Probleme und Lösungen
Such dein Problem in der Liste. Die meisten Dinge haben eine einfache Ursache.
Die Weboberfläche lädt nicht
Der Browser zeigt „Not Found“ oder eine leere Seite.
Die Weboberfläche wurde nicht auf den ESP32 geschrieben. Führe Schritt 2 aus Firmware installieren aus (Upload Filesystem Image oder pio run -t uploadfs).
hyperled.local wird nicht gefunden.
- Unter Windows nimm http://hyperled (ohne .local).
- Dein Handy oder Computer muss im selben Netzwerk sein wie der ESP32. Ein Gastnetz oder die „Client-Isolation“ deines Routers blockiert das.
- Such die IP-Adresse von „hyperled“ in deinem Router und öffne http://<diese Adresse>.
- Taucht er im Router gar nicht auf, ist er nicht mit deinem WLAN verbunden: siehe nächster Punkt.
Ich bekomme ihn nicht ins WLAN.
- Benutze ein 2,4-GHz-Netz; 5 GHz wird nicht unterstützt.
- Prüfe das Passwort (Groß- und Kleinschreibung).
- Kann sich der ESP32 nicht mit deinem WLAN verbinden, bietet er wieder sein eigenes Netz HyperLED-AP an. Verbinde dich damit, öffne http://192.168.4.1 und gib die Daten neu ein.
Die LEDs tun nichts
- Gar nichts leuchtet: Sind Streifen und Netzteil angeschlossen, und ist die Masse des ESP32 mit der Masse des Netzteils verbunden? Hängt die Datenleitung an DIN (dem Ende, bei dem der Pfeil vom Streifen weg zeigt), und ist der Pin derselbe wie unter Geräte → LED-Hardware (Voreinstellung GPIO 4)?
- Ist das Segment eingeschaltet und die Helligkeit über 0? Schau auf die Seite Licht: Wähle das Segment und drück seinen Power-Knopf.
- Nur die ersten LEDs leuchten oder es sind zu viele: Prüfe die Anzahl LEDs unter Geräte → LED-Hardware.
- Die Farben stimmen nicht: Wähle den LED-Typ, der zu deinem Streifen passt.
Die LEDs flackern oder zeigen zufällige Pixel
Das liegt fast immer am Datensignal oder am Strom:
- Verbinde die Masse von Netzteil und ESP32.
- Setz den 330-Ω-Widerstand in die Datenleitung und halte sie kurz.
- Setz den Kondensator (1000 µF) an den Stromeingang des Streifens.
- Benutze einen Pegelwandler (74AHCT125) von 3,3 V auf 5 V.
- Versorge den Streifen mit einem ausreichend starken Netzteil, lange Streifen von beiden Enden.
Laufen Streifen und ESP32 am selben schwachen USB-Anschluss, gib dem Streifen ein eigenes Netzteil.
Siehe Verkabelung und Strom.
Die LEDs sind dunkler als erwartet
Der Automatische Helligkeitsbegrenzer von HyperLED senkt die Helligkeit, damit dein Netzteil nicht überlastet wird. Prüfe den Maximalen Netzteil-Strom (mA) unter Geräte → LED-Hardware → Stromversorgung. Kann dein Netzteil mehr liefern, erhöhe den Wert. Stell ihn nie höher, als Netzteil und Leitungen verkraften.
Die Farben am Ende eines langen Streifens sind rötlich oder dunkel
Das ist Spannungsabfall. Speise den Strom an beiden Enden (oder in der Mitte) mit dicken Leitungen ein.
Ein Panel flackert oder zeigt Geisterbilder
Ändere den Treiber-Chip unter Geräte → Verbundene Geräte für dieses Gerät („bei Geisterbildern/Flackern anpassen“). Startet das Panel nicht, braucht es vielleicht mehr Speicher, als das Board hat: Wähle ein kleineres Panel.
Ein Slave wird nicht gefunden
- Hat der Slave Strom, und läuft die Slave-Firmware?
- Drück Geräte suchen unter Geräte → Verbundene Geräte.
- Kabel: TX des Masters geht an RX des Slaves (Master GPIO 17 → Slave GPIO 16), und die Massen müssen verbunden sein.
- Funk: Master und Slave müssen nah genug für den Funk sein; der Slave findet den Kanal nach ein paar Sekunden selbst.
Home Assistant zeigt HyperLED nicht
- Öffne Einstellungen → WLAN / MQTT. Über den Feldern sagt HyperLED, ob es verbunden ist und warum nicht.
- Drück Verbindung testen. Prüfe IP-Adresse, Port, Benutzer und Passwort.
- Drück In Home Assistant neu anmelden.
- Ist die MQTT-Integration in Home Assistant eingerichtet, und nimmt der Broker den Benutzer an?
Ein Update funktioniert nicht
- Prüfe die Internetverbindung (Einstellungen → System, Auf Update prüfen).
- Wird das Update abgelehnt, weil die Firmware nicht mehr in den Update-Platz passt, spiel die aktuelle Version einmal per USB auf, siehe Updates, Sicherung und Zurücksetzen.
Ein Plugin funktioniert nicht
Öffne die Live-Werte des Plugins (Einstellungen → Plugins). Sie zeigen den Zustand und den Grund, die gelesenen Werte und den Anfang der Antwort. Typische Ursachen: eine falsche Adresse, das Gerät ist ausgeschaltet, oder ein anderes Plugin nutzt das Segment schon.
Zeitpläne laufen nicht
Der Controller braucht die Uhrzeit aus dem Internet. Schau unter Szenen → Zeitpläne: Die Seite zeigt die Geräte-Uhrzeit oder sagt, dass sie nicht synchronisiert ist. Prüfe auch die Zeitzone.
Neu anfangen
- Eine Sicherung speichert vorher alles (Einstellungen → System → Sicherung).
- Auf Werkseinstellungen zurücksetzen löscht alle Einstellungen, siehe Updates, Sicherung und Zurücksetzen.
Immer noch nicht gelöst?
Eröffne ein Issue und beschreibe, was du getan hast und was du siehst. Es hilft, wenn du die Version nennst, die du nutzt (Einstellungen → System), und welche LEDs und welches Board du hast.
Wenn du einen Computer anschließen kannst: Der Controller behält die letzte Minute seines Logs im Speicher. Öffne http://hyperled.local/api/log im Browser für den laufenden Controller oder http://hyperled.local/api/lastlog für die Minute vor dem letzten Absturz oder unerwarteten Neustart. Häng es an dein Issue.