wandering1/STM32F4-Base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity

docs: 错误码传播审计收口并删除该文档（E-xx 转历史编号族）

Browse Source 
本次会话先后销项与关闭：
- E-61 SD2506 清 INTAF：原实现只读取 CTR1，而按手册 ARST=0 时读操作
  不清标志，属空操作；改为读-改-写 CTR1，并按手册订正 CTR1 位宏
  （INTAF/INTDF/BLF 位置，ARST 归 CTR3）
- E-16 cfg_file：新增 CFG_FILE_MAX_NAME_LEN（段名/键名 ≤15），注册时
  拒绝超长键名；s_gen_document 两处 snprintf 改检查式；补 TC-CFG-024
  用例（主机单测 149→151 PASSED）
- E-23 TC704：PHASE7_MULTI_COUNT 8→5（并发上限 = 8 − 3 个常驻监听），
  accept 失败分支加网络代次检查（网络重建即重建监听）
- E-26（UDP）按“保留 API + 文档定案”关闭；E-30 评估为不必要后关闭；
  N-4（ACCEPT 决定不实施）关闭

审计文档剩余 5 项 P2 + 2 项监督，经用户裁定“都不重要”后整体删除：
- 删除 docs/问题记录/错误码传播审计.md（634 行）
- 九类缺陷模式表迁入 docs/编号规范.md §4.2.1（PAT-01~09）
- E-xx 转为纯历史编号族：编号规范 §4.1 属主改“无（原属主已删除）”，
  §4.3 保持冻结；全仓 26 处引用按“保留编号、去悬空文档名”处理
- 顺带修正 N-4 收口遗留：排期详述 C1 才是 E-25/E-27/E-28 的承载处
  （审计 §4 曾误写为登记簿）；README 两处 C1 旧名改回“net 层跨上下文收口”

一并提交此前遗留的体系层评审报告 2026-10-14 复核 WIP（六维评分复核、
未闭环 Top 5→3、三区水位实测刷新）。

