home-assistant.io/source/_integrations/sma.markdown

---
title: SMA Solar
description: Instructions on how to connect your SMA Solar Inverter to Home Assistant.
ha_category:
  - Energy
ha_iot_class: Local Polling
ha_config_flow: true
ha_release: 0.36
ha_codeowners:
  - '@kellerza'
  - '@rklomp'
  - '@erwindouna'
ha_domain: sma
ha_platforms:
  - diagnostics
  - sensor
ha_integration_type: integration
ha_dhcp: true
---

The SMA Solar integration will poll a [SMA](http://www.sma-solar.com/) [(US)](https://www.sma-america.com/) solar inverter, energy meter or battery inverter and present the values as sensors in Home Assistant.


{% include integrations/config_flow.md %}

### Installation details

When Home Assistant discovers a new SMA device, or when you manually add one, the following form is presented:

- **Host**: the hostname or IP address (if discovered via DHCP, this field will not be displayed as it's known via discovery)
- Use SSL certificate
- Verify SSL certificate
- **Group**: choose either **user** or **installer** (default: **user**). Ask your installer if you’re unsure which to use
- **Password**: use your password or ask your installer the default password that has been set up

## 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](https://github.com/rklomp/pysma/blob/master/pysma/definitions.py).

### 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 |