smartGarden для умной системы Gardena

Адаптер ioBroker smartgarden для интеллектуальной системы GARDENA

Адаптер для интеллектуальной системы GARDENA, использующий официальный API и сервисы интеллектуальной системы GARDENA .

Адаптер позволяет разрабатывать приложения (например, с использованием VIS), которые можно использовать параллельно с официальным приложением GARDENA. Адаптер и его дополнительные функции не влияют на основные функции приложения GARDENA и наоборот.

Адаптер не является полной заменой приложения GARDENA, а лишь дополнением, позволяющим интегрировать устройства GARDENA в систему умного дома с помощью ioBroker. С помощью адаптера можно выполнять самые важные действия. Он также предоставляет возможность реализовать собственные идеи, которые невозможны с приложением GARDENA.

Поддерживаемые устройства

• Роботизированные газонокосилки GARDENA smart SILENO
• Система интеллектуального управления орошением GARDENA
• Насос высокого давления GARDENA Smart
• Система интеллектуального управления водоснабжением GARDENA
• Интеллектуальный адаптер питания GARDENA
• Умный датчик GARDENA

Более подробную информацию об устройствах можно найти на немецком сайте GARDENA , а также здесь (на английском языке) .

Требования

Для использования этого адаптера вам понадобятся следующие вещи:

1. учетная запись интеллектуальной системы GARDENA
2. ключ приложения GARDENA
3. секрет приложения GARDENA

Чтобы получить доступ к этим ресурсам, пожалуйста, перейдите на портал разработчиков Husqvarna по адресу https://developer.husqvarnagroup.cloud/ .

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

В настоящее время сайт выглядит так, как показано на следующих скриншотах.

Нажмите кнопку НОВОЕ ПРИЛОЖЕНИЕ

Отредактируйте форму, добавив свои данные. В настоящее время поле «URL-адреса перенаправления» не используется. Поэтому сейчас вы можете ввести любое значение. Нажмите кнопку «Создать».

На следующей странице вы получите ключ приложения и секретный ключ приложения . Эти значения понадобятся вам для настройки экземпляра адаптера. И вам нужно будет подключиться к API.

• API аутентификации и
• API интеллектуальной системы GARDENA.

Для этого нажмите кнопку «ПОДКЛЮЧИТЬ НОВЫЙ API» и выберите первый API. Повторите то же самое для второго API.

Примечание:

• Если у вас уже есть учетная запись Husqvarna Automower® Connect или GARDENA smart system, вы можете войти в систему с помощью этой учетной записи и продолжить создание заявки, чтобы получить ключ и секретный ключ приложения.

  ---

  Практически наверняка у вас есть учетная запись. Пожалуйста, используйте ту же учетную запись, что и для приложения GARDENA, в котором зарегистрированы ваши устройства GARDENA. В противном случае вы не получите доступ к своим устройствам.

  ---

• Убедитесь, что приложение подключено к API.

  • API аутентификации и
  • API интеллектуальной системы GARDENA.

И, конечно же, вам потребуется работающая установка ioBroker (как минимум с использованием пользовательского интерфейса admin5), а также как минимум одно функционирующее умное устройство GARDENA .

Оглавление

• Список изменений
  • 2.0.1
  • 2.0.0
  • предыдущие версии
• Лицензия

Установка

Адаптер имеется в наличии.

• в npm: Установка с помощьюnpm install iobroker.smartgarden
• На GitHub по адресу https://github.com/jpgorganizer/ioBroker.smartgarden . Описание установки с GitHub доступно здесь (на немецком языке).

Настройка адаптера

1. Установите адаптер

2. Создайте экземпляр адаптера.

