Интеграција паметне косилице у кућни асистент

Ако имате модерну роботску косилицу и већ користите кућног асистента, само сте корак до тога да је претворите у... још један део вашег екосистема кућне аутоматизације Уместо да га оставите закључаног у његовој званичној апликацији, интеграција вам омогућава да одлучите када и како да искључите светла: на основу времена, да ли има људи у башти, вишка производње соларне енергије или једноставно распореда породице.

У овом чланку ћемо детаљно и на практичан начин видети како се понашају у кућном асистенту. главне паметне косилице и интеграцијеMammotion (Luba/Yuka), Bosch Indego преко MQTT-а, Husqvarna Automower коришћење званичног API-ја, трик за представљање Mammotion-а Apple Home-у као усисивача преко Matter-а и шта Home Assistant нуди некоме ко тек почиње да истражује који робот да купи. Све објашњено на шпанском (Шпанија) и са мноштвом идеја за аутоматизацију „из стварног света“.

Које су предности интеграције паметне косилице у кућни асистент?

Када косилица постоји само у својој апликацији, она остаје у „Силос“ потпуно искључен остатка вашег паметног дома. Интеграција са кућним асистентом разбија тај силос и претвара робота у само још један уређај, са ентитетима, сензорима и услугама које можете користити у аутоматизацији.

У пракси, то значи да можете користити податке као што су батерија, радни статус, GPS локација, зона кошења или временска прогноза да одлучи да ли робот излази да сече, враћа се у базу, паузира рад или остаје непокретан.

Неке веома типичне идеје које имају много смисла када имате косилицу у кућном асистенту су:

• Зауставите сечење ако се приближава киша. коришћењем локалних сензора или временских интеграција.
• Избегавајте најтоплије сате дана или ризиковати травњак и заказати рад за рано јутро или касно увече.
• Покрените искључивање када постоји вишак фотонапонског система, ако пратите производњу соларне енергије у апликацији Home Assistant.
• Блокирајте робота када су људи у башти (деца се играју, посетиоци на роштиљу, отворена баштенска капија итд.).
• Ускладите сечење са породичним календарима како не би ометало састанке, дремке или посебне догађаје.

Све је ово могуће зато што, једном интегрисан, робот открива сензори (батерија, стање, режим, зона, грешке…) и акције (покретање, паузирање, повезивање, превазилажење итд.) које се могу комбиновати са остатком вашег паметног дома.

Интеграција косилица за траву Mammotion (Luba и Yuka) у Home Assistant

Модели Mammotion (Luba, Yuka и деривати) имају веома потпуну интеграцију са заједницом која трансформише робота у изворни уређај „косилица за траву“ у оквиру Кућног асистента. Одатле можете очитавати десетине сензора и извршавати напредне команде за сечење.

Велика предност ове интеграције је то што извлачи податке из косилице као што су ниво батерије, радни статус, GPS позиција, број сателита, активно подручје, тип везе (WiFi/BLE/4G) и друге параметре специфичне за модел, поред излагања сервисима за покретање, паузирање, заустављање или слање робота назад у базу.

Што се тиче захтева, важно је имати кућног помоћника. ажурирано на новију верзију (минимум 2025.3.0) и укључују HACS (Home Assistant Community Store), пошто интеграција није део језгра и инсталира се као прилагођени репозиторијум.

Најосетљивији детаљ није техничке природе, већ се односи на рачуноводство: препоручује се креирање други Mammotion налог ексклузивно за Home AssistantАко користите главни налог који већ користите у апликацији, постоји ризик од досадних прекида везе на вашем мобилном уређају сваки пут када HA обнови пријаву.

Типичан ток рада за припрему тог другог налога је:

• Направите нови налог у апликацији Mammotion, користећи другу адресу е-поште.
• Вратите се на свој главни налог и подели робота са секундарним налогом.
• Пријавите се са секундарним налогом, прихватите дељени уређај и резервишите га само за кућног асистента.

Када је одељак за налоге спреман, интеграција се инсталира из HACS-а додавањем прилагођени репозиторијум „https://github.com/mikey0000/Mammotion-HA“ Као интеграција, Кућни асистент се инсталира и поново покреће тако да се појављује доступан у менију Интеграције.

