# SMA

<!-- BEGIN GENERATED: __badges_sma__ -->
<span class="badge stable">STABLE</span> <span class="badge origin-nymea">NYMEA</span> <span class="badge consumer">CONSUMER</span>

Connect to SMA solar equipment.

<!-- END GENERATED -->

_Installation guide coming soon._

## Reference

<!-- BEGIN GENERATED: integrationpluginsma.json -->
!!! info "Application labels"
    The keys and labels below are the ones the application shows,
    **in English**. They are left verbatim so that you find them
    word for word on screen.

**Manufacturer:** SMA Solar Technology AG  
**Plugin:** `sma`

#### Supported models
| Model | Role | Transport | Pairing | Quantities |
| --- | --- | --- | --- | --- |
| **SMA Sunny WebBox** | solarinverter | Modbus TCP | Auto-discovery / Manual | 6 |
| **SMA Energy Meter** | Energy meter | — | Auto-discovery / Manual | 20 |
| **SMA Inverter** | solarinverter | Modbus TCP | Auto-discovery / Manual | 14 |
| **SMA Battery** | energystorage | — | Automatic | 9 |
| **SMA Solar Inverter (Modbus)** | solarinverter | Modbus TCP | Auto-discovery / Manual | 14 |
| **SMA Battery Inverter (Modbus)** | energystorage | Modbus TCP | Auto-discovery / Manual | 7 |

#### Per-model detail
??? abstract "SMA Sunny WebBox — `sunnyWebBox`"
    _Settings:_

    | Key | Label | Type | Range | Default | Read-only |
    | --- | --- | --- | --- | --- | --- |
    | `address` | Host address | QString | — | — | no |
    | `hostName` | Host name | QString | — | — | no |
    | `macAddress` | MAC address | QString | — | — | yes |

    _Measured quantities:_

    | Key | Quantity | Type | Unit |
    | --- | --- | --- | --- |
    | `connected` | Connected | bool | — |
    | `currentPower` | Current power | double | Watt |
    | `dayEnergyProduced` | Day energy produced | double | KiloWattHour |
    | `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
    | `mode` | Mode | QString | — |
    | `error` | Error | QString | — |

??? abstract "SMA Energy Meter — `speedwireMeter`"
    _Settings:_

    | Key | Label | Type | Range | Default | Read-only |
    | --- | --- | --- | --- | --- | --- |
    | `serialNumber` | Serial number | QString | — | — | yes |
    | `modelId` | Model ID | uint | — | — | yes |

    _Measured quantities:_

    | Key | Quantity | Type | Unit |
    | --- | --- | --- | --- |
    | `connected` | Connected | bool | — |
    | `voltagePhaseA` | Voltage phase A | double | Volt |
    | `voltagePhaseB` | Voltage phase B | double | Volt |
    | `voltagePhaseC` | Voltage phase C | double | Volt |
    | `currentPhaseA` | Current phase A | double | Ampere |
    | `currentPhaseB` | Current phase B | double | Ampere |
    | `currentPhaseC` | Current phase C | double | Ampere |
    | `currentPower` | Current power | double | Watt |
    | `currentPowerPhaseA` | Current power phase A | double | Watt |
    | `currentPowerPhaseB` | Current power phase B | double | Watt |
    | `currentPowerPhaseC` | Current power phase C | double | Watt |
    | `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
    | `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
    | `energyConsumedPhaseA` | Energy consumed phase A | double | KiloWattHour |
    | `energyConsumedPhaseB` | Energy consumed phase B | double | KiloWattHour |
    | `energyConsumedPhaseC` | Energy consumed phase C | double | KiloWattHour |
    | `energyProducedPhaseA` | Energy produced phase A | double | KiloWattHour |
    | `energyProducedPhaseB` | Energy produced phase B | double | KiloWattHour |
    | `energyProducedPhaseC` | Energy produced phase C | double | KiloWattHour |
    | `firmwareVersion` | Firmware version | QString | — |

??? abstract "SMA Inverter — `speedwireInverter`"
    _Settings:_

    | Key | Label | Type | Range | Default | Read-only |
    | --- | --- | --- | --- | --- | --- |
    | `address` | Host address | QString | — | — | no |
    | `hostName` | Host name | QString | — | — | no |
    | `macAddress` | MAC address | QString | — | — | yes |
    | `serialNumber` | Serial number | QString | — | — | yes |
    | `modelId` | Model ID | uint | — | `0` | yes |

    _Measured quantities:_

    | Key | Quantity | Type | Unit |
    | --- | --- | --- | --- |
    | `connected` | Connected | bool | — |
    | `voltagePhaseA` | Voltage phase A | double | Volt |
    | `voltagePhaseB` | Voltage phase B | double | Volt |
    | `voltagePhaseC` | Voltage phase C | double | Volt |
    | `currentPhaseA` | Current phase A | double | Ampere |
    | `currentPhaseB` | Current phase B | double | Ampere |
    | `currentPhaseC` | Current phase C | double | Ampere |
    | `currentPower` | Current power | double | Watt |
    | `currentPowerMpp1` | DC power MPP1 | double | Watt |
    | `currentPowerMpp2` | DC power MPP2 | double | Watt |
    | `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
    | `energyProducedToday` | Energy produced today | double | KiloWattHour |
    | `frequency` | Frequency | double | Hertz |
    | `firmwareVersion` | Firmware version | QString | — |

