mcgs脚本驱动

脚本驱动V2.0使用指导手册

版本号：0.1

第一章新脚本驱动说明

一．脚本驱动适用范围

1.脚本驱动适用的版本

A. MCGS嵌入式组态软件；

版本号：6.5（01.0010）注：此版本以上为新版本，以下为旧版本

B. MCGS通用版的定制版组态软件

C. MCGS网络版的定制版组态软件

2.脚本驱动适用的设备

A. 独立板卡设备

B. 串口通信设备

3.脚本驱动适用的协议

二．脚本驱动兼容性

1.旧版本脚本驱动兼容新版本组态软件

2.新版本脚本驱动不兼容旧版本的组态软件，旧版本组态软件无法识别新版本脚本驱

动

三．脚本驱动新增内容

1.脚本驱动新增功能

新增加生成向导功能，具体参照第三章内容。

2.脚本驱动新增函数

（1）数据解析函数

1.!SvrGetByteFromByteArr(ByRef ByteArr, start, ByRef n, Flag)

2.!SvrGetShortFromByteArr(ByRef ByteArr, start, ByRef n, Flag)

3.!SvrGetIntFromByteArr(ByRef ByteArr, start, ByRef n, Flag)

4.!SvrGetSingleFromByteArr(ByRef ByteArr, start, ByRef x, Flag)

5.!SvrGetByteFromHexStr(str, ByRef n, Flag)

6.!SvrGetShortFormHexStr(str, ByRef n, Flag)

7.!SvrGetIntFromHexStr(str, ByRef n, Flag)

8.!SvrGetSingleFromHexStr(str, ByRef x, Flag)

（2）数据校验函数

1.!SvrByteArraySum(ByRef ByteArr, start, length)

2.!SvrStrSum(str, Flag)

3.!SvrByteArrayXOR(ByRef ByteArr, start, length)

4.!SvrStrXOR(str, Flag)

5.!SvrStrModbusCRC(ByRef ByteArr, start, length)

6.!SvrStrModbusLRC(str, start, length)

7.!OpenLog()

8.!CloseLog()

（3）字节数组操作函数

1.!HStr2HByre(str, arByte)

2.!HByte2HStr(arByte, str)

第二章基础概念讲解

一．通讯协议

1.ACSII码通讯协议（字符型协议）

通讯信息按照ASCII码方式解析得到的参数信息称为ASCII码通讯。比如：主站接收到从站发送的4个字符：0x31 0x34 0x2E 0x36，用ASCII码表示为14.6。

2.HEX通讯协议（字节数组协议）

通讯信息按照十六进制方式解析得到的参数信息称为十六进制通讯。比如：主站接收到从站发送的4个字符：0x31 0x34 0x2E 0x36，用HEX表示为0x31342E36

3.ASCII码通讯与HEX通讯的区别

1)ASCII码通讯传送的字符能清楚的了解发送命令和接收信息，但是传送的信息速度量少；十

六进制通讯发送的字符信息速度量大，但是发送命令和接收信息不明了。

2)ASCII码的通讯帧1个字占4个字符，而HEX的通讯帧1个字占2个字符。如：发送0x1427

信息，ASCII码发送4个字符：0x31 0x34 0x32 0x37，而HEX只需要发送2个字符：0x14 0x27。二．

第三章向导使用说明

一．完全适用向导的协议

1.ASCII码协议，多条命令通讯示例

1.1步骤1：协议分析

通讯命令1：模仿ADAM4018协议，协议格式如下：

发送命令：#xx\r

帧头：长1个字符，固定为#

地址：固定长2个字符

帧尾：长1个字符，为回车

接收命令：#+xxx.xx+xxx.xx+xxx.xx+xxx.xx+xxx.xx+xxx.xx+xxx.xx+xxx.xx\r

帧头：长1个字符，固定为#

数据体：共8个数据体，每个数据体固定长7个字符，按ASCII码方式解析

帧尾：长1个字符，为回车

模拟数据：

发送命令1：#01\r

接收命令1：#+11.111+22.222+33.333+44.444+55.555+66.666+77.777+88.888\r

通讯命令2：自己定义，解析数据非等长通讯协议，分两种情况：数据长度已知；数据长度未知。下面以数据长度未知，数据之间用分隔符分离的协议，协议格式如下：

发送命令：#xxxxxx\r

帧头：长1个字符，固定为#，参与校验

地址：固定长2个字符，参与校验

校验：长2个字符，累加和校验

结束符号：长1个字符，固定为回车

接收命令：#xxAA,BBB,CCCC,DDDDD,EEEE,FFF,GG,HHHHxx\r

帧头：长1个字符，固定为#

数据体：8个数据体，以“，”分隔

校验：长2个字符，累加和校验

结束符号：长1个字符，固定为回车

模拟数据：

发送命令：#0184\r

接收命令：#11,222,3333,44444,5555,666,77,8888E3\r