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

PipSolar 光伏逆变器

PipSolar 组件允许你在 ESPHome 中集成 PIP 兼容的逆变器。 它使用 UART 进行通信。

配置完成后，你可以在项目中使用下面描述的传感器、二进制传感器、开关和输出。

WARNING

所有功能在 esp8266 和 esp32 芯片上都能正常工作。 如果你配置了下面列出的很多可能的传感器等，可能会耗尽内存（在 esp8266 上）。 如果你配置了不止一个这样的设备且几乎包含所有传感器等，你会遇到栈大小问题。在这种情况下，你必须增大栈大小。

pip4048 兼容的光伏逆变器。

你可以连接各种各样的光伏逆变器，只要它们提供串行接口并能识别所使用的命令（至少是你想使用的那些命令）。 关于（大多受支持的）通信协议的文档可以在此处找到。

此组件会在循环中轮询所需的轮询命令。如果有用于控制逆变器的命令要发送，该命令将被排队，并在当前轮询命令结束后作为下一条发出。 有一个缓冲区最多可缓冲 10 条命令。

# 示例配置条目
pipsolar:
  - id: inverter0

配置变量

Section titled “配置变量”
  • id (必选, ID): 用于此 pipsolar 组件的 id。
  • uart_id (可选): UART 总线 ID。

传感器

Section titled “传感器”
# 示例配置条目
sensor:
  - platform: pipsolar
    pipsolar_id: inverter0
    grid_rating_voltage:
      id: inverter0_grid_rating_voltage
      name: inverter0_grid_rating_voltage
    grid_rating_current:
      id: inverter0_grid_rating_current
      name: inverter0_grid_rating_current
    ac_output_apparent_power:
      id: inverter0_ac_output_apparent_power
      name: inverter0_ac_output_apparent_power
    ac_output_active_power:
      id: inverter0_ac_output_active_power
      name: inverter0_ac_output_active_power

配置变量

Section titled “配置变量”

所有传感器都是普通的传感器…所以所有的传感器变量也都有效。

  • grid_rating_voltage (可选): 额定并网电压

  • grid_rating_current (可选): 额定并网电流

  • ac_output_rating_voltage (可选): AC 输出额定电压

  • ac_output_rating_frequency (可选): AC 输出额定频率

  • ac_output_rating_current (可选): AC 输出额定电流

  • ac_output_rating_apparent_power (可选): AC 输出额定视在功率

  • ac_output_rating_active_power (可选): AC 输出额定有功功率

  • battery_rating_voltage (可选): 电池额定电压

  • battery_recharge_voltage (可选): 电池再充电电压

  • battery_under_voltage (可选): 电池欠压值

  • battery_bulk_voltage (可选): 电池恒流（bulk）充电电压

  • battery_float_voltage (可选): 电池浮充电压

  • battery_type (可选): 电池类型

  • current_max_ac_charging_current (可选): 当前最大交流充电电流

  • current_max_charging_current (可选): 当前最大充电电流

  • input_voltage_range (可选): 输入电压范围

  • output_source_priority (可选): 输出源优先级

  • charger_source_priority (可选): 充电器源优先级

  • parallel_max_num (可选): 并联最大数量

  • machine_type (可选): 机器类型

  • topology (可选): 拓扑结构

  • output_mode (可选): 输出模式

  • battery_redischarge_voltage (可选): 电池再放电电压

  • pv_ok_condition_for_parallel (可选): 并联的 PV 正常条件

  • pv_power_balance (可选): PV 功率平衡模式

  • grid_voltage (可选): 并网电压

  • grid_frequency (可选): 并网频率

  • ac_output_voltage (可选): AC 输出电压

  • ac_output_frequency (可选): AC 输出频率

  • ac_output_apparent_power (可选): AC 输出视在功率

  • ac_output_active_power (可选): AC 输出有功功率

  • output_load_percent (可选): 输出负载百分比

  • bus_voltage (可选): 母线电压

  • battery_voltage (可选): 电池电压

  • battery_charging_current (可选): 电池充电电流

  • battery_capacity_percent (可选): 电池容量百分比

  • inverter_heat_sink_temperature (可选): 逆变器散热器温度

  • pv_input_current_for_battery (可选): 供电池充电的 PV 输入电流

  • pv_input_voltage (可选): PV 输入电压

  • battery_voltage_scc (可选): 来自 scc 的电池电压

  • battery_discharge_current (可选): 电池放电电流

  • battery_voltage_offset_for_fans_on (可选): 风机开启的电池电压偏移

  • eeprom_version (可选): eeprom 版本

  • pv_charging_power (可选): PV 充电功率

