PipSolar 光伏逆变器

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

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

WARNING

所有功能在 esp8266 和 esp32 芯片上工作正常。如果您配置了下面许多可能的传感器等，可能会出现内存不足的情况（在 esp8266 上）。如果您配置多个此类设备并启用几乎所有传感器等，则会遇到栈大小问题。在这种情况下，您必须增加栈大小。

概述

您可以连接各种光伏逆变器，只要它们提供串行接口并能使用所需的命令（至少是您想要使用的命令）。关于大多数支持的通信协议的文档可以在这里找到。

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

# 示例配置项
pipsolar:
  - id: inverter0

配置变量

id (必填, ID): 用于此 pipsolar 组件的 id。
uart_id (可选): UART 总线 ID

传感器

# 示例配置项
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

配置变量

所有传感器都是普通传感器…所以所有传感器变量都可用。

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 (可选): 当前最大 AC 充电电流
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 充电功率

二进制传感器

# 示例配置项
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

配置变量

所有传感器都是普通二进制传感器…所以所有二进制传感器变量都可用。

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 (可选): AC 充电状态
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 (可选): 输出短路故障
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 (可选): 母线软启动期间 AC 输入过高警告
warning_battery_equalization (可选): 电池均衡警告

文本传感器

# 示例配置项
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:

配置变量

所有传感器都是普通文本传感器…所以所有文本传感器变量都可用。

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

开关

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

# 示例配置项
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

配置变量

所有传感器都是普通文本传感器…所以所有文本传感器变量都可用。

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 功率平衡

输出

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

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

配置变量

所有传感器都是普通文本传感器…所以所有文本传感器变量都可用。

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 (可选): 当前最大 AC 充电电流;
- 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` 动作

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

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

配置选项：

id (必填, ID): 输出的 ID。
value (可选, 百分比, 模板化): 目标级别。

另请参阅

UART 总线

PipSolar 光伏逆变器

概述

配置变量

传感器

配置变量

二进制传感器

配置变量

文本传感器

配置变量

开关

配置变量

输出

配置变量

output.pipsolar.set_level 动作

另请参阅

`output.pipsolar.set_level` 动作