4566704
a3d94c4b9f
- 新增 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 示例（风扇/窗帘/传感器控制）
61 lines
1.4 KiB
Go
61 lines
1.4 KiB
Go
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}
|
|
}
|