Batteries · RS485 · CAN · MQTT

JK-BMS RS485 for Home Assistant

Monitor cells, temperatures, alarms and batteries in Home Assistant. JK-BMS RS485 Add-on publishes your data through MQTT for dashboards and automations.

Install the stable version →Explore the dashboards Get help →

Get started with JK-BMS RS485

Check your BMS model, firmware and supported connection in the documentation.
Follow the production repository instructions to install and configure the add-on in Home Assistant.
Check MQTT data and discovery, then choose your dashboard.

Read the installation guide ↗Get help

**Recognising a JK-BMS**Example BMS with its communication board. Compatibility depends on the model, firmware and port used.

What's already available

Wired acquisition over USB/RS485, a TCP/IP gateway or CAN on compatible hardware; MQTT Discovery integration; cell, temperature and alarm monitoring. Diagnostics help explain communication losses. Premium dashboards are optional.

SmartPhoton JK-BMS dashboard: battery status and detailed data — SCADA interface · monitoring example; availability depends on the version.

JK-BMS · Standalone · Windows

JK-BMS as a local application

Explore the Standalone working version: a local interface, its history views and Windows launcher.

Explore JK-BMS Standalone →

Versions and interfaces explained

Name	What it means	Availability / starting point
Legacy	The original JK-BMS add-on architecture.	Existing installations: use the production repository documentation.
Multi-Pack	An architecture that organises BMS devices into independent packs, including a single pack.	Check the published version; next-generation tests are tracked in DEV.
Premium	Optional advanced features and dashboards.	Scope depends on the module and version; consult its documentation.
SCADA	A monitoring interface with process overview, alarms, trends and cell diagnostics.	Shown in the gallery; availability depends on the version.
Standalone Windows	A Windows launcher and local web dashboard dedicated to JK-BMS.	V0.11.9 prototype shown in screenshots; availability to be clarified.

Development and testing

Want to test new features? The DEV repository tracks Multi-Pack and Active Polling experiments. Read its requirements and limitations before using it.

View testing on GitHub ↗

Understand the test · RS485-1 / RS485-2 →

Premium, Multi-Pack and SCADA

Explore fleet views, pack details, cell diagnostics and the SCADA process view in the interface gallery.

View the interfaces →Reuse the data through MQTT →

Videos

Watch SmartPhoton in action.

Demonstrations from @domosimple showing the project and its tests.

Testing both RS485 buses

JK-BMS Monitor demonstration from 14 October 2026: access and LCD control on RS485-1, with RS485-2 running in parallel.

Watch on YouTube ↗

JK-BMS & Premium dashboards

Add-on improvements and an introduction to the Premium interfaces.

Watch on YouTube ↗

Towards a Multi-Pack architecture

Understand the move towards independent packs.

Watch on YouTube ↗

SmartPhoton: 2025 introduction

An introduction to the project at that stage of its development.

Watch on YouTube ↗

Videos retain their original language. The YouTube player loads only after you click.

All @domosimple videos ↗

Go further

Production repository features and compatibility ↗Current work and roadmap ↗Discuss your installation ↗

Compatibility and diagnostics

The repository documents 1S to 16S packs, compatible USB/RS485, TCP/IP gateways and CAN connections, alarms and communication diagnostics. Check supported models, firmware and functions for your installed version.

FAQ ↗Read the documentation ↗

JK-BMS also runs with Docker

The repository provides standalone Docker installation for Home Assistant Core, Linux servers and advanced deployments. This is separate from installation as an HAOS add-on. Docker contribution: @SergeyYmb.

Docker guide ↗

Credits and contributions

Development: Jean-Luc Martinelli. Dashboard design and Premium visual ecosystem: John. Inspiration: Nolak. Docker contribution: @SergeyYmb.