校验：Keil 构建 0 错误 0 警告（Code=212344）；check_doc_links
--sections-strict 与 --all（142 文档）通过；内存双台账刷新后均 PASS。
This commit is contained in:
Wanderingss
2026-10-15 07:39:38 +08:00
parent 803f7717ed
commit 506eccc68f
40 changed files with 514 additions and 1142 deletions
Download Patch File Download Diff File Expand all files Collapse all files
App/cfg/cfg_file.c
+19 -5
View File
@@ -12,7 +12,7 @@
* 移除对 C 库 malloc 的全部依赖（MicroLIB C 堆仅 512B，
* 原 4 处 KB 级 malloc 真机必然失败）；增编译期堆峰值预算
* 校验 + 失败上报自检记录
* v1.2 2026-09-21 王建锋 E-01（错误码传播审计 P0）：超长文件守卫根治——poll 判定
* v1.2 2026-09-21 王建锋 E-01（历史审计 P0，属主文档已删除）：超长文件守卫根治——poll 判定
* 前置到 cfg_store_stat 真实 st.size（旧检查位于截断后的
* len 上恒假=死码，超长文件被截断当有效解析 → 界外静默
* 回工厂默认 → 基线粘住 → 用户配置销毁链）；save 输出上限
@@ -21,6 +21,10 @@
* v1.3 2026-10-04 王建锋 P2-1：受管键行超 CFG_LINE_TEST_MAX 时拒绝保存——
* 原实现 Pass1 静默跳过超长行，Pass2 遂在段头补写新 KV 且
* 原文超长行原样保留 → 同一键出现两行（旧值残留、静默截断）
* v1.4 2026-10-15 王建锋 E-16（历史审计 P2，属主文档已删除）：生成文档边界余量收口——
* s_gen_document 两处 `off += snprintf(...)` 改检查式（截断即
* 返回 -1，不再跳过缓冲末尾）；注册拒超长键名（≤ 15 字符），
* 使每行 112 字节余量成为可编译期验证的前提
* 函数说明：引擎状态非重入——调用方须收敛同一任务（defaultTask：poll/save，见 P1-3；
* 启动期 load 先于任务竞争）；FS 卷并发由 FatFS REENTRANT 卷锁保证
* （见《配置文件设计说明》D15 A+ 方案）
@@ -63,7 +67,7 @@ static const char s_doc_header[] =
#define CFG_OUT_MAX 5120u /* 保存输出缓冲上限（经 cfg_store_alloc 取，见下方堆峰值预算） */
#define CFG_LINE_TEST_MAX 127u /* 受管键行匹配的行长上限（超长必非受管键行） */
#define CFG_SNAP_MAX 64u /* 变更检测段快照缓冲（挂回调段 data_size 须 ≤ 此值） */
#define CFG_NAME_MAX 16u /* 段名缓冲（15 字符 + NUL） */
#define CFG_NAME_MAX (CFG_FILE_MAX_NAME_LEN + 1u) /* 段名/键名缓冲（15 字符 + NUL） */
#define CFG_HEAP_BUDGET 10240u /* 暂态堆峰值预算：读缓冲(1B NUL) + 输出缓冲之和上限 */
/* 编译期钉死暂态堆峰值：放大 CFG_FILE_MAX_LEN / CFG_OUT_MAX 会先在此编译失败，强制
@@ -457,6 +461,7 @@ static int s_decode(const cfg_key_def_t *p_key, uint8_t *p_dst, const char *p_va
*/
static int s_gen_document(char *p_buf, size_t cap, size_t *p_len) {
size_t off;
int n;
int i;
int k;
size_t hlen;
@@ -480,7 +485,11 @@ static int s_gen_document(char *p_buf, size_t cap, size_t *p_len) {
if (cap < off + 112u) {
return -1;
}
off += (size_t)snprintf(p_buf + off, cap - off, "\r\n[%s]\r\n", p_sec->name);
n = snprintf(p_buf + off, cap - off, "\r\n[%s]\r\n", p_sec->name);
if (n < 0 || (size_t)n >= cap - off) {
return -1;
}
off += (size_t)n;
for (k = 0; k < (int)p_sec->key_count; k++) {
const cfg_key_def_t *p_key = &p_sec->p_keys[k];
@@ -492,7 +501,11 @@ static int s_gen_document(char *p_buf, size_t cap, size_t *p_len) {
if (cap < off + 112u) {
return -1;
}
off += (size_t)snprintf(p_buf + off, cap - off, "%s=%s\r\n", p_key->name, v);
n = snprintf(p_buf + off, cap - off, "%s=%s\r\n", p_key->name, v);
if (n < 0 || (size_t)n >= cap - off) {
return -1;
}
off += (size_t)n;
}
}
*p_len = off;
@@ -1004,7 +1017,8 @@ int cfg_file_register(const cfg_section_reg_t *p_reg) {
for (k = 0; k < (int)p_reg->key_count; k++) {
const cfg_key_def_t *p_key = &p_reg->p_keys[k];
if (p_key->name == NULL || p_key->len == 0u) {
if (p_key->name == NULL || p_key->len == 0u ||
strlen(p_key->name) >= CFG_NAME_MAX) {
return -1;
}
if (p_key->type == CFG_VAL_UINT &&
App/cfg/cfg_file.h
+9 -3
View File
@@ -9,10 +9,12 @@
* 修改记录：
* v1.0 2026-09-14 王建锋 创建初始版本（P3：段键表引擎 + net_cfg 集成）
* v1.1 2026-09-15 王建锋 属主任务由 netTask 改为 defaultTask（配置引擎单一属主，P1-3）
* v1.2 2026-09-21 王建锋 E-01（错误码传播审计 P0）：超长守卫契约同步——poll 沉降
* v1.2 2026-09-21 王建锋 E-01（历史审计 P0，属主文档已删除）：超长守卫契约同步——poll 沉降
* 后先按真实 st.size 判超长（旧实现查截断后读长恒假）、
* save 输出上限收紧至 CFG_FILE_MAX_LEN、写盘唯一闸口拒写
* 超长；超长处置补自检留痕
* v1.3 2026-10-15 王建锋 E-16（历史审计 P2，属主文档已删除）：新增公开常量
* CFG_FILE_MAX_NAME_LEN（段名/键名上限 15 字符）
*/
#ifndef CFG_FILE_H
@@ -33,6 +35,10 @@ extern "C" {
/* 引擎可注册段数上限 */
#define CFG_FILE_MAX_SECTIONS 8u
/* 段名 / 键名最大字符数（不含结尾 NUL）；超长的注册描述符被 cfg_file_register 拒绝。
* 该上限是生成文档每行余量（112 字节）可编译期验证的前提，勿放宽 */
#define CFG_FILE_MAX_NAME_LEN 15u
/* 单段键数上限 */
#define CFG_FILE_MAX_KEYS 16u
@@ -55,7 +61,7 @@ typedef enum {
/* 键定义（offset/len 均相对段 RAM 副本起始） */
typedef struct {
const char *name; /* 键名（小写） */
const char *name; /* 键名（小写，≤ CFG_FILE_MAX_NAME_LEN 字符） */
cfg_val_type_t type; /* 值类型 */
size_t offset; /* 字段偏移 */
size_t len; /* 字段长度 */
@@ -63,7 +69,7 @@ typedef struct {
/* 段注册描述符 */
typedef struct {
const char *name; /* 段名（≤ 15 字符） */
const char *name; /* 段名（≤ CFG_FILE_MAX_NAME_LEN 字符） */
void *p_data; /* 段 RAM 副本（模块自有静态区，引擎原地更新） */
const void *p_defaults; /* 工厂默认值（与 p_data 同布局；load 先复位再解析） */
size_t data_size; /* RAM 副本字节数 */
App/sync/time_sync.c
+1 -1
View File
@@ -36,7 +36,7 @@
* E-02 头阻塞修复 + L3 pending 化（timeSync 侧；lftpd 侧见 lftpd_inet.c）：
* 旧实现用单次 30s 阻塞 net_recv（默认 NET_RECV_TIMEOUT_MS）等时间包——等待期间
* netTask（全部 socket 操作的唯一执行者）被独占，其余任务的网络操作（远端显示 /
* FTP）整体停摆（docs/问题记录/错误码传播审计.md E-02）。
* FTP）整体停摆（历史审计 E-02，属主文档已删除）。
* 2026-09-22 先落地分片有界读（5ms 片），同日 L3 pending 化后改为"挂起请求"：
* 每次等待 = 一次挂起登记（netTask 零占用，完成按主循环节拍检查），调用方
* 单次超时 = 剩余总预算（总等待 ≤ TIME_SYNC_TOTAL_BUDGET_MS，语义与旧 30s
App/util/README.md
+1 -1
View File
@@ -13,7 +13,7 @@
> 两模块**零调用者**且未编入任何构建——CRC 从未被链接使用：名义上的关联点 `net_cfg_legacy.c`
> （旧档 `/cfg/netcfg.bin` 迁移，**该文件亦已于 2026-10-10 删除**）自带静态 `s_crc16_modbus()`，
> 从不调用本模块；环形缓冲由 `App/log/console_log.c` 内联实现（`s_con_ring`）。
> 保留只会造成"有统一实现"的误导，故整体移除（详见 `docs/任务规划/排期详述.md` E-15（C5））。
> 保留只会造成"有统一实现"的误导，故整体移除。
## 设计要点