📚 课程目录第4章工程配置总览

4. 工程配置总览：Link Test配置项清单、配置文件结构、常见配置工具介绍

在SECS/GEM断连检测工程中，Link Test（链路测试）是维持通信健康状态的核心机制。本章将系统梳理Link Test的配置项清单、配置文件结构以及主流配置工具，帮助工程师快速建立全局配置视图。

4.1 Link Test 配置项清单

Link Test的配置项决定了断连检测的灵敏度、可靠性和资源消耗。下表列出核心配置参数及其典型值范围：

配置项	参数名称	典型值	说明
T3 超时	t3_timeout	45 s	等待回复的最大时间，超时即判定链路异常
T5 间隔	t5_interval	10 s	两次 Link Test 消息发送的最小间隔
重试次数	retry_count	3	连续失败次数达到阈值后触发断连
链路 ID	link_id	0	标识物理或逻辑链路通道
消息格式	message_format	S9F1 / S9F3	SECS-II 标准消息类型
日志级别	log_level	INFO	DEBUG / INFO / WARN / ERROR
自动恢复	auto_recovery	true	断连后是否自动尝试重连

配置建议：T3 超时建议设置为设备通信往返时间的 3~5 倍；T5 间隔不宜过短，避免网络拥塞；重试次数建议 3~5 次，兼顾灵敏度和误报率。

4.2 配置文件结构

Link Test 配置通常以结构化文件存储，支持 XML、JSON、INI 三种主流格式。以下展示典型的 JSON 配置文件结构：

{
  "device": {
    "device_id": 1,
    "model": "ASML TWINSCAN",
    "protocol": "SECS-II"
  },
  "channel": {
    "type": "TCP/IP",
    "host": "192.168.1.100",
    "port": 5000,
    "connect_timeout": 30
  },
  "link_test": {
    "enabled": true,
    "t3_timeout": 45,
    "t5_interval": 10,
    "retry_count": 3,
    "link_id": 0,
    "message_format": "S9F1",
    "log_level": "INFO",
    "auto_recovery": true,
    "recovery_interval": 60
  },
  "logging": {
    "file_path": "/var/log/secs/link_test.log",
    "max_size_mb": 100,
    "backup_count": 5
  }
}

配置文件采用三层嵌套结构：

设备段（device）：定义设备标识和协议版本。
通道段（channel）：定义网络传输参数。
Link Test 段（link_test）：核心断连检测参数。

4.3 常见配置工具介绍

工程实践中，Link Test 配置可通过以下工具完成：

工具名称	类型	适用场景	特点
SECS Configurator	GUI 图形工具	现场调试、快速验证	可视化配置，实时预览，支持导入/导出
GEM Link Tool	专用测试工具	链路诊断、断连模拟	内置 Link Test 发送器，日志实时分析
命令行 CLI	命令行接口	自动化部署、批量配置	脚本化操作，支持参数传递
脚本 API	编程接口	集成到上位机系统	Python/C# 库，动态修改配置

  工具选型建议：
  现场调试优先使用 SECS Configurator，降低人为错误。
批量部署推荐 CLI + 脚本 API，实现配置即代码（Configuration as Code）。
断连故障排查使用 GEM Link Tool，可主动触发 Link Test 并捕获异常。

4.4 配置项与工具的映射关系

不同工具对配置项的暴露程度不同，下表展示关键配置项在各工具中的可操作性：

配置项	SECS Configurator	GEM Link Tool	CLI	脚本 API
T3 超时	滑块 + 输入框	只读显示	--t3 45	set_t3(45)
T5 间隔	下拉选择	可修改	--t5 10	set_t5(10)
重试次数	数字微调	可修改	--retry 3	set_retry(3)
日志级别	下拉选择	实时切换	--log DEBUG	set_log_level("DEBUG")
自动恢复	开关按钮	可修改	--auto-recovery	enable_auto_recovery(True)

注意：GEM Link Tool 主要用于诊断，修改配置后不会自动持久化到配置文件；如需永久生效，应通过 SECS Configurator 或 CLI 保存。

4.5 配置生效流程

Link Test 配置从编辑到生效遵循以下步骤：

编辑配置：使用 GUI 或文本编辑器修改配置文件。
语法校验：工具自动检查 JSON/XML 格式及参数范围。
加载配置：Link Test 服务读取配置文件到内存。
参数生效：T3、T5、重试次数等参数立即生效。
运行验证：发送一次 Link Test 消息确认配置正确。