chore: 统一项目版本至V1.1.24并完善版本管理

1. 新增`apps/chrg/applications/utils/chrg_def.h`统一管理版本号，定义CHRG_VERSION相关宏与版本字符串 2. 更新所有业务源文件和头文件的文件头版本号为V1.1.24 3. 修改`chrg_comm.c`移除硬编码版本号，改用统一定义的CHRG_FIRMWARE_VERSION 4. 更新`main.c`添加版本头文件并打印应用版本字符串 5. 更新`修改日志.md`添加V1.1.24版本记录，说明版本管理规则 6. 新增编译日志记录本次版本统一构建结果 7. 补充AGENTS.md中的版本管理规范 8. 新增一批产品测试文档与彩页文件
2026-09-15 21:33:14 +08:00
parent 8327cb3500
commit 9f63dfeaf5
54 changed files with 90 additions and 43 deletions
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_fal.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 初始化片上FLASH存储驱动，参数读/写FLASH接口实现；
 升级数据包写入实现；日志写入FLASH实现。
 版本历史   : 创建原始版本
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_fal.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 提供参数读/写FLASH接口。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_gpio.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 一般性 GPIO 读写操作: 管脚设置，读取等
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_gpio.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 
 	GPIO口宏定义。
 版本历史   : 创建原始版本
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_led.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 采用系统软件定时器驱动多路GPIO 
 LED灯，实现LED等工作模式初始化，闪烁方式等的功能。
 版本历史   : 创建原始版本
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_led.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 控制LED灯工作模式。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_rel.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : sink/source 切换继电器操作。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_rel.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : sink/source 切换继电器操作。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_switch.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : SN74LV4052APW 选通操作接口。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_switch.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : SN74LV4052APW 选通操作接口。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_tmr.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 芯片内支持的高精度(us级)硬件定时器操作实现：启动、停止、回调等接口。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_tmr.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 高精度(us级)硬件定时器调用接口：启动、停止、读取时刻等接口。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_tty.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 实现串口设备创建、销毁、配置、读取数据、发送数据等接口函数。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_tty.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 串口设备调用接口：创建、销毁、配置、读取数据、发送数据等接口。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_vcom.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 实现USB虚拟串口作为控制终端。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_vcom.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 实现USB虚拟串口作为控制终端。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_wdt.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 实现芯片内部看门狗初始化以及喂狗函数。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_wdt.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 实现芯片内部看门狗初始化以及喂狗函数。
 版本历史   : 创建原始版本
 说明      : 
@@ -8,6 +8,7 @@

 #include "shell.h"
 #include "chrg_wdt.h"
+#include "chrg_def.h"

 void show_app_version (void)
 {
@@ -20,7 +21,8 @@ void show_app_version (void)
 		HAL_GetUIDw2(), HAL_GetUIDw1(), HAL_GetUIDw0());
 	rt_kprintf("================================================\r\n");
 #else
-	rt_kprintf("\tcharger control via RT-Thread v%d.%d.%d built @ %s, %s\r\n", 
+	rt_kprintf("\tcharger firmware %s via RT-Thread v%d.%d.%d built @ %s, %s\r\n",
+		CHRG_VERSION_STRING,
 		RT_VERSION_MAJOR, RT_VERSION_MINOR, RT_VERSION_PATCH, __DATE__, __TIME__);
 #endif
 }
@@ -27,7 +27,6 @@
 #include "stm32f4xx_hal.h"

 #define HOLD_REG_FIRMWARE_VERSION 0x0300U /* 协议板固件版本，只读 */
