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
+60
View File
@@ -0,0 +1,60 @@
package xiaomi
import (
"errors"
"fmt"
)
// 封装层错误定义
var (
// ErrNotSupported 设备不支持该操作
ErrNotSupported = errors.New("xiaomi: operation not supported by this device")
// ErrDeviceNotFound 设备不存在
ErrDeviceNotFound = errors.New("xiaomi: device not found")
// ErrHomeNotFound 家庭不存在
ErrHomeNotFound = errors.New("xiaomi: home not found")
// ErrRoomNotFound 房间不存在
ErrRoomNotFound = errors.New("xiaomi: room not found")
// ErrDeviceOffline 设备离线
ErrDeviceOffline = errors.New("xiaomi: device is offline")
// ErrNoSPEC 设备缺少 SPEC 信息
ErrNoSPEC = errors.New("xiaomi: device has no SPEC information")
// ErrInvalidProp 属性读取/写入失败
ErrInvalidProp = errors.New("xiaomi: invalid property access")
// ErrNotInitialized 客户端未初始化
ErrNotInitialized = errors.New("xiaomi: client not initialized")
)
// ClientError 带上下文的客户端错误
type ClientError struct {
Op string // 操作名称
DID string // 设备 ID
Err error // 底层错误
}
func (e *ClientError) Error() string {
if e.DID != "" {
return fmt.Sprintf("xiaomi: %s device=%s: %v", e.Op, e.DID, e.Err)
}
return fmt.Sprintf("xiaomi: %s: %v", e.Op, e.Err)
}
func (e *ClientError) Unwrap() error {
return e.Err
}
// wrapErr 包装错误
func wrapErr(op, did string, err error) error {
if err == nil {
return nil
}
return &ClientError{Op: op, DID: did, Err: err}
}