refactor(app): 去掉 App/protocol 层,104 迁入 App/iec60870/104_port

IEC 60870 是标准族(含 104/101),原 App/protocol/ 把它拆成
iec60870/(vendor 核心)+ iec104/(我方适配)两棵同级树,多一层且
看不出「104 只维护一个」。现按标准族收口:

  App/protocol/iec60870        -> App/iec60870
  App/protocol/iec104          -> App/iec60870/104_port
  App/protocol/{README.md,.gitkeep}  删除
  App/protocol/iec104/iec104_asdu.h  删除(零 include / 零注册的孤儿)

vendor 子树(104/ common/ examples/)逐字节未改:91 个 R100 重命名、
git diff --cached -M 后 0 insertions / 0 deletions,另按字节直比 89/89
一致;UPSTREAM.sha256 差异集仍等于既有 17 项受控差异,非篡改。
适配层只改注释里的路径字样,无逻辑行。

门禁配套:
- coding-standard 的 exclude 不能写祖先 App/iec60870/——rename_ref 机械
  改出的祖先形态会把 2,191 行适配层一起豁免掉。改为三条精确前缀
  common/ 104/ examples/,适配层 11/11 回到受检;vendor 直调脚本仍报
  88 处违规而钩子 Skipped,证明确实由 exclude 生效而非空跑。
- check_registration 的 KNOWN_GAPS 键与理由文本同步到新路径。

验证:Keil 0 errors 0 warnings(Code=367464 RO-data=48492
RW-data=2288 ZI-data=173544),构建日志与 .d 依赖证明 5 个适配 .o
真被编入;模拟器 0 警告并跑通 iec104-tcp 13/13 真实 TCP 回环;
pre-commit 25 Passed / 0 Failed;doc-links 30 处问题全在
IEC60870-Slave/ 供应商快照,我方文档零新增。

