Energy
Pylontech Dashboard
A purpose-built view of the Pylontech battery bank, translating raw battery data into a practical energy overview.
Current build
SOCBattery healthWhat it does
Built for a clear view
Energy management is easier when the state of the battery bank is obvious. This dashboard brings the most useful battery readings together for fast checks and longer-term awareness.
Key features
Battery state-of-charge overview
Voltage, current and power readings
Individual battery status
Clear warnings and connection state
Under the panel
How the system works
A practical map from the onboard sensor or controller to the value shown in the browser.
- 01
The dashboard asks the ESP gateway for a snapshot and specifies how many battery modules to query.
- 02
The ESP sends the Pylontech console command to each module and streams every returned text row through the WebSocket.
- 03
Rows are grouped by battery number until the completion line arrives.
- 04
The browser parses the numeric columns, converts millivolts, milliamps, milli-degrees and milliamp-hours, then calculates pack totals and state of charge.
Wire reference
Data format
- Transport
- Browser ↔ HAL WebSocket ↔ ESP serial gateway ↔ Pylontech console
- Envelope
- JSON chat messages carrying indexed Pylontech text lines
Example payload
{"type":"chat","text":"pylon: request 4"}
{"type":"chat","text":"pylon: 1 0 3327 -224 24600 Dischg ... 82% 74500 ..."}Field reference
request NAsk for N battery modules
battery indexNumber immediately after pylon:
cell mV / current mANumeric columns 2 and 3 of each returned row
temperatureMilli-degrees Celsius; divided by 1000
SOC / capacityPercentage and mAh columns from the console response
Source code
Take it apart. Make it yours.
The ZIP contains the web project and its matching ESP/Arduino firmware. Passwords, private keys, tokens, logs and live location data have been removed.
Firmware: ESP32 Pylontech battery firmware
- Pylontech dashboard variants
- ESP32 Arduino sketch
- HAL WebSocket server
- Node server package files