3. Проверьте и завершите настройку экземпляра.

   Если вы измените какие-либо значения этих настроек, пожалуйста, перезагрузите адаптер.

   3.1 Отредактируйте ключ приложения и секретный ключ приложения и/или необязательное имя пользователя и пароль в конфигурации основного экземпляра.

   Параметр	Описание
   обязательный
   Ключ приложения	Ключ приложения (ключ API), например, в разделе «Требования».
   секретное приложение или имя пользователя и пароль *) **)
   рекомендовано
   Секрет приложения *)	Секрет приложения, например, в разделе «Требования» — только если имя пользователя и пароль пустые (новинка в версии 2.0.0)*
   не рекомендуется
   имя пользователя *) **)	Имя пользователя для интеллектуальной системы GARDENA — только если секретный ключ приложения пуст.
   пароль *) **)	соответствующий пароль — только если указано имя пользователя

   ПРИМЕЧАНИЯ: *)

   • Начиная с версии 2.0.0, предпочтительным способом входа в систему является использование ключа и секрета приложения , поскольку прежний способ входа с именем пользователя и паролем больше не поддерживается Gardena, но тем не менее он по-прежнему работает для многих пользователей. По этой причине он всё ещё доступен здесь, но в случае ошибки его поддержка прекращается. Поэтому рекомендуется использовать ключ и секрет приложения!

   • Ключ приложения , секретный ключ приложения и пароль шифруются и хранятся внутри адаптера, после чего расшифровываются для аутентификации на хосте приложения GARDENA.

   **)

   • Данный параметр устарел и может быть недоступен в будущих версиях.

   3.2 Проверьте значения по умолчанию для различных параметров и опций включения/выключения в конфигурации экземпляра. Для большинства пользователей значения по умолчанию будут приемлемы.

   Параметр	Описание
   прогноз	Использовать прогноз времени зарядки и оставшегося времени работы газонокосилки; включать/выключать прогноз времени зарядки и времени работы газонокосилки; по умолчанию: выключено; (новое в версии 0.5.0)
   циклы	Количество циклов истории работы газонокосилки; можно использовать любое число от 3 (минимум), но 10 (по умолчанию) кажется хорошим значением; актуально только если включена указанная выше функция «прогнозирования» ; (новое в версии 0.5.0)
   проверка орошения	Используйте функцию проверки наличия полива во время кошения; включите/выключите; по умолчанию: выключено; (новое в версии 0.6.0)
   ограничение монитора	Использовать мониторинг ограничений скорости API интеллектуальной системы Gardena; включить/выключить; по умолчанию: выключено; (новое в версии 1.0.2)

   3.3 Проверьте значения по умолчанию в настройках системы и параметры включения/выключения в конфигурации экземпляра. Большинству пользователей не потребуется ничего менять на этой вкладке.

   Параметр	Описание
   Уровень логирования	Уровень логирования: 0 = нет записей в журнале, 1 = есть записи в журнале, 2 = есть записи в журнале, 3 = все записи в журнале; по умолчанию: 0 - нет записей в журнале
   украсить журнал	Сократить идентификаторы состояний в журнале; включить/выключить; по умолчанию: включено; (новое в версии 1.0.5)
   интервал повторных попыток подключения	Интервал повторной попытки подключения к веб-сервису Gardena в случае ошибки (в секундах); по умолчанию: 300, минимум: 60; (новое в версии 1.0.3)
   интервал пинга	Интервал отправки пингов в веб-сервис Gardena (в секундах); по умолчанию: 150, минимум: 1, максимум: 300
   фактор авторизации	Коэффициент действительности токена аутентификации; по умолчанию: 0,999
   Auth-URL	URL хоста аутентификации; по умолчанию: https://api.authentication.husqvarnagroup.dev
   Базовый URL	Базовый URL веб-сервиса; по умолчанию: https://api.smart.gardena.dev

Получение поддержки

Чтобы получить помощь, внимательно прочтите этот файл README и раздел часто задаваемых вопросов (FAQ) . Если вам потребуется дополнительная поддержка, пожалуйста, присоединитесь к обсуждению на форуме ioBroker .

Точки данных адаптера

Адаптер предназначен для мониторинга и управления устройствами интеллектуальной системы GARDENA. Для этого потребуется один адаптер.LOCATION и один или несколькоDEVICE 's. Для каждогоDEVICE будет

• одинSERVICE_COMMON_<id> и
• один или несколькоSERVICE_<servicelink_type>_<id> .

