OPC代理客户端文档中心

全面的技术文档和使用指南

文档目录

安装指南

系统要求

  • 操作系统：Windows 7/8/10/11, Linux, macOS
  • Java环境：Java 8 或更高版本
  • 内存：至少512MB可用内存
  • 磁盘空间：至少100MB可用空间

安装步骤

  1. 下载OPC代理客户端安装包
  2. 解压缩到目标目录
  3. 确保系统已安装Java 8或更高版本
  4. 根据需要修改配置文件
  5. 运行客户端程序

Windows系统安装

# 下载并解压opc-proxy-client.zip
# 进入解压后的目录
cd opc-proxy-client

# 运行客户端
java -jar opc-proxy-client.jar

Linux/macOS系统安装

# 下载并解压opc-proxy-client.tar.gz
tar -xzf opc-proxy-client.tar.gz

# 进入目录
cd opc-proxy-client

# 添加执行权限
chmod +x run.sh

# 运行客户端
./run.sh

配置手册

配置文件说明

OPC代理客户端的主要配置文件位于src/main/resources/application.properties，支持以下配置项：

服务器连接配置

# 服务器地址
server.host=127.0.0.1
server.port=8081

# 用户认证信息
client.username=defaultUser
client.password=defaultPass

数据采集配置

# 数据采集间隔
data.collection.interval=10
data.collection.unit=SECONDS

# 数据采集器选择
data.collector.device.enabled=true

设备连接配置

# 设备连接信息
device.ip=127.0.0.1
device.port=502
device.id=1
device.protocol=MODBUS

命令行参数配置

客户端支持通过命令行参数覆盖配置文件中的设置：

java -jar opc-proxy-client.jar -h <服务器地址> -p <端口> -u <用户名> -pw <密码>

配置优先级

配置项的优先级从高到低为：

  1. 命令行参数
  2. 配置文件
  3. 代码默认值

API文档

客户端内部API

OPC代理客户端包含以下主要类和方法：

ClientApplication类

客户端主应用程序类

  • start() - 启动客户端
  • loadConfiguration() - 加载配置
  • authenticate() - 客户端认证

DeviceDataCollector类

设备数据采集器

  • collectDeviceData() - 采集设备数据
  • collectFromDevice() - 从设备采集数据

协议相关类

支持多种工业协议：

  • ModbusProtocol - Modbus TCP协议实现
  • OpcUaProtocol - OPC UA协议实现
  • HttpProtocol - HTTP/HTTPS协议实现

数据格式

客户端采集的数据以JSON格式发送到服务器：

{
  "protocol": "MODBUS",
  "timestamp": 1634567890123,
  "data": {
    "register_0": 123,
    "register_1": 456
  }
}

故障排除

常见问题

1. 客户端无法启动

问题描述：运行客户端时出现错误信息

可能原因：

  • Java环境未正确安装
  • 端口被其他程序占用
  • 配置文件格式错误

解决方案：

  • 确认已安装Java 8或更高版本
  • 检查端口占用情况
  • 检查配置文件语法

2. 无法连接到服务器

问题描述：客户端启动成功但无法连接到服务器

可能原因：

  • 服务器地址或端口配置错误
  • 网络连接问题
  • 防火墙阻止连接

解决方案：

  • 检查server.host和server.port配置
  • 确认网络连接正常
  • 检查防火墙设置

3. 数据采集失败

问题描述：客户端连接成功但无法采集设备数据

可能原因：

  • 设备地址或端口配置错误
  • 设备协议不匹配
  • 设备未正常运行

解决方案：

  • 检查device.ip和device.port配置
  • 确认设备协议类型
  • 检查设备运行状态

日志分析

客户端日志文件位于logs目录下，包含以下信息：

  • 启动日志
  • 连接日志
  • 数据采集日志
  • 错误日志

技术支持

如果您在使用OPC代理客户端过程中遇到任何问题，请联系我们的技术支持团队：

邮箱：95123150@163.com

电话：+86 13358176399

我们的技术支持时间为工作日 9:00-18:00

提交问题报告

为了更快地解决您的问题，请在联系时提供以下信息：

  • 客户端版本号
  • 操作系统类型和版本
  • Java版本信息
  • 详细的错误描述
  • 相关日志文件内容