Jak zacząć

Dodanie klienta MQTT i konfiguracja

1. Zaloguj się do centrali.

2. Przejdź do zakładki Ustawienia → Integracje.

3. Kliknij przycisk Dodaj klient MQTT.
   
   

4. Wprowadź dane konfiguracyjne klienta MQTT.

5. Do celów testowych możesz skorzystać z ogólnodostępnego brokera MQTT:

   • Adres serwera: broker.hivemq.com

   • Port: 1883

6. Zapisz wprowadzoną konfigurację.
   
   

7. Przejdź do listy klientów MQTT, aby sprawdzić identyfikator (ID) nowo utworzonego klienta.

8. Identyfikator (ID) jest wyświetlany pod nazwą klienta.
   
   

Wysyłanie danych z centrali do brokera MQTT

1. Przejdź do zakładki Sceny.

2. Dodaj nową scenę typu Kod.

3. W polu edycji kodu wklej poniższy przykład:

   mqtt_client[ID]:publish("greetings", "Hello world", 0, false)

4. Zamień ID na identyfikator klienta MQTT utworzonego wcześniej.
   Przykład z identyfikatorem 2:

   mqtt_client[2]:publish("greetings", "Hello world", 0, false)
    

   
   
   

5. Ten przykład wysyła wiadomość "Hello world" na temat greetings, z poziomem QoS równym 0 i flagą retain ustawioną na false.

6. Szczegółowy opis funkcji publish znajduje się w dokumentacji języka Lua, dostępnej w zakładce Dokumentacja (menu górne).

7. Podpowiedź: do uzupełnienia kodu można również wykorzystać dostępne przykłady, znajdujące się w górnym menu.
   
   

8. Zapisz scenę.

9. Do odbierania wiadomości można użyć darmowego programu MQTT Explorer.
   Po pobraniu i instalacji programu:

   • Wprowadź dane połączeniowe do brokera (np. broker.hivemq.com, port 1883).

   • Przejdź do zakładki Advanced.

   • Dodaj subskrypcję na temat greetings, na którym klient będzie odbierał wiadomości.

10. Kliknij przycisk +ADD, aby dodać subskrypcję na wskazany temat.
    
    
    
    

11. Następnie kliknij Back, Save, a następnie Connect, aby nawiązać połączenie z brokerem.
    Po poprawnym połączeniu powinien zostać wyświetlony stan połączenia oraz aktualne tematy i wiadomości.
    
    

12. Aby przetestować wysyłanie danych z centrali, uruchom wcześniej zapisaną scenę.
    
    

13. Po uruchomieniu sceny w programie MQTT Explorer powinna pojawić się wiadomość wysłana z centrali za pomocą klienta MQTT.
    
    

Odbieranie danych z brokera MQTT

1. Aby odbierać dane z brokera, należy dodać temat (topic), na którym będą one przesyłane.
   
   

   • Przejdź do zakładki Integracje.

   • Wyświetl listę klientów MQTT.

   • Wejdź w edycję klienta utworzonego wcześniej.

   • Dodaj subskrypcję na temat data.

2. Aby wyświetlić otrzymane dane, dodaj scenę z kodem Lua, która wypisze odebraną wiadomość.

   • Przejdź do zakładki Automatyzacje.

   • Dodaj nową automatyzację o nazwie mqtt i typie Kod.

   • Wprowadź poniższy kod:

     mqtt_client[2]:onMessage(function(topic, payload, qos, retain, dup)
     print("topic: " .. topic .. " - data: " .. payload)
     end)

   • Uwaga: Upewnij się, że liczba 2 odpowiada identyfikatorowi klienta utworzonego wcześniej.

3. Aby zobaczyć przychodzące dane, kliknij ikonę w lewym dolnym rogu interfejsu, przejdź do zakładki Automatyzacje, a następnie wybierz utworzoną wcześniej automatyzację mqtt.
   
   

4. Otwórz program MQTT Explorer.
   Ustaw w polu wysyłki temat data (taki sam, jak ustawiony wcześniej jako subskrypcja) i wpisz wiadomość, którą chcesz wysłać.
   
   

5. Kliknij przycisk PUBLISH.
   Wiadomość zostanie wysłana do brokera, a następnie odebrana przez centralę i wypisana w konsoli logów.