Где<servicelink_type> Это описание типа устройства, например, газонокосилка или клапан.<id> Это (закодированный) идентификатор устройства GARDENA, используемый API. См. описание ServiceLink по адресу https://developer.husqvarnagroup.cloud/apis/GARDENA+smart+system+API#/swagger .

Управление/мониторинг каждого устройства возможен черезSERVICE_<servicelink_type> перечислены в следующей таблице.SERVICE_COMMON Предоставляет общую информацию об устройстве.

Если вам нужна дополнительная информация о точках данных, пожалуйста, ознакомьтесь с информацией по ссылке https://developer.husqvarnagroup.cloud/apis/GARDENA+smart+system+API#/swagger . Там вы найдете описание каждой точки данных, за исключением тех, которые помечены как точки данных адаптера, а не API интеллектуальной системы GARDENA.

При выборе функции адаптер создает собственные точки данных для различных функций/опций. Эти точки данных не удаляются автоматически при снятии выбора с функции. Если они вам больше не нужны, их можно удалить вручную.

Общие сведения о точках данных

Адаптер не изменяет значения, передаваемые API интеллектуальной системы GARDENA. Единственное, что делается (начиная с версии 1.0.0), — это проверка типа временных меток и чисел .

Запросы на управление устройством будут успешно выполнены, как только команда будет принята интеллектуальным шлюзом. Успешное выполнение команды на самом устройстве можно наблюдать по соответствующему изменению состояния. Пример: отправка команды на запуск службы VALVE интеллектуального управления водоснабжением приведет к следующему результату:activity_value Данные сервиса, которые необходимо изменить после обработки командой устройством.

Примечания:

• Запросы на управление устройством не могут быть отправлены, пока адаптер smartgarden не подключен к API интеллектуальной системы GARDENA.
• Пожалуйста, убедитесь, что вы задали значение для команды с помощьюack=false См. главу «Команды и состояния» в руководстве для разработчиков адаптеров.

Для SERVICE_MOWER

Контроль

Для управления устройством используйте точку данных.

• activity_control_i : типstring

  Эта точка данных генерируется адаптером и не требуется благодаря API интеллектуальной системы GARDENA.

  Измените этот параметр, чтобы запустить газонокосилку.

  • Чтобы начать выполнение задания на заданное время, установите значение, равное запланированной продолжительности в секундах (пожалуйста, используйте числа, кратные 60; минимальное значение — 60); учитывайте тип данных.string
  • для автоматической работы установите строкуSTART_DONT_OVERRIDE
  • Чтобы отменить текущую операцию и вернуться на зарядную станцию, используйте строку.PARK_UNTIL_NEXT_TASK
  • Чтобы отменить текущую операцию, вернитесь на зарядную станцию и проигнорируйте строку использования расписания.PARK_UNTIL_FURTHER_NOTICE

  Примечание: газонокосилка запускается только при полностью заряженном аккумуляторе.

Мониторинг

Все остальные данные используются исключительно для мониторинга и в информационных целях.

Особые данные:

• activity_mowing_i

  Эта точка данных генерируется адаптером и не требуется в связи с использованием API интеллектуальной системы GARDENA.

  Эта точка данных показывает два разных состояния газонокосилки:

  • true : кошение или
  • false Не косит.

  Эти данные можно использовать для дальнейших действий, когда важно знать, находится ли газонокосилка на газоне в безопасном положении.

  В зависимости от значения точки данныхactivity_value Данная точка данных задана. Подробности см. в следующей таблице.

  activity_value	activity_mowing_i
  OK_CHARGING Газонокосилка должна косить, но из-за недостаточного уровня заряда она остается на зарядной станции.	ЛОЖЬ
  PARKED_TIMER Газонокосилка припаркована в соответствии с таймером и снова запустится в заданное время.	ЛОЖЬ
  PARKED_PARK_SELECTED Газонокосилка временно припаркована до дальнейшего уведомления.	ЛОЖЬ
  PARKED_AUTOTIMER Газонокосилка пропускает скашивание из-за недостаточной высоты травы.	ЛОЖЬ
  PAUSED Газонокосилка находится в режиме ожидания, люк закрыт.	ЛОЖЬ
  OK_CUTTING Газонокосилка работает в автоматическом режиме (по расписанию).	истинный
  OK_CUTTING_TIMER_OVERRIDDEN Газонокосилка нарушает график работ.	истинный
  OK_SEARCHING Газонокосилка ищет зарядную станцию.	истинный
  OK_LEAVING Газонокосилка отъезжает от зарядной станции.	истинный
  NONE Никакой активности не происходит, возможно, из-за ошибки.	истинный
  все остальные значения	истинный

