2.9 KiB
layout, title, description, date, sidebar, comments, sharing, footer, ha_category, logo, ha_iot_class, ha_release
| layout | title | description | date | sidebar | comments | sharing | footer | ha_category | logo | ha_iot_class | ha_release |
|---|---|---|---|---|---|---|---|---|---|---|---|
| page | SMA Solar WebConnect | Instructions on how to connect your SMA Solar Inverter to Home Assistant. | 2015-12-28 21:45 | true | false | true | true | Energy | sma.png | Local Polling | 0.36 |
The sma sensor will poll a SMA (US) solar inverter and present the values as sensors (or attributes of sensors) in Home Assistant.
{% linkable_title Configuration %}
To enable this sensor, add the following lines to your configuration.yaml file:
# Example configuration.yaml entry
sensor:
- platform: sma
host: IP_ADDRESS_OF_DEVICE
password: YOUR_SMA_PASSWORD
sensors:
current_consumption: [total_consumption]
current_power:
total_yield:
{% configuration %}
host:
description: The IP address of the SMA WebConnect module.
required: true
type: string
ssl:
description: Enables HTTPS if set to true, otherwise with false the platform run with HTTP.
required: false
default: false
type: boolean
password:
description: The password of the SMA WebConnect module.
required: true
type: string
group:
description: The user group, which can be either user or installer.
required: false
default: user
type: string
sensors:
description: A dictionary of sensors that will be added. The value of the dictionary can include sensor names that will be shown as attributes.
required: true
type: list
keys:
current_power:
description: Current power.
current_consumption:
description: Current consumption.
total_power:
description: Total power.
total_consumption:
description: Total consumption.
custom:
description: A dictionary of custom sensor key values and units.
required: false
type: list
keys:
key:
description: The SMA sensor key.
required: true
type: string
unit:
description: Unit.
required: true
type: string
factor:
description: Factor.
required: false
default: 1
type: float
{% endconfiguration %}
You can create composite sensors, where the sub-sensors will be attributes of the main sensor. E.g.,
sensors:
- current_power: [total_power, total_consumption]
The SMA WebConnect module supports a wide variety of sensors, and not all these have been mapped to standard sensors. Custom sensors can be defined by using the custom section of the configuration. You will need: A sensor name (no spaces), the SMA sensor key and the unit
Example:
custom:
yesterday_consumption:
key: 6400_00543A01
unit: kWh
factor: 1000
Over time more sensors will be added as standard sensors to the pysma library. Feel free to submit additional sensors on that repository.