بيئة تطوير الأجهزة الافتراضية (Matter)

حزمة تطوير البرامج (SDK) للأجهزة

‫Matter Virtual Device Development Environment (MVD-DE) هي حاوية Docker يمكنك من خلالها إنشاء Matter Virtual Device (MVD) واستخدام تطبيق Virtual Device Controller (VDC) لسطح المكتب لتوفير واجهة مستخدم رسومية للتحكّم في حالات أجهزة Matter الافتراضية وعرضها. يقدّم التطبيق تمثيلاً مرئيًا لجهازك الظاهري، بالإضافة إلى عناصر التحكّم في مجموعات Matter المتوافقة مع الجهاز.

يستخدم التطبيق برنامج RPC client للتواصل مع خادم RPC الخاص بالجهاز الافتراضي، ويُرسِل طلبات تعكس أفعالك (تبديل الطاقة، وخفت الإضاءة، وزيادة الإضاءة) ويُجري عمليات استطلاع مرة كل ثانية لاسترداد الحالة.

الأجهزة المتوافقة

تتيح MVD-DE حاليًا استخدام Matter أنواع الأجهزة التالية:

إعداد بيئة تطوير الأجهزة الافتراضية في 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
   

   بعد بدء الحاوية، من المفترض أن يظهر لك بعض النتائج التشخيصية يليها رسالة تؤكّد صحة إعدادات الحاوية، ثم أخيرًا، طلب shell للحاوية:

   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 بدون تقديم أيّ وسيطات، سيتم ضبطه تلقائيًا على خيار مقبس الشبكة باستخدام المنفذ 33000 على المضيف المحلي.

بعد أن يتمكّن جهاز VDC من الاتصال بجهازك، سيقوم بعرض شاشة تعرض حالة جهازك:

عرض رمز الاستجابة السريعة للجهاز

يمكن أيضًا استخدام VDC لاسترداد رمز الاستجابة السريعة كجزء من عملية تنشيط الجهاز. انقر على رمز رمز الاستجابة السريعة بجانب صورة الجهاز لعرض رمز الاستجابة السريعة لهذا الجهاز:

يمكنك استخدام رمز الاستجابة السريعة هذا لتفعيل جهازك.

إيقاف بيئة تطوير الأجهزة الافتراضية في Matter

لإيقاف MVD-DE، اضغط على Ctrl-Q مع التركيز على شاشة VDC، أو اضغط على Ctrl-C في جلسة المحطة الطرفية التي بدأت فيها التطبيق.

ملاحظات

لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربتك مع MVD-DE، يُرجى ملء نموذج الملاحظات.

إرسال ملاحظاتك إلينا