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

Роботы-пылесосы Xiaomi давно перестали быть простыми помощниками по уборке — они превратились в полноценные умные устройства с открытыми возможностями для программирования.hether вы хотите оптимизировать маршруты уборки, интегрировать пылесос в систему умного дома или вовсе перепрошить его под альтернативную ОС — современные модели (такие как Roborock S8 Pro Ultra, DreameBot X30 Ultra или Viomi V3) предоставляют для этого все инструменты. Однако без правильного подхода даже базовая настройка через Mi Home может вызвать сложности, не говоря уже о работе с Python-скриптами или прошивкой через ADB.

В этом руководстве мы разберём все уровни программирования роботов-пылесов Xiaomi — от элементарной настройки расписания до глубокой кастомизации через API и сторонние прошивки. Вы узнаете, как обойти ограничения стандартного ПО, какие инструменты понадобятся для работы с токенами доступа, и почему некоторые модели (например, Roborock на базе STM32) позволяют гораздо больше свободы, чем устройства на MT7688. Особое внимание уделим безопасности: неправильная прошивка может превратить ваш пылесос в «кирпич», а открытые порты — в лакомую цель для хакеров.

Если вы никогда не занимались программированием устройств IoT, начните с первых двух разделов — там мы разберём базовые понятия и официальные методы настройки. Опытные пользователи могут сразу перейти к разделам про API, Python-библиотеки или альтернативные прошивки. Для удобства мы собрали все критичные команды, пути к файлам и примеры кода в отдельные блоки — их можно копировать и адаптировать под свою модель.

1. Подготовка: что нужно знать перед программированием

Прежде чем приступать к настройке, определите модель своего робота-пылесоса и его «железную» платформу. Это критично, так как методы программирования для устройств на Rockchip RK3308 (например, DreameBot D9) и STM32F4 (Roborock S5 Max) принципиально отличаются. Узнать платформу можно:

🔍 В документации к устройству (ищите раздел Hardware Specifications).
🛠️ Разобрав пылесос и посмотрев маркировку на плате (требует аккуратности!).
📱 Через приложение Mi Home: перейдите в Настройки устройства → Об устройстве → Модель.

Второй ключевой момент — версия прошивки. Устаревшие версии (например, до 3.5.8 для Roborock) могут не поддерживать современные API или иметь уязвимости. Проверить версию можно:

📲 В Mi Home: Профиль устройства → Три точки → Фирмвера.
🖥️ Через SSH (если есть root-доступ): команда
```
cat /etc/version
```

⚠️ Внимание: Роботы-пылесосы Xiaomi с префиксом Viomi (например, Viomi V2) часто используют проприетарные протоколы, несовместимые со стандартными библиотеками для Roborock. Перед покупкой или прошивкой уточните поддержку вашей модели на форумах вроде XDA Developers.

Также подготовьте необходимые инструменты:

Задача	Инструменты	Примечания
Базовая настройка	`Mi Home` (Android/iOS), аккаунт Xiaomi	Привязка к аккаунту обязательна для работы с API.
Работа с API	`Python 3.8+`, библиотека `python-miio`	Установите через `pip install python-miio`
Прошивка	`ADB`, `Fastboot`, кабель `USB-Type-C`	Для Roborock S7 нужен кабель с поддержкой `OTG`.
Отладка	`Wireshark`, `TCPdump`	Для анализа сетевого трафика устройства.

📊 Какую модель робота-пылесоса Xiaomi вы используете?

Roborock (S5/S6/S7/S8)

Dreame (D9/D10/X30)

Viomi (V2/V3)

Другая модель

Ещё не купил

2. Базовая настройка через Mi Home: расписание, зоны, виртуальные стены

Даже без глубокого программирования официальное приложение Mi Home позволяет гибко настроить поведение пылесоса. Рассмотрим ключевые функции, которые часто упускают пользователи:

Расписание уборки по времени и условиям. В отличие от ручного запуска, расписание позволяет:

⏰ Запускать уборку в зависимости от времени суток (например, только днём, когда никого нет дома).
🌡️ Привязывать к погодным условиям (через интеграцию с Xiaomi Weather).
🔄 Создавать цепочки действий (например, «сначала пропылесосить, потом помыть пол»).

Чтобы настроить расписание:

Откройте Mi Home → выберите свой пылесос.
Перейдите в Уборка → Расписание.
Нажмите Добавить и выберите дни недели, время, тип уборки.
В разделе Дополнительно активируйте опцию Автоочистка пылесборника (доступно для моделей с док-станцией).