Приликом конфигурисања интеграције у Подешавањима → Уређаји и услуге → Додај интеграцију, можете изабрати да ли желите да повежете робота преко Блуетоотх са ниском потрошњом енергије (БЛЕ) или путем Ви-Фи/4ГАко користите BLE и сервер Home Assistant је далеко од баште, можете се ослонити на... Блутут прокси са ESPHome-ом (ESP32 који делује као BLE мост близу косилице).

Са WiFi везом, која је обично најпогоднија ако је башта добро покривена, једноставно унесите имејл и лозинка секундарног налога Mammotion и интеграција ће почети да креирају уређај са његовим ентитетима.

Када се дода, на панелу уређаја видећете свој Луба/Јука са контролама сечења и читавим низом сензора: батерија, тренутни статус (кошење, пуњење, мировање...), тип везе, локација, број сателита, активна радна површина, напредак кошења и још много тога, у зависности од модела.

Поред сензора, интеграција открива веома моћне сервисе, као што су mammotion.start_mowшто вам омогућава да покренете параметризовано кошење. Из „Алатке за програмере“ → „Акције“ можете да изаберете ту услугу, изаберете косилицу и проследите јој параметре као што су брзина, режим путање, детекција препрека, висина кошења (на моделима Luba) или листа подручја.

У многим случајевима, постоје комбинације параметара заједничких за цео асортиман (нпр. брзина, режими навигације или осетљивост на препреке) и других специфичних за Јуку (сакупљање, ивице итд.) или за Лубу (висина кошења, различите стратегије мапирања), што вам омогућава да се прилагодите катсцене са високим нивоом детаља.

Корисне аутоматизације са Mammotion-ом и Home Assistant-ом

Прави скок у квалитету долази када почнете да стварате аутоматизације које повезују логику косилице са остатком вашег паметног дома. Знајући његов статус, ниво батерије и локацију, можете доносити много прецизније одлуке него са стандардним програмирањем апликације.

Класичан пример је реакција на временске услове: ако ваша локална метеоролошка станица, ваши спољни Zigbee сензори или интеграција за прогнозирање открију велика вероватноћа предстојеће кишеКућни помоћник може да нареди косилици да престане да ради и врати се у базу пре него што се башта претвори у блато.

Нешто слично се може урадити и са екстремним температурама. Ако спољни сензор региструје више од, на пример, 30°C, можете одложити искључивање до Избегавајте рад на директној сунчевој светлостикако за заштиту травњака, тако и за бригу о батерији и компонентама робота.

Ако имате фотонапонске системе интегрисане у Home Assistant, још једна веома корисна функција аутоматизације је ... сечење искоришћавањем вишка соларне енергијеКада систем детектује да извозите енергију у мрежу (или да производња прелази одређени праг), покреће косилицу у „прихватљивом“ временском оквиру. На овај начин, велики део накнадног пуњења робота напаја се вашом сопственом производњом енергије.

Такође је веома уобичајено успостављање правила безбедности и коегзистенције: ако се отвори баштенска капија, ако камера детектује људско присуство или ако активирате режим „роштиљ“ или „деца се играју“, систем може паузирати кошење како би избегао било каква изненађења. На овај начин, робот престаје да буде заборављена ствар усред травњака што може бити досадно баш када то најмање очекујете.

Коначно, интеграција породичних календара у кућног асистента вам омогућава да избегнете кошење током састанака, радног времена на даљину или одређеног времена (на пример, ако догађај у календару означава „бебино спавање“, робот остаје на својој бази). Косилица се тада понаша као обична косилица. члан који је боље усклађен са распоредом домаћинства.

На нивоу интерфејса, са свим сензорима и командама на располагању, можете направити посебну контролну таблу за робота, са анимираним картицама, дугмадима за брзу контролу и веома углађеним приказом статуса. Уобичајено је користити пројекте попут HA-Animated-Cards за ову сврху. креирајте визуелно привлачне картице који у реалном времену приказују напредак сечења или тренутног подручја.

Ако у било ком тренутку интеграција не успе са грешкама истека времена према API-ју „api.link.aliyun.com“, препоручљиво је проверити рутер или заштитни зид у случају да је блокирање веза са сервисима који се налазе у КиниОво се може десити са одређеним безбедносним политикама. Такође, ако процес подешавања налога одбије адресу е-поште, сам репозиторијум предлаже коришћење „броја налога“ уместо адресе е-поште, јер ово боље функционише у неким случајевима.

Напредна контрола Мамута из 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).

