Velux Binding

This binding integrates the Velux devices with help of a gateway, the Velux Bridge KLF200, which is able to control 200 actuators. The Velux Binding interacts via the Velux Bridge with any io-homecontrol (opens new window)-based devices like window openers, shutters and others.

Based on the VELUX API this binding integrates Velux and other io-homecontrol devices directly into the openHAB, avoiding the necessity of any cloud-based mediation infrastructures. The complete home-automation will work even without any Internet connectivity.

For details about the features, see the following websites:

• Velux (opens new window)
• Velux API (opens new window)

Initial Configuration of Devices in the Hub

This guide assumes that you have already configured your devices in the KLF200 hub. When the KLF200 hub is started it provides a temporary private Wi-Fi Access Point to facilitate this configuration. The Velux leaflet B) explains how to access the configuration web page via this temporary private Wi-Fi Access Point and configure your devices. Note: ending the configuration process prematurely might lead to misconfiguration and require factory resetting your hub and/or devices.

If you want to add devices to the hub later, you have to access the configuration web page via the temporary private Wi-Fi Access Point once more. See the chapter "FAQ and Troubleshooting" below if you have any problems setting up the connection to openHAB again afterwards.

Note: if any device connects to the temporary private Wi-Fi Access Point, it disables the normal LAN connection, thus preventing the binding from connecting. So make sure this Wi-Fi AP is not permanently running (the default setting is that the AP will turn off after some time).

Supported Things

The binding supports the following types of Thing.

Thing Type	Description	Note
bridge	A Velux KLF200 which acts as a gateway to all Velux / IO-home controlled devices.
window	A Velux / IO-home control window.	1.
rollershutter	A Velux / IO-home control roller shutter.	1.
actuator	Generic Velux / IO-home device.	1.
scene	A Velux Scene which commands Velux / IO-home devices to specific positions.
vshutter	A Velux virtual shutter.	2.
information	A Thing that provides overall information about the binding itself.

1. Only supported in hubs with firmware v0.2.x.x or above
2. Only needed in hubs with firmware v0.1.x.x (due to note 1. above)

Discovery

To simplify the initial provisioning, the binding provides one thing which can be found by autodiscovery. The binding will automatically discover Velux Bridges within the local network, and place them in the Inbox. Once a Velux Bridge has been discovered, you will need to enter the password Configuration Parameter (see below) before the binding can communicate with it. And once the Velux Bridge is fully configured, you need to check your Inbox for discovered scenes and actuators. If nothing shows up you need to trigger discovering scenes and actuators (like windows and rollershutters) of the Velux Bridge. For this log into the openHAB webfront go to Settings -> Things and click on the + symbol in the lower right. Then select the Velux Binding and click Scan. After the scan has completed the scences and actuators configured in the KLF 200 are placed in the Inbox.

Thing Configuration

Thing Configuration for "bridge"

The bridge Thing connects to the KLF-200 hub (bridge) to communicate with any respective connected Velux or IO-home device Things. It signs on to the hub using the supplied connection parameters, and it polls the hub at regular intervals to read and write the data for each connected device. The KLF-200 supports two Application Programming Interfaces "API" (a SLIP based one, and a JSON based one), and this binding can use either of them to communicate with it. Before the binding can communicate with the hub, the Configuration Parameters ipAddress and password must be entered. In addition there are some optional Configuration Parameters.

Configuration Parameter	Default	Required	Description
ipAddress		Yes	Hostname or address for accessing the Velux Bridge.
password	velux123	Yes	Password for authentication against the Velux Bridge.(**)
timeoutMsecs	3000	No	Communication timeout in milliseconds.
protocol	slip	No	Underlying communication protocol (http/https/slip).
tcpPort	51200	No	TCP port (80 or 51200) for accessing the Velux Bridge.
retries	5	No	Number of retries during I/O.
refreshMsecs	10000	No	Refresh interval in milliseconds.
isBulkRetrievalEnabled	yes	No	Load all scenes and actuators in one step.
isSequentialEnforced	no	No	Enforce Sequential Actuator Control even for long operations.
isProtocolTraceEnabled	no	No	Show any protocol interaction (loglevel INFO).

