Mosquitto

Mosquitto ist der MQTT-Broker des Wohnmobils.

Der Dienst läuft als Docker-Container auf dem Raspberry Pi tsg-bobil und übernimmt den Austausch von MQTT-Nachrichten zwischen verschiedenen Anwendungen und Geräten.

Zugriff

Mosquitto verwendet den MQTT-Standardport:

1883

Eigenschaft	Wert
Anwendung	Eclipse Mosquitto
Container	mosquitto
Port	1883
Broker im Womo-Netz	192.168.8.10:1883
Broker im Docker-Netz	mosquitto:1883
Docker-Netzwerk	womo-net

Mosquitto besitzt keine eigene Weboberfläche.

Aufgabe

MQTT arbeitet nach dem Publish/Subscribe-Prinzip.

Ein Gerät oder eine Anwendung veröffentlicht eine Nachricht unter einem bestimmten Topic. Andere Teilnehmer können dieses Topic abonnieren und erhalten anschließend die dort veröffentlichten Nachrichten.

Mosquitto übernimmt dabei die Vermittlung zwischen Sendern und Empfängern.

             MQTT
              │
              ▼
          Mosquitto
         MQTT-Broker
              │
      ┌───────┴───────┐
      │               │
 Zigbee2MQTT       Node-RED

Verwendung im Wohnmobil

Derzeit wird Mosquitto unter anderem für die Übertragung der Zigbee-Sensordaten verwendet.

Zigbee2MQTT veröffentlicht die empfangenen Messwerte als MQTT-Nachrichten.

Node-RED abonniert die entsprechenden Topics und kann die Messwerte anschließend weiterverarbeiten.

Der Datenweg lautet damit:

Zigbee-Sensor
     │
     │ Zigbee
     ▼
Zigbee2MQTT
     │
     │ MQTT
     ▼
 Mosquitto
     │
     │ MQTT
     ▼
  Node-RED

Node-RED kann die empfangenen Daten anschließend beispielsweise:

• für die Live-Anzeige im Womo-Handbuch bereitstellen
• für die historische Speicherung an InfluxDB übergeben
• für weitere Automatisierungen und Auswertungen verwenden

ℹ️MQTT-Broker▶

Mosquitto speichert die historischen Messwerte nicht.

Der Broker ist in erster Linie für den Transport und die Verteilung der MQTT-Nachrichten zuständig.

Die dauerhafte Speicherung ausgewählter Messwerte erfolgt über Node-RED in InfluxDB.

Kommunikation im Docker-Netzwerk

Mosquitto ist gemeinsam mit den anderen beteiligten Diensten in das interne Docker-Netzwerk

womo-net

eingebunden.

Docker-Container können den MQTT-Broker dadurch direkt über seinen Containernamen erreichen:

mosquitto:1883

Dies wird beispielsweise von Zigbee2MQTT und Node-RED verwendet.

        womo-net

Zigbee2MQTT ──► mosquitto:1883
                       ▲
                       │
                  Node-RED

Für Anwendungen oder Geräte außerhalb von Docker wird dagegen die IP-Adresse des Raspberry Pi verwendet.

Im Womo-Netz lautet die Adresse:

192.168.8.10:1883

ℹ️Interne und externe Adresse▶

Innerhalb des Docker-Netzwerks wird Mosquitto über mosquitto:1883 angesprochen.

Geräte im normalen Womo-Netz verwenden dagegen 192.168.8.10:1883.

Dadurch bleibt die Kommunikation zwischen den Docker-Containern unabhängig von der jeweiligen IP-Adresse des Raspberry Pi.

Zugriffsschutz

Der MQTT-Broker ist durch Benutzername und Passwort geschützt.

Für die Kommunikation der Dienste wird der MQTT-Benutzer

womo-mqtt

verwendet.

Zigbee2MQTT und Node-RED verwenden diesen Benutzer für die Anmeldung am Broker.

Das Passwort wird nicht im Handbuch dokumentiert.

⚠️MQTT-Zugangsdaten▶

MQTT-Passwörter sind Zugangsdaten und dürfen nicht im Handbuch oder im Git-Repository gespeichert werden.

Die Zugangsdaten werden separat in Bitwarden verwaltet.

MQTT-Topics

MQTT-Nachrichten werden über sogenannte Topics organisiert.

Zigbee2MQTT verwendet beispielsweise Topics nach folgendem Schema:

zigbee2mqtt/<Gerätename>

Für den derzeit verwendeten Raumklimasensor lautet das Topic beispielsweise:

zigbee2mqtt/RTF_Test_Pi8

Eine Nachricht kann dabei unter anderem folgende Werte enthalten:

{
  "battery": 90,
  "humidity": 50.84,
  "pressure": 991.5,
  "temperature": 28.73
}

Node-RED kann dieses Topic abonnieren und die enthaltenen Werte anschließend weiterverarbeiten.

Weitere Verwendung

Über Mosquitto können zukünftig auch weitere Geräte und Anwendungen Daten austauschen.

Damit kann derselbe MQTT-Broker beispielsweise für zusätzliche Sensoren oder die Übertragung von Messwerten der Victron-Komponenten verwendet werden.

Die bestehende MQTT-Struktur kann dadurch erweitert werden, ohne dass für jede Datenquelle eine eigene Kommunikationsverbindung aufgebaut werden muss.

← Zurück zum IT-System