Шаг за шагом: ставим робот‑пылесос через Home Assistant 2025

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

Выбор совместимого пылесоса: что учитывать в 2025 году

Рынок роботов-пылесосов в 2025 году предлагает огромный выбор моделей, но не все из них одинаково хорошо работают с Home Assistant. Ключевой фактор — поддержка открытых протоколов или наличие официальной/сообщественной интеграции. Наиболее популярные бренды, чьи устройства легко интегрируются: Xiaomi (включая Roborock), Dreame, Ecovacs и некоторые модели от Samsung.

При выборе пылесоса обращайте внимание на три параметра: наличие Wi-Fi, поддержка облачного API и статус разблокировки локального управления. Устройства на базе прошивки Gen4 и выше часто позволяют полностью отказаться от облака, что критично для безопасности и скорости реакции. Например, модели Roborock S8 Pro Ultra и Dreame L30 Ultra уже по умолчанию поддерживают локальное управление через протокол Miio.

Если вы планируете глубокую интеграцию, выбирайте модели, которые уже есть в списке Supported Devices на GitHub-страницах интеграций HACS (Home Assistant Community Store). Особенно рекомендуются пылесосы с LiDAR-навигацией — они точнее строят карту и лучше реагируют на команды.

Подготовка Home Assistant: обновление и базовая настройка

Перед добавлением любого нового устройства убедитесь, что ваш Home Assistant работает на актуальной версии 2025.1 или новее. Обновления можно выполнить через раздел Настройки → Система → Обновления. Новые версии содержат исправления безопасности, улучшенную работу с IoT-устройствами и оптимизированные интеграции.

Также важно обеспечить стабильное сетевое соединение. Робот-пылесос должен находиться в той же локальной сети, что и сервер Home Assistant. Избегайте использования гостевых Wi-Fi сетей или VLAN без проброса multicast-трафика. Для лучшей производительности рекомендуется выделенный SSID для умных устройств.

Установите необходимые дополнения через HACS, если они ещё не активны:

• Valetudo RE — для устройств с перепрошиткой;
• MQTT Broker — требуется для большинства продвинутых сценариев;
• File Editor — для редактирования конфигурационных файлов.

Проверьте, включён ли режим разработчика. Он даёт доступ к состояниям сущностей и помогает диагностировать проблемы. Активируется в Настройки → Пользователи → Ваш профиль → Режим разработчика.

Добавление пылесоса в Home Assistant: пошаговая инструкция

Процесс интеграции зависит от типа устройства. Ниже приведена универсальная схема для пылесосов на базе Miio и аналогичных платформ.

1. Подключите пылесос к Wi-Fi. Используйте приложение производителя (Xiaomi Home, Mi Home, Roborock и др.), чтобы привязать устройство к вашей сети. Запомните IP-адрес — он понадобится далее.
2. Найдите токен устройства. Токен — это уникальный ключ для доступа к API. Его можно получить через приложение Mi Home (через резервную копию), через ADB-дамп или с помощью специальных утилит, таких как miio-token-extractor.
3. Откройте Home Assistant. Перейдите в Настройки → Устройства и службы → Добавить интеграцию.
4. Выберите интеграцию. Для Xiaomi/Roborock — это «Xiaomi Miio». Введите IP-адрес и токен. Нажмите «Отправить».
5. Дождитесь обнаружения. HA автоматически определит тип устройства и создаст сущности: vacuum.roborock_s8_pro_ultra, sensor.cleaning_time и другие.

Для устройств с Valetudo процесс проще: после установки прошивки пылесос появляется в сети как MQTT-устройство. Достаточно подключить его через интеграцию Valetudo в HACS, указав IP и порт (обычно 3001).

Пример: добавление Roborock S7 через Miio

• Устройство подключено к Wi-Fi, IP: 192.168.1.105.
• Токен найден: abcdef1234567890abcdef1234567890.
• В HA: «Добавить интеграцию» → «Xiaomi Miio» → ввод данных.
• Через 10–20 секунд появляется устройство с сущностями.

Настройка автоматизаций для уборки

