fix(docs): 修 16 处指向已删文件的历史指针,别让读者照着找空门
上一笔改名把 App/protocol/iec104 搬到 App/iec60870/104_port 时,机械
文本替换把「讲一个已经删掉的文件当初做什么」的叙述也一起改了:
iec104_pts.c / iec104_asdu.c / iec104_link.c
这三个文件在 90cc9a7d 里就删了(旧自研协议层整体退役),
App/iec60870/104_port/ 下从来没有它们。于是文档与注释里出现了一批
「新路径 + 旧行为」的混合描述,读者按图索骥只会撞空。
按两类分别处理,共 11 个文件(只有注释与 Markdown,零代码行):
一、讲历史事实的 -> 写回当时真实的旧名,就近标「已删除」
App/task/ui_task.c SYSLOG_OPER 那条原写入点
App/algo/run_par.h 104 消费侧每拍读取
Drivers/BSP/UI/ui_data.h YX_DP_N / 遥控记录两条
Drivers/BSP/UI/ui_page_oper.c 操作页写入点
Drivers/BSP/UI/ui_page_reset.c 复归串与远端那条刻意不同
Drivers/BSP/UI/ui_page_yk.c 遥控页写入点
Drivers/BSP/UI/ui_data.c CP56 正反两套实现同族
test/host/ui_data/ui_data_test.c 两处历史注释
simulator/main.c 双点位图固定帧的来历
App/log/README.md oper.log / yk.log 生产者
docs/UI设计/UI_数据供给设计.md
docs/UI设计/页面扩充详细方案.md
docs/产品需求/产品需求设计文档.md 链路层与点表实现指针
二、讲现在仍活着的接缝的 -> 指向真实存在的文件,并 test -f 过
App/algo/run_par.h:23 死区分流现由 iec104_dtu_table.c +
iec104_source.c 承担
App/algo/meas.h 数值口径改指 common/IEC60870_InformationObjects.h
的 IEC60870_ASDU_QUALITY_*;顺带修掉同句里两个
既有错:引用了不存在的 test/host/iec104/,
且 104 当前消费点是 iec104_serv.c 的 s_measure()
test/host/bench/iec104/iec104_master.py 常量与帧头说明改指
common/IEC60870_Asdu.c 与 104/IEC104_Types.h
App/task/iec104_serv.c 单独说明:文件还在但 s_clock_sync() 已随新契约
消失(grep RC=1),所以写「同日重写后不再投递」,不写「已删除」。
验证:grep 新假路径零命中;旧真名 14 处全部带删除标注;check_bom_drift
RC=0(6 个带 BOM 文件按原始字节补回,未过文本编解码);check_mojibake
RC=0;check_coding_standard 逐文件 RC=0;doc-links 308 篇 / 30 处问题
全部仍在 IEC60870-Slave 供应商快照内,非 vendor 计数仍为 0。
This commit is contained in:
+5
-3
@@ -49,10 +49,12 @@ extern "C" {
|
||||
#define MEAS_PERIOD_MS 200u
|
||||
|
||||
/* 每点品质位(uint16)。**低字节与线上 104 QDS 字节同值**(OV/NT/IV,数值
|
||||
* 口径同 App/iec60870/104_port/iec104_asdu.h 的 IEC104_QDS_*)——但本层**不得**
|
||||
* 口径同 App/iec60870/common/IEC60870_InformationObjects.h 的 IEC60870_ASDU_QUALITY_*;
|
||||
* 旧参照头 App/protocol/iec104/iec104_asdu.h 的 IEC104_QDS_* 已于 2026-11-18 删除,
|
||||
* 常量值同值未变)——但本层**不得**
|
||||
* include 协议层头(分层方向:算法层在协议层之下,反向依赖禁止),故在此自
|
||||
* 定义同值常量;104 侧消费(104 改读快照)直接截低字节上送,一致性由本目录单测与
|
||||
* test/host/iec104/ 既有断言双向钉住。高字节为 meas 域扩展位(线上不直接
|
||||
* 定义同值常量;104 侧消费(App/task/iec104_serv.c 的 s_measure() 取快照后
|
||||
* 直接截低字节上送,见该函数注释)一致性由 meas 单测双向钉住。高字节为 meas 域扩展位(线上不直接
|
||||
* 出现,由消费者映射): */
|
||||
#define MEAS_QDS_OV (0x0001u) /* 溢出(留位,本项不产出——判据待运行参数化) */
|
||||
#define MEAS_QDS_NT (0x0020u) /* 非当前值:未就绪 / 语义未处理(TEMP) */
|
||||
|
||||
+7
-3
@@ -2,8 +2,10 @@
|
||||
* 模块名称:运行参数段(全周傅氏相量/保护判据整定层,「数据可信」这一项)
|
||||
* 模块功能:遥测死区(9 点)与通道标定系数覆盖(k/b 各 8 路)的**单一真源**:
|
||||
* - 死区 = 本模块 int32 毫单位 RAM 副本(注册进 cfg 引擎 [run_par] 段,
|
||||
* 工厂默认 = 「数据可信」下游常数按工程量重定后的额定 0.5 % 档),104 消费侧
|
||||
* (App/iec60870/104_port/iec104_pts.c)每拍实时读取——无投递、无缓存
|
||||
* 工厂默认 = 「数据可信」下游常数按工程量重定后的额定 0.5 % 档),原 104 消费侧
|
||||
* (旧 App/protocol/iec104/iec104_pts.c,该文件 2026-11-18 随骨架迁 MCU 删除;
|
||||
* 当前 run_par_deadband() 的调用方只剩装配层 App/app/ui_data_feed.c,104 侧无调用方)
|
||||
* 每拍实时读取——无投递、无缓存
|
||||
* 副本(104 改读快照曾在 pts 侧留运行时副本 s_yc_db,运行参数段落地后收编于此,
|
||||
* 双源必打架);
|
||||
* - 系数覆盖 = **直通 adc_cal_set() / adc_cal_set_ratio()**
|
||||
@@ -18,7 +20,9 @@
|
||||
* 0x8050~0x8057 = 变比 r 覆盖(比值,无单位;0 = 本路不折算,见
|
||||
* run_par_cal_r_set 的说明);
|
||||
* 其余留白(未启用类别),**0x8027~0x802A 属 prot_set 告警段**,本表
|
||||
* 永不让位(两表按精确地址分流,见 iec104_pts.c set 路由)。
|
||||
* 永不让位(两表按精确地址分流,见旧 iec104_pts.c 的 set 路由;
|
||||
* 该文件 2026-11-18 已删除,现行分流在 App/iec60870/104_port/
|
||||
* iec104_dtu_table.c 与 iec104_source.c)。
|
||||
* 持久化(B7 prot_set 先例同款):任一写成功 → 脏标志只置不清;
|
||||
* iec104Task 主循环 peek → 置 SYS_EVT_RUN_PAR_SAVE → defaultTask
|
||||
* (配置引擎属主)run_par_store_save() 调 cfg_file_save() 整档外科
|
||||
|
||||
+2
-2
@@ -62,8 +62,8 @@
|
||||
| 事故 | `SYSLOG_ACCIDENT` / `accid.log` | 512 | `App/task/protect_task.c:188` | `asserted` 上升沿**且**该元件跳闸投退项 = 1 |
|
||||
| 保护告警 | `SYSLOG_ALARM` / `alarm.log` | 1024 | 同文件 `191` | `asserted` 上升沿**且**跳闸投退项 = 0 或该元件无此项 |
|
||||
| 保护启动 | `SYSLOG_START` / `start.log` | 1024 | 同文件 `183` | `picked` 上升沿(越限电平,早于/等于动作) |
|
||||
| 操作 | `SYSLOG_OPER` / `oper.log` | 512 | `App/task/default_task.c`(`default_task_func()`,`settings saved`)、`App/log/sys_log_mcu.c`(`s_clear_service()`,清除记录成功)、`App/task/ui_task.c`(`ui_task_maint_oper_note()`,面板操作)、`App/sync/time_sntp.c`(`clock set by SNTP`);宿主侧 `simulator/main.c` 与 `simulator/sim/sim_syslog.c` | 定值**真落盘成功** / 清除记录成功 / 面板运维动作 / SNTP 对时。⚠ 104 侧不再投递:原 `App/iec60870/104_port/iec104_pts.c` 写 `force reset` 与 `plate in/out`,该实现已于 2026-11-17 割接删除,骨架阶段不驱动物理出口故无记录(见 `docs/子系统设计/IEC104上行设计说明.md` §0.5) |
|
||||
| 遥控 | `SYSLOG_YK` / `yk.log` | 256 | **当前无生产者**——原写入点 `App/iec60870/104_port/iec104_pts.c`(`s_src_yk_exec()`:选择段、执行段、非法 DPC、未知 IOA)已随 2026-11-17 割接删除 | ⚠ 骨架阶段**有意不记**:模拟动作绝不驱动物理出口,照旧写"选择/执行"即为伪造记录(判据与后果见 `docs/子系统设计/IEC104上行设计说明.md` §0.5)。恢复记录需新增观测接缝,待另行立项 |
|
||||
| 操作 | `SYSLOG_OPER` / `oper.log` | 512 | `App/task/default_task.c`(`default_task_func()`,`settings saved`)、`App/log/sys_log_mcu.c`(`s_clear_service()`,清除记录成功)、`App/task/ui_task.c`(`ui_task_maint_oper_note()`,面板操作)、`App/sync/time_sntp.c`(`clock set by SNTP`);宿主侧 `simulator/main.c` 与 `simulator/sim/sim_syslog.c` | 定值**真落盘成功** / 清除记录成功 / 面板运维动作 / SNTP 对时。⚠ 104 侧不再投递:原旧 `App/protocol/iec104/iec104_pts.c` 写 `force reset` 与 `plate in/out`,该实现已于 2026-11-17 割接删除(文件在 2026-11-18 随骨架迁 MCU 移除),骨架阶段不驱动物理出口故无记录(见 `docs/子系统设计/IEC104上行设计说明.md` §0.5) |
|
||||
| 遥控 | `SYSLOG_YK` / `yk.log` | 256 | **当前无生产者**——原写入点旧 `App/protocol/iec104/iec104_pts.c`(`s_src_yk_exec()`:选择段、执行段、非法 DPC、未知 IOA;该文件 2026-11-18 已删除) | ⚠ 骨架阶段**有意不记**:模拟动作绝不驱动物理出口,照旧写"选择/执行"即为伪造记录(判据与后果见 `docs/子系统设计/IEC104上行设计说明.md` §0.5)。恢复记录需新增观测接缝,待另行立项 |
|
||||
|
||||
- **"哪些元件算跳闸"只有一个真源**:定值表 `g_prot_set_meta` 里的 `PS_*_TRIP`(枚举注释
|
||||
即"0 告警 / 1 跳闸")+ 实例表 `k_pe[]` 的 `trip_ctl` 列。分类入口
|
||||
|
||||
+3
-2
@@ -246,8 +246,9 @@ static int ui_task_maint_clock_set(uint32_t a_epoch) {
|
||||
* 返回值:0 - 已投递(prot_elm_request_reset 无拒绝分支) int
|
||||
* 限定条件:uiTask 上下文;不等待执行结果
|
||||
* 函数说明:只投递不阻塞(契约:UI 页面二次确认后调,页面立刻给"已请求复归")。
|
||||
* **不在这里投操作记录**:远端 104 YK11 那条已经在
|
||||
* App/iec60870/104_port/iec104_pts.c 投过,在这里再投一次就会给每一次
|
||||
* **不在这里投操作记录**:远端 104 YK11 那条原先已经由旧
|
||||
* App/protocol/iec104/iec104_pts.c 投过(该文件 2026-11-18 已删除,骨架阶段
|
||||
* 104 侧不再投递),在这里再投一次就会给每一次
|
||||
* 主站复归多记一条"面板复归",审计面直接失真。本地这条由页面投
|
||||
* (只有页面知道"这是人按的"),措辞也不同串:见 Drivers/BSP/UI/ui_page_reset.c
|
||||
*/
|
||||
|
||||
@@ -574,8 +574,10 @@ int ui_data_maint_clear_state(uint8_t a_log_id) {
|
||||
/*
|
||||
* 私有宏定义区(本小节自带,不与其它小节共用):
|
||||
* 算法 = Howard Hinnant 的 days_from_civil / civil_from_days(以 0000-03-01
|
||||
* 为纪元、400 年一周期),与 App/iec60870/104_port/iec104_asdu.c 的正反两套实现
|
||||
* 同族;本工程年域 2000..2038,全程非负,用 uint32 就够,不引 int64 也不引 time.h
|
||||
* 为纪元、400 年一周期),与旧 App/protocol/iec104/iec104_asdu.c 的正反两套实现
|
||||
* 同族(该文件 2026-11-18 已删除;现网 ASDU 时间在
|
||||
* App/iec60870/common/IEC60870_Time.c);本工程年域 2000..2038,全程非负,
|
||||
* 用 uint32 就够,不引 int64 也不引 time.h
|
||||
*/
|
||||
#define CL_SECONDS_PER_DAY 86400u
|
||||
#define CL_SECONDS_OF_DAY_MAX 11647u /* 0x7FFFFFFF % 86400 = 2038-01-19 的 03:14:07 */
|
||||
|
||||
@@ -163,9 +163,13 @@ typedef struct {
|
||||
uint64_t yx_dp; /* 遥信双点位图: bit i = 1 该点是双点型(M_DP)
|
||||
* 值列打"合位/分位",单点打"动作/复归"。
|
||||
* 为什么下发位图而不让页面自己认定"前 4 点是
|
||||
* 双点":单/双点是**104 点表事实**(见
|
||||
* App/iec60870/104_port/iec104_pts.c 的 YX_DP_N 与
|
||||
* iec104_pts_yx_is_dp),抄一份进表现层就是第二
|
||||
* 双点":单/双点是**104 点表事实**(旧产品
|
||||
* 33 点表 App/protocol/iec104/iec104_pts.c 的
|
||||
* YX_DP_N 与 iec104_pts_yx_is_dp,该文件
|
||||
* 2026-11-18 已删除;现行口径见
|
||||
* App/iec60870/104_port/iec104_dtu_table.c 的
|
||||
* IEC104_DTU_SP_COUNT / IEC104_DTU_DP_COUNT),
|
||||
* 抄一份进表现层就是第二
|
||||
* 真相——点表把某点改成双点、或把双点段挪到下标
|
||||
* 中段,屏上不会报错,只会用错词形容同一个点。
|
||||
* V0.1 双点 4 点无开入硬件 → 不在 yx_valid 内,
|
||||
@@ -545,7 +549,8 @@ typedef struct {
|
||||
* const char *
|
||||
* 返回值:无
|
||||
* 限定条件:真机实现 = syslog_post_quiet(SYSLOG_OPER, desc)。**谁触发谁投**:
|
||||
* 远端 104 遥控那条已由 App/iec60870/104_port/iec104_pts.c 投,
|
||||
* 远端 104 遥控那条原由旧 App/protocol/iec104/iec104_pts.c 投(该文件
|
||||
* 2026-11-18 已删除,骨架阶段 104 侧无此记录),
|
||||
* 本地面板这条由页面在受理成功后投,两边各一条、不得互替
|
||||
*/
|
||||
void (*oper_note)(const char *a_desc);
|
||||
|
||||
@@ -6,7 +6,12 @@
|
||||
* 空日志显示单条伪行"无记录";向框架 ui_content_page 提供页面描述符(零 LVGL 对象)
|
||||
* 记录口径(本文件只读显示、不实现写入方;权威表 App/log/README.md §五类记录):
|
||||
* 触发判据 = 人工/远端操作留痕:定值保存、强制复归、对时(SNTP 与 104)、清除记录;
|
||||
* 写入点 = App/task/default_task.c(定值保存)、App/iec60870/104_port/iec104_pts.c(复归与整定写入)、App/task/iec104_serv.c 与 App/sync/time_sntp.c(对时)、App/log/sys_log_mcu.c(清除记录留痕,OPER 自身除外);
|
||||
* 写入点 = App/task/default_task.c(定值保存)、
|
||||
* App/log/sys_log_mcu.c(清除记录留痕,OPER 自身除外)、
|
||||
* App/sync/time_sntp.c(对时);
|
||||
* 旧实现另有旧 App/protocol/iec104/iec104_pts.c(复归与整定写入,
|
||||
* 该文件 2026-11-18 已删除)与 App/task/iec104_serv.c 的
|
||||
* s_clock_sync()(104 对时,同日重写为新契约后不再投递);
|
||||
* "记录类型 = 日志 ID 本身"(一类记录一个文件,记录体内没有类型字段位,
|
||||
* Lead 裁定 2026-10-26)——本页只读 oper.log 一个文件,不做跨文件混排。
|
||||
* 台架复核已完成(2026-11-06,Issue #53 台架轮、实机 boot 188–193,证据贴 Issue #53 评论):
|
||||
|
||||
@@ -31,7 +31,8 @@
|
||||
|
||||
/*
|
||||
* 本地这条操作记录的描述串:ASCII 20 字节 < SYSLOG_DESC_MAX(28)。
|
||||
* 与远端那条(App/iec60870/104_port/iec104_pts.c 的 "force reset")**刻意不同串**——
|
||||
* 与远端那条(旧 App/protocol/iec104/iec104_pts.c 的 "force reset",该文件
|
||||
* 2026-11-18 已删除,骨架阶段 104 侧无此记录)**刻意不同串**——
|
||||
* 操作记录是审计面,两条一样就再也分不出"是主站下发的还是现场有人按面板",
|
||||
* 而那正是查遥控事故时第一个要问的问题。
|
||||
* 为什么由页面投而不是由 prot_elm_request_reset() 投:那条函数在 algo 层,
|
||||
|
||||
@@ -6,7 +6,9 @@
|
||||
* 空日志显示单条伪行"无记录";向框架 ui_content_page 提供页面描述符(零 LVGL 对象)
|
||||
* 记录口径(本文件只读显示、不实现写入方;权威表 App/log/README.md §五类记录):
|
||||
* 触发判据 = 104 遥控的选择 / 执行 / 拒绝(含未知类型与参数越界);
|
||||
* 写入点 = App/iec60870/104_port/iec104_pts.c 的遥控段;
|
||||
* 写入点 = 旧 App/protocol/iec104/iec104_pts.c 的遥控段(该文件 2026-11-18
|
||||
* 已删除);骨架阶段**当前无生产者**——模拟动作绝不驱动物理出口,
|
||||
* 见 docs/子系统设计/IEC104上行设计说明.md §0.5;
|
||||
* "记录类型 = 日志 ID 本身"(一类记录一个文件,记录体内没有类型字段位,
|
||||
* Lead 裁定 2026-10-26)——本页只读 yk.log 一个文件,不做跨文件混排。
|
||||
* 台架复核已完成(2026-11-06,Issue #53 台架轮、实机 boot 188–193,证据贴 Issue #53 评论):
|
||||
|
||||
@@ -172,7 +172,7 @@ 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/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**。
|
||||
**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/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/iec60870/examples/iec104_dtu_profile.h` 的 `dtu_signals[]` 原始名):
|
||||
|
||||
@@ -351,7 +351,7 @@ V0.1 **无直流采样通道**(`ADC_SEM` 只有 8 路电气 + 温度),点
|
||||
|
||||
### 3.3 三遥设置(5 页,阻塞于 `run_par`)
|
||||
|
||||
**现状**:死区是**编译期常量**——`App/iec60870/104_port/iec104_pts.c` 的 `k_yc[].deadband`(第 244 行 `if (d > k_yc[i].deadband)`)。其余四项(系数/类型/防抖/双点)在固件里**完全没有对应结构**。(注:`iec104_pts` 实现已于 2026-11-17 割接删除,此处为立项时方案原文;引用的源码行号随之失效)
|
||||
**现状**:死区是**编译期常量**——`App/protocol/iec104/iec104_pts.c` 的 `k_yc[].deadband`(第 244 行 `if (d > k_yc[i].deadband)`)。其余四项(系数/类型/防抖/双点)在固件里**完全没有对应结构**。(注:`iec104_pts` 实现已于 2026-11-17 割接删除,此处为立项时方案原文;引用的源码行号随之失效)
|
||||
|
||||
**所以这 5 页不是页面工作,是一个参数模型工作。**
|
||||
|
||||
|
||||
@@ -644,8 +644,8 @@ flowchart LR
|
||||
|
||||
**FR-IEC104-1 链路层**
|
||||
- 需求:APCI U/S/I 帧、STARTDT/STOPDT/TESTFR、k/w 窗、t1/t2/t3;TCP 流重组与坏帧自恢复。
|
||||
- 实现:`App/iec60870/104_port/iec104_link.c`(纯逻辑:收=喂流、发=回调、时基注入);参数 k=12 / w=8 /
|
||||
t1=15 s / t2=10 s / t3=20 s;序号 15 bit 回绕、超时一律差值法。
|
||||
- 实现:旧 `App/protocol/iec104/iec104_link.c`(纯逻辑:收=喂流、发=回调、时基注入)——该文件 2026-11-18 随骨架迁 MCU 删除,现由 vendor `App/iec60870/104/IEC104_Link*` 承担;参数 k=12 / w=8 /
|
||||
t1=15 s / t2=10 s / t3=20 s(现实现默认值同值,见 `App/iec60870/104/IEC104_Types.h` 的 `IEC104_DEFAULT_*`);序号 15 bit 回绕、超时一律差值法。
|
||||
- 判据:主机侧 174 断言全绿;台架主站往返 STARTDT → 总召四组 → actterm 全通过。
|
||||
|
||||
**FR-IEC104-2 遥测上送**
|
||||
@@ -656,7 +656,7 @@ flowchart LR
|
||||
|
||||
**FR-IEC104-3 遥信上送**
|
||||
- 需求:双位置遥信上双点、其余单点;变位突发 + 背景扫描;**无效点也入表并置 IV**。
|
||||
- 实现:`iec104_pts.c` 点表(33 点)+ COV 判定;突发单点带 CP56 时标。
|
||||
- 实现:旧 `App/protocol/iec104/iec104_pts.c` 点表(33 点)+ COV 判定(该文件 2026-11-18 已删除;现为 DTU 标准表 75 个遥信点,见 `App/iec60870/104_port/iec104_dtu_table.c`,两套点表语义不同不可对号入座);突发单点带 CP56 时标。
|
||||
- 判据:`YX15~18/23/31` 为活数据;`YX1~14/19~22/24~30/32~33` 恒 IV(缺行比置 IV 更糟)。
|
||||
|
||||
**FR-IEC104-4 遥控**
|
||||
@@ -1349,7 +1349,7 @@ mac=00:00:00:00:00:00
|
||||
| `prot_elm` | `prot_elm_init/run/eval/state/request_reset` | 保护判据元件框架(9 实例) |
|
||||
| `run_par` | `run_par_init/get/set_104_write/dirty_peek` | 运行参数段(死区 + 系数代理) |
|
||||
| `soe_rec` / `soe_store` | `soe_rec_encode/decode` · `soe_store_post/drain` | SOE 编解码 + 落盘投递 |
|
||||
| `iec104` | `iec104_link_*` / `iec104_pts_*` / `iec104_serv_*` | 104 链路 / 点表 / 板端胶水 |
|
||||
| `iec104` | 旧 `iec104_link_*` / `iec104_pts_*` / `iec104_serv_*`(2026-11-18 删旧自研三源后,现为 `iec104_core_*` / `iec104_source_*` / `iec104_dtu_table_*` 等 `104_port` 接口 + vendor `IEC104_*`) | 104 链路 / 点表 / 板端胶水 |
|
||||
|
||||
### 6.8 IEC 60870-5-104 点表摘要
|
||||
|
||||
|
||||
+6
-2
@@ -1061,8 +1061,12 @@ static void sim_fill_rt_frame(ui_data_rt_t *p_rt, uint32_t n) {
|
||||
}
|
||||
p_rt->yx_bits = 0u; /* 固定帧无动作态 */
|
||||
p_rt->yx_valid = 0x4043C000ULL; /* YX15~18/23/31 有效位图(与点表同集合) */
|
||||
/* 双点位图照写侧口径给(App/iec60870/104_port/iec104_pts.c 的 YX_DP_N = 4 → bit0~3)。
|
||||
* 这 4 点**不在**上面的有效位图里(V0.1 无开入硬件),所以遥信页对它们打 "--"——
|
||||
/* 双点位图照写侧口径给(bit0~3 = 双点)——这是**固定帧**、不是按点表算出来的:
|
||||
* 旧产品 33 点表实现(App/protocol/iec104/iec104_pts.c 的 YX_DP_N = 4,该文件
|
||||
* 2026-11-18 已删除)当时双点确实在 bit0~3;割接后 DTU 标准表把双点段挪到下标
|
||||
* 59~74,写侧 feed_yx_dp() 按新表算出的位图 bit0~32 全 0,本帧仍写 0x0F 以固定
|
||||
* 台架画面形态。这 4 点**不在**上面的有效位图里
|
||||
* (V0.1 无开入硬件),所以遥信页对它们打 "--"——
|
||||
* 刻意不把 bit0 塞进 yx_valid 让画面多两个汉字好看:那会让黄金参考显示成"这台设备
|
||||
* 有开关位置遥信",而真机上没有(屏上的话必须与本机一致,同页脚页码那条裁定) */
|
||||
p_rt->yx_dp = 0x0FULL;
|
||||
|
||||
@@ -3,8 +3,10 @@
|
||||
"""B6 bench leg: IEC 60870-5-104 master client (GI + COV round-trip).
|
||||
|
||||
Historical bench leg; acceptance criteria: docs/子系统设计/IEC104上行设计说明.md §8.
|
||||
docs/子系统设计/IEC104上行设计说明.md §3/§4. Constants mirror
|
||||
App/iec60870/104_port/iec104_asdu.h / iec104_link.h.
|
||||
docs/子系统设计/IEC104上行设计说明.md §3/§4. Constants mirror the old in-house
|
||||
protocol layer (App/protocol/iec104/iec104_asdu.h / iec104_link.h, both deleted
|
||||
2026-11-18 with the skeleton MCU migration); current wire layout is governed by
|
||||
App/iec60870/common/IEC60870_Asdu.h + App/iec60870/104/IEC104_Types.h.
|
||||
|
||||
Flow:
|
||||
1. TCP connect device :2404 (factory default; --port overrides),
|
||||
@@ -64,7 +66,8 @@ import socket
|
||||
import struct
|
||||
import time
|
||||
|
||||
# ---- constants (mirror iec104_asdu.h / iec104_link.h) -----------------------
|
||||
# ---- constants (mirror the old iec104_asdu.h / iec104_link.h; both deleted
|
||||
# 2026-11-18 -- current layout: App/iec60870/common/ + App/iec60870/104/) ------
|
||||
U_STARTDT_ACT, U_STARTDT_CON = 0x07, 0x0B
|
||||
U_TESTFR_ACT, U_TESTFR_CON = 0x43, 0x83
|
||||
|
||||
@@ -76,9 +79,13 @@ T_C_IC_NA_1, T_C_RD_NA_1 = 100, 102
|
||||
COT_BG, COT_SPONT, COT_INIT, COT_REQ = 2, 3, 4, 5
|
||||
COT_ACT, COT_ACTCON, COT_ACTTERM = 6, 7, 8
|
||||
COT_PN = 0x40 # cause byte bit6: negative confirm
|
||||
# NOTE(2026-10-25 m104fix): THIS SLAVE USES THE B4 IN-HOUSE 6-BYTE ASDU HEAD --
|
||||
# T/PN/RBT FLAGS LIVE IN THE CAUSE BYTE (bit7/bit6/bit4), byte[3] IS OA+EVI(bit7).
|
||||
# SEE App/iec60870/104_port/iec104_asdu.c iec104_asdu_put_hdr(). The old RX path read
|
||||
# NOTE(2026-10-25 m104fix): THE 6-BYTE ASDU HEAD PUTS T/PN FLAGS IN THE CAUSE BYTE
|
||||
# (bit7/bit6) AND byte[3] IS OA -- NOT COT HI. Current firmware config is sizeOfCOT=2
|
||||
# (App/iec60870/104/IEC104_Types.h IEC104_APP_LAYER_PARAMETERS_DEFAULT), written by
|
||||
# App/iec60870/common/IEC60870_Asdu.c: buffer[2] = cause | PN<<6 | TEST<<7, buffer[3] = OA.
|
||||
# The in-house writer this note was first written against, old
|
||||
# App/protocol/iec104/iec104_asdu.c iec104_asdu_put_hdr(), was deleted on 2026-11-18
|
||||
# with the skeleton MCU migration. The old RX path read
|
||||
# PN from byte[3] (standard 2-byte-COT habit) -> pn was ALWAYS False and a rejected
|
||||
# command logged cot=71 (7|0x40), so actcon_of(type, True) could never match.
|
||||
# Bench proof 2026-10-25 (V5-gap replay): two out-of-range C_SE writes
|
||||
|
||||
@@ -350,8 +350,8 @@ static void tc_yx_points(void)
|
||||
/* 遥信行数 33 是**产品视图**的点数,不是协议点表的点数。这里是**有意**再抄一遍
|
||||
* 字面量:测试的职责是独立见证,改点数时必须有人被绊一下——绊到后要同时改:
|
||||
* ui_data.h 的 UI_DATA_YX_N、页面名表 ui_page_yx.c(有编译期数组守卫兜着)、本条。
|
||||
* 历史:割接前 33 同时等于旧产品点表 App/iec60870/104_port/iec104_pts.c 的 YX_N
|
||||
* (该文件 2026-11-17 通信骨架割接已删除);现在协议侧是 DTU 标准表
|
||||
* 历史:割接前 33 同时等于旧产品点表 App/protocol/iec104/iec104_pts.c 的 YX_N
|
||||
* (该文件 2026-11-17 通信骨架割接弃用、2026-11-18 随骨架迁 MCU 删除);现在协议侧是 DTU 标准表
|
||||
* iec104_dtu_table.c 的 SP 59 + DP 16 = 75 个遥信点,**两者语义不同、数值本就不等**,
|
||||
* 写侧 ui_data_feed.c 留了一条一次性 DBG_ERROR 把这个差异显式化,不改显示 */
|
||||
CHECK((uint32_t)UI_DATA_YX_N == 33u, "TC-UIDATA-009d point count is 33 (YX_N witness)");
|
||||
@@ -1309,8 +1309,9 @@ static void tc_maint_forwarding(void)
|
||||
(void)ui_data_maint_oper_note("force reset by panel");
|
||||
CHECK((s_stub_note_calls == 1) && (strcmp(s_stub_note_last, "force reset by panel") == 0),
|
||||
"TC-UIDATA-026i page-side note reaches executor verbatim");
|
||||
/* 面板这条与远端 YK11 那条(App/iec60870/104_port/iec104_pts.c 投的
|
||||
* "force reset")必须是不同串,否则审计面再也分不出"主站下发的"还是
|
||||
/* 面板这条与远端 YK11 那条(旧 App/protocol/iec104/iec104_pts.c 投的
|
||||
* "force reset",该文件 2026-11-18 已删除;骨架阶段 104 侧无此记录)
|
||||
* 必须是不同串,否则审计面再也分不出"主站下发的"还是
|
||||
* "现场有人按了面板"。比的是执行侧缓冲里的实际内容,不是两个常量互比 */
|
||||
CHECK(strcmp(s_stub_note_last, "force reset") != 0,
|
||||
"TC-UIDATA-026s posted note differs from the remote YK11 wording");
|
||||
|
||||
Reference in New Issue
Block a user