Overview KLF 200 / VELUX



This function block controls VELUX io-homecontrol actuators (roller shutters, windows, awnings, venetian blinds, gates, lights) through the VELUX KLF 200 gateway and reads back their positions.

Communication uses the local KLF 200 API (TCP port 51200, TLS-encrypted). Enter the IP address and password of the KLF 200. The password is the setup key printed on the device (Wi-Fi password).

The easiest way is to read the actuators with the Search actuators button while the controller is connected. After Apply, the Studio asks whether the addresses should be generated right away. The addresses then carry the actuator names from the KLF 200. Without the search, set the number of actuators and create the addresses with Create addresses.

Three addresses are created per actuator:
  • Target position (input, 0..100 %): moves the actuator to the desired position.
  • Actual position (output, 0..100 %): current position of the actuator.
  • State (output): actuator feedback (moving / done / radio error).
Important: The meaning of the position depends on the actuator type (e.g. window 100 % = open, roller shutter 100 % = closed).

Note: The automatic search only works if the controller is connected to the software and is itself connected to the KLF 200. If the system is operated via APP, special protective measures should be taken (e.g. a private VPN access). The system should never be freely accessible from the internet.

No connection to the KLF 200: The cause is shown in the error log of the controller.
  • The KLF 200 must be connected with a network cable. Its WLAN is only used for setup, the interface cannot be reached via WLAN.
  • The interface is available from firmware 0.2.0.0.71. Update older devices in the web interface of the KLF 200.
  • The KLF 200 accepts at most two connections at the same time. If another system is connected or an old session is stuck, it rejects further connections. The only remedy is to briefly disconnect the KLF 200 from power.
  • Establishing the connection takes a few seconds on the KLF 200. After an error the block retries after 5 s, then at increasing intervals of up to 60 s.

Outputs

ER
Error counter
Number of communication errors (-1 = software without SSL support)

Parameters

IP address
IP address of the KLF 200
Port
TCP port of the KLF 200 API (default: 51200)
Password
Setup key of the KLF 200 (printed on the device)
Timeout (ms)
Connection timeout in milliseconds
Number of actuators
Number of actuators to control (determines the number of generated addresses)
Actuator list
Assignment of the actuators (NodeID/name/type). Filled automatically by the search.
Debug
Additional diagnostic output in the error log

See also the common parameters of all function blocks.