chrg/docs/修改日志.md

修改日志

V1.1.26 - 2026-09-17

修复Sink角色往返时初始化上下文残留

• Source切回Sink时清除旧Sink初始化阶段、提交标记和延时计时；重新执行清短路及继电器等完整初始化，避免角色切换回码被误判为旧初始化成功。
• 应用版本更新为 V1.1.26，对外固件版本寄存器 0x0300 为 0x012A；Bootloader不变。

V1.1.25 - 2026-09-17

修复Sink重复启动及退出Short时初始化卡住

• 同角色Sink参数生效只复制PC可写配置，不再覆盖实时work_mode、sub、On_work、test_mode_old及量测数据。
• 初始化/退出Short期间，相同运行请求继续原事务，不重复取消批次；不同配置返回Modbus忙（异常码0x06），PC需等待后重新发送参数生效。停止流程未完成时也拒绝新运行请求。
• 已开始的初始化收到重复INIT时恢复到INIT_AUX_WAIT，避免被last_state去重卡住；停止和掉电保护允许抢占初始化。
• 按阶段记录初始化命令是否入队，入队失败或批次失败时重试当前阶段，禁止用上一阶段的成功结果跳过未发送的命令。
• 重复/拒绝的Sink配置不再无条件递增北向配置版本，避免连续参数生效导致有效回码被反复丢弃。
• STOP入队失败后由北向轮询继续重试，不依赖On_work或通道使能。
• 应用版本V1.1.25，对外寄存器0x0300返回0x0129；Bootloader不变。不修改Von门槛、串口超时和南向队列容量。
• 增加主机回归测试tests/sink_init（运行真实状态机及COM生效函数，模拟南向批次和时钟）。硬件仍需验证单/四通道循环启停、反复Short进入退出、通信超时恢复及停止安全性。

V1.1.24 - 2026-09-15

统一应用版本定义

• CHRG应用版本统一为 V1.1.24，版本信息集中定义在 chrg_def.h。
• 上位机读取寄存器 0x0300 返回 0x0128。
• apps/chrg 各C源文件和头文件的文件头版本统一为 V1.1.24。
• Bootloader版本保持 V1.0.0 不变。
• 后续每次修改应用代码时，必须同步更新应用版本号、对外版本编码和本修改日志。

V1.1.23 - 2026-09-11

负载初始化继电器时序调整

• 负载初始化先单独下发辅助继电器 FU_REL_ON (0x01 0x02)。
• 只有收到匹配回码后，等待 30ms 才打开北向负载继电器。
• 北向继电器打开后，再继续下发电流、模式、V_On等初始化参数。
• 辅助继电器回码失败时只重发当前初始化阶段，不提前打开北向继电器。
• 协议板版本号更新为 V1.1.23，固件版本寄存器更新为 0x0127。

待验证

• 上电初始化日志中确认先收到 01 02，约30ms后才出现北向继电器打开。
• 辅助继电器无回码时确认北向继电器保持关闭。

V1.1.22 - 2026-09-11

增加纹波滤波调试打印

• 记录每个通道主继电器闭合的 tick 和忽略帧配置。
• 打印忽略帧的序号、原始纹波值及继电器闭合后的经过时间。
• 打印实际进入滤波的帧序号、原始值、滤波值及经过时间。
• 协议板版本号更新为 V1.1.22，固件版本寄存器更新为 0x0126。
• 待验证：确认宏调整后忽略帧数量和实际进入滤波的时间同步变化。

V1.1.21 - 2026-09-11

继电器切换纹波滤波

• 主继电器闭合回码成功后，忽略 RIPPLE_RELAY_IGNORE_P1_COUNT 个新P1采样帧；当前值为 2U，可在 chrg_north.h 中调整。
• 后续纹波持续使用三点中值滤波，滤除单帧尖峰；连续异常纹波仍会正常显示。
• LCD和上位机纹波寄存器统一使用滤波后的纹波值。
• 协议板版本号更新为 V1.1.21，固件版本寄存器更新为 0x0125。

验证记录

• 待硬件验证：继电器闭合瞬间出现约500mV尖峰时，LCD和上位机不显示该尖峰；忽略2帧后再累计3帧并更新为稳定纹波。
• 待硬件验证：持续三帧以上的高纹波仍能在LCD和上位机显示。

V1.1.20 - 2026-09-10

D+/D-上位机显示单位修正

• 上位机读取各通道 D+、D- 保持寄存器时，返回值由内部原始值放大 10 倍，适配上位机按 0.001V 解析。
• LCD显示、北向回码解析及内部控制值保持原有 0.01V 单位，不受影响。
• 增加16位寄存器上限保护，放大结果超过 65535 时返回 65535。
• 协议板版本号更新为 V1.1.20，固件版本寄存器更新为 0x0124。

