دستگاه مجازی مهم
با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

سپس dpkg برای نصب بسته MVD Debian (.deb) اجرا کنید:

sudo dpkg -i mvd_1.6.0_amd64.deb

macOS

سپس روی فایل dmg دوبار کلیک کنید تا پنجره نصب باز شود.

برای تکمیل نصب، نماد mvd را انتخاب کرده و به پوشه Applications بکشید:

استفاده از پورت را بررسی کنید

ماژول کنترلر در MVD از پورت TCP 33000 برای برقراری تماس های RPC با دستگاه مجازی استفاده می کند، بنابراین اگر این پورت قبلاً توسط فرآیند دیگری در رایانه شما استفاده می شود، حتماً آن را آزاد کنید.

برای مشاهده اینکه آیا فرآیندی از پورت 33000 استفاده می کند یا خیر:

لینوکس

sudo fuser -v 33000/tcp

macOS

lsof -i:33000

شما می توانید هر فرآیندی را با استفاده از پورت TCP 33000 تنها با یک دستور از بین ببرید:

لینوکس

sudo fuser -k 33000/tcp

macOS

lsof -ti:33000 | xargs kill

MVD را اجرا کنید

لینوکس

در لینوکس، MVD از پوشه برنامه های خود یا از ترمینال اجرا کنید:

mvd

macOS

در macOS، از Launchpad برای باز کردن MVD یا اجرای MVD از ترمینال استفاده کنید:

cd /Applications
open mvd.app

دستگاه خود را پیکربندی کنید

صفحه اصلی پس از راه اندازی ظاهر می شود و به شما امکان می دهد یک دستگاه مجازی را پیکربندی کنید:

نوع دستگاه : نوع دستگاه را انتخاب کنید (به عنوان مثال، نور، سوئیچ، سنسور و غیره).
نام دستگاه : نامی کاربرپسند به دستگاه بدهید.
Discriminator : یک عدد 12 بیتی است که برای تشخیص بین تبلیغات چند دستگاه قابل سفارش استفاده می شود. (پیش‌فرض: 3840 ).
Matter Port : پورتی برای راه اندازی و ارتباط Matter از طریق شبکه های IP. Matter به طور پیش‌فرض از پورت TCP/UDP 5540 استفاده می‌کند، اما تا زمانی که هیچ سرویس دیگری از آن استفاده نمی‌کند، می‌توانید دستگاه مجازی را برای استفاده از پورت دیگری پیکربندی کنید.
شناسه فروشنده : فقط شناسه فروشنده آزمایشی 0xFFF1 پشتیبانی می شود.
شناسه محصول : فقط شناسه‌های محصول آزمایشی 0x8000 تا 0x801F پشتیبانی می‌شوند.

پیکربندی دستگاه مجازی صفحه نمایش

فایروال خود را پیکربندی کنید

لینوکس

اگر فایروال در رایانه خود دارید، آن را خاموش کنید یا به اتصالات TCP/UDP ورودی در پورت Matter اجازه دهید.

برای مشاهده قوانین فعلی فایروال فیلتر نت ، اجرا کنید:

sudo iptables -L -n

اگر از «ufw» استفاده می کنید، می توان آن را با موارد زیر غیرفعال کرد:

sudo ufw disable

و می توان آن را دوباره فعال کرد:

sudo ufw enable

macOS

برای پیکربندی یا غیرفعال کردن فایروال در macOS:

به منوی  Apple رفته و System Settings را انتخاب کنید.
روی Network در لیست نوار کناری کلیک کنید.
روی فایروال کلیک کنید.
سوئیچ فایروال را در موقعیت خاموش قرار دهید.

دستگاه خود را اجرا کنید

پس از پیکربندی دستگاه، روی ایجاد دستگاه کلیک کنید. هنگامی که دستگاه ایجاد می شود، صفحه کنترلر ظاهر می شود. بسته به نوع دستگاهی که انتخاب کرده اید، ممکن است یک یا چند مورد از کنترل های زیر را مشاهده کنید:

روشن/خاموش : در اکثر دستگاه ها رایج است.
سطح : به عنوان مثال، یک چراغ می تواند یک نوار لغزنده برای تنظیم روشنایی داشته باشد.
رنگ : برای مثال، یک نور رنگی می تواند این کنترل را داشته باشد.
Occupancy : سنسور اشغال این کنترل را برای شبیه سازی حالت اشغال یا غیر اشغال ارائه می دهد.

تمام دستگاه های مجازی دارای کنترل های زیر هستند:

QRCode : کد QR مورد استفاده برای راه اندازی را نشان می دهد.
راه اندازی مجدد : دستگاه مجازی را مجددا راه اندازی می کند. دستگاه برای مدت کوتاهی از شبکه قطع می شود.
بازنشانی : دستگاه فعلی را به حالت کارخانه بازنشانی می‌کند و تمام وضعیت‌ها، از جمله راه‌اندازی، وضعیت کنترل‌های فعلی و غیره را پاک می‌کند.
حذف : دستگاه را از بین می برد و به صفحه ایجاد دستگاه باز می گردد.

کنترل دستگاه مجازی صفحه نمایش

دستگاه خود را سفارش دهید

دستگاه به محض ایجاد قابل راه اندازی است.

چند پیش نیاز برای راه اندازی دستگاه وجود دارد:

