修复了短路测试下由于发送运行时间太短导致1~2持续抢占南向发送

修复了V_ON在运行状态下不能发送新的设置值的问题

chore: 更新版本号并新增运行中修改V_On功能

1. 更新多个文件的版本号至V1.1.14~V1.1.15
2. 新增Sink通道运行中修改V_On时下发Eload_Start_V_ON逻辑
3. 新增Sink电压判定可选来源配置，支持协议板或功率板电压
4. 优化chrg_sink_parse函数，新增实际电压读取和序号更新
5. 调整短路测试补发周期至50ms，移除冗余宏定义
6. 更新修改日志文档，新增V1.1.15版本变更记录
7. 新增协议板YMODEM升级文档

apps/chrg/applications/thread/chrg_comm.c

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_comm.c
 完成日期   : 
-当前版本号 : V1.1.10
+当前版本号 : V1.1.15
 主要功能   : 实现对外通讯协议 MODBUS 服务端，以独立线程等待处理响应请求数据。
 版本历史   : 创建原始版本
 说明      : 
@@ -27,7 +27,7 @@
 #include "stm32f4xx_hal.h"
 
 #define HOLD_REG_FIRMWARE_VERSION 0x0300U /* 协议板固件版本，只读 */
-#define CHRG_FIRMWARE_VERSION     0x011AU /* 当前协议板版本：V1.1.10 */
+#define CHRG_FIRMWARE_VERSION     0x011FU /* 当前协议板版本：V1.1.15 */
 
 rt_uint8_t ucDiscInBuf[(TOTAL_DISC_REGS+BITS_UCHAR-1)/BITS_UCHAR];
 rt_uint8_t ucCoilBuf[(TOTAL_COIL_REGS+BITS_UCHAR-1)/BITS_UCHAR];
