SECS4Java8 项目使用教程

1. 项目的目录结构及介绍

SECS4Java8 项目是一个基于 Java 8 实现的 SEMI-SECS 通信协议的开源库。以下是项目的目录结构及其简要介绍：

secs4java8/
├── docs/               # 项目文档目录
├── src/                # 源代码目录
│   ├── examples/       # 示例代码目录
│   └── main/           # 主代码目录
├── .gitignore          # Git 忽略文件
├── LICENSE             # 项目许可证文件
├── README-HSMS-GS.md   # HSMS-GS 相关的 README 文件
├── README.md           # 项目总体的 README 文件
├── compile.sh          # 编译脚本
└── javadoc.sh          # 生成 Javadoc 的脚本

• docs/: 存放项目的文档。
• src/: 包含项目的所有源代码。
  • examples/: 包含一些使用该库的示例代码。
  • main/: 包含库的主要代码。
• .gitignore: 指定 Git 忽略的文件和目录。
• LICENSE: 项目的 Apache-2.0 许可证。
• README-HSMS-GS.md: 关于 HSMS-GS 的详细说明。
• README.md: 项目的总体介绍和说明。
• compile.sh: 用于编译项目的脚本。
• javadoc.sh: 用于生成项目 Javadoc 文档的脚本。

2. 项目的启动文件介绍

SECS4Java8 项目并没有一个专门的启动文件，它主要作为一个库被其他 Java 项目所依赖。在使用时，你需要将该项目作为依赖项加入到你的项目中，然后根据官方文档或示例代码来创建和配置通信器。

以下是一个简单的示例，展示了如何创建一个 HSMS-SS 被动通信器的实例：

HsmsSsCommunicatorConfig config = new HsmsSsCommunicatorConfig();
config.connectionMode(HsmsConnectionMode.PASSIVE);
config.socketAddress(new InetSocketAddress("127.0.0.1", 5000));
config.sessionId(10);
config.isEquip(true);
config.timeout().t3(45.0F);
config.timeout().t6(5.0F);
config.timeout().t7(10.0F);
config.timeout().t8(5.0F);
config.gem().mdln("MDLN-A");
config.gem().softrev("000001");
config.gem().clockType(ClockType.A16);

SecsCommunicator passive = HsmsSsCommunicator.newInstance(config);
passive.open();

3. 项目的配置文件介绍

SECS4Java8 项目的配置主要是通过创建不同类型的 CommunicatorConfig 对象来完成的。每种通信器类型（如 HSMS-SS、HSMS-GS、SECS-I 等）都有自己的配置类，这些配置类提供了多种方法来设置通信器参数，如连接模式、套接字地址、会话 ID、设备类型、超时设置等。

以下是 HsmsSsCommunicatorConfig 类的一些配置选项：

• connectionMode(): 设置连接模式（主动或被动）。
• socketAddress(): 设置通信器的 IP 地址和端口。
• sessionId(): 设置会话 ID。
• isEquip(): 设置是否为设备。
• timeout().t3(): 设置 T3 超时时间。
• timeout().t6(): 设置 T6 超时时间。
• timeout().t7(): 设置 T7 超时时间。
• timeout().t8(): 设置 T8 超时时间。
• gem().mdln(): 设置设备的模型名称。
• gem().softrev(): 设置软件版本。
• gem().clockType(): 设置时钟类型。

每个配置方法都允许你细粒度地控制通信器的行为，以满足特定应用的需求。在实际使用中，你应该根据你的应用场景和通信要求来配置这些参数。