โปรแกรมนักพัฒนาแอป 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
ข้อกำหนดเบื้องต้น
นักพัฒนาแอปต้องมีสิ่งต่อไปนี้จึงจะผสานรวมอุปกรณ์ที่เปิดใช้ Matter เข้ากับระบบนิเวศของ Google Home ได้อย่างเต็มที่
- Google Hub ที่รองรับเทรดเพื่อทำหน้าที่เป็นทั้ง Border Router สำหรับอุปกรณ์ที่เปิดใช้เทรด และเป็นเส้นทางการตอบสนองในเครื่องสำหรับการกำหนดเส้นทาง Intent ของสมาร์ทโฮม
- อุปกรณ์เคลื่อนที่ (โทรศัพท์ทดสอบ) ที่เป็นไปตามข้อกำหนดขั้นต่ำ
- Android O (8.1, API ระดับ 27 ขึ้นไป)
- iOS (v16.5 ขึ้นไป)
- ความสามารถของ BLE
- รหัสผู้ให้บริการ (VID) และรหัสผลิตภัณฑ์ (PID) สำหรับอุปกรณ์ที่พร้อมใช้งาน Matter
- อุปกรณ์ที่เปิดใช้ Matter อุปกรณ์นี้ควรเป็นหนึ่งในMatterประเภทอุปกรณ์ที่รองรับในระบบนิเวศ Google Home และอาจเป็นอุปกรณ์ต่อไปนี้
- ผลิตภัณฑ์ของคุณเองที่มีเฟิร์มแวร์ที่เปิดใช้ 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 ทดสอบจะใช้ในอุปกรณ์ของผู้บริโภคไม่ได้
- VID เวอร์ชันที่ใช้งานจริงต้องออกโดย Connectivity Standards Alliance (Alliance) Google จะตรวจสอบว่าคุณเป็นเจ้าของ VID ดังกล่าวก่อนจึงจะใช้ VID นั้นใน Google Home Developer Console ได้ เมื่อดำเนินการเสร็จแล้ว คุณจะสร้างการผสานรวมสำหรับ VID นั้นได้
- คุณต้องสร้างโปรเจ็กต์และการผสานรวมกับชุดค่าผสม VID และ PID ที่เกี่ยวข้องใน Developer Console เพื่อวัตถุประสงค์ในการพัฒนาและการทดสอบภาคสนาม ผู้ใช้ที่สั่งการให้อุปกรณ์ทํางานได้ต้องเป็นสมาชิกของโปรเจ็กต์หรืออยู่ในรายชื่อผู้ใช้การทดสอบภาคสนาม
- ผู้ใช้ทั่วไปจะใช้ผลิตภัณฑ์ของคุณได้ก็ต่อเมื่อผลิตภัณฑ์ได้รับการรับรองจาก Alliance
VID และ PID ใช้ได้เพียงครั้งเดียวสำหรับการผสานรวม 1 ครั้ง หากต้องการใช้ VID หรือ PID เดียวกันในการผสานรวม คุณจะต้องดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- แก้ไขการผสานรวมโดยใช้ VID หรือ PID เป็น VID หรือ PID อื่น
- ลบการผสานรวมโดยใช้ VID หรือ PID
| ผู้ใช้ประเภทใดบ้างที่จะสามารถสั่งอุปกรณ์ให้เข้าสู่ระบบนิเวศของ Google Home ได้ | |||
|---|---|---|---|
| ประเภท VID | สถานะการรับรอง VID และการผสานรวมคอนโซล | เวอร์ชันที่ใช้งานจริง
(ผู้ใช้ทั่วไป) |
การพัฒนา
(นักพัฒนาแอป ผู้ใช้การทดสอบภาคสนาม) |
| ทดสอบ | ไม่มีการผสานรวมใน Developer Console (ไม่สามารถรับรองได้) | ||
| ทดสอบ | การผสานรวมมีอยู่ใน Developer Console (ไม่สามารถรับรองได้) | ||
| เวอร์ชันที่ใช้งานจริง | ไม่ผ่านการรับรอง ไม่มีการผสานรวมใน Developer Console | ||
| เวอร์ชันที่ใช้งานจริง | ไม่มีการรับรอง มีการผสานรวมใน Developer Console | ||
| เวอร์ชันที่ใช้งานจริง | ได้รับการรับรองใน Alliance DCL แต่ไม่มีการทำงานร่วมกันใน Developer Console | ||
| เวอร์ชันที่ใช้งานจริง | ผ่านการรับรองใน Alliance DCL และมีการผสานรวมใน Developer Console | ||
รหัสผลิตภัณฑ์
ระบบจะอ่านข้อมูลเกี่ยวกับอุปกรณ์จาก Matterคลัสเตอร์ข้อมูลพื้นฐาน รหัสผลิตภัณฑ์ที่เข้ารหัสในเฟิร์มแวร์ของอุปกรณ์ต้องตรงกับรหัสผลิตภัณฑ์ของMatterการผสานรวมในคอนโซลนักพัฒนาซอฟต์แวร์
ฟีเจอร์ที่ไม่รองรับ
คลัสเตอร์ Matter บางรายการยังไม่แสดงต่อผู้ใช้ แต่ระบบอาจใช้คลัสเตอร์ดังกล่าว ในกรณีส่วนใหญ่ ผู้ใช้ปลายทางจะไม่เห็นแอตทริบิวต์ที่แสดงผ่านคลัสเตอร์เหล่านี้
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ ดูว่าการเปลี่ยนแปลงนี้ส่งผลต่อสวิตช์เปิด/ปิดอย่างไร