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:
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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 板端网络割接)
|
||||
+2
-2
@@ -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
Reference in New Issue
Block a user