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

โปรแกรมนักพัฒนาซอฟต์แวร์ของ Google Home ช่วยให้ผู้ผลิตอุปกรณ์เชื่อมต่อ อุปกรณ์สมาร์ทโฮมของตนกับระบบนิเวศของ Google 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 ของเรา เรา ขอแนะนำให้ทำอย่างน้อย 1 ใน Codelab ต่อไปนี้

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

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

คำจำกัดความ

คำศัพท์ต่อไปนี้ใช้ตลอดทั้งเอกสารนี้

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

ข้อกำหนดเบื้องต้น

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

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

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

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

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

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

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

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

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

VID และ PID ใช้ได้เพียงครั้งเดียวสำหรับการผสานรวม 1 รายการ หากต้องการใช้ VID หรือ PID เดียวกันในการผสานรวม คุณต้องทำอย่างใดอย่างหนึ่งต่อไปนี้

  • แก้ไขการผสานรวมโดยใช้ VID หรือ PID เป็น VID หรือ PID อื่น
  • ลบการผสานรวมโดยใช้ VID หรือ PID
ตาราง: รหัสผู้ให้บริการ (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 คลัสเตอร์ข้อมูลพื้นฐาน รหัสผลิตภัณฑ์ที่เข้ารหัสในเฟิร์มแวร์ของอุปกรณ์ต้องตรงกับรหัสผลิตภัณฑ์ของ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.

¹ ดูสวิตช์ไฟเปิด/ปิด เพื่อดูว่าสวิตช์ไฟเปิด/ปิดได้รับผลกระทบอย่างไร