รุ่นตัวอย่างสําหรับนักพัฒนาซอฟต์แวร์
โปรแกรมนักพัฒนาซอฟต์แวร์ของบ้าน Google ช่วยให้ผู้ผลิตอุปกรณ์สามารถเชื่อมต่อ อุปกรณ์ในบ้านอัจฉริยะกับระบบนิเวศของ Google Home เรากําลังขยายเส้นทางการดําเนินการตามท้องถิ่นสําหรับ Smart Home Actions พร้อมเพิ่มอุปกรณ์ที่เปิดใช้ Matter เพื่อให้ตั้งค่าได้โดยใช้ Google Home app (GHA) และควบคุมโดยใช้ Google Assistant, GHA หรือ Smart Display เช่น Google Nest Hub (2nd gen)
เอกสารประกอบนี้จะอธิบายวิธีเริ่มต้นสร้างและผสานรวมแพลตฟอร์มที่ Matter รองรับในระบบนิเวศ Google Home
ข้อจํากัดความรับผิดชอบ
เกี่ยวกับกระบวนการที่อธิบายไว้ในการแสดงตัวอย่างสําหรับนักพัฒนาซอฟต์แวร์ใน Matter นี้ โปรดคํานึงถึงสิ่งต่อไปนี้
- บัญชีที่ใช้สําหรับการพัฒนาควรมีฮับที่เปิดใช้ Matter เพียงรายการเดียวเท่านั้นสําหรับการทดสอบ ฮับที่เปิดใช้ Matter หลายตัวที่เชื่อมต่อพร้อมกันหรือเชื่อมต่อกับโครงสร้างเดียวกันในระหว่างการทดสอบอาจทําให้เกิดพฤติกรรมที่ไม่คาดคิด
- กระบวนการทั้งหมดจะถือว่าใช้เครื่อง Linux ที่ใช้ Ubuntu 20.04 เพื่อสร้างและสุ่มตัวอย่าง Matter ซึ่งทดสอบโดย Google แล้ว แม้ว่าระบบจะรองรับเครื่อง MacOS แต่ขอแนะนําให้ใช้ Linux คําแนะนําเฉพาะสําหรับ Mac จะถูกเรียกออกมาในขั้นตอนต่างๆ ตามที่ต้องการ
คำจำกัดความ
คําศัพท์ต่อไปนี้ใช้อยู่ในเอกสารประกอบทั้งหมด
- เราเตอร์ขอบ
- ฮับที่ใช้เส้นทาง Border Thread อเนกประสงค์สําหรับอุปกรณ์ที่ใช้ Thread ได้
- Hub
- อุปกรณ์ Google Nest ที่รองรับ เช่น Google Nest Hub (2nd gen) ต้องมีฮับเพื่อควบคุมอุปกรณ์ที่เปิดใช้ Matter ผ่านแพลตฟอร์มอื่นๆ เช่น Assistant, GHA และ Smart Display
- อุปกรณ์ที่เปิดใช้ Matter
- อุปกรณ์หรือบอร์ดการพัฒนาที่ถูกแฟลชด้วยบิลด์หรือแอปตัวอย่างที่เปิดใช้ Matter
- อุปกรณ์เคลื่อนที่
- โทรศัพท์ทดสอบที่ใช้เพื่อช่วยในการจับคู่ นี่คือโทรศัพท์ของ Android
สิ่งที่ต้องดำเนินการก่อน
นักพัฒนาซอฟต์แวร์ต้องมีสิ่งต่อไปนี้ จึงจะผสานรวมอุปกรณ์ที่เปิดใช้ Matter เข้ากับระบบนิเวศของ Google Home ได้อย่างสมบูรณ์
- Google Hub ที่รองรับชุดข้อความ ทําหน้าที่เป็นทั้ง Border Router สําหรับอุปกรณ์ที่เปิดใช้ Thread และเป็นเส้นทางการตอบสนองในเครื่องสําหรับการกําหนดเส้นทาง Intent ของสมาร์ทโฮม
- อุปกรณ์เคลื่อนที่ (โทรศัพท์ทดสอบ) ที่มีคุณสมบัติตรงตามข้อกําหนดขั้นต่ํา
- Android O (8.1, API ระดับ 27 หรือใหม่กว่า)
- iOS (v16.5 หรือใหม่กว่า)
- ความสามารถ BLE
- รหัสผู้ให้บริการ (VID) และรหัสผลิตภัณฑ์ (PID) สําหรับอุปกรณ์ที่เปิดใช้ Matter
- อุปกรณ์ที่พร้อมใช้งาน Matter อุปกรณ์นี้ควรเป็นหนึ่งในอุปกรณ์ Matter ประเภทที่ปัจจุบันรองรับในระบบนิเวศของ Google Home และอาจเป็นดังนี้
- ผลิตภัณฑ์ของคุณเองที่มีเฟิร์มแวร์ Matter
- บอร์ดการพัฒนาของแพลตฟอร์มผู้ให้บริการที่รองรับ ซึ่งใช้เป็นอุปกรณ์ที่ใช้ Matter ได้เพื่อการตรวจสอบตั้งแต่ต้นทางถึงปลายทาง แพลตฟอร์มที่รองรับมีดังนี้
ผู้ขาย | แพลตฟอร์ม | คำแนะนำ | การสนับสนุนสําหรับ Thread |
---|---|---|---|
ห้องใต้ดิน Bouffalo | BL602 | คู่มือเริ่มต้นฉบับย่อ | |
BL702 | คู่มือเริ่มต้นฉบับย่อ | ||
เอสเปรสโซ | ESP32 | คู่มือเริ่มต้นฉบับย่อ
การทดสอบ OTA |
|
เซมิคอนดักเตอร์แบบนอร์ดิก | NRF52840 | คู่มือเริ่มต้นฉบับย่อ
การทดสอบ OTA |
|
NXP | ชุดพัฒนาซอฟต์แวร์ IOTZTB-DK006 | คู่มือเริ่มต้นฉบับย่อ | |
Realtek | Ameba D Series | คู่มือเริ่มต้นฉบับย่อ | |
ห้องทดลองซิลิคอน | ชุดเครื่องมือสําหรับการพัฒนา EFR32MG24 | คู่มือเริ่มต้นฉบับย่อ | |
ชุดเครื่องมือเริ่มต้นใช้งานชุดข้อความและ EFR32MG Zigbee | คู่มือเริ่มต้นฉบับย่อ | ||
Telink | TLSR9518 | คู่มือเริ่มต้นฉบับย่อ | |
เครื่องดนตรีเท็กซัส | CC2652R7 KitPad Development Kit | คู่มือเริ่มต้นฉบับย่อ |
รหัสผู้ให้บริการ
โดยค่าเริ่มต้น คุณสามารถใช้ VID ที่ CSA จัดสรรไว้เพื่อการทดสอบได้ เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
หากต้องการใช้ VID เวอร์ชันที่ใช้งานจริงเพื่อให้การผสานรวมได้รับการรับรองและเปิดตัว คุณจะต้องได้รับการยืนยันจาก Google ก่อนเพื่อให้ CSA ออกให้
ควรใช้ VID นี้ในเฟิร์มแวร์ของอุปกรณ์
อุปกรณ์ Matter จะจับคู่ได้เฉพาะในระบบนิเวศของ Google Home ในรหัสผู้ให้บริการและสถานการณ์ของอุปกรณ์บางประเภทเท่านั้น
- ใช้ VID ทดสอบในอุปกรณ์ของผู้บริโภคไม่ได้
- VID เวอร์ชันที่ใช้งานจริงของคุณจะต้องออกโดย CSA Google จะยืนยันว่าคุณเป็นเจ้าของ VID ดังกล่าวก่อนที่คุณจะใช้ใน Google Home Developer Console ในกรณีเช่นนี้ คุณจะสร้างการผสานรวมสําหรับ VID ดังกล่าวได้
- เพื่อการพัฒนาและการทดสอบภาคสนาม ต้องรวมโปรเจ็กต์และการผสานรวมที่มีชุดค่าผสม VID และ PID ที่สอดคล้องกันไว้ในที่สร้างขึ้นในDeveloper Console ผู้ใช้ที่มอบหมายให้อุปกรณ์ต้องเป็นสมาชิกของโครงการ หรืออยู่ในรายชื่อผู้ใช้ทดลองใช้งานภาคสนาม
- ผู้ใช้ทั่วไปจะใช้ผลิตภัณฑ์ได้เมื่อได้รับการรับรองจาก CSA เท่านั้น
ผู้ใช้ประเภทใดกําหนดอุปกรณ์ในระบบนิเวศของ Google Home ได้ | |||
---|---|---|---|
ประเภท VID | การรับรอง VID และสถานะการผสานรวมคอนโซล | เวอร์ชันที่ใช้งานจริง
(ผู้ใช้ทั่วไป) |
การพัฒนา
(นักพัฒนาซอฟต์แวร์ ผู้ใช้ช่วงทดลองใช้ภาคสนาม) |
ทดสอบ | ไม่มีการผสานรวมใน Developer Console (รับรองไม่ได้) | ||
ทดสอบ | มีการผสานรวมอยู่ใน Developer Console (รับรองไม่ได้) | ||
Production | ไม่ได้รับการรับรอง ไม่มีการผสานรวมใน Developer Console | ||
Production | ไม่ได้รับการรับรอง มีอยู่ในDeveloper Console | ||
Production | ผ่านการรับรองใน CSA DCL เนื่องจากไม่มีการผสานรวมอยู่ใน Developer Console | ||
Production | ผ่านการรับรองใน CSA DCL และการผสานรวมอยู่ใน Developer Console |
รหัสผลิตภัณฑ์
อ่านข้อมูลเกี่ยวกับอุปกรณ์ได้จากคลัสเตอร์ข้อมูลพื้นฐาน Matter รหัสผลิตภัณฑ์ที่เข้ารหัสในเฟิร์มแวร์ของอุปกรณ์ต้องตรงกับรหัสผลิตภัณฑ์ของการผสานรวม Matter ใน Developer Console
ฟีเจอร์ที่ไม่รองรับ
คลัสเตอร์ Matter บางรายการยังไม่ได้แสดงต่อผู้ใช้ แต่ระบบอาจใช้คลัสเตอร์เหล่านี้อยู่ ในกรณีส่วนใหญ่ นี่หมายความว่าแอตทริบิวต์ ที่แสดงผ่านคลัสเตอร์เหล่านี้จะไม่แสดงต่อผู้ใช้ปลายทาง
ประเภทคลัสเตอร์ | คลัสเตอร์ |
---|---|
หลัก |
|
การสมัคร |
|
1 ดูสวิตช์เปิด/ปิดไฟ ส่งผลต่อสวิตช์เปิด/ปิดอย่างไร