Параметры конфигурации

В Home Assistant каждый успешно настроенный робот-пылесос сохраняется как отдельная запись интеграции. Соответствующее устройство создается автоматически и привязывается к этой записи, предоставляя доступ к сущностям, сервисам и данным карты пылесоса. Параметры конфигурации позволяют управлять настройками для каждого устройства, давая возможность настраивать поведение каждой записи интеграции независимо.

Эти настройки можно получить сразу же во время первоначальной настройки на последнем этапе после завершения конфигурации для выбранного типа подключения (сразу перед добавлением устройства в Home Assistant). Их также можно изменить в любое время позже на странице Интеграции Home Assistant, нажав кнопку Настроить, расположенную в верхнем правом углу карточки устройства.

Ключ Dreame Vacuum Card

Необязательное поле для ключа лицензии Карта пылесоса Dreame. При вводе действительного ключа интеграция автоматически активирует встроенную индивидуальную карту и делает её доступной среди индивидуальных карт на панели управления. Если введён недействительный ключ, карта останется в режиме предварительного просмотра на панели управления.

Получить ключ DVC

Активация на одно устройство

Каждый лицензионный ключ строго ограничен одним устройством. После активации ключ навсегда привязывается к этому конкретному устройству и не может быть использован для активации карты на другом устройстве.

Примечание

Это поле полностью необязательно. Если оставить его пустым, встроенную индивидуальную карту всё равно можно добавить на панель управления, но она будет работать в режиме предварительного просмотра. Действительный ключ всегда можно получить позднее напрямую через интерфейс карты в режиме предварительного просмотра.

Уведомления

Выберите, какие категории постоянные уведомления интеграция может создавать для этого устройства. Снятие галочки с категории полностью её отключает, даже если соответствующее событие устройства всё ещё происходит.

• Очистка завершена (cleanup_completed): Создаётся каждый раз, когда задача очистки успешно завершена.
• Расходный материал (consumable): Создаётся, когда срок службы расходного материала заканчивается или когда компонент требует обслуживания.
• Информация (information): Создаётся для общих информационных событий и обновлений статуса.
• Предупреждение (warning): Создаётся, когда устройство сталкивается с исправляемыми ошибками или незначительными проблемами.
• Ошибка (error): Создаётся, когда устройство испытывает критическую неисправность или аппаратную ошибку.

Подробнее о функции уведомлений

Приложение-компаньон

По умолчанию постоянные уведомления отображаются только на панели управления Home Assistant. Они не могут быть отправлены напрямую в мобильное приложение Home Assistant Companion, так как требуется конкретный идентификатор устройства для уведомлений. Чтобы получать push-уведомления на мобильное устройство, необходимо создать пользовательская автоматизация, который либо отслеживает события интеграции, либо мониторит созданные постоянные уведомления, а затем пересылает их на конкретное мобильное устройство.

Опции отображения карты Поддержка карт

Следующие параметры доступны только для устройств, настроенных с облачной учетной записью (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): Встроенные значки Material Design в 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): Точки точечной уборки, показывающие площадь 1,5 м².
• Иконка зарядного устройства (charger): Иконка базовой станции.
• Иконка робота (robot): Иконка, представляющая самого робота.
• Направление уборки (cleaning_direction): Стрелка, указывающая направление, в котором робот в данный момент убирает.
• ИИ-препятствие (obstacle): Иконки препятствий, обнаруженных ИИ, такие как туфли и провода. (Только на поддерживаемых устройствах)
• Животное (pet): Препятствия, обнаруженные как животные. (Только на поддерживаемых устройствах)
• Ковер (carpet): Текстура ковра. (Только на поддерживаемых устройствах)
• Материал пола (material): Текстура материала пола комнаты, например, дерево или плитка. (Только на поддерживаемых устройствах)
• Низменные участки (low_lying_area): Низкие участки, куда робот заходит, опуская свой LiDAR-сканер. (Только на поддерживаемых устройствах)
• Мебель (furniture): 3D или 2D мебель. (Только на поддерживаемых устройствах)
• Пандус (ramp): Пандусы, размещенные в окружающей среде. (Только на поддерживаемых устройствах)
• Занавеска (curtain): Занавески. (Только на поддерживаемых устройствах)
• Контрольные точки (cruise_point): Переход к рабочим точкам. (Только на поддерживаемых устройствах)

Квадратное изображение карты

Принудительно формирует изображение камеры карты в квадратном соотношении сторон 1:1 вместо естественной рамки карты, что может быть полезно для макетов панели управления, ожидающих квадратное изображение.

Изображение карты низкого разрешения

Формирует изображение камеры карты с пониженным разрешением для уменьшения использования памяти и ускорения обновлений.

Ограничения памяти

Генерация больших карт может потребовать значительного объема памяти. Если Home Assistant аварийно завершает работу и перезапускается при переходе на страницу устройства или при доступе к сущности камеры карты, это, скорее всего, связано с недостатком памяти. Включение этой опции обычно решает проблему.

Примечание

Включение этой опции также отключает сущность камеры Сохраненная карта WiFi, так как она недоступна в низком разрешении.

Предпочитать облако

Доступно только для устройств, настроенных с учетной записью Xiaomi Home. Этот параметр позволяет обновить предпочтение, выбранное на первоначальном этапе настройки.

• При включении: Все коммуникации проходят через облако. Это необходимо для новых устройств, где Xiaomi отключила локальный доступ, или когда устройство и 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