Seminar FHEM MQTT und MQTT2

Inhaltsverzeichnis

1. Einordnung und Nutzen
2. Zielgruppe
3. Voraussetzungen
4. Lernziele
5. Seminarinhalte
6. Praxisübungen
7. Technische Arbeitsumgebung

Einordnung und Nutzen

Topic-Struktur, Payload, Retain-Verhalten und Übersetzung in Readings und Set-Befehle werden dokumentiert, da MQTT kein einheitliches Gerätemodell vorgibt.

Zielgruppe

FHEM-Anwender, Integratoren und Administratoren für MQTT-fähige Sensoren, Aktoren und Gateways.

Voraussetzungen

FHEM-Grundkenntnisse und elementares Netzwerkverständnis; JSON-Erfahrung ist hilfreich.

Lernziele

Nach Abschluss des Seminars können die Teilnehmenden die folgenden Aufgaben systematisch bearbeiten:

• MQTT-Architektur planen: Publisher, Subscriber, Broker und FHEM-Rolle bestimmen. Berechtigungskonzept definieren.
• MQTT2-IO einrichten: Zwischen integriertem und externem Broker entscheiden. Wiederverbindung nach Neustart prüfen.
• MQTT2_DEVICE erstellen: autocreate kontrolliert aktivieren. autocreate nach Inbetriebnahme einschränken.
• Befehle und JSON: Befehlstopic und Payload bestimmen. Befehlsannahme und reale Rückmeldung unterscheiden.
• Sicherheit und Fehlersuche: Brokerzugriff absichern. Gerätetausch mit Rückfallplan durchführen.

Seminarinhalte

Kapitel 1: MQTT-Architektur planen

1. Schritt 1: Publisher, Subscriber, Broker und FHEM-Rolle bestimmen.
2. Schritt 2: Topic-Hierarchie dokumentieren.
3. Schritt 3: QoS, Retain und Last-Will festlegen.
4. Schritt 4: Berechtigungskonzept definieren.

Kapitel 2: MQTT2-IO einrichten

1. Schritt 1: Zwischen integriertem und externem Broker entscheiden.
2. Schritt 2: MQTT2_SERVER oder MQTT2_CLIENT anlegen.
3. Schritt 3: Clientkennung und Zugangsdaten konfigurieren.
4. Schritt 4: Testnachricht senden und empfangen.
5. Schritt 5: Wiederverbindung nach Neustart prüfen.

Kapitel 3: MQTT2_DEVICE erstellen

1. Schritt 1: autocreate kontrolliert aktivieren.
2. Schritt 2: Topics einem Device zuordnen.
3. Schritt 3: readingList bereinigen.
4. Schritt 4: Readings benennen und Einheiten ergänzen.
5. Schritt 5: autocreate nach Inbetriebnahme einschränken.

Kapitel 4: Befehle und JSON

1. Schritt 1: Befehlstopic und Payload bestimmen.
2. Schritt 2: setList mit Wertebereichen anlegen.
3. Schritt 3: attrTemplate anwenden und prüfen.
4. Schritt 4: JSON in einzelne Readings zerlegen.
5. Schritt 5: Befehlsannahme und reale Rückmeldung unterscheiden.

Kapitel 5: Sicherheit und Fehlersuche

1. Schritt 1: Brokerzugriff absichern.
2. Schritt 2: Retain-Altwerte und doppelte Clientkennungen erkennen.
3. Schritt 3: Topic-, Payload- und Verbindungsfehler trennen.
4. Schritt 4: Hohe Nachrichtenraten begrenzen.
5. Schritt 5: Gerätetausch mit Rückfallplan durchführen.

Praxisübungen

• MQTT2-Verbindung aufbauen
• readingList und setList erstellen
• JSON-, Retain- und ClientID-Probleme diagnostizieren

Technische Arbeitsumgebung

Die Übungen erfolgen in einer getrennten FHEM-Trainingsumgebung mit vorbereiteten Testgeräten, simulierten Ereignissen und kontrollierten Schnittstellen. Änderungen werden nach jedem Arbeitsschritt geprüft, gespeichert und anhand definierter Testfälle abgenommen.