알림 새로운 개발자 프리뷰 프로그램이 곧 출시됩니다. 여기에서 신청하여 새로운 도구를 사용해 보고 의견을 제공해 보세요.

Matter 통합 테스트

Google Home Developer ConsoleGoogle Home Test Suite를 사용하여 Matter 통합에 대해 테스트를 구성하고 실행할 수 있는 테스트 페이지를 제공합니다. Test Suite는 모든 통합 테스트를 처리하는 Developer 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과 같이 버전이 지정되지 않은 통합 인스턴스를 기반으로 합니다.

통합의 해당 사항 없음 버전은 개발 탭에서 관리되는 버전이 지정되지 않은 통합 인스턴스를 나타냅니다.

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

  • 통합 버전 해당 사항 없음에 대해 테스트를 클릭하면 새 버전이 생성됩니다. 버전 번호는 번호가 매겨진 기존 버전보다 1입니다.
    • 번호가 매겨진 버전이 없으면 버전 v.1이 생성됩니다.
    • v.1 버전이 있으면 버전 v.2가 생성됩니다. 버전 v.2가 있으면 버전 v.3도 생성됩니다.
  • 번호가 매겨진 통합 버전 (예: v.1)에서 테스트를 클릭하면 새 버전이 생성되지 않습니다. 대신 버전 v.1을 다시 테스트합니다.

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

테스트 계획 만들기

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

인증을 위한 테스트 계획을 만들기 전에 다음을 완료했는지 확인하세요.

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

통합에 대해 이 모든 단계를 완료하지 않은 경우 인증 테스트를 위해 생성된 통합 버전은 인증할 수 없습니다. 새 버전을 만들어야 합니다. 즉, 테스트, 필드 체험판, 인증 단계를 다시 실행해야 합니다.

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

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

개발자 콘솔로 이동

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

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

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

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

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

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

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

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

테스트 계획 만들기

Test Suite를 종료하려면 개발자 센터로 돌아가기를 클릭하세요.

테스트 계획 실행

Test Suite테스트 계획 만들기 페이지에서 테스트 실행을 클릭합니다. 테스트 환경 페이지가 모든 테스트의 상태 및 로그와 함께 표시됩니다.

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

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

테스트 결과

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

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

테스트 결과 보기 및 해석

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

테스트 기록

제출한 인증 계획의 경우 인증용으로 저장됨 섹션에서 결과를 클릭하여 테스트 결과 보고서를 확인합니다.

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

콘솔 상태

테스트 단계에서 다음과 같은 콘솔 상태가 발생합니다.

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

버전을 테스트하고 저장했습니다.

실패한 모든 테스트 사례에는 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 0xFFF10xFFF4이(가) 테스트용으로 예약되어 있습니다. 기본 수수료 및 제어 테스트에는 사용할 수 있지만 다음과 같은 개발 단계에서는 사용할 수 없습니다.

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

nRF Connect Android 버전의 이 스크린샷에서 VID/PID는 서비스 데이터 필드의 네 번째 바이트부터 5A23FFFE로 나열됩니다. 이는 VID 5A23 및 PID FFFE - 둘 다 리틀 엔디언 형식을 나타냅니다.

BLE 앱에서는 값이 Little Endian으로 표시되지만 Developer Console 프로젝트에 입력한 VID/PID 값은 Big Endian입니다.

블루투스 스니퍼가 표시되는 내용에 따라 작업 콘솔 프로젝트에 올바른 값과 형식이 입력되었는지 확인합니다.

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