Xiaomi Miot集成中宠物饮水机设备不可用问题解析

问题现象

近期有用户反馈在使用Xiaomi Miot集成连接mmgg.pet_waterer.wi11宠物饮水机设备时，出现多个实体持续显示"不可用"状态的问题。该问题发生在Home Assistant 2024.12.4版本环境下，集成版本为1.0.5。用户尝试了重新安装集成、重载配置、强制更新设备等多种方法均未能解决。

技术分析

通过分析设备属性信息，我们发现该宠物饮水机设备包含多个功能实体：

• 基础开关控制（pet_drinking_fountain.on）
• 指示灯控制（indicator_light.on）
• 滤芯剩余时间（filter.filter_left_time）
• 故障状态（pet_drinking_fountain.fault）
• 清洁剩余时间（remain_clean_time）
• 缺水检测（no_water_flag相关状态）
• 工作模式选择（pet_drinking_fountain.mode）

在1.0.5版本中，部分实体（特别是indicator_light.on）会出现间歇性不可用的情况。这通常是由于设备通信协议处理不完善导致的。

解决方案

项目维护者在1.0.6版本中修复了此问题。升级方法如下：

1. 通过HACS更新Xiaomi Miot集成至最新版本
2. 对于需要立即修复的用户，可以使用以下命令强制更新到master分支：

   wget -O - https://get.hacs.vip | DOMAIN=xiaomi_miot ARCHIVE_TAG=master bash -
   

配置建议

针对宠物智能设备，建议注意以下配置选项：

1. 连接模式选择：

   • miot_cloud：始终使用云端连接
   • auto_cloud：优先本地连接，失败时自动切换云端

2. 局域网检测（check_lan）： 启用此选项后，系统会通过检测本地连接来确认设备在线状态，避免因小米服务器缓存导致的设备状态误判。

3. 实体自定义： 可以通过集成的自定义功能调整实体属性，如需恢复默认设置，可在设备配置中点击"重置自定义"按钮。

注意事项

升级后若仍有实体显示不可用，建议检查设备的info实体属性，确认所有功能是否已正确映射。对于宠物饮水机和喂食器这类设备，部分功能可能需要特定固件版本支持。

通过保持集成版本更新和合理配置连接参数，可以确保智能宠物设备的稳定接入和功能完整性。