Connect IoT - SECS/GEM驱动程序#

SECS/GEM是半导体的设备接口协议，用于设备对主机的数据通信。在自动化制造产业中，该接口可用于启动和停止设备处理、收集测量数据、更改变量和选择产品配方。SECS（SEMI设备通信标准）/GEM（通用设备模型）标准将以明确定义的方式完成所有这些操作。

数据类型#

这些是受支持的特定数据类型：

Table: SECS/GEM特定数据类型

异常流程参数#

异常流程支持以下参数，用于定义通信参数以及驱动程序的预期行为：

Table: SECS/GEM特定参数

扩展参数#

属性#

使用此协议的驱动程序定义中定义的所有自动化属性都将具有以下可自定义的扩展（额外）属性

Table: SECS/GEM特定扩展属性

事件#

驱动程序定义中定义的使用此异常流程的所有自动化事件都将具有以下可用于自定义的扩展（额外）属性

Table: SECS/GEM特定扩展事件

事件属性#

使用此协议的驱动程序定义中定义的所有自动化事件属性都将具有以下可自定义的扩展（额外）属性

命令#

驱动程序定义中定义的使用此异常流程的所有自动化命令都将具有以下可用于自定义的扩展（额外）属性

Table: SECS/GEM特定命令

初始配置流程#

当已请求连接且设置了自动配置配置时，系统将执行以下消息交换来配置设备：

• 建立通信(S1F13)
  • 应为S1F14且具有0x00 ACK
• 设置联机(S1F17)
  • 预期S1F18将获得0x00或0x02 ACK
• 基于deleteReportsMode设置删除报告(S2F33)
  • 应为S2F34且具有0x00 ACK
• 定义报告(S2F33)
  • 应为S2F34且具有0x00 ACK
• 将事件与报告链接(S2F35)
  • 应为S2F36且具有0x00 ACK
• 基于enableDisableEventsMode设置启用/禁用事件(S2F37)
  • 应为S2F38且具有0x00 ACK
• 基于enableDisableAlarmsMode设置启用/禁用警报(S5F3)
  • 应为S5F4且具有0x00 ACK

驱动程序扩展#

此异常流程驱动程序提供了一组扩展，允许自定义执行独立于关联的驱动程序定义的操作。这意味着您可以使用自定义注册驱动程序定义中不存在的事件。

这在访问共享的设备数据或者由于过于复杂而无法使用常规机制访问的设备数据时特别有用。在需要访问命名约定可能因设备而异的数据时也很有用。

对象#

对象是作为参数传递或作为结果值返回的结构。

RegisterHandler#

Table: SECS/GEM特定处理程序注册

UnregisterHandler#

Table: SECS/GEM特定处理程序取消注册

SecsMessage#

Table: SECS/GEM特定SecsMessage

SecsItem#

Table: SECS/GEM特定SecsItem

SecsTransaction#

Table: SECS/GEM特定SecsTransaction

方法#

注册处理程序#

在发生特定SECS/GEM消息类型时通知协议驱动程序引发该事件。

void connect.iot.driver.secsgem.registerHandler(data: RegisterHandler)

示例#

通知 connect.iot.driver.secsgem.registerHandler

{
  "type": "S1F13",
  "mode": "HandleFullProcess"
}

取消注册处理程序#

通知异常流程驱动程序在出现特定消息时停止引发该消息。

void connect.iot.driver.secsgem.unregisterHandler(data: UnregisterHandler)

示例#

通知 connect.iot.driver.secsgem.unregisterHandler

{
  "type": "S1F13"
}

发送消息#

向设备发送消息（或回复）。

any connect.iot.driver.secsgem.sendMessage (data: SecsMessage)

示例#

SendRequest connect.iot.driver.secsgem.sendMessage

{
    "type": "S1F13",
    "item": {
        "type": "L",
        "value": [ {
            "type": "A",
            "name": "MLDN",
            "value": "Equipment TopModel"
        }, {
            "type": "A",
            "name": "SOFTREV",
            "value": "Software Rev 1.0"
        } ]
    }
}

