گزینه‌های پیکربندی

در Home Assistant، هر ربات جاروبرقی که با موفقیت پیکربندی شده باشد به عنوان یک ورودی یکپارچه‌سازی مجزا ذخیره می‌شود. یک دستگاه مربوطه به طور خودکار ایجاد شده و به این ورودی متصل می‌شود و موجودیت‌ها، خدمات و داده‌های نقشه جاروبرقی را در دسترس قرار می‌دهد. گزینه‌های پیکربندی امکان دسترسی به تنظیمات هر دستگاه را فراهم می‌کنند و اجازه می‌دهند رفتار هر ورودی یکپارچه‌سازی به طور مستقل شخصی‌سازی شود.

این تنظیمات می‌توانند بلافاصله در طول فرآیند راه‌اندازی اولیه به عنوان مرحله نهایی پس از تکمیل پیکربندی نوع اتصال انتخاب‌شده (لحظه‌ای قبل از اضافه شدن دستگاه به Home Assistant) در دسترس باشند. همچنین می‌توان آنها را در هر زمان بعدی از صفحه Integrations در Home Assistant با کلیک بر روی دکمه Configure که در بالای سمت راست کارت دستگاه قرار دارد، تغییر داد.

کلید Dreame Vacuum Card

یک فیلد اختیاری برای کلید مجوز کارت جاروبرقی Dreame. وقتی یک کلید معتبر وارد شود، ادغام به طور خودکار کارت سفارشی تعبیه‌شده را فعال می‌کند و آن را در میان کارت‌های سفارشی در داشبورد قابل استفاده می‌سازد. اگر کلید نامعتبری وارد شود، کارت در حالت پیش‌نمایش در داشبورد باقی خواهد ماند.

دریافت کلید DVC

فعال‌سازی دستگاه منفرد

هر کلید مجوز به‌طور دقیق به یک دستگاه محدود است. پس از فعال‌سازی یک کلید، به‌طور دائمی به آن دستگاه خاص متصل می‌شود و نمی‌توان از آن برای فعال‌سازی کارت روی دستگاه دیگری استفاده کرد.

توجه

این فیلد کاملاً اختیاری است. اگر خالی باقی بماند، کارت سفارشی تعبیه‌شده هنوز می‌تواند به داشبورد اضافه شود اما در حالت پیش‌نمایش عمل خواهد کرد. کلید معتبر همیشه می‌تواند بعداً مستقیماً از طریق رابط کارت در حالت پیش‌نمایش به‌دست آید.

اعلان‌ها

انتخاب کنید کدام دسته‌بندی‌های اعلان‌های پایدار مجاز به ایجاد توسط ادغام برای این دستگاه هستند. لغو تیک یک دسته‌بندی آن را به‌طور کامل غیرفعال می‌کند، حتی اگر رویداد دستگاه زمینه‌ای همچنان رخ دهد.

• پاک‌سازی تکمیل شد (cleanup_completed): هر بار که یک کار پاک‌سازی با موفقیت به پایان می‌رسد ایجاد می‌شود.
• مصرفی (consumable): وقتی عمر یک مصرفی رو به پایان است یا زمانی که یک قطعه نیاز به نگهداری دارد ایجاد می‌شود.
• اطلاعات (information): برای رخدادهای اطلاعاتی عمومی و به‌روزرسانی وضعیت ایجاد می‌شود.
• هشدار (warning): وقتی دستگاه با خطاهای قابل رفع یا مسائل جزئی مواجه می‌شود ایجاد می‌شود.
• خطا (error): وقتی دستگاه با خطای بحرانی یا خطای سخت‌افزاری مواجه می‌شود ایجاد می‌شود.

بیشتر درباره ویژگی اعلان‌ها

برنامه همراه

به طور پیش‌فرض، اعلان‌های دائمی تنها در داشبورد Home Assistant نمایش داده می‌شوند. این اعلان‌ها نمی‌توانند به طور مستقیم به اپلیکیشن همراه Home Assistant روی دستگاه همراه ارسال شوند زیرا به یک شناسه دستگاه اعلان خاص نیاز است. برای دریافت اعلان‌های پوش روی دستگاه همراه، یک اتوماسیون سفارشی باید ایجاد شود که یا به رویدادها یکپارچگی گوش دهد یا اعلان‌های دائمی تولید شده را رصد کند و سپس آن‌ها را به دستگاه همراه خاص ارسال کند.

گزینه‌های نمایش نقشه پشتیبانی از نقشه

تنظیمات زیر تنها برای دستگاه‌هایی که با حساب ابری (DreameHome، MovaHome، TROUVER یا Xiaomi Home) پیکربندی شده‌اند در دسترس هستند، زیرا همه آن‌ها به داده‌های نقشه وابسته‌اند:

کارت جاروبرقی Dreame