• batteryState_chargingTime_remain_i (в разделе SERVICE_COMMON...) и
  activity_mowingTime_remain_i (в разделе SERVICE_MOWER...)

  Обе точки данных генерируются адаптером и не требуются благодаря API интеллектуальной системы GARDENA.

  Эти данные показывают прогноз оставшегося времени зарядки и времени работы газонокосилки в секундах. Они создаются только при выборе этой функции в конфигурации экземпляра.

  Для прогнозирования значения история последних нескольких циклов зарядки и кошения сохраняется в двух состояниях.info.saveMowingHistory иinfo.saveChargingHistory .

  Эту функцию можно включить/выключить в конфигурации адаптера, а также изменить количество сохраненных циклов зарядки и кошения в истории.

  Для активации этой функции убедитесь, что хотя бы один цикл кошения и зарядки прошел без ошибок (например, не был прерван вручную или с помощью датчика). Лучше, если будет выполнено не менее трех циклов без ошибок. Эта функция пытается распознать нормальный случай и изначально предполагает, что следующий процесс также является нормальным. Если возникает ошибка, то этот ошибочный цикл считается нормальным, а последующие циклы, прошедшие нормально, — ошибочными. Если во время работы возникает ошибка, остановите адаптер, удалите две точки данных и запустите его заново.

  Для получения более подробной информации об общих механизмах прогнозирования см. FORECAST.md .

  Примечания:

  1. Прогнозируемые значения доступны только в том случае, если в истории сохранен хотя бы один полный цикл зарядки и кошения.

  2. История сохранена в разделеinfo так что еслиLOCATION Если файл необходимо удалить, например, в случае будущего обновления, он не будет потерян.

  3. Если вы отключите газонокосилку от интеллектуальной системы GARDENA и снова подключите её, история будет потеряна, поскольку в интеллектуальной системе GARDENA вашей косилке будет присвоен новый идентификатор. Это означает, что адаптер не сможет распознать косилку как предыдущую — возможно, это будет вторая косилка. В этом случае рекомендуется удалить эти две точки данных и перезапустить адаптер, чтобы предыдущие (теперь уже старые) наборы истории не считывались и не записывались постоянно. После этого адаптер начнёт создавать новую историю.

  4. Эта функция должна работать с несколькими газонокосилками, но она не тестировалась (я не могу этого сделать, потому что у меня только одна газонокосилка) . Если у вас несколько газонокосилок, пожалуйста, протестируйте её и сообщите об ошибках, а также, конечно, сообщите, работает ли она должным образом. Заранее спасибо.

• lastErrorCode_value

  Пожалуйста, обратите особое внимание на эту точку данных.lastErrorCode_value Описание возможных значений можно найти по адресу https://developer.husqvarnagroup.cloud/apis/GARDENA+smart+system+API#/swagger , см. "MowerService - lastErrorCode"

Для SERVICE_VALVE_SET

Контроль

Для управления устройством используйте точку данных.

• stop_all_valves_i : типstring

  Эта точка данных генерируется адаптером и не требуется благодаря API интеллектуальной системы GARDENA.

  Измените этот параметр, чтобы остановить работу всех клапанов.

  • Для немедленной остановки всех клапанов используйте веревку.STOP_UNTIL_NEXT_TASK

  Примечание: Не отображайте значение этой точки данных в вашем приложении, поскольку оно, как правило, не определено. Кроме того, эта точка данных не может служить триггером для ваших собственных действий, поскольку после выполнения команды ей присваивается значение null .

