2025.3.4
首页 ▸ Integrations ▸

Velux

Velux integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] for Home Assistant allows you to connect to a Velux KLF 200 interface, to control io-homecontrol devices like windows and blinds. The module allows you to start scenes configured within KLF 200.

At least firmware version > 2.0.0.0 is required on the KLF 200 device. The firmware images may be obtained here and may be imported via the webinterface of your KLF 200.

There is currently support for the following device types within Home Assistant:

  • Cover
  • Light
  • Scene

配置

要将 Velux integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

Velux 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

During configuration, you will be asked for a hostname and password:

  • Hostname: enter the IP address of the KLF 200 gateway.
  • Password: enter the password of the gateway’s wireless access point (printed on the underside - not the web login password).

You must complete the configuration within 5 minutes of rebooting the KLF 200 gateway while the access point is still available.

Actions

Action velux.reboot_gateway

Reboots the configured KLF 200 Gateway.

There is a problem with the KLF 200 gateway where the connection cannot be established after a restart of Home Assistant, only a manual power off and on fixes this. As a workaround, you can use an automation to force a restart of the KLF 200 before exiting Home Assistant, like this:

automation:
  - alias: "KLF reboot on hass stop event"
    description: "Reboots the KLF200 in order to avoid SSL Handshake issue"
    triggers:
      - trigger: homeassistant
        event: shutdown
    actions:
      - action: velux.reboot_gateway

Velux Active (KIX 300)

The Velux Active (KIX 300) set is not supported by this integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more]. To integrate Velux Active (KIX 300) with Home Assistant, you can use the HomeKit Controller integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] and get full control over your windows, curtains, covers, the air quality sensor KLA 300, etc.

Add the Velux Active gateway using HomeKit pairing (with the pairing code on the sticker at the bottom of the Velux Active gateway) and the devices connected to the gateway - including sensors - will be automatically discovered and added to Home Assistant.