خيارات التكوين

في Home Assistant، يتم تخزين كل مكنسة روبوت تم تكوينها بنجاح كإدخال تكامل منفصل. يتم إنشاء جهاز متوافق تلقائيًا وربطه بهذا الإدخال، مما يعرض الكيانات والخدمات وبيانات الخريطة الخاصة بالمكنسة. توفر خيارات التكوين الوصول إلى إعدادات كل جهاز، مما يسمح بتخصيص سلوك كل إدخال تكامل بشكل مستقل.

يمكن الوصول إلى هذه الإعدادات فورًا أثناء عملية الإعداد الأولية كخطوة نهائية بعد إكمال التكوين لنوع الاتصال المختار (فقط قبل إضافة الجهاز إلى Home Assistant). ويمكن أيضًا تعديلها في أي وقت لاحق من صفحة التكاملات في Home Assistant من خلال النقر على زر تكوين الموجود في أعلى يمين بطاقة الجهاز.

مفتاح Dreame Vacuum Card

حقل اختياري لمفتاح ترخيص بطاقة مكنسة Dreame. عند إدخال مفتاح صالح، يقوم التكامل تلقائيًا بتنشيط البطاقة المخصصة المدمجة ويجعلها متاحة ضمن البطاقات المخصصة في لوحة التحكم. إذا تم إدخال مفتاح غير صالح، ستظل البطاقة في وضع المعاينة في لوحة التحكم.

الحصول على مفتاح DVC

تنشيط على جهاز واحد

كل مفتاح ترخيص مقيد بشدة لجهاز واحد فقط. بمجرد تنشيط المفتاح، يرتبط دائمًا بذلك الجهاز المحدد ولا يمكن استخدامه لتنشيط البطاقة على أي جهاز آخر.

ملاحظة

هذا الحقل اختياري تمامًا. إذا تُرك فارغًا، يمكن إضافة البطاقة المخصصة المدمجة إلى لوحة التحكم لكنها ستعمل في وضع المعاينة. ويمكن دائمًا الحصول على مفتاح صالح لاحقًا مباشرة من خلال واجهة البطاقة في وضع المعاينة.

الإشعارات

حدد أي فئات من الإشعارات المستمرة يُسمح للتكامل بإنشائها لهذا الجهاز. إلغاء تحديد فئة يمنعها تمامًا، حتى إذا حدث الحدث الأساسي للجهاز.

• اكتملت عملية التنظيف (cleanup_completed): يتم إنشاؤها في كل مرة تنتهي فيها مهمة التنظيف بنجاح.
• المستهلكات (consumable): يتم إنشاؤها عندما تكون مدة عمر المستهلك منخفضة أو عندما يتطلب أحد المكونات صيانة.
• معلومات (information): يتم إنشاؤها للأحداث الإعلامية العامة وتحديثات الحالة.
• تحذير (warning): يتم إنشاؤها عندما يواجه الجهاز أخطاء يمكن مسحها أو مشكلات بسيطة.
• خطأ (error): يتم إنشاؤها عندما يواجه الجهاز عطلًا حرجًا أو خطأً في الأجهزة.

المزيد عن ميزة الإشعارات

تطبيق الرفيق

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

خيارات عرض الخريطة دعم الخريطة

الإعدادات التالية متاحة فقط للأجهزة التي تم تكوينها بحساب سحابي (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_old): مجموعة أيقونات تطبيق دريمي القديم.
• ميجيا (mijia): مجموعة أيقونات تطبيق Xiaomi Mi Home الرسمي.
• المادة (material): أيقونات Material Design المدمجة في Home Assistant.

كائنات الخريطة المخفية

يحدد عناصر الخريطة التي يتم استبعادها من صورة الخريطة المولدة. هذا مفيد لتبسيط الخريطة أو إخفاء المعلومات التي لا تحتاجها لوحة القيادة المحددة.

الكائنات المتاحة

