docs: 更新变更日志,补充低电流待机恢复逻辑修改

refactor: 重构负载电流处理与状态机,优化待机恢复流程
- 修改chrg_comm.c:将低电流待机恢复改为先等待北向电压稳定
- 更新chrg_sink.h:新增/修改负载工作状态枚举与阈值参数
- 新增chrg_sou_com_batch_cancel接口并完善超时重试安全机制
- 优化chrg_north.c:调整电压稳定判断逻辑与计数阈值
- 修改chrg_sink.c:简化负载启动批次、更新关闭电流与卸载阈值

docs: 补充相关注释与文档说明,修正部分历史描述错误
This commit is contained in:
wrh
2026-08-09 20:34:09 +08:00
parent 030252c747
commit 03b313d9fe
7 changed files with 146 additions and 66 deletions
+44 -50
View File
@@ -21,8 +21,9 @@
#include "chrg_eload.h"
#define SINK_UNLOAD_QUERY_INTERVAL_MS 20U // 卸载期间两次优先量测请求的最小间隔
#define SINK_UNLOAD_CURRENT_MAX_MA 100U // 判定负载已安全卸载的最大实际电流
#define SINK_UNLOAD_CURRENT_MAX_MA 200U // 判定负载已安全卸载的最大实际电流
#define SINK_UNLOAD_CONFIRM_COUNT 2U // 连续满足低电流条件的量测帧数
#define SINK_CLOSE_CURRENT_MA 1000U // 安全关闭阶段写入功率板的电流设定值
/* 卸载确认只接受停止批次成功后产生的新P1量测。 */
static rt_uint32_t g_sink_unload_sample_seq[TOTAL_SOU_CHS] = {0};
@@ -322,8 +323,8 @@ static int chrg_sink_work_init_aux_wait(eIDX_SOU_CH idx,
*****************************************************************/
static int chrg_sink_work_volt_runing(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
{
rt_uint16_t regs[4] = {REG_REL_ON, REG_REL_ON, 0, REG_WORK};
rt_uint16_t vals[4] = {FU_REL_ON, ALL_REL_ON, 0, WORK_START};
rt_uint16_t regs[3] = {REG_REL_ON, 0, REG_WORK};
rt_uint16_t vals[3] = {ALL_REL_ON, 0, WORK_START};
int ret;
if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL)) {
@@ -332,14 +333,13 @@ static int chrg_sink_work_volt_runing(eIDX_SOU_CH idx, struct chrg_switch_t *pSW
if (!chrg_sink_load_should_start(pSW)) {
/*
* 北向协议已完成,低电流设定仍需要接通主继电器,使负载通路
* 处于完整连接状态;但禁止电子负载带载,随后发送WORK_STOP并
* 清零电流,避免0A或几十mA设定造成启动冲击。
* 处于完整连接状态;但禁止电子负载带载,仅发送WORK_STOP,
* 不改写电流设定,避免空载待机影响下一次有效电流设置。
*/
rt_uint16_t stop_regs[3] = {REG_REL_ON, REG_WORK,
REG_CURRENT_OUT + 1};
rt_uint16_t stop_vals[3] = {ALL_REL_ON, WORK_STOP, 0};
rt_uint16_t stop_regs[2] = {REG_REL_ON, REG_WORK};
rt_uint16_t stop_vals[2] = {ALL_REL_ON, WORK_STOP};
ret = chrg_sou_com_batch_submit(idx, stop_regs, stop_vals, 3U);
ret = chrg_sou_com_batch_submit(idx, stop_regs, stop_vals, 2U);
if (ret == 0) {
pSW->sink.work_mode = SINK_WORK_LOAD_STANDBY;
}
@@ -353,7 +353,7 @@ static int chrg_sink_work_volt_runing(eIDX_SOU_CH idx, struct chrg_switch_t *pSW
regs[2] = REG_CURRENT_OUT + 1;
vals[2] = pSW->sink.loadc;
}
return chrg_sou_com_batch_submit(idx, regs, vals, 4U);
return chrg_sou_com_batch_submit(idx, regs, vals, 3U);
}
/*****************************************************************
@@ -370,20 +370,18 @@ static int chrg_sink_work_volt_runing(eIDX_SOU_CH idx, struct chrg_switch_t *pSW
static int chrg_sink_work_soft_resume(eIDX_SOU_CH idx,
struct chrg_switch_t *pSW)
{
rt_uint16_t regs[4] = {REG_REL_ON, REG_REL_ON, 0, REG_WORK};
rt_uint16_t vals[4] = {FU_REL_ON, ALL_REL_ON, 0, WORK_START};
rt_uint16_t regs[3] = {REG_REL_ON, 0, REG_WORK};
rt_uint16_t vals[3] = {ALL_REL_ON, 0, WORK_START};
int ret;
if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL)) {
return -1;
}
if (!chrg_sink_load_should_start(pSW)) {
/* 软卸载未切继电器,低电流下继续保持原继电器和协议状态。 */
/* 软卸载未切继电器,低电流下保持原继电器和协议,只关闭电子负载。 */
regs[0] = REG_WORK;
vals[0] = WORK_STOP;
regs[1] = REG_CURRENT_OUT + 1;
vals[1] = 0;
ret = chrg_sou_com_batch_submit(idx, regs, vals, 2U);
ret = chrg_sou_com_batch_submit(idx, regs, vals, 1U);
if (ret == 0) {
pSW->sink.work_mode = SINK_WORK_LOAD_SOFT_STANDBY;
}
@@ -396,7 +394,7 @@ static int chrg_sink_work_soft_resume(eIDX_SOU_CH idx,
regs[2] = REG_CURRENT_OUT + 1;
vals[2] = pSW->sink.loadc;
}
if (chrg_sou_com_batch_submit(idx, regs, vals, 4U) != 0) {
if (chrg_sou_com_batch_submit(idx, regs, vals, 3U) != 0) {
return -1;
}
pSW->sink.work_mode = SINK_WORK_SOFT_RUNNING;
@@ -409,19 +407,19 @@ static int chrg_sink_work_soft_resume(eIDX_SOU_CH idx,
输入参数: idx:南向功率通道编号 pSW:当前通道控制结构体
输出参数: 命令入队成功后进入SINK_WORK_LOAD_SOFT_STANDBY
返回说明: 0:命令提交成功 <0:参数或命令提交失败
其它说明: 命令顺序固定为WORK_STOP、CURRENT=0;不改变北向协议、CC和
其它说明: 命令只发送WORK_STOP;不改变北向协议、CC、电流设定和
主副继电器,保证后续恢复有效电流时无需重新协议握手
*****************************************************************/
static int chrg_sink_work_load_stop(eIDX_SOU_CH idx,
struct chrg_switch_t *pSW)
{
rt_uint16_t regs[2] = {REG_WORK, REG_CURRENT_OUT + 1};
rt_uint16_t vals[2] = {WORK_STOP, 0};
rt_uint16_t reg = REG_WORK;
rt_uint16_t val = WORK_STOP;
if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL)) {
return -1;
}
if (chrg_sou_com_batch_submit(idx, regs, vals, 2U) != 0) {
if (chrg_sou_com_batch_submit(idx, &reg, &val, 1U) != 0) {
return -1;
}
pSW->sink.work_mode = SINK_WORK_LOAD_SOFT_STANDBY;
@@ -434,51 +432,38 @@ static int chrg_sink_work_load_stop(eIDX_SOU_CH idx,
输入参数: idx:南向功率通道编号 pSW:当前通道控制结构体
输出参数: 命令入队成功后进入SINK_WORK_SOFT_RUNNING
返回说明: 0:命令提交成功 <0:参数或命令提交失败
其它说明: 命令顺序为ALL_REL_ON、目标负载电流、WORK_START;不重新设置
协议或CC;低电流待机可能由软卸载进入且主继电器未闭合,恢复时
必须先把继电器打开再启动,防止电子负载先于主继电器带载
其它说明: 本状态只作为待恢复标记,不直接下发WORK_START;必须由北向解析确认
实际电压稳定后转入SINK_WORK_SOFT_RESUME,再恢复目标电流和WORK_START
*****************************************************************/
static int chrg_sink_work_load_resume(eIDX_SOU_CH idx,
struct chrg_switch_t *pSW)
{
rt_uint16_t regs[4] = {REG_REL_ON, REG_REL_ON,
REG_CURRENT_OUT + 1, REG_WORK};
rt_uint16_t vals[4] = {FU_REL_ON, ALL_REL_ON, 0, WORK_START};
if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL) ||
!chrg_sink_load_should_start(pSW)) {
return -1;
}
vals[2] = pSW->sink.loadc;
if (chrg_sou_com_batch_submit(idx, regs, vals, 4U) != 0) {
return -1;
}
pSW->sink.work_mode = SINK_WORK_SOFT_RUNNING;
return 0;
}
/*****************************************************************
函数名称: chrg_sink_work_load_start
函数描述: 从主继电器未打开的低电流待机状态执行完整负载启动
函数描述: 从主继电器未打开的低电流待机状态等待北向电压稳定后再启动负载
输入参数: idx:南向功率通道编号 pSW:当前通道控制结构体
输出参数: 命令入队成功后进入SINK_WORK_RUNING
返回说明: 0:命令提交成功 <0:参数或命令提交失败
其它说明: 使用独立入口避开状态机对RUNING的重复状态去重;执行副继电器、
全部继电器、目标负载值和WORK_START的标准启动顺序
其它说明: 本状态只作为待启动标记,不直接下发继电器或WORK_START;必须由北向
解析确认实际电压稳定后转入SINK_WORK_RUNING,再执行标准启动顺序
*****************************************************************/
static int chrg_sink_work_load_start(eIDX_SOU_CH idx,
struct chrg_switch_t *pSW)
{
int ret;
if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL)) {
return -1;
}
ret = chrg_sink_work_volt_runing(idx, pSW);
if ((ret == 0) && (pSW->sink.work_mode == SINK_WORK_LOAD_START)) {
pSW->sink.work_mode = SINK_WORK_RUNING;
if (!chrg_sink_load_should_start(pSW)) {
return -1;
}
return ret;
return 0;
}
/*****************************************************************
@@ -487,7 +472,7 @@ static int chrg_sink_work_load_start(eIDX_SOU_CH idx,
输入参数: idx:南向功率通道编号 pSW:当前通道控制结构体
输出参数: -
返回说明: 0:命令提交成功 非0:命令提交失败
其它说明: 命令顺序为WORK_STOP、CURRENT=0、ALL_REL_OFF、FU_REL_ON;
其它说明: 命令顺序为WORK_STOP、CURRENT=1000mA、ALL_REL_OFF、FU_REL_ON;
ALL_REL_OFF后立即恢复副继电器,为协议板重新得电保留通路
*****************************************************************/
static int chrg_sink_nor_work_low(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
@@ -496,12 +481,16 @@ static int chrg_sink_nor_work_low(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
REG_WORK, REG_CURRENT_OUT + 1, REG_REL_ON, REG_REL_ON
};
rt_uint16_t vals[4] = {
WORK_STOP, 0, ALL_REL_OFF, FU_REL_ON
WORK_STOP, SINK_CLOSE_CURRENT_MA, ALL_REL_OFF, FU_REL_ON
};
if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL)) {
return -1;
}
/* 低压保护优先级最高,先丢弃该通道残留的启动或设定命令。 */
if (chrg_sou_com_batch_cancel(idx) != 0) {
return -1;
}
if (chrg_sou_com_batch_submit(idx, regs, vals, 4U) != 0) {
return -1;
}
@@ -609,7 +598,7 @@ static int chrg_sink_work_switch(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
输出参数: -
返回说明: 0:命令提交成功 <0:命令提交失败
其它说明: 不操作北向和南向功率继电器;WORK_STOP完成后进入UNLOAD_WAIT,
连续确认两帧实际电流不大于100mA,才允许北向重配协议并使用软恢复流程
连续确认两帧实际电流不大于200mA,才允许北向重配协议并使用软恢复流程
*****************************************************************/
static int chrg_sink_work_protocol_unload(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
{
@@ -632,7 +621,8 @@ static int chrg_sink_work_protocol_unload(eIDX_SOU_CH idx, struct chrg_switch_t
输入参数: idx:南向功率板通道 pSW:当前通道控制结构体
输出参数: 命令提交成功后进入SINK_WORK_HANDSHAKE_WAIT
返回说明: 0:四条命令提交成功 <0:参数或命令提交失败
其它说明: 命令顺序固定为WORK_STOP、CURRENT=0、ALL_REL_OFF、FU_REL_ON;
其它说明: 命令顺序固定为WORK_STOP、CURRENT=1000mA、ALL_REL_OFF、FU_REL_ON;
WORK_STOP已关闭电子负载,1000mA仅为功率板停止阶段保存的电流设定值;
主副继电器全部断开并确认回码后再单独打开副继电器;
北向Sink继电器保持接通,低电流确认完成后才允许重新握手
*****************************************************************/
@@ -643,17 +633,21 @@ static int chrg_sink_work_handshake_prepare(eIDX_SOU_CH idx,
REG_WORK, REG_CURRENT_OUT + 1, REG_REL_ON, REG_REL_ON
};
rt_uint16_t vals[4] = {
WORK_STOP, 0, ALL_REL_OFF, FU_REL_ON
WORK_STOP, SINK_CLOSE_CURRENT_MA, ALL_REL_OFF, FU_REL_ON
};
if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL)) {
return -1;
}
/* 新CC/协议事务必须抢占本通道尚未发送的旧启动和设定命令。 */
if (chrg_sou_com_batch_cancel(idx) != 0) {
return -1;
}
if (chrg_sou_com_batch_submit(idx, regs, vals, 4) != 0) {
return -1;
}
/* 四条写回码完成后,还必须连续确认两帧实际电流不大于100mA。 */
/* 四条写回码完成后,还必须连续确认两帧实际电流不大于200mA。 */
chrg_sink_unload_confirm_reset(idx);
pSW->sink.work_mode = SINK_WORK_HANDSHAKE_WAIT;
return 0;
@@ -661,13 +655,13 @@ static int chrg_sink_work_handshake_prepare(eIDX_SOU_CH idx,
/*****************************************************************
函数名称: chrg_sink_work_current_wait
函数描述: 等待负载安全断开批次完成,并连续确认两帧实际电流不大于100mA
函数描述: 等待负载安全断开批次完成,并连续确认两帧实际电流不大于200mA
输入参数: idx:南向功率板通道 pSW:当前通道控制结构体
full_handshake:RT_TRUE为完整重握手 RT_FALSE为协议参数软卸载
输出参数: 确认成功后将sink.work_mode切换为SINK_WORK_WAIT
返回说明: 0:继续等待或确认成功 <0:状态查询或优先量测请求失败
其它说明: 软卸载只要求WORK_STOP收到匹配回码后建立量测基线;完整重握手
还要求CURRENT=0、ALL_REL_OFF和FU_REL_ON回码成功,但保持北向Sink继电器接通
还要求CURRENT=1000mA、ALL_REL_OFF和FU_REL_ON回码成功,但保持北向Sink继电器接通
*****************************************************************/
static int chrg_sink_work_current_wait(eIDX_SOU_CH idx,
struct chrg_switch_t *pSW, rt_bool_t full_handshake)
+5 -5
View File
@@ -203,7 +203,7 @@ enum {
/*
* 普通恒流负载允许执行WORK_START的最低设定电流,单位mA。
* 小于该值时北向仍完成协议握手,但南向保持WORK_STOP且设定电流为0,
* 小于该值时北向仍完成协议握手,但南向保持WORK_STOP且不改写电流设定,
* 避免功率板在零电流或几十mA的小电流设定下启动电子负载产生冲击。
*/
#define SINK_LOAD_ENABLE_MIN_MA 100U
@@ -222,7 +222,7 @@ enum {
SINK_WORK_STOP, // 用户主动停止负载
SINK_WORK_SWITCH, // 停止旧电源后进入负载INIT
SINK_WORK_PROTOCOL_UNLOAD, // 协议电压或电流变化:掉载但不切换继电器
SINK_WORK_UNLOAD_WAIT, // 等待软卸载完成并连续两次确认电流不大于100mA
SINK_WORK_UNLOAD_WAIT, // 等待软卸载完成并连续两次确认电流不大于200mA
SINK_WORK_SOFT_RESUME_WAIT, // 继电器保持闭合,等待协议电压稳定后恢复负载
SINK_WORK_SOFT_RESUME, // 只恢复目标电流/电压和WORK_START,不写继电器
SINK_WORK_SOFT_RUNNING, // 软恢复后的稳定运行状态,禁止重复切换继电器
@@ -233,9 +233,9 @@ enum {
SINK_WORK_HANDSHAKE_WAIT, // 南向低电流确认与北向协议/CC并行
SINK_WORK_LOAD_STANDBY, // 协议已就绪但主继电器未打开,低设定电流下保持停止
SINK_WORK_LOAD_SOFT_STANDBY, // 协议和继电器保持不变,运行中降至低电流后的停止状态
SINK_WORK_LOAD_STOP, // 运行中跨到低电流:发送WORK_STOP后将设定电流清零
SINK_WORK_LOAD_START, // 主继电器未打开的低电流待机恢复:执行完整RUNING动作
SINK_WORK_LOAD_RESUME, // 软待机跨回有效电流:不切继电器,直接恢复电流和WORK_START
SINK_WORK_LOAD_STOP, // 运行中跨到低电流:只发送WORK_STOP关闭电子负载
SINK_WORK_LOAD_START, // 主继电器未打开的低电流待机恢复:等待北向电压稳定后进入RUNING
SINK_WORK_LOAD_RESUME, // 软待机跨回有效电流:等待北向电压稳定后进入SOFT_RESUME
};
// sink 参数结构