secs/gem协议系统通讯平台

第一章   产品简介

1. 产品介绍

金南瓜SECS/GEM是最适应于全自动智能设备的选择。 DMS SECS/GEM具有怪兽级的强劲性能，全面升级的高适应性，易用友好的SECS工具，利于快速开发部署。

         金南瓜SECS/GEM兼容运行在独自工控机，或与设备软件集成在一台工控机，让用户灵活应对各种使用场景。

2. 软件清单与展示

全部软件目录清单

2.1软件清单

1       SECS/GEM用户

提供EquipViewApp.exe和HostViewApp.exe俩款demo软件，分别对应的场景是设备端和主机端模拟。

移植所需文件

红色框内为所需文件

2.      PLC SECS/GEM用户

提供EquipViewApp.exe、 PlcSecsControlView.exe和HostViewApp.exe软件，分别对应的场景是设备端、PLC连接器和主机EAP端模拟。

3.      GEM300用户

额外提供EquipViewApp300.exe和HostViewApp300.exe测试软件，分别对应的GEM300设备端和主机端模拟。

2.2 模拟软件展示

1.      设备端模拟软件EquipViewApp

4.      SECS/GEM300模拟软件EquipViewApp300

5. 其他软件

1. 后台服务进程JNG_Server.exe

2.3 其他文件介绍

1. SecsConfig 文件夹中主要的文件
   1. licenses.ini 为运行许可，可选用加密狗或licenses.ini方式授权
   2. 配置文件：
      1. Alarm.csv 为警报信息表（ALID）
      2. EC.csv 为设备常量表（ECID）
      3. Event.csv 为设备常量表（CEID）
      4. SV.csv 为用户软件的设备常量表（SVID/VID）
2. PlcSecsData文件夹为PLC的配置档，保存客户与PLC通讯的各类数据。

3. 开发环境

1. 编程语言

主流语言 C、C++、C#、Labview

2 运行环境

                   Windows XP SP3

windows 7

windows 10

3 开发工具

LabVIEW、VC6.0、QT、Visual Studio 2008及以上

4 硬件环境

硬件：

         PC工控机

接口：

RJ45或者光纤以太网网口 1个

第二章   软件使用

4. 软件获取

4.1 获取金南瓜SECS SDK

用户可以在我们的网站上下载开发包文件。

http://www.secsgem.cn

下载地址http://download.semisecs.com               

4.2 获取运行许可

1.      如果为加密狗方式，将加密狗插入USB接口即可

2.      运行文件许可方式

1. 运行licenseClient获取PC的序列号GUID

1. 将获取到的GUID发送给厂商
2. 将金南瓜给予的license替换/JngServer/SecsConfig/license.ini文件夹里面原来的许可。

4.3 软件使用

1. 参考 “Demo使用介绍书(日期).pdf”操作使用书

第三章   开发指导

5 软件交互流程

SDK与设备软件交互关系图

5.1 初始化SECS/GEM SDK模块

1. 初始化SDK dll模块

2. 设置各类参数、回调函数等

3. 设置控制模式（OFFLINE或ONLINE）

4. 启用通讯

​​​​​​​ ​​​​​​​

初始化流程

5.2 SECS/GEM SDK与设备之间交互

1. 通讯状态发生改变时，SDK通过回调函数实时反馈给设备

         例如：

                   通讯状态

                   控制状态

2. 设备发生事件时，调用EventPos API通知SDK

3. 设备发生Alarm时，调用Alarm Set API通知SDK

4. 服务器发送远程命令给设备，SDK通过远程命令回调函数通知设备

6 数据配置

作用：

         SECS/GEM 将变量、事件、警报等数据含义配置给SDK

配置文件目录：

         SECS/GEM在../JngServer/SecsConfig/当中

类型映射表

6.1 变量添加

通过SV.csv方法添加

1. ID建议
2. TYPE类型:L、A、TF、B、U1、U2、U4、I1、I2、I4、F4、F8
3. CLASS一般为SV
4. Int value 一般为空
5. Units为单位
6. callback为通过回调方式访问最新值

