SMA Solar

The SMA Solar integration will poll a SMA (US) solar inverter, energy meter or battery inverter and present the values as sensors in Home Assistant.

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.

  • Go to Settings > Devices & Services.

  • 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