Prepara una imagen OTA

Las imágenes de actualización de firmware OTA deben cumplir con el formato de archivo de imagen de software OTA Matter, que incluye lo siguiente:

  • Es un identificador de archivo que identifica de forma exclusiva el archivo como 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 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 OTA de Matter (ota_image_tool.py). Algunos sistemas de compilación pueden crear imágenes OTA de Matter automáticamente, por lo que debes consultar la documentación de tu SoC.

Crea 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 Play Console

  1. Ve a Matter > OTA.

  2. Haz clic en Administrar junto al dispositivo en la lista Dispositivos.

  3. En la página Configuración OTA, haz clic en la pestaña Imágenes.

  4. Haz clic en Imagen nueva.

Diálogo de carga de imágenes OTA de Matter

  1. Asigna un nombre a la imagen y haz clic en Adjuntar imagen para seleccionar y subir el archivo de imagen.

  2. Una vez que la imagen se haya validado correctamente, haz clic en Guardar.

  3. Cuando aparezca el diálogo de confirmación, haz clic en Guardar para que la imagen esté disponible para tus dispositivos, o haz clic en Cancelar para cancelar el envío.

La imagen inalámbrica estará disponible para su distribución poco después de la carga.