Geräteupdate für Azure IoT Hub mit Azure RTOS

In diesem Artikel erfahren Sie, wie Sie das Geräteupdate für azure IoT Hub-Agent in Azure RTOS NetX Duo erstellen. Darüber hinaus stehen einfache APIs zur Verfügung, mit denen Entwickler die Device Update-Funktion in ihre Anwendung integrieren können. Sehen Sie sich die wichtigen Beispiele für Halbleiter-Evaluierungsboards an, die Leitfäden zu den ersten Schritten enthalten. In diesen erfahren Sie, wie Sie OTA-Updates für die Geräte konfigurieren, erstellen und bereitstellen können.

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Voraussetzungen

• Zugriff auf eine IoT Hub-Instanz. Wir empfehlen, einen S1-Tarif (Standard) oder höher zu verwenden.
• Eine Device Update-Instanz und ein mit Ihrem IoT-Hub verknüpftes Konto. Befolgen Sie die Anleitung zum Erstellen und Verknüpfen eines Device Update-Kontos, wenn dies noch nicht geschehen ist.

Loslegen

Jedes Azure Echtzeit-Betriebssystemprojekt (RTOS), das spezifisch für das jeweilige Board ist, enthält Code und Dokumentation zur Verwendung der Geräteaktualisierung für IoT Hub. Du wirst:

1. Laden Sie die board-spezifischen Beispieldateien von Azure RTOS und Device Update samples herunter.
2. Navigieren Sie zum Dokumentationsordner des heruntergeladenen Beispiels.
3. Gehen Sie gemäß der Dokumentation die Schritte zum Vorbereiten der Azure-Ressourcen und eines Kontos sowie zum Registrieren von IoT-Geräten durch.
4. Befolgen Sie die Dokumentation, um ein neues Firmware-Image zu erstellen und das Manifest für Ihr Board zu importieren.
5. Veröffentlichen Sie das Firmware-Image und das Manifest in Device Update for IoT Hub.
6. Laden Sie das Projekt herunter, und führen Sie es auf Ihrem Gerät aus.

Erfahren Sie mehr über Azure RTOS.

Kennzeichnen Ihres Geräts

1. Lassen Sie die Geräteanwendung aus dem vorherigen Schritt weiter laufen.

2. Melden Sie sich beim Azure-Portal an, und navigieren Sie zum IoT-Hub.

3. Klicken Sie im linken Bereich auf Geräte. Suchen Sie Ihr IoT-Gerät und wechseln Sie zum digitalen Zwilling.

4. Löschen Sie im Gerätezwilling alle vorhandenen Device Update-Tagwerte, indem Sie sie auf „NULL“ festlegen.

5. Fügen Sie dem JSON-Stammobjekt einen neuen Tagwert für Device Update wie gezeigt hinzu:

       "tags": {
               "ADUGroup": "<CustomTagValue>"
               }
   

Erstellen einer Updategruppe

1. Navigieren Sie oben auf der Seite zur Registerkarte Gruppen und Bereitstellungen.

   

2. Wählen Sie Gruppe hinzufügen aus, um eine neue Gruppe zu erstellen.

   

3. Wählen Sie in der Liste ein IoT Hub-Tag und eine Geräteklasse aus. Wählen Sie anschließend Gruppe erstellen aus.

   

4. Nachdem die Gruppe erstellt wurde, sehen Sie, dass das Updatekonformitätsdiagramm und die Gruppenliste aktualisiert werden. Das Updatekonformitätsdiagramm zeigt die Anzahl von Geräten in verschiedenen Konformitätszuständen: Mit neuestem Update, Neue Updates verfügbar und Updates werden ausgeführt. Informieren Sie sich weiter über die Updatekonformität.

   

5. Ihre neu erstellte Gruppe und alle verfügbaren Updates für die Geräte in der neuen Gruppe sollten angezeigt werden. Wenn Geräte vorhanden sind, die die Geräteklassenanforderungen der Gruppe nicht erfüllen, werden sie in einer entsprechenden ungültigen Gruppe angezeigt. Um das beste verfügbare Update aus dieser Ansicht für die neue benutzerdefinierte Gruppe bereitzustellen, klicken Sie neben der Gruppe auf Bereitstellen.

Erfahren Sie mehr darüber, wie Sie Tags hinzufügen und Updategruppen erstellen.

Bereitstellen neuer Firmware

1. Nachdem die Gruppe erstellt wurde, sollte unter Bestes Update ein neues Update für Ihre Gerätegruppe mit dem entsprechenden Link angezeigt werden. Möglicherweise müssen Sie den Browser einmal aktualisieren. Informieren Sie sich weiter über die Updatekonformität.

2. Wählen Sie die Zielgruppe aus, indem Sie den Gruppennamen auswählen. Sie werden zu den Gruppendetails unter Allgemeine Informationen zu Gruppen weitergeleitet.

   

3. Um die Bereitstellung zu starten, wechseln Sie zur Registerkarte Aktuelle Bereitstellung. Klicken Sie im Abschnitt Verfügbare Updates auf den Link „Bereitstellen“ neben dem gewünschten Update. Das beste verfügbare Update für eine bestimmte Gruppe wird mit Beste hervorgehoben.

   

4. Planen Sie den Start Ihrer Bereitstellung sofort oder zu einem späteren Zeitpunkt. Wählen Sie dann Erstellen aus.

   Tipp

   Das Startdatum und die Uhrzeit sind standardmäßig 24 Stunden ab der aktuellen Zeit eingestellt. Wählen Sie unbedingt ein anderes Datum und eine andere Uhrzeit aus, wenn die Bereitstellung früher beginnen soll.

   

5. Unter Bereitstellungsdetails wird der Status in Aktiv geändert. Das Bereitstellungsupdate ist mit (Wird bereitgestellt) gekennzeichnet.

   

6. Zeigen Sie das Kompatibilitätsdiagramm an, um herauszufinden, ob das Update jetzt in Bearbeitung ist.

7. Nachdem das Gerät erfolgreich aktualisiert wurde, erkennen Sie, dass Ihr Konformitätsdiagramm und die Bereitstellungsdetails so aktualisiert wurden, dass sie übereinstimmen.

   

Überwachung der Updatebereitstellung

1. Klicken Sie oben auf der Seite auf die Registerkarte Bereitstellungsverlauf.

   

2. Klicken Sie neben der von Ihnen erstellten Bereitstellung auf Details.

   

3. Wählen Sie Aktualisieren aus, um die neuesten Statusdetails anzuzeigen.

Sie haben jetzt ein erfolgreiches End-to-End-Imageupdate mithilfe des Geräteupdates für IoT Hub auf einem eingebetteten Azure RTOS-Gerät abgeschlossen.

Nächste Schritte

Weitere Informationen zu Azure RTOS und deren Funktionsweise mit IoT Hub finden Sie auf der Azure RTOS-Webseite.