เริ่มต้นใช้งาน Matter

โปรแกรม Google Home Developer ช่วยให้ผู้ผลิตอุปกรณ์เชื่อมต่อ อุปกรณ์ในบ้านอัจฉริยะกับระบบนิเวศของ Google Home ได้ เรากำลังขยายเส้นทางการตอบสนองในพื้นที่สำหรับการดำเนินการเกี่ยวกับสมาร์ทโฮมโดยให้มีความสามารถในการเพิ่มอุปกรณ์ที่เปิดใช้ Matter เพื่อตั้งค่าโดยใช้ Google Home app (GHA) และควบคุมอุปกรณ์เหล่านี้โดยใช้ Google Assistant,GHA หรือ Smart Display เช่น Google Nest Hub (2nd gen) ได้

เอกสารประกอบนี้จะอธิบายวิธีเริ่มสร้างและผสานรวมแพลตฟอร์มที่รองรับ Matter ในระบบนิเวศของ Google Home

ข้อจำกัดความรับผิด

โปรดตรวจสอบขั้นตอนที่อธิบายไว้ในเอกสารประกอบ Matter ดังนี้

  • เราขอแนะนำให้บัญชีที่ใช้สำหรับการพัฒนาต้องเชื่อมต่อฮับที่เปิดใช้ Matter สำหรับการทดสอบเท่านั้น ฮับที่เปิดใช้ Matter หลายตัวซึ่งเชื่อมต่อพร้อมกันหรือเชื่อมต่อกับโครงสร้างเดียวกันในระหว่างการทดสอบอาจทำให้เกิดลักษณะการทำงานที่คาดเดาไม่ได้
  • ขั้นตอนทั้งหมดจะถือว่าใช้เครื่อง Linux ที่ใช้ Ubuntu 20.04 ในการสร้างและกะพริบตัวอย่าง Matter ซึ่งได้รับการทดสอบโดย Google แม้ว่าระบบจะรองรับเครื่อง MacOS แต่ขอแนะนำให้ใช้ Linux และจะมีคำอธิบายวิธีการสำหรับ Mac โดยเฉพาะ ในกระบวนการที่จำเป็น

วิธีสร้าง

หากต้องการสร้างอุปกรณ์ที่พร้อมใช้งาน Matter ซึ่งผสานรวมกับระบบนิเวศของ Google Home คุณจะต้องใช้กระดานการพัฒนาที่ใช้ร่วมกับ Matter และ Matter SDK ได้

วิธีที่ง่ายที่สุดในการเริ่มต้นใช้งานคือการอ่าน Codelab เราขอแนะนำให้ทำ Codelab ต่อไปนี้อย่างน้อย 1 รายการ

หลังจากนั้น ตรวจสอบรายการอุปกรณ์ที่รองรับเพื่อให้แน่ใจว่าสิ่งที่คุณวางแผนจะผสานรวมได้รับการสนับสนุนในระบบนิเวศของ Google Home จากนั้นอ่านรายการตรวจสอบสำหรับนักพัฒนาซอฟต์แวร์เพื่อทำความเข้าใจขั้นตอนการพัฒนาทั้งหมดตั้งแต่การสร้างโปรเจ็กต์ไปจนถึงการเปิดตัว

อุปกรณ์ที่รองรับ รายการตรวจสอบสำหรับนักพัฒนาซอฟต์แวร์

คำจำกัดความ

มีการใช้คำศัพท์ต่อไปนี้ในเอกสารประกอบนี้

บอร์เดอร์เราเตอร์
ฮับที่ใช้ Border Router สำหรับงานทั่วไป Thread สำหรับอุปกรณ์ที่เปิดใช้ Thread
Hub
อุปกรณ์ Google Nest ที่รองรับ เช่น Google Nest Hub (2nd gen) คุณต้องมีฮับเพื่อควบคุมอุปกรณ์ที่เปิดใช้ Matter ผ่านแพลตฟอร์มอื่นๆ เช่น Assistant, GHA และ Smart Display
อุปกรณ์ที่เปิดใช้ Matter
อุปกรณ์หรือกระดานการพัฒนาที่มีการแฟลชด้วยบิลด์หรือแอปตัวอย่างที่เปิดใช้ Matter
อุปกรณ์เคลื่อนที่
โทรศัพท์ทดสอบที่ใช้เพื่อช่วยในการจับคู่ ปัจจุบันนี่คือโทรศัพท์ Android

