Topic Struktur - MQTT

Normale Topic-Struktur

Ein Topic wird wie folgt strukturiert:

GEKKOID/SYSTEM/itemX

Zusammengesetzt aus:

  • GEKKOID: 16-stellige eindeutige Identifikationsnummer, getrennt durch - (XXXX-XXXX-XXXX-XXXX)
  • SYSTEM: Der Name des Systems, in dem sich das Element befindet (lights, blinds usw.).
  • itemX: Die Positionsnummer (item0, item1, ...)

Zum Beispiel:

12XY-X34Z-XY12-3XZ4/lights/item0

Tabelle der SYSTEM-Namen

Die folgende Tabelle fasst die SYSTEM-Namen mit den Systemelementen des myGEKKO-Controllers zusammen:

MQTT Systemname (SYSTEM)

eigentlicher Systemname

System-Element-Index

globals

-

-

lights

Licht

0

blinds

Jalousie

1

vents

Lüftung

2

loads

Gerät/Steckdose

3

roomtemps

Raumregelung

4

heatingsystems

H/K Erzeuger

5

heatingcircuits

H/K Mischkreis

6

energycosts

Energiezähler

7

alarms_logics

Logik

8

accessdoors

Zutritt

9

energymanager

Energiemanager

10

alarmsystem

Alarmanlage

11

multirooms

Musik

12

cams

Video

13

smsemail

Mail/Sms

14

actions

Aktionen

15

clocks

Uhren

16

controlcircuits

Regelkreis

19

air_handling_unit

Klimaanlage

20

saunas

Sauna

22

pools

Schwimmbad

23

trends

Analyse

27

emobils

E-Mobil

28

hotwater_systems

H/K Speicher

39

hotwater_circulations

H/K Zirkulation

40

stoves

Kaminofen

41

door_intercom

Sprechstelle

45

Erweiterte Topic-Struktur

Die erweiterte Topic-Struktur wird aktiviert, wenn die Option „Topic prefix“ eingeschaltet ist. Die Option „topic prefix“ ermöglicht es Ihnen, eine benutzerdefinierte ID am Anfang des Topics einzufügen und es so zu erweitern.

Wenn Sie beispielsweise ein Gebäude mit mehreren Controllern haben, die alle an denselben MQTT-Broker publizieren, könnte der Gebäudemanager den Namen des Gebäudes an den Anfang der Standard-Topic-Struktur setzen, um alle Controller besser zu organisieren.

Anstatt also zu haben:

12XY-X34Z-XY12-3XZ4/lights/item0

Könnte man folgende Struktur verwenden:

myBuilding-01/12XY-X34Z-XY12-3XZ4/lights/item0

Auf diese Weise wird es einfacher alle Topics eines Gebäudes abzurufen.

myBuilding-01/#

Bei der Verwendung der erweiterten Topic-Struktur gibt es zwei Einschränkungen:

  • Es ist nur eine Topic-Ebene erlaubt, das heißt, dass der Benutzer nur eine Topic-Ebene anstelle von mehreren Ebenen hinzufügen kann.
  • Die maximale Anzahl der Zeichen ist auf 255 Zeichen begrenzt.

Darüber hinaus gibt es zwei wichtige Überlegungen:

  • Das Zeichen „/“ wird automatisch hinzugefügt: Beim Schreiben des Topic Präfix muss der Benutzer das „/“ nicht hinzufügen, um das Ende des Topic Präfix anzuzeigen. Dieses Zeichen wird automatisch hinzugefügt, nachdem die Zeichenfolge normalisiert und alle nicht erlaubten Zeichen in erlaubte Zeichen umgewandelt wurden. Wenn der Benutzer also „THeader/“ als Topic Präfix schreibt, wird es in „THeader_“ umgewandelt.
  • Wenn der Topic Präfix aktiviert ist, aber das Textfeld leer ist, wird standardmäßig keinen Topic Präfix hinzugefügt, und es hat die gleiche Wirkung wie wenn der Topic Präfix nicht aktiviert ist.