(**) Note: This password is the API password that is printed on the back of the unit. Normally it differs from the password of the web frontend.

Advice: if you see a significant number of messages per day as follows, you should increase the parameters retries or/and timeoutMsecs...

 communicate(): socket I/O failed continuously (x times).

For your convenience you'll see a log entry for the recognized configuration within the log file i.e.

2018-07-23 20:40:24.746 [INFO ] [.b.velux.internal.VeluxBinding] - veluxConfig[ipAddress=192.168.42.1,tcpPort=80,password=********,timeoutMsecs=2000,retries=10]

Thing Configuration for "actuator", "window", "rollershutter"

These types of Thing only supported in the Velux Bridge in API version two or higher (firmware version > 0.2.*.*). These types of Thing are configured by means of their serial number in the hub. In addition there are some optional Configuration Parameters.

Configuration Parameter	Default	Type	Required	Description
serial		custom	Yes	Serial number of the device in the hub (custom format 00:00:00:00:00:00:00:00)
name		text	No	Name of the device in the hub.
inverted	false	boolean	No	The position and state (if available) are inverted (i.e. 0% <-> 100%, OFF <-> ON).

Notes:

1. To enable a complete inversion of all parameter values use the property inverted or add a trailing star to the eight-byte serial number.

2. Somfy devices do not provide a valid serial number to the Velux KLF200 Bridge. For such devices you have to enter the special all-zero serial number 00:00:00:00:00:00:00:00 in the serial parameter. This special serial number complies with the serial number validation checks, but also makes the binding use the name parameter value instead of the serial parameter value when it communicates with the KLF Bridge. The name parameter must therefore contain the name that you gave to the actuator when you first registered it in the KLF200 Bridge. For an example, see the Thing definition for 'Living_Room_Awning' below.

The impact of the inverted parameter on the open/close position of the device, when a command is sent, is shown in the table below..

Inverted Parameter	UP Button Pressed	DOWN Button Pressed	Slider Position 0%	Slider Position 100%	Switch Command OFF	Switch Command ON
inverted = false	Device is open	Device is closed	Device is open	Device is closed	Device is open	Device is closed
inverted = true	Device is closed	Device is open	Device is closed	Device is open	Device is closed	Device is open

Thing Configuration for "scene"

The Velux Bridge in API version one (firmware version 0.1.1.*) allows activating a set of predefined actions, so called scenes. So besides the bridge, only one real Thing type exists, namely "scene". This type of Thing is configured by means of its scene name in the hub.

Configuration Parameter	Default	Type	Required	Description
sceneName		text	Yes	Name of the scene in the hub.
velocity	'default'	text	No	The speed at which the scene will be executed ('default', 'silent', 'fast')

Thing Configuration for "vshutter"

The Velux Bridge in API version one (firmware version 0.1.1.*) does not support a real rollershutter interaction. So besides the bridge, this binding provides a virtual rollershutter Thing consisting of different scenes which set a specific shutter level. Therefore the respective Item definition contains multiple pairs of rollershutter levels each followed by a scene name. The virtual shutter Thing must be configured with pairs of level (0..10%) combined with the appropriate scene names (text) as follows.

Configuration Parameter	Default	Type	Required	Description
sceneLevels		text	Yes	{Level1},{Scene1},{Level2},{Scene2},..
currentLevel	0	integer	No	Inverts any device values (0..100).

Supported Channels for Thing Types

Channels for "bridge" Things

The supported Channels and their associated channel types are shown below.

Channel	Data Type	Description
status	String	Description of current Bridge State.
reload	Switch	Command to force reload of the bridge information.
downtime	Number	Time interval (sec) between last successful and most recent device interaction.
doDetection	Switch	Command to activate bridge detection mode.

Channels for "window" Things

The supported Channels and their associated channel types are shown below.

Channel	Data Type	Description
position	Rollershutter	Actual position of the window or device.
limitMinimum	Rollershutter	Minimum limit position of the window or device.
limitMaximum	Rollershutter	Maximum limit position of the window or device.

The position Channel indicates the open/close state of the window (resp. roller shutter) in percent (0% .. 100%) as follows..

