Secs/Gem第二讲 (基于secs4net项目的ChatGpt介绍)

news2025/3/20 2:46:19

好的，我们正式进入：

第二讲：深入 SECS4NET 项目结构——主机程序是怎么搭起来的？

关键词：项目结构、类图、通信类、事件处理、连接生命周期、异步机制

本讲目的

我们从源码入手，一步步搞懂：

SECS4NET 主机（Host）是如何设计通信逻辑的
有哪些关键类，类之间的关系是什么
通信的生命周期怎么管理
怎么实现“接收消息”和“主动发送”的功能
如何集成到你自己的 EAP 或测试程序中

你将不再只是“调 Sample”，而是可以掌控它的主干脉络，甚至模仿它写出你自己的通信程序。

一、SECS4NET 项目的基本结构

这个项目结构很清晰，大致可以分成三大块：

1. 核心库部分

主要是以下几个类和命名空间：

类名 / 接口	功能描述
`SecsGem`	主控类，负责建立连接、发送接收消息，是你最常用的接口
`SecsMessage`	表示一条 SECS 报文
`SecsItem`	表示报文内部的数据结构（Item Tree）
`SecsGemBuilder`	构建 `SecsGem` 的工厂类，负责配置通信参数
`HSMSConnectMode`	枚举，指明是主机模式还是设备模式

这些类都在 Sec4net 命名空间中，是整个通信流程的核心。

2. 样例程序（SampleHost）

这是个完整的 WPF Demo，它通过 UI 来驱动 Host 端的连接、发命令、注册事件等。

你可以从 SampleHost 入手，理解 SECS4NET 是如何实际运作的：

按钮绑定命令（Command）
App.xaml.cs 中初始化 Host
有个 GemService 类作为核心逻辑封装

3. 工具与日志

比如：

MessageLogViewModel.cs：将 SECS 报文日志格式化输出
App.xaml：注册依赖注入，绑定服务层
Config 配置项：定义设备地址、端口、模式等参数

二、核心类分析：SecsGem

这是你最常打交道的类，我们来详细拆解一下它的几个核心接口和机制。

1. 初始化过程

var gem = new SecsGemBuilder()
    .UseHsms()
    .ConnectMode(HSMSConnectMode.Active) // 主机模式
    .DeviceId(0)
    .Host("127.0.0.1")  // 设备 IP
    .Port(5000)         // 设备端口
    .Build();

解释知识点：

.UseHsms() 表示使用 HSMS 协议（TCP 通信）
.ConnectMode() 设为 Active 就是主机，Passive 就是设备
.DeviceId() 是主机的设备编号
.Host() 和 .Port() 指的是连接目标设备的地址和端口
.Build() 返回一个 SecsGem 实例

2. 启动连接

await gem.ConnectAsync();

连接过程其实包括 TCP 建立、SECS 建链（S1F13/S1F14）、状态机启动等。

3. 监听接收到的报文

gem.MessageReceived += OnSecsMessageReceived;

你只要写一个回调函数：

private void OnSecsMessageReceived(object sender, SecsMessage e)
{
    if (e.Stream == 6 && e.Function == 11)
    {
        var ceid = e.SecsItem[0].GetValue<ushort>();
        Console.WriteLine($"收到事件：CEID = {ceid}");
    }
}

报文进来后你可以按 SML 结构解析，把报文打印出来或入库。

4. 发送消息

发送很简单，你只需要构造一个 SecsMessage，比如：

var msg = new SecsMessage(2, 41, true,
    Item.L(
        Item.A("START_PROCESS"),
        Item.L(Item.A("Lot123"), Item.A("Recipe1"))
    )
);
await gem.SendAsync(msg);