示例（回复）#

SendRequest connect.iot.driver.secsgem.sendMessage

{
    "type": "REPLY_1234567890",
    "item": {
        "type": "L",
        "value": [ {
            "type": "BI",
            "name": "COMMACK",
            "value": "0x00"
        }
    }
}

内部删除报告#

基于deleteReportsMode设置发送“删除报告”消息(S2F33)。如果您希望发送一些自定义握手流，则使用此功能。

bool connect.iot.driver.secsgem.internalDeleteReports()

内部定义报告#

发送“定义报告”消息(S2F33)。如果您希望发送一些自定义握手流，则使用此功能。

bool connect.iot.driver.secsgem.internalDefineReports()

内部链接事件#

发送“将事件与报告链接”消息(S2F35)。如果您希望发送一些自定义握手流，则使用此功能。

bool connect.iot.driver.secsgem.internalLinkEvents()

内部启用禁用事件#

基于enableDisableEventsMode设置发送“启用/禁用事件”消息(S2F37)。如果您希望发送一些自定义握手流，则使用此功能。

bool connect.iot.driver.secsgem.internalEnableDisableEvents()

内部启用禁用警报#

基于enableDisableAlarmsMode设置发送“启用/禁用警报”消息(S5F3)。如果您希望发送一些自定义握手流，则使用此功能。

bool connect.iot.driver.secsgem.internalEnableDisableEvents()

事件#

connect.iot.driver.secsgem.receivedMessage.*#

只有在先注册事件后，才会引发事件。事件的内容类型为SecsTransaction，其中相关的值将因触发的事件而异。

触发的事件的全名将附加先前注册的事件的全名。

示例（假定之前已使用registerHandler注册S1F13消息）：

{
    "id": "1234567890",
    "systemBytes": [0x00, 0x01, 0x02, 0x03],
    "needsReply": true,
    "primary": {
        "type": "S1F13",
        "item": {
            "type": "L",
            "value": [ {
                "type": "A",
                "name": "MLDN",
                "value": "Equipment TopModel"
            }, {
                "type": "A",
                "name": "SOFTREV",
                "value": "Software Rev 1.0"
            } ]
        }
    },
    "secondary": {
        "type": "S1F14",
        "item": {
            "type": "L",
            "value": [ {
                "type": "BI",
                "name": "COMMACK",
                "value": "0x00"
            }
  }
    }
}

要发送此消息的回复（并替换模板回复），请使用“发布”/“发送请求” connect.iot.driver.secsgem.sendMessage

{
    "type": "REPLY_1234567890",
    "item": {
        "type": "L",
        "value": [ {
            "type": "BI",
            "name": "COMMACK",
            "value": "0x01"
        }
    }
}

内存泄漏修复手册说明#

由于已部署的组件存在内存泄漏问题，需要执行一些手动步骤来进行修复并重新编译该组件。

1. 转到 node_modules\edge-js\src\CoreCLREmbedding

2. 编辑coreclrnodejsfuncinvokecontext.cpp文件

3. 转到第100行并添加以下行：

CoreClrFunc::FreeMarshalData(context->Payload, context->PayloadType);

1. 代码应如下所示：

DBG("CoreClrNodejsFuncInvokeContext::InvokeCallback - Calling JavaScript function");
Nan::Call(Nan::New(*(context->FunctionContext->Func)), Nan::GetCurrentContext()->Global(), 2, argv);
CoreClrFunc::FreeMarshalData(context->Payload, context->PayloadType);
DBG("CoreClrNodejsFuncInvokeContext::InvokeCallback - Called JavaScript function");

1. 保存并关闭编辑器

2. 返回node_modules\edge-js目录

3. 进入tools目录

4. 输入以下命令（将相应部分更改为您正在使用的节点版本）

node -v
build.bat release 8.14.0

1. 如果上述命令由于缺少node-gyp依赖项而失败，请确保已安装该依赖项

npm install -g node-gyp