??? abstract "SMA Battery — `speedwireBattery`"
    _Measured quantities:_

    | Key | Quantity | Type | Unit |
    | --- | --- | --- | --- |
    | `connected` | Connected | bool | — |
    | `voltage` | Voltage | double | Volt |
    | `current` | Current | double | Ampere |
    | `temperature` | Temperature | double | DegreeCelsius |
    | `currentPower` | Current power | double | Watt |
    | `capacity` | Available energy | double | KiloWattHour |
    | `batteryCritical` | Battery critical | bool | — |
    | `batteryLevel` | Battery level | int | Percentage |
    | `chargingState` | Charging state | QString | — |

??? abstract "SMA Solar Inverter (Modbus) — `modbusSolarInverter`"
    _Settings:_

    | Key | Label | Type | Range | Default | Read-only |
    | --- | --- | --- | --- | --- | --- |
    | `address` | Host address | QString | — | — | no |
    | `hostName` | Host name | QString | — | — | no |
    | `macAddress` | MAC address | QString | — | — | no |
    | `port` | Port | int | — | `502` | no |
    | `slaveId` | Slave ID | int | — | `3` | no |
    | `serialNumber` | Serial number | QString | — | — | yes |

    _Measured quantities:_

    | Key | Quantity | Type | Unit |
    | --- | --- | --- | --- |
    | `connected` | Connected | bool | — |
    | `voltagePhaseA` | Voltage phase A | double | Volt |
    | `voltagePhaseB` | Voltage phase B | double | Volt |
    | `voltagePhaseC` | Voltage phase C | double | Volt |
    | `currentPhaseA` | Current phase A | double | Ampere |
    | `currentPhaseB` | Current phase B | double | Ampere |
    | `currentPhaseC` | Current phase C | double | Ampere |
    | `currentPower` | Current power | double | Watt |
    | `currentPowerPhaseA` | Current power phase A | double | Watt |
    | `currentPowerPhaseB` | Current power phase B | double | Watt |
    | `currentPowerPhaseC` | Current power phase C | double | Watt |
    | `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
    | `energyProducedToday` | Energy produced today | double | KiloWattHour |
    | `firmwareVersion` | Firmware version | QString | — |

??? abstract "SMA Battery Inverter (Modbus) — `modbusBatteryInverter`"
    _Settings:_

    | Key | Label | Type | Range | Default | Read-only |
    | --- | --- | --- | --- | --- | --- |
    | `address` | Host address | QString | — | — | no |
    | `hostName` | Host name | QString | — | — | no |
    | `macAddress` | MAC address | QString | — | — | no |
    | `port` | Port | int | — | `502` | no |
    | `slaveId` | Slave ID | int | — | `3` | no |
    | `serialNumber` | Serial number | QString | — | — | yes |

    _Measured quantities:_

    | Key | Quantity | Type | Unit |
    | --- | --- | --- | --- |
    | `connected` | Connected | bool | — |
    | `batteryLevel` | Battery level | int | Percentage |
    | `batteryCritical` | Battery critical | bool | — |
    | `currentPower` | Current power | double | Watt |
    | `capacity` | Capacity | double | KiloWattHour |
    | `chargingState` | Charging state | QString | — |
    | `firmwareVersion` | Firmware version | QString | — |

<!-- END GENERATED -->