refactor(chrg): 重构北向轮询与状态机代码,补充注释与函数文档

1.  apps/chrg/applications/thread/chrg_roll_nor.c: 新增chrg_roll_nor_cmd、chrg_roll_nor_set函数注释,补充线程判断逻辑注释
2.  apps/chrg/applications/thread/chrg_comm.c: 完善modbus写入寄存器的注释,补充角色切换逻辑说明
3.  apps/chrg/applications/utils/chrg_source.c: 为所有电源状态机函数补充详细中文注释与函数说明
4.  apps/chrg/applications/thread/chrg_north.c: 删除冗余全局变量与函数,补充帧处理、解析函数注释,修正初始化注释
5.  apps/chrg/applications/utils/chrg_sink.c: 删除大量废弃测试代码,为所有负载状态机函数补充详细中文注释与函数说明
This commit is contained in:
wrh
2026-07-22 10:14:48 +08:00
parent 684ad2e20e
commit 587e03b65f
5 changed files with 238 additions and 343 deletions
+63 -16
View File
@@ -23,12 +23,6 @@
//#define LOG_TAG "chrg.nor"
#define DBG_LEVEL DBG_LOG
#include <rtdbg.h>
rt_uint16_t volt;
uint16_t chrg_compare(rt_int16_t a, rt_int16_t b)
{
if(a>b) return a - b;
else return b - a;
}
/*****************************************************************
函数名称: chrg_source_standard_output
@@ -53,7 +47,16 @@ void chrg_source_standard_output(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
}
}
//电源快充
/*****************************************************************
函数名称: chrg_source_parse
函数描述: 解析北向电源板电压电流回码并驱动Source状态机
输入参数: frame_data:完整北向回码 idx:当前通道 pSW:通道控制结构体
pNOR:北向总控结构体
输出参数: 更新协商电压、电流、source.work_mode及上次下发电压缓存
返回说明: -
其它说明: frame_data[4~7]为实测值,[8~11]为协议协商目标值;
目标电压变化时进入RUNING,相同时进入WAIT
*****************************************************************/
void chrg_source_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
struct chrg_switch_t *pSW, struct chrg_north_t *pNOR)
{
@@ -61,7 +64,6 @@ void chrg_source_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
rt_uint16_t Curr_mA = (frame_data[10] << 8) | frame_data[11];
rt_uint16_t volt_mv_Now = (frame_data[4] << 8) | frame_data[5];
rt_uint16_t Curr_mA_Now = (frame_data[6] << 8) | frame_data[7];
rt_uint16_t volt_compare = chrg_compare(volt_mv, volt_mv_Now);
static rt_uint16_t last_volt_mv[TOTAL_SOU_CHS] = {0};
static rt_uint8_t number = 0;
int ret;
@@ -84,7 +86,15 @@ void chrg_source_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
}
}
//电源设置
/*****************************************************************
函数名称: chrg_source_setting
函数描述: 根据电源协议类型和启停标志选择标准输出或快充解析流程
输入参数: frame_data:北向回码 idx:当前通道 pSW:通道控制结构体
pNOR:北向总控结构体
输出参数: 可能更新功率板设定值或北向子状态sub
返回说明: -
其它说明: 标准协议直接设置输出,快充协议使用协商结果驱动状态机
*****************************************************************/
void chrg_source_setting(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
struct chrg_switch_t *pSW, struct chrg_north_t *pNOR)
{
@@ -103,7 +113,16 @@ void chrg_source_setting(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
}
}
//解析负载返回数据
/*****************************************************************
函数名称: chrg_sink_parse
函数描述: 解析北向负载板回码并根据电压、电流反馈驱动Sink状态机
输入参数: frame_data:完整北向回码 idx:当前通道 pSW:通道控制结构体
pNOR:北向总控结构体
输出参数: 更新VZ、VF、低压计数、无电流计数及sink.work_mode
返回说明: -
其它说明: 电压连续低于门槛进入LOW;电压达到目标附近进入RUNING;
运行电流连续过低时退回WAIT重新判断
*****************************************************************/
void chrg_sink_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
struct chrg_switch_t *pSW, struct chrg_north_t *pNOR)
{
@@ -163,8 +182,12 @@ void chrg_sink_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
/*****************************************************************
函数名称: chrg_north_handle_Seting_Volt
功能描述: 处理设置电压/电流命令,解析命令数据并执行相应操作
****************************************************/
函数描述: 根据当前通道角色分发21字节电压电流回码
输入参数: frame_data:完整北向回码 frame_len:回码长度
输出参数: 调用Source或Sink解析函数更新当前通道状态
返回说明: -
其它说明: 当前通道由chrgnorth.idx确定,角色由pSW->id确定
*****************************************************************/
rt_uint8_t change_number = 0;
static void chrg_north_handle_Seting_Volt(rt_uint8_t *frame_data, rt_uint16_t frame_len)
{
@@ -198,7 +221,7 @@ struct chrg_north_t chrgnorth = {
.source = { // 电源侧参数初始化
.On_Flag = 0, // 启动标志初始关闭
.Set_CV_Flag = 1, // 启停控制初始置1
.work_mode = SOURCE_WORK_WAIT,
.work_mode = SOURCE_WORK_WAIT, // 上电保持等待,禁止自动执行Source INIT
}, // 关键:补充逗号分隔source和sink
.sink = {
.protocol = 0xFE,
@@ -216,7 +239,7 @@ struct chrg_north_t chrgnorth = {
.source = {
.On_Flag = 0,
.Set_CV_Flag = 1,
.work_mode = SOURCE_WORK_WAIT,
.work_mode = SOURCE_WORK_WAIT, // 上电保持等待,禁止自动执行Source INIT
},
.sink = {
.protocol = 0xFE,
@@ -233,7 +256,7 @@ struct chrg_north_t chrgnorth = {
.source = {
.On_Flag = 0,
.Set_CV_Flag = 1,
.work_mode = SOURCE_WORK_WAIT,
.work_mode = SOURCE_WORK_WAIT, // 上电保持等待,禁止自动执行Source INIT
},
.sink = {
.protocol = 0xFE,
@@ -250,7 +273,7 @@ struct chrg_north_t chrgnorth = {
.source = {
.On_Flag = 0,
.Set_CV_Flag = 1,
.work_mode = SOURCE_WORK_WAIT,
.work_mode = SOURCE_WORK_WAIT, // 上电保持等待,禁止自动执行Source INIT
},
.sink = {
.protocol = 0xFE,
@@ -393,6 +416,14 @@ int a_number;
#define NORTH_FRAME_TIMEOUT_MS 100
/*****************************************************************
函数名称: chrg_north_frame_reset
函数描述: 复位北向帧接收状态并按需释放未完成帧内存
输入参数: pFrame:帧接收上下文 release:是否释放pMB及payload
输出参数: 清零接收长度、帧头标志、超时计时和消息指针
返回说明: -
其它说明: 完整帧已移交邮箱时release应为RT_FALSE,异常中止时为RT_TRUE
*****************************************************************/
static void chrg_north_frame_reset(struct pickup_info_t *pFrame, rt_bool_t release)
{
if (RT_NULL == pFrame) {
@@ -413,6 +444,14 @@ static void chrg_north_frame_reset(struct pickup_info_t *pFrame, rt_bool_t relea
pFrame->pMB = RT_NULL;
}
/*****************************************************************
函数名称: chrg_north_frame_append
函数描述: 从北向环形缓冲区追加数据到当前未完成帧
输入参数: rb:北向接收环形缓冲区 pFrame:帧接收上下文
输出参数: 更新已接收长度和最后接收时间
返回说明: 1:完整帧接收完成 0:仍需等待数据 <0:参数或状态异常
其它说明: 单次仅复制当前帧剩余长度,避免读取下一帧数据
*****************************************************************/
static int chrg_north_frame_append(struct rt_ringbuffer *rb,
struct pickup_info_t *pFrame)
{
@@ -444,6 +483,14 @@ static int chrg_north_frame_append(struct rt_ringbuffer *rb,
return (pFrame->length == (rt_size_t)pFrame->len_msg) ? 1 : 0;
}
/*****************************************************************
函数名称: chrg_north_frame_dispatch
函数描述: 分发已经组装完成的北向数据帧
输入参数: pFrame:包含完整pMB消息的帧接收上下文
输出参数: 21字节回码进入电压解析,同时完整消息发送到北向轮询邮箱
返回说明: -
其它说明: 消息所有权移交邮箱后只复位上下文,不在此处释放pMB
*****************************************************************/
static void chrg_north_frame_dispatch(struct pickup_info_t *pFrame)
{
struct mb_msg_t *pMB = pFrame->pMB;