OTA-Image vorbereiten

OTA-Firmware-Update-Images müssen dem OTA-Software-Image-Dateiformat von Matter entsprechen, das Folgendes umfasst:

• Eine Dateikennung, die die Datei eindeutig als Matter-Firmware-Update-Datei identifiziert
• Die Größe der Datei
• Die Headergröße
• Ein TLV-codierter Header (Tag-length-value) mit Informationen zum Update, darunter:
  • VID
  • PID
  • Softwareversion
• Die Nutzlast

Das Matter SDK bietet ein Tool zum Erstellen und Prüfen von Matter-OTA-Images (ota_image_tool.py). Einige Build-Systeme können Matter-OTA-Images automatisch erstellen. Weitere Informationen finden Sie in der SoC-Dokumentation.

OTA-Image erstellen

Verwenden Sie ota_image_tool.py, um das Image zu erstellen:

$ ./ota_image_tool.py create \
  -v hexVendorId \
  -p hexProductId \
  -vn versionNumber \
  -vs "versionString" \
  -da "hash-function \
  path_to_binary \
  path_to_ota_file

Führen Sie das Script mit dem Befehl show aus, um den Metadatensatz und den Header der Datei zu prüfen:

$ ./ota_image_tool.py show path_to_ota_file

Beispielausgabe:

Magic: 1beef11e
Total Size: 90
Header Size: 62
Header TLV:
  [0] Vendor Id: XXXX (0xXX)
  [1] Product Id: XXX (0xXX)
  [2] Version: 101 (0x65)
  [3] Version String: 1.0.1
  [4] Payload Size: 12 (0xc)
  [8] Digest Type: 1 (0x1)
  [9] Digest: a948904f2f0f429b8f8197694b30184b0d2ed1c3cd2a1ec0fb85d299a193a447

OTA-Image hochladen

So laden Sie das Image in die Google Home Developer Console hoch:

Zur Developer Console

1. Öffnen Sie Ihr Projekt und dann Ihr Gerät.

2. Gehe zu Matter > OTA.

3. Klicke in der Liste Integrationen neben dem Gerät auf OTA verwalten.

4. Klicken Sie auf dem Tab Verwalten auf addOTA-Image hinzufügen.

1. Klicken Sie auf attach_fileHochladen, um die Bilddatei auszuwählen und hochzuladen.

   Nachdem das Image erfolgreich validiert wurde, wird der Dateiname unter dem Button attach_fileHochladen angezeigt.

Das OTA-Image ist kurz nach dem Upload für die Verteilung verfügbar.

OTA-Image-Beschreibung hinzufügen oder ändern

1. Gehe zu Matter > OTA.

2. Klicken Sie auf dem Tab Verwalten neben dem Image, das Sie ändern möchten, auf Öffnen.

3. Im Dialogfeld OTA-Bilddetails können Sie die Bildbeschreibung ändern.

4. Klicken Sie auf Abbrechen oder Speichern.

OTA-Image löschen

Du kannst kein OTA-Image löschen, das sich im Status „Veröffentlicht“ befindet. Du kannst nur Images im Status „Bereit“ löschen. So löschen Sie ein OTA-Image im Status „Bereit“:

1. Gehe zu Matter > OTA.

2. Klicken Sie auf dem Tab Verwalten auf das Dreipunkt-Menü more_vert neben dem OTA-Image und wählen Sie Löschen aus.