Udostępnij przez


Instalowanie i używanie eksploratora usługi Azure IoT

Ważne

Ten artykuł zawiera kroki nawiązywania połączenia z usługą przy użyciu sygnatury dostępu współdzielonego. Ta metoda uwierzytelniania jest wygodna do testowania i oceny, ale uwierzytelnianie w usłudze przy użyciu identyfikatora Entra firmy Microsoft lub tożsamości zarządzanych jest bardziej bezpieczne. Aby dowiedzieć się więcej, zobacz Najlepsze rozwiązania w zakresie zabezpieczeń rozwiązań > IoT w chmurze.

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

W tym artykule pokazano, jak wykonać następujące działania:

  • Zainstaluj i skonfiguruj narzędzie Azure IoT Explorer.
  • Użyj narzędzia do interakcji i przetestowania urządzeń IoT Plug and Play.

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

Aby użyć narzędzia Azure IoT Explorer, potrzebne są następujące elementy:

  • Hub Azure IoT. Istnieje wiele sposobów dodawania centrum IoT Hub do subskrypcji platformy Azure, takich jak Tworzenie centrum IoT Hub przy użyciu interfejsu wiersza polecenia platformy Azure. Aby uruchomić narzędzie Azure IoT Explorer, potrzebne są parametry połączenia centrum IoT Hub. 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 usłudze IoT Hub.

Instalowanie eksploratora usługi Azure IoT

Przejdź do wersji eksploratora usługi Azure IoT i rozwiń listę zasobów dla najnowszej wersji. Pobierz i zainstaluj najnowszą wersję aplikacji. Pakiet instalacyjny konfiguruje sposób uruchamiania aplikacji na platformie. Na przykład w systemie Windows możesz uruchomić aplikację z menu Start.

Ważne

Przeprowadź aktualizację do wersji 0.13.x lub nowszej, aby rozpoznawać modele z dowolnego repozytorium na podstawie 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ń.

Nawiązywanie połączenia z centrum

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

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

Aby dodać źródło:

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

Aby usunąć źródło:

  1. Przejdź do pozycji Strona główna/Ustawienia usługi IoT Plug and Play
  2. Znajdź źródło, które chcesz usunąć.
  3. Wybierz X, aby ją usunąć.

Zmień priorytety źródłowe:

Możesz przeciągać i upuszczać jedno ze źródeł definicji modelu, aby zmienić jego pozycję w rankingu na liście.

Zobacz urządzenia

Po nawiązaniu połączenia z centrum IoT wyświetlona zostanie strona Urządzenia, która zawiera listę tożsamości urządzeń zarejestrowanych w centrum IoT. Aby wyświetlić więcej informacji, możesz wybrać dowolny wpis na liście.

Na stronie listy Urządzenia można wykonywać następujące czynności:

  • Wybierz Nowy, aby zarejestrować nowe urządzenie w hubie. 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 odpowiednią tożsamość urządzenia.

Interakcja z urządzeniem

Na liście Urządzenia wybierz wartość w kolumnie Identyfikator urządzenia , aby wyświetlić stronę szczegółów zarejestrowanego urządzenia. Dla każdego urządzenia znajdują się dwie sekcje: Urządzenie (Device) i Cyfrowy Bliźniak (Digital Twin).

Urządzenie

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

Składniki usługi IoT Plug and Play

Jeśli urządzenie jest połączone z centrum przy użyciu identyfikatora modelu, narzędzie wyświetli kartę Składniki usługi 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ł — repozytorium publiczne lub folder lokalny, zostanie wyświetlona lista składników. Wybranie składnika powoduje wyświetlenie dostępnych właściwości, poleceń i telemetrii.

Na stronie Składnik można wyświetlić właściwości tylko do odczytu, zaktualizować właściwości zapisywalne, wywołać polecenia i wyświetlić komunikaty telemetryczne wygenerowane 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 możliwością zapisu).
  2. Wybierz właściwość, którą 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: synchronizacja, powodzenie lub błąd. Po zakończeniu synchronizacji zostanie wyświetlona nowa wartość właściwości w kolumnie Zgłoszona wartość . Jeśli przejdziesz do innych stron przed ukończeniem synchronizacji, 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. Rozwiń polecenie, które chcesz wyzwolić na liście poleceń.
  2. Wprowadź wszystkie wymagane wartości dla 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 . Wybierz pozycję Rozpocznij , aby rozpocząć odbieranie danych telemetrycznych.

Znane problemy

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