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

金南瓜SECS/GEM独立工控机或与设备软件相结合，使用户能够灵活应对各种使用场景。

所有软件目录清单

1 SECS/GEM用户

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

移植所需文件

所需文件在红框内

2. PLC SECS/GEM用户

1. 设备端模拟软件EquipViewApp

4. SECS/GEM300模拟软件EquipViewApp300

5. 其他软件

1. 后台服务流程JNG_Server.exe

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各种通信数据。

1. 编程语言

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

2 运行环境

Windows XP SP3

windows 7

windows 10

3 开发工具

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

4 硬件环境

硬件：

         PC工控机

接口：

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

http://www.secsgem.cn

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

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

2.      运行文件许可方式

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

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

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

SDK与设备软件交互关系图

1. 初始化SDK dll模块

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

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

4. 启用通讯

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

初始化流程

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

         例如：

                   通讯状态

                   控制状态

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

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

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

作用：

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

配置文件目录：

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

类型映射表

通过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为通过回调方式访问最新值

通过Event.csv方法添加

通过alarm.csv方法添加

1. ID 是唯一性的

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

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所能支持的格式

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

接口：

void Start(string pServerAddr, int nPort);

例子：

m_pSecs = new CSecsEquip();

// 连接服务器

RcResult rc = m_pSecs->Start();

初始化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;

1. 调用接口API开始通讯

CommEnable();

更新变量数据的方式

1. 采用设置方法 

VariableSet();

通过API函数发送事件

EventPos();

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

AlarmSet(ID, true/false);

true为设置

false为清除

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

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

注意：

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

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

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

创建一个SECS通讯对象

public CSecsEquip m_pSecs = new CSecsEquip();

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

初始化方法：

1. 调用开始接口

void Start(string pServerAddr, int nPort);

2. 使用例子

Start();

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. 增加变量、事件、警报等

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

1. 调用接口API开始通讯

CommEnable();

更新变量数据的方式

1. 采用设置方法

VariableSet();

通过API函数发送事件

EventPos();

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

AlarmSet(ID, true/false);

true为设置

false为清除

第四章   常见问题与解决

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

         需要材料：一根网线

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

         配置方法：

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

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

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

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

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

                   可能出现的问题：

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

         现象：

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

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

         可能出错原因：

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