Direkt zum Hauptinhalt

MQTT Broker Service

● MQTT Broker Service

Der DEXA Pager Broker unterstützt MQTT als Kommunikationsprotokoll für LX7-Pager.

Verbindung

Broker-Adresse

Parameter Wert
Host mqtt.pager.dexa.gmbh
Port 8883
Verschlüsselung TLS 1.2+
Protokoll MQTT 3.1.1

Authentifizierung

Authentifizierung erfolgt via Client-Zertifikat oder Username/Password.

Topic-Schema

Alle Topics folgen dem Schema:

p/u/<UID>/<SUFFIX>

Segment Beschreibung
p Prefix für Pager
u Unique ID Indikator
<UID> 14-stellige Seriennummer des Pagers
<SUFFIX> Topic-Typ

Topics

Übersicht

Topic Richtung QoS Beschreibung
p/u/<UID>/r/<RIC> Server → Pager 1 Alarm senden
p/u/<UID>/ka Pager → Server 1 KeepAlive und Antworten
p/u/<UID>/lwt Broker → Server 1 Last Will Testament

Alarm senden

Topic: p/u/<UID>/r/<RIC>

Richtung: Server → Pager

Parameter im Topic

Parameter Beschreibung Beispiel
<UID> 14-stellige Pager-Seriennummer 24702004551000
<RIC> RIC-Adresse (hex) 1379996A

Payload-Felder

Feld Typ Pflicht Beschreibung
msg string ja Alarmtext (max. 256 Zeichen)

Beispiel

Topic: p/u/24702004551000/r/1379996A

Payload:

{"msg":"Feuer in Musterstadt, Hauptstraße 15"}

---


KeepAlive und Antworten


Topic: p/u/<UID>/ka


Richtung: Pager → Server


Alle Pager-Nachrichten werden über dieses Topic gesendet. Die UID wird aus dem Topic extrahiert.


Type-Codes

|

|Kategorie|Beschreibung||------|-----------|---------------------||10| Status    | |||Antwort   | |||



| KOMME               |
| 82   | Antwort   | |||Antwort   | |||



|NOTRUF||0A|Notfall|MANDOWN


Type
Kategorie
Beschreibung






10
Status
KeepAlive / PowerOn




02
Antwort
Empfangen (ACK)




80
Antwort
KOMME
82Antwort
KOMME SPÄTER




84
Antwort
KOMME NICHT




08
Notfall
NOTRUF
0ANotfall
MANDOWN




0C
Status
Tearoff





|
| 0C   | Status    | Tearoff             |
Mögliche Payload-Felder

|

|Typ|Beschreibung||------|--------|-------------------------||type| string | |||



| Batteriespannung        |
| gps  | string | |||string | |||string | |---


Feld
Typ
Beschreibung






type
string
Type-Code (Pflichtfeld)




bat
string
Batteriespannung
gpsstring
GPS-Position




firm
string
Firmware-Version




lte
string
LTE/SIM-Information








Last Will Testament


Topic: p/u/<UID>/lwt


Richtung: Broker → Server (automatisch)


Wird vom MQTT-Broker gesendet, wenn die Verbindung zum Pager unerwartet abbricht.


Payload-Felder

|

|Typ|Beschreibung||------|--------|--------------||type| string | |



Feld
Typ
Beschreibung






type
string
Immer lwt





Beispiel


Topic: p/u/24702004551000/lwt


Payload: {"type":"lwt"}

---


Payloads


KeepAlive Type:(Type 1010)


Regelmäßige Statusmeldung des Pagers.


Felder

|

|Typ|Pflicht|Beschreibung||------|--------|---------|------------------||type|


|ja|10||bat| string | nein    | Batteriespannung |
| gps  | string | nein    | |



Feld
Typ
Pflicht
Beschreibung






type
string
ja
10

batstring
nein
Batteriespannung




gps
string
nein
GPS-Position





Beispiel


Topic: p/u/24702004551000/ka


Payload: {"type":"10","bat":"4,24V+","gps":"130946 52N13.007 009E33.7736"}

---


PowerOn Type:(Type 1010)


