SMA Solar
The SMA Solar integration will poll a SMA
Configuration
To add the SMA Solar integration to your Home Assistant instance, use this My button:
Manual configuration steps
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select SMA Solar.
-
Follow the instructions on screen to complete the setup.
Supported Devices
Not all inverters, energy meters and batteries from SMA are supported.
The integration uses the device’s web interface (called webconnect). Before you start, make sure you are able to connect to the solar inverter from your favorite web browser. Devices with the ennexos operating system (like the Tripower X series) and all Energy Meters (SMA Energy Meter and SMA Sunny Home Manager) are not supported.
Sensors
The SMA WebConnect module supports a wide variety of sensors, but not all of these have been mapped in the pysma
library. Currently available sensors can be found below. Feel free to submit additional sensors to be added as standard sensors to the pysma library
Solar Inverter
name | Unit | Description |
---|---|---|
status | Status of the device | |
pv_power | W | Current power provided to the AC side by all the solar panels |
pv_power_a | W | Current power generated on the DC side by the solar panels (A side) |
pv_power_b | W | Current power generated on the DC side by the solar panels (B side) |
pv_voltage_a | V | Current voltage generated by the solar panels (A side) |
pv_voltage_b | V | Current voltage generated by the solar panels (B side) |
pv_current_a | A | Current amperage generated by the solar panels (A side) |
pv_current_b | A | Current amperage generated by the solar panels (B side) |
grid_power | W | Power supplied to the grid by the inverter. grid_power = power_l1 + power_l2 + power_l3 |
frequency | Hz | Grid frequency |
current_l1 | A | Current for phase 1 |
current_l2 | A | Current for phase 2 |
current_l3 | A | Current for phase 3 |
voltage_l1 | V | Voltage for phase 1 |
voltage_l2 | V | Voltage for phase 2 |
voltage_l3 | V | Voltage for phase 3 |
power_l1 | W | Power for phase 1 |
power_l2 | W | Power for phase 2 |
power_l3 | W | Power for phase 3 |
total_yield | kWh | Total energy yield from a solar installation |
daily_yield | Wh | The solar plant’s yield for today |
pv_gen_meter | kWh | Total kWh generated to date |
Optimizers via Inverter
name | Unit | Description |
---|---|---|
optimizer_power_x | W | Power supplied by optimizer X |
optimizer_current_x | A | Current supplied by optimizer X |
optimizer_voltage_x | V | Voltage supplied by optimizer X |
optimizer_temp_x | C | Temperature of optimizer X |
Energy Meter via Inverter
name | Unit | Description |
---|---|---|
metering_power_supplied | W | Power supplied |
metering_power_absorbed | W | Power absorbed |
metering_frequency | Hz | Grid frequency |
metering_total_yield | kWh | Total energy supplied to the grid |
metering_total_absorbed | kWh | Total energy from the grid |
metering_current_l1 | A | Current for phase 1 |
metering_current_l2 | A | Current for phase 2 |
metering_current_l3 | A | Current for phase 3 |
metering_voltage_l1 | V | Voltage for phase 1 |
metering_voltage_l2 | V | Voltage for phase 2 |
metering_voltage_l3 | V | Voltage for phase 3 |
metering_active_power_l1 | W | Active Power for phase 1 |
metering_active_power_l2 | W | Active Power for phase 2 |
metering_active_power_l3 | W | Active Power for phase 3 |
metering_active_power_consumed_l1 | W | Active Power Consumed for phase 1 |
metering_active_power_consumed_l2 | W | Active Power Consumed for phase 2 |
metering_active_power_consumed_l3 | W | Active Power Consumed for phase 3 |
Energy Meter
name | Unit | Description |
---|---|---|
status | Status of the device | |
grid_power | W | Power supplied to the grid. grid_power = power_l1 + power_l2 + power_l3 |
frequency | Hz | Grid frequency. |
current_l1 | A | Current for phase 1 |
current_l2 | A | Current for phase 2 |
current_l3 | A | Current for phase 3 |
voltage_l1 | V | Voltage for phase 1 |
voltage_l2 | V | Voltage for phase 2 |
voltage_l3 | V | Voltage for phase 3 |
power_l1 | W | Power for phase 1 |
power_l2 | W | Power for phase 2 |
power_l3 | W | Power for phase 3 |
Battery Inverter
name | Unit | Description |
---|---|---|
operating_status_general | General operating status | |
inverter_condition | Inverter Condition | |
inverter_system_init | Inverter System Init | |
grid_connection_status | Grid connection status | |
grid_relay_status | Grid relay status | |
insulation_residual_current | mA | Insulation residual current |
current_l1 | A | Current for phase 1 |
current_l2 | A | Current for phase 2 |
current_l3 | A | Current for phase 3 |
current_total | A | Total Current. |
voltage_l1 | V | Voltage for phase 1 |
voltage_l2 | V | Voltage for phase 2 |
voltage_l3 | V | Voltage for phase 3 |
grid_reactive_power | var | Total Reactive Power |
grid_reactive_power_l1 | var | Reactive Power for phase 1 |
grid_reactive_power_l2 | var | Reactive Power for phase 2 |
grid_reactive_power_l3 | var | Reactive Power for phase 3 |
grid_apparent_power | VA | Total Apparent Power |
grid_apparent_power_l1 | VA | Apparent Power for phase 1 |
grid_apparent_power_l2 | VA | Apparent Power for phase 2 |
grid_apparent_power_l3 | VA | Apparent Power for phase 3 |
grid_power_factor | Grid Power factor | |
grid_power_factor_excitation | Grid Power factor excitation | |
battery_soc_total | % | Total battery state of charge |
battery_soc_a | % | State of charge battery A |
battery_soc_b | % | State of charge battery B |
battery_soc_c | % | State of charge battery C |
battery_voltage_a | V | Voltage battery A |
battery_voltage_b | V | Voltage battery B |
battery_voltage_c | V | Voltage battery C |
battery_current_a | A | Current battery A |
battery_current_b | A | Current battery B |
battery_current_c | A | Current battery C |
battery_temp_a | C | Temperature battery A |
battery_temp_b | C | Temperature battery B |
battery_temp_c | C | Temperature battery C |
battery_status_operating_mode | Battery status operating mode | |
battery_capacity_total | % | Total battery capacity |
battery_capacity_a | % | Capacity battery A |
battery_capacity_b | % | Capacity battery B |
battery_capacity_c | % | Capacity battery C |
battery_charging_voltage_a | V | Charging voltage battery A |
battery_charging_voltage_b | V | Charging voltage battery B |
battery_charging_voltage_c | V | Charging voltage battery C |
battery_power_charge_total | W | Total charging power |
battery_power_charge_a | W | Charging power battery A |
battery_power_charge_b | W | Charging power battery B |
battery_power_charge_c | W | Charging power battery C |
battery_charge_total | kWh | Total charge |
battery_charge_a | kWh | Charge battery A |
battery_charge_b | kWh | Charge battery B |
battery_charge_c | kWh | Charge battery C |
battery_power_discharge_total | W | Total discharging power |
battery_power_discharge_a | W | Disharging power battery A |
battery_power_discharge_b | W | Disharging power battery B |
battery_power_discharge_c | W | Disharging power battery C |
battery_discharge_total | kWh | Total discharge |
battery_discharge_a | kWh | Discharge battery A |
battery_discharge_b | kWh | Discharge battery A |
battery_discharge_c | kWh | Discharge battery A |
inverter_power_limit | W | Power limit of the Inverter |