Add support for remote (TCP/IP) DSMR sensors (i.e. via ser2net)

AlexMekkering · AlexMekkering · commit 6bcf3f002ed1 · 2017-01-02T20:47:02.000+01:00
diff --git a/source/_components/sensor.dsmr.markdown b/source/_components/sensor.dsmr.markdown
@@ -46,13 +46,14 @@ sensor:
 
 Configuration variables:
 
-- **port** string (*Optional*): Serial port to which Smartmeter is connected (default: /dev/ttyUSB0).
-- **dsmr_version_** string (*Optional*): Version of DSMR used by meter, choices: 2.2, 4 (default: 2.2).
+- **port** string (*Optional*): Serial port to which Smartmeter is connected (default: /dev/ttyUSB0 (connected to USB port)). For remote (i.e. ser2net) connections, use TCP port number to connect to (i.e. 2001).
+- **host** string (*Optional*): Host to which Smartmeter is connected (default: '' (connected via serial or USB, see **port**)). For remote connections, use IP address of host to connect to (i.e. 192.168.1.13).
+- **dsmr_version** string (*Optional*): Version of DSMR used by meter, choices: 2.2, 4 (default: 2.2).
 
-A full configuration example can be found below:
+Full configuration examples can be found below:
 
 ```yaml
-# Example configuration.yaml entry
+# Example configuration.yaml entry for USB connected Smartmeter
 sensor:
   - platform: dsmr
     port: /dev/ttyUSB1
@@ -69,6 +70,25 @@ group:
       - sensor.gas_consumption
 ```
 
+```yaml
+# Example configuration.yaml entry for remote (TCP/IP, i.e. via ser2net) connection to host which is connected to Smartmeter
+sensor:
+  - platform: dsmr
+    host: 192.168.1.13
+    port: 2001
+    dsmr_version: 4
+
+group:
+  meter_readings:
+    name: Meter readings
+    entities:
+      - sensor.power_consumption_low
+      - sensor.power_consumption_normal
+      - sensor.power_production_low
+      - sensor.power_production_normal
+      - sensor.gas_consumption
+```
+
 [HASSbian](/getting-started/installation-raspberry-pi-image/) users have to give dialout permission to the user `homeassistant`:
 
 ```
