3.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.
This sensor uses the web interface and in order to use it you have to be able to connect to the solar inverter from your favorite web browser.
{% 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
verify_ssl:
description: Whether Home Assistant should verify the SSL certificate from the inverter. Self-signed certificates may require false for this sensor to operate properly.
required: false
default: true
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 a list of sensor names that will be used as attributes.
required: true
type: map
keys:
current_power:
description: Current power (W).
current_consumption:
description: Power that you are currently drawing, depending on your installation it can be a combination of the inverter and the grid (W).
total_yield:
description: Total power yield from solar installation (kWh).
total_consumption:
description: Total power consumption (kWh).
grid_voltage:
description: The grid voltage (V)
pv_power:
description: PV Power (W)
daily_yield:
description: daily_yield (Wh)
power_supplied:
description: Power supplied (W)
power_absorbed:
description: Power absorbed (W)
status:
description: Status of the solar plant.
your-custom-sensor:
description: Any sensor name defined in the custom: section
custom:
description: A dictionary of custom sensor key values and units.
required: false
type: map
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.