เริ่มต้นใช้งาน Matter

รุ่นตัวอย่างสําหรับนักพัฒนาซอฟต์แวร์

โปรแกรม Home ของ Google ช่วยให้ผู้ผลิตอุปกรณ์เชื่อมต่ออุปกรณ์ในบ้านอัจฉริยะกับระบบนิเวศของ Google Home ได้ เรากําลังขยายเส้นทางการดําเนินการตามคําสั่งซื้อในท้องถิ่นของ Smart Home โดยเพิ่มอุปกรณ์ที่เปิดใช้ Matter สําหรับการตั้งค่าได้โดยใช้ Google Home app (GHA) ใน Android และควบคุมโดยใช้ 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 จะระบุไว้ในกระบวนการตามที่จําเป็น
• รองรับเฉพาะ GHA เวอร์ชัน Android เท่านั้น

คำจำกัดความ

ข้อกําหนดต่อไปนี้ใช้ในเอกสารฉบับนี้ทั้งหมด

• ฮับ — อุปกรณ์ Google Nest ที่รองรับ เช่น Google Nest Hub (2nd gen) ต้องใช้ฮับเพื่อควบคุมอุปกรณ์ที่เปิดใช้ Matter ผ่าน GHA

• เราเตอร์ Thread — Google Hub ที่ใช้เราเตอร์ Border Border ทั่วไปสําหรับอุปกรณ์ที่เปิดใช้ชุดข้อความ

• อุปกรณ์ที่เปิดใช้ Matter — อุปกรณ์หรือนักพัฒนาการพัฒนาที่ได้รับการแฟลชด้วยบิลด์หรือแอปตัวอย่างที่เปิดใช้ Matter

• อุปกรณ์เคลื่อนที่ — โทรศัพท์ทดสอบที่ใช้เพื่อช่วยในการจับคู่ ปัจจุบันเป็นโทรศัพท์ Android

สิ่งที่ต้องดำเนินการก่อน

หากต้องการผสานรวมอุปกรณ์ที่เปิดใช้ Matter กับระบบนิเวศของ Google Home อย่างสมบูรณ์ นักพัฒนาแอปต้องมีสิ่งต่อไปนี้

1. Nest Hub (2nd gen) ทําหน้าที่เป็นทั้ง Border Router สําหรับอุปกรณ์ที่เปิดใช้ชุดข้อความ และเป็นเส้นทางการตอบสนองในเครื่องสําหรับ Intent ของ Smart Home
2. อุปกรณ์เคลื่อนที่ (โทรศัพท์ทดสอบ) ที่เป็นไปตามข้อกําหนดขั้นต่ํา
   • Android O (8.1, API ระดับ 27) ขึ้นไป (รองรับ iOS ในภายหลัง)
   • ความสามารถ BLE
3. รหัสผู้ให้บริการ (VID) และรหัสผลิตภัณฑ์ (PID) สําหรับอุปกรณ์ที่เปิดใช้ Matter
4. อุปกรณ์ที่พร้อมใช้งาน Matter อุปกรณ์นี้ควรเป็นหนึ่งในอุปกรณ์ Matter ประเภทที่ระบบนิเวศของ Google Home รองรับในปัจจุบัน และอาจมีลักษณะดังนี้
   • ผลิตภัณฑ์ของคุณเองที่มีเฟิร์มแวร์ Matter ที่เปิดใช้
   • กระดานการพัฒนาของแพลตฟอร์มผู้ให้บริการที่รองรับซึ่งทําหน้าที่เป็นอุปกรณ์ ที่เปิดใช้ Matter สําหรับการยืนยันจากต้นทางถึงปลายทาง แพลตฟอร์มที่รองรับมีดังนี้

ตาราง: Matter ตัวอย่างจากผู้ให้บริการซิลิโคน

ผู้ขาย	แพลตฟอร์ม	คำแนะนำ	การสนับสนุนสําหรับ Thread
ห้องทดลองบุฟเฟต์	BL602	คู่มือเริ่มต้นฉบับย่อ
แก้วกาแฟ	ESP32	คู่มือเริ่มต้นฉบับย่อ
เซมิคอนดักเตอร์นอร์ดิก	nRF52840 DK	คู่มือเริ่มต้นฉบับย่อ
NXP	ชุดพัฒนาซอฟต์แวร์ IOTZTB-DK006	คู่มือเริ่มต้นฉบับย่อ
Realtek	Ameba D Series	คู่มือเริ่มต้นฉบับย่อ
ห้องทดลองซิลิคอน	EFR32MG Zigbee และ Thread Starter Kit	คู่มือเริ่มต้นฉบับย่อ

รหัสผู้ให้บริการ

ใช้รหัสผู้ให้บริการ (VID) ตามข้อกําหนดของ CSA Matter หากไม่มี VID ที่ได้รับมอบหมาย ให้ใช้ VID รายการหนึ่งจาก CSA เพื่อวัตถุประสงค์ในการทดสอบ ซึ่งได้แก่ 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4

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

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

ระบบจะอ่านข้อมูลอุปกรณ์โดยใช้คลัสเตอร์ Matter Descriptor ไม่ใช่รหัสผลิตภัณฑ์ คุณอาจกําหนดรหัสผลิตภัณฑ์ระหว่างการพัฒนาก็ได้ ตามรูปแบบการกําหนดหมายเลขของบริษัท ตราบใดที่ตรงกับรหัสผลิตภัณฑ์ของการผสานรวม Matter (หากระบุ)

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

ฟีเจอร์บางอย่างของข้อกําหนด Matter ยังไม่รองรับในระบบนิเวศของ Google Home อย่างสมบูรณ์

• ไม่รองรับการอัปเดต OTA สําหรับเฟิร์มแวร์

นอกจากนี้ คลัสเตอร์ Matter อื่นๆ จํานวนมากยังไม่แสดงให้ผู้ใช้เห็น แม้ว่าระบบอาจมีการใช้งานก็ตาม ในกรณีส่วนใหญ่ ผู้ใช้ปลายทางจะไม่เห็นแอตทริบิวต์ที่เปิดเผยผ่านคลัสเตอร์เหล่านี้

ตาราง: Matter ผู้ใช้ที่คุณไม่เห็นในระบบนิเวศของ Google Home

ประเภทคลัสเตอร์	คลัสเตอร์
หลัก	การเชื่อมโยง ป้ายกำกับ ป้ายกํากับแบบคงที่ ป้ายกํากับของผู้ใช้ การดำเนินการ คีย์กลุ่ม การกําหนดค่าการแปล การแปลรูปแบบเวลา การแปลหน่วย การกําหนดค่าแหล่งจ่ายไฟ แหล่งพลังงาน คลัสเตอร์การวินิจฉัย (บันทึกการวินิจฉัย การวินิจฉัยทั่วไป การวินิจฉัยซอฟต์แวร์ การวินิจฉัยเครือข่ายเทรด การวินิจฉัยเครือข่าย Wi-Fi การวินิจฉัยเครือข่ายอีเทอร์เน็ต) การซิงค์เวลา เลือกโหมด
การสมัคร	ไม่รองรับกลุ่มและฉากโดยตรง ฟังก์ชันที่เทียบเท่ากันพร้อมใช้งานผ่านกิจวัตร คลัสเตอร์สื่อทั้งหมด ฟังก์ชันที่เทียบเท่าพร้อมใช้งานผ่าน Google Cast