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 inclut les éléments suivants:

• Un identifiant de fichier qui identifie de manière unique le fichier comme étant un fichier de mise à jour du micrologiciel Matter
• Taille du fichier
• Taille de l'en-tête
• Un en-tête encodé au format TLV (Tag-length-value-value) contenant des informations sur la mise à jour, y compris :
  • ID vidéo
  • ID d'achat
  • version logicielle
• La charge utile

Le SDK Matter fournit un outil permettant de créer et d'inspecter des images OTA de Matter (ota_image_tool.py). Certains systèmes de compilation peuvent créer automatiquement des images OTA de Matter. Nous vous invitons donc à consulter la documentation sur vos SoC.

Créer une image d'OTA

Utilisez ota_image_tool.py pour créer l'image:

$ ./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 développeur

1. Accédez à Matter > 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 Save (Enregistrer).

3. Lorsque la boîte de dialogue de confirmation s'affiche, cliquez sur Enregistrer pour que l'image soit disponible pour vos appareils, ou sur Annuler pour annuler l'envoi.

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