Hardvér a nastavenie
Najprv si podľa návodu nižšie pripravte dosku a zapojenie, potom nahrajte firmvér cez prehliadač v časti Automatické nastavenie.
Potrebný hardvér
Gateway potrebuje ESP32 dosku, RS485 prevodník a (voliteľne) CAN prevodník, zapojené podľa tabuliek nižšie. Presné čísla pinov sú definované v src/BoardPins.h firmvéru — ak zapojíte inak, zmeňte ich tam.
Čo potrebujete
- Ľubovoľná ESP32 vývojová doska (napr. ESP32-WROOM-32, 38-pin DevKit) alebo ESP32-S3-DevKitC-1 N8R2 (RS485 piny rovnaké, CAN a LED na GPIO5/6/7 namiesto 25/26/27)
- MAX485 / MAX3485 TTL↔RS485 prevodník (3.3 V verzia, s DE a RE spojenými na jeden pin)
- SN65HVD230 (3.3 V) CAN prevodník — potrebný len ak chcete čítať aj CAN vysielanie meniča
- RJ45 kábel do kombinovaného 485/CAN portu BMS
- 5V napájací zdroj pre ESP32 dosku
Voliteľne: pripravená KiCad doska (carrier PCB), ktorá spája ESP32 DevKit, oba prevodníky, skrutkovacie svorky (CAN, RS485, napájanie) a stavovú LED na jednej doštičke pre DIN krabičku.
Zapojenie MAX485 (RS485) → ESP32
| Pin MAX485 | Pin ESP32 | Pin ESP32-S3 | Poznámka |
|---|---|---|---|
| VCC | 3.3V | Oba prevodníky sú natívne 3.3V súčiastky — nenapájajte ich z 5V, mohli by preťažiť RX pin ESP32. | |
| GND | GND | ||
| DI (driver in) | GPIO17 (TX2) | ||
| RO (receiver out) | GPIO16 (RX2) | ||
| DE + RE (spojené) | GPIO4 | HIGH = vysielanie, LOW = príjem | |
| A | BMS RS485-A (RJ45 pin 2/7) | ||
| B | BMS RS485-B (RJ45 pin 1/8) | ||
Zapojenie SN65HVD230 (CAN) → ESP32
| Pin SN65HVD230 | Pin ESP32 | Pin ESP32-S3 | Poznámka |
|---|---|---|---|
| 3 VCC | 3.3V | Oba prevodníky sú natívne 3.3V súčiastky — nenapájajte ich z 5V, mohli by preťažiť RX pin ESP32. | |
| 2 GND | GND | ||
| 1 D (TXD) | GPIO25 | GPIO5 | CAN_TX_PIN |
| 4 R (RXD) | GPIO26 | GPIO6 | CAN_RX_PIN |
| 8 Rs | 10 kΩ → GND | ||
| 5 Vref | — | ||
| 7 CANH / 6 CANL | BMS CAN-H / CAN-L | ||
Kombinovaný port BMS 485/CAN (RJ45)
JK-PB2A16S20P má jeden kombinovaný RJ45 port "485/CAN", ktorý nesie obe zbernice naraz:
| Pin RJ45 | Signál |
|---|---|
| 1, 8 | RS485-B |
| 2, 7 | RS485-A |
| 3 | NC |
| 4 | CAN-H |
| 5 | CAN-L |
| 6 | GND |
Doska (carrier PCB) má namiesto RJ45 konektorov skrutkovacie svorky. Zapojte rozstrihnutý RJ45 kábel (alebo RJ45 redukciu so svorkami) takto:
| Pin RJ45 | Svorka na doske |
|---|---|
| 4 (CAN-H) | J3 pin 1 (CH) |
| 5 (CAN-L) | J3 pin 2 (CL) |
| 6 (GND) | J3 pin 3 / 4 (GND), J4 pin 3 (GND) |
| 2, 7 (RS485-A) | J4 pin 4 (A) |
| 1, 8 (RS485-B) | J4 pin 5 (B) |
Napájanie dosky: svorka J4, pin 1 = VIN+ (7–60 V), pin 2 = GND; pin 6 sa nepoužíva. Piny svoriek sa číslujú zľava doprava pri pohľade zo strany, kde vstupujú vodiče. Svorka J4 je chránená proti prehodeniu polarity sériovou diódou D3 — pri opačnom zapojení sa doska jednoducho nespustí.
Dôležité poznámky
- Firmvér počúva CAN zbernicu iba pasívne (listen-only) — nikdy nič nevysiela, takže je bezpečné pripojiť sa aj na živú zbernicu medzi BMS a meničom.
- 120 Ω terminačný odpor na CAN pridajte iba ak je ESP32 skutočným koncom zbernice. Ak je len odbočkou na zbernici, ktorú už terminuje BMS a menič, odpor nepridávajte.
- Prenosová rýchlosť CAN je predvolene 500 kbit/s (JK predvolené) a dá sa zmeniť za behu na karte CAN v dashboarde alebo cez
POST /api/can/config. - BMS vysiela CAN iba vtedy, keď je v jeho menu zvolený a zapnutý CAN protokol. Použite „Deye low-voltage protocol“ (48 V) — rámce kompatibilné s Pylontech na 500 kbit/s; firmvér ich dekóduje predvolene.
Automatické nastavenie — JK BMS Web Gateway
Pre klasické ESP32 dosky (ESP32-WROOM-32, 4 MB flash). Máte ESP32-S3? Použite záložku „JK BMS S3“.
Ponúkaná verzia: R1-V1.03s
Odporúčame prehliadač Google Chrome alebo Microsoft Edge — Web Serial API tam funguje bez ďalšieho nastavenia. Vo Firefoxe musíte najskôr povoliť prístup k sériovým portom (experimentálna funkcia, zapína sa cez about:config → dom.serial.enabled), inak tlačidlo nižšie nebude fungovať.
Od verzie R1-V1.03p (JK BMS) a R1-V1.01m (DEYE) sa brána aktualizuje sama z dashboardu: v pätičke stlačte Skontrolovať novší firmvér. Túto stránku potom potrebujete len pri prvej inštalácii alebo ak aktualizácia zlyhá.
Postup krok za krokom
- Pripojte ESP32 dosku k počítaču pomocou USB kábla (pri ESP32-S3-DevKitC-1 použite USB port označený UART).
- Kliknite na tlačidlo „Pripojiť a flashnúť“ a v prehliadači povoľte prístup k sériovému portu.
- Vyberte inštaláciu „JK BMS Web Gateway“ a potvrďte.
- Počkajte približne 2 minúty, kým sa dokončí nahratie firmvéru a súborového systému.
- Zariadenie sa reštartuje a spustí WiFi konfiguračný portál „JK-BMS-Setup“ — pripojte sa naň a zadajte údaje vašej domácej WiFi siete.
Pre stiahnutie alebo flashovanie musíš byť prihlásený.
Manuálne nastavenie — JK BMS Web Gateway
Ak sa vám nepodarí automatická aktualizácia cez prehliadač, je možné spustiť aktualizáciu aj cez príkazový riadok / PowerShell — stačí len zmeniť číslo PORT, na ktorom počúva vaša ESP32 doska.
Súbory z priečinka nižšie naflashujte príkazom:
esptool.py --chip esp32 --port PORT write_flash \
0x1000 bootloader.bin \
0x8000 partitions.bin \
0xe000 boot_app0.bin \
0x10000 firmware.bin \
0x290000 littlefs.bin
Pre stiahnutie alebo flashovanie musíš byť prihlásený.
Automatické nastavenie — JK BMS Web Gateway (ESP32-S3)
Pre dosky ESP32-S3-DevKitC-1 N8R2 (8 MB flash, viac rezervy pre budúce funkcie). Máte klasické ESP32? Použite záložku „JK BMS“.
Ponúkaná verzia: R1-V1.03s
Odporúčame prehliadač Google Chrome alebo Microsoft Edge — Web Serial API tam funguje bez ďalšieho nastavenia. Vo Firefoxe musíte najskôr povoliť prístup k sériovým portom (experimentálna funkcia, zapína sa cez about:config → dom.serial.enabled), inak tlačidlo nižšie nebude fungovať.
Od verzie R1-V1.03p (JK BMS) a R1-V1.01m (DEYE) sa brána aktualizuje sama z dashboardu: v pätičke stlačte Skontrolovať novší firmvér. Túto stránku potom potrebujete len pri prvej inštalácii alebo ak aktualizácia zlyhá.
Postup krok za krokom
- Pripojte ESP32 dosku k počítaču pomocou USB kábla (pri ESP32-S3-DevKitC-1 použite USB port označený UART).
- Kliknite na tlačidlo „Pripojiť a flashnúť“ a v prehliadači povoľte prístup k sériovému portu.
- Vyberte inštaláciu „JK BMS Web Gateway (ESP32-S3)“ a potvrďte.
- Počkajte približne 2 minúty, kým sa dokončí nahratie firmvéru a súborového systému.
- Zariadenie sa reštartuje a spustí WiFi konfiguračný portál „JK-BMS-Setup“ — pripojte sa naň a zadajte údaje vašej domácej WiFi siete.
Pre stiahnutie alebo flashovanie musíš byť prihlásený.
Manuálne nastavenie — JK BMS Web Gateway (ESP32-S3)
Ak sa vám nepodarí automatická aktualizácia cez prehliadač, je možné spustiť aktualizáciu aj cez príkazový riadok / PowerShell — stačí len zmeniť číslo PORT, na ktorom počúva vaša ESP32 doska.
Súbory z priečinka nižšie naflashujte príkazom:
esptool.py --chip esp32s3 --port PORT write_flash \
0x0 bootloader.bin \
0x8000 partitions.bin \
0xe000 boot_app0.bin \
0x10000 firmware.bin \
0x670000 littlefs.bin
Pre stiahnutie alebo flashovanie musíš byť prihlásený.
Automatické nastavenie — DEYE Web Gateway
Ponúkaná verzia: R1-V1.01w
Odporúčame prehliadač Google Chrome alebo Microsoft Edge — Web Serial API tam funguje bez ďalšieho nastavenia. Vo Firefoxe musíte najskôr povoliť prístup k sériovým portom (experimentálna funkcia, zapína sa cez about:config → dom.serial.enabled), inak tlačidlo nižšie nebude fungovať.
Od verzie R1-V1.03p (JK BMS) a R1-V1.01m (DEYE) sa brána aktualizuje sama z dashboardu: v pätičke stlačte Skontrolovať novší firmvér. Túto stránku potom potrebujete len pri prvej inštalácii alebo ak aktualizácia zlyhá.
Postup krok za krokom
- Pripojte ESP32 dosku k počítaču pomocou USB kábla (pri ESP32-S3-DevKitC-1 použite USB port označený UART).
- Kliknite na tlačidlo „Pripojiť a flashnúť“ a v prehliadači povoľte prístup k sériovému portu.
- Vyberte inštaláciu „DEYE Web Gateway“ a potvrďte.
- Počkajte približne 2 minúty, kým sa dokončí nahratie firmvéru a súborového systému.
- Zariadenie sa reštartuje a spustí WiFi konfiguračný portál „DEYE-Setup“ — pripojte sa naň a zadajte údaje vašej domácej WiFi siete.
Pre stiahnutie alebo flashovanie musíš byť prihlásený.
Manuálne nastavenie — DEYE Web Gateway
Ak sa vám nepodarí automatická aktualizácia cez prehliadač, je možné spustiť aktualizáciu aj cez príkazový riadok / PowerShell — stačí len zmeniť číslo PORT, na ktorom počúva vaša ESP32 doska.
Súbory z priečinka nižšie naflashujte príkazom:
esptool.py --chip esp32 --port PORT write_flash \
0x1000 bootloader.bin \
0x8000 partitions.bin \
0xe000 boot_app0.bin \
0x10000 firmware.bin \
0x290000 littlefs.bin
Pre stiahnutie alebo flashovanie musíš byť prihlásený.