Korzystanie z programu narzędziowego klienta MQTT

W celu przetestowania konfiguracji pomiarowej można użyć jednego lub kilku programów narzędziowych klienta MQTT. W ramach tego zadania użyto jednego programu narzędziowego klienta w celu publikowania i subskrybowania komunikatów.

Zanim zaczniesz

  • Należy sprawdzić, czy usługa telemetryczna (MQXR) działa.
  • Konieczny jest co najmniej jeden działający kanał pomiarowy, aby pomyślnie użyć programu narzędziowego klienta MQTT.

Informacje o zadaniu

Istnieje kilka metod uruchomienia programu narzędziowego klienta MQTT. Więcej informacji na temat uruchamiania programu narzędziowego klienta zawiera sekcja Uruchamianie programu narzędziowego klienta MQTT. W ramach tego zadania program narzędziowy klienta jest uruchamiany z kanału pomiarowego PlainText utworzonego za pomocą kreatora Definiowanie przykładowej konfiguracji.

Domyślnie ID użytkownika MCA kanału PlainText jest ustawiony na guest w systemie Windows, a nobody w systemie Linux®. Te wartości domyślne są niezbędne w celu zasubskrybowania tematów.

Procedura

  1. Kliknij prawym przyciskiem myszy kanał telemetryczny PlainText , a następnie kliknij opcję Uruchom program narzędziowy klienta MQTT. Zostanie otwarte okno programu narzędziowego klienta. Wartości pól Host i Port zostaną ustawione automatycznie przy użyciu wartości z wybranego kanału pomiarowego.
  2. Wpisz identyfikator klienta w polu Identyfikator klienta . Przy każdym uruchomieniu programu narzędziowego klienta MQTT z kanału pomiarowego jest generowany nowy identyfikator klienta. Można użyć wygenerowanego identyfikatora lub wpisać nazwę wybranego identyfikatora. W przypadku uruchomienia więcej niż jednego programu narzędziowego klienta w kanale pomiarowym, należy pamiętać o użyciu różnych identyfikatorów klienta w każdym programie narzędziowym klienta. Jeśli dwa programy narzędziowe klienta MQTT mają taki sam identyfikator klienta, ten, który nawiązał połączenie jako ostatni, zostanie rozłączony z poprzednim w sposób wymuszony. W przypadku uruchamiania więcej niż jednego programu narzędziowego klienta MQTT z kanału pomiarowego wygenerowany identyfikator klienta posiada przyrostek liczbowy, który jest powiększany przy każdym uruchomieniu nowego programu narzędziowego klienta.
  3. Kliknij przycisk Opcje , aby otworzyć okno Opcje połączenia . Program narzędziowy klienta można uruchomić od wyczyszczonej sesji lub skonfigurować opcje ostatniej woli i testamentu.
  4. Kliknij opcję Połącz , aby nawiązać połączenie z kanałem telemetryczny PlainText . W polu Historia klientawyświetlana jest nowa pozycja zdarzenia Connected .
  5. Wpisz nazwę tematu w polu Subskrypcja Temat . Domyślna nazwa tematu to testTopic , a ta nazwa jest używana w ramach tego zadania.
  6. Wybierz jakość subskrypcji usługi z menu Żądaj usługi QoS .
  7. Kliknij opcję Subskrybuj , aby zasubskrybować temat testTopic. W polu Historia klientazostanie wyświetlona nowa pozycja zdarzenia Subscribed wraz z nazwą tematu, QoS i czasem subskrypcji.
  8. Zaakceptuj domyślną nazwę tematu testTopicw polu Publikacja Temat . Należy upewnić się, że tematy subskrypcji i publikacji są zgodne, tak aby klient MQTT otrzymywał komunikaty z odpowiedniego tematu.
  9. Wpisz komunikat w polu Komunikat . Domyślnym testem komunikatu jest Test Message.
  10. Wybierz jakość usługi publikacji z menu Żądaj jakości usługi .
  11. Wybierz opcję Zachowana , aby przekazać najnowsze zachowaną publikację w tym temacie do nowych subskrybentów.
  12. Kliknij przycisk Publikuj , aby opublikować komunikat w temacie testTopic dla zainteresowanych subskrybentów. Nowa pozycja zdarzenia Published jest wyświetlana w obszarze Historia klientawraz z nazwą tematu, QoS, czy komunikat jest zachowywany, a także czasem subskrypcji. W programie narzędziowym klienta odbierającego nowa pozycja zdarzenia Received jest wyświetlana w polu Historia klienta.
  13. Wybierz otrzymany komunikat w polu Historia klienta, a następnie kliknij opcję Wyświetl komunikat , aby wyświetlić pełny komunikat w oknie Przeglądarka komunikatów . Można także wybrać komunikat i nacisnąć klawisz Enter lub dwukrotnie kliknąć odebrany komunikat.

Wyniki

Możliwość publikowania i przeglądania komunikatów w zasubskrybowanych tematach świadczy o poprawnym skonfigurowaniu menedżera kolejek dla składnika Telemetry.