Plugin MQTT umožňuje komunikaci s MQTT brokerem (serverem) v síti. Miniserver vždy funguje jako MQTT klient a podporuje odesílání ("publishing") dat brokerovi a přijímání ("subscribing") dat od brokera.
MQTT (Message Queuing Telemetry Transport) je jednoduchý a lehký protokol, který lze použít pro komunikaci mezi zařízeními. Je široce používán pro aplikace "Internet věcí (IoT)", například pro sběr dat ze senzorů nebo ovládání chytrých zařízení.
Je vyžadován MQTT broker, na který se může Miniserver přihlásit a publikovat. Miniserver může spravovat 16 přihlášení (vstupy) a také 16 publikací (výstupy).
|
Upozorňujeme, že Miniserver Gen. 1 není podporován. |
Obsah
Vytváření a konfigurace objektu↑
Modul MQTT je integrován prostřednictvím síťové periferie:
Jeden plugin MQTT se může najednou připojit pouze k jednomu brokerovi. Nastavení proveďte následovně:
Odesílání/Přijímání dat↑
Pro příjem dat od brokera (subscribe) nebo odeslání dat brokerovi (publish) vytvořte příslušný objekt:
Odesílání a přijímání zpráv je vždy založeno na tématech, která slouží jako cesta nebo adresa identifikující data. Odběry mohou současně poslouchat více témat pomocí (wildcards). Publikování nepodporuje zástupné znaky.
Příklad Topicu:
Pokud je potřeba odeslat data na teplotní čidlo v obývacím pokoji, příslušné téma by mohlo vypadat takto:
domov/obývací_pokoj/teplota
Subscription:
Subscribe (přijímat):
Přijímá hodnoty na zadaném tématu od brokera.
Jiné zařízení nebo aplikace mohou subscribe tohoto tématu, aby přijímaly přenášené zprávy. Například termostat by se mohl přihlásit k odběru tématu home/livingroom/temperature, aby získal údaje o teplotě.
Pokud obdržíte data ve formátu JSON nebo podobná, doporučuje se použít blok "Rozpoznání příkazů" pro extrakci analogové hodnoty z dat.
|
|
Hodnota subscription je vyhodnocována nejvýše jednou za 2 sekundy. Pokud dojde ke změně hodnoty v intervalu kratším než 2 sekundy od předchozí změny, nová změna bude uložena do mezipaměti. Po uplynutí 2sekundového intervalu bude zpracována nejnovější změna. Tento přístup pomáhá snížit zatížení Miniserveru, zejména když jsou v krátkém časovém období odeslány na topic více změn. |
Wildcards v Subscriptions:
Abychom nemuseli odebírat každý topic zvlášť, MQTT podporuje zástupné symboly, které umožňují odběr více témat současně:
Jednoúrovňový Wildcard (+): Nahrazuje přesně jednu úroveň topicu v cestě topicu.
Příklad:
domov/+/teplota
Toto předplatné přijímá zprávy ze všech místností v domě, které odesílají údaje o teplotě, jako například:
home/livingroom/temperature
home/kitchen/temperature
Víceúrovňový Wildcard (#): Pokrývá všechny následující úrovně topicu v cestě topicu a musí být použit na konci cesty.
Příklad:
domov/#
Toto subscription obdrží všechny zprávy začínající na home/, bez ohledu na počet následujících úrovní, jako například:
home/obývací pokoj/teplota
home/kuchyně/vlhkost
home/garáž/auto/baterie
|
|
Pouze subscriptions podporují wildcards, publishes ne. Zařízení může posílat zprávy pouze na konkrétní topic, nikoli současně na více topiců. |
Publish:
Publish (odeslat):
Zařízení (klient) odesílá zprávu na konkrétní topic. V příkladu výše by teplotní čidlo odeslalo aktuální teplotu na home/livingroom/temperature.
Senzory↑
| Krátký popis | Jednotky |
|---|---|
| Subscription | Text |
Aktory↑
| Krátký popis | Jednotky |
|---|---|
| Publish | Text |
Vstupy pro diagnostiku↑
| Krátký popis | Popis | Jednotky | Rozsah hodnot |
|---|---|---|---|
| Onlinestatus | Uvádí, zda je zařízení dostupné pro Miniserver. Diagnostika Air zařízení Diagnostika Tree zařízení Diagnostika Extensionu |
Digital | 0/1 |
Vlastnosti↑
| Krátký popis | Popis | Rozsah hodnot | Výchozí hodnota |
|---|---|---|---|
| Adresa brokeru | Adresa síťového serveru MQTT broker | - | - |
| Port brokeru | Síťový port MQTT brokera (Výchozí: 1883) | 0...65535 | - |
| Verze protokolu | Podporovaná verze protokolu MQTT brokerem (výchozí: MQTTv5) | - | - |
| ID klienta | ID tohoto MQTT klienta. ID musí být unikátní při připojení k MQTT brokerovi! Při použití protokolu MQTTv3 je ID zkráceno na 23 znaků. | - | - |
| Uživatelské jméno | Uživatelské jméno pro ověření na MQTT brokeru. Ponechte prázdné pro anonymní přihlášení (pokud to MQTT broker umožňuje). | - | - |
| Heslo | Heslo pro ověření na MQTT brokeru. Ponechte prázdné pro anonymní přihlášení (pokud je to MQTT brokerem povoleno). | - | - |
| Použijte SSL/TLS | Použijte SSL/TLS spojení k MQTT brokerovi. | - | - |
| Monitorovat službu | Pokud je tato možnost zaškrtnuta, budete o nedostupnosti nebo offline stavu této služby informováni prostřednictvím Stavu Systému nebo Cloud Maileru. | - | - |