รุ่นตัวอย่างสําหรับนักพัฒนาซอฟต์แวร์
โปรแกรม 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 บางส่วนยังไม่ได้แสดงต่อผู้ใช้ แต่ระบบอาจใช้คลัสเตอร์ดังกล่าว ในกรณีส่วนใหญ่ ตัวอย่างดังกล่าวหมายความว่าแอตทริบิวต์ ที่เปิดเผยผ่านคลัสเตอร์เหล่านี้จะไม่แสดงต่อผู้ใช้ปลายทาง
ประเภทคลัสเตอร์ | คลัสเตอร์ |
---|---|
หลัก |
|
การสมัคร |
|