JeeNavimow — versione beta¶

Questa pagina descrive la versione beta (instabile) di JeeNavimow: funzioni in prova e roadmap. Per la documentazione stabile, vedi index.md.

⚠️ La beta può contenere funzioni incomplete. Esegui un backup di Jeedom prima di installarla.

Beta-news¶

Affinamento del tempo reale MQTT: interpretazione dei messaggi di stato Navimow (posizione, avanzamento, superficie, eventi) tramite l'SDK mower_sdk.
Rilevamento più preciso dello stato «in carica» da MQTT.
Robustezza della riconnessione MQTT e del fallback REST.

Funzioni previste, per priorità. Dipendono da ciò che l'API/MQTT Navimow espone realmente.

Analisi completa dei messaggi MQTT (Thing status / properties / events).
In diretta: avanzamento del taglio, superficie tagliata, posizione relativa (X/Y).
Stato «in carica» affidabile.
Eventi Jeedom al cambio di stato.

Pianificazione del taglio.
Selezione di zone di lavoro / mappe.
Ritardo pioggia, altezza di taglio, blocco bambini, modalità bordo.

Supporto multi-account, selezione della regione cloud (Europa / USA / Asia).

Diagnostica: nuova opzione Cattura MQTT grezza nella configurazione del plugin. Registra così com'è ogni messaggio ricevuto dal cloud Navimow, in un file dedicato, senza portare il demone in debug. Lo script resources/mqtt_report.py ne compila l'inventario dei campi — frequenza, tipo, esempi — segnalando quelli non ancora sfruttati dal plugin. Obiettivo: individuare i campi reali di avanzamento, superficie e posizione, i cui nomi non sono documentati. Vengono catturati anche i comandi inviati (REST sendCommands) e le risposte di stato; i token OAuth e le credenziali MQTT sono mascherati.
Documentazione: corretti gli URL di documentazione e changelog (hosting Cloudflare), poiché GitHub Pages non può pubblicare un repository privato.

Dipendenze: se non è presente alcun Python ≥ 3.11, il plugin prova prima apt-get install python3.11 e poi compila Python 3.11 dai sorgenti (make altinstall in /usr/local, senza toccare il python3 di sistema) — Debian 11 (Bullseye) ora si installa senza interventi manuali.
Integrità dell'archivio Python verificata (MD5 pubblicato da python.org), parallelismo di compilazione limitato dalla RAM disponibile e lock che impedisce due installazioni simultanee.
⏱️ Su Debian 11 (Bullseye) la prima installazione delle dipendenze dura da 20 min a 1 h (compilazione di Python 3.11) contro meno di un minuto su Debian 12; il Python compilato viene poi riutilizzato.

Widget: corretto il link sul nome del rasaerba (aggiunto il parametro m=) — ora apre correttamente la pagina di configurazione del dispositivo.

Dipendenze: rilevamento automatico di un Python ≥ 3.11 installato in parallelo (es. python3.11 su Debian 11 dove python3 = 3.9), invece di fallire; messaggio di errore migliorato (Debian 11 / Debian 12).

Widget: pulsante Riprendi in verde lime (#9ACD32), distinto da Avvia e Base.

Widget: ora segue il tema di Jeedom (modalità scura / chiara) invece del tema del browser/sistema operativo.

Widget: logo del plugin nell'intestazione (al posto dell'icona robot) e nome del rasaerba cliccabile che apre la configurazione del dispositivo.
Widget: pulsante di donazione (caffè) con tooltip opaco in primo piano; rimosso il pulsante «Sync» ridondante.
Widget: icona casa blu per il pulsante Base e correzione di icone mancanti (compatibilità Font Awesome 5).
Widget: «Base» disponibile in pausa, indicatore batteria centrato.

Nuova icona del rasaerba nel widget (immagine dedicata), animata durante il taglio.

MQTT in tempo reale tramite il broker dinamico mqttHost/mqttUrl restituito dall'API (al posto dell'hostname mqtt.navimow.com, non risolvibile) — connessione WSS + sottoscrizioni ai topic realtime confermate.
Rinnovo automatico del token OAuth (~1 h): proattivo + al codice 4005 (CODE_OAUTH_INFO_ILLEGAL), aggiornamento dell'autenticazione MQTT senza interrompere la connessione.
Avvio robusto del demone: bind della porta con retry, PID scritto dopo il bind riuscito, pulizia delle istanze orfane (corregge «il demone non si avvia»).
Widget ad aggiornamento automatico: i widget dashboard e mobile si aggiornano da soli ogni 15 s senza ricaricare la pagina.
Porta del demone predefinita 55149 (evita il conflitto con jeewhatsapp).

Architettura impostata (OAuth, demone MQTT + REST, widget, i18n).
Correzioni: codifica OAuth x-www-form-urlencoded, header requestId obbligatorio, analisi data.payload.devices, batteria tramite capacityRemaining.
Aggiunto il pulsante Aggiorna rasaerba; ID comando su una sola riga.