Skip to main content
Firmware Stable

Display and LEDs

The BMS state can be indicated using either WS2812 RGB LEDs or an OLED display, selected by the dispmode parameter. A button is available in both configurations for controlling the BMS.

warning

A reboot is required after changing the dispmode parameter.

dispmode​

WS LED Parameters​

bright​

WS LED brightness multiplier.

bar_invert​

Inverts the LED bar direction (SOC bar increases towards the button when enabled).

WS LED Behavior​

The 4 RGB LEDs display the battery SOC as a bar graph. The color indicates the current BMS state:

ColorState
GreenDSC port on (running)
Green blinkingCHG port on (charging)
BlueIdle
Orange pulsingError / Protect / Init
Red pulsingCritical error / Fail

Button Control (WS LED mode)​

  • Short press — wake LEDs and show SOC
  • Double press — toggle USB charging output
  • Long press — toggle BMS ports on/off

OLED Display​

The OLED display (128x64 SH1106) shows detailed BMS information across multiple pages. Navigate pages with a short press of the button.

Display Pages​

PageContent
0Overview — SOC, voltage, current, temperature, state
1Balancer — cell voltages, balancing status, min/max
2Ports — DSC and CHG port voltage, current, BMS temp
3Limiter — active limitations and limiter values
4BEST — energy, SOC, SOH, cycle count
5Atmo — atmospheric sensor (temperature, humidity, pressure)
6Last protect events
7Last error events

Button Control (OLED mode)​

  • Short press — next page
  • Long press on pages 0, 2, 3, 4, 5 — toggle BMS ports on/off
  • Long press on page 1 — toggle balancer override
  • Long press on page 3 — toggle screen always-on
  • Long press on page 4 — reset BEST estimator
  • Long press on pages 6, 7 — reboot BMS

States​

StateTypeDescription
btn_stateUINT32Button state: 0 = released, 1 = pressed, 2 = double press, 10 = long press

Shell Commands​

CommandDescription
led [position] [red] [green] [blue]Set WS LED color manually. Call led without arguments to return to automatic mode.