شما باید یک پروژه در Google Home Developer Console داشته باشید. این پروژه باید حاوی یک ادغام Matter باشد که دارای همان ترکیب VID/PID باشد که در راه اندازی دستگاه مجازی خود استفاده کردید. برای جزئیات به راهنمای ایجاد پروژه مراجعه کنید.
باید یک Google Nest Hub داشته باشید که از Matter پشتیبانی کند
شما باید یک گوشی اندرویدی داشته باشید که دارای اندروید 8.1 یا بالاتر است و GHA آن نصب شده باشد.
تلفن Android باید به همان شبکه Wi-Fi متصل باشد که هاب است.
دستگاه میزبان باید به شبکه Wi-Fi متصل باشد.

برای راه‌اندازی دستگاه با استفاده از GHA ، روی QRCode کلیک کنید تا کد QR دستگاه نمایش داده شود، سپس دستورالعمل‌های موجود در دستگاه Pair a Matter را دنبال کنید که نحوه سوار کردن دستگاه Matter با استفاده از GHA را توضیح می‌دهد. همچنین می‌توانید با استفاده از Google Home Sample App for Matter دستگاه را راه‌اندازی کنید.

برای آشنایی با نحوه عملکرد Matter Commissioning به Matter Primer مراجعه کنید.

دستگاه را کنترل کنید

پس از راه اندازی یک دستگاه مجازی، می توانید دستگاه را با استفاده از برنامه Google Home یا Google Assistant به صورت صوتی کنترل کنید. شما می توانید:

هنگام نظارت بر تغییرات وضعیت در دستگاه مجازی، دستگاه را از طریق GHA یا Assistant کنترل کنید، یا
هنگام نظارت بر تغییرات وضعیت در دستگاه مجازی، دستگاه را با استفاده از Sample App for Matter کنترل کنید، یا
هنگام نظارت بر تغییرات وضعیت در GHA یا Assistant ، وضعیت دستگاه را از طریق خود MVD کنترل کنید.

با دستگاه تست کنید

برای آزمایش با Assistant ، توصیه می‌کنیم از یک شبیه‌ساز گفتار مانند Google Home Extension برای VS Code یا Google Home Plugin برای Android Studio استفاده کنید.

مشاهده جزئیات دستگاه

صفحه جزئیات دستگاه اطلاعات دقیق دستگاه را نشان می دهد:

نام: نام دوستانه ای که به دستگاه داده می شود.
نوع دستگاه : نوع دستگاه انتخاب شده.
Discriminator : تشخیص دهنده دستگاه فعلی.
شناسه فروشنده : شناسه فروشنده دستگاه فعلی.
شناسه محصول : شناسه محصول فعلی دستگاه.
پورت RPC : پورت RPC که دستگاه با کنترلرها (GUI) ارتباط برقرار می کند.
Matter Port : پورتی که دستگاه فعلی برای برقراری ارتباط از طریق شبکه IP استفاده می کند.
رمز عبور : پین مورد استفاده برای راه اندازی دستگاه از طریق شبکه.
پوشه پیکربندی : پوشه ای که دستگاه مجازی پیکربندی را ذخیره می کند.
اطلاعات کمیسیون : فابریک(هایی) که دستگاه به آن متصل شده و شناسه گره دستگاه در پارچه را نشان می دهد.

مشاهده گزارش های دستگاه

اگر MVD از ترمینال راه اندازی کرده اید، خروجی ورود به سیستم در stdout ظاهر می شود. همچنین می توانید گزارش های دستگاه را در تب Device logs مشاهده کنید.

دستگاه را متوقف کنید

برای متوقف کردن و نابود کردن دستگاه، روی حذف کلیک کنید.

برنامه را خاتمه دهید

بستن پنجره کنترل دستگاه را از بین می برد و برنامه MVD را خاتمه می دهد. اگر از ترمینال راه‌اندازی کرده‌اید، می‌توانید با تایپ کردن Ctrl-C در ترمینال، برنامه را خاتمه دهید.

کمک بگیرید

برای دریافت راهنمایی در مورد MVD ، گزارش یک اشکال، یا درخواست یک ویژگی جدید، با تماس با پشتیبانی Google خود تماس بگیرید.

با کلیک بر روی دکمه در گوشه سمت راست بالای پنجره به این صفحه می‌روید.

یک اشکال را ثبت کنید

اگر احساس می‌کنید نقصی در MVD پیدا کرده‌اید، می‌توانید با کلیک کردن روی دکمه Issue در گوشه سمت راست بالای پنجره، یک اشکال را ثبت کنید.

ارسال بازخورد

برای ارائه نظرات خود در مورد آنچه در مورد MVD دوست دارید یا اینکه چگونه می توانیم تجربه شما را با این ابزار بهبود بخشیم، فرم بازخورد ما را تکمیل کنید.

فرم را می توان از دکمه بازخورد در گوشه سمت راست بالای پنجره یا با کلیک کردن روی دکمه زیر راه اندازی کرد.

ماده ؛ API های خانگی

در مقایسه با سایر ابزارها

MVD شامل چندین دستگاه مجازی از پیش ساخته شده مختلف است و شامل یک رابط کاربری یکپارچه برای اجرا و کنترل آنها است.

دستگاه های پشتیبانی شده

MVD از انواع دستگاه Matter زیر پشتیبانی می کند:

