Sensors

TIP

You can find all sensors names in the definitions here: https://github.com/kellerza/sunsynk/blob/main/src/sunsynk/definitions

You can add sensors under the SENSORS and SENSORS_FIRST_INVERTER keys in the configuration.

If you want to add the Battery SOC sensor, you can use any of the following formats. In the logs you will see the first format (no spaces and all lower case).

SENSORS:
  - battery_soc
  - Battery SOC
  - battery_SOC

This page lists common sensors that can also be added through sensor groups. You can find all the supported sensor names in the sensor definition files, or even use the Modbus protocol document to create your own definitions.

Sensor definitions

The sensor definitions include the modbus register number (or several registers), the name of the sensor, the unit and other optional parameters. For example:

Sensor(183, "Battery voltage", VOLT, 0.01),
Sensor(184, "Battery SOC", "%"),

The last parameter in the battery voltage sensor definition is a factor, in this case a value of 1 in the register represents 0.01V. When the factor is negative for normal sensors it indicates that the number in the register is Signed (it can be negative & positive)

To enable both these sensors in your configuration, simply use the names:

SENSORS:
  - battery_voltage
  - battery_soc

You can find the details of the definitions here and definitions are selected in the configuration with one of the following options:

SENSOR_DEFINITIONS: single-phase / three-phase [low voltage] / three-phase-hv [high voltage]

Groups of sensors

Sensor groups will allow you to add several sensors with a single entry.

All sensors

The all group will include all the sensors available for your inverter.

SENSORS:
  - all

Adding all sensors will cause Home Assistant to record a great amount of data, that you might not need. This could lead to a large database and slow down your system. It is especially bad if you are using an SD card for your Home Assistant installation.

Rather consider using the other groups or selecting the sensors you need.

WARNING

It is not recommended to add all sensors for your final system. This is mainly for testing purposes.

Energy management

These sensors are mostly related to energy or kWh and required for the Home Assistant Energy Management

SENSORS:
  - energy_management

Sensors included

total_battery_charge
total_battery_discharge
total_grid_export
total_grid_import
total_pv_energy

Power flow card: power_flow_card

These are all sensors used by the Power Flow Card

SENSORS:
  - power_flow_card

Sensors included

aux_power
battery_current
battery_power
battery_soc
battery_voltage
day_battery_charge
day_battery_discharge
day_grid_export
day_grid_import
day_load_energy
day_pv_energy
essential_power
grid_connected
grid_ct_power
grid_frequency
grid_power
grid_voltage
inverter_current
inverter_power
load_frequency
non_essential_power
overall_state
priority_load
pv1_current
pv1_power
pv1_voltage
use_timer

Settings

Sensors used for changing the System Operating Mode - see here

These can be under SENSORS or SENSORS_FIRST_INVERTER

SENSORS_FIRST_INVERTER:
  - settings

Sensors included

load_limit
prog1_capacity
prog1_charge
prog1_power
prog1_time
prog2_capacity
prog2_charge
prog2_power
prog2_time
prog3_capacity
prog3_charge
prog3_power
prog3_time
prog4_capacity
prog4_charge
prog4_power
prog4_time
prog5_capacity
prog5_charge
prog5_power
prog5_time
prog6_capacity
prog6_charge
prog6_power
prog6_time

My Sensors

All your custom sensors can be added to the configuration using the mysensors group.

SENSORS:
  - mysensors