wandering1
|
7d1db02164
|
perf(iec104): 参数区按 17 项真实消费者收窄并接上真实定值模型
104 协议侧参数通道此前镜像了厂商点表的全部 430 条参数(697 槽),
但其中 413 条在本设备上没有任何消费者——104 与设备侧真实定值模型
prot_set 之间零调用,主站改定值只落在无人读的 RAM 镜像里,保护功能
毫无感知。本次按"严格按消费者收窄"口径收口:
可见性以 iec104_dtu_protection_mapping() 语义桥表为唯一判据,只放行
三段过流投退/定值/延时(9 项)、低压与过压定值/延时(4 项)、PT 与
CT 一次/二次额定(4 项)。其余参数在位表枚举层即不可见,主站读取
得到 COT=47 + P/N=1 的显式否定确认,不静默丢弃。values[697]→values[53]、
staged[264]→staged[17],并删除生成式 iec104_source_ranks.h。
桥表接真实源:iec104_serv 的 parameter_read/apply 从 NULL 改为直读
prot_set 与整批原子提交,Q10 量化后一次事务落地,持久化仍由
defaultTask 的脏标志闭环负责。
prot_set 因此出现两个运行时写者(netTask 的 104 与 uiTask 的本地整
定),原"写者靠启动时序串行"的约定失效。加入写事务互斥与 seqlock
序号:四个写入口全部进锁,校验与提前返回一律在 enter 之前;序号卡
奇数连续 8 拍即判保护闭锁,避免自检被永久跳过而静默失去防篡改能力。
锁的安装在 defaultTask 的存储 bring-up 阶段,不在 app_main_init——
后者早于 osKernelInitialize,内核启动前禁止任何 RTOS 创建类 API。
实测:RW_IRAM1 117,304→113,720 B(−3,584 B,89.50%→86.76%);
ER_IROM1 413,392→411,668 B(−1,724 B);iec104_source.o 5,656→2,056 B;
prot_set.o 344→352 B(+8 B,写事务序号与锁句柄)。Keil 构建 0 错误
0 警告;主机侧 prot_set 175/175、iec104_dtu 7/7;真实 TCP 验收
13/13;暂存口径门禁 18 项全通过。
已知边界:模拟器不链接 iec104_serv.c,TCP 验收不覆盖 prot_set 绑定,
板端需实机确认主站写入能反映到本地定值页;17 项中 15 项的出厂默认
值与点表字面量不同,主站读到的是真实模型的值;绑定真实源后定值区
切换一律拒绝(单套活跃值无原子整区事务)。
|
2026-11-19 15:48:21 +08:00 |
|
wandering1
|
ed25fc5a4d
|
perf(iec104): 删死仿真数组并按类型分表存变化检测基线,省 816 B RAM
104 的内存大头不在协议栈本身,而在两处「每层各留一份、且按最宽类型统一
存储」的静态数组。本次按实测逐项瘦身,行为等价有证:
一、iec104_source.c 删掉 5 个无写者的模拟注入数组(ZI -288 B)
singles / single_set / doubles / measurements / measurement_set 的唯一
写入点是 init() 的 memset,全仓无 setter、无导出写 API、simulator 与
test 也无人写。故 single_set/measurement_set 恒 0 使对应 if 分支永假、
doubles 恒 0 使 type3 分支恒返回零值+NO_SOURCE_QUALITY。
保留 steps/bits:iec104_source_find() 用它们响应 IOA 0x1201..0x1208 与
0x1301..0x1308,删掉会把「返回 0+品质」变成「未知地址」,属协议行为变化。
实测 ZI 5912 -> 5624,比数组名义总和 284 多 4 B,因两处 2 字节对齐空隙
一并消失。
二、iec104_core.c 变化检测基线按点类型分表(ZI -528 B)
原 core_previous_t previous[105] 每点 8 字节(uint32 value + quality +
bool,对齐补到 8),840 B。改为按点表顺序分三段:单点 u8 x59、双点
u8 x16、测量值 u32 x30,品质按原索引逐点存,initialized 改位图 14 B。
测量值仍按 32 位位模式比较,不是浮点比较,NaN/-0 判等语义不变。
加两道防护:编译期断言「SP+DP+ME == 105 且段边界为 0/59/75」;启动期
逐点校验 type_id 必须依次为 1/3/13,错序即启动失败——否则会静默把一种
类型的值当另一种比较。校验在每次 core_start 跑 105 次,刻意不缓存成
静态标志:重连后点表若被改坏,这一次就是唯一防线。
等价性证据(独立审查员复算,非自述):
iec104_source_point() 225 点全表 x 回调三态 x 边界 4089 条轨迹逐字节一致;
变化检测 133,560 次判定/读回零差异;4 个位置的变异体各自红在埋点行,
证明这几条判据不是恒真摆设;去掉启动校验后乱序点表在主机用例里静默通过。
实测(权威构建,同一台机器前后对比):
RW_IRAM1 118,120 -> 117,304 B(-816,90.1% -> 89.5%)
ER_IROM1 413,416 -> 413,392 B(-24)
iec104_source.o ZI 5912 -> 5624;iec104_core.o ZI 3192 -> 2664
s_core 2928 -> 2400 B
顺带把 App/task/iec104_serv.c 两处写死的源码行号改为「文件路径+函数名」
锚点,重构后不会漂移。
|
2026-11-19 12:51:45 +08:00 |
|
wandering1
|
f23d30111d
|
perf(iec104): TcpServer 时间戳降到 32 位、控制帧槽 8→4,省 296 B RAM
单连接子站的 TcpServer 结构体(server_pool[1])原来 7656 B,其中大量
绝对时刻用 64 位存,纯属浪费。按两条线索瘦身:
一、毫秒时间戳 64→32 位
涉及 SendBuffer 发送槽状态、SendManager I 帧记录、Connection 的六个
时刻字段、TcpServer 的两个重试时刻与 ack 观察槽。这些字段只用于
「记下时刻、稍后相减求是否超时」,改成 32 位后按无符号差值 / 有符号
差值判断,49.7 天回绕天然正确,不必再做回绕扩展。
有两处原本是大小比较,一并改成差值判据,否则回绕瞬间会误判时钟倒退:
- IEC104_Connection 的 Check_Time 判单调性
- Dispatch_Received_Frame 判活动时刻是否更新
两个重试时刻用 0 表示「未暂停」,赋值后补一条抬到 1ms 的兜底,避免
恰好回绕成 0 被当成未暂停。
取时刻的入口收敛到 TcpServer 里一个静态函数,出口截断成 32 位;
对外 ABI 未变:Now_Ms 仍取 64 位单调毫秒供 CP56/UTC 时基使用,
查询 ack 时刻的出参仍是 64 位,测试夹具的哨兵语义不受影响。
二、控制帧槽 IEC104_TCP_CONTROL_CAPACITY 8→4
S/U 帧 FIFO 在单连接子站里实际深度是个位数,8 是通用多连接库的默认
值。取模与队满判断全部走运行期容量,无硬编码,改默认值即可。
实测(权威构建,同一台机器前后对比):
server_pool 7656 -> 7360 B(-296)
iec104_tcpserver.o ZI 7656 -> 7360
RW_IRAM1 118416 -> 118120 B(90.3% -> 90.1%)
ER_IROM1 414232 B 不变
验证:Keil 0 错 0 警;模拟器构建通过;真实 TCP 回环 13/13;单测
iec104_comm 50/50、iec104_serv 50/50、soe 32/32、netmcu 13/13 + 2/2、
iec104_dtu 7/7;覆盖率 89.3% 无回退;pre-commit 12 项通过 0 失败;
内存台账 --check 一致、--gate 通过。
|
2026-11-19 00:31:41 +08:00 |
|
wandering1
|
2053f6d913
|
docs(iec60870): 把 104 板端落地文档归入 docs/iec60870/板端落地
四篇讲「本项目怎么接 104」的文档原来散在子系统设计与网络两个目录,
和随库迁入的 36 篇协议库设计混在一起。现集中到 docs/iec60870/板端落地/:
- IEC104上行设计说明.md(原 docs/子系统设计/)
- IEC104_Net适配契约.md(原 docs/网络/)
- IEC104_MCU落地规划.md(原 docs/子系统设计/)
- IEC104_MCU最小可行性验证.md(原 docs/子系统设计/)
改动:
- 四篇 git mv 保留历史,全库引用经 rename_ref.py 逐篇改写(27 个文件
54 处引用行),旧路径残留扫描为 0。
- docs/README.md:§5.3 改为「IEC 60870-5-104 文档(40 篇)」,拆成
「板端落地 4 篇」与「协议库设计与接口 36 篇」两张表,说明两条轴的分工;
从 §5.1 功能子系统表里移除这三篇的重复条目。
- docs/iec60870/README.md:新增两条轴入口与板端落地表,原阅读顺序
改标注为「协议库部分」。
验证:
- check_doc_links.py --all --sections-strict:310 篇 0 问题。
- 三份索引 markdown 链接可达性逐个 exists() 校验,断链 0;索引表覆盖
36 篇协议库文档,与实际磁盘文件双向差集为空。
- 板端落地目录 4 篇 BOM / CR / U+FFFD 均为 0。
- 工作树 Keil 权威构建 0 errors 0 warnings(Code=365896 RO=48336
RW=2736 ZI=173104),此后预提交 21 Passed / 0 Failed。
|
2026-11-18 23:31:37 +08:00 |
|
wandering1
|
c6612ddd6d
|
merge: 104 文档迁入 docs/iec60870、点表并回 104、按项目规范整理文档
|
2026-11-18 23:01:08 +08:00 |
|
wandering1
|
cb59f1cf47
|
merge: 合入网络 fd 失效值契约(含 104 目录重构解冲突)
把 dsh-204f318c-38b4 的网络 fd 契约工作流合入主树:NET_FD_INVALID
单一契约 + 静态门禁 + 回归测试 + 全仓审计 + 最小加固。
解冲突与集成修复:
- 5 个数值快照(RAM 文档/tsv/size_attestation/report.json)两侧各自
过时,取主线重构后结构,合并后用权威 Keil 构建(0/0)重新回填:
Code=365896 RO=48336 RW=2736 ZI=173104,IRAM1 90.3% / CCM 87.9%。
- iec104_net_mcu.c 的 net_fd 改动随主树 104 目录重构
App/protocol/ → App/iec60870/ 自动迁移,路径正确。
- net-handle 豁免面从旧路径 App/protocol/iec60870/ 对齐到主树重构后的
App/iec60870/(大写 IEC104_* 上游代码暂免检,小写 iec104_* 自研
适配层仍受检),消除 read_socket 布尔标志的误报。
验证:net-handle 0 违规/493 文件 + selftest 42 PASS;size-gate 同码
PASS;mem 双区 <92%;本次 6 文档链接 PASS;主机套件全绿。
预存红项(ioboard_di.c / IEC60870-Slave 第三方文档)不在本次提交。
|
2026-11-18 22:28:49 +08:00 |
|
wandering1
|
67a6467c9e
|
refactor(iec60870): 把 DTU 点表 profile 从 examples 并入 104
App/iec60870/examples/ 只有一份 iec104_dtu_profile.h,且被
iec104_dtu_table.c 包含进产品(const 数据进 Flash),是实打实的
产品代码,不是示例。按用户裁定把它并入 104/ 后删掉整个 examples/:
- iec104_dtu_profile.h 移到 104/,examples/ 目录整个消失;
- Keil uvprojx 与模拟器 CMakeLists 各删一条 include 路径;
- 补文件头注释让该头过 coding-standard(RC=0),同时删掉
.pre-commit-config.yaml 里 App/iec60870/examples/ 的豁免,不扩大排除面;
- 三个 README 同步(App/、iec60870/、104/),examples/README.md 的
三条点表约束并入 104/README.md;
- 引用图重生成,覆盖率基线路径更新,代码面 examples 引用归零。
验证:Keil 0 errors 0 warnings(Code=365792,与基线一致)、模拟器
build_sim OK、TCP 回环 13/13、6 个单测全过、覆盖率 8204/9185
(89.3%) 数字未变、pre-commit 18 Passed 0 Failed。
|
2026-11-18 22:28:05 +08:00 |
|
wandering1
|
f16e8b9094
|
chore(iec60870): 删掉 4 个声明了却无实现的死头文件
这 4 个头共 364 行,共同特点是「声明了一批链接不上的符号」:函数有 extern
声明,但对应的 .c 当初没随迁,全仓也找不到任何一处 include 和调用。谁哪天
顺手 include 一下,得到的不是编译错误而是链接错误,排查成本更高。
逐个核过再删:
- IEC104.h(72 行):旧单路接收入口。3 个 extern 函数全仓 0 定义 0 调用,
它定义的 IEC104_RxStage_t / IEC104_RxResult_t 也无一处使用。接收这件事现在
由 IEC104_Receiver.c 负责。
- IEC104_Log.h(103 行):日志接口。3 个 extern 全无定义;本目录按零日志
惯例运行,状态通过 status 结构而非日志暴露。实现文件在原上游有,未随迁。
- IEC104_Link.h(15 行):聚合头,只做三行 include,无人引用。
- IEC104_Link_Master_StartStop.h(174 行):主站启停。9 个 extern 全无定义,
本仓是子站,主站角色从未实现;唯一引用它的是上面那个聚合头。
判据:全仓 844 个 .c/.h 扫描,这 4 个头都没有任何 include;函数级扫描确认
12 个 extern 声明在全仓 0 处定义、0 处调用;两套构建清单(uvprojx /
CMakeLists)对它们零引用,所以删除必然改变不了任何产物的字节。
连带处理:
- App/iec60870/104/README.md 删掉「IEC104_Log.h 当前是孤儿」那一行——它存在
的唯一理由就是解释这个头;§4 的零日志惯例说明保留,那是真约束。
- tools/refgraph 重生成引用关系图(4 个产物),图中已无这 4 个节点。
- 覆盖率基线重写:untested_sources 270 -> 254,清掉 16 条指向已不存在文件的
陈旧记录(含 Phase 2a 删的 12 个头,它们也一直挂在基线里没清)。分母
lines_valid 9185 不变,覆盖率仍 89.3%。
验证:
- Keil 0 errors / 0 warnings;ER_IROM1 413,992 B、RW_IRAM1 118,408 B 与删除
前逐字节一致(纯头文件不进二进制,符合预期)
- 模拟器 build_sim.ps1 OK;TCP 回环 13/13 通过
- 单测 comm 50/50、serv 50/50、soe 32/32、netmcu real 13/13 + static 2/2、
dtu 7/7
- 全量 pre-commit 8 Passed / 0 Failed;内存数字一致、RAM 门禁 PASS、
生成器幂等 PASS
|
2026-11-18 21:43:23 +08:00 |
|
wandering1
|
4784df923e
|
refactor(iec60870): 解除第三方钉死,104 协议栈按项目自有代码维护
这个目录里的 104 协议栈原先按「第三方导入、逐字节保真」的方式管理:
改动要登记进哈希清单,门禁靠对比上游字节来判断有没有被动过。现在它已经是
团队自己的代码(用户裁定有完整处置权),这套机制就变成了纯粹的阻力——
它会让正常的功能修改看起来像篡改。这一版把它拆掉。
主要动作:
- App/iec60870/IMPORT.md 改名为 README.md。原来的名字本身就在说「这是导入的」,
而按仓库文档规范,每个自建代码目录都该有 README。
- 删除 App/iec60870/UPSTREAM.sha256(84 条上游哈希)。它唯一的运行时消费者
是 transport 测试的源文件清单,那个脚本已改成显式列出 27 个 .c。
- 许可证表述改为项目自有。仓库根的 IEC60870-Slave/ 是另一件事:那份仍是原始
快照、仅作独立验证基线,许可状态未确认,不因本目录收编而改变。
- 四个子目录 README 从 4~6 行扩写到 32~69 行,各自说清职责、边界与改动纪律。
- coding-standard 的排除面收窄:从排除整个 104/ 改为只排除 business/ 与
大写开头的 IEC104_*。我们自己的适配层 iec104_*.{c,h} 重新进入受检面,
11 个文件实测 RC=0。
保留的技术知识(没有随保真框架一起删掉):C99 静态断言为何需要 shim 与
43 处断言条件未改、SOE 深度 128 的合规依据、点表元素 12B 降到 8B 以放进
const Flash、无符号上界比较消诊断、FaultEvent 的链接依赖、11 个容量宏的
默认值表、以及能力边界(历史/录波/文件/升级后端未导入)。
验证:
- 全量 pre-commit 12 Passed / 0 Failed
- doc-links 308 篇 / 30 处问题,全部在 IEC60870-Slave/ 内,我方零新增
- transport 测试改前改后编译集逐字节一致(27 个 .c,哈希相同),10 条用例全过
- 8 个改动文件字节体检 BOM=False / CR=0 / U+FFFD=0
|
2026-11-18 21:31:03 +08:00 |
|
wandering1
|
ce72cdfc41
|
refactor(iec60870): 裁掉项目用不到的信息对象类型,Flash 省约 1.9 KB
这一版的目标是把第三方协议库变成项目自己的代码,第一步先删掉项目
根本用不到的部分,让后续维护不必假装这些能力还在。
删除的 12 个纯头文件(只声明、没有实现,全仓 0 处 include):
- common/IEC60870_Comtrade.h
- common/IEC60870_EnergyFreeze.h
- common/IEC60870_EnergyFreezeFile.h
- common/IEC60870_FaultRecorder.h
- common/IEC60870_FirmwareUpdate.h
- common/IEC60870_History.h
- common/IEC60870_HistoryFile.h
- common/IEC60870_UserLog.h
- common/IEC60870_UserLogFile.h
- common/IEC60870_Clock.h
- 104/business/IEC104_FileService.h
- 104/business/IEC104_SoftwareUpgrade.h
它们描述的是录波、历史文件、用户日志、固件升级、文件传输这些没有
实现的接口,留着只会让人误以为协议栈具备这些能力。
裁掉的 9 个信息对象类型(无任何创建、解析或发送引用):
- Type 106 延时获取命令
- Type 120~127 文件传输与日志查询(Type 125 本就不在长度表里)
改动只删整块:类型定义、vtable、编解码入口、两处 switch 分支,以及
长度校验表 asdu_object_lengths 的 8 项。Type 110~113 被两个删除块
夹住的场景经逐行比对证实为 diff 对齐伪影,源码零插入、零替换。
主站若发送被删类型,仍按原路径回 COT 44(未知类型):ASDU 头解析只
用长度表判载荷,业务模块本就不认领,最后由 iec104_core 的 dispatch
统一拒绝。行为不变。
验证(本机实跑):
- Keil 0 错误 0 警告;Code 367,464→365,768,RO 48,492→48,224
- 模拟器构建 OK;真实 TCP 回环 13/13 全过
- 6 个主机单测全过(comm 50/50、serv 50/50、netmcu 13/13 与 2/2、
soe 32/32、dtu 7/7)
- 覆盖率 89.3%、49/49 套件,无回退
- 内存台账按新构建回填(ER_IROM1 413,992 B / 39.5%)
|
2026-11-18 21:06:33 +08:00 |
|
wandering1
|
13ed84a0f0
|
refactor(iec104): 把 104_port 适配层并入 104,协议栈只剩一个目录
104 从 App/protocol 迁入 App/iec60870 时,协议核心(common/ 104/ examples/)
与我方平台适配层(原 104_port/)仍分成两个平行目录。既然这个库已转为项目自有
代码,适配层没有独立存在的理由——它本来就是对协议的装配与平台后端。
本次只做目录合并,不动任何协议逻辑:
- App/iec60870/104_port/ 的 11 个文件全部移入 App/iec60870/104/
(iec104_core / iec104_source / iec104_source_ranks / iec104_net_mcu /
iec104_dtu_table / iec104_comm 的 .c/.h),空目录删除
- Keil 删掉 ../App/iec60870/104_port include 路径;模拟器 CMake 把重复的
104_port include 行合并进既有的 IEC60870_DIR/104
- 单测运行器里硬拼的 "104_port" 路径段改成 "104"(rename_ref 只认斜杠形态)
- .pre-commit-config.yaml 的 iec104-tcp 触发面去掉 104_port 前缀;coding-standard
的排除注释改写为「库已转为自有代码,排除项待收编完成后删除」
- 文档与生成物同步:项目架构总览、软件架构与运行时规格、IEC104 上行设计说明、
产品需求、网络配置说明、App/README、仓根 README,以及引用关系图与架构 SVG
验证(均为实跑):
- Keil UV4 RC=0,0 errors 0 warnings,Code=367464 RO=48492 RW=2288 ZI=173544
- 模拟器构建 OK,编译告警 0,iec104-tcp 13/13 真实 TCP 回环通过
- 受影响单测:iec104_comm 50/50、iec104_serv 50/50、iec104_netmcu 13/13 与
static 2/2、soe 32/32、iec104_dtu 7 tests OK
- 覆盖率门禁 RC=0,line 8204/9185 (89.3%),49/49 套件
- 全仓 104_port 残留:仅 App/README 里一句「原 104_port 并入 104」的历史说明
|
2026-11-18 19:17:25 +08:00 |
|
wandering1
|
c0cef2fca0
|
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。
|
2026-11-18 14:15:10 +08:00 |
|