Skip to main content

A Lightwave RF Proxy

Project description

Lightwave TRV Integration for HomeAssistant

This adds support for Thermostatic Radiator Valves (TRVs) to the LightwaveRF integration into HomeAssistant.
This is for Series 1 Lightwave.

Getting Started

Lightwave does not provide an interface, via the API, to query the Lightwave Hub for the current TRV status. Instead the status is broadcast to the LAN. Thus this integration comes in two components. A HomeAssistant custom configurations, and a proxy. The proxy captures the TRV broadcast messages, and makes them available to a HomeAssistant polling loop.

Installing

  • github
git clone https://github.com/ColinRobbins/Homeassistant-Lightwave-TRV.git

or

  • pip
pip3 install lw-trv-proxy

Set up HomeAssistant

(temporary requirement until integrated in HomeAssistant) Copy the folder, and all its contents to the HomeAssistant configuration area.

cp -r customer_components ~homeassistant/.homeassistant

Configuration

The TRV broadcasts its status with the device serial number as the only identifier. This needs to be put into the HA configuration file. The file sample_configuration.yaml gives an example.

lightwave:
  host: 192.168.10.10    	# Lightwave Hub
  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
  lights:
    R99D1:
      name: Bedroom Light
  trv:				
    R1Dh:			# The ID of the TRV.  
      name: Bedroom TRV
      serial: E84902		# Serial number of the TRV - found in the Lightwave App, or web site

Run the proxy

The proxy is (by default) configured to run on the same server as HA. No configuration should be needed. Simply run it...

lwproxy &

Command line options:

  • -v verbose
  • -i ip_address IP addres to run the porcy on. Default 127.0.0.1
  • -p port Port to run the proxy on. Default 7878

Reboot

You will need to run this as a service to survive reboots etc. I've created a systemctl template service description in lwproxy.service.

Test

Restart hass. (A restart is required, simply re-reading config is not sufficient)

Authors

License

This project is licensed under the same term as HomeAssistant - see the LICENSE.md file for details

Acknowledgements

  • GeoffAtHome for the initial work that started me investigating how to do this!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for lw-trv-proxy, version 0.5
Filename, size File type Python version Upload date Hashes
Filename, size lw_trv_proxy-0.5-py3-none-any.whl (8.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size lw-trv-proxy-0.5.tar.gz (4.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page