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
+74
View File
@@ -0,0 +1,74 @@
// Package main demonstrates sensor device reading (temp/humidity & occupancy).
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()
// 获取所有传感器
sensorList, err := client.GetDevices(ctx, xiaomi.FilterByKind(xiaomi.KindSensor))
if err != nil {
log.Fatalf("获取传感器列表失败: %v", err)
}
if len(sensorList) == 0 {
log.Fatal("未找到传感器类设备")
}
log.Printf("共 %d 个传感器\n", len(sensorList))
for _, info := range sensorList {
kind := info.DeviceKind()
log.Printf("=== %s (DID: %s, 型号: %s, 种类: %s) ===",
info.Name, info.DID, info.Model, kind)
// 尝试温湿度传感器
if ht, err := devices.NewTempHumiditySensor(client, info); err == nil {
if temp, err := ht.GetTemperature(ctx); err == nil {
log.Printf(" 温度: %.1f°C", temp)
}
if hum, err := ht.GetHumidity(ctx); err == nil {
log.Printf(" 湿度: %.0f%%", hum)
}
continue
}
// 尝试人在传感器
if occ, err := devices.NewOccupancySensor(client, info); err == nil {
if occupied, err := occ.IsOccupied(ctx); err == nil {
log.Printf(" 有人: %v", occupied)
}
if lux, err := occ.GetIlluminance(ctx); err == nil {
log.Printf(" 光照: %.0f lux", lux)
}
continue
}
log.Printf(" (无支持的传感器协议)")
}
}