อุปกรณ์เสมือนจริงกรณี

Matter Device SDK

Matterอุปกรณ์เสมือนมีประโยชน์สําหรับการพัฒนาและทดสอบโซลูชัน Matter และสามารถจัดเตรียมใช้งานโดยใช้ Google Home app (GHA) รวมถึงควบคุมโดยใช้ GHA และ Google Assistant ได้ เช่นเดียวกับMatterอุปกรณ์จริง

สำหรับนักพัฒนาแอปและคนอื่นๆ ที่ต้องการทดสอบหรือจําลองอุปกรณ์ Matterเสมือนจริง แต่ไม่มีทรัพยากรในการสร้างอุปกรณ์ Matterจริงหรือเสมือนจริงของตนเอง Google มี Matter Virtual Device (MVD) ให้ MVD เป็นเครื่องมือเดสก์ท็อป Linux หรือ macOS แบบสแตนด์อโลนที่มีน้ำหนักเบา ซึ่งจำลองอุปกรณ์ Matter เสมือนจริงประเภทต่างๆ และมีอินเทอร์เฟซผู้ใช้แบบกราฟิกเพื่อควบคุมและแสดงสถานะของอุปกรณ์ Matter เสมือนจริง

MVD ไม่ได้ใช้บลูทูธพลังงานต่ำ (BLE) หรือ Thread® เพื่อเข้าร่วมเครือข่าย Matter ต่างจากอุปกรณ์ Matter จริง แต่จะใช้การเชื่อมต่อเครือข่าย Wi-Fi ที่มีอยู่ของเครื่องโฮสต์ซึ่งใช้ Linux หรือ macOS แทน

เมื่อเทียบกับเครื่องมืออื่นๆ

MVD แตกต่างจาก Virtual Device Controller (VDC) ตรงที่เป็นโซลูชันแบบสแตนด์อโลน ซึ่งรวมอุปกรณ์เสมือนเข้ากับ UI สำหรับการควบคุม ในทางตรงกันข้าม VDC ใช้เพื่อควบคุมอุปกรณ์ Matter เสมือนแยกต่างหาก เช่น อุปกรณ์ที่เราสร้างใน Matter Virtual Device Development Environment (MVD-DE)

คุณอาจเคยทํางานกับ MVD-DE codelab อยู่แล้ว ใน Codelab นี้ คุณจะได้สร้างอุปกรณ์เสมือนประเภทเดียว ซึ่งเป็นหลอดไฟอัจฉริยะ ในทางตรงกันข้าม MVD มีอุปกรณ์เสมือนจริงที่สร้างขึ้นล่วงหน้าหลายแบบและมี UI แบบรวมเพื่อเรียกใช้และควบคุมอุปกรณ์เสมือนจริงเหล่านั้น

อุปกรณ์ที่รองรับ

MVD รองรับMatterประเภทอุปกรณ์ต่อไปนี้

ติดตั้ง MVD

MVD ทำงานบนเครื่องที่ใช้โปรเซสเซอร์ x86 64 บิตที่ใช้ Debian (11 ขึ้นไป), Ubuntu (20.04 ขึ้นไป) หรือ macOS

Linux

ดาวน์โหลดแพ็กเกจ MVD Debian (.deb)

ดาวน์โหลดไฟล์ลายเซ็น ASCII ที่เข้ารหัส (.asc)

จากนั้นเรียกใช้ dpkg เพื่อติดตั้งแพ็กเกจ MVD Debian (.deb)

sudo dpkg -i mvd_1.5.0_amd64.deb

macOS

ดาวน์โหลดไฟล์ DMG ของ MVD (macOS x86)

ดาวน์โหลดไฟล์ dmg ของ MVD (ARM64 M1)

จากนั้นดับเบิลคลิกไฟล์ dmg เพื่อเปิดหน้าต่างการติดตั้ง

เลือกและลากไอคอน mvd ไปยังโฟลเดอร์ Applications เพื่อติดตั้งให้เสร็จสมบูรณ์

ตรวจสอบการใช้งานพอร์ต

โมดูลตัวควบคุมใน MVD ใช้พอร์ต TCP 33000 เพื่อเรียก RPC ไปยังอุปกรณ์เสมือน ดังนั้นหากมีการใช้พอร์ตนี้โดยกระบวนการอื่นในคอมพิวเตอร์อยู่แล้ว โปรดตรวจสอบว่าได้ปล่อยพอร์ตนี้ให้ว่าง

วิธีดูว่ามีกระบวนการใดใช้พอร์ต 33000 อยู่หรือไม่

sudo fuser -v 33000/tcp

lsof -i:33000

คุณยกเลิกกระบวนการใดก็ได้ที่ใช้พอร์ต TCP 33000 ด้วยคำสั่งเดียว ดังนี้

sudo fuser -k 33000/tcp

lsof -ti:33000 | xargs kill

เรียกใช้ MVD

mvd

cd /Applications
open mvd.app

กำหนดค่าอุปกรณ์