Мониторинг

Все остальные данные используются исключительно для мониторинга и в информационных целях.

Для сервисного клапана

Контроль

Для управления устройством используйте точку данных.

• duration_value : типstring

  Измените эту точку данных, чтобы запустить клапан.

  • Чтобы установить заданное время, задайте значение в секундах (используйте числа, кратные 60; минимальное значение — 60); учитывайте тип данных.string .

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

    устройство	лимит
    Система интеллектуального управления орошением GARDENA	5400 секунд (90 минут)
    Умный насос GARDENA	36000 (10 часов)
    Система интеллектуального управления водоснабжением GARDENA	36000 (10 часов)

  • Чтобы отменить текущий полив и продолжить выполнение расписания, используйте строку.STOP_UNTIL_NEXT_TASK

  • Чтобы пропустить автоматическое выполнение операции до указанного времени, текущая активная операция может быть отменена или нет (зависит от модели устройства). Используйте строку.PAUSE_<number_of_seconds> напримерPAUSE_86400 Приостановить на 24 часа (пожалуйста, используйте числа, кратные 60; минимальное значение — 60).

  • Для восстановления автоматической работы, если она была приостановлена, используйте строку.UNPAUSE

• irrigationWhileMowing_allowed_i иirrigationWhileMowing_mowerDefinition_i

  Эти данные генерируются адаптером и не требуются благодаря API интеллектуальной системы GARDENA.

  Эти точки данных позволяют управлять функцией «Полив запрещен во время кошения ». Они создаются только при выборе этой функции в конфигурации экземпляра. Описание этой функции см. в главе « Полив запрещен во время кошения» .

Мониторинг

Все остальные данные используются исключительно для мониторинга и в информационных целях.

Особый показатель:

• duration_leftover_i

  Эта точка данных генерируется адаптером и не требуется благодаря API интеллектуальной системы GARDENA.

  Это значение описывает количество минут, оставшихся до закрытия клапана и прекращения полива.

  • Целое число, единица (1 ) или более.
  • null если не определено

Для SERVICE_POWER_SOCKET

Контроль

Для управления устройством используйте точку данных.

• duration_value : типstring

  Измените эту точку данных, чтобы запустить розетку.

  • Чтобы установить заданное время, задайте значение в секундах (используйте числа, кратные 60; минимальное значение — 60); учитывайте тип данных.string
  • Чтобы устройство оставалось включенным навсегда, используйте строку.START_OVERRIDE .
  • Чтобы остановить использование устройстваSTOP_UNTIL_NEXT_TASK .
  • Чтобы пропустить автоматическое выполнение операции до указанного времени. Текущая активная операция НЕ будет отменена. Используйте строку.PAUSE_<number_of_seconds> напримерPAUSE_86400 Приостановить на 24 часа (пожалуйста, используйте числа, кратные 60; минимальное значение — 60).
  • Для восстановления автоматической работы, если она была приостановлена, используйте строку.UNPAUSE

Мониторинг

Все остальные данные используются исключительно для мониторинга и в информационных целях.

Особый показатель:

• duration_leftover_i

  Эта точка данных генерируется адаптером и не требуется в связи с использованием API интеллектуальной системы GARDENA.

  Это значение указывает количество минут, оставшихся до отключения электропитания от розетки.

  • Целое число, единица (1 ) или более.
  • null если не определено

Для SERVICE_SENSOR

Контроль

Функции управления отсутствуют.

Мониторинг

Все данные представлены исключительно в целях мониторинга и информирования.

Для SERVICE_COMMON

ОнSERVICE_COMMON Предоставляет общую информацию об устройстве. Описание интегрируется в описание других сервисов, где это необходимо.

Ограничения скорости

Существуют некоторые ограничения, о которых вам следует знать. Пожалуйста, ознакомьтесь с главой «Ограничения скорости» в файле README описания API интеллектуальной системы GARDENA.

Чтобы проверить, не превысили ли вы лимиты скорости запросов, вы можете включить мониторинг в конфигурации экземпляра с помощью параметра мониторинга «Лимиты скорости запросов» .