تنظیمات زیر تنها بر روی موجودیت دوربین نقشه تولید شده اعمال می‌شوند. کارت جاروبرقی Dreame به صورت بومی نقشه خود را نمایش می‌دهد و می‌تواند به طور مستقل رنگ‌بندی و مجموعه آیکون را از طریق پیکربندی پیشرفته تغییر دهد. گزینه‌های تصویر نقشه مربعی و تصویر نقشه با وضوح پایین بر روی کارت سفارشی تأثیری ندارند، بنابراین فعال کردن تصویر نقشه با وضوح پایین برای صرفه‌جویی در حافظه به شدت توصیه می‌شود.

طرح رنگ

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

• Dreame Light (dreame_light): تم رسمی اپلیکیشن Dreame.
• Dreame Dark (dreame_dark): تم تاریک مختص ادغام dreame_vacuum.
• Mijia Light (mijia_light): تم روشن رسمی اپلیکیشن Xiaomi Mi Home.
• Mijia Dark (mijia_dark): تم تاریک رسمی اپلیکیشن Xiaomi Mi Home.
• Grayscale (grayscale): تم نقشه بدون رنگ و تک‌رنگ.
• Transparent (transparent): کف، دیوارها و پرکردگی اتاق‌ها به طور کامل شفاف تولید می‌شوند، مفید برای قرار دادن نقشه روی پس‌زمینه سفارشی.

رنگ‌های موجود در پشتیبانی نقشه را مشاهده کنید

مجموعه نمادها

سبک آیکون استفاده شده برای نشانگرهای نقشه مانند ربات، شارژر و مبلمان را انتخاب می‌کند، که با مجموعه آیکون‌های برنامه‌های رسمی مطابقت دارد.

• Dreame (dreame): مجموعه آیکون‌های برنامه رسمی Dreame.
• Dreame Old (dreame_old): مجموعه آیکون‌های برنامه قدیمی Dreame.
• Mijia (mijia): مجموعه آیکون‌های برنامه رسمی Xiaomi Mi Home.
• Material (material): آیکون‌های طراحی متریال داخلی Home Assistant.

اشیاء پنهان نقشه

انتخاب می‌کند که کدام عناصر نقشه از تصویر تولید شده نقشه حذف شوند. این برای ساده‌سازی نقشه یا پنهان کردن اطلاعاتی که برای داشبورد خاص مورد نیاز نیست، مفید است.

اشیاء موجود

• Room Colors (color): پر کننده رنگ مجزا برای هر اتاق.
• Room Icons (icon): آیکون اتاق بر اساس نوع آن.
• Room Names (name): برچسب‌های متنی برای نام اتاق‌ها.
• Room Name Background (name_background): پس‌زمینه به شکل کپسول پشت نام اتاق‌ها با رنگ مرتبط آن.
• ترتیب اتاق (order): نشان‌های شماره‌گذاری شده که ترتیب تمیزکاری را نشان می‌دهند.
• سطح مکش اتاق (suction_level): نمادی که سطح مکش پیکربندی‌شده اتاق را نشان می‌دهد.
• حجم آب اتاق (water_volume): نمادی که حجم آب پیکربندی‌شده اتاق را نشان می‌دهد.
• زمان‌های تمیزکاری اتاق (cleaning_times): نشان‌دهنده تعداد دفعات تمیزکاری اتاق است.
• حالت تمیزکاری اتاق (cleaning_mode): نمادی که حالت تمیزکاری پیکربندی‌شده اتاق را نشان می‌دهد (جارو، طی، یا هر دو). (فقط در دستگاه‌های پشتیبانی‌شده)
• حالت طی‌کشی اتاق (mopping_mode): نمادی که نوع پد طی پیکربندی‌شده اتاق را نشان می‌دهد. (فقط در دستگاه‌های پشتیبانی‌شده)
• مسیر (path): مسیر نشان‌دهنده محل‌هایی که ربات تمیز کرده است.
• مناطق ممنوعه (no_go): مناطق محدود شده.
• مناطق بدون طی (no_mop): مناطق ممنوعه برای طی‌کشی.
• دیوارهای مجازی (virtual_wall): دیواری مجازی برای جلوگیری از عبور ربات افزوده شده است.
• آستانه‌های مجازی (pathway): آستانه‌های تعریف‌شده که ربات باید با دقت از آن‌ها عبور کند. (فقط در دستگاه‌های پشتیبانی‌شده)
• مناطق فعال (active_area): جعبه محاطی که هنگام تمیز کردن منطقه کشیده می‌شود.
• نقاط فعال (active_point): نقاط تمیزکاری که یک مساحت ۱.۵ متر مربع را نشان می‌دهند.
• نماد شارژر (charger): نماد ایستگاه پایه.
• نماد ربات (robot): نماد نمایانگر خود ربات.
• جهت تمیزکاری (cleaning_direction): فلشی که جهت فعلی تمیز کردن ربات را نشان می‌دهد.
• مانع هوش مصنوعی (obstacle): نماد موانع تشخیص داده‌شده توسط هوش مصنوعی مانند کفش و سیم‌ها. (فقط در دستگاه‌های پشتیبانی‌شده)
• حیوان خانگی (pet): موانعی که به عنوان حیوان خانگی شناسایی شده‌اند. (فقط در دستگاه‌های پشتیبانی‌شده)
• منطقه فرش (carpet): بافت فرش. (فقط در دستگاه‌های پشتیبانی‌شده)
• جنس کف (material): بافت جنس کف اتاق، مانند چوب یا کاشی. (فقط در دستگاه‌های پشتیبانی‌شده)
• مناطق کم‌ارتفاع (low_lying_area): مناطقی کم که ربات با پایین آوردن اسکنر LiDAR خود وارد آن‌ها می‌شود. (فقط در دستگاه‌های پشتیبانی‌شده)
• مبلمان (furniture): مبلمان دوبعدی یا سه‌بعدی. (فقط در دستگاه‌های پشتیبانی‌شده)
• شیب (ramp): شیب‌هایی که در محیط قرار گرفته‌اند. (فقط در دستگاه‌های پشتیبانی‌شده)
• پرده (curtain): پرده‌ها. (فقط در دستگاه‌های پشتیبانی‌شده)
• نقاط کروز (cruise_point): رفتن به نقاط عملیات. (فقط در دستگاه‌های پشتیبانی‌شده)

