renogy

Component to integrate with Renogy connected products.

This component will set up the following platforms.

Platform	Description
binary_sensor	On/Off sensors for various settings.
sensor	Show info from an Renogy's API.

Obtaining your Renogy API Keys

You will require two keys to use this integration. The keys can be obtained at Renogy's deveopler platform here:

https://platform.renogy.com/

Once 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.

You can make more than one set of keys, if you wish.

Please 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.

Currently (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.

Installation via HACS (recommended)

1. Follow the link here
2. Use the custom repo link https://github.com/firstof9/ha-renogy
3. Select the category type integration
4. Then once it's there (still in HACS) click the INSTALL button
5. Restart Home Assistant
6. Once restarted, in the HA UI go to Configuration (the ⚙️ in the lower left) -> Devices and Services click + Add Integration and search for renogy

Manual (non-HACS)

Instructions

You 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

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called renogy.
4. Download all the files from the custom_components/renogy/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant
7. Once restarted, in the HA UI go to Configuration (the ⚙️ in the lower left) -> Devices and Services click + Add Integration and search for renogy

Configuration is done in the UI

Exposed Entities

This is depedent on type of device. Here are some examples of the entities that are exposed for the ONE Core and its connected devices.

Renogy ONE Core and connected devices:

Renogy 100 ah self-heating battery (RBT100LFP12SH-G1)

Renogy Rover 40 Li (RNG-CTRL-RVR40)

Renogy Pure Sine Wave 1000 Inverter (RINVTPGH110111S)

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

---

TODO

• Add tests
• Code