מכשיר וירטואלי בתקן Matter

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

למפתחי אפליקציות ולאחרים שצריכים לבדוק או לדמות מכשיר Matter וירטואלי, אבל אין להם את המשאבים לבנות מכשיר Matter פיזי או וירטואלי משלהם, Google מציעה את Matter Virtual Device (MVD). ‫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

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

הורדת קובץ החתימה (‎.asc) של armored-ASCII

אחר כך מריצים את הפקודה 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

הגדרת המכשיר

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

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

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

sudo iptables -L -n

sudo ufw disable

sudo ufw enable

הפעלת המכשיר

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

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

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

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

תכונות ספציפיות ליצרן

תכונות ספציפיות ליצרן (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 ל-VS Code או פלאגין Google Home ל-Android Studio.

הצגת פרטי המכשיר

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

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

צפייה בקובצי היומן במכשיר

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

עצירת המכשיר

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

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

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

עזרה

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

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

דיווח על באג

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

שליחת משוב

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

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

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

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