• As a general rule the display is the actual physical position.
• If it is moving towards a new target position, the display is the target position.
• After the movement has completed, the display is the final physical position.
• If a window is opened manually, the display is UNDEF.
• In case of errors (e.g. window jammed) the display is UNDEF.
• If a Somfy actuator is commanded to its 'favorite' position via a Somfy remote control, under some circumstances the display is UNDEF. See also Rules below.

Channels for "rollershutter" Things

The supported Channels and their associated channel types are shown below.

Channel	Data Type	Description
position	Rollershutter	Actual position of the window or device.
limitMinimum	Rollershutter	Minimum limit position of the window or device.
limitMaximum	Rollershutter	Maximum limit position of the window or device.
vanePosition	Dimmer	Vane position of a Venetian blind. (optional)

The position, limitMinimum, and limitMaximum are the same as described above for "window" Things.

The vanePosition Channel only applies to Venetian blinds that have tiltable slats. The binding detects whether the device supports a vane position, and if so, it adds the vanePosition Channel automatically.

Channels for "actuator" Things

The supported Channels and their associated channel types are shown below.

Channel	Data Type	Description
position	Rollershutter	Actual position of the window or device.
state	Switch	Device control (ON, OFF).
limitMinimum	Rollershutter	Minimum limit position of the window or device.
limitMaximum	Rollershutter	Maximum limit position of the window or device.

See the section above for "window" / "rollershutter" Things for further information concerning the position Channel.

Channels for "scene" Things

The supported Channels and their associated channel types are shown below.

Channel	Data Type	Description
action	Switch	Activates the scene (moves devices to their preset positions).
silentMode	Switch	Enables silent mode.

Channels for "vshutter" Things

The supported Channel and its associated channel type is shown below.

Channel	Data Type	Description
position	Rollershutter	Position of the virtual roller shutter.

See the section above for "window" / "rollershutter" Things for further information concerning the position Channel.

Channels for "information" Thing

The supported Channel and its associated channel type is shown below.

Channel	Data Type	Description
information	String	Information about the binding.

Rain Sensor

Unfortunately the rain sensor is closely integrated into the window device and it is therefore not possible to display its state via a channel. However, the 'limitMinimum' channel can provide information about rainy weather. The rain sensor, when triggered, overrides the window position so it cannot open more than the ventilation position. (Normally 5% .. 10% depending on the window type, resp. 90% .. 95% inverted). So if 'limitMinimum' changes from its normal value (usually 100% resp. 0% inverted) to this ventilation position value, it is an indication that the rain sensor has probably been triggered.

Properties of the "bridge" Thing

The bridge Thing provides the following properties.

Property	Description
address	IP address of the Bridge
check	Result of the check of current item configuration
connectionAttempt	Date-Time of last connection attampt
connectionSuccess	Date-Time of last successful connection attampt
defaultGW	IP address of the Default Gateway of the Bridge
DHCP	Flag whether automatic IP configuration is enabled
firmware	Software version of the Bridge
products	List of all recognized products
scenes	List of all defined scenes
subnetMask	IP subnetmask of the Bridge
vendor	Vendor name
WLANSSID	Name of the wireless network (not suported any more)
WLANPassword	WLAN Authentication Password (not suported any more)

Full Example

Things

Bridge velux:klf200:g24 "Velux KLF200 Hub" @ "Under Stairs" [ipAddress="192.168.1.xxx", password="secret"] {
    // Velux (standard) window (with serial number)
    Thing window Bathroom_Roof_Window "Bathroom Roof Window" @ "Bathroom" [serial="56:36:13:5A:11:2A:05:70"]

    // Somfy (non-standard) rollershutter (without serial number)
    Thing rollershutter Living_Room_Awning "Living Room Awning" @ "Living Room" [serial="00:00:00:00:00:00:00:00", name="Living Room Awning"]
}

See things.md for more examples.

Items

Rollershutter Bathroom_Roof_Window_Position "Bathroom Roof Window Position [%.0f %%]" {channel="velux:window:g24:w56-36-13-5A-11-2A-05-70:position"}

See items.md for more examples.

Sitemap