二进制传感器

Section titled “二进制传感器”
# 示例配置条目
binary_sensor:
  - platform: pipsolar
    pipsolar_id: inverter0
    add_sbu_priority_version:
      id: inverter0_add_sbu_priority_version
      name: inverter0_add_sbu_priority_version
    configuration_status:
      id: inverter0_configuration_status
      name: inverter0_configuration_status

配置变量

Section titled “配置变量”

所有传感器都是普通的二进制传感器…所以所有的二进制传感器变量也都有效。

  • add_sbu_priority_version (可选): 添加 sbu 优先级版本

  • configuration_status (可选): 配置状态

  • scc_firmware_version (可选): scc 固件版本

  • load_status (可选): 负载状态

  • battery_voltage_to_steady_while_charging (可选): 充电时电池电压达到稳定值

  • charging_status (可选): 充电状态

  • scc_charging_status (可选): scc 充电状态

  • ac_charging_status (可选): 交流充电状态

  • charging_to_floating_mode (可选): 从充电切换到浮充模式

  • switch_on (可选): 开关机

  • dustproof_installed (可选): 已安装防尘装置

  • silence_buzzer_open_buzzer (可选): 静音蜂鸣器/开启蜂鸣器

  • overload_bypass_function (可选): 过载旁路功能

  • lcd_escape_to_default (可选): LCD 恢复默认

  • overload_restart_function (可选): 过载重启功能

  • over_temperature_restart_function (可选): 过温重启功能

  • backlight_on (可选): 背光开启

  • alarm_on_when_primary_source_interrupt (可选): 主电源中断时报警

  • fault_code_record (可选): 故障码记录

  • power_saving (可选): 节能模式

  • warnings_present (可选): 存在警告

  • faults_present (可选): 存在故障

  • warning_power_loss (可选): 警告：断电

  • fault_inverter_fault (可选): 故障：逆变器故障

  • fault_bus_over (可选): 故障：母线过压

  • fault_bus_under (可选): 故障：母线欠压

  • fault_bus_soft_fail (可选): 故障：母线软故障

  • warning_line_fail (可选): 警告：线路故障

  • fault_opvshort (可选): 故障：opvshort

  • fault_inverter_voltage_too_low (可选): 故障：逆变器电压过低

  • fault_inverter_voltage_too_high (可选): 故障：逆变器电压过高

  • warning_over_temperature (可选): 警告：过温

  • warning_fan_lock (可选): 警告：风机锁定

  • warning_battery_voltage_high (可选): 警告：电池电压过高

  • warning_battery_low_alarm (可选): 警告：电池低电量报警

  • warning_battery_under_shutdown (可选): 警告：电池欠压关机

  • warning_battery_derating (可选): 警告：电池降额

  • warning_over_load (可选): 警告：过载

  • warning_eeprom_failed (可选): 警告：eeprom 失败

  • fault_inverter_over_current (可选): 故障：逆变器过流

  • fault_inverter_soft_failed (可选): 故障：逆变器软启动失败

  • fault_self_test_failed (可选): 故障：自检失败

  • fault_op_dc_voltage_over (可选): 故障：直流输出电压过高

  • fault_battery_open (可选): 故障：电池开路

  • fault_current_sensor_failed (可选): 故障：电流传感器故障

  • fault_battery_short (可选): 故障：电池短路

  • warning_power_limit (可选): 警告：功率限制

  • warning_pv_voltage_high (可选): 警告：PV 电压过高

  • fault_mppt_overload (可选): 故障：MPPT 过载

  • warning_mppt_overload (可选): 警告：MPPT 过载

  • warning_battery_too_low_to_charge (可选): 警告：电池电压过低无法充电

  • fault_dc_dc_over_current (可选): 故障：DC-DC 过流

  • fault_code (可选): 故障码

  • warning_low_pv_energy (可选): 警告：PV 能量过低

  • warning_high_ac_input_during_bus_soft_start (可选): 警告：母线软启动期间交流输入过高

  • warning_battery_equalization (可选): 警告：电池均衡

文本传感器

Section titled “文本传感器”
# 示例配置条目
text_sensor:
  - platform: pipsolar
    pipsolar_id: inverter0
    device_mode:
      id: inverter0_device_mode
      name: inverter0_device_mode
    last_qpigs:
      id: inverter0_last_qpigs
      name: inverter0_last_qpigs
    last_qpiri:

