Instalowanie i używanie eksploratora usługi Azure IoT

Eksplorator usługi Azure IoT to graficzne narzędzie do interakcji z usługą i urządzeniami połączonymi z centrum IoT. Ten artykuł koncentruje się na używaniu narzędzia do testowania IoT Plug and Play urządzeniach. Po zainstalowaniu narzędzia na komputerze lokalnym możesz użyć go do nawiązania połączenia z koncentratorem. Za pomocą tego narzędzia można wyświetlać dane telemetryczne, które wysyłają urządzenia, pracować z właściwościami urządzenia i wywoływać polecenia.

W tym artykule wyjaśniono, jak:

  • Zainstaluj i skonfiguruj narzędzie Azure IoT Explorer.
  • Użyj tego narzędzia, aby wchodzić w interakcje z urządzeniami IoT Plug and Play testowe.

Aby uzyskać więcej ogólnych informacji na temat korzystania z narzędzia, zobacz GitHub readme.

Do korzystania z narzędzia Azure IoT Explorer potrzebne są:

  • Centrum Azure IoT Hub. Istnieje wiele sposobów dodawania centrum IoT do subskrypcji platformy Azure, na przykład tworzenie centrum IoT przy użyciuinterfejsu wiersza polecenia platformy Azure. Do uruchomienia narzędzia eksploratora usługi Azure IoT potrzebne są ciągi połączenia centrum IoT. Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
  • Urządzenie zarejestrowane w centrum IoT. Eksplorator IoT umożliwia tworzenie rejestracji urządzeń i zarządzanie nimi w IoT Hub.

Instalowanie eksploratora usługi Azure IoT

Przejdź do wydań eksploratora usługi Azure IoT i rozwiń listę zasobów dla najnowszej wersji. Pobierz i zainstaluj najnowszą wersję aplikacji.

Ważne

Aktualizacja do wersji 0.13.x w celu rozpoznawania modeli z dowolnego repozytorium opartego na https://github.com/Azure/iot-plugandplay-models

Korzystanie z eksploratora usługi Azure IoT

W przypadku urządzenia możesz połączyć własne urządzenie lub użyć jednego z przykładowych symulowanych urządzeń. Przykładowe symulowane urządzenia napisane w różnych językach można znaleźć w Połączenie przykładowej aplikacji IoT Plug and Play urządzenia do IoT Hub samouczku.

Połączenie do centrum

Przy pierwszym uruchomieniu eksploratora usługi Azure IoT zostanie wyświetlony monit o ciąg połączenia centrum IoT. Po dodaniu parametrów połączenia wybierz pozycję Połączenie. Możesz użyć ustawień narzędzia, aby przełączyć się do innego centrum IoT, aktualizując wartości parametrów połączenia.

Definicja modelu dla urządzenia IoT Plug and Play jest przechowywana w repozytorium publicznym, na połączonym urządzeniu lub w folderze lokalnym. Domyślnie narzędzie szuka definicji modelu w repozytorium publicznym i na połączonym urządzeniu. Możesz dodawać i usuwać źródła lub konfigurować priorytet źródeł w programie Ustawienia:

Aby dodać źródło:

  1. Przejdź do strony głównej/IoT Plug and Play Ustawienia
  2. Wybierz pozycję Dodaj i wybierz źródło z repozytorium lub folderu lokalnego.

Aby usunąć źródło:

  1. Przejdź do strony głównej/IoT Plug and Play Ustawienia
  2. Znajdź źródło, które chcesz usunąć.
  3. Wybierz przycisk X, aby go usunąć.

Zmienianie priorytetów źródła:

Możesz przeciągnąć i upuścić jedno ze źródeł definicji modelu do innego rankingu na liście.

Wyświetlanie urządzeń

Gdy narzędzie nawiąże połączenie z centrum IoT, zostanie wyświetlona strona listy Urządzenia, która zawiera listę tożsamości urządzeń zarejestrowanych w centrum IoT. Możesz wybrać dowolny wpis na liście, aby wyświetlić więcej informacji.

Na stronie listy Urządzenia można:

  • Wybierz pozycję Nowe, aby zarejestrować nowe urządzenie w centrum. Następnie wprowadź identyfikator urządzenia. Użyj ustawień domyślnych, aby automatycznie wygenerować klucze uwierzytelniania i włączyć połączenie z centrum.
  • Wybierz urządzenie, a następnie wybierz pozycję Usuń, aby usunąć tożsamość urządzenia. Przed ukończeniem tej akcji przejrzyj szczegóły urządzenia, aby upewnić się, że usuwasz właściwą tożsamość urządzenia.

