Smartphoton JK-BMS-RS485 & CAN bus (JKong company) is a BMS management add-on that use an RS485 or CAN port (wired)
BMS Type
- PB2A16S20P
- PB2A16S15P
- PB1A16S15P
- PB1A16S10P
- New one with the FW:19
- Configuration interface for JK-BMS software settings
- Modbus RS485 <--> USB communication
- Modbus RS485 <--> IP Gateway (Ethernet or Wifi) communication
- CAN bus broadcasting (New !! July 2025)
- Control panel integrated into Home Assistant
- Multi-BMS support
- MQTT integration (open to other software)
- Multi modes rs485: Master or Listening
1) Master mode
In this mode, the software interrogates each BMS (addresses from 1 to 15) via the RS485 bus to retrieve static, setup and dynamic values. Several parameters can be changed from the software.
To activate Master mode, leave the parameter:
`bms_broadcasting: false`
2) Listening mode
In this mode, the software listens to the rs485 bus. One of the BMSs has been defined as the master of the rs485 bus. This involves setting all 4 small switches to the down or 0000 position. This is the BMS that will query the other BMSs if any are connected. This BMS will then broadcast the information it has retrieved cyclically every 5 seconds. It is not possible to change several parameters from the software in this mode. Only setup and dynamic information is retrieved. This mode must be used if your inverter requires one of the BMSs to be the Master Bus!
To activate Listen mode, set the parameter
`bms_broadcasting: true`
| variable | Explanations |
|---|---|
| path | The path to the USB port where the Serial port RS485 adapter is connected to your machine. For example: /dev/serial/by-id/usb-1a86_USB_Serial-if00-port0 or /dev/ttyUSB0 if the port is unique. You can find the path to use in the Settings-System-Hardware-All Hardware menu, under ttyUSB. see the photo below |
| nb_jkbms | Number of JK BMSs to control (from 1 to 15) |
| use_gateway | Using an IP gateway ? |
| gateway_ip | address of the IP gateway |
| gateway_port | Gateway port number |
| bms_broadcasting | "true" if one the BMSs is configured in master mode (0000) |
| CAN bus usage | Using the CAN bus broadcasting (yet implemented in july 2025) |
| mqttaddress | The IP address or DNS name of your MQTT broker. By default, this will be the internal address of HAOS |
| mqttport | Port number of the MQTT broker |
| mqttuser | User name for MQTT authentication broker |
| mqttpass | Password for MQTT authentication. Put it in quotation marks |
3) CAN broadcasting
Here is the latest development (July 2025). CAN bus support is now fully functional
This is the second RJ45 connector from the left. The BMS broadcast information in loop mode
You can obtain two pre-configured dashboards that you can import into your Home Assistant home automation system.
This can save you several hours of work in formatting the data by yourself.
Have a look here:
The module can manage 21 alarms identified by the BMS.
It will create 4 HAOS entities telling you that there are alarms in progress,
How many and which ones. It also tells you on which BMS there is an alarm.
There is also an entity designed to trigger an automatic system based on a global binary senso: binary_sensor.bms_global_bms_global_alarm
You can see which alarms are possible on this table
You can connect your JK-BMS to an RS485/Ethernet gateway in transparent mode. This means you do not need to have your PC next to your BMS(es).
The data will be retransmitted by this gateway over the network and this module will then be able to remotely manage your BMS. You will need to activate the dedicated switch for this in the configuration.
Here are the gateways that are known to work actually. You can find them in this directory
This configuration is quite complex and may not work depending on the hardware/settings.
- Add this repository in Home Assistant:
https://github.com/jean-luc1203/jkbms-rs485-addon - Install the "Smartphoton_JKBMS RS485 Home Assistant Addon"
- Configure the parameters according to your installation
- Start the module
- Clone this repository in the
/addons/folder of your Home Assistant installation - Reload the add-ons
- Install and configure
- BMS appear in MQTT devices
- Entities created
For the creation of the module under HAOS, I drew inspiration from Nolak's work for smartphoton as well as assistance from various AI. The Node Red flow are from me. Jean-Luc Martinelli or JLM.
To report problems or request features, use GitHub issues.
MIT License