Если вы включили мониторинг состоянияinfo.RateLimitCounter Это состояние обновляется с каждым запросом. В этом состоянии сохраняется структура данных, содержащая количество запросов за месяц, день, час, а также за последние 30 и 31 день.

Структура представлена в формате JSON и выглядит следующим образом:

{
  "2020": {                          <<< year
    "2020-08": {                     <<< month
      "count": 21,                   <<< number of requests for month
      "2020-08-27": {                <<< day
        "11": {                      <<< hour
          "count": 3                 <<< number of requests for hour
        },
        "12": {                      <<< hour   
          "count": 13                <<< number of requests for hour
        },
        "count": 16                  <<< number of requests for day
      },
      "2020-08-28": {                <<< day
        "14": {                      <<< hour
          "count": 5                 <<< number of requests for hour 
        },
        "count": 5                   <<< number of requests for day
      }
    }
  },
     ...
  "last30days": {                     
    "count": 2021                    <<< number of requests in last 30 days
  },
  "last31days": {
    "count": 2098                    <<< number of requests in last 31 days
  }
}

Примечание:

• Этот час соответствует времени по всемирному координированному времени (UTC).
• Фактическое количество запросов может быть выше. Особенно если соответствующий период не полностью охватывается мониторингом.
• Эта структура становится очень большой и никогда не удаляется адаптером. Поэтому, пожалуйста, удаляйте её вручную время от времени или отключайте мониторинг — по крайней мере, если у вас нет проблем с ограничениями скорости.

Полив во время кошения травы запрещен.

В чём проблема?

Если у вас есть и газонокосилка, и система орошения с выдвижными дождевателями, существует риск того, что ваша газонокосилка во время работы системы орошения может задеть один из дождевателей и повредить его или причинить себе ущерб.

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

Что делается?

Благодаря этой функции можно остановить полив, когда газонокосилка находится на газоне. Это можно настроить отдельно для каждого клапана.

Для каждого клапана можно назначить одну или несколько косилок, при этом клапан не должен быть открыт во время работы косилки. В основном, косилка имеет приоритет над орошением, то есть, если возникает конфликт, когда косилка работает, а клапан открыт, клапан закрывается и устанавливается соответствующее предупреждение.

Кроме того, можно установить правило, согласно которому клапан никогда не должен открываться, независимо от того, работает газонокосилка или нет. Например, это можно использовать, если клапан или труба за ним повреждены.

В конфигурации экземпляра проверку можно включить или выключить целиком с помощью параметра «Проверка орошения» .

Для каждого из них доступно три параметра.SERVICE_VALVE Они используются для настройки и для сообщения о предупреждениях.

• формат идентификатора газонокосилки

  smartgarden.0.LOCATION_xxxxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxxxxxxxxxx.DEVICE_xxxxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxxxxxxxxxx.SERVICE_MOWER_xxxxxxxx-xxxxxx-xxxxxx-xxxxxxxxxxxxxxxxxxxxx

  Вы можете скопировать этот идентификатор газонокосилки со вкладки «Объекты» в ioBroker, см. красную стрелку на следующем рисунке.

  

• коды предупреждений

  код предупреждения	описание
  NO_WARNING	Без предупреждения, клапан открыт.
  UNKNOWN_MOWER	Неверный идентификатор газонокосилки. irrigationWhileMowing_mowerDefinition_i
  STOPPED	Клапан автоматически закрывается, потому что газонокосилка косит.
  FORBIDDEN	Клапан закрыт из-за специального кода.IRRIGATION_FORBIDDEN задано в точке данныхirrigationWhileMowing_mowerDefinition_i

Эта функция выполняется каждый раз, когда

• клапан открывается или
• газонокосилка начинает косить

Программа не запускается при изменении значений в указанных выше параметрах данных. Это означает: если возникает конфликтная ситуация и вы вносите изменения...irrigationWhileMowing_allowed_i отtrue кfalse Конфликт не распознается, и конфликт будет продолжаться. Аналогичное поведение наблюдается и при изменении...irrigationWhileMowing_mowerDefinition_i .

