2026년부터 모든 Matter 통합 및 테스트에는 Alliance 상호 운용성 테스트가 필요합니다. 자세한 내용은 Alliance Interop Test Lab 전환 페이지를 참고하세요.

Matter 시작하기

이 문서에서는 Google Home 생태계에서 Matter-지원 플랫폼을 빌드하고 통합하는 방법을 설명합니다.

면책조항

Matter 문서에 설명된 절차와 관련하여 다음 사항에 유의하세요.

개발에 사용되는 계정에는 테스트를 위해 Matter Matter-지원 허브가 하나만 연결되어 있는 것이 좋습니다. 테스트 중에 여러 Matter 지원 허브가 동시에 연결되거나 동일한 구조에 연결되면 예측할 수 없는 동작이 발생할 수 있습니다.
모든 절차는 Google에서 테스트한 빌드 및 플래시 Matter 샘플에 Ubuntu 20.04를 실행하는 Linux 머신을 사용하는 것으로 가정합니다. macOS 머신이 지원되지만 Linux를 사용하는 것이 좋습니다. 필요에 따라 절차에서 Mac 관련 안내가 호출됩니다.

Matter 지원 기기를 빌드하여 Google Home 생태계와 통합하려면 Matter 호환 개발 보드와 Matter SDK를 사용해야 합니다.

가장 쉽게 시작하는 방법은 Codelab을 살펴보는 것입니다. 다음 Codelab 중 하나 이상을 실행하는 것이 좋습니다.

그런 다음 지원되는 기기 목록을 확인하여 통합하려는 항목이 Google Home 생태계에서 지원되는지 확인합니다. 그런 다음 개발자 체크리스트 를 읽고 프로젝트 생성부터 출시까지 전체 개발 흐름을 파악합니다.

이 문서에서는 다음 용어를 사용합니다.

보더 라우터: Thread 지원 기기를 위한 범용 Thread 보더 라우터를 구현하는 허브입니다.
허브: Google Nest Hub(2세대)와 같은 지원되는 Google Nest 기기입니다 Google Nest Hub (2nd gen). 어시스턴트, GHA, 스마트 디스플레이와 같은 다른 화면을 통해 Matter 지원 기기를 제어하려면 허브가 필요합니다.
Matter 지원 기기: Matter 지원 빌드 또는 샘플 앱으로 플래시된 기기 또는 개발 보드입니다.Matter
휴대기기: 페어링을 지원하는 데 사용되는 테스트 휴대전화입니다. 현재는 이 Android 휴대전화입니다.

Matter 개발을 위한 권장 IDE 확장 프로그램

개발자는 Matter-지원 기기를 Google Home 생태계와 완전히 통합하려면 다음을 보유해야 합니다.

Thread 지원 기기의 보더 라우터와 스마트 홈 인텐트 라우팅을 위한 로컬 처리 경로 역할을 하는 Thread 지원 Google 허브
최소 요구사항을 충족하는 휴대기기 (테스트 휴대전화):
- Android O (8.1, API 수준 27 이상)
- iOS (v16.5 이상)
- BLE 기능
Matter 지원 기기의 공급업체 ID (VID) 및 제품 ID (PID)Matter
Matter 지원 기기 이 기기는 Google Home 생태계에서 지원되는 Matter 기기 유형 중 하나여야 하며 다음과 같을 수 있습니다.
- Matter 지원 펌웨어가 포함된 자체 제품Matter
- 엔드 투 엔드 확인에 사용할 다음 Matter 기기 중 하나

*표: Matter 실리콘 공급업체의 예*
공급업체	플랫폼	가이드
Bouffalo Lab	BL602
Bouffalo Lab	BL702
Espressif	ESP32	OTA 테스트
Nordic Semiconductor	nRF52840 DK	OTA 테스트
NXP	IOTZTB-DK006 개발 키트
Realtek	Ameba D 시리즈
Silicon Labs	EFR32MG24 개발 키트
Silicon Labs	EFR32MG Zigbee 및 Thread 스타터 키트
Telink	TLSR9528	Telink Matter 개발자 가이드
Texas Instruments	CC2652R7 LaunchPad 개발 키트

기본적으로 테스트 목적으로 Alliance에서 할당한 VID 중 하나를 사용할 수 있습니다. 다음 중 하나를 선택합니다. 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

통합을 인증하고 출시할 수 있도록 프로덕션 VID를 사용하려면 먼저 Google에서 VID가 Alliance에서 발급되었는지 확인해야 합니다.

이 VID는 기기의 펌웨어에 구현되어야 합니다.

Matter 기기는 특정 공급업체 ID 및 기기 유형 시나리오에서만 Google Home 생태계에서 페어링할 수 있습니다.

테스트 VID는 소비자 기기에서 사용할 수 없습니다.
프로덕션 VID는 Connectivity Standards Alliance (Alliance)에서 발급해야 합니다. Google에서 Google Home Developer Console에서 사용할 수 있도록 VID의 소유자인지 Google에서 확인합니다. 확인이 완료되면 해당 VID의 통합을 만들 수 있습니다.
개발 및 Field Trial 목적을 위해 상응하는 VID 및 PID 조합이 포함된 프로젝트 및 통합을 Developer Console에서 만들어야 합니다. 기기를 커미셔닝하는 사용자는 프로젝트의 구성원이거나 Field Trial 사용자 목록에 포함되어야 합니다.
일반 사용자는 Alliance에서 제품을 인증한 후에만 제품을 사용할 수 있습니다.

VID 및 PID는 하나의 통합에 한 번만 사용할 수 있습니다. 통합에서 동일한 VID 또는 PID를 사용하려면 다음 중 하나를 실행해야 합니다.

*표: 공급업체 ID (VID) 및 기기 유형 페어링 시나리오*
		어떤 유형의 사용자가 기기를 Google Home 생태계에 커미셔닝할 수 있나요?
VID 유형	VID 인증 및 콘솔 통합 상태	프로덕션 (일반 사용자)	개발 (개발자, Field Trial 사용자)
테스트	Developer Console에 통합이 없음 (인증할 수 없음)
테스트	Developer Console에 통합이 있음 (인증할 수 없음)
프로덕션	인증되지 않음, Developer Console에 통합이 없음
프로덕션	인증되지 않음, Developer Console에 통합이 있음
프로덕션	Alliance DCL에서 인증됨, 통합이 개발자 콘솔에 없음Developer Console
프로덕션	Alliance DCL에서 인증됨, 통합이 Developer Console에 있음

기기에 관한 정보는 Matter 기본 정보 클러스터에서 읽습니다. 기기의 펌웨어에 인코딩된 제품 ID는 개발자 콘솔의 Matter 통합 제품 ID와 일치해야 합니다.

일부 Matter 클러스터는 시스템에서 사용할 수 있지만 아직 사용자에게 노출되지 않습니다. 대부분의 경우 이러한 클러스터를 통해 노출되는 속성은 최종 사용자에게 표시되지 않습니다.

*Table: Matter clusters not exposed to users in the Google Home ecosystem*
Cluster Type	Clusters
Core	Binding ¹ Label Fixed Label User Label Actions Group Key Localization Configuration Time Format Localization Unit Localization Power Source Configuration Power Source Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics) Time Synchronization Mode Select
Application	Groups and Scenes are not directly supported. Equivalent functionality is available via Routines. All Media clusters. Equivalent functionality is available via Google Cast.

¹ 전원 스위치 에 미치는 영향은 전원 스위치를 참고하세요.