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
This commit is contained in:
@@ -46,7 +46,7 @@
|
||||
- netTask:`net_stack_bring_up`(配置已由 defaultTask 在屏障前加载,本任务只读 RAM 副本)→ 置 NET_READY → 循环 `net_poll` + `net_process_messages`;消费 `SYS_EVT_NET_RECONFIG` → 按网络代次号重建监听(新 IP 免重启生效)
|
||||
- defaultTask:`f_mount` forced(无卷自动 `f_mkfs`;挂载后卷健康探针,FAT 区陈旧时自愈重格式化)→ 加载网络配置 → STORAGE_READY → LED 闪烁;同时是 syslog(`/log/run.log`·`selftest.log`,定长 64B 记录)的**唯一写者**与**配置引擎属主**(netTask/uiTask 不得直接触碰配置引擎)
|
||||
- adcTask:**纯消费者**——每拍 `adc_input_poll()`(TPAFE 原子快照 + 消费一帧 STM32 ADC1 DMA 双缓冲),只取数不做保护运算;**节拍与唤醒同源**(TIM3 ISR 内触发 CONVST + 同一更新事件经 TRGO 触发 ADC1,并调 `adc_tick_irq_notify()` 置位,任务 `osThreadFlagsWait` 等唤醒)。⚠ ISR 侧**只能**走 `adc_tick_irq_notify()`(内含"消费者就绪"门,TIM3 比调度器早 ≈100 ms 启动);手写于 `Src/freertos.c` 的 `USER CODE` 区,纳入 IWDG `required_mask`(`TASK_WD_ADC`)
|
||||
- **采集与算法层(L1/L2/L3)落在 `App/algo/`**:`adc_input`/`adc_health` = L1,`sample_ring`/`phasor` = L2,`freq` = L2.5 测频(B8,自适应窗),`prot_set`/`prot_elm` = L3。板端消费者 = **protectTask**(B5,2026-10-12):20 ms 节拍 `prot_elm_run()` + L5-4 采样故障闭锁 + L5-1 定值校验和巡检;跨上下文复归(104 YK11)经 `prot_elm_request_reset()` 落请求。纳入 IWDG `required_mask`(`TASK_WD_PROTECT`,产品 `0x1F7`)。→ `App/algo/README.md`
|
||||
- **采集与算法层(L1/L2/L3)落在 `App/algo/`**:`adc_input`/`adc_health` = L1,`sample_ring`/`phasor` = L2,`freq` = L2.5 测频(B8,自适应窗),`prot_set`/`prot_elm` = L3。板端消费者 = **protectTask**(B5,2026-10-12):20 ms 节拍 `prot_elm_run()` + L5-4 采样故障闭锁 + L5-1 定值校验和巡检;跨上下文复归(104 YK11)经 `prot_elm_request_reset()` 落请求。纳入 IWDG `required_mask`(`TASK_WD_PROTECT`,产品 `0x1F7`)。→ `docs/算法/采集与算法层设计说明.md`(设计与判据)、`App/algo/README.md`(目录索引)
|
||||
- 全景 → `docs/架构设计/项目架构总览.md`;启动时序与内核前模式 → `docs/架构设计/项目启动顺序管理.md`
|
||||
|
||||
<!-- TASK_TABLE:BEGIN generated by scripts/gen_task_table.py -->
|
||||
|
||||
Reference in New Issue
Block a user