home-assistant.io/source/_integrations/saj.markdown

title	description	ha_category	ha_iot_class	ha_release	ha_codeowners	ha_domain	ha_platforms	ha_integration_type	related	ha_quality_scale
SAJ Solar Inverter	Instructions on how to connect your SAJ Solar Inverter to Home Assistant.	Energy	Local Polling	0.100	@fredericvl	saj	sensor	integration	docs title /docs/configuration/ Configuration file	legacy

The saj {% term integration %} 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 {% term integration %}, add the following lines to your {% term "configuration.yaml" %} file. {% include integrations/restart_ha_after_config_inclusion.md %}

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

{% configuration %} host: description: "The IP address of the SAJ Solar Inverter." required: true type: string name: description: "An optional name for your SAJ Solar Inverter." required: false type: string type: description: "Type of connection module: 'ethernet' or 'wifi'" required: false default: ethernet type: string username: description: "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)" required: false type: string password: description: "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)" required: false type: string {% endconfiguration %}

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