2024.11.3
Home ▸ Integrations ▸

Lightwave

The lightwave integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] 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/. To add your Lightwave devices into your Home Assistant installation, add the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.

# Example configuration.yaml entry
lightwave:
  host: IP_ADDRESS
  lights:
    R1D3:
      name: Wall lights
    R1D4:
      name: Ceiling lights
  switches:
    R1D2:
      name: Tree socket
    R2D1:
      name: Radio socket
    R2D2:
      name: Light socket
    R2D3:
      name: Phone socket
    R2D4:
      name: Torch socket

Configuration Variables

Looking for your configuration file?
host string Required

IP address of your Lightwave hub

lights map (Optional)

List of lights you wish to configure

name string Required

Name of the Light

switches map (Optional)

List of switches you wish to configure

name string Required

Name of the Switch

trv map (Optional)

TRV configuration

proxy_ip string (Optional, default: 127.0.0.1)

IP address of a proxy for TRV integration.

proxy_port integer (Optional, default: 7878)

IP port address of a proxy for TRV integration.

trvs map (Optional)

List of TRVs you wish to configure

name string Required

Name of the TRV

serial string Required

Serial Number of the TRV

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.

TRVs

Lightwave Thermostatic Radiator Values (TRV) are supported.

Earlier integrations required a proxy - See LWProxy. This capabilty is still supported, but no longer required.

# Example TRV configuration.yaml for TRVs
lightwave:
  host: IP_ADDRESS
  lights:
    R99D1:
      name: Bedroom Light
  trv:
      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

Related topics