OTA-Image vorbereiten

OTA-Firmware-Update-Images müssen dem Dateiformat Matter OTA Software Image entsprechen. Dazu gehören:

• Eine Datei-ID, die die Datei eindeutig als Matter-Firmwareupdatedatei identifiziert
• Die Größe der Datei
• Kopfzeilengröße
• Eine TLV-codierte (Tag-Length-Value) Kopfzeile mit Informationen zur Aktualisierung, 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. Lesen Sie dazu die SoC-Dokumentation.

OTA-Image erstellen

Erstellen Sie das Image mit ota_image_tool.py:

$ ./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 die Kopfzeile der Datei zu überprü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 Bild in die Google Home Developer Console hoch:

Developer Console aufrufen

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

2. Gehen Sie zu Matter > OTA.

3. Klicken Sie 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.

   Sobald das Bild validiert wurde, wird sein Dateiname unter der Schaltfläche attach_fileHochladen angezeigt.

Das OTA-Image kann kurz nach dem Upload verteilt werden.

Beschreibung für OTA-Image hinzufügen oder ändern

1. Gehen Sie zu Matter > Over-the-air.

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

3. Im Dialogfeld Details zum Over-the-air-Image können Sie die Bildbeschreibung ändern.

4. Klicken Sie auf Abbrechen oder Speichern.

OTA-Image löschen

Sie können ein OTA-Image, das den Status „Veröffentlicht“ hat, nicht löschen. Sie können nur solche im Status „Bereit“ löschen. So löschen Sie ein OTA-Image im Status „Bereit“:

1. Gehen Sie zu Matter > Over-the-air.

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