Änderungs-PIN, WLAN wechseln und vergessene PIN

Gilt für das JK BMS Web Gateway ab Version R1-V1.03n und das DEYE Web Gateway ab Version R1-V1.01k. Beide Gateways funktionieren gleich; nur der Name des Einrichtungs-WLANs unterscheidet sich: JK-BMS-Setup beim JK BMS, DEYE-Setup beim DEYE.

Was die PIN schützt

Jede Änderung am Gateway braucht die PIN: BMS- oder Wechselrichter-Einstellungen, Webserver-Einstellungen, WLAN-Wechsel, Eingeben oder Entfernen der Lizenz. Das Lesen von Daten nicht, daher zeigen Dashboard und Home Assistant die Werte ohne PIN.

Ab Werk ist die PIN 666666.
Sie können sie auf beliebige 4 bis 8 Ziffern ändern.
Abschalten lässt sie sich nicht.
Nach 5 falschen PINs in Folge lehnt das Gateway 60 Sekunden lang jede Änderung ab.

⚠️ Ändern Sie die Standard-PIN gleich nach der Installation. Solange 666666 gilt, erinnert Sie das Dashboard bei jedem Laden daran.

PIN ändern

Öffnen Sie das Dashboard des Gateways im Browser.
Wählen Sie im Menü (☰) Webserver-Einstellungen.
Geben Sie unter PIN für Änderungen die aktuelle PIN, die neue PIN und die neue PIN noch einmal ein.
Drücken Sie PIN ändern.

Der Browser merkt sich die PIN. Auf einem anderen Gerät fragt das Dashboard bei der ersten Änderung danach.

Gateway in ein anderes WLAN umziehen

Wenn Sie die PIN kennen und das Gateway erreichbar ist:

Drücken Sie im Dashboard WLAN-Netzwerk ändern und geben Sie die PIN ein.
Das Gateway vergisst das Netzwerk, startet neu und öffnet das WLAN JK-BMS-Setup oder DEYE-Setup.
Verbinden Sie sich mit dem Handy. Es öffnet sich eine Seite, auf der Sie Ihr Netzwerk wählen und dessen Passwort eingeben.
Das Gateway verbindet sich mit dem neuen Netzwerk. Die PIN bleibt unverändert.

PIN vergessen oder das Gateway erreicht sein altes WLAN nicht

Verwenden Sie die BOOT-Taste auf der ESP32-Platine (neben dem USB-Anschluss, manchmal mit IO0 beschriftet). Dafür braucht man physischen Zugang, über das Netzwerk lässt sich die PIN so nicht umgehen.

Halten Sie BOOT 5 Sekunden gedrückt. Das geht im Betrieb und direkt nach dem Einschalten.
Das Gateway vergisst das gespeicherte WLAN und setzt die PIN auf 666666 zurück.
Es startet neu und öffnet das WLAN JK-BMS-Setup oder DEYE-Setup.
Richten Sie das WLAN wie beim ersten Start ein.
Öffnen Sie das Dashboard und ändern Sie sofort die PIN, wie oben beschrieben.

Die Lizenz sowie die BMS-, CAN-, Wechselrichter- und Webserver-Einstellungen bleiben erhalten. Verloren gehen nur das WLAN und Ihre eigene PIN.

Das Einrichtungs-WLAN hat kein Passwort. Das Gateway öffnet es nur, wenn kein Netzwerk gespeichert ist, im normalen Betrieb ist es also nicht erreichbar.

Für Entwickler und Skripte

Lesen über die REST-API (GET) funktioniert ohne PIN. Jeder POST muss den Header X-PIN mit der PIN und Content-Type: application/json senden. Ohne PIN oder mit einer falschen antwortet das Gateway mit 401, nach 5 Fehlern mit 429. Die PIN wird mit POST /api/pin und dem Body {"newPin": "1234"} geändert. Details stehen in der REST-API-Dokumentation.

curl -X POST http://jkbms.local/api/server-config \
  -H "Content-Type: application/json" \
  -H "X-PIN: 666666" \
  -d '{"pollIntervalMs": 5000}'

Die Home-Assistant-Integration liest nur und braucht daher keine PIN.