顺带删掉仓根误入库且零引用的 _all_hook.txt 与 _scope.txt。
This commit is contained in:
2026-11-18 14:15:10 +08:00
parent 263b00277e
commit c0cef2fca0
167 changed files with 29172 additions and 7007 deletions
+1 -1
View File
@@ -121,7 +121,7 @@ onToolCallBudget: wrap-up
8. **自研代码禁用 C 库堆分配**:只用 `pvPortMalloc/vPortFree`。MicroLIB 堆仅 512 B。
9. **RS-485 接线门禁:驱动契约未修完前,任何消费者都不得接 `rs485_on_rx()`**。
- **先说清"消费者"是什么**:`Drivers/BSP/RS485/rs485.c` 的 HAL 回调收满一帧后调 `rs485_on_rx(buf, size)`(`buf` 指向驱动内部那份 `rx_buf`,回调返回后即被下一次接收覆盖)。**重定义 `rs485_on_rx` 就是"接消费者"**——把数据拷进你的环/缓冲、交给 ModBus 解析、喂给算法,全都发生在这一句之后。不要把"接消费者"想成"写 `rs485_task.c`",任何形态的重定义都算。
- **当前状态:整簇冻结(用户裁定,2026-10-12 起)**,产品需求设计文档 §5.10 是权威表述:「`rs485_init()` 已调用;`rs485_task.c` 为空桩、未在 `freertos.c` 创建;`App/protocol/` 为该协议族预留(当前仅 104 在用)」;2026-11-13 又裁定**台架不接 RS-485 线、该端子只读噪声底**。所以现在连"跑起来看现象"都做不到——**门禁未解除不是保守,是物理上也验不了**。`App/task/rs485_task.c` 现状是空桩(`rs485_task_init()` 直接 `return 0`、`rs485_task_func()` 只有 `osDelay(100)`),且它至今未在 uvprojx 注册(`registration-check` 有一条存量 WARN 记录的就是它)。
- **当前状态:整簇冻结(用户裁定,2026-10-12 起)**,产品需求设计文档 §5.10 是权威表述:「`rs485_init()` 已调用;`rs485_task.c` 为空桩、未在 `freertos.c` 创建」;该节原还有一句「`App/protocol/` 为该协议族预留(当前仅 104 在用)」,**已于 2026-11-18 失效**(该层目录被删除,104 迁入 `App/iec60870/`,ModBus RTU 落点需确认),引文按此口径读;2026-11-13 又裁定**台架不接 RS-485 线、该端子只读噪声底**。所以现在连"跑起来看现象"都做不到——**门禁未解除不是保守,是物理上也验不了**。`App/task/rs485_task.c` 现状是空桩(`rs485_task_init()` 直接 `return 0`、`rs485_task_func()` 只有 `osDelay(100)`),且它至今未在 uvprojx 注册(`registration-check` 有一条存量 WARN 记录的就是它)。
- **解除条件(四条全绿才准开工;缺一条就是没解除)**:
① **单缓冲包撕裂**已消除——驱动只有一份 `rx_buf`(`RS485_RX_BUF_SIZE = 256`),回调把同一个指针交给消费者,消费者一旦拷得慢于下一帧到达就被覆盖。处置形态 = 双缓冲 + 帧序号,或改成驱动内部只负责投递、数据在回调内拷走(`docs/产品需求/产品需求设计文档.md` §5.10 设计约束②)。
② **TX 超时拉 DE 未等 TC** 已修——实测 `rs485_transmit`(`rs485.c` 的 `rs485_transmit`)在 `HAL_UART_Transmit` 失败/超时后**无条件** `RS485_DIR_RX()`,没有任何"等 TC"分支;半双工的经典后果是把末字节截断、或在自己还在发的时候把总线让给别人。`docs/产品需求/产品需求设计文档.md` §5.10 要求补一条**明确的超时路径**,不是靠 HAL 返回值顺手带过。
+13 -7
View File
@@ -155,12 +155,16 @@ repos:
types: [c]
# 范围与 cppcheck 钩子一致;另排除 CubeMX 生成文件(Src/、Inc/,重新生成即覆盖)、
# dhara/FatFS 接口适配层(nand_ftl,函数名由外部 API 固定)
# `App/protocol/iec60870/` 与 `IEC60870-Slave/` 是逐字节钉在 UPSTREAM.sha256 上的
# 第三方源码(IEC 60870-5-104 子站库,45k 行):函数命名/注释块/typedef 形态都是
# 上游风格,改一字节就等于篡改第三方(`verify_vendor.py` 会判定受控差异漂移)。
# 这就是本文档 §0 写明的"排除…第三方"口径落到实处;Lib/、Middlewares/、
# `App/iec60870/{common,104,examples}/` 与 `IEC60870-Slave/` 是逐字节钉在
# UPSTREAM.sha256 上的第三方源码(IEC 60870-5-104 子站库,45k 行):函数命名/注释块/
# typedef 形态都是上游风格,改一字节就等于篡改第三方(`verify_vendor.py` 会判定受控
# 差异漂移)。这就是本文档 §0 写明的"排除…第三方"口径落到实处;Lib/、Middlewares/、
# Drivers/CMSIS/ 同理。**我们自己的适配层不在排除面内**:
# App/protocol/iec104/ 全目录、App/task/、Drivers/BSP/NET/ 照旧受检。
# App/iec60870/104_port/ 全目录、App/task/、Drivers/BSP/NET/ 照旧受检。
# ⚠ 排除面必须逐条写成 vendor 子树前缀(common/、104/、examples/),**不能**写成祖先
# `App/iec60870/`:那会把同级的 104_port/(2,191 行自研适配层)一并吞掉——
# 2026-11-18 搬迁后实测回归(104_port/iec104_core.c 被判 EXCLUDED)。
# `104/` 带尾斜杠,不会误匹配 `104_port/`。
exclude: |
(?x)^(
Drivers/CMSIS/|
@@ -168,7 +172,9 @@ repos:
Drivers/BSP/NET/lftpd/|
Drivers/BSP/GD5F2GQ5UE/nand_ftl\.|
Drivers/BSP/dhara/|
App/protocol/iec60870/|
App/iec60870/common/|
App/iec60870/104/|
App/iec60870/examples/|
IEC60870-Slave/|
Lib/|
Middlewares/|
@@ -736,7 +742,7 @@ repos:
stages: [manual]
entry: scripts/gate_python.py scripts/check_iec104_tcp.py
language: system
files: ^(App/protocol/iec104/|App/protocol/iec60870/104/|test/host/iec104_dtu/|simulator/(sim|main\.c|CMakeLists\.txt)|scripts/check_iec104_tcp\.py$|\.pre-commit-config\.yaml$)
files: ^(App/iec60870/104_port/|App/iec60870/104/|test/host/iec104_dtu/|simulator/(sim|main\.c|CMakeLists\.txt)|scripts/check_iec104_tcp\.py$|\.pre-commit-config\.yaml$)
pass_filenames: false
# 13) 编号门禁的历史:2026-10-20 起曾有一版「全库语料审计」(规范 §8 的 8 项校验 +
+11 -1
View File
@@ -20,7 +20,7 @@ FreeRTOS/CMSIS-RTOS API**(本条与「就绪屏障位必须 `osFlagsNoClear`
| `log/` | **日志子系统**:syslog(NAND)+ 控制台单写者日志 | [`log/README.md`](log/README.md) |
| `task/` | **FreeRTOS 任务实现**(6 个任务) | [`task/README.md`](task/README.md) |
| `util/` | **通用工具**:CRC / 环形缓冲 / 墙钟时间 | [`util/README.md`](util/README.md) |
| `protocol/` | 通信协议(预留,当前为空) | [`protocol/README.md`](protocol/README.md) |
| `iec60870/` | **通信协议**:IEC 60870-5-104 只维护一个——vendor 子树(`common/` `104/` `examples/`)+ 我方适配层 `104_port/`(core/source/net_mcu/dtu_table/comm) | [`iec60870/IMPORT.md`](iec60870/IMPORT.md)(来源、补丁与验证边界);结构见本文末节 |
## 关键约束
@@ -29,6 +29,16 @@ FreeRTOS/CMSIS-RTOS API**(本条与「就绪屏障位必须 `osFlagsNoClear`
- **syslog 唯一写者**:`/log/*` 只由 defaultTask 写入
- 新增任务/缓冲/栈前**必须先核算 RAM 余量**(`docs/内存管理/`)
## 通信协议:`iec60870/` 结构
**104 只维护一个实现**(2026-11-18 由 `App/protocol/` 迁入,该中间层目录已删除)。
`iec60870/` 分两类内容,改动时先认清自己在哪一侧:
| 子目录 | 属于 | 内容 | 能否就地改 |
|---|---|---|---|
| `common/` `104/` `104/business/` `examples/` | **vendor 子树**(IEC60870-Slave 产品子集) | `common/`:ASDU/信息对象/时间编解码与 Slave 主体;`104/`:Link/Connection/TcpServer/SendManager 等 APCI 传输;`104/business/`:总召、命令、对时、文件服务等业务状态机;`examples/`:DTU 点表 profile | 有来源哈希与补丁清单约束 → 见 [`iec60870/IMPORT.md`](iec60870/IMPORT.md),改动须登记 |
| `104_port/` | **我方适配层**(11 个文件) | `iec104_core`(装配共享核心)、`iec104_source`(数据/模拟动作/参数 RAM/虚拟墙钟)、`iec104_net_mcu`(CH395F 网络后端)、`iec104_dtu_table`(标准 DTU 点表)、`iec104_comm`(`[comm]` 段) | 可改;设计口径 → `docs/子系统设计/IEC104上行设计说明.md` |
## 相关文档
- 架构全景:`docs/架构设计/项目架构总览.md`
+1 -1
View File
@@ -49,7 +49,7 @@ extern "C" {
#define MEAS_PERIOD_MS 200u
/* 每点品质位(uint16)。**低字节与线上 104 QDS 字节同值**(OV/NT/IV,数值
* 口径同 App/protocol/iec104/iec104_asdu.h 的 IEC104_QDS_*)——但本层**不得**
* 口径同 App/iec60870/104_port/iec104_asdu.h 的 IEC104_QDS_*)——但本层**不得**
* include 协议层头(分层方向:算法层在协议层之下,反向依赖禁止),故在此自
* 定义同值常量;104 侧消费(104 改读快照)直接截低字节上送,一致性由本目录单测与
* test/host/iec104/ 既有断言双向钉住。高字节为 meas 域扩展位(线上不直接
+1 -1
View File
@@ -3,7 +3,7 @@
* 模块功能:遥测死区(9 点)与通道标定系数覆盖(k/b 各 8 路)的**单一真源**:
* - 死区 = 本模块 int32 毫单位 RAM 副本(注册进 cfg 引擎 [run_par] 段,
* 工厂默认 = 「数据可信」下游常数按工程量重定后的额定 0.5 % 档),104 消费侧
* (App/protocol/iec104/iec104_pts.c)每拍实时读取——无投递、无缓存
* (App/iec60870/104_port/iec104_pts.c)每拍实时读取——无投递、无缓存
* 副本(104 改读快照曾在 pts 侧留运行时副本 s_yc_db,运行参数段落地后收编于此,
* 双源必打架);
* - 系数覆盖 = **直通 adc_cal_set() / adc_cal_set_ratio()**
@@ -25,7 +25,7 @@
/* ---------------- [comm] RAM 副本与工厂默认 ----------------
* 引擎属主 = defaultTask:本段只被 cfg_file_load/save/poll 通用遍历,本文件
* 不触引擎任何写路径;内核前注册点 = app_main.c(「先注册后 load」契约,同
* adc_cal_init / run_par_init)。App/protocol 零日志惯例保持——注册失败留痕
* adc_cal_init / run_par_init)。App/iec60870 零日志惯例保持——注册失败留痕
* 由调用方 app_main.c 锚点负责,getter/setter 纯 RAM 不打日志(iec104Task
* 深链省栈,日志成本见 docs/子系统设计/控制台单写者日志设计.md §7.1)。 */
@@ -154,7 +154,7 @@ uint8_t iec104_comm_dirty_peek(void) {
* 返回值:0 成功/无脏;-1 写盘失败 int
* 限定条件:**defaultTask(配置引擎属主)上下文**——run_par_store_save()
* 同一调用点旁挂,每轮无条件
* 函数说明:失败不打日志是刻意的(App/protocol 零日志惯例,本文件无 DBG):
* 函数说明:失败不打日志是刻意的(App/iec60870 零日志惯例,本文件无 DBG):
* cfg_file_save 自身已有 DBG_ERROR 留痕 + 脏位保留 = 屏上 ERR 的
* 判定源,再打一条就是重复锚点(日志成本见 docs/子系统设计/控制台单写者日志设计.md §7.1)
*/
@@ -2,7 +2,7 @@
* 模块名称:IEC 60870-5-104 通讯参数段([comm] 配置)公共接口
* 模块功能:/config.ini [comm] 段的对外契约——公共地址(CA = ASDU 公共地址,
* 2B)与被控站 TCP 监听端口的工厂默认、getter/setter 与合法带。
* 实现 = 配对文件 App/protocol/iec104/iec104_comm.c(coding-standard
* 实现 = 配对文件 App/iec60870/104_port/iec104_comm.c(coding-standard
* CODE-RULE-17 (2.2)「非 static 函数须在**配对头文件**声明」按文件名
* 判定;初版曾寄身 iec104_pts.c 尾段,2026-10-26 lead 纠偏迁出)。
* 修改记录:
@@ -1,6 +1,6 @@
/* 模块名称:IEC 60870-5-104 板端 Net 后端(netTask 单 owner) */
/*
* 模块功能:实现 App/protocol/iec60870/104/IEC104_Net.h 的全部导出 ABI,
* 模块功能:实现 App/iec60870/104/IEC104_Net.h 的全部导出 ABI,
* 底层走 Drivers/BSP/NET/net_socket.h 的 net_* 接口。
* 适用平台:STM32F407ZGTx + CH395F;只在 netTask 上下文中调用(threadless)。
* 创建日期:2026-11-17(task-18 板端网络割接)
@@ -1,9 +1,9 @@
/* 模块名称:参数值槽 rank 映射表(生成文件,勿手改)。 */
/* GENERATED FILE - do not edit by hand.
* Source: App/protocol/iec60870/examples/iec104_dtu_profile.h (const profile table).
* Source: App/iec60870/examples/iec104_dtu_profile.h (const profile table).
* Generator: ci-artifacts/iec104-cutover/gen_source_ranks.py
* Design: ci-artifacts/iec104-cutover/package-b-design.md
* Include exactly once, from App/protocol/iec104/iec104_source.c only.
* Include exactly once, from App/iec60870/104_port/iec104_source.c only.
*
* Ranks are uint16_t because the largest rank is 344 (configured) / 263 (writable),
* both above 0xFF. A uint8_t table would alias sentinel 0xFF with rank 255 and

Some files were not shown because too many files have changed in this diff Show More