สิ่งที่ต้องดำเนินการก่อน

ส่วนขยาย IDE ที่แนะนำสำหรับการพัฒนา Matter

หากต้องการผสานรวมอุปกรณ์ที่เปิดใช้ Matter เข้ากับระบบนิเวศของ Google Home อย่างเต็มรูปแบบ นักพัฒนาซอฟต์แวร์จะต้องมีสิ่งต่อไปนี้

  1. Google Hub ที่มีการรองรับเทรดสำหรับทำหน้าที่เป็นทั้ง Border Router สำหรับอุปกรณ์ที่เปิดใช้เทรดและเป็นเส้นทาง Fulfillment ภายในสำหรับการกำหนดเส้นทาง Intent ของสมาร์ทโฮม
  2. อุปกรณ์เคลื่อนที่ (โทรศัพท์ทดสอบ) ที่มีคุณสมบัติตรงตามข้อกำหนดขั้นต่ำดังต่อไปนี้
    • Android O (8.1, API ระดับ 27 ขึ้นไป)
    • iOS (v16.5 หรือใหม่กว่า)
    • ความสามารถ BLE
  3. รหัสผู้ให้บริการ (VID) และรหัสผลิตภัณฑ์ (PID) สำหรับอุปกรณ์ที่เปิดใช้ Matter
  4. อุปกรณ์ที่พร้อมใช้งาน Matter อุปกรณ์นี้ควรเป็นหนึ่งในอุปกรณ์ Matter ประเภทที่ระบบนิเวศ Google Home รองรับในปัจจุบัน และอาจเป็นประเภทต่อไปนี้
    • ผลิตภัณฑ์ของคุณเองที่มีเฟิร์มแวร์ที่เปิดใช้ Matter
    • กระดานพัฒนาของแพลตฟอร์มผู้ให้บริการที่รองรับซึ่งทำหน้าที่เป็นอุปกรณ์ที่เปิดใช้ Matter เพื่อการยืนยันจากต้นทางถึงปลายทาง ระบบรองรับแพลตฟอร์มต่อไปนี้
ตาราง: Matter ตัวอย่างจากผู้ให้บริการซิลิคอน
ตัวแทนจำหน่ายรายย่อย แพลตฟอร์ม คำแนะนำ การสนับสนุนสำหรับ Thread
ห้องทดลอง Bouffalo BL602 คู่มือเริ่มต้นฉบับย่อ
BL702 คู่มือเริ่มต้นฉบับย่อ
เอสเพรสซีฟ ESP32 คู่มือเริ่มต้นฉบับย่อ
การทดสอบ OTA
เซมิคอนดักเตอร์นอร์ดิก nRF52840 DK คู่มือเริ่มต้นฉบับย่อ
การทดสอบ OTA
NXP ชุดพัฒนาซอฟต์แวร์ IOTZTB-DK006 คู่มือเริ่มต้นฉบับย่อ
Realtek Ameba D Series คู่มือเริ่มต้นฉบับย่อ
ห้องทดลองซิลิคอน ชุดพัฒนาซอฟต์แวร์ EFR32MG24 คู่มือเริ่มต้นฉบับย่อ
EFR32MG Zigbee และ Thread Starter Kit คู่มือเริ่มต้นฉบับย่อ
Telink TLSR9518 คู่มือเริ่มต้นฉบับย่อ
เครื่องดนตรีเท็กซัส ชุดการพัฒนา LaunchPad ของ CC2652R7 คู่มือเริ่มต้นฉบับย่อ

รหัสตัวแทนจำหน่ายรายย่อย

