Плагин JeeNavimow¶

Плагин JeeNavimow интегрирует газонокосилки-роботы Segway Navimow в Jeedom: мониторинг статуса, батареи и прошивки, управление (старт / стоп / пауза / продолжить / возврат на базу) и отслеживание в реальном времени через MQTT (с резервным REST).

⚠️ Неофициальный плагин, не связан с Segway-Ninebot. Использует то же облачное API, что и сообществная интеграция для Home Assistant (регион Европа / Франкфурт).

Совместимость¶

Jeedom 4.4+
Газонокосилки Navimow с аккаунтом Segway Navimow (мобильное приложение «Navimow») — протестировано на i210 LiDAR Pro, совместимо с сериями i / H / X, привязанными к облаку Navimow.
Зависимости Python устанавливаются автоматически в изолированном виртуальном окружении (требуется Python 3.11+ — при отсутствии устанавливается или собирается автоматически).

Установка¶

Установите плагин из Маркета Jeedom (категория Объекты connectés / подключённые устройства).
Включите плагин.
В настройках плагина запустите установку зависимостей и дождитесь статуса «OK».
Подключите аккаунт Navimow (см. ниже).

⏱️ Длительность установки зависимостей — в Debian 11 (Bullseye) python3 равен 3.9, а пакета Python 3.11 в репозиториях нет. Начиная с 0.2.8 плагин сам собирает Python 3.11: рассчитывайте на 20 мин — 1 ч в зависимости от машины (около 20 мин на современном x86, до 1 ч на Raspberry Pi), против менее минуты на Debian 12 (Bookworm). Это разовое ожидание: собранный Python сохраняется в /usr/local и используется при последующих установках. Оставьте страницу открытой до статуса «OK», не запускайте установку повторно и подготовьте около 1,5 ГБ свободного места на диске.

Подключение аккаунта Navimow¶

Аутентификация использует официальный поток OAuth2 от Segway (страница входа на стороне Segway). Ваши учётные данные никогда не проходят через Jeedom.

Нажмите «Подключить мой аккаунт Navimow».
Шаг 1 — нажмите Создать URL для входа.
Шаг 2 — откройте URL в браузере и войдите в аккаунт Segway Navimow. После входа браузер перенаправляется на URL, содержащий ?code=....
Скопируйте этот полный URL перенаправления и вставьте его в поле, затем Подтвердить.
Ваши газонокосилки импортируются автоматически как устройства.

🔑 Код входа одноразовый и истекает за несколько секунд: создайте URL и сразу вставьте URL перенаправления. При ошибке создайте новый URL.

Обновить / добавить газонокосилки¶

Кнопка «Обновить газонокосилки» (видна после подключения аккаунта) повторно запускает обнаружение без повторного входа — удобно после добавления новой газонокосилки.

Демон¶

JeeNavimow использует демон Python, который: поддерживает связь с облаком Navimow (автоматическое обновление токена OAuth); слушает обновления в реальном времени по MQTT; опрашивает REST API каждые 30 с в качестве резерва, если MQTT недоступен; и передаёт команды (старт/стоп/пауза/продолжить/база) газонокосилке. Порт демона настраивается (меняйте только при конфликте).

Устройство: команды¶

Каждая импортированная газонокосилка автоматически предоставляет команды.

Информация: Статус, код статуса, батарея (%), Зарядка, В сети, Ошибка + сообщение об ошибке, Прогресс (%), Скошенная площадь (м²), Позиция X/Y, Прошивка, Доступно обновление, Последняя синхронизация.

Действия: Начать кошение, Стоп, Пауза, Продолжить, Возврат на базу, Обновить.

Виджет панели¶

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

FAQ / Устранение неполадок¶

