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

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

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

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

คำจำกัดความ

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

Border Router
ฮับที่ใช้ Thread Border Router อเนกประสงค์สำหรับอุปกรณ์ที่เปิดใช้ Thread
Hub
อุปกรณ์ 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 อุปกรณ์อย่างใดอย่างหนึ่งต่อไปนี้เพื่อใช้สำหรับการ ยืนยันจากต้นทางถึงปลายทาง
ตาราง: 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 TLSR9518
Texas Instruments ชุดพัฒนา CC2652R7 LaunchPad

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

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

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

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

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

  • คุณจะใช้ VID ทดสอบในอุปกรณ์ของผู้บริโภคไม่ได้
  • Connectivity Standards Alliance (Alliance) ต้องออก VID ของเวอร์ชันที่ใช้งานจริง 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

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

ระบบจะอ่านข้อมูลเกี่ยวกับอุปกรณ์จาก 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.

¹ ดูสวิตช์ไฟเปิด/ปิด เพื่อดูว่าการเปลี่ยนแปลงนี้ส่งผลต่อสวิตช์ไฟเปิด/ปิดอย่างไร