{"id":23463922,"url":"https://github.com/firstof9/ha-renogy","last_synced_at":"2026-03-03T21:03:12.559Z","repository":{"id":267985686,"uuid":"902625367","full_name":"firstof9/ha-renogy","owner":"firstof9","description":"Integration for Renogy cloud API","archived":false,"fork":false,"pushed_at":"2025-03-28T18:15:35.000Z","size":98,"stargazers_count":8,"open_issues_count":5,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-14T08:14:38.915Z","etag":null,"topics":["hacktoberfest","home-assistant","home-assistant-integration","renogy"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/firstof9.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"firstof9","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"firstof9","thanks_dev":null,"custom":null}},"created_at":"2024-12-13T00:04:59.000Z","updated_at":"2025-04-07T17:34:37.000Z","dependencies_parsed_at":null,"dependency_job_id":"2694907b-8f68-4ef1-ad69-7e636a066267","html_url":"https://github.com/firstof9/ha-renogy","commit_stats":null,"previous_names":["firstof9/ha-renogy"],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstof9%2Fha-renogy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstof9%2Fha-renogy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstof9%2Fha-renogy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstof9%2Fha-renogy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firstof9","download_url":"https://codeload.github.com/firstof9/ha-renogy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248843950,"owners_count":21170495,"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":["hacktoberfest","home-assistant","home-assistant-integration","renogy"],"created_at":"2024-12-24T09:17:33.569Z","updated_at":"2026-03-03T21:03:12.553Z","avatar_url":"https://github.com/firstof9.png","language":"Python","funding_links":["https://github.com/sponsors/firstof9","https://buymeacoffee.com/firstof9","https://www.buymeacoffee.com/firstof9"],"categories":[],"sub_categories":[],"readme":"# renogy\n\n[![GitHub Release][releases-shield]][releases]\n[![GitHub Activity][commits-shield]][commits]\n[![License][license-shield]](LICENSE)\n\n[![hacs][hacsbadge]][hacs]\n![Project Maintenance][maintenance-shield]\n[![BuyMeCoffee][buymecoffeebadge]][buymecoffee]\n\n[![Discord][discord-shield]][discord]\n[![Community Forum][forum-shield]][forum]\n\n_Component to integrate with [Renogy][renogy] connected products._\n\n**This component will set up the following platforms.**\n\nPlatform | Description\n-- | --\n`binary_sensor` | On/Off sensors for various settings.\n`sensor` | Show info from an Renogy's API.\n\n## Obtaining your Renogy API Keys\n\nYou will require two keys to use this integration. The keys can be obtained at Renogy's deveopler platform here:\n\nhttps://platform.renogy.com/\n\nOnce you are logged in, click on your name at the top right, and click on \"API Key\". From here, click on \"Create New Key\". The first key that will be shown is your secret key or the key that starts with `sk`.  Copy paste this key because it only shows it once. Then, when you press ok, it shows you the second key or the access key or `ak` key. You can always go back and see the ak key but not the sk key. If you lose or forget the sk key, just delete it and make a new one.\n\nYou can make more than one set of keys, if you wish.\n\nPlease note that the email associated with your API account must be the same email that your hub is paired to. You can check this in the hub settings. Also, only devices that are paired to the hub will be exposed to the Renogy API. Devices that are connected directly to the DC Home App (i.e. via BT with your phone) or older Renogy apps, will not be exposed to the API.\n\nCurrently (Jan 2025), the API does not support control of devices and can only read information. This will be added to the API in the future.\n\n## Installation via HACS (recommended)\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=firstof9\u0026repository=ha-renogy\u0026category=integration)\n\n1. Follow the link [here](https://hacs.xyz/docs/faq/custom_repositories/)\n2. Use the custom repo link https://github.com/firstof9/ha-renogy\n3. Select the category type `integration`\n4. Then once it's there (still in HACS) click the INSTALL button\n5. Restart Home Assistant\n6. Once restarted, in the HA UI go to `Configuration` (the ⚙️ in the lower left) -\u003e `Devices and Services` click `+ Add Integration` and search for `renogy`\n\n## Manual (non-HACS)\n\u003cdetails\u003e\n\u003csummary\u003eInstructions\u003c/summary\u003e\n\n\u003cbr\u003e\nYou probably do not want to do this! Use the HACS method above unless you know what you are doing and have a good reason as to why you are installing manually\n\u003cbr\u003e\n\n1. Using the tool of choice open the directory (folder) for your HA configuration (where you find `configuration.yaml`).\n2. If you do not have a `custom_components` directory (folder) there, you need to create it.\n3. In the `custom_components` directory (folder) create a new folder called `renogy`.\n4. Download _all_ the files from the `custom_components/renogy/` directory (folder) in this repository.\n5. Place the files you downloaded in the new directory (folder) you created.\n6. Restart Home Assistant\n7. Once restarted, in the HA UI go to `Configuration` (the ⚙️ in the lower left) -\u003e `Devices and Services` click `+ Add Integration` and search for `renogy`\n\u003c/details\u003e\n\n## Configuration is done in the UI\n\n### Device ID Guide\n\nWhen using **Hub Mode** (multiple devices connected to one BT-2 via Communication Hub):\n\nDevice Type | Standalone | Hub Mode\n-------------|------------|----------\nController | 255 | 96, 97\nBattery | 255 | 48, 49, 50\nInverter | 255, 32 | 32\n\nFor **separate BT modules** (one per device), use `device_id: 255`.\n\n\u003c!----\u003e\n\n## Exposed Entities\n\nThis is dependent on the type of device. Here are some examples of the entities that are exposed for the ONE Core and its connected devices.\n\nRenogy ONE Core and connected devices:\n\n![image](https://github.com/user-attachments/assets/abe93dd1-5153-41f4-8e89-127a4d1b0d00)\n\nRenogy 100 ah self-heating battery (RBT100LFP12SH-G1)\n\n![image](https://github.com/user-attachments/assets/7b40dda1-f658-4995-977f-198e1f13df76)\n\nRenogy Rover 40 Li (RNG-CTRL-RVR40)\n\n![image](https://github.com/user-attachments/assets/81b31b88-1118-4974-9ddf-45467d7b689e)\n\nRenogy Pure Sine Wave 1000 Inverter (RINVTPGH110111S)\n\n![image](https://github.com/user-attachments/assets/483f5b5a-0af8-4920-84e7-19abecbf22f4)\n\n## Contributions are welcome!\n\nIf you want to contribute to this please read the [Contribution guidelines](CONTRIBUTING.md)\n\n***\n\n## TODO\n\n- [x] Add tests\n- [x] Code\n- [ ] Add more tests\n\n\n[renogy]: https://renogy.com/\n[integration_blueprint]: https://github.com/firstof9/ha-renogy\n[buymecoffee]: https://www.buymeacoffee.com/firstof9\n[buymecoffeebadge]: https://img.shields.io/badge/buy%20me%20a%20coffee-donate-yellow.svg?style=for-the-badge\n[commits-shield]: https://img.shields.io/github/commit-activity/y/firstof9/ha-renogy.svg?style=for-the-badge\n[commits]: https://github.com/firstof9/ha-renogy/commits/main\n[hacs]: https://github.com/custom-components/hacs\n[hacsbadge]: https://img.shields.io/badge/HACS-Custom-orange.svg?style=for-the-badge\n[discord]: https://discord.gg/Qa5fW2R\n[discord-shield]: https://img.shields.io/discord/330944238910963714.svg?style=for-the-badge\n[exampleimg]: example.png\n[forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg?style=for-the-badge\n[forum]: https://community.home-assistant.io/\n[license-shield]: https://img.shields.io/github/license/firstof9/ha-renogy.svg?style=for-the-badge\n[maintenance-shield]: https://img.shields.io/badge/maintainer-Chris%20Nowak%20%40firstof9-blue.svg?style=for-the-badge\n[releases-shield]: https://img.shields.io/github/release/firstof9/ha-renogy.svg?style=for-the-badge\n[releases]: https://github.com/firstof9/ha-renogy/releases\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirstof9%2Fha-renogy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirstof9%2Fha-renogy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirstof9%2Fha-renogy/lists"}