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

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

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

คำจำกัดความ

คําศัพท์ต่อไปนี้ใช้อยู่ในเอกสารประกอบทั้งหมด

เราเตอร์ขอบ

ฮับที่ใช้เส้นทาง Border Thread อเนกประสงค์สําหรับอุปกรณ์ที่ใช้ Thread ได้

Hub

อุปกรณ์ Google Nest ที่รองรับ เช่น Google Nest Hub (2nd gen) ต้องมีฮับเพื่อควบคุมอุปกรณ์ที่เปิดใช้ Matter ผ่านแพลตฟอร์มอื่นๆ เช่น Assistant, GHA และ Smart Display

อุปกรณ์ที่เปิดใช้ Matter

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

อุปกรณ์เคลื่อนที่

โทรศัพท์ทดสอบที่ใช้เพื่อช่วยในการจับคู่ นี่คือโทรศัพท์ของ Android

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

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

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

ตาราง: สถานการณ์การจับคู่รหัสผู้ให้บริการ (VID) และประเภทอุปกรณ์

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

ตาราง: Matter ระบบไม่แสดงคลัสเตอร์ผู้ใช้ในระบบนิเวศของ Google Home

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

1 ดูสวิตช์เปิด/ปิดไฟ ส่งผลต่อสวิตช์เปิด/ปิดอย่างไร