Виртуальные стены и зоны помогают ограничить область уборки без физических барьеров. Например, можно запретить пылесосу заезжать в детскую комнату или зону с коврами. Для этого:

В Mi Home откройте карту помещения.
Нажмите Редактировать → Добавить зону/стену.
Нарисуйте границы на карте и сохраните.

⚠️ Внимание: Виртуальные стены на моделях Roborock до 2021 года могут сбрасываться после обновления прошивки. Чтобы этого избежать, экспортируйте карту вручную через Настройки → Карта → Сохранить.

Для продвинутых пользователей доступна настройка через голоса помощников (например, Алиса или Google Assistant). Чтобы связать пылесос с голосовым ассистентом:

В Mi Home перейдите в Профиль → Настройки → Голосовые помощники.
Выберите сервис (Яндекс, Google, Siri) и авторизуйтесь.
Скажите команду типа: «Алиса, включи пылесос на кухне».

Проверить подключение пылесоса к Wi-Fi (2.4 GHz)

Обновить приложение Mi Home до последней версии

Убедиться, что пылесос привязан к вашему аккаунту Xiaomi

Скачать карту помещения (если ещё не создано)-->

3. Получение токена доступа: как разблокировать API робота-пылесоса

Для программирования через Python или сторонние приложения (например, Home Assistant) нужен токен доступа — уникальный ключ, который позволяет отправлять команды устройству. Официально Xiaomi не предоставляет токены пользователям, поэтому их приходится извлекать самостоятельно.

Существует три основных способа получить токен:

Через MITM-прокси (для Android):

📱 Установите на телефон Packet Capture или Fiddler.
🔄 Запустите захват трафика и авторизуйтесь в Mi Home.
🔍 Найдите в логах запрос к api.io.mi.com с параметром deviceId.

Через скрипт для iOS (обход ограничений):

🍎 Используйте плагин для Mi Home (требует джейлбрейк).
📋 Токен будет отображаться в настройках устройства.

Через консоль разработчика (для веб-версии Mi Home):

🌐 Откройте веб-версию Mi Home в Chrome.

🔧 Нажмите F12 → Console и введите:

Object.values(miio.env.devices).map(d => ({id: d.deviceID, token: d.token}))

⚠️ Внимание: Токены доступа действуют до тех пор, пока устройство не будет отвязано от аккаунта или не обновится прошивка с изменением протокола безопасности. Храните токен в безопасном месте (например, в KeePass) и не передавайте его третьим лицам — это даёт полный контроль над вашим пылесосом.

Пример полученного токена:

70:7f:2c:1c:4f:9a:7a:d8:6f:b1:5d:c4:3a:8f:ee:9b

Чтобы проверить работоспособность токена, используйте Python-скрипт:

from miio import Vacuum
vacuum = Vacuum(ip="192.168.1.100", token="YOUR_TOKEN_HERE")
print(vacuum.status)

Если скрипт возвращает статус устройства (например, {'state': 8,'battery': 100}), токен действующий. Ошибка DeviceException означает, что токен неверный или устройство offline.

Что делать, если токен перестал работать?

Если токен внезапно перестал работать, причины могут быть следующими:

1. Обновление прошивки — некоторые обновления сбрасывают токены (особенно на моделях Viomi).

2. Сброс устройства — при отвязке от аккаунта Xiaomi токен аннулируется.

3. Изменение IP-адреса — если пылесос получил новый IP по DHCP, обновите его в скриптах.

4. Блокировка Xiaomi — при подозрительной активности (например, слишком частых запросах) аккаунт может быть временно заблокирован.

Чтобы восстановить доступ:

- Повторите процедуру получения токена.

- Проверьте, не изменился ли deviceID (можно увидеть в Mi Home → Настройки устройства).

- Если ничего не помогает, попробуйте сбросить пылесос к заводским настройкам (удерживайте кнопку питания 10 секунд).

4. Программирование через Python: библиотека python-miio и примеры скриптов

Библиотека python-miio — самый популярный инструмент для автоматизации роботов-пылесов Xiaomi. Она поддерживает большинство моделей (включая Roborock, Dreame, Viomi) и позволяет отправлять команды через локальную сеть.

Установите библиотеку:

pip install python-miio --upgrade

Базовый скрипт для управления пылесосом:

from miio import Vacuum
import time

Подключение к устройству
vacuum = Vacuum(ip="192.168.1.100", token="YOUR_TOKEN_HERE")