*جدول: انواع دستگاه های Matter که برای MVD پشتیبانی می شوند*
Matter نوع دستگاه	خوشه(های) برنامه	نوع اکوسیستم خانگی
تصفیه کننده هوا	0x0202 0x0006 0x0071	تصفیه کننده هوا
سنسور کیفیت هوا	0x005b 0x0402 0x0405 0x040c 0x040d 0x042a 0x042d 0x042e	سنسور
پخش کننده اصلی ویدیو	0x0006 0x0506 0x0509	تلویزیون
نور دمای رنگ	0x0300 0x0008 0x0006	نور
سنسور تماس	0x0045	سنسور
نور قابل کاهش	0x0008 0x0006	نور
واحد پلاگین قابل تنظیم	0x0006 0x0008	خروجی
ماشین ظرفشویی	0x0006 0x0059 0x0056 0x0060	ماشین ظرفشویی
قفل درب	0x0101	قفل کنید
نور رنگی گسترده	0x0300 0x0008 0x0006	نور
فن	0x0202 0x0006	فن
سنسور جریان	0x0404	سنسور
سوئیچ عمومی	0x003b	سوئیچ
سنسور رطوبت	0x0405	سنسور
لباسشویی	0x0006 0x0051 0x0053 0x0056 0x0060	واشر
سنسور نور	0x0400	سنسور
سنسور اشغال	0x0406	سنسور
چراغ روشن/خاموش	0x0008 0x0006	نور
کلید روشن/خاموش نور	0x0006	سوئیچ
واحد پلاگین روشن/خاموش	0x0008 0x0006	خروجی
سنسور فشار	0x0403	سنسور
پمپ	0x0006 0x0200 0x0402 0x0403 0x0404	پمپ
ربات جاروبرقی	0x0054 0x0055 0x0061	وکیوم
تهویه مطبوع اتاق	0x0006 0x0201 0x0202	کولر گازی
هشدار CO دود	0x005C	آشکارساز Co2 آشکارساز دود
سنسور دما	0x0402	سنسور
ترموستات	0x0201	ترموستات
پوشش پنجره	0x0102	پرده

MVD را نصب کنید

لینوکس

سپس dpkg برای نصب بسته MVD Debian (.deb) اجرا کنید:

sudo dpkg -i mvd_1.6.0_amd64.deb

macOS

سپس روی فایل dmg دوبار کلیک کنید تا پنجره نصب باز شود.

برای تکمیل نصب، نماد mvd را انتخاب کرده و به پوشه Applications بکشید:

استفاده از پورت را بررسی کنید

برای مشاهده اینکه آیا فرآیندی از پورت 33000 استفاده می کند یا خیر:

لینوکس

sudo fuser -v 33000/tcp

macOS

lsof -i:33000

شما می توانید هر فرآیندی را با استفاده از پورت TCP 33000 تنها با یک دستور از بین ببرید:

لینوکس

sudo fuser -k 33000/tcp

macOS

lsof -ti:33000 | xargs kill

MVD را اجرا کنید

لینوکس

در لینوکس، MVD از پوشه برنامه های خود یا از ترمینال اجرا کنید:

mvd

macOS

در macOS، از Launchpad برای باز کردن MVD یا اجرای MVD از ترمینال استفاده کنید:

cd /Applications
open mvd.app

دستگاه خود را پیکربندی کنید

صفحه اصلی پس از راه اندازی ظاهر می شود و به شما امکان می دهد یک دستگاه مجازی را پیکربندی کنید:

نوع دستگاه : نوع دستگاه را انتخاب کنید (به عنوان مثال، نور، سوئیچ، سنسور و غیره).
نام دستگاه : نامی کاربرپسند به دستگاه بدهید.
Discriminator : یک عدد 12 بیتی است که برای تشخیص بین تبلیغات چند دستگاه قابل سفارش استفاده می شود. (پیش‌فرض: 3840 ).
Matter Port : پورتی برای راه اندازی و ارتباط Matter از طریق شبکه های IP. Matter به طور پیش‌فرض از پورت TCP/UDP 5540 استفاده می‌کند، اما تا زمانی که هیچ سرویس دیگری از آن استفاده نمی‌کند، می‌توانید دستگاه مجازی را برای استفاده از پورت دیگری پیکربندی کنید.
شناسه فروشنده : فقط شناسه فروشنده آزمایشی 0xFFF1 پشتیبانی می شود.
شناسه محصول : فقط شناسه‌های محصول آزمایشی 0x8000 تا 0x801F پشتیبانی می‌شوند.

پیکربندی دستگاه مجازی صفحه نمایش

فایروال خود را پیکربندی کنید

لینوکس

اگر فایروال در رایانه خود دارید، آن را خاموش کنید یا به اتصالات TCP/UDP ورودی در پورت Matter اجازه دهید.

برای مشاهده قوانین فعلی فایروال فیلتر نت ، اجرا کنید:

sudo iptables -L -n

اگر از «ufw» استفاده می کنید، می توان آن را با موارد زیر غیرفعال کرد:

sudo ufw disable

و می توان آن را دوباره فعال کرد:

sudo ufw enable

macOS

برای پیکربندی یا غیرفعال کردن فایروال در macOS:

به منوی  Apple رفته و System Settings را انتخاب کنید.
روی Network در لیست نوار کناری کلیک کنید.
روی فایروال کلیک کنید.
سوئیچ فایروال را در موقعیت خاموش قرار دهید.

