Geräte Devices. Einleitung

Transkript

1 Geräte Devices Geräte Devices...1 Einleitung...1 Struktur...2 Gerätetypen...3 Mehrere IDs...4 Mehrere Protokolle für ein Gerät...4 Protokolleinstellungen Ändern...5 Einleitung Dieses Dokument erklärt nur die Grundlagen der Gerätekonfiguration, mit nur einigen Protokollen als Beispiele. Für die komplette Liste unterstützter Protokolle und deren Syntax, lesen Sie die Protokollseiten dieses Handbuchs. pilight kann entweder mit oder ohne konfigurierten Geräten gestartet werden. Der Vorteil einer Gerätekonfiguration ist, dass pilight diese Geräte in Eventingregeln und anderen externen Clients wie z. B. der eingebauten webgui verwenden kann. Statusupdates der Geräte werden automatisch aktualisiert, genau wie Wetterinformation. Die Protokollnamen die pilight-receive ausgibt sind nicht (immer) dieselben Protokolle die in der Gerätekonfiguration verwendet werden. Der Grund hierfür ist, dass mehrere Gerätehersteller dasselbe Basisprotokoll benutzten. Das arctech_switch Protokoll wird von mindestens fünf unterschiedlichen Marken benutzt. Das Basisprotokoll für alle diese Marken ist dasselbe. 1. Überprüfen Sie die Marke des Gerätes dass Sie konfigurieren möchten 2. Überprüfen Sie ob Ihr Gerät in pilight-receive erkannt wird 3. Überprüfen Sie die Protokollseiten um zu sehen ob Ihr Gerät dort zu finden ist und wie die Gerätesyntax lautet. Falls Ihre Marke/Ihr Gerät nicht in der Liste aufgeführt ist, aber pilight-receive dennoch Ausgaben erzeugt, bitte Kontaktieren Sie uns damit wir das Gerät zu der Unterstützte Geräte -Liste des Protokolls hinzufügen können.

2 Struktur 2 "television": 3 "protocol": [ "relay" ], 5 "gpio": 3 6 ], 7 "state": "off" 8, 9 "bookshelflight": 10 "protocol": [ "kaku_switch" ], 11 "id": [ 12 "id": , 13 "unit": 1 14 ], 15 "state": "off" Jedes Gerät, dass Sie in pilight konfigurieren wollen, hat einen eigen Eintrag. In diesem Beispiel haben wir zwei Geräte konfiguriert. Ein über GPIO angebundenes Relais, welches den Fernseher ein- und ausschaltet, und eine, über das KlikAanKlikUit Protokoll gesteuerte, Lampe im Bücherregal. Wenn pilight nun ein entsprechendes Signal empfängt, dann werden die konfigurierten Geräte, falls nötig, aktualisiert. Würden Sie also im obigen Beispiel, die Bücherregal Lampe bookshelflight mit einer KlikAanKlikUit Fernbedienung einschalten, würde pilight dieses Signal empfangen und intern den Status der bookshelflight auf ein setzten. Natürlich muss hierfür ein Empfänger angeschlossen sein, sonst kann pilight das Signal nicht empfangen. Jedes Protokoll hat seine eigene Syntax, aber einige grundlegende Eigenschaften bleiben gleich: 1. Name 2. Protokoll 3. ID Um die Syntax eines Protokolls, dass Sie benutzten wollen, herauszufinden, wenden Sie sich an die Protokolldokumentation dieses Handbuchs.

3 Gerätetypen pilight mit diversen Gerätetypen interagieren. Jedes Gerät hat unterschiedliche Funktionen und benötigt gewisse Voraussetzungen, manchmal benutzten sie aber ähnliche Signale. Ein Beispiel hierfür sind die KlikAanKlikUit Schalter, Dimmer, Klingeln und Rollläden. In pilight kann ein KlikAanKlikUit Signal so aussehen: "protocol": "arctech_switches", "code": "state": off, "protocol": "arctech_dimmers", "code": "state": off, "protocol": "arctech_screens", "code": "state": up, Wie Sie sehen können, wurde ein einzelnes KlikAanKlikUit Signal als drei unterschiedliche Gerätetypen empfangen. Sie müssen nun das Gerät auswählen, dass auch wirklich das Signal gesendet hat um es korrekt zu definieren. Der Unterschied ist, das ein Dimmer einen Schieberegler und einen Ein-/Ausschalter hat, ein normaler Schalter nur einen Ein-/Ausschalter, und ein Rollladen Knöpfe für hoch und runter Impulse hat. Es ist zwar möglich, einen Rollladen als einen Dimmer zu definieren, aber dann können Sie den Rollladen über die unterschiedlichen GUIs nicht steuern.

