เริ่มต้นใช้งาน 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 เท่านั้น

คำจำกัดความ

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

เราเตอร์เส้นขอบ
ฮับที่ใช้Thread Border Router ตามวัตถุประสงค์ทั่วไปสําหรับอุปกรณ์ที่เปิดใช้ Thread
Hub
อุปกรณ์ Google Nest ที่รองรับ เช่น Google Nest Hub (2nd gen) ต้องมีฮับเพื่อควบคุมอุปกรณ์ที่เปิดใช้ Matter ผ่านแพลตฟอร์มอื่นๆ เช่น Assistant, GHA และ Smart Display
อุปกรณ์ที่เปิดใช้ Matter
อุปกรณ์หรือกระดานการพัฒนาที่ใช้ Flash ด้วยแอป Matter ที่สร้างจากบิลด์หรือตัวอย่าง
อุปกรณ์เคลื่อนที่
โทรศัพท์ทดสอบที่ใช้สําหรับความช่วยเหลือในการจับคู่ นี่คือโทรศัพท์ของ Android

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

ส่วนขยาย IDE ที่แนะนําสําหรับการพัฒนา Matter

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

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

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

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

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

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

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