Основные команды
vacuum.start # Начать уборку
time.sleep(10) # Пауза 10 секунд
vacuum.pause # Приостановить уборку
vacuum.home # Вернуться на базу
vacuum.status # Получить статус

Более сложный пример — уборка по расписанию с учётом уровня батареи:

from miio import Vacuum
import schedule
import time

def check_and_clean:
vacuum = Vacuum(ip="192.168.1.100", token="YOUR_TOKEN_HERE")
status = vacuum.status
if status.battery > 50: # Если заряд больше 50%
vacuum.start
print("Уборка начата")
else:
print("Заряд слишком низкий")

Запуск каждый день в 14:00
schedule.every.day.at("14:00").do(check_and_clean)

while True:
schedule.run_pending
time.sleep(60)

Для работы с картами помещений и зонами уборки используйте расширенные методы:

# Получение карты (требует прошивку с поддержкой API карт)
map_data = vacuum.get_map
print(map_data)

Уборка в конкретной зоне (координаты в формате [x1, y1, x2, y2])
vacuum.clean_zone([18000, 22000, 22000, 26000])

⚠️ Внимание: Координаты зон уборки зависят от модели пылесоса и версии прошивки. Для Roborock S7 система координат начинается с левого нижнего угла карты (0,0), а для DreameBot X30 — с центра. Чтобы узнать точные значения, экспортируйте карту через vacuum.get_map и изучите структуру данных.

Для интеграции с Home Assistant добавьте в конфиг configuration.yaml:

vacuum: - platform: xiaomi_miio host: 192.168.1.100

token: YOUR_TOKEN_HERE

После этого пылесос появится в интерфейсе Home Assistant как полноценное устройство, которым можно управлять через автоматизации.

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

Официальное ПО Xiaomi имеет ограничения: отсутствие локального управления без облака, закрытые API для новых моделей, принудительные обновления. Альтернативные прошивки вроде Valetudo или OpenMiHome решают эти проблемы, но их установка требует осторожности.

Valetudo — самая популярная прошивка с открытым исходным кодом. Она поддерживает:

🌐 Локальное управление без облака Xiaomi.
📊 Расширенные карты с возможностью редактирования зон.
🔧 Полный доступ к API через REST или MQTT.
🛡️ Безопасность: нет принудительной отправки данных в Китай.

Установка Valetudo возможна на следующие модели:

Модель	Поддержка	Метод установки
Roborock S5/S5 Max	✅ Полная	Через `SSH + Docker`
Roborock S6/S7	✅ Полная	Через `ADB + root`
Dreame D9/D10	⚠️ Частичная	Требует патч прошивки
Viomi V2/V3	❌ Нет	Закрытая платформа

Инструкция по установке Valetudo на Roborock S5:

Скачайте последнюю версию Valetudo с официального сайта.
Подключитесь к пылесосу по SSH (логины/пароли для разных моделей здесь).
Загрузите файл valetudo на устройство:
```
scp valetudo root@192.168.1.100:/mnt/UDISK/
```
Сделайте его исполняемым:
```
chmod +x /mnt/UDISK/valetudo
```

Добавьте в автозагрузку:

echo"/mnt/UDISK/valetudo" >> /mnt/default/autostart.sh

Перезагрузите пылесос:
```
reboot
```

После установки Valetudo будет доступен по адресу http://[IP_пылесоса]:8080. Интерфейс позволяет:

🗺️ Редактировать карты в реальном времени.
📡 Управлять пылесосом через MQTT.
🔄 Настраивать автоматизации без облака.

⚠️ Внимание: Установка альтернативных прошивок аннулирует гарантию Xiaomi и может привести к необратимому повреждению устройства. Например, неверная прошивка загрузчика на Roborock S7 делает невозможным восстановление через официальные инструменты. Перед установкой создайте резервную копию оригинальной прошивки командой:
dd if=/dev/mtdblock0 of=/mnt/UDISK/backup.bin

OpenMiHome — ещё один проект, но он ориентирован на интеграцию с Home Assistant и поддерживает меньше моделей. Его основное преимущество — простой веб-интерфейс для управления устройствами Xiaomi без облака.

6. Расширенные возможности: интеграция с умным домом и голосовыми помощниками

Робот-пылесос можно сделать частью экосистемы умного дома, связав его с Home Assistant, Node-RED или голосовыми помощниками. Рассмотрим самые полезные сценарии.

Интеграция с Home Assistant позволяет:

📅 Запускать уборку по сложным условиям (например, «если никого нет дома и батарея заряжена»).
🔄 Связывать пылесос с другими устройствами (например, «если окно открыто, прекратить уборку»).
📊 Визуализировать статистику уборки на дашборде.