-#define CHRG_FIRMWARE_VERSION     0x0127U /* 当前协议板版本：V1.1.23 */

 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 +617,7 @@ eMBException funcReadHoldingRegister (rt_uint8_t *reqFrame, rt_uint16_t reqLen,

 	/*
 	 * 协议板版本号使用独立的只读地址0x0300，不占用现有通道保持寄存器空间。
-	 * 当前版本V1.1.23编码为0x0127，Modbus响应按高字节在前返回01 27。
+	 * 当前版本由chrg_def.h统一定义，Modbus响应按高字节在前返回。
 	 * 该特殊地址只支持一次读取一个寄存器，避免与普通连续寄存器混用。
 	 */
 	if (regAddress == HOLD_REG_FIRMWARE_VERSION) {
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_comm.h
 完成日期   : 
-当前版本号 : V1.1.21
+当前版本号 : V1.1.24
 主要功能   : 实现对外通讯协议 MODBUS 服务端，以独立线程等待处理响应请求数据。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_lcd.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 实现与显示屏交互，向屏更新数据与接收屏控制数据，以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_lcd.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 实现与显示屏交互，向屏更新数据与接收屏控制数据。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_north.c
 完成日期   : 
-当前版本号 : V1.1.14
+当前版本号 : V1.1.24
 主要功能   : 实现北向通信交互，包括接收命令解析，发送请求命令，切换通路。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_north.h
 完成日期   : 
-当前版本号 : V1.1.22
+当前版本号 : V1.1.24
 主要功能   : 实现北向通信交互，包括接收命令解析，发送请求命令，切换通路。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_roll_nor.c
 完成日期   : 
-当前版本号 : V1.1.14
+当前版本号 : V1.1.24
 主要功能   : 实现北向通信轮巡请求命令。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_roll_nor.h
 完成日期   : 
-当前版本号 : V1.1.14
+当前版本号 : V1.1.24
 主要功能   : 实现北向通信轮巡请求命令。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_roll_sou.c
 完成日期   : 
-当前版本号 : V1.1.23
+当前版本号 : V1.1.24
 主要功能   : 实现南向通信轮巡请求命令。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_roll_sou.h
 完成日期   : 
-当前版本号 : V1.1.21
+当前版本号 : V1.1.24
 主要功能   : 实现南向通信轮巡请求命令。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_south.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 实现南向通信交互，包括接收命令解析，发送请求命令，切换通路。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_south.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 实现南向通信交互，包括接收命令解析，发送请求命令，切换通路。以独立线程处理。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_thread.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 启动多个业务线程
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_thread.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 统一管理业务线程，业务线程信息定义。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_def.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 全局宏定义，常量，及结构体。
 版本历史   : 创建原始版本
 说明      : 
@@ -12,6 +12,15 @@

 #include <rtthread.h>

+/* CHRG application version. Keep this value synchronized with the changelog. */
+#define CHRG_VERSION_MAJOR       1U
+#define CHRG_VERSION_MINOR       1U
+#define CHRG_VERSION_PATCH       24U
+#define CHRG_VERSION_STRING      "V1.1.24"
+/* Modbus version encoding: major<<8 + minor<<4 + patch. */
+#define CHRG_FIRMWARE_VERSION    ((CHRG_VERSION_MAJOR << 8) + \
+	(CHRG_VERSION_MINOR << 4) + CHRG_VERSION_PATCH)
+
 /*
 * Channel polling mode:
 * 1 - multi-channel hardware, advance the polling channel index;
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_eload.c
 完成日期   : 
-当前版本号 : V1.1.22
+当前版本号 : V1.1.24
 主要功能   : 源载命令数据解析，封装，读写请求。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_eload.h
 完成日期   : 
-当前版本号 : V1.1.22
+当前版本号 : V1.1.24
 主要功能   : 源载命令数据解析，封装，读写请求，寄存器定义，数据结构定义。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_north_pkg.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 北向数据编码、解码。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_sink.c
 完成日期   : 
-当前版本号 : V1.1.23
+当前版本号 : V1.1.24
 主要功能   : 北向数据sink请求数据填充及发送，命令字定义。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_source.c
 完成日期   : 
-当前版本号 : V1.1.14
+当前版本号 : V1.1.24
 主要功能   : 北向数据source请求数据填充及发送。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_source.c
 完成日期   : 
-当前版本号 : V1.1.14
+当前版本号 : V1.1.24
 主要功能   : 北向数据source请求数据填充及发送，命令字定义。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_utils.c
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 一些通用数据封装，功能接口。
 版本历史   : 创建原始版本
 说明      : 
@@ -1,7 +1,7 @@
 /****************************************************************************
 文件名称   : chrg_utils.h
 完成日期   : 
-当前版本号 : V1.0
+当前版本号 : V1.1.24
 主要功能   : 一些通用数据封装，功能接口。
 版本历史   : 创建原始版本
 说明      : 
@@ -0,0 +1,23 @@
+*** Using Compiler 'V6.16', folder: 'D:\Program Files\Keil_v5\ARM\ARMCLANG\Bin'
+Build target 'chrg'
+compiling main.c...
+compiling chrg_switch.c...
+compiling chrg_vcom.c...
+compiling chrg_rel.c...
+compiling chrg_roll_nor.c...
+compiling chrg_north.c...
+compiling chrg_south.c...
+compiling chrg_comm.c...
+compiling chrg_roll_sou.c...
+compiling chrg_lcd.c...
+compiling chrg_thread.c...
+compiling chrg_source.c...
+compiling chrg_sink.c...
+compiling chrg_north_pkg.c...
+compiling chrg_eload.c...
+linking...
+Program Size: Code=152916 RO-data=15924 RW-data=9356 ZI-data=16188  
+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:07