Frame label="Velux Windows" {
    Slider item=Bathroom_Roof_Window_Position
}

See sitemaps.md for more examples.

Rule for simultaneously moving the main position and the vane position

This applies to shades or shutters that have both a main position and a vane / tilt position. On such shades if one sends a vane position command followed shortly by a main position command (or vice versa) the second command will cause the first command to stop. This problem is most problematic when the two commands are issued simultaneously by a single rule. In order to solve this problem, there is a rule action to simultaneously set the main position and the vane position.

Warning: use this command carefully...

The action is a command method that is called from within a rule. The method is called with the following syntax moveMainAndVane(thingName, mainPercent, vanePercent). The meaning of the arguments is described in the table below. The method returns a Boolean whose meaning is also described in the table below.

Argument	Type	Example	Description
thingName	String	"velux:rollershutter:hubid:thingid"	The thing name of the shutter. Must be a valid configured thing in the hub.
mainPercent	Integer	75	The target main position in percent. Integer between 0 and 100.
vanePercent	Integer	25	The target vane position in percent. Integer between 0 and 100.
return	Boolean	true	Is true if the command was sent successfully or false if any arguments were invalid.

Example:

rule "Simultaneously Move Main and Vane Positions"
when
    ...
then
    // note: "velux:klf200:hubid" shall be the thing name of your KLF 200 hub
    val veluxActions = getActions("velux", "velux:klf200:hubid")
    if (veluxActions !== null) {
        val succeeded = veluxActions.moveMainAndVane("velux:rollershutter:hubid:thingid", 75, 25)
    }
end

Rule for closing windows after a period of time

Especially in the colder months, it is advisable to close the window after adequate ventilation. Therefore, automatic closing after one minute is good to save on heating costs. However, to allow the case of intentional prolonged opening, an automatic closure is made only with the window fully open.

Example:

rule "V_WINDOW_changed"
when
    Item V_WINDOW changed
then
    logInfo("rules.V_WINDOW",    "V_WINDOW_changes() called.")
    // Get the sensor value
    val Number windowState = V_WINDOW.state as DecimalType
    logWarn("rules.V_WINDOW", "Window state is " + windowState + ".")
    if (windowState < 80) {
        if (windowState == 0) {
            logWarn("rules.V_WINDOW", "V-WINDOW changed to fully open.")
            var int interval = 1
            createTimer(now.plusMinutes(interval)) [ |
                    logWarn("rules.V_WINDOW:event", "event-V_WINDOW(): setting V-WINDOW to 100.")
                    sendCommand(V_WINDOW, 100)
                    V_WINDOW.postUpdate(100)
                    logWarn("rules.V_WINDOW:event", "event-V_WINDOW done.")
                ]
            } else {
            logWarn("rules.V_WINDOW", "V-WINDOW changed to partially open.")
        }
        }
    // Check type of item
    logDebug("rules.V_WINDOW",    "V_WINDOW_changes finished.")
end

See rules.md for more examples.

Rule for rebooting the Bridge

This binding includes a rule action to reboot the Velux Bridge by remote command:

• boolean isRebooting = rebootBridge()

Warning: use this command carefully...

Example:

rule "Reboot KLF 200"
when
    ...
then
    val veluxActions = getActions("velux", "velux:klf200:myhubname")
    if (veluxActions !== null) {
        val isRebooting = veluxActions.rebootBridge()
        logWarn("Rules", "Velux KLF 200 rebooting: " + isRebooting)
    } else {
        logWarn("Rules", "Velux KLF 200 actions not found, check thing ID")
    }
end

Rule for checking if a Window has been manually opened

In the case that a window has been manually opened, and you then try to move it via the binding, its position will become UNDEF. You can exploit this behaviour in a rule to check regularly if a window has been manually opened.

rule "Every 10 minutes, check if window is in manual mode"
when
    Time cron "0 0/10 * * * ?" // every 10 minutes
then
    if (Velux_Window.state != UNDEF) {
        // command the window to its actual position; this will either
        // - succeed: the actual position will not change, or
        // - fail: the position becomes UNDEF (logged next time this rule executes)
        Velux_Window.sendCommand(Velux_Window.state)
    } else {
        logWarn("Rules", "Velux in Manual mode, trying to close again")
        // try to close it
        Velux_Window.sendCommand(0)
    }
