מכשיר וירטואלי חשוב

Matter ; Home APIs

Matter מכשירים וירטואליים שימושיים לפיתוח ולבדיקה של פתרונות, ואפשר להפעיל אותם באמצעות Google Home app (GHA) ולשלוט בהם באמצעות GHA ו-Google Assistant, בדיוק כמו במכשירי Matter פיזיים.Matter

מפתחי אפליקציות ואנשים אחרים שצריכים לבדוק או לחקות מכשיר וירטואלי, אבל אין להם את המשאבים לבניית מכשיר פיזי או וירטואלי משלהם, יכולים להשתמש ב-Matter. ‏MVD הוא כלי קל משקל עצמאי למחשבים עם Linux או macOS, שמדמה סוגים שונים של מכשירים וירטואליים ומספק ממשק משתמש גרפי לשליטה במצבים של המכשיר הווירטואלי ולהצגתם.MatterMatterMatterMatter Virtual Device (MVD)

בניגוד למכשיר Matter פיזי, MVD לא מסתמך על Bluetooth® Low Energy (BLE) או על Thread®‎ כדי להצטרף לרשת Matter. במקום זאת, הוא משתמש בחיבור הקיים לרשת Wi-Fi של המחשב המארח עם Linux או macOS לצורך הקצאת הרשאות.

בהשוואה לכלים אחרים

הפתרון MVD שונה מVirtual Device Controller (VDC) בכך שהוא פתרון עצמאי שמשלב מכשיר וירטואלי עם ממשק משתמש לשליטה בו. לעומת זאת, האפליקציה VDC משמשת לשליטה במכשיר וירטואלי נפרד Matter.

השדה MVD מכיל כמה מכשירים וירטואליים שנוצרו מראש, וכולל ממשק משתמש משולב להפעלה ולשליטה בהם.

מכשירים נתמכים

MVD תומך בסוגי המכשירים הבאים: Matter

התקנת MVD

אפשר להריץ את MVD במכונות עם מעבד x86 בגרסת 64 ביט שפועלות ב-Debian (מגרסה 13 Trixie ואילך), ב-Ubuntu (מגרסה 20.04 Noble Numbat ואילך) או ב-macOS.

Linux

הורדת חבילת MVD Debian ‏ (.deb)

הורדת קובץ החתימה בפורמט ASCII משוריין (‎.asc)

ואז מריצים את הפקודה dpkg כדי להתקין את חבילת Debian ‏(‎.deb):MVD

sudo dpkg -i mvd_1.7.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

הגדרת המכשיר

המסך הראשי מופיע כשמפעילים את התוכנה, ומאפשר להגדיר מכשיר וירטואלי:

