wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 29 Pull Requests 1 Actions Packages Projects 2 Releases Wiki Activity
918 Commits 4 Branches 0 Tags
master
Commit Graph

7 Commits

Author SHA1 Message Date
wandering1 da36f4ba56 refactor(编号): 自愈层号与 timeSync 挂起、CubeMX 三层、采集链层名清号（代码面） 
批次六余账之二（代码与脚本面）。四族都是「批次一 / 三c 改了文档、漏了代码」的半改
状态。

- 日志自愈：「L1 文件级自愈」→「文件级自愈」、「L2 错误去重」→「错误去重」（正文
  本来就这么叫，层号纯属多余）：App/log/soe_store.c、sys_log_mcu.c 三处、
  test/host/sys_log_mcu 的测试与假件头共 10 处。
- timeSync：「L3 pending 化」→ 挂起请求 / pending 化——这条口径早写在记忆里，
  今天才算全仓一致。App/sync/time_sync.c 3 处。
- CubeMX 防丢失三层优先级：scripts/check_cubemx_survival.py 6 处「由 L3 升级为
  L2」「L2 受保护」「L3 兜底」→ 写进 .ioc / 搬进 USER CODE 区 / 审计兜底；变迁史
  句子按「换号留事实」改写、日期原样保留。
- 采集链旧层名：App/README.md「采集与算法层（L1/L2/L3）」→「采集与算法层」；
  protect_task.c/.h「（L3 板端接线，B5）」→「（板端接线，B5）」。
- phasor 断言文案 19 处：改为 ASCII 的 phasor-in ring（C 字面量必须纯 ASCII）。
  改前先证明这些串无耦合——全仓只有本文件含它们、harness 只看 returncode 与汇总
  标记；改后 phasor 57/57 与基线同数。
- 零行为：剥注释 + 套登记表后与 HEAD 逐字节 / AST 相同；sys_log_mcu 141/141、
  phasor 57/57、watchdog 47/47、freq 46/46 均与动手前基线同数。
- 同一四族的文档面（CubeMX 30、采集链 5、菜单层级 2、双写 14）由下一笔收。
 2026-10-28 18:52:37 +08:00
wandering1 67fbdd9897 refactor(结构债): S-4 删零消费点占位宏；S-2 消两处与 Inc 重复的 extern 
用户批准「先只跑 1+2」（报告 §0.4 结构债三项 S-1/S-2/S-4 的评估结论）。

**S-4 闭环**：删除 `App/app/app_cfg.h` 里 4 个**全库零消费点**的宏
（`APP_NET_ENABLE` / `APP_ADC_ENABLE` / `APP_RS485_ENABLE` /
`APP_SYS_TIME_SRC`），文件降格为「决策占位说明」——修改记录 v1.2 写明为什么删、
将来在真实初始化点接入门控时怎么接回；同时去掉 `app_main.c` 里只为它存在的
include。留「看着能裁剪、其实不生效」的宏比不留更糟：它不产生任何编译期效果，
却会让评审误信模块可裁剪——此前为了对冲这个误解，AGENTS 之外还得在 6 处文档各
写一句「未接线占位，别当开关用」。

**文档口径同步 17 处**：`App/app/README.md`、`App/README.md`、根 `README.md`、
`项目架构总览.md`、`项目部署环境要求.md`（§3.2 两行 + 配置表一行）、`产品需求
设计文档.md`（B0 结论 + 配置表）、`基线与待确认.md`、`排期详述.md` C5、`登记簿
.md` N-23 残余、`RAM使用分析与优化方案.md` 三处。

**顺带纠出另一个「文档里有、代码里从来没有」的东西**：`RAM使用分析与优化方案
.md` 把 `APP_CCM_ENABLE` 写成「加在 `App/app/app_cfg.h`」，全库只有那篇文档提
到它，从未落地——已就地标注「未实现，重开本簇时一起落地」，免得下一个读者以为
CCM 有回退开关。

**S-2 第一步**：删 `gd5f2gq5ue.c:47`、`sd2506.c:20` 两处与 `Inc/spi.h` /
`Inc/i2c.h` 重复的 `extern`；GD5F 改 `#include "spi.h"`（沿用 `ch395f.c:22`
的既有做法）。

**镜像体积逐项不变**：`Code=213,188 RO-data=18,580 RW-data=1,184
ZI-data=131,504` 与改动前完全相同，`@build` 0 错 0 警告 → 两步均为行为中性。

报告 §0.4/§9 同步为实测口径并**认错**：S-2 不是旧写的「4 处」而是 **25 处**
（`App/task/default_task.c:52-69` 一次就 18 行任务句柄/属性 extern；
`stm32f4xx_it.c` 的 `fault_entry_hard` 属 ARMCC `__asm` 合法例外，不该「
修」）；S-1 不是「语义层错位」而是**真实的 BSP→App 反向依赖**（NETCFG 10 处
include `App/cfg/cfg_file.h` + UI 3 个文件）。这两个旧数字是 v3.0 重写时沿用
未测所致。

途中被自家门禁正确拦下一次：在 .c 注释里写「S-2a」→ `+1 [校验1] 未登记编号
`，改成平实语言后转绿（正合既有纪律「代码注释禁用不可检索的内部编号」）。

门禁：`@build` 0/0；`check_ids.py --strict` 增量拦截通过、存量债 650 → 640、
可判定比例 82.83%（地板 82.6%+0.1pp）；`check_doc_links.py --all
--sections-strict` 146 文档 0 问题；`pre-commit` 相关文件全 Passed；字节卫生 15
个文件 BOM/CR/U+FFFD/行尾空格全清（`end-of-file-fixer` 修掉 app_cfg.h 的一个
多余空行）。未推送。
 2026-10-22 18:22:58 +08:00
