跳转到内容
ESPHome - 让智能家居更简单2026.7.0

Pylontech 电池

Pylontech 组件允许你将 Pylontech 电池的数据拉取到 ESPHome 中。 它使用 UART 进行通信。

配置完成后，你可以在项目中使用如下所述的传感器。

Pylontech 电池

硬件设置

Section titled “硬件设置”

你可以使用标有 “Console” 的端口连接到 Pylontech 电池。 通过 CAN 或 RS485 的任何连接（例如连接到逆变器）都不会受影响，保持可用。

控制台端口提供使用 RJ11 或 RJ45 连接器的 RS232 接口。 电压电平不兼容 TTL。必须在电池和 ESPHome 设备之间放置一个 RS232 收发器。 基于 MAX3232 的收发器已经过测试，可以很好地工作。

如果你有多个电池，你需要连接到主电池的控制台端口。

Pylontech RJ45 控制台端口（US2000C、US3000C、US5000C）

Section titled “Pylontech RJ45 控制台端口（US2000C、US3000C、US5000C）”
RJ45 引脚TIA-568B 颜色TIA-568A 颜色功能连接到
3White/GreenWhite/OrangePylontech TX经收发器接 ESPHome RX
6GreenOrangePylontech RX经收发器接 ESPHome TX
8BrownBrownGNDGND
RJ45 引脚定义

Pylontech RJ11 控制台引脚定义（US2000B、US2000）

Section titled “Pylontech RJ11 控制台引脚定义（US2000B、US2000）”
RJ11 引脚功能连接到
2Pylontech RX经收发器接 ESPHome TX
3Pylontech TX经收发器接 ESPHome RX
4GNDGND

组件/Hub

Section titled “组件/Hub”
# 示例配置条目
pylontech:

配置变量

Section titled “配置变量”
  • id (必选, ID): 用于此 Pylontech 组件的 id。
  • uart_id (可选): UART 总线 ID。
  • update_interval (可选, Time): 检查传感器的间隔。默认为 60s。

传感器

Section titled “传感器”

所有值都会针对每个 Pylontech 电池单独报告。

# 示例配置条目
sensor:
  - platform: pylontech
    battery: 1


    voltage:
      name: "Battery1 Voltage"
    current:
      name: "Battery1 Current"
    coulomb:
      name: "Battery1 State of Charge"

配置变量

Section titled “配置变量”
  • pylontech_id (可选): 如果有多个 pylontech 实例，手动指定该实例的 ID。
  • battery (必选): 要监控的电池。1 表示主电池，2..16 表示子电池。
  • voltage (可选): 电池电压。Sensor 的所有选项。
  • current (可选): 流入电池的电流。放电时为负值。Sensor 的所有选项。
  • coulomb (可选): 充电状态，以百分比表示。Sensor 的所有选项。
  • temperature (可选): 温度。Sensor 的所有选项。
  • temperature_low (可选): 历史最低温度。Sensor 的所有选项。
  • temperature_high (可选): 历史最高温度。Sensor 的所有选项。
  • voltage_low (可选): 最低电芯的电压。Sensor 的所有选项。
  • voltage_high (可选): 最高电芯的电压。Sensor 的所有选项。
  • mos_temperature (可选): mosfet 的温度。Sensor 的所有选项。

文本传感器

Section titled “文本传感器”
# 示例配置条目
text_sensor:
  - platform: pylontech
    pylontech_id: pylontech0
    battery: 1


    base_state:
      id: bat1_base_state
      name: "Battery1 Base State"

配置变量

Section titled “配置变量”
  • pylontech_id (可选): 如果有多个 pylontech 实例，手动指定该实例的 ID。
  • battery (必选): 要监控的电池。1 表示主电池，2..16 表示子电池。
  • base_state (可选): 基本状态。通常读取为 Dischg、Charge 或 Idle。文本传感器 的所有选项。
  • voltage_state (可选): 电压状态。通常读取为 Normal。文本传感器 的所有选项。
  • current_state (可选): 电流状态。通常读取为 Normal。文本传感器 的所有选项。
  • temperature_state (可选): 温度状态。通常读取为 Normal。文本传感器 的所有选项。

能量监控

Section titled “能量监控”

通过组合模板传感器和 积分传感器， 可以监控所有电池组合流入和流出的能量，为 Homeassistant 能量监控 做好准备。

sensor:
  - platform: template
    id: pylontech_power
    name: "Pylontech power"
    unit_of_measurement: W
    lambda: |-
      auto pwr1 = id(bat1_voltage).state * id(bat1_current).state;
      auto pwr2 = id(bat2_voltage).state * id(bat2_current).state;
      auto pwr = pwr1 + pwr2;
      id(combined_charge_power).publish_state(max(pwr, 0.0f));
      id(combined_discharge_power).publish_state(max(-pwr, 0.0f));
      return pwr;
    update_interval: 5s
    device_class: power
    state_class: measurement


  - platform: template
    id: combined_charge_power


  - platform: template
    id: combined_discharge_power


  - platform: integration
    name: "Pylontech charging"
    sensor: combined_charge_power
    time_unit: h
    state_class: total_increasing
    device_class: energy
    unit_of_measurement: "Wh"


  - platform: integration
    name: "Pylontech discharging"
    sensor: combined_discharge_power
    time_unit: h
    state_class: total_increasing
    device_class: energy
    unit_of_measurement: "Wh"

另请参阅

Section titled “另请参阅”