STM32F4-Base

Author SHA1 Message Date

Author	SHA1	Message	Date
wandering1	593c5d0c84	refactor(编号): 采集链分层 L1/L1.5/L2/L2.5/L3/L4/L5 → 语义名（批次 1）用户裁定（2026-10-28）：L1/L1.5/L2/L2.5/L3 这套层号「谁能看懂」，改用语义名。映射（同一批定稿，含 L4/L5）： L1 → 语义取数与有效性 L1.5 → 标定折算 L2 → 全周傅氏相量 L2.5 → 测频与遥测快照 L3 → 保护判据 L4 → 出口与记录 L5 → 动作留痕实测规模：384 站点 / 62 文件（App/algo、App/task、test/host 六个套件、docs/算法、产品需求、架构总览、启动顺序、ADC 采样节拍、IEC104 上行、采集短板评测、内存管理、 AGENTS.md、README.md、docs/README.md、.pre-commit-config.yaml 与 scripts 里的注释）。改法（不是全局替换，逐模式有上下文规则）： - 先吃同位语再落裸词：L1 有效性校验 → 语义取数与有效性校验、L2 相量层 → 全周傅氏相量层、L3 保护 → 保护判据、L2.5 遥测快照 → 测频与遥测快照，避免「保护判据保护判据」这类重复（第一版就是这么坏掉的，已整体回滚重做）。 - .c/.h 只改注释：先把字符串字面量切出去（引号数为奇数的跨行注释按整行处理）， C 字符串里的 L2-in ring 之类原样保留——AGENTS 铁律「字符串字面量必须纯 ASCII」。 - 层内条目号（L1-3 / L2-3 这类）本批不动，属批次 2；另外三族（UI 菜单层级 L0~L3、链路延迟分段 L1~L8、CubeMX 防丢失三层）也不动，属批次 3。 - 顺手修的措辞：范围写法 L1~L3 → 「分层（语义取数与有效性 → 保护判据）」、 CI 段「不含 L1/L2/L3」→「不含采集链分层」、目录地图里同一处并列表述。验证：@build 0 错 0 警（Code=236456，与改前逐字节同尺寸——纯注释改动）；内存布局配图已按新脚本重生成（自检通过）；doc-links --all --sections-strict 通过（195 文档）；mojibake / bom-guard / coding-standard / 新编号门禁自查全 rc=0； git diff --check 干净。	2026-10-28 13:04:02 +08:00
wandering1	97049a4bf0	docs(plan): 采集链与上送链台架联调分工新增 docs/任务规划/分工说明-20261028-采集链与上送链联调.md（45 行）：只分工不改行为。A 线走采集链 L1→L2→L2.5，B 线走上送链 L2.5→104/UI，两条线各自验收后合并，不交叉编辑对方文件。 - A 线交付：App/algo/README.md 补「快照时序」一节；adc_input 主机单测增帧序号回绕与双缓冲半帧两个用例；ADC采样节拍说明 §5 按实测节拍回填。 - B 线交付：meas 双区快照的单写者与多读者一致性说明；ui_data 补陈旧代次（generation）用例；新增 .c 时双端注册 Keil 工程与 CMakeLists。 - 禁区写进正文：CODE-RULE-20 禁 C 库堆分配、V0.1 禁跨转换器做相位与功率运算、layer-deps 不许 BSP 反依赖 App、UI 源文件带 BOM 须原样补回。 - 验收表：台架一次烧录须 -Rst -Run 并回读校验（No difference found），串口日志不得出现 [ERR]——四个 Fault 的崩溃日志都以它开头。随笔修一处：正文第 31 行举例引用的 §4.2 在目标文档里已不存在，改指现有小节 §10.1，否则 doc-links 门禁拦提交（编码 BOM、LF 与乱码均无变化）。本笔只动这一份文档，代码与门禁配置零改动；上一笔 `94b0d790` 的页面接线与任务卡号清退不在本笔内，其未做的六页真机判据已登记在登记簿 §7。另记一笔待办：文中写的 MDK-ARM/STM32F4-Base.uvprojx 与实际工程文件名（STM32F407-Demo.uvprojx）不符，留给该线负责人校正，本笔不代改。	2026-10-28 07:30:05 +08:00

