Matter 문제 해결

건물

휴대전화 호환성 확인하기

모든 Android O (8.1, API 수준 27) 및 이후 기기는 Matter와 호환됩니다. 아래 단계에 따라 휴대전화에 필요한 모듈이 있는지 확인합니다.

Android 디버그 브리지 설정

문제 해결을 시작하기 전에 Android 디버그 브리지 (adb)를 설정해야 합니다. 설정하려면 다음 단계를 따르세요.

  1. 컴퓨터에 'adb'를 설치합니다.
  2. Android 휴대전화에서 개발자 옵션과 USB 디버깅을 사용 설정합니다.

Google Play 서비스 (GPS) Matter 모듈 확인

Google Play services Matter 모듈이 있는지 확인하려면 다음 단계를 따르세요.

  1. Android 디버그 브리지를 설정합니다.
  2. USB 케이블을 사용하여 Android 휴대전화를 컴퓨터에 연결합니다.
  3. 터미널에서 다음 명령어를 실행하여 필요한 Matter 모듈이 설치되어 있는지 확인합니다. 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    아래와 유사한 출력이 표시되면 Matter 모듈이 설치된 것입니다. 
    com.google.android.gms.home [v222110900]
     위의 버전 번호는 기기와 다를 수 있습니다.
  4. 터미널에서 다음 명령어를 실행하여 필요한 Thread 모듈이 설치되어 있는지 확인합니다. 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    다음 예와 유사한 출력이 표시되면 Thread 모듈이 설치된 것입니다. 
    com.google.android.gms.threadnetwork [v222106301]
     기기의 버전 번호는 다를 수 있습니다.

모듈이 표시되지 않으면 다음 중 하나에 해당합니다.

  1. 오래된 Android 버전을 사용하고 있습니다. Android O (8.1) 이상인지 확인합니다.
  2. Matter 모듈이 아직 다운로드되지 않았습니다. 다운로드가 완료될 때까지 최소 24시간 동안 기다립니다. 이때 기기의 전원이 켜져 있고 충전 중인지 확인하여 다운로드가 지연되지 않도록 하세요. 24시간 이내에 모듈을 받지 못한 경우 기기를 초기화하여 모듈을 강제로 다운로드해 볼 수 있습니다.

Fuchsia 허브 기기 로그

로컬 로그 검색을 위한 허브를 사용 설정하려면 다음 단계를 따르세요.

  1. 기기의 일련번호와 모델을 포함하여 Google Technical Account Manager (TAM)에 이메일을 보냅니다. 기기 아래에 작은 글자로 표시됩니다.
  2. 허용 목록에 추가되면 다음 단계에 따라 기능을 사용 설정해야 합니다.
    • 허브에서 다음 단계를 따르세요.
      1. 화면 상단에서 아래로 스와이프합니다.
      2. 설정 아이콘 을 탭합니다.
      3. Fuchsia 버전 찾기: Google Nest Hub (2nd gen)에서 기기 정보 > 기술 정보 > Fuchsia 버전으로 이동합니다.
      4. 'Fuchsia 버전'을 7번 탭합니다. 이렇게 하면 개발자 옵션이 사용 설정됩니다.
      5. 최상위 메뉴로 돌아가기
      6. '개발자 옵션'을 탭합니다.
      7. '파트너 로깅'을 탭합니다.
    • 이 기능은 24시간 동안 사용 설정됩니다. 그런 다음 5단계부터 로깅 기능을 다시 사용 설정합니다.
  3. 허브의 IP 주소를 가져옵니다.
    • 화면이 있는 허브의 경우 다음 단계를 따르세요.
      1. 화면 상단에서 아래로 스와이프합니다.
      2. 설정 아이콘 을 탭합니다.
      3. 기기 IP 주소 찾기: Nest Hub (2nd gen)에서 기기 정보 > 기술 정보 > IP 주소로 이동합니다.
    • 휴대전화의 Google Home app (GHA)에서 다음 단계를 따르세요.
      1. 기기를 탭하여 기기 세부정보 페이지를 엽니다.
      2. 설정 아이콘 을 탭하여 설정 페이지를 엽니다.
      3. 기기 IP 주소 찾기: 기기 정보 > 기술 정보 > IP 주소로 이동합니다.
  4. 허브에서 로그를 가져오려면 동일한 Wi-Fi 네트워크에 있는 컴퓨터에서 허브에 GET HTTP 요청을 보냅니다.
    • 엔드포인트의 포트와 경로를 확인합니다. 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • 연결은 1분 동안만 열려 있을 수 있지만 버퍼에서 가져온 데이터에는 일반적으로 20~30분 전의 과거 이벤트가 포함됩니다.
      • 테스트 절차가 완료된 직후에 이 메서드를 사용하여 로그를 추출하면 버퍼에 테스트와 관련된 콘텐츠가 포함될 수 있습니다 (Android 버그 신고와 유사).

