TapHome

MQTT Broker

Introducere în protocolul MQTT și activarea serviciului MQTT Broker în sistemul TapHome pentru comunicația cu dispozitivele terțe.

Ultima actualizare:

TapHome poate rula un MQTT Broker direct pe controler, astfel încât dispozitivele terțe, precum Shelly, Zigbee2MQTT sau Tasmota, schimbă mesaje cu TapHome prin topicuri publish/subscribe. Îl activați în Setări → Hardware, introducând numărul portului, prefixul ID-ului de client, numele de utilizator și parola. Toată comunicația rămâne în rețeaua dvs., nu se trimit date în cloud. După activare, definiți comunicația MQTT în Hardware → Packet parser.

Ce este MQTT?

MQTT (Message Queuing Telemetry Transport) este un protocol de comunicație publish/subscribe cu consum redus de resurse, conceput special pentru Internet of Things (IoT) și comunicația Machine-to-Machine (M2M).

Concepte de bază MQTT

Modelul Publish/Subscribe:

  • Spre deosebire de comunicația tradițională client-server, MQTT folosește un model în care dispozitivele nu trebuie să își cunoască reciproc adresele
  • Dispozitivele comunică printr-un punct central - MQTT Broker
  • Un dispozitiv publică mesaje pe un topic specific
  • Alte dispozitive se abonează la aceste topicuri și primesc mesajele automat

Topicuri:

  • O structură de organizare a mesajelor, asemănătoare folderelor dintr-un sistem de fișiere
  • Exemplu: home/living_room/temperature, home/kitchen/light/status
  • Dispozitivele se pot abona la anumite topicuri sau pot folosi caractere wildcard (home/# = toate topicurile din home)

Avantajele MQTT:

  • Consum extrem de redus de date și energie
  • Funcționează pe rețele lente sau instabile
  • Simplu de implementat
  • Scalabil de la sisteme mici la sisteme mari

MQTT Broker în TapHome

MQTT Broker este un serviciu pentru gestionarea comunicației MQTT dintre dispozitive. Brokerul poate funcționa pe un calculator extern sau direct pe controlerul TapHome.

MQTT Broker din TapHome funcționează ca:

  • Mediator central pentru toate mesajele MQTT din sistem
  • Punte între TapHome și dispozitivele terțe (Shelly, Zigbee2MQTT, Tasmota și altele)
  • Serviciu local - toată comunicația rămâne în rețeaua dvs., nu se trimit date în cloud

Cum activați MQTT Broker în TapHome

  1. Mergeți la Setări → Hardware și selectați MQTT Broker
  2. Introduceți datele de configurare, inclusiv numărul portului, prefixul ID-ului de client, numele de utilizator și parola
  3. Salvați setările pentru a activa serviciul
Configurare MQTT Broker - Setări

Detalii de configurare

După activare, configurația comunicației MQTT se definește în Hardware → Packet parser.

Configurare MQTT Broker - Aplicație

În modulul Packet Parser cu protocolul MQTT, introduceți ca adresă IP a brokerului 127.0.0.1 — astfel unitatea de control se conectează la ea însăși, iar adresa nu se schimbă nici după modificarea adresei IP a unității. Nu introduceți aici adresa IP proprie a unității de control: când routerul o schimbă, modulul nu mai primește mesaje. Cum atribuiți unității de control și dispozitivelor o adresă fixă → Pregătirea rețelei pentru o instalație TapHome.

Exemplu practic de utilizare

Scenariu: Aveți un dispozitiv Shelly (priză inteligentă) și doriți să îl integrați în TapHome.

  1. Activați MQTT Broker în TapHome (urmând pașii de mai sus)
  2. Configurați dispozitivul Shelly - în interfața sa web, introduceți adresa IP a controlerului TapHome (cu rezervare în router) și portul brokerului MQTT
  3. Creați un modul Packet Parser în TapHome cu protocolul MQTT și adresa IP a brokerului 127.0.0.1
  4. Configurați topicurile MQTT - de exemplu, shellies/shellyplug-s-12345/relay/0 pentru starea releului și shellies/shellyplug-s-12345/relay/0/command pentru controlul releului
  5. Dispozitivul este conectat - acum puteți controla Shelly prin aplicația TapHome și puteți crea smart rules

Rezultat: Shelly își publică starea pe un topic MQTT, TapHome primește notificări despre modificări. Când doriți să porniți/opriți Shelly, TapHome publică o comandă pe topicul corespunzător.