• ألوان الغرف (color): التلوين المميز لكل غرفة.
• أيقونات الغرف (icon): أيقونة الغرفة بناءً على نوعها.
• أسماء الغرف (name): التسميات النصية لأسماء الغرف.
• خلفية اسم الغرفة (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): نقاط التنظيف الموضعي التي تظهر مساحة 1.5 م².
• رمز الشاحن (charger): رمز محطة الشحن.
• رمز الروبوت (robot): الرمز الذي يمثل الروبوت نفسه.
• اتجاه التنظيف (cleaning_direction): السهم الذي يشير إلى اتجاه تنظيف الروبوت الحالي.
• عائق بواسطة الذكاء الاصطناعي (obstacle): رموز العوائق المكتشفة بواسطة الذكاء الاصطناعي مثل الأحذية والأسلاك. (متاح فقط على الأجهزة المدعومة)
• الحيوان الأليف (pet): العوائق المكتشفة على أنها حيوان أليف. (متاح فقط على الأجهزة المدعومة)
• منطقة السجاد (carpet): ملمس السجاد. (متاح فقط على الأجهزة المدعومة)
• مواد الأرض (material): ملمس مادة الأرضية في الغرفة، مثل الخشب أو البلاط. (متاح فقط على الأجهزة المدعومة)
• المناطق المنخفضة (low_lying_area): المناطق المنخفضة التي يدخلها الروبوت عن طريق خفض جهاز مسح الليدار الخاص به. (متاح فقط على الأجهزة المدعومة)
• الأثاث (furniture): الأثاث ثلاثي الأبعاد أو ثنائي الأبعاد. (متاح فقط على الأجهزة المدعومة)
• المنحدر (ramp): المنحدرات الموضوعة في البيئة. (متاح فقط على الأجهزة المدعومة)
• الستارة (curtain): الستائر. (متاح فقط على الأجهزة المدعومة)
• نقاط الجولان (cruise_point): الانتقال إلى نقاط التشغيل. (متاح فقط على الأجهزة المدعومة)

صورة خريطة مربعة

يجبر صورة كاميرا الخريطة المولدة على نسبة عرض إلى ارتفاع مربعة 1:1 بدلاً من الحد الطبيعي للخريطة، وهو ما يمكن أن يكون مفيدًا لتخطيطات لوحة المعلومات التي تتطلب صورة مربعة.

صورة خريطة منخفضة الدقة

يولد صورة كاميرا الخريطة بدقة منخفضة لتقليل استخدام الذاكرة وتسريع التحديثات.

قيود الذاكرة

إن إنشاء خرائط كبيرة يمكن أن يتطلب كمية كبيرة من الذاكرة. إذا تعطل Home Assistant وأعاد التشغيل عند الانتقال إلى صفحة الجهاز أو عند الوصول إلى كيان كاميرا الخريطة، فمن المرجح أن يكون السبب نقص الذاكرة. تفعيل هذا الخيار سيحل المشكلة عادةً.

ملاحظة

تفعيل هذا الخيار أيضًا يعطل كيان كاميرا خريطة الواي فاي المحفوظة، لأنه غير متاح بدقة منخفضة.

تفضيل السحابة

متاح فقط للأجهزة المكوّنة بحساب Xiaomi Home. يتيح هذا الإعداد تحديث التفضيل الذي تم اختياره في خطوة التهيئة الأولية.

• عند التمكين: يجبر كل التواصل عبر السحابة. هذا مطلوب للأجهزة الأحدث حيث قامت Xiaomi بتعطيل إمكانيات الوصول المحلي، أو عندما يكون الجهاز وHome Assistant على شبكات فرعية مختلفة.
• عند التعطيل (موصى به للإعدادات المدعومة): يقيم التكامل اتصالاً محليًا مباشرًا مع الجهاز (مع الاستمرار في إدارة تجديد الرموز وعناوين IP تلقائيًا من السحابة). هذا يحافظ على جميع الاتصالات (باستثناء بيانات الخرائط) محلية بالكامل.

اختبار توفر واجهة برمجة التطبيقات المحلية

يوفر هذا الخيار طريقة مفيدة جدًا لاختبار الاتصال المحلي. لضمان نجاح إعداد الجهاز الأولي بدون أخطاء، يمكن ترك تفضيل السحابة مفعّلًا أثناء عملية التهيئة. بمجرد إضافة الجهاز بنجاح إلى Home Assistant، يمكن تعطيل هذا الخيار هنا للتحقق من ما إذا كان الجهاز يدعم فعليًا واجهة برمجة التطبيقات المحلية. إذا أصبح الجهاز غير متاح بعد تعطيله، ببساطة أعد تفعيله للرجوع إلى الاتصال بالسحابة.

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