Xiaomi Home集成中晾衣架设备状态显示问题解析

问题背景

在Xiaomi Home集成0.2.0版本更新后，部分用户反馈其晾衣架设备在Home Assistant中无法显示当前位置状态。这一问题主要影响两类设备：米家晾衣机Pro（hyd.airer.pro2）和邦先生晾衣架（mrbond.airer.m33a）。

技术原因分析

设备规范差异

通过分析MIoT-Spec-V2设备规范发现，不同厂商对晾衣架设备的实现存在显著差异：

1. 米家晾衣机Pro：在标准规范中，airer服务未包含current-position属性，但实际设备通过灯光服务实现了位置状态反馈。这表明厂商可能采用了非标准实现方式。

2. 邦先生晾衣架：设备规范中包含了三个current-position属性，其中第二个属性（p_2_10）实际表示设备高度状态，采用百分比形式（0%表示上限位，100%表示下限位）。

集成适配问题

Xiaomi Home集成在0.2.0版本中将晾衣架设备统一转换为cover实体类型，这种转换导致：

1. 对于规范中明确包含位置属性的设备，位置信息被正确映射到cover实体的current_cover_position属性。

2. 对于采用非标准实现的设备，位置信息无法被自动识别和转换。

解决方案演进

开发团队针对不同设备类型采取了差异化处理：

1. 邦先生晾衣架：在0.2.3版本中，将sensor.mrbond_cn_435120299_m33a_current_position_p_2_10传感器正确转换为cover实体的current_cover_position属性，解决了位置显示问题。

2. 米家晾衣机Pro：由于设备采用非标准实现（位置属性位于灯光服务而非晾衣架服务），需要特殊处理才能正确获取位置信息。

用户临时解决方案

对于希望保留原有操作方式的用户，可以通过以下步骤恢复：

1. 修改specv2entity.py文件，删除airer转换规则
2. 重启Home Assistant
3. 在集成配置中勾选"更新实体转换规则"

最佳实践建议

1. 对于自动化依赖设备位置状态的场景，建议优先选择规范实现完整的设备型号。

2. 开发自定义组件时，应考虑设备厂商可能存在的非标准实现，增加兼容性处理。

3. 用户遇到类似问题时，可通过检查设备规范和服务属性来定位问题根源。

总结

本次事件凸显了IoT设备标准化过程中的挑战，也展示了开源社区通过协作解决问题的效率。随着Xiaomi Home集成的持续迭代，预计将会有更多设备的特殊实现得到良好支持。