1.0  通讯组件概述

通讯组件用于PC与可编程控制器(PLC)、智能仪表等进行数据通讯,适用于基于PC高级语言的工业自动化控制系统。组件采用动态链接库文件(*.DLL)的形式,在PC系统的项目工程里引用该组件,调用相应的属性与方法函数,即可快速实现PC与PLC的高效数据交换。

DLL通讯组件无须安装,直接复制到工程文件目录,方便打包安装部署;无须任何配置,直接调用函数,与应用开发无缝衔接;多年工程经验的软件团队开发测试,经过本公司及客户的海量实际工程应用检验,稳定可靠;采用稳定高效的内部协议,无须编写PLC内部程序配合,直接访问PLC的内存,通讯响应快速;内建动态管理的多独立线程连接,同时支持外部应用的多线程结构调用;兼容WINDOWS系统下的所有开发环境,包括各种版本的VB.NET、C#、VC++,以及DEIPHI 、VB、LabView等;支持几乎所有PLC的CPU自带通讯口、通讯扩展模块。

2.0  通讯组件名称

C#与西门子PLC通讯-LMLPHP

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)。

05-11 20:28