@@ -618,7 +618,7 @@ eMBException funcReadHoldingRegister (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
 
 	/*
 	 * 协议板版本号使用独立的只读地址0x0300，不占用现有通道保持寄存器空间。
-	 * 当前版本V1.1.10编码为0x011A，Modbus响应按高字节在前返回01 1A。
+	 * 当前版本V1.1.15编码为0x011F，Modbus响应按高字节在前返回01 1F。
 	 * 该特殊地址只支持一次读取一个寄存器，避免与普通连续寄存器混用。
 	 */
 	if (regAddress == HOLD_REG_FIRMWARE_VERSION) {
@@ -2563,6 +2563,7 @@ static eMBException chrg_comm_apply_sink_effect(rt_uint8_t ch,
 	rt_bool_t protocol_voltage_only;
 	rt_bool_t protocol_current_change;
 	rt_bool_t protocol_data_changed;
+	rt_bool_t von_changed;
 	rt_uint8_t curr_test;
 	rt_uint8_t curr_test_old;
 	rt_uint8_t old_cv_mode = pReal->CV_mode;
@@ -2587,6 +2588,17 @@ static eMBException chrg_comm_apply_sink_effect(rt_uint8_t ch,
 		!full_handshake_change;
 	protocol_voltage_only = diff_info.pro_voltage_changed &&
 		!full_handshake_change && !protocol_current_change;
+	von_changed = (pReal->sink.volt_on != pShadow->sink.volt_on);
+	if ((sink_work == 0x01) && (old_on_work == 1U) && von_changed) {
+		rt_uint16_t reg = Eload_Start_V_ON;
+		rt_uint16_t val = (pShadow->sink.volt_on <= 500U) ?
+			500U : pShadow->sink.volt_on;
+
+		if (chrg_sou_com_batch_submit((eIDX_SOU_CH)ch, &reg,
+			&val, 1U) != 0) {
+			return MB_EX_SLAVE_BUSY;
+		}
+	}
 	rt_memcpy(pReal, pShadow, sizeof(struct chrg_switch_t));
 
 	if (sink_work == 0x01) {

apps/chrg/applications/thread/chrg_comm.h

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_comm.h
 完成日期   : 
-当前版本号 : V1.1.10
+当前版本号 : V1.1.15
 主要功能   : 实现对外通讯协议 MODBUS 服务端，以独立线程等待处理响应请求数据。
 版本历史   : 创建原始版本
 说明      : 

apps/chrg/applications/thread/chrg_north.c

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_north.c
 完成日期   : 
-当前版本号 : V1.1.10
+当前版本号 : V1.1.14
 主要功能   : 实现北向通信交互，包括接收命令解析，发送请求命令，切换通路。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -212,13 +212,13 @@ void chrg_source_setting(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
 
 /*****************************************************************
 函数名称： chrg_sink_parse
-函数描述： 解析北向负载板0x20回码，提取D+/D-电压到VZ/VF
+函数描述： 解析北向负载板0x20回码，提取实际电压和D+/D-电压
 输入参数： frame_data:完整北向回码 idx:当前通道 pSW:通道控制结构体
           pNOR:北向总控结构体
-输出参数： 更新pSW->VZ(D+)、pSW->VF(D-)
+输出参数： 更新pSW->Sink_voltage、VZ(D+)、VF(D-)
 返回说明： -
-其它说明： Sink电压状态机判定已迁移至chrg_sink_volt_judge，
-          由北向轮询线程基于eload.c更新的Now_voltage驱动
+其它说明： Sink电压状态机可通过SINK_VON_VOLTAGE_SOURCE选择使用本回码
+          实际电压或功率板实际电压
 *****************************************************************/
 void chrg_sink_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx, 
                        struct chrg_switch_t *pSW, struct chrg_north_t *pNOR)
@@ -227,6 +227,9 @@ void chrg_sink_parse(rt_uint8_t *frame_data, eIDX_SOU_CH idx,
 		return;
 	}
 
+	pSW->Sink_voltage = (rt_uint16_t)(((frame_data[4] << 8) |
+		frame_data[5]) * 10U);
+	pSW->Sink_voltage_seq++;
 	pSW->VZ = ((frame_data[14] << 8) | frame_data[15]);
 	pSW->VF = ((frame_data[16] << 8) | frame_data[17]);
 

apps/chrg/applications/thread/chrg_north.h

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_north.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.14
 主要功能   : 实现北向通信交互，包括接收命令解析，发送请求命令，切换通路。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -16,6 +16,20 @@
 #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  10U
+
 #define THR_NAME_NORTH		"thr.nor"
 #define DEV_NAME_NORTH		"uart3"
 
@@ -23,10 +37,10 @@
 #define MIN_FRAME_LENGTH	(5)			// 帧最短5字节
 #define WORK_MIN_VOLT			500			// 工作电压下限，单位mV
 #define NORTH_FRAME_DEBUG      0x00    // 北向UART原始收发帧
-#define NORTH_SOURCE_DEBUG     0x01    // Source协议解析及组帧
-#define NORTH_SINK_DEBUG       0x01    // Sink协议解析及组帧
+#define NORTH_SOURCE_DEBUG     0x00    // Source协议解析及组帧
+#define NORTH_SINK_DEBUG       0x00    // Sink协议解析及组帧
 #define SOUTH_FRAME_DEBUG      0x00    // 南向UART原始收发帧
-#define SOUTH_COMMAND_DEBUG    0x00    // 南向寄存器写命令
+#define SOUTH_COMMAND_DEBUG    0x01    // 南向寄存器写命令
 #define COMM_FRAME_DEBUG       0x00    // COM UART原始收发帧
 #define COMM_DEBUG             0x00    // COM寄存器读写过程
 #define COMM_TRIM_DEBUG        0x00    // COM校准参数解析
@@ -56,6 +70,8 @@ struct chrg_switch_t {
 	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;
 };

apps/chrg/applications/thread/chrg_roll_nor.c

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_roll_nor.c
 完成日期   : 
-当前版本号 : V1.1.10
+当前版本号 : V1.1.14
 主要功能   : 实现北向通信轮巡请求命令。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -1033,7 +1033,7 @@ void chrg_roll_nor_thread_entry (void *data)
 			 source_waiting = chrg_roll_nor_source_wait_process(idx, pSW);
 			 sink_waiting = chrg_roll_nor_sink_wait_process(idx, pSW);
 
-			/* 全通道Sink电压判定：使用eload实际电压Now_voltage与V_On比较，
+			/* 全通道Sink电压判定：使用配置的V_On电压源与V_On比较，
 			 * 判定后统一由chrg_sink_work执行；短路测试由该入口负责WORK_START保活。 */
 			for (i = 0; i < TOTAL_NOR_CHS; i++) {
 				struct chrg_switch_t *psw = &pNOR->sw[i];

apps/chrg/applications/thread/chrg_roll_nor.h

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_roll_nor.h
 完成日期   : 
-当前版本号 : V1.1.10
+当前版本号 : V1.1.14
 主要功能   : 实现北向通信轮巡请求命令。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 

apps/chrg/applications/thread/chrg_roll_sou.c

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_roll_sou.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.14
 主要功能   : 实现南向通信轮巡请求命令。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -26,7 +26,6 @@
 #define SOU_MUTEX_TIMEOUT_MS    100
 #define SOU_RESPONSE_TIMEOUT_MS 20
 #define SOU_COM_MAX_ATTEMPTS    3
-#define SOU_COM_BURST_MAX       10U
 #define SOU_COM_RETRY_YIELD_MS   1U
 #define SOU_REL_SWITCH_DELAY_MS 100U
 #define SOU_CHANNEL_BIT(ch)     ((rt_uint8_t)(1U << (ch)))

apps/chrg/applications/utils/chrg_sink.c

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_sink.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.14
 主要功能   : 北向数据sink请求数据填充及发送。
 版本历史   : 创建原始版本
 说明      : 
@@ -41,6 +41,10 @@ static rt_tick_t g_sink_unload_query_tick[TOTAL_SOU_CHS] = {0};
 static rt_uint8_t g_sink_unload_confirm_count[TOTAL_SOU_CHS] = {0};
 /* 记录各通道短路测试最近一次WORK_START的发送时间。 */
 static rt_tick_t g_sink_short_start_tick[TOTAL_SOU_CHS] = {0};
+#if SINK_VON_VOLTAGE_SOURCE == SINK_VON_VOLTAGE_FROM_PROTOCOL
+/* 只消费新的协议板0x20电压回码，避免同一帧重复计入稳定次数。 */
+static rt_uint32_t g_sink_von_voltage_seq[TOTAL_SOU_CHS] = {0};
+#endif
 
 enum {
 	SINK_UNLOAD_NEXT_RUNNING = 0,
@@ -263,9 +267,8 @@ static int chrg_sink_work_init(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
 		regs[0] = REG_REL_ON;						vals[0] = ALL_REL_OFF;
 		regs[1] = REG_REL_ON;						vals[1] = FU_REL_ON;
 		regs[2] = REG_CURRENT_OUT + 1;	vals[2] = 0;
-		regs[3] = REG_MODE;						vals[3] = pSW->CV_mode;
-		regs[4] = Eload_Start_V_ON;			vals[4] =
-			(pSW->sink.volt_on <= 500) ? 500 : pSW->sink.volt_on;
+		regs[3] = REG_MODE;							vals[3] = pSW->CV_mode;
+		regs[4] = Eload_Start_V_ON;			vals[4] = (pSW->sink.volt_on <= 500) ? 500 : pSW->sink.volt_on;
 		regs[5] = ModbusRTU_ShortTest_CMD_MODE_FLAG;
 		vals[5] = ModbusRTU_DYNA_CMD_MODE_STOP;
 		count = 6U;
@@ -875,9 +878,18 @@ static rt_uint8_t chrg_sink_voltage_confirm_count(rt_uint16_t target_volt_mv)
 		SINK_VOLT_CONFIRM_5V_COUNT : SINK_VOLT_CONFIRM_NORMAL_COUNT;
 }
 
+static rt_uint16_t chrg_sink_von_voltage_get(const struct chrg_switch_t *pSW)
+{
+#if SINK_VON_VOLTAGE_SOURCE == SINK_VON_VOLTAGE_FROM_PROTOCOL
+	return pSW->Sink_voltage;
+#else
+	return pSW->Now_voltage;
+#endif
+}
+
 /*****************************************************************
 函数名称： chrg_sink_volt_judge
-函数描述： 使用南向功率板实际电压Now_voltage与V_On比较，驱动负载进入RUNING
+函数描述： 使用配置的V_On电压源与V_On比较，控制负载启停
 输入参数： idx:南向通道 pSW:通道控制结构体
 输出参数： 更新sink.work_mode并调用chrg_sink_work
 返回说明： 0:处理完成 <0:参数错误
@@ -890,20 +902,31 @@ int chrg_sink_volt_judge(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
 	static rt_uint8_t volt_set_ok[TOTAL_SOU_CHS] = {0};
 	static rt_uint8_t volt_stable_count[TOTAL_SOU_CHS] = {0};
 	static rt_tick_t running_start_tick[TOTAL_SOU_CHS] = {0};
+	rt_uint16_t von_voltage;
 
 	if ((idx >= TOTAL_SOU_CHS) || (pSW == RT_NULL)) {
 		return -1;
 	}
+#if SINK_VON_VOLTAGE_SOURCE == SINK_VON_VOLTAGE_FROM_PROTOCOL
+	if (pSW->Sink_voltage_seq == g_sink_von_voltage_seq[idx]) {
+		return chrg_sink_work(idx, pSW);
+	}
+	g_sink_von_voltage_seq[idx] = pSW->Sink_voltage_seq;
+#endif
+	von_voltage = chrg_sink_von_voltage_get(pSW);
 	stable_confirm_count = chrg_sink_voltage_confirm_count(
 		pSW->sink.pro_loadv);
 
 	if ((pSW->sink.On_work == 1) && (pSW->sink.test.test_mode == 0)) {
-		if (pSW->Now_voltage <= WORK_MIN_VOLT) {
+		if (von_voltage <= WORK_MIN_VOLT) {
 			volt_stable_count[idx] = 0;
 			if (volt_set_ok[idx] == 1 && ++volt_low[idx] >= 50) {
 				volt_set_ok[idx] = 0;
 				no_curr[idx] = 0;
 			}
+			if (pSW->sink.work_mode == SINK_WORK_RUNING) {
+				return chrg_sink_work_load_stop(idx, pSW);
+			}
 		} else {
 			volt_low[idx] = 0;
 			volt_set_ok[idx] = 1;
@@ -918,7 +941,7 @@ int chrg_sink_volt_judge(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
 				/* 掉电安全批次完成前，不得进入RUNING。 */
 				volt_stable_count[idx] = 0;
 				no_curr[idx] = 0;
-			} else if (pSW->Now_voltage > pSW->sink.volt_on) {
+			} else if (von_voltage > pSW->sink.volt_on) {
 				if ((pSW->sink.work_mode != SINK_WORK_RUNING) &&
 					(pSW->sink.work_mode != SINK_WORK_LOAD_STANDBY)) {
 					if (volt_stable_count[idx] < stable_confirm_count) {
@@ -934,6 +957,10 @@ int chrg_sink_volt_judge(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
 				} else if (pSW->sink.work_mode == SINK_WORK_LOAD_STANDBY) {
 					volt_stable_count[idx] = 0;
 					no_curr[idx] = 0;
+					if (chrg_sink_load_should_start(pSW)) {
+						/* 因输入电压不足停止带载后，电压恢复时重新进入稳定确认。 */
+						pSW->sink.work_mode = SINK_WORK_WAIT;
+					}
 				} else if ((pSW->Now_current > 200) || (pSW->sink.loadc < 200)) {
 					volt_stable_count[idx] = 0;
 					no_curr[idx] = 0;
@@ -948,6 +975,10 @@ int chrg_sink_volt_judge(eIDX_SOU_CH idx, struct chrg_switch_t *pSW)
 			} else {
 				volt_stable_count[idx] = 0;
 				no_curr[idx] = 0;
+				/* 配置电压源低于负载设置的V_On时，立即停止电子负载。 */
+				if (pSW->sink.work_mode == SINK_WORK_RUNING) {
+					return chrg_sink_work_load_stop(idx, pSW);
+				}
 			}
 		}
 	} else {

apps/chrg/applications/utils/chrg_sink.h

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_sink.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.14
 主要功能   : 北向数据sink请求数据填充及发送，命令字定义。
 版本历史   : 创建原始版本
 说明      : 
@@ -22,7 +22,7 @@ struct chrg_switch_t;
 #define SINK_TEST_OCP   2
 #define SINK_TEST_DYNA  3
 /* 短路测试期间按该周期补发WORK_START，防止功率板因超时停止。 */
-#define SINK_SHORT_START_INTERVAL_MS  30U
+#define SINK_SHORT_START_INTERVAL_MS  50U
 //短路测试结构体
 struct test_short {
     rt_uint16_t         hold_time;           // 短路测试时间

apps/chrg/applications/utils/chrg_source.c

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_source.c
 完成日期   : 
-当前版本号 : V1.1.10
+当前版本号 : V1.1.14
 主要功能   : 北向数据source请求数据填充及发送。
 版本历史   : 创建原始版本
 说明      : 

apps/chrg/applications/utils/chrg_source.h

@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_source.c
 完成日期   : 
-当前版本号 : V1.1.10
+当前版本号 : V1.1.14
 主要功能   : 北向数据source请求数据填充及发送，命令字定义。
 版本历史   : 创建原始版本
 说明      : 

apps/chrg/codex_von_verify.log

@@ -0,0 +1,9 @@
+*** Using Compiler 'V6.16', folder: 'D:\keil mdk 2\ARM\ARMCLANG\Bin'
+Build target 'chrg'
+compiling chrg_comm.c...
+linking...
+Program Size: Code=151160 RO-data=15928 RW-data=9356 ZI-data=16036  
+FromELF: creating hex file...
+After Build - User command #1: fromelf --bin  .\build\keil\Obj\chrg.axf -o build/chrg.bin
+".\build\keil\Obj\chrg.axf" - 0 Error(s), 0 Warning(s).
+Build Time Elapsed:  00:00:02

docs/修改日志.md

@@ -1,5 +1,17 @@
 # 修改日志
 
+## V1.1.15 - 2026-09-09
+
+### 运行中 V_On 更新
+
+- Sink 通道处于运行状态时，参数生效检测到 `V_On` 改变，会向对应功率板下发 `Eload_Start_V_ON`。
+- 下发值保持既有下限：小于或等于 `500mV` 时按 `500mV` 发送。
+- 南向队列提交失败时，本次参数生效返回忙，协议板运行参数保持原 `V_On`。
+
+### 验证记录
+
+- 待硬件验证：运行中修改 `SINK_REG_VON_VOLT (0x0B)` 并执行参数生效，确认功率板收到 `Eload_Start_V_ON` 新值。
+
 ## V1.1.9 - 2026-08-25
 
 ### Source 复位后的初始化流程

docs/协议板Boot_YMODEM上位机实现规则.md

@@ -0,0 +1,208 @@
+# 协议板 Boot：YMODEM 上位机实现规则
+
+## 1. 适用范围
+
+本文适用于 **PC 上位机通过 USART1 直连协议板 Boot**，传输协议为 YMODEM + CRC16。
+
+不适用于“协议板 App 通过南向 Modbus `0x20` 转发功率板 Boot”的链路；该链路的报文封装、应答和状态机需要独立实现。
+
+## 2. 基本要求
+
+| 项目 | 规则 |
+| --- | --- |
+| 串口 | USART1，115200 bps，8N1，无校验、无流控 |
+| 升级文件 | 必须发送已由现有打包工具生成的完整 `.upk` 文件 |
+| 不支持的文件 | 裸 `.bin`，以及自行封装/加密但不符合工程 UPK 格式的文件 |
+| 启动依据 | 等待 Boot 发出 ASCII `C`（`0x43`）后再开始传输 |
+| Boot 上电等待 | 首次等待主机开始约 5 秒；超时后可能跳转 App |
+| 传输中的帧间等待 | Boot 约 10 秒；上位机不得使相邻有效帧间隔达到 10 秒 |
+
+Boot 每约 1 秒发送一次 `C`。若没有收到 `C`，上位机不可直接发送 YMODEM 首帧；应提示设备未进入 Boot，或重新复位/触发其进入 Boot。
+
+## 3. YMODEM 常量与帧格式
+
+| 名称 | 值 | 含义 |
+| --- | --- | --- |
+| SOH | `0x01` | 128 字节数据包 |
+| STX | `0x02` | 1024 字节数据包 |
+| EOT | `0x04` | 数据结束 |
+| ACK | `0x06` | 接收成功 |
+| NAK | `0x15` | 接收失败/请求重发 |
+| CAN | `0x18` | 取消传输 |
+| C | `0x43` | 请求以 CRC16 模式发送 |
+
+数据包格式：
+
+```text
+Header + PacketNo + (~PacketNo) + Data + CRC16_H + CRC16_L
+```
+
+| 包类型 | Data 长度 | 总长度 |
+| --- | ---: | ---: |
+| SOH | 128 | 133 |
+| STX | 1024 | 1029 |
+
+CRC 算法必须为 **CRC-16/XMODEM**：
+
+```text
+poly=0x1021, init=0x0000, RefIn=false, RefOut=false, XorOut=0x0000
+```
+
+CRC 覆盖 `Data` 的全部固定长度字节（128 或 1024），并按 **高字节、低字节** 放在帧尾。
+
+## 4. 包序号与数据填充
+
+1. 元数据包必须使用 `SOH`，`PacketNo=0x00`，反码为 `0xFF`。
+2. 首个文件数据包使用 `PacketNo=0x01`；每得到 ACK 后序号加 1，按 8 位自然回绕。
+3. 数据包正常使用 `STX`（1024 字节）；最后一包不足 1024 字节时仍应补齐到 1024 字节，建议补 `0x1A`。
+4. Boot 校验包号、包号反码、帧长度与 CRC。任一校验失败会回复 NAK。
+5. 收到 NAK 时，必须重发**原完整帧**，包号不得递增。该 Boot 不将“前一帧重复包”当作成功帧，因此不能依赖重复包自动 ACK。
+
+## 5. 元数据包规则
+
+第一个包固定是包号 0 的 SOH 包，128 字节 Data 的内容为：
+
+```text
+ASCII 文件名 + 0x00 + ASCII 十进制文件大小 + 0x00 + 其余补 0x00
+```
+
+示例（文件名仅用于协议描述，实际可使用真实 `.upk` 文件名）：
+
+```text
+protocol_v1.2.upk\0 123456\0 [其余填 0]
+```
+
+文件大小必须是待传输 `.upk` 的实际字节数。传输结束包也是 SOH/包号 0，但其 128 字节 Data 必须全部为 `0x00`。
+
+## 6. `.upk` 文件要求
+
+Boot 在接收数据后按 UPK 格式处理，而不是把它当作裸固件。
+
+- 头部标识必须为 `UPK_IDENTIFIER=0x006B7075`（`"upk"`）。
+- UPK 头为 1 字节对齐、总计 96 字节，包含版本、目标分区、原始/包体大小、CRC 等字段。
+- 工程当前启用 AES-256-CBC 解密；上位机职责仅为原样传输既有打包工具产生的 `.upk`，无需也不得自行改变加密、CRC 或头内容。
+- Boot 根据 UPK 头确定下载与安装流程；当前配置会先写 download 分区，再更新 app 分区。
+
+## 7. 完整正常时序
+
+```text
+Boot -> PC : C                         （每秒一次，等待开始）
+PC   -> Boot: SOH, 00, FF, 元数据, CRC
+Boot -> PC : ACK
+Boot -> PC : C                         （必须等待此 C）
+
+PC   -> Boot: STX/SOH, 01, FE, 数据块, CRC
+Boot -> PC : ACK
+PC   -> Boot: STX/SOH, 02, FD, 数据块, CRC
+Boot -> PC : ACK
+...                                    （直至全部 .upk 数据发送完成）
+
+PC   -> Boot: EOT
+Boot -> PC : NAK
+PC   -> Boot: EOT
+Boot -> PC : ACK
+Boot -> PC : C
+PC   -> Boot: SOH, 00, FF, 128 字节全 0, CRC
+Boot -> PC : ACK
+
+Boot      : 校验 UPK、写 Flash、安装 App、校验 App，并可能跳转 App
+```
+
+关键点：
+
+- 元数据 ACK 后，必须等 Boot 的第二个 `C` 才能发送数据包。
+- 第一个 EOT 后，必须等 NAK；第二个 EOT 后，必须等 ACK。
+- 第二个 EOT 的 ACK 后，必须等 `C`，再发送结束空包。
+- Boot 处理擦除和 Flash 写入期间，ACK 可能延迟；PC 的单帧 ACK 等待建议设为 3～10 秒。
+
+## 8. 上位机状态机（可直接实现）
+
+```text
+WAIT_C_START
+  收到 C -> SEND_META
+
+SEND_META
+  发送包号 0 元数据 -> WAIT_META_ACK
+
+WAIT_META_ACK
+  ACK -> WAIT_C_DATA
+  NAK/超时 -> 重发元数据
+
+WAIT_C_DATA
+  C -> SEND_DATA(包号=1)
+
+SEND_DATA
+  发送当前数据包 -> WAIT_DATA_ACK
+
+WAIT_DATA_ACK
+  ACK -> 若还有数据：包号+1，SEND_DATA；否则 SEND_EOT_1
+  NAK/超时 -> 重发当前数据包
+
+SEND_EOT_1
+  发送 EOT -> WAIT_EOT_NAK
+
+WAIT_EOT_NAK
+  NAK -> SEND_EOT_2
+  超时 -> 重发 EOT（保持本状态）
+
+SEND_EOT_2
+  发送 EOT -> WAIT_EOT_ACK
+
+WAIT_EOT_ACK
+  ACK -> WAIT_C_END
+  NAK/超时 -> 重发 EOT
+
+WAIT_C_END
+  C -> SEND_END_PACKET
+
+SEND_END_PACKET
+  发送包号 0 的全 0 SOH 包 -> WAIT_END_ACK
+
+WAIT_END_ACK
+  ACK -> TRANSFER_FINISHED
+  NAK/超时 -> 重发结束空包
+```
+
+## 9. 超时、重发、取消与结果判定
+
+| 事件 | 上位机处理 |
+| --- | --- |
+| 收到 ACK | 仅推进到下一协议状态；数据包 ACK 后才递增包号 |
+| 收到 NAK | 立即重发当前完整帧，不改变包号和文件偏移 |
+| 单帧等待超时 | 重发当前完整帧；建议最多连续 3 次 |
+| 重发次数耗尽 | 发送 CAN 两次，标记升级传输失败 |
+| 收到 CAN | 立即停止，标记 Boot 取消升级 |
+| 用户取消 | 发送 CAN 两次，停止发送后续字节 |
+| 无 C | 不开始发送，提示设备未进入 Boot 或串口参数/连线错误 |
+
+Boot 对单个 CAN 会进入取消流程并回 ACK；上位机仍建议按标准发送两个 CAN，并接受可能出现的 ACK。
+
+`WAIT_*_ACK` 的建议超时为 3～10 秒，元数据后的 `WAIT_C_DATA`、结束阶段的 `WAIT_C_END` 建议为 10 秒。上位机可将串口接收设计为持续缓存并按字节解析，忽略调试文本或仅识别 `C/ACK/NAK/CAN` 控制字符，避免因分段到达造成误判。
+
+## 10. 成功判定与日志
+
+结束空包得到 ACK 仅表示 **YMODEM 文件传输完成**，不是最终“固件安装成功”的结构化回码。随后 Boot 仍需校验 `.upk`、写下载区、安装 App、校验 App。
+
+上位机应分两级显示结果：
+
+1. `传输完成`：收到结束空包 ACK。
+2. `升级确认成功`：设备重启并进入 App 后，通过应用通信读取新固件版本（推荐）或观察 Boot/App 启动日志确认。
+
+建议记录：开始时间、文件名/大小、每个包号、重试次数、控制字符、异常原因、传输完成时间和最终版本读取结果。
+
+## 11. 与功率板 Boot 转发升级的边界
+
+若上位机目标是功率板，而物理串口只连接协议板 App，则不能直接把本 YMODEM 原始字节流写到串口。需要按协议板 App 已实现/约定的 Modbus 扩展功能码 `0x20` 封装，再由 App 南向转发给功率板 Boot，并处理 App 的转发 ACK、`C`、NAK、超时和重发。
+
+本文件可作为功率板转发方案中“YMODEM 内层状态机”的依据；外层 Modbus `0x20` 帧格式和升级进入/退出控制需以 `apps/chrg/applications/thread/chrg_comm.c`、`chrg_comm.h` 的实际实现为准，不能与协议板 Boot 直连流程混用。
+
+## 12. 代码依据
+
+- `apps/boot/application/main.c`：USART1/USART2 初始化及 Boot 启动。
+- `apps/boot/application/func/transfer.c`：USART1 接收传输层。
+- `apps/boot/application/include/ymodem.h`：YMODEM 常量、包定义。
+- `apps/boot/application/func/ymodem.c`：YMODEM 状态机、C/ACK/NAK/EOT 时序和超时。
+- `apps/boot/application/func/app.c`：UPK 接收、校验、写入和安装流程。
+- `apps/boot/application/include/firmware.h`：UPK 头和分区相关定义。
+- `apps/boot/application/func/utils.c`：CRC-16/XMODEM 实现。
+- `apps/boot/application/include/app_config.h`：超时、分区和 AES 配置。