Базовое поведение — ПРЕДУПРЕЖДЕНИЕ

Эта функция не может предотвратить открытие клапана во время работы газонокосилки. Например, это можно сделать вручную через приложение GARDENA или автоматически по расписанию.

Эта функция может закрыть клапан как можно быстрее только в случае конфликта. При этом конфликт может и не быть распознан. Поэтому может случиться так, что вода всё же протечёт. Например, нельзя предотвратить выдвижение дождевателей и столкновение газонокосилки с ними , но вероятность этого сведена к минимуму. Таким образом, задача вашего приложения — обеспечить, чтобы этот конфликт никогда не возникал.

Пожелания относительно точек данных

Этот адаптер передает каждое значение в виде точки данных, предоставляемой через API интеллектуальной системы GARDENA. Если кому-то нужны дополнительные значения, пожалуйста, свяжитесь с GARDENA и сообщите им, что это значение также будет включено в API. Для этого перейдите в раздел «Контакты» и оставьте отзыв внизу страницы на портале разработчиков GARDENA .

Примечание

Это частный проект. Я не имею никакого отношения к компаниям GARDENA или Husqvarna.

Кредиты

Большое спасибо компании GARDENA/Husqvarna за предоставление этого общедоступного API , и особая благодарность вашей службе поддержки за очень качественную и оперативную помощь.

Логотип SmartGarden: http://www.freepik.com Разработано Freepik

Changelog

2.0.1

• (jpgorganizer) 2024-May-25
  • fixed warning smartgarden has an invalid jsonConfig, e.g. Issue 72
  • fixed Issue 64 Connection == true when adapter is stopped
  • Fix comparison with NaN in api.js, e.g. Pull request 67
  • some further minor changes

2.0.0

• (jpgorganizer) 2022-Jun-13

  • support for new login procedure to Gardena webservice: using Application secret and Application key instead of username and password. Issue 47

    Procedure with username and password is still available, as it's still working for some users.

    TODO for all existing users: please re-enter your login data, even if you will still use username and password!

  • support for admin4 UI removed; at least admin5 is needed!

  • new configuration page

  • function and configuration parameter pre-define states removed. All Gardena data points get deleted and created again.

  • documentation has been adjusted

1.0.6

• (jpgorganizer) 2022-May-04
  • some minor changes in documentation, including Issue 41 and new limit for SERVICE_VALVE (just smart Irrigation Control)
  • bug fix in error handling
  • changes due to new Gardena API v1.1.0
  • necessary changes due to changed behavior Gardena Service Issue 43
  • tests against js-controller 4.x, Issue 40

1.0.5

• (jpgorganizer) 2021-May-13
  • necessary adjustments due to js-controller v3.3; e.g. Issue 29
    • nearly all data points get deleted and created again with intended role/unit
    • data types for following data points changed from string to number:
      • for all devices: rfLinkLevel_value
      • for mower: batteryLevel_value, operatingHours_value
      • for sensor: batteryLevel_value, soilHumidity_value, soilTemperature_value, lightIntensity_value, ambientTemperature_value
  • compatibility test with node.js v14 and node.js v16 and added to Travis CI test; compatibility test with the upcoming Admin 5 React UI; e.g. Issue 30
  • new parameter beautify log in instance configuration; makes state ids a little bit shorter in log if switched on

1.0.4

• (jpgorganizer) 2021-Feb-22
  • necessary adjustments due to js-controller v3.2
  • option useTestVariable in adapter/instance configuration removed

1.0.3

• (jpgorganizer) 2021-Jan-26
  • improved error handling
  • new parameter connection retry interval
  • axios vulnerability solved, using version >=0.21.1

1.0.2

• (jpgorganizer) 2020-Aug-30
  • monitoring rate limits, see chapter Rate Limits and discussion at Issue 18

1.0.1

• (jpgorganizer) 2020-Aug-17
  • better reconnection to GARDENA smart system server in case of your internet connection was broken
  • textual changes in io-package.json
  • improved README and FAQ

1.0.0

