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.


From Github: Copy this repro to your local machine. Or use pip

pip3 install lwproxy

Set up HomeAssistant

Copy the folder, and all its contents to the HomeAssistant configuration area.

cp -r customer_components ~homeassistant/.homeassistant


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.

  host:    	# Lightwave Hub
  trv_proxy_ip:       # Proxy address, do not change unless running on a different server
  trv_proxy_port: 7878		# Do not change, unless a port clash
      name: Bedroom Light
    R1Dh:			# The ID of the TRV.  
      name: Bedroom TRV
      serial: E84902		# Serial number of the TRV - found in the Lightwave App, or web site

A modification is required to


to add TRV support. To replace the file...

sudo cp lightwave/ <PATH>/lib/python3.7/site-packages/lightwave/

Replace <PATH> to the appropriate HomeAssistant folder.

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...

python3 &

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


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



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


  • 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.1
Filename, size File type Python version Upload date Hashes
Filename, size lw_trv_proxy-0.1-py3-none-any.whl (7.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size lw-trv-proxy-0.1.tar.gz (3.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page