6.2 事件添加

通过Event.csv方法添加

6.3 警报添加

通过alarm.csv方法添加

1. ID 是唯一性的

7  C/C++二次开发

这部分内容针对于PC端的C++语言二次开发

7.1 编译器配置改动：

8.1.1 编译器 VC6 配置

无需改动

8.1.2 SECS/GEM 编译器 C++ Builder 6 配置

需要修改代码

1. 启用“SecsPortExport.h”的宏定义 #define __CPP_BUILDER__

原来没有启用

、

启用宏定义

2. 删除“Group.cpp”、“SecsBase.cpp”和“SecsEquip.cpp”第一行的 #include “stdafx.h”

3. SECS/GEM 用C++ Builder 6 的implib.exe将SecsPort.lib转换成C++ Builder 6所能支持的格式

7.2 初始化SDK

在使用SECS通讯之前需要调用Start函数进行初始化dll模块。

接口：

void Start(string pServerAddr, int nPort);

例子：

m_pSecs = new CSecsEquip();

// 连接服务器

RcResult rc = m_pSecs->Start();

7.3 初始化参数

初始化SECS/GEM通讯的各项参数，例如IP、端口号、device ID等。

接口：

1. SECS连接参数的接口

设置通讯对方的TCP/IP地址

RcResult SetIP(string ip);

设置TCP/IP通讯的端口号

RcResult SetPort(int port);

设置主动/被动的TCP/IP通讯模式

RcResult SetPassive(bool bPassive);

设置设备型号名称

RcResult SetMDLN(string pMDLN);

设置会话ID

RcResult SetDeviceID(int nDeviceID);SetT1();

设置各种场景的超时

RcResult SetT1(int nTimeout);

RcResult SetT2(int nTimeout);

RcResult SetT3(int nTimeout);

RcResult SetT4(int nTimeout);

RcResult SetT5(int nTimeout);

RcResult SetT6(int nTimeout);

RcResult SetT7(int nTimeout);

RcResult SetT8(int nTimeout);

2. 加载CSV数据

加载指定的数据CSV配置

RcResult LoadDataByCsvFile(string pDir = “”);

3. 设置响应函数

SecsStateChangeProc* m_pStateChangeCallback;                    // 状态改变回调SecsTerminalProc* m_pTerminalCallback;                                 // 终端信息回调

SecsRemoteProc* m_pRemoteCallback;                                      // 远程控制回调            

4. 如果需要多线程同步，可以同步对象

回调函数会附带该参数

void SetClientData(void* pClientData);

5. 设置控制模式

设置控制状态

RcResult SetControlMode(CONTROL_MODE state);

6. 增加变量、事件、警报等

增加方法参考后面对应名称

例子：

m_pSecs = new CSecsEquip();

// 连接服务器

RcResult rc = m_pSecs->Start();

         if (rc.rc != 0)

         {

                   MessageBox(rc.ToString().c_str(), “JNG_Server.exe没有初始化”);

                   // 暴力退出不推荐

                   exit(0);

         }

// 初始化其他

         // 设置参数

         rc = m_pSecs->SetIP(g_appdata.m_pAddress);                                      

         rc = m_pSecs->SetPort(g_appdata.m_nPort);                                        

         rc = m_pSecs->SetPassive(g_appdata.m_bPassive);                              

         rc = m_pSecs->SetDeviceID(g_appdata.m_nDeviceID);             

         rc = m_pSecs->SetMDLN(g_appdata.m_pInterfaceName);                

         rc = m_pSecs->SetEnableLog(g_appdata.m_bEnableLog);                   

         rc = m_pSecs->SetT1(g_appdata.m_nTimeout[0]);                               

         rc = m_pSecs->SetT2(g_appdata.m_nTimeout[1]);                               

         rc = m_pSecs->SetT3(g_appdata.m_nTimeout[2]);                               

         rc = m_pSecs->SetT4(g_appdata.m_nTimeout[3]);                               

         rc = m_pSecs->SetT5(g_appdata.m_nTimeout[4]);                               

         rc = m_pSecs->SetT6(g_appdata.m_nTimeout[5]);                               

         rc = m_pSecs->SetT7(g_appdata.m_nTimeout[6]);                               

         // 设置回调

         m_pSecs->SetClientData(this);

         m_pSecs->m_pTerminalCallback = ::OnTerminalProc;

         m_pSecs->m_pStateChangeCallback = ::OnStateChangeProc;

         m_pSecs->m_pRemoteCallback = ::OnRemoteProc;