Android 로그 수정 사용 중지

  • 개인 정보 보호 및 보안을 위해 이 기능은 엔지니어링 테스트 목적으로만 사용해야 합니다.
  • 프로덕션 기기 또는 사용자에게는 이 옵션을 사용하지 마세요.
  • 단계:
    1. 수정되지 않은 로그가 포함된 사용자의 Google 계정을 Google TAM로 전송합니다.
    2. 계정이 허용 목록에 추가되었음을 확인한 후 휴대전화를 재부팅합니다.

기기의 VID/PID 확인

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

블루투스 스니퍼 문제 해결

기기가 비콘으로 전송하는 VID/PID 값은 Google Home Developer Console 프로젝트에 입력된 VID/PID와 일치해야 합니다.

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

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

nRF Connect Android 버전의 스크린샷에서 VID/PID가 서비스 데이터 필드의 네 번째 바이트부터 5A23FFFE로 표시됩니다. 이는 VID가 5A23이고 PID가 FFFE임을 나타내며 둘 다 little-endian 형식입니다.

BLE 앱은 값을 리틀 엔디언으로 표시하지만 Developer Console 프로젝트에 입력하는 VID/PID 값은 빅 엔디언입니다.

블루투스 스니퍼에 표시되는 내용을 바탕으로 Actions Console 프로젝트에 올바른 값과 형식이 입력되었는지 확인합니다.

스크린샷 예시의 값을 기준으로 Developer Console의 VID와 PID는 각각 235A 및 FEFF입니다.

호환되는 Matter SDK 브랜치를 사용하여 기기가 빌드되었는지 확인

Google Matter 허브는 Matter 1.0과 호환되며 안정화 브랜치 v1.0-branch의 커밋을 사용한 빌드로 테스트되었습니다. 각 새 허브 출시와 함께 사용하도록 권장되는 특정 커밋은 공개 출시 메모를 확인하세요.

페어링

기기 사용자 인증 정보 확인

자체 Alliance 할당 VID를 사용하는 경우 기기에 올바른 사용자 인증 정보가 있는지 확인합니다.

  • 인증 선언 (CD)
  • 기기 증명 인증서 (DAC) 및 인증서 체인

자세한 내용은 Matter 기기 테스트 인증서 만들기를 참고하세요.

Matter 호환 허브 확인하기

Matter 허브는 Google에서 지원하는 허브 중 하나여야 합니다. 또한 Matter와 호환되는 빌드에 있어야 합니다.

일부 허브는 스레드 보더 라우터이기도 하므로 스레드 기기를 개발하고 테스트할 수 있습니다. 네트워크에 스레드 연결을 사용 설정할 수 있는 다른 보더 라우터가 없는 한 다른 허브는 Wi-Fi 및 이더넷 Matter 기기만 지원합니다.

상단 가장자리에서 아래로 스와이프 > 구성 휠 > 기기 정보 > 기술 정보 > Chromecast 펌웨어 버전을 통해 허브 빌드를 확인할 수 있습니다.

'Google에 연결할 수 없습니다' 오류 메시지와 함께 커미셔닝이 실패함

Developer Console에서 올바른 VID/PID 조합으로 통합을 만들었는지 확인합니다. 자세한 내용은 Matter 통합 만들기를 참고하세요.

'기기에 연결할 수 없음' 오류 메시지와 함께 커미셔닝이 실패함

Thread 기기를 커미셔닝할 때 '기기에 연결할 수 없음' 오류 메시지가 계속 표시되고 사용 가능한 모든 디버그 옵션을 사용해 본 경우, Android 휴대전화에 저장된 기본 Thread 사용자 인증 정보를 삭제하여 깨끗하게 설정할 수 있습니다. 이렇게 하려면 설정 > 앱 > 앱 앱 > Google Play 서비스 > 저장용량 및 캐시 > 공간 관리 > 모든 데이터 지우기를 통해 삭제합니다.

테스트

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

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

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

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

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

문제가 계속 발생하는 경우

여기의 문제 해결 단계를 모두 수행한 후에도 문제가 해결되지 않으면 걱정하지 마세요.

문제 해결 단계에서 기기, Console 프로젝트, 환경에 관한 중요한 데이터를 수집했습니다. 이 데이터를 바탕으로 지원 페이지에서 커뮤니티 및 Google Home 지원팀에 문제를 가장 효과적으로 공유하는 방법을 확인하세요.