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

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

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

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

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

في الوقت الحالي، يتوافق MVD-DE مع Matter نوع من الأجهزة التالية:

نوع جهاز واحد (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
    

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

    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، اضغط على Control-Q مع التركيز على شاشة VDC، أو اضغط على Control-C في الجلسة الطرفية التي بدأت تشغيل التطبيق فيها.

ملاحظات

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

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