Preparar uma imagem OTA

As imagens de atualização de firmware OTA precisam estar em conformidade com o OTA Matter Formato de arquivo de imagem do software, que inclui:

  • Um identificador de arquivo que identifica exclusivamente o arquivo como um Arquivo de atualização de firmware do Matter
  • O tamanho do arquivo
  • O tamanho do cabeçalho
  • Um cabeçalho codificado em valor de comprimento de tag (TLV) contendo informações sobre o incluindo:
    • VID
    • PID
    • versão do software
  • O payload

O SDK do Matter fornece uma ferramenta para criar e inspecionar Matter imagens OTA (ota_image_tool.py). Alguns sistemas de build podem criar Matter imagens OTA automaticamente. Portanto, verifique a documentação do SoC.

Criar uma imagem OTA

Use ota_image_tool.py para criar a imagem:

$ ./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 o conjunto de metadados e o cabeçalho do arquivo, execute o script com a Comando show:

$ ./ota_image_tool.py show path_to_ota_file

Exemplo de saída:

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

Fazer upload da imagem OTA

Para fazer upload da imagem para Google Home Developer Console:

Acessar o Play Console

  1. Acesse Caso > OTA.

  2. Clique em Gerenciar ao lado do dispositivo na lista Dispositivos.

  3. Na página Configuração do OTA, clique na guia Imagens.

  4. Clique em Nova imagem.

Upload de imagem OTA do Matter
caixa de diálogo

  1. Dê um nome à imagem e clique em Anexar imagem para selecionar e fazer upload do arquivo de imagem.

  2. Depois que a imagem for validada, clique em Salvar.

  3. Quando a caixa de diálogo de confirmação aparecer, clique em Salvar para criar a imagem. disponível para seus dispositivos ou clique em Cancelar para cancelar o envio.

A imagem OTA fica disponível para distribuição logo após o upload.