Seminar Jeedom Intensivseminar – Protokolle, Integration und Entwicklung

Jeedom verbindet Geräte und Dienste mit sehr unterschiedlichen Kommunikations-, Sicherheits- und Betriebsmodellen. Eine stabile Integration benötigt deshalb klare Grenzen zwischen Protokoll, Plugin, Gateway, Datenmodell und eigener Erweiterung.

Das Intensivseminar entwickelt eine durchgängige Integrationsarchitektur und setzt repräsentative Funk-, Nachrichten-, Gebäude- und Softwareschnittstellen bis hin zu einem eigenen Plugin um.

Inhaltsübersicht

• Zielsetzung
• Zielgruppe
• Voraussetzungen
• Seminarinhalte
• Praxisübungen
• Methodik

Zielsetzung

• Protokoll-, Gateway- und Pluginarchitekturen für konkrete Integrationsfälle auswählen
• Zigbee, Z-Wave, MQTT und Gebäudeprotokolle kontrolliert einbinden und diagnostizieren
• Jeedom-APIs und Webhooks mit minimalen Rechten und robusten Datenverträgen verwenden
• Ein wartbares Jeedom-Plugin von Struktur und Befehlsmodell bis Test und Release entwickeln

Zielgruppe

Smart-Home-Integratoren, Automatisierungsingenieure, IoT-Architekten, Entwickler, technische Consultants und Jeedom-Administratoren mit Integrationsverantwortung.

Voraussetzungen

Sichere Jeedom-Grundbedienung, Netzwerkkenntnisse und grundlegendes Verständnis von Datenformaten. Für die Entwicklungsanteile sind elementare PHP-, JavaScript- und Linux-Kenntnisse erforderlich.

Seminarinhalte

1. Schritt 1: Integrationsarchitektur und Verantwortungsgrenzen planen

   Gerät, Funk- oder Feldbus, Controller, Gateway, Broker, Plugin, Jeedom-Befehl und externe Anwendung werden getrennt dargestellt. Datenrichtung, Aktualität, Ausfallverhalten, Sicherheitsgrenze und Eigentümer werden je Verbindung festgelegt.

2. Schritt 2: Plugin-Lifecycle und Kompatibilität steuern

   Plugins werden nach Zweck, Reife, Abhängigkeiten, Daemon, Controller und Wartbarkeit bewertet. Installation, Konfiguration, Update, Deaktivierung und Ersatz erhalten definierte Prüfschritte.

3. Schritt 3: Zigbee mit JeeZigbee und Zigbee2MQTT integrieren

   Koordinator, Kanal, Mesh, Router, Endgeräte, Pairing und Geräteinterview werden behandelt. Gruppen, Bindings, Reporting, schlafende Geräte und Diagnose werden in eine belastbare Betriebsstruktur überführt.

4. Schritt 4: Z-Wave mit Z-Wave JS integrieren

   Controller, Sicherheitsklassen, Inclusion, Interview, Konfigurationsparameter, Assoziationen und Wake-up werden umgesetzt. Meshqualität, Routen, Exclusion und Controllerwechsel werden systematisch geprüft.

5. Schritt 5: MQTT-Datenflüsse aufbauen

   Broker, Topicstruktur, QoS, Retain, Last-Will, Authentifizierung und Nutzdatenvertrag werden festgelegt. Zustände werden abonniert, strukturierte Nachrichten ausgewertet und Aktionsbefehle kontrolliert veröffentlicht.

6. Schritt 6: KNX fachlich und sicher anbinden

   Topologie, Gruppenadressen, Datenpunkttypen, Gateway und je nach Umgebung sichere Kommunikation werden eingeordnet. Lese-, Schreib- und Statusobjekte werden eindeutig Jeedom-Befehlen zugeordnet.

7. Schritt 7: Modbus, BACnet und DALI integrieren

   Register, Datentypen, Skalierung, Byte-Reihenfolge, BACnet-Objekte und DALI-Gruppen beziehungsweise Szenen werden behandelt. Schreibrechte, Abfrageintervalle, Gatewaygrenzen und Fehlzustände werden pro Protokoll festgelegt.

8. Schritt 8: Befehle und generische Typen vereinheitlichen

   Protokollspezifische Werte werden auf stabile Info- und Aktionsbefehle abgebildet. Einheiten, logische IDs, Zustandsrückmeldung, Aktualitätsprüfung und generische Typen ermöglichen protokollübergreifende Szenarien.

9. Schritt 9: HTTP-, JSON-RPC-API und Webhooks nutzen

   Getrennte API-Schlüssel, Datenverträge, Lese- und Schreiboperationen, Szenariostarts und eingehende Ereignisse werden umgesetzt. Zeitüberschreitung, Wiederholung, Idempotenz und Fehlerprotokollierung werden getestet.

10. Schritt 10: Plugin-Grundstruktur erstellen

    Plugin-Identität, Metadaten, Verzeichnisstruktur, Konfigurationsseite sowie Geräte- und Befehlsklassen werden aus einer Vorlage aufgebaut. Namensräume, logische IDs und Konfigurationswerte werden konsistent festgelegt.

11. Schritt 11: Daemon, Abhängigkeiten und Hintergrundaufgaben entwickeln

    Abhängigkeiten, Cron-Aufgaben, Ereignisse und optionaler Daemon werden entsprechend dem Integrationsfall implementiert. Start, Stopp, Status, Wiederanlauf, Protokollierung und Ressourcenverbrauch werden geprüft.

12. Schritt 12: Test, Verpackung und End-to-End-Abnahme durchführen

    Installation, Update, Deinstallation, Geräteerkennung, Info- und Aktionsbefehle, Fehlerpfade, Sicherheit und Performance werden getestet. Ein End-to-End-Projekt verbindet externes Gerät, Jeedom-Plugin, Szenario und API-Weitergabe.

Praxisübungen

• Integrationslandkarte mit Protokoll-, Plugin-, Gateway- und Sicherheitsgrenzen erstellen
• Je ein repräsentatives Zigbee-, Z-Wave- und MQTT-Gerät einbinden und diagnostizieren
• Feldbuswerte aus KNX, Modbus, BACnet oder DALI auf Jeedom-Befehle abbilden
• API- und Webhook-Fluss mit minimalem Schlüsselumfang und Fehlerbehandlung testen
• Eigenes Plugin mit Gerät, Befehlen, Hintergrundaufgabe und Releaseprüfung entwickeln

Methodik

Vortrag, geführte Demonstrationen und strukturierte Übungen an einer vorbereiteten Jeedom-Umgebung. Jeder Arbeitsschritt wird zunächst fachlich eingeordnet, anschließend am System umgesetzt und danach mit klaren Prüfkriterien kontrolliert. Konfigurationsentscheidungen, Fehlersituationen und betriebliche Auswirkungen werden gemeinsam ausgewertet.