Aktualisieren von Azure Percept DK per Funk (Over-the-Air-Update)

Wichtig

Einstellung von Azure Percept DK:

Update 22. Februar 2023: Ein Firmwareupdate für die Percept DK Vision- und Audiozubehörkomponenten (auch bekannt als Vision und Audio SOM) ist jetzt hier verfügbar und ermöglicht es den Zubehörkomponenten, über den Ausmusterungstermin hinaus weiter zu funktionieren.

Die Public Preview von Azure Percept wird weiterentwickelt und soll neue Edgegeräteplattformen und Entwicklerfunktionen unterstützen. Im Rahmen dieser Weiterentwicklung werden Azure Percept DK und Audio Accessory sowie die zugehörigen unterstützenden Azure-Dienste für Percept DK am 30. März 2023 eingestellt.

Ab dem 30. März 2023 werden Azure Percept DK und Audio Accessory von keinem Azure-Dienst mehr unterstützt, einschließlich Azure Percept Studio, Betriebssystemupdates, Containerupdates, Anzeige von Webstreams und Custom Vision-Integration. Ab diesem Zeitpunkt bietet Microsoft keinen Kundenerfolgssupport und keine unterstützenden Dienste mehr. Weitere Informationen finden Sie im Blogbeitrag zur Außerbetriebnahme.

Achtung

Das OTA-Update für das Azure Percept DK wird nicht mehr unterstützt. Informationen zum weiteren Vorgehen finden Sie unter Aktualisieren des Azure Percept DK über eine USB-C-Kabelverbindung.

In dieser Anleitung erfahren Sie, wie Sie das Betriebssystem und die Firmware der Trägerplatine Ihres Azure Percept DK-Geräts per Funk (Over The Air, OTA) mit Device Update für IoT Hub aktualisieren.

Voraussetzungen

  • Azure Percept DK (DevKit)

  • Azure-Abonnement

  • Azure Percept DK-Setup: Sie haben Ihr DevKit mit einem WLAN verbunden, eine IoT Hub-Instanz erstellt und das DevKit mit der IoT Hub-Instanz verbunden.

  • Device Update für IoT Hub wurde erfolgreich konfiguriert

  • Stellen Sie sicher, dass Sie die alte Version des Device Update for IoT Hub verwenden. Navigieren Sie dazu in Ihrem IoT Hub zu Geräteverwaltung>Updates, und wählen Sie den Link Zur älteren Version wechseln im Banner aus.

    Screenshot des Banners.

    Achtung

    Das DevKit ist derzeit nicht mit den neuesten Änderungen im Device Update for IoT Hub-Dienst kompatibel. Daher ist es wichtig, auf die ältere Version des Device Update of Iot Hub zu wechseln (wie oben beschrieben), bevor Sie fortfahren.

Importieren Ihrer Update- und Manifestdatei

Hinweis

Falls Sie das Update bereits importiert haben, können Sie direkt mit Erstellen einer Geräteupdategruppe fortfahren.

  1. Bestimmen Sie, welches Manifest und Updatepaket für Ihr Dev Kit geeignet ist.

  2. Navigieren Sie zu der Azure IoT Hub-Instanz, die Sie für Ihr Azure Percept-Gerät verwenden. Wählen Sie im Menübereich auf der linken Seite unter Automatische Geräteverwaltung die Option Geräteupdates aus.

  3. Im oberen Bereich des Bildschirms werden mehrere Registerkarten angezeigt. Wählen Sie die Registerkarte Updates aus.

  4. Wählen Sie unter der Überschrift Bereitstellung kann durchgeführt werden die Option + Neues Update importieren aus.

  5. Klicken Sie auf die Felder unter Manifestdatei für Import auswählen und Updatedateien auswählen, um Ihre Manifestdatei (JSON-Datei) und Updatedatei (SWU-Datei) auszuwählen.

  6. Wählen Sie unter Speichercontainer auswählen das Ordnersymbol oder das Textfeld und anschließend das passende Speicherkonto aus. Wenn Sie bereits einen Speichercontainer erstellt haben, können Sie ihn wiederverwenden. Wählen Sie andernfalls + Container aus, um einen neuen Speichercontainer für OTA-Updates zu erstellen. Wählen Sie den gewünschten Container aus, und klicken Sie auf Auswählen.

  7. Wählen Sie Übermitteln aus, um den Importvorgang zu starten. Aufgrund der Imagegröße kann der Übermittlungsvorgang bis zu fünf Minuten dauern.

    Hinweis

    Möglicherweise werden Sie aufgefordert, eine CORS-Regel (Cross-Origin Resource Sharing, Ressourcenfreigabe zwischen verschiedenen Ursprüngen) für den Zugriff auf den ausgewählten Speichercontainer hinzuzufügen. Wählen Sie Add rule and retry (Regel hinzufügen und wiederholen) aus, um den Vorgang fortzusetzen.

  8. Wenn der Importvorgang beginnt, werden Sie zur Registerkarte Importverlauf der Seite Geräteupdates umgeleitet. Klicken Sie auf Aktualisieren, um den Fortschritt des Importvorgangs zu überwachen. Der Vorgang kann je nach Größe des Updates einige Minuten oder auch länger dauern (zu Spitzenzeiten kann mit einer Dauer von bis zu einer Stunde gerechnet werden).

  9. Wenn in der Spalte Status angezeigt wird, dass der Import erfolgreich war, wählen Sie die Registerkarte Bereitstellung kann durchgeführt werden aus, und klicken Sie auf Aktualisieren. Ihr importiertes Update sollte nun in der Liste angezeigt werden.

