Las imágenes de la actualización de firmware OTA deben cumplir con la OTA Matter Formato de archivo de imagen de software, que incluye lo siguiente:
- Es un identificador de archivo que identifica de manera inequívoca que el archivo es un Archivo de actualización de firmware Matter
- El tamaño del archivo
- El tamaño del encabezado
- Un encabezado con codificación de longitud de etiqueta (TLV) que contiene información sobre el
actualización, que incluye lo siguiente:
- VID
- PID
- versión de software
- La carga útil
El SDK de Matter proporciona una herramienta para inspeccionar y crear
Matter de imágenes OTA
(ota_image_tool.py
).
Algunos sistemas de compilación pueden crear Matter imágenes OTA
de forma automática, así que
consulta la documentación del SoC.
Cómo crear una imagen OTA
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 OTA
Para subir la imagen a Google Home Developer Console, haz lo siguiente:
Ve a Matter > OTA.
Haz clic en Administrar junto al dispositivo en la lista Dispositivos.
En la página OTA Configuration, haz clic en la pestaña Images.
Haz clic en Imagen nueva.
Asigna un nombre a la imagen y haz clic en Adjuntar imagen para seleccionar y subir la de imagen.
Una vez que la imagen se haya validado correctamente, haz clic en Guardar.
Cuando aparezca el diálogo de confirmación, haz clic en Guardar para crear la imagen. disponible para tus dispositivos, o bien haz clic en Cancelar para cancelar el envío.
La imagen OTA está disponible para su distribución poco después de subirla.