• סוג המכשיר: בוחרים את סוג המכשיר (לדוגמה, Light, ‏ Switch, ‏ Sensor וכו').
• שם המכשיר: נותנים למכשיר שם ידידותי למשתמש.
• דיסקרימינטור: מספר בן 12 ביט שמשמש להבחנה בין כמה מודעות של מכשירים שניתן לקבל עמלה על מכירתם. (ברירת מחדל: 3840).
• Matter יציאה: יציאה לMatter הפעלה ותקשורת דרך רשתות IP. פרוטוקול Matter משתמש ביציאת TCP/UDP 5540 כברירת מחדל, אבל אפשר להגדיר את המכשיר הווירטואלי לשימוש ביציאה אחרת, כל עוד אף שירות אחר לא משתמש בה.
• מזהה ספק: נתמך רק מזהה הספק 0xFFF1 לצורך בדיקה.
• מזהה מוצר: נתמכים רק מזהי מוצרים לבדיקה 0x8000 עד 0x801F.

הגדרת חומת האש

sudo iptables -L -n

sudo ufw disable

sudo ufw enable

הפעלת המכשיר

אחרי שמגדירים את המכשיר, לוחצים על יצירת מכשיר. כשיוצרים את המכשיר, מופיע המסך Controller (בקר). בהתאם לסוג המכשיר שבחרתם, יכול להיות שיוצגו לכם אחד או יותר מהאמצעים הבאים לשליטה:

• הפעלה/השבתה: משותף לרוב המכשירים.
• רמה: לדוגמה, לנורה יכול להיות פס הזזה לרמה כדי לכוון את הבהירות.
• צבע: לדוגמה, אפשר לשלוט בצבע של נורת תאורה.
• תפוסה: חיישן התפוסה מציע את האפשרות הזו כדי לדמות את המצב של חדר תפוס או לא תפוס.

לכל המכשירים הווירטואליים יש את אמצעי הבקרה הבאים:

• QRCode: הצגת קוד ה-QR שמשמש להקצאת הרשאות.
• הפעלה מחדש: מפעילה מחדש את המכשיר הווירטואלי. המכשיר מנותק מהרשת לזמן קצר.
• איפוס: איפוס המכשיר להגדרות המקוריות ומחיקת כל הנתונים, כולל ההפעלה, הסטטוס הנוכחי של אמצעי הבקרה וכו'.
• מחיקה: המכשיר נמחק ומוחזר למסך יצירת מכשיר.

מאפיינים ספציפיים ליצרן

מאפיינים ספציפיים ליצרן (MS) נתמכים על ידי ממשקי ה-API של Home ל-Android ומספקים פונקציונליות נוספת מעבר למאפיינים הרגילים ב-Matter. כדי לבדוק מכשיר עם תכונת MS, אפשר להשתמש ב-MVD כדי ליצור אינטראקציה עם התכונות בקטע שנקרא Custom Clusters (אשכולים מותאמים אישית) (ראו תמונה למעלה).

חיבור המכשיר

אפשר להגדיר את המכשיר ככזה שמזכה אתכם בעמלה מיד אחרי שהוא נוצר.

יש כמה דרישות מקדימות להפעלת המכשיר:

• צריך שיהיה לכם פרויקט ב-Google Home Developer Console. הפרויקט הזה צריך לכלול שילוב של Matter עם אותו שילוב של VID/PID שבו השתמשתם בהגדרת המכשיר הווירטואלי. פרטים נוספים זמינים במדריך ליצירת פרויקטים.

• צריך מכשיר Google Nest Hub שתומך ב-Matter

• צריך טלפון Android עם Android מגרסה 8.1 ואילך, שמותקנת בו GHA.

• טלפון Android צריך להיות מחובר לאותה רשת Wi-Fi שאליה מחוברת הרכזת.

• המחשב המארח צריך להיות מחובר לרשת ה-Wi-Fi.

כדי להפעיל את המכשיר באמצעות GHA, לוחצים על QRCode כדי להציג את קוד ה-QR של המכשיר, ואז פועלים לפי ההוראות במאמר צימוד מכשיר 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 Extension for VS Code או Google Home Plugin for Android Studio.

צפייה בפרטי המכשיר

במסך פרטי המכשיר מוצג מידע מפורט על המכשיר:

• שם: השם הידידותי שניתן למכשיר.
• סוג מכשיר: סוג המכשיר שנבחר.
• דיסקרימינטור: הדיסקרימינטור של המכשיר הנוכחי.
• ‫Vendor ID (מזהה הספק): מזהה הספק הנוכחי של המכשיר.
• מזהה המוצר: מזהה המוצר הנוכחי של המכשיר.
• יציאה בתקן RPC: היציאה בתקן RPC שדרכה המכשיר מתקשר עם הבקרים (ממשק משתמש גרפי).
• Matter יציאה: היציאה שבה המכשיר הנוכחי משתמש כדי לתקשר דרך רשת IP.
• קוד כניסה: קוד האימות שמשמש להפעלת המכשיר דרך הרשת.
• תיקיית ההגדרות: התיקייה שבה המכשיר הווירטואלי שומר את ההגדרות.
• פרטי העמלה: מציגים את הרשתות שאליהן המכשיר הצטרף ואת מזהה הצומת של המכשיר ברשת.

צפייה ביומנים של מכשירים

אם הפעלתם את MVD מהטרמינל, פלט היומן מופיע ב-stdout. אפשר גם לראות את יומני המכשיר בכרטיסייה יומני מכשיר.

הפסקת השימוש במכשיר

כדי לעצור ולהשמיד את המכשיר, לוחצים על מחיקה.

סגירת האפליקציה

סגירת חלון הבקרה משביתה את המכשיר ומסיימת את הפעולה של אפליקציית MVD. אם הפעלתם את האפליקציה מהטרמינל, תוכלו גם להקליד Ctrl-C בטרמינל כדי לסיים את הפעולה של האפליקציה.

עזרה

כדי לקבל עזרה בנושא MVD, לדווח על באג או לבקש תכונה חדשה, אפשר לפנות לאיש הקשר לתמיכה של Google.

בלחיצה על לחצן העזרה help בפינה השמאלית העליונה של החלון תועברו לדף הזה.

דיווח על באג

אם לדעתכם מצאתם פגם ב-MVD, אתם יכולים לדווח על באג בלחיצה על הלחצן 'בעיה' sms_failed בפינה השמאלית העליונה של החלון.

שליחת משוב

כדי לשלוח לנו את דעתכם על מה שאהבתם ב-MVD או על הצעות לשיפור חוויית השימוש בכלי, אתם יכולים למלא את טופס המשוב שלנו.

אפשר לפתוח את הטופס באמצעות לחצן המשוב sentiment_satisfied בפינה השמאלית העליונה של החלון, או באמצעות לחיצה על הלחצן שלמטה.

נשמח לקבל ממך משוב

אפשר גם לשלוח משוב באמצעות הסקר שמופיע בחלק התחתון כשמשתמשים ב-MVD.