验证记录

• 待硬件验证：D+或D-内部值为 260 时，LCD继续显示 2.60V，上位机读取值为 2600 并显示 2.600V。

V1.1.19 - 2026-09-10

短路测试绕过 V_ON 门槛

• 短路测试启动批次增加 Eload_Start_V_ON=500mV，保证5V输入时不因用户设置的6V V_ON而拒绝短路启动。
• 短路测试期间忽略普通 V_ON 更新，保持功率板使用500mV短路启动门槛。
• 退出短路测试时由初始化流程恢复用户设定的 V_ON。
• 协议板版本号更新为 V1.1.19，固件版本寄存器更新为 0x0123。

验证记录

• 待硬件验证：V_ON=6V、输入PD5V时，短路模式仍能启动并按周期发送 WORK_START。
• 待硬件验证：退出短路模式后，功率板恢复用户设定的 V_ON。

V1.1.18 - 2026-09-10

修复 CC 切换时 V_ON 丢失

• 修复 V_ON 与 CC 线同时修改时，V_ON 命令先入队后被完整握手清队列取消的问题。
• 协议软卸载和完整握手统一按 WORK_STOP -> Eload_Start_V_ON 顺序下发。
• 握手或命令重试时会重新携带当前 V_ON，避免功率板继续使用旧阈值。
• 协议板版本号更新为 V1.1.18，固件版本寄存器更新为 0x0122。

验证记录

• 待硬件验证：同时修改 V_ON 与 CC 线，确认功率板收到 Eload_Start_V_ON。
• 待硬件验证：确认 CC 切换失败重试、协议电压切换和其他通道调度正常。

V1.1.17 - 2026-09-10

协议切换期间禁止误启动

• 将 V_On 稳定确认计数提升为通道级状态，并在协议软卸载、完整握手和自动停止时清零。
• UNLOAD_WAIT、HANDSHAKE_WAIT 以及协议配置未完成前，电压采样只推进安全流程，不允许进入 RUNING 或发送 WORK_START。
• 协议/模式配置完成并回到 IDX_GET_SINK_VC 后，才重新累计 V_On 稳定确认帧，避免停止后约40ms因旧电压再次启动。
• 协议板版本号更新为 V1.1.17，固件版本寄存器更新为 0x0121。

验证记录

• 待硬件验证：协议电压切换时确认 WORK_STOP 后、协议配置完成前不再出现 WORK_START。
• 待硬件验证：确认协议切换、自动停止恢复和三个通道并行调度不受影响。

V1.1.16 - 2026-09-09

Sink 自动停止后的恢复保护

• 新增 SINK_LOAD_RESTART_CONFIRM_COUNT，位于 chrg_north.h，当前设为 2U。
• 功率板电压作为 V_On 判定源时，仅消费新的 P1 采样帧，旧采样不再重复累计稳定次数。
• 自动停止带载时取消本通道残留南向批次，再单独下发 WORK_STOP，避免残留 WORK_START 在停止后执行。
• 自动恢复带载前必须收到连续 2 帧新的、满足 V_On 的电压采样。

验证记录

• 待硬件验证：触发 CH1 自动停止后，确认停止后 2 帧新P1到达前不再出现 WORK_START；同时确认其它通道南向命令正常调度。

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 复位后的初始化流程

• 从其他协议切换到 PD 时复位加入断开CC，D+D-，GND逻辑，等断开后再复位，再初始化
• 增加 PD 切换到非 PD 协议时的完整复位；PD/非PD跨类别切换统一执行复位。
• PD切PD、非PD切非PD以及仅切换CC线时不复位。
• 新增 SOURCE_WORK_INIT_WAIT，复位回码后重新执行 Source 初始化，并等待南向初始化批次完成。
• 加入了读取版本号

V1.1.8 - 2026-08-24

修改主题

修复了source部分的PD协议长时间运行后会出不来的问题 对应芯海3221/source版本V_1.07

Source协议复位切换

• 新增SOURCE_RESET命令：发送06 00 02 18 00 0E，校验回码05 00 02 18 16。
• 首次发送协议不复位；PD与非PD跨类别切换时先复位。
• PD切PD、非PD切非PD以及仅切换CC线时不复位。
• 删除CC_CLOSE状态及其共享等待屏障。
• 协议设置回码有效后更新last_pd_pro，避免协议尚未生效时错误判断。

验证记录

