搞了台树新风T2 Pro,折腾了下,还是AI大手发力。沟通4回合成功产出树新风空气净化器接入ha集成。
话不多说看图:
项目链接:
详细的请看下方Readme:
Treeow Home Integration for Home Assistant
树新风空气净化器 Home Assistant 集成 集成由AI参与生成,目前测试设备T2Pro
功能特性
传感器实体
- PM2.5 - 实时 PM2.5 浓度监测
- 室内温度 - 当前室内温度
- 室内湿度 - 当前室内湿度百分比
- 甲醛浓度 - 甲醛(CH2O)浓度值
- 滤芯寿命 - 滤芯剩余寿命百分比
- 滤芯剩余天数 - 滤芯剩余可用天数
- 累计工作时间 - 设备累计运行小时数
- AAL - 空气质量等级
- 在线状态 - 设备在线/离线状态
风扇实体
- 开关控制 - 设备开关
- 7档风速控制 - 支持 0-6 档风速调节
- 0档:睡眠模式(0%)
- 1-5档:手动档位(14%, 28%, 42%, 57%, 71%)
- 6档:极净模式(100%)
- 预设模式:
- 自动模式 - 根据空气质量自动调节
- 极净模式 - 最大风速净化
- 睡眠模式 - 静音低风速运行
安装
方法一:通过 HACS 安装(推荐)
- 确保已安装 HACS
- 在 HACS 中,进入"集成"
- 点击右上角三个点,选择"自定义存储库"
- 添加此存储库 URL
- 选择类别为"集成"
- 在 HACS 中搜索 "Treeow Home" 并安装
- 重启 Home Assistant
- 在"设置" -> "设备与服务"中添加集成
方法二:手动安装
- 下载最新版本
- 将 treeow_home 文件夹复制到 Home Assistant 的 custom_components 目录
- 重启 Home Assistant
- 在"设置" -> "设备与服务"中添加集成
- 搜索 "Treeow Home" 并输入您的用户名和密码
配置
集成通过配置流程进行设置,需要提供: - 用户名/手机号 - 您的 Treeow Home 账号(手机号)
- 密码 - 您的账号密码
集成会自动: - 登录并获取访问令牌
- 发现所有家庭和设备
- 创建传感器和风扇实体
使用
自动化示例
# 当 PM2.5 超过 50 时,自动开启极净模式automation: - alias: "Auto Purify High PM2.5" trigger: - platform: numeric_state entity_id: sensor.t2_pro_全效空气净化器_pm2_5 above: 50 action: - service: fan.set_preset_mode target: entity_id: fan.t2_pro_全效空气净化器_风扇 data: preset_mode: "极净"
# 夜间自动切换到睡眠模式automation: - alias: "Night Mode" trigger: - platform: time at: "22:00:00" action: - service: fan.set_preset_mode target: entity_id: fan.t2_pro_全效空气净化器_风扇 data: preset_mode: "睡眠"
卡片配置示例
type: entitiestitle: 空气净化器entities: - entity: fan.t2_pro_全效空气净化器_风扇 name: 风扇 - entity: sensor.t2_pro_全效空气净化器_pm2_5 name: PM2.5 - entity: sensor.t2_pro_全效空气净化器_室内温度 name: 温度 - entity: sensor.t2_pro_全效空气净化器_室内湿度 name: 湿度 - entity: sensor.t2_pro_全效空气净化器_甲醛 name: 甲醛 - entity: sensor.t2_pro_全效空气净化器_滤芯寿命 name: 滤芯寿命
技术细节
更新频率
设备数据每 1 秒更新一次,以匹配官方 App 的更新频率。 安全
- 密码在传输前会进行 MD5 加密
- 访问令牌会自动管理和刷新
- 所有通信均通过 HTTPS 加密
API 端点
- eziotes.treeow.com.cn - 主要 API 服务器
- ezopen.treeow.com.cn - 设备令牌服务器
故障排除
设备未发现
- 确认账号密码正确
- 检查网络连接
- 查看 Home Assistant 日志获取详细错误信息
设备离线
- 检查设备是否在线(通过官方 App)
- 确认设备已连接到 WiFi
- 如果设备长时间离线,传感器会显示最后已知值
控制无响应
- 确认设备在线
- 检查 Home Assistant 日志
- 尝试重启集成
支持的设备
- T2 Pro 全效空气净化器
- 其他支持 Treeow Home API 的设备
版本历史
1.0.0
- 初始版本
- 支持传感器和风扇实体
- 支持预设模式控制
- 7档风速控制
贡献
欢迎提交 Issue 和 Pull Request! 许可证
MIT License
|