{"id":26182709,"url":"https://github.com/palafin02back/rinnai_mqtt_ha","last_synced_at":"2025-04-14T23:15:52.538Z","repository":{"id":266430311,"uuid":"898325816","full_name":"palafin02back/rinnai_mqtt_ha","owner":"palafin02back","description":"林内智家锅炉控制","archived":false,"fork":false,"pushed_at":"2025-04-01T08:11:29.000Z","size":140,"stargazers_count":17,"open_issues_count":3,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-14T23:15:44.836Z","etag":null,"topics":["docker","home-assistant"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/palafin02back.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-04T07:38:38.000Z","updated_at":"2025-04-12T03:15:31.000Z","dependencies_parsed_at":"2024-12-04T08:32:19.558Z","dependency_job_id":"217328fc-b5d6-48c4-9183-3deff0735792","html_url":"https://github.com/palafin02back/rinnai_mqtt_ha","commit_stats":null,"previous_names":["palafin02back/rinnai_mqtt_ha"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palafin02back%2Frinnai_mqtt_ha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palafin02back%2Frinnai_mqtt_ha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palafin02back%2Frinnai_mqtt_ha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palafin02back%2Frinnai_mqtt_ha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/palafin02back","download_url":"https://codeload.github.com/palafin02back/rinnai_mqtt_ha/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248975329,"owners_count":21192210,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","home-assistant"],"created_at":"2025-03-11T22:23:48.421Z","updated_at":"2025-04-14T23:15:52.505Z","avatar_url":"https://github.com/palafin02back.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\r\n# 林内 MQTT Home Assistant 集成\r\n\r\n本项目旨在桥接林内智能设备与 Home Assistant，目前已在 `RBS-**G56系列` (设备 ID: `0F06000C`) 上进行测试。对于其他型号的林内设备，可能需要根据设备抓包信息自行添加 MQTT 主题。\r\n\r\n## ⚠️ 注意：订阅过多存在封号风险！ ⚠️\r\nhttps://github.com/palafin02back/rinnai_mqtt_ha/issues/22\r\n- 请注意！目前发现订阅数量过多，可能触发封禁，返回rc：5\r\n- 建议先暂停使用，观察一段时间，被封了可以先换个账号绑定，以免影响正常app使用\r\n\r\n\r\n\r\n## 项目背景\r\n\r\n该项目起源于想要在Home Assistant中管理锅炉启停数据并控制，尝试抓包解包林内app数据实现home assistant中控制锅炉。对于 `RBS-**G56` 系列设备，理论上可以直接使用林内账号密码进行连接，无需手动抓包配置 MQTT 主题。\r\n\r\n## 功能特性\r\n\r\n- **状态监控:** 在 Home Assistant 中查看林内锅炉的运行状态。\r\n- **温度控制:**  在 Home Assistant 中调整锅炉的温度设置。\r\n- **燃气用量:**  获取林内锅炉的燃气消耗量数据。\r\n- **本地 MQTT 支持:**  支持配置用户名和密码连接本地 MQTT Broker。\r\n\r\n## 快速开始\r\n\r\n### 环境变量\r\n\r\n请配置以下环境变量：\r\n\r\n```\r\n- RINNAI_USERNAME=你的林内智家账号\r\n- RINNAI_PASSWORD=你的林内智家密码\r\n- LOCAL_MQTT_HOST=你的 Home Assistant MQTT Broker 地址\r\n- LOCAL_MQTT_PORT=你的 Home Assistant MQTT Broker 端口\r\n- LOCAL_MQTT_USERNAME=你的 Home Assistant MQTT Broker 用户名 (可选)\r\n- LOCAL_MQTT_PASSWORD=你的 Home Assistant MQTT Broker 密码 (可选)\r\n- LOCAL_MQTT_TLS=True 或 False (如果本地 MQTT 地址是 HTTPS，请设置为 True，默认为 False)\r\n- LOGGING=True 或 False (是否开启日志，默认为 True)\r\n```\r\n\r\n### Docker 运行\r\n\r\n```bash\r\ndocker run -d \\\r\n  --restart always \\\r\n  -e RINNAI_USERNAME=yourphone \\\r\n  -e RINNAI_PASSWORD=yourpassword \\\r\n  -e LOCAL_MQTT_HOST=yourhamqtt \\\r\n  -e LOCAL_MQTT_PORT=yourhamqttport \\\r\n  -e LOCAL_MQTT_USERNAME=test \\\r\n  -e LOCAL_MQTT_PASSWORD=test \\\r\n  -e LOCAL_MQTT_TLS=False \\\r\n  -e LOGGING=True \\\r\n  ghcr.io/palafin02back/rinnai_mqtt_ha:release\r\n```\r\n\r\n### Docker Compose\r\n\r\n```yaml\r\nversion: \"3.8\"\r\nservices:\r\n  rinnai_mqtt:\r\n    image: ghcr.io/palafin02back/rinnai_mqtt_ha:release\r\n    restart: always\r\n    environment:\r\n      - RINNAI_USERNAME=yourphone\r\n      - RINNAI_PASSWORD=yourpassword\r\n      - LOCAL_MQTT_HOST=yourhamqtt\r\n      - LOCAL_MQTT_PORT=yourhamqttport\r\n      - LOCAL_MQTT_USERNAME=test\r\n      - LOCAL_MQTT_PASSWORD=test\r\n      - LOCAL_MQTT_TLS=False\r\n      - LOGGING=True\r\n```\r\n\r\n## 工作原理\r\n\r\n本项目通过以下步骤将林内设备集成到 Home Assistant：\r\n\r\n1. **连接林内 MQTT:** 使用配置的用户名和密码连接林内官方的 MQTT 服务器。\r\n2. **数据处理:**  接收并解析林内 MQTT 服务器推送的消息。\r\n3. **发布到本地 MQTT:** 将解析后的设备状态和数据发布到您配置的本地 MQTT Broker。\r\n4. **Home Assistant 自动发现:** Home Assistant 通过 MQTT 自动发现集成的林内设备。\r\n\r\n## 效果展示\r\n\r\nHome Assistant 中 MQTT 可以自行发现：\r\n\r\n![image](https://github.com/user-attachments/assets/4ec03ab1-56ab-4574-9f59-13eea7ad464c)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpalafin02back%2Frinnai_mqtt_ha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpalafin02back%2Frinnai_mqtt_ha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpalafin02back%2Frinnai_mqtt_ha/lists"}