Husqvarna-автоматическая газонокосилка (Connect)

Этот адаптер использует официальный Automower Connect API Husqvarna для запроса и управления данными вашей газонокосилки через модуль подключения. Полный, активно поддерживаемый форк iobroker.husqvarna-automower с полной поддержкой API.

Адаптер husqvarna-automower-connect для ioBroker

Этот адаптер получает данные с вашей газонокосилки Husqvarna с сайта https://developer.husqvarnagroup.cloud через "новое" соединение WebSocket и работает с API Automower Connect v1.0.0/OAS 3.0.

Это полностью поддерживаемая и активно разрабатываемая версия ice987987/ioBroker.husqvarna-automower . Она исправляет несколько команд записи (START ,STARTINWORKAREA ,PARK ,CUTTINGHEIGHT ,DATETIME ,HEADLIGHT ) которые были отклонены API из-за некорректного тела запроса, и добавляет полное покрытие официального API: подтверждение ошибок, высота/включение резки для каждой рабочей зоны, включение/отключение зон, находящихся вне зоны, и история сообщений об ошибках/событиях. Полная благодарность ice987987 за оригинальный адаптер, на основе которого построен этот проект.

Отказ от ответственности

Все названия продуктов и компаний, а также логотипы являются товарными знаками™ или зарегистрированными® товарными знаками соответствующих владельцев. Их использование не подразумевает какой-либо связи с ними или их дочерними компаниями, а также не подразумевает одобрения с их стороны! Этот личный проект ведется в свободное время и не преследует коммерческих целей. Husqvarna Automower является товарным знаком Husqvarna Group.

Требования к установке

Требуется Node.js версии >= 22.
Требуется ioBroker.js-controller версии >=6.0.11.
Для работы требуется ioBroker.admin версии не ниже 7.8.23.
Этот адаптер использует API Husqvarna Automower Connect для запроса данных (через WebSocket) и отправки команд (через REST API) для вашей газонокосилки Husqvarna.

Пожалуйста, создайте учетную запись и сгенерируйте свой персональный аккаунт.Application key иApplication secret Следуйте этим инструкциям по адресу https://developer.husqvarnagroup.cloud .Redirect URLs может бытьhttp://localhost:8080 )

Контроль

На газонокосилку Husqvarna можно передавать следующие значения:

.ACTIONS.PAUSE : пауза косилка
.ACTIONS.PARKUNTILNEXTSCHEDULE : припарковать газонокосилку до следующего запланированного запуска
.ACTIONS.PARKUNTILFURTHERNOTICE : косилка в парке до дальнейшего уведомления, график работы отменяется.
.ACTIONS.park.PARK : припарковать газонокосилку на определенный период времени.ACTIONS.park.parkTime (в минутах), с отменой расписания
.ACTIONS.RESUMESCHEDULE Возобновить работу газонокосилки в соответствии с графиком.
.ACTIONS.start.START Запустите газонокосилку и косите в течение определенного времени..ACTIONS.start.startTime (в минутах), с отменой расписания
.ACTIONS.startInWorkArea.STARTINWORKAREA Запустите газонокосилку и косите в течение определенного времени..ACTIONS.startInWorkArea.duration (в минутах, необязательно, если равно нулю (0), то изменение будет действовать постоянно), в области с идентификатором .ACTIONS.startInWorkArea.workAreaId¹
.ACTIONS.CUTTINGHEIGHTОбновите параметр cuttingHeight и получите текущий статус. ²³
.ACTIONS.DATETIMEДата и время в секундах с 1 января 1970 года, отображаемые на газонокосилке. Метка времени используется газонокосилкой для запуска расписания. В данный момент получить метку времени с газонокосилки невозможно.
.ACTIONS.HEADLIGHT Обновите информацию о фарах и получите текущий статус.¹
.ACTIONS.schedule.SET Обновите график работы газонокосилки..ACTIONS.schedule.[i].start (минуты после полуночи),.ACTIONS.schedule.[i].duration (в минутах),.ACTIONS.schedule.[i].monday ,.ACTIONS.schedule.[i].tuesday ,.ACTIONS.schedule.[i].wednesday ,.ACTIONS.schedule.[i].thursday ,.ACTIONS.schedule.[i].friday ,.ACTIONS.schedule.[i].saturday ,.ACTIONS.schedule.[i].sunday и.ACTIONS.schedule.[i].workAreaId и получить текущий статус²
.ACTIONS.REFRESHSTATISTICS Обновление значений статистики вне установленного расписания.
.ACTIONS.RESETCUTTINGBLADEUSAGETIME Сбросить счетчик времени использования режущего лезвия..statistics.cuttingBladeUsageTime ). Та же функция, что и в приложении Automower Connect, используется после замены лезвий.
.ACTIONS.CONFIRMERROR Подтверждение некритической ошибки газонокосилки (доступно только если).capabilities.canConfirmError являетсяtrue и работает только при условии, что.mower.isErrorConfirmable являетсяtrue )
.ACTIONS.workAreaSettings.APPLYWORKAREASETTINGS : Обновлять.cuttingHeight (0-100%) и/или.enabled для рабочей зоны, указанной .ACTIONS.workAreaSettings.workAreaId¹
.ACTIONS.stayOutZoneSettings.APPLYSTAYOUTZONESETTINGS: Обновлять.enabled для зоны, куда запрещен вход, заданной.ACTIONS.stayOutZoneSettings.zoneId (невозможно, пока.stayOutZones.dirty являетсяtrue )⁴

Доступные значения (только для чтения)

Ваша газонокосилка Husqvarna выдает следующие значения:

.battery.batteryPercent Информация об аккумуляторе газонокосилки Automower.
.capabilities.canConfirmError Если газонокосилка Automower поддерживает команду подтверждения ошибки, то ошибка также должна быть подтверждаемой.
.capabilities.headlights Если автогазонокосилка поддерживает фары, значит, фары недоступны.
.capabilities.position: Если газонокосилка Automower поддерживает определение местоположения по GPS. Если значение равно false, данные о местоположении недоступны.
.capabilities.stayOutZones Если автогазонокосилка поддерживает зоны, куда вход воспрещен. Если значение равно false, зоны, куда вход воспрещен, недоступны.
.capabilities.workAreas : Если автокосилка поддерживает рабочие зоны. Если нет, рабочие зоны недоступны.
.metadata.connected Подключена ли газонокосилка в данный момент к облаку? Для отправки команд необходимо подключение.
.metadata.statusTimestamp : Отметка времени последнего обновления статуса в миллисекундах с 1970-01-01T00:00:00 по времени UTC. ПРИМЕЧАНИЕ! Эта отметка времени генерируется в бэкэнде, а не газонокосилкой.
.mower.mode Информация о текущем режиме работы газонокосилки.
.mower.activity Информация о текущем состоянии газонокосилок.
.mower.inactiveReason Причина неактивности:
.mower.state Информация о текущем состоянии газонокосилок.
.mower.workAreaId : Идентификатор текущей рабочей зоны. Если газонокосилка поддерживает рабочие зоны и работает в рабочей зоне. Если текущая рабочая зона не выбрана, этот атрибут не устанавливается.
.mower.errorCode Информация о текущем состоянии ошибки газонокосилки.
.mower.errorTimestamp : Отметка времени последнего кода ошибки в миллисекундах с 1970-01-01T00:00:00 по местному времени. ПРИМЕЧАНИЕ! Эта отметка времени указана по местному времени газонокосилки и получена непосредственно от неё.
.mower.isErrorConfirmable Если у газонокосилки есть код ошибки (errorCode), этот атрибут указывает, можно ли подтвердить ошибку.
.planner.override В Планировщике есть функция переопределения, которая позволяет отменить действие, заданное Календарем. Предусмотрена возможность только одного переопределения за раз, и оно вступает в силу с текущего момента и действует в течение определенного периода времени.
.planner.nextStartTimestamp : Временная метка следующего автоматического запуска в миллисекундах с 1970-01-01T00:00:00 по местному времени. Если газонокосилка заряжается, то это значение — приблизительное время, когда она покинет зарядную станцию. Если значение равно 0, то газонокосилка должна запуститься сейчас. ВНИМАНИЕ! Эта временная метка указана по местному времени для газонокосилки и поступает непосредственно от неё.
.planner.restrictedReason Причина ограниченного доступа.
.planner.externalReason Причина установки: внешняя, заданная, например, IFTTT, Google Assistant или Amazon Alexa. Диапазоны: 1000–1999: Google Assistant; 2000–2999: Amazon Alexa; 3000–3999: портал разработчика; 4000–4999: IFTTT, учет дикой природы — 4000, защита от мороза и дождя — 4001 и подключение к календарю — 4002; 100000–199999: апплеты IFTTT; 200000–299999: портал разработчика.
.positions.latitude : Широта местоположения⁵
.positions.longitude Положение, долгота⁵
.positions.latlong Положение "широта; долгота"⁵
.positions.positions Позиции⁵
.stayOutZones.dirty Если зоны, куда вход воспрещен, синхронизированы с облаком Husqvarna, то при наличии некорректных данных на карте включить или отключить зону, куда вход воспрещен.¹
.stayOutZones.zones Список всех зон, куда запрещено заходить газонокосилке Automower.¹
.statistics.cuttingBladeUsageTime : Количество секунд, прошедших с момента последнего сброса счетчика использования режущего лезвия.¹
.statistics.numberOfChargingCycles : Количество циклов зарядки.¹
.statistics.numberOfCollisions Общее количество столкновений.¹
.statistics.totalChargingTime Общее время зарядки в секундах.¹
.statistics.totalCuttingTime Общее время резки в секундах.¹
.statistics.totalDriveDistance Общее пройденное расстояние в метрах. Это расчетное значение, вычисляемое путем умножения общего времени работы на среднюю скорость газонокосилки в зависимости от модели.¹
.statistics.totalRunningTime Общее время работы в секундах (с учетом времени работы колесных двигателей).¹
.statistics.totalSearchingTime Общее время поиска в секундах.¹
.system.id : Идентификатор устройства
.system.model : Название модели газонокосилки-автомата
.system.name : Имя, присвоенное пользователю газонокосилке при сопряжении с ней.
.system.serialNumber Серийный номер газонокосилки Automower.
.system.type : Тип устройства
.workAreas.[workAreaId].workAreaId : Идентификатор рабочей области¹
.workAreas.[workAreaId].name Название рабочей зоны¹
.workAreas.[workAreaId].cuttingHeight Высота среза в процентах (0 ... 100%)¹
.workAreas.[workAreaId].enabled : Включена или отключена рабочая область.¹
.workAreas.[workAreaId].progress : Информация о ходе работ. Доступно только для газонокосилок EPOS и системного скашивания.¹
.workAreas.[workAreaId].lastTimeCompleted Отметка времени в секундах с 1 января 1970 года, когда последний раз выполнялась работа на данном участке. Отметка времени указана по местному времени на газонокосилке. Доступно только для газонокосилок EPOS и участков с систематическим скашиванием.
.workAreas.[workAreaId].lastTimeAbandoned Отметка времени в секундах с 1 января 1970 года, когда рабочая зона в последний раз была заброшена. Доступно только для газонокосилок EPOS и зон с систематическим скашиванием.
.workAreas.[workAreaId].typeТип рабочей зоны (random илиsystematic кошение).
.workAreas.[workAreaId].useGlobalCuttingHeight : Еслиtrue Вместо этого используется глобальная настройка высоты среза..cuttingHeight данной рабочей зоны.
.workAreas.[workAreaId].orientation Настроенная ориентация скашивания в градусах. Только для участков, где требуется систематическое скашивание.
.workAreas.[workAreaId].orientationShift : Добавлено смещение между сеансами кошения в градусах. Только для зон систематического кошения.
.workAreas.[workAreaId].currentOrientation Текущая ориентация скашивания в градусах. Только для участков, где требуется систематическое скашивание.
.messages.messages Полный список сообщений об ошибках/событиях, возвращаемых API (массив JSON, начиная с самых последних, максимум ~1000 записей).
.messages.lastTime ,.messages.lastCode ,.messages.lastSeverity ,.messages.lastLatitude ,.messages.lastLongitude : В разделе «Удобство» отображается самое последнее сообщение, обновляемое как путем опроса, так и в режиме реального времени через WebSocket.message событие push.

