Как запрограммировать робота-пылесоса Xiaomi: от базовых настроек до продвинутой автоматизации

npm install -g miio-cli
miio discover --handshake

После получения токена вы можете отправлять команды роботу через HTTP. Пример запроса для запуска уборки на Python:

import requests

token = "YOUR_DEVICE_TOKEN"  # Замените на ваш токен
did = "YOUR_DEVICE_ID"       # ID устройства (можно найти в Mi Home)
ip = "192.168.1.100"         # Локальный IP робота

url = f"http://{ip}/miIO.info"
headers = {"Content-Type": "application/json"}
data = {
"id": 1,
"method": "miIO.info",
"params": []
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

Запуск уборки
url = f"http://{ip}/miIO.info"
data = {
"id": 2,
"method": "app_start",
"params": []
}

response = requests.post(url, json=data, headers=headers)

Полный список поддерживаемых команд для роботов-пылесосов Xiaomi можно найти в документации Home Assistant. Например:

• app_start — начать уборку.
• app_pause — приостановить уборку.
• app_zoned_clean — уборка в указанной зоне (требуются координаты).
• app_goto_target — отправить робота в конкретную точку на карте.

⚠️ Внимание: Токены устройств Xiaomi могут меняться после обновления прошивки или сброса настроек. Если команды перестали работать, повторите процедуру извлечения токена.

4. Интеграция с Home Assistant: полный контроль над роботом

Home Assistant — это открытая платформа для умного дома, которая позволяет объединить устройства разных производителей в единую систему. С её помощью вы можете:

• 📊 Визуализировать карту уборки в реальном времени.
• 🤖 Создавать сложные автоматизации с учётом данных с других датчиков.
• 📱 Управлять роботом через голосовых помощников (Алиса, Google Assistant, Siri).
• 🔄 Синхронизировать уборку с другими устройствами (например, выключать робота при включении пылесоса).

Чтобы подключить робот-пылесос Xiaomi к Home Assistant:

1. Установите Home Assistant на Raspberry Pi, NAS или ПК.
2. В файле конфигурации configuration.yaml добавьте интеграцию xiaomi_miio:

   vacuum:
   - platform: xiaomi_miio
   host: 192.168.1.100  # IP робота
   token: YOUR_DEVICE_TOKEN

3. Перезагрузите Home Assistant.
4. В интерфейсе появится новая сущность vacuum.xiaomi_vacuum, которой можно управлять через панели или автоматизации.

Пример автоматизации в Home Assistant, которая запускает уборку, когда все ушли из дома, а влажность воздуха выше 50%:

automation:
- alias: "Уборка при отсутствии дома и высокой влажности"
trigger:
- platform: state
entity_id: group.family
to: "not_home"
for: "00:30:00"  # Задержка 30 минут
condition:
- condition: numeric_state
entity_id: sensor.humidity
above: 50
action:
- service: vacuum.start
entity_id: vacuum.xiaomi_vacuum
- service: notify.telegram
data:
message: "Робот начал уборку: влажность {{ states('sensor.humidity') }}%."

Важно: модели роботов-пылесосов Xiaomi с прошивкой после 2023 года могут требовать дополнительную аутентификацию через облако. В этом случае для интеграции с Home Assistant потребуется использовать компонент miio2 с поддержкой облачного токена.

Получить токен устройства|Установить Home Assistant на Raspberry Pi/NAS|Добавить интеграцию xiaomi_miio в configuration.yaml|Проверить подключение в меню Developer Tools → States|Создать тестовую автоматизацию-->

5. Альтернативные прошивки: Valetudo и открытые возможности

Если вас не устраивают ограничения стандартной прошивки Xiaomi, можно установить альтернативное ПО, такое как Valetudo. Это проект с открытым исходным кодом, который предоставляет:

• 🌐 Локальное управление без зависимости от облака Xiaomi.
• 🗺️ Продвинутые инструменты работы с картой (редактирование зон, ручное управление).
• 🔧 Поддержка пользовательских скриптов на JavaScript.
• 📡 Интеграция с MQTT для умного дома.

Valetudo поддерживает следующие модели роботов-пылесосов Xiaomi:

Процесс установки Valetudo зависит от модели. Для большинства устройств потребуется:

1. Получить root-доступ к роботу (например, через уязвимость в прошивке или специальный скрипт).
2. Подключиться к роботу по SSH (обычно по адресу root@192.168.1.100, пароль пустой или 1234567890).
3. Запустить установщик Valetudo:

   wget -O - https://raw.githubusercontent.com/Hypfer/Valetudo/master/scripts/install.sh | bash

4. После установки веб-интерфейс Valetudo будет доступен по адресу http://[IP_робота]:80.

В интерфейсе Valetudo вы можете:

• 🖥️ Управлять роботом через веб-браузер (включая ручное управление с джойстика).
• 📝 Редактировать карту, добавлять виртуальные стены и зоны уборки.
• 📊 Просматривать статистику уборки и ошибки.
• 🔧 Настраивать пользовательские команды через JavaScript.

⚠️ Внимание: Установка альтернативных прошивок может привести к потере гарантии и нестабильной работе робота. Перед прошивкой сделайте резервную копию оригинальной прошивки через команду dd if=/dev/mtdblock0 of=/tmp/full_backup.bin.

6. Программирование через сторонние приложения: AlternativeApp и другие

Если работа с API и прошивками кажется слишком сложной, можно использовать сторонние приложения, которые расширяют функционал Mi Home. Самые популярные:

• 📱 AlternativeApp for Xiaomi Vacuum (Android) — позволяет настраивать расписание с точностью до минуты, создавать сложные зоны уборки и управлять роботом без интернета.
  • Поддерживает модели: Mi Robot Vacuum 1/1S, Mi Robot Vacuum-Mop P, S5/S6.
  • Требует токен устройства (извлекается так же, как для API).
• 🌍 Vacuum Map Viewer (веб) — отображает карту уборки в реальном времени с возможностью ручного управления.
  • Работает через облако Xiaomi (нужен токен).
  • Поддерживает экспорт карты в формате .svg.
• 🤖 Robot Vacuum Controller (iOS) — альтернатива Mi Home с расширенными настройками зон и расписания.
  • Есть функция "Следование за мной" (робот едет за вами по дому).
  • Поддерживает голосовое управление через Siri.

Пример настройки AlternativeApp:

1. Скачайте APK с GitHub и установите на Android.
2. Добавьте робот-пылесос, введя его IP, токен и Device ID.
3. В меню Advanced настройте:
   • Custom commands — создайте собственные команды (например, уборка только по периметру).
   • Map management — редактируйте сохранённые карты.
   • DND mode — настройте "не беспокоить" по расписанию.

Преимущества сторонних приложений:

• ✅ Нет зависимости от серверов Xiaomi (работает локально).
• ✅ Больше гибкости в настройке зон и расписания.
• ✅ Поддержка старых моделей, которые больше не обновляются.

Недостатки:

• ❌ Требуется ручная настройка (токены, IP).
• ❌ Нет официальной поддержки (возможны баги).

7. Сравнение возможностей программирования по моделям Xiaomi

Не все роботы-пылесосы Xiaomi поддерживают продвинутые функции. Ниже — сравнение популярных моделей по возможностям кастомизации:

Если ваша модель не поддерживает нужные функции, рассмотрите апгрейд. Например, переход с Mi Robot Vacuum 1S на Xiaomi Robot Vacuum-Mop 2 Pro откроет доступ к:

• 🗺️ Точной карте с сохранением нескольких этажей.
• 🚿 Автоматической смене режимов (пылесос/швабра).
• 🔄 Интеграции с другими устройствами умного дома.

8. Частые ошибки и их решение

При программировании роботов-пылесосов Xiaomi пользователи сталкиваются с типичными проблемами. Разберём самые распространённые:

• 🔌 Робот не отвечает на API-команды.
  • Проверьте, что IP-адрес робота не изменился (используйте статический IP в роутере).
  • Убедитесь, что токен актуальный (после обновления прошивки он может сброситься).
  • Проверьте, что робот и устройство, с которого отправляются команды, находятся в одной сети.
• 🗺️ Карта не сохраняется после выключения.
  • Включите опцию Сохранение карты в настройках робота в Mi Home.
  • Для моделей без лидара карта не сохраняется принципиально (они используют случайный алгоритм уборки).
• 🔄 Робот не возвращается на базу.
  • Проверьте, что база установлена на ровной поверхности и не закрыта препятствиями.
  • Обновите прошивку робота (в старых версиях были баги с навигацией).
  • Если робот застрял, используйте команду app_charge через API, чтобы принудительно отправить его на зарядку.
• 📱 Приложение Mi Home не видит робот.
  • Перезагрузите робот (зажмите кнопку питания на 10 секунд).
  • Сбросьте настройки робота до заводских (Настройки → Общие → Сброс).
  • Проверьте, что робот подключён к сети 2.4 GHz (не 5 GHz).

Если робот выдаёт ошибку с кодом (например, Error 10 или Error 12), расшифровать её можно в документации Home Assistant. Например:

• Error 3 — робот застрял.
• Error 5 — проблема с боковой щёткой.
• Error 9 — низкий заряд батареи.

⚠️ Внимание: Если после прошивки Valetudo робот перестал включаться, проверьте целостность файловой системы через SSH. Частая причина — нехватка места в разделе /tmp. Решение: подключитесь по SSH и выполните df -h, чтобы проверить свободное место.

FAQ: Ответы на частые вопросы