4 Mehrere IDs Jedes Protokoll benötigt mindestens eine definierte ID, damit pilight weiß welches Gerät angesteuert wurde. Es könnte aber sein, dass Sie mehrere KlikAanKlikUit Fernbedienungen haben die dieselbe KlikAanKlikUit Funksteckdose steuern. In diesem Fall, können Sie mehrere IDs für ein Gerät konfigurieren. Im Falle einer KlikAanKlikUit Funksteckdose sähe dies etwa so aus: 2 "bookshelflight": 3 "protocol": [ "kaku_switch" ], 5 "id": 1234, 6 "unit": 0 7, 8 9 "id": 2345, 10 "unit": 1 11 ], 12 "state": "off" Wenn nun irgendeine dieser IDs empfangen wurde, aktualisiert pilight den Status des Geräts. Mehrere Protokolle für ein Gerät pilight bietet auch die Möglichkeit, mehrere Protokolle für ein Gerät zu definieren. Die neue Version der KlikAanKlikUit Funksteckdosen sind abwärtskompatibel mit den alten Fernbedienungen. Dies bedeutet das pilight beide Protokolle überprüfen muss, um herauszufinden, ob ein Gerätestatus aktualisiert werden muss. Im Fall eines KlikAanKlikUit Dimmers muss pilight drei Protokolle überprüfen. Um mehrere Protokolle pro Gerät zu definieren, muss mindestens eine korrekte ID für jedes Protokoll vorhanden sein, und alle Werte, die die Protokolle benötigen müssen vorhanden sein. Ein Beispiel: 2 "bookshelflight": 3 "protocol": [ "kaku_dimmer", "kaku_switch", "kaku_old" ], 5 "id": , 6 "unit": 1 7, 8 9 "id": 10, 10 "unit": 5 11 ], 12 "state": "off", 13 "dimlevel":

5 Es gibt einige wichtige Punkte die Sie beachten sollten falls Sie mehrere Protokolle für ein einzelnes Gerät verwenden wollen. Diese sind an das obige Beispiel angepasst: 1. Die kaku_dimmer und kaku_switch Protokollen haben ähnliche ID Spezifikationen, aber das kaku_old Protokoll kann nur eine ID < 16 und einen unitcode < 33 haben. Das ID-set für die kaku_switch und kaku_dimmer, wird daher nicht von dem kaku_old Protokoll unterstützt. Deswegen muss eine weitere ID definiert werden, die zu den Voraussetzungen des kaku_old Protokolls passen. 2. Da wir Dimmer- und Schalterprotokolle kombiniert haben, brauchen wir ein dimlevel und ein state Feld in der Gerätekonfiguration. 3. Das kaku_dimmer Protokoll ist das erste Protokoll in dem obigen Beispiel. Dies ist wichtig, weil pilight nun das Gerät als Dimmer interpretiert, statt als Schalter. Würde das kaku_dimmer als zweites oder drittes Protokoll definiert, würde das Gerät als Schalter interpretiert. Protokolleinstellungen Ändern Jedes Protokoll hat einige Einstellungen die Sie in der Gerätekonfiguration ändern können. Welche Einstellungen das sind, können Sie auf den Protokollseiten dieses Handbuchs nachlesen. Diese Einstellungen können die internen Funktionen eines Protokolls verändern, oder welche Werte akzeptiert werden. Diese Werte gelten für jedes Gerät einzeln definiert. Zum Beispiel, möchten wir nicht das unser Dimmer ganz hoch gedimmt wird, weil er dann zu hell ist. Aber, wir wollen auch nicht das er ganz runter gedimmt wird, weil es dann zu dunkel ist. In diesem Fall, können wir die Minimal- und Maximaldimmwerte ändern: 2 "bookshelflight": 3 "protocol": [ "kaku_dimmer" ], 5 "id": 1234, 6 "unit": 1 7 ], 8 "state": "on", 9 "dimlevel": 3, 10 "dimlevel-minimum": 3, 11 "dimlevel-maximum": Natürlich können wir diese Grenzen mit der Fernbedienung überschreiten, aber pilight stellt sicher dass pilight nicht den Dimmer außerhalb dieser dimlevel-grenzen dimmt.