Skip to content

ESPHome components to monitor and control a Jikong Battery Management System (JK-BMS) via UART-TTL or BLE. Monitor multiple JK-PBx (hw v14 & v15) using RS485 internal network.

License

Notifications You must be signed in to change notification settings

txubelaxu/esphome-jk-bms

This branch is 200 commits ahead of, 75 commits behind syssi/esphome-jk-bms:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

18bc9f8 · Jan 22, 2025
Mar 6, 2024
Aug 4, 2024
Jan 22, 2025
Jun 28, 2024
Feb 24, 2023
Mar 31, 2024
Apr 13, 2023
Jan 26, 2024
Aug 22, 2021
Feb 26, 2022
Mar 27, 2022
Aug 13, 2021
Aug 9, 2021
Aug 9, 2024
Mar 19, 2024
Sep 3, 2024
Sep 3, 2024
Sep 3, 2024
Mar 31, 2024
Feb 11, 2023
Jan 21, 2024
Aug 6, 2024
Aug 6, 2024
Feb 11, 2023
Jan 21, 2024
Aug 6, 2024
Mar 22, 2024
Aug 6, 2024
Aug 6, 2024
Jan 21, 2024
Feb 10, 2024
Aug 6, 2024
Jan 27, 2024
Feb 10, 2024
Mar 22, 2024
Aug 6, 2024
Aug 6, 2024
Aug 6, 2024
Apr 20, 2023
Jan 21, 2024
Sep 3, 2024
Sep 3, 2024
Sep 3, 2024
Sep 3, 2024
Aug 6, 2024
Aug 6, 2024
Feb 11, 2023
Aug 6, 2024
Aug 6, 2024
Aug 6, 2024
Aug 6, 2024
Apr 20, 2023
Jan 21, 2024
Aug 6, 2024
Aug 22, 2021
Aug 22, 2021
Mar 12, 2022
May 9, 2022
May 9, 2022

Repository files navigation

esphome-jk-bms

GitHub actions GitHub stars GitHub forks GitHub watchers "Buy Me A Coffee"

ESPHome components to monitor Jikong Battery Management Systems (JK-BMS) via UART-TTL, BLE, and RS-485.

Via RS-485 - GOOD for monitoring and control SWITCHES and NUMBERS (the ESP acts as MASTER)

NEW: monitor your new JK-PBx BMSs via internal RS485 network using 1 only ESP. Click here for more info. Home Assistant dashboards inside as well.

Last Change: Added RCV Time and RFV Time as Read & Write Last Change: control your BMSs settings (Numbers): cell_smart_sleep_voltage, cell_undervoltage_protection, cell_undervoltage_protection_recovery, cell_overvoltage_protection, cell_overvoltage_protection_recovery, cell_balancing_trigger_voltage, cell_soc100_voltage, cell_soc0_voltage, cell_request_charge_voltage, cell_request_float_voltage, cell_power_off_voltage, cell_balancing_starting_voltage, max_charging_current, charging_overcurrent_protection_delay, charging_overcurrent_protection_recovery_delay, max_discharging_current, discharging_overcurrent_protection_delay, discharging_overcurrent_protection_recovery_delay, short_circuit_protection_delay, short_circuit_protection_recovery_delay, max_balancing_current, charging_overtemperature_protection, charging_overtemperature_protection_recovery, discharging_overtemperature_protection, discharging_overtemperature_protection_recovery, charging_lowtemperature_protection, charging_lowtemperature_protection_recovery, mos_overtemperature_protection, mos_overtemperature_protection_recovery, cell_count_settings, battery_capacity_total_settings, precharging_time_from_discharge

Broadcast is possible with those settings too. Updated: 0master_2slave example & 0master_7slave example

Last: control your BMSs settings (Switches) "balancing", "charging" and "discharging" switches. New "broadcast mode" to easy switch on/off every BMS in the network.

Last: new parameters added and new dashboards

  • New Dashboards (summary, cells, settings, protection) available here
  • Multiple alarm signals: BATTempSensor1Absent, BATTempSensor2Absent, BATTempSensor3Absent, BATTempSensor4Absent, BATTempSensor5Absent, BatOVP, BatUVP, BatteryOverTemp, CPUAuxCommuErr, CellOVP, CellQuantity, CellUVP, ChOCP, ChOTP, ChSCP, ChUTP, ChargeMOS, CurSensorErr, DchOCP, DchOTP, DchSCP, DischargeMOS, DischargeOnFailed, GPSDisconneted, MOSTempSensorAbsent, ModifyPWDinTime, MosOTP, PLCModuleAnomaly, TemperatureSensorAnomaly, WireRes (thanks to @jblance and @jrventer
  • difference between: "switch status" and "real working status". Useful for balancing, for example: balancer could be ON, but balancing can be on or off, depending on conditions...

image image image image

Via Bluetooth (BLE) or UART (best for controlling)

Last: new parameters added and new dashboards

  • New information about device: vendorid, hardware_version, software_version, device_name, device_password So, if you lose your password of your jk bms you can recover using this.

ESPHome component to control and monitor a Jikong Battery Management System (JK-BMS) via UART-TTL or BLE Click here for more info.

Support If you want to tip me for this work, you can now buy me a coffee

"Buy Me A Coffee"

References

About

ESPHome components to monitor and control a Jikong Battery Management System (JK-BMS) via UART-TTL or BLE. Monitor multiple JK-PBx (hw v14 & v15) using RS485 internal network.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 62.6%
  • Python 37.4%