OTA 이미지 준비

OTA 펌웨어 업데이트 이미지는 다음을 포함하는 Matter OTA 소프트웨어 이미지 파일 형식을 준수해야 합니다.

  • 파일이 Matter 펌웨어 업데이트 파일임을 고유하게 식별하는 파일 식별자
  • 파일 크기
  • 헤더 크기
  • 다음과 같은 업데이트에 관한 정보가 포함된 태그-길이-값 (TLV)으로 인코딩된 헤더:
    • VID
    • PID
    • 소프트웨어 버전
  • 페이로드

Matter SDK는 Matter OTA 이미지를 만들고 검사하는 도구 (ota_image_tool.py)를 제공합니다. 일부 빌드 시스템은 Matter OTA 이미지를 자동으로 만들 수 있으므로 SoC 문서를 확인하세요.

OTA 이미지 만들기

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

설정된 메타데이터와 파일의 헤더를 확인하려면 show 명령어와 함께 스크립트를 실행합니다.

$ ./ota_image_tool.py show path_to_ota_file

출력 예시:

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

OTA 이미지 업로드

Google Home Developer Console에 이미지를 업로드하려면 다음 단계를 따르세요.

Developer Console로 이동

  1. 프로젝트를 연 다음 기기를 엽니다.

  2. Matter > OTA 로 이동합니다.

  3. 통합 목록에서 기기 옆에 있는 OTA 관리 를 클릭합니다.

  4. 관리 탭에서 OTA 이미지 추가 를 클릭합니다.

Matter OTA 이미지 업로드 대화상자

  1. 업로드를 클릭하여 이미지 파일을 선택하고 업로드합니다.

    이미지가 성공적으로 검증되면 파일 이름이 업로드 버튼 아래에 표시됩니다.

OTA 이미지는 업로드 후 곧바로 배포할 수 있습니다.

OTA 이미지 설명 추가 또는 수정

  1. Matter > OTA 로 이동합니다.

  2. 관리 탭에서 수정할 이미지 옆에 있는 열기 를 클릭합니다.

  3. OTA 이미지 세부정보 대화상자에서 이미지 설명을 변경할 수 있습니다.

  4. 취소 또는 저장 을 클릭합니다.

OTA 이미지 삭제

'출시됨' 상태의 OTA 이미지는 삭제할 수 없으며 '준비됨' 상태의 이미지만 삭제할 수 있습니다. '준비됨' 상태의 OTA 이미지를 삭제하려면 다음 단계를 따르세요.

  1. Matter > OTA 로 이동합니다.

  2. 관리 탭에서 '더보기' 메뉴를 클릭하고 OTA 이미지 옆에 있는 삭제 를 선택합니다.