JK BMS
SK EN DE

PIN pre zmeny, zmena WiFi a zabudnutý PIN

Platí pre JK BMS Web Gateway od verzie R1-V1.03n a DEYE Web Gateway od verzie R1-V1.01k. Postup je pre obe brány rovnaký, líši sa len názov konfiguračnej WiFi: JK-BMS-Setup pri JK BMS a DEYE-Setup pri DEYE.

Čo chráni PIN

Každá zmena v bráne vyžaduje PIN: nastavenia BMS alebo meniča, nastavenia web servera, zmena WiFi, zadanie aj odstránenie licencie. Čítanie údajov PIN nepotrebuje, takže dashboard aj Home Assistant zobrazujú hodnoty bez neho.

⚠️ Zmeňte predvolený PIN hneď po inštalácii. Kým platí 666666, dashboard vás na to po každom načítaní upozorní.

Ako zmeniť PIN

  1. Otvorte dashboard brány v prehliadači.
  2. V menu (☰) zvoľte Nastavenia web servera.
  3. V časti PIN pre zmeny zadajte súčasný PIN, nový PIN a nový PIN znova.
  4. Stlačte Zmeniť PIN.

Prehliadač si PIN zapamätá. Na inom zariadení sa vás dashboard pri prvej zmene na PIN opýta.

Presun brány na inú WiFi sieť

Ak PIN poznáte a brána je dostupná:

  1. V dashboarde stlačte Zmeniť WiFi sieť a zadajte PIN.
  2. Brána zabudne sieť, reštartuje sa a vytvorí WiFi JK-BMS-Setup alebo DEYE-Setup.
  3. Pripojte sa k nej mobilom. Otvorí sa stránka, na ktorej vyberiete svoju sieť a zadáte jej heslo.
  4. Brána sa pripojí k novej sieti. PIN ostáva nezmenený.

Zabudnutý PIN alebo brána sa nepripojí k starej WiFi

Použite tlačidlo BOOT na doske ESP32 (pri USB konektore, niekedy označené IO0). Potrebujete k nemu fyzický prístup, preto sa takto nedá obísť PIN na diaľku.

  1. Podržte tlačidlo BOOT 5 sekúnd. Funguje za chodu aj hneď po zapnutí.
  2. Brána zabudne uloženú WiFi sieť a vráti PIN na 666666.
  3. Reštartuje sa a vytvorí WiFi JK-BMS-Setup alebo DEYE-Setup.
  4. Nastavte WiFi ako pri prvom štarte.
  5. Otvorte dashboard a hneď zmeňte PIN, ako je popísané vyššie.

Licencia, nastavenia BMS, CAN, meniča aj web servera ostávajú zachované. Stratí sa len WiFi sieť a vlastný PIN.

Konfiguračná WiFi nemá heslo. Brána ju otvorí len vtedy, keď nemá uloženú žiadnu sieť, takže počas bežnej prevádzky nie je dostupná.

Pre vývojárov a skripty

Čítanie cez REST API (GET) funguje bez PIN. Každý POST musí posielať hlavičku X-PIN s PIN a Content-Type: application/json. Bez PIN alebo s nesprávnym PIN brána odpovie 401, po 5 chybách 429. PIN sa mení cez POST /api/pin s telom {"newPin": "1234"}. Podrobnosti sú v dokumentácii REST API. 

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

Integrácia pre Home Assistant iba číta, preto PIN nepotrebuje.