---
title: SAJ Solar Inverter
description: Instructions on how to connect your SAJ Solar Inverter to Home Assistant.
ha_category:
  - Energy
ha_iot_class: Local Polling
ha_release: '0.100'
ha_codeowners:
  - '@fredericvl'
ha_domain: saj
---

The `saj` sensor will poll a [SAJ](https://www.saj-electric.com/) 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 sensor, add the following lines to your `configuration.yaml` file:

```yaml
# 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

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