OTA-Image vorbereiten

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

• Eine Dateikennung, 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 Bild 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. Gehen Sie zu Matter > OTA.

2. Klicken Sie in der Liste Geräte neben dem Gerät auf Verwalten.

3. Klicken Sie auf der Seite OTA-Konfiguration auf den Tab Images.

4. Klicken Sie auf Neues Image.

1. Geben Sie dem Bild einen Namen und klicken Sie auf Bild anhängen, um die Bilddatei auszuwählen und hochzuladen.

2. Klicken Sie auf Speichern, sobald das Bild validiert wurde.

3. Klicken Sie im Bestätigungsdialogfeld auf Speichern, um das Bild für Ihre Geräte verfügbar zu machen, oder auf Abbrechen, um die Einreichung abzubrechen.

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