* 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>
This commit is contained in:
Colin Robbins 2020-04-13 07:42:07 +01:00 committed by GitHub
parent 0fb93ffc64
commit a9d869ad77
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -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 switches
Lightwave Thermostatic Radiator Values (TRV) are supported but require an additional proxy to capture the current TRV temperature.
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
```