This component will set up the following platforms.
| Platform | Description |
|---|---|
sensor |
Show info from RCT Power API. |
- Install the "RCT Power" integration using HACS.
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "RCT Power"
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml). - If you do not have a
custom_componentsdirectory (folder) there, you need to create it. - In the
custom_componentsdirectory (folder) create a new folder calledrct_power. - Download all the files from the
custom_components/rct_power/directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "RCT Power"
Upon installation the integration accepts the following configuration parameters:
Host name: The local IP address or host name of the inverter.Port: The port of the inverter's API, defaults to8899.Name: This name is used as a prefix to the entities created by this integration and can be used to disambiguate multiple inverters.
After installation the integration allows for the following configuration parameters to be changed:
Frequent polling interval: The polling interval in seconds for entities updated frequently, defaults to30.Infrequent polling interval: The polling interval in seconds for entities updated infrequently, defaults to180.Static polling interval: The polling interval in seconds for entities updated seldomly, defaults to3600.
You can use the entities provided by this integration on Home Assistant's built-in energy dashboard. For that purpose, navigate to "Configuration" -> "Energy" and choose the following entities.
Please note that the entity names in your installation are prefixed with the inverter name chosen during installation of the integration, so interpret the entity names mentioned below to be entity name suffixes.
Also note that after configuration the energy dashboard might take several hours to show any data, because Home Assistant calculates the underlying statistics only on an hourly basis.
| Configuration item | Entity name | Note |
|---|---|---|
| Grid consumption | Grid Energy Consumption Total |
|
| Return to grid | Grid Energy Production Absolute Total |
Make sure to use the "Absolute" variant of this entity |
You can configure the two generator strings A and B separately or combined depending on your preference.
| Configuration item | Entity name |
|---|---|
| Solar Production | Generator A Energy Production Total |
| Solar Production | Generator B Energy Production Total |
| Configuration item | Entity name |
|---|---|
| Solar Production | All Generators Energy Production Total |
| Configuration item | Entity name |
|---|---|
| Battery systems - Energy going into the battery | Battery Stored Energy |
| Battery systems - Energy coming out of the battery | Battery Used Energy |
| Entity name | Unit | Description |
|---|---|---|
| Grid Frequency | Hz | the instantaneous overall grid frequency |
| Grid Frequency P1/P2/P3 | Hz | the instantaneous grid frequency on phase 1/2/3 |
| Grid Power | W | the instantaneous power consumed from (> 0) or fed into (< 0) the grid |
| Grid Power P1/P2/P3 | W | the instantaneous power consumed from or fed into the grid on phase 1/2/3 |
| Grid Voltage P1/P2/P3 | W | the instantaneous grid voltage on phase 1/2/3 |
| Grid Energy Consumption Day/Month/Year/Total | Wh | the cumulative energy consumed from the grid |
| Grid Energy Production Day/Month/Year/Total | Wh | the cumulative energy fed into the grid |
| Grid Energy Production Absolute Total | kWh | the absolute value of the cumulative energy fed into the grid since installation |
| Grid Maximum Feed Power | W | the maximum power the inverter is configured to feed into the grid |
| Entity name | Unit | Description |
|---|---|---|
| Battery Power | W | the instantaneous power consumed from (> 0) or fed into (< 0) the battery |
| Battery Current | A | the instantaneous current flowing from or to the battery |
| Battery Voltage | V | the instantaneous voltage of the battery |
| Battery Temperature | °C | the instantaneous temperature of the battery |
| Battery Cycles | the recorded full charge/discharge cycles of the battery | |
| Battery State of Charge | % | the instantaneous state of charge of the battery |
| Battery State of Charge Target | % | the state of charge of the battery aimed for by the system |
| Battery State of Health | % | the estimated state of health of the battery |
| Battery Stored Energy | Wh | the cumulative energy fed into the battery |
| Battery Used Energy | Wh | the cumulative energy consumed from the battery |
| Entity name | Unit | Description |
|---|---|---|
| Consumer Energy Consumption Day/Month/Year/Total | Wh | the cumulative energy consumed by the household (from any source) |
| Consumer Power | W | the instantaneous power consumed by the household |
| Consumer Power P1/P2/P3 | W | the instantaneous power consumed by the household on phase 1/2/3 |
| External Energy Production Day/Month/Year/Total | Wh | the cumulative energy produced by the external producer (if installed) |
| Entity name | Unit | Description |
|---|---|---|
| Generator A Energy Production Day/Month/Year/Total | Wh | the cumulative energy produced by generator string A |
| Generator B Energy Production Day/Month/Year/Total | Wh | the cumulative energy produced by generator string B |
| All Generators Energy Production Total | Wh | the sum of the cumulative energy produced by both generator strings |
| Generator A Power | W | the instantaneous power produced by generator string A |
| Generator B Power | W | the instantaneous power produced by generator string B |
| All Generators Power | W | the sum of the instantaneous power produced by both generator strings |
| Generator A Voltage | V | the instantaneous voltage produced by generator string A |
| Generator B Voltage | V | the instantaneous voltage produced by generator string B |
| Generator Maximum Power | W | the configured combined maximum power of both generator strings |
| Insulation Resistance | Ohm | |
| Insulation Resistance Positive/Negative Input | Ohm | |
| Minimum Insulation Resistance | Ohm |
| Entity name | Unit | Description |
|---|---|---|
| Inverter AC Power | W | the instantaneous AC power transmitted by the inverter |
| Inverter Energy Production Day/Month/Year/Total | Wh | the cumulative energy produced by the inverter |
| Inverter Power P1/P2/P3 | W | the instantaneous power consumed or generated by the inverter |
| Inverter Serial Number | the serial number of the inverter | |
| Faults | a bitmask of the failures reported by the inverter |
If you want to contribute to this please read the Contribution guidelines
This would have been a lot more difficult if not for @svalouch's python-rctclient library. Thank you!
This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.
Code template was mainly taken from @Ludeeus's integration_blueprint template