Први корак је проналажење свих релевантних роботских ентитета у Алатима за програмере → Стања: главна косилица *, сензори режима и батерије, дугмад за зоне, дугме за отказивање задатка и селектор режима путање. Ови тачни ИД-ови се затим користе за изградњу датотеке configuration.yaml. вакуумски шаблон што преводи унутрашње стање „РЕЖИМ_РАДА“, „РЕЖИМ_ПУЊЕЊА“ итд. у стања усисивача као што су чишћење, прикључен, паузиран или у стању мировања.

Тај шаблон усисивача такође дефинише:

• El ниво батерије узимајући вредност са сензора батерије косилице.
• Команде за покретање, заустављање, паузу и враћање у базу које подржавају одговарајући сервиси lawn_mower.* и button.*.
• Листа „брзина вентилатора“ која се заправо користи за избор зона сечења (Зона А, Зона Б, Зона Ц…).
• Атрибут Собе, који садржи у JSON-у низ објеката {id, name} са различитим зонама, у формату који очекује Matter Hub.

Овај атрибут „собе“ је кључан јер логика Matter Hub-а укључује функцију која, након детекције овог поља у ентитету усисивача, аутоматски креира кластер. сервис област и попуњава подржане области. На овај начин, у Apple Home-у видите сваку зону сечења као да је то „соба“ коју можете изабрати у интерфејсу усисивача.

Опционо, можете креирати шаблон блока унутар истог блока. изаберите шаблон ентитета Ово преводи различите режиме путање сечења (једнострука_мрежа, двострука_мрежа, сегментна_мрежа, без_мреже) у имена која су једноставнија за коришћење као што су „Сечење по линијама“, „Сечење цик-цак“, „Сечење у мрежи“ или „Без мреже“. Овај избор се затим користи у Matter Hub-у као ентитет режима чишћења, тако да Apple Home приказује ова имена у свом интерфејсу роботског усисивача.

Након валидације и поновног покретања Home Assistant-а ради учитавања ових шаблона, проверавамо да ли нови ентитет usisivač.* има исправно стање, да ли је ниво батерије попуњен и да ли атрибут rooms садржи zone JSON. Након тога, прелазимо на део Matter Hub.

У интерфејсу додатка Matter Hub, нови мост се креира у серверском режиму, његов филтер ентитета је ограничен на шаблон вакуума и додаје се мапирање које указује да овај вакуум * треба да буде изложен као Уређај за материју типа RoboticVacuumCleanerИзабрани ентитет за режим сечења може се тамо повезати ако је креиран.

Након поновног покретања додатка и провере да ли крајња тачка приказује очекиване кластере (укључујући serviceArea са подржаним областима), једноставно идите на апликацију Apple Home, изаберите „Додај додатну опрему“, скенирајте QR код моста Matter Hub и завршите упаривање. Када завршите, косилица ће се појавити у Apple Home-у као Роботски усисивач са дугмадима за репродукцију/паузирање/базу, процентом батерије, избором зоне и избором режима.

Вреди напоменути нека ограничења: за сада је избор подручја у Apple Home-у првенствено визуелан, јер Matter-ова команда SelectAreas још увек није повезана са генеричком HA услугом која активира дугмад за зоне; режим кошења може приказивати „непознато“ ако је косилица искључена, а све промене дефиниције кластера или зоне обично захтевају повлачење и поновно пуштање у рад додатак у Apple Home-у.

Интеграција Bosch Indego-а путем MQTT-а

Бош Индего косилице немају тако чврсту интеграцију са кућним асистентом као Маммоушн или Хускварна, али постоји веома солидан пројекат под називом „Апликација контролера и API за Bosch Indego Connect“ који пружа приступ његовом API-ју и такође укључује MQTT адаптер савршен за интеграцију у HA.

Идеја је једноставна: процес који се зове IndegoMqtt адаптер Повезује се са Бош облаком користећи ваше акредитиве и истовремено објављује и слуша информације о вашем локалном MQTT брокеру. Кућни асистент једноставно чита ове MQTT теме као сензоре и шаље команде објављивањем порука другим темама.

Да би се адаптер аутоматски покренуо у Линук окружењу, веома је уобичајено додати линију у системски 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 за разликовање адаптера, корен теме типа test/device/indego и polling-interval-ms од око 30000 ms за Ажурирај статус сваких 30 секунди.

