golib/xiaomihome
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
14 Commits 1 Branch 2 Tags
v0.1.0
Commit Graph
14 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
4566704 cdc459b5ff fix(xiaomihome): 模块路径改为 git.zeroonesoft.cn/golib/xiaomihome 
- 改动：go.mod module 声明与全部内部导入路径补全为完整域名路径，README 同步
- 原因：裸模块名无法被 go get 解析，发版前必须修正为 GOPRIVATE 可拉取路径
 2026-10-05 08:53:23 +08:00
4566704 2b7de69403 refactor(logger): 日志改用 logrus 全局包级调用，移除 Logger 注入接口 
为什么：并入宿主项目后须与宿主日志体系一致——宿主统一用 pkg/logger 初始化
logrus 全局实例并直接 logrus.Xxx 包级调用；包一层 Logger 接口会让 logrus 的
caller 定位（报告调用文件:行号）失准。

改动：
- 删除 logger 包（Logger 接口 / Default / SetDefault，默认本就是 logrus.StandardLogger）
- 11 个结构体移除 lgr logger.Logger 字段、SetLogger 方法及构造中的 lgr 初始化
- 192 处 lgr.Xxxf 调用改为 logrus.Xxxf，日志消息文本保持不变
- xiaomi.Client 移除 Logger() 访问器，air_conditioner 回读日志去掉判空调用直连 logrus
- miot_i18n.go 两处标准库 log.Printf 改为 logrus.Errorf，统一日志出口
- go.mod：logrus 从 indirect 提升为直接依赖
- goimports/goformat 全树规范化：此前部分文件未 gofmt（单行 if、对齐），本次顺带
  格式化，纯空白/换行变化，无逻辑改动

验证：go build / go vet / go test ./... 全部通过（bridge、miot、xiaomi、devices、specs）
 2026-09-15 20:16:26 +08:00
4566704 7ae32bd012 docs: 补充「与 Python 原版的有意差异」说明与设备剔除/风速映射文档 
- README 新增有意差异一节：设备列表语义（剔除米家已删设备）与缓存持久化内容的两条有意偏离及其原因、剔除判定规则
- README 架构概览补齐 xiaomi/、bridge/ 两层目录说明
- xiaomi/README 更新 GetDevices/RefreshDevices 签名（ctx），补充设备列表语义、家庭范围刷新示例与数字档位风速映射说明
 2026-09-15 19:51:38 +08:00
4566704 a595330144 fix(miot): 米家已删除设备从缓存、控制器与订阅中彻底剔除 
在米家 App 删除设备后设备列表仍能获取到：删除检测只 delete(deviceListCloud)，
deviceListCache 仅置 online=false，而对外 DeviceList()/GetDevices() 读的正是
cache；缓存又会在停机时落盘到 .dict、启动时原样恢复，已删设备跨重启复活。

- pruneRemovedDevicesLocked：候选集改为「缓存 ∪ 云列表」，云端不存在且网关/
  局域网非在线的设备从四张表彻底删除（旧实现只遍历 deviceListCloud，启动时它
  为空，停机期间被删的设备永远检测不到）
- 护栏：云端返回空列表时跳过剔除，避免接口异常清库
- homeScope：只刷新部分家庭时不再误删其它家庭的云列表
- 子设备（xxx.s1）不参与判定，它被归并到父设备的 sub_devices
- 命中剔除的设备同时清理 c.devices 实例与 MQTT 订阅路由
- bridge: pruneControllers 剔除已删设备的控制器，AC()/Switch() 不再返回实例
- 新增 7 个 miot 用例（含 httptest 打桩的端到端）+ 3 个 bridge 用例
 2026-09-12 19:29:46 +08:00
4566704 c18c0adaae fix(xiaomi): 空调风速按数字档位映射并增加 MQTT 反向语义解析 
klwdz1.airc.001 等设备 fan-level 枚举为 Auto + Level1~Level5，SDK 侧
low/medium/high 在枚举里查不到，导致只有 Auto 能设置成功。

- valMapper 增加 levelFallback 开关（仅 fan-level 启用）：精确匹配失败时
  low/medium/high 按数字档位相对位置映射（排除 Auto=0）
- name() 增加对称的反向映射：设备上报 1/3/5 → low/medium/high，
  控制与 MQTT 通知使用同一套语义枚举
