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

حزمة 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) مجموعات التطبيقات نوع المنظومة المتكاملة للمنزل
أداة استشعار التلامس الحالة المنطقية جهاز استشعار
إضاءة خافتة تفعيل/إيقاف
التحكّم في المستوى
فاتح
إضاءة ملوَّنة موسّعة تشغيل/إيقاف
التحكم في المستوى
التحكّم في الألوان
فاتح
مستشعر التدفق قياس التدفق جهاز استشعار
جهاز استشعار الرطوبة قياس الرطوبة النسبية جهاز استشعار
جهاز استشعار الإضاءة قياس الإضاءة جهاز استشعار
جهاز استشعار تواجد الأفراد في المنزل ميزة "استشعار تواجد الأفراد في المنزل" جهاز استشعار
تشغيل/إيقاف الإضاءة تشغيل / إيقاف فاتح
مقبس تفعيل/إيقاف
التحكّم في المستوى
المقبس
مستشعر ضغط قياس الضغط جهاز استشعار
المتحدث تفعيل/إيقاف
التحكّم في المستوى
مكبّرات الصوت
Switch تشغيل / إيقاف تبديل
جهاز استشعار الحرارة قياس درجة الحرارة جهاز استشعار

إعداد بيئة تطوير الأجهزة الافتراضية لمعيار 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، يُرجى ملء نموذج الملاحظات.

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