1.0 通讯组件概述
通讯组件用于PC与可编程控制器(PLC)、智能仪表等进行数据通讯,适用于基于PC高级语言的工业自动化控制系统。组件采用动态链接库文件(*.DLL)的形式,在PC系统的项目工程里引用该组件,调用相应的属性与方法函数,即可快速实现PC与PLC的高效数据交换。
DLL通讯组件无须安装,直接复制到工程文件目录,方便打包安装部署;无须任何配置,直接调用函数,与应用开发无缝衔接;多年工程经验的软件团队开发测试,经过本公司及客户的海量实际工程应用检验,稳定可靠;采用稳定高效的内部协议,无须编写PLC内部程序配合,直接访问PLC的内存,通讯响应快速;内建动态管理的多独立线程连接,同时支持外部应用的多线程结构调用;兼容WINDOWS系统下的所有开发环境,包括各种版本的VB.NET、C#、VC++,以及DEIPHI 、VB、LabView等;支持几乎所有PLC的CPU自带通讯口、通讯扩展模块。
2.0 通讯组件名称
3.0 数据类型
通讯组件能对PLC的输入、输出端口,以及内部中间继电器存储区域、内部数据存储区域,以及扩展存储区域进行读写操作,支持以下数据类型:
0 BOOL1: 1位布尔型数据;
1 INT16: 16位有符号整数;
2 UINT16: 16位无符号整数;
3 DINT32: 32位有符号整数;
4 HEX32: 32位16进制字符;
5 REAL32: 32位单精度浮点数据;
6 BIN16: 16位二进制字符串;
7 CHAR8: 8位单个字符(ASCII)
8 BYTE8: 8位单字节数据;
9 STRING: 多个字符或数字组成的字符串(ASCII)
4.0 函数与参数
4.1 函数参数
[EntLink] 设置PC、PLC的通讯参数,建立与PLC的以太网连接;
参数: pcIP,String,本地地址,即PC端的IP地址
pcPort , Uint16, 本地端口,即PC端的网络端口,默认为0
plcIP , String ,远程地址,即PLC的IP地址
plcPort ,Uint16, 远程端口,即PLC的通讯端口
Rack ,Uint16, PLC的机架号码
Slot ,Uint16, PLC的CPU的插槽号码
Handle, Integer ,DLL组件返回网络中PLC的连接句柄 *1
SN , String,调用序列号码,可联系本公司获
OverTime,Uint16, 通讯超时时间限制,毫秒单位,默认1000
返回值: Int16,函数执行结果,见4.3详细说明。
[ComLink] 设置PC、PLC的通讯参数,建立与PLC的串口连接;
参数: CommPort,Uint16,联接PLC的PC通讯端口
CommRate,Int32,与PLC通讯的速率
DataBit, Uint16, 通讯数据位数
StopBit,Uint16, 数据的停止位数
Parity,PrtType, 数据校验方式
Station, Uint16, PLC的站号码
OverTime,Uint16, 通讯超时时间限制,毫秒单位
SN , String,调用序列号码,通过联系本公司获取
返回值:Int16,函数执行结果,见4.3详细说明
[DeLink] 断开与PLC的连接;
参数: Handle, Integer , 通过EntLink函数获取的网络中PLC的句柄 *1
返回值: Int16,函数执行结果,见4.3详细说明
[CmdRead] 批量读取PLC的数据;
参数: Handle, Integer , 通过EntLink函数获取的网络中PLC的句柄 *1
Memory ,PlcMemory, PLC数据区域枚举,见4.2详细说明
ValType, DataType, 数据类型枚举,见4.2详细说明
Block ,Uint16, DB块的号码,非DB数据为0
Address ,Uint16, 要读取的存储区域起始地址
Count ,Uint16, 要读取的数量,以ValType对应的数据类型为单位
ReData() ,Object/String,读取到的数据(传地址方式的形式参数)
返回值: Int16,函数执行结果,见4.3详细说明
[CmdWrite] 批量写入数据到PLC;
参数: Handle, Integer , 通过EntLink函数获取的网络中PLC的句柄 *1
Memory ,PlcMemory, PLC数据区域枚举,见4.2详细说明
ValType, DataType, 数据类型枚举,见4.2详细说明
Block ,Uint16, DB块的号码,非DB数据为0
Address ,Uint16, 要写入的存储区域起始地址
Count ,Uint16, 要写入的数量,以ValType对应的数据类型为单位
Data() ,Object/String,要写入PLC的数据(传地址方式的形式参数)
返回值: Int16,函数执行结果,见4.3详细说明
[Bit_Test] 以Bit(位)的方式读取一个位的状态;
参数: Handle, Integer , 通过EntLink函数获取的网络中PLC的句柄 *1
Memory ,PlcMemory, PLC数据区域枚举,见4.2详细说明
Block ,Uint16, DB块的号码,非DB数据为0
Address ,Uint16, 要读取的位所在的字或字节地址
Bit,Uint16, 要读取的位在Address中的位号码
State ,Boolean,读取到的位的状态(传地址方式的形式参数)
返回值: Int16,函数执行结果,见4.3详细说明
[Bit_Set] 以Bit(位)的方式设置其状态为ON;
参数: Handle, Integer , 通过EntLink函数获取的网络中PLC的句柄 *1
Memory ,PlcMemory, PLC数据区域枚举,见4.2详细说明
Block ,Uint16, DB块的号码,非DB数据为0
Address ,Uint16, 要设置的位所在的字或字节地址
Bit,Uint16, 要设置的位在Address中的位号码
返回值: Int16,函数执行结果,见4.3详细说明
[Bit_Reset] 以Bit(位)的方式复位其状态为OFF;
参数: Handle, Integer , 通过EntLink函数获取的网络中PLC的句柄 *1
Memory ,PlcMemory, PLC数据区域枚举,见4.2详细说明
Block ,Uint16, DB块的号码,非DB数据为0
Address ,Uint16, 要复位的位所在的字或字节地址
Bit,Uint16, 要复位的位在Address中的位号码
返回值: Int16,函数执行结果,见4.3详细说明
[CmdReadString] 读取PLC中的字符串;
参数: Handle, Integer , 通过EntLink函数获取的网络中PLC的句柄 *1
Memory ,PlcMemory, PLC数据区域枚举,见4.2详细说明
Block ,Uint16, DB块的号码,非DB数据为0
Address ,Uint16, 要读取的存储区域起始地址
PlcDataSize ,Uint16, PLC内定义的存放字符的最大字符数
返回值: String,正常时为读到的字符串,异常时为空
[CmdWriteString] 写入字符串到PLC;
参数: Handle, Integer , 通过EntLink函数获取的网络中PLC的句柄 *1
Memory ,PlcMemory, PLC数据区域枚举,见4.2详细说明
Block ,Uint16, DB块的号码,非DB数据为0
Address ,Uint16, 要写入的存储区域起始地址
PlcDataSize ,Uint16, PLC内定义的存放字符的最大字符数
Data ,String, 要写入到PLC的符数,长度应≤PlcDataSize
返回值: String,正常时为读到的字符串,异常时为空
[DataConvert] 数据类型转换函数;
参数: SourType,DataType, 数据类型枚举,见4.2详细说明
SourData , Object,需要转换的源数据
DestType ,DataType, 数据类型枚举,见4.2详细说
DestData ,Object,转换后的目标数据(传地址方式的形式参数)
StartByte ,Int16,目标数据从源数据取数的起始字节(可选参数)
返回值: Int16,函数执行结果,见5.3详细说明。
*1: Handle参数说明
为方便同一应用程序连接多台PLC而设置的参数,在通讯组件外部调用时,定义一个全局变量,DLL在与PLC网络连接成功以后,自动分配PLC句柄数据,外部程序通过该句柄区分操作不同的PLC;变量为输入输出型参数,即传地址方式的形式参数,外部赋值无效。
4.2 枚举结构体参数说明:
--PlcMemory 要操作的PLC的内存区域类型:
DI: 数字输入端口;
DQ: 数字输出端口;
MR: 内部中间继电器区域;
DR: 内部数据寄存器V/DB区域;
--PrtType 串口通讯的校验方式
None: 无校验
Odd:奇校验
Even:偶检验
4.3 返回值说明:
0 执行成功;
-1 IP地址或端口参数错误;
-2 网络连接错错误;
-3 连接参数错误导致连接失败(如Rack>7 、Slot>15等);
-4 PLC握手连接异常;
-5 PLC握手无响应;
-6 PLC握手响应错误;
-10 读数据超过最大数据量限制;
-11 读数据时数据发送异常;
-12 读数据时PLC响应超时;
-13 读数据PLC返回格式错误;
-14 读数据PLC返回数据错误;
-15 读数据PLC返回数据校验错误;
-18 PLC的网络句柄解析错误;
-19 PLC的网络句柄数据错误;
-20 写数据超过最大数据量限制;
-21 写数据时数据发送异常;
-22 写数据PLC响应超时;
-23 写数据PLC返回格式错误;
-24 写数据PLC返回数据错误;
-25 写数据PLC返回数据校验错误;
-28 PLC的网络句柄解析错误;
-29 PLC的网络句柄数据错误;
-31 数据转换时源数据处理错误;
-32 数据转换时目标数据处理错误;
-41 位操作函数的参数错误;
-70 PLC内存区域的功能受限制;
-80 PC系统中无网卡;
-81 PC的IP地址格式错误;
-82 PLC的IP地址格式错误;
-83 PING命令返回错误;
-99 连接序列号错误或测试次数超过试用限制;
5.0 组件使用步骤
5.1 基本步骤
a. 复制DLL、OCX文件到需要用到该组件的工程项目目录下;
b. 注册DLL、OCX文件(VS.NET平台的DLL程序集组件不用注册);
c. 在项目开发环境里引用DLL文件,不同的开发环境引用方式有区别,具体参见所用语言的帮助文档;
d. 参照例程定义、实例化通讯组件,编写相关通讯代码;
5.2 DLL注册方法
VS.NET平台的DLL程序集组件不用注册,ActiveX的COM组件(*.dll/*.ocx)须要在系统下注册才能正常使用,注册的方法主要有两种:
a. 代码注册:用Windows提供的Shell命令,Shell “regsvr32 \s ” + 组件的完整路径及文件名称;
b. 手动注册:同时按下 “Win”键 +“R”建,在弹出的运行对话框中输入:
“Regsvr32 ” + 空格 + 组件的完整路径及文件名称,然后点“确认”按钮;
Windows7 及以上的系统下注册,建议对用户账户作以下设置:
控制面板->用户账号和家庭安全->用户账户->更改用户账户控制设置,把滑竿拖到最下面,即“从不通知”。
Windows7 及以上系统64位注册方法:
a. 在C:\Windows\SysWOW64\下新建目录(以 regdll 为例),复制需要注册的dll到这个目录下(以WinTcpS7.dll为例);
b. 点击开始,在“搜索程序和文件”里键入cmd,然后在搜索出来的cmd菜单上右键,以管理员的权限运行;
c. 此时cmd提示符为C:\Windows\System32,键入: Regsvr32 C:\Windows\System32\regdll\WinTcpS7.dll
d. 按回车键,然后提示注册成功(注意此时使用的是syswow64目录下的regsvr32.exe,而不是system32下的regsvr32.exe)。