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 干净。
This commit is contained in:
@@ -30,7 +30,7 @@
|
||||
flowchart TB
|
||||
subgraph APP["应用层 (App/)"]
|
||||
direction LR
|
||||
A1["app/app_main.c"] ~~~ A2["task/net_task.c"] ~~~ A3["task/ui_task.c"] ~~~ A4["sync/time_sync.c"] ~~~ A5["algo/(L1~L3)"]
|
||||
A1["app/app_main.c"] ~~~ A2["task/net_task.c"] ~~~ A3["task/ui_task.c"] ~~~ A4["sync/time_sync.c"] ~~~ A5["algo/(语义取数与有效性~保护判据)"]
|
||||
end
|
||||
subgraph BSP["驱动层 (Drivers/BSP/)"]
|
||||
direction LR
|
||||
@@ -63,8 +63,8 @@ main.c
|
||||
│ ├─ rs485_init()
|
||||
│ ├─ gd5f2gq5ue_init() // 含 BBT 全片扫描
|
||||
│ ├─ tpafe5160_init()
|
||||
│ ├─ adc_input_init() // L1 采集层(语义映射 + STM32 ADC1 DMA)
|
||||
│ ├─ phasor_init() / freq_init() / prot_set_init() + prot_elm_init() // L2/L3 内核前就绪
|
||||
│ ├─ adc_input_init() // 语义取数与有效性层(语义映射 + STM32 ADC1 DMA)
|
||||
│ ├─ phasor_init() / freq_init() / prot_set_init() + prot_elm_init() // 全周傅氏相量/保护判据内核前就绪
|
||||
│ ├─ SD2506 诊断(ID/时间/温度/电池)
|
||||
│ └─ HAL_TIM_Base_Start_IT(&htim3) // 启动 TIM3 1kHz 采样节拍
|
||||
├─ osKernelInitialize()
|
||||
@@ -85,7 +85,7 @@ main.c
|
||||
| timeSyncTask | 640 words | Normal | 墙钟时间同步 |
|
||||
| adcTask | 640 words | AboveNormal | TPAFE5160 采样(TIM3 1kHz 事件驱动 + 原子快照 + STM32 ADC DMA,纯消费者) |
|
||||
| iec104Task | 640 words | Normal | IEC 60870-5-104 上行(:2404 监听,遥信/遥测/定值区) |
|
||||
| protectTask | 512 words | Normal | 保护判据 20ms 节拍(L3 元件 + 采样故障闭锁,B5) |
|
||||
| protectTask | 512 words | Normal | 保护判据 20ms 节拍(保护判据元件 + 采样故障闭锁,B5) |
|
||||
<!-- TASK_TABLE:END -->
|
||||
|
||||
> 上表与 `Src/freertos.c` 的 `osThreadAttr_t` 一致(2026-10-14 校准,9 任务);改动栈大小前先读
|
||||
@@ -119,7 +119,7 @@ STM32F4-Base/
|
||||
│ └── gpio.h / dma.h / spi.h / i2c.h / usart.h
|
||||
├── App/ # 应用层代码
|
||||
│ ├── app/ # 应用入口与全局(app_main / app_cfg / sys_events)
|
||||
│ ├── algo/ # 采集与算法层(L1 adc_input / L2 phasor+freq / L3 prot_set+prot_elm)
|
||||
│ ├── algo/ # 采集与算法层(语义取数与有效性 adc_input / 全周傅氏相量 phasor+freq / 保护判据 prot_set+prot_elm)
|
||||
│ ├── cfg/ # 配置引擎(cfg_file 解析/持久化/迁移 + 存储后端)
|
||||
│ ├── fs/ # 卷锁(vol_lock,syslog/cfg/lftpd 三条路径 try 语义)
|
||||
│ ├── sync/ # 时间同步(time_sync 任务)
|
||||
@@ -128,9 +128,9 @@ STM32F4-Base/
|
||||
│ │ ├── default_task.c/h # 存储挂载 + 配置引擎属主 + syslog 写者
|
||||
│ │ ├── net_task.c/h # 网络任务
|
||||
│ │ ├── ui_task.c/h # UI 任务
|
||||
│ │ ├── adc_task.c/h # ADC 任务(L1/L2 纯消费者,TIM3 1kHz 唤醒)
|
||||
│ │ ├── adc_task.c/h # ADC 任务(语义取数与有效性/全周傅氏相量纯消费者,TIM3 1kHz 唤醒)
|
||||
│ │ ├── iec104_serv.c/h # IEC 60870-5-104 上行服务
|
||||
│ │ ├── protect_task.c/h # 保护判据任务(L3 20ms 节拍)
|
||||
│ │ ├── protect_task.c/h # 保护判据任务(保护判据 20ms 节拍)
|
||||
│ │ └── rs485_task.c/h # RS-485 任务(已实现,未创建,B2 暂缓)
|
||||
│ ├── util/ # 工具函数(crc / ringbuf / sys_clock)
|
||||
│ └── protocol/ # 通信协议(预留)
|
||||
@@ -394,7 +394,7 @@ pre-commit run --all-files
|
||||
| `Drivers/BSP/NET/net_socket.c` | BSD Socket API |
|
||||
| `Drivers/BSP/NET/net_events.c` | 芯片边沿事件处理 + 周期对账 |
|
||||
| `Drivers/BSP/NET/net_listener.c` | 监听生命周期(单一重建所有者) |
|
||||
| `App/algo/prot_elm.h` | L3 保护元件框架(判据消费入口) |
|
||||
| `App/algo/prot_elm.h` | 保护判据元件框架(判据消费入口) |
|
||||
| `.dsh/skills/keil-build/scripts/keil_build.py` | 编译脚本(`@build`) |
|
||||
| `.dsh/skills/serial-boot-test/scripts/run_boot_test.py` | 自动化测试脚本 |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user