- newValMapper 默认关闭 fallback，mode/swing 行为不变
- 新增 TestValMapperLevelFallback 覆盖正反向映射与 mode 无副作用
 2026-09-12 19:29:32 +08:00
4566704 a0ef854726 feat: 完善 AC"set 后回读"机制 — 目标聚合 + 防抖重试验证 
**回读目标聚合（recordReadback）**
- 所有 set 方法（TurnOn/TurnOff/SetMode/SetTargetTemp/SetFanSpeed/
  SetSwing/SetTargetHumidity/SetAuxHeat/SetEco）成功后记录目标值 rbTarget
- 同属性目标覆盖、不同属性追加，连续 set 自动聚合

**防抖 + 重试验证（readbackLoop）**
- 静默窗口 readbackIdle=3s：等待最后一次 set 无新操作才开始验证
- 未命中目标时按 readbackRetryInterval=3s 重试，上限 readbackMaxRetries=5
- 整体超时 readbackTimeout=30s，防云端卡住导致回读永久挂起
- 命中后逐字段回调 OnPropsChanged 注册的 handler（与 MQTT 推送同语义）
- rbValueEqual 数值比较用 epsilon=0.01，bool/string 直接相等

**白名单配置透传**
- xiaomi.Config 新增 ReadbackModels 白名单（留空 = 全部不回读，默认）
- Client 新增 NeedReadback(model) 判定 + Logger() 访问器
- bridge.Pool.NewPool(readbackModels...) 透传；newBridge 传入 Client 配置

**其他**
- bridge 设备创建失败（Warn）与不支持跳过（Debug）分别记录日志
 2026-08-23 23:33:32 +08:00
4566704 86c21ce91c feat: AC 三合一设备支持 + 新增 Plug/Gateway 驱动 + Cover 结构化重构 
**AC 驱动增强**
- 支持 thermostat + air-conditioner + air-fresh 多服务三合一设备，属性跨服务合并解析
- 新增 specResolver.findValListInService/findInService/hasService/serviceShortName 方法
- 移除 KindThermostat，heater/electric-blanket/thermostat 重新归类为 KindAirConditioner

**Cover 窗帘重构**
- CoverProps 结构化：Position/Status/Fault 分离
- SetPosition 优先写 target-position，回退 current-position
- OnPropsChanged/FetchProps 支持多属性同步刷新

**新增设备类型**
- Plug 驱动：插座/插头，支持开合、在线状态、属性变更订阅
- Gateway 驱动：网关设备类型识别
- miot/miot_errors.go：新增 MIoT 云端错误码定义

**MIoT 客户端健壮性**
- SetProp 空结果视为失败；设备被移除或离线时自动刷新设备列表
- GetDevices 的 has_more 改用 parseBool 严格解析
- MIPS SubscribeMany 批量订阅减少往返
- matchURN 改为按段精确匹配，避免 tofan 误匹配 fan

**Bridge**
- 移除 Thermostat case，Cover 改用结构化 CoverProps
- 新增设备创建后自动订阅属性变更

**其他**
- 日志整体 Info → Debug 降噪
- .gitignore 忽略 /.codebuddy/memory
- 更新 devices_test 与 08_adv_filter_classify 示例
 2026-08-23 19:42:55 +08:00
4566704 04333750ab feat: State→Props 命名统一 + 新增 Plug/Gateway 设备 + 分类系统重构 
**命名统一（State → Props）**
- 所有设备类型：XxxState → XxxProps，GetState() → GetProps()，FetchState() → FetchProps()
- 回调接口：OnStateChanged → OnPropsChanged
- Bridge 层类型别名、示例代码、文档同步更名

**新增设备类型**
- KindPlug + Plug 驱动：智能插座/插头（TurnOn/TurnOff/IsOn/OnPropsChanged）
- KindGateway + Gateway 驱动：网关设备类型识别
- KindOccupancySensor 从 KindSensor 独立，添加 OccupancyProps

**设备分类系统改进**
- classifyByModel 改为按 key 长度降序匹配（防止 sensor 先于 sensor-occupy）
- 新增下划线变体识别（sensor_occupy、sensor_temp 等）
- outlet 重新归类为 Plug（非 Switch）
- 新增 Or() 组合过滤器

**连接桥增强**
- 设备创建成功后自动订阅属性变更
- 新增 nil 防护检查
- 支持 Plug/Speaker/Gateway/Occupancy 类型的 FetchProps 刷新
- 日志级别 Info → Debug

