เริ่มต้นใช้งาน 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 Hub ที่รองรับเทรดเพื่อทำหน้าที่เป็นทั้ง Border Router สำหรับอุปกรณ์ที่เปิดใช้เทรด และเป็นเส้นทางการตอบสนองในเครื่องสำหรับการกำหนดเส้นทาง 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
EFR32MG Zigbee และ Thread Starter Kit
Telink TLSR9518
Texas Instruments ชุดพัฒนาซอฟต์แวร์ CC2652R7 LaunchPad

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

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

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

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

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

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

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

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

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

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

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

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

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