"Привет Siri, уберись на кухне" (пылесос Xiaomi + Homey)

В данной статье хочу рассказать как интегрировать пылесос Xiaomi (вторую версию, но первая должна быть аналогичной) в Homey (он же колобок). А так же обозначить зоны уборки в помещении и управлять их уборкой через HomeKit, Siri или использовать в любых сценариях.

1. Обновляем прошивку пылесоса, если требуется:

Для начала потребуется обновить пылесос до прошивки не ниже 3.3.9_001633 т.к. в ней появилась возможность сохранения карты (а так же возможность указать виртуальные ограничения зон уборки, чтобы пылесос не заезжал в проблемные зоны.). На версиях ниже тоже будет работать, но не стабильно, т.к. при каждом запуске карта будет обновляться и все координаты сбиваться.

После обновления, там же в приложении Mi Home, выбираем пылесос / настройки (многоточие в верхнем правом углу) / настройки робота / и включаем "режим сохранения карты". После чего на главной странице управления пылесосом появился кнопка "редактировать карту" жмём её и сбрасываем старую карту. Запускаем пылесос на уборку по всей квартире, чтобы он построил и сохранил всю карту помещения.

2. Добавляем пылесос в Homey:

Следующим шагом добавляем пылесос в Homey, для этого устанавливаем в Homey плагин Xiaomi Mi Home, так же потребуется знать ip адрес пылесоса в Вашей сети и token пылесоса.

IP адрес можно посмотреть на роутере в списке клиентов WiFi, а о том как достать token есть много статей, но мне больше всего понравился способ с эмулятором Android Nox и версией Mi Home от Вевса. Если у Вас есть устройство на Android, то эмулятор можно пропустить (у меня просто ни одного Android устройства дома не оказалось) подробнее где что скачать и как делать можно найти здесь.

1.Получаем токен Mi wi-fi совместимых устройств

2. Добываем токен (Token) Xiaomi MiHome с iOS устройств через MacBook

После того как достали token, добавляем в Homey новое устройство, выбираем Mi Robot в соответствующем плагине и прописываем ip и token.

3. Определяем координаты:

Для определения координат открываем приложение Mi Home и переходим на страницу пылесоса, чтобы была видна карта помещения. Далее за вводное берём координаты 25500x25500 это так называемая нулевая координата, и начинается она от док станции пылесоса. Создаём тестовый Flow, в столбик when перемещаем для теста This Flow is started, а в столбик then перетаскиваем карточку Mi Robot и перелистываем до действия Send vacuum cleaner to target. Затем необходимо задать X и Y координаты, помня что докстанция это 25500x25500 прибавляем и убавляем значение к этим координатам по 1000, и выполняя тестовый запуск Flow смотрим на открытую карту в приложении Mi Home. Запоминаем куда перемещается указатель точки назначения, тем самым сможем ориентироваться в координатах, прибавлять или убавлять их для попадания в нужную зону. Определившись с системой координат, стараемся переместить точку назначения в левый нижний угол желаемой зоны уборки. (возможно у кого-то нужно будет переместить в правый нижний угол, или даже верхний, зависит от положения док станции, но у меня это левый нижний)

4. Обозначаем границы зон:

Следующим шагом меняем действие Send vacuum cleaner to target в тестовом Flow на Start zone cleaning. Формат координаты в этой карточке следующий [18700, 27600, 22200, 33200, 1] где 18700, 27600 координаты X и Y нижней левой точки зоны уборки, которую мы определили на предыдущем шаге, а 22200, 33200 координаты верхней правой точки этой зоны, которая определяется путём экспериментов. Прибавляя и убавляя значения, проверяем получаемую зону после запуска Flow на карте в Mi Home. ВАЖНО координаты второй точки ОБЯЗАТЕЛЬНО больше чем первой! Если координаты второй точки получились меньше чем у первой, то нужно их поменять местами в шаблоне, иначе не будет работать. А последний оставшийся параметр в шаблоне "1" это количество циклов уборки, по аналогии с тем же параметром в Mi Home от 1 до 3.

Таким же способом определяем координаты других зон если требуется.

5. Добавляем в HomeKit:

Для запуска зональной уборки через Siri потребуется добавить в Homey виртуальную кнопку через модуль Virtual Devices. Лучше всего Siri будет озвучивать тип кнопки Heater, такой тип она будет считать выключателем, а не розеткой или светом.

Далее создаём Flow где when это условия включения виртуальной кнопки, а then это карточка Mi Robot с действием Start zone cleaning по указанным координатам. И ещё одна карточка это выключение виртуальной кнопки. Т.к. если оставить её включенной, то второй и далее запуск через Siri не пройдёт, т.к. HomeKit видит что данное устройство уже включено и не передаёт команду в Homey.

Остаётся только пробросить виртуальную кнопку в HomeKit через плагин от Sprut'а, переименовать как Вам нравится, и создать сценарий в приложении Home Вашей iOS, где в имя написать удобную Вам команду, например "Уберись на кухне", а в действие добавить включение той самой добавленной виртуальной кнопки.

Всё теперь можно командой через Siri "Уберись на кухне" отправить пылесос убираться в нужной зоне. Это быстрее и удобнее чем рисовать каждый раз зону в приложении Mi Home, и работает даже без интернета (разве что SiRi нужен интернет) и китайских серверов, которые часто стали сбоить, после чего в приложении Mi Home ничего нельзя сделать :-)

Пример кейса "уборка на кухне после готовки":

Для себя решил опробовать кейс уборки на кухне после окончания готовки.

После выключения подсветки в зоне готовки приходит уведомление на телефон с вопросом "запустить уборку на кухне?" и если нажать в ответе кнопку "Да" то запускается уборка по координатам кухни.

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