wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

补充总召唤的广播地址，电度召唤+时钟同步业务的实现
CI / L0 静态门禁 (pre-commit) (push) Failing after 44s
Details
CI / L0.5 主机侧单测 (MSVC) (push) Failing after 42s
Details

Browse Source
This commit is contained in:
STF
2026-10-29 03:20:19 -07:00
parent 4c55544f05
commit 7596f3371a
267 changed files with 130894 additions and 1436 deletions
Download Patch File Download Diff File Expand all files Collapse all files
IEC60870-Slave/docs/test/IEC104测试文档.md
+43 -5
View File
@@ -1,6 +1,6 @@
# IEC104 测试说明
> **目录与命令同步日期**：2026-10-26。测试代码位于根目录的 `test/`，本文仅列出当前保留的测试入口及可运行命令。
> **目录与命令同步日期**：2026-10-29。测试代码位于根目录的 `test/`，本文仅列出当前保留的测试入口及可运行命令。
> **配套文档**：[TCP服务设计](../104/IEC104_TcpServer_设计架构.md)、[链路设计](../104/IEC104_Link_设计架构.md)、[发送模块设计](../104/IEC104_发送模块_设计架构.md)。
## 1. 当前测试入口
@@ -13,14 +13,20 @@
`iec104_tcp_scheduler_test.c`复用上述可控Net后端，包含25个调度场景；其中2个明确验证原有严格容量背压策略仍会超时，不能把测试通过解释为消除了队头阻塞。`iec104_net_pending_input_test.c`使用当前Windows后端进行真实本机回环检查。
`iec104_slave_test.c`复用同一可控Net后端，包含15组统一子站入口和共用应答接口测试：12种字段布局的可写ASDU借用、原地字段修改和失败保留、函数指针分派、从I_FRAME事件到确认/终止的完整发送字节、构造容器发送、HIGH满后的WAIT及重试、非法布局/长度/空指针、事件身份及请求状态校验、旧代次拒绝及FATAL诊断；另覆盖延迟事件复制、Close/Init及服务槽复用、两层池生命周期、外部调度和离线主动上报。共用层使用非104参数的测试接入验证分派，不代表已提供101串口传输。
`iec104_slave_test.c`复用可控Net后端，共32组统一入口测试，覆盖ASDU视图、共用发送分派、确认/终止字节、HIGH背压、非法参数、原连接身份、延迟复制、服务复用、生命周期、外部调度及离线上报。站点测试覆盖13节点、CA/context隔离、删除即时退出路由与引用延迟回收、同CA替代节点的注册编号、快照期间增删/嵌套/结束回收、显式集合锁及跨服务误用；新增9组同步拒绝回归。共用层非104参数测试不代表已提供101串口传输。
因接口过期而无法编译的旧协议、发送管理器、TCP模拟后端和Windows回环测试及其专用辅助文件已删除。这里新增的测试均使用当前接口，历史测试未恢复。
`iec104_slave_example_test.c`验证总召模块及单文件示例，包含59组业务流程测试：完整报文、部分写入、各阶段WAIT续发、错误请求、忙时否定确认、停用/断线取消、格式错误、任务积压及通知预算后的STOP/START。`test/slave_example_loopback_test.cjs`启动实际示例进程，通过Windows后端和真实本机TCP验证总召及错误应答。构建及点表见[示例说明](../examples/IEC104子站示例.md)。
`iec104_slave_example_test.c`包含原98组总召基线，覆盖总召报文、部分写入、各阶段WAIT、忙拒绝、撤销、STOP/断线、need_process、突发排序、不排队提交及业务/链路期限。提交期通知覆盖三个入口的STOPPED归因、FATAL与STOP并存、非STOP的ERROR、OK/WAIT伴随新回执及START后恢复。畸形请求覆盖可靠否定/丢弃边界、基础截短仍被Receiver拒绝、输入原文保持、活动总召/期限不变、背压满槽及广播撤销隔离。多站覆盖13站三阶段顺序、非空混合批次、状态区不足/重叠、已确认未来站删除与同CA重建、超出2槽FIFO的FINISHED交付、各阶段定向及满槽广播撤销、拒绝与撤销同时等待、非当前站总期限，以及总期限禁用、BEGIN先到期和两项同时到期的处理优先级。`test/slave_example_loopback_test.cjs`通过Windows后端与真实TCP验证命令行单站，多CA由可控Net回归覆盖。构建及点表见[示例说明](../examples/IEC104子站示例.md)。
同步拒绝接口回归检查COT=44..47的原文回显、TEST/OA/CA/VSQ及对象字节保留、输入事件和最近提交结果不变、非法参数及原服务/会话隔离。未读启停通知拒绝提交；已消费STOP/START后的旧事件不在同步接口允许的调用范围内，不能用状态计数为0证明其仍有效。示例回归覆盖连续及重复内容的新命令、HIGH真满时丢新且保留连接/旧应答、活动总召中的兜底、启停与发送故障收尾；原同批兜底回归继续保留。接入校时后的真实TCP对103与102同批发送分别核对ACT_CON和COT=44，不保证跨业务响应顺序。接口与丢新语义见[同步拒绝当前请求](../104/IEC104_API接口汇总.md#reject-request)。
校时测试使用模拟action及可控单调时钟，不设置Windows时间。覆盖Handle/Process不执行应用、显式执行一次、原CP56回显、COT/CA/IOA校验优先级、TEST/IV/非法CP56拒绝、SU/时区转换、受理起滞留补偿、日期上界和64位运算、期限与倒退、Try背压不重复动作、FIFO/满槽、STOP/断线/旧会话、广播快照及删除目标，以及action内只读状态。真实设备写入耗时、权限及失败后的硬件状态不由这些模拟测试证明，边界见[时钟同步设计](../104/IEC104_ClockSynchronization_设计架构.md)。
## 2. 编译与运行
当前业务测试由98组总召、12组计数量、4组兜底及16组校时组成，共130组，单/双服务配置各跑一次。计数量覆盖独立实例、请求校验、Type15/37批次边界、忙隔离、冻结/复位、动作重复调用和WAIT/STALE/TEST、业务期限、STOP/断线、共享连接失败、发送背压及多站广播；兜底改用未支持的106/102，覆盖同批与反序/重复内容、窗口与写阻塞、HIGH满丢新及恢复、STOP/STOPSTART取消和活动总召中的应答。校时专项检查独立受理与执行、原文确认、补偿/期限、广播及生命周期。`iec104_interrogation_rules_test.c`另有3组规则测试，遍历限定词、数据COT和类型/SQ/FRZ矩阵并检查解析；没有网络交互。
在项目根目录的PowerShell中执行，要求GCC可用。下述TCP事件环和调度测试已包含TcpServer实现且自行实现Net接口，构建时不要再次链接`IEC104_TcpServer.c`或`IEC104_Net_Windows.c`。
```powershell
@@ -126,7 +132,7 @@ if ($LASTEXITCODE -ne 0) { throw 'Slave replies build failed' }
if ($LASTEXITCODE -ne 0) { throw 'Slave replies tests failed' }
```
输出`Slave service: 15 groups passed (automatic replies, deferred copies, lifecycle, request validation)`。默认及`-DIEC104_TCP_SERVER_CAPACITY=2`均运行同一套测试。确认及终止的期望字节直接由独立请求向量和明确COT字节比较，不使用待测应答函数生成预期结果。确认提交失败仍保留已修改的COT/P/N，队列未接手时不增加条目；重连后旧代次无法写出应答。FATAL用测试内注入的队列不可用状态验证结果传递，不能据此声称覆盖了所有发送故障或部分写出组合。
输出`Slave service: 32 groups passed (replies, identities, stations, lifecycle, backpressure, rejection)`。默认及`-DIEC104_TCP_SERVER_CAPACITY=2`均运行同一套测试。确认及终止字节由独立请求向量和明确COT比较，不用待测函数生成期望。失败且未接手时不增加队列条目，旧代次不能写入新连接；FATAL注入验证结果传递，不代表穷尽所有发送故障组合，也不能把取消计数解释为确定没有字节写出。
参数矩阵遍历COT=1/2、CA=1/2、IOA=1/2/3：288组双对象监视报文布局、216组命令编解码报文；应答单独遍历全部30类型、12种配置、7种COT及两种P/N。所有布局检查截短输入及额外尾字节。边界测试检查省略OA、1字节CA溢出、三种IOA连续地址溢出、非法/NULL参数、容量与配置上限分别生效、4字节未知类型应答的重叠复制及5字节读命令。通用ASDU可编码/解析254字节报文，而104 I帧封装仍拒绝该长度。
@@ -140,7 +146,7 @@ if ($LASTEXITCODE -ne 0) { throw 'Slave replies tests failed' }
./scripts/build.ps1 -Test
```
先输出`slave example + event interrogation tests: 59 groups passed`，再输出`Slave example loopback: passed ...`。可控后端使用251字节HIGH和2槽业务事件FIFO，验证WAIT时原文及进度保留；真实回环使用默认存储、k=1、随机本机端口，验证分片请求、逐帧ACK、错误应答、STOP/START、重连及4秒后的正常退出。这里只实现模拟点表总召，不包含实际校时、遥控业务，也不构成完整互操作认证。
脚本输出两次`Slave service: 32 groups passed ...`（单/双服务）、两次`slave example + event interrogation tests: 130 groups passed ...`、`interrogation rules: 3 groups passed ...`和`Slave example loopback: passed ...`。可控后端使用251字节HIGH和2槽召唤业务事件FIFO。真实回环使用默认存储、k=1、随机本机端口，验证总召与计数量交错、冻结/复位及后续读取、分组/广播、TEST拒绝、COT=8返回45、106/102同批回44、STOP/START、重连及8秒后的正常退出。校时另核对正常7、TEST否定7、COT=5否定45、广播实际CA及103/102同批先44再7，全部使用模拟时钟且连接保留；STOP为submitted=65、clock_executed=3、clock_synchronized=3、clock_submitted=5。这里没有真实计量设备、系统设时或遥控，不构成完整互操作认证。
## 3. 覆盖范围
@@ -199,8 +205,40 @@ if ($LASTEXITCODE -ne 0) { throw 'Large configuration tests failed' }
调度专项使用同样的配置参数，将命令中的`@testSources`换为`@schedulerSources`并使用独立输出文件名即可。
### 校时固定存储与栈测量
2026-10-29 Windows x64 GCC默认配置实测：ClockTask为104字节，含4槽的ClockSynchronization实例为568字节，Request为80字节，Status为72字节；默认单服务的校时静态实例数组占568字节，不是完整协议库RAM总量。探针及产物位于`.build/clock-synchronization-20261029/size_probe.c/exe`。
`-O2 -fstack-usage`报告的单函数栈帧：Handle_Event 256、Execute_Next 240、Submit_Head 224、Process 64、Get_Status 80字节；示例main由修改前768增至800字节，Clock_Action为48字节。记录为同目录的`example-before.su`、`example-after.su`及`clock.su`。这些是x64宿主ABI和单函数测量，不是最坏调用链，也不代表ARMCC/MCU的RAM或栈占用；嵌入式接入须按实际工具链重新核算。
## 5. 验证记录
2026-10-29 Type 103时钟同步：新增独立静态池模块、显式Execute_Next动作、64位受理后滞留补偿、执行期限、原文ACT_CON及广播快照确认；示例默认模拟，显式system模式才设置Windows时间。整合`build.ps1 -Test`中GCC `-std=c11 -O2 -Wall -Wextra -Werror`构建无诊断，Slave单/双服务各32组、业务单/双服务各130组（98总召、12计数量、4兜底、16校时）及3组规则测试均通过。脚本内首次Node启动因沙箱`spawnSync EPERM`失败，因此该次脚本整体不是成功退出；随后获准单独重跑相同Node回环命令，退出码0，真实本机TCP通过，核对submitted=65、clock_executed=3、clock_synchronized=3、clock_submitted=5。默认模拟校时的正常/TEST/COT=5/广播及103+102同批均覆盖，未执行system模式或真实设备设时。改前基线、大小探针及栈测量位于`.build/clock-synchronization-20261029/`。
2026-10-28 业务目录整理：共用召唤引擎、内部规则头、总召和计数量共7个源码/头文件移到`104/business/`，迁移前后SHA256逐字节一致；构建加入该目录的头文件搜索路径，同步测试直接包含路径及文档源码链接。严格GCC构建通过，单/双服务各110组业务测试、23组Slave测试及3组规则测试通过，公开头C++检查和真实Windows TCP回环通过。沙箱限制Node启动子进程时，回环使用原授权命令在沙箱外执行。迁移清单及备份位于`.build/business-layout-20261028/`，修改仅限IEC60870-Slave；未执行Keil目标构建或硬件联调。
2026-10-28 计数量召唤：先验证原98组总召、单/双服务各23组Slave及真实TCP基线；拆分规则后原98组不修改通过。新实现用独立规则和实例复用引擎，动作接口校验后执行一次，冻结/复位只确认，不制造取数阶段；总召接口名称和行为保留。严格GCC构建通过，110组业务测试在单/双服务配置均通过，3组规则测试、10组ASDU和7组扩展ASDU测试通过。真实Windows TCP回环通过；沙箱限制Node子进程启动（EPERM）时，原回环命令在获准的环境中运行通过。只链接总召或只链接计数量（实例容量1）的创建/销毁检查通过。修改前字节备份和验证产物位于`.build/counter-interrogation-20261028/`。未执行Keil目标构建或硬件联调；本次仅修改IEC60870-Slave目录。
同日Windows x64 GCC实测：实例1240→1248字节，默认单服务池1240→2496字节，请求32字节、事件80字节、广播每站48字节不变。新增请求字段使用原尾部填充，旧字段偏移保留；此测量不代替ARMCC目标的RAM/栈预算。只用一种业务可显式缩小实例池。
2026-10-27 广播总期限判定收敛：Task_Timeout以同一次取时返回最近期限、原因及已确认站到期标志，Expire不再重复遍历。公开API、固定存储容量及超时处理策略不变。新增总期限禁用、BEGIN先到期和同时到期用例，重构前后均通过。GCC C11严格警告构建、98组总召、单/双服务各23组Slave及真实Windows TCP回环通过；回环在沙箱内因子进程EPERM失败，按原命令在沙箱外重跑通过。修改及验证限本目录，未执行Keil构建或硬件联调。
2026-10-27 提交期STOP归因：总召三个发送入口仅在ERROR时复核原连接正常停用状态，先交付DEACTIVATED，保留STOPPED原因；其他ERROR/FATAL不降级，成功路径不增加查询。目录内严格编译、97组总召、单/双服务各23组Slave及真实Windows TCP回环通过。新增真实通知容量背压复现，以及其他入口的容量/故障注入；验证等待不推进批次、不停止取数计时、不重复提交，STOP伴随FATAL仍为SEND_ERROR，OK/WAIT交付新回执后暂停后续提交。原临时复现程序已迁入正式测试，公开接口和固定存储容量不变。
2026-10-27 总召畸形请求隔离：单对象完整但SQ/尾字节错误时规范化否定应答，零/多对象丢弃；公共视图失败交公共入口，基础截短仍由Receiver处理。目录内生产示例通过严格警告编译，92组总召回归及单/双服务各23组Slave回归通过，真实Windows TCP回环通过（沙箱子进程EPERM后按原命令重跑）。覆盖畸形激活/撤销不取消已有总召、不刷新期限、不修改输入，以及FIFO背压、满槽丢弃和多CA活动广播继续完成。未增加任务槽或发送缓冲，修改及验证均限IEC60870-Slave目录。
2026-10-27 c104广播发送顺序：合法多目标广播改为全部ACT_CON、逐站数据、全部ACT_TERM，调用方提供每站状态区，仍共用一个任务。87组总召及23组Slave回归在单/双服务配置下通过C11严格警告编译及运行；生产示例构建和真实Windows TCP回环通过。新增覆盖状态区不足/重叠、非空多站报文、已确认未来站删除、13条FINISHED通过2槽FIFO无损交付、满槽及跨阶段撤销、拒绝与撤销并存、非当前站总期限。回环因沙箱子进程EPERM按原授权命令重跑。Windows x64默认配置实测管理对象1240B、每站状态48B，通信队列容量和覆盖策略不变。文档197个本地链接及锚点、UTF-8编码和diff空白检查通过；修改及验证均限本目录。
2026-10-27 多CA总召及站点删除：Remove即时退出路由，引用/快照结束后回收；总召按请求CA选站，广播以一个任务逐站推进。23组Slave及78组总召测试均在单/双服务配置下通过`-std=c11 -O2 -Wall -Wextra -Werror`编译和运行，包含13站广播、同CA替换、三阶段WAIT及撤销/超时/STOP。生产示例严格编译和真实TCP回环通过；回环子进程EPERM后以已授权原命令运行。Windows x64默认配置测量：站点40B、快照32B、Slave40B、总召1192B、任务168B；通信队列容量及事件覆盖策略未变。本次修改与验证仅在IEC60870-Slave目录内进行。
2026-10-27 共用站点基础：Slave提供调用方节点注册、按CA查找、context、引用及集合锁，总召可绑定已注册节点，示例改为注册一次CA后复用。22组Slave测试及70组总召测试均在单/双服务配置下通过`-std=c11 -O2 -Wall -Wextra -Werror`构建与运行；生产示例严格编译及真实Windows TCP回环通过。回环因沙箱子进程EPERM使用已授权原命令重跑。当前总召仍只处理一个绑定站点，未验证或宣称多CA总召调度。x64测量每节点32字节，Slave32字节，总召968字节，通信队列及业务槽容量不变。仓库`.venv`和可执行Python缺失，`@build`及RAM/栈报告入口未能启动；未执行ARMCC目标验证或硬件联调。
2026-10-27 总召请求存储精简：任务改为保存原事件身份及10字节Type100原文，发送时临时建立ASDU视图；Slave新增按身份发送/尝试发送/关闭接口，保留原服务实例与连接代次校验。任务、事件及传输队列容量和覆盖策略未调整，内存测量见[固定存储](../104/IEC104_Interrogation_设计架构.md#2-对象身份与固定存储)。68组总召回归、18组Slave回归（默认及双服务配置）和真实Windows TCP回环通过严格警告构建及运行。新增验证源事件复用、输入存储释放、HIGH接手条数不变、Try等待不入队/覆盖及旧身份隔离；原总召回归继续覆盖忙拒绝、广播错误字段、满槽撤销、超时、STOP和新旧数据排序。回环子进程经已授权的原命令运行；未执行Keil目标构建或硬件联调。
2026-10-27 总召与突发发送排序：总召数据改为不排队提交，有未提交HIGH/NORMAL、当前帧或窗口背压时返回WAIT；应用保留事件及游标，重读当前值后重试。有效批次遇发送WAIT后停止本批取数期限，下一批重新计时；示例仅在OK后推进游标。68组总召测试、13个TCP事件环场景、25个调度场景及15组Slave测试通过C11严格警告编译与运行；真实Windows TCP回环通过。回环子进程在沙箱内遇EPERM，经授权使用原命令重跑通过。新增场景覆盖新旧突发及总召顺序、部分写入、窗口和期限边界、提交故障；产物位于`.build/`，未连接实际设备。
2026-10-26 总召本地续跑：状态新增need_process，示例直接据此决定立即续跑；实时检查未读Slave通知，发送WAIT后让出，网络推进后继续重试。62组可控网络测试通过C11严格警告编译与运行，覆盖业务应答、旧FINISHED出队释放空位、短应答、四类发送背压、到期及STOP/START优先；真实Windows TCP回环通过。回环在沙箱内启动子进程遇到EPERM，经授权使用原测试命令重跑通过。产物位于`.build/slave-example/`，未连接实际设备。
2026-10-26 目录整理：104协议、公共模块、示例、测试、文档和构建脚本分别归入 `104/`、`common/`、`examples/`、`test/`、`docs/` 和 `scripts/`，同步头文件搜索路径、示例引用及文档命令。49个生产源码/头文件的SHA256与迁移前一致，21个生产C文件通过C11严格警告检查。按本文命令运行的默认/纯整数时间ASDU测试（各10组）、扩展ASDU测试（各7组）、104封装2组、子站15组、TCP事件环默认/小容量/大容量各13组、调度25组及Windows输入查询回环均通过；从非项目根目录调用构建脚本，示例编译及59组总召测试通过。真实TCP回环核对62个ASDU和11次正常完成的总召通过。当前执行环境拒绝Node默认子进程管道（EPERM）；本次回环以临时文件接收真实子进程输出，原测试代码、网络交互和断言未修改。迁移清单、路径校验及临时运行适配保存在 `.build/layout-migration/`，未连接实际设备。
2026-10-26 广播地址处理重构：新增固定协议常量IEC104_CA_BROADCAST，Type100入口一次确定应答CA，统一在内部请求副本建立时写入；Process及发送重试直接沿用该地址。移除重复任务header，批次COT/OA/TEST从info校验，CA继续按本站配置校验。原59组可控网络测试通过C11严格警告编译与运行，覆盖广播及定向总召、错误CA回显、发送WAIT、忙拒绝、撤销及确认前失败。真实Windows TCP回环继续通过，核对62个ASDU和11次正常完成的总召。修改前备份与可控测试产物位于`.build/interrogation-address-copy-20261026-031956/`；公开函数签名、事件及配置字段不变。