Wird beim Einschalten des Pagers gesendet.


Felder

|

|Typ|Pflicht|Beschreibung||------|--------|---------|---------------------||type|


|ja|10||bat| string | nein    | Batteriespannung    |
| firm | string | nein    | |||string| nein    | |



Feld
Typ
Pflicht
Beschreibung






type
string
ja
10

batstring
nein
Batteriespannung




firm
string
nein
Firmware-Version




lte
string
nein
LTE/SIM-Information





Beispiel


Topic: p/u/24702004551000/ka


Payload: {"type":"10","bat":"4,18V+","firm":"F2470101P60A0P51EF56","lte":"860873040845702"}

---


Empfangen / ACK (ACK)Type Type:02)

02


Bestätigung, dass der Alarm empfangen wurde.


Felder

|

|Typ|Pflicht|Beschreibung||------|--------|---------|--------------||type|string|ja


Feld
Typ
Pflicht
Beschreibung






type
string
ja
02





|
Beispiel

02           |

Beispiel


Topic: p/u/24702004551000/ka


Payload: {"type":"02"}

---


KOMME Type:(Type 8080)


Benutzer bestätigt Einsatzteilnahme.


Felder

|

|Typ|Pflicht|Beschreibung||------|--------|---------|--------------||type|string|ja


Feld
Typ
Pflicht
Beschreibung






type
string
ja
80





|
Beispiel

80           |

Beispiel


Topic: p/u/24702004551000/ka


Payload: {"type":"80"}

---


KOMME SPÄTER Type:(Type 8282)


Benutzer bestätigt verspätete Einsatzteilnahme.


Felder

|

|Typ|Pflicht|Beschreibung||------|--------|---------|--------------||type|string|ja


Feld
Typ
Pflicht
Beschreibung






type
string
ja
82





|
Beispiel

82           |

Beispiel


Topic: p/u/24702004551000/ka


Payload: {"type":"82"}

---


KOMME NICHT Type:(Type 8484)


Benutzer lehnt Einsatzteilnahme ab.


Felder

|

|Typ|Pflicht|Beschreibung||------|--------|---------|--------------||type|string|ja


Feld
Typ
Pflicht
Beschreibung






type
string
ja
84





|
Beispiel

84           |

Beispiel


Topic: p/u/24702004551000/ka


Payload: {"type":"84"}

---


NOTRUF Type:(Type 0808)


Manuell ausgelöster Notruf.


Felder

|

|Typ|Pflicht|Beschreibung||------|--------|---------|--------------||type|


|ja      | 08           |
| gps  | string | ja      | |



Feld
Typ
Pflicht
Beschreibung






type
string
ja
08

gpsstring
ja
GPS-Position





Beispiel


Topic: p/u/24702004551000/ka


Payload: {"type":"08","gps":"130946 52N13.007 009E33.7736"}

---


MANDOWN Type:(Type 0A0A)


Automatisch ausgelöster Alarm bei Sturz oder Bewegungslosigkeit.


Felder

|

|Typ|Pflicht|Beschreibung||------|--------|---------|--------------||type|


|ja      | 0A           |
| gps  | string | ja      | |



Feld
Typ
Pflicht
Beschreibung






type
string
ja
0A

gpsstring
ja
GPS-Position





Beispiel


Topic: p/u/24702004551000/ka


Payload: {"type":"0A","gps":"130946 52N13.007 009E33.7736"}

---


Tearoff Type:(Type 0C0C)


Pager wurde aus der Ladestation genommen.


Felder

|

|Typ|Pflicht|Beschreibung||------|--------|---------|--------------||type|string|ja


Feld
Typ
Pflicht
Beschreibung






type
string
ja
0C





|
Beispiel

0C           |

Beispiel


Topic: p/u/24702004551000/ka


Payload: {"type":"0C"}

---


Datenformate


GPS-Format


Format: HHMMSS DDN/SMM.MMMM DDDE/WMM.MMMM


Segmente

|

|Beschreibung|Beispiel||---------|-----------------------|----------||HHMMSS  | |130946||DD      | |52|| | |N|| | | ||| |009|| | |E|| | | |



