Google의 Home 개발자 프로그램은 기기 제조업체가 스마트 홈 기기를 Google Home 생태계에 연결할 수 있도록 지원합니다. Google Home app (GHA)를 사용하여 설정을 위해 Matter 지원 기기를 추가하고 Google Assistant, GHA 또는 Google Nest Hub (2nd gen)과 같은 스마트 디스플레이를 사용하여 이를 제어할 수 있는 기능을 통해 스마트 홈 작업 로컬 처리 경로를 확장하고 있습니다.
이 문서에서는 Google Home 생태계에서 Matter 지원 플랫폼을 빌드하고 통합하는 방법을 설명합니다.
면책조항
Matter 문서에 설명된 절차와 관련하여 다음 사항에 유의하세요.
- 개발에 사용되는 계정에는 테스트를 위해 연결된 Matter 지원 허브가 하나만 있는 것이 좋습니다. 테스트 중에 동시에 연결되거나 동일한 구조에 연결된 여러 개의 Matter 지원 허브로 인해 예기치 않은 동작이 발생할 수 있습니다.
- 모든 절차는 Google에서 테스트한 Matter 샘플을 빌드하고 플래시하기 위해 Ubuntu 20.04를 실행하는 Linux 머신을 사용한다고 가정합니다. macOS 머신도 지원되지만 Linux를 사용하는 것이 좋습니다. Mac 관련 안내는 필요에 따라 절차에서 호출됩니다.
빌드 방법
Google Home 생태계와 통합되는 Matter 지원 기기를 빌드하려면 Matter 호환 개발 보드와 Matter SDK를 사용합니다.
시작하는 가장 쉬운 방법은 Codelab을 사용하는 것입니다. 다음 Codelab 중 하나 이상을 완료하는 것이 좋습니다.
그런 다음 지원되는 기기 목록을 확인하여 통합하려는 기기가 Google Home 생태계에서 지원되는지 확인하세요. 그런 다음 개발자 체크리스트를 읽고 프로젝트 생성부터 출시에 이르기까지의 전체 개발 흐름을 이해합니다.
정의
이 문서에서는 다음 용어가 사용됩니다.
- 보더 라우터
- Thread 지원 기기용 범용 Thread 보더 라우터를 구현하는 허브입니다.
- 허브
- 지원되는 Google Nest 기기(예: Google Nest Hub (2nd gen)) Assistant, GHA, 스마트 디스플레이와 같은 다른 표시 경로를 통해 Matter 지원 기기를 제어하려면 허브가 필요합니다.
- Matter 지원 기기
- Matter 지원 빌드 또는 샘플 앱으로 플래시된 기기 또는 개발 보드입니다.
- 휴대기기
- 페어링을 지원하는 데 사용된 테스트 휴대전화입니다. 현재는 Android 휴대전화입니다.
기본 요건
Matter 지원 기기를 Google Home 생태계와 완전히 통합하려면 개발자가 다음을 갖추어야 합니다.
- 스레드 지원 Google 허브: 스레드 지원 기기의 보더 라우터와 스마트 홈 인텐트 라우팅을 위한 로컬 처리 경로 역할을 합니다.
- 다음과 같은 최소 요구사항을 충족하는 휴대기기 (테스트 전화)
- Android O (8.1, API 수준 27 이상)
- iOS (v16.5 이상)
- BLE 기능
- Matter 지원 기기의 공급업체 ID (VID) 및 제품 ID (PID)
- Matter 지원 기기 이 기기는 Google Home 생태계에서 지원되는 Matter 기기 유형 중 하나여야 하며 다음과 같은 유형일 수 있습니다.
- Matter 지원 펌웨어가 포함된 자체 제품
- 엔드 투 엔드 인증에 사용할 다음 Matter 기기 중 하나:
공급업체 | 플랫폼 | Thread 지원 | 가이드 |
---|---|---|---|
Bouffalo Lab | BL602 | ||
BL702 | |||
Espressif | ESP32 | OTA 테스트 | |
Nordic Semiconductor | nRF52840 DK | OTA 테스트 | |
NXP | IOTZTB-DK006 개발 키트 | ||
Realtek | Ameba D 시리즈 | ||
Silicon Labs | EFR32MG24 Dev Kit | ||
EFR32MG Zigbee 및 Thread Starter Kit | |||
Telink | TLSR9518 | ||
Texas Instruments | CC2652R7 LaunchPad 개발 키트 |
공급업체 ID
기본적으로 테스트 목적으로 CSA에서 할당한 VID 중 하나를 사용할 수 있습니다. 0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
중 하나를 선택합니다.
통합을 인증하고 출시할 수 있도록 프로덕션 VID를 사용하려면 먼저 Google에서 VID가 CSA에서 발급한 것인지 확인해야 합니다.
이 VID는 기기의 펌웨어에 구현되어야 합니다.
Matter 기기는 특정 공급업체 ID 및 기기 유형 시나리오에서만 Google Home 생태계에서 페어링할 수 있습니다.
- 테스트 VID는 소비자 기기에서 사용할 수 없습니다.
- 프로덕션 VID는 Connectivity Standards Alliance (Alliance)에서 발급해야 합니다. Google Home Developer Console에서 VID를 사용하려면 먼저 Google에서 해당 VID의 소유자임을 확인해야 합니다. 그러면 해당 VID에 대한 통합을 만들 수 있습니다.
- 개발 및 필드 테스트 목적으로 프로젝트와 해당 VID 및 PID 조합과의 통합을 Developer Console에서 만들어야 합니다. 기기를 커미셔닝하는 사용자는 프로젝트 회원이거나 현장 시험 사용자 목록에 포함되어 있어야 합니다.
- 소비자 사용자는 Alliance에서 인증한 후에만 제품을 사용할 수 있습니다.
VID 및 PID는 하나의 통합에 한 번만 사용할 수 있습니다. 통합에서 동일한 VID 또는 PID를 사용하려면 다음 중 하나를 실행해야 합니다.
- VID 또는 PID를 사용하여 통합을 다른 VID 또는 PID로 수정합니다.
- VID 또는 PID를 사용하여 통합을 삭제합니다.
어떤 유형의 사용자가 Google Home 생태계에서 기기를 커미셔닝할 수 있나요? | |||
---|---|---|---|
VID 유형 | VID 인증 및 콘솔 통합 상태 | 프로덕션
(일반 사용자) |
개발
(개발자, 파일럿 사용자) |
테스트 | Developer Console에 통합이 없음 (인증할 수 없음) | ||
테스트 | Developer Console에 통합이 있습니다 (인증할 수 없음). | ||
프로덕션 | 인증되지 않음, Developer Console에 통합이 없음 | ||
프로덕션 | 인증되지 않음, Developer Console에 통합이 있음 | ||
프로덕션 | Alliance DCL에서 인증되었으나 Developer Console에 통합이 없음 | ||
프로덕션 | Alliance DCL에서 인증을 받았으며 Developer Console에 통합이 있음 |
제품 ID
기기 정보는 Matter 기본 정보 클러스터에서 읽습니다. 기기의 펌웨어에 인코딩된 제품 ID가 Developer Console의 Matter 통합 제품 ID와 일치해야 합니다.
지원되지 않는 기능
일부 Matter 클러스터는 시스템에서 사용될 수 있지만 아직 사용자에게 노출되지 않습니다. 대부분의 경우 이러한 클러스터를 통해 노출되는 속성은 최종 사용자에게 표시되지 않습니다.
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
¹ 전원 스위치에 미치는 영향은 전원 스위치를 참고하세요.