// 示例的回调内容结束       

         // 通过Csv文件加载配置

         rc = m_pSecs->LoadDataByCsvFile();

         // 建立通讯

         rc = m_pSecs->SetControlMode((CONTROL_MODE)g_appdata.m_nControlMode);

         if(g_appdata.m_bCommEnable)

         {

                   rc = m_pSecs->CommEnable();

                   SHOW_MSG_RC(rc);

         }

         return true;

7.4 建立通讯

1. 调用接口API开始通讯

CommEnable();

7.5 变量设置

更新变量数据的方式

1. 采用设置方法 

VariableSet();

7.6 事件发送

通过API函数发送事件

EventPos();

7.7 警报设置/清除

通过API函数设置/清除警报

AlarmSet(ID, true/false);

true为设置

false为清除

8  C# SECS/GEM 二次开发

这部分内容针对于PC端的C#语言二次开发

接口名称和作用跟C++一致

注意：

         工程师需要将SecsBase和SecsEquip俩个C#项目重新编译

         1. 将项目的net版本选择与设备软件一致的版本

2. 编译生成DLL文件，将DLL文件添加到设备软件项目当中

8.1 初始化SDK

创建一个SECS通讯对象

public CSecsEquip m_pSecs = new CSecsEquip();

金南瓜SDK软件使用之前必须先对其初始化

初始化方法：

1. 调用开始接口

void Start(string pServerAddr, int nPort);

2. 使用例子

Start();

8.2 初始化参数

1. 设置SECS连接参数

         SetIP();

         SetPort();

         SetPassive();

         SetMDLN();

         SetT1();

         SetT2();

         SetT3();

         SetT4();

         SetT5();

         SetT6();

         SetT7();

2. 加载CSV数据

LoadDataByCsvFile();

3. 设置响应/委托函数

m_pOnCommState                    通讯状态改变通知

m_pOnControlState                   控制状态改变通知

m_pOnRemoteCommand         远程命令通知

m_pOnTerminal                          终端消息通知

4. 设置处理对象指针

SetClientData();

5. 设置控制模式

SetControlMode();

6. 增加变量、事件、警报等

         增加方法参考后面对应名称

8.3 建立通讯

1. 调用接口API开始通讯

CommEnable();

8.4 变量设置

更新变量数据的方式

1. 采用设置方法

VariableSet();

8.5 事件发送

通过API函数发送事件

EventPos();

8.6 警报设置/清除

通过API函数设置/清除警报

AlarmSet(ID, true/false);

true为设置

false为清除

第四章   常见问题与解决

9 问题与场景

9.1 笔记本控制设备

         场景： 笔记本通过SECS控制设备

         需要材料：一根网线

         接线：用网线将设备和笔记本网口相接

         配置方法：

                   1.      将设备配置成“设备配置图1”的网络配置。

2.      笔记本配置成“笔记本配置图2”的网络配置。

                                    设备配置图1                                                         笔记本配置图2

3.      将设备端SECS设置为被动模式，启动通讯

4.      将笔记本的SECS Host端配置为主动模式，IP地址为192.168.1.1，启用通讯就能通讯上。

                   可能出现的问题：

1. 如果使用笔记本跟设备电脑连接，如果任一电脑加公司域。该情况有可能无法连接。

9.2 防火墙导致无法通讯

         现象：

1. 使用cmd的ping可以对俩台电脑进行测试通畅

         2. 模拟器在本地通讯测试没问题，俩台电脑时候却无法通讯

         可能出错原因：

1. 防火墙拦截住通讯连接，将防火墙关闭再测试

10 错误代码