Газонокосилка не появляется после подключения → нажмите Обновить газонокосилки. Проверьте, что она видна в приложении Navimow.
Информация не обновляется → убедитесь, что демон запущен (страница «Здоровье») и зависимости в статусе «OK». Перезапустите демон после обновления плагина.
«Ошибка обмена токена: invalid_grant» → код OAuth истёк: создайте новый URL для входа и вставьте свежий URL перенаправления.
Установка зависимостей выглядит зависшей → в Debian 11 (Bullseye) плагин собирает Python 3.11: это занимает от 20 мин до 1 ч, в журнале видно «Compilation de Python 3.11.9 depuis les sources». Это нормально — дождитесь завершения.
Установка зависимостей не удаётся → требуется Python 3.11+ (требование navimow-sdk). Проверьте в журнале установки, хватает ли места на диске (~1,5 ГБ) и есть ли доступ к сети.

Changelog¶

0.2.8¶

Зависимости: если Python ≥ 3.11 не найден, плагин сначала пробует apt-get install python3.11, а затем собирает Python 3.11 из исходников (make altinstall в /usr/local, системный python3 не затрагивается) — Debian 11 (Bullseye) теперь устанавливается без ручных действий.
Проверяется целостность архива Python (MD5, опубликованный python.org), параллелизм сборки ограничен доступной оперативной памятью, блокировка предотвращает два одновременных запуска установки.
⏱️ В Debian 11 (Bullseye) первая установка зависимостей занимает от 20 мин до 1 ч (сборка Python 3.11) против менее минуты в Debian 12; собранный Python затем используется повторно.

0.2.7¶

Виджет: исправлена ссылка на имя газонокосилки (добавлен параметр m=) — теперь корректно открывает страницу настройки оборудования.

0.2.6¶

Зависимости: автоматическое обнаружение Python ≥ 3.11, установленного параллельно (например, python3.11 в Debian 11, где python3 = 3.9), вместо ошибки; более понятное сообщение об ошибке (Debian 11 / Debian 12).

0.2.5¶

Плагин: категория перенесена в Nature.

0.2.4¶

Виджет: кнопка Продолжить в жёлто-зелёном цвете (#9ACD32), отличается от «Старт» и «База».

0.2.3¶

Виджет: теперь следует теме Jeedom (тёмный / светлый режим) вместо темы браузера/ОС.

0.2.2¶

Виджет: логотип плагина в заголовке (вместо иконки робота) и кликабельное имя газонокосилки, открывающее настройки оборудования.
Виджет: кнопка доната (кофе) с непрозрачной подсказкой на переднем плане; удалена дублирующая кнопка «Sync».
Виджет: синяя иконка дома для кнопки «База» и исправление отсутствующих иконок (совместимость с Font Awesome 5).
Виджет: «База» доступна на паузе, центрированный индикатор батареи.

0.2.1¶

Новая иконка газонокосилки в виджете (отдельное изображение), анимируется во время кошения.

0.2.0¶

MQTT в реальном времени через динамический брокер mqttHost/mqttUrl, возвращаемый API (вместо неразрешимого имени mqtt.navimow.com) — WSS-подключение + подписки на realtime-топики подтверждены.
Автоматическое обновление токена OAuth (~1 ч): проактивно + при коде 4005 (CODE_OAUTH_INFO_ILLEGAL), обновление аутентификации MQTT без разрыва соединения.
Надёжный запуск демона: привязка порта с повторами, PID записывается после успешной привязки, очистка осиротевших экземпляров (исправляет «демон не запускается»).
Самообновляющийся виджет: виджеты панели и мобильной версии обновляются сами каждые 15 с без перезагрузки страницы.
Порт демона по умолчанию 55149 (исключает конфликт с jeewhatsapp).

0.1.0 (бета)¶

Первая публичная версия (бета).
Аутентификация OAuth2 Segway Navimow (поток со вставкой URL перенаправления).
Автоматическое обнаружение газонокосилок аккаунта (+ кнопка Обновить газонокосилки).
Информация: статус, батарея, зарядка, в сети, ошибка, прошивка, последняя синхронизация (а также прогресс/площадь/позиция в зависимости от API).
Действия: старт, стоп, пауза, продолжить, возврат на базу, обновить.
Демон Python: MQTT в реальном времени + резервный REST (30 с), автоматическое обновление токена.
Виджет панели в стиле glassmorphism.
Многоязычная документация (FR, EN, DE, ES, RU, ID, IT).