1. 设备端消息写完了,为什么还要自己搭 Host 回归脚本
设备端的 SECS/GEM 消息处理写完,只能说明代码能编译、能回几条演示消息。真正让人翻车的是联调现场:Host 发来 S1F13 建立通信,设备回错流号;S2F33 报告定义没做,S6F11 事件永远不上报;S2F41 远程命令到了,设备端命令表里根本没注册。等问题在现场暴露,排查成本比在实验室高得多。用开源代码开发工具搭一个 Host 端回归脚本,把连接、心跳、报告定义、事件上报、远程命令、报警上报逐条跑一遍,是成本最低的做法。这篇围绕 Python 的 secsgem 库,讲怎么让 Host 被动监听、怎么发消息等回复、timeout 怎么设、哪些坑必须提前知道。适合已经能看懂 SECS 消息名、但还没把设备通信测透的开发者。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具怎么选:HSMS 连接模式与 HsmsSettings 参数
2.1 HSMS 的连接角色:active=False 到底改变了什么
HSMS 跑在 TCP 上,连接双方分主动和被动。主动方发起 TCP 连接,被动方监听端口等连入。Host 脚本里用 active=False,再把 address 设成 0.0.0.0、port 设成 5000,意思是 Host 在本机 5000 端口监听,等设备端主动连过来。这时 connect_to 和 connect_port 填的是设备端地址,作用更像“记录对端是谁”,不是让脚本去连。这个顺序不能反:如果脚本设成 active=True,就变成 Host 主动连设备,设备端必须处于监听状态;现场设备如果只配了主动连 Host,脚本再设主动,两边都主动,连接根本建不起来。
为什么测试时让 Host 被动?因为现场设备端往往已经固化成主动连 Host 的配置,测试脚本跟着现场拓扑走,不用为了测试改设备端连接参数。设备端改一次参数,可能还要重启、重新初始化 HSMS 状态机,反而引入新变量。Host 被动监听,设备端连上来就能测,脚本改起来也方便。
但被动监听有个代价:脚本 enable() 之后不会立刻有连接,要等设备端发起。很多人写完脚本直接跑 send_and_wait,结果第一条 S1F13 就超时,以为是消息写错了,其实是设备还没连上来。所以启动顺序要固定:先跑 Host 脚本,确认监听端口起来了,再让设备端发起连接,最后才跑用例。这个顺序在后面排错章还会碰到。
2.2 HsmsSettings 的参数表与最小连接脚本
python复制from secsgem.hsms import HsmsSettings, HsmsClient
settings = HsmsSettings(
address="0.0.0.0", # Host 本地监听地址,0.0.0.0 表示监听所有网卡
port=5000, # Host 本地监听端口,设备端要连这个端口
connect_to="192.168.1.101", # 设备端地址,被动模式下用于标识对端
connect_port=5000, # 设备端端口,主动模式下才是连接目标
device_id=0, # 设备号,双方必须一致
session_id=0, # 会话号,双方必须一致
active=False # False:Host 被动监听;True:Host 主动连接
)
client = HsmsClient(settings)
client.enable() # 启动监听/连接,被动模式下此时还没有设备连入
逻辑说明:HsmsSettings 是一次性配置对象,HsmsClient 拿它建连接。enable() 只是把监听或连接动作启动起来,不代表 HSMS 会话已经可用。参数说明可以对照下表,重点看“常见错法”一列,都是现场调试里很容易犯的。
| 参数 | 含义 | 被动模式怎么填 | 常见错法 |
|---|---|---|---|
| address | 本地绑定地址 | 0.0.0.0 监听所有网卡 |
填了设备 IP,本机反而没监听 |
| port | 本地监听端口 | 与设备端 connect_port 一致 |
两边都写 5000,但设备端连的是别的端口 |
| connect_to | 对端地址 | 设备实际 IP | 填 127.0.0.1,设备连不到 |
| connect_port | 对端端口 | 设备监听端口 | 与本地 port 混用 |
| device_id | 设备标识 | 与设备端配置一致 | 脚本默认 0,设备端配了 1 |
| session_id | 会话标识 | 与设备端配置一致 | 多设备时全用 0,消息串会话 |
| active | 连接角色 | False |
设备只主动连,脚本也设 True |
address 和 port 是 Host 自己的监听端点,connect_to 和 connect_port 在被动模式下记录的是对端信息。真正决定能不能连上的是设备端的 connect_to 有没有指向 Host 的 address:port。device_id 和 session_id 不是 TCP 端口,是 HSMS 会话层标识,后面单独讲。
2.3 连接建立前后的检查顺序
我一般把启动拆成三步,避免“脚本一跑就发消息”的假失败。第一步,先启动 Host 脚本,让监听端口起来;第二步,让设备端发起连接;第三步,确认连接建立后再执行第一条 S1F13。如果脚本里用了一个固定等待,比如两秒,那只是给设备端留出连入时间的粗办法,正式脚本最好用连接状态回调或轮询替代。
bash复制# 在 Host 上确认 5000 端口处于监听状态
ss -lntp | grep 5000
逻辑说明:ss 用来查看本机 TCP 监听端口,如果这里没有输出,说明脚本没起来、端口被占用,或者绑定的不是这块网卡。参数说明:-l 看监听,-n 用数字端口,-t 只看 TCP,-p 显示进程。先确认这一层,再去怀疑 SECS 消息,能省很多时间。
3. 用 secsgem 写回归用例:六类消息的发送、等待与断言
3.1 测试骨架:从 enable 到 send_and_wait
python复制# test_host.py
import time
from secsgem.hsms import HsmsSettings, HsmsClient
from secsgem.secs.functions import S1F13
def test_s1f13():
settings = HsmsSettings(
address="0.0.0.0", port=5000,
connect_to="192.168.1.101", connect_port=5000,
device_id=0, session_id=0, active=False
)
client = HsmsClient(settings)
client.enable()
time.sleep(2) # 给设备端留出主动连入的时间,实际以现场为准
# 等待设备连入后发 S1F13
response = client.send_and_wait(S1F13(), timeout=10)
assert response.header.stream == 1
assert response.header.function == 14
逻辑说明:active=False 让 Host 端被动监听,send_and_wait 发 S1F13 并等 S1F14。参数说明:timeout=10 是单条消息的测试超时,比 T3 短,快速失败;time.sleep(2) 是等待设备连入的粗办法,正式脚本可以换成连接状态检查。断言只检查回复的流和功能号,确保协议层先把消息对上了。消息类从 secsgem.secs.functions 按实际定义引入,S1F13() 只演示发送动作,真实消息体按设备端要求填。
这个骨架跑通之后,后面的用例都可以沿用同一个 client。如果每条用例都新建连接,设备端会反复经历连接、断开,反而把状态机搅乱。更稳的做法是把 client 放在测试夹具里,整个会话只建一次连接,用例按“建立通信 → 心跳 → 报告定义 → 事件上报 → 远程命令 → 报警上报”的顺序执行。
3.2 六类消息的发送方向与断言点
| 用例 | 方向 | 发送或触发 | 期待 | 断言点 | 前置条件 |
|---|---|---|---|---|---|
| 建立通信 | Host→设备 | S1F13 | S1F14 | stream=1,function=14 | 设备已连入 |
| 心跳 | Host→设备 | S1F1 | S1F2 | stream=1,function=2 | 通信已建立 |
| 报告定义 | Host→设备 | S2F33/S2F35 | 对应确认 | 回复流号=2,功能号对应 | 设备支持报告定义 |
| 事件上报 | 设备→Host | 触发设备事件 | S6F11 | stream=6,function=11,关键字段 | 报告已定义 |
