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

โปรแกรมนักพัฒนาซอฟต์แวร์ของ Google Home ช่วยให้ผู้ผลิตอุปกรณ์เชื่อมต่อ อุปกรณ์สมาร์ทโฮมด้วยระบบนิเวศ Google Home เรากำลังขยาย เส้นทาง Fulfillment ของ Smart Home ในพื้นที่ซึ่งสามารถเพิ่มได้ อุปกรณ์ที่พร้อมใช้งาน Matter สำหรับการตั้งค่าโดยใช้ Google Home app (GHA) และควบคุมโดยใช้ Google Assistant, GHA หรือจออัจฉริยะ เช่น 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 ที่รองรับเทรด สำหรับใช้เป็น Border Router สำหรับอุปกรณ์ที่เปิดใช้งาน Thread เส้นทาง 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 คู่มือ
บูฟฟาโลแล็บ BL602
BL702
เอสเพรสซีฟ ESP32 การทดสอบ OTA
นอร์ดิกเซมิคอนดักเตอร์ nRF52840 DK การทดสอบ OTA
NXP การพัฒนา IOTZTB-DK006 ชุดเครื่องมือ
Realtek ซีรีส์ Ameba D
Silicon Labs EFR32MG24 Dev Kit
EFR32MG Zigbee และเทรด คู่มือเริ่มต้น
เทลิงก์ TLSR9518
เครื่องดนตรีเท็กซัส การพัฒนา CC2652R7 LaunchPad ชุดเครื่องมือ

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

โดยค่าเริ่มต้น คุณจะใช้ 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 (ไม่สามารถ ได้รับการรับรอง)
การผลิต ไม่ได้รับการรับรองเนื่องจากไม่มีการผสานรวมใน Developer Console
การผลิต ไม่ได้รับการรับรอง มีการผสานรวมใน Developer Console
การผลิต ได้รับการรับรองใน DCL ของ Alliance แต่การผสานรวมจะไม่ มีอยู่ใน Developer Console
การผลิต ได้รับการรับรองใน 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 ดูสวิตช์ไฟเปิด/ปิด สำหรับผลกระทบที่มีต่อสวิตช์เปิด/ปิด