Skip to content

MQTT Integration

Diese Seite bietet alles, was du brauchst – von der Konfiguration bis hin zu praktischen Beispielen mit MQTT-Topics und Payloads.

Einrichtung

Nachdem du deinen Doorman mit dem WLAN verbunden hast, wird die LED rot und blau pulsieren. Das bedeutet, der MQTT-Broker ist noch nicht konfiguriert.

  1. Öffne die Weboberfläche deines Doormans und gehe zum Abschnitt MQTT-Konfiguration.

  2. Gib deine MQTT-Broker-Zugangsdaten ein.

    broker-credentials

    Wenn du die Einstellungen nicht findest, scrolle ganz nach unten und klicke auf "Alle anzeigen".

  3. Speichere die Einstellungen — die Firmware versucht dann, eine Verbindung zu deinem MQTT-Broker herzustellen.

  4. Wenn die Verbindung erfolgreich ist, leuchtet die Status-LED zur Bestätigung 3 Sekunden lang durchgehend blau.

Topics

Bei Verwendung der MQTT-Firmware werden verschiedene Topics an deinen Broker gesendet. So funktioniert die Struktur der Topics und Steuerung.

Topic Struktur

Jede Entität veröffentlicht ihren Status auf einem Topic im folgenden Format:

<TOPIC_PREFIX>/<COMPONENT_TYPE>/<COMPONENT_NAME>/state

Du kannst bestimmte Entitäten steuern, indem du einen Befehl an ein Topic mit folgendem Format sendest:

<TOPIC_PREFIX>/<COMPONENT_TYPE>/<COMPONENT_NAME>/command
ON oder OFF oder was sonst unterstützt wird

Beispiel

Um die Ring-To-Open Automatisierung zu aktivieren oder zu deaktivieren, sende ON oder OFF als Payload an dieses Topic:

doorman-s3/switch/ring_to_open/command
ON

Spezielle Topics

Es gibt spezielle Topics, die erweiterte Befehle ermöglichen.

Senden eines Bus Telegramms (Hexadezimal)

Hier ist ein Beispiel um hexadezimale Telegramme (uint32) an den Bus zu senden:

doorman-s3/send_tc_raw_telegram
json
{
    "telegram": 0x1C30BA80
}
json
{
    "telegram": 0x00000680,
    "is_long": true
}

Senden eines Bus Telegramms (Telegram Builder)

Hier ist ein Beispiel um Telegramme via Telegram Builder an den Bus zu senden:

doorman-s3/send_tc_telegram
json
{
    "type": "open_door",
    "address": 0,
    "payload": 0,
    "serial_number": 123456
}

Senden eines Innenstation Telegramms (Telegram Builder)

Hier ist ein Beispiel um Innenstation Telegramme via Telegram Builder an den Bus zu senden:

doorman-s3/send_tc_is_telegram
json
{
    "type": "open_door",
    "address": 0,
    "payload": 0
}

Empfang von geparsten Telegrammen

Alle Telegramme werden auf einem speziellen Topic veröffentlicht. Die Nachrichten enthalten die geparsten Telegrammdaten.

doorman-s3/last_telegram
json
{
    "telegram": "1100",
    "type": "open_door",
    "address": "0",
    "payload": "0",
    "serial_number": "0"
}

Veröffentlicht unter der GPL 3.0 Lizenz.