API tools faq
paste
keldbroe

JK BMS - 1 stk

keldbroe
Aug 4th, 2025
460
0
Never
Add comment
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
YAML 10.08 KB | None | 0 0
raw download clone embed print report
  1. substitutions:
  2.   name: "jkbms-battery-4"
  3.   device_description: "Monitor and control a JK-BMS via bluetooth"
  4.   external_components_source: github://syssi/esphome-jk-bms@main
  5.   mac_address: C8:47:80:21:22:6C
  6.   # Please use "JK02_24S" if you own a old JK-BMS < hardware version 11.0 (hardware version >= 6.0 and < 11.0)
  7.   # Please use "JK02_32S" if you own a new JK-BMS >= hardware version 11.0 (f.e. JK-B2A8S20P hw 11.XW, sw 11.26)
  8.   # Please use "JK04" if you have some old JK-BMS <= hardware version 3.0 (f.e. JK-B2A16S hw 3.0, sw. 3.3.0)
  9.   protocol_version: JK02_32S
  10.  
  11. esphome:
  12.   name: ${name}
  13.   friendly_name: "JK BMS Batteri 4"
  14.   comment: ${device_description}
  15.   min_version: 2024.6.0
  16.   project:
  17.     name: "syssi.esphome-jk-bms"
  18.     version: 2.1.0
  19.  
  20. esp32:
  21.   board: esp32dev
  22.   framework:
  23.     type: esp-idf
  24.  
  25. external_components:
  26.   - source: ${external_components_source}
  27.     refresh: 0s
  28.  
  29. wifi:
  30.   ssid: !secret wifi_ssid
  31.   password: !secret wifi_password
  32.  
  33. ota:
  34.   platform: esphome
  35.   on_begin:
  36.     then:
  37.       - switch.turn_off: ble_client_switch0
  38.       - logger.log: "BLE connection suspended for OTA update"
  39.  
  40. logger:
  41.   level: DEBUG
  42.   logs:
  43.     esp32_ble_tracker: INFO
  44.     esp32_ble_client: INFO
  45.  
  46. # If you don't use Home Assistant please remove this `api` section and uncomment the `mqtt` component!
  47. api:
  49. # mqtt:
  50. #   broker: !secret mqtt_host
  51. #   username: !secret mqtt_username
  52. #   password: !secret mqtt_password
  53. #   id: mqtt_client
  54.  
  55. esp32_ble_tracker:
  56.   scan_parameters:
  57.     active: false
  58.  
  59. ble_client:
  60.   - mac_address: ${mac_address}
  61.     id: client0
  62.  
  63.  
  64. jk_bms_ble:
  65.   - ble_client_id: client0
  66.     protocol_version: ${protocol_version}
  67.     throttle: 15s
  68.     id: bms0
  69.  
  70. binary_sensor:
  71.   - platform: jk_bms_ble
  72.     balancing:
  73.       name: "${name} balancing"
  74.     charging:
  75.       name: "${name} charging"
  76.     discharging:
  77.       name: "${name} discharging"
  78.     heating:
  79.       name: "${name} heating"
  80.     online_status:
  81.       name: "${name} online status"
  82.  
  83. button:
  84.   - platform: jk_bms_ble
  85.     retrieve_settings:
  86.       name: "${name} retrieve settings"
  87.     retrieve_device_info:
  88.       name: "${name} retrieve device info"
  89.  
  90. number:
  91.   - platform: jk_bms_ble
  92.     jk_bms_ble_id: bms0
  93.     balance_trigger_voltage:
  94.       name: "${name} balance trigger voltage"
  95.     cell_count:
  96.       name: "${name} cell count"
  97.     total_battery_capacity:
  98.       name: "${name} total battery capacity"
  99.     cell_voltage_overvoltage_protection:
  100.       name: "${name} cell voltage overvoltage protection"
  101.     cell_voltage_overvoltage_recovery:
  102.       name: "${name} cell voltage overvoltage recovery"
  103.     cell_voltage_undervoltage_protection:
  104.       name: "${name} cell voltage undervoltage protection"
  105.     cell_voltage_undervoltage_recovery:
  106.       name: "${name} cell voltage undervoltage recovery"
  107.     balance_starting_voltage:
  108.       name: "${name} balance starting voltage"
  109.     voltage_calibration:
  110.       name: "${name} voltage calibration"
  111.     current_calibration:
  112.       name: "${name} current calibration"
  113.     power_off_voltage:
  114.       name: "${name} power off voltage"
  115.     max_balance_current:
  116.       name: "${name} max balance current"
  117.     max_charge_current:
  118.       name: "${name} max charge current"
  119.     max_discharge_current:
  120.       name: "${name} max discharge current"
  121.     smart_sleep_voltage:
  122.       name: "${name} smart sleep voltage"
  123.     cell_soc100_voltage:
  124.       name: "${name} cell soc100 voltage"
  125.     cell_soc0_voltage:
  126.       name: "${name} cell soc0 voltage"
  127.     cell_request_charge_voltage:
  128.       name: "${name} cell request charge voltage"
  129.     cell_request_float_voltage:
  130.       name: "${name} cell request float voltage"
  131.     cell_request_charge_voltage_time:
  132.       name: "${name} cell request charge voltage time"
  133.     cell_request_float_voltage_time:
  134.       name: "${name} cell request float voltage time"
  135.     charge_overcurrent_protection_delay:
  136.       name: "${name} charge overcurrent protection delay"
  137.     charge_overcurrent_protection_recovery_time:
  138.       name: "${name} charge overcurrent protection recovery time"
  139.     discharge_overcurrent_protection_delay:
  140.       name: "${name} discharge overcurrent protection delay"
  141.     discharge_overcurrent_protection_recovery_time:
  142.       name: "${name} discharge overcurrent protection recovery time"
  143.     short_circuit_protection_delay:
  144.       name: "${name} short circuit protection delay"
  145.     short_circuit_protection_recovery_time:
  146.       name: "${name} short circuit protection recovery time"
  147.     charge_overtemperature_protection:
  148.       name: "${name} charge overtemperature protection"
  149.     charge_overtemperature_protection_recovery:
  150.       name: "${name} charge overtemperature protection recovery"
  151.     discharge_overtemperature_protection:
  152.       name: "${name} discharge overtemperature protection"
  153.     discharge_overtemperature_protection_recovery:
  154.       name: "${name} discharge overtemperature protection recovery"
  155.     charge_undertemperature_protection:
  156.       name: "${name} charge undertemperature protection"
  157.     charge_undertemperature_protection_recovery:
  158.       name: "${name} charge undertemperature protection recovery"
  159.     power_tube_overtemperature_protection:
  160.       name: "${name} power tube overtemperature protection"
  161.     power_tube_overtemperature_protection_recovery:
  162.       name: "${name} power tube overtemperature protection recovery"
  163.  
  164. sensor:
  165.   - platform: jk_bms_ble
  166.     jk_bms_ble_id: bms0
  167.     min_cell_voltage:
  168.       name: "${name} min cell voltage"
  169.     max_cell_voltage:
  170.       name: "${name} max cell voltage"
  171.     min_voltage_cell:
  172.       name: "${name} min voltage cell"
  173.     max_voltage_cell:
  174.       name: "${name} max voltage cell"
  175.     delta_cell_voltage:
  176.       name: "${name} delta cell voltage"
  177.     average_cell_voltage:
  178.       name: "${name} average cell voltage"
  179.     cell_voltage_1:
  180.       name: "${name} cell voltage 1"
  181.     cell_voltage_2:
  182.       name: "${name} cell voltage 2"
  183.     cell_voltage_3:
  184.       name: "${name} cell voltage 3"
  185.     cell_voltage_4:
  186.       name: "${name} cell voltage 4"
  187.     cell_voltage_5:
  188.       name: "${name} cell voltage 5"
  189.     cell_voltage_6:
  190.       name: "${name} cell voltage 6"
  191.     cell_voltage_7:
  192.       name: "${name} cell voltage 7"
  193.     cell_voltage_8:
  194.       name: "${name} cell voltage 8"
  195.     cell_voltage_9:
  196.       name: "${name} cell voltage 9"
  197.     cell_voltage_10:
  198.       name: "${name} cell voltage 10"
  199.     cell_voltage_11:
  200.       name: "${name} cell voltage 11"
  201.     cell_voltage_12:
  202.       name: "${name} cell voltage 12"
  203.     cell_voltage_13:
  204.       name: "${name} cell voltage 13"
  205.     cell_voltage_14:
  206.       name: "${name} cell voltage 14"
  207.     cell_voltage_15:
  208.       name: "${name} cell voltage 15"
  209.     cell_voltage_16:
  210.       name: "${name} cell voltage 16"
  211.     cell_resistance_1:
  212.       name: "${name} cell resistance 1"
  213.     cell_resistance_2:
  214.       name: "${name} cell resistance 2"
  215.     cell_resistance_3:
  216.       name: "${name} cell resistance 3"
  217.     cell_resistance_4:
  218.       name: "${name} cell resistance 4"
  219.     cell_resistance_5:
  220.       name: "${name} cell resistance 5"
  221.     cell_resistance_6:
  222.       name: "${name} cell resistance 6"
  223.     cell_resistance_7:
  224.       name: "${name} cell resistance 7"
  225.     cell_resistance_8:
  226.       name: "${name} cell resistance 8"
  227.     cell_resistance_9:
  228.       name: "${name} cell resistance 9"
  229.     cell_resistance_10:
  230.       name: "${name} cell resistance 10"
  231.     cell_resistance_11:
  232.       name: "${name} cell resistance 11"
  233.     cell_resistance_12:
  234.       name: "${name} cell resistance 12"
  235.     cell_resistance_13:
  236.       name: "${name} cell resistance 13"
  237.     cell_resistance_14:
  238.       name: "${name} cell resistance 14"
  239.     cell_resistance_15:
  240.       name: "${name} cell resistance 15"
  241.     cell_resistance_16:
  242.       name: "${name} cell resistance 16"
  243.     total_voltage:
  244.       name: "${name} total voltage"
  245.     current:
  246.       name: "${name} current"
  247.     heating_current:
  248.       name: "${name} heating current"
  249.     power:
  250.       name: "${name} power"
  251.     charging_power:
  252.       name: "${name} charging power"
  253.     discharging_power:
  254.       name: "${name} discharging power"
  255.     temperature_sensor_1:
  256.       name: "${name} temperature sensor 1"
  257.     temperature_sensor_2:
  258.       name: "${name} temperature sensor 2"
  259.     temperature_sensor_3:
  260.       name: "${name} temperature sensor 3"
  261.     temperature_sensor_4:
  262.       name: "${name} temperature sensor 4"
  263.     temperature_sensor_5:
  264.       name: "${name} temperature sensor 5"
  265.     power_tube_temperature:
  266.       name: "${name} power tube temperature"
  267.     balancing:
  268.       name: "${name} balancing"
  269.     state_of_charge:
  270.       name: "${name} state of charge"
  271.     capacity_remaining:
  272.       name: "${name} capacity remaining"
  273.     total_battery_capacity_setting:
  274.       name: "${name} total battery capacity setting"
  275.     charging_cycles:
  276.       name: "${name} charging cycles"
  277.     total_charging_cycle_capacity:
  278.       name: "${name} total charging cycle capacity"
  279.     total_runtime:
  280.       name: "${name} total runtime"
  281.     balancing_current:
  282.       name: "${name} balancing current"
  283.     errors_bitmask:
  284.       name: "${name} errors bitmask"
  285.     emergency_time_countdown:
  286.       name: "${name} emergency time countdown"
  287.  
  288. switch:
  289.   - platform: jk_bms_ble
  290.     charging:
  291.       name: "${name} charging"
  292.     discharging:
  293.       name: "${name} discharging"
  294.     balancer:
  295.       name: "${name} balancer"
  296.     emergency:
  297.       name: "${name} emergency"
  298.     heating:
  299.       name: "${name} heating"
  300.     disable_temperature_sensors:
  301.       name: "${name} disable temperature sensors"
  302.     display_always_on:
  303.       name: "${name} display always on"
  304.     smart_sleep:
  305.       name: "${name} smart sleep"
  306.     disable_pcl_module:
  307.       name: "${name} disable pcl module"
  308.     timed_stored_data:
  309.       name: "${name} timed stored data"
  310.     charging_float_mode:
  311.       name: "${name} charging float mode"
  312.  
  313.   - platform: ble_client
  314.     ble_client_id: client0
  315.     id: ble_client_switch0
  316.     name: "${name} enable bluetooth connection"
  317.  
  318. text_sensor:
  319.   - platform: jk_bms_ble
  320.     errors:
  321.       name: "${name} errors"
  322.     total_runtime_formatted:
  323.       name: "${name} total runtime formatted"
Advertisement
Add Comment
Please, Sign In to add comment
Public Pastes
We use cookies for various purposes including analytics. By continuing to use Pastebin, you agree to our use of cookies as described in the Cookies Policy.  OK, I Understand
Not a member of Pastebin yet?
Sign Up, it unlocks many cool features!