chore: 提交高层 xiaomi 封装库及示例

- 新增 xiaomi/examples/ 下 8 个示例程序(用户/家庭查询、设备列表、开关/灯光/空调控制、属性订阅、高级过滤分类、SPEC 解析)
- miot_client_sub.go: 重构 SubProp/SubEvent,使用 buildPropTopic/buildEventTopic 支持通配符订阅(siid/piid=0 → +),并修复锁顺序问题(将 RequestRefreshProp 移到 Lock 外)
- spec_parser.go: 新增 downloadSpecFile 方法,本地 SPEC 文件缺失时自动从 miot-spec.org 下载
- ARCH_PLAN.md: 架构设计从 Proposed 更新为 Accepted(v1.0→v1.1),补充设备分类/工厂/SPEC 映射等模块设计
- xiaomi/: 新增 miot 上层强类型封装模块,包含 Client 主入口、用户/家庭/设备 API、属性读写、动作调用、订阅通知,以及 devices/ 设备控制抽象(Switch/Light/AirConditioner/Fan/Cover/Humidifier/Vacuum/WaterHeater/Thermostat)和 specs/ SPEC 查询辅助
- 更多 xiaomi 示例(风扇/窗帘/传感器控制)
This commit is contained in:
2026-06-29 08:51:21 +08:00
parent 35efed7d15
commit a3d94c4b9f
93 changed files with 7582 additions and 157 deletions
+111
View File
@@ -0,0 +1,111 @@
// Package main demonstrates full air conditioner control.
// 运行前提:已配置环境变量 XIAOMI_CLIENT_ID / XIAOMI_CLIENT_SECRET / XIAOMI_ACCESS_TOKEN。
package main
import (
"context"
"log"
"time"
"xiaomihome/xiaomi"
"xiaomihome/xiaomi/devices"
miotconfig "xiaomihome/miot/examples/config"
)
func main() {
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
cfg, err := miotconfig.LoadConfig("../../../miot/examples/config.json")
if err != nil {
log.Fatal("请先运行 miot/examples/cloud_oauth 获取 token:", err)
}
client, err := xiaomi.NewClient(ctx, xiaomi.Config{
ClientSecret: "",
AccessToken: cfg.AuthInfo.AccessToken,
UID: cfg.UID,
UUID: cfg.UUID,
})
if err != nil {
log.Fatal(err)
}
defer client.Close()
const targetDID = "2053225728"
info, err := client.GetDevice(ctx, targetDID)
if err != nil {
log.Fatalf("获取设备 %s 失败: %v", targetDID, err)
}
ac, err := devices.NewAirConditioner(client, info)
if err != nil {
log.Fatalf("创建 AirConditioner 失败: %v", err)
}
log.Printf("空调: %s (DID: %s, 型号: %s)", info.Name, info.DID, info.Model)
on, _ := ac.IsOn(ctx)
mode, _ := ac.GetMode(ctx)
targetTemp, _ := ac.GetTargetTemp(ctx)
currentTemp, _ := ac.GetCurrentTemp(ctx)
fanSpeed, _ := ac.GetFanSpeed(ctx)
swing, _ := ac.GetSwing(ctx)
log.Printf("当前状态: on=%v mode=%s target=%.1f current=%.1f fan=%s swing=%s",
on, mode, targetTemp, currentTemp, fanSpeed, swing)
log.Println("=== 执行控制: 开 -> 制冷 -> 26度 -> 自动风速 -> 垂直摆风 ===")
if !on {
log.Println(" 开启空调...")
ac.TurnOn(ctx)
time.Sleep(500 * time.Millisecond)
}
log.Println(" 设置制冷模式...")
ac.SetMode(ctx, devices.ModeCool)
log.Println(" 设置目标温度 26度...")
ac.SetTargetTemp(ctx, 26.0)
log.Println(" 设置自动风速...")
ac.SetFanSpeed(ctx, devices.SpeedAuto)
log.Println(" 设置垂直摆风...")
ac.SetSwing(ctx, devices.SwingVertical)
time.Sleep(1 * time.Second)
mode, _ = ac.GetMode(ctx)
targetTemp, _ = ac.GetTargetTemp(ctx)
currentTemp, _ = ac.GetCurrentTemp(ctx)
fanSpeed, _ = ac.GetFanSpeed(ctx)
swing, _ = ac.GetSwing(ctx)
log.Printf("更新后状态: mode=%s target=%.1f current=%.1f fan=%s swing=%s",
mode, targetTemp, currentTemp, fanSpeed, swing)
log.Println("设置目标湿度 50...")
if err := ac.SetTargetHumidity(ctx, 50); err != nil {
log.Printf(" 设置湿度失败(可能不支持): %v", err)
} else {
humidity, _ := ac.GetTargetHumidity(ctx)
curHumidity, _ := ac.GetCurrentHumidity(ctx)
log.Printf(" 湿度: target=%d current=%d", humidity, curHumidity)
}
log.Println("关闭电辅热...")
ac.SetAuxHeat(ctx, false)
log.Println("开启节能模式...")
ac.SetEco(ctx, true)
subID, err := ac.OnStateChanged(func(state devices.ACState) {
log.Printf("空调状态变化: power=%v mode=%s target=%.1f current=%.1f fan=%s swing=%s",
state.Power, state.Mode, state.TargetTemp, state.CurrentTemp,
state.FanSpeed, state.Swing)
})
if err != nil {
log.Printf("订阅状态失败: %v", err)
} else {
log.Printf("已订阅空调状态: subID=%s", subID)
}
log.Println("空调控制演示完毕")
}