Las imágenes de actualización del firmware inalámbrico deben cumplir con los Matter OTA Software Image file format, which includes:
- un identificador de archivo que identifica de forma exclusiva que el archivo es un archivo de actualización de firmware Matter
- el tamaño del archivo
- el tamaño del encabezado
- Un encabezado codificado en longitud de etiqueta (TLV) que contenga información sobre la actualización, incluido lo siguiente:
- VID (VID)
- PID
- versión de software
- la carga útil
El SDK de Matter proporciona una herramienta para crear e inspeccionar imágenes inalámbricas Matter (ota_image_tool.py
). Algunos sistemas de compilación pueden crear imágenes inalámbricas Matter de forma automática, por lo que debes verificar la documentación del SoC.
Crea una imagen inalámbrica
Usa ota_image_tool.py
para crear la imagen:
$ ./ota_image_tool.py create \
-v hexVendorId \
-p hexProductId \
-vn versionNumber \
-vs "versionString" \
-da "hash-function \
path_to_binary \
path_to_ota_file
Para verificar el conjunto de metadatos y el encabezado del archivo, ejecuta la secuencia de comandos con el comando show
:
$ ./ota_image_tool.py show path_to_ota_file
Resultado de ejemplo:
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
Sube la imagen inalámbrica
Para subir la imagen a la Google Home Developer Console :
Ve a Matter > OTA.
Haz clic en Administrar junto al dispositivo en la lista Dispositivos.
En la página Configuración inalámbrica, haz clic en la pestaña Imágenes.
Haz clic en Imagen nueva.
Asigna un nombre a la imagen y haz clic en Adjuntar imagen para seleccionar y subir el archivo de imagen.
Una vez que la imagen se valide correctamente, haga clic en Guardar.
Cuando aparezca el cuadro de diálogo de confirmación, haz clic en Guardar a fin de que la imagen esté disponible para tus dispositivos o en Cancelar a fin de cancelar la entrega.
La imagen inalámbrica está disponible para distribución poco después de la carga.