دستگاه خود را اجرا کنید

روشن/خاموش : در اکثر دستگاه ها رایج است.
سطح : به عنوان مثال، یک چراغ می تواند یک نوار لغزنده برای تنظیم روشنایی داشته باشد.
رنگ : برای مثال، یک نور رنگی می تواند این کنترل را داشته باشد.
Occupancy : سنسور اشغال این کنترل را برای شبیه سازی حالت اشغال یا غیر اشغال ارائه می دهد.

تمام دستگاه های مجازی دارای کنترل های زیر هستند:

QRCode : کد QR مورد استفاده برای راه اندازی را نشان می دهد.
راه اندازی مجدد : دستگاه مجازی را مجددا راه اندازی می کند. دستگاه برای مدت کوتاهی از شبکه قطع می شود.
بازنشانی : دستگاه فعلی را به حالت کارخانه بازنشانی می‌کند و تمام وضعیت‌ها، از جمله راه‌اندازی، وضعیت کنترل‌های فعلی و غیره را پاک می‌کند.
حذف : دستگاه را از بین می برد و به صفحه ایجاد دستگاه باز می گردد.

کنترل دستگاه مجازی صفحه نمایش

دستگاه خود را سفارش دهید

دستگاه به محض ایجاد قابل راه اندازی است.

چند پیش نیاز برای راه اندازی دستگاه وجود دارد:

شما باید یک پروژه در Google Home Developer Console داشته باشید. این پروژه باید حاوی یک ادغام Matter باشد که دارای همان ترکیب VID/PID باشد که در راه اندازی دستگاه مجازی خود استفاده کردید. برای جزئیات به راهنمای ایجاد پروژه مراجعه کنید.
باید یک Google Nest Hub داشته باشید که از Matter پشتیبانی کند
شما باید یک گوشی اندرویدی داشته باشید که دارای اندروید 8.1 یا بالاتر است و GHA آن نصب شده باشد.
تلفن Android باید به همان شبکه Wi-Fi متصل باشد که هاب است.
دستگاه میزبان باید به شبکه Wi-Fi متصل باشد.

برای آشنایی با نحوه عملکرد Matter Commissioning به Matter Primer مراجعه کنید.

دستگاه را کنترل کنید

هنگام نظارت بر تغییرات وضعیت در دستگاه مجازی، دستگاه را از طریق GHA یا Assistant کنترل کنید، یا
هنگام نظارت بر تغییرات وضعیت در دستگاه مجازی، دستگاه را با استفاده از Sample App for Matter کنترل کنید، یا
هنگام نظارت بر تغییرات وضعیت در GHA یا Assistant ، وضعیت دستگاه را از طریق خود MVD کنترل کنید.

با دستگاه تست کنید

مشاهده جزئیات دستگاه

صفحه جزئیات دستگاه اطلاعات دقیق دستگاه را نشان می دهد:

نام: نام دوستانه ای که به دستگاه داده می شود.
نوع دستگاه : نوع دستگاه انتخاب شده.
Discriminator : تشخیص دهنده دستگاه فعلی.
شناسه فروشنده : شناسه فروشنده دستگاه فعلی.
شناسه محصول : شناسه محصول فعلی دستگاه.
پورت RPC : پورت RPC که دستگاه با کنترلرها (GUI) ارتباط برقرار می کند.
Matter Port : پورتی که دستگاه فعلی برای برقراری ارتباط از طریق شبکه IP استفاده می کند.
رمز عبور : پین مورد استفاده برای راه اندازی دستگاه از طریق شبکه.
پوشه پیکربندی : پوشه ای که دستگاه مجازی پیکربندی را ذخیره می کند.
اطلاعات کمیسیون : فابریک(هایی) که دستگاه به آن متصل شده و شناسه گره دستگاه در پارچه را نشان می دهد.

مشاهده گزارش های دستگاه

دستگاه را متوقف کنید

برای متوقف کردن و نابود کردن دستگاه، روی حذف کلیک کنید.

برنامه را خاتمه دهید

کمک بگیرید

با کلیک بر روی دکمه در گوشه سمت راست بالای پنجره به این صفحه می‌روید.

یک اشکال را ثبت کنید

ارسال بازخورد

فرم را می توان از دکمه بازخورد در گوشه سمت راست بالای پنجره یا با کلیک کردن روی دکمه زیر راه اندازی کرد.

ماده ؛ API های خانگی

در مقایسه با سایر ابزارها

MVD شامل چندین دستگاه مجازی از پیش ساخته شده مختلف است و شامل یک رابط کاربری یکپارچه برای اجرا و کنترل آنها است.

دستگاه های پشتیبانی شده

MVD از انواع دستگاه Matter زیر پشتیبانی می کند:

