Préparer une image OTA

Les images de mise à jour du micrologiciel OTA doivent être conformes au format de fichier image du logiciel OTA Matter, qui inclut les éléments suivants:

• Identifiant de fichier qui identifie de manière unique le fichier en tant que fichier de mise à jour du micrologiciel Matter
• Taille du fichier
• Taille de l'en-tête
• En-tête encodé en tag-length-value (TLV) contenant des informations sur la mise à jour, y compris les éléments suivants :
  • VID
  • ID d'achat
  • version logicielle
• La charge utile

Le SDK Matter fournit un outil permettant de créer et d'inspecter des images OTA Matter (ota_image_tool.py). Certains systèmes de compilation peuvent créer automatiquement des images OTA Matter. Consultez donc la documentation de votre SoC.

Créer une image OTA

Créez l'image à l'aide de 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

Pour vérifier l'ensemble de métadonnées et l'en-tête du fichier, exécutez le script avec la commande show :

$ ./ota_image_tool.py show path_to_ota_file

Exemple de résultat :

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

Importer l'image OTA

Pour importer l'image dans Google Home Developer Console :

Accéder à la console de développement

1. Accédez à Matter > OTA (Matter > Mise à jour OTA).

2. Cliquez sur Gérer à côté de l'appareil dans la liste Appareils.

3. Sur la page Configuration OTA, cliquez sur l'onglet Images.

4. Cliquez sur Nouvelle image.

1. Attribuez un nom à l'image, puis cliquez sur Joindre une image pour sélectionner et importer le fichier image.

2. Une fois l'image validée, cliquez sur Enregistrer.

3. Lorsque la boîte de dialogue de confirmation s'affiche, cliquez sur Save (Enregistrer) pour rendre l'image disponible sur vos appareils ou sur Cancel (Annuler) pour annuler l'envoi.

L'image OTA peut être distribuée peu de temps après sa mise en ligne.