📚 课程目录第4章设备端参数配置实战

4. 设备端参数配置实战

设备端参数配置是EAP联机链路能否建立的第一道关口。很多现场“连不上、掉线、重复上报”的问题，追根溯源并不是网络硬件故障，而是设备端几个关键参数与上位机（EAP Host）或MES侧约定不一致。本节围绕六类核心参数——IP/端口、设备ID、通信模式、超时、心跳、事件上报开关——讲清楚每一项“配什么、怎么配、配完怎么核对”。

核心原则：设备端参数必须与上位机侧“成对匹配”。任何一项单边修改，都会导致链路建立失败或数据语义错乱。配置完成后，务必用“参数核对表 + 实际报文”双重验证。

一、IP与端口：链路可达性的基础

EAP设备通常作为TCP客户端主动连接上位机，或作为服务端被动等待连接。以最常见的“设备主动连接”为例，设备端需要配置目标IP（上位机/EAP Server地址）和目标端口。示例场景：上位机部署在192.168.10.50，EAP服务监听端口5000，则设备端应配置：

RemoteIP   = 192.168.10.50
RemotePort = 5000
LocalIP    = 192.168.10.101   # 设备自身地址，建议固定
LocalPort  = 0               # 0表示由系统随机分配本地端口

核对要点有三：其一，设备与上位机必须处于同一可达网段，或路由可达，可用ping 192.168.10.50验证；其二，端口不能被防火墙拦截，可用telnet 192.168.10.50 5000确认端口开放；其三，若设备作为服务端，则上位机需配置设备IP和监听端口，方向相反但匹配逻辑相同。现场常见错误是把上位机端口写成设备本地端口，导致连接被拒。

二、设备ID：数据归属的唯一标识

设备ID（DeviceID / EquipmentID）是EAP上报数据中标识“这条数据来自哪台设备”的字段，通常为字符串，如EQP-ETCH-001。它必须与MES/EAP侧设备台账中的ID完全一致，包括大小写和分隔符。若设备ID配错，数据可能被归到错误机台，造成良率统计混乱。核对方法是：在设备端读取配置值，与MES设备主数据逐字符比对，并在首次上报报文中确认该字段实际发出。

三、通信模式：决定谁主动、用什么协议

通信模式包含两层含义：连接方向（主动/被动）和协议格式（如SECS/GEM、MQTT、HTTP、自定义TCP）。以SECS/GEM为例，设备通常为主动方（Active），上位机为被动方（Passive），设备通过Select建立会话。若模式配反，双方都在等待对方发起连接，链路永远建立不起来。配置时应明确：

连接方向：Active（设备主动）或 Passive（设备被动）；
协议类型：SECS-II/HSMS、MQTT、Modbus TCP、自定义JSON over TCP等；
报文编码：ASCII或二进制，字节序（大端/小端）。

核对时，抓取一次实际连接报文，确认握手方向与协议头符合约定。例如HSMS应看到Select.req由设备发出，上位机回Select.rsp。

四、超时参数：连接、响应与重连的边界

超时参数决定设备在“等不到回应”时的行为。常见三类：连接超时（Connect Timeout）、响应超时（Response Timeout / T3）、重连间隔（Reconnect Interval）。示例配置：

ConnectTimeout   = 5000 ms   # 建立TCP连接的最长等待
ResponseTimeout  = 10000 ms  # 发出请求后等待回复的最长等待
ReconnectInterval= 3000 ms   # 断线后重连尝试间隔

超时过短会导致网络抖动时误判断线；过长则故障恢复慢。核对方法是人为断开网线，观察设备是否在ConnectTimeout后报连接失败，并按ReconnectInterval周期性重试。日志中应出现明确的超时事件，而非静默卡死。

五、心跳：维持长连接与快速发现断线

心跳（Heartbeat / KeepAlive）用于在无业务数据时维持链路，并让双方快速感知对端异常。配置项包括心跳周期和心跳超时。示例：心跳周期30s，心跳超时90s（即连续3个周期未收到心跳判定断线）。若设备与上位机心跳周期不一致，可能出现一方认为在线、另一方已判离线的“假在线”。核对时，在抓包工具中确认心跳报文按周期稳定发出，且对端有回应。

六、事件上报开关：控制数据是否上送

事件上报开关（Event Report Enable）决定某类事件是否触发上报，如设备报警、状态切换、批次开始/结束。常见配置为按事件类型分别开关：

Report.AlarmEnable   = true
Report.StateEnable   = true
Report.BatchEnable   = false   # 调试期临时关闭
Report.HeartbeatLog  = false

核对要点：开关状态必须与当前调试阶段匹配。调试期可关闭非关键事件以减少干扰，但量产前必须逐项确认应开尽开。验证方法是人为触发一次报警，确认上位机收到对应事件报文；再关闭开关，确认不再上报。

七、配置核对的标准动作

参数配完不等于配对。建议按以下顺序核对：第一步，在设备端导出当前配置，与上位机配置表逐项比对，重点检查IP、端口、设备ID、通信模式；第二步，用抓包工具（如Wireshark）或设备日志确认实际连接报文中的源/目的地址、端口、协议头；第三步，人为触发一次心跳和一次事件，确认上位机侧收到对应数据；第四步，记录核对结果，形成配置基线，后续变更需走变更流程。

调试期可临时关闭非关键事件上报以减少干扰，但必须在量产前恢复。建议在配置文件中用注释标明“调试临时关闭”，避免遗忘。

常见坑：设备ID大小写不一致、端口被防火墙拦截、通信模式双方都配成Passive、心跳周期不一致导致“假在线”。这四类问题占现场联机故障的多数，核对时优先排查。

设备端参数配置的本质，是让设备与上位机在“地址、身份、方向、节奏、边界、内容”六个维度上达成一致。把这六项参数配准、核对到位，后续的联机测试与故障排查就有了可靠的基础。