Skip to content

Latest commit

 

History

History
138 lines (102 loc) · 6.52 KB

README.md

File metadata and controls

138 lines (102 loc) · 6.52 KB
Raw

SDK Version Version
License Check Style Run Tests
Spenden Wunschliste

VeluxKLF200

Diese Implementierung der API von dem Velux KLF200 Gateway ermöglicht die Einbindung von allen io-homecontrol® Geräten, welche von diesem Gateway unterstützt werden.

Dokumentation

Inhaltsverzeichnis

1. Funktionsumfang

KLF200 Discovery

  • Auffinden von KLF200 im Netzwerk und Anlegen der Konfigurator-Instanz inklusive Gateway in IPS.

KLF200 Configurator

  • Einfaches Anlegen von Geräte-Instanzen in IPS.

KLF200 Gateway

  • Bindeglied zwischen dem KLF200 und den Geräte und Konfigurator-Instanzen.

KLF200 Node

  • Bildet ein Gerät (Node) des KLF200 in Symcon ab.

KLF200 Scene

  • Bildet eine Szene des KLF200 in Symcon ab.

2. Voraussetzungen

  • IPS 6.0 oder höher
  • KLF200 io-homecontrol® Gateway
    • KLF200 muss per LAN angeschlossen sein
    • KLF200 Firmware 2.0.0.71 oder neuer

3. Software-Installation

Über den Module-Store in IPS das Modul VELUX KLF200 hinzufügen.
Bei kommerzieller Nutzung (z.B. als Errichter oder Integrator) wenden Sie sich bitte an den Autor.
Module-Store

4. Einrichten der Instanzen in IP-Symcon

Details sind direkt in der Dokumentation der jeweiligen Module beschrieben.
Es wird empfohlen die Einrichtung mit der Discovery-Instanz zu starten (KLF200 Discovery:).

5. Anhang

1. GUID der Module

Modul Typ Prefix GUID
KLF200 Discovery Discovery KLF200 {3F7261B4-04E3-4FF5-98D3-41ED2AD9548D}
KLF200 Configurator Configurator KLF200 {38724E6E-8202-4D37-9FA7-BDD2EDA79520}
KLF200 Gateway Splitter KLF200 {725D4DF6-C8FC-463C-823A-D3481A3D7003}
KLF200 Node Device KLF200 {4EBD07B1-2962-4531-AC5F-7944789A9CE5}
KLF200 Scene Device KLF200 {4E0650E4-2CDE-47A1-99F8-2C695FAC25E7}

2. Changelog

Version 1.03:

  • Node-Instanz hat die Rückmeldung von COMMAND_SEND_CFM und STATUS_REQUEST_CFM falsch ausgewertet.
  • Neue Scenen-Instanzen werden im Konfigurator angezeigt.

Version 1.02:

  • Timeout auf 10 Sekunden erhöht.
  • Neue Scenen-Instanz.

Version 1.00:

  • Doku aktualisiert.
  • Discovery Instanz hinzugefügt.
  • Internen Datenaustausch überarbeitet, da einige Events nicht in den Node Instanzen verarbeitet wurden.
  • Node Instanzen können automatisch den Namen aus dem KLF200 übernehmen.
  • Node Instanz hat bool Werte invertiert abgebildet.
  • Node Instanz zeigt an ob ein Node arbeitet oder nicht.
  • Node Instanz führt den aktuellen Status nach, wenn sich die Gateway Instanz verbindet.
  • Node Instanz schreibt den Grund der letzten Aktivierung in eine Statusvariable. (Wind & Regensensor)
  • Node Instanz kann jetzt auch auf dem Zustand vom Gerät warten.
  • KLF200_OrientationUp, KLF200_OrientationDown und KLF200_OrientationStop waren defekt.
  • Konfigurator sucht nicht mehr nach neuen Nodes, sondern verarbeitet nun Events des Gateway um Geräte zu erkennen.
  • Gateway Instanz fragt aktuellen Zustand der Nodes beim verbinden an.
  • Gateway Instanz trennt die Verbindung zum KLF200 wenn Symcon runtergefahren wird. (Eigene Shutdown-Skripte auf dem ClientSocket können damit kollidieren!)
  • Gateway Instanz kann beim beenden von Symcon das KLF200 neustarten.
  • Gateway Instanz sendet alle 5 Minuten anstatt 10 Minuten eine Anfrage an das KLF200 um einen Timeout der Verbindung zu vermeiden.

Version 0.71:

  • Fehlermeldung wenn Timeout beim Verbindungsaufbau auftrat.
  • Gateway zeigte beim Symcon start verbunden an, auch wenn ClientSocket gestört war.

Version 0.7:

  • PTLS entfernt.

Version 0.6:

  • Button im Splitter für das Lesen der Firmwareversion war ohne Funktion.
  • Fehler im Konfigurator, wenn Namen der Geräte einen Umlaut enthielt.
  • Der Konfigurator hat eine neuen Button, um im laufenden Betrieb die Geräteliste neu zu laden.

Version 0.5:

  • Öffentliche Betaversion
  • Dokumentation erstellt

Version 0.1:

  • Testversion

3. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

Wunschliste

6. Lizenz

CC BY-NC-SA 4.0