Пример автоматизации в Home Assistant (файл automations.yaml):

- alias:"Уборка по расписанию с проверкой окна" trigger: platform: time at:"15:00:00" condition: - condition: state entity_id: binary_sensor.window_contact state:"off" # Окно закрыто - condition: numeric_state entity_id: sensor.roborock_battery above: 50 action: - service: vacuum.start target:

entity_id: vacuum.roborock_s7

Голосовое управление через Алису/Google Assistant настраивается через Yandex IoT или Google Home. Для этого:

В Mi Home свяжите пылесос с голосовым помощником (раздел Настройки → Голосовые помощники).
В приложении помощника (Алиса или Google Home) добавьте устройство через Добавить → Устройство.
Настройте рутины (например, «Алиса, начни уборку на кухне»).

Для продвинутых пользователей доступна интеграция через Node-RED. Пример потока для управления пылесосом:

Установите ноду node-red-contrib-mi-home.
Создайте поток с триггером (например, inject или MQTT).
Добавьте ноду mi-vacuum и настройте её с IP и токеном.
Настройте действия (например, start, pause, zone_clean).

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

import telebot
from miio import Vacuum

bot = telebot.TeleBot("YOUR_TELEGRAM_BOT_TOKEN")
vacuum = Vacuum(ip="192.168.1.100", token="YOUR_TOKEN_HERE")

@bot.message_handler(commands=['start'])
def start(message):
vacuum.start
bot.reply_to(message,"Пылесос начал уборку!")

@bot.message_handler(commands=['stop'])
def stop(message):
vacuum.pause
bot.reply_to(message,"Пылесос остановлен.")

bot.polling

⚠️ Внимание: При настройке удалённого доступа (например, через Telegram или MQTT) никогда не открывайте порты пылесоса напрямую в интернет. Используйте VPN (например, WireGuard) или Cloudflare Tunnel для безопасного подключения.

7. Решение проблем: ошибки подключения, сброс настроек, восстановление

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

Ошибка: «Unable to connect to the vacuum»

🔌 Проверьте, что пылесос и устройство с Python-скриптом находятся в одной сети.
🔄 Перезагрузите пылесос (удерживайте кнопку питания 5 секунд).
📡 Убедитесь, что токен не изменился (проверьте через Mi Home).
🛡️ Отключите брандмауэр на роутере (иногда он блокирует UDP-пакеты).

Ошибка: «Invalid token»

🔑 Получите новый токен (старый мог истечь).
📱 Перепривяжите пылесос к аккаунту Xiaomi.
🔄 Обновите библиотеку python-miio:

pip install --upgrade python-miio

Пылесос не возвращается на базу

🧭 Проверьте, не сбилась ли карта (пересоздайте её в Mi Home).
🔋 Убедитесь, что батарея заряжена хотя бы на 20%.
📡 Переместите док-станцию в более открытое место (минимум 1.5 м свободного пространства спереди).

После прошивки пылесос не включается («кирпич»)

🔌 Попробуйте сбросить настройки: удерживайте кнопку питания 10–15 секунд.
🖥️ Подключитесь через UART (нужен USB-TTL адаптер) и перепрошейте загрузчик.
📧 Обратитесь в issue на GitHub с логами ошибок.

Если пылесос перестал реагировать на команды после обновления прошивки, попробуйте откатиться на предыдущую версию. Для этого:

Скачайте старую прошивку с репозитория.
Подключите пылесос к ПК через USB.

Запустите прошивку через ADB:

adb push firmware.bin /sdcard/

adb shell"flash_image misc /sdcard/firmware.bin"

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

8. Безопасность: как защитить свой пылесос от хакеров

Роботы-пылесосы с подключением к интернету — потенциальная мишень для хакер

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

1. Подготовка: что нужно знать перед программированием

2. Базовая настройка через Mi Home: расписание, зоны, виртуальные стены

3. Получение токена доступа: как разблокировать API робота-пылесоса

4. Программирование через Python: библиотека python-miio и примеры скриптов

Подключение к устройству

Основные команды

Запуск каждый день в 14:00

Уборка в конкретной зоне (координаты в формате [x1, y1, x2, y2])

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

6. Расширенные возможности: интеграция с умным домом и голосовыми помощниками

7. Решение проблем: ошибки подключения, сброс настроек, восстановление

8. Безопасность: как защитить свой пылесос от хакеров

📖 Читайте также