Matter 시작하기

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 중 하나 이상을 완료하는 것이 좋습니다.

49분

Updated 2024년 12월 21일

Local Home SDK로 로컬 처리를 사용 설정하여 스마트 홈과 어시스턴트의 통합을 강화하는 방법을 알아보세요.

25분

Updated 2024년 11월 23일

GCP 측정항목 및 Logging을 사용하여 프로덕션 문제를 파악하고 해결하는 방법을 알아봅니다. 테스트 모음을 사용하여 기능 및 API 문제를 파악하는 방법을 알아보세요.

35분

Updated 2024년 11월 23일

클라우드 간 통합을 빌드하고 배포하여 어시스턴트에 가상 스마트 세탁기를 통합하세요.

16분

Updated 2024년 11월 23일

Google Cloud에서 로그 기반 측정항목을 사용하여 패턴을 추적하고 스마트 홈 통합 오류 로그를 분석하는 방법을 알아보세요.

50분

Updated 2024년 11월 23일

GCP 측정항목 및 Logging을 사용하여 프로덕션 문제를 파악하고 해결하는 방법을 알아봅니다. 테스트 모음을 사용하여 기능 및 API 문제를 파악하는 방법을 알아보세요. 로컬 홈 앱을 개발하는 동안 Chrome 개발자 도구를 사용하는 방법을 알아봅니다.

23분

Updated 2024년 11월 23일

CameraStream 특성 및 WebRTC를 사용하여 웹캠에서 Google Nest 디스플레이 기기로 스트리밍하는 방법을 알아봅니다.

50분

Updated 2024년 11월 23일

맞춤설정 가능한 기기 특성을 통해 클라우드 간 통합을 개선하고 보안을 강화하며, 2단계 인증을 통해 보안을 강화하는 방법을 알아보세요.

31분

Updated 2024년 11월 21일

이 Codelab에서는 스마트 홈 통합에 자동 알림을 설정하여 서비스 중단을 감지하는 방법을 알아봅니다.

56분

Updated 2024년 11월 9일

이 Codelab에서는 Cast Ad Breaks API를 사용하는 맞춤 웹 수신기 애플리케이션을 빌드합니다.

59분

Updated 2024년 11월 9일

이 Codelab에서는 기존 커스텀 웹 수신기 앱에 Cast 디버그 로거를 추가합니다.

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

지원되는 기기 개발자 체크리스트

정의

이 문서에서는 다음 용어가 사용됩니다.

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

기본 요건

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

Matter 지원 기기를 Google Home 생태계와 완전히 통합하려면 개발자가 다음을 갖추어야 합니다.

  1. 스레드 지원 Google 허브: 스레드 지원 기기의 보더 라우터와 스마트 홈 인텐트 라우팅을 위한 로컬 처리 경로 역할을 합니다.
  2. 최소 요구사항을 충족하는 휴대기기 (테스트 전화)
    • Android O (8.1, API 수준 27 이상)
    • iOS (v16.5 이상)
    • BLE 기능
  3. Matter 지원 기기의 공급업체 ID (VID)제품 ID (PID)
  4. Matter 지원 기기 이 기기는 Google Home 생태계에서 지원되는 Matter 기기 유형 중 하나여야 하며 다음과 같은 유형일 수 있습니다.
    • 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 스타터 키트
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에 대한 통합을 만들 수 있습니다.
  • 개발 및 Field Trial 목적으로 프로젝트와 해당 VID 및 PID 조합과의 통합을 Developer Console에서 만들어야 합니다. 기기를 커미셔닝하는 사용자는 프로젝트의 구성원이거나 Field Trial 사용자 목록에 포함되어 있어야 합니다.
  • 소비자 사용자는 Alliance에서 인증한 후에만 제품을 사용할 수 있습니다.

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

  • VID 또는 PID를 사용하여 통합을 다른 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에 통합이 있음

제품 ID

기기 정보는 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.

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