Segment
Beschreibung
Beispiel






HHMMSS
UTC-Zeit
130946




DD
Breitengrad (Grad)
52




N/S
Nord/Süd
N




MM.MMMM
Breitengrad (Minuten)
13.007




DDD
Längengrad (Grad)
009




E/W
Ost/West
E




MM.MMMM
Längengrad (Minuten)
33.7736





Beispiel


130946 52N13.007 009E33.7736

|

|Bedeutung||-------------|------------------||| ||| ||| |---


Wert
Bedeutung






130946
13:09:46 UTC




52N13.007
52° 13.007' Nord




009E33.7736
9° 33.7736' Ost








Batterie-Format


Format: <Spannung>V<Ladeindikator>

Beispiele|
|Bedeutung||--------|-----------------------------||| ||| ||| |---



Wert
Bedeutung






4,24V+
4,24 Volt, wird geladen




4,02V
4,02 Volt, Batteriebetrieb




3,85V
3,85 Volt, Batterie niedrig








Ablauf Alarmierung

Sequenzdiagramm┌──────────┐┌──────────┐│








│
└────┬─────┘                                   └────┬─────┘
     │                                              │
     │   │
     │   in││──────────────────────────────────────────►││   │
     │   │◄──────────────────────────────────────────│││
│
     │   ││◄──────────────────────────────────────────│




Schritt
RichtungTopicPayloadBeschreibung
1Server │                                   │→ Pager
p/u/24702004551000/r/1379996A
{"msg":"FeuerFeuer"}
Alarm Musterstadt"}senden




2
Pager │→ │Server
p/u/24702004551000/ka
{"type":"02"}
Empfang │bestätigt




3
Pager │→ Serverp/u/24702004551000/ka
{"type":"80"}
KOMME





│

│

Schritte

| Schritt | Beschreibung                                |
|---------|---------------------------------------------|
| 1       | Server sendet Alarm an p/u/<UID>/r/<RIC>    |
| 2       | Pager bestätigt Empfang mit Type 02         |
| 3       | Benutzer antwortet (z.B. KOMME) mit Type 80 |

---

Server-Konfiguration


Subscriptions

DerServerabonniertfolgendeTopics:|Topic|Beschreibung|
|-----------|------------------------------|
| | ||| |





Topic
Beschreibung






p/u/+/ka
KeepAlive und alle Antworten




p/u/+/lwt
Last Will Testament





Einstellungen

|

|Beschreibung||--------------------------------|-----------------------------------------------------------------||| ||| |---Referenz


Einstellung
Beschreibung






Pager automatisch registrieren
Neue Pager werden beim ersten MQTT-Kontakt automatisch angelegt




RICs automatisch abonnieren
RICs aus Topics werden automatisch dem Pager zugeordnet








Referenz: Alle Type-Codes

|

|Name| Kategorie | |Beschreibung||------|--------------|-----------|----------|----------------------------|||KeepAlive|Status    | optional | |||ACK|Antwort   | nein     | |||KOMME|Antwort   | nein     | ||| |Antwort| nein     | ||| |Antwort| nein     | |||NOTRUF|Notfall   | ja       | |||MANDOWN|Notfall   | ja       | |||Tearoff|Status    | nein     | |||LWT|System    | nein     | ||```


Code
Name
Kategorie
Hat GPS
Beschreibung






10
KeepAlive
Status
optional
Regelmäßige Statusmeldung




02
ACK
Antwort
nein
Alarm empfangen




80
KOMME
Antwort
nein
Einsatzteilnahme bestätigt




82
KOMME SPÄTER
Antwort
nein
Verspätete Teilnahme




84
KOMME NICHT
Antwort
nein
Teilnahme abgelehnt




08
NOTRUF
Notfall
ja
Manueller Notruf




0A
MANDOWN
Notfall
ja
Automatischer Sturzalarm




0C
Tearoff
Status
nein
Aus Ladestation genommen




lwt
LWT
System
nein
Verbindung verloren





|              |           |          |                            |
nach oben