Merge pull request #1668 from home-assistant/kellerza-sma-webconnect-sensor-platform

[sensor/sma] New SMA Solar Webconnect sensor

source/_components/sensor.sma.markdown

@@ -0,0 +1,66 @@
+---
+layout: page
+title: "SMA Solar WebConnect"
+description: "Instructions on how to connect your SMA Solar Inverter to Home Assistant."
+date: 2015-12-28 21:45
+sidebar: true
+comments: false
+sharing: true
+footer: true
+ha_category:
+logo: sma.png
+ha_iot_class: "Local Polling"
+ha_release: 0.36
+---
+
+
+The `sma` sensor will poll a SMA solar inverter and present the values as sensors (or attributes of sensors) in Home Assistant.
+
+To enable this sensor, add the following lines to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+sensor sma:
+  - platform: sma
+    host: 192.168.88.199
+    password: !secret sma_password
+    sensors:
+      current_consumption: [total_consumption]
+      current_power: 
+      total_yield: 
+```
+
+Configuration variables:
+
+- **host** (*Required*): The IP address of the SMA WebConnect module.
+- **password** (*Required*): The password of the SMA WebConnect module.
+- **group** (*Optional*): The user group, which can be either `user` (the default) or `installer`.
+- **sensors** (*Required*): A dictionary of sensors that will be added. The value of the dictionary can include sensor names that will be shown as attributes.
+- **custom** (*Optional*): A dictionary of custom sensor key values and units
+
+Sensor configuration:
+
+The sensors can be any one of the following:
+- current_power
+- current_consumption
+- total_power
+- total_consumption
+
+You can create composite sensors, where the sub-sensors will be attributes of the main sensor, e.g.
+
+```yaml
+    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:
+```yaml
+   custom:
+      yesterday_consumption: 
+         key: 6400_00543A01
+         unit: W
+```         
+
+Over time more sensors will be added as standard sensors to the [pysma library](https://github.com/kellerza/pysma/blob/master/pysma/__init__.py#L18). Feel free to submit additional sensors on that repository.