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

chore(编号): 存量编号全量转语义短语，门禁识别面与语料同批重打

Browse Source 
登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号）
一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、
采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。

门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏
undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8
reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF；
id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。

test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字，
是本批唯一改变构建产物的文件集合。

为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged
部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、
不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。

实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01%
（基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 /
告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。

基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处
引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使
识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。

⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二
根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有），
今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。

固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0；
App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889
断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿；
check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带
BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。

.cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法：
Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。

同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%，
RW_CCM 57,376 B / 87.9%，阈值 92%。
This commit is contained in:
Wanderingss
2026-10-26 12:28:14 +08:00
parent 7635480e06
commit 0f7b5a87fb
253 changed files with 2234 additions and 4541 deletions
Download Patch File Download Diff File Expand all files Collapse all files
App/task/adc_task.c
+2 -2
View File
@@ -28,7 +28,7 @@
* 创建日期：2026-07-19
* 修改记录：
* v1.0 2026-07-19 王建锋 创建初始版本
* v1.1 2026-10-05 王建锋 P3-11：注明"预留桩（未启用）"，避免误认为已实现
* v1.1 2026-10-05 王建锋 注明"预留桩（未启用）"，避免误认为已实现
* v2.0 2026-10-10 王建锋 B1：实现真实消费者（1ms 节拍 + 原子快照 + 帧统计 +
* 看门狗心跳），由 Src/freertos.c 创建为 adcTask
* v2.1 2026-10-10 王建锋 日志门控：首帧/周期统计仅在 dbg_console_writer_ready()
@@ -75,7 +75,7 @@
* 单调性/错误计数增量）——严重事件与故障电平上升沿
* 打 DBG_ERROR + 每类每次开机一次 SYSLOG_SELFTEST；
* 恢复打 DBG_INFO；心跳日志增 tgap（TPAFE 侧丢帧，
* 与 adc1_gap 对称）。判定不在本文件（A-4：算法与
* 与 adc1_gap 对称）。判定不在本文件（算法与
* I/O 分离），本文件只做"消费计数 → 告警"的编排
* v3.0 2026-10-21 王建锋 修复"任务初始化入口从未被调用"：adc_task_func 进入
* 循环之前先调 adc_task_init()。原实现下判定层状态靠
App/task/default_task.c
+12 -12
View File
@@ -2,7 +2,7 @@
* 模块名称：Default Application Task
* 模块功能：主控任务（defaultTask）任务体实现：
* ① 启动段：存储 bring-up（挂载 + 空卷自动建卷 + 卷健康探针两击 +
* 自愈重格式化，E-31 失败后主循环 3×2s 有界重试）+ 网络配置加载
* 自愈重格式化，挂载失败后主循环 3×2s 有界重试）+ 网络配置加载
* + STORAGE_READY 屏障 + "保存网络配置"回调注册
* ② 控制台单写者：dbg_console_writer_attach 注册 + 主循环 dbg_console_drain
* 排空（串口唯一发送者，见 App/log/console_log.c 设计说明）
@@ -65,7 +65,7 @@
* 2026-10-12（B5）：堆扩至 56KB（.ioc configTOTAL_HEAP_SIZE=57344，CCM 腾给
* protectTask/iec104Task 栈），阈值**不随堆缩放**——它是绝对字节安全线。 */
#define HEAP_LOW_WATER_B 3072u
/* E-31 自愈策略（2026-09-21 审计 P0 修复）：启动期存储挂载失败后，
/* 存储自愈策略（2026-09-21 审计 P0 修复）：启动期存储挂载失败后，
* 主循环按 2s 周期重跑完整 bring-up 的次数上限；耗尽则维持无存储降级
* （自检已上报、卷保留、不重格式化），等下次上电重新 resume */
#define STORAGE_BRINGUP_RETRIES 3u
@@ -106,7 +106,7 @@ static FRESULT storage_bring_up(FATFS *fs);
* 只在内核运行期被调度，启动段允许使用 CMSIS 对象
* 函数说明：启动段 = 存储 bring-up + 保存回调注册 + 控制台写者注册；
* 主循环 = 事件等待（配置保存/控制台待发，50ms 兜底）→ 控制台排空
* → 配置保存执行 → 2s 配置轮询（含 E-31 有界重试）→ LED 心跳
* → 配置保存执行 → 2s 配置轮询（含存储自愈有界重试）→ LED 心跳
* → syslog 落盘 → 栈水位观测
*/
void default_task_func(void *argument) {
@@ -121,7 +121,7 @@ void default_task_func(void *argument) {
* 完整 bring-up 序列（挂载 + 空卷自动建卷 + 健康探针 + 自愈重格式化
* + 日志挂载 + 配置加载 + 就绪屏障）实现于 storage_bring_up()。
*
* E-31（2026-09-21 审计，P0 修复）：dhara_map_resume 失败不再被当
* 存储自愈（2026-09-21 审计，P0 修复）：dhara_map_resume 失败不再被当
* "新卷"静默重格式化（扫描中任何一次瞬态毛刺都会销毁全部用户数据）——
* nand_ftl 仅把 DHARA_E_TOO_BAD（真空白）判为新卷，其余失败使
* disk_initialize 失败 → f_mount 失败 → 下方自检上报并保留卷；
@@ -131,7 +131,7 @@ void default_task_func(void *argument) {
* 小写两击确认、FR_INVALID_NAME 不入重格式化集、写保护类只上报，
* 详见该函数注释）。 */
#if !defined(TEST_SUITE_STORAGE)
/* E-31 自愈：存储 bring-up 剩余重试次数（0 = 已就绪或已耗尽）；
/* 存储自愈：存储 bring-up 剩余重试次数（0 = 已就绪或已耗尽）；
* 须在启动块之前声明（启动块失败路径写入、主循环读取） */
uint32_t storage_retry = 0u;
#endif
@@ -146,12 +146,12 @@ void default_task_func(void *argument) {
if (fr != FR_OK) {
/* 存储不可写：自检故障仅能滞留待发队列（串口已告警） */
syslog_post(SYSLOG_SELFTEST, "filesystem fault");
/* E-31 自愈：启动主循环中的有界重试（每 2s 一次） */
/* 存储自愈：启动主循环中的有界重试（每 2s 一次） */
storage_retry = STORAGE_BRINGUP_RETRIES;
}
/* 注册"保存网络配置"请求通知：UI（uiTask）投递 → 置事件 → 本任务立即执行写盘
* （配置引擎属主 = 本任务；UI 保存不再直接触碰配置文件引擎，P1-3） */
* （配置引擎属主 = 本任务；UI 保存不再直接触碰配置文件引擎） */
net_cfg_set_save_req_cb(default_task_net_cfg_save_notify);
#else
/* STORAGE 套件构建：挂载/配置引擎/日志盘写全部跳过，存储由 testTask 独占 */
@@ -177,9 +177,9 @@ void default_task_func(void *argument) {
task_wd_start();
for (;;) {
/* round 8 取证：进段打点——每步前记录段号到 .noinit 槽（复位不丢）。
/* 第 8 轮取证：进段打点——每步前记录段号到 .noinit 槽（复位不丢）。
* 误复位后开机 `PREVRUN seg=N` 即"上一轮主循环死在哪个调用点"
* （round 7 初判"poller 自身停摆"经 round 8b 更正：真因是 IWDG 超时被静默
* （第 7 轮初判"poller 自身停摆"经第 8b 轮更正：真因是 IWDG 超时被静默
* 配成复位默认值，见 docs/子系统设计/看门狗设计说明.md 2026-10-02 变更记录）。 */
task_wd_seg(TASK_WD_SEG_POLL);
/* 心跳抽样与喂狗判定（内部节流至 100ms；全员到位才喂，否则累计停喂） */
@@ -240,7 +240,7 @@ void default_task_func(void *argument) {
if ((cfg_poll_cnt++ % 40u) == 0u) {
#if !defined(TEST_SUITE_STORAGE)
task_wd_seg(TASK_WD_SEG_CFGPOLL);
/* E-31 自愈：启动期挂载失败时，每 2s 重跑完整 bring-up——
/* 存储自愈：启动期挂载失败时，每 2s 重跑完整 bring-up——
* 瞬态毛刺（如 dhara resume 扫描的瞬时 SPI 故障）通常第二次
* 即恢复；成功后由 storage_bring_up 补跑启动时跳过的
* "存储就绪"序列（日志挂载/配置加载/屏障置位，均幂等）；
@@ -257,7 +257,7 @@ void default_task_func(void *argument) {
syslog_post(SYSLOG_SELFTEST, "filesystem fault");
}
}
/* P2-9：卷已就绪（STORAGE_READY）但日志后端未就绪（建 /log 曾失败，
/* 卷已就绪（STORAGE_READY）但日志后端未就绪（建 /log 曾失败，
* s_fs_ready 恒 0 → syslog_drain 永久 no-op）→ 2s 周期重试（幂等；
* 就绪后 syslog_mcu_mounted 立即返回，仅一次 volatile 读）。 */
if (sys_evtHandle != NULL
@@ -410,7 +410,7 @@ static void stack_probe_poll(void) {
* 下整体不参与编译（卷由 testTask 独占）
* 函数说明：
* 由 defaultTask 调用：启动期一次；若失败，主循环每 2s 重试至多
* STORAGE_BRINGUP_RETRIES 次（E-31 自愈策略，2026-09-21）：dhara_map_resume
* STORAGE_BRINGUP_RETRIES 次（存储自愈策略，2026-09-21）：dhara_map_resume
* 失败分类修复后（nand_ftl.c 仅真空白判新卷，其余失败保留卷并返回
* disk_initialize 失败），重试让瞬态毛刺（SPI 瞬时故障/扫描窗口抖动）
* 在数秒内免重启恢复，成功时补跑启动期跳过的就绪序列（日志挂载/配置
App/task/iec104_serv.c
+4 -4
View File
@@ -3,7 +3,7 @@
* 模块功能：2404 监听 + 单连接 socket 收发 + 把字节流喂给 iec104_link 纯逻辑
* 层；对时经 sys_clock_set_unix 落墙钟；数据源走 iec104_pts 默认源
* （phasor / prot_elm / prot_set）。协议语义全部在 App/protocol/iec104，
* 本文件只做 I/O 编排（A-4 约束 1）。
* 本文件只做 I/O 编排（分层约束）。
* 线程约定：iec104Task 独占（NET_READY 屏障后循环，100ms 节拍 + 看门狗心跳）。
* 创建日期：2026-10-12（B4）
*/
@@ -33,7 +33,7 @@
/* 兜底节拍：门控判"无数据"时每 32 轮无条件收一次（ui_net_sink RM 先例，
* 防 RECV_OK 事件未收到把数据永久藏住）；须为 2 的幂 */
#define IEC104_LIVENESS_DIV 32u
/* 连续发送失败阈值：同 ui_net_sink E-04（短写=对端收坏帧） */
/* 连续发送失败阈值：同 ui_net_sink 先例（短写=对端收坏帧） */
#define IEC104_SEND_FAIL_MAX 3u
/* ---------------- 服务状态（iec104Task 独占） ---------------- */
@@ -59,7 +59,7 @@ static const iec104_link_cfg_t s_cfg = { 1u, s_send_apdu, s_clock_sync, s_epoch_
* 入口参数：ctx 未用；apdu/len = 完整 APCI 帧
* 返回值：无
* 限定条件：s_client >= 0（在 link 调用栈内执行，即本任务上下文）
* 函数说明：短写/失败累计（E-04 先例）；连续 3 次 → 置 s_conn_dead，
* 函数说明：短写/失败累计（ui_net_sink 先例）；连续 3 次 → 置 s_conn_dead，
* 由 s_service_link 在 link 调用返回后统一拆链（严禁在回调里拆）
*/
static void s_send_apdu(void *ctx, const uint8_t *apdu, uint16_t len) {
@@ -191,7 +191,7 @@ static void s_service_link(uint32_t now) {
* 返回值：无
* 限定条件：NET_READY 已置位；s_cfg/s_link 已 init
* 函数说明：门控（net_listener_armed/net_can_read 纯 RAM 读）+ 兜底节拍照
* ui_net_sink I-1/I-2；EOF 时 client==listen 严禁 close（net 层
* ui_net_sink 先例；EOF 时 client==listen 严禁 close（net 层
* 已 auto_relisten，close 会连监听一起毁）
*/
static void s_serv_poll(void) {
App/task/net_task.c
+9 -9
View File
@@ -11,12 +11,12 @@
* v1.2 2026-07-21 王建锋 网络初始化移入本任务（net_init + TCP 监听）
* v1.3 2026-07-22 王建锋 单连接模式重构，增加大文件/边界/KeepAlive 测试
* v1.4 2026-09-14 王建锋 新增自检埋点：PHY 链路 3s 未建立 → sys_log "comms fault"
* v1.5 2026-09-15 王建锋 配置加载移交 defaultTask（配置引擎属主，P1-3）；
* v1.5 2026-09-15 王建锋 配置加载移交 defaultTask（配置引擎属主）；
* 本任务只读 RAM 副本
* v1.6 2026-09-15 王建锋 P1-6：入口加 CH395F 硬件层测试模式自挂起守卫
* v1.6 2026-09-15 王建锋 入口加 CH395F 硬件层测试模式自挂起守卫
* （基础线程无条件创建，该模式下不运行）；
* freertos.c USER CODE 区重复创建已删除
* v1.7 2026-10-02 王建锋 P1-8：初始组网失败/重建失败 → 自检记录 + 30s 周期重试
* v1.7 2026-10-02 王建锋 初始组网失败/重建失败 → 自检记录 + 30s 周期重试
* （原实现：初始失败 = netTask 无限驻留；重建失败 = 静默丢配置）
* v1.8 2026-10-10 王建锋 任务耗时测量埋点：net_poll() 单独计时——
* 本任务每 ~1ms 分派一次消息队列，若驱动轮询被拉长，
@@ -52,7 +52,7 @@
* 函数说明：只置事件位；真正的重建在主循环内完成（CH395F SPI 归 netTask 独占，
* UI 不得直接操作）
*/
/* P1-8（2026-10-02）：重建失败延迟重试的截止 tick；0 = 无待重试 */
/* 重建失败延迟重试的截止 tick；0 = 无待重试 */
static uint32_t s_reinit_retry_at;
static void net_reconfig_request_cb(void) {
@@ -186,7 +186,7 @@ void net_task_func(void const *arg) {
* 2026-10-02 台架修复：10s 超时等待改 100ms 分片 + 每片喂心跳——原实现
* 在等待期无心跳：若存储 bring-up 失败，本等待跑满 10s 超时，而 IWDG
* 此时已启动（defaultTask 在 bring-up 后即启动），NET 位长期缺失 →
* 必需掩码不可达 → 复位循环，E-31 的 2s 自愈重试根本没有机会。
* 必需掩码不可达 → 复位循环，存储自愈的 2s 重试根本没有机会。
* 分片喂位保证"存储未就绪"降级态下 NET 位持续新鲜。 */
uint32_t rounds_left = 100u; /* 100 × 100ms = 原 10s 超时语义 */
for (;;) {
@@ -202,7 +202,7 @@ void net_task_func(void const *arg) {
}
}
/* P1-8（2026-10-02）：初始组网失败不自驻留——自检台账留痕 + 30s 周期重试
/* 初始组网失败不自驻留——自检台账留痕 + 30s 周期重试
* （1s 分片、每片喂心跳）：线缆/芯片恢复即可当场完成组网；原 for(;;)osDelay
* 会令看门狗 NET 位持续陈旧，并阻塞全部下游就绪屏障 */
for (;;) {
@@ -235,7 +235,7 @@ void net_task_func(void const *arg) {
/* UI 保存网口配置后请求立即应用：在此重建网络（新 IP/掩码/网关/MAC）。
* 重建完成后代次号已递增，各 TCP 服务据此重建监听；期间连接会断开（预期）。
* P2-11（2026-10-04）：用 osEventFlagsWait(timeout=0) 原子"取走并清除"RECONFIG
* 用 osEventFlagsWait(timeout=0) 原子"取走并清除"RECONFIG
* 位，替换原 Get+Clear 两步；原写法在 Get 与 Clear 之间若有生产者在同一位上
* Set，该次请求会被 Clear 一并吞掉（丢事件窗口）。 */
if (sys_evtHandle != NULL) {
@@ -247,7 +247,7 @@ void net_task_func(void const *arg) {
(void)osEventFlagsSet(sys_evtHandle, SYS_EVT_NET_READY);
s_reinit_retry_at = 0U;
} else {
/* P1-8（2026-10-02）：重建失败 → 自检留痕 + 30s 延迟重试（重事件位），
/* 重建失败 → 自检留痕 + 30s 延迟重试（重事件位），
* 新配置不再静默丢失（原实现仅一条 DBG_ERROR 后丢弃） */
DBG_ERROR("netTask: re-init FAIL, retry in 30s");
(void)syslog_post(SYSLOG_SELFTEST, "net reinit fail");
@@ -255,7 +255,7 @@ void net_task_func(void const *arg) {
}
} else if ((s_reinit_retry_at != 0U)
&& ((int32_t)((uint32_t)HAL_GetTick() - s_reinit_retry_at) >= 0)) {
/* P1-8：30s 倒计时到 → 重新触发重建（符号差处理 tick 回绕） */
/* 30s 倒计时到 → 重新触发重建（符号差处理 tick 回绕） */
s_reinit_retry_at = 0U;
(void)osEventFlagsSet(sys_evtHandle, SYS_EVT_NET_RECONFIG);
}
App/task/net_task.h
+1 -1
View File
@@ -8,7 +8,7 @@
* v1.0 2026-07-19 王建锋 创建初始版本
* v1.1 2026-08-24 王建锋 提取 net_stack_bring_up() 供硬件层/NET 层两种测试模式共用
* v1.2 2026-09-15 王建锋 硬件层模式描述修正：netTask 恒创建（基础线程），
* 该模式下自挂起不运行（P1-6 守卫）
* 该模式下自挂起不运行（入口自挂起守卫）
* v1.3 2026-10-21 王建锋 删除 net_task_init() 声明（空壳入口、无调用点）
*/
App/task/protect_task.c
+1 -1
View File
@@ -84,7 +84,7 @@ static uint8_t s_prev_cal_lock; /* 上拍未标定闭锁态（边沿日志用
* 返 回 值：1 - 闭锁（判据停走）；0 - 放行 uint8_t
* 限定条件：仅本任务上下文（adc_cal_flags 纯读，任意上下文可读）
* 函数说明：判据 = UA/UN/IA 三路 VALID **全**置位——恰好是 V0.1 唯一有效的
* 三个测量通道（N-18）；UB/UC/IB/IC/IN 即使将来标定也另受 CLIPPED
* 三个测量通道（双转换器无共同采样触发）；UB/UC/IB/IC/IN 即使将来标定也另受 CLIPPED
* 品质约束（M5 快照层处理），不掺和进本闭锁源。VALID 随 cfg
* load/poll 与卡 12 标定自动翻转，本函数无自有状态（每拍现查，
* 无陈旧标志位）。台架调试旁路 = 编译期 -DDTU_BENCH（§4.3 决策 1
App/task/rs485_task.c
+1 -1
View File
@@ -9,7 +9,7 @@
* 创建日期：2026-07-19
* 修改记录：
* v1.0 2026-07-19 王建锋 创建初始版本
* v1.1 2026-10-05 王建锋 P3-11：注明"预留桩（未启用）"，避免误认为已实现
* v1.1 2026-10-05 王建锋 注明"预留桩（未启用）"，避免误认为已实现
*/
#include "rs485_task.h"
App/task/ui_task.c
+2 -2
View File
@@ -25,7 +25,7 @@
* （2026-10-25 实测 bit4 8 连击、uisn=154ms 仍在段内；
* 按位连击判据 = docs/子系统设计/看门狗设计说明.md §5.3）。
* 单个往返自身仍无上界——该上界与彻底解耦（事件驱动
* accept）归登记簿 E-27/E-28（批 3），本票只做心跳续命。
* accept）归登记簿「net 层跨上下文收口」（批 3），本票只做心跳续命。
*/
#include "ui_task.h"
@@ -295,7 +295,7 @@ void ui_task_func(void *argument) {
* 一次心跳，救不了 → 彻底解耦须走事件驱动 accept，见文件头修改记录 v1.3。
* v1.4 补充：sink 内每个往返**返回点**已各自补喂（set_beat_cb 注入），
* 「单轮多个慢往返之和」不再构成缺席链；剩单往返 >800ms 才报——那是
* netTask 自身停摆，按位判据抓对了人（上界归 E-27/E-28）。 */
* netTask 自身停摆，按位判据抓对了人（上界归「net 层跨上下文收口」）。 */
task_wd_beat(TASK_WD_UI);
/* 推流轮询段单独 enter/exit：它内部经 net_accept → net_wait_result 走到
* xTaskNotifyWait(portMAX_DELAY) 的**无限期阻塞**。若 uiTask 永久卡在这里，