SAJ Solar Inverter
The SAJ Solar Inverter integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] polls a SAJ solar inverter through its local web interface and presents the values as sensors in Home Assistant.
Before you start, make sure you can open the inverter’s local web interface in a browser on your network. Not every SAJ connection module provides a local web interface.
There is a difference between inverters that are connected via an Ethernet module and those connected via a Wi-Fi module. The Wi-Fi module requires a username and password for authentication where the Ethernet module does not.
Supported devices
The following connection modules are known to work with this integration when they expose a local web interface:
- Ethernet connection modules
- Older Wi-Fi modules such as WiFi-D and OLED
Unsupported devices
The following connection modules are not supported by this integration:
- AIO3. This module does not expose the local web interface required by this integration.
Configuration
Configuration
To add the SAJ Solar Inverter hub to your Home Assistant instance, use this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select SAJ Solar Inverter.
-
Follow the instructions on screen to complete the setup.
Username for logging in to SAJ Solar Inverter (only used when type is ‘wifi’ but can be skipped if the inverter still has the default credentials, which may be empty).
During setup, you will be prompted to select the connection type (Ethernet or Wi-Fi) and provide the necessary information. Wi-Fi connections may require username and password.
Sensors
Energy sensors
The integration provides the following energy-related sensors:
| name | Unit | Description |
|---|---|---|
| current_power | W | Current power generated by the inverter. |
| today_yield | kWh | Power yield for today. |
| today_time | h | Inverter’s running time for today. |
| today_max_current | W | Maximum current power for today. (only for connection via ethernet module) |
| total_yield | kWh | Total kWh generated to date. |
| total_time | h | Total running time of the inverter. |
| total_co2_reduced | kg | Total CO2 in kg reduced. |
| temperature | °C | Temperature of the inverter. |
| state | N/A | Live state of the inverter. |
Diagnostic sensors
The integration also provides diagnostic sensors that help you understand and troubleshoot the connection to your inverter.
The diagnostic sensors are:
-
Inverter IP address
- Unit: None
- Description: Shows the IP address that Home Assistant currently uses to connect to the inverter, which is useful when your router assigns dynamic IP addresses
-
Connection type
- Unit: None
- Description: Indicates whether the integration is using the Ethernet module or the Wi-Fi module to communicate with the inverter
-
Serial number
- Unit: None
- Description: Displays the inverter serial number as reported by the device, which can help you match the device in Home Assistant with labels on the physical inverter or with entries in the SAJ web interface
Troubleshooting
This integration does not support automatic discovery. Set it up manually by entering the inverter IP address or hostname.
For Wi-Fi connections, ensure you’re using the correct credentials.
If setup fails because Home Assistant cannot reach the inverter, confirm that you can open the inverter’s local web interface in a browser. If there is no local web interface (for example with an AIO3 module), this integration cannot connect. See Unsupported devices.