593c5d0c84

refactor(编号): 采集链分层 L1/L1.5/L2/L2.5/L3/L4/L5 → 语义名（批次 1）

用户裁定（2026-10-28）：L1/L1.5/L2/L2.5/L3 这套层号「谁能看懂」，改用语义名。
映射（同一批定稿，含 L4/L5）：
  L1   → 语义取数与有效性
  L1.5 → 标定折算
  L2   → 全周傅氏相量
  L2.5 → 测频与遥测快照
  L3   → 保护判据
  L4   → 出口与记录
  L5   → 动作留痕

实测规模：384 站点 / 62 文件（App/algo、App/task、test/host 六个套件、docs/算法、
产品需求、架构总览、启动顺序、ADC 采样节拍、IEC104 上行、采集短板评测、内存管理、
AGENTS.md、README.md、docs/README.md、.pre-commit-config.yaml 与 scripts 里的注释）。

改法（不是全局替换，逐模式有上下文规则）：
- 先吃同位语再落裸词：L1 有效性校验 → 语义取数与有效性校验、L2 相量层 → 全周傅氏
  相量层、L3 保护 → 保护判据、L2.5 遥测快照 → 测频与遥测快照，避免「保护判据保护判据」
  这类重复（第一版就是这么坏掉的，已整体回滚重做）。
- .c/.h 只改注释：先把字符串字面量切出去（引号数为奇数的跨行注释按整行处理），
  C 字符串里的 L2-in ring 之类原样保留——AGENTS 铁律「字符串字面量必须纯 ASCII」。
- 层内条目号（L1-3 / L2-3 这类）**本批不动**，属批次 2；另外三族（UI 菜单层级
  L0~L3、链路延迟分段 L1~L8、CubeMX 防丢失三层）也不动，属批次 3。
- 顺手修的措辞：范围写法 L1~L3 → 「分层（语义取数与有效性 → 保护判据）」、
  CI 段「不含 L1/L2/L3」→「不含采集链分层」、目录地图里同一处并列表述。

验证：@build 0 错 0 警（Code=236456，与改前逐字节同尺寸——纯注释改动）；
内存布局配图已按新脚本重生成（自检通过）；doc-links --all --sections-strict 通过
（195 文档）；mojibake / bom-guard / coding-standard / 新编号门禁自查 全 rc=0；
git diff --check 干净。

2026-10-28 13:04:02 +08:00

wandering1

97049a4bf0

docs(plan): 采集链与上送链台架联调分工

新增 docs/任务规划/分工说明-20261028-采集链与上送链联调.md（45 行）：
只分工不改行为。A 线走采集链 L1→L2→L2.5，B 线走上送链 L2.5→104/UI，
两条线各自验收后合并，不交叉编辑对方文件。

- A 线交付：App/algo/README.md 补「快照时序」一节；adc_input 主机单测
  增帧序号回绕与双缓冲半帧两个用例；ADC采样节拍说明 §5 按实测节拍回填。
- B 线交付：meas 双区快照的单写者与多读者一致性说明；ui_data 补陈旧
  代次（generation）用例；新增 .c 时双端注册 Keil 工程与 CMakeLists。
- 禁区写进正文：CODE-RULE-20 禁 C 库堆分配、V0.1 禁跨转换器做相位与
  功率运算、layer-deps 不许 BSP 反依赖 App、UI 源文件带 BOM 须原样补回。
- 验收表：台架一次烧录须 -Rst -Run 并回读校验（No difference found），
  串口日志不得出现 [ERR]——四个 Fault 的崩溃日志都以它开头。

随笔修一处：正文第 31 行举例引用的 §4.2 在目标文档里已不存在，改指现有
小节 §10.1，否则 doc-links 门禁拦提交（编码 BOM、LF 与乱码均无变化）。
本笔只动这一份文档，代码与门禁配置零改动；上一笔 94b0d790 的页面接线与
任务卡号清退不在本笔内，其未做的六页真机判据已登记在登记簿 §7。
另记一笔待办：文中写的 MDK-ARM/STM32F4-Base.uvprojx 与实际工程文件名
（STM32F407-Demo.uvprojx）不符，留给该线负责人校正，本笔不代改。

2026-10-28 07:30:05 +08:00

2 Commits