Interakcja z urządzeniem

Na stronie listy Urządzenia wybierz wartość w kolumnie Identyfikator urządzenia, aby wyświetlić stronę szczegółów zarejestrowanego urządzenia. Dla każdego urządzenia istnieją dwie sekcje: Urządzenie i Bliźniacze reprezentacji usługi Digital Twins.

Urządzenie

Ta sekcja zawiera karty Tożsamość urządzenia, Bliźniacze reprezentacji urządzenia, Telemetria, Metoda bezpośrednia, Komunikat z chmury do urządzenia, Tożsamość modułu.

  • Informacje o tożsamości urządzenia można wyświetlić i zaktualizować na karcie Tożsamość urządzenia.
  • Dostęp do informacji o bliźniaczej reprezentacji urządzenia można uzyskać na karcie bliźniaczej reprezentacji urządzenia.
  • Jeśli urządzenie jest połączone i aktywnie wysyła dane, możesz wyświetlić dane telemetryczne na karcie Telemetria.
  • Metodę bezpośrednią można wywołać na urządzeniu na karcie Metoda bezpośrednia.
  • Komunikat z chmury do urządzenia można wysłać na karcie Komunikaty z chmury do urządzenia.
  • Możesz uzyskać dostęp do informacji o bliźniaczej reprezentacji modułu.

IoT Plug and Play składników

Jeśli urządzenie jest połączone z koncentratorem przy użyciu identyfikatora modelu, narzędzie wyświetla kartę IoT Plug and Play, na której można zobaczyć identyfikator modelu.

Jeśli identyfikator modelu jest dostępny w jednym ze skonfigurowanych źródeł — publicznym lub lokalnym folderze, zostanie wyświetlona lista składników. Wybranie składnika pokazuje dostępne właściwości, polecenia i dane telemetryczne.

Na stronie Składnik można wyświetlać właściwości tylko do odczytu, aktualizować właściwości zapisywalne, wywoływać polecenia i wyświetlać komunikaty telemetryczne wytwarzanych przez ten składnik.

Wyświetlanie składników w eksploratorze usługi Azure IoT

Właściwości

Wyświetlanie właściwości w eksploratorze usługi Azure IoT

Właściwości tylko do odczytu zdefiniowane w interfejsie można wyświetlić na karcie Właściwości (tylko do odczytu). Właściwości zapisywalne zdefiniowane w interfejsie można zaktualizować na karcie Właściwości (zapisywalne):

  1. Przejdź do karty Właściwości (z zapisywalnym dostępem).
  2. Kliknij właściwość, która chcesz zaktualizować.
  3. Wprowadź nową wartość właściwości .
  4. Wyświetl podgląd ładunku, który ma zostać wysłany do urządzenia.
  5. Prześlij zmianę.

Po przesłaniu zmiany możesz śledzić stan aktualizacji: synchronizowanie, powodzenie lub błąd. Po zakończeniu synchronizowania nowa wartość właściwości zostanie wyświetlony w kolumnie Zgłaszane właściwości. Jeśli przechodzisz do innych stron przed zakończeniem synchronizowania, narzędzie nadal powiadamia o zakończeniu aktualizacji. Możesz również użyć centrum powiadomień narzędzia, aby wyświetlić historię powiadomień.

Polecenia

Aby wysłać polecenie do urządzenia, przejdź do karty Polecenia:

  1. Na liście poleceń rozwiń polecenie, które chcesz wyzwolić.
  2. Wprowadź wszystkie wymagane wartości polecenia.
  3. Wyświetl podgląd ładunku, który ma zostać wysłany do urządzenia.
  4. Prześlij polecenie .

Telemetria

Aby wyświetlić dane telemetryczne dla wybranego interfejsu, przejdź do karty Telemetria.

Znane problemy

Aby uzyskać listę funkcji IoT obsługiwanych przez najnowszą wersję narzędzia, zobacz Lista funkcji.

Następne kroki

W tym artykule z instalowania i używania eksploratora usługi Azure IoT do interakcji z urządzeniami IoT Plug and Play chmurze. Sugerowanym następnym krokiem jest nauka zarządzania usługą IoT Plug and Play digital twins.