*جدول: انواع دستگاه های Matter که برای MVD پشتیبانی می شوند*
Matter نوع دستگاه	خوشه(های) برنامه	نوع اکوسیستم خانگی
تصفیه کننده هوا	0x0202 0x0006 0x0071	تصفیه کننده هوا
سنسور کیفیت هوا	0x005b 0x0402 0x0405 0x040c 0x040d 0x042a 0x042d 0x042e	سنسور
پخش کننده اصلی ویدیو	0x0006 0x0506 0x0509	تلویزیون
نور دمای رنگ	0x0300 0x0008 0x0006	نور
سنسور تماس	0x0045	سنسور
نور قابل کاهش	0x0008 0x0006	نور
واحد پلاگین قابل تنظیم	0x0006 0x0008	خروجی
ماشین ظرفشویی	0x0006 0x0059 0x0056 0x0060	ماشین ظرفشویی
قفل درب	0x0101	قفل کنید
نور رنگی گسترده	0x0300 0x0008 0x0006	نور
فن	0x0202 0x0006	فن
سنسور جریان	0x0404	سنسور
سوئیچ عمومی	0x003b	سوئیچ
سنسور رطوبت	0x0405	سنسور
لباسشویی	0x0006 0x0051 0x0053 0x0056 0x0060	واشر
سنسور نور	0x0400	سنسور
سنسور اشغال	0x0406	سنسور
چراغ روشن/خاموش	0x0008 0x0006	نور
کلید روشن/خاموش نور	0x0006	سوئیچ
واحد پلاگین روشن/خاموش	0x0008 0x0006	خروجی
سنسور فشار	0x0403	سنسور
پمپ	0x0006 0x0200 0x0402 0x0403 0x0404	پمپ
ربات جاروبرقی	0x0054 0x0055 0x0061	وکیوم
تهویه مطبوع اتاق	0x0006 0x0201 0x0202	کولر گازی
هشدار CO دود	0x005C	آشکارساز Co2 آشکارساز دود
سنسور دما	0x0402	سنسور
ترموستات	0x0201	ترموستات
پوشش پنجره	0x0102	پرده

MVD را نصب کنید

لینوکس

سپس dpkg برای نصب بسته MVD Debian (.deb) اجرا کنید:

sudo dpkg -i mvd_1.6.0_amd64.deb

macOS

سپس روی فایل dmg دوبار کلیک کنید تا پنجره نصب باز شود.

برای تکمیل نصب، نماد mvd را انتخاب کرده و به پوشه Applications بکشید:

استفاده از پورت را بررسی کنید

برای مشاهده اینکه آیا فرآیندی از پورت 33000 استفاده می کند یا خیر:

لینوکس

sudo fuser -v 33000/tcp

macOS

lsof -i:33000

شما می توانید هر فرآیندی را با استفاده از پورت TCP 33000 تنها با یک دستور از بین ببرید:

لینوکس

sudo fuser -k 33000/tcp

macOS

lsof -ti:33000 | xargs kill

MVD را اجرا کنید

لینوکس

در لینوکس، MVD از پوشه برنامه های خود یا از ترمینال اجرا کنید:

mvd

macOS

در macOS، از Launchpad برای باز کردن MVD یا اجرای MVD از ترمینال استفاده کنید:

cd /Applications
open mvd.app

دستگاه خود را پیکربندی کنید

صفحه اصلی پس از راه اندازی ظاهر می شود و به شما امکان می دهد یک دستگاه مجازی را پیکربندی کنید:

نوع دستگاه : نوع دستگاه را انتخاب کنید (به عنوان مثال، نور، سوئیچ، سنسور و غیره).
نام دستگاه : نامی کاربرپسند به دستگاه بدهید.
Discriminator : یک عدد 12 بیتی است که برای تشخیص بین تبلیغات چند دستگاه قابل سفارش استفاده می شود. (پیش‌فرض: 3840 ).
Matter Port : پورتی برای راه اندازی و ارتباط Matter از طریق شبکه های IP. Matter به طور پیش‌فرض از پورت TCP/UDP 5540 استفاده می‌کند، اما تا زمانی که هیچ سرویس دیگری از آن استفاده نمی‌کند، می‌توانید دستگاه مجازی را برای استفاده از پورت دیگری پیکربندی کنید.
شناسه فروشنده : فقط شناسه فروشنده آزمایشی 0xFFF1 پشتیبانی می شود.
شناسه محصول : فقط شناسه‌های محصول آزمایشی 0x8000 تا 0x801F پشتیبانی می‌شوند.

پیکربندی دستگاه مجازی صفحه نمایش

فایروال خود را پیکربندی کنید

لینوکس

اگر فایروال در رایانه خود دارید، آن را خاموش کنید یا به اتصالات TCP/UDP ورودی در پورت Matter اجازه دهید.

برای مشاهده قوانین فعلی فایروال فیلتر نت ، اجرا کنید:

sudo iptables -L -n

اگر از «ufw» استفاده می کنید، می توان آن را با موارد زیر غیرفعال کرد:

sudo ufw disable

و می توان آن را دوباره فعال کرد:

sudo ufw enable

macOS

برای پیکربندی یا غیرفعال کردن فایروال در macOS:

به منوی  Apple رفته و System Settings را انتخاب کنید.
روی Network در لیست نوار کناری کلیک کنید.
روی فایروال کلیک کنید.
سوئیچ فایروال را در موقعیت خاموش قرار دهید.

دستگاه خود را اجرا کنید

روشن/خاموش : در اکثر دستگاه ها رایج است.
سطح : به عنوان مثال، یک چراغ می تواند یک نوار لغزنده برای تنظیم روشنایی داشته باشد.
رنگ : برای مثال، یک نور رنگی می تواند این کنترل را داشته باشد.
Occupancy : سنسور اشغال این کنترل را برای شبیه سازی حالت اشغال یا غیر اشغال ارائه می دهد.

تمام دستگاه های مجازی دارای کنترل های زیر هستند:

