mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-22 10:06:49 +00:00
83 lines
3.2 KiB
Markdown
83 lines
3.2 KiB
Markdown
---
|
|
title: SAJ Solar Inverter
|
|
description: Instructions on how to connect your SAJ Solar Inverter to Home Assistant.
|
|
ha_category:
|
|
- Energy
|
|
logo: saj.png
|
|
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
|
|
```
|