ZME_RAZ_EU RaZberry - Ein Z-Wave Controller basierend auf dem Raspberry PI Firmware Version : 1.0

Transkript

1 ZME_RAZ_EU RaZberry - Ein Z-Wave Controller basierend auf dem Raspberry PI Firmware Version : 1.0 Kurzinfo C Dieses Gerät ist ein statischer Z-Wave Controller. Alle Netzwerkeinstellungen sind im Nutzerinterface im Tab "Netzwerk" erreichbar. Das Inkludieren von Geräten in das Z-Wave Netz des RaZberry erfolgt mit der Schaltfläche "Include-Modus Start" im Menüpunkt Netzwerk/Steuerung; Exkludieren erfolgt mit der Schaltfläche "Exclude-Modus Start". Um den RaZberry in das Netz eines anderen Primärcontrollers zu inkludieren gehen Sie auf "Controller-Übergabe-Start". Weitergehende Informationen finden sich in den jeweiligen Abschnitten dieses Handbuches. Was ist Z-Wave? Dieses Produkt entspricht dem Z-Wave-Standard. Z-Wave ist der internationale Funkstandard zur Kommunikation von Geräten im intelligenten Haus. Z-Wave-Geräte funken in Europa auf der Frequenz von MHz.Z-Wave ermöglicht eine sichere und stabile Kommunikation indem jede Nachricht vom Empfänger rückbestätigt wird (Zweiwege-Kommunikation) und alle netzbetriebenen Geräte Nachrichten weiterleiten (Routing) können, wenn eine direkte Funkbeziehung zwischen Sender und Empfänger gestört ist. Dank Z-Wave können Produkte unterschiedlicher Hersteller miteinander in einem Funknetz verwendet werden. Damit ist auch dieses Produkt mit beliebigen anderen Produkten anderer Hersteller in einem gemeinsamen Z-Wave Funknetz einsetzbar. Z-Wave unterscheidet zwischen Controllern und Slaves. Slaves sind entweder Sensoren S, die Daten ermitteln oder Aktoren A, die Aktionen ausführen (Sensoren und Aktoren sind mitunter in einem Gerät vereint). Controller sind entweder statische netzgespeiste Controller C (auch IP-Gateways genannt) oder mobile batteriebetriebene Controller (Fernbedienungen, Batteriewandschalter) R. Damit ergeben sich eine Reihe prinzipieller Kommunikationsmöglichkeiten in einem Z-Wave-Netz: 1. Controller steuern Aktoren. 2. Aktoren melden Änderungen ihres Schaltzustandes 3. Sensoren melden Messwerte oder Statusänderungen an Controller 4. Sensoren steuern Aktoren direkt bei Ereignissen 5. Aktoren steuern andere Aktoren 6. Fernbedienungen erzeugen Ereignisse in einem statischen Controller, die zum Beispiel zum Steuern von Szenen genutzt werden 7. Fernbedienungen steuern Aktoren Controller können in einem Z-Wave Netzwerk zwei unterschiedliche Rollen einnehmen. Es gibt immer genau einen Primärcontroller der das Netzwerk steuert und Geräte in das Netzwerk inkludiert oder aus dem Netzwerk exkludiert. Dieser Controller kann weiter Nutzerfunktionen - zum Beispiel Tasten - besitzen. Alle anderen Controller mit Nutzerfunktionen erfüllen keine 1 (c) 2012 Z-Wave Europe GmbH, Goldbachstr. 13, Hohenstein-Ernstthal, Germany,