Erstellen einer Geräteupdategruppe

Mit Device Update für IoT Hub können Sie ein Update auf bestimmte Gruppen von Azure Percept DK-Geräten ausrichten. Um eine Gruppe zu erstellen, müssen Sie Ihrer Gerätezielgruppe in Azure IoT Hub ein Tag hinzufügen.

Hinweis

Falls Sie bereits eine Gruppe erstellt haben, können Sie mit dem nächsten Abschnitt fortfahren.

Anforderungen für Gruppentags:

  • Sie können Ihrem Tag einen beliebigen Wert hinzufügen (mit Ausnahme von „Uncategorized“ (Nicht kategorisiert), da es sich dabei um einen reservierten Wert handelt).
  • Der Tagwert darf maximal 255 Zeichen enthalten.
  • Der Tagwert darf nur folgende Sonderzeichen enthalten: „.“, „-“, „_“, „~“.
  • Für Tag- und Gruppennamen wird Groß-/Kleinschreibung beachtet.
  • Ein Gerät kann immer nur über ein einzelnes Tag verfügen. Wenn bereits ein Tag vorhanden ist und ein weiteres Tag hinzugefügt wird, wird das zuvor vorhandene Tag überschrieben.
  • Ein Gerät kann nur einer einzelnen Gruppe angehören.
  1. Fügen Sie Ihrem Gerät bzw. Ihren Geräten ein Tag hinzu:

    1. Suchen Sie im linken Navigationsbereich unter IoT Edge nach Ihrem Azure Percept DK-Gerät, und navigieren Sie zum zugehörigen Gerätezwilling.

    2. Fügen Sie wie im Anschluss gezeigt einen neuen Tagwert vom Typ Device Update für IoT Hub hinzu (<CustomTagValue> verweist auf Ihren Tagwert/-namen, z. B. „AzurePerceptGroup1“). Weitere Informationen zu Tags im JSON-Dokument für Gerätezwillinge finden Sie hier.

      "tags": {
      "ADUGroup": "<CustomTagValue>"
      },
      
  2. Klicken Sie auf Speichern, und beheben Sie ggf. vorhandene Formatierungsprobleme.

  3. Erstellen Sie eine Gruppe, indem Sie ein vorhandenes Azure IoT Hub-Tag auswählen:

    1. Kehren Sie zu Ihrer Azure IoT Hub-Seite zurück.
    2. Wählen Sie im Menübereich auf der linken Seite unter Automatische Geräteverwaltung die Option Geräteupdates aus.
    3. Wählen Sie die Registerkarte Gruppen . Auf dieser Seite wird die Anzahl nicht gruppierter Geräte angezeigt, die mit Device Update verbunden sind.
    4. Wählen Sie + Hinzufügen aus, um eine neue Gruppe zu erstellen.
    5. Wählen Sie in der Liste ein IoT Hub-Tag aus, und klicken Sie auf Übermitteln.
    6. Wenn die Gruppe erstellt wurde, werden das Updatekonformitätsdiagramm und die Gruppenliste aktualisiert. Das Diagramm gibt Aufschluss über die Anzahl von Geräten mit verschiedenen Konformitätszuständen: Mit neuestem Update, Neue Updates verfügbar, Updates werden ausgeführt und Not yet grouped (Noch nicht gruppiert).

Bereitstellen eines Updates

  1. Die neu erstellte Gruppe sollte mit einem neuen Update unter Verfügbare Updates aufgelistet werden. (Möglicherweise muss die Ansicht einmal aktualisiert werden.) Wählen Sie das Update aus.

  2. Vergewissern Sie sich, dass als Zielgerätegruppe die richtige Gerätegruppe ausgewählt ist. Wählen Sie ein Startdatum und eine Startzeit für Ihre Bereitstellung aus, und klicken Sie anschließend auf Bereitstellung erstellen.

    Achtung

    Wenn Sie die Startzeit auf einen Zeitpunkt in der Vergangenheit festlegen, wird die Bereitstellung sofort ausgelöst.

  3. Überprüfen Sie das Konformitätsdiagramm. Dort sollte zu sehen sein, dass das Update jetzt ausgeführt wird.

  4. Nach Abschluss des Updates wird das Konformitätsdiagramm mit dem neuen Status Ihres Updates aktualisiert.

  5. Wählen Sie oben auf der Seite Geräteupdates die Registerkarte Bereitstellungen aus.

  6. Wählen Sie Ihre Bereitstellung aus, um die Bereitstellungsdetails anzuzeigen. Klicken Sie ggf. auf Aktualisieren, bis sich der Status in Erfolgreich ändert.

Nächste Schritte

Ihr Development Kit wurde erfolgreich aktualisiert. Sie können die Entwicklung und den Betrieb mit Ihrem DevKit fortsetzen.