Один из главных плюсов Home Assistant — возможность создавать сложные сценарии. Вот несколько практических примеров автоматизаций для робот-пылесоса.

• Уборка после ухода из дома: запускать пылесос, когда все смартфоны покидают геозону.
• Глубокая уборка по расписанию: каждый вторник и пятницу в 11:00.
• Уборка к приходу гостей: за 30 минут до ожидаемого визита, по событию в календаре.
• Реакция на загрязнение: если датчик качества воздуха фиксирует резкий рост пыли.

Создание автоматизации:

1. Перейдите в Настройки → Автоматизации и сценарии → Создать автоматизацию.
2. Выберите тип: «Предопределённая» или «Редактор YAML».
3. Задайте триггер: время, состояние, событие.
4. Укажите условие (например, только если никто дома).
5. Добавьте действие: «Вызвать службу» → vacuum.start для выбранного устройства.

Пример YAML-автоматизации

alias: Уборка после ухода
description: Запускает пылесос, когда все покидают дом
trigger:
  - platform: state
    entity_id: 
      - device_tracker.phone_alexey
      - device_tracker.phone_ann
    to: 'not_home'
    for:
      minutes: 5
condition:
  - condition: time
    after: '09:00'
    before: '20:00'
action:
  - service: vacuum.start
    target:
      entity_id: vacuum.roborock_s8_pro_ultra
mode: single

Визуализация и управление: карта уборки и интерфейс

С Home Assistant 2025 стало возможным отображать карту уборки прямо в интерфейсе. Для этого используется интеграция Valetudo или дополнение Map Extractor для Miio-устройств.

Установите Lovelace-карту через HACS. Добавьте новый вид в панель управления и используйте кастомную карту, например vacuum-card или floorplan. Она покажет текущее положение робота, зоны уборки и позволит задавать точки назначения.

Настройте мини-панель на главном экране:

• Кнопка запуска/остановки;
• Индикатор заряда батареи;
• Время последней уборки;
• Карта в уменьшенном виде.

Такой подход делает управление интуитивным даже для членов семьи, не знакомых с HA.

Типичные ошибки и как их избежать

Даже при чётком руководстве пользователи сталкиваются с проблемами. Ниже — самые частые ошибки и пути их решения.

Ошибка 1: Устройство не добавляется через Miio

Причина — неверный токен или блокировка облаком. Xiaomi периодически блокирует локальный доступ после обновления прошивки. Решение: использовать метод локального разблокирования (local token unlock) или перейти на Valetudo.

Ошибка 2: Пылесос запускается, но не возвращается на базу

Часто возникает при плохой навигации или помехах. Убедитесь, что на пути нет тёмных ковров, зеркал или ярких источников света. Также проверьте, не исчерпана ли вода в баке (для моделей с мытьем).

Ошибка 3: Карта не отображается или «замерзает»

Требуется корректная настройка MQTT. Убедитесь, что брокер работает, а пылесос отправляет данные. Для Miio-устройств может потребоваться дополнительный скрипт экстракции карты.

Экспертное мнение

По словам эксперта, будущее — за локальным управлением. Облачные решения постепенно уходят в прошлое из-за проблем с задержками и приватностью. Именно поэтому проекты вроде Valetudo и ESPHome становятся стандартом де-факто для продвинутых пользователей.

Вопросы и ответы

Заключение

Интеграция робот-пылесоса в Home Assistant 2025 — это не просто подключение устройства, а создание части умной экосистемы. Благодаря открытой архитектуре HA вы получаете контроль, гибкость и возможность настраивать поведение пылесоса под свой образ жизни. Главное — действовать поэтапно: выбрать совместимую модель, правильно добавить её в систему, настроить автоматизации и визуализировать процесс.

• Выбирайте пылесосы с поддержкой локального API (Xiaomi, Roborock, Dreame).
• Используйте актуальные интеграции через HACS и обновляйте HA до версии 2025.
• Настройте автоматизации на основе времени, местоположения и событий.
• Добавьте карту уборки через Valetudo или MQTT для полного контроля.
• Тестируйте систему поэтапно, избегая типичных ошибок с токенами и сетью.