YamBMS项目YAML配置完全指南

项目概述

YamBMS是一个基于ESPHome的电池管理系统(BMS)监控解决方案，支持多种BMS设备类型和通信方式。本文将详细介绍如何为YamMBMS项目创建和配置YAML文件，帮助用户实现电池系统的全面监控。

基础配置

网络连接配置

YamBMS支持WiFi和以太网两种连接方式，建议根据实际使用环境选择合适的连接方式。

WiFi配置示例

wifi:
  manual_ip:
    static_ip: 192.168.0.85
    gateway: 192.168.0.1
    subnet: 255.255.255.0
    dns1: 8.8.8.8
    dns2: 8.8.4.4

重要提示：

• 默认情况下，如果ESP32断开WiFi连接，会每15分钟重启尝试恢复连接
• WiFi凭证需要配置在secrets.yaml文件中

以太网配置示例

ethernet:
  manual_ip:
    static_ip: 192.168.0.85
    gateway: 192.168.0.1
    subnet: 255.255.255.0
    dns1: 8.8.8.8
    dns2: 8.8.4.4

Home Assistant API配置

api:
  reboot_timeout: 0s

此配置可防止ESP32在Home Assistant断开连接时自动重启。

Web服务器配置

Web服务器组件提供了通过浏览器访问YamBMS信息的界面，但需要注意：

• 启用此组件会占用大量内存
• 可能会影响系统稳定性
• 在不使用Home Assistant时特别有用

硬件板选择

YamBMS支持多种ESP32开发板，以下是常见型号的配置示例：

通用ESP32开发板

  device_board: !include packages/board/board_ESP32_Generic.yaml

带显示屏的开发板

  device_board: !include
    file: packages/board/board_ESP32-S3_AtomS3.yaml
    vars:
      display_auto_next_page_interval: '5s'

带以太网的开发板

  device_board: !include packages/board/board_ESP32-C3_ETH01-EVO.yaml

BMS设备配置

基本规则

• BMS必须从1开始顺序编号
• 主节点使用bms_combine前缀的配置文件
• RS485总线上的节点使用bms_modbus前缀的配置文件

JK-BMS配置示例

BLE连接方式

  bms1: !include
    file: packages/bms/bms_combine_JK_BLE_standard.yaml
    vars:
      bms_id: '1'
      bms_name: 'BMS 1'
      bms_ble_protocol_version: 'JK02_32S'
      bms_ble_mac_address: 'C8:47:8C:10:7E:AA'
      bms_cell_max_cycles: '6000.0'

注意：BLE连接会消耗大量RAM，建议优先考虑UART或RS485连接。

UART连接方式

  bms1: !include
    file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml
    vars:
      bms_id: '1'
      bms_name: 'BMS 1'
      bms_uart_id: 'uart_esp_1'
      bms_cell_max_cycles: '6000.0'

JBD-BMS配置示例

UART连接方式

  bms1: !include
    file: packages/bms/bms_combine_JBD_UART_full.yaml
    vars:
      bms_id: '1'
      bms_name: 'BMS 1'
      bms_uart_id: 'uart_esp_1'
      bms_rx_timeout: '150ms'
      bms_max_charge_current: '100'
      bms_max_discharge_current: '100'
      bms_cell_ovp: '3.650'
      bms_cell_uvp: '2.800'
      bms_balance_trigger_voltage: '0.010'
      bms_cell_max_cycles: '6000.0'

分流器(Shunt)配置

基本规则

• 分流器必须从1开始顺序编号
• 主节点使用shunt_combine前缀的配置文件
• RS485总线上的节点使用shunt_modbus前缀的配置文件

Victron SmartShunt配置示例

  shunt1: !include
    file: packages/shunt/shunt_combine_Victron_SmartShunt_UART.yaml
    vars:
      shunt_id: '1'
      shunt_name: 'Shunt 1'

RS485多节点配置

YamBMS支持通过RS485总线连接多个节点，实现分布式电池监控。

主节点(Modbus客户端)配置

  modbus: !include
    file: packages/base/device_modbus.yaml
    vars:
      modbus_role: 'client'
      modbus_uart_id: 'uart_esp_1'

  bms1: !include
    file: packages/bms/bms_combine_modbus_client.yaml
    vars:
      bms_id: '1'
      bms_name: 'BMS 1'

从节点(Modbus服务器)配置

  modbus: !include
    file: packages/base/device_modbus.yaml
    vars:
      modbus_role: 'server'
      modbus_uart_id: 'uart_esp_1'

  bms1: !include
    file: packages/bms/bms_modbus_JK_UART_4G-GPS_full.yaml
    vars:
      bms_id: '1'
      bms_name: 'BMS 1'

重要提示：Modbus客户端和服务器的BMS/Shunt ID必须完全匹配。

性能优化建议

1. 蓝牙和Web服务器组件会占用大量内存，可能影响稳定性
2. 优先使用有线连接(UART/RS485)而非蓝牙
3. 对于简单监控需求，可以使用minimal版本的配置文件
4. 合理配置自动重启参数，平衡系统稳定性和故障恢复能力

通过以上配置指南，用户可以灵活地构建适合自己需求的电池监控系统，无论是单节点还是复杂的多节点RS485网络。