Lightwave (#12027)

* Optimistic mode

* Added TRV support

* Revert "Optimistic mode"

This reverts commit b8f3f02f15f79a6b26c8ee1e13a0ab69634564a7.

* added code type

* ✏️ Tweak

* added configuration block

* fix configuration

* Pushed proxy configuration into TRV section

* ✏️ Tweak

* config fix

* modify IP_ADDRESS

Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com>

source/_integrations/lightwave.markdown

@@ -11,7 +11,7 @@ ha_iot_class: Assumed State
 ha_domain: lightwave
 ---
 
-The `lightwave` integration links Home Assistant with your Lightwave WiFi link for controlling Lightwave lights and switches.
+The `lightwave` integration links Home Assistant with your Lightwave WiFi link for controlling Lightwave lights, switches and TRVs.
 
 This integration uses the official API published by Lightwave on their website [https://api.lightwaverf.com/](https://api.lightwaverf.com/).
 To add your Lightwave devices into your Home Assistant installation, add the following to your `configuration.yaml` file:
@@ -19,7 +19,7 @@ To add your Lightwave devices into your Home Assistant installation, add the fol
 ```yaml
 # Example configuration.yaml entry
 lightwave:
-  host: 192.168.1.2
+  host: IP_ADDRESS
   lights:
     R1D3:
       name: Wall lights
@@ -38,14 +38,84 @@ lightwave:
       name: Torch socket
 ```
 
-Where `192.168.1.2` is the IP address of your Lightwave hub.
+{% configuration %}
+host:
+  description: IP address of your Lightwave hub
+  required: true
+  type: string
+lights:
+  description: List of lights you wish to configure
+  required: false
+  type: map
+  keys:
+    name:
+      description: Name of the Light
+      required: true
+      type: string
+switches:
+  description: List of switches you wish to configure
+  required: false
+  type: map
+  keys:
+    name:
+      description: Name of the Switch
+      required: true
+      type: string
+trv:
+  description: TRV configuration
+  required: false
+  type: map
+  keys:
+    trv_proxy_ip:
+      description: IP address of a proxy for TRV integration. 
+      required: false
+      type: string
+      default: "127.0.0.1"
+    trv_proxy_port:
+      description: IP port address of a proxy for TRV integration.
+      required: false
+      type: integer
+      default: 7878
+    trvs:
+      description: List of TRVs you wish to configure
+      required: false
+      type: map
+      keys: 
+        name: 
+          description: Name of the TRV
+          required: true
+          type: string
+        serial: 
+          description: Serial Number of the TRV
+          required: true
+          type: string
+{% endconfiguration %}
+
+
+Where IP_ADDRESS is the IP address of your Lightwave hub.
 Each `switch` or `light` requires an `id` and a `name`. The `id` takes the form `R#D#` where `R#` is the room number and `D#` is the device number.
 
 `lights` and `switches` are optional but one of these must be present.
 
 The first use of a light or switch will try to register with your Lightwave WiFi Link hub. If the hub has not been registered a message on your hub will be displayed asking you to pair the device. You have 12 seconds to push the button on your hub to accept this. Once done, you should be able to control your lights and switches via Home Assistant. This only needs to be done if the hub has not been registered.
 
-The Lightwave Home Assistant integration currently supports the following Lightwave devices:
+# TRVs
 
-- Lightwave lights
+Lightwave Thermostatic Radiator Values (TRV) are supported but require an additional proxy to capture the current TRV temperature.
-- Lightwave switches
+See [LWProxy](https://github.com/ColinRobbins/Homeassistant-Lightwave-TRV)
+
+```yaml
+# Example TRV configuration.yaml for TRVs
+lightwave:
+  host: IP_ADDRESS
+  lights:
+    R99D1:
+      name: Bedroom Light
+  trv:
+      trv_proxy_ip: 127.0.0.1       # Proxy address, do not change unless running on a different server
+      trv_proxy_port: 7878          # Do not change, unless a port clash
+      trvs:
+        R1Dh:                       # The ID of the TRV.
+          name: Bedroom TRV
+          serial: E84902            # Serial number of the TRV - found in the Lightwave App, or web site
+```