Matter 통합 테스트

Google Home Developer ConsoleGoogle Home Test Suite를 사용하여 Matter 통합에 관한 테스트를 구성하고 실행할 수 있는 테스트 페이지를 제공합니다. Test SuiteDeveloper Console에 내장된 별도의 애플리케이션으로, 모든 통합 테스트를 처리합니다.

통합의 공급업체 ID 및 제품 ID 기기는 테스트를 위해 커미셔닝되어 Developer Console와 함께 사용되는 계정의 Google Home app (GHA)에서 제공되어야 합니다. 자세한 내용은 Matter 기기 페어링을 참고하세요.

Test Suite는 특정 Matter 프로젝트 구성에 속한 기기 세트에서 실행할 수 있습니다. 통합에서 Test Suite를 실행하여 모든 것이 제대로 작동하는지 확인하는 것이 매우 중요합니다.

테스트 페이지에서 완료되어 테스트할 준비가 된 Matter 통합이 테스트 준비 완료에 표시됩니다.

테스트된 Matter 통합은 테스트됨 섹션에 나열됩니다.

테스트 계획 유형

테스트 계획에는 두 가지 유형이 있습니다.

  • 개발 테스트 계획은 Matter를 사용하여 기기 제어를 테스트하는 데 사용됩니다. 수정은 가능하지만 Matter 인증을 위해 제출할 수는 없습니다.

  • 인증 테스트 계획은 Matter 인증 전용이며 수정할 수 없습니다. 이 옵션을 선택하면 새 버전의 Matter 통합이 생성됩니다.

통합 버전

인증을 위한 테스트 계획을 만들면 새 버전의 통합이 생성됩니다. 번호가 매겨진 이 버전은 테스트 탭부터 Developer Console에 있는 모든 통합 목록에 나열됩니다.

새 버전은 번호가 매겨진 다른 버전에서 생성되지 않습니다. 예를 들어 통합을 위해 만든 첫 번째 테스트 계획은 해당 통합의 버전 v.1을 만듭니다. 다른 테스트 계획을 만들면 해당 통합용 버전 v.2가 생성되지만 이 버전은 v.1을 기반으로 하지 않습니다. 대신 이 버전은 v.1과 마찬가지로 버전이 지정되지 않은 통합 인스턴스를 기반으로 합니다.

통합의 N/A 버전은 개발 탭에서 관리되는 버전이 지정되지 않은 통합 인스턴스를 나타냅니다.

즉, Developer ConsoleMatter > 테스트에서 다음을 실행합니다.

  • 통합 N/A 버전에 대해 테스트를 클릭하면 새 버전이 생성됩니다. 버전 번호는 기존의 번호가 매겨진 버전보다 하나 높습니다.
    • 번호가 매겨진 버전이 없으면 버전 v.1이 생성됩니다.
    • 버전 v.1이 있으면 버전 v.2가 생성됩니다. 버전 v.2가 있으면 버전 v.3이 생성됩니다.
  • 통합의 번호가 매겨진 버전 (예: v.1)에 대해 테스트를 클릭하면 새 버전이 생성되지 v.1. 대신 버전 v.1이 다시 테스트됩니다.

자세한 내용은 통합 버전 관리를 참조하세요.

테스트 계획 만들기

통합 버전은 버전이 지정되지 않은 통합의 스냅샷입니다. 즉, 인증용 테스트 계획과 통합 버전을 만들 때 해당 통합과 관련된 모든 메타데이터가 출시된 통합에 사용하려는 정보여야 합니다.

인증을 위한 테스트 계획을 만들기 전에 다음을 완료해야 합니다.

  1. 회사 프로필 생성
  2. 통합의 프로덕션 공급업체 ID(VID)를 입력합니다.
  3. 설정 및 브랜딩을 구성했습니다.

통합에서 이러한 작업을 모두 완료하지 않으면 인증 테스트용으로 만든 통합 버전을 인증할 수 없습니다. 새 버전을 만들어야 합니다. 즉, Test, Field Trial, Certify 단계를 다시 실행해야 합니다.

또한 통합 버전이 인증되기 전에 브랜딩을 업데이트하려면 새 버전을 만들고 다시 시작해야 합니다.

테스트 계획을 만드는 방법은 다음과 같습니다.

Play Console로 이동

  1. 프로젝트 목록에서 작업할 프로젝트 옆에 있는 열기를 클릭합니다.

  2. 페이지 왼쪽의 탐색 메뉴에서 Matter > Test로 이동합니다.

  3. 테스트하려는 통합의 버전 해당 사항 없음에 대해 테스트를 클릭합니다. 이 작업으로 새 통합 버전이 생성됩니다.

  4. 개발 테스트 또는 인증 테스트의 테스트 유형을 선택합니다. 새 테스트 계획 만들기

    • Google 생태계에서 인증을 준비하려면 인증 테스트를 선택합니다.
    • 개발 테스트는 인증에 사용할 수 없습니다.
  5. Test를 클릭합니다. No device found 오류 화면이 표시되면 이 통합을 위한 기기가 아직 생태계에 커미셔닝되지 않은 것입니다. 자세한 내용은 페어링 문제 해결을 참고하세요.

  6. 테스트 구성 화면에서 테스트 이름을 입력하고 기기 목록에서 테스트할 기기를 선택합니다.

  7. 다음: 테스트 계획 버튼을 클릭합니다.

  8. 테스트 계획 만들기 페이지의 테스트 모음 섹션에서 실행할 테스트 모음을 선택합니다.