**AC 驱动增强**
- 新增 HasPower()、GetElectricPower()、GetPowerConsumption() 功率接口
- ACProps 新增 ElectricPower、PowerConsumption 字段
- valMapper：Desc 为空时 fallback 用 Name，key 统一小写

**MIoT 核心**
- 设备列表刷新改用 reflect.DeepEqual 全字段变更检测
- 移除 BLE/代理设备默认在线 hack
- RefreshDeviceAllProps 增加离线检查
- 新增 miot_errors.go：MIoT 错误码定义
- 全局日志级别 Info→Debug/Warn（降低噪音）

**示例与文档**
- 所有示例代码同步 API 变更
- 传感器示例改用 Or 组合过滤器
- ARCH_PLAN 等迁移文档同步更新
 2026-08-05 17:54:08 +08:00
4566704 b808e51b3e refactor: 重大架构升级 — HomeID/RoomID int64化 + 设备驱动重构 + 结构化日志 
主要变更：

**类型系统重构**
- HomeInfo.ID/RoomInfo.ID/HomeID 从 string 改为 int64，json tag 使用 ,string
- GetHome/GetRooms/GetRoomDevices 接口同步修改
- 新增 int64FromStr 工具函数，更新 parseHomeInfo 解析逻辑

**新增 Speaker 设备**
- 新增 KindSpeaker 类型
- classify 映射覆盖 speaker/bluetooth-speaker/alarm-clock/media-player/playback/music

**设备驱动重构**
- AC 驱动彻底重写：从硬编码常量改为基于 SPEC ValueList 的动态 valMapper
- 所有设备(Fan/Humidifier/Light/OccupancySensor/Switch/TempHumiditySensor/Thermostat/Vacuum/WaterHeater/Cover)新增 GetState() 和 FetchState(ctx) 接口
- base.go 新增 specResolver.format() 方法

**MIoT 模块增强**
- MIoTClient 新增 homeIDs 字段，支持按家庭过滤设备
- RefreshDevices 支持 homeIDs 参数
- SpecStdLib 引入 logger.Logger，log.Printf 全部迁移为结构化日志

**其他**
- Config 新增 RedirectURL 和 HomeIDs 字段
- AuthInfo.ExpiresIn 类型从 int 改为 int32
- UUID 生成简化为 hex.EncodeToString
- 新增 github.com/sirupsen/logrus 依赖
- .gitignore 新增 examples/*/data/ 忽略规则
- 删除已提交的 config.json 敏感配置
 2026-07-13 10:40:20 +08:00
4566704 8ffc9e4e44 refactor: 重构 token 管理，新增 NATS adapter 和多示例 
按照 TOKEN_REFACTOR.md / FIX_CONFIG.md 方案重构核心层：
- miot: Init() 优先读 storage token，新增 RefreshAuthInfo() 和刷新回调
- xiaomi: Config 改用 AuthInfo 结构体（含 UUID/UID/DataDir/OnTokenRefreshed）
- xiaomi: NewClient(ctx, Config) 新签名，新增 RefreshToken()，后台自动刷新
- xiaomi/devices: 设备控制接口重构
- 新增示例 12_ac_subscribe，其余示例适配新 Config
 2026-06-30 12:16:49 +08:00
4566704 a3d94c4b9f 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 示例（风扇/窗帘/传感器控制）
 2026-06-29 08:51:21 +08:00
4566704 35efed7d15 chore: 修复 import 路径为 xiaomihome/miot，补充 README 项目文档 
go.mod 模块名为 xiaomihome，将所有内部 import 从 "miot" 更新为
"xiaomihome/miot"，涉及所有测试文件和示例文件。新增 README.md 项目
介绍文档（架构概览、模块说明、移植进度等）。新增 ARCH_PLAN.md 架构
设计文档。
 2026-06-28 23:21:18 +08:00
4566704 3a44cb9e6a feat: 初始化小米 IoT (MIoT) 智能家居 Go 库 
- 实现 MIoT 客户端核心功能（MQTT 连接、设备管理、属性读写）
- 支持云端 API 调用与局域网设备发现（mDNS）
- 集成国际化（i18n）多语言支持
- 添加 MIoT 设备规约解析器（spec_parser）
- 包含单元测试与使用示例
 2026-06-28 22:05:49 +08:00
4566704 ac442812b4 first commit 2026-06-28 21:42:16 +08:00