Пошто адаптер већ објављује стања у MQTT-у, у Home Assistant-у је потребно само да декларишете MQTT сензоре у configuration.yaml датотеци, указујући на одговарајуће теме. Ентитети се обично креирају за статус напајања (укључено/искључено), радни статус (Прикључено, Пуњење, Кошење, Повратак на док...), проценат покошене траве, време последњег кошења и укупно време рада.

Шаблони вредности (value_template) се користе за превођење енглеских стања примљених путем MQTT-а у шпанске текстуалне стрингове, тако да корисник види „Учитавање“, „Кошење“, „Повратак кући“, „Одреживање ивица“, „Неактивност у башти“, „Слаба батерија“ итд. Такође је могуће да Претворите радне минуте у сате Дељење са 60 и заокруживање, ради приказивања практичнијих метрика на картицама.

Када се Кућни асистент поново покрене, ови сензори се могу поставити на панел картицу како би се на први поглед видели статус напајања, тренутни статус косилице, проценат већ покошене површине и радни сати.

За контролу Indego-а са HA интерфејса, обично се користе картице типа [недостаје тип]. дугме-ентитета Хоризонтални стек са три дугмета: једно за покретање сечења (слање MOW корисног оптерећења команди topic), друго за паузирање (PAUSE корисни оптерећење) и треће за слање робота назад кући (RETURN корисни оптерећење). Сва ова дугмад покрећу сервис mqtt.publish са одговарајућом темом и корисним оптерећењем.

Када је ово покренуто и у функцији, сада можете дизајнирати аутоматизације сличне онима код других робота: на пример, почетак кошења у 6 ујутру само ако није падала киша и неће падати, комбиновањем MQTT статуса робота са подацима из интеграције као што је AccuWeather. Или слањем обавештења путем Телеграма или звучника када косилица почне да косити, заврши циклус или се заглави у башти.

Овај приступ заснован на MQTT-у има предност што је веома флексибилан: пошто се све дешава кроз теме, можете лако га комбинујте са другим системима, контролним таблама или напредним аутоматизацијамаИ не зависите од тога да ли постоји посебна званична интеграција за Indego у језгру Home Assistant-а.

Званична интеграција Хускварна Аутомовер са Хоме Ассистант-ом

Хускварна нуди званичну интеграцију за своје аутоматске косилице опремљене са Automower Connect или Automower Connect модулКористећи сопствени cloud API бренда, ово пружа веома детаљне ентитете за статус косилице, статистику и контролу.

Да бисте користили ову интеграцију, потребно је да конфигуришете OAuth2 акредитиве у Портал за програмере компаније HusqvarnaПријављујете се са истим налогом који користите у апликацији Automower Connect, креирате нову апликацију и додељујете јој одређени URL за преусмеравање Home Assistant-а (https://my.home-assistant.io/redirect/oauth), поред повезивања API-ја за аутентификацију и Automower Connect.

Приликом креирања апликације, портал генерише кључ апликације и тајну апликације које се морају третирати као осетљиви акредитиви (еквивалентни корисничком имену и лозинци)Затим се из Home Assistant-а користи интеграција са Husqvarna Automower-ом, која ће вас водити кроз процес пријаве и ауторизације користећи те податке.

Једном конфигурисан, Кућни асистент креира Husqvarna „чвориште“ и, одатле, низ ентитета повезаних са косилицом. То укључује бинарне сензоре за детекцију да ли се користи. пуњење батерије (када се робот вратио због празне батерије и пуни се) или ако напушта базу на путу ка почетној тачки.

Интеграција такође може генерисати ботонес да потврдите мање грешке, ресетујете време коришћења сечива или синхронизујете унутрашњи сат косилице са временом кућног асистента, веома корисне радње за одржавање и дијагностику.

А календар за сваког робота, који приказује конфигурисана времена сечења, омогућавајући вам да у HA видите и тренутне и будуће програмиране временске слотове, интегришући их са остатком кућних календара.

Ако модел то подржава, појављује се ентитет праћење_уређаја који приказује ГПС позицију косилице и ентитет догађаја који одражава последњу грешку, са атрибутима као што су озбиљност, тачна географска ширина и дужина инцидента и временска ознака. Ово отвара врата аутоматизацијама као што је „ако дође до грешке нагиба, пошаљите обавештење са локацијом и прикажите маркер на мапи“.

Централни контролни ентитет је ентитет косилицаОдавде можете наставити програм, паузирати кошење или паркирати робота до следећег заказаног времена. Код неких модела, креирају се и нумерички ентитети за подешавање општа висина кошења (од 1 до 9) и висину кошења по радној површини (од 0% до 100% у односу на основну висину), тако да можете прилагодити кошење различитим деловима баште.

Такође постоје одабрани ентитети за контролу, на пример, режима рада фарова косилице, и веома свеобухватних сензора за трајање батерије, време коришћења сечива, грешке, периоде неактивности, разлоге ограничења (мраз, дневно ограничење, недељни распоред...), преостало време пуњења, тренутни режим, следеће покретање, број циклуса пуњења, судара, акумулираног времена кошења, претраге, вожње итд., као и назив... активно радно подручје.

За сваку радну област са активираним систематским сечењем, креирају се додатни сензори са напретком у процентима и датумом/временом последњег завршетка, што олакшава аутоматизацију као што је „ако напредак области X достигне 100%, обавести и пошаљи робота у базу“.

Интеграција такође генерише прекидаче за контролу зоне искључења (зоне забране)Ови прекидачи вам омогућавају да активирате или деактивирате глобални програм кошења робота и да омогућите или онемогућите сваку радну област засебно. Помоћу ових прекидача можете да одлучите, на пример, да робот треба да избегава одређену област када организујете забаву на травњаку.

Што се тиче конкретних акција, интеграција укључује позиве за пребриши програм (поништи распоред) и натерати робота да коси или паркира одређени период (од 1 минута до 42 дана), са трајањем одређеним у данима, сатима и минутима. Такође му можете дати команду да коси одређену радну површину одређено време, користећи ИД подручја добијен од одговарајућег сензора.

Важно је бити свестан неких ограничења дизајна: не можете покренути косилицу једноставно помоћу `lawn_mower.start_mowing` ван заказаног времена; за то морате користити акције замене. Такође, на моделима са EPOS технологијом, управљање зоном искључења још увек није подржано у овој званичној интеграцији.

Шта корисник добија када почне са коришћењем Home Assistant-а и тражи косилицу?

Ако сте у раним фазама истраживања коју роботску косилицу да купите (на пример, разматрате Мамоушн Јука Мини 700/800 или Ecovacs Goat) и инсталирали сте Home Assistant само „само да га испробате“, можда се питате да ли се исплати упуштати у све ове интеграционе ствари.

Одговор је обично потврдан, посебно ако планирате своју башту и кућу као кохерентан систем: интеграцијом косилице са кућним асистентом добијате много већа контрола и видљивост Са званичном апликацијом, ово се претвара у мање изненађења и већу аутономију у свакодневној употреби.

У конкретном случају Јуке/Лубе, интеграција са Маммоушном вам омогућава да:

• Проверите на први поглед статус, батерија, позиција и зона са панела Кућни асистент.
• Смањења лансирања условљена су правилима као што су време, присуство или производња соларне енергије.
• Синхронизујте распореде са породичним календарима или кућним режимима (одсутан, одмор, ноћ...).
• Истражите напредне сценарије као што су изложеност Apple Home-у преко Matter-а да га контролише као да је роботски усисивач.

Да бисте заиста извукли максимум из тога, поред косилице за траву, биће вам потребни и неки основни елементи кућне аутоматизације: нека поуздана временска интеграција (метеосат, AccuWeather, локална станица), сензори присуства или камере ако желите да блокирате прекид када су људи у близини, и, ако имате соларне панеле, интегришите их у ХА да бисте се играли логиком вишкова.

Напор потребан за подешавање свега може у почетку изгледати велики, али када се почетне аутоматизације заврше, систем ради прилично глатко и ваш робот постаје „тај фриленсерски колега који ради иза кулиса“Али сада поштујући правила која узимају у обзир шта се заиста дешава у вашој кући и башти.

На крају крајева, интеграција паметне косилице у Home Assistant, било да је то Mammotion, Bosch Indego преко MQTT-а или Husqvarna Automower са његовим званичним API-јем, трансформише наизглед једноставну функцију попут кошења травњака у... још један део слагалице кућне аутоматизацијеусклађено са климом, енергијом, присуством и навикама породице, нешто што је приметно и у удобности и у спокоју када башта брине о себи скоро сама и једва да се сећате да тамо ради робот.