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:
@@ -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;
|
||||
|
||||
Reference in New Issue
Block a user