Przygotuj obraz OTA

Obrazy aktualizacji oprogramowania OTA muszą być zgodne z formatem pliku Matter OTA Software Image, który zawiera:

• Identyfikator pliku, który jednoznacznie wskazuje, że jest to plik aktualizacji oprogramowania Matter
• Rozmiar pliku
• Rozmiar nagłówka
• Nagłówek zakodowany w formacie tag-length-value (TLV) zawierający informacje o aktualizacji, w tym:
  • VID
  • Identyfikator zamówienia reklamowego
  • wersja oprogramowania
• Ładunek

Pakiet SDK Matter udostępnia narzędzie do tworzenia i sprawdzania obrazów OTA (Matter) (ota_image_tool.py). Niektóre systemy kompilacji mogą automatycznie tworzyć obrazy OTA (Matter), więc sprawdź dokumentację SoC.

Tworzenie obrazu OTA

Aby utworzyć obraz, użyj aplikacji ota_image_tool.py:

$ ./ota_image_tool.py create \
  -v hexVendorId \
  -p hexProductId \
  -vn versionNumber \
  -vs "versionString" \
  -da "hash-function \
  path_to_binary \
  path_to_ota_file

Aby zweryfikować zestaw metadanych i nagłówek pliku, uruchom skrypt za pomocą polecenia show:

$ ./ota_image_tool.py show path_to_ota_file

Przykładowe dane wyjściowe:

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

Przesyłanie obrazu OTA

Aby przesłać obraz do Google Home Developer Console:

Otwórz konsolę programistów

1. Otwórz projekt, a potem urządzenie.

2. Kliknij Matter > OTA.

3. Obok urządzenia na liście Integracje kliknij Zarządzaj OTA.

4. Na karcie Zarządzaj kliknij addDodaj obraz OTA.

1. Kliknij attach_filePrześlij, aby wybrać i przesłać plik obrazu.

   Po sprawdzeniu obrazu jego nazwa pojawi się pod przyciskiem attach_filePrześlij.

Obraz OTA jest dostępny do dystrybucji wkrótce po przesłaniu.

Dodawanie i modyfikowanie opisu obrazu OTA

1. Kliknij Matter > OTA.

2. Na karcie Zarządzaj kliknij Otwórz obok obrazu, który chcesz zmodyfikować.

3. W oknie Szczegóły obrazu OTA możesz zmienić opis obrazu.

4. Kliknij Anuluj lub Zapisz.

Usuwanie obrazu OTA

Nie możesz usunąć obrazu OTA, który jest w stanie Opublikowano. Możesz usunąć tylko obrazy w stanie Gotowe. Aby usunąć obraz OTA w stanie Gotowy:

1. Kliknij Matter > OTA.

2. Na karcie Zarządzaj kliknij menu more_vert „Więcej” obok obrazu OTA i wybierz Usuń.