Rinnai 采暖设备集成(Home Assistant 插件)

hacs_badge GitHub release GitHub license

本项目 fork 自 palafin02back/rinnai_integration,并在此基础上进行了功能完善和适配。

本集成适用于 Rinnai(林内)REB 系列冷凝炉,可在 Home Assistant 中实现本地化的采暖与热水控制与状态监控。

使用本集成存在被官方服务器封号的风险。一旦被封号,可能导致原厂 App 中设备一直显示离线,无法远程控制。
请在充分了解风险并自行承担责任的前提下使用本插件。严格不建议在主账号下使用。本项目及开发者对由此引发的任何后果不承担责任。

• 采暖气候实体
  • 支持设置采暖目标温度
  • 支持在四种模式间切换:普通、快速、外出、关闭
  • 能显示当前运行状态(采暖中 / 待机 / 关闭)及目标温度
• 热水器实体
  • 支持设置热水目标温度
  • 展示热水温度上下限等基础信息
• 热水器节能模式(Eco Mode)开关:与 REB 设备节能位同步,可单独在控制面板上切换
• 诊断与传感器信息:采暖 / 热水燃烧状态、水压、采暖 / 热水设定温度等
• MQTT 被动更新:无需等待下一次轮询即可刷新实体状态

1. 确保已安装 HACS
2. 在 HACS → 自定义存储库 中添加 https://github.com/kaattz/rinnai_integration
3. 类别选择 "Integration",点击添加
4. 在 HACS 集成页面搜索 "Rinnai" 并安装
5. 重启 Home Assistant

1. 下载本仓库源码
2. 将 custom_components/rinnai 目录拷贝到 Home Assistant 配置目录的 custom_components 中
3. 重启 Home Assistant

1. 打开 Home Assistant → 设置 → 设备与服务 → 添加集成
2. 搜索 "Rinnai"
3. 按向导填写账号、密码等参数完成配置

• 主要支持林内 REB 系列采暖冷凝炉
• 其他系列暂未适配,如适配成功欢迎反馈
• 已在 Home Assistant 202590 版本测试,其余版本请自行验证兼容性

1. 设备是否已成功连网,可否通过官方 App 正常控制
2. 检查 Home Assistant 日志中有无 custom_components.rinnai 报错
3. 如问题无法解决,请开启调试日志,附带完整日志、HA 版本等信息提交 Issue

欢迎通过 Issue / PR 提交反馈、建议或代码,一起完善 REB 系列的支持。

本项目为非官方爱好者开发,与 Rinnai 官方无关。任何因使用本项目造成的账号封禁、设备异常或其他损失,由使用者自行承担风险与责任;作者及贡献者不承担任何责任,敬请知悉。

项目采用 MIT License,详见 LICENSE。