配置变量

Section titled “配置变量”

所有传感器都是普通的文本传感器…所以所有的文本传感器变量也都有效。

  • device_mode (可选): 设备模式响应
  • last_qpigs (可选): 上次 qpigs 响应
  • last_qpiri (可选): 上次 qpiri 响应
  • last_qmod (可选): 上次 qmod 响应
  • last_qflag (可选): 上次 qflag 响应
  • last_qpiws (可选): 上次 qpiws 响应
  • last_qt (可选): 上次 qt 响应
  • last_qmn (可选): 上次 qmn 响应

开关

Section titled “开关”

并非所有可能的开关都被公开，因为它们可能导致严重损坏的可能性。它们应该只在物理设备本身上设置。

# 示例配置条目
switch:
  - platform: pipsolar
    pipsolar_id: inverter0
    output_source_priority_utility:
      name: inverter0_output_source_priority_utility
    output_source_priority_solar:
      name: inverter0_output_source_priority_solar
    output_source_priority_battery:
      name: inverter0_output_source_priority_battery
    output_source_priority_hybrid:
      name: inverter0_output_source_priority_hybrid
    input_voltage_range:
      name: inverter0_input_voltage_range
    pv_ok_condition_for_parallel:
      name: inverter0_pv_ok_condition_for_parallel
    pv_power_balance:
      name: inverter0_pv_power_balance

配置变量

Section titled “配置变量”

所有传感器都是普通的文本传感器…所以所有的文本传感器变量也都有效。

  • output_source_priority_utility (可选): 输出源优先级：市电
  • output_source_priority_solar (可选): 输出源优先级：太阳能
  • output_source_priority_battery (可选): 输出源优先级：电池
  • output_source_priority_hybrid (可选): 输出源优先级：混合
  • input_voltage_range (可选): 输入电压范围
  • pv_ok_condition_for_parallel (可选): 并联的 PV 正常条件
  • pv_power_balance (可选): PV 功率平衡

输出

Section titled “输出”

并非所有可能的输出都被公开，因为它们可能导致严重损坏的可能性。它们应该只在物理设备本身上设置。

# 示例配置条目
output:
  - platform: pipsolar
    pipsolar_id: inverter0
    battery_recharge_voltage:
      id: inverter0_battery_recharge_voltage_out

配置变量

Section titled “配置变量”

所有传感器都是普通的文本传感器…所以所有的文本传感器变量也都有效。

  • battery_recharge_voltage (可选): 电池再充电电压；

    • possible_values (可选, list): 可能值的列表，默认：44.0,45.0,46.0,47.0,48.0,49.0,50.0,51.0

  • battery_under_voltage (可选): 电池欠压值；

    • possible_values (可选, list): 可能值的列表，默认：40.0,40.1,42,43,44,45,46,47,48.0

  • battery_float_voltage (可选): 电池浮充电压；

    • possible_values (可选, list): 可能值的列表，默认：48.0,49.0,50.0,51.0

  • battery_type (可选): 电池类型；

    • possible_values (可选, list): 可能值的列表，默认：0,1,2

  • current_max_ac_charging_current (可选): 当前最大交流充电电流；

    • possible_values (可选, list): 可能值的列表，默认：2,10,20

  • current_max_charging_current (可选): 当前最大充电电流；

    • possible_values (可选, list): 可能值的列表，默认：10,20,30,40

  • output_source_priority (可选): 输出源优先级；

    • possible_values (可选, list): 可能值的列表，默认：0,1,2

  • charger_source_priority (可选): 充电器源优先级；

    • possible_values (可选, list): 可能值的列表，默认：0,1,2,3

  • battery_redischarge_voltage (可选): 电池再放电电压；

    • possible_values (可选, list): 可能值的列表，默认：00.0,48.0,49,50.0,51.0,52,53,54,55,56,57,58

output.pipsolar.set_level 操作

Section titled “output.pipsolar.set_level 操作”

要在自动化或模板中使用你的输出，你可以使用此操作来设置 输出的目标级别。

on_...:
  then:
  - output.pipsolar.set_level:
      id: my_pipsolar_output
      value: 48.0

配置选项：

  • id (必选, ID): 输出的 ID。
  • value (必选, percentage, 可模板化): 目标级别。

另请参阅

Section titled “另请参阅”