Selbst bauen · Schritt 7
Fehlersuche
Diese Seite sammelt, was die Unterlagen des Projekts zu Fehlern sagen. Erfahrungen aus dem Betrieb gibt es noch nicht.
Auf dieser Seite
Flashen
Der SuperMini erscheint nicht als Port
BOOT gedrückt halten, USB einstecken, BOOT loslassen, flashen, danach einmal RESET drücken. Das hilft bei einem fabrikneuen Board. Hängt das Board am Netzteil, vorher die Brücke zum Pin 5V abziehen, siehe Steckbrett.
Der SuperMini startet nach dem Flashen nicht
Laut den Unterlagen ist der eingestellte Flash-Modus für dieses Board ungeprüft. Der Hinweis
dort: den Flash-Modus dio versuchen.
Bus
Abschluss prüfen
Alles stromlos, dann zwischen CAN-H und CAN-L messen.
| Messwert | Ursache |
|---|---|
| etwa 60 Ω | alles richtig |
| etwa 40 Ω | Der Widerstand an einem mittleren Modul ist noch drauf. |
| etwa 120 Ω | Ein Ende ist nicht abgeschlossen. |
Ein Modul meldet sich nicht
- Masse zwischen den Boards verbunden? Sie ist der Bezug für CAN.
- 5 V an jedem Board angekommen? Die Brücke von der Plusleiste zum Pin 5V steckt?
- CTX und CRX vertauscht? TX des Controllers gehört an CTX, RX an CRX.
- Konsole des Moduls ansehen. Beim Start gibt es Board und Pinbelegung aus. Vor dem USB-Kabel an diesem Modul die Brücke zum Pin 5V abziehen.
- Ein Modul ohne Adresse meldet sich alle 2 Sekunden an. Der Hub zeigt es erst unter „Neue Geräte“, wenn er selbst übernommen ist.
Ein Modul erscheint als „Typ offen“
Es hat keinen gesetzten Typ und keinen Vorschlag. Unter „Neue Geräte“ steht, was es erkannt hat: kein Sensor, mehrere Sensorarten, ein Chip, der nicht unterstützt wird, oder nur DS18B20, bei dem die Übernahme fragt, wo der Fühler misst. Den Typ wählt man bei der Übernahme. Für jeden Sensor gehört ein eigenes Modul dazu. Ohne gesetzten Typ sucht das Modul alle 30 Sekunden neu, ein später angesteckter Sensor erscheint also von selbst.
„Falscher Sensor“ oder „Kein Sensor“
Der Sensor passt nicht zum Typ des Moduls oder antwortet nicht. Der Alarm nennt, was erwartet wurde und was steckt. Richtigen Sensor anstecken oder mit „Typ ändern“ einen Typ wählen, der den Chip nimmt. Die Meldung endet von selbst, spätestens 60 Sekunden nach dem Anstecken. Steht dort BMP280 statt BME280: Manche Platinen sind falsch beschriftet.
Die Versorgung am Modul zeigt „nicht gemessen“
Auf dem Steckbrett speist das 5-V-Netzteil den Pin 5V direkt, ohne Spannungsteiler. Werte unter 3 V gelten dann als „nicht gemessen“, ohne Warnung. In den Einstellungen des Hubs „Erwartete Versorgung“ auf 5 V stellen.
Hub
Der Hub erscheint nicht unter „Neue Geräte“
| Prüfen | Hinweis |
|---|---|
| Geduld | Die Netzsuche kann bis etwa drei Minuten dauern. |
| Einrichtungscode | Er steht unter „Geräte“, vollständig mit dem Server-Schlüssel am Ende. Ein neuer Code wird erst nach einem Neustart des Hubs wirksam. |
| Zertifikat | Passt das Zertifikat nicht zum Server-Schlüssel, verbindet sich der Hub nicht. Den Grund zeigt er im Einrichtungs-WLAN. |
| Netz | Liegt der Server in einem anderen Netz, etwa hinter VLAN oder VPN, muss die Server-Adresse im Einrichtungs-WLAN eingetragen werden. |
| Docker Desktop | mDNS erreicht das Heimnetz dort nicht. Der Hub sucht dann selbst nach Port 8443 oder 443. |
| Ports 8443, 8883 | HTTPS und MQTT über TLS müssen vom Hub aus erreichbar sein. |
| Statuslicht | Blau blinkend: Einrichtungs-WLAN offen. Gelb blinkend: verbindet. Grün: online. Ab Firmware 0.10.0. |
Das Einrichtungs-WLAN erneut öffnen
Den Taster am Hub lang drücken. Findet ein neuer Hub zehn Minuten lang keinen Server, öffnet er es von selbst wieder. Seit Firmware 0.10.0 ist es offen, ohne Passwort; ein Passwort-Aufkleber älterer Firmware gilt nicht mehr.
Der Hub wurde im Server entfernt
Lehnt der Broker die Zugangsdaten ab, versucht der Hub es mit wachsendem Abstand weiter. Nach etwa 65 Sekunden meldet er sich wieder unter „Neue Geräte“.
Server
Der erste Start dauert lange
Beim Bauen des Backend-Images wird die Firmware mitgebaut. Dafür lädt PlatformIO einmalig die Werkzeuge für den ESP32 herunter. Spätere Builds nutzen den Zwischenspeicher.
Nach einem Update starten Dienste nicht
Wer von einem älteren Stand kommt, bei dem Container noch als root liefen, setzt einmal die Besitzer der Volumes. Das steht unter Server installieren.
Betrieb
Ein Ausgang ist gesperrt
Die Detailansicht nennt den Grund. Ursache beheben, dann freigeben. Eine Sperre übersteht Neustarts, sie verschwindet nicht von selbst. Mehr unter Störung und Sperre.
Ein Sensor ist außer Betrieb
Sensor prüfen oder tauschen, dann in der Oberfläche zurücksetzen. Mehr unter Sensoren prüfen.
Der Füllstand zeigt Unsinn
Der Sensor ist beschlagen. Kondenswasser auf einem Ultraschallsensor stört die Messung.
„Kalibrierung ausstehend“
Füllstand, Bodenfeuchte und Antriebe haben keine Voreinstellung. Bis zur Kalibrierung zeigt ein Sensor seinen Rohwert und steuert nichts, ein Antrieb fährt nicht. Der Link in der Warnung öffnet den Assistenten. Mehr unter Kalibrieren.
Ein Deckel öffnet nicht
| Grund | Was tun |
|---|---|
| Kalibrierung ausstehend | Antrieb kalibrieren |
| Windschutz | warten, bis es 10 Minuten lang ruhig war, oder die Grenze anpassen |
| Regen | Die Verriegelung hält die Deckel zu, auch bei ausgefallenem Sensor. |
| Kammer im Frostschutz | Der Deckel öffnet erst über 40 °C. |
| Windsensor ausgefallen | Sensor prüfen. Solange er fehlt, bleiben die Deckel zu. |
Die Begründung steht in der Oberfläche unter „Warum?“.
Pumpen laufen nicht
Pumpen laufen nur, wenn der Füllstand des Tanks bekannt, kalibriert und über der Untergrenze ist. Ist der Füllstandsensor nicht in Ordnung, bleiben sie aus. Mehr unter Wasser.
Das Licht geht nicht an
Ohne gestellte Uhr steht der Regler für das Licht, weil er ein Zeitfenster hat. Der Hub stellt seine Uhr über das Netzwerk.