Якщо у вас є сучасна роботизована газонокосарка, і ви вже користуєтеся Home Assistant, ви за крок від того, щоб перетворити її на... ще один елемент вашої екосистеми домашньої автоматизації Замість того, щоб залишати його заблокованим в офіційному додатку, інтеграція дозволяє вам вирішувати, коли і як вимикати світло: залежно від погоди, наявності людей у саду, надлишку сонячної енергії чи просто графіка родини.
У цій статті ми детально та практично розглянемо, як вони поводяться в Home Assistant. основні розумні газонокосарки та інтеграціїMammotion (Luba/Yuka), Bosch Indego через MQTT, Husqvarna Automower з використанням офіційного API, секрет інтеграції Mammotion з Apple Home як пилососа через Matter та що Home Assistant пропонує тим, хто тільки починає шукати робота для покупки. Все це пояснюється іспанською (Іспанія) мовою та містить безліч ідей автоматизації з реального світу.
Які переваги інтеграції розумної газонокосарки в Home Assistant?
Коли газонокосарка знаходиться лише у своєму додатку, вона залишається в «Силос» повністю відключений решти вашого розумного дому. Інтеграція з Home Assistant руйнує цю ізольованість і перетворює робота на просто ще один пристрій з об'єктами, датчиками та сервісами, які можна використовувати в автоматизації.
На практиці це означає, що ви можете використовувати такі дані, як акумулятор, робочий стан, місцезнаходження GPS, зона скошування або прогноз погоди вирішити, чи робот виходить різати, повертається на базу, призупиняє роботу чи залишається нерухомим.
Ось деякі типові ідеї, які мають сенс, коли у вас є газонокосарка в Home Assistant:
- Припиніть різання, якщо наближається дощ. використання локальних датчиків або інтегрування за часом.
- Уникайте найспекотніших годин дня або ризикувати газоном та запланувати роботу на ранній ранок або пізній вечір.
- Ініціювати вимкнення, коли є надлишок фотоелектричної енергії, якщо ви відстежуєте виробництво сонячної енергії в Home Assistant.
- Блокуйте робота, коли в саду є люди (діти граються, гості на барбекю, відчинені садові ворота тощо).
- Вирівняйте вирізання з сімейними календарями щоб це не заважало зустрічам, сну чи особливим подіям.
Все це можливо завдяки тому, що після інтеграції робот виявляє датчики (батарея, стан, режим, зона, помилки…) та дії (запуск, пауза, стикування, перевизначення тощо), які можна поєднувати з рештою вашого розумного дому.
Інтеграція газонокосарок Mammotion (Luba та Yuka) в Home Assistant
Моделі Mammotion (Luba, Yuka та похідні) мають дуже повну інтеграцію зі спільнотою, що перетворює робота на рідний пристрій «газонокосарка» в Home Assistant. Звідти ви можете зчитувати показники десятків датчиків та виконувати розширені команди різання.
Великою перевагою цієї інтеграції є те, що вона витягує дані з газонокосарки, такі як рівень заряду батареї, робочий стан, положення GPS, кількість супутників, активна зона, тип з'єднання (WiFi/BLE/4G) та інші параметри, специфічні для моделі, окрім надання послуг для запуску, призупинення, зупинки або відправлення робота назад на базу.
Що стосується вимог, важливо мати домашнього помічника. оновлено до останньої версії (мінімум 2025.3.0) та включати HACS (Home Assistant Community Store), оскільки інтеграція не є частиною ядра та встановлюється як користувацький репозиторій.
Найделікатніша деталь не технічна, а пов'язана з бухгалтерським обліком: рекомендується створювати другий обліковий запис Mammotion ексклюзивно для Home AssistantЯкщо ви використовуєте основний обліковий запис, який ви вже використовуєте в додатку, існує ризик надокучливих розривів з’єднання на вашому мобільному пристрої щоразу, коли HA поновлює вхід.
Типовий робочий процес підготовки другого облікового запису такий:
- Створіть новий обліковий запис у застосунку Mammotion, використовуючи іншу адресу електронної пошти.
- Поверніться до свого основного облікового запису та поділитися роботом з вторинним обліковим записом.
- Увійдіть, використовуючи додатковий обліковий запис, прийміть спільний пристрій і зарезервуйте його лише для Home Assistant.
Після того, як розділ облікових записів буде готовий, інтеграцію встановлюється з HACS шляхом додавання користувацький репозиторій "https://github.com/mikey0000/Mammotion-HA" Як інтеграція, Home Assistant встановлюється та перезапускається, щоб він відображався в меню «Інтеграції».
Під час налаштування інтеграції в Налаштуваннях → Пристрої та послуги → Додати інтеграцію ви можете вибрати, чи підключати робота через Bluetooth з низьким енергоспоживанням (BLE) або через Wi-Fi/4GЯкщо ви використовуєте BLE, а сервер Home Assistant знаходиться далеко від саду, ви можете покластися на Проксі-сервер Bluetooth з ESPHome (ESP32 діє як міст BLE біля газонокосарки).
За допомогою Wi-Fi-з’єднання, яке зазвичай найзручніше, якщо сад добре покритий, просто введіть електронна пошта та пароль додаткового облікового запису Mammotion та інтеграція почнуть створювати пристрій з його сутностями.
Після додавання, на панелі пристрою ви побачите свою Любу/Юку з елементами керування різанням та цілим набором датчиків: акумулятор, поточний стан (косіння, заряджання, режим очікування…), тип з’єднання, розташування, кількість супутників, активна робоча зона, прогрес скошування та багато іншого, залежно від моделі.
Окрім датчиків, інтеграція надає доступ до дуже потужних сервісів, таких як mammotion.start_mowщо дозволяє запускати параметризоване скошування. У розділі «Інструменти розробника» → «Дії» ви можете вибрати цю службу, вибрати газонокосарку та передати їй такі параметри, як швидкість, режим траєкторії, виявлення перешкод, висота скошування (на моделях Luba) або список ділянок.
У багатьох випадках існують комбінації параметрів, спільних для всього асортименту (наприклад, швидкість, режими навігації або чутливість до перешкод), та інших, специфічних для Yuka (збір, краї тощо) або Luba (висота скошування, різні стратегії картографування), що дозволяє адаптуватися катсцени з високим рівнем деталізації.
Корисні автоматизації з Mammotion та Home Assistant
Справжній стрибок у якості відбувається, коли ви починаєте творити автоматизація, що з'єднує логіку газонокосарки з рештою вашого розумного дому. Знаючи його стан, рівень заряду батареї та місцезнаходження, ви можете приймати набагато точніші рішення, ніж за допомогою стандартного програмування застосунку.
Класичним прикладом є реакція на погоду: якщо ваша місцева метеостанція, ваші зовнішні датчики Zigbee або інтеграція прогнозування виявляють висока ймовірність неминучого дощуДомашній помічник може наказати газонокосарці зупинити роботу та повернутися на базу, перш ніж сад перетвориться на багнюку.
Щось подібне можна зробити з екстремальними температурами. Якщо зовнішній датчик реєструє, наприклад, більше 30°C, ви можете відкласти вимкнення до Уникайте роботи під прямими сонячними променямияк для захисту газону, так і для догляду за акумулятором і компонентами робота.
Якщо у вас є фотоелектричні панелі, інтегровані в Home Assistant, ще однією дуже корисною функцією автоматизації є... скорочення, використовуючи надлишок сонячної енергіїКоли система виявляє, що ви експортуєте енергію в мережу (або що виробництво перевищує певний поріг), вона запускає газонокосарку протягом «прийнятного» періоду часу. Таким чином, значна частина подальшої підзарядки робота забезпечується вашим власним виробництвом енергії.
Також дуже поширеним є встановлення правил безпеки та співіснування: якщо садові ворота відчиняються, якщо камера виявляє присутність людини або якщо ви активуєте режим «барбекю» чи «діти граються», система може призупинити скошування, щоб уникнути будь-яких несподіванок. Таким чином, робот перестає бути забута річ посеред газону що може дратувати саме тоді, коли ви цього найменше очікуєте.
Зрештою, інтеграція сімейних календарів у Home Assistant дозволяє уникнути косіння трави під час зустрічей, віддаленої роботи або певного часу (наприклад, якщо подія в календарі вказує на «дитячий сон», робот залишається на своїй базі). Тоді газонокосарка поводиться як звичайна газонокосарка. член, більш узгоджений з розкладом домогосподарства.
На рівні інтерфейсу, маючи всі доступні датчики та команди, ви можете створити спеціальну панель керування для робота з анімованими картками, кнопками швидкого керування та дуже продуманим відображенням стану. Для цієї мети зазвичай використовуються такі проекти, як HA-Animated-Cards. створювати візуально привабливі листівки що показують у режимі реального часу хід розрізу або поточну область.
Якщо в будь-який момент інтеграція завершиться невдачею через помилки тайм-ауту API "api.link.aliyun.com", рекомендується перевірити маршрутизатор або брандмауер, якщо він блокування підключень до сервісів, розміщених у КитаїЦе може статися з певними політиками безпеки. Також, якщо процес налаштування облікового запису відхиляє адресу електронної пошти, репозиторій сам пропонує використовувати «номер облікового запису» замість електронної пошти, оскільки в деяких випадках це працює краще.
Розширене керування Mammoth від Apple Home за допомогою Matter
Інтеграція Mammotion в Home Assistant демонструє газонокосарку як єдине ціле. газонокосаркаПроблема полягає в тому, що Matter, станом на сьогодні, не включає певний тип пристрою для газонокосарок, тому немає прямого зіставлення між цією сутністю та аксесуаром Apple Home.
Рішення полягає в тому, щоб спостерігати, що з точки зору домашньої автоматизації, автономна газонокосарка та робот-пилосос є... практично функціональні близнюкиОбидва охоплюють визначені зони, мають батареї, зони, режими роботи, команди запуску/паузи/зупинки та «повернення на базу».
Специфікація Matter включає тип пристрою Роботизований пилосос (0x0074), з кластерами для відображення робочого стану, режиму очищення, режиму роботи та, що дуже важливо, кластером serviceArea, який ідеально відповідає зонам скошування газону.
Хитрощі в тому, щоб створити його в Home Assistant шаблон вакуумної сутності що «огортає» сутність Mammotion lawn_mower: команди старт/стоп/пауза/повернення до базового стану стають еквівалентами пилососа, рівень заряду батареї визначається датчиком батареї газонокосарки, а зони представлені як «кімнати» пилососа.
Щоб усе це налаштувати, вам потрібно, щоб інтеграція Mammotion працювала в доповненні Home Assistant. Центр питань домашнього помічника (бажано, fork, що підтримується RiDDiX), нещодавній HomePod або Apple TV як центр Apple Home та кнопки зон газонокосарки, доступні в Home Assistant (сутності button.*_zone_*, що надаються Mammotion).
Перший крок – знайти всі відповідні об’єкти роботів у Інструментах розробника → Стани: головну газонокосарку.*, датчики режиму та батареї, кнопки зон, кнопку скасування завдання та селектор режиму шляху. Ці точні ідентифікатори потім використовуються для створення файлу configuration.yaml. вакуумний шаблон що перетворює внутрішній стан "MODE_WORKING", "MODE_CHARGING" тощо на стани пилососа, такі як прибирання, док-станція, пауза або режим очікування.
Цей шаблон пилососа також визначає:
- El рівень акумулятора зчитуючи значення з датчика акумулятора газонокосарки.
- Команди запуску, зупинки, паузи та return_to_base, що підтримуються відповідними сервісами lawn_mower.* та button.*.
- Список «швидкостей вентилятора», який фактично використовується для вибору зона різання (Зона А, Зона Б, Зона В…).
- Атрибут приміщення, який містить у форматі JSON масив об'єктів {id, name} з різними зонами у форматі, очікуваному Matter Hub.
Цей атрибут «кімнати» є ключовим, оскільки логіка Matter Hub включає функцію, яка після виявлення цього поля в сутності пилососа автоматично створює кластер. ServiceArea і заповнює підтримувані області. Таким чином, в Apple Home ви бачите кожну зону різання так, ніби це вибрана «кімната» в інтерфейсі пилососа.
За бажанням, ви можете створити шаблон блоку всередині того ж блоку. вибрати шаблон сутності Це перетворює різні режими шляху різання (single_grid, double_grid, segment_grid, no_grid) на більш зручні для користувача назви, такі як «Різати по лініях», «Різати зигзагом», «Різати по сітці» або «Без сітки». Цей вибір потім використовується в Matter Hub як сутність режиму прибирання, щоб Apple Home відображав ці назви в інтерфейсі робота-пилососа.
Після перевірки та перезапуску Home Assistant для завантаження цих шаблонів, ми перевіряємо, чи нова сутність vacuum.* має правильний стан, чи рівень заряду батареї заповнений, а атрибут rooms містить JSON зони. З огляду на це, ми переходимо до частини Matter Hub.
В інтерфейсі плагіна Matter Hub створюється новий міст у режимі сервера, його фільтр сутностей обмежується шаблоном вакууму, і додається маппінг, який вказує, що цей вакуум * має бути доступний як Пристрій типу RoboticVacuumCleanerВибраний об'єкт для режиму різання можна прив'язати туди, якщо його було створено.
Після перезапуску доповнення та перевірки того, що кінцева точка відображає очікувані кластери (включно з serviceArea з підтримуваними областями), просто перейдіть до програми Apple Home, виберіть «Додати аксесуар», відскануйте QR-код моста Matter Hub та завершіть сполучення. Після цього газонокосарка відображатиметься в Apple Home як Робот-пилосос з кнопками відтворення/паузи/бази, відсотком заряду батареї, вибором зони та вибором режиму.
Варто зазначити деякі обмеження: наразі вибір області в Apple Home переважно візуальний, оскільки команда SelectAreas у Matter ще не підключена до загальної служби високої доступності, яка активує кнопки зон; режим скошування може відображати «невідомо», якщо газонокосарка вимкнена, а будь-які зміни визначення кластера або зони зазвичай вимагають… відкликати та повторно ввести в експлуатацію аксесуар в Apple Home.
Інтеграція Bosch Indego через MQTT
Газонокосарки Bosch Indego не мають такої тісної вбудованої інтеграції з Home Assistant, як Mammotion або Husqvarna, але є дуже надійний проект під назвою «Контролер та API для Bosch Indego Connect» який забезпечує доступ до його API, а також включає адаптер MQTT, ідеальний для інтеграції в HA.
Ідея проста: процес, який називається Адаптер IndegoMqtt Він підключається до хмари Bosch, використовуючи ваші облікові дані, та одночасно публікує й прослуховує інформацію про вашого локального брокера MQTT. Home Assistant просто зчитує ці теми MQTT як датчики та надсилає команди, публікуючи повідомлення в інші теми.
Щоб адаптер завантажувався автоматично в середовищі Linux, дуже часто додають рядок до системного cron із синтаксисом @reboot, наприклад:
@reboot /home/pi/indego/bin/IndegoMqttAdapter -c /home/pi/indego/IndegoMqttAdapterConfig.properties
Файл конфігурації IndegoMqttAdapterConfig.properties містить усі конфіденційні дані: Базова URL-адреса сервісу Indego, ім'я користувача та пароль, які ви використовуєте в офіційному додатку, адреса брокера MQTT (ip:порт), облікові дані брокера, коренева тема для повідомлень та інтервал опитування в мілісекундах.
Типовий приклад такого файлу містить такі поля, як indego.mqtt.device.username та password, параметр indego.mqtt.broker.connection, що вказує на tcp://IP_BROKER:1883, ідентифікатор клієнта для розрізнення адаптера, кореневий каталог типу test/device/indego та інтервал опитування (polling-interval-ms) приблизно 30000 мс для Оновлювати статус кожні 30 секунд.
Оскільки адаптер вже публікує стани в MQTT, у Home Assistant вам потрібно лише оголосити датчики MQTT у configuration.yaml, вказуючи на відповідні теми. Сутності зазвичай створюються для стан живлення (увімкнено/вимкнено), робочий стан (Підключено, Заряджання, Косіння, Повернення до док-станції…), відсоток скошеної трави, час останнього скошування та загальний час роботи.
Шаблони значень (value_template) використовуються для перетворення англійських станів, отриманих через MQTT, на іспанські текстові рядки, тому користувач бачить «Завантаження», «Скошування», «Повернення додому», «Обрізання країв», «Бездіяльність у саду», «Низький заряд батареї» тощо. Також можливо Перетворити робочі хвилини на години Ділення на 60 та округлення для зручнішого відображення показників на картках.
Після перезапуску Home Assistant ці датчики можна розмістити на панелі керування, щоб одразу бачити стан живлення, поточний стан газонокосарки, відсоток вже скошеної площі та години роботи.
Для керування Indego з інтерфейсу високої доступності зазвичай використовуються карти наступних типів: кнопка-сутності Горизонтальний стек із трьома кнопками: одна для початку розрізання (надсилання корисного навантаження MOW до команди topic), інша для паузи (корисне навантаження PAUSE) та третя для повернення робота додому (корисне навантаження RETURN). Усі ці кнопки запускають сервіс mqtt.publish з відповідною темою та корисним навантаженням.
Завдяки цьому та його роботі ви також можете розробляти автоматизацію, подібну до автоматизації інших роботів: наприклад, починати косити о 6 ранку лише за умови, що не було дощу і не буде дощу, поєднуючи статус MQTT робота з даними з такої інтеграції, як AccuWeather. Або надсилаючи сповіщення через Telegram або динаміки коли газонокосарка починає косити, завершує цикл або застрягає в саду.
Цей підхід на основі MQTT має перевагу в тому, що він дуже гнучкий: оскільки все відбувається через теми, ви можете легко поєднуйте його з іншими системами, панелями інструментів або розширеною автоматизацієюІ ви не залежите від наявності спеціальної офіційної інтеграції для Indego в ядро Home Assistant.
Офіційна інтеграція Husqvarna Automower з Home Assistant
Husqvarna пропонує офіційну інтеграцію для своїх автоматичних газонокосарок, оснащених Automower Connect або модуль Automower ConnectВикористовуючи власний хмарний API бренду, це забезпечує дуже детальну інформацію про стан газонокосарок, статистику та керування.
Щоб скористатися цією інтеграцією, потрібно налаштувати облікові дані OAuth2 у Портал розробників HusqvarnaВи входите в систему, використовуючи той самий обліковий запис, який використовуєте в застосунку Automower Connect, створюєте новий застосунок і призначаєте йому певну URL-адресу перенаправлення Home Assistant (https://my.home-assistant.io/redirect/oauth), а також підключаєте API автентифікації та Automower Connect.
Під час створення програми портал генерує ключ програми та секрет програми, які необхідно розглядати як конфіденційні облікові дані (еквівалентні імені користувача та паролю)Потім, з Home Assistant, використовується інтеграція Husqvarna Automower, яка проведе вас через процес входу та авторизації, використовуючи ці дані.
Після налаштування Home Assistant створює «хаб» Husqvarna, а звідти — низку об’єктів, пов’язаних із газонокосаркою. До них належать бінарні датчики для визначення використання газонокосарки. заряджання акумулятора (коли робот повернувся через низький заряд батареї та заряджається) або якщо він залишає базу дорогою до початкової точки.
Інтеграція також може генерувати botones для підтвердження незначних помилок, скидання часу використання леза або синхронізації внутрішнього годинника газонокосарки з часом Home Assistant, дуже корисні дії для технічного обслуговування та діагностики.
А календар для кожного робота, який відображає налаштований час різання, дозволяючи бачити в HA як поточні, так і майбутні запрограмовані часові інтервали, інтегруючи їх з рештою календарів будинку.
Якщо модель це підтримує, з'являється сутність трекер_пристроїв який відображає GPS-позицію газонокосарки та сутність події, що відображає останню помилку, з такими атрибутами, як серйозність, точна широта та довгота інциденту, а також позначка часу. Це відкриває шлях до автоматизації, такої як «якщо виникає помилка нахилу, надсилати сповіщення з місцем розташування та відображати маркер на карті».
Центральний керуючий об'єкт – це об'єкт газонокосаркаЗвідси ви можете відновити програму, призупинити косіння або припаркувати робота до наступного запланованого часу. У деяких моделях також створюються числові сутності для налаштування загальна висота скошування (від 1 до 9) та висоту скошування для кожної робочої зони (від 0% до 100% відносно базової висоти), щоб ви могли адаптувати скошування до різних частин саду.
Також є окремі об'єкти для керування, наприклад, режимом роботи фар газонокосарки, та дуже комплексні датчики для часу роботи акумулятора, часу використання леза, помилок, періодів бездіяльності, причин обмежень (заморозки, щоденне обмеження, тижневий графік…), часу заряджання, що залишився, поточного режиму, наступного запуску, кількості циклів заряджання, зіткнень, накопиченого часу скошування, пошуку, руху тощо, а також назви активна робоча зона.
Для кожної робочої області з активованим систематичним різанням створюються додаткові датчики з прогресом у відсотках та датою/часом останнього завершення, що сприяє автоматизації, наприклад, «якщо прогрес області X досягає 100%, повідомити та відправити робота на базу».
Інтеграція також генерує перемикачі для керування заборонені зони (зони заборони)Ці перемикачі дозволяють активувати або деактивувати глобальну програму скошування робота, а також вмикати або вимикати кожну робочу зону окремо. За допомогою цих перемикачів ви можете, наприклад, вирішити, що робот повинен уникати певної ділянки, коли ви влаштовуєте вечірку на газоні.
Щодо конкретних дій, інтеграція включає заклики до перезаписати програму (змінити розклад) та змусити робота косити або паркуватися протягом певного періоду (від 1 хвилини до 42 днів), з тривалістю, зазначеною в днях, годинах та хвилинах. Ви також можете наказати йому косити певну робочу ділянку протягом певного часу, використовуючи ідентифікатор ділянки, отриманий від відповідного датчика.
Важливо пам’ятати про деякі обмеження дизайну: ви не можете запустити газонокосарку просто за допомогою `lawn_mower.start_mowing` поза запланованим часом; для цього потрібно використовувати дії перевизначення. А на моделях із технологією EPOS керування зоною виключення ще не підтримується в цій офіційній інтеграції.
Що отримує користувач, починаючи з Home Assistant та шукаючи газонокосарку?
Якщо ви перебуваєте на ранніх етапах дослідження того, яку роботизовану газонокосарку придбати (наприклад, розглядаєте Mammotion Yuka Mini 700/800 або Ecovacs Goat), і ви встановили Home Assistant лише «просто щоб спробувати», можливо, ви задаєтеся питанням, чи варто заглиблюватися у всі ці інтеграційні речі.
Відповідь зазвичай ствердна, особливо якщо ви плануєте свій сад і будинок як цілісну систему: інтегрувавши газонокосарку з Home Assistant, ви отримаєте набагато більше контролю та видимості З офіційним додатком це означає менше несподіванок та більшу реальну автономність у щоденному використанні.
У конкретному випадку з Yuka/Luba, інтеграція Mammotion дозволяє вам:
- Перевірте одним поглядом стан, батарея, положення та зона з панелі Домашнього помічника.
- Скорочення запуску обумовлені такими правилами, як погода, присутність або виробництво сонячної енергії.
- Синхронізуйте розклади з сімейними календарями або домашніми режимами (відсутність, відпустка, ніч…).
- Дослідіть розширені сценарії, такі як вплив Apple Home через Matter керувати ним так, ніби це робот-пилосос.
Щоб отримати від цього максимум користі, вам, окрім газонокосарки, знадобляться деякі основні елементи домашньої автоматизації: деяка надійна інтеграція за часом (meteosat, AccuWeather, місцева станція), датчики присутності або камери, якщо ви хочете блокувати відключення, коли поруч є люди, а якщо у вас є сонячні панелі, інтегруйте їх у HA, щоб погратися з логікою надлишків.
Спочатку зусилля, пов'язані з налаштуванням, можуть здатися високими, але після завершення початкової автоматизації система працює досить гладко, і ваш робот стає... «той колега-фрілансер, який працює за лаштунками»Але тепер дотримуючись правил, які враховують те, що насправді відбувається у вашому будинку та саду.
Зрештою, інтеграція розумної газонокосарки в Home Assistant, будь то Mammotion, Bosch Indego через MQTT або Husqvarna Automower з її офіційним API, перетворює, здавалося б, просту функцію, таку як скошування газону, на... ще один елемент пазлу домашньої автоматизаціїузгоджено з кліматом, енергією, присутністю та звичками родини, що помітно як у комфорті, так і в спокої, коли сад майже сам про себе піклується, і ви майже не пам'ятаєте, що там працює робот.