หน้าจอหลักจะปรากฏขึ้นเมื่อเปิดใช้งานและให้คุณกำหนดค่าอุปกรณ์เสมือนได้ ดังนี้

• ประเภทอุปกรณ์: เลือกประเภทอุปกรณ์ (เช่น หลอดไฟ สวิตช์ เซ็นเซอร์ และอื่นๆ)
• ชื่ออุปกรณ์: ตั้งชื่ออุปกรณ์ให้ใช้งานง่าย
• ตัวแยก: ตัวเลข 12 บิตที่ใช้แยกความแตกต่างระหว่างโฆษณาอุปกรณ์หลายรายการที่มีสิทธิ์ได้รับค่าคอมมิชชัน (ค่าเริ่มต้น: 3840)
• พอร์ต Matter: พอร์ตสำหรับการจัดเตรียมMatterและการสื่อสารผ่านเครือข่าย IP Matter ใช้พอร์ต TCP/UDP 5540 โดยค่าเริ่มต้น แต่คุณกำหนดค่าอุปกรณ์เสมือนให้ใช้พอร์ตอื่นได้ ตราบใดที่ไม่มีบริการอื่นใช้พอร์ตนั้นอยู่
• รหัสผู้ให้บริการ: ระบบรองรับเฉพาะรหัสผู้ให้บริการทดสอบ 0xFFF1
• รหัสผลิตภัณฑ์: ระบบรองรับเฉพาะรหัสผลิตภัณฑ์ทดสอบ 0x8000 ถึง 0x801F

กำหนดค่าไฟร์วอลล์

sudo iptables -L -n

sudo ufw disable

sudo ufw enable

เรียกใช้อุปกรณ์

หลังจากกำหนดค่าอุปกรณ์แล้ว ให้คลิกสร้างอุปกรณ์ เมื่อสร้างอุปกรณ์แล้ว หน้าจอตัวควบคุมจะปรากฏขึ้น คุณอาจเห็นตัวควบคุมอย่างน้อย 1 รายการต่อไปนี้ ทั้งนี้ขึ้นอยู่กับประเภทอุปกรณ์ที่เลือก

• เปิด/ปิด: พบได้ทั่วไปในอุปกรณ์ส่วนใหญ่
• ระดับ: เช่น หลอดไฟอาจมีแถบเลื่อนระดับเพื่อปรับความสว่าง
• สี: เช่น หลอดไฟสีอาจมีการควบคุมนี้
• การมีคนอยู่: เซ็นเซอร์ตรวจจับการมีคนอยู่มีการควบคุมนี้เพื่อจำลองสถานะมีคนอยู่หรือไม่มีคนอยู่

อุปกรณ์เสมือนทั้งหมดจะมีการควบคุมต่อไปนี้

• QRCode: แสดงคิวอาร์โค้ดที่ใช้สำหรับการจัดเตรียม
• รีบูต: รีสตาร์ทอุปกรณ์เสมือน อุปกรณ์ถูกตัดการเชื่อมต่อจากเครือข่ายชั่วคราว
• รีเซ็ต: รีเซ็ตอุปกรณ์ปัจจุบันเป็นค่าเริ่มต้นและล้างสถานะทั้งหมด ซึ่งรวมถึงการจัดเตรียม สถานะการควบคุมปัจจุบัน และอื่นๆ
• ลบ: ทำลายอุปกรณ์และกลับไปที่หน้าจอสร้างอุปกรณ์

เตรียมอุปกรณ์ให้พร้อมใช้งาน

อุปกรณ์จะเรียกเก็บค่าคอมมิชชันได้ทันทีที่สร้าง

ข้อกําหนดเบื้องต้นในการเตรียมอุปกรณ์มีดังนี้

• คุณต้องมีโปรเจ็กต์ใน Google Home Developer Console โปรเจ็กต์นี้ต้องมีMatterการผสานรวมที่มีชุดค่าผสม VID/PID เดียวกันกับที่คุณใช้ตั้งค่าอุปกรณ์เสมือน ดูรายละเอียดได้จากคู่มือการสร้างโปรเจ็กต์

• คุณต้องมี Google Nest Hub ที่รองรับ Matter

• คุณต้องมีโทรศัพท์ Android ที่ใช้ Android 8.1 ขึ้นไปซึ่งติดตั้ง GHA

• โทรศัพท์ Android ต้องเชื่อมต่อกับเครือข่าย Wi-Fi เดียวกับฮับ

• เครื่องโฮสต์ต้องเชื่อมต่อกับเครือข่าย Wi-Fi

หากต้องการจัดเตรียมอุปกรณ์โดยใช้ GHA ให้คลิก QRCode เพื่อแสดงคิวอาร์โค้ดของอุปกรณ์ จากนั้นทำตามวิธีการในหัวข้อจับคู่อุปกรณ์ Matter ซึ่งอธิบายวิธีเริ่มต้นใช้งานอุปกรณ์ Matter โดยใช้ GHA นอกจากนี้ คุณยังจัดเตรียมอุปกรณ์โดยใช้ Google Home Sample App for Matter ได้ด้วย