2 Managementaufgaben. Sie heißen Sekundärcontroller. Trotzdem verfügen sie - sozusagen als Backup - über alle notwendigen Informationen über das Netz. Das Übersichtsbild zeigt, das - batteriegestützt - Sensoren nicht direkt mit - batteriebetriebenen - Fernbedienungen kommunizieren. Sie senden nur Daten an statische Controller oder steuern Aktoren direkt. Produktbeschreibung Der RaZberry verwandelt jedes Raspberry Pi in ein Z-Wave Gateway. Die Hardware und die vorkompilierte Z-Wave Steuersoftware wartet auf Ihr eigenes User Interface. Die Z-Wave Software, basierend auf der Java Script Interface Technologie JSON, ist einfach zu bedienen. Es war nie einfacher Ihre eigene Smart Home App zu programmieren. Achtung: Der Lieferumfang umfasst nur das Z-Wave Aufsteckmodul und die notwendige Software. Das Raspberry Pi Basisboard ist NICHT im Lieferumfang enthalten. Mehr Information erhalten Sie auf der RaZberry Website razberry.z-wave.me. Der RaZberry besteht aus folgenden Teilen: Der Z-Wave Transceiver ist auf das GPIO-Interface des Rasperrry Pi steckbar. Die optimierte Transceiver-Firmware läuft auf dem Z-Wave Chip. Der zertifizierte Z-Wave Kommunikations-Stack Z-Way läuft auf dem Raspberry Pi und bietet eine JSON Schnittstelle. Eine Demo AJAX Anwendung zeigt die Nutzung der JSON Schnitstelle und kann auch zum Steuern des Z-Wave-Netzes genutzt werden. Sicherheitshinweis Lesen Sie dieses Handbuch vor der Installation! Achtung! Dieses Gerät wird mit 230 V Netzspannung betrieben. Beachten Sie die Sicherheitshinweise während der Installation. Vor Beginn der Installation müssen alle Anschlussleitungen potentialfrei sein. Weiterhin muss sichergestellt sein, dass während der Installation niemand die Spannung wieder zuschalten kann (Sicherung wieder aktivieren). Elektrische Arbeiten dürfen nur von einer Elektrofachkraft in Übereinstimmung mit den geltenden Regeln und Vorschriften durchgeführt werden. Verwenden Sie das Gerät auf keine andere Weise als im Handbuch angegeben. Der Hersteller übernimmt keine Garantie für unsachgemäße Bedienung. Installationsanleitung Stecken Sie den RaZberry wie auf der Abbildung zu sehen auf Ihren Raspberry Pi auf. Der Raspberry Pi muss dabei von der Stromversorgung getrennt sein! Es existieren zwei Wege die Software in Betrieb zu nehmen: Beschreiben einer kompletten SD Karte: Dies ist der Weg wenn der Raspberry Pi selbst noch nicht in Betrieb genommen wurde. Installieren der Software aus der Kommandozeile: Dies ist der Weg, wenn es bereits einen funktionierenden Raspberry Pi gibt. Mit neuer SD-Karte 1. Erzeugen Sie eine neue SD Karte mit dem Image 2. Starten Sie den Raspberry Pi und verbinden Sie ihn mit dem Ethernet. 3. Gehen Sie mit einem PC im gleichen Ethernet zur Website Sie finden dort die IP-Adresse des Raspberry Pi. 4. Klicken Sie auf den Link und definieren Sie ihr Zugangspasswort. Weiterhin sehen Sie die ID ihres PI. ID + Password kann zum Remote Login über find.zwave.me verwendet werden. 5. Über oder über find.zwave.me gelangen Sie zur Auswahlseite der Nutzerschnittstellen von Z-Way, der Steuersoftware von RaZberry. Mit bestehendem Raspberry Pi 1. Starten Sie Ihren Raspberry und melden Sie sich am Betriebssystem an. 2. Führen Sie den folgenden Befehl aus: wget -q -O - sudo bash 2 (c) 2012 Z-Wave Europe GmbH, Goldbachstr. 13, Hohenstein-Ernstthal, Germany,

