ha-renac

Home assistant custom component to support Renac Solar Inverter Only On-Grid type of Inverters (R3-xK-DT) are supported. The NV3-HV kind of Hybrid Inverter may work but requires testing due to the recent changes on the Renac API.

Breaking changes as from version 0.1.x

As from version 0.1.3, the configuration is now done through the UI. Remove the renac: section from the configuration.yml and configure the component from the UI directly. The name of the various sensors also changed to include the name of the equipment (for future support of multiple equipements) This version also includes a tentative support for the Hybrid Inverters. This hasn't been tested since I don't have access to it. I added the sensors that were proposed in one of the reported issues. The session management should also be a bit more robust. The whole logic to interact with the Renac back-end server has been moved to the pyrenac project and has also been updated to use async logic everywhere. This is a requirement if we want to include this component as part of the official intergrations. This version also includes a service to sync the recorder data (to fix wrong/missing long term statistics). So far all my attempts where rather unsuccessful in the way that the imported data looked good, but all subsequent data were broken... so don't use it unless you want to break everything have have to fix the recorder database by hand...

⚠️ Known Limitations

• The hybrid inverter changes in this PR (expanded sensors, new binary_sensor platform) were verified live against an N3-HV-10.0 hybrid inverter only. They rely on two fixes to the pyrenac package itself - correct hybrid-inverter detection and a missing signature header - proposed separately in gastush/pyrenac#4. Until that's merged and released, hybrid inverters still won't be detected correctly even with this PR applied.
• The on-grid sensor field names (SUM_ENERGY, OUTPUT_POWER, PV1_VOL, etc. in ONGRID_SENSORS) were left untouched and have not been re-verified against the current RENAC Cloud API - given the API has changed multiple times (see #21, #26), they may or may not still be accurate. Reports from on-grid owners testing against current hardware are very welcome.

🛠️ Installation

Method 1: HACS (Recommended)

Step 1 — Add this repository to HACS:

If the button doesn't work, add manually:

1. Open HACS → Integrations → click the ⋮ menu → Custom repositories
2. Add this repository URL and select category Integration
3. Find Renac Solar Inveter in the HACS store and click Download
4. Restart Home Assistant
5. Go to Settings → Devices & Services → Add Integration → search for Renac Inveter
6. Complete the setup wizard

Method 2: Manual

1. Download or clone this repository
2. Copy the renac/ folder into config/custom_components/:

   config/
   └── custom_components/
       └── renac/
           ├── __init__.py
           ├── config_flow.py
           ├── const.py
           ├── coordinator.py
           ├── entity.py
           ├── manifest.json
           ├── sensor.yaml
           ├── services.yaml
           └── strings.json
   

3. Restart Home Assistant
4. Go to Settings → Devices & Services → Add Integration → search for Renac Inverter

To date, the following sensors are supported :

On-Grid Inverter

• AC generated power (W)
• Today's total generated power (kWh)
• PV 1,2 Voltage (V)
• PV 1,2 Current (A)
• PV 1,2 Power (W)
• R,S,T Voltage (V)
• R,S,T Current (A)
• R,S,T Frquency (Hz)
• Total generated power (kWh)

Hybrid Inverter

• Total Energy (kWh)
• Today's Energy (kWh)
• Load (W)
• PV (W)
• Battery (W)
• Grid (W)
• Charge (%)