Prepara un'immagine OTA

Le immagini di aggiornamento del firmware OTA devono essere conformi al formato file immagine software OTA Matter, che include:

  • Un identificatore di file che identifica in modo univoco il file come file di aggiornamento firmware Matter
  • Le dimensioni del file
  • Le dimensioni dell'intestazione
  • Un'intestazione codificata con lunghezza-valore-tag (TLV) contenente informazioni sull'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 automaticamente immagini OTA Matter, quindi consulta la documentazione del SoC.

Crea un'immagine OTA

Utilizza 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 il 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 a Google Developers Console

  1. Apri il progetto, quindi apri il dispositivo.

  2. Vai a Matter > OTA.

  3. Fai clic su Gestisci OTA accanto al dispositivo nell'elenco Integrazioni.

  4. Nella scheda Gestisci, fai clic su Aggiungi immagine OTA.

La finestra di dialogo per il caricamento dell'immagine OTA di Matter

  1. Fai clic su Carica per selezionare e caricare il file immagine.

    Una volta convalidata correttamente l'immagine, il nome del file viene visualizzato sotto il pulsante Carica.

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

Aggiungere o modificare la descrizione di un'immagine OTA

  1. Vai a Matter > OTA.

  2. Nella scheda Gestisci, fai clic su Apri accanto all'immagine da modificare.

  3. Nella finestra di dialogo Dettagli immagine OTA, puoi modificare la descrizione dell'immagine.

  4. Fai clic su Annulla o Salva.

Elimina un'immagine OTA

Non puoi eliminare un'immagine OTA nello stato Rilasciata, ma solo quelle nello stato Pronta. Per eliminare un'immagine OTA nello stato Pronto:

  1. Vai a Matter > OTA.

  2. Nella scheda Gestisci, fai clic sul menu "Altro" accanto all'immagine OTA e seleziona Elimina.