Petlibro项目新增对PLWF105智能饮水机的支持

Petlibro项目新增对PLWF105智能饮水机的支持

petlibro Petlibro | Home Assistant integration 项目地址: https://gitcode.com/gh_mirrors/pe/petlibro

在智能宠物设备领域，Petlibro项目近期完成了对DOCKSTREAM系列PLWF105型号智能饮水机的功能支持。作为该开源项目的重要更新，本次集成实现了与PLWF305型号相近的功能体验（除RFID相关特性外），为宠物主人提供了更完善的设备管理能力。

设备功能解析

PLWF105智能饮水机具备以下核心功能特性：

• 水量监测：通过重量传感器实时检测剩余水量（1726克示例数据，69%水量百分比）
• 工作状态监控：包括水泵运行状态、真空模式等关键参数
• 智能提醒：滤芯更换倒计时（14天示例）和机器清洁提醒
• 环境适应：支持时区自动适配（如America/Chicago）
• 网络连接：Wi-Fi信号强度监测（-67dBm示例）

技术实现上，项目通过解析设备API返回的JSON数据结构，提取了包括设备序列号、固件版本（v1.0.7）、电源类型等关键字段。开发者特别注意到该设备具有独特的"雪花模式"（snowflake参数），这是区别于其他型号的特色功能。

技术实现细节

在v1.0.8版本更新中，开发团队主要完成了：

1. 设备识别逻辑：通过productIdentifier字段（PLWF105）实现自动识别
2. 状态映射：将API返回的weightState（NORMAL）、runningState（WATER_NORMAL）等参数转换为HA实体状态
3. 异常处理：针对barnDoorError、errorState等异常状态设计告警机制

值得关注的是，设备上报的数据包含丰富的维护信息：

• filterNextReplacementTime：滤芯下次更换时间戳
• machineNextCleaningTime：下次清洁时间戳
• remainingDesiccantDays：干燥剂剩余天数

未来优化方向

虽然基础功能已实现，但项目路线图中还包含以下增强计划：

1. 维护重置功能：开发专用按钮实体用于重置清洁/滤芯计时器
2. 用水量统计：深化todayTotalMl字段的利用，提供周期用水报告
3. 设备联动：基于weightState状态实现自动化触发条件

对于初次接触智能宠物设备的用户，建议重点关注水量百分比和滤芯更换提醒这两个核心功能，它们能有效保障宠物的饮水健康。开发团队将持续收集用户反馈，进一步完善设备支持。

该更新现已随Petlibro v1.0.8版本发布，用户可通过标准流程升级集成体验新功能。对于技术爱好者，项目保持开源特性，欢迎贡献更多设备支持或功能优化。

petlibro Petlibro | Home Assistant integration 项目地址: https://gitcode.com/gh_mirrors/pe/petlibro