chore: 整理代码并更新文档
1. 新增并替换通信协议文档,删除旧版V2.0协议文档 2. 重构充电源逻辑,移除Set_CV_Flag相关变量和代码 3. 优化充电源关闭流程,修正寄存器配置逻辑 4. 完善Modbus输入寄存器回调和功能码处理逻辑 5. 调整输入寄存器映射表,简化寄存器定义 6. 为USB设备队列内存添加对齐宏定义 7. 新增南向电源Modbus寄存器头文档
This commit is contained in:
@@ -28,100 +28,133 @@
|
||||
#define SOURCE_VOLT_RETRY_FRAMES 3U
|
||||
|
||||
/*****************************************************************
|
||||
函数名称: chrg_source_standard_output
|
||||
功能描述: 南向功率源标准输出控制函数
|
||||
函数描述: 根据CV标志位,分别设置电源输出电压或输出电流,实现标准模式下的恒压/恒流输出
|
||||
输入参数:
|
||||
idx :功率通道编号
|
||||
pSW :北向通道控制结构体指针,包含电压/电流设定值、CV控制标志等参数
|
||||
输出参数:
|
||||
pSW :更新CV控制标志位
|
||||
返回说明: 无返回值
|
||||
函数名称: chrg_source_voltage_control
|
||||
函数描述: 统一处理Source目标电压、误差判断和状态机切换
|
||||
输入参数: idx:当前通道 pSW:通道控制结构体 volt_mv:目标电压(mV)
|
||||
curr_ma:目标电流(mA)
|
||||
输出参数: 更新source.vc及source.work_mode
|
||||
返回说明: 0:状态处理成功 <0:参数错误或命令提交失败
|
||||
其它说明: 目标电压变化时立即进入RUNING;实际电压与目标值的绝对误差
|
||||
小于等于200mV时进入WAIT;连续3次超过误差范围时重发
|
||||
*****************************************************************/
|
||||
void chrg_source_standard_output(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
|
||||
static int chrg_source_voltage_control(eIDX_SOU_CH idx,
|
||||
struct chrg_switch_t *pSW,
|
||||
rt_uint16_t volt_mv,
|
||||
rt_uint16_t curr_ma)
|
||||
{
|
||||
if(pSW->source.Set_CV_Flag) {
|
||||
chrg_set_sou_reg((eIDX_SOU_CH)idx, REG_VOLTAGE_OUT+1, pSW->source.max_vol);
|
||||
#if DEBUG_NORTH
|
||||
rt_kprintf("Volt_Set%d\r\n",pSW->source.vc.set_voltage);
|
||||
#endif
|
||||
pSW->source.Set_CV_Flag = 1;
|
||||
pSW->change_flag = 0;
|
||||
}
|
||||
}
|
||||
|
||||
/*****************************************************************
|
||||
函数名称: chrg_source_parse
|
||||
函数描述: 解析北向电源板电压电流回码并驱动Source状态机
|
||||
输入参数: frame_data:完整北向回码 idx:当前通道 pSW:通道控制结构体
|
||||
pNOR:北向总控结构体
|
||||
输出参数: 更新电压、电流、source.work_mode及电压重试计数
|
||||
返回说明: -
|
||||
其它说明: frame_data[4~7]为实测值,[8~11]为协议协商目标值;
|
||||
新目标立即进入RUNING;实际误差连续3帧超过200mV时重发
|
||||
*****************************************************************/
|
||||
void chrg_source_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
|
||||
struct chrg_switch_t *pSW, struct chrg_north_t *pNOR)
|
||||
{
|
||||
rt_uint16_t volt_mv;
|
||||
rt_uint16_t curr_ma;
|
||||
rt_uint16_t volt_error;
|
||||
static rt_uint16_t last_volt_mv[TOTAL_SOU_CHS] = {0};
|
||||
static rt_uint8_t last_volt_valid[TOTAL_SOU_CHS] = {0};
|
||||
static rt_uint8_t last_protocol[TOTAL_SOU_CHS] = {0};
|
||||
static rt_uint8_t volt_retry_count[TOTAL_SOU_CHS] = {0};
|
||||
rt_bool_t need_set = RT_FALSE;
|
||||
int ret;
|
||||
|
||||
if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL) ||
|
||||
(frame_data == RT_NULL)) {
|
||||
return;
|
||||
if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL)) {
|
||||
return -1;
|
||||
}
|
||||
volt_mv = (frame_data[8] << 8) | frame_data[9];
|
||||
curr_ma = (frame_data[10] << 8) | frame_data[11];
|
||||
/* 保存北向协议板返回的实测值和协商目标值。 */
|
||||
|
||||
/* 保存本次目标值,RUNING状态只使用其中的目标电压下发命令。 */
|
||||
pSW->source.vc.set_voltage = volt_mv;
|
||||
pSW->source.vc.set_current = curr_ma;
|
||||
|
||||
if (!pSW->source.On_Flag) {
|
||||
/* 关机后清除历史值,确保下次启动至少下发一次目标电压。 */
|
||||
/* 关机后清除历史缓存,下一次启动必须重新设置目标电压。 */
|
||||
last_volt_valid[idx] = 0;
|
||||
volt_retry_count[idx] = 0;
|
||||
return;
|
||||
return 0;
|
||||
}
|
||||
|
||||
/* 使用绝对误差,避免无符号减法在实际电压较小时发生下溢。 */
|
||||
/* 使用绝对误差,避免实际电压低于目标值时发生无符号下溢。 */
|
||||
volt_error = (pSW->Now_voltage >= volt_mv) ?
|
||||
(pSW->Now_voltage - volt_mv) :
|
||||
(volt_mv - pSW->Now_voltage);
|
||||
|
||||
if (!last_volt_valid[idx] || (volt_mv != last_volt_mv[idx])) {
|
||||
/* 首次设置或目标变化,立即进入RUNING下发新电压。 */
|
||||
if (!last_volt_valid[idx] ||
|
||||
(last_protocol[idx] != (rt_uint8_t)pSW->source.protocol) ||
|
||||
(volt_mv != last_volt_mv[idx])) {
|
||||
/* 首次设置、协议切换或目标变化时立即下发新电压。 */
|
||||
need_set = RT_TRUE;
|
||||
} else if (volt_error <= SOURCE_VOLT_ERROR_MV) {
|
||||
/* 实际电压已进入允许范围,清除连续失败计数。 */
|
||||
/* 实际电压误差不超过200mV即可视为设置成功。 */
|
||||
volt_retry_count[idx] = 0;
|
||||
} else {
|
||||
/* 给功率板三个反馈周期的稳定时间,避免每帧重复写电压。 */
|
||||
if (volt_retry_count[idx] < SOURCE_VOLT_RETRY_FRAMES) {
|
||||
volt_retry_count[idx]++;
|
||||
}
|
||||
|
||||
if (volt_retry_count[idx] >= SOURCE_VOLT_RETRY_FRAMES) {
|
||||
need_set = RT_TRUE;
|
||||
}
|
||||
}
|
||||
|
||||
/* 解析函数只决定状态,具体寄存器操作仍由Source状态机执行。 */
|
||||
pSW->source.work_mode = need_set ?
|
||||
SOURCE_WORK_RUNING : SOURCE_WORK_WAIT;
|
||||
|
||||
ret = chrg_source_work_state(idx, pSW);
|
||||
if ((ret == 0) && need_set) {
|
||||
/* 成功入队后更新缓存;重发成功后重新开始计算连续超差帧数。 */
|
||||
/* 只有命令成功提交后才更新缓存,失败时下一次继续重试。 */
|
||||
last_volt_mv[idx] = volt_mv;
|
||||
last_protocol[idx] = (rt_uint8_t)pSW->source.protocol;
|
||||
last_volt_valid[idx] = 1;
|
||||
volt_retry_count[idx] = 0;
|
||||
}
|
||||
|
||||
return ret;
|
||||
}
|
||||
|
||||
/*****************************************************************
|
||||
函数名称: chrg_source_standard_output
|
||||
函数描述: 使用COM配置值驱动标准协议电源输出
|
||||
输入参数: idx:当前通道 pSW:通道控制结构体
|
||||
输出参数: 更新source.vc及source.work_mode
|
||||
返回说明: 无返回值
|
||||
其它说明: 外部协议值0x20映射为PRO_NONE;本函数不解析北向协议返回
|
||||
数据,目标电压和保护电流直接使用COM配置值
|
||||
*****************************************************************/
|
||||
void chrg_source_standard_output(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
|
||||
{
|
||||
if (pSW == RT_NULL) {
|
||||
return;
|
||||
}
|
||||
|
||||
(void)chrg_source_voltage_control(idx, pSW,
|
||||
pSW->source.max_vol, pSW->source.protective_curr);
|
||||
}
|
||||
|
||||
/*****************************************************************
|
||||
函数名称: chrg_source_parse
|
||||
函数描述: 按电源协议类型处理目标电压并驱动Source状态机
|
||||
输入参数: frame_data:完整北向回码 idx:当前通道 pSW:通道控制结构体
|
||||
pNOR:北向总控结构体
|
||||
输出参数: 更新电压、电流、source.work_mode及电压重试计数
|
||||
返回说明: -
|
||||
其它说明: 标准协议不解析frame_data,直接使用COM配置值;快充协议读取
|
||||
frame_data[8~11]中的协商目标值。新目标立即进入RUNING,
|
||||
实际误差连续3帧超过200mV时重发
|
||||
*****************************************************************/
|
||||
void chrg_source_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
|
||||
struct chrg_switch_t *pSW, struct chrg_north_t *pNOR)
|
||||
{
|
||||
rt_uint16_t volt_mv;
|
||||
rt_uint16_t curr_ma;
|
||||
|
||||
if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL)) {
|
||||
return;
|
||||
}
|
||||
|
||||
/* 标准协议使用COM设定值,不读取北向协议返回帧。 */
|
||||
if (pSW->source.protocol == PRO_NONE) {
|
||||
chrg_source_standard_output(idx, pSW);
|
||||
return;
|
||||
}
|
||||
|
||||
if (frame_data == RT_NULL) {
|
||||
return;
|
||||
}
|
||||
volt_mv = (frame_data[8] << 8) | frame_data[9];
|
||||
curr_ma = (frame_data[10] << 8) | frame_data[11];
|
||||
/* 快充只负责解析北向协商结果,后续控制逻辑与标准协议共用。 */
|
||||
(void)chrg_source_voltage_control(idx, pSW, volt_mv, curr_ma);
|
||||
}
|
||||
|
||||
/*****************************************************************
|
||||
@@ -138,7 +171,7 @@ void chrg_source_setting(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
|
||||
{
|
||||
//执行输出调整
|
||||
if (pSW->source.On_Flag == 1) {
|
||||
if(pSW->source.protocol==0x00){//标准下输出设定值
|
||||
if(pSW->source.protocol == PRO_NONE){//标准下输出设定值
|
||||
chrg_source_standard_output(idx, pSW);
|
||||
}
|
||||
else{ //快充部分按协商结果输出
|
||||
@@ -258,7 +291,6 @@ struct chrg_north_t chrgnorth = {
|
||||
.id = ID_SINK, // 初始为负载模式
|
||||
.source = { // 电源侧参数初始化
|
||||
.On_Flag = 0, // 启动标志初始关闭
|
||||
.Set_CV_Flag = 1, // 启停控制初始置1
|
||||
.work_mode = SOURCE_WORK_WAIT, // 上电保持等待,禁止自动执行Source INIT
|
||||
}, // 关键:补充逗号分隔source和sink
|
||||
.sink = {
|
||||
@@ -276,7 +308,6 @@ struct chrg_north_t chrgnorth = {
|
||||
.change_flag = 0,
|
||||
.source = {
|
||||
.On_Flag = 0,
|
||||
.Set_CV_Flag = 1,
|
||||
.work_mode = SOURCE_WORK_WAIT, // 上电保持等待,禁止自动执行Source INIT
|
||||
},
|
||||
.sink = {
|
||||
@@ -293,7 +324,6 @@ struct chrg_north_t chrgnorth = {
|
||||
.change_flag = 0,
|
||||
.source = {
|
||||
.On_Flag = 0,
|
||||
.Set_CV_Flag = 1,
|
||||
.work_mode = SOURCE_WORK_WAIT, // 上电保持等待,禁止自动执行Source INIT
|
||||
},
|
||||
.sink = {
|
||||
@@ -310,7 +340,6 @@ struct chrg_north_t chrgnorth = {
|
||||
.change_flag = 0,
|
||||
.source = {
|
||||
.On_Flag = 0,
|
||||
.Set_CV_Flag = 1,
|
||||
.work_mode = SOURCE_WORK_WAIT, // 上电保持等待,禁止自动执行Source INIT
|
||||
},
|
||||
.sink = {
|
||||
|
||||
Reference in New Issue
Block a user