UZ Energy BMS Toolkit (MQTT + WebUI)

Lightweight toolkit to monitor a UZ Energy 16S LiFePO4 BMS via USB-serial, publish data to MQTT, and visualize it using a static WebUI and/or Home Assistant.

Italian version: README.it.md

What it does

• Consumes MQTT topic: shinwa_bms/state (full state JSON)
• Produces MQTT topic: shinwa_bms/hot (compact “hot” JSON)
• Includes a static HTML WebUI
• Plays well with Home Assistant via MQTT Discovery

Project status

• Unofficial
• No firmware, no proprietary dumps
• Based on real-world observations and comparison against the official app

Temperature decoding (verified)

Temp_C = (raw & 0x7FFF) - 49

Notes:

• Only some channels are real temperatures
• Out-of-range values are filtered to null

Repository layout

• tools/ Python scripts
• webui/ Static HTML WebUI
• docs/ Technical notes
• examples/ Example payloads

License

MIT