1. 代码开发工具里的 IEC 104 测试工具:它补的是抓包器给不了的那一段
代码开发工具里有一类很容易被当成黑匣子的角色:协议调试工具。IEC 104 测试工具就是其中之一。它不像抓包器只告诉你线上有什么,而是自带 libiec104.dll 协议栈、config.ini 配置、templates 报文模板和 scripts 重放脚本,能把 ASDU 类型、COT 激活确认这些字段从手工拼报文里解放出来。
做 IEC 104 联调时,最适合拿它先跑通一条最小闭环:单点遥信触发、激活确认、日志回看。新手可以按目录和配置一步步走,熟手更该关注 DLL 加载顺序、TLS 1.2 前置条件和模板与配置的对应关系——这三处最容易翻车。
它不是万能抓包器,也不是替代对端协议栈的模拟器。把它当成“带协议栈的测试夹具”,先让一条链路跑通,再谈压力和回归,后面几章都围绕这个用法展开。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具落地第一步:解压后先认目录和 DLL 加载顺序
2.1 目录不是随便放的:四个目录各管一段
解压 iec104测试工具.zip 后,先别急着双击 iec104_test.exe。我习惯先把根目录列一遍,确认每个目录在哪个环节起作用。典型结构如下,不同版本可能少一两个文件,但核心骨架一致:
bash复制iec104_test.exe # 主程序(32/64位 Windows GUI)
config.ini # 全局配置(IP、端口、ASDU类型、超时阈值)
lib/
├── libiec104.dll # 核心协议栈(APCI 帧构造/解析)
└── libtls_wrapper.dll # 可选 TLS 封装(仅启用加密时加载)
logs/ # 原始报文(十六进制 + ASCII 双视图)
scripts/
├── test_asdu1.py # 单点遥信触发
└── test_cot6.py # 激活确认(COT=6)压力测试
templates/
└── asdu_type_45.json # 遥控命令(类型45)字段占位符
这段目录清单不是让你背文件名,而是让你知道改动会落在哪一层。iec104_test.exe 只是界面壳,真正构造和解析 APCI 帧的是 lib/libiec104.dll;config.ini 管连接目标和超时;templates 管 ASDU 字段怎么填;scripts 管把一次手工操作变成可重放的脚本;logs 是事后排查的唯一黑匣子。
我见过有人把 exe 单独拷到桌面,结果双击一闪而过,然后怀疑工具坏了。其实不是,lib 目录没跟着走,协议栈加载失败,主程序连界面都起不来。目录结构本身就是运行前提,不是安装残留。
| 路径 | 作用 | 动它之前先确认什么 |
|---|---|---|
iec104_test.exe |
主程序入口 | 是否和 lib、config.ini 在同一套目录下 |
config.ini |
IP、端口、ASDU 类型、超时阈值 | 是否已备份原文件,是否一次只改一项 |
lib/libiec104.dll |
APCI 帧构造/解析核心 | 是否被杀毒软件隔离,是否在加载路径 |
lib/libtls_wrapper.dll |
可选 TLS 封装 | 当前用例是否真的启用了加密 |
logs/ |
原始报文双视图 | 是否有写权限,是否在触发业务前就为空 |
scripts/ |
Python 重放脚本 | 脚本目标 ASDU 类型是否与配置一致 |
templates/ |
ASDU 字段占位符 | 模板类型是否与当前测试用例匹配 |
2.2 为什么协议栈要独立成 libiec104.dll
libiec104.dll 是整个工具的协议心脏。它不依赖 .NET Framework,而是直接调用 Windows Sockets API 加自研的 ASN.1 编解码器。这个设计对一线联调很实际:你不需要先装运行时,解压就能跑;协议栈和 GUI 分开后,界面卡死不影响底层收发,日志也能在协议栈层直接抓原始报文。
但“不依赖运行时”不等于“没有前置条件”。材料里明确提了一句:必须确保 Windows 系统已启用 TLS 1.2 支持,Win7 SP1+ 默认开启,WinXP 已彻底不支持。这句话只在你启用加密时才是硬门槛;不启用加密时,libtls_wrapper.dll 不会被加载,你也不用去折腾 TLS 配置。
这也是选型时我最看重的一点:工具把“必须加密”和“可选加密”分成了两个 DLL。你可以在不加密的实验室环境先跑通业务报文,再切到加密链路验证 TLS 封装。不要一上来就把两个变量一起改,否则连不上时你分不清是 IP 端口错了,还是 TLS 没起来。
另一个细节是 ASN.1 编解码器自研。这意味着模板里的字段占位符不是随便写的 JSON 键,它最终要经过 libiec104.dll 编码成 APCI 帧里的 ASDU。模板和配置对不上,现象往往不是报错,而是对端收到一帧“能解析但业务不对”的报文。后面第 4 章会细说这类翻车。
2.3 启动前做三项依赖检查
我自己的顺序是:先固定解压路径,再核对最低依赖,最后才启动。路径别放在桌面或下载目录,带空格和中文的路径容易让脚本读 config.ini 时出问题。下面这个 PowerShell 片段只做一件事:检查启动最低依赖是否齐全。
powershell复制$root = "C:\iec104_test"
$must = @(
"iec104_test.exe",
"config.ini",
"lib\libiec104.dll"
)
foreach ($f in $must) {
$p = Join-Path $root $f
if (Test-Path $p) { "OK $f" } else { "MISS $f" }
}
$root 换成你的解压目录;$must 里三项是启动最低依赖,缺任何一个都别往下走。启用加密时,再把 lib\libtls_wrapper.dll 加进 $must,同时确认系统 TLS 1.2 已启用。这个检查不验证协议对不对,只验证“壳能不能起来、协议栈能不能加载”,先把环境问题和业务问题分开。
三项检查通过后,从解压根目录启动 iec104_test.exe,不要从 lib 子目录启动,也不要给 exe 建快捷方式后把“起始位置”留空。Windows 加载 DLL 时按当前工作目录和系统路径找,工作目录不对,libiec104.dll 就可能找不到。这个坑不报具体协议错,只表现为启动失败或界面异常,很容易被误判成工具兼容性问题。
3. 把 config.ini 配成能连的测试端:IP、端口、ASDU 类型、超时阈值怎么定
3.1 四个配置项的先后顺序
config.ini 里最常动的四项是 IP、端口、ASDU 类型、超时阈值。我的顺序是先把 IP 和端口定死,再选 ASDU 类型,最后调超时阈值。顺序反了,后面每一步都在猜。
IP 填被测端或模拟器的地址。先确认本机网卡和目标在同一条链路可达,不要因为工具能启动就默认网络通了。端口填被测端监听的端口,不要照抄示例值;示例值只是占位,对端没开那个端口,你配得再对也连不上。
ASDU 类型决定你后面用哪套模板、哪个脚本。test_asdu1.py 对应单点遥信用例,asdu_type_45.json 对应遥控命令(类型45),这两个不是一套东西。配置里的 ASDU 类型要和模板文件名、脚本目标三者对齐,否则你会看到“脚本发出去了、对端也回了、但字段不是你要的”这种半成功状态。
超时阈值是等待响应和重试的边界。我一般先把阈值放宽,确认链路能通、能回激活确认,再逐步收紧。一上来就卡得很死,弱网或对端处理慢时会把正常响应误判成超时,然后你去查协议,方向就偏了。
| 配置项 | 作用 | 先设什么 | 常见误用 |
|---|---|---|---|
| IP | 被测端或模拟器地址 | 先确认本机到目标可达 | 填本机回环地址却以为在测对端 |
| 端口 | 被测端监听端口 | 先问对端实际监听值 | 照抄示例端口,对端根本没开 |
| ASDU 类型 | 决定模板和脚本用哪套 | 先与 templates 文件名对齐 |
一套配置跑所有类型 |
| 超时阈值 | 等待响应和重试边界 | 先放宽确认链路,再收紧 | 一上来卡死,正常响应被误判 |
3.2 一份可核对的配置骨架
下面不是让你照抄的完整配置文件,而是一份核对骨架。键名以工具实际生成的 config.ini 为准,我只标出联调前必须逐项确认的四个位置:
ini复制; 键名以工具生成的 config.ini 为准,下面只核对四项
IP=被测端或模拟器地址
PORT=被测端监听端口
ASDU_TYPE=1
TIMEOUT_MS=先放宽,确认链路后再收紧
IP 和 PORT 填实际值,不要保留中文占位符;ASDU_TYPE=1 对应单点遥信用例,换成遥控命令时改成模板对应的类型;TIMEOUT_MS 先给一个足够宽的等待窗口,等 logs 里能看到完整请求和响应,再往下收。改之前先备份原文件,一次只改一项,改完立刻用单次触发验证,不要连续改三项再启动。
这个骨架的价值是让你每次联调前有固定核对点。我见过最常见的错误是把 ASDU 类型改成了 45,模板却还在用单点遥信那套,脚本 test_asdu1.py 也照旧跑。结果对端回了报文,但字段映射全错,排查时又去怀疑 DLL,白白绕一圈。
3.3 模板和脚本怎么跟配置对齐
templates/asdu_type_45.json 是遥控命令(类型45)的字段占位符。模板不是越全越好,而是要和当前用例一一对应。一个最小模板骨架可以写成这样:
json复制{
"type": 45,
"name": "遥控命令",
"fields": {
"COT": "__COT__",
"ASDU": "__ASDU__",
"payload": "__PAYLOAD__"
}
}
type 必须和 config.ini 里的 ASDU 类型一致;COT、ASDU、payload 这些占位符在重放前要替换成当前用例的值。不同模板的字段名可能不同,以文件里实际键为准,不要拿这个骨架去覆盖原模板。模板的作用是把“字段填什么”从代码里拿出来,让脚本重放时只关心“这次跑哪个用例”。
脚本这边,scripts/test_asdu1.py 是单点遥信触发,test_cot6.py 是激活确认(COT=6)压力测试。我的习惯是先把自带脚本复制一份,改成自己的参数入口,不直接改原文件。下面是一个最小骨架,只做读取配置、读取模板、打印本次计划,发送部分留成占位:
python复制#!/usr/bin/env python3
# test_asdu1.py 的最小重放骨架:先读配置和模板,再交给工具发送
import json
import argparse
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
def load_config_text():
# 节名和键名以实际 config.ini 为准,这里只演示读取路径
return (ROOT / "config.ini").read_text(encoding="utf-8")
def load_template(name):
with open(ROOT / "templates" / name, "r", encoding="utf-8") as f:
return json.load(f)
def main():
parser = argparse.ArgumentParser()
parser.add_argument("--template", default="asdu_type_45.json")
parser.add_argument("--cot", default="6")
args = parser.parse_args()
cfg_text = load_config_text()
tpl = load_template(args.template)
# send 只是占位:按工具的 CLI 或 GUI 自动化入口接上
print("config loaded:", bool(cfg_text))
print("template type:", tpl.get("type"), "COT:", args.cot)
if __name__ == "__main__":
main()
--template 选 templates 下与当前 ASDU 类型对应的文件;--cot 默认 6 对应激活确认,跑单点遥信时改成当前用例需要的值;ROOT 按脚本所在目录回退两级,保证从任何工作目录启动都能找到 config.ini 和 templates。发送函数不要在这个骨架里硬编码,按工具的 CLI 或 GUI 自动化入口接上,接口没确认之前只打印计划,先保证“读对了”再保证“发出去了”。
3.4 先手动后脚本的联调顺序
我的固定顺序是:先手动触发一次单点遥信,看 logs 里有没有完整的请求和响应;再把这次手工参数固化成 test_asdu1.py 的一次重放;最后才上 test_cot6.py 做激活确认压力。手动那一步不是为了偷懒,而是为了拿到一条“已知正确”的基线日志。后面脚本跑偏时,你至少有对照。
手动阶段只改 config.ini,不动模板和脚本。脚本阶段只改脚本参数,不动 config.ini。压力阶段只改压力参数,不动前两步的基线。每次只动一层,出问题能立刻定位到层。这个习惯看起来慢,实际比三项一起改快得多。
4. 联调避坑:五类翻车从缺 DLL 到压力测试打挂对端
4.1 启动与依赖类
现象:双击 iec104_test.exe 后窗口一闪而过,或提示缺少模块。
原因通常不是工具损坏,而是 exe 被单独拷走,lib 目录没跟着走,libiec104.dll 不在加载路径。解决:保持解压目录结构,从根目录启动;用 2.3 的检查脚本核对 iec104_test.exe、config.ini、lib\libiec104.dll 三项是否齐全。缺一项就先补齐,不要反复重装。
现象:启用加密后连接建立不了,不加密时反而正常。
原因是 libtls_wrapper.dll 仅在启用加密时加载,而系统没有启用 TLS 1.2,或跑在不支持的系统上。材料里写得很清楚,Win7 SP1+ 默认开启,WinXP 已彻底不支持。解决:先确认当前系统 TLS 1.2 已启用;不需要加密时先关掉加密,把业务链路跑通;必须加密时换支持的系统,别在 WinXP 上耗时间。
现象:程序能打开,但 logs 目录一直是空的。
原因是 logs 记录的是经过 libiec104.dll 的原始报文,链路没真正建立、没有触发业务,或者报文根本没进协议栈,日志自然是空的。解决:先确认 IP、端口可达,再手动触发一次单点遥信;如果还是没有日志,回到启动检查,确认 libiec104.dll 真的被加载,而不是界面壳空转。
4.2 配置与脚本类
现象:脚本跑完,对端没反应,或者回了报文但字段对不上。
原因多半是 config.ini 的 ASDU 类型、templates 模板、脚本目标三者不一致。比如配置改成了类型 45,模板还是单点遥信那套,test_asdu1.py 也照旧跑。解决:先按 3.3 对齐 type 和模板文件名,再手动触发一次确认字段映射,最后才跑脚本。不要用“脚本能跑完”判断成功,要看 logs 里的 ASDU 类型和 COT 对不对。
现象:test_cot6.py 压力测试把对端打挂,或自己频繁超时。
原因是 COT=6 激活确认压力测试频率高,而 TIMEOUT_MS 还停留在单次验证时的紧值;没有先做单次 test_asdu1.py 基线,直接上压力,对端处理不过来就会断开或丢响应。解决:先单次触发拿到基线日志,再逐步加压力;超时阈值先放宽,观察 logs 里有没有重发、断开;对端已经异常时先停压力,回退到单次触发,确认链路恢复再继续。
这五类里,前两类是环境问题,后三类是配置和节奏问题。环境问题看依赖和系统前置条件,配置问题看模板与配置对齐,节奏问题看“先单次后压力”的顺序。把这三层分开,排查时就不会一上来就怀疑协议栈。
5. 把代码开发工具用成回归夹具:日志双视图与脚本重放的三步习惯
5.1 日志双视图先看哪一列
logs 里的原始报文是十六进制加 ASCII 双视图。我的读法是先看十六进制列,确认帧边界和 APCI 类型有没有对齐;再看 ASCII 列,确认 ASDU 类型和 COT 是不是当前用例。十六进制看“帧对不对”,ASCII 看“业务对不对”,两列对不上时,先怀疑模板占位符没替换,而不是协议栈坏了。
| 视图 | 先看什么 | 用来判断 |
|---|---|---|
| 十六进制 | 帧头、长度、APCI 类型 | 帧有没有对齐、是不是 APCI 帧 |
| ASCII | ASDU 类型、COT | 业务字段对不对、激活确认有没有回 |
5.2 脚本重放的最小闭环
我一般把一次手工触发固化成 test_asdu1.py 的一次重放,参数只改 --template 和 --cot,不碰 config.ini。重放成功后再跑 test_cot6.py,压力参数从小往大加,每加一档看一眼 logs 有没有断开或重发。脚本不是用来代替手工的,是用来把手工基线固定下来。
5.3 我每次上线前固定走的三步
第一步,备份 config.ini,只改当前用例需要的项;第二步,先跑 test_asdu1.py 单次触发,看 logs 双视图确认请求和响应;第三步,再放 test_cot6.py 压力,压力结束回看日志有没有异常断开。从那以后我每次改完 config.ini,都先把单点遥信单跑一遍,再看日志双视图,最后才放压力测试。这个顺序救过我几次,也让我少怀疑了很多次协议栈。希望帮到你。