3 3. Öffnen Sie einen Internet Browser und gehen auf folgende Adresse: um die Nutzerschnittstelle zu öffnen. Verhalten des Gerätes im Z-Wave Netz I Im Auslieferungszustand ist das Gerät mit keinem Z-Wave-Netz verbunden. Damit es mit anderen Z-Wave Geräten kommunizieren kann, muss es in ein bestehendes Z-Wave Netz eingebunden werden. Dieser Prozess wird bei Z-Wave Inklusion genannt. Geräte können Netzwerke auch wieder verlassen. Dieser Prozess heißt bei Z-Wave Exklusion. Beide Prozesse werden von einem Controller gestartet, der dazu in einen Inklusion- bzw. Exklusion-Modus geschaltet werden muss. Das Handbuch des Controllers enthält Informationen, wie er in diese Modi zu schalten ist. Erst wenn der Controller des Z-Wave Netzes im Inclusion- Modus ist, können Geräte hinzugefügt werden. Das Verlassen des Netzes durch Exklusion führt zum Rücksetzen dieses Gerätes in den Auslieferungszustand. Um den RaZberry in das Netz eines anderen Primärcontrollers zu inkludieren gehen Sie auf "Controller-Übergabe-Start". Bedienung des Gerätes Die Demo Nutzerschnittstelle (UI) bietet alle Funktionen der RaZberry Software und dient zur Steuerung Ihres gesamten Z-Wave Netzwerks. Sie können auf einfache Weise Ihre eigene Gateway Anwendung und Ihre eigene Nutzerschnittstelle erstellen. Sie benötigen dazu lediglich HTML, CSS und JavaScript-Kenntnisse. Auf der Internet-Seite razberry.zwave.me finden Sie dazu die vollständige Dokumentation der Demo UI und das JSON Anwendung Programmier Interface (API) und Beispiel Code zum besseren Verständnis der API. Hier finden Sie auch Informationen zur Idee hinter dem RaZberry, ein Diskussions-Forum, sowie Hilfe und alle Neuigkeiten aus der RazBerry Community. Node Information Frame NIF Der Node Information Frame ist die Visitenkarte eines Z-Wave Gerätes. Es ist ein spezielles Datenpaket, in dem der Gerätetyp sowie die Funktionen des Gerätes bekanntgemacht werden. Inklusion und Exklusion eines Gerätes wird von diesem mit einem Node Information Frame beantwortet. Zusätzlich kann der Node Information Frame für bestimmte Konfigurationsprozesse des Z- Wave Netzes - zum Beispiel das Setzen von Assoziationen - benötigt werden. Zum Aussenden eines Node Information Frame drücken Sie die Schaltfläche "Sende Geräteinfo (NIF) des Controllers". Spezielle Controllerfunktionen So lang dieses Gerät nicht als Sekundärcontroller in das Netz eines anderen Z-Wave Controllers inkludiert wurde, kann es selbst als Primärcontroller (Systemverwalter) ein Z-Wave-Netz aufbauen und managen. Dies beinhaltet das Inkludieren und Exkludieren von Geräten, das Erstellen und Löschen von Assoziationen sowie die Reorganisation des Netzes. Die folgenden Funktionen werden von diesem Controller unterstützt: Inklusion von Geräten in das eigene Z-Wave-Netz CI Zwei Z-Wave Geräte können nur dann miteinander kommunizieren, wenn sie sich in einem gemeinsamen Netz befinden. Der Vorgang, ein Gerät in ein Z-Wave Netz einzufügen heisst bei Z-Wave Inklusion und wird immer von einem Controller gestartet. Dieser wird dazu in den sogenannten Inklusion-Modus geschaltet. Die Inklusion wird durch das zu inkludierende Gerät bestätigt, meist durch Betätigen einer Taste. Zum Inkludieren von Geräten in das Z-Wave Netz des RaZberry gehen Sie auf "Include-Modus Start". Exklusion von Geräten aus dem eigenen Z-Wave-Netz Der Controller kann Geräte aus dem Z-Wave-Netz entfernen. Durch diese Exklusion wird die Verbindung zwischen dem Gerät und dem Controller beendet und es ist keine Kommunikation mehr möglich. Für eine Exklusion wird der Controller in den Exclusion- Modus geschaltet und die Exclusion am Gerät - meist durch einen Tastendruck bestätigt. Achtung: Das Entfernen eines Gerätes aus einem Netz setzt dieses Gerät wieder in den Auslieferungszustand zurück. Ein Gerät kann von jedem Controller zurückgesetzt (exkludiert) werden, auch wenn es vorher zu einem anderen Netz gehört hat. 3 (c) 2012 Z-Wave Europe GmbH, Goldbachstr. 13, Hohenstein-Ernstthal, Germany,

