2024.12.5
Home ▸ Integrations ▸

SAJ Solar Inverter

The saj integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] will poll a SAJ solar inverter and present the values as sensors in Home Assistant.

This sensor uses the web interface and to use it, you have to be able to connect to the solar inverter from your favorite web browser.

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.

Configuration

To enable this integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more], add the following lines to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.

# Example configuration.yaml entry
sensor:
  - platform: saj
    host: IP_ADDRESS_OF_DEVICE

Configuration Variables

Looking for your configuration file?
host string Required

The IP address of the SAJ Solar Inverter.

name string (Optional)

An optional name for your SAJ Solar Inverter.

type string (Optional, default: ethernet)

Type of connection module: ‘ethernet’ or ‘wifi’

username string (Optional)

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 set: admin/admin)

password string (Optional)

Password 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 set: admin/admin)

Sensors

Sensors available in the library:

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.

Full configuration example for Wi-Fi inverters 

sensor:
  - platform: saj
    name: MY_INVERTER_NAME
    host: IP_ADDRESS_OF_DEVICE
    type: wifi
    username: USERNAME
    password: PASSWORD

Related topics