ดูMatter ข้อมูลเบื้องต้นเพื่อศึกษาวิธีการทำงานของMatterการจัดเตรียม

ควบคุมอุปกรณ์

หลังจากจัดเตรียมอุปกรณ์เสมือนแล้ว คุณจะควบคุมอุปกรณ์ได้โดยใช้แอป Google Home หรือ Google Assistant ด้วยเสียง เลือกดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้

• ควบคุมอุปกรณ์ผ่าน GHA หรือ Assistant ขณะตรวจสอบการเปลี่ยนแปลงสถานะในอุปกรณ์เสมือน หรือ
• ควบคุมอุปกรณ์โดยใช้ Sample App for Matter ขณะตรวจสอบการเปลี่ยนแปลงสถานะในอุปกรณ์เสมือน หรือ
• ควบคุมสถานะของอุปกรณ์ผ่าน MVD โดยตรงขณะที่ตรวจสอบการเปลี่ยนแปลงสถานะใน GHA หรือ Assistant

ทดสอบกับอุปกรณ์

หากต้องการทดสอบกับ Assistant เราขอแนะนำให้ใช้เครื่องจำลองคําพูด เช่น ส่วนขยาย Google Home สําหรับ VS Code หรือปลั๊กอิน Google Home สําหรับ Android Studio

ดูรายละเอียดอุปกรณ์

หน้าจอรายละเอียดอุปกรณ์จะแสดงข้อมูลอุปกรณ์โดยละเอียด ดังนี้

• ชื่อ: ชื่อที่แสดงสำหรับอุปกรณ์
• ประเภทอุปกรณ์: ประเภทอุปกรณ์ที่เลือก
• ตัวแบ่ง: ตัวแบ่งอุปกรณ์ปัจจุบัน
• รหัสผู้ให้บริการ: รหัสผู้ให้บริการอุปกรณ์ปัจจุบัน
• รหัสผลิตภัณฑ์: รหัสผลิตภัณฑ์ของอุปกรณ์ปัจจุบัน
• พอร์ต RPC: พอร์ต RPC ที่อุปกรณ์ใช้สื่อสารกับตัวควบคุม (GUI)
• พอร์ต Matter: พอร์ตที่อุปกรณ์ปัจจุบันใช้เพื่อสื่อสารผ่านเครือข่าย IP
• รหัสผ่าน: PIN ที่ใช้เพื่อจัดเตรียมอุปกรณ์ผ่านเครือข่าย
• โฟลเดอร์การกําหนดค่า: โฟลเดอร์ที่อุปกรณ์เสมือนใช้จัดเก็บการกําหนดค่า
• ข้อมูลค่าคอมมิชชัน: แสดง Fabric ที่อุปกรณ์เข้าร่วมและรหัสโหนดของอุปกรณ์ใน Fabric

ดูบันทึกของอุปกรณ์

หากคุณเปิด MVD จากเทอร์มินัล เอาต์พุตบันทึกจะปรากฏใน stdout นอกจากนี้ คุณยังดูบันทึกของอุปกรณ์ในแท็บบันทึกของอุปกรณ์ได้ด้วย

หยุดอุปกรณ์

หากต้องการหยุดและทำลายอุปกรณ์ ให้คลิกลบ

สิ้นสุดการทำงานของแอป

การปิดหน้าต่างการควบคุมจะทำลายอุปกรณ์และสิ้นสุดแอปพลิเคชัน MVD หากเปิดจากเทอร์มินัล คุณสามารถสิ้นสุดการทำงานของแอปพลิเคชันได้โดยพิมพ์ Ctrl-C ในเทอร์มินัล

รับความช่วยเหลือ

หากต้องการความช่วยเหลือเกี่ยวกับ MVD, รายงานข้อบกพร่อง หรือขอฟีเจอร์ใหม่ โปรดติดต่อตัวแทนทีมสนับสนุนของ Google

การคลิกปุ่มความช่วยเหลือ help ที่มุมขวาบนของหน้าต่างจะนำคุณไปยังหน้านี้

รายงานข้อบกพร่อง

หากคิดว่าพบข้อบกพร่องใน MVD คุณสามารถรายงานข้อบกพร่องได้โดยคลิกปุ่มปัญหา sms_failed ที่มุมขวาบนของหน้าต่าง

ส่งความคิดเห็น

หากต้องการส่งความคิดเห็นเกี่ยวกับสิ่งที่คุณชอบเกี่ยวกับ MVD หรือวิธีที่เราปรับปรุงประสบการณ์การใช้งานเครื่องมือของคุณได้ โปรดกรอกแบบฟอร์มความคิดเห็น

คุณเปิดแบบฟอร์มได้จากปุ่มความคิดเห็น sentiment_satisfied ที่มุมขวาบนของหน้าต่าง หรือคลิกปุ่มด้านล่าง

ส่งความคิดเห็นถึงเรา