Aller au contenu

Plugin JeeNavimow

Das Plugin JeeNavimow integriert die Segway Navimow Mähroboter in Jeedom: Überwachung von Status, Akku und Firmware, Steuerung (Start / Stopp / Pause / Fortsetzen / Rückkehr zur Station) und Echtzeit-Tracking über MQTT (mit REST-Fallback).

⚠️ Inoffizielles Plugin, ohne Verbindung zu Segway-Ninebot. Es nutzt dieselbe Cloud-API wie die Community-Integration für Home Assistant (Region Europa / Frankfurt).

Kompatibilität

  • Jeedom 4.4+
  • Navimow-Mäher mit einem Segway-Navimow-Konto (mobile App „Navimow") — getestet mit i210 LiDAR Pro, kompatibel mit den an die Navimow-Cloud gebundenen Serien i / H / X.
  • Python-Abhängigkeiten werden automatisch in einer isolierten virtuellen Umgebung installiert (Python 3.11+ erforderlich — bei Bedarf automatisch installiert oder kompiliert).

Installation

  1. Installieren Sie das Plugin aus dem Jeedom-Market (Kategorie Objets connectés / Vernetzte Objekte).
  2. Aktivieren Sie das Plugin.
  3. Starten Sie in der Plugin-Konfiguration die Installation der Abhängigkeiten und warten Sie auf den Status „OK".
  4. Verbinden Sie Ihr Navimow-Konto (siehe unten).

⏱️ Dauer der Abhängigkeitsinstallation — unter Debian 11 (Bullseye) ist python3 = 3.9, und in den Paketquellen existiert kein Python 3.11. Seit 0.2.8 kompiliert das Plugin Python 3.11 selbst: Rechnen Sie mit 20 Min. bis 1 Std. je nach Maschine (ca. 20 Min. auf aktuellem x86, bis zu 1 Std. auf einem Raspberry Pi), gegenüber unter einer Minute auf Debian 12 (Bookworm). Diese Wartezeit fällt nur einmal an: das kompilierte Python bleibt in /usr/local erhalten und wird bei späteren Installationen wiederverwendet. Lassen Sie die Seite bis zum Status „OK" geöffnet, starten Sie die Installation zwischenzeitlich nicht neu und halten Sie rund 1,5 GB freien Speicherplatz bereit.

Navimow-Konto verbinden

Die Authentifizierung nutzt den offiziellen OAuth2-Ablauf von Segway (von Segway gehostete Anmeldeseite). Ihre Zugangsdaten gelangen niemals über Jeedom.

  1. Klicken Sie auf „Mein Navimow-Konto verbinden".
  2. Schritt 1 — klicken Sie auf Anmelde-URL generieren.
  3. Schritt 2 — öffnen Sie die URL im Browser und melden Sie sich mit Ihrem Segway-Navimow-Konto an. Nach der Anmeldung wird der Browser zu einer URL mit ?code=... weitergeleitet.
  4. Kopieren Sie diese vollständige Weiterleitungs-URL und fügen Sie sie in das Feld ein, dann Bestätigen.
  5. Ihre Mäher werden automatisch als Geräte importiert.

🔑 Der Anmeldecode ist einmalig gültig und läuft innerhalb von Sekunden ab: URL generieren und die Weiterleitungs-URL sofort einfügen. Bei Fehler eine neue URL generieren.

Mäher aktualisieren / hinzufügen

Die Schaltfläche „Mäher aktualisieren" (sichtbar, sobald das Konto verbunden ist) startet die Mäher-Erkennung ohne erneute Anmeldung — praktisch nach dem Hinzufügen eines neuen Mähers.

Der Daemon

JeeNavimow nutzt einen Python-Daemon, der: die Verbindung zur Navimow-Cloud aufrechterhält (automatische OAuth-Token-Erneuerung); auf Echtzeit-Updates über MQTT hört; die REST-API alle 30 s als Fallback abfragt; und Befehle (Start/Stopp/Pause/Fortsetzen/Dock) an den Mäher weiterleitet. Der Daemon-Port ist in der Konfiguration einstellbar (nur bei Konflikt ändern).

Gerät: Befehle

Jeder importierte Mäher stellt automatisch Befehle bereit.

Informationen: Status, Statuscode, Akku (%), Lädt, Online, Fehler + Fehlermeldung, Fortschritt (%), gemähte Fläche (m²), Position X/Y, Firmware, Update verfügbar, letzte Synchronisierung.

Aktionen: Mähen starten, Stopp, Pause, Fortsetzen, Rückkehr zur Station, Aktualisieren.

Dashboard-Widget

Ein eigenes Widget zeigt den animierten Mäherzustand, die Akkuanzeige, den Mähfortschritt und die Steuerschaltflächen, mit Behandlung der Zustände Offline und Fehler.

FAQ / Fehlerbehebung

  • Kein Mäher erscheint nach dem Verbinden → klicken Sie auf Mäher aktualisieren. Prüfen Sie, ob der Mäher in der Navimow-App sichtbar ist.
  • Informationen werden nicht aktualisiert → stellen Sie sicher, dass der Daemon läuft (Seite Gesundheit) und die Abhängigkeiten „OK" sind. Starten Sie den Daemon nach einem Plugin-Update neu.
  • „Token-Austausch fehlgeschlagen: invalid_grant" → der OAuth-Code ist abgelaufen: neue Anmelde-URL generieren und eine frische Weiterleitungs-URL einfügen.
  • Die Installation der Abhängigkeiten scheint zu hängen → unter Debian 11 (Bullseye) kompiliert das Plugin Python 3.11: das dauert 20 Min. bis 1 Std., das Protokoll zeigt „Compilation de Python 3.11.9 depuis les sources". Das ist normal — lassen Sie den Vorgang zu Ende laufen.
  • Installation der Abhängigkeiten schlägt fehl → Python 3.11+ ist erforderlich (von navimow-sdk vorgegeben). Prüfen Sie im Installationsprotokoll, ob Speicherplatz (~1,5 GB) oder Netzwerkzugang fehlt.

Changelog

0.2.8

  • Abhängigkeiten: Ist kein Python ≥ 3.11 vorhanden, versucht das Plugin zunächst apt-get install python3.11 und kompiliert anschließend Python 3.11 aus den Quellen (make altinstall nach /usr/local, das System-python3 bleibt unangetastet) — Debian 11 (Bullseye) installiert jetzt ohne manuellen Eingriff.
  • Integrität des Python-Archivs wird geprüft (von python.org veröffentlichte MD5), Kompilierungs-Parallelität durch den verfügbaren RAM begrenzt, Sperre gegen zwei gleichzeitige Installationen.
  • ⏱️ Unter Debian 11 (Bullseye) dauert die erste Abhängigkeitsinstallation 20 Min. bis 1 Std. (Kompilierung von Python 3.11) statt unter einer Minute unter Debian 12; das kompilierte Python wird danach wiederverwendet.

0.2.7

  • Widget: Link auf den Mäher-Namen korrigiert (Parameter m= hinzugefügt) — öffnet jetzt korrekt die Gerätekonfigurationsseite.

0.2.6

  • Abhängigkeiten: automatische Erkennung eines parallel installierten Python ≥ 3.11 (z. B. python3.11 unter Debian 11, wo python3 = 3.9), statt fehlzuschlagen; verbesserte Fehlermeldung (Debian 11 / Debian 12).

0.2.5

  • Plugin: Kategorie nach Nature verschoben.

0.2.4

  • Widget: Schaltfläche Fortsetzen in Gelbgrün (#9ACD32), unterscheidbar von „Start" und „Basis".

0.2.3

  • Widget: folgt jetzt dem Jeedom-Theme (Dunkel-/Hell-Modus) statt dem Browser-/Betriebssystem-Theme.

0.2.2

  • Widget: Plugin-Logo in der Kopfzeile (statt Roboter-Symbol) und anklickbarer Mäher-Name, der die Gerätekonfiguration öffnet.
  • Widget: Spenden-Schaltfläche (Kaffee) mit deckendem Tooltip im Vordergrund; redundante „Sync"-Schaltfläche entfernt.
  • Widget: blaues Haus-Symbol für die Schaltfläche „Basis" und fehlende Symbole korrigiert (Font-Awesome-5-Kompatibilität).
  • Widget: „Basis" auch im Pausenzustand verfügbar, zentrierte Akkuanzeige.

0.2.1

  • Neues Mäher-Symbol im Widget (eigenes Bild), animiert während des Mähens.

0.2.0

  • Echtzeit-MQTT über den dynamischen Broker mqttHost/mqttUrl der API (statt des nicht auflösbaren Hostnamens mqtt.navimow.com) — WSS-Verbindung + Realtime-Topic-Abonnements bestätigt.
  • Automatische OAuth-Token-Erneuerung (~1 h): proaktiv + bei Code 4005 (CODE_OAUTH_INFO_ILLEGAL), MQTT-Auth-Aktualisierung ohne Verbindungsabbruch.
  • Robuster Daemon-Start: Port-Bind mit Wiederholung, PID erst nach erfolgreichem Bind, Bereinigung verwaister Instanzen (behebt „Daemon startet nicht").
  • Selbstaktualisierendes Widget: Dashboard- und Mobil-Widget aktualisieren sich alle 15 s ohne Neuladen der Seite.
  • Standard-Daemon-Port 55149 (vermeidet Konflikt mit jeewhatsapp).

0.1.0 (Beta)

  • Erste öffentliche Version (Beta).
  • Segway-Navimow-OAuth2-Authentifizierung (Ablauf per Einfügen der Weiterleitungs-URL).
  • Automatische Erkennung der Mäher des Kontos (+ Schaltfläche Mäher aktualisieren).
  • Informationen: Status, Akku, Laden, Online, Fehler, Firmware, letzte Synchronisierung (sowie Fortschritt/Fläche/Position je nach API).
  • Aktionen: Start, Stopp, Pause, Fortsetzen, Rückkehr zur Station, Aktualisieren.
  • Python-Daemon: Echtzeit-MQTT + REST-Fallback (30 s), automatische Token-Erneuerung.
  • Glassmorphism-Dashboard-Widget.
  • Mehrsprachige Dokumentation (FR, EN, DE, ES, RU, ID, IT).