mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-24 11:06:51 +00:00
90 lines
3.4 KiB
Markdown
90 lines
3.4 KiB
Markdown
---
|
|
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
|
|
ha_platforms:
|
|
- sensor
|
|
ha_integration_type: integration
|
|
related:
|
|
- docs: /docs/configuration/
|
|
title: Configuration file
|
|
ha_quality_scale: legacy
|
|
---
|
|
|
|
The `saj` {% term integration %} 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 {% term integration %}, add the following lines to your {% term "`configuration.yaml`" %} file.
|
|
{% include integrations/restart_ha_after_config_inclusion.md %}
|
|
|
|
```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
|
|
```
|