ai-republic / bms-to-inverter

Use, monitor and control any battery brand with any inverter! Application to read and monitor data from BMSes and write data to an inverter using any protocol (e.g. UART, RS485, ModBus or CAN)
https://github.com/ai-republic/bms-to-inverter
Other
101 stars 14 forks source link
battery bms daly daly-bms deye growatt inverter jk lifepo4 lithium pace pylon pylontech seplos seplos-bms sma solar solark sunny-island victron

BMS to Solar Inverter communication

(Use, monitor and control any battery brand with any inverter)

This application is reading data from one or multiple BMS(es) and sending it to an inverter using a microcontroller in between as a bridge. Many inverter manufacturers only allow batteries from certain battery manufacturers and certain models. With this application you have no restriction on what battery brands you can use with your inverter!!!

This project enables you to read your BMS's data via different protocols - RS485, RS232, UART, ModBus or CAN - and write the battery data to the inverter in a specification that the inverter supports - Pylontech, SMA, Growatt, Deye, SolArk, etc. The appplication supports multiple BMS (even mixes from different manufacturers), aggregating them and sending the data to the configurable inverter.

You can monitor each of your battery packs cells and view alarm states on the included webserver or hook up via the MQTT broker on your smart home.

It even let's you manipulate or simulate BMS data that get's sent to the inverter! Please see read plugin information in the Wiki.

This way you control what get's send to the inverter!

This application will run on any microcontroller the can run a Java JDK (32 or 64bit) like PI's such as RPi 1 or RPi 5. The (reference) project uses a Raspberry Pi 4B with a Waveshare RS485/CAN hat or Waveshare 2-Channel CAN FD HAT module but you can use any CAN or RS485 module for your PI that provides ports like can0 or /dev/ttyS0 or similar.

A wide range of BMS and inverters are supported and new one's are added continuously on request, see Supported-BMSes-and-Inverters in the Wiki.

NOTE: If your BMS or inverter is not in the list it is likely to work with one of these bindings (like Pylon). Just open an issue and we'll see what I can do! NOTE: I would appreciate support to test the BMS and inverter bindings in all variations. Please let me know if you would like to support this project - Testers are very welcome! :)_ NOTE USB CAN adapters that do not create a proper CAN device but only a ttyUSB device have found to be problematic. So please choose the right hardware.


Supported protocols:

NOTE: There are restrictions using CAN on Windows as SocketCAN library is NOT available on Windows OS


Requirements

This project explicitly supports Java 8 because its the last version with 32-bit JDK 8 support that many microcontrollers support. If you're using a Raspberry PI 3B, 4B or above I recommend to use a 64-bit Java JDK and 64-bit operating system like Raspian OS or Ubuntu. The application has also been tested on Pi 1 - Pi5. Any microcontroller that can run a JDK 8+ can be used. For detailed requirements please refer to the How-to-Use in the Wiki.


How to use

See the Wiki page How to use for details on how to install and configure your system using the Configurator.

IMPORTANT: If you use the dummy BMS (NONE) binding together with the inverter plugin SimulatedBatteryPackPlugin you MUST (!!!!!!!!!!) disconnect any load and PV DC input to prevent possible damage as the inverter will try charging/discharging!!!


Other Notes

DISCLAIMER I do not take any responsibility for any kind of damage or injury that might be caused by using this software. Use at your own risk.

If you have questions or need support feel free to contact me or raise an issue or discussion. If you like to support me testing the application on all different BMSes and inverters please contact me!

=====>>>> Finally, if you like this project and like to support my work please consider sponsoring this project Sponsor button on the right ❤️ <<<<=====