Matter 문제 해결

건물

휴대폰이 호환되는지 확인

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

Android 디버그 브리지 설정

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

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

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개 설치됨: <ph type="x-smartling-placeholder">
    com.google.android.gms.home [v222110900]
    </ph> 위의 버전 번호는 사용 중인 기기와 다를 수 있습니다.
  4. 터미널에서 이 명령어를 실행하여 필요한 Thread 모듈이 설치되었습니다. 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    다음 예와 비슷한 출력이 표시되면 모듈 Thread개 설치됨: <ph type="x-smartling-placeholder">
    com.google.android.gms.threadnetwork [v222106301]
    </ph> 기기에 따라 버전 번호가 다를 수 있습니다.

모듈이 나열되지 않으면 다음 중 하나를 의미합니다.

  1. Android 버전이 오래되었습니다. Android O (8.1) 이상
  2. Matter 모듈이 아직 다운로드되지 않았습니다. 대기 다운로드되어야 합니다. 기기의 전원이 켜져 있고 다운로드가 지연되지 않습니다. 아직 하지 않으셨다면 받으신 경우 모듈 초기화를 시도해 보실 수 있습니다. 모듈을 다운로드하도록 할 수 있습니다.

Fuchsia 허브 기기 로그

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

  1. 기기의 일련번호와 모델이 포함된 이메일을 Google Technical Account Manager (TAM)으로 이메일을 보내세요. 기기 아래에 작은 글자로 표시됩니다.
  2. 허용 목록에 추가되면 다음 단계에 따라 기능을 사용 설정해야 합니다. <ph type="x-smartling-placeholder">
      </ph>
    • 허브에서: <ph type="x-smartling-placeholder">
        </ph>
      1. 화면 상단에서 아래로 스와이프합니다.
      2. 설정 아이콘 을 탭합니다.
      3. Fuchsia 버전 찾기: Google Nest Hub (2nd gen)에서 다음으로 이동합니다. 기기 정보 > 기술 정보 > Fuchsia 버전
      4. 'Fuchsia 버전'을 탭합니다. 7배입니다. 이렇게 하면 개발자 옵션이 사용 설정됩니다.
      5. 최상위 메뉴로 돌아가기
      6. '개발자 옵션'을 탭합니다.
      7. '파트너 로깅'을 탭합니다.
    • 이 기능은 24시간 동안 사용 설정됩니다. 그런 다음 5단계부터 로깅 기능을 다시 사용하도록 설정합니다.
  3. 허브의 IP 주소를 가져옵니다. <ph type="x-smartling-placeholder">
      </ph>
    • 허브에서 화면이 있는 경우: <ph type="x-smartling-placeholder">
        </ph>
      1. 화면 상단에서 아래로 스와이프합니다.
      2. 설정 아이콘 을 탭합니다.
      3. 기기 IP 주소 찾기: Nest Hub (2nd gen)에서 다음으로 이동합니다. 기기 정보 > 기술 정보 > IP 주소
    • 휴대전화의 Google Home app (GHA)에서 다음을 수행합니다. <ph type="x-smartling-placeholder">
        </ph>
      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 로그 수정 사용 중지

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

기기의 VID/PID를 확인하세요.

Google과의 통합 개발을 시작하려면 Google Home Console에서의 통합에 대해 알아봤습니다.

블루투스 스니퍼 문제 해결

기기에서 비커닝 중인 VID/PID 값이 VID/PID와 일치해야 합니다. Google Home Developer Console 프로젝트에 입력했습니다.

  • VID 0xFFF1 ~ 0xFFF4은(는) 테스트용으로 예약되어 있습니다. 다음 용도로 사용할 수 있습니다. 기본 커미셔닝 및 제어 테스트를 실행할 수 있지만 배포해 보겠습니다 <ph type="x-smartling-placeholder">

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

이 nRF Connect Android 버전의 스크린샷에서는 VID/PID가 5A23FFFE 서비스 데이터 필드에 입력합니다. 이는 VID가 5A23이고 PID가 FFFE임을 나타냅니다. 둘 다 리틀 엔디언 형식으로 되어 있습니다.

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

작업에 올바른 값과 형식을 입력했는지 확인 블루투스 스니퍼가 표시하는 항목을 기반으로 한 콘솔 프로젝트입니다.

예제 스크린샷에 표시된 값의 경우 Developer Console는 각각 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에 문의할 수 없습니다'라는 메시지와 함께 커미셔닝 실패 오류 메시지

올바른 VID/PID 조합으로 통합을 생성했는지 확인하세요. Developer Console에 포함 법적 사안 만들기를 참조하세요. 통합을 참조하세요.

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

'기기에 연결할 수 없습니다' 메시지가 계속 표시되는 경우 오류 메시지를 기기 Thread대를 보유하고 있으며 사용 가능한 모든 디버그를 소진했습니다. 저장된 기본 Thread를 삭제하는 것이 좋습니다. Android 휴대전화의 사용자 인증 정보를 설정 > 앱 > 앱 앱 &gt; Google Play 서비스 > 스토리지 및 캐시 > 스페이스 관리 > 모든 데이터 지우기를 선택합니다.

테스트

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

테스트 공급업체 ID (VID) 및 제품 ID (PID)로 기기를 페어링했지만 테스트로 기기를 테스트하려고 하면 나타나지 않습니다. 도구 모음이 Developer Console에서 발생한 경우 다음과 같은 이유 때문일 수 있습니다. 여러 통합에서 동일한 테스트 VID 및 PID 조합 사용

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

올바른 ID를 페어링했는지 확인하려면 Manufacturer을 설정하고 다음 대상 기기의 모델 정보 (CHIP_DEVICE_CONFIG_DEVICE_* 값) 고유한 값을 설정할 수 있습니다.

자세한 내용은 기기 정보를 참조하세요. 확인할 수 있습니다

문제가 계속 발생하는 경우

모든 문제 해결 단계를 수행한 후에도 문제가 해결되지 않는 경우 걱정하지 마세요.

문제 해결 단계에서 기기에 대한 중요한 데이터를 수집했습니다. 환경을 제공합니다 해당 데이터를 사용하여 지원 페이지를 참조하세요. Google Home 지원팀에 문의해 주세요