Files
chrg/apps/chrg/applications/thread/chrg_north.h
T
wrh 98f887eb36 feat: 南向升级支持任意阶段退出功能
1 更新协议板固件版本至V1.1.49
2 新增SOUTH_YMODEM_EXIT_APP宏控制升级退出时是否发送跳转App帧
3 新增YMODEM_PREPARE_DELAY_MS宏,升级模式切换后等待200ms
4 修改chrg_ymodem_proxy_exit函数,支持升级任意阶段退出
5 更新chrg_comm.c、chrg_def.h及升级日志文件对应版本信息
2026-09-29 16:14:58 +08:00

214 lines
9.4 KiB
C

/****************************************************************************
文件名称 : chrg_north.h
完成日期 :
主要功能 : 实现北向通信交互,包括接收命令解析,发送请求命令,切换通路。以独立线程处理。
版本历史 : 创建原始版本
说明 :
******************************************************************************/
#ifndef __CHRG_NORTH_H__
#define __CHRG_NORTH_H__
#include <rtthread.h>
#include "chrg_source.h"
#include "chrg_tty.h"
#include "chrg_sink.h"
#include "chrg_def.h"
/* V_On启停判定电压源:切换后需重新编译固件。 */
#define SINK_VON_VOLTAGE_FROM_PROTOCOL 1U
#define SINK_VON_VOLTAGE_FROM_POWER 2U
#ifndef SINK_VON_VOLTAGE_SOURCE
#define SINK_VON_VOLTAGE_SOURCE SINK_VON_VOLTAGE_FROM_POWER
#endif
#if (SINK_VON_VOLTAGE_SOURCE != SINK_VON_VOLTAGE_FROM_PROTOCOL) && \
(SINK_VON_VOLTAGE_SOURCE != SINK_VON_VOLTAGE_FROM_POWER)
#error "Invalid SINK_VON_VOLTAGE_SOURCE"
#endif
/* 南向COM批次中单通道连续收到有效回码后的最大发送条数。 */
#define SOU_COM_BURST_MAX 2U
/* 自动停止带载后,电压恢复时需要连续确认的新P1采样帧数。 */
#define SINK_LOAD_RESTART_CONFIRM_COUNT 2U
/* 主继电器闭合后的纹波瞬态过滤参数,单位为新的P1采样帧。 */
#define RIPPLE_RELAY_IGNORE_P1_COUNT 5U
#define RIPPLE_MEDIAN_WINDOW_SIZE 3U
#define THR_NAME_NORTH "thr.nor"
#define DEV_NAME_NORTH "uart3"
#define LEN_FRAME_HEAD (4) // [帧长, 0x00, id, 命令]
#define MIN_FRAME_LENGTH (5) // 帧最短5字节
#define WORK_MIN_VOLT 500 // 工作电压下限,单位mV
#define NORTH_FRAME_DEBUG 0x00 // 北向UART原始收发帧
#define NORTH_SOURCE_DEBUG 0x00 // Source协议解析及组帧
#define NORTH_SINK_DEBUG 0x00 // Sink协议解析及组帧
#define SOUTH_FRAME_DEBUG 0x00 // 南向UART原始收发帧
#define SOUTH_COMMAND_DEBUG 0x01 // 南向寄存器写命令
#define SOUTH_YMODEM_DEBUG 0x01 // 南向YMODEM回码
#define SOUTH_YMODEM_EXIT_APP 0x01 // 升级退出时发送南向跳转App帧
#define COMM_FRAME_DEBUG 0x00 // COM UART原始收发帧
#define COMM_DEBUG 0x00 // COM寄存器读写过程
#define COMM_TRIM_DEBUG 0x00 // COM校准参数解析
#define LCD_OPEN 0x01 // 0为关闭屏幕显示 1为打开
#define TRIM_NORTH 0x00 // 0 = 关闭, 1 = 开启
#define SINK_TEST_DEBUG 0x00 // 0 = 关闭,1 = 开启
// 北向4通路索引 U14 ->
typedef enum {
IDX_NOR_CH1 = IDX_CH1, // J3
IDX_NOR_CH2 = IDX_CH2, // J4
IDX_NOR_CH3 = IDX_CH3, // J9
IDX_NOR_CH4 = IDX_CH4, // J10
TOTAL_NOR_CHS
} eIDX_NOR_CH;
struct chrg_switch_t {
eIDX_ID id;
struct chrg_src_t source;
struct chrg_sink_t sink;
rt_uint8_t protoCmd; // 协议类型
rt_uint8_t sub; //状态机步骤
rt_uint8_t show_step; // 显示步骤标志位,0-各项参数,1-显示电压电流,
rt_uint8_t continue_flag;
rt_uint8_t CV_mode; //恒压恒流
rt_uint8_t change_flag; //正在调整功率标志位
rt_uint16_t Now_voltage; // 当前电压 mV
rt_uint16_t Now_current; // 当前电流 mA
rt_uint16_t Sink_voltage; // 协议板0x20回码的实际电压 mV
rt_uint32_t Sink_voltage_seq; // 协议板实际电压有效回码序号
rt_uint16_t VZ;
rt_uint16_t VF;
};
//校准结构体
//#define ModbusRTU_Trim_Start 0x01 //进入校准模式
//#defin ModbusRTU_Trim_Stop 0x02 //退出校准模式
#define ModbusRTU_Volt_CAL_K_H 0x2C //2C~2D 电压校准K值,被放大Q16倍,再移动16回去;使用两个字节
#define ModbusRTU_Volt_CAL_K_L 0x2D
#define ModbusRTU_Volt_CAL_B 0x2E //2E 电压校准B值
#define ModbusRTU_Current_CAL_K_H 0x2F //2F-30 电流校准K值
#define ModbusRTU_Current_CAL_K_L 0x30
#define ModbusRTU_Current_CAL_B 0x31 //31 电流校准B值
#define ModbusRTU_SourceCurrent_CAL_K_H 0x32 //32-33 电流校准K值
#define ModbusRTU_SourceCurrent_CAL_K_L 0x33
#define ModbusRTU_SourceCurrent_CAL_B 0x34 //34 电流校准B值
#define ModbusRTU_Trim_Zero_CAL 0x35 //35 校准零点,写入后会将电压电流都校准到0,读取时会返回当前的零点值
#define ModbusRTU_Trim_CRC_CAL 0x36 //36 校准CRC校验,写入后会将之前的校准数据生效,读取时会返回当前的CRC校验值
#define ModbusRTU_CAL_WriteEnable_ADD 0x37 //使能写入FLASH的地址
#define ModbusRTU_CAL_WriteValue 0x4361 //写入FALSH的魔数
#define ModbusRTU_CAL_WriteRecovery 0x38 //使能写入出厂数据区域;0x5763
#define ModbusRTU_CAL_WriteRecovery_Value 0x5763 //写入FALSH的魔数
#define ModbusRTU_CAL_ReadRecovery 0x39 //使能读出;将出厂数据读到当前的bank中,并更新6个参数
#define MODE_VOLT_CAL 0x01
#define MODE_CURR_CAL 0x02
#define MODE_SOURCE_CURR_CAL 0x03
#define MODE_ZERO_CAL 0x04
struct chrg_trim {
rt_uint16_t trim_volt_k_H; // 校准电压值高16位 mV
rt_uint16_t trim_volt_k_L; // 校准电压值低16位 mV
rt_int16_t trim_volt_b; // 校准电压值b mV
rt_uint16_t trim_curr_k_H; // 校准电流值高16位 mA
rt_uint16_t trim_curr_k_L; // 校准电流值低16位 mA
rt_int16_t trim_curr_b; // 校准电流值b mA
rt_uint16_t trim_source_curr_k_H; // 校准电源电流值高16位 mA
rt_uint16_t trim_source_curr_k_L; // 校准电源电流值低16位 mA
rt_int16_t trim_source_curr_b; // 校准电源电流值b mA
rt_int16_t trim_zero; // 校准飘零值 mV/mA
rt_uint8_t trim_mode; // 校准模式, 0-默认值,1-校准电压,2-校准电流,3-校准电源电流
rt_uint8_t trim_enable_flag; //0就是默认写用户区,1则写出场数据区
};
struct chrg_north_t {
const char *devname;
struct chrg_tty_t *tty;
struct rt_ringbuffer *rb;
struct pickup_info_t frame;
rt_uint32_t config_version[TOTAL_NOR_CHS]; // COM配置版本,用于识别等待期间到达的旧回码
/* 每个物理通道独立递增;仅在协议板内部标识一次北向请求。 */
volatile rt_uint32_t transaction_id[TOTAL_NOR_CHS];
/* 通道切换时由发送线程递增请求号,接收线程完成清理后写回确认号。 */
volatile rt_uint32_t rx_reset_request;
volatile rt_uint32_t rx_reset_ack;
struct chrg_trim trim[TOTAL_NOR_CHS];
rt_uint8_t rx_buf[SIZE_BUF_TTY];
rt_uint8_t free_flag;
rt_uint8_t enable[TOTAL_NOR_CHS]; // 通路使能
rt_uint8_t manual; // 手动插入命令
eIDX_NOR_CH idx; // 当前通路
struct chrg_switch_t sw[TOTAL_NOR_CHS];
};
extern struct chrg_north_t chrgnorth;
/*****************************************************************
函数名称: chrg_source_parse
函数描述: 解析Source的0x20电压电流回码并驱动电源状态机
输入参数: frame_data:已通过CRC校验的完整回码 idx:对应通道
pSW:通道控制结构体 pNOR:北向控制结构体
输出参数: 更新Source目标电压、电流和工作状态
返回说明: 0:回码正常 <0:参数错误、Source切换错误或功率命令提交失败
其它说明: 仅由北向轮询线程在确认回码角色、命令和通道匹配后调用
*****************************************************************/
extern int chrg_source_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
struct chrg_switch_t *pSW, struct chrg_north_t *pNOR);
/*****************************************************************
函数名称: chrg_sink_parse
函数描述: 解析Sink的0x20电压电流回码并驱动负载状态机
输入参数: frame_data:已通过CRC校验的完整回码 idx:对应通道
pSW:通道控制结构体 pNOR:北向控制结构体
输出参数: 更新Sink协议量测值和工作状态
返回说明: -
其它说明: 仅由北向轮询线程在确认回码角色、命令和通道匹配后调用
*****************************************************************/
extern void chrg_sink_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
struct chrg_switch_t *pSW, struct chrg_north_t *pNOR);
/*****************************************************************
函数名称: chrg_north_switch
函数描述: 北向通道选择
输入参数: ch: 北向通道
输出参数: -
返回说明: <0: 错误
其它说明: -
*****************************************************************/
extern int chrg_north_switch (eIDX_NOR_CH ch);
/* 物理通道切换后清理旧接收数据并建立新事务,返回0表示准备失败。 */
extern rt_uint32_t chrg_north_request_begin(eIDX_NOR_CH ch);
/*****************************************************************
函数名称: chrg_north_send
函数描述: 北向通道数据发送
输入参数: *data: 数据 length: 数据长度
输出参数: -
返回说明: <0: 错误 >0:发送数据长度
其它说明: -
*****************************************************************/
extern int chrg_north_send (rt_uint8_t *data, rt_size_t length);
/*****************************************************************
函数名称: chrg_north_thread_entry
函数描述: 北向通道数据接收线程体
输入参数: *data: 本线程信息
输出参数: -
返回说明: -
其它说明: -
*****************************************************************/
extern void chrg_north_thread_entry (void *data);
extern rt_uint8_t On_Flag2;
extern rt_bool_t Set_Pro_Flag;
#endif