As imagens de atualização do firmware OTA precisam estar em conformidade com o formato de arquivo Matter OTA de imagem do software, que inclui:
- Um identificador de arquivo que o identifica exclusivamente como um arquivo de atualização de firmware do Matter.
- O tamanho do arquivo
- O tamanho do cabeçalho
- Um cabeçalho codificado por valor de tag (TLV) contendo informações sobre a atualização, incluindo:
- VID
- PID
- versão do software
- A carga útil
O SDK do Matter fornece uma ferramenta para criar e inspecionar imagens OTA Matter (ota_image_tool.py
). Alguns sistemas de compilação podem criar imagens OTA Matter 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 o 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 no Google Home Developer Console:
Acesse Caso > OTA.
Clique em Gerenciar ao lado do dispositivo na lista Dispositivos.
Na página OTA Configuration, clique na guia Images.
Clique em Nova imagem.
Atribua um nome à imagem e clique em Anexar imagem para selecionar e fazer o upload do arquivo de imagem.
Depois que a imagem for validada, clique em Salvar.
Quando a caixa de diálogo de confirmação aparecer, clique em Salvar para disponibilizar a imagem aos dispositivos ou clique em Cancelar para cancelar o envio.
A imagem OTA está disponível para distribuição logo após o upload.