4 Zum Exkludieren von Geräten gehen Sie auf "Exclude-Modus Start". Sollte ein Gerät im Netzwerk nicht mehr erreichbar sein, kann es manuell mit der Schaltfläche "entferne defektes Gerät" aus dem Netzwerk entfernt werden. Übergabe der Primärcontrollerrolle an einen neuen Controller Dieses Gerät kann seine Primärcontrollerfunktion an einen anderen in das Netz zu includierenden Controller übergeben. Um den RaZberry in das Netz eines anderen Primärcontrollers zu inkludieren gehen Sie auf "Controller-Übergabe-Start". Setzen von Assoziationen zwischen zwei Geräten CA Der Controller ist in der Lage, Assoziationen zwischen zwei Geräten im Netz zu erstellen. Dazu wird einen Assoziationmodus gestartet und Quelle und Ziel der Assoziation werden dem Controller bekanntgemacht. Dazu ist dan den Geräten genau die Operation durchzuführen, zu für eine Inclusion durchzuführen ist. Sind beide Assoziationspartner bekannt, wird der Controller selbständig die Assoziation im Quellgerät in Richtung des Zielgerätes setzen und den Modus beenden. Im Tab Gerätekonfiguration können die einzelnen Geräte konfiguriert werden. Wählen Sie dazu ein Gerät an der linken Seite aus. Wenn ein Gerät Assoziations-Gruppen anbietet, werden diese unter dem Geräte Informations-Menü angezeigt. Ziehen Sie zum Assoziieren einfach Geräte per Drag'n'Drop in die Assoziations-Gruppen. Über die Schaltfläche "Speichern der Konfiguration ins Gerät" speichern und aktivieren Sie die Assoziationen. Ein Doppelklick auf die Assoziations-Gruppen entfernt die assoziierten Geräte wieder. Durch erneutes Speichern werden die Einstellungen wirksam. Rücksetzen des Controllers Mit der Schaltfläche "Controller rücksetzen" können Sie den RaZberry wieder auf Werkseinstellungen zurücksetzen. Kommandoklassen Unterstützte Kommandoklassen Basic (Version 1) Clock (Version 1) Version (Version 1) Multilevel Switch (Version 1) Multi Channel (Version 2) Time (Version 2) Scene Activation (Version 1) Multi Command Encapsulated (Version 1) Manufacturer Specific (Version 1) Simple AV Control (Version 1) Node Naming and Location (Version 1) Technische Daten Schutzklasse IP 20 Explorer Frames Nein SDK Geräteart Allgemeiner Z-Wave-Gerätetyp Spezieller Z-Wave-Gerätetyp Static controller Static Controller PC Controller 4 (c) 2012 Z-Wave Europe GmbH, Goldbachstr. 13, Hohenstein-Ernstthal, Germany,

5 Router FLiRS Ja Nein Firmware Version 1.0 Erläuterung Z-Wave-spezifischer Begriffe Controller... ist ein Z-Wave-Gerät mit erweiterten Fähigkeiten zur Verwaltung eines Netzes. Dies sind in der Regel Gateways oder Fernbedienungen. Batteriegespeiste Wandschalter können auch Controller sein. Slave... ist ein Z-Wave-Gerät mit erweiterten Fähigkeiten zur Verwaltung eines Netzes. Es gibt Sensoren, Aktoren und auch Fernbedienungen als Slaves. Primärcontroller (engl. Primary Controller)... ist der zentrale Netzverwalter des Z-Wave-Netzes. Inklusion (eng. Inclusion)... ist der Prozess des Einbindens eines neuen Gerätes ins Z-Wave-Netz. Exklusion (engl. Exclusion)... ist der Prozess des Entfernens eines Gerätes aus dem Z-Wave-Netz. Assoziation (engl. Association)... ist eine Steuerbeziehung zwischen einem steuernden und einem gesteuerten Gerät. Die Information dazu wird im steuernden Gerät in einer Assoziationsgruppe hinterlegt. Wakeup Notifikation (engl. Wakeup Notification)... ist eine spezielle Funknachricht, mit der ein batteriegespeistes Gerät bekanntmacht, daß es im Aufwachstatus ist und Z-Wave-Nachrichten empfangen kann. Node Information Frame... ist eine spezielle Funknachricht, mit der ein Z-Wave-Gerät seine Geräteeigenschaften bekanntgibt. Entsorgungshinweis Dieses Gerät enthält keine Batterien. Das ist ein elektrisches Gerät. Es kann kostenfrei bei entsprechenden Annahmestellen abgegeben werden. 5 (c) 2012 Z-Wave Europe GmbH, Goldbachstr. 13, Hohenstein-Ernstthal, Germany,