docs: clear task and layer shorthand IDs
Replace task/batch shorthand IDs and residual layer labels in human-facing docs with semantic phrases. Add the new cleanup policy to docs/编号规范.md and update the entry docs. Machine keys (TC/CODE-RULE/MENU-STATE/TRAP/FR), hardware designators/pins/MAC, protocol/version numbers and frozen historical evidence are intentionally kept. Docs only; no code behavior change. Verified with check_doc_links.py --all and git diff --check.
This commit is contained in:
@@ -21,7 +21,7 @@
|
||||
| USART1 | 串口 | PA9 TX, PA10 RX | 115200bps 调试串口 |
|
||||
| SD2506 RTC | I2C1 | PB6 SCL, PB7 SDA | 墙钟基准与日志时间戳 |
|
||||
| 6x LED | GPIO | PC5, PB0, PB1, PB2, PF11, PF12 | 低电平点亮 |
|
||||
| RS-485 | UART4 | PC10 TX, PC11 RX, PA15 DE | 半双工通信(B2 暂缓,见 `docs/任务规划/暂缓-RS485.md`) |
|
||||
| RS-485 | UART4 | PC10 TX, PC11 RX, PA15 DE | 半双工通信(暂缓,见 `docs/任务规划/暂缓-RS485.md`) |
|
||||
| SWD | — | PA13 SWDIO, PA14 SWCLK | 调试口 CN2(XH-3A) |
|
||||
|
||||
## 项目架构
|
||||
@@ -30,19 +30,19 @@
|
||||
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/(语义取数与有效性~保护判据)"]
|
||||
APPMAIN["app/app_main.c"] ~~~ NETTASK["task/net_task.c"] ~~~ UITASK["task/ui_task.c"] ~~~ TIMESYNC["sync/time_sync.c"] ~~~ ALGO["algo/(语义取数与有效性~保护判据)"]
|
||||
end
|
||||
subgraph BSP["驱动层 (Drivers/BSP/)"]
|
||||
direction LR
|
||||
B1["CH395F"] ~~~ B2["GD5F2GQ5UE"] ~~~ B3["TPAFE5160"] ~~~ B4["SD2506"] ~~~ B5["RS485"] ~~~ B6["UI"]
|
||||
ETH["CH395F"] ~~~ NAND["GD5F2GQ5UE"] ~~~ ADC["TPAFE5160"] ~~~ RTC["SD2506"] ~~~ RS485["RS485"] ~~~ UI["UI"]
|
||||
end
|
||||
subgraph MW["中间件 (Middlewares/ & Lib/)"]
|
||||
direction LR
|
||||
C1["FreeRTOS"] ~~~ C2["FatFs"] ~~~ C3["dhara FTL"] ~~~ C4["LVGL"]
|
||||
FREERTOS["FreeRTOS"] ~~~ FATFS["FatFs"] ~~~ DHARA["dhara FTL"] ~~~ LVGL["LVGL"]
|
||||
end
|
||||
subgraph HAL["HAL 层 / CMSIS"]
|
||||
direction LR
|
||||
D1["STM32F4xx_HAL_Driver/"] ~~~ D2["CMSIS/"]
|
||||
HALDRV["STM32F4xx_HAL_Driver/"] ~~~ CMSIS["CMSIS/"]
|
||||
end
|
||||
HW["硬件 (STM32F407ZGTx)"]
|
||||
APP --> BSP --> MW --> HAL --> HW
|
||||
@@ -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 节拍(保护判据元件 + 采样故障闭锁,B5) |
|
||||
| protectTask | 512 words | Normal | 保护判据 20ms 节拍(保护判据元件 + 采样故障闭锁) |
|
||||
<!-- TASK_TABLE:END -->
|
||||
|
||||
> 上表与 `Src/freertos.c` 的 `osThreadAttr_t` 一致(2026-10-14 校准,9 任务);改动栈大小前先读
|
||||
@@ -131,7 +131,7 @@ STM32F4-Base/
|
||||
│ │ ├── adc_task.c/h # ADC 任务(语义取数与有效性/全周傅氏相量纯消费者,TIM3 1kHz 唤醒)
|
||||
│ │ ├── iec104_serv.c/h # IEC 60870-5-104 上行服务
|
||||
│ │ ├── protect_task.c/h # 保护判据任务(保护判据 20ms 节拍)
|
||||
│ │ └── rs485_task.c/h # RS-485 任务(已实现,未创建,B2 暂缓)
|
||||
│ │ └── rs485_task.c/h # RS-485 任务(已实现,未创建,暂缓)
|
||||
│ ├── util/ # 工具函数(crc / ringbuf / sys_clock)
|
||||
│ └── protocol/ # 通信协议(预留)
|
||||
├── Drivers/
|
||||
@@ -421,7 +421,7 @@ pre-commit run --all-files
|
||||
| `docs/网络/BSD_Socket_API_使用指南.md` | BSD Socket API 使用指南(`net_socket` / `net_select`:线程安全 / 快速开始 / TCP / UDP / I/O 多路复用 / 事件回调 / API 参考 / 常见问题) |
|
||||
| `docs/网络/Net层阻塞模型架构设计.md` | NET 阻塞模型(挂起请求表五路语义,recv 一期 / SEND 二期已落地) |
|
||||
| `docs/网络/网络自愈架构设计.md` | 网络自愈架构(监听重建 / 沉降隔离 / 周期对账) |
|
||||
| `docs/子系统设计/IEC104上行设计说明.md` | IEC 60870-5-104 上行(工厂默认 :2404 监听,B4) |
|
||||
| `docs/子系统设计/IEC104上行设计说明.md` | IEC 60870-5-104 上行(工厂默认 :2404 监听) |
|
||||
| `docs/子系统设计/ADC采样节拍设计说明.md` | TIM3 1kHz 采样节拍(两片转换器同源硬件驱动) |
|
||||
| `docs/UI设计/UI_设计架构.md` | LVGL UI 系统架构(菜单 / 内容页 / 内存预算) |
|
||||
| `docs/UI设计/菜单页面设计.md` | 菜单导航行为、数据流与内容页设计 |
|
||||
|
||||
Reference in New Issue
Block a user