====== webMobaLedLib – Fehlersuche ====== //Seitenstand 1.00 (2026-11-10), gilt für webMobaLedLib 3.08// Auf dieser Seite stehen die häufigsten Probleme mit ihren Lösungen. Suche den Bereich, in dem es hakt, und die Beobachtung, die zu deinem Problem passt. Probleme, die nur eine bestimmte Installation betreffen (zum Beispiel „Python wurde nicht gefunden“), stehen am Ende der Seite für dein System: [[anleitungen:webmobaledlib:windows|Windows]], [[anleitungen:webmobaledlib:macos|macOS]], [[anleitungen:webmobaledlib:linux|Linux]], [[anleitungen:webmobaledlib:raspberrypi|Raspberry Pi]]. ===== Zuerst prüfen ===== * **Welche Version läuft?** Die Nummer steht unter dem Titel der Oberfläche. Nach einem Update zeigt das Programm manchmal noch die alte Version (siehe unten). * **Steht oben eine rote oder orange Meldung?** Sie sagt meist selbst, was fehlt. Zum Beispiel „Nicht alle Dateien passen zur Version …“ oder „Das Update … ist abgebrochen“. Siehe [[#wenn_nichts_mehr_geht|Wenn nichts mehr geht]]. * **Das Protokoll:** Das Programm schreibt alle Meldungen in die Datei **webmobaledlib.log**. Du siehst die letzten Zeilen unter **Hilfe → Logfile anzeigen**. **Ganze Datei herunterladen** gibt dir die komplette Datei. Bei einer Fehlermeldung im Forum bitte diese Datei mitschicken (und //webmobaledlib.log.1//, falls es sie gibt). Wo die Datei liegt, steht auf der Seite [[anleitungen:webmobaledlib:aktualisieren#wo_liegt_der_datenordner|Aktualisieren]] (Datenordner). ===== Start und Browser ===== ^ Beobachtung ^ Ursache und Hilfe ^ | „Port 8080 ist belegt“ | Das Programm läuft schon. Dann öffnet das Symbol nur den Browser. Sonst läuft ein anderes Programm auf dem Port. Starte mit einem anderen Port, zum Beispiel ''--port 8081''. | | Der Browser öffnet sich nicht | Das Programm probiert mehrere Browser. Gib die Adresse von Hand ein: ''http://localhost:8080''. Der Start dauert auf langsamen Rechnern bis zu einer Minute: **nicht noch einmal** auf das Symbol klicken. | | Nach dem Aktualisieren zeigt das Programm noch die **alte Version** | Die **alte Instanz läuft noch**, und das Symbol öffnet nur den Browser darauf. Beende sie mit dem Knopf **BEENDEN** oben rechts und starte neu. Bleibt sie hängen: Linux und macOS ''pkill -f webmobaledlib.py''. Windows: ''netstat -ano'' zeigt hinter :8080 die Nummer des Prozesses, ''taskkill /PID /F'' beendet ihn. | | Meldung **„Connection lost“**, die Seite baut sich immer wieder neu auf | Meist ist der Rechner **langsam**: Der Browser braucht nach dem Seitenaufbau noch 10 bis 30 Sekunden, bis er sich mit dem Programm verbindet, und das Programm wartet nur 60 Sekunden. Schließe andere Programme, benutze einen leichteren Browser und wähle in den Programm Einstellungen das **kompakte Layout**. Auf dem **iPad oder iPhone** siehe den Abschnitt [[#raspberry_pi_und_netz|Raspberry Pi und Netz]]. | | Nach jeder Änderung bleibt die Tabelle einen Moment **weiß** | Meist zeichnet der Browser ohne Grafikbeschleunigung. Schalte im Browser die **Hardwarebeschleunigung** ein, verkleinere Fenster und Browser-Zoom oder wähle das kompakte Layout. Hilft das nicht, aktualisiere auf die neueste Version. | | Rote Meldung **„Nicht alle Dateien passen zur Version …“** | Es wurden nicht alle Dateien einer Version eingespielt. Jede Zeile nennt Datei, gefundene und verlangte Version. Mache **Hilfe → Update webMobaLedLib …** (das Update stellt fehlende und beschädigte Dateien wieder her) oder siehe [[#wenn_nichts_mehr_geht|Wenn nichts mehr geht]]. | | Das Programm startet gar nicht | Starte es in einem Terminal oder einer Eingabeaufforderung und lies die Meldung: Windows ''install\start_windows.bat'', macOS ''install/start_mac.command'', Linux ''install/start_linux.sh''. Das Protokoll liegt im Datenordner. | | Die Konfiguration wird nicht gespeichert | Der Datenordner ist nicht beschreibbar. Dann nimmt das Programm einen Ersatzordner und warnt im Protokoll. Einen anderen Ort stellt ''MLL_DATA_DIR'' ein. | ===== Die Lichtmaschine verbinden und das Programm übertragen ===== ^ Beobachtung ^ Ursache und Hilfe ^ | **Mit ARDUINO verbinden** klappt nicht, oben steht **Nicht verbunden** | Bei einer **neuen** Lichtmaschine ist das normal: Es läuft noch **kein MobaLedLib-Programm**. Stelle Board und Anschluss ein und übertrage zuerst das Programm, siehe [[anleitungen:webmobaledlib:pg_arduino|Verbinden und Übertragen]]. | | Bei **USB Port erkennen** erscheint kein Anschluss | Prüfe das **USB-Kabel** (es muss Daten übertragen, kein reines Ladekabel) und stecke die Lichtmaschine neu an. **Windows:** Bei Nachbauten mit dem Chip **CH340** fehlt oft der [[https://www.wch-ic.com/downloads/CH341SER_EXE.html|CH340-Treiber]]. **Linux und Raspberry Pi:** Du musst in der Gruppe ''dialout'' sein (''groups'' zeigt es; sonst ab- und wieder anmelden). | | Das **Hochladen bricht ab** | Prüfe das **Board** in **Optionen Werkzeuge → LED ARDUINO**. Bei vielen Nano-Nachbauten hilft **Nano Normal (old Bootloader)**. Unter Linux und macOS erkennt das Programm den Typ nicht selbst: Wähle ihn immer richtig. | | Das Übertragen dauert **sehr lange** | Beim **ersten Mal** ist das normal (bis zu 10 Minuten): PlatformIO lädt Werkzeuge aus dem Internet nach. Prüfe sonst die Internetverbindung. | | Meldung **„PlatformIO nicht gefunden“** | Die Installation wurde nicht ganz beendet. Starte das Installationsskript noch einmal ([[anleitungen:webmobaledlib:installation|Installation]]). | | Beim **Raspberry Pico** meldet das Hochladen //picotool was unable to connect// (Linux) | Der USB-Zugriff für den Pico ist nicht eingerichtet. Klicke in **Optionen Werkzeuge → ENTWICKLUNGSUMGEBUNG** auf **USB-Zugriff für den Pico einrichten** (einmalig, das Programm fragt nach dem Passwort). | | **ESP32:** Das Hochladen bleibt bei //Connecting........_____// stehen und endet mit //Failed to connect to ESP32// | Der Chip kommt nicht in den Bootloader: **Halte auf dem ESP32-Board die Taste BOOT gedrückt**, sobald im Fenster „Connecting…“ erscheint, bis „Writing at …“ kommt. Viele Nachbauten haben keinen zuverlässigen Auto-Reset. Hilft es nicht: ein Datenkabel direkt am Rechner ohne Hub und einen anderen USB-Port probieren. | | Meldung **„Die ARDUINO IDE wurde nicht gefunden“** | Mit **PlatformIO** (Standard) sollte sie nicht kommen. Klicke in **Optionen Werkzeuge → ENTWICKLUNGSUMGEBUNG** auf **PlatformIO prüfen**. Benutzt du die ARDUINO IDE, siehe [[anleitungen:webmobaledlib:wz_arduino_einstellungen|ARDUINO Einstellungen]]. | ===== Das Programm erzeugen: Makros und Tabelle ===== ^ Beobachtung ^ Ursache und Hilfe ^ | Ein **Makro** wird beim Doppelklick nicht vorausgewählt, oder in der Liste stehen **Makros doppelt** | Im Ordner **libraries** darf nur stehen, was dort hingehört (**MobaLedLib** und die **Erweiterungen**). Jeder Ordner mit einer Datei ''MobaLedLib.properties'' wird als Erweiterung eingelesen. Entferne fremde oder alte Ordner (zum Beispiel ''ServoAnim'', ''LEDColorAnim'', ''MultiLEDColorAnim'', ''Pattern'', ''ServoAnim2B''). | | Meldung beim Start: **„Das Makro … ist schon eingebaut … und wird ignoriert“** | Eine Erweiterung bringt ein Makro mit einem Namen, den es schon gibt. Benenne den Ordner der Erweiterung um oder entferne ihn. | | Beim Kompilieren fehlt **MobaLedLib.h** oder eine Bibliothek | Die Bibliotheken müssen installiert sein. Das Programm bietet das beim Start an. | | Ein **Text** ist in meiner Sprache noch **deutsch** | Mache ein Bildschirmfoto und schreibe Stelle und Sprache ins Forum. Die Übersetzungen werden laufend ergänzt. | ===== Raspberry Pi und Netz ===== ^ Beobachtung ^ Ursache und Hilfe ^ | Das Symbol meldet „Der Dienst konnte nicht gestartet werden“ | Führe ''sudo bash install_pi.sh --no-check'' noch einmal aus oder starte den Dienst mit ''sudo systemctl start mobaledlib-web''. | | Die Seite lädt nicht | Prüfe mit ''systemctl status mobaledlib-web'' den Dienst. Hänge den Port an die Adresse (''http://:8080''). Warte beim ersten Start eine Minute. | | ''raspberrypi.local'' wird nicht gefunden | Dieser Name funktioniert nicht überall (Gastnetz, WLAN mit Geräteisolation, Firmennetz, Android). Nimm die **IP-Adresse** (steht im Router). | | Das Anmeldefenster nimmt das Passwort nicht an | Benutzer ist ''mobaledlib''. Das Passwort ist das Standardpasswort ''mobaledlib'' oder das im Programm gesetzte. Vergessen? Lösche die Datei ''web_password.json'' im Datenordner. | | Der Dienst startet nicht | ''journalctl -u mobaledlib-web -e'' zeigt die Meldung. ''pi_check.py'' zeigt fehlende Pakete. | | Auf dem **iPad oder iPhone** bricht die Verbindung ab, zum Beispiel beim Wechsel der **Tabelle** („Connection lost“) | Alle Browser auf dem iPad und iPhone senden die Anmeldung nicht beim Aufbau der Dauerverbindung mit. Aktualisiere das Programm auf Version **3.05 oder neuer**: Seitdem merkt es sich die Anmeldung mit einem **Cookie**. **Cookies müssen erlaubt sein.** | | **Firefox oder Chrome** auf dem iPad zeigt **gar keine Verbindung** und keine Anmeldung | iOS verlangt die Berechtigung **Lokales Netzwerk**. Schalte sie ein: **Einstellungen → Datenschutz & Sicherheit → Lokales Netzwerk** (oder bei den Einstellungen des Browsers). Oder benutze **Safari**. | | Ein anderer Rechner im Netz erreicht die Oberfläche nicht | Meist die **Firewall** (Windows: Netzwerkprofil „Öffentlich“). Siehe [[anleitungen:webmobaledlib:wz_netzwerk|Zugriff aus dem Netz]]. | | Der Pi **hängt sich auf**, oder das Programm verschwindet ohne Meldung | Meist ist die **Stromversorgung** zu schwach (Netzteil, USB-Festplatte, Arduino mit vielen LEDs am USB-Anschluss) oder der Pi zu heiß. Benutze das offizielle Netzteil, versorge LEDs und Festplatten getrennt und lass das Gehäuse frei stehen. Das Protokoll enthält ab Version 2.22 Zeilen zu Temperatur und Spannung. | ===== Wenn nichts mehr geht ===== Ein Update kann abbrechen (Stromausfall, Programm beendet, ein Virenprogramm sperrt eine Datei) oder Dateien können fehlen. Probiere der Reihe nach: - **Orange Hinweis „Das Update … ist abgebrochen“:** Das Programm ist **automatisch zur vorherigen Version zurückgegangen**. Deine Tabellen und Einstellungen sind nicht betroffen. Schließe den Hinweis mit **OK** und versuche das Update später noch einmal. Scheitert es wieder an derselben Datei, beende das Programm, halte das Sicherungs- oder Virenprogramm kurz an und wiederhole das Update. - **Rote Meldung „… Dateien fehlen oder haben eine andere Größe als in der Prüfliste“:** Mache **Hilfe → Update webMobaLedLib …**. Auch bei gleicher Version **stellt das Update fehlende und beschädigte Dateien wieder her**. Starte danach neu. - **Das Programm startet gar nicht, oder rot „Das automatische Zurückgehen war nicht vollständig“: Reparaturskript.** Es braucht das Programm nicht und läuft auch, wenn es beschädigt ist. Beende das Programm vorher. ^ System ^ Aufruf ^ | **Windows** | im Ordner **python\install** die Datei **repair_windows.bat** doppelklicken | | **macOS** | im Ordner **python/install** die Datei **repair_mac.command** doppelklicken | | **Linux** | ''bash install/repair_linux.sh'' im Ordner **python** | | **Raspberry Pi** | ''bash install/repair_linux.sh'' im Ordner **python**, danach ''sudo systemctl restart mobaledlib-web'' | Das Skript macht ein abgebrochenes Update rückgängig, vergleicht die Dateien mit der Prüfliste, sucht ein vollständiges Release (zuerst die zwischengespeicherten, sonst von GitHub) und schreibt nur die fehlenden oder abweichenden Dateien neu. Die ersetzten Dateien sichert es vorher. Es fragt vor dem Schreiben (**j**). **Ohne Internet:** Lade ''webmobaledlib.zip'' von [[https://github.com/haroldlinke/WebMLL/releases|GitHub]] und rufe das Skript mit ''--zip '' auf. ''--check-only'' prüft nur. - **Das Update bricht mit „keine Prüfliste“, „unvollständig“ oder „würde … Dateien löschen“ ab:** Das Paket ist nicht das vollständige Release. Es wurde **nichts verändert**. Melde es im Forum. - **Auch das Reparaturskript fehlt oder geht nicht (von Hand):** - Beende das Programm. - Lade das aktuelle ''webmobaledlib.zip'' von [[https://github.com/haroldlinke/WebMLL/releases|GitHub]]. - **Benenne den Ordner python um** (zum Beispiel in //python_defekt//), entpacke das ZIP (es enthält den Ordner **python**) und starte wie gewohnt. Auf dem Raspberry Pi startest du den Dienst neu: ''sudo systemctl restart mobaledlib-web''. - Deine Tabellen, Einstellungen und das Passwort liegen im **Datenordner** und bleiben dabei erhalten. Die Python-Umgebung (**venv_web** bzw. **venv**) gehört nicht zum ZIP: Liegt sie im alten Ordner, verschiebe sie in den neuen. - **Dateien zurückholen:** Ersetzte und gelöschte Dateien liegen im Datenordner unter ''update_backup//'' (letzte fünf), die von der Reparatur ersetzten unter ''repair_backup//''. **Alles neu installieren (zum Beispiel auf dem Raspberry Pi):** Ein Skript namens //uninstall.bat// gibt es nicht. Auf dem Pi entfernt ''sudo bash ~/mobaledlib/python/pi/uninstall_pi.sh'' den Dienst, das Desktop-Symbol und die sudo-Regel, **nicht** den Ordner //mobaledlib//. Lösche ihn danach selbst, entpacke das ZIP neu (''unzip webmobaledlib.zip'' in einem leeren Ordner //mobaledlib//) und führe im Ordner **mobaledlib/python/pi** ''sudo bash install_pi.sh'' aus. Deine Daten bleiben erhalten, denn der Datenordner liegt außerhalb. ===== Wenn nichts hilft ===== Schreibe ins [[https://forum.mobaledlib.de/viewforum.php?f=14|Forum der MobaLedLib]]. Nenne dein **System**, die **Programmversion** (unter dem Titel der Oberfläche), **was du getan hast** und die **Fehlermeldung**. Hänge die Datei **webmobaledlib.log** an (siehe oben).