โดยค่าเริ่มต้น คุณจะใช้ VID รายการที่ CSA จัดสรรไว้เพื่อการทดสอบได้ เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้ 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4

หากต้องการใช้ VID เวอร์ชันที่ใช้งานจริงเพื่อให้การผสานรวมได้รับการรับรองและเปิดตัวได้ คุณต้องได้รับการยืนยันจาก Google ก่อนเพื่อให้แน่ใจว่าจะมีการออกโดย CSA ให้คุณ

VID นี้ควรติดตั้งในเฟิร์มแวร์ของอุปกรณ์

อุปกรณ์ Matter จะจับคู่ได้ในระบบนิเวศของ Google Home ในบางสถานการณ์ของรหัสผู้ให้บริการและประเภทอุปกรณ์เท่านั้น

  • ใช้ VID ทดสอบในอุปกรณ์ของผู้บริโภคไม่ได้
  • VID ที่ใช้งานจริงของคุณต้องออกโดย Connectivity Standards Alliance (Alliance) Google จะตรวจสอบว่าคุณเป็นเจ้าของ VID ดังกล่าวก่อนที่คุณจะใช้ใน Google Home Developer Console ได้ หลังจากนั้น คุณก็จะสามารถ สร้างการผสานสำหรับ VID นั้นได้
  • สำหรับวัตถุประสงค์ในการพัฒนาและทดลองภาคสนาม โครงการและการผสานรวมกับ VID และ PID ที่เกี่ยวข้องจะต้องสร้างขึ้นในDeveloper Console ผู้ใช้ที่ว่าจ้างอุปกรณ์ต้องเป็นสมาชิกของโปรเจ็กต์หรือรวมอยู่ในรายชื่อผู้ใช้ทดลองภาคสนาม
  • ผู้ใช้ทั่วไปจะใช้ผลิตภัณฑ์ของคุณได้ก็ต่อเมื่อผลิตภัณฑ์ดังกล่าวได้รับการรับรองจาก Alliance เท่านั้น
ตาราง: สถานการณ์การจับคู่รหัสผู้ให้บริการ (VID) และประเภทอุปกรณ์
ผู้ใช้ประเภทใดมอบสิทธิ์ให้อุปกรณ์เข้าสู่ระบบนิเวศของ Google Home ได้
ประเภท VID สถานะการรับรอง VID และการผสานรวมคอนโซล เวอร์ชันที่ใช้งานจริง
(ผู้ใช้ทั่วไป)
การพัฒนา
(นักพัฒนาซอฟต์แวร์ ผู้ใช้การทดสอบภาคสนาม)
ทดสอบ ไม่มีการผสานรวมใน Developer Console (ไม่สามารถผ่านการรับรอง)
ทดสอบ มีการผสานรวมอยู่ใน Developer Console (ไม่สามารถผ่านการรับรอง)
Production ไม่ผ่านการรับรอง ไม่มีการผสานรวมอยู่ใน Developer Console
Production ไม่ได้รับการรับรอง มีการผสานรวมอยู่ใน Developer Console
Production ผ่านการรับรองใน DCL ของ Alliance ไม่มีการผสานรวมอยู่ใน Developer Console
Production ได้รับการรับรองใน DCL ของ Alliance และมีการผสานรวมอยู่ใน Developer Console

รหัสผลิตภัณฑ์

ระบบจะอ่านข้อมูลเกี่ยวกับอุปกรณ์จากคลัสเตอร์ข้อมูลพื้นฐานของ Matter รหัสผลิตภัณฑ์ที่เข้ารหัสในเฟิร์มแวร์ของอุปกรณ์ต้องตรงกับรหัสผลิตภัณฑ์ของการผสานรวม Matter ใน Developer Console

ฟีเจอร์ที่ไม่รองรับ

คลัสเตอร์ 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.

1 ดูสวิตช์ไฟเปิด/ปิด เกี่ยวกับผลกระทบของสวิตช์ไฟเปิด/ปิด