• 使用1-2，3-4测试自举例程测试俩百次正常
• git diff --check`：通过。
• 旧CC_CLOSE状态、宏和调用引用：已检查清理。
• Keil编译：按当前要求未执行，待现场烧录后验证复位回码和协议切换时序。

V1.1.7 - 2026-08-08

修改主题

并行执行Sink完整握手中的南向低电流确认与北向协议/CC设置。

主要修改

• 南向安全批次完成并收到辅助继电器回码、建立量测基线后，立即允许北向设置协议和CC线。
• 南向实际电流连续两次不大于 100mA 的确认过程与北向协议/CC设置并行执行。
• 北向进入 GET_SINK_VC 后，只有低电流确认完成且CC后的 200ms 查询保护时间到期，才发送第一条 0x20。
• 电压稳定后再发送 ALL_REL_ON -> 目标电流 -> WORK_START，防止协议协商期间提前带载。

涉及文件

• apps/chrg/applications/thread/chrg_roll_nor.c
• apps/chrg/applications/utils/chrg_sink.c
• apps/chrg/applications/utils/chrg_sink.h

编译验证

• Keil MDK 编译结果：0 Error(s), 0 Warning(s)。

V1.1.5 - 2026-08-08

修改主题

协议电压和协议电流变化统一采用软卸载重发协议流程。

主要修改

• 协议类型、CC线和协议组号变化仍进入完整握手并切换南向继电器。
• 协议电压、协议电流单独变化或同时变化时，只发送 WORK_STOP，不关闭南向继电器。
• 软卸载不再额外发送 CURRENT=0，仅通过实际电流连续两次不大于 100mA确认电子负载已停止。
• 协议重新生效且电压稳定后，由RUNNING先写入实际负载电流，再发送 WORK_START。

涉及文件

• apps/chrg/applications/thread/chrg_comm.c
• apps/chrg/applications/utils/chrg_sink.c

编译验证

• Keil MDK 编译结果：0 Error(s), 0 Warning(s)。

V1.1.4 - 2026-08-07

修改主题

调整负载低电流启动时的继电器和工作命令顺序。

主要修改

• 设定电流为 0A 或低于 100mA 时，协议握手仍正常执行。
• 电压达到目标后发送 ALL_REL_ON，确保主继电器打开。
• 主继电器打开后继续发送 WORK_STOP 和 CURRENT=0，保持电子负载不带载。
• 已经处于运行状态切换到低电流时，沿用原有停止流程，不重复切换继电器。

涉及文件

• apps/chrg/applications/utils/chrg_sink.c

编译验证

• Keil MDK 编译结果：0 Error(s), 0 Warning(s)。

V1.1.3 - 2026-08-07

修改主题

并行执行Sink南向初始化与北向握手，并优化握手查询和RUNING继电器时序。

主要修改

• INIT将 FU_REL_ON -> CURRENT=0 -> MODE -> VON 作为一个有序南向批次提交。
• 南向初始化批次成功入队后立即打开北向Sink继电器、设置 enable=1 并开始协议握手。
• SINK_WORK_INIT_AUX_WAIT改为后台监控南向初始化，不再阻塞北向协议、CC和电压查询。
• 南向初始化失败重试时保留当前北向 sub，不重复拉回协议设置起点。
• 协议或CC有效回码后，首条 0x20 等待 200ms；电压未稳定时后续每 100ms 查询一次。
• 一帧通过CRC、ID、命令和配置版本校验的电压达到目标后立即进入 RUNING，不再等待第二帧。
• 进入稳定运行后立即解除查询节流，恢复北向正常轮询速度。
• RUNING删除重复的 FU_REL_ON，调整为 ALL_REL_ON -> 目标负载值 -> WORK_START。

涉及文件

• apps/chrg/applications/utils/chrg_sink.c
• apps/chrg/applications/thread/chrg_roll_nor.c
• apps/chrg/applications/thread/chrg_north.c

编译验证

• Keil MDK 编译结果：0 Error(s), 0 Warning(s)。

硬件验证

• 待确认南向初始化命令与北向协议/CC设置并行执行且互不重置状态。
• 待确认首条和后续 0x20 间隔分别约为 200ms 和 100ms。
• 待确认进入 RUNING 时不再发送 FU_REL_ON，主继电器不会被重复断开。

V1.1.2 - 2026-08-07

修改主题

降低Sink协议握手阶段的北向电压电流查询频率。

主要修改

• 新增 SINK_HANDSHAKE_QUERY_INTERVAL_MS，设置为 200ms。
• Sink协议或CC设置收到有效回码后，不立即发送或连续快速发送 0x20 查询。
• CC路径的 200ms 从有效 0x17 回码时刻开始计时，包含原有 50ms CC稳定保护。
• 协议握手、软恢复等待和掉电恢复监控阶段的 0x20 查询按每 200ms 一次执行。
• 北向量测连续两次达到稳定条件后解除节流，RUNING 和低电流待机恢复正常查询频率。
• 仅重发协议的 IDX_SET_SINK_PD_ONLY 路径同样启动 200ms 查询等待。
• 设置协议和CC命令仍然按有效回码、超时和原有重试机制处理。

涉及文件

• apps/chrg/applications/thread/chrg_roll_nor.c

编译验证

• Keil MDK 编译结果：0 Error(s), 0 Warning(s)。

硬件验证

• 待观察协议/CC设置后 0x20 的发送间隔是否稳定为不小于 200ms。
• 待验证电压连续两次稳定后是否恢复正常量测频率。

V1.1.1 - 2026-08-07

修改主题

增加普通负载最低带载电流控制，低电流时保持协议在线但关闭电子负载。

主要修改

• 新增 SINK_LOAD_ENABLE_MIN_MA，恒流负载设定低于 100mA 时禁止发送 WORK_START。
• 最低带载门限只判断南向负载电流 loadc，不影响北向协议电流 pro_loadc 和协议握手。
• 首次启动或完整重握手后为低电流时，发送 WORK_STOP -> CURRENT=0 并保持主继电器关闭。
• 运行中由有效电流降至低电流时，发送 WORK_STOP -> CURRENT=0，保持协议、CC和继电器不变。
• 运行中低电流待机恢复有效电流时，只发送目标电流和 WORK_START，不重新握手或切换继电器。
• 主继电器未打开的低电流待机使用独立 SINK_WORK_LOAD_START 恢复入口，避免被 RUNING 状态去重。
• 低电流待机期间仅修改协议电压时不重复卸载，并保持原有主继电器状态语义。
• 将 COM 端运行电流跨门限判断封装为 chrg_comm_handle_sink_load_current()，避免生效分支继续膨胀。
• 北向解析将两种低电流待机状态作为稳定状态，不因实际电流为零反复进入 RUNING。
• 低电流待机恢复有效电流时，SINK_WORK_LOAD_START/SINK_WORK_LOAD_RESUME 只作为待启动标记，必须等北向实际电压稳定后才下发 WORK_START。

涉及文件

• apps/chrg/applications/utils/chrg_sink.h
• apps/chrg/applications/utils/chrg_sink.c
• apps/chrg/applications/thread/chrg_comm.c
• apps/chrg/applications/thread/chrg_north.c

编译验证

• Keil MDK 编译结果：0 Error(s), 0 Warning(s)。

硬件验证

• 待验证 20V/3A -> 20V/0A -> 20V/3A 的南向命令顺序和协议保持情况。
• 待验证首次以低于 100mA 的电流启动时，北向握手正常且南向不执行 WORK_START。

V1.1.0 - 2026-08-07

修改主题

负载启动、掉电恢复、协议重握手和协议电压软切换时序调整。

主要修改

• 负载启动时先向南向发送 FU_REL_ON，收到有效回码后才打开北向 Sink 继电器。
• 剩余的负载初始化命令在副继电器确认后入队，北向协议握手与南向初始化并行执行。
• RUNING 阶段的南向命令继续追加到同一队列，保持初始化配置、继电器、目标电流/电压和 WORK_START 的顺序。
• 掉电恢复时执行 WORK_STOP -> CURRENT=0 -> ALL_REL_OFF -> FU_REL_ON，副继电器恢复后等待输入电压重新出现。
• 掉电恢复检测到电压后重新设置协议和 CC，不能使用掉电前的电压样本直接进入 RUNING。
• 协议类型、CC、协议组号或协议电流变化进入完整重握手，关闭主副继电器后重新打开副继电器。
• 仅协议电压变化使用软卸载，只发送 WORK_STOP 和 CURRENT=0，不切换继电器。
• 软卸载恢复时只发送目标电流/电压和 WORK_START，不再发送继电器命令。
• 保留连续两次实际电流不大于 100mA 的安全确认，以及连续两次稳定电压确认。
• 暂时保持南向主副继电器之间的固定延时为屏蔽状态。

涉及文件

• apps/chrg/applications/utils/chrg_sink.h
• apps/chrg/applications/utils/chrg_sink.c
• apps/chrg/applications/thread/chrg_comm.c
• apps/chrg/applications/thread/chrg_roll_nor.c
• apps/chrg/applications/thread/chrg_north.c

编译验证

• Keil MDK 编译结果：0 Error(s), 0 Warning(s)。
• 尚未完成硬件验证，需重点观察南向命令顺序、北向协议握手时刻、掉电恢复和协议电压软切换。

后续记录格式

后续每次修改按以下格式追加：

## Vx.y.z - YYYY-MM-DD

### 修改主题
### 主要修改
### 涉及文件
### 编译验证
### 硬件验证