Aller au contenu

JeeNavimow — бета-версия

Эта страница описывает бета-версию (нестабильную) JeeNavimow: функции в тестировании и план развития. Стабильную документацию см. в index.md.

⚠️ Бета может содержать незавершённые функции. Сделайте резервную копию Jeedom перед установкой.

Beta-news

В тестировании (текущая бета)

  • Доработка реального времени MQTT: разбор сообщений состояния Navimow (позиция, прогресс, площадь, события) через SDK mower_sdk.
  • Более точное определение состояния «зарядка» по MQTT.
  • Надёжность переподключения MQTT и резервного REST.

План развития

Запланированные функции, по приоритету. Зависят от того, что реально предоставляет API/MQTT Navimow.

v0.2 — Полное реальное время

  • Полный разбор сообщений MQTT (Thing status / properties / events).
  • В реальном времени: прогресс кошения, скошенная площадь, относительная позиция (X/Y).
  • Надёжное состояние «зарядка».
  • События Jeedom при изменении состояния.

v0.3 — Расширенное управление (зависит от API)

  • Планирование кошения.
  • Выбор рабочих зон / карт.
  • Задержка по дождю, высота скашивания, блокировка от детей, режим кромки.

v0.4 — Визуализация и история

  • Виджет-карта (относительная позиция, скошенная зона).
  • Статистика (время кошения, накопленная площадь, история батареи).

v0.5 — Покрытие и i18n

  • Поддержка нескольких аккаунтов, выбор региона облака (Европа / США / Азия).

Changelog бета

0.2.9

  • Диагностика: новая опция Сырая запись MQTT в настройках плагина. Она сохраняет каждое сообщение из облака Navimow без изменений в отдельный файл, не переводя демон в режим отладки. Скрипт resources/mqtt_report.py составляет по ней перечень полей — частота, тип, примеры — отмечая те, что плагин пока не использует. Цель: определить реальные поля прогресса, площади и позиции, имена которых не документированы. Отправленные команды (REST sendCommands) и ответы о состоянии также записываются; токены OAuth и учётные данные MQTT маскируются.
  • Документация: исправлены URL документации и журнала изменений (хостинг Cloudflare), поскольку GitHub Pages не публикует приватный репозиторий.

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

  • Создана архитектура (OAuth, демон MQTT + REST, виджет, i18n).
  • Исправления: кодировка OAuth x-www-form-urlencoded, обязательный заголовок requestId, разбор data.payload.devices, батарея через capacityRemaining.
  • Добавлена кнопка Обновить газонокосилки; ID команды в одну строку.