end

Rule for Somfy actuators

If a Somfy actuator is commanded to its 'favorite' position via a Somfy remote control, under some circumstances the display is UNDEF. You can resolve this behaviour in a rule that detects the UNDEF position and (re-)commands it to its favorite position.

rule "Somfy Actuator: resolve undefined position"
when
    Item Somfy_Actuator changed to UNDEF
then
    val favoritePosition = 91
    Somfy_Actuator.sendCommand(favoritePosition)
end

Debugging

For those who are interested in more detailed insight of the processing of this binding, a deeper look can be achieved by increased loglevel.

With Karaf you can use the following command sequence:

log:set TRACE org.openhab.binding.velux
log:tail

This, of course, is possible on command line with the commands:

% openhab-cli console log:set TRACE org.openhab.binding.velux
% openhab-cli console log:tail org.openhab.binding.velux

On the other hand, if you prefer a textual configuration, you can append the logging definition with:

    <logger name="org.openhab.binding.velux" level="TRACE">
        <appender-ref ref="FILE" />
    </logger>

During startup of normal operations, there should be only some few messages within the logfile, like:

[INFO ] [nal.VeluxValidatedBridgeConfiguration] - veluxConfig[protocol=slip,ipAddress=192.168.45.9,tcpPort=51200,password=********,timeoutMsecs=1000,retries=5,refreshMsecs=15000,isBulkRetrievalEnabled=true]
[INFO ] [ng.velux.bridge.slip.io.SSLconnection] - Starting velux bridge connection.
[INFO ] [hab.binding.velux.bridge.slip.SClogin] - velux bridge connection successfully established (login succeeded).
[INFO ] [ding.velux.handler.VeluxBridgeHandler] - Found velux scenes:
        Scene "V_Shutter_West_100" (index 5) with non-silent mode and 0 actions
        Scene "V_Shutter_West_000" (index 4) with non-silent mode and 0 actions
        Scene "V_Shutter_Ost_090" (index 10) with non-silent mode and 0 actions
        Scene "V_Window_Mitte_005" (index 3) with non-silent mode and 0 actions
        Scene "V_Window_Mitte_000" (index 1) with non-silent mode and 0 actions
        Scene "V_Window_Mitte_100" (index 2) with non-silent mode and 0 actions
        Scene "V_Shutter_West_090" (index 7) with non-silent mode and 0 actions
        Scene "V_Window_Mitte_010" (index 0) with non-silent mode and 0 actions
        Scene "V_Shutter_Ost_000" (index 8) with non-silent mode and 0 actions
        Scene "V_Shutter_Ost_100" (index 9) with non-silent mode and 0 actions       .
[INFO ] [ding.velux.handler.VeluxBridgeHandler] - Found velux actuators:
        Product "M_Rollershutter" / ROLLER_SHUTTER (bridgeIndex=4,serial=43:12:14:5A:12:1C:05:5F,position=0010)
        Product "O_Rollershutter" / ROLLER_SHUTTER (bridgeIndex=3,serial=43:12:40:5A:0C:23:0A:6E,position=0000)
        Product "M_Window" / WINDOW_OPENER (bridgeIndex=0,serial=43:12:3E:26:0C:1B:00:10,position=C800)
        Product "W-Rollershutter" / ROLLER_SHUTTER (bridgeIndex=1,serial=43:12:40:5A:0C:2A:05:64,position=0000)      .
[INFO ] [ding.velux.handler.VeluxBridgeHandler] - velux Bridge is online with 10 scenes and 4 actuators, now.

However if you have set the configuration parameter isProtocolTraceEnabled to true, you'll see the complete sequence of exchanged messages:

