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:
@@ -18,7 +18,7 @@
|
||||
| 相量(有效值/相角) | `App/algo/phasor.h` | 算法层 |
|
||||
| 频率 | `App/algo/freq.h` | 算法层 |
|
||||
| 定值(40 项 + 封存态) | `App/algo/prot_set.h` | 算法层 |
|
||||
| 遥信位图 / 品质 / 单双点性质 | `App/protocol/iec104/iec104_dtu_table.h`(2026-11-17 割接前为 `iec104_pts.h`,该实现已删除) | 协议层 |
|
||||
| 遥信位图 / 品质 / 单双点性质 | `App/iec60870/104_port/iec104_dtu_table.h`(2026-11-17 割接前为 `iec104_pts.h`,该实现已删除) | 协议层 |
|
||||
| 时钟 | `App/util/sys_clock.h` | 工具层(**已在 ALLOW 豁免内**) |
|
||||
| 运行/自检记录 | `App/log/sys_log.h` | 服务层 |
|
||||
|
||||
@@ -172,10 +172,10 @@ typedef struct {
|
||||
- **字符串只用定长数组**:`clock[20]` 在结构体内,无指针、无生命周期问题(跨层传指针是经典事故源)。
|
||||
- **`yx_valid` 与 `yx_bits` 分开**:无效点不参与显示、不参与变位判断(沿用 104 点表的既有做法,避免"IV 通道抖动成变位")。
|
||||
- **`yx_dp`**:单点还是双点是 **104 点表事实**,由写侧 `ui_data_feed.c` 的 `feed_yx_dp()` 逐点问点表 `type` 字段(1 = 单点、3 = 双点)后下发位图;页面只按位图选词(双点"合位/分位"、单点"动作/复归"、无效 "--")。把"前 4 点是双点"抄进表现层就是第二真相:点表改成双点段挪位或加高起始下标,屏上不会报错,只会用错词形容同一个点。
|
||||
**2026-11-17 通信骨架割接后,问的点表换了源**:旧的产品自有 33 点表实现 `App/protocol/iec104/iec104_pts.c`(`YX_N = 33`、`YX_DP_N = 4`,`iec104_pts_yx_is_dp()` 逐点判型)已随割接删除;现在问的是 DTU 标准表 `iec104_dtu_point()`(`App/protocol/iec104/iec104_dtu_table.c`)。两套点表语义不同:新表 index 0~58 是单点(0~42 → IOA 0x0001~0x002B,43~58 → 0x0032~0x0041,源表 0x002C~0x0031 空号)、59~74 是双点(IOA 0x1001 起)、75~104 是测量值,共 59 + 16 = 75 个遥信点,**双点不在 0~3 而在 59~74**。
|
||||
**2026-11-17 通信骨架割接后,问的点表换了源**:旧的产品自有 33 点表实现 `App/iec60870/104_port/iec104_pts.c`(`YX_N = 33`、`YX_DP_N = 4`,`iec104_pts_yx_is_dp()` 逐点判型)已随割接删除;现在问的是 DTU 标准表 `iec104_dtu_point()`(`App/iec60870/104_port/iec104_dtu_table.c`)。两套点表语义不同:新表 index 0~58 是单点(0~42 → IOA 0x0001~0x002B,43~58 → 0x0032~0x0041,源表 0x002C~0x0031 空号)、59~74 是双点(IOA 0x1001 起)、75~104 是测量值,共 59 + 16 = 75 个遥信点,**双点不在 0~3 而在 59~74**。
|
||||
**这不改变任何像素**:本字段只覆盖 `UI_DATA_YX_N = 33` 行,即新表的单点段;双点段落在 33 之外,取不到。而产品视图的 YX1~4(页面名表"位置1~4")在新表里是单点、旧表里是双点——这 4 点 V0.1 无开入硬件,不在 `yx_valid` 内,页面先按 valid 短路打 "--",走不到双点/单点选词分支,所以屏上无差异。**点表口径差异是既有事实,不是本节引入的问题。**
|
||||
点数一致性由写侧一条一次性 `DBG_ERROR` 兜(`UI_DATA_YX_N` 与 DTU 表 `SP_COUNT + DP_COUNT = 75` 不等时留痕)——该口径**自割接起会打且是应打的**:33 行产品视图与 75 点标准表本就不等,这条日志让差异现场可见,不影响显示。
|
||||
- **页面名表与 DTU 标准表同名下标语义不一致——这是既有事实,当前无运行期风险**。产品视图 `s_yx_name`(`Drivers/BSP/UI/ui_page_yx.c`)的前 33 行是按**旧产品点表**起的名;DTU 标准表同位置(前 59 个单点段中的同一 index)是另一批信号。逐点对照(下标取产品视图行号,DTU 侧取 `App/protocol/iec60870/examples/iec104_dtu_profile.h` 的 `dtu_signals[]` 原始名):
|
||||
- **页面名表与 DTU 标准表同名下标语义不一致——这是既有事实,当前无运行期风险**。产品视图 `s_yx_name`(`Drivers/BSP/UI/ui_page_yx.c`)的前 33 行是按**旧产品点表**起的名;DTU 标准表同位置(前 59 个单点段中的同一 index)是另一批信号。逐点对照(下标取产品视图行号,DTU 侧取 `App/iec60870/examples/iec104_dtu_profile.h` 的 `dtu_signals[]` 原始名):
|
||||
|
||||
| 下标 | 产品视图名(页面) | DTU 标准表同下标信号(原名 / 释义) |
|
||||
|---|---|---|
|
||||
@@ -418,7 +418,7 @@ ui_data_param_state() / ui_data_param_err_mask()(保存行显词 + 越界行
|
||||
|---|---|---|---|---|
|
||||
| 维护动作 | `ui_data_maint_ops_t`(`ui_data_maint_bind()`,uiTask 启动时绑) | `clock_set`(写后必须回读复核)/ `reset_req`(`prot_elm_request_reset()`)/ `active_count`(`popcount(prot_elm_active_mask())`)/ `oper_note`(`syslog_post_quiet(SYSLOG_OPER)`,谁触发谁投 104 与本地各一条)/ `clear_req`(`syslog_request_clear()`)/ `clear_state`(`syslog_clear_state()`) | 装置维护 3 页(对时 / 强制复归 / 清除记录) | `docs/UI设计/内容页架构.md` §7 |
|
||||
| 遥测整定 | `ui_data_yt_ops_t`(`ui_data_yt_bind()`,feed 首轮懒绑,先于 `ui_menu_init`) | 死区 9 行(电气 8 + 频率,与 104 0x8030~0x8038 同序)+ 系数 8 路:`db_n/db_row/db_set`、`cal_n/cal_row/cal_k_set`、`cal_blocked`、`pending` | 遥测整定页(`ui_w_ytview`) | 行语义/单位/上下限归 `App/algo/run_par.c` 与 `App/algo/adc_cal.c`;`unit`/`decimals` 归装配层 `ui_data_feed.c`;lo/hi 唯一出口 `run_par_db_range()` / `RUN_PAR_K_MAX_UV`,页面不得抄数 |
|
||||
| 通讯参数 | `ui_data_comm_ops_t`(`ui_data_comm_bind()`,与遥测整定同点位相邻) | `row` / `set` / `pending` 共 2 行:CA(1..65535,**改后重启生效**)与 104 端口(1024..65535,下次重 bind 监听生效) | 通讯设置页 | 真源 `App/protocol/iec104/iec104_comm.h`;行名行数归页面 |
|
||||
| 通讯参数 | `ui_data_comm_ops_t`(`ui_data_comm_bind()`,与遥测整定同点位相邻) | `row` / `set` / `pending` 共 2 行:CA(1..65535,**改后重启生效**)与 104 端口(1024..65535,下次重 bind 监听生效) | 通讯设置页 | 真源 `App/iec60870/104_port/iec104_comm.h`;行名行数归页面 |
|
||||
| 录波回放 | `ui_data_wave_ops_t`(`ui_data_wave_bind()`,uiTask 启动时绑) | 7 件:`manual_req`(手动触发录波)/ 入场作废缓存钩子 / `seg_first/seg_prev/seg_next`(段导航,环形回绕)/ `seg_head`(事件名+触发字+削顶)/ `seg_win`(40 点码值 + 窗口峰值) | 录波回放页 | 取数口径唯一真源 `docs/子系统设计/故障录波设计说明.md` §6.3 |
|
||||
|
||||
三条共用口径:
|
||||
|
||||
@@ -351,7 +351,7 @@ V0.1 **无直流采样通道**(`ADC_SEM` 只有 8 路电气 + 温度),点
|
||||
|
||||
### 3.3 三遥设置(5 页,阻塞于 `run_par`)
|
||||
|
||||
**现状**:死区是**编译期常量**——`App/protocol/iec104/iec104_pts.c` 的 `k_yc[].deadband`(第 244 行 `if (d > k_yc[i].deadband)`)。其余四项(系数/类型/防抖/双点)在固件里**完全没有对应结构**。(注:`iec104_pts` 实现已于 2026-11-17 割接删除,此处为立项时方案原文;引用的源码行号随之失效)
|
||||
**现状**:死区是**编译期常量**——`App/iec60870/104_port/iec104_pts.c` 的 `k_yc[].deadband`(第 244 行 `if (d > k_yc[i].deadband)`)。其余四项(系数/类型/防抖/双点)在固件里**完全没有对应结构**。(注:`iec104_pts` 实现已于 2026-11-17 割接删除,此处为立项时方案原文;引用的源码行号随之失效)
|
||||
|
||||
**所以这 5 页不是页面工作,是一个参数模型工作。**
|
||||
|
||||
|
||||
+1353
-56
File diff suppressed because it is too large
Load Diff
+14395
-279
File diff suppressed because it is too large
Load Diff
+12046
-4264
File diff suppressed because it is too large
Load Diff
|
Before Width: | Height: | Size: 522 KiB After Width: | Height: | Size: 1.2 MiB |
+69
-54
@@ -28,19 +28,23 @@ digraph refgraph_module {
|
||||
"test" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"其他(第三方)" [fillcolor="#f3f4f6", color="#9ca3af"];
|
||||
"外部/系统头文件" [shape=ellipse, fillcolor="#fef3c7", color="#d97706"];
|
||||
"App" -> "App/log" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App" -> "App/util" [color="#2563eb", penwidth=1.2, label="×4"];
|
||||
"App" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×4"];
|
||||
"App" -> "App/log" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"App" -> "App/task" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App" -> "App/util" [color="#2563eb", penwidth=1.2, label="×8"];
|
||||
"App" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×10"];
|
||||
"App" -> "BSP/GD5F2GQ5UE" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App" -> "BSP/NET" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App" -> "BSP/NET" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"App" -> "BSP/NETCFG" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App" -> "BSP/RS485" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App" -> "BSP/SD2506" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App" -> "BSP/TPAFE5160" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App" -> "FatFs" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"App" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×5"];
|
||||
"App" -> "test" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×28"];
|
||||
"App" -> "BSP/UI" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App" -> "FatFs" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"App" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×7"];
|
||||
"App" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×6"];
|
||||
"App" -> "test" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App" -> "其他(第三方)" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×89"];
|
||||
"App/log" -> "App" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"App/log" -> "App/util" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App/log" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
@@ -48,64 +52,69 @@ digraph refgraph_module {
|
||||
"App/log" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×5"];
|
||||
"App/log" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/log" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×8"];
|
||||
"App/task" -> "App" [color="#2563eb", penwidth=1.2, label="×18"];
|
||||
"App/task" -> "App/log" [color="#2563eb", penwidth=1.2, label="×6"];
|
||||
"App/task" -> "App/util" [color="#2563eb", penwidth=1.2, label="×12"];
|
||||
"App/task" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×7"];
|
||||
"App/task" -> "App" [color="#2563eb", penwidth=1.2, label="×42"];
|
||||
"App/task" -> "App/log" [color="#2563eb", penwidth=1.2, label="×9"];
|
||||
"App/task" -> "App/util" [color="#2563eb", penwidth=1.2, label="×14"];
|
||||
"App/task" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×10"];
|
||||
"App/task" -> "BSP/CH395F" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/task" -> "BSP/GD5F2GQ5UE" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/task" -> "BSP/NET" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"App/task" -> "BSP/NETCFG" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App/task" -> "BSP/RS485" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/task" -> "BSP/TPAFE5160" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/task" -> "BSP/UI" [color="#2563eb", penwidth=1.2, label="×4"];
|
||||
"App/task" -> "FatFs" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/task" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×9"];
|
||||
"App/task" -> "BSP/TPAFE5160" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App/task" -> "BSP/UI" [color="#2563eb", penwidth=1.2, label="×8"];
|
||||
"App/task" -> "FatFs" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App/task" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×10"];
|
||||
"App/task" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/task" -> "test" [color="#2563eb", penwidth=1.2, label="×4"];
|
||||
"App/task" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×3"];
|
||||
"App/util" -> "App" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/util" -> "App/log" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"App/util" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App/util" -> "BSP/SD2506" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/util" -> "BSP/SD2506" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"App/util" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×4"];
|
||||
"App/util" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×4"];
|
||||
"App/util" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×5"];
|
||||
"App/util" -> "lftpd" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/util" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×8"];
|
||||
"App/util" -> "test" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"App/util" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×11"];
|
||||
"BSP(公共)" -> "App/log" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"BSP(公共)" -> "App/util" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"BSP(公共)" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×1"];
|
||||
"BSP(公共)" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP(公共)" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP(公共)" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×9"];
|
||||
"BSP/CH395F" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"BSP/CH395F" -> "BSP/GD5F2GQ5UE" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"BSP/CH395F" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"BSP/CH395F" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×1"];
|
||||
"BSP/GD5F2GQ5UE" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/GD5F2GQ5UE" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"BSP/GD5F2GQ5UE" -> "FatFs" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/GD5F2GQ5UE" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"BSP/GD5F2GQ5UE" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/GD5F2GQ5UE" -> "dhara" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/GD5F2GQ5UE" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×4"];
|
||||
"BSP/NET" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×4"];
|
||||
"BSP/NET" -> "BSP/CH395F" [color="#2563eb", penwidth=1.2, label="×6"];
|
||||
"BSP/NET" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×18"];
|
||||
"BSP/NET" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×5"];
|
||||
"BSP/NET" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×6"];
|
||||
"BSP/NET" -> "BSP/CH395F" [color="#2563eb", penwidth=1.2, label="×7"];
|
||||
"BSP/NET" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×23"];
|
||||
"BSP/NET" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×6"];
|
||||
"BSP/NET" -> "test" [color="#2563eb", penwidth=1.2, label="×6"];
|
||||
"BSP/NET" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×7"];
|
||||
"BSP/NET" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×9"];
|
||||
"BSP/NETCFG" -> "App" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/NETCFG" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"BSP/NETCFG" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×4"];
|
||||
"BSP/NETCFG" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×6"];
|
||||
"BSP/RS485" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/RS485" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"BSP/SD2506" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"BSP/SD2506" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/SD2506" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/SD2506" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×1"];
|
||||
"BSP/TPAFE5160" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"BSP/TPAFE5160" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/TPAFE5160" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/TPAFE5160" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/TPAFE5160" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×1"];
|
||||
"BSP/UI" -> "App/log" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/UI" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×6"];
|
||||
"BSP/UI" -> "BSP/NET" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/UI" -> "BSP/NETCFG" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"BSP/UI" -> "LVGL" [color="#2563eb", penwidth=1.2, label="×9"];
|
||||
"BSP/UI" -> "BSP/NETCFG" [color="#2563eb", penwidth=1.2, label="×4"];
|
||||
"BSP/UI" -> "LVGL" [color="#2563eb", penwidth=1.2, label="×12"];
|
||||
"BSP/UI" -> "test" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"BSP/UI" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×20"];
|
||||
"BSP/UI" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×48"];
|
||||
"CMSIS" -> "HAL" [color="#94a3b8", penwidth=0.7, label="×1"];
|
||||
"CMSIS" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×22"];
|
||||
"FatFs" -> "App/util" [color="#94a3b8", penwidth=0.7, label="×1"];
|
||||
@@ -125,9 +134,10 @@ digraph refgraph_module {
|
||||
"LVGL" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×204"];
|
||||
"SDL2" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×36"];
|
||||
"Src/Inc (CubeMX)" -> "App" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"Src/Inc (CubeMX)" -> "App/task" [color="#2563eb", penwidth=1.2, label="×6"];
|
||||
"Src/Inc (CubeMX)" -> "App/log" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"Src/Inc (CubeMX)" -> "App/task" [color="#2563eb", penwidth=1.2, label="×5"];
|
||||
"Src/Inc (CubeMX)" -> "App/util" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"Src/Inc (CubeMX)" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"Src/Inc (CubeMX)" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×5"];
|
||||
"Src/Inc (CubeMX)" -> "BSP/CH395F" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"Src/Inc (CubeMX)" -> "BSP/GD5F2GQ5UE" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"Src/Inc (CubeMX)" -> "BSP/NET" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
@@ -149,29 +159,34 @@ digraph refgraph_module {
|
||||
"lftpd" -> "FatFs" [color="#94a3b8", penwidth=0.7, label="×2"];
|
||||
"lftpd" -> "FreeRTOS" [color="#94a3b8", penwidth=0.7, label="×2"];
|
||||
"lftpd" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×9"];
|
||||
"simulator" -> "App" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"simulator" -> "App" [color="#2563eb", penwidth=1.2, label="×12"];
|
||||
"simulator" -> "App/log" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"simulator" -> "BSP/NET" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"simulator" -> "BSP/NETCFG" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"simulator" -> "BSP/UI" [color="#2563eb", penwidth=1.2, label="×5"];
|
||||
"simulator" -> "BSP/UI" [color="#2563eb", penwidth=1.2, label="×9"];
|
||||
"simulator" -> "LVGL" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"simulator" -> "SDL2" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"simulator" -> "SDL2" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"simulator" -> "test" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"simulator" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×6"];
|
||||
"test" -> "App" [color="#2563eb", penwidth=1.2, label="×29"];
|
||||
"test" -> "App/log" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"simulator" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×8"];
|
||||
"test" -> "App" [color="#2563eb", penwidth=1.2, label="×80"];
|
||||
"test" -> "App/log" [color="#2563eb", penwidth=1.2, label="×16"];
|
||||
"test" -> "App/task" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"test" -> "App/util" [color="#2563eb", penwidth=1.2, label="×7"];
|
||||
"test" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×11"];
|
||||
"test" -> "BSP/CH395F" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"test" -> "BSP/GD5F2GQ5UE" [color="#2563eb", penwidth=1.2, label="×4"];
|
||||
"test" -> "BSP/NET" [color="#2563eb", penwidth=1.2, label="×6"];
|
||||
"test" -> "BSP/SD2506" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"test" -> "App/util" [color="#2563eb", penwidth=1.2, label="×15"];
|
||||
"test" -> "BSP(公共)" [color="#2563eb", penwidth=1.2, label="×30"];
|
||||
"test" -> "BSP/CH395F" [color="#2563eb", penwidth=1.2, label="×7"];
|
||||
"test" -> "BSP/GD5F2GQ5UE" [color="#2563eb", penwidth=1.2, label="×6"];
|
||||
"test" -> "BSP/NET" [color="#2563eb", penwidth=1.2, label="×49"];
|
||||
"test" -> "BSP/NETCFG" [color="#2563eb", penwidth=1.2, label="×8"];
|
||||
"test" -> "BSP/SD2506" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"test" -> "BSP/TPAFE5160" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"test" -> "FatFs" [color="#2563eb", penwidth=1.2, label="×3"];
|
||||
"test" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×10"];
|
||||
"test" -> "BSP/UI" [color="#2563eb", penwidth=1.2, label="×10"];
|
||||
"test" -> "FatFs" [color="#2563eb", penwidth=1.2, label="×11"];
|
||||
"test" -> "FreeRTOS" [color="#2563eb", penwidth=1.2, label="×25"];
|
||||
"test" -> "HAL" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"test" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×7"];
|
||||
"test" -> "lftpd" [color="#2563eb", penwidth=1.2, label="×1"];
|
||||
"test" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×43"];
|
||||
"test" -> "Src/Inc (CubeMX)" [color="#2563eb", penwidth=1.2, label="×8"];
|
||||
"test" -> "dhara" [color="#2563eb", penwidth=1.2, label="×2"];
|
||||
"test" -> "lftpd" [color="#2563eb", penwidth=1.2, label="×12"];
|
||||
"test" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×142"];
|
||||
"其他(第三方)" -> "App" [color="#94a3b8", penwidth=0.7, label="×128"];
|
||||
"其他(第三方)" -> "外部/系统头文件" [color="#94a3b8", penwidth=0.7, label="×112"];
|
||||
}
|
||||
|
||||
+1086
-981
File diff suppressed because it is too large
Load Diff
|
Before Width: | Height: | Size: 106 KiB After Width: | Height: | Size: 120 KiB |
@@ -43,10 +43,10 @@
|
||||
<text x="1255" y="275" font-size="13" fill="#1e293b" text-anchor="middle">task/(9 任务)</text>
|
||||
<rect x="811" y="300" width="421" height="38" rx="8" fill="#ffffff" stroke="#0d9488" stroke-opacity="0.55"/>
|
||||
<text x="1021" y="323" font-size="13" fill="#1e293b" text-anchor="middle">algo/(语义取数与有效性~保护判据 · 遥测快照 · 录波数据面)</text>
|
||||
<rect x="811" y="348" width="298" height="38" rx="8" fill="#ffffff" stroke="#0d9488" stroke-opacity="0.55"/>
|
||||
<text x="960" y="371" font-size="13" fill="#1e293b" text-anchor="middle">protocol/iec104(104 上行默认 :2404)</text>
|
||||
<rect x="1119" y="348" width="227" height="38" rx="8" fill="#ffffff" stroke="#0d9488" stroke-opacity="0.55"/>
|
||||
<text x="1233" y="371" font-size="13" fill="#1e293b" text-anchor="middle">ui_data_feed(App→UI 装配)</text>
|
||||
<rect x="811" y="348" width="427" height="38" rx="8" fill="#ffffff" stroke="#0d9488" stroke-opacity="0.55"/>
|
||||
<text x="1024" y="371" font-size="13" fill="#1e293b" text-anchor="middle">iec60870/(104 上行默认 :2404;vendor 子树 + 104_port)</text>
|
||||
<rect x="1248" y="348" width="227" height="38" rx="8" fill="#ffffff" stroke="#0d9488" stroke-opacity="0.55"/>
|
||||
<text x="1362" y="371" font-size="13" fill="#1e293b" text-anchor="middle">ui_data_feed(App→UI 装配)</text>
|
||||
<rect x="811" y="396" width="208" height="38" rx="8" fill="#ffffff" stroke="#0d9488" stroke-opacity="0.55"/>
|
||||
<text x="915" y="419" font-size="13" fill="#1e293b" text-anchor="middle">sys_log · soe(记录引擎)</text>
|
||||
<rect x="1029" y="396" width="264" height="38" rx="8" fill="#ffffff" stroke="#0d9488" stroke-opacity="0.55"/>
|
||||
|
||||
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
@@ -170,7 +170,7 @@ flowchart LR
|
||||
| G1 | **可靠**:现场死机可自恢复、掉电不丢配置、错误可追溯 | IWDG + 任务心跳位图、原子写 + 迁移、错误码通道四要素 |
|
||||
| G2 | **可维护**:分层解耦、单一事实源、双端复用、门禁强制 | 六层架构、就绪屏障、生成器(菜单/字体/任务表)、pre-commit 钩子族 |
|
||||
| G3 | **可移植**:UI/配置源码 MCU 与 PC 模拟器共用 | 平台后端抽象(`*_mcu.c` / `*_sim.c`),核心零平台依赖 |
|
||||
| G4 | **可扩展**:新子系统/新配置段/新页面按模板接入 | 事件位扩展、段注册三步、页面插件描述符、`App/protocol/` 预留 |
|
||||
| G4 | **可扩展**:新子系统/新配置段/新页面按模板接入 | 事件位扩展、段注册三步、页面插件描述符、协议族自成一域(104 在 `App/iec60870/`) |
|
||||
| G5 | **可验收**:每项能力有明确判据与自动化门禁 | `/keil-build` / `/serial-boot-test` / 静态门禁 / 主机侧纯逻辑单测 / 台架验证 |
|
||||
|
||||
**设计原则**(贯穿全项目):
|
||||
@@ -475,8 +475,10 @@ flowchart LR
|
||||
### 5.10 RS-485 采集(FR-RS485)⬜ 冻结
|
||||
|
||||
- **需求(已确认)**:半双工 RS-485 **对下 ModBus RTU 采集**(下行采集口;上行走以太网 104)。
|
||||
- **现状**:`rs485_init()` 已调用;`rs485_task.c` 为空桩、未在 `freertos.c` 创建;`App/protocol/` 为该
|
||||
协议族预留(当前仅 104 在用)。**整簇冻结**(用户决定,2026-10-12)。
|
||||
- **现状**:`rs485_init()` 已调用;`rs485_task.c` 为空桩、未在 `freertos.c` 创建。原表述「`App/protocol/`
|
||||
为该协议族预留(当前仅 104 在用)」**已于 2026-11-18 失效**:`App/protocol/` 这一层被删除,104 迁入
|
||||
`App/iec60870/`(vendor 子树 + `104_port/` 适配层)。ModBus RTU 协议族将来的落点**需确认**——不再存在
|
||||
一个集中收容协议实现的预留目录。**整簇冻结**(用户决定,2026-10-12)。
|
||||
- **重启门禁**:先修「单缓冲包撕裂」「TX 超时拉 DE 未等 TC」两条,再谈接消费者。
|
||||
- **动手前必须落实的三条设计约束**(事后无法补测——撕裂与错误路径在真机上不可稳定复现。
|
||||
本条收口原「测试与架构专项」2026-10-28 删除后唯一未闭环的约束):
|
||||
@@ -642,7 +644,7 @@ flowchart LR
|
||||
|
||||
**FR-IEC104-1 链路层**
|
||||
- 需求:APCI U/S/I 帧、STARTDT/STOPDT/TESTFR、k/w 窗、t1/t2/t3;TCP 流重组与坏帧自恢复。
|
||||
- 实现:`App/protocol/iec104/iec104_link.c`(纯逻辑:收=喂流、发=回调、时基注入);参数 k=12 / w=8 /
|
||||
- 实现:`App/iec60870/104_port/iec104_link.c`(纯逻辑:收=喂流、发=回调、时基注入);参数 k=12 / w=8 /
|
||||
t1=15 s / t2=10 s / t3=20 s;序号 15 bit 回绕、超时一律差值法。
|
||||
- 判据:主机侧 174 断言全绿;台架主站往返 STARTDT → 总召四组 → actterm 全通过。
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@
|
||||
|
||||
把全部可写参数纳入统一的提交语义,因为只为真实保护参数落盘会遗漏标准参数、区域参数和模拟项。
|
||||
|
||||
**事实**:`App/protocol/iec104/iec104_source.h` 的 `iec104_source_bind()` 要求平台整批校验与原子应用,但现行 `iec104_source_init()` 明确恢复类型化默认值;这不是新产品掉电保持实现。
|
||||
**事实**:`App/iec60870/104_port/iec104_source.h` 的 `iec104_source_bind()` 要求平台整批校验与原子应用,但现行 `iec104_source_init()` 明确恢复类型化默认值;这不是新产品掉电保持实现。
|
||||
|
||||
**事实**:持久化调查 `ci-artifacts/iec104-mcu-plan/persistence/report.md` 及其 `audit_parameters.py` 逐项核出远方参数 264 个可写元数据:176 个全局项、88 个区域项;区域 0 与区域 1~4 各持一份区域值,合计 616 个可写区域实例。标准参数 120 项与远方参数没有信息对象地址(IOA)交集,当前源码也没有别名桥;加总是 736 个值槽,而不是业务同义已获裁定。`iec104_core.c` 的 QPA3(参数激活限定词)在当前装配仅控制一个组的遥测周期启停,此状态也须持久,不包含在上述值槽数内;编码未批。标准参数的限定词与逐点激活语义仍需和实际装配逐项冻结,不能把库支持的所有扩展当作已开放,也不能静默只保存 120 个数值。
|
||||
|
||||
|
||||
+19
-16
@@ -3,22 +3,24 @@
|
||||
> **定位**:DTU 上行规约 IEC 60870-5-104(DL/T 634.5104-2009)的设计基线——
|
||||
> 范围、点表、链路流程、板端接入、预算与测试。规格来源
|
||||
> `docs/算法/继电保护功能复现规划.md` §1.5(产品定义,验收 = 省电科院点表);
|
||||
> 代码落点 `App/protocol/iec104/`;未闭环的送检验收见本文 §8。
|
||||
> 代码落点 `App/iec60870/104_port/`;未闭环的送检验收见本文 §8。
|
||||
> **角色**:本 DTU = **被控站(受控端)**,104 **TCP 服务器,端口 `[comm]` 段 `port`(工厂默认 2404)**;主站
|
||||
> (控制端,点表参考 `192.168.1.199`)主动连入。
|
||||
|
||||
## 0. 成熟协议核心迁入状态与验证边界
|
||||
|
||||
本节说明正在迁入的 `IEC60870-Slave` 产品子集。**下文 §1 至 §8 仍描述既有板端实现及其历史验证,不代表新核心已经替换板端。** 当前旧 asdu/pts/link 与 `App/task/iec104_serv.c` 仍保留;删除旧栈必须在板端切换、资源闭环及实际验证后进行。
|
||||
本节说明正在迁入的 `IEC60870-Slave` 产品子集。**下文 §1 至 §8 仍描述既有板端实现及其历史验证,不代表新核心已经替换板端。**
|
||||
|
||||
> **2026-11-18 补记(旧栈状态已变,此处按日期冻结)**:本节原写「当前旧 asdu/pts/link 与 `App/task/iec104_serv.c` 仍保留;删除旧栈必须在板端切换、资源闭环及实际验证后进行」——**该描述在当天之后失效**:`iec104_asdu/pts/link` 三源在同一日随骨架迁 MCU 删除(`App/task/iec104_serv.c` 被重写为新契约,不再含旧胶水),`App/protocol/` 这一层整体并入 `App/iec60870/`。§1–§8 保留为历史实现记录,其中出现的 `App/protocol/iec104/…` 路径与 `iec104Task` 承载描述均属当时事实;当前结构见 §0.1 与 `App/README.md`。
|
||||
|
||||
### 0.1 装配与生命周期
|
||||
|
||||
| 落点 | 当前职责 | 不能据此推断 |
|
||||
|---|---|---|
|
||||
| `App/protocol/iec60870/` | 成熟 ASDU、Slave、业务状态机、TcpServer 与网络后端;来源见 `App/protocol/iec60870/IMPORT.md` | 目录迁入不等于 MCU 集成通过 |
|
||||
| `App/protocol/iec104/iec104_core.c` | `iec104_core_start()` / `iec104_core_poll()` / `iec104_core_stop()` 装配共享核心;`iec104_core_get_status()` 提供状态 | PC 运行不证明 CH395F、RTOS 或板端监听生命周期正确 |
|
||||
| `App/protocol/iec104/iec104_source.c` | 数据、模拟动作、参数 RAM 与虚拟设备墙钟;`iec104_source_bind()` 是可选平台接缝 | 接口存在不等于已绑定 UI、保护或标定真源 |
|
||||
| `App/protocol/iec104/iec104_dtu_table.c` | 标准 DTU 演示点表与元数据 | 新旧通信地址相同不代表语义相同;候选映射不代表真实绑定 |
|
||||
| `App/iec60870/` | 成熟 ASDU、Slave、业务状态机、TcpServer 与网络后端;来源见 `App/iec60870/IMPORT.md` | 目录迁入不等于 MCU 集成通过 |
|
||||
| `App/iec60870/104_port/iec104_core.c` | `iec104_core_start()` / `iec104_core_poll()` / `iec104_core_stop()` 装配共享核心;`iec104_core_get_status()` 提供状态 | PC 运行不证明 CH395F、RTOS 或板端监听生命周期正确 |
|
||||
| `App/iec60870/104_port/iec104_source.c` | 数据、模拟动作、参数 RAM 与虚拟设备墙钟;`iec104_source_bind()` 是可选平台接缝 | 接口存在不等于已绑定 UI、保护或标定真源 |
|
||||
| `App/iec60870/104_port/iec104_dtu_table.c` | 标准 DTU 演示点表与元数据 | 新旧通信地址相同不代表语义相同;候选映射不代表真实绑定 |
|
||||
|
||||
调用必须由同一事件循环属主串行执行,源回调须短且不阻塞。`start` 拒绝重复启动;失败清理后仍持有资源时须重试 `stop`,不得直接再次启动。每次被接纳的服务启动重置模拟值、参数 RAM、计数及设备墙钟;普通 TCP 重连保留已提交 RAM 值,但取消未完成的选择与参数预置事务。模拟“固化”仅提交运行时 RAM,不是断电保持。
|
||||
|
||||
@@ -60,9 +62,9 @@
|
||||
|
||||
### 0.5 骨架阶段的记录缺口(有意收窄,不是回归 bug)
|
||||
|
||||
**旧板端实现会写遥控与对时记录。** `git show HEAD:App/protocol/iec104/iec104_pts.c` 的 `s_src_yk_exec()` 有 7 处 `syslog_post_quiet()` 写 `SYSLOG_YK`(`/log/yk.log`),覆盖 8 种文案:`YK11 select`、`YK11 exec`、`YK12 select`、`YK12 exec on`、`YK12 exec off`、`YK12 exec fail`、`YK12 bad dpc`、`YK unknown ioa`;同一函数另有 2 处写 `SYSLOG_OPER`(`/log/oper.log`),覆盖 3 种文案:YK11 执行段调 `prot_elm_request_reset()` 后写 `force reset`,YK12 执行段调 `prot_set_set_sealed(PS_GLOBAL_EN, …)` 成功/失败后写 `plate in` / `plate out`。`git show HEAD:App/task/iec104_serv.c` 的 `s_clock_sync()` 在 `sys_clock_set_unix()` 返回 0 时写 `SYSLOG_OPER` 的 `clock set by 104`。
|
||||
**旧板端实现会写遥控与对时记录。** 取旧实现请用**删文件前的那个提交**,不能用 `HEAD`:`iec104_pts.c` 在 `90cc9a7d`(2026-11-18 骨架迁 MCU)被删除,`App/task/iec104_serv.c` 也在同一次提交里重写成新契约,所以 `git show HEAD:…iec104_pts.c` 直接报 `path does not exist`、`git show HEAD:App/task/iec104_serv.c` 里已无 `s_clock_sync()`。可复现的证据锚点 = `2e9272cc`(2026-11-17,两文件都在),路径按当时的目录名 `App/protocol/` 写:`git show 2e9272cc:App/protocol/iec104/iec104_pts.c` 的 `s_src_yk_exec()` 有 7 处 `syslog_post_quiet()` 写 `SYSLOG_YK`(`/log/yk.log`),覆盖 8 种文案:`YK11 select`、`YK11 exec`、`YK12 select`、`YK12 exec on`、`YK12 exec off`、`YK12 exec fail`、`YK12 bad dpc`、`YK unknown ioa`;同一函数另有 2 处写 `SYSLOG_OPER`(`/log/oper.log`),覆盖 3 种文案:YK11 执行段调 `prot_elm_request_reset()` 后写 `force reset`,YK12 执行段调 `prot_set_set_sealed(PS_GLOBAL_EN, …)` 成功/失败后写 `plate in` / `plate out`。`git show 2e9272cc:App/task/iec104_serv.c` 的 `s_clock_sync()` 在 `sys_clock_set_unix()` 返回 0 时写 `SYSLOG_OPER` 的 `clock set by 104`。
|
||||
|
||||
**迁移后的共享核心不写这些记录,因为无真事实可写。** `iec104_source_command()`(`App/protocol/iec104/iec104_source.c`,函数头注释「改变模拟遥信并标识替代源,绝不驱动物理出口」)是纯模拟态变更:选择段立即返回,执行段只改模拟 IOA 的状态与统计,其中复位动作的注释明确「只复归模拟锁存,绝不复归真实保护状态」。`App/protocol/` 与 `App/task/iec104_serv.c` 对 `prot_elm_request_reset` 与 `PS_GLOBAL_EN` 均为 0 次引用,即新核心不触碰任何真实控制目标(与 §0.2「遥控全部为模拟动作」同一事实)。因此骨架档若照旧写 `force reset` 或 `plate in/out`,写下的将是**伪造记录**——不写是当前唯一诚实的做法。
|
||||
**迁移后的共享核心不写这些记录,因为无真事实可写。** `iec104_source_command()`(`App/iec60870/104_port/iec104_source.c`,函数头注释「改变模拟遥信并标识替代源,绝不驱动物理出口」)是纯模拟态变更:选择段立即返回,执行段只改模拟 IOA 的状态与统计,其中复位动作的注释明确「只复归模拟锁存,绝不复归真实保护状态」。`App/protocol/` 与 `App/task/iec104_serv.c` 对 `prot_elm_request_reset` 与 `PS_GLOBAL_EN` 均为 0 次引用(当时目录名为 `App/protocol/`,2026-11-18 重构为 `App/iec60870/`;此句记录的是那次 grep 的当时范围,不改写成新路径),即新核心不触碰任何真实控制目标(与 §0.2「遥控全部为模拟动作」同一事实)。因此骨架档若照旧写 `force reset` 或 `plate in/out`,写下的将是**伪造记录**——不写是当前唯一诚实的做法。
|
||||
|
||||
**可感知后果**(按用户可见面):
|
||||
|
||||
@@ -92,11 +94,11 @@
|
||||
|
||||
| 模块 | 文件 | 职责 | I/O |
|
||||
|---|---|---|---|
|
||||
| ASDU 编解码 | `App/protocol/iec104/iec104_asdu.c/h` | 类型/COT 常量、ASDU 头、IOA 3B 小端、短浮点、CP56Time2a↔epoch | 零 |
|
||||
| 点表/数据源 | `App/protocol/iec104/iec104_pts.c/h` | YC/YX/YK/定值表、COV(变位+死区)、**数据源 vtable**(板端绑 phasor/prot_*,单测绑假源) | 零(源注入) |
|
||||
| 链路状态机 | `App/protocol/iec104/iec104_link.c/h` | TCP 流重组、U/S/I、k/w/t1/t2/t3、总召/突发/遥控/定值/对时编排 | 零(收=on_rx 喂流,发=回调,时基注入) |
|
||||
| ASDU 编解码 | 旧 `App/protocol/iec104/iec104_asdu.c/h`(**已删除 2026-11-18**,现由 vendor `App/iec60870/common/` 承担) | 类型/COT 常量、ASDU 头、IOA 3B 小端、短浮点、CP56Time2a↔epoch | 零 |
|
||||
| 点表/数据源 | 旧 `App/protocol/iec104/iec104_pts.c/h`(**已删除 2026-11-18**,现由 `App/iec60870/104_port/iec104_dtu_table.c` + `iec104_source.c` 承担) | YC/YX/YK/定值表、COV(变位+死区)、**数据源 vtable**(板端绑 phasor/prot_*,单测绑假源) | 零(源注入) |
|
||||
| 链路状态机 | 旧 `App/protocol/iec104/iec104_link.c/h`(**已删除 2026-11-18**,现由 vendor `App/iec60870/104/IEC104_Link*` 与 `104_port/iec104_core.c` 承担) | TCP 流重组、U/S/I、k/w/t1/t2/t3、总召/突发/遥控/定值/对时编排 | 零(收=on_rx 喂流,发=回调,时基注入) |
|
||||
| 板端胶水 | `App/task/iec104_serv.c/h`(随实现定名) | `[comm]` port 监听(工厂默认 2404)、数据通道收发、断链重听、netTask 驱动 | 全部(net_* API) |
|
||||
| 通讯参数段 | `App/protocol/iec104/iec104_comm.c/h`(道G task-8) | `[comm]` 段注册 + ca/端口 getter 合法带自愈 / setter 守卫 | cfg_file 引擎(只注册不属主) |
|
||||
| 通讯参数段 | `App/iec60870/104_port/iec104_comm.c/h`(道G task-8) | `[comm]` 段注册 + ca/端口 getter 合法带自愈 / setter 守卫 | cfg_file 引擎(只注册不属主) |
|
||||
|
||||
> 三个纯逻辑模块 + 真实数据源(`App/algo/` 全纯逻辑)可整体在主机侧编译 →
|
||||
> 主机侧纯逻辑单测覆盖**全协议栈**(`test/host/iec104/` 已删除 2026-11-18,随旧自研协议层三源退役),与 `test/host/prot_elm/` 同模式。
|
||||
@@ -198,8 +200,8 @@
|
||||
| 其余 | 留白(PT/CT 变比等未启用类别) | — | — | C_RD → COT14+EVI / C_SE → actcon+PN |
|
||||
|
||||
- `0x8027~0x802A` 是 prot_set 告警段(过压/欠压),**run_par 命中集精确匹配、永不覆盖**;
|
||||
两表共存的路由顺序 = **run_par 表先、未命中落 prot_set**(`iec104_pts.c` set 路由,
|
||||
证据钉在 TC-IEC104-029)。
|
||||
两表共存的路由顺序 = **run_par 表先、未命中落 prot_set**(旧 `App/protocol/iec104/iec104_pts.c`
|
||||
的 set 路由,该文件 2026-11-18 已删除;证据钉在 TC-IEC104-029)。
|
||||
- 现行门控 = 两段式 + 范围/合法带校验(与保护定值同款),**无「仅暂停/测试态可写」
|
||||
门控**——文档现行如此,不造新语义;若送检点表要求该类门控,接线点在
|
||||
`run_par_104_write` 执行段入口,加一处即可。
|
||||
@@ -230,7 +232,7 @@
|
||||
- **承载任务 = 专用 iec104Task(640 words / Normal)**,非 netTask:netTask 是
|
||||
socket RPC 执行者,`net_recv/net_send` 在 netTask 内调用 = 自己等自己回执(死锁)。
|
||||
手写于 `Src/freertos.c` USER CODE 区(timeSyncTask/adcTask 同款先例),文件
|
||||
`App/task/iec104_serv.c`(纯编排,协议语义全在 `App/protocol/iec104/`)。
|
||||
`App/task/iec104_serv.c`(纯编排,协议语义全在 `App/iec60870/104_port/`)。
|
||||
- **看门狗**:`TASK_WD_IEC104 = 7` 纳入 `wd_required_mask()` 两分支(产品 0x1F7 /
|
||||
HW 测试层 0x1F5,含 保护任务 protect 位 bit8);主循环 100ms 节拍喂位,屏障等待按
|
||||
100ms 分片喂位(timeSyncTask 2026-10-02 台架先例)。
|
||||
@@ -285,7 +287,8 @@
|
||||
**任意上下文可读**(不取锁、不读时刻、不碰 socket;四枚 u32 单字原子,跨字段不保证同一
|
||||
瞬间,四枚之间没有"合起来才成立"的判据),到顶饱和不回绕。**「总召次数 / 上送 I 帧数」
|
||||
不在这里**:那是 link 层事件,serv 照不到,需要它得去
|
||||
`App/protocol/iec104/iec104_link.c` 加——本卡未做,别在页面上摆一个数却没有产生它的地方。
|
||||
旧 `App/protocol/iec104/iec104_link.c` 加(该文件 2026-11-18 已删除;当前对应实现在
|
||||
vendor `App/iec60870/104/IEC104_Link*`)——本卡未做,别在页面上摆一个数却没有产生它的地方。
|
||||
|
||||
## 6. RAM / 栈预算(2026-10-12 实测)
|
||||
|
||||
|
||||
@@ -161,7 +161,7 @@ write=1
|
||||
|
||||
### 3.5 `[comm]` 段:IEC 60870-5-104 通讯参数(2026-10-26 新增,「UI 补齐」波次里的非 UI 前置项,道G task-8)
|
||||
|
||||
104 被控站的公共地址与监听端口持久载体(段属主 = `App/protocol/iec104/` 配对模块:
|
||||
104 被控站的公共地址与监听端口持久载体(段属主 = `App/iec60870/104_port/` 配对模块:
|
||||
工厂默认与合法带见 `iec104_comm.h`、键表与实现见 `iec104_comm.c`;注册
|
||||
`iec104_comm_init()` 在
|
||||
`app_main_init()` 内核前——「先注册后 load」契约同 [adc_cal] / [run_par]):
|
||||
|
||||
@@ -137,7 +137,7 @@ db_freq=500
|
||||
| `ca` | 无符号 | `1` | 公共地址 CA(1~65535) |
|
||||
| `port` | 无符号 | `2404` | 104 服务端口(1024~65535) |
|
||||
|
||||
**改后需重启生效**(该链路在任务启动时建立连接参数)。来源 `App/protocol/iec104/iec104_comm.c`。
|
||||
**改后需重启生效**(该链路在任务启动时建立连接参数)。来源 `App/iec60870/104_port/iec104_comm.c`。
|
||||
|
||||
### 2.5 `[adc_cal]`、`[adc_cal_ofs]`、`[adc_cal_sec]`:采集标定
|
||||
|
||||
@@ -325,7 +325,7 @@ flowchart TD
|
||||
| `[network]` | 4 | `Drivers/BSP/NETCFG/net_cfg.c` | 有(触发网络重建) | 保存后立即重建网络 |
|
||||
| `[ftp]` | 3 | `Drivers/BSP/NETCFG/ftp_cfg.c` | 无 | 下次登录生效 |
|
||||
| `[sntp]` | 4 | `Drivers/BSP/NETCFG/sntp_cfg.c` | 无 | 客户端每轮直读 RAM 副本 |
|
||||
| `[comm]` | 2 | `App/protocol/iec104/iec104_comm.c` | 无 | 改后重启生效 |
|
||||
| `[comm]` | 2 | `App/iec60870/104_port/iec104_comm.c` | 无 | 改后重启生效 |
|
||||
| `[adc_cal]` | 9 | `App/algo/adc_cal.c` | 无 | 消费方按拍直读 |
|
||||
| `[adc_cal_ofs]` | 8 | `App/algo/adc_cal.c` | 无 | 同上 |
|
||||
| `[adc_cal_sec]` | 8 | `App/algo/adc_cal.c` | 无 | 同上 |
|
||||
|
||||
+14
-6
@@ -63,7 +63,10 @@
|
||||
|
||||
## 4. 解析原理(与编译器行为对齐)
|
||||
|
||||
1. 扫描仓库全部 `.c/.h`(跳过 `.git`/`.venv`/`MDK-ARM`/`docs`/`simulator/build`);
|
||||
1. 扫描仓库全部 `.c/.h`(跳过 `.git`/`.venv`/`MDK-ARM`/`docs`/`simulator/build`/**`ci-artifacts`**);
|
||||
`ci-artifacts/` 是一次性取证与构建产物区(`.gitignore` 挡掉、不入库),里面的桩文件、旧基线
|
||||
副本与探针 `.c` 会经 `#include` 相对路径拉进幽灵节点(实测曾把已删除的 `iec104_pts.c` /
|
||||
`iec104_link.c` 拉回图中),且"本机有没有这个目录"会导致产物不同——排除它图才可复现;
|
||||
2. 提取每条 `#include`(处理行尾反斜杠续行;编码按 UTF-8→GBK→Latin-1 兜底);
|
||||
3. 解析顺序与编译器一致:**所在文件目录 → Keil 工程包含路径(解析自
|
||||
`MDK-ARM/STM32F407-Demo.uvprojx`,自动跟随)→ 模拟器 CMake 包含路径
|
||||
@@ -94,9 +97,14 @@
|
||||
- 换机:`winget install Graphviz.Graphviz`(渲染依赖;缺失时工具自动跳过渲染,
|
||||
仍产出 `.dot`)。
|
||||
|
||||
## 7. 当前数据(2026-10-14 刷新)
|
||||
## 7. 当前数据(2026-11-18 刷新,含 `App/iec60870/` 迁入与 `ci-artifacts` 排除)
|
||||
|
||||
索引 1495 个 `.c/.h`;解析 include 5972 条(解析成功 4821,外部/系统 1151,351 种);
|
||||
第一方文件 215 个;节点 = 第一方 215 + 第三方 1266 + 外部聚合 1;去重边 5176 条。
|
||||
被引用最多的第一方文件:`Drivers/BSP/dbg_log.h`(48)、`Inc/main.h`(33)、
|
||||
`Drivers/BSP/NET/net_socket.h`(18)……(完整 Top10 见运行报告)。
|
||||
索引 2026 个 `.c/.h`;解析 include 7745 条(解析成功 5889,外部/系统 1856,373 种);
|
||||
第一方文件 559 个;节点 = 第一方 559 + 第三方 1455 + 外部聚合 1 = 2015;边 7745 条。
|
||||
被引用最多的第一方文件:`Drivers/BSP/dbg_log.h`(63)、`Drivers/BSP/UI/ui_content_page.h`(40)、
|
||||
`Drivers/BSP/UI/ui_tokens.h`(39)、`Inc/main.h`(38)、`App/iec60870/104/IEC104_Net.h`(36)……
|
||||
(完整 Top10 见运行报告)。
|
||||
|
||||
> 上一版口径(2026-10-14)是 1495 个文件 / 5972 条 include / 第一方 215 个。两次口径不可直接
|
||||
> 相减:中间既迁入了 `IEC60870-Slave` 与 `App/iec60870/`(第一方文件数大增),也排除了
|
||||
> `ci-artifacts/`(上一版没有这个目录,本次若不禁会多出约 1900 个第三方节点)。
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
|---|---|---|---|
|
||||
| ① 业务层 | `Drivers/BSP/NETCFG/` | 顶层共享配置(被 UI 与基础服务共用) | `net_cfg` |
|
||||
| ② UI 层 | `Drivers/BSP/UI/` | LVGL 界面(与 PC 模拟器共用源码) | `ui_port` `ui_menu` `ui_menu_view` `ui_menu_tab` `ui_content_page` `ui_page_*` `ui_net_sink` `ui_font_cn_12` `ui_deco` |
|
||||
| ③ 基础服务层 | `App/`、`Drivers/BSP/NET/lftpd/` | 应用侧服务、采集算法与协议编排 | `app_main` `sys_events` `app_cfg` `task/*` `algo/*`(语义取数与有效性~保护判据)`protocol/iec104/*` `log/soe_store` `lftpd` `time_sync` |
|
||||
| ③ 基础服务层 | `App/`、`Drivers/BSP/NET/lftpd/` | 应用侧服务、采集算法与协议编排 | `app_main` `sys_events` `app_cfg` `task/*` `algo/*`(语义取数与有效性~保护判据)`iec60870/*`(104 vendor 子树 + `104_port` 适配层)`log/soe_store` `lftpd` `time_sync` |
|
||||
| ④ 中间件层 | `Drivers/BSP/NET/`、`Lib/`、`App/util/` | 通用库 / 协议栈 | `net_socket` `net_select` `FatFs` `nand_ftl`(dhara) `LVGL` `sys_clock` |
|
||||
| ⑤ 驱动层 | `Drivers/BSP/{CH395F,GD5F2GQ5UE,TPAFE5160,SD2506,RS485}/` | 芯片寄存器 / 时序 / 中断 | `ch395f` `gd5f2gq5ue` `tpafe5160` `sd2506` `rs485` |
|
||||
| ⑥ 内核 / HAL | `Middlewares/`、`Drivers/STM32F4xx_HAL_Driver/`、`Drivers/CMSIS/` | 任务调度、外设 HAL、启动 | FreeRTOS V10.3.1 · STM32 HAL · CMSIS |
|
||||
|
||||
+5
-2
@@ -23,7 +23,7 @@
|
||||
|---|---|---|---|
|
||||
| ① 业务层 | `Drivers/BSP/NETCFG/` | 顶层共享配置(被 UI 与基础服务共用) | `net_cfg`(`/config.ini` `[network]` 段) |
|
||||
| ② UI 层 | `Drivers/BSP/UI/` | LVGL 160×160 单色界面(与 PC 模拟器、屏板、远程显示**共用同一份显存**) | `ui_port` `ui_menu` `ui_menu_view` `ui_menu_tab`(生成物) `ui_content_page` `ui_page_registry`(生成物) `ui_page_*`(20+ 页插件) `ui_data`(数据供给发布 API) `ui_net_sink` `ui_standby` `ui_font_cn_12` `ui_deco` |
|
||||
| ③ 基础服务层 | `App/`、`Drivers/BSP/NET/lftpd/` | 应用侧服务与编排 | `app_main` `sys_events` `ui_data_feed` `task/*`(9 任务) `algo/*`(语义取数与有效性~保护判据 + 遥测快照 + 录波数据面 + 屏板灯位映射) `protocol/iec104` `sys_log`·`soe_*`·`console_log` `cfg_file`·`prot_set_store` `vol_lock` `time_sync` `lftpd` |
|
||||
| ③ 基础服务层 | `App/`、`Drivers/BSP/NET/lftpd/` | 应用侧服务与编排 | `app_main` `sys_events` `ui_data_feed` `task/*`(9 任务) `algo/*`(语义取数与有效性~保护判据 + 遥测快照 + 录波数据面 + 屏板灯位映射) `iec60870/*`(104 vendor 子树 + `104_port` 适配层) `sys_log`·`soe_*`·`console_log` `cfg_file`·`prot_set_store` `vol_lock` `time_sync` `lftpd` |
|
||||
| ④ 中间件层 | `Drivers/BSP/NET/`、`Lib/`、`App/util/` | 通用库 / 协议栈 | `net_socket` `net_select` `net_events` `net_listener` `net_pending` `FatFs` `nand_ftl(dhara)` `LVGL v9.3` `sys_clock` `task_watchdog` |
|
||||
| ⑤ 驱动层 | `Drivers/BSP/{CH395F,GD5F2GQ5UE,TPAFE5160,SD2506,RS485,ScreenLink}/` | 芯片寄存器 / 时序 / 中断 | `ch395f` `gd5f2gq5ue` `tpafe5160` `sd2506` `rs485` `sb_link`·`sb_proto` |
|
||||
| ⑥ 内核 / HAL | `Middlewares/`、`Drivers/STM32F4xx_HAL_Driver/`、`Drivers/CMSIS/` | 任务调度、外设 HAL、启动 | FreeRTOS V10.3.1 · STM32 HAL · CMSIS |
|
||||
@@ -315,7 +315,10 @@ STM32F4-Base/
|
||||
│ │ prot_set / prot_elm / run_par / wave_ring / wave_store / sb_led_map
|
||||
│ ├── task/ default_task / net_task / ui_task / adc_task / iec104_serv / protect_task /
|
||||
│ │ rs485_task*(*未创建,RS-485 暂缓)+ task_handles.h
|
||||
│ ├── protocol/iec104/ IEC 60870-5-104:iec104_asdu / iec104_link / iec104_pts(点表:遥测读 meas、遥信读 prot_elm)/ iec104_comm([comm] 段)
|
||||
│ ├── iec60870/ IEC 60870-5-104「只维护一个」:vendor 子树 + 我方适配层
|
||||
│ │ common/(ASDU/时间/信息对象编解码)· 104/(Slave/TcpServer/
|
||||
│ │ Connection/SendManager + business/)· examples/(DTU 点表 profile)
|
||||
│ │ · 104_port/(core/source/net_mcu/dtu_table/comm 装配与平台适配)
|
||||
│ ├── log/ sys_log 记录引擎(定长 64B,/log 唯一写者=defaultTask)、
|
||||
│ │ console_log(UART5 控制台单写者)、soe_rec(64B SOE 纯编解码)+ soe_store(投递/落盘胶水)
|
||||
│ ├── cfg/ 配置引擎:cfg_file(静态态单任务收敛于 defaultTask)、store(MCU=FreeRTOS 堆)、
|
||||
|
||||
@@ -126,7 +126,7 @@
|
||||
|---|---|
|
||||
| 16 套主机单测 | 全部通过(插桩运行下仍 PASS) |
|
||||
| 被测到的自研生产源文件 | **19 个** / 2,893 可执行行 |
|
||||
| 行覆盖最低的两个 | `Drivers/BSP/GD5F2GQ5UE/nand_ftl.c` 48.6%(123/253,函数 14/22)、`App/protocol/iec104/iec104_pts.c` 67.2%(117/174,函数 13/17) |
|
||||
| 行覆盖最低的两个 | `Drivers/BSP/GD5F2GQ5UE/nand_ftl.c` 48.6%(123/253,函数 14/22)、`App/protocol/iec104/iec104_pts.c` 67.2%(117/174,函数 13/17)——后者 2026-11-18 随骨架迁 MCU 删除,此处为当时路径 |
|
||||
| 行覆盖 95%+ 的文件 | 12 个(多为纯逻辑层:`adc_health` / `sample_ring` / `vol_lock` / `time_sync` / `task_watchdog` …) |
|
||||
| **从未进过任何主机单测的生产源文件** | **125 个 / 约 11,839 有效代码行**——拆开是 **47 个 `.c`(9,657 行)
|
||||
| + 78 个 `.h`(2,182 行,多数只有声明与宏)**;前五:`net_socket.c` 1,251、`ch395f.c` 801、`lftpd.c` 694、
|
||||
|
||||
@@ -329,7 +329,7 @@ static void phaseN_run(void) {
|
||||
| `App/log/sys_log_mcu.c` | — | ⬜ 候选 | 记录编解码(定长 64B) | 编解码纯逻辑;写入端依赖 FatFS + 队列,测编解码即可 |
|
||||
| `App/util/time_sync.c` | — | ⬜ 候选 | 协议帧编解码 | 报文组装/解析纯逻辑;网络收发不测 |
|
||||
| `Drivers/BSP/NETCFG/net_cfg_legacy.c` | — | ⛔ 已删除(2026-10-10) | — | 二进制旧档的迁移代码整体移除,测试候选随之撤销 |
|
||||
| `App/protocol/iec104/*`(104 协议栈) | — | ✅ 已覆盖(82 断言,2026-10-12 IEC 104 上行) | 数据源 vtable + tick 注入 + 发送回调注入 | APCI 重组/总召分片/COV/k-w-t1~t3/两段式全离线穷举;`iec104-unit-test` 钩子 |
|
||||
| `App/iec60870/104_port/*`(104 协议栈) | — | ✅ 已覆盖(82 断言,2026-10-12 IEC 104 上行) | 数据源 vtable + tick 注入 + 发送回调注入 | APCI 重组/总召分片/COV/k-w-t1~t3/两段式全离线穷举;`iec104-unit-test` 钩子 |
|
||||
| `Drivers/BSP/GD5F2GQ5UE/nand_ftl.c`(dhara 移植层) | 573 行 | ✅ 已覆盖(149 断言,2026-10-15 起离线钉死 dhara 移植层两条硬约束) | 11 个 SPI 原语(`gd5f2gq5ue.h`)→ **RAM 假芯片** | 移植层是纯地址算术 + 边界判定,换掉芯片即可离线跑;钉死 is_free 整页扫描与六入口越界守卫,并内联旧算法做对照证明断言有牙 |
|
||||
| `App/util/rs485.c` | — | ⏸ 待功能实现 | — | 上游 RS-485 采集链路;当前为空桩 |
|
||||
| `Drivers/BSP/TPAFE5160/*.c` | — | ❌ 不适格 | — | 寄存器序列为主,需真机时序 |
|
||||
|
||||
@@ -187,7 +187,7 @@
|
||||
| **全周傅氏相量计算** | 全周傅氏基波/谐波、线/负序/零序合成、双区交换 | `CalFFTVecFull` / `CalfLineVec` / `CalfNegVec` | `App/algo/`(拟) |
|
||||
| **保护判据元件** | 各保护判据(过流/零序/过压/频率/…) | `RelayUnit/PRS_*.c` | `App/protect/`(拟) |
|
||||
| **出口与记录与信号** | 跳闸/告警出口、信号灯 | `TripKO` / KO | `App/protect/` + BSP 出口驱动 |
|
||||
| **动作留痕记录与上送** | SOE/动作记录、UI 显示、遥测上送 | 记录模块 + 通信 | `App/log/` + `Drivers/BSP/UI/` + `App/protocol/` |
|
||||
| **动作留痕记录与上送** | SOE/动作记录、UI 显示、遥测上送 | 记录模块 + 通信 | `App/log/` + `Drivers/BSP/UI/` + `App/iec60870/`(104 上送;2026-11-18 前该层名为 `App/protocol/`) |
|
||||
|
||||
> **分层原则**:语义取数与有效性只做"数"(码值→工程量),全周傅氏相量只做"相量"(工程量→复相量),保护判据只做"判据"(相量 + 定值→布尔),出口与记录/动作留痕只做"动作与留痕"。**算法与 I/O 分离**,使 全周傅氏相量/保护判据成为主机侧纯逻辑单测的天然适格对象(三条采集链路设计约束的正文在 `docs/产品需求/产品需求设计文档.md` §5.10)。
|
||||
|
||||
@@ -224,7 +224,7 @@
|
||||
| 定值存取 | **cfg_file 配置引擎**(替代参考的 EEPROM 定值文件) | `App/cfg/cfg_file.c` + 新增定值段 |
|
||||
| 动作/SOE 记录 | `sys_log`(`/log/run.log`)与运行记录 | `App/log/` |
|
||||
| 保护定值/测量显示 | 远端显示 UI(`ui_page_ac` 已有 24 行占位) | `Drivers/BSP/UI/ui_page_ac.h` |
|
||||
| 遥测/事件上送 | 网络栈 + `App/protocol/`(协议预留) | `App/protocol/` + `Drivers/BSP/NET/` |
|
||||
| 遥测/事件上送 | 网络栈 + `App/iec60870/`(现状只有 104) | `App/iec60870/` + `Drivers/BSP/NET/` |
|
||||
| 时间戳 | `sys_clock`(RTC 基准) | `App/util/sys_clock.c` |
|
||||
| 自检留痕 | `selftest.log` / 自检框架 | `App/log/` |
|
||||
|
||||
|
||||
@@ -741,7 +741,7 @@ V0.1 恒命中 UB/UC/IB/IC/IN,位图 `0xE6`),它表示"这路不能测交
|
||||
| # | 位置 | 现值与语义 | 状态 |
|
||||
|---|---|---|---|
|
||||
| 1 | `App/algo/freq.h` 的 `FREQ_AMP_MIN` | 测频幅值门,**二次值 V 口径**(与 `prot_set.c` 头部量纲基准同源):2026-10-25 重定为 50 V = 0.5×Un;**2026-11-13 用户裁定放宽到 5 V = 0.05×Un**(台架低端注入也能测频,浮空噪声与门仍差两个数量级) | ✅ 已放宽;`eng=0` 过渡期「本门恒不过 → 如实报不可测」是当时那一轮测频轮的读法(引脚域满幅 <5 V,历史叙述);标定完成后 UA ≥5 V 即出数 |
|
||||
| 2 | `App/protocol/iec104/iec104_pts.c:69-80` | `k_yc[].deadband` 已按点重定:电压 0.5 V、电流 0.005 A、频率 0.5 Hz(真源在 `run_par`,UI 可改) | ✅ 已重定;④ 变比到手后需再复核一次量纲 |
|
||||
| 2 | `App/algo/run_par.c` 的 `s_db_rom[]`(出厂默认表) | 死区已按点重定:电压 0.5 V、电流 0.005 A、频率 0.5 Hz(毫值 500 / 5 / 500);真源在本模块,UI 与 104 都经 `run_par_deadband()` / `run_par_deadband_set()` 读写。旧实现 `App/protocol/iec104/iec104_pts.c:69-80` 的 `k_yc[].deadband` 是这份常量的前身,该文件 2026-11-18 随骨架迁 MCU 删除,引用的源码行号随之失效 | ✅ 已重定;④ 变比到手后需再复核一次量纲 |
|
||||
| 3 | `App/algo/prot_set.c:25-70` | `g_prot_set_meta[]` 定值 = 二次值 A / V(基准 100 V / 1 A):OC1 10 A、OV 120 V、UV 20 V、3U0 15 V… | 🟡 口径对,但**标定前无法在板上验真**;精度目标定了之后连同 `min`/`max` 复核 |
|
||||
|
||||
### 13.8 落盘:拆三段,不碰引擎
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
# IEC 104 板端 Net 适配契约
|
||||
|
||||
> **定位**:`App/protocol/iec104/iec104_net_mcu.c` 把成熟 104 库的 `IEC104_Net.h` 后端 ABI 接到
|
||||
> **定位**:`App/iec60870/104_port/iec104_net_mcu.c` 把成熟 104 库的 `IEC104_Net.h` 后端 ABI 接到
|
||||
> `Drivers/BSP/NET/net_socket.h` 的 `net_*` 接口上,本契约说明**为什么不能直译、按什么规则映射、
|
||||
> 哪些不变量必须成立**。代码落点:`App/protocol/iec104/iec104_net_mcu.c` / `.h`。
|
||||
> 哪些不变量必须成立**。代码落点:`App/iec60870/104_port/iec104_net_mcu.c` / `.h`。
|
||||
> **验证边界**:见 §7——经 fake net 层 12/12 与代码审查,**CH395F 板端行为未证**。
|
||||
|
||||
## 1. 反例:直译 vendor 的 `Close(client)` 会毁掉监听
|
||||
|
||||
成熟库按 **Windows/Winsock 式的"独立 client fd"** 设计:监听 socket 与接入后的数据 socket
|
||||
是两个不同句柄,因此 `Accept` 失败清理、以及"已有客户端时又来一个"的分支,一律
|
||||
`IEC104_Net_Close(client, NULL)`——`App/protocol/iec60870/104/IEC104_TcpServer.c` 里共 **7 处**
|
||||
`IEC104_Net_Close(client, NULL)`——`App/iec60870/104/IEC104_TcpServer.c` 里共 **7 处**
|
||||
(约 1606 / 1611 / 1616 / 1628 / 1636 / 1652 / 1665 行)。在 Winsock 下这让两侧各自独立,语义自洽。
|
||||
|
||||
CH395F 是**单连接模型**:`net_accept()` 返回的是**监听 socket 自己**,接入瞬间同一个 fd 从
|
||||
@@ -128,7 +128,7 @@ listen/close 后旧 handle 必然查表失败。
|
||||
| 5 个新声明所在的 `#ifndef NET_NO_OS` 段 | `net_socket.h:702` ~ `:809` |
|
||||
| `net_drop_conn_locked` / `net_accept_locked` 声明 | `net_socket.h:769` / `:770` |
|
||||
| `net_pending_bytes` / `net_send_try` / `net_mono_now_ms` 声明 | `net_socket.h:777` / `:785` / `:792` |
|
||||
| 后端的 LISTEN / CLIENT 分流 | `App/protocol/iec104/iec104_net_mcu.c` 的 `IEC104_Net_Close()` |
|
||||
| 后端的 LISTEN / CLIENT 分流 | `App/iec60870/104_port/iec104_net_mcu.c` 的 `IEC104_Net_Close()` |
|
||||
| 后端的 role 查表 | 同文件 `find_role()` / `slot_by_handle()` |
|
||||
| 7 处 `IEC104_Net_Close(client, NULL)` | `App/protocol/iec60870/104/IEC104_TcpServer.c` 约 1606/1611/1616/1628/1636/1652/1665 |
|
||||
| 7 处 `IEC104_Net_Close(client, NULL)` | `App/iec60870/104/IEC104_TcpServer.c` 约 1606/1611/1616/1628/1636/1652/1665 |
|
||||
| `server->listen_socket` 赋值点 | 同文件 `:2129`(Listen 成功)/ `:322`、`:2146`、`:3322`(置无效) |
|
||||
|
||||
@@ -79,7 +79,7 @@ RAM 预算门禁 FAIL:RW_CCM 占用 92.3% > 92%(阈值 92%)
|
||||
真实链接测量过」——**这不是预算问题,也不拦提交**(该脚本只挂在 `scripts/ci_local.py` 的体积门禁,不在 51 条
|
||||
pre-commit 钩子内)。判据:报错里若同时列出「未入索引的文件」且那些文件正被别的任务改,就等它们入库后
|
||||
统一 `/keil-build` → `ram_baseline.py --update` 补凭证,**别为了把它调绿去 `git add` 别人在飞的改动**。本条写作时
|
||||
(2026-10-27 09:4x)凭证**仍是红的**:`App/protocol/iec104/iec104_comm.{c,h}` 正被通讯道改、未入索引;
|
||||
(2026-10-27 09:4x)凭证**仍是红的**:`App/iec60870/104_port/iec104_comm.{c,h}` 正被通讯道改、未入索引;
|
||||
回填动作发生在该卡入库之后,届时以 `--update` 的实际输出为准,本节不预告结果。
|
||||
|
||||
## 7. 豁免与基线
|
||||
|
||||
@@ -94,7 +94,7 @@
|
||||
- `App/algo/adc_input.c` 的 `adc_input_raw()` 明确只搬原始码值、不做标定(见其头文件注释)。
|
||||
- `App/algo/phasor.c` 的系数表只含 √2/N 折算,**不含通道增益**——`fAmSQ` 的数值量纲是"码值",不是 V/A。
|
||||
- `App/algo/prot_elm.h` 与 `App/algo/freq.h` 均注明"工程量↔码值换算系数 = 1(「通道标定(一次系数 + 零漂)」标定未实现)"。
|
||||
- `App/protocol/iec104/iec104_pts.c` 的遥测源直接返回 `p.fAmSQ`;死区 10.0 也是码值口径。
|
||||
- 旧 `App/protocol/iec104/iec104_pts.c`(该文件 2026-11-18 随骨架迁 MCU 删除,下条同)的遥测源直接返回 `p.fAmSQ`;死区 10.0 也是码值口径。
|
||||
|
||||
**参考做法**:`DataPre.c` 每拍做 `fValue = iVal * pfSamCoe[dwPinNo]`,每通道一个定点(2^10)系数,把码值换成二次侧工程量;再由 PT/CT 变比换一次值。
|
||||
|
||||
@@ -119,7 +119,7 @@
|
||||
**现状与证据**
|
||||
|
||||
- 全库无 200 ms 测量任务,无谐波方和根、无 4 点平均、无死区确认、无零漂、无畸变率(按关键词扫描 `App/` 与 `Drivers/BSP/` 均无命中)。
|
||||
- `App/protocol/iec104/iec104_pts.c` 的 COV 比对在**协议层**做死区判定——遥测层不存在。
|
||||
- 旧 `App/protocol/iec104/iec104_pts.c` 的 COV 比对在**协议层**做死区判定——遥测层不存在。
|
||||
- 遥测值 = 相量瞬时值,每 1 ms 变化一次。
|
||||
|
||||
**参考做法**:`CalfYcMea.c`(2 453 行)——中断内回溯一周波 20 点入私有缓冲,主循环每 200 ms:`YcJLFilter` 对 k=1~9 逐次 DFT → 方和根 `√(ΣHk²)` → 4 点平均 → 死区连续 2 点确认 → 零漂门槛置零 → 微调系数 → 变比。
|
||||
|
||||
Reference in New Issue
Block a user