wandering1 64d8b052b1 docs(algo): App/algo/README 缩成目录索引，详细设计迁入 docs/算法 
拆分层级
- 新建 docs/算法/采集与算法层设计说明.md（413 行、13 节）承接机制、契约、
  判据与设计理由：定位与边界 / 数据流与初始化落点 / adc_input / adc_health /
  sample_ring / phasor / freq（7.1 为什么自适应窗、7.2 判据 J1~J6）/
  prot_set / prot_elm / 关键约定与禁令 / 资源足迹 / 验证与判读 / 相关文档
- App/algo/README.md 360 -> 128 行：只留文件清单、依赖、逐文件"改代码必须
  知道"的红线、构建与测试入口、新增模块动作；深挖改成逐条指针
- README 保留 §3.1-§3.7 原编号，既有"§3.7"引用不失效

索引与引用同步
- 索引：docs/README.md §5.2 新增行；项目架构总览主题表拆成"设计与判据 /
  目录索引"两行；AGENTS.md 与 App/README.md 指向（后者原文还写着 L1/L2）
- 按内容重指（编号仍在但内容已搬走，只核编号会静默指错）：App/algo/freq.h、
  test/host/freq/freq_test.c、run_unit_test.py、继电保护规划 L2-4 行、
  pre-commit使用说明 J4 行 -> 指向设计说明
- ADC采样节拍设计说明的两处指向同步改到新文档

修 README 内过时事实
- 挂载写"八个 .c"，实际 uvprojx 内 7 个
- SIM_EXEMPT 写"prot_set / freq 才登记豁免"，实际七个全在表内
- freq-unit-test 标"待登记"，实际已在 .pre-commit-config.yaml
- 定值项数一处 31->40、一处 32->40；blob 144->176 B 证明是 32->40
- 用例与判据数字不再三处复制：属主是 test/host/<模块>/ 与 docs/测试说明/

门禁
- doc-links --all 无新增问题；--sections-strict 覆盖 10 篇文档通过
- id-check 可判定 82.65%（基线 82.6，容差 0.1）；TC 双向追溯差异 124 处不变
- registration-check PASS（1 条已知 WARN）；freq 单测 46/46；@build 0 错 0 警
- 全部改动文件无 BOM、无 CR、U+FFFD = 0
 2026-10-21 11:39:53 +08:00
wandering1 d59c2198eb feat(adc): L1 采集层落地——STM32 ADC1 扫描 + 语义通道映射 
新增 App/algo/adc_input.c/h（L1 采集与预处理层，落实 L1-3/L1-4）：
- L1-4 语义通道映射表 k_adc_map[]：UA/UN/IA → TPAFE buf[6]/[5]/[2]；
  UB/UC/IB/IC/IN/TEMP → STM32 ADC1 CH14/3/6/1/2/5。消费侧一律经
  adc_input_raw() 按语义取数，不写死下标（V0.2 改版只改表内容）。
- L1-3 STM32 ADC1 9 通道软件触发顺序扫描：HAL_ADC_Start + 逐通道
  PollForConversion/GetValue（EOC_SINGLE_CONV + 无 DMA，可逐通道轮询）。
- adc_input_poll() 统一"TPAFE 原子快照 + STM32 扫描"；
  adc_input_init() 做映射自检（STM32 映射通道必落在扫描序列内，否则
  返回 -1），挡住"映射到不扫描的通道 → 恒读陈旧值"的静默错。

集成：
- adc_task.c 取数改走 L1 层（首帧日志补全 8 路 + 温度；心跳增
  adc1_rc/adc1_err 观测 STM32 侧健康度）。
- app_main.c 在 tpafe5160_init() 之后调 adc_input_init()，失败记
  SYSLOG_SELFTEST("ADC map fault")。
- Keil 工程挂 adc_input.c 并加 ../App/algo 包含路径。
- 文档同步：继电保护规划 §1.2/§3.1（L1-3/L1-4 改 ✅）、ADC通道映射说明
  §7/§8/§9、产品需求 §5.9/§9、架构总览 §7、AGENTS.md、App/README.md、
  App/task/README.md、新增 App/algo/README.md、boot_log_data 清单。

验证：
- @build 0 错 0 警；镜像无源文件新于 hex。
- 台架 @test PASS：ADC input layer init OK、adc1_rc=0/adc1_err=0
  （30 s ≈27 万次转换零超时）、seq 仍 1000.0 Hz、adc 栈峰值
  528→584 B（余 71%）、回读一致、零 [ERR]/HardFault。
  证据 docs/测试说明/boot_log_data/20261010_prod_adc_l1_boot_log.txt
- 内存快照已刷新（Flash 269,404→270,712 B）。
 2026-10-10 16:06:31 +08:00
wandering1 0779d3a075 栈整改不抬栈：删旧档迁移、FIL静态化、日志行缓冲按模块收紧、钩子脱离HAL，defaultTask链5312→2776B 2026-10-10 10:17:00 +08:00
wandering1 22559365b9 整理 App 与 test 目录：按职责分子目录并同步全库引用 2026-09-26 12:52:39 +08:00
wandering1 39bd06adea 为自建代码目录补齐 README，建立目录级导航体系 
- 新增 26 份目录 README：App/(+log,task,util,protocol)、Drivers/BSP/(+8子系统)、
  Src/、Inc/、scripts/、tools/(+6子工具)、test/、MDK-ARM/、simulator/(+sim,tests)
- 每份含：定位、文件清单表、关键约束/陷阱、指向 docs 权威文档
- 第三方库与生成代码目录排除（CMSIS/HAL/Middlewares/Lib/SDL2）
- docs/文档规范.md 新增 §1.1b 代码目录 README 约定；根 README 目录结构加入说明
 2026-09-26 12:25:36 +08:00