Aller au contenu

JeeNavimow — versión beta

Esta página describe la versión beta (inestable) de JeeNavimow: funciones en pruebas y hoja de ruta. Para la documentación estable, consulte index.md.

⚠️ La beta puede contener funciones inacabadas. Haga una copia de seguridad de su Jeedom antes de instalarla.

Beta-news

En pruebas (beta actual)

  • Mejora del tiempo real MQTT: interpretación de los mensajes de estado de Navimow (posición, progreso, superficie, eventos) mediante el SDK mower_sdk.
  • Detección más precisa del estado «en carga» desde MQTT.
  • Robustez de la reconexión MQTT y del respaldo REST.

Hoja de ruta

Funciones previstas, por prioridad. Dependen de lo que la API/MQTT de Navimow exponga realmente.

v0.2 — Tiempo real completo

  • Análisis completo de los mensajes MQTT (Thing status / properties / events).
  • En directo: progreso del corte, superficie cortada, posición relativa (X/Y).
  • Estado «en carga» fiable.
  • Eventos Jeedom al cambiar de estado.

v0.3 — Control avanzado (según API)

  • Programación del corte.
  • Selección de zonas de trabajo / mapas.
  • Retardo por lluvia, altura de corte, bloqueo infantil, modo borde.

v0.4 — Visualización e historial

  • Widget de mapa (posición relativa, zona cortada).
  • Estadísticas (tiempo de corte, superficie acumulada, historial de batería).

v0.5 — Cobertura e i18n

  • Soporte multicuenta, selección de región de la nube (Europa / EE. UU. / Asia).

Changelog beta

0.2.9

  • Diagnóstico: nueva opción Captura MQTT en bruto en la configuración del plugin. Registra tal cual cada mensaje recibido de la nube Navimow, en un archivo dedicado, sin pasar el demonio a depuración. El script resources/mqtt_report.py elabora el inventario de los campos —frecuencia, tipo, ejemplos— señalando los que el plugin aún no aprovecha. Objetivo: identificar los campos reales de progreso, superficie y posición, cuyos nombres no están documentados. También se capturan los comandos enviados (REST sendCommands) y las respuestas de estado; los tokens OAuth y las credenciales MQTT se enmascaran.
  • Documentación: corregidas las URLs de documentación y de changelog (alojamiento Cloudflare), ya que GitHub Pages no puede publicar un repositorio privado.

0.2.8

  • Dependencias: si no hay ningún Python ≥ 3.11, el plugin intenta primero apt-get install python3.11 y luego compila Python 3.11 desde las fuentes (make altinstall en /usr/local, sin tocar el python3 del sistema) — Debian 11 (Bullseye) ya se instala sin intervención manual.
  • Integridad del archivo Python verificada (MD5 publicado por python.org), paralelismo de compilación limitado por la RAM disponible y bloqueo que impide dos instalaciones simultáneas.
  • ⏱️ En Debian 11 (Bullseye), la primera instalación de dependencias dura de 20 min a 1 h (compilación de Python 3.11) frente a menos de un minuto en Debian 12; el Python compilado se reutiliza después.

0.2.7

  • Widget: corregido el enlace del nombre del cortacésped (añadido el parámetro m=) — ahora abre correctamente la página de configuración del equipo.

0.2.6

  • Dependencias: detección automática de un Python ≥ 3.11 instalado en paralelo (p. ej. python3.11 en Debian 11 donde python3 = 3.9), en lugar de fallar; mensaje de error mejorado (Debian 11 / Debian 12).

0.2.5

  • Plugin: categoría movida a Nature.

0.2.4

  • Widget: botón Reanudar en verde lima (#9ACD32), diferenciado de Iniciar y Base.

0.2.3

  • Widget: ahora sigue el tema de Jeedom (modo oscuro / claro) en lugar del tema del navegador/SO.

0.2.2

  • Widget: logo del plugin en la cabecera (en lugar del icono de robot) y nombre del cortacésped clicable que abre la configuración del equipo.
  • Widget: botón de donación (café) con tooltip opaco en primer plano; eliminado el botón «Sync» redundante.
  • Widget: icono de casa azul para el botón Base y corrección de iconos faltantes (compatibilidad con Font Awesome 5).
  • Widget: «Base» disponible en pausa, medidor de batería centrado.

0.2.1

  • Nuevo icono de cortacésped en el widget (imagen dedicada), animado durante el corte.

0.2.0

  • MQTT en tiempo real mediante el broker dinámico mqttHost/mqttUrl devuelto por la API (en lugar del hostname mqtt.navimow.com, no resoluble) — conexión WSS + suscripciones a los topics realtime confirmadas.
  • Renovación automática del token OAuth (~1 h): proactiva + ante el código 4005 (CODE_OAUTH_INFO_ILLEGAL), actualización de la autenticación MQTT sin cortar la conexión.
  • Arranque robusto del demonio: bind del puerto con reintentos, PID escrito tras el bind correcto, limpieza de instancias huérfanas (corrige «el demonio no arranca»).
  • Widget autoactualizable: los widgets de panel y móvil se actualizan solos cada 15 s sin recargar la página.
  • Puerto del demonio por defecto 55149 (evita el conflicto con jeewhatsapp).

0.1.0

  • Arquitectura establecida (OAuth, demonio MQTT + REST, widget, i18n).
  • Correcciones: codificación OAuth x-www-form-urlencoded, encabezado requestId obligatorio, análisis data.payload.devices, batería vía capacityRemaining.
  • Añadido el botón Actualizar cortacéspedes; ID de comando en una sola línea.