Ако имате модерна роботизирана косачка за трева и вече използвате 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 мост близо до косачката за трева).
С WiFi връзка, която обикновено е най-удобна, ако градината е добре покрита, просто влезте имейл адресът и паролата на вторичния акаунт Mammotion и интеграцията ще започнат да създават устройството с неговите обекти.
След като бъде добавен, в панела на устройството ще видите вашия Luba/Yuka с контроли за рязане и цял набор от сензори: батерия, текущо състояние (косене, зареждане, покой...), тип връзка, местоположение, брой сателити, активна работна зона, напредък на косене и много други, в зависимост от модела.
В допълнение към сензорите, интеграцията предоставя много мощни услуги, като например 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: командите старт/стоп/пауза/връщане към базата стават еквиваленти на прахосмукачката, нивото на батерията идва от сензора за батерията на косачката, а зоните са представени като „стаи“ за прахосмукачка.
За да настроите всичко това, трябва да имате работеща интеграция с Mammotion в добавката Home Assistant. Център за домашен асистент (за предпочитане fork, поддържан от RiDDiX), скорошен HomePod или Apple TV като Apple Home hub и бутоните за зоната на косачката, налични в Home Assistant (обектите button.*_zone_*, предоставени от Mammotion).
Първата стъпка е да намерите всички съответни роботизирани обекти в „Инструменти за разработчици“ → „Състояния“: основната косачка за трева * (main lawn_mower.*), сензорите за режим и батерия, бутоните за зони, бутона за отмяна на задача и селектора за режим на пътя. Тези точни идентификатори след това се използват за изграждане на файла configuration.yaml. вакуумен шаблон което превежда вътрешното състояние "MODE_WORKING", "MODE_CHARGING" и т.н. в състояния на прахосмукачката, като почистване, докинг станция, пауза или неактивност.
Този шаблон за прахосмукачка също така определя:
- El ниво на батерията вземайки стойността от сензора на батерията на косачката.
- Командите за стартиране, спиране, пауза и return_to_base, поддържани от съответните услуги lawn_mower.* и button.*.
- Списък с „скорости на вентилатора“, който действително се използва за избор зоната на рязане (Зона А, Зона Б, Зона В…).
- Атрибут стаи, който съдържа в JSON масив от обекти {id, name} с различните зони, във формата, очакван от Matter Hub.
Този атрибут „стаи“ е ключов, защото логиката на Matter Hub включва функция, която, след като открие това поле в обекта на прахосмукачката, автоматично създава клъстера. зона на обслужване и запълва поддържаните области. По този начин в Apple Home виждате всяка зона за рязане, сякаш е избираема „стая“ в интерфейса на прахосмукачката.
По желание можете да създадете шаблонен блок в рамките на същия блок. изберете шаблон за обект Това превежда различните режими на пътя на рязане (single_grid, double_grid, segment_grid, no_grid) в по-лесни за ползване имена като „Cut in lines“, „Cut in zigzag“, „Cut in grid“ или „No grid“. След това този избор се използва в Matter Hub като обект на режим на почистване, така че Apple Home да показва тези имена в интерфейса на роботизираната си прахосмукачка.
След валидиране и рестартиране на Home Assistant за зареждане на тези шаблони, проверяваме дали новият обект vacuum.* е в правилното състояние, нивото на батерията е заредено и атрибутът rooms съдържа zone JSON. След като сме подредили това, преминаваме към частта Matter Hub.
В интерфейса на плъгина Matter Hub се създава нов мост в сървърен режим, филтърът му за обекти е ограничен до шаблона на вакуума и се добавя картографиране, показващо, че този вакуум * трябва да бъде изложен като Устройство за материя от типа RoboticVacuumCleanerИзбраният обект за режим на рязане може да бъде свързан там, ако е бил създаден.
След като рестартирате добавката и проверите дали крайната точка показва очакваните клъстери (включително serviceArea с поддържаните области), просто отидете в приложението Apple Home, изберете „Добавяне на аксесоар“, сканирайте QR кода на моста Matter Hub и завършете сдвояването. След като сте готови, косачката за трева ще се появи в Apple Home като Роботизирана прахосмукачка с бутони за възпроизвеждане/пауза/база, процент на батерията, избор на зона и избор на режим.
Струва си да се отбележат някои ограничения: засега изборът на област в Apple Home е предимно визуален, тъй като командата SelectAreas на Matter все още не е свързана с обща HA услуга, която задейства бутони за зони; режимът на косене може да показва „неизвестен“, ако косачката е изключена, а всякакви промени в клъстера или дефинициите на зоната обикновено изискват оттегляне и повторно въвеждане в експлоатация аксесоарът в 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:port), идентификационните данни на брокера, основната тема за съобщенията и интервала на запитване в милисекунди.
Типичен пример за такъв файл включва полета като indego.mqtt.device.username и password, параметъра indego.mqtt.broker.connection, сочещ към tcp://IP_BROKER:1883, client-id за разграничаване на адаптера, topic-root от типа test/device/indego и polling-interval-ms от около 30000 ms за Актуализиране на състоянието на всеки 30 секунди.
Тъй като адаптерът вече публикува състояния в MQTT, в Home Assistant е необходимо само да декларирате MQTT сензори в configuration.yaml, като сочите към съответните теми. Обикновено се създават обекти за състояние на захранването (включено/изключено), работното състояние (Докирана, Зареждане, Косене, Връщане към докинг станцията...), процентът окосена трева, времето на последното косене и общото работно време.
Шаблоните за стойности (value_template) се използват за преобразуване на английските състояния, получени чрез MQTT, в испански текстови низове, така че потребителят вижда „Зареждане“, „Косене“, „Връщане у дома“, „Подрязване на краищата“, „Бездействие в градината“, „Ниска батерия“ и др. Възможно е също така да Преобразувайте работните минути в часове Деление на 60 и закръгляване, за да се показват по-удобни показатели на картите.
След като Home Assistant се рестартира, тези сензори могат да бъдат поставени на панелна карта, за да имате с един поглед състоянието на захранването, текущото състояние на косачката, процента на вече окосената площ и работните часове.
За управление на Indego от HA интерфейса обикновено се използват карти от тип [липсващ тип]. бутон-на-обект Хоризонтален стек с три бутона: един за стартиране на рязането (изпращане на полезния товар MOW към командата topic), друг за пауза (PAUSE payload) и трети за връщане на робота у дома (RETURN payload). Всички тези бутони стартират услугата 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, превръща привидно проста функция като косене на тревата в... още едно парче от пъзела за домашна автоматизациясъгласувано с климата, енергията, присъствието и навиците на семейството, нещо, което се забелязва както в комфорта, така и в спокойствието, когато градината се грижи почти сама за себе си и едва ли се сещате, че там работи робот.