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

Device SDK

Matter Virtual Device Development Environment (MVD-DE) הוא קונטיינר של Docker שבו אפשר ליצור Matter Virtual Device (MVD) ולהשתמש באפליקציית Virtual Device Controller (VDC) למחשב כדי לספק ממשק משתמש גרפי לצורך בקרה ותצוגה של המצבים של מכשירי Matter הווירטואליים. האפליקציה מספקת ייצוג חזותי של המכשיר הווירטואלי, וגם את אמצעי הבקרה של אשכולות Matter שנתמכים במכשיר.

האפליקציה משתמשת בלקוח RPC כדי לתקשר עם שרת ה-RPC של המכשיר הווירטואלי, שולחת בקשות שמשקפות את הפעולות שלכם (הפעלה/השבתה, עמעום, הבהרה) ומבצעת סקרים פעם בשנייה כדי לאחזר את המצב.

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

בשלב זה, MVD-DE תומך בסוגים הבאים של מכשירי Matter:

Matter סוג המכשיר אשכולות של אפליקציות סוג סביבת הבית החכמה
חיישן מגע מצב בוליאני Sensor
תאורה עם אפשרות עמעום הפעלה/השבתה
בקרת עוצמה
קל
Extended Color Light הפעלה/השבתה
בקרת עוצמה
בקרת צבע
קל
חיישן זרימה מדידת זרימה Sensor
חיישן לחות מדידת לחות יחסית Sensor
חיישן תאורה מדידת תאורה Sensor
חיישן נוכחות חישת תפוסה Sensor
תאורת הפעלה/השבתה הפעלה/השבתה קל
שקע חשמלי הפעלה/השבתה
בקרת עוצמה
Outlet
חיישן לחץ מדידת לחץ Sensor
רמקול הפעלה/השבתה
בקרת עוצמה
רמקול
החלפה הפעלה/השבתה החלפה
חיישן טמפרטורה מדידת טמפרטורה Sensor

הגדרת סביבת הפיתוח של מכשיר וירטואלי ב-Matter

MVD-DE היא תמונת Docker מוגדרת מראש שזמינה ב-Docker Hub. כדי להתקין אותו, מריצים את הפקודה:

user@host> docker pull us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest

הפעולה הזו עשויה להימשך כמה דקות.

הפעלת סביבת הפיתוח של מכשיר וירטואלי של Matter

  1. מפעילים את קונטיינר Docker:

    user@host> xhost local:1000
    user@host> docker run -it --ipc=host --net=host -e DISPLAY --name matter-container us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest
    

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

    Environment looks good, you are ready to go!
    
  2. יוצרים מופע שני של סשן מסוף:

    user@host> docker exec -it matter-container /bin/bash
    
  3. במכשיר Matter וירטואלי, אחרי שהמכשיר פועל, מפעילים את VDC ומעבירים לו את הארגומנט --s ואת יציאת ה-IP שבה המכשיר משתמש:

    $ electron main.js --s=localhost:33000
    

    במכשיר פיזי, מפעילים את VDC ומעבירים לו את הארגומנט --d ואחריו את היציאה הטורית של המכשיר:

    $ electron main.js --d=/dev/ttyUSB0
    

אם תפעילו את VDC בלי לספק ארגומנטים, כברירת מחדל יופעל יציאת ה-socket של הרשת באמצעות יציאת ה-localhost‏ 33000.

אחרי שהמכשיר VDC יצליח להתחבר למכשיר שלכם, יוצג בו מסך עם סטטוס המכשיר:

ממשק משתמש גרפי של מכשיר וירטואלי

הצגת קוד ה-QR של המכשיר

אפשר להשתמש ב-VDC גם כדי לאחזר את קוד ה-QR כחלק מתהליך ההפעלה של המכשיר. לוחצים על סמל קוד ה-QR לצד התמונה של המכשיר כדי להציג את קוד ה-QR של המכשיר הזה:

בקר מכשיר וירטואלי שמוצג בו קוד ה-QR של המכשיר

אפשר להשתמש בקוד ה-QR הזה כדי להפעיל את המכשיר.

הפסקת סביבת הפיתוח של מכשיר וירטואלי של Matter

כדי להפסיק את MVD-DE, לוחצים על Control-Q כשהמסך של VDC נמצא בחזית, או על Control-C בסשן מסוף שבו הפעלתם את האפליקציה.

משוב

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

שליחת משוב