Las imágenes de actualización del firmware inalámbrico deben cumplir con el formato de archivo de imagen de software inalámbrico Matter, que incluye lo siguiente:
- Identificador de archivo que identifica de manera única el archivo como una actualización de firmware Matter
- El tamaño del archivo
- El tamaño del encabezado
- Un encabezado codificado por longitud de etiqueta (TLV) que contiene información sobre la actualización, incluido lo siguiente:
- 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 tu documentación de 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 Google Home Developer Console, haz lo siguiente:
Ir a la Consola para desarrolladores
Ve a Matter > OTA.
Haz clic en Administrar junto al dispositivo en la lista de 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 diálogo de confirmación, haz clic en Guardar para que la imagen esté disponible para tus dispositivos o en Cancelar a fin de cancelar el envío.
La imagen inalámbrica está disponible para su distribución poco después de la carga.