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

Matter ; Home APIs

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

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

בניגוד למכשיר 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 יציאה: יציאה להפעלה ולתקשורת דרך רשתות IP.Matter ‫Matter משתמש ביציאת TCP/UDP‏ 5540 כברירת מחדל, אבל אפשר להגדיר את המכשיר הווירטואלי כך שישתמש ביציאה אחרת, כל עוד אף שירות אחר לא משתמש בה.
• מזהה ספק: נתמך רק מזהה הספק 0xFFF1 לבדיקה.
• מזהה מוצר: נתמכים רק מזהי מוצרים לבדיקה 0x8000 עד 0x801F.

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

sudo iptables -L -n

sudo ufw disable

sudo ufw enable

הפעלת המכשיר

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

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

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

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

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

‫MS traits נתמכות על ידי ממשקי ה-API של Home ל-Android, ומספקות פונקציונליות נוספת מעבר ל-traits הרגילים ב-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.