• (jpgorganizer) 2020-Jun-13
  • code rework, no functional change expected
  • support PAUSE for SERVICE_VALVE, SERVICE_POWER_SOCKET. e.g. Issue 14
  • internal representation for all timestamps changed from format like 2020-05-26T05:03:47.613+0000 to 2020-05-26T05:03:47.613Z to support Safari browser e.g. Issue 12.
  • support forecast values for mower id's in format with suffix, e.g. d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3:suffix, e.g. Issue 12
  • making the adapter more fault tolerant at startup, e.g. trimming whitespaces from username, etc.
  • README: new chapter Getting support,
  • README: chapter Known Errors deleted, should be resolved by GARDENA
  • README: links to GARDENA/Husqvarna developer portal adjusted to the new address

0.6.0

• (jpgorganizer) 2020-May-03
  • new feature Irrigation not allowed while mowing, for detailed description see Irrigation not allowed while mowing; e.g. Issue 5
  • rework instance config dialog
  • improvement of documentation

0.5.1

• (jpgorganizer) 2020-Apr-26
  • some corrections (sensor, typo)
  • integration of travis-ci

0.5.0

• (jpgorganizer) 2020-Apr-25

  • MOWER: forecast for remaining charging time and remaining mowing time integrated, e.g. Issue 1

  • IMPORTANT CHANGE for existing users: the id for LOCATION, all DEVICE's and all SERVICE's has changed due to support of History adapter. (History adapter cannot handle id's with % (percent) character within id's, although the % is not forbidden in id's in ioBroker), e.g. Issue 8.

    So you must delete all states of the adapter instance to install this release and please check your application carefully for necessary adjustments regarding the change of the id names.

  • devices Water Control and Smart Pump tested (many thanks to user gammler2003 and xengosam at ioBroker Forum for testing)

  • some code rework and improvement of documentation

  • dependency corrected, important for js-controller v3, e.g. Issue 7

  • adapter now available at npm

0.4.2

• (jpgorganizer) 2020-Apr-01
  • error missing SENSOR data fixed (many thanks to user dslraser and muckel at ioBroker Forum for testing)

0.4.1

• (jpgorganizer) 2020-Mar-31
  • Dependency get's resolved now

0.4.0

• (jpgorganizer) 2020-Mar-31
  • NOTE: with this version an additional dependency is necessary at runtime. If it does not get installed together with the installation of this adapter, please install seperately with npm install https://github.com/jpgorganizer/ioBroker.utils or npm i @jpgorganizer/utils
  • NOTE: you must delete all states of the adapter instance to install this release and please check your application carefully for necessary adjustments regarding type/role changes (see below)
  • data types of (nearly) all data points adjusted for compliance with ioBroker guidance:
    • states now have special ioBroker type and role instead of former string/text where applicable, e.g. number/value.battery for batteryLevel_value, see Issue 3
  • data point activity_value_i replaced by activity_mowing_i with type/role boolean/indicator.working: true means mowing, false means not mowing
  • possibility to pre-define states integrated, see new switch PreDefine States in adapter/instance configuration, see Issue 2
  • states are readonly now; except states for commands, see Issue 4
  • input field for useTestVariable in adapter/instance configuration switched to a checkbox (former: text); please check your settings
  • error in command stop_all_valves_i in VALVE_SET fixed

0.3.0

• (jpgorganizer) 2020-Mar-25
  • create all states read/write
  • error TypeError: Cannot read property 'val' of null with useTestVariable fixed

0.2.0

• (jpgorganizer) 2020-Mar-24
  • IMPORTANT : data point for MOWER control (command) changed from
    duration_value to activity_control_i
  • rework leftovertimer
  • improved error handling
  • improved logging (see loglevel in adapter configurations)

0.0.1

• (jpgorganizer) 2020-Mar-01
  • initial release

License

Copyright (c) 2020 - 2026 jpgorganizer, https://github.com/jpgorganizer

smartgarden by jpgorganizer is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC-BY-NC-SA-4.0) Based on a work at https://github.com/jpgorganizer/ioBroker.smartgarden.