QRCode : کد QR مورد استفاده برای راه اندازی را نشان می دهد.
راه اندازی مجدد : دستگاه مجازی را مجددا راه اندازی می کند. دستگاه برای مدت کوتاهی از شبکه قطع می شود.
بازنشانی : دستگاه فعلی را به حالت کارخانه بازنشانی می‌کند و تمام وضعیت‌ها، از جمله راه‌اندازی، وضعیت کنترل‌های فعلی و غیره را پاک می‌کند.
حذف : دستگاه را از بین می برد و به صفحه ایجاد دستگاه باز می گردد.

کنترل دستگاه مجازی صفحه نمایش

دستگاه خود را سفارش دهید

دستگاه به محض ایجاد قابل راه اندازی است.

چند پیش نیاز برای راه اندازی دستگاه وجود دارد:

شما باید یک پروژه در Google Home Developer Console داشته باشید. این پروژه باید حاوی یک ادغام Matter باشد که دارای همان ترکیب VID/PID باشد که در راه اندازی دستگاه مجازی خود استفاده کردید. برای جزئیات به راهنمای ایجاد پروژه مراجعه کنید.
باید یک Google Nest Hub داشته باشید که از Matter پشتیبانی کند
شما باید یک گوشی اندرویدی داشته باشید که دارای اندروید 8.1 یا بالاتر است و GHA آن نصب شده باشد.
تلفن Android باید به همان شبکه Wi-Fi متصل باشد که هاب است.
دستگاه میزبان باید به شبکه Wi-Fi متصل باشد.

برای آشنایی با نحوه عملکرد Matter Commissioning به Matter Primer مراجعه کنید.

دستگاه را کنترل کنید

هنگام نظارت بر تغییرات وضعیت در دستگاه مجازی، دستگاه را از طریق GHA یا Assistant کنترل کنید، یا
هنگام نظارت بر تغییرات وضعیت در دستگاه مجازی، دستگاه را با استفاده از Sample App for Matter کنترل کنید، یا
هنگام نظارت بر تغییرات وضعیت در GHA یا Assistant ، وضعیت دستگاه را از طریق خود MVD کنترل کنید.

با دستگاه تست کنید

مشاهده جزئیات دستگاه

صفحه جزئیات دستگاه اطلاعات دقیق دستگاه را نشان می دهد:

نام: نام دوستانه ای که به دستگاه داده می شود.
نوع دستگاه : نوع دستگاه انتخاب شده.
Discriminator : تشخیص دهنده دستگاه فعلی.
شناسه فروشنده : شناسه فروشنده دستگاه فعلی.
شناسه محصول : شناسه محصول فعلی دستگاه.
پورت RPC : پورت RPC که دستگاه با کنترلرها (GUI) ارتباط برقرار می کند.
Matter Port : پورتی که دستگاه فعلی برای برقراری ارتباط از طریق شبکه IP استفاده می کند.
رمز عبور : پین مورد استفاده برای راه اندازی دستگاه از طریق شبکه.
پوشه پیکربندی : پوشه ای که دستگاه مجازی پیکربندی را ذخیره می کند.
اطلاعات کمیسیون : فابریک(هایی) که دستگاه به آن متصل شده و شناسه گره دستگاه در پارچه را نشان می دهد.

مشاهده گزارش های دستگاه

دستگاه را متوقف کنید

برای متوقف کردن و نابود کردن دستگاه، روی حذف کلیک کنید.

برنامه را خاتمه دهید

کمک بگیرید

با کلیک بر روی دکمه در گوشه سمت راست بالای پنجره به این صفحه می‌روید.

یک اشکال را ثبت کنید

ارسال بازخورد

فرم را می توان از دکمه بازخورد در گوشه سمت راست بالای پنجره یا با کلیک کردن روی دکمه زیر راه اندازی کرد.

ماده ؛ API های خانگی

در مقایسه با سایر ابزارها

MVD شامل چندین دستگاه مجازی از پیش ساخته شده مختلف است و شامل یک رابط کاربری یکپارچه برای اجرا و کنترل آنها است.

دستگاه های پشتیبانی شده

MVD از انواع دستگاه Matter زیر پشتیبانی می کند:

*جدول: انواع دستگاه های Matter که برای MVD پشتیبانی می شوند*
Matter نوع دستگاه	خوشه(های) برنامه	نوع اکوسیستم خانگی
تصفیه کننده هوا	0x0202 0x0006 0x0071	تصفیه کننده هوا
سنسور کیفیت هوا	0x005b 0x0402 0x0405 0x040c 0x040d 0x042a 0x042d 0x042e	سنسور
پخش کننده اصلی ویدیو	0x0006 0x0506 0x0509	تلویزیون
نور دمای رنگ	0x0300 0x0008 0x0006	نور
سنسور تماس	0x0045	سنسور
نور قابل کاهش	0x0008 0x0006	نور
واحد پلاگین قابل تنظیم	0x0006 0x0008	خروجی
ماشین ظرفشویی	0x0006 0x0059 0x0056 0x0060	ماشین ظرفشویی
قفل درب	0x0101	قفل کنید
نور رنگی گسترده	0x0300 0x0008 0x0006	نور
فن	0x0202 0x0006	فن
سنسور جریان	0x0404	سنسور
سوئیچ عمومی	0x003b	سوئیچ
سنسور رطوبت	0x0405	سنسور
لباسشویی	0x0006 0x0051 0x0053 0x0056 0x0060	واشر
سنسور نور	0x0400	سنسور
سنسور اشغال	0x0406	سنسور
چراغ روشن/خاموش	0x0008 0x0006	نور
کلید روشن/خاموش نور	0x0006	سوئیچ
واحد پلاگین روشن/خاموش	0x0008 0x0006	خروجی
سنسور فشار	0x0403	سنسور
پمپ	0x0006 0x0200 0x0402 0x0403 0x0404	پمپ
ربات جاروبرقی	0x0054 0x0055 0x0061	وکیوم
تهویه مطبوع اتاق	0x0006 0x0201 0x0202	کولر گازی
هشدار CO دود	0x005C	آشکارساز Co2 آشکارساز دود
سنسور دما	0x0402	سنسور
ترموستات	0x0201	ترموستات
پوشش پنجره	0x0102	پرده

