MCGS脚本驱动开发工具使用指导手册

第二章 基础概念讲解
一． 通讯协议
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

脚本驱动开发工具2.0
如何起步欢迎使用MCGS脚本驱动开发工具　通过阅读起步、脚本驱动的基本概念两章的帮助内容，你可以快速了解MCGS脚本驱动开发工具的目的、功能和范围。若你已经按照制作一个样例驱动中的第一节准备中所要求的条件做好了学习的准备，你便可以开始阅读制作一个样例驱动中的后续内容，通过阅读该章中的内容，你可以基本了解制作脚本驱动的过程。
本帮助文档的结构
MCGS脚本驱动开发工具共包括13章的内容。它们分为3个部分：入门、使用说明、参考。
入门部分的内容用于帮助用户快速地了解脚本驱动的功能和用途，以及快速入门。它包括：起步、脚本驱动的基本概念、制作一个样例驱动、脚本驱动开发工具界面说明。
使用说明部分主要阐述了脚本驱动开发工具的使用方法，它包括以下章节：管理脚本驱动、设备属性、设备通道、设备命令、自定义子函数、全局变量、为驱动添加帮助、编写脚本、对脚本进行语法检查、调试脚本、发布和使用。
参考部分主要罗列了脚本语法的规则和系统提供的标准函数，参考一章描述了以上的内容。
术语表　术语解释
MCGSMonitor and Control Generated System通用监控系统根据上下文环境可能代表北京昆仑通态自动化软件科技有限公司或者通用监控系统这个产品
MCGSEMonitor and Control Generated System for Embeded嵌入版通用监控系统MCGSWMonitor and Control Generated System for Internet网络版通用监控系统脚本驱动MCGS组态软件利用自身的脚本功能实现的驱动程序脚本驱动开发工具
MCGSE产品包中为开发脚本驱动程序提供的专用开发工具。
MDRMCGS DriverMCGS 脚本驱动
DLLDynamic Link Library动态链接库，它是一种程序库，供用户在程序中进行动态调用，即不用在编译时编入EXE文件系统根据上下文环境有可能代表脚本驱动开发工具或者
MCGSE组态环境
版本信息
MCGS脚本驱动开发工具2.0版
MCGS脚本驱动开发工具为MCGS组态软件的配套产品进行发售。
图3-1-1-2
1.2 步骤3：配置驱动属性
图3-1-1-3
1. 添加属性，添加除“设备地址”和“通讯延时”以外的属性，当所添加属性的数据类型选择枚举型时，属性范围处填写枚举量，并用“;”隔开，如图3-1-1-4所示。
2. 删除属性，对多余的属性进行删除，其中“设备地址”和“通讯延时”为默认属性，不允许删除。
3. 设置属性，修改设置已添加的属性。
图3-1-1-4

脚本驱动 的概念
什么是脚本驱动
脚本驱动是一种使用MCGS脚本语言编写的设备驱动程序。
昆仑通态推出脚本驱动的目的，是给用户提供一种与传统MCGS组态软件中驱动程序功能兼容的、编程简便的设备驱动开发方法。
使用MCGS提供的脚本驱动开发工具，能够让您迅速的开发出脚本驱动程序。相对于VC、VB驱动程序的开发，脚本驱动的开发更简单、更容易 。脚本驱动屏蔽了设备驱动开发的技术细节，采用与MCGS脚本语言兼容的编程语言，封装了大量标准功能，并提供必要的容错处理。您不需要使用VC、VB等 其它开发语言，不需要理解动态连接库、COM接口等复杂的计算机技术。您只需要做一些简单的设置，编写一些简单的脚本，就可以完成一个设备驱动。您可以把主要精力集中到具体设备及其设备通信规约上，从而提高驱动开发效率和驱动质量。
脚本驱动适用范围
脚本驱动适用的人员：
昆仑通态的设备驱动开发人员；
昆仑通态的技术支持人员；
昆仑通态的销售人员；
需要自己编写设备驱动的MCGS用户。
脚本驱动适用的版本：
MCGS嵌入式组态软件； 版本号：6.8（01.0001）
MCGS通用版组态软件，版本号：6.8（01.0001）。6.8（01.0001）以下版本提供相应的定制版本
MCGS网络版组态软件；版本号：6.8（01.0001）。6.8（01.0001）以下版本提供相应的定制版本
脚本驱动适用的设备：
独立板卡设备
串口通信设备
和MCGS组态软件的集成
传统的MCGS设备驱动是以DLL形式存在的，为了支持用户自定义驱动，昆仑通态定义了MDR文件格式，该文件由脚本驱动开发工具生成，它用于保存用户在脚本驱动开发工具中对设备驱动所作的各种功能定义。因此脚本驱动开发工具所开发出来的驱动只能在篏入式６.8(01.0001)（含）以上、通用版的定制版和网络版的定制版中应用。
昆仑通态为此发行了MCGS脚本工具2.0版，安装该版的MCGS组态软件后，你的电脑上就已经有了脚本驱动开发工具了。
脚本驱动开发工具的功能
脚本驱动开发工具是开发MCGS脚本驱动程序的专用工具，它提供以下功能：
使用图形化方式设置设备基本属性、设备属性和设备通道，使用户能够简单、快速地开发MCGS设备驱动程序；用户还可以通过图形化方式编辑设备命令参数以及编写命令脚本，可以轻松实现脚本驱动的设备命令。
系统把驱动程序的结构简化为4个主要脚本：初始化脚本、采集脚本、单通道写脚本和退出脚本，并且提供分类清晰的标准函数。
运用工具的自定义子函数和函数库功能，能够实现代码重用、积累，随着使用时间的推移和功能函数库的反复重用和调整可以不断地提高脚本驱动开发的效率、质量；使用户在开发行业应用中具有更大地优势。
脚本编辑器提供语法着色功能（关键字高亮显示、注释着色），编辑器风格为类VB编辑器的风格。
脚本工具为不同的用户设定了不同的界面，简单用户界面和高级用户界面；简单用户界面，界面简洁，具有必备功能。高级用户界面，功能齐全。简单用户界面和高级用户界面可以任意切换。
此外，工具还提供脚本驱动的脚本调试功能，这样可以脱离MCGS软件而独立调试脚本驱动。在调试过程中，开发人员可以设置断点，进行脚本驱动的单步跟踪调试，并且能对自定义函数进行进入和退出的跟踪，跟踪自定义函数的执行，提供对驱动脚本的精确设计功能，能够快速的定位和排除脚本驱动中的错误，提高开发的效率和质量。