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
SupportedThe currently published JKBMSR firmware target. WROOM antenna variants use the same firmware.
- 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
ConditionalThe CPU may be compatible, but integrated displays, PSRAM, relays, or other peripherals can reserve required pins.
- 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 supportedDetected safely by the browser flasher, but no JKBMSR ESP8266 firmware is published yet. ESP32 firmware will not be written to it.
- 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 supportedThese use different firmware targets and must not receive the classic ESP32 image.
- 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 supportedThe current browser installer and gateway runtime are designed for Espressif chips.
- 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.
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.