JK-BMS RS485 Home Assistant Addon

[domosimple]

JK-BMS RS485 Home Assistant Addon

Home Assistant add-on module for managing JK-BMS via Node-RED and Modbus RS485.

Features

• Configuration interface for JK-BMS software settings
• Modbus RS485 communication
• Control panel integrated into Home Assistant
• Multi-BMS support
• MQTT integration (open to other software)

Screenshot

Configuration

Available parameters

• path: The path to the USB port where the Serial port RS485 adapter is connected to your machine
• nb_jkbms: Number of JK BMSs to control (from 1 to 15)
• 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
• mqttpass: Password for MQTT authentication. Put it in quotation marks

–» Complementary and pre-configured Dashboard: «–

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

Installation

You can add the repository automatically by following this:

Via the add-on shop

1. Add this repository in Home Assistant: https://github.com/jean-luc1203/jkbms-rs485-addon
2. Install the “Smartphoton_JKBMS RS485 Home Assistant Addon”
3. Configure the parameters according to your installation
4. Start the module

Manual installation (for development)

1. Clone this repository in the /addons/ folder of your Home Assistant installation
2. Reload the add-ons
3. Install and configure

Use

• BMS appear in MQTT devices

• Entities created

Authors & contributors

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 JLM.

Support

To report problems or request features, use GitHub issues.

License

MIT License

[LawrenceH]

Great tool! I’m running HA in Hyper-V, which doesn’t support USB passthrough. Do you think using USB/IP to connect the RS485 USB adapter to HA would work?

[domosimple]

Thank you @LawrenceH for your comment.

Which interface are you referring to?

At the moment, my code accesses a serial port, which is one of the USB ports. If you are referring to an RS485/IP gateway, this has not been implemented yet. I have done this in my other module smartphoton. Among other things, I use Elfin modules.

If I receive several requests, I can add the code to manage the IP addresses and ports of a gateway, thereby eliminating the need to go through the serial port.

[LawrenceH]

Yeah, I mean the serial port on the USB adapter. Since Hyper-V can’t pass USB devices from Windows, you need something like USB-over-IP to connect it to HA, like using USB/IP.

[domosimple]

In my case, I use these inexpensive gateways which give me great satisfaction. Is this what you have in mind?

Ethernet

The rs485 version, then.

[LawrenceH]

Yeah, the USB version

[domosimple]

I am currently adding the ability to connect an RS485-IP gateway of this type. I had it lying around somewhere. This means you can have the PC anywhere and no longer need to connect a physical USB port. It’s starting to work. In a few days, I will make this version available on my GitHub.

This is the one i’m using

[domosimple]

The version with IP Gateway ethernet-wifi connection is now available on Github

[LawrenceH]

Great, thanks alot!!

[domosimple]

It is now possible to leave a BMS in Master mode.

You can use it with your inverter, which requires one of the BMSs to be in the Master position, i.e. 0000 on the switches.
Like Deye, Victron …

This involves setting all 4 small switches to the down or 0000 position.

Parameters can no longer be modified in this mode !

In this configuration, the BMS will query the other BMSs if any are connected to the RS485 bus.

The BMS will then broadcast the information it has retrieved cyclically every 5 seconds. This information will be read by this add-on