[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Sending command GW_PASSWORD_ENTER_REQ.
[INFO ] [nternal.bridge.slip.io.SSLconnection] - Starting velux bridge connection.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_PASSWORD_ENTER_CFM.
[INFO ] [g.velux.internal.bridge.slip.SClogin] - velux bridge connection successfully established (login succeeded).
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Sending command GW_COMMAND_SEND_REQ.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_COMMAND_SEND_CFM.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Sending command GW_GET_LIMITATION_STATUS_REQ.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_NODE_STATE_POSITION_CHANGED_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_COMMAND_RUN_STATUS_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_COMMAND_RUN_STATUS_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_SESSION_FINISHED_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_NODE_STATE_POSITION_CHANGED_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_GET_LIMITATION_STATUS_CFM.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_LIMITATION_STATUS_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Sending command GW_GET_NODE_INFORMATION_REQ.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_COMMAND_RUN_STATUS_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_SESSION_FINISHED_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_GET_NODE_INFORMATION_CFM.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_GET_NODE_INFORMATION_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Sending command GW_GET_NODE_INFORMATION_REQ.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_GET_NODE_INFORMATION_CFM.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_GET_NODE_INFORMATION_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Sending command GW_GET_NODE_INFORMATION_REQ.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_GET_NODE_INFORMATION_CFM.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_GET_NODE_INFORMATION_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Sending command GW_GET_NODE_INFORMATION_REQ.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_GET_NODE_INFORMATION_CFM.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Received answer GW_GET_NODE_INFORMATION_NTF.
[INFO ] [internal.bridge.slip.SlipVeluxBridge] - Sending command GW_GET_LIMITATION_STATUS_REQ.

Supported/Tested Firmware Revisions

The Velux Bridge in API version one (firmware version 0.1.1.*) allows activating a set of predefined actions, so called scenes. Therefore beside the bridge, only one main thing exists, the scene element.

The next-generation firmware version two is not backward compatible, and does not provide a public web frontend, but version two does provide full access to any IO-Home compatible devices not limited to Velux and includes many different features.

Firmware revision	Release date	Description
0.1.1.0.41.0	2016-06-01	Default factory shipping revision.
0.1.1.0.42.0	2017-07-01	Public Web Frontend w/ JSON-API.
0.1.1.0.44.0	2017-12-14	Public Web Frontend w/ JSON-API.
0.2.0.0.71.0	2018-09-27	Public SLIP-API w/ private-only WLAN-based Web Frontend w/ JSON-API.

Notes:

• Velux bridges cannot be returned to version one of the firmware after being upgraded to version two.

FAQ and troubleshooting

Is it possible to run the both communication methods in parallel?

For environments with the firmware version 0.1.* on the gateway, the interaction with the bridge is limited to the HTTP/JSON based communication, of course. On the other hand, after upgrading the gateway firmware to version 2, it is possible to run the binding either using HTTP/JSON if there is a permanent connectivity towards the WLAN interface of the KLF200 or using SLIP towards the LAN interface of the gateway. For example the Raspberry PI can directly be connected via WLAN to the Velux gateway and providing the other services via the LAN interface (but not vice versa).

Known Limitations

The communication based on HTTP/JSON is limited to one connection: If the binding is operational, you won't get access to the Web Frontend in parallel.

The SLIP communication is limited to two connections in parallel, i.e. two different openHAB bindings - or - one openHAB binding and another platform connection.

Both interfacing methods, HTTP/JSON and SLIP, can be run in parallel. Therefore, on the one hand you can use the Web Frontend for manual control and on the other hand a binding can do all automatic jobs.

Login sequence fails and Connection Refused

If you get this error first make sure that you entered the right password (the one below SSID on the back of the hub). If the error persists, it may be due to the temporary Wi-Fi Access Point blocking the LAN (as described above). To recover from this, first disable the bridge in the UI, disconnect the LAN cable, power cycle your KLF200 and wait a few minutes. Then reconnect the LAN cable and re-enable the bridge in the UI again. DO NOT try to connect anything to the temporary Wi-Fi Access Point during this process!!

Unknown Velux devices

All known Velux devices can be handled by this binding. However, there might be some new ones which will be reported within the logfiles. Therefore, error messages like the one below should be reported to the maintainers so that the new Velux device type can be incorporated.

[ERROR] [g.velux.things.VeluxProductReference] - PLEASE REPORT THIS TO MAINTAINER: VeluxProductReference(3) has found an unregistered ProductTypeId.

Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)