Fehlersuche
Nach Symptom geordnet. Oft hilft schon der Blick auf den Broker: mosquitto_sub -h localhost -t 'schaltli/#' -v auf dem Pekaway-System zeigt, was bei Schaltli passiert, siehe MQTT-Broker.
Der Designer
Der Designer lässt sich nicht öffnen. Nimm die IP-Adresse des Pekaway-Systems mit Port 3000, http://<IP>:3000. Wartet das System auf Port 3000? systemctl status schaltli-designer.socket auf dem Pekaway-System zeigt es. Der Designer selbst startet erst beim ersten Aufruf; ob er dabei einen Fehler hatte, zeigt systemctl status schaltli-designer.
Deploy to Device fehlt im Menü. Der Designer wurde ohne NEXT_PUBLIC_DEPLOY_ENABLED=true in .env.local gebaut. Trag die Zeile ein und führe das Installationsskript noch einmal aus, es baut dann neu.
Unter dem Screen steht, das Gerät sei auf diesem Designer nicht verfügbar. Das Projekt wurde für ein Gerät angelegt, das dieser Designer nicht kennt. Er öffnet es trotzdem, mit der Beschreibung, die im Projekt steckt. Unter Settings › Device kannst du dem Projekt mit Load Device ein Gerät geben, das dieser Designer kennt.
Das Block-Menü ist leer. Das Menü sagt, wo es gesucht hat. Steht dort «No broker at», erreicht der Browser den Broker nicht auf Port 9001, siehe MQTT-Broker. Steht dort «Nothing announces itself under», kündigt auf dem Broker kein Gerät etwas an, oder unter einem anderen Präfix, siehe Bausteine. Auf einem Pekaway-System kündigt die VanPi-Brücke an. Fehlt sie oder ist sie zu alt, richtet das Installationsskript sie neu ein, siehe VanPi-Brücke.
Ein Gerät
Ein neues Board taucht nirgends auf. Es braucht erst die Firmware über USB, siehe Firmware flashen, und dann WLAN und Broker, siehe Einrichten.
Das Board zeigt «WLAN nicht erreichbar». Das WLAN aus der Einrichtung ist nicht in Reichweite oder hat sich geändert. Bring das Board mit der Geste zurück in die Einrichtung und trag das WLAN neu ein.
Das Gerät ist im WLAN, aber nicht im Designer. Es erreicht den Broker nicht. Prüfe in der Einrichtung, ob unter Host die IP-Adresse des Pekaway-Systems steht und der Port 1883 ist.
Das Gerät zeigt keine Werte, nur leere Anzeigen. Leere Anzeigen heissen: Auf dem Topic ist noch kein Wert angekommen, siehe Noch kein Wert. Prüfe mit mosquitto_sub, ob unter schaltli/state/… Werte liegen.
Ein Schalter springt zurück. Die Anlage hat den Befehl nicht ausgeführt oder meldet einen anderen Zustand. Der Schalter zeigt immer, was die Anlage meldet. Prüfe, ob das Topic zum Schreiben stimmt und ob die VanPi-Brücke läuft.
Übertragen
Der Dialog findet kein Gerät für dieses Projekt. Er zeigt nur Geräte desselben Typs wie das Projekt. Er nennt, welche Geräte sich stattdessen melden. Passt eines davon, wurde das Projekt für einen anderen Gerätetyp angelegt; unter Settings › Device gibst du ihm das richtige.
Offline - will apply automatically when the device reconnects Das Gerät ist gerade nicht online. Das Projekt wartet auf dem Broker und wird übernommen, sobald das Gerät wieder da ist.
Failed mit «Download failed». Das Gerät hat das Projekt nicht vom Designer laden können. Die Geräte laden es über die Adresse des Designers im lokalen Netz. Läuft der Designer auf einem Rechner mit mehreren Netzwerken oder einem VPN, kann er eine Adresse wählen, die das Gerät nicht erreicht.
Der Dialog verlangt zuerst ein Firmware-Update. Die Firmware des Geräts ist zu alt für dieses Projekt. Aktualisiere sie im selben Dialog, siehe Firmware-Updates.
Flashen
Der Browser bietet keinen Anschluss an. Nimm Chrome oder Edge auf einem Computer. Prüfe, ob das Kabel Daten überträgt. Beim Knob dreh den USB-C-Stecker um.
Das Flashen bricht ab oder das Board startet danach nicht. Flashe noch einmal mit Erase the whole chip first. Prüfe, ob du das richtige Board gewählt hast. Mehr unter Firmware flashen.
Wenn nichts hilft
Beschreib das Problem in einem Issue auf GitHub, mit der Ausgabe von curl http://<IP>:3000/api/version und, falls es ein Gerät betrifft, dessen Typ.