Neues Plugin: VLX2MQTT Velux Bridge

[4siggi]

Hallo zusammen.

Ich hatte zum Steuern meiner Velux Dachfenster und Rollladen über die KLF200, lange folgendes im Einsatz als Docker-Container:
Re: Velux KLF200 einbinden | Comment

Das Projekt von 3s1d/vlx2mqtt habe ich als Vorlage genommen, ein Loxberry Plugin für den Velux KLF 200 zu bauen und möchte mein Stand mit euch teilen.

Das Ergebnis habe ich, nach erfolgreichen Tests unter Loxberrx v3 und v4 hier bereit gestellt:
LoxBerry Wiki: VLX2MQTT Velux Bridge und GitHub: VLX2MQTT KLF200 Bridge LoxBerry Plugin

Für Rückmeldungen würde ich mich sehr freuen.



VG, Siggi

[challo]

Hi Siggi hab aktuell eine Lösung über HA am laufen, werde aber auf jeden Fall dein Plugin mal testen um nochmal etwas zentraler über das Loxberry zu laufen und nicht so viele unterschiedliche Systeme zu haben. Steuerst du Rolläden auch über Up/Down oder hast du eine Möglichkeit über die Position gefunden?

Es gibt ja auch https://github.com/tobsch/loxberry-velux Kannst du hier auf Unterschiede oder deine Beweggründe eine neu Implementierung zu machen eingehen?

[4siggi]

Hi challo ,

ja, die Rollläden lassen sich sowohl per UP/DOWN/STOP als auch über Zielpositionen 0..100 steuern.

Die Basis ist meine schon länger genutzte Lösung auf Grundlage von 3s1d/vlx2mqtt, die ich über die Zeit für meinen Einsatz optimiert habe. Daraus habe ich jetzt ein LoxBerry-Plugin gebaut, damit alles zentraler über den LoxBerry läuft. Das Ganze basiert auf Python und MQTT.

Zu loxberry-velux: Das Projekt kenne ich, mein Ansatz ist aber etwas anders. Ich wollte bewusst meine bestehende MQTT/vlx2mqtt-Lösung weiterführen und sauber in LoxBerry integrieren.

Neu in v1.0.0 ist zusätzlich der Vorlagen-Export für Loxone Config, sodass virtuelle Eingänge und Ausgänge nicht komplett manuell angelegt werden müssen.

Auf deine Rückmeldung bin ich gespannt.


VG, Siggi

[challo]

danke für die Rückmeldung. Ich werde meine konfig heute abend mal von HA auf dein Plugin umstellen. Verwendest du Up/Down und Stop für die Bewegung oder ist es auch mölgich den Ausgangs Pos des Rollo Bausteins an das Dachfenster zu übergeben? Also dein Plugin kann es aber kann man es auch so in loxone implementieren. Das meinte ich ;-)

[4siggi]

Hi @challo,

ah, jetzt verstehe ich, was du meinst :-)

Ja, das Plugin kann grundsätzlich auch Positionen 0..100 anfahren. In meiner Loxone-Config nutze ich es aber je nach Baustein etwas unterschiedlich.

Beim normalen Fenster-Baustein ist wichtig:
In Loxone bedeutet 100% = offen, bei der KLF ist 100% = geschlossen.
Für die Rückmeldung der Position habe ich deshalb einen Formelbaustein zur Umrechnung verwendet und diesen an CPos angeschlossen.
Die Ausgänge Op/Cl gehen bei mir auf die virtuellen UDP-Ausgänge UP/DOWN.
Eine Zielposition setze ich bei Bedarf getrennt über einen virtuellen Eingang "Schieber".

Beim Baustein „Dachfenster Beschattung“ nutze ich ebenfalls Op/Cl auf die virtuellen UDP-Ausgänge UP/DOWN.
Den Eingang bzw. Ausgang Pos habe ich dort nicht belegt, weil es dort keinen CPos-Eingang wie beim Fenster-Baustein gibt. Die Position lasse ich mir dort nur als Info anzeigen.

Mit v1.0.0 gibt es im Plugin zusätzlich den Loxone Config Export, der die virtuellen UDP-Eingänge und Ausgänge für die erkannten Nodes erzeugt. Das nimmt einem schon einiges an Handarbeit ab.

VG, Siggi

[challo]

