Gateway hardware catalog

Gateway hardware compatibility

Check whether a microcontroller can run JKBMSR before connecting it. The browser installer detects the chip and will never substitute firmware from another family.

Classic ESP32 / esp32dev

Supported

The currently published JKBMSR firmware target. WROOM antenna variants use the same firmware.

Boards and modules
  • ESP32-DevKitC with ESP32-WROOM-32, 32D, 32E, or 32U
  • DOIT ESP32 DEVKIT V1
  • NodeMCU-32S / ESP32S development boards
  • Generic ESP32-WROOM development boards with 4 MB flash
  • Requires at least 4 MB flash.
  • Default BMS UART pins are GPIO16 (RX) and GPIO17 (TX).
  • ESP32-WROOM-32U is the external-antenna version and does not need different firmware.

Other classic ESP32 boards

Conditional

The CPU may be compatible, but integrated displays, PSRAM, relays, or other peripherals can reserve required pins.

Boards and modules
  • ESP32-WROVER development boards
  • ESP32-PICO-D4 boards
  • TTGO, T-Display, and other integrated-peripheral ESP32 boards
  • Bare ESP32-WROOM modules
  • Confirm 4 MB flash and available UART pins before flashing.
  • Bare modules require a correct 3.3 V supply, USB-to-UART adapter, EN/BOOT circuitry, and antenna design.
  • WROVER modules may use GPIO16/17 for PSRAM; choose different BMS UART pins in gateway settings.

ESP8266EX

Not yet supported

Detected safely by the browser flasher, but no JKBMSR ESP8266 firmware is published yet. ESP32 firmware will not be written to it.

Boards and modules
  • NodeMCU ESP8266 v2/v3
  • Wemos D1 mini
  • ESP-01 / ESP-01S
  • ESP-12E / ESP-12F development boards
  • ESP8266 has no Bluetooth support and fewer UART/resources than ESP32.
  • A dedicated, reduced UART-only firmware must be built and hardware-tested before this status can change.
  • Flash ID 0 is a board/flash communication problem that must be fixed before any firmware can be installed.

Newer ESP32 families

Not yet supported

These use different firmware targets and must not receive the classic ESP32 image.

Boards and modules
  • ESP32-S2 / ESP32-S3
  • ESP32-C2 / C3 / C5 / C6
  • ESP32-H2
  • ESP32-P4
  • The flasher distinguishes these chip families automatically.
  • Support requires a separately built and published manifest for each compatible target.

Non-Espressif microcontrollers

Not yet supported

The current browser installer and gateway runtime are designed for Espressif chips.

Boards and modules
  • STM32 boards
  • Raspberry Pi Pico / RP2040 / RP2350
  • Arduino AVR boards
  • nRF52 boards
  • These boards use different bootloaders, networking stacks, storage, and firmware images.
  • Do not select their serial ports in the ESP browser flasher.

USB serial adapters

The adapter identifies the USB connection, not the microcontroller or compatible firmware.

CH9102
Usually identified as USB 1a86:55d4
CH340 / CH341
Usually identified as USB 1a86:7523
CP2102 / CP210x
Common on Espressif and NodeMCU development boards
FT232 / FTDI
Works when wired for 3.3 V UART and correct EN/BOOT control

Before flashing any board

  • • Use desktop Chrome or Edge and a data-capable USB cable.
  • • Disconnect the BMS and other peripherals during flashing.
  • • Confirm the flash chip returns a valid, non-zero ID.
  • • Use BOOT and EN/RESET if automatic download mode fails.