MVD را نصب کنید

لینوکس

سپس dpkg برای نصب بسته MVD Debian (.deb) اجرا کنید:

sudo dpkg -i mvd_1.6.0_amd64.deb

macOS

سپس روی فایل dmg دوبار کلیک کنید تا پنجره نصب باز شود.

برای تکمیل نصب، نماد mvd را انتخاب کرده و به پوشه Applications بکشید:

استفاده از پورت را بررسی کنید

برای مشاهده اینکه آیا فرآیندی از پورت 33000 استفاده می کند یا خیر:

لینوکس

sudo fuser -v 33000/tcp

macOS

lsof -i:33000

شما می توانید هر فرآیندی را با استفاده از پورت TCP 33000 تنها با یک دستور از بین ببرید:

لینوکس

sudo fuser -k 33000/tcp

macOS

lsof -ti:33000 | xargs kill

MVD را اجرا کنید

لینوکس

در لینوکس، MVD از پوشه برنامه های خود یا از ترمینال اجرا کنید:

mvd

macOS

در macOS، از Launchpad برای باز کردن MVD یا اجرای MVD از ترمینال استفاده کنید:

cd /Applications
open mvd.app

دستگاه خود را پیکربندی کنید

صفحه اصلی پس از راه اندازی ظاهر می شود و به شما امکان می دهد یک دستگاه مجازی را پیکربندی کنید:

نوع دستگاه : نوع دستگاه را انتخاب کنید (به عنوان مثال، نور، سوئیچ، سنسور و غیره).
نام دستگاه : نامی کاربرپسند به دستگاه بدهید.
Discriminator : یک عدد 12 بیتی است که برای تشخیص بین تبلیغات چند دستگاه قابل سفارش استفاده می شود. (پیش‌فرض: 3840 ).
Matter Port : پورتی برای راه اندازی و ارتباط Matter از طریق شبکه های IP. Matter به طور پیش‌فرض از پورت TCP/UDP 5540 استفاده می‌کند، اما تا زمانی که هیچ سرویس دیگری از آن استفاده نمی‌کند، می‌توانید دستگاه مجازی را برای استفاده از پورت دیگری پیکربندی کنید.
شناسه فروشنده : فقط شناسه فروشنده آزمایشی 0xFFF1 پشتیبانی می شود.
شناسه محصول : فقط شناسه‌های محصول آزمایشی 0x8000 تا 0x801F پشتیبانی می‌شوند.

پیکربندی دستگاه مجازی صفحه نمایش

فایروال خود را پیکربندی کنید

لینوکس

اگر فایروال در رایانه خود در حال اجرا هستید ، یا آن را خاموش کنید ، یا اجازه دهید اتصالات TCP/UDP ورودی را در درگاه Matter وارد کنید.

برای مشاهده قوانین فعال فایروال Netfilter فعلی ، اجرا کنید:

sudo iptables -L -n

اگر از "UFW" استفاده می کنید ، می تواند با:

sudo ufw disable

و می توان آن را دوباره فعال کرد:

sudo ufw enable

macOS

برای پیکربندی یا غیرفعال کردن فایروال در MACOS:

به منوی  اپل بروید و تنظیمات سیستم را انتخاب کنید.
روی شبکه در لیست نوار کناری کلیک کنید.
روی فایروال کلیک کنید.
سوئیچ را برای فایروال به حالت خاموش تغییر دهید.

دستگاه خود را اجرا کنید

پس از پیکربندی دستگاه ، روی ایجاد دستگاه کلیک کنید. هنگام ایجاد دستگاه ، صفحه کنترلر ظاهر می شود. بسته به نوع دستگاهی که انتخاب کرده اید ، ممکن است یک یا چند مورد از کنترل های زیر را ببینید:

روشن/خاموش : مشترک برای اکثر دستگاه ها.
سطح : به عنوان مثال ، یک چراغ می تواند یک کشویی سطح برای تنظیم روشنایی داشته باشد.
رنگ : به عنوان مثال ، یک نور رنگی می تواند این کنترل را داشته باشد.
اشغال : سنسور اشغال این کنترل را برای شبیه سازی وضعیت اشغالی یا غیرقابل استفاده ارائه می دهد.

همه دستگاه های مجازی کنترل های زیر را دارند:

QRCode : کد QR مورد استفاده برای راه اندازی را نشان می دهد.
راه اندازی مجدد : دستگاه مجازی را مجدداً راه اندازی کنید. دستگاه به طور خلاصه از شبکه جدا شده است.
تنظیم مجدد : کارخانه دستگاه فعلی را تهیه می کند و کلیه ایالت ها ، از جمله راه اندازی ، دولت کنترل فعلی و غیره را پاک می کند
DELETE : دستگاه را از بین می برد و به صفحه ایجاد دستگاه باز می گردد.

