OTA-Image vorbereiten

Images für OTA-Firmwareupdates müssen dem Dateiformat Matter OTA-Software Image entsprechen:

  • Eine Datei-ID, mit der die Datei eindeutig als Matter-Firmwareupdatedatei identifiziert wird
  • Die Größe der Datei
  • Die Größe der Kopfzeile
  • Ein Tag-Längenwert (TLV)-codierter Header, der Informationen über die Aktualisierung enthält, darunter:
    • VID
    • PID
    • Softwareversion
  • Die Nutzlast

Das Matter SDK bietet ein Tool, mit dem Matter OTA-Images (ota_image_tool.py) erstellt und geprüft werden können. Einige Build-Systeme können Matter-OTA-Images automatisch erstellen. Sehen Sie sich daher Ihre SoC-Dokumentation an.

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 Skript 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 Bild in Google Home Developer Console hoch:

Zur Entwicklerkonsole

  1. Klicken Sie auf 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 Bild.

Dialogfeld für den Matter-OTA-Upload von Bildern

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

  2. Klicken Sie nach der Überprüfung des Bildes auf Speichern.

  3. Klicken Sie im Dialogfeld zur Bestätigung auf Speichern, um das Image für Ihre Geräte verfügbar zu machen, oder auf Abbrechen, wenn Sie das Senden abbrechen möchten.

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