2022年MCGS脚本驱动开发工具使用指导手册 .pdf
《2022年MCGS脚本驱动开发工具使用指导手册 .pdf》由会员分享,可在线阅读,更多相关《2022年MCGS脚本驱动开发工具使用指导手册 .pdf(45页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、北京昆仑通态自动化软件科技有限公司- 1 - 脚本驱动 V2.0 使用指导手册版本号: 0.1 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 2 - 目录错误!未找到图形项目表。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页,共 45 页 - - - - - - - -
2、 - 北京昆仑通态自动化软件科技有限公司- 3 - 第一章新脚本驱动说明一脚本驱动适用范围1.脚本驱动适用的版本A. MCGS 嵌入式组态软件;版本号: 6.5(01.0010)注:此版本以上为新版本,以下为旧版本B. MCGS 通用版的定制版组态软件C. MCGS 网络版的定制版组态软件2.脚本驱动适用的设备A. 独立板卡设备B. 串口通信设备3.脚本驱动适用的协议二脚本驱动兼容性1.旧版本脚本驱动兼容新版本组态软件2.新版本脚本驱动不兼容旧版本的组态软件,旧版本组态软件无法识别新版本脚本驱动三脚本驱动新增内容1. 脚本驱动新增功能新增加生成向导功能,具体参照第三章内容。2. 脚本驱动新增函
3、数(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, Fl
4、ag) 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.!SvrS
5、trModbusCRC(ByRef ByteArr, start, length) 6.!SvrStrModbusLRC(str, start, length) 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 4 - 7.!OpenLog() 8.!CloseLog() (3)字节数组操作函数1.!HStr2HByre(str, arByte) 2.!HByte2HStr(arByte,
6、str) 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 5 - 第二章基础概念讲解一通讯协议1.ACSII 码通讯协议(字符型协议)通讯信息按照ASCII 码方式解析得到的参数信息称为ASCII 码通讯。 比如:主站接收到从站发送的 4 个字符: 0 x31 0 x34 0 x2E 0 x36 ,用 ASCII 码表示为 14.6。2.HEX 通讯协议(字节数组协议)通讯信息按照十六进制
7、方式解析得到的参数信息称为十六进制通讯。比如:主站接收到从站发送的 4 个字符: 0 x31 0 x34 0 x2E 0 x36 ,用 HEX 表示为 0 x31342E36 3.ASCII 码通讯与HEX 通讯的区别1)ASCII码通讯传送的字符能清楚的了解发送命令和接收信息,但是传送的信息速度量少;十六进制通讯发送的字符信息速度量大,但是发送命令和接收信息不明了。2)ASCII 码的通讯帧1 个字占 4 个字符, 而 HEX 的通讯帧 1 个字占 2 个字符。 如:发送 0 x1427信息,ASCII 码发送 4 个字符:0 x31 0 x34 0 x32 0 x37 , 而 HEX 只需
8、要发送 2 个字符:0 x14 0 x27。二名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 6 - 第三章向导使用说明一完全适用向导的协议1. ASCII 码协议,多条命令通讯示例1.1 步骤 1:协议分析通讯命令 1:模仿 ADAM4018 协议,协议格式如下:发送命令: #xxr 帧头:长 1 个字符,固定为 # 地址:固定长2 个字符帧尾:长 1 个字符,为回车接收命令: #+xx
9、x.xx+xxx.xx+xxx.xx+xxx.xx+xxx.xx+xxx.xx+xxx.xx+xxx.xxr 帧头:长 1 个字符,固定为 # 数据体:共8 个数据体,每个数据体固定长7 个字符,按ASCII 码方式解析帧尾:长 1 个字符,为回车模拟数据:发送命令 1:#01r 接收命令 1:#+11.111+22.222+33.333+44.444+55.555+66.666+77.777+88.888r 通讯命令2:自己定义,解析数据非等长通讯协议,分两种情况:数据长度已知;数据长度未知。下面以数据长度未知,数据之间用分隔符分离的协议,协议格式如下:发送命令: #xxxxxxr 帧头:长
10、 1 个字符,固定为 #,参与校验地址:固定长2 个字符,参与校验校验:长 2 个字符,累加和校验结束符号:长1 个字符,固定为回车接收命令: #xxAA,BBB,CCCC,DDDDD,EEEE,FFF,GG,HHHHxxr 帧头:长 1 个字符,固定为 # 数据体: 8 个数据体,以“, ”分隔校验:长 2 个字符,累加和校验结束符号:长1 个字符,固定为回车模拟数据:发送命令: #0184r 接收命令: #11,222,3333,44444,5555,666,77,8888E3r 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - -
11、- 名师精心整理 - - - - - - - 第 6 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 7 - 1.2 步骤 2:新建工程进入向导新建工程后进入新建工程模式,如图3-1-1-1 所示。图 3-1-1-1 1.选择“使用向导新建工程” ,则进入向导界面,如图3-1-1-2 所示。2.选择“不使用向导新建工程”,流程和原来一样,直接生成示例脚本。图 3-1-1-2 设置脚本驱动的名称和注释内容整个脚本配置分为 4 个步骤,前一个步骤不执行,不允执行下个步骤名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - -
12、- - - - - - - 名师精心整理 - - - - - - - 第 7 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 8 - 1.3 步骤 3:配置驱动属性图 3-1-1-3 1. 添加属性,添加除“设备地址”和“通讯延时”以外的属性,当所添加属性的数据类型选择枚举型时,属性范围处填写枚举量,并用“;”隔开,如图3-1-1-4 所示。2. 删除属性,对多余的属性进行删除,其中“设备地址”和“通讯延时”为默认属性,不允许删除。3. 设置属性,修改设置已添加的属性。图 3-1-1-4 名师资料总结 - - -精品资料欢迎下载 - - - - -
13、- - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 8 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 9 - 1.4 步骤 4:配置通道图 3-1-1-5 1. 添加通道,可进行批量添加操作。2. 删除通道,对多余的通道进行删除,可批量删除(按住Ctrl 键,选择要删除的通道,点击“删除通道”按钮即可) ,其中“通讯状态”为默认通道,不允许删除。3. 设置通道,修改设置已添加的通道,设置通道中不能修改通道个数。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - -
14、- - - - - 名师精心整理 - - - - - - - 第 9 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 10 - 1.5 步骤 5:配置通讯帧图 3-1-1-6 5.1 添加收发通讯帧根据协议分析知,2 组通讯帧结构信息配置分别如图3-1-1-7,图 3-1-1-8 所示。图 3-1-1-7 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 10 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有
15、限公司- 11 - 图 3-1-1-8 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 11 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 12 - 5.2 设置收发通讯帧图 3-1-1-9 对于 ASCII 码通讯帧的数据体设置主要有以下几种情况:1. 无特别属性,数据内容为可见ASCII 字符,如图图3-1-1-10 所示。图 3-1-1-10 1.进入设置数据属性画面,设置每个数值的属性2.设置过的选项,将显示设置内容和相应的属性3
16、.命令预浏功能,直观的查看收发命令的格式数据类型: ASCII 字符数据数据长度: 1 字符数据内容: # 数据属性:无当 此 数 据 体 参 与 校 验时,需要选择。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 12 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 13 - 2. 无特别属性,数据内容为不可见ASCII 字符,如图图3-1-1-11 所示。图 3-1-1-11 3.数值不确定的数据体,配置“设备属性”中的某个属性获得其值
17、,如图图3-1-1-12 所示。图 3-1-1-12 数据类型:字节数据HEX 格式 数据长度: 1 字节,用 2 个字符表示数据内容: 0D,注意一定以HEX 格式填写,无空格数据属性:无注释:提供 ASCII 表,可以方便的直接选择不可见的ASCII 字符数据类型: ASCII 字符数据数据长度: 2 字符数据内容:无数据属性:设备属性中的设备地址对于相同的数据体,设置好一个后,其他可选择默认设置,设置与前一个相同的参数名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 13 页,共
18、 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 14 - 4. 数据解析1)可知长度的解析,如图3-1-1-13 所示。图 3-1-1-13 2)未知长度的解析,如图3-1-1-14 所示。图 3-1-1-14 数据类型: ASCII 字符数据数据长度: 1 字符,此处数据长度为“解析数据间分隔符号”的长度数据内容:无数据属性:解析数据中的ASCII 码数据 未知长度 ,解析数据间分隔符号是“,” 。数据类型: ASCII 字符数据数据长度: 7 字符数据内容:无数据属性:解析数据中的ASCII码数据 可知长度 名师资料总结 - - -精品资料欢迎下载 -
19、 - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 14 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 15 - 5. 校验,如果命令中的数据都是确定的,那么可以直接计算出校验值,如图3-1-1-15 所示。图 3-1-1-15 6. 预览功能,命令信息设置完之后,可点击“命令预览”查看命令格式,如图3-1-1-16 所示。图 3-1-1-16 7. 对于各属性同前一个的数据体,点击“默认设置”即可。1.此处需校验的数据是选择了“是否参与校验” 的数据体。2.可选框无效,如:即使不选择
20、“帧头”,它也参与校验。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 15 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 16 - 1.6 步骤 6:配置预览在此预览通道和解析数据的匹配关系,并检查配置是否正确,如果正确就可以,完成配置生成驱动,否则不完成配置生成代码。图 3-1-1-17 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - -
21、- - 第 16 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 17 - 1.7 步骤 7:完成配置,进行调试1.代码的生成与编译。(1)配置都正确后,可以“完成配置”直接生成脚本代码,如图3-1-1-18 所示。图 3-1-1-18 (2)编译生成的代码。选择“调试”“检查整个驱动”,若没有问题输出窗口会提示“设备编辑检查通过” ,如图 3-1-1-19 所示。图 3-1-1-19 2. 配置“串口参数” 。(1)创建虚拟串口,如图3-1-1-20 所示,串口COM2 和 COM3 虚拟串口。组建命令帧发 送 命 令 帧 并 接收数据,对接收数据
22、进行校验对接收的数据进行解析,并设置通道值名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 17 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 18 - 图 3-1-1-20 (2)配置脚本驱动中的串口参数选择“设置”“串口父设备配置”,配置串口参数,如图3-1-1-21 所示。图 3-1-1-21 (3)设置串口转发工具SmartCom.exe。首先,设置串口,如图3-1-1-22 所示。图 3-1-1-22 1.除串口号外,其他需要与脚
23、本驱动中串口参数一致2.数据格式选择ASCII 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 18 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 19 - 其次,设置模拟设备, 串口设置完后, 打开串口, 选择“使能”,添加收发帧, 如图 3-1-1-23所示。图 3-1-1-23 然后,将 2 组命令帧的模拟数据分别添加进去,选择启动,如图3-1-1-24 所示。图 3-1-1-25 3. 进行调试。在脚本驱动中,选择“调试”“定时通
24、道采集”进行调试,如图3-1-1-26 所示。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 19 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 20 - 图 3-1-1-26 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 20 页,共 45 页 - - - - - - - - - 北京昆仑通态自动化软件科技有限公司- 21
25、- 2. HEX 码协议,单条命令通讯示例2.1 步骤 1:协议分析通讯命令:模仿ModbusRTU 协议,协议格式如下:发送命令:从 4 区寄存器地址0 开始,连续读8 个 16 位无符号二进制地址:长 1BYTE ,内容从属性“设备地址”中获得命令码:长 1BYTE ,固定为 0 x03 起始地址:长2BYTE ,固定为 0 x0000 连续元件个数:长2BYTE ,固定为 0 x0008 校验:长 2BYTE ,CRC 校验接收命令:地址 :长 1BYTE ,内容不重要命令码长 1BYTE ,内容预计为0 x03 回收字节长度:长1BYTE ,内容预计为0 x10 数据体 00:长 2B
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 2022年MCGS脚本驱动开发工具使用指导手册 2022 MCGS 脚本 驱动 开发 工具 使用 指导 手册
限制150内