کنترل دستگاه مجازی صفحه نمایش

دستگاه خود را کمیسیون کنید

دستگاه به محض ایجاد قابل حمل است.

چند پیش نیاز برای راه اندازی دستگاه وجود دارد:

شما باید یک پروژه در Google Home Developer Console داشته باشید. این پروژه باید حاوی یکپارچه سازی Matter باشد که دارای همان ترکیب VID/PID همان است که شما در تنظیم دستگاه مجازی خود استفاده کرده اید. برای جزئیات بیشتر به راهنمای ایجاد پروژه مراجعه کنید.
شما باید یک مرکز Google Nest داشته باشید که از ماده پشتیبانی می کند
شما باید یک تلفن Android در حال اجرا Android 8.1 یا بعد از آن باشد که GHA نصب شده است.
تلفن Android باید به همان شبکه Wi-Fi به عنوان مرکز وصل شود.
دستگاه میزبان باید به شبکه Wi-Fi وصل شود.

برای کاربری دستگاه با استفاده از GHA ، روی QRCode کلیک کنید تا کد QR دستگاه را نمایش دهید ، سپس دستورالعمل ها را به صورت جفت یک دستگاه Matter دنبال کنید که توضیح می دهد چگونه می توانید با استفاده از GHA یک دستگاه Matter را سوار کنید. همچنین می توانید دستگاه را با استفاده از Google Home Sample App for Matter کمیسیون کنید.

برای یادگیری نحوه کار راه اندازی Matter ، به آغازگر Matter ما مراجعه کنید.

دستگاه را کنترل کنید

پس از راه اندازی یک دستگاه مجازی ، می توانید دستگاه را با استفاده از برنامه Google Home یا Google Assistant با صدا کنترل کنید. شما می توانید:

دستگاه را از طریق GHA یا Assistant کنترل کنید ضمن نظارت بر تغییرات حالت در دستگاه مجازی ، یا
دستگاه را با استفاده از Sample App for Matter کنترل کنید در حالی که نظارت بر تغییرات حالت در دستگاه مجازی یا
حالت کنترل دستگاه از طریق MVD ضمن نظارت بر تغییرات حالت در GHA یا Assistant .

با دستگاه تست کنید

برای آزمایش با Assistant ، توصیه می کنیم از یک شبیه ساز گفتاری مانند Google Home Extension برای VS Code یا Google Home Plugin برای Android Studio استفاده کنید.

مشاهده جزئیات دستگاه

صفحه جزئیات دستگاه اطلاعات دقیق دستگاه را نشان می دهد:

نام: نام دوستانه ای که به دستگاه داده می شود.
نوع دستگاه : نوع دستگاه انتخاب شده است.
تبعیض آمیز : تبعیض کننده دستگاه فعلی.
شناسه فروشنده : شناسه فروشنده فعلی دستگاه.
شناسه محصول : شناسه محصول فعلی دستگاه.
پورت RPC : درگاه RPC که دستگاه با کنترل کننده ها (GUI) ارتباط برقرار می کند.
بندر Matter : پورت مورد استفاده توسط دستگاه فعلی برای برقراری ارتباط از طریق شبکه IP.
کد عبور : پین مورد استفاده برای سفارش دستگاه از طریق شبکه.
پوشه پیکربندی : پوشه ای که دستگاه مجازی پیکربندی را ذخیره می کند.
اطلاعات کمیسیون : پارچه (های) موجود در دستگاه و شناسه گره دستگاه را در پارچه نشان می دهد.

مشاهده گزارش های دستگاه

اگر MVD از ترمینال راه اندازی کردید ، خروجی ورود به سیستم در stdout ظاهر می شود. همچنین می توانید سیاهههای مربوط به دستگاه را در برگه ورود به سیستم مشاهده کنید.

دستگاه را متوقف کنید

برای متوقف کردن و از بین بردن دستگاه ، روی حذف کلیک کنید.

برنامه را خاتمه دهید

بستن پنجره کنترل دستگاه را از بین می برد و برنامه MVD را خاتمه می دهد. اگر از ترمینال راه اندازی کردید ، می توانید با تایپ CTRL-C در ترمینال ، برنامه را خاتمه دهید.

کمک بگیرید

برای کمک به MVD ، گزارش یک اشکال یا درخواست ویژگی جدید ، به تماس پشتیبانی Google خود دسترسی پیدا کنید.

با کلیک بر روی دکمه در گوشه بالا سمت راست پنجره ، شما را به این صفحه می برد.

یک اشکال را ثبت کنید

اگر احساس می کنید نقصی را در MVD پیدا کرده اید ، می توانید با کلیک روی دکمه شماره در گوشه سمت راست و راست پنجره ، اشکال دهید.

ارسال بازخورد

برای ارسال افکار خود در مورد آنچه دوست دارید در مورد MVD یا اینکه چگونه می توانیم تجربه شما را با ابزار بهبود بخشیم ، فرم بازخورد خود را تکمیل کنیم.

این فرم را می توان از دکمه بازخورد در گوشه بالا سمت راست پنجره یا با کلیک روی دکمه زیر راه اندازی کرد.