รุ่นตัวอย่างสําหรับนักพัฒนาซอฟต์แวร์
โปรแกรม Home ของ Google ช่วยให้ผู้ผลิตอุปกรณ์เชื่อมต่ออุปกรณ์ในบ้านอัจฉริยะกับระบบนิเวศของ Google Home ได้ เรากําลังขยายเส้นทางการดําเนินการตามท้องถิ่นของ Smart Home Actions ที่มีความสามารถในการเพิ่ม Matter-enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant, GHA, or smart displays like the Google Nest Hub (2nd gen).
เอกสารประกอบนี้จะอธิบายวิธีเริ่มต้นสร้างและผสานรวมแพลตฟอร์มที่รองรับ Matter ในระบบนิเวศ Google Home
ข้อจํากัดความรับผิดชอบ
ในส่วนของขั้นตอนที่อธิบายไว้ในตัวอย่างสําหรับนักพัฒนาแอป Matter นี้ โปรดระวังสิ่งต่อไปนี้
- บัญชีที่ใช้สําหรับการพัฒนาควรมีฮับที่เปิดใช้ Matter เพียงแห่งเดียวสําหรับการทดสอบ ฮับที่เปิดใช้ Matter หลายตัวเชื่อมต่อพร้อมกันหรือเชื่อมต่อกับโครงสร้างเดียวกันระหว่างการทดสอบอาจทําให้เกิดลักษณะการทํางานที่คาดเดาไม่ได้
- กระบวนการทั้งหมดจะถือว่ามีการใช้เครื่อง Linux ที่ใช้ Ubuntu 20.04 ในการสร้างและกะพริบ Matter ตัวอย่าง ซึ่งได้รับการทดสอบจาก Google แล้ว แม้ว่าเราจะรองรับเครื่อง MacOS แต่เราขอแนะนําให้ใช้ Linux วิธีการเฉพาะของ Mac จะระบุไว้ในกระบวนการตามที่จําเป็น
- รองรับเฉพาะ GHA เวอร์ชัน Android เท่านั้น
คำจำกัดความ
ข้อกําหนดต่อไปนี้ใช้ในเอกสารฉบับนี้ทั้งหมด
- เราเตอร์เส้นขอบ
- ฮับที่ใช้Thread Border Router for Thread-enabled devices.ทั่วไป
- Hub
- Google Nest device, such as the Google Nest Hub (2nd gen). A hub is required to control Matter-enabled devices through other surfaces such as Assistant, the GHA, and smart displays. ที่รองรับ
- อุปกรณ์ที่เปิดใช้ Matter
- อุปกรณ์หรือกระดานการพัฒนาที่ใช้ Flash ด้วยแอป Matter ที่สร้างจากบิลด์หรือตัวอย่าง
- อุปกรณ์เคลื่อนที่
- โทรศัพท์ทดสอบที่ใช้สําหรับความช่วยเหลือในการจับคู่ นี่คือ Android phone.
สิ่งที่ต้องดำเนินการก่อน
หากต้องการผสานรวมอุปกรณ์ที่เปิดใช้ Matter กับระบบนิเวศของ Google Home อย่างสมบูรณ์ นักพัฒนาแอปต้องมีสิ่งต่อไปนี้
- ฮับของ Google ที่มีการรองรับเทรด ทําหน้าที่เป็นทั้ง Border Router สําหรับอุปกรณ์ที่เปิดใช้เทรด และเป็นเส้นทางการตอบสนองในเครื่องสําหรับกําหนดเส้นทาง Intent ของสมาร์ทโฮม
- อุปกรณ์เคลื่อนที่ (โทรศัพท์ทดสอบ) ที่เป็นไปตามข้อกําหนดขั้นต่ํา
- Android O (8.1, API ระดับ 27) ขึ้นไป (รองรับ iOS ในภายหลัง)
- ความสามารถ BLE
- รหัสผู้ให้บริการ (VID) และรหัสผลิตภัณฑ์ (PID) สําหรับอุปกรณ์ที่เปิดใช้ Matter
- อุปกรณ์ที่พร้อมใช้งาน Matter อุปกรณ์นี้ควรเป็นหนึ่งในอุปกรณ์ Matter ประเภทที่ระบบนิเวศของ Google Home รองรับในปัจจุบัน และอาจมีลักษณะดังนี้
- ผลิตภัณฑ์ของคุณเองที่มีเฟิร์มแวร์ Matter ที่เปิดใช้
- กระดานการพัฒนาของแพลตฟอร์มผู้ให้บริการที่รองรับซึ่งทําหน้าที่เป็นอุปกรณ์ ที่เปิดใช้ Matter สําหรับการยืนยันจากต้นทางถึงปลายทาง แพลตฟอร์มที่รองรับมีดังนี้
| ผู้ขาย | แพลตฟอร์ม | คำแนะนำ | การสนับสนุนสําหรับ Thread |
|---|---|---|---|
| ห้องทดลองบุฟเฟต์ | BL602 | คู่มือเริ่มต้นฉบับย่อ | |
| BL702 | คู่มือเริ่มต้นฉบับย่อ | ||
| แก้วกาแฟ | ESP32 | คู่มือเริ่มต้นฉบับย่อ
การทดสอบ OTA |
|
| เซมิคอนดักเตอร์นอร์ดิก | nRF52840 DK | คู่มือเริ่มต้นฉบับย่อ
การทดสอบ OTA |
|
| NXP | ชุดพัฒนาซอฟต์แวร์ IOTZTB-DK006 | คู่มือเริ่มต้นฉบับย่อ | |
| Realtek | Ameba D Series | คู่มือเริ่มต้นฉบับย่อ | |
| ห้องทดลองซิลิคอน | EFR32MG Zigbee และ Thread Starter Kit | คู่มือเริ่มต้นฉบับย่อ | |
| ชุดพัฒนาซอฟต์แวร์ EFR32MG24 | คู่มือเริ่มต้นฉบับย่อ | ||
| ลิงก์ | TLSR9518 | คู่มือเริ่มต้นฉบับย่อ |
รหัสผู้ให้บริการ
โดยค่าเริ่มต้น คุณจะใช้ VID รายการหนึ่งที่ CSA จัดสรรให้สําหรับการทดสอบได้ เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4
หากต้องการใช้ VID เวอร์ชันที่ใช้งานจริง เพื่อให้การรับรองได้รับการรับรองและเปิดตัวได้ คุณต้องได้รับการยืนยันจาก Google ก่อน เพื่อให้แน่ใจว่า CSA จะเป็นผู้ออกให้คุณ
คุณควรนํา VID นี้ไปใช้ในเฟิร์มแวร์ของอุปกรณ์
อุปกรณ์ Matter จะจับคู่ได้เฉพาะในระบบนิเวศของ Google Home ในรหัสผู้ให้บริการและประเภทอุปกรณ์บางประเภทเท่านั้น
- ใช้ VID ทดสอบในอุปกรณ์ของผู้บริโภคไม่ได้
- อุปกรณ์ต้องได้รับการรับรองใน CSA DCL เพื่อให้จับคู่อุปกรณ์ที่ใช้งานจริง (ผู้บริโภค) ได้
- เพื่อจุดประสงค์ด้านการพัฒนาและช่วงทดลองใช้งาน อุปกรณ์ต้องจดทะเบียนใน Google Home Developer Console
| ผู้ใช้ประเภทใดค่าคอมมิชชันอุปกรณ์ในระบบนิเวศ Google Home ได้ | |||
|---|---|---|---|
| ประเภท VID | สถานะการรับรองและการจดทะเบียน VID | เวอร์ชันที่ใช้งานจริง
(ผู้ใช้ทั่วไป) |
การพัฒนา
(นักพัฒนาแอป ผู้ใช้ช่วงทดลองใช้ภาคสนาม) |
| ทดสอบ | ไม่ได้ลงทะเบียน (รับการรับรองไม่ได้) | ไม่มีข้อมูล | ไม่มีข้อมูล |
| ทดสอบ | จดทะเบียนใน Developer Console (รับการรับรองไม่ได้) | ไม่มีข้อมูล | |
| Production | ไม่ผ่านการรับรอง ไม่ได้ลงทะเบียน | ไม่มีข้อมูล | |
| Production | ไม่ผ่านการรับรอง ลงทะเบียนในDeveloper Console | ||
| Production | ได้รับการรับรองจาก CSA DCL แต่ไม่ได้ลงทะเบียน | ไม่มีข้อมูล | |
| Production | ผ่านการรับรองด้าน CSA DCL และจดทะเบียนใน Developer Console | ||
รหัสผลิตภัณฑ์
ระบบจะอ่านข้อมูลอุปกรณ์โดยใช้คลัสเตอร์ Matter Descriptor ไม่ใช่รหัสผลิตภัณฑ์ คุณอาจกําหนดรหัสผลิตภัณฑ์ระหว่างการพัฒนาก็ได้ ตามรูปแบบการกําหนดหมายเลขของบริษัท ตราบใดที่ตรงกับรหัสผลิตภัณฑ์ของการผสานรวม Matter (หากระบุ)
ฟีเจอร์ที่ไม่รองรับ
คลัสเตอร์ Matter บางส่วนยังไม่ได้แสดงต่อผู้ใช้ แต่ระบบอาจใช้คลัสเตอร์ดังกล่าว ในกรณีส่วนใหญ่ ตัวอย่างดังกล่าวหมายความว่าแอตทริบิวต์ ที่เปิดเผยผ่านคลัสเตอร์เหล่านี้จะไม่แสดงต่อผู้ใช้ปลายทาง
| ประเภทคลัสเตอร์ | คลัสเตอร์ |
|---|---|
| หลัก |
|
| การสมัคร |
|