Aktualizacja urządzenia dla usługi Azure IoT Hub przy użyciu usługi Azure RTOS

W tym artykule przedstawiono sposób tworzenia aktualizacji urządzenia dla agenta usługi Azure IoT Hub w usłudze Azure RTOS NetX Duo. Udostępnia również proste interfejsy API dla deweloperów, które umożliwiają integrowanie możliwości aktualizacji urządzeń w swojej aplikacji. Przeglądaj przykłady kluczowych płyt ewaluacyjnych półprzewodników, które zawierają przewodniki startowe, aby dowiedzieć się, jak konfigurować, budować i wdrażać aktualizacje bezprzewodowe na urządzeniach.

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Wymagania wstępne

Dostęp do wystąpienia usługi IoT Hub. Zalecamy użycie warstwy S1 (Standardowa) lub nowszej.
Instancja i konto usługi Device Update powiązane z Twoim centrum IoT Hub. Postępuj zgodnie z przewodnikiem, aby utworzyć i połączyć konto aktualizacji urządzenia, jeśli nie zostało to zrobione wcześniej.

Rozpocznij

Każdy projekt przykładowy specyficzny dla płyty z systemem operacyjnym Azure w czasie rzeczywistym (RTOS) zawiera kod i dokumentację dotyczącą korzystania z usługi Device Update dla usługi IoT Hub. Wykonasz:

Pobierz przykładowe pliki specyficzne dla płyty z przykładów Azure RTOS i Device Update.
Znajdź folder dokumenty z pobranej próbki.
W dokumentacji wykonaj kroki przygotowywania zasobów platformy Azure i konta oraz rejestrowania urządzeń IoT.
Postępuj zgodnie z dokumentacją, aby utworzyć nowy obraz oprogramowania układowego i zaimportować manifest dla płytki.
Opublikuj obraz oprogramowania układowego i manifest w usłudze Device Update dla usługi IoT Hub.
Pobierz i uruchom projekt na urządzeniu.

Dowiedz się więcej o Azure RTOS.

Oznacz swoje urządzenie

Zachowaj działanie aplikacji urządzenia z poprzedniego kroku.
Zaloguj się do witryny Azure Portal i przejdź do centrum IoT Hub.
W okienku po lewej stronie wybierz pozycję Urządzenia. Znajdź urządzenie IoT i przejdź do cyfrowego bliźniaka urządzenia.
W bliźniaczej reprezentacji urządzenia usuń wszystkie istniejące wartości tagów usługi Device Update, ustawiając je na wartość null.
Dodaj nową wartość tagu Device Update do głównego obiektu JSON, jak pokazano poniżej:
```
    "tags": {
            "ADUGroup": "<CustomTagValue>"
            }
```

Tworzenie grupy aktualizacji

Przejdź do zakładki Grupy i Wdrożenia w górnej części strony.
Wybierz Dodaj grupę, aby utworzyć nową grupę.
Wybierz tag usługi IoT Hub i klasę urządzenia z listy. Następnie wybierz pozycję Utwórz grupę.
Po utworzeniu grupy zobaczysz, że zaktualizowano zarówno wykres zgodności aktualizacji, jak i listę grup. Wykres zgodności aktualizacji przedstawia liczbę urządzeń w różnych stanach zgodności: w przypadku najnowszej aktualizacji, dostępne nowe aktualizacje i aktualizacje w toku. Dowiedz się więcej o zgodności aktualizacji.
Twoja nowo utworzona grupa powinna być widoczna, podobnie jak wszystkie dostępne aktualizacje dla urządzeń w tej grupie. Jeśli istnieją urządzenia, które nie spełniają wymagań klasy urządzeń grupy, są one wyświetlane w odpowiedniej nieprawidłowej grupie. Aby wdrożyć najlepszą dostępną aktualizację dla nowej grupy zdefiniowanej przez użytkownika z tego widoku, wybierz pozycję Wdróż obok grupy.

Dowiedz się więcej na temat dodawania tagów i tworzenia grup aktualizacji.

Wdrażanie nowego oprogramowania układowego

Po utworzeniu grupy powinna zostać wyświetlona nowa aktualizacja dostępna dla grupy urządzeń z linkiem do aktualizacji w obszarze Najlepsza aktualizacja. Może być konieczne odświeżenie strony jeden raz. Dowiedz się więcej o zgodności aktualizacji.
Wybierz grupę docelową, wybierając nazwę grupy. Zostaniesz przekierowany do szczegółów grupy w obszarze Podstawowe informacje o grupie.
Aby rozpocząć wdrażanie, przejdź do karty Bieżące wdrożenie . Wybierz link wdrażania obok żądanej aktualizacji w sekcji Dostępne aktualizacje . Najlepsza dostępna aktualizacja dla danej grupy jest oznaczona wyróżnieniem Najlepsze .
Zaplanuj rozpoczęcie wdrożenia natychmiast lub w przyszłości. Następnie wybierz Utwórz.

Wskazówka

Domyślnie data i godzina rozpoczęcia to 24 godziny od bieżącej godziny. Pamiętaj, aby wybrać inną datę i godzinę, jeśli chcesz, aby wdrożenie rozpoczęło się wcześniej.
W sekcji Szczegóły wdrożeniaStatus zmienia się na Aktywny. Wdrożona aktualizacja jest oznaczona elementem (wdrażanie).
Wyświetl wykres zgodności, aby zobaczyć, że aktualizacja jest teraz w toku.
Po pomyślnym zaktualizowaniu urządzenia zobaczysz, że wykres zgodności i szczegóły wdrożenia zostały zaktualizowane w celu odzwierciedlenia tego samego.