테스트 계획 만들기

Test Suite를 종료하려면 Developer Center로 돌아가기를 클릭하세요.

테스트 계획 실행

Test Suite테스트 계획 만들기 페이지에서 테스트 실행을 클릭합니다. 모든 테스트의 상태 및 로그가 포함된 테스트 환경 페이지가 나타납니다.

테스트가 완료되면 테스트 결과가 표시됩니다. 각 테스트 모음 실행의 상태 (통과, 실패)가 옆에 표시됩니다.

로그 창에는 개별 테스트 실행의 상태가 표시됩니다.

테스트 결과

테스트 환경 페이지에서 테스트 계획을 다시 테스트하려면 테스트 실행이 완료된 후 상단에 있는 다시 테스트를 클릭합니다.

완료되면 다음 단계를 따르세요.

테스트 결과 보기 및 해석

Test Suite테스트 기록 페이지에 있는 테스트 계획 섹션에서 원하는 테스트 계획에 대해 다시 테스트를 클릭하여 개발 계획 또는 제출되지 않은 인증 테스트 계획의 이전 테스트 결과를 볼 수 있습니다. 그러면 테스트 결과를 표시하는 테스트 환경 페이지로 이동합니다.

테스트 기록

제출된 인증 계획의 인증을 위해 저장됨 섹션에서 결과를 클릭하여 테스트 결과 보고서를 봅니다.

Developer ConsoleTest 탭에서 통합 버전의 테스트 결과에 액세스할 수도 있습니다. 페이지에 나열된 통합 버전의 테스트 기록에서 View를 클릭하여 Test Suite테스트 기록 페이지로 이동합니다.

콘솔 상태

테스트 단계에서 다음과 같은 콘솔 상태가 표시됩니다.

Section 상태 설명 요건 다음 단계
테스트 준비 완료 준비됨 이 integration 버전을 테스트할 준비가 되었습니다. N/A 이 버전의 integration를 테스트합니다.
테스트 완료 준비됨 이 integration 버전은 테스트되었으며 필드 체험판 또는 인증을 위해 제출할 수 있습니다.

버전이 테스트 및 저장되었습니다.

실패한 모든 테스트 사례에는 Google에서 검토해야 하는 근거가 포함됩니다.

원하는 경우 다시 테스트합니다.

문제 해결

커미셔닝된 기기가 테스트 모음에 표시되지 않습니다.

기기를 테스트 공급업체 ID (VID) 및 제품 ID (PID)와 페어링했지만 Developer Console에서 테스트 모음으로 기기를 테스트하려고 할 때 표시되지 않는 경우 여러 통합에서 동일한 테스트 VID와 PID 조합을 사용했기 때문일 수 있습니다.

문제를 해결하려면 Developer Console에서 모든 테스트 기기를 삭제하고 다시 테스트하려는 기기를 페어링합니다.

올바른 페어링을 완료했는지 확인하려면 기기의 제조업체 및 모델 정보 (CHIP_DEVICE_CONFIG_DEVICE_* 값)를 테스트 펌웨어의 고유한 값으로 설정하면 됩니다.

자세한 내용은 기기 정보를 참고하세요.

기기의 VID/PID 확인

Google과의 통합 개발을 시작하려면 Google Home 콘솔에서 프로젝트와 통합을 만들어야 합니다.

블루투스 스니퍼 문제 해결

기기에서 비커닝하는 VID/PID 값은 Developer Console 프로젝트에 입력된 VID/PID와 일치해야 합니다.

  • VID 0xFFF1: 0xFFF4은(는) 테스트용으로 예약되어 있습니다. 기본 커미셔닝 및 제어 테스트에 사용할 수 있지만 다음 개발 단계에서는 사용할 수 없습니다.

모바일용 nRF Connect와 같은 블루투스 엔지니어링 앱을 사용하면 서비스 데이터 필드에서 비콘 기기의 VID/PID를 확인할 수 있습니다.

nRF Connect의 Android 버전에 관한 이 스크린샷에서는 VID/PID가 서비스 데이터 필드의 네 번째 바이트에서 시작하여 5A23FFFE로 나열되어 있는 것을 확인할 수 있습니다. 5A23의 VID와 FFFE의 PID를 모두 little endian 형식으로 나타냅니다.

BLE 앱은 값을 Little Endian으로 표시하지만 Developer Console 프로젝트에 입력한 VID/PID 값은 big endian입니다.

블루투스 스니퍼에 표시되는 내용에 따라 적절한 값과 형식이 Actions 콘솔 프로젝트에 입력되었는지 확인합니다.

예시 스크린샷의 값의 경우 Developer Console의 VID와 PID는 각각 235AFEFF입니다.