Velux Logic Node for X1/L1

This logic block allows seamless integration of your VELUX gateway with your automation system. It enables full control and monitoring of VELUX windows, covers, and indoor climate sensors such as temperature, humidity, and CO₂. You can set window positions, read current states, and build powerful automations around ventilation, shading, and indoor comfort.

Download

Latest version of Velux X1/L1 Logic Node (v0.0.000272)

First-time setup (IP, pairing and devices)

  1. When using the block for the first time, the logic node will automatically try to find the Velux Gateway on your network. If you have multiple gateways or a gateway in another subnet (and the network doesn’t relay MDNS), you can set the IP address manually. Although, I do not recommend to set the IP address manually because if the IP address will ever change, you also need to change it here.
  2. The gateway must be paired. After entering your HomeKit code, the block will generate a pairing output. Copy this output and paste it back into the corresponding input field to complete the pairing process.
    If pairing fails, the gateway may already be linked or the code may be incorrect. In that case, you can reset the gateway by pressing the button until the red LED appears (at least 30 seconds!) After resetting, add the gateway again in your app and retry the pairing process. Don’t worry, your App settings/windows won’t be lost.
  3. After pairing, the block will automatically discover all available devices connected to the VELUX gateway. These devices are listed along with their serial numbers, which uniquely identify each window, cover, or sensor.
  4. To control or monitor a device, simply enter its serial number in the corresponding input field of the block. You can configure the number of devices you want to use, and each configured device can then be individually controlled or triggered using its inputs.
    This allows you to precisely target specific windows or covers, while also reading sensor values for use in your logic and automations. TIP: You can set a trigger every 10 or 30 seconds to get values.

Important notes

  • The VELUX gateway supports only one HomeKit connection at a time. If it is already paired elsewhere, you must reset it before connecting again.
  • HomeKit is used here purely as a communication API. It does not require any Apple devices in your home.
  • You can use this integration fully standalone with systems like X1 or L1, without relying on the Apple ecosystem.

Velux models: gateways, remote controls and sensors

Velux is not that clear about their products and model numbers, that’s why I made a list here so you can easily see the products and

Velux has these gateways:

  • KLF100 (1 dry-contact input for controlling 1 window or window group, has a display, no lan, no wifi)
  • KLF150 (5 dry-contact inputs, 10 outputs, no lan, no wifi, firmware update via USB)
  • KL200 (3 dry-contact inputs, LAN, up to 50 windows, has API, DISCONTINUED)
  • KIG300 (Wifi, Can support up to 200 windows, NETATMO/Active, has Homekit support)
  • KIX300 (a kit containing the KIG300, KLA300 and KLI310)

Velux has these remote controls:

  • WUR101 (remote, 3 buttons, infrared, old), use with WUI101 (infrared receiver), see WUX101 manual
  • WLR100 (remote, 7 buttons, tiny display, old)
  • KLR100 (remote control, 9 buttons, display, can import/export codes)
  • KLR200 (a mini tablet, DISCONTINUED)
  • KLR300 (a mini e-ink tablet)

Velux has these sensors and (wall)switches:

  • KLA300 (Temperature, Humidity, CO2 and Lux climate sensor, can only be used with KIG300)
  • KLI310 (Remote control for 1 window or window/group or suncreens) (KLI311, KLI312, KLI313 have another logo and cannot control sunscreens )
  • KLN300 (Central departure switch), see KLI310 manual

Velux has these receivers (allow remote operation of a (older)windows)

  • KUX110 (power supply and receiver for (old) Velux Integra windows)
  • WUC101 (power supply, receiver and dry contact input and output, old), see WUX101 manual
  • WUX101 (a kit existing of the WUC101 and the WUR101 and WUI101, old)

Repairing

How to repair a Velux KLF200 gateway ?
If your gateway looks completely dead (no LEDs at all), it’s most likely the internal soldered fuse which is burned, you can see how to fix it here.

If you can’t solder, you can send me an e-mail, I repair them fot EUR 75,-

Release Notes

0.0.000272 (30-03-2026)

  • Small fixes

0.0.000270 (01-02-2026)

  • Initial version