Prepara un'immagine OTA

Le immagini degli aggiornamenti del firmware OTA devono essere conformi all'aggiornamento OTA di Matter Formato file immagine software, che include:

  • Un identificatore di file che identifica in modo univoco il file come un File di aggiornamento firmware Matter
  • Le dimensioni del file
  • Le dimensioni dell'intestazione
  • Un'intestazione codificata con un valore di lunghezza tag (TLV) contenente informazioni sul parametro aggiornamento, tra cui:
    • VID
    • PID
    • versione software
  • Il payload

L'SDK Matter fornisce uno strumento per creare e ispezionare Matter immagini OTA (ota_image_tool.py). Alcuni sistemi di build possono creare immagini OTA Matter automaticamente, quindi controlla la documentazione del SoC.

Crea un'immagine OTA

Usa ota_image_tool.py per creare l'immagine:

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

Per verificare il set di metadati e l'intestazione del file, esegui lo script con Comando show:

$ ./ota_image_tool.py show path_to_ota_file

Output di esempio:

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

Carica l'immagine OTA

Per caricare l'immagine su Google Home Developer Console:

Vai alla Developer Console

  1. Vai a Pratica > OTA.

  2. Fai clic su Gestisci accanto al dispositivo nell'elenco Dispositivi.

  3. Nella pagina OTA Configuration (Configurazione OTA), fai clic sulla scheda Immagini.

  4. Fai clic su Nuova immagine.

Caricamento dell'immagine OTA di Matter
Finestra di dialogo

  1. Assegna un nome all'immagine e fai clic su Allega immagine per selezionare e caricare la un file immagine.

  2. Dopo aver convalidato l'immagine, fai clic su Salva.

  3. Quando viene visualizzata la finestra di dialogo di conferma, fai clic su Salva per applicare l'immagine disponibili per i tuoi dispositivi oppure fai clic su Annulla per annullare l'invio.

L'immagine OTA sarà disponibile per la distribuzione poco dopo il caricamento.