Funktioniert super, vielen Dank für deine Arbeit!!
Ich hatte mit meinen Dachfenster Rolläden immer Probleme, dass sie wegen der Zeitbasierten Ansteuerung doch nicht ganz standen wie Loxone dachte.
Ich hab das ganze jetzt umgestellt da unserer Fenster sowieso nur offen, zu oder auf Beschattungspos (90% geschlossen) stehen. Die Zeit für hoch/runter habe ich dafür auf 1 sec gestellt und dann den Pos Ausgang des Bausteins auf MQTT Set Pos gelegt. Damit kann man zwar keine Zwischenpositionen anfahren über die App oder den Taster anfahren aber das benötige ich wie gesagt auch nicht.

[Humpfrey]

Moin,
bin relativ neu in der ganzen Thematik, vielleicht kann mir einer unter die Arme greifen:
Ich habe ein Velux Dachfenster samt Rollo und beides bereits im KLF registriert. Im KLF habe ich LAN/WLAN dauerhaft auf EIN gestellt und das KLF per LAN im Netzwerk.

Wenn ich die Verbindung via PLugin herstellen (als KLF Host hab ich die LAN IP im Netzwerk hinterlegt?)will, gibt er mir als "Fehler"

OK | PID: 26684 | KLF: klf_connection_refused

Hier mal noch das Log dazu:

2026-07-08 15:54:56,089 INFO: Using config file: /opt/loxberry/config/plugins/vlx2mqtt/vlx2mqtt.cfg
2026-07-08 15:54:56,090 INFO: Verbose logging: off
2026-07-08 15:54:56,091 INFO: External recovery config: enabled=False threshold=4 cooldown=1800s grace=120s topic=vlx2mqtt/recovery/powercycle_required trigger_states=('klf_connection_refused', 'klf_disconnected', 'klf_unreachable')
2026-07-08 15:54:56,091 OK: Applied pyvlx payload patch
2026-07-08 15:54:56,091 INFO: Starting vlx2mqtt_rebuild
2026-07-08 15:54:56,100 OK: External recovery cleared: previous_reason=None
2026-07-08 15:54:56,102 INFO: pyvlx connect attempt 1
2026-07-08 15:54:57,115 OK: MQTT connected rc=0
2026-07-08 15:54:59,168 WARNING: pyvlx connect failed: PyVLXException("Failed to open socket connection to KLF 200: [Errno 113] Connect call failed ('192.168.1.29', 51200)")
2026-07-08 15:55:00,183 INFO: pyvlx connect attempt 2
2026-07-08 15:55:03,263 WARNING: pyvlx connect failed: PyVLXException("Failed to open socket connection to KLF 200: [Errno 113] Connect call failed ('192.168.1.29', 51200)")
2026-07-08 15:55:05,276 INFO: pyvlx connect attempt 3
2026-07-08 15:55:08,351 WARNING: pyvlx connect failed: PyVLXException("Failed to open socket connection to KLF 200: [Errno 113] Connect call failed ('192.168.1.29', 51200)")
2026-07-08 15:55:12,366 INFO: pyvlx connect attempt 4
2026-07-08 15:55:15,423 WARNING: Recovery threshold reached but external recovery is disabled: count=4 threshold=4 last=klf_connection_refused topic=vlx2mqtt/recovery/powercycle_required
2026-07-08 15:55:15,424 WARNING: pyvlx connect failed: PyVLXException("Failed to open socket connection to KLF 200: [Errno 113] Connect call failed ('192.168.1.29', 51200)")
2026-07-08 15:55:22,996 INFO: connect_pyvlx interrupted during backoff
2026-07-08 15:55:22,997 INFO: Stopping before KLF connection completed
2026-07-08 15:55:22,997 OK: External recovery cleared: previous_reason=None

Oder muss ich im Netzwerk für das KLF noch was ändern? Im Router erscheint das quasi dauerhaft als offline..

Grüße und Danke schonmal!


Edit: hab´s hinbekommen über die Portfreigabe.

Läuft soweit sehr gut, sodass ich die Steuerung vom Fenster/Rollo jetzt schonmal auf die Taster/App funktional habe.
Lässt sich das auch "einfach" noch realisieren, dass der "Status" vom Fenster, falls das automatisch aufgrund des Regensensors schließt, an den Baustein in Loxone übergeben/übernommen wird, sodass dort auch geöffnet/zu immer stimmt?

Danke!!