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.  新增一批产品测试文档与彩页文件
This commit is contained in:
yhf
2026-09-15 21:33:14 +08:00
parent 8327cb3500
commit 9f63dfeaf5
54 changed files with 90 additions and 43 deletions
+4
View File
@@ -26,3 +26,7 @@ There is no product-level automated test suite or coverage threshold. Every firm
## Commit & Pull Request Guidelines
History uses short, lowercase, imperative summaries such as `fix south ch` and `add roll thread`; keep each commit focused and avoid generated artifacts. Pull requests should describe the affected target and behavior, link the issue, list build and hardware results, and include serial logs or LCD captures for user-visible or protocol changes. Call out changes to register maps, flash layout, linker scripts, or upgrade compatibility explicitly.
## Application Versioning
Every change to `apps/chrg` application code must increment the CHRG application version. Keep `CHRG_VERSION_*`, `CHRG_VERSION_STRING`, and `CHRG_FIRMWARE_VERSION` in `applications/utils/chrg_def.h`, the `当前版本号` field in affected application source headers, and `docs/修改日志.md` synchronized. Do not change the Bootloader version unless the Bootloader itself is intentionally released.
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_fal.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 初始化片上FLASH存储驱动,参数读/写FLASH接口实现;
升级数据包写入实现;日志写入FLASH实现。
版本历史 : 创建原始版本
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_fal.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 提供参数读/写FLASH接口。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_gpio.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 一般性 GPIO 读写操作: 管脚设置,读取等
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_gpio.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 :
GPIO口宏定义。
版本历史 : 创建原始版本
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_led.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 采用系统软件定时器驱动多路GPIO
LED灯,实现LED等工作模式初始化,闪烁方式等的功能。
版本历史 : 创建原始版本
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_led.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 控制LED灯工作模式。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_rel.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : sink/source 切换继电器操作。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_rel.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : sink/source 切换继电器操作。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_switch.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : SN74LV4052APW 选通操作接口。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_switch.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : SN74LV4052APW 选通操作接口。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_tmr.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 芯片内支持的高精度(us级)硬件定时器操作实现:启动、停止、回调等接口。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_tmr.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 高精度(us级)硬件定时器调用接口:启动、停止、读取时刻等接口。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_tty.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 实现串口设备创建、销毁、配置、读取数据、发送数据等接口函数。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_tty.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 串口设备调用接口:创建、销毁、配置、读取数据、发送数据等接口。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_vcom.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 实现USB虚拟串口作为控制终端。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_vcom.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 实现USB虚拟串口作为控制终端。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_wdt.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 实现芯片内部看门狗初始化以及喂狗函数。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_wdt.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 实现芯片内部看门狗初始化以及喂狗函数。
版本历史 : 创建原始版本
说明 :
+3 -1
View File
@@ -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
}
+1 -2
View File
@@ -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 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_comm.h
完成日期 :
当前版本号 : V1.1.21
当前版本号 : V1.1.24
主要功能 : 实现对外通讯协议 MODBUS 服务端,以独立线程等待处理响应请求数据。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_lcd.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 实现与显示屏交互,向屏更新数据与接收屏控制数据,以独立线程处理。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_lcd.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 实现与显示屏交互,向屏更新数据与接收屏控制数据。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_north.c
完成日期 :
当前版本号 : V1.1.14
当前版本号 : V1.1.24
主要功能 : 实现北向通信交互,包括接收命令解析,发送请求命令,切换通路。以独立线程处理。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -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 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_south.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 实现南向通信交互,包括接收命令解析,发送请求命令,切换通路。以独立线程处理。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_south.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 实现南向通信交互,包括接收命令解析,发送请求命令,切换通路。以独立线程处理。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_thread.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 启动多个业务线程
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_thread.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 统一管理业务线程,业务线程信息定义。
版本历史 : 创建原始版本
说明 :
+10 -1
View File
@@ -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 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_eload.c
完成日期 :
当前版本号 : V1.1.22
当前版本号 : V1.1.24
主要功能 : 源载命令数据解析,封装,读写请求。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -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 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_sink.c
完成日期 :
当前版本号 : V1.1.23
当前版本号 : V1.1.24
主要功能 : 北向数据sink请求数据填充及发送,命令字定义。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_source.c
完成日期 :
当前版本号 : V1.1.14
当前版本号 : V1.1.24
主要功能 : 北向数据source请求数据填充及发送。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_source.c
完成日期 :
当前版本号 : V1.1.14
当前版本号 : V1.1.24
主要功能 : 北向数据source请求数据填充及发送,命令字定义。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_utils.c
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 一些通用数据封装,功能接口。
版本历史 : 创建原始版本
说明 :
+1 -1
View File
@@ -1,7 +1,7 @@
/****************************************************************************
文件名称 : chrg_utils.h
完成日期 :
当前版本号 : V1.0
当前版本号 : V1.1.24
主要功能 : 一些通用数据封装,功能接口。
版本历史 : 创建原始版本
说明 :
+23
View File
@@ -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
Binary file not shown.
Binary file not shown.
+10
View File
@@ -1,5 +1,15 @@
# 修改日志
## 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
### 负载初始化继电器时序调整
Binary file not shown.