Préparer une image OTA

Les images de mise à jour du micrologiciel OTA doivent être conformes au format de fichier d'image logicielle OTA Matter, qui comprend 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. Ouvrez votre projet, puis votre appareil.

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

3. Cliquez sur Gérer les mises à jour OTA à côté de l'appareil dans la liste Intégrations.

4. Dans l'onglet Gérer, cliquez sur addAjouter une image OTA.

1. Cliquez sur attach_fileImporter pour sélectionner et importer le fichier image.

   Une fois l'image validée, son nom de fichier s'affiche sous le bouton attach_fileImporter.

L'image OTA peut être distribuée peu de temps après l'importation.

Ajouter ou modifier la description d'une image OTA

1. Accédez à Matter > Mise à jour.

2. Dans l'onglet Gérer, cliquez sur Ouvrir à côté de l'image que vous souhaitez modifier.

3. Dans la boîte de dialogue Détails de l'image OTA, vous pouvez modifier la description de l'image.

4. Cliquez sur Annuler ou sur Enregistrer.

Supprimer une image OTA

Vous ne pouvez pas supprimer une image OTA à l'état "Publiée". Vous ne pouvez supprimer que celles à l'état "Prête". Pour supprimer une image OTA en état "Prêt" :

1. Accédez à Matter > Mise à jour.

2. Dans l'onglet Gérer, cliquez sur le menu more_vert "Plus" à côté de l'image OTA, puis sélectionnez Supprimer.