تصویر مربع نقشه

تصویر دوربین نقشه تولیدشده را به نسبت تصویر مربع 1:1 وادار می‌کند، به جای جعبه محدودکننده طبیعی نقشه، که می‌تواند برای چیدمان داشبوردهایی که انتظار تصویر مربع دارند مفید باشد.

تصویر نقشه با وضوح پایین

تصویر دوربین نقشه را با وضوح کاهش‌یافته تولید می‌کند تا استفاده از حافظه کاهش پیدا کند و به‌روزرسانی‌ها سریع‌تر شود.

محدودیت‌های حافظه

تولید نقشه‌های بزرگ می‌تواند نیاز به مقدار قابل توجهی حافظه داشته باشد. اگر Home Assistant هنگام رفتن به صفحه دستگاه یا هنگام دسترسی به موجودیت دوربین نقشه کرش کند و راه‌اندازی مجدد شود، احتمال زیاد به دلیل کمبود حافظه است. فعال کردن این گزینه معمولاً مشکل را برطرف می‌کند.

توجه

فعال کردن این گزینه همچنین موجودیت دوربین Saved WiFi Map را غیرفعال می‌کند، زیرا در وضوح پایین قابل استفاده نیست.

ترجیح بر ابر

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

• هنگام فعال بودن: تمام ارتباطات را از طریق ابر اجبار می‌کند. این برای دستگاه‌های جدیدتر که شیائومی قابلیت دسترسی محلی را غیرفعال کرده، یا زمانی که دستگاه و Home Assistant در زیرشبکه‌های متفاوتی قرار دارند، لازم است.
• هنگامی که غیرفعال است (توصیه شده برای تنظیمات پشتیبانی شده): این یکپارچه‌سازی یک اتصال مستقیم محلی با دستگاه برقرار می‌کند (در حالی که هنوز خودکار وظایف تمدید توکن و IP از طریق ابر را انجام می‌دهد). این باعث می‌شود که تمام ارتباطات (به جز داده‌های نقشه) کاملاً محلی باقی بمانند.

آزمایش دسترسی به API محلی

این گزینه راه بسیار مفیدی برای آزمایش اتصال محلی فراهم می‌کند. برای اطمینان از اینکه تنظیم اولیه دستگاه بدون خطا انجام می‌شود، ترجیح ابر می‌تواند در طول جریان پیکربندی فعال باقی بماند. پس از اینکه دستگاه با موفقیت به Home Assistant اضافه شد، این گزینه می‌تواند در اینجا غیرفعال شود تا بررسی شود که آیا دستگاه واقعاً از API محلی پشتیبانی می‌کند یا خیر. اگر پس از غیرفعال کردن آن، دستگاه در دسترس نباشد، کافی است دوباره آن را فعال کنید تا به اتصال ابری بازگردید.

YAML برای مرجع

dreame_vacuum:
  # Local connection
  host: 192.168.1.100
  token: b2a1c3d4e5f6a7b8c9d0e1f2a3b4c5d6

  # Cloud connection
  username: your@email.com
  password: your_password
  country: de
  prefer_cloud: true # Only available on Xiaomi Home

  # Options available regardless of connection type
  dvc_key: 123e4567-e89b-42d3-a456-426614174000
  notify:
    - information
    - warning
    - error

  # Options available only with map support (Cloud)
  color_scheme: dreame_dark
  icon_set: dreame_old
  hidden_map_objects:
    - name_background
    - name
    - order
  square: true
  low_resolution: true