привязки ioBroker.vis

Следующий код можно использовать для привязки HTML-кода в адаптере ioBroker.vis , чтобы преобразовать описание статуса и коды ошибок в текст для лучшей визуализации:

Точка данныхhusqvarna-automower-connect.0.[mowerID from DP .system.id].mower.errorCode :

(EN)

{value1:husqvarna-automower-connect.0.[mowerID from DP .system.id].mower.errorCode;value1 === "0" ? "Unexpected error" :: (value1 === "1" ? "Outside working area" :: (value1 === "2" ? "No loop signal" :: (value1 === "3" ? "Wrong loop signal" :: (value1 === "4" ? "Loop sensor problem, front" :: (value1 === "5" ? "Loop sensor problem, rear" :: (value1 === "6" ? "Loop sensor problem, left" :: (value1 === "7" ? "Loop sensor problem, right" :: (value1 === "8" ? "Wrong PIN code" :: (value1 === "9" ? "Trapped" :: (value1 === "10" ? "Upside down" :: (value1 === "11" ? "Low battery" :: (value1 === "12" ? "Empty battery" :: (value1 === "13" ? "No drive" :: (value1 === "14" ? "Mower lifted" :: (value1 === "15" ? "Lifted" :: (value1 === "16" ? "Stuck in charging station" :: (value1 === "17" ? "Charging station blocked" :: (value1 === "18" ? "Collision sensor problem, rear" :: (value1 === "19" ? "Collision sensor problem, front" :: (value1 === "20" ? "Wheel motor blocked, right" :: (value1 === "21" ? "Wheel motor blocked, left" :: (value1 === "22" ? "Wheel drive problem, right" :: (value1 === "23" ? "Wheel drive problem, left" :: (value1 === "24" ? "Cutting system blocked" :: (value1 === "25" ? "Cutting system blocked" :: (value1 === "26" ? "Invalid sub-device combination" :: (value1 === "27" ? "Settings restored" :: (value1 === "28" ? "Memory circuit problem" :: (value1 === "29" ? "Slope too steep" :: (value1 === "30" ? "Charging system problem" :: (value1 === "31" ? "STOP button problem" :: (value1 === "32" ? "Tilt sensor problem" :: (value1 === "33" ? "Mower tilted" :: (value1 === "34" ? "Cutting stopped - slope too steep" :: (value1 === "35" ? "Wheel motor overloaded, right" :: (value1 === "36" ? "Wheel motor overloaded, left" :: (value1 === "37" ? "Charging current too high" :: (value1 === "38" ? "Electronic problem" :: (value1 === "39" ? "Cutting motor problem" :: (value1 === "40" ? "Limited cutting height range" :: (value1 === "41" ? "Unexpected cutting height adj" :: (value1 === "42" ? "Limited cutting height range" :: (value1 === "43" ? "Cutting height problem, drive" :: (value1 === "44" ? "Cutting height problem, curr" :: (value1 === "45" ? "Cutting height problem, dir" :: (value1 === "46" ? "Cutting height blocked" :: (value1 === "47" ? "Cutting height problem" :: (value1 === "48" ? "No response from charger" :: (value1 === "49" ? "Ultrasonic problem" :: (value1 === "50" ? "Guide 1 not found" :: (value1 === "51" ? "Guide 2 not found" :: (value1 === "52" ? "Guide 3 not found" :: (value1 === "53" ? "GPS navigation problem" :: (value1 === "54" ? "Weak GPS signal" :: (value1 === "55" ? "Difficult finding home" :: (value1 === "56" ? "Guide calibration accomplished" :: (value1 === "57" ? "Guide calibration failed" :: (value1 === "58" ? "Temporary battery problem" :: (value1 === "59" ? "Temporary battery problem" :: (value1 === "60" ? "Temporary battery problem" :: (value1 === "61" ? "Temporary battery problem" :: (value1 === "62" ? "Temporary battery problem" :: (value1 === "63" ? "Temporary battery problem" :: (value1 === "64" ? "Temporary battery problem" :: (value1 === "65" ? "Temporary battery problem" :: (value1 === "66" ? "Battery problem" :: (value1 === "67" ? "Battery problem" :: (value1 === "68" ? "Temporary battery problem" :: (value1 === "69" ? "Alarm! Mower switched off" :: (value1 === "70" ? "Alarm! Mower stopped" :: (value1 === "71" ? "Alarm! Mower lifted" :: (value1 === "72" ? "Alarm! Mower tilted" :: (value1 === "73" ? "Alarm! Mower in motion" :: (value1 === "74" ? "Alarm! Outside geofence" :: (value1 === "75" ? "Connection changed" :: (value1 === "76" ? "Connection NOT changed" :: (value1 === "77" ? "Com board not available" :: (value1 === "78" ? "Slipped - Mower has Slipped. Situation not solved with moving pattern" :: (value1 === "79" ? "Invalid battery combination - Invalid combination of different battery types." :: (value1 === "80" ? "Cutting system imbalance --Warning--" :: (value1 === "81" ? "Safety function faulty" :: (value1 === "82" ? "Wheel motor blocked, rear right" :: (value1 === "83" ? "Wheel motor blocked, rear left" :: (value1 === "84" ? "Wheel drive problem, rear right" :: (value1 === "85" ? "Wheel drive problem, rear left" :: (value1 === "86" ? "Wheel motor overloaded, rear right" :: (value1 === "87" ? "Wheel motor overloaded, rear left" :: (value1 === "88" ? "Angular sensor problem" :: (value1 === "89" ? "Invalid system configuration" :: (value1 === "90" ? "No power in charging station" :: (value1 === "91" ? "Switch cord problem" :: (value1 === "92" ? "Work area not valid" :: (value1 === "93" ? "No accurate position from satellites" :: (value1 === "94" ? "Reference station communication problem" :: (value1 === "95" ? "Folding sensor activated" :: (value1 === "96" ? "Right brush motor overloaded" :: (value1 === "97" ? "Left brush motor overloaded" :: (value1 === "98" ? "Ultrasonic Sensor 1 defect" :: (value1 === "99" ? "Ultrasonic Sensor 2 defect" :: (value1 === "100" ? "Ultrasonic Sensor 3 defect" :: (value1 === "101" ? "Ultrasonic Sensor 4 defect" :: (value1 === "102" ? "Cutting drive motor 1 defect" :: (value1 === "103" ? "Cutting drive motor 2 defect" :: (value1 === "104" ? "Cutting drive motor 3 defect" :: (value1 === "105" ? "Lift Sensor defect" :: (value1 === "106" ? "Collision sensor defect" :: (value1 === "107" ? "Docking sensor defect" :: (value1 === "108" ? "Folding cutting deck sensor defect" :: (value1 === "109" ? "Loop sensor defect" :: (value1 === "110" ? "Collision sensor error" :: (value1 === "111" ? "No confirmed position" :: (value1 === "112" ? "Cutting system major imbalance" :: (value1 === "113" ? "Complex working area" :: (value1 === "114" ? "Too high discharge current" :: (value1 === "115" ? "Too high internal current" :: (value1 === "116" ? "High charging power loss" :: (value1 === "117" ? "High internal power loss" :: (value1 === "118" ? "Charging system problem" :: (value1 === "119" ? "Zone generator problem" :: (value1 === "120" ? "Internal voltage error" :: (value1 === "121" ? "High internal temerature" :: (value1 === "122" ? "CAN error" :: (value1 === "123" ? "Destination not reachable" :: (value1 === "124" ? "Destination blocked" :: (value1 === "125" ? "Battery needs replacement" :: (value1 === "126" ? "Battery near end of life" :: (value1 === "127" ? "Battery problem" :: (value1 === "128" ? "Multiple reference stations detected" :: (value1 === "129" ? "Auxiliary cutting means blocked" :: (value1 === "130" ? "Imbalanced auxiliary cutting disc detected" :: (value1 === "131" ? "Lifted in link arm" :: (value1 === "132" ? "EPOS accessory missing" :: (value1 === "133" ? "Bluetooth com with CS failed" :: (value1 === "134" ? "Invalid SW configuration" :: (value1 === "135" ? "Radar problem" :: (value1 === "136" ? "Work area tampered" :: (value1 === "137" ? "High temperature in cutting motor, right" :: (value1 === "138" ? "High temperature in cutting motor, center" :: (value1 === "139" ? "High temperature in cutting motor, left" :: (value1 === "141" ? "Wheel brush motor problem" :: (value1 === "143" ? "Accessory power problem" :: (value1 === "144" ? "Boundary wire problem" :: (value1 === "701" ? "Connectivity problem" :: (value1 === "702" ? "Connectivity settings restored" :: (value1 === "703" ? "Connectivity problem" :: (value1 === "704" ? "Connectivity problem" :: (value1 === "705" ? "Connectivity problem" :: (value1 === "706" ? "Poor signal quality" :: (value1 === "707" ? "SIM card requires PIN" :: (value1 === "708" ? "SIM card locked" :: (value1 === "709" ? "SIM card not found" :: (value1 === "710" ? "SIM card locked" :: (value1 === "711" ? "SIM card locked" :: (value1 === "712" ? "SIM card locked" :: (value1 === "713" ? "Geofence problem" :: (value1 === "714" ? "Geofence problem" :: (value1 === "715" ? "Connectivity problem" :: (value1 === "716" ? "Connectivity problem" :: (value1 === "717" ? "SMS could not be sent" :: (value1 === "724" ? "Communication circuit board SW must be updated" :: "errorCode #" + value1 + " unknown")))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))}

Точка данныхhusqvarna-automower-connect.0.[mowerID from DP .system.id].mower.activity :

(EN)

{value1:husqvarna-automower-connect.0.[mowerID from DP .system.id].mower.activity;value1 === "UNKNOWN" ? "Unknown activity" :: (value1 === "NOT_APPLICABLE" ? "Manual start required in mower." :: (value1 === "MOWING" ? "Mower is mowing lawn. If in demo mode the blades are not in operation." :: (value1 === "GOING_HOME" ? "Mower is going home to the charging station." :: (value1 === "CHARGING" ? "Mower is charging in station due to low battery." :: (value1 === "LEAVING" ? "Mower is leaving the charging station." :: (value1 === "PARKED_IN_CS" ? "Mower is parked in charging station." :: (value1 === "STOPPED_IN_GARDEN" ? "Mower has stopped. Needs manual action to resume." :: "activity #" + value1 + " unknown")))))))}

Точка данныхhusqvarna-automower-connect.0.[mowerID from DP .system.id].mower.mode :

(EN)

{value1:husqvarna-automower-connect.0.[mowerID from DP .system.id].mower.mode;value1 === "MAIN_AREA" ? "Mower will mow until low battery. Go home and charge. Leave and continue mowing. Week schedule is used. Schedule can be overridden with forced park or forced mowing." :: (value1 === "DEMO" ? "No blade operation - Mower will mow until low battery. Go home and charge. Leave and continue mowing. Week schedule is used. Schedule can be overridden with forced park or forced mowing." :: (value1 === "SECONDARY_AREA" ? "Mower is in secondary area. Schedule is overridden with forced park or forced mowing. Mower will mow for request time or untill the battery runs out." :: (value1 === "HOME" ? "Mower goes home and parks forever. Week schedule is not used. Cannot be overridden with forced mowing." :: (value1 === "UNKNOWN" ? "Unknown mode" :: "mode #" + value1 + " unknown"))))}

Точка данныхhusqvarna-automower-connect.0.[mowerID from DP .system.id].mower.state :

(EN)

{value1:husqvarna-automower-connect.0.[mowerID from DP .system.id].mower.state;value1 === "UNKNOWN" ? "Unknown state" :: (value1 === "NOT_APPLICABLE" ? "Not Applicable" :: (value1 === "PAUSED" ? "Mower has been paused by user." :: (value1 === "IN_OPERATION" ? "See value in activity for status." :: (value1 === "WAIT_UPDATING" ? "Mower is downloading new firmware." :: (value1 === "WAIT_POWER_UP" ? "Mower is performing power up tests." :: (value1 === "RESTRICTED" ? "Mower can currently not mow due to week calender, or override park." :: (value1 === "OFF" ? "Mower is turned off." :: (value1 === "STOPPED" ? "Mower is stopped, requires manual action." :: (value1 === "ERROR" ? "An error has occurred. Check errorCode. Mower requires manual action." :: (value1 === "FATAL_ERROR" ? "An fatal error has occurred. Check errorCode. Mower requires manual action." :: (value1 === "ERROR_AT_POWER_UP" ? "An error at power up has occurred. Check errorCode. Mower requires manual action." :: "state #" + value1 + " unknown")))))))))))}

Скрипт для статистики

(Первоначальный сценарий от @ArnoD15, изменен @ice987987)

Будет рассчитано следующее значение:

Время зарядки сегодня и общее время зарядки
Время кошения сегодня и общее время кошения
Пройденное расстояние сегодня и пройденное расстояние всего
Расстояние между газонокосилкой и зарядной станцией
Преобразуйте время начала и окончания расписаний в минуты и часы.
Создать/обновить ссылку на Google Maps
Возможность оставить газонокосилку на обочину во время дождя до следующего запланированного времени.
Расчет оставшегося времени работы ножа в процентах.

Для использования скопируйте следующий код в новый JavaScript -скрипт и заполните следующие переменные:instance ,pathLevel1 ,pathLevel2 ,mowerID ,sID_RainSensor иtargetBladeCuttingTime в разделеUSER CONFIGURATION .

//***************************************************************************************************
//++++++++++++++++++++++++++++++++++++++++ USER CONFIGURATION +++++++++++++++++++++++++++++++++++++++

const instance = '0_userdata.0';                                                    // Type your instance name
const pathLevel1 = 'husqvarna';                                                     // Type your path name
const pathLevel2 = ['statistics', 'schedules', 'general', 'blades', 'actions'];     // Type your folder names
const mowerID = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';                             // Mower ID from Husqvarna automower
const sID_RainSensor = 'hm-rpc.0.12345678901234.1.RAINING';                         // Path rain sensor (true = rain)
const targetBladeCuttingTime = 180_000_000;                                         // Which time should a set of knives run in milliseconds (180_000_000ms = 50h)

//++++++++++++++++++++++++++++++++++++++ END USER CONFIGURATION +++++++++++++++++++++++++++++++++++++
//***************************************************************************************************

// create required folders and states
createState();
async function createState() {
    for (let i = 0; i < 4; i++) {
        createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[1]}.startTime_${i}`, '00:00', false, {name: `Schedule ${i} start time`, role: 'value', type: 'string', read: true, write: true, def: '00:00'});
        createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[1]}.endTime_${i}`, '00:00', false, {name: `Schedule ${i} end time`, role: 'value', type: 'string', read: true, write: true, def: '00:00'});
    };
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[0]}.drivenDistanceToday`, 0, false, {name: 'Driven Distance Today', role: 'state', type: 'number', read: true, write: false, def: 0, unit: 'km'});
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[0]}.drivenDistanceTotal`, 0, false, {name: 'Driven Distance Total', role: 'state', type: 'number', read: true, write: false, def: 0, unit: 'km'});
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[0]}.chargingTimeToday`, 0, false, {name: 'Charging Time Today', role: 'state', type: 'number', read: true, write: false, def: 0, unit: 'ms'});
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[0]}.mowingTimeToday`, 0, false, {name: 'Mowing Time Total', role: 'state', type: 'number', read: true, write: false, def: 0, unit: 'ms'});
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[3]}.currentBladeCuttingTime`, 0, false, {name: 'Current Blade Cutting Time', desc: 'How many seconds was the current set of knives run', role: 'state', type: 'number', read: true, write: false, def: 0, unit: 'ms'});
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[3]}.reset`, false, false, {name: 'Reset', desc: 'Restart counter after knife change', role: 'button', type: 'boolean', read: true, write: true, def: false});
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[3]}.changeBlades`, false, false, {name: 'Change Blades', role: 'state', type: 'boolean', read: true, write: false, def: false});
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[3]}.remainingCuttingCapacity`, 100, false, {name: 'Remaining cutting Capacity', desc: 'in percent', role: 'state', type: 'number', read: true, write: false, def: 100, max: 100, unit: '%'});
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[0]}.distanceFromChargingStation`, 0, false, {name: 'Distance from charging station', role: 'state', type: 'number', read: true, write: false, def: 0, unit: 'm'});
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[2]}.GoogleMapsLink`, '', false, {name: 'Google Maps Link', role: 'value', type: 'string', read: true, write: false, def: ''});
    await createStateAsync(`${instance}.${pathLevel1}.${pathLevel2[4]}.parkAfterNextChargingCycle`, false, false, {name: 'Park after next charging cycle', role: 'state', type: 'boolean', read: true, write: true, def: false});
    log('-==== folders and states created ====-', 'debug');
};

const sID_HusqvarnaSchedules = [];
$(`state[id=husqvarna-automower-connect.0.${mowerID}.ACTIONS.schedule.*.start]`).each(function(id) {
    sID_HusqvarnaSchedules.push(id);
});
$(`state[id=husqvarna-automower-connect.0.${mowerID}.ACTIONS.schedule.*.duration]`).each(function(id) {
    sID_HusqvarnaSchedules.push(id);
});

let drivenDistanceToday = getState(`${instance}.${pathLevel1}.${pathLevel2[0]}.drivenDistanceToday`).val;
let drivenDistanceTotal = getState(`${instance}.${pathLevel1}.${pathLevel2[0]}.drivenDistanceTotal`).val;
let drivenDistance = 0;
let chargingTimeToday = getState(`${instance}.${pathLevel1}.${pathLevel2[0]}.chargingTimeToday`).val;
let chargingTime = 0;
let mowingTimeToday = getState(`${instance}.${pathLevel1}.${pathLevel2[0]}.mowingTimeToday`).val;
let mowingTime = 0;
let bladeCuttingTime = 0;
let remainingBladeCapacity = 0;
let chargingStationLatitude = 0;
let chargingStationLongitude = 0;
let distanceFromChargingStation = 0;

// reset variables "[...]Today" every midnight
schedule('0 0 * * *', function () {
    drivenDistanceToday = 0;
    setState(`${instance}.${pathLevel1}.${pathLevel2[0]}.drivenDistanceToday`, drivenDistanceToday, true);
    chargingTimeToday = 0;
    setState(`${instance}.${pathLevel1}.${pathLevel2[0]}.chargingTimeToday`, chargingTimeToday, true);
    mowingTimeToday = 0;
    setState(`${instance}.${pathLevel1}.${pathLevel2[0]}.mowingTimeToday`, mowingTimeToday, true);
});

// get chargingTimeToday and chargingTimeTotal
on({id: `husqvarna-automower-connect.0.${mowerID}.mower.activity`, oldVal: 'CHARGING'}, function (obj) {
    chargingTime = obj.state.ts - obj.oldState.ts;
    log(`chargingTime: ${chargingTime / 1000}s`, 'debug');
    chargingTimeToday = chargingTime + chargingTimeToday;
    setState(`${instance}.${pathLevel1}.${pathLevel2[0]}.chargingTimeToday`, chargingTimeToday, true);
});

// get mowingTimeToday, mowingTimeTotal, bladeCuttingTime and remainingBladeCapacity
on({id: `husqvarna-automower-connect.0.${mowerID}.mower.activity`, oldVal: 'MOWING'}, function (obj) {
    mowingTime = obj.state.ts - obj.oldState.ts;
    log(`mowingTime: ${mowingTime / 1000}s`, 'debug');
    mowingTimeToday = mowingTime + mowingTimeToday;
    setState(`${instance}.${pathLevel1}.${pathLevel2[0]}.mowingTimeToday`, mowingTimeToday, true);

    let currentBladeCuttingTime = getState(`${instance}.${pathLevel1}.${pathLevel2[3]}.currentBladeCuttingTime`).val;

    bladeCuttingTime = mowingTime + currentBladeCuttingTime;
    setState(`${instance}.${pathLevel1}.${pathLevel2[3]}.currentBladeCuttingTime`, bladeCuttingTime, true);

    remainingBladeCapacity = 100 - (currentBladeCuttingTime * 100) / targetBladeCuttingTime;
    setState(`${instance}.${pathLevel1}.${pathLevel2[3]}.remainingCuttingCapacity`, remainingBladeCapacity, true);
});

// reset values after blade change
on({id: `${instance}.${pathLevel1}.${pathLevel2[3]}.reset`, val: true, ack: false}, function () {
    setState(`${instance}.${pathLevel1}.${pathLevel2[3]}.remainingCuttingCapacity`, 100, true);
    setState(`${instance}.${pathLevel1}.${pathLevel2[3]}.changeBlades`, false, true);
    setState(`${instance}.${pathLevel1}.${pathLevel2[3]}.currentBladeCuttingTime`, 0, true);
});

// get distance from automower to charging station, drivenDistanceToday and drivenDistanceTotal
on({id: `husqvarna-automower-connect.0.${mowerID}.positions.latlong`, change: 'ne'}, async function (obj) {
    if (getState(`husqvarna-automower-connect.0.${mowerID}.mower.activity`).val === 'CHARGING' || getState(`husqvarna-automower-connect.0.${mowerID}.mower.activity`).val === 'PARKED_IN_CS') {
        if (chargingStationLatitude !== 0 && chargingStationLongitude !== 0) {
            chargingStationLatitude = (Number(obj.state.val.split(';')[0]) + Number(chargingStationLatitude)) / 2;
            chargingStationLongitude = (Number(obj.state.val.split(';')[1]) + Number(chargingStationLongitude)) / 2;
        } else {
            chargingStationLatitude = obj.state.val.split(';')[0];
            chargingStationLongitude = obj.state.val.split(';')[1];
        };
    };
    distanceFromChargingStation = 1000 * (6378.388 * Math.acos(Math.sin(obj.state.val.split(';')[0] * (Math.PI / 180)) * Math.sin(chargingStationLatitude * (Math.PI / 180)) + Math.cos(obj.state.val.split(';')[0] * (Math.PI / 180)) * Math.cos(chargingStationLatitude * (Math.PI / 180)) * Math.cos(chargingStationLongitude * (Math.PI / 180) - obj.state.val.split(';')[1] * (Math.PI / 180)))); // reference: https://www.kompf.de/gps/distcalc.html
    log(`distanceFromChargingStation: ${round(distanceFromChargingStation, 2)}m`, 'debug');
    await setStateAsync(`${instance}.${pathLevel1}.${pathLevel2[0]}.distanceFromChargingStation`, distanceFromChargingStation, true);

    if (getState(`husqvarna-automower-connect.0.${mowerID}.mower.activity`).val === 'MOWING' || getState(`husqvarna-automower-connect.0.${mowerID}.mower.activity`).val === 'GOING_HOME' || getState(`husqvarna-automower-connect.0.${mowerID}.mower.activity`).val === 'LEAVING') {
        drivenDistance = 6378.388 * Math.acos(Math.sin(obj.state.val.split(';')[0] * (Math.PI / 180)) * Math.sin(obj.oldState.val.split(';')[0] * (Math.PI / 180)) + Math.cos(obj.state.val.split(';')[0] * (Math.PI / 180)) * Math.cos(obj.oldState.val.split(';')[0] * (Math.PI / 180)) * Math.cos(obj.oldState.val.split(';')[1] * (Math.PI / 180) - obj.state.val.split(';')[1] * (Math.PI / 180))); // reference: https://www.kompf.de/gps/distcalc.html
        log(`distanceDriven: ${round(drivenDistance * 1000, 2)}m`, 'debug');
        drivenDistanceToday = drivenDistanceToday + drivenDistance;
        drivenDistanceTotal = drivenDistanceTotal + drivenDistance;
        await setStateAsync(`${instance}.${pathLevel1}.${pathLevel2[0]}.drivenDistanceToday`, round(drivenDistanceToday, 2), true);
        await setStateAsync(`${instance}.${pathLevel1}.${pathLevel2[0]}.drivenDistanceTotal`, round(drivenDistanceTotal, 2), true);
    };
});

// Convert start and end time to minutes
$(`state[id=${instance}.${pathLevel1}.${pathLevel2[1]}.*]`).on(async function (obj) {
    if (obj.id.split('.')[obj.id.split('.').length - 1].split('_')[0] === 'startTime') {
        let startTime = obj.state.val.split(':')[0] * 60 + Number(obj.state.val.split(':')[1]);
        setState(`husqvarna-automower-connect.0.${mowerID}.ACTIONS.schedule.${obj.id.split('.')[obj.id.split('.').length - 1].split('_')[1]}.start`, startTime, false);
        let endTime = (await getStateAsync(`${instance}.${pathLevel1}.${pathLevel2[1]}.endTime_${obj.id.split('.')[obj.id.split('.').length - 1].split('_')[1]}`)).val;
        let duration = endTime.split(':')[0] * 60 + Number(endTime.split(':')[1]) - startTime;
        setState(`husqvarna-automower-connect.0.${mowerID}.ACTIONS.schedule.${obj.id.split('.')[obj.id.split('.').length - 1].split('_')[1]}.duration`, duration, false);
    } else {
        let startTime = (await getStateAsync(`${instance}.${pathLevel1}.${pathLevel2[1]}.startTime_${obj.id.split('.')[obj.id.split('.').length - 1].split('_')[1]}`)).val;
        let startTimeMin = startTime.split(':')[0] * 60 + Number(startTime.split(':')[1]);
        let duration = obj.state.val.split(':')[0] * 60 + Number(obj.state.val.split(':')[1]) - startTimeMin;
        setState(`husqvarna-automower-connect.0.${mowerID}.ACTIONS.schedule.${obj.id.split('.')[obj.id.split('.').length - 1].split('_')[1]}.duration`, duration, false);
    };
});

// Convert start and end time to hh:mm
on({id: sID_HusqvarnaSchedules, change: 'ne', ack: true}, async function (obj) {
    if (obj.id.split('.')[obj.id.split('.').length - 1] === 'start') {
        let m = obj.state.val % 60;
        let h = (obj.state.val - m) / 60;
        let HHMM = `${(h < 10 ? '0' : '')}${h.toString()}:${(m < 10 ? '0' : '')}${m.toString()}`;
        await setStateAsync(`${instance}.${pathLevel1}.${pathLevel2[1]}.startTime_${obj.id.split('.')[obj.id.split('.').length - 2]}`, HHMM, true);
        let endTime = obj.state.val + (await getStateAsync(`husqvarna-automower-connect.0.${mowerID}.ACTIONS.schedule.${obj.id.split('.')[obj.id.split('.').length - 2]}.duration`)).val;
        let m1 = endTime % 60;
        let h1 = (endTime - m1) / 60;
        let HHMM1 = `${(h1 < 10 ? '0' : '')}${h1.toString()}:${(m1 < 10 ? '0' : '')}${m1.toString()}`;
        await setStateAsync(`${instance}.${pathLevel1}.${pathLevel2[1]}.endTime_${obj.id.split('.')[obj.id.split('.').length - 2]}`, HHMM1, true);
    } else {
        let startTime = (await getStateAsync(`husqvarna-automower-connect.0.${mowerID}.ACTIONS.schedule.${obj.id.split('.')[obj.id.split('.').length - 2]}.start`)).val;
        let endTime = startTime + obj.state.val;
        let m = endTime % 60;
        let h = (endTime - m) / 60;
        let HHMM = `${(h < 10 ? '0' : '')}${h.toString()}:${(m < 10 ? '0' : '')}${m.toString()}`;
        await setStateAsync(`${instance}.${pathLevel1}.${pathLevel2[1]}.endTime_${obj.id.split('.')[obj.id.split('.').length - 2]}`, HHMM, true);
    };
});

// update google maps link
on({id: `husqvarna-automower-connect.0.${mowerID}.positions.latlong`, change: 'ne'}, async function (obj) {
    let arrayLatLong = getState(obj.id).val.split(';');
    let GoogleLink = `https://www.google.com/maps/place/${arrayLatLong[0]},${arrayLatLong[1]}/@?hl=de`;
    await setStateAsync(`${instance}.${pathLevel1}.${pathLevel2[2]}.GoogleMapsLink`, GoogleLink, true);
});

// during rain, park until next schedule
on({id: sID_RainSensor, change: 'ne', val: true}, async function () {
   await setStateAsync(`husqvarna-automower-connect.0.${mowerID}.ACTIONS.PARKUNTILNEXTSCHEDULE`, true);
   log('-==== It is raining. Mower is parked. ====-', 'info');
});

// park after next charging cycle
on({id: `husqvarna-automower-connect.0.${mowerID}.mower.activity`, change: 'ne', val: 'CHARGING'}, function () {
    if (getState(`${instance}.${pathLevel1}.${pathLevel2[4]}.parkAfterNextChargingCycle`).val) {
        setState(`husqvarna-automower-connect.0.${mowerID}.ACTIONS.PARKUNTILFURTHERNOTICE`, true, true);
        setState(`${instance}.${pathLevel1}.${pathLevel2[4]}.parkAfterNextChargingCycle`, false, true);
    };
});

// round
function round(digit, digits) {
    digit = (Math.round(digit * Math.pow(10, digits)) / Math.pow(10, digits));
    return digit;
};

Как сообщать о проблемах и отправлять запросы на добавление новых функций

Для сообщения об ошибках используйте GitHub Issues -> "Сообщить об ошибке" и заполните форму.

Установите для адаптера режим отладочного логирования (Экземпляры -> Экспертный режим -> Уровень логирования столбцов). Получите файл лога с диска (подкаталог "log" в каталоге установки ioBroker, а не из папки Admin, поскольку Admin обрезает строки). Перед публикацией лога убедитесь, что в нем нет личной информации.
Для отправки предложений по улучшению функционала, пожалуйста, используйте раздел "Проблемы" на GitHub -> "Запрос на добавление функции" и заполните форму.

Changelog

1.0.10 (2026-08-08)

Fix: the button role:read=false and workAreas..enabled role fixes from 1.0.9 only applied to newly created objects (setObjectNotExistsAsync never updates existing ones). Any installation upgrading from <=1.0.8 kept the old, incorrect values forever. migrateObjectRoles() now also force-corrects these two on every startup, exactly like it already does for the pre-1.0.3 issues. Verified against a live object dump: corrects exactly the 18 affected button states, no false positives.

1.0.9 (2026-08-08)

Fix all issues from the manual maintainer review (PR #6326): all 13 button states now use read:false as required by the button role spec; fixed a case-sensitivity bug (StartInWorkArea vs startInWorkArea) that made the STARTINWORKAREA command completely non-functional; added a 10s timeout to all 5 axios calls to prevent indefinite hangs on an unresponsive API; stayOutZones.zones is now JSON.stringify'd before setState as required for array-type states; workAreas..enabled now uses the correct 'indicator' role instead of the unrelated 'indicator.connected'; completed the placeholder zh-cn translation for statisticsIntervalHint; added validation (hasForbiddenChars) for the externally-sourced mower ID and workAreaId before using them in object paths - invalid values are rejected and logged rather than silently sanitized, since the mower ID is later parsed back out of the object path to address the real Husqvarna API.

1.0.8 (22.07.2026)

(Stefan Bühler) Documentation only: removed the e-mail address and corrected the name spelling in the README license section (the LICENSE file itself was already correct); commented out the number-of-installations badge, which cannot resolve until the adapter is available in the official ioBroker repository. No functional changes.

1.0.7 (22.07.2026)

(Stefan Bühler) Metadata only: standardized copyright/author to "Stefan Bühler" across package.json, io-package.json and LICENSE (dropped the GitHub username and email address from the copyright line; ice987987's original-author credit is unchanged). No functional changes.

1.0.6 (17.07.2026)

(Stefan Bühler) Documentation only: fixed the PayPal donate link, which previously used the wrong URL format and did not work.

1.0.5 (17.07.2026)

(Stefan Bühler) FIX: system.serialNumber declared type 'number', but role 'info.serial' only accepts 'string' - changed type and now writes the value as a string.
(Stefan Bühler) FIX: positions.latlong used role 'value.gps', which the store submission's object structure checker rejects for a compound 'latitude;longitude' string (despite this being the officially documented format for that role) - changed to role 'text' to satisfy the checker.
(Stefan Bühler) The startup migration added in 1.0.4 now also force-corrects these two, including objects that were only partially corrected by an earlier version of the migration.

1.0.4 (17.07.2026)

(Stefan Bühler) FIX: 1.0.3 corrected several wrong object roles/types (ACTIONS.HEADLIGHT, ACTIONS.schedule fields, messages.messages, system.id/type/serialNumber), but setObjectNotExistsAsync() never touches an object that already exists - so installations updating from before 1.0.3 kept the old, incorrect objects forever. Added a one-time startup migration that force-corrects exactly those known objects via extendObjectAsync(), without touching anything else.

1.0.3 and older

Older changelog entries can be found in CHANGELOG_OLD.md.

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Если значение отсутствует или равно нулю (0), газонокосилка не поддерживает это значение. ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷ ↩⁸ ↩⁹ ↩¹⁰ ↩¹¹ ↩¹² ↩¹³ ↩¹⁴ ↩¹⁵ ↩¹⁶ ↩¹⁷ ↩¹⁸
Не использовать для 550 EPOS и Ceora из -за ограничений API Husqvarna. ↩ ↩²
Неподдерживаемые модели: 405X, 415X и 435X AWD (вы получите ошибку "Эта газонокосилка использует миссии и не может быть обновлена с помощью этой конечной точки") ↩
доступно только если.capabilities.stayOutZones являетсяtrue ↩
Если GPS-сигнал отсутствует, эти значения не обновляются. ↩ ↩² ↩³ ↩⁴

Husqvarna-автоматическая газонокосилка (Connect)

Адаптер husqvarna-automower-connect для ioBroker

Отказ от ответственности

Требования к установке

Контроль

Доступные значения (только для чтения)

привязки ioBroker.vis

Скрипт для статистики

Как сообщать о проблемах и отправлять запросы на добавление новых функций

Changelog

1.0.10 (2026-08-08)

1.0.9 (2026-08-08)

1.0.8 (22.07.2026)

1.0.7 (22.07.2026)

1.0.6 (17.07.2026)

1.0.5 (17.07.2026)

1.0.4 (17.07.2026)

1.0.3 and older

License

Footnotes