1. 先用 IEC 104 测试工具把链路跑通:代码开发工具的最小闭环
代码开发工具的价值,往往不是替你读懂 IEC 104 协议,而是在链路还没通的时候,先给你一份能对照的报文和日志。我拿到 iec104测试工具.zip 后,第一件事不是翻协议文档,而是把解压目录、config.ini、lib 和 logs 四件事对齐。这个测试工具是典型的绿色解压型 Windows GUI 程序,核心能力在 libiec104.dll 里,靠 Windows Sockets API 加自研 ASN.1 编解码器干活,不依赖 .NET 运行时。它适合刚接手 ASDU、COT 联调的人,也适合已经能抓包、但需要脚本重放和报文级对照的熟手。先跑通最小闭环,再谈压力测试和加密联调,后面会少很多翻车。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具落地:从压缩包到可识别目录的四个检查点
2.1 解压后先看目录分层:exe、config、lib、logs 各管什么
解压后不要急着双击 iec104_test.exe。先把目录分层看清楚,因为这类工具不是安装包,路径一乱,协议栈就可能加载不到。典型结构可以整理成下面这样,不同版本略有差异,但核心文件一致:
bash复制# 解压目录的典型结构
./iec104_test.exe
./config.ini
./lib/libiec104.dll
./lib/libtls_wrapper.dll
./logs/
./scripts/test_asdu1.py
./scripts/test_cot6.py
./templates/asdu_type_45.json
这段目录列表不是好看用的,它对应的是一条排查顺序:iec104_test.exe 是入口,config.ini 管 IP、端口、ASDU 类型和超时阈值,lib 目录放协议栈,logs 目录自动记录原始报文,scripts 目录放 Python 重放脚本,templates 目录放 ASDU 字段映射模板。libiec104.dll 是核心协议栈,libtls_wrapper.dll 是可选的 TLS 封装模块,只有启用加密时才会加载。我的习惯是先把这些文件在位确认一遍,再启动主程序;如果 lib 目录被挪走,后面看到的“能打开但一发业务就断”就不是玄学,而是路径问题。
提示:
logs目录是这套工具的黑匣子,十六进制和 ASCII 双视图都落在里面。先确认它可写,再谈连接。
2.2 libiec104.dll 与 TLS 1.2:运行时依赖先于功能验证
libiec104.dll 是整个工具的协议心脏。它不依赖 .NET Framework,而是直接调用 Windows Sockets API,加上自研的 ASN.1 编解码器。这个设计的好处是机器上不用额外装运行时,坏处是协议栈文件必须老老实实待在 lib 目录里。启动前我会先做两件事:一是确认 libiec104.dll 存在且没有被安全软件隔离;二是确认系统已经启用 TLS 1.2 支持。后者不是可选项,因为工具说明里写得很清楚,Win7 SP1+ 默认开启 TLS 1.2,WinXP 已彻底不支持。如果这次联调要启用加密,libtls_wrapper.dll 才会参与加载;如果只是明文联调,可以先把它当作可选文件看待。
这里的参数取舍很简单:不要在主程序都还没起来的时候去调 config.ini 里的超时阈值。先保证协议栈能加载,再保证日志能落盘,最后才去碰连接参数。常见失败现象是主程序界面能打开,但收发功能不可用,或者一启用加密就握手失败。前者先看 lib 目录完整性,后者先看系统 TLS 1.2 支持。把这两步拆开,排查范围会小很多。
2.3 目录权限与日志落盘:先让 logs 能写再谈抓包
logs 目录不是装饰品,它自动记录原始报文,提供十六进制加 ASCII 双视图。联调时最怕的就是“界面上好像发了,日志里什么都没有”,这时候你连后悔药都没得吃。我的做法是解压后先打开 logs 目录,确认当前用户有写权限;不要把工具解压到只读目录,也不要把整个目录放到需要管理员权限才能写的路径下。启动主程序后,先看 logs 里有没有新文件生成,再决定要不要改 config.ini。
这一步的参数说明很少,但顺序很重要:先有日志,再有连接,再有业务报文。如果日志目录为空,先查解压位置和写权限,不要一上来怀疑 ASDU 类型填错。目录权限这种问题看起来低级,实际联调现场很常见,尤其是把工具直接放在压缩包预览窗口里运行,或者从只读共享目录启动。先把 logs 写通,后面脚本重放和 COT 压测才有证据可看。
3. 代码开发工具配置:config.ini 里四个参数怎么定才不白抓包
3.1 IP 与端口:先确认测试工具和被测端谁主动连谁
config.ini 是全局配置,材料里明确它管 IP、端口、ASDU 类型、超时阈值。配置前先回答一个问题:这次联调里,测试工具是主动去连被测端,还是被动监听被测端连过来?这个角色不确认,IP 和端口填反了,日志里只会看到超时。常见做法是:工具主动连被测设备时,IP 和端口填被测端的监听地址;工具被动监听时,IP 填本机地址,端口填双方约定的监听端口。同机联调可以用回环地址,但不要两边都随手填一个地址就开跑。
参数表可以这样对照:
| 参数 | 作用 | 改动前要确认 | 失败时先看 |
|---|---|---|---|
| IP 地址 | 指定对端或本机监听地址 | 工具是主动连还是被动听 | 连接是否超时、日志有无新文件 |
| 端口 | 指定链路入口 | 被测端是否在同一端口监听 | 端口是否被占用、双方是否一致 |
| ASDU 类型 | 决定报文语义和模板选择 | 本次跑单点遥信还是类型 45 遥控 | 模板是否匹配、脚本是否对路 |
| 超时阈值 | 决定等待回应的时间边界 | 被测端正常响应时间 | 是否过早判失败、是否拖慢重放 |
改 config.ini 时我一般一次只改一个维度。先把 IP 和端口对上,跑一次空连接看日志;再改 ASDU 类型,跑单点遥信;最后才动超时阈值。一次改三个参数,失败时根本分不清是地址错、类型错还是等待时间太短。配置文件改完记得保存到解压根目录的 config.ini,不要在 templates 或 scripts 里改了一个同名文件还以为生效了。
3.2 ASDU 类型与超时阈值:把报文语义和等待边界对上
ASDU 类型不是随便填的编号,它决定这次报文按什么语义解析。材料里给了两个很具体的入口:scripts/test_asdu1.py 是单点遥信触发脚本,scripts/test_cot6.py 是激活确认 COT=6 的压力测试脚本,templates/asdu_type_45.json 是遥控命令类型 45 的字段占位符模板。也就是说,单点遥信、激活确认、遥控命令不是一套参数通吃。你跑单点遥信时,config.ini 里的 ASDU 类型和模板要跟单点场景对齐;你跑类型 45 遥控时,模板要换成 asdu_type_45.json 这一路。COT 是传送原因,COT=6 表示激活确认,压测脚本名字已经把这个语义点出来了。
超时阈值的作用是给等待回应划一条边界。设得太短,被测端还没回,工具已经判失败,日志里看起来像“只有发没有收”;设得太长,一轮重放拖很久,压测节奏会被拉散。我的做法是联调初期给足等待时间,先确认报文能回,再逐步收紧到现场可接受的范围。不要在没有基线日志的情况下直接压 COT=6,先让 test_asdu1.py 把单点遥信跑通,确认请求和回应在 logs 里成对出现,再去跑 test_cot6.py。
3.3 启动顺序:先加载协议栈再启连接,日志里看什么
启动顺序我固定成四步:确认 lib 目录完整,改好 config.ini,启动 iec104_test.exe,看 logs 是否产生新文件。这个顺序的道理是先把协议栈和证据链立住,再去碰连接。主程序起来后,不要只看界面状态,先打开 logs 目录按时间找最新文件。十六进制视图用来看帧结构,ASCII 视图用来快速辨认可读字段;两边对不上时,以十六进制为准,因为 ASCII 只是辅助显示。
如果启动后日志没有新文件,先回到目录权限和 lib 加载;如果日志有文件但没有业务交互,回到 config.ini 的 IP、端口和 ASDU 类型;如果业务交互有请求没有回应,再去看超时阈值和被测端状态。这个排查路径不花哨,但能把“配置错”和“协议栈没起来”分开。最怕的是一上来就改模板占位符,结果根因是 libiec104.dll 根本没被加载。
4. 代码开发工具跑最小闭环:脚本重放、模板填参与报文日志三件套
4.1 用 test_asdu1.py 触发单点遥信:先验证上行还是下行?
先跑单点遥信,不要一上来就压 COT=6。scripts/test_asdu1.py 的名字已经说明它是单点遥信触发脚本,适合做最小业务闭环。执行时我一般在解压根目录下调用,让脚本按相对路径找到 scripts 目录里的文件:
bash复制# 在解压目录根下执行;脚本位于 scripts/
python scripts/test_asdu1.py
python scripts/test_cot6.py
这两条命令的含义要分开看:test_asdu1.py 先验证单点遥信这一路能不能触发、能不能在 logs 里留下对应交互;test_cot6.py 是 COT=6 的激活确认压力测试,应该放在单点场景稳定之后。参数上,脚本内部参数材料没有展开,现场要配合 config.ini 的 ASDU 类型和 templates 里的字段映射一起用。不要在正式环境直接跑压力脚本,先在联调环境把单点跑通。
如果 test_asdu1.py 跑完日志没有新增,先查 Python 解释器是否可用、工作目录是否在解压根下、config.ini 是否指向了当前被测端。脚本是 Python 格式,主程序本身不依赖 .NET,但脚本执行需要机器上有可用的 Python 解释器,这两件事不要混在一起判断。
4.2 asdu_type_45.json 的模板用法:类型 45 遥控命令字段占位符怎么填
templates/asdu_type_45.json 是遥控命令类型 45 的报文模板,里面定义的是 ASDU 字段映射和字段占位符。它的价值是让你不用手拼十六进制,而是按现场点表把占位符填进去。我的习惯是保留原模板不动,另存一份工作副本再改;改的时候只填占位符,不要动字段结构。类型 45 对应遥控命令,这个语义要和 config.ini 里的 ASDU 类型、脚本场景对齐,不能拿单点遥信的配置去套遥控模板。
填模板时重点看三件事:占位符是否全部替换,字段长度是否和现场约定一致,模板文件是否放在工具能读到的 templates 目录。占位符没填完就发,常见现象是报文能出去但对方不认,或者 logs 里 ASCII 视图出现明显不完整的字段。模板改错不要靠猜,先回到原模板对照字段名,再改工作副本。类型 45 的遥控场景比单点遥信多一层字段映射,所以它更适合放在单点闭环之后做。
4.3 logs 目录里的十六进制+ASCII 双视图:一次成功交互该看哪几行
logs 目录自动记录原始报文,提供十六进制加 ASCII 双视图。一次成功的单点交互,我至少看三段:请求发出后的十六进制帧、回应回来的十六进制帧、以及两边 ASCII 视图里可读字段是否对得上。先看时间顺序,确认不是上一轮残留日志;再看请求和回应是否成对;最后看 COT 是否符合本次场景。COT=6 的激活确认要在 test_cot6.py 那轮里单独核对,不要拿单点遥信的日志去证明压测通过。
如果日志里只有发出没有回应,先别改模板,回到 config.ini 的 IP、端口和超时阈值;如果回应有但 ASCII 视图明显不对,回到 asdu_type_45.json 的占位符和字段长度;如果日志目录根本没有新文件,回到第 2 章的目录权限和 lib 加载。把 logs 当作黑匣子用,顺序是“先有日志,再有成对报文,再有 COT 语义”,不要反过来从界面状态猜结论。
5. 代码开发工具避坑排查:四类高频翻车现象与定位顺序
5.1 主程序能打开,一发业务就断或日志空白
现象:iec104_test.exe 能启动,界面看起来正常,但一发业务报文就断,或者 logs 目录始终没有新文件。原因通常不是协议参数,而是 lib 目录里的协议栈没被加载:libiec104.dll 被挪走、被安全软件隔离,或者整个工具被放在只读目录里运行。解决顺序是先恢复 lib 目录,确认 libiec104.dll 在位,再确认工具解压目录可写,最后启动主程序看 logs 是否落盘。不要在这个时候去改 ASDU 类型,根因不在那一层。
5.2 连接超时,config.ini 改了却像没生效
现象:config.ini 里改了 IP 和端口,启动后还是连接超时,logs 里没有有效交互。原因常见有三种:改的不是解压根目录的 config.ini;工具和被测端的主动、被动角色搞反了;被测端根本没有在约定端口监听。解决时先确认配置文件路径,再确认本次联调谁主动连谁,最后去被测端核对监听状态。一次只改一个参数,改完重启主程序再看日志,不要连续改三处然后靠猜。
5.3 启用加密后握手失败,明文却正常
现象:不启用加密时单点遥信能跑,一启用加密就握手失败。原因在材料里写得很直接:工具依赖系统 TLS 1.2 支持,Win7 SP1+ 默认开启,WinXP 已彻底不支持;libtls_wrapper.dll 是可选 TLS 封装模块,只有启用加密时才加载。解决时先确认系统 TLS 1.2 状态,再确认 libtls_wrapper.dll 在位。如果本次联调不要求加密,就不要启用这个模块,让明文链路先跑通;如果必须加密,换到支持 TLS 1.2 的系统环境再测,不要在原地反复重启工具。
5.4 test_cot6.py 跑完没有 COT=6 激活确认
现象:test_cot6.py 执行完,logs 里没有出现预期的 COT=6 激活确认,或者只有发出没有回应。原因通常落在三处:config.ini 的 ASDU 类型和本次场景不一致;templates 里的模板占位符没按现场字段填完;超时阈值太短,回应还没到就被判失败。解决时先回到 test_asdu1.py 把单点遥信跑通,再核对类型 45 模板的占位符和字段长度,最后把超时阈值放宽到能稳定收到回应,再逐步收紧。压力脚本不要在生产环境直接跑,先在小流量联调环境确认 COT=6 的语义对得上。
6. 代码开发工具进阶验证:用一次可复现的回归把工具链钉死
我一般把这套动作固定成一次可复现回归,而不是每次联调都从零开始摸。改完 config.ini、动过 templates/asdu_type_45.json、或者切换过加密开关之后,按下面这张表走一遍,能把大部分翻车点挡在业务测试之前。
| 回归项 | 看哪里 | 通过标准 |
|---|---|---|
| 目录完整性 | lib、scripts、templates |
核心文件在位,libiec104.dll 未被隔离 |
| 连接参数 | config.ini 的 IP、端口 |
与本次被测端角色一致 |
| 单点遥信 | scripts/test_asdu1.py |
logs 出现成对请求与回应 |
| COT=6 压测 | scripts/test_cot6.py |
激活确认符合本次场景 |
| 加密开关 | libtls_wrapper.dll 与 TLS 1.2 |
握手成功后再跑业务报文 |
这张表里最容易被跳过的是目录完整性和日志落盘,但恰恰是这两项决定了后面所有报文证据可不可信。我的具体技巧是:每次改配置前先保留一份当前 config.ini 的副本,跑脚本前先确认 logs 目录可写,跑完单点遥信后先看十六进制成对、再看 ASCII 可读,最后才碰 test_cot6.py 和加密开关。从那以后我每次改 config.ini 或动模板前,都先备份原文件、清空或标记当前 logs 基线,再跑单点遥信和 COT=6 两轮确认,最后才碰加密开关。这个习惯不花哨,但能少很多翻车。希望帮到你。
