01脚本驱动开发工具接口函数

昆仑通态脚本驱动开发工具接口函数脚本驱动开发工具接口函数设备属性；设备通道；设备命令；全局变量；设备脚本；设备属性设备属性的定义；设备属性的添加和删除；设备属性的使用；设备属性在组态软件的应用；设备属性的定义设备属性是脚本驱动跟MCGSE组态软件之间的配置接口，组态工程通过设置设备属性来对脚本驱动进行一定的调整和设置。设备属性是脚本驱动的一个基本组成元素，其目的是用来在脚本驱动开发完成之后，在MCGSE组态环境中对脚本驱动组态时候可以修改一些与现场、环境相关的设备参数值，使脚本驱动能够适应不同的环境。设备属性添加和删除执行菜单命令驱动编辑︱添加属性，系统会显示添加设备属性对话框要添加的属性名称属性类型：整型、浮点型属性值的有效范围属性值的默认值设备属性添加和删除选中设备窗口中的设备根节点，展开下面的设备属性节点选中要删除的属性执行菜单命令驱动编辑︱删除当前节点，系统会显示删除确认对话框设备属性的使用设备属性可以在脚本驱动的所有脚本中全局使用。设备属性表示了用户对脚本驱动所进行的一些参数设置和调整。在设备脚本中必须读取这些参数，以按照用户需要的方式控制脚本驱动的工作方式。设备属性在组态软件的应用脚本驱动中的设备属性在MCGSE组态软件中看起来是下图的样子：设备通道设备通道定义；设备通道添加和删除；操作设备通道；设备通道输出时间间隔；设备通道在组态中的应用；设备通道定义设备通道是脚本驱动跟实时数据对象之间的接口，它用于实现脚本驱动中的数据输出功能。在组态环境和运行环境下，脚本驱动通过设备通道向工程中的实时数据对象定时上报采集到的数据；设备通道的添加和删除添加一个新的设备通道：执行菜单命令驱动编辑︱添加通道，系统会显示添加设备通道对话框输入通道名称通道类型增加连续通道个数设备通道的添加和删除删除一个设备通道：选中设备窗口中的脚本驱动根节点，展开设备通道节点选中要删除的设备通道执行菜单命令驱动编辑︱删除当前节点，系统会显示删除确认对话框操作设备通道通道标识，系统用通道名称和通道编号两种方式来唯一标识一个通道。通道的编号是从１开始的，每一个通道的编号顺序与在设备窗口下的设备通道列表中的排列显示顺序是一致的；通道接口函数，通道操作函数分为写通道、读通道、通道辅助功能三类函数；通道接口函数通道辅助功能GetCurrentChannelNum，得到当前触发单通道写的通道；GetChannelCount，得到驱动通道总数；读通道GetIntChannelValueByName，GetSingleChannelValueByNameGetIntChannelValueByNumGetSingleChannelValueByNum写通道SetIntChannelValueByNameSetSingleChannelValueByNameSetIntChannelValueByNumSetSingleChannelValueByNum设备通道输出时间间隔最小采集周期，用户在可以在组态软件中设置脚本驱动的最小采集周期；采集脚本的执行时间，用户编写的采集脚本在运行过程中也会耗费一定的时间。所耗费的时间长短随脚本的不同而变化。采集脚本是决定脚本驱执行效率最关键的一个因素。高质量的采集脚本执行效率高且执行时间也短。设备通道在组态中的应用设备通道输出的数据仅能被实时数据对象接收和保存。在组态软件中的关联方法为打开设备属性设置对话框，选中通道连接选项卡，选中要设置的通道行，在第一列中输入要关联的实时数据对象。如图所示：设备命令设备命令的定义；设备命令的添加和删除；设备命令的使用；设备命令的定义在组态工程中可以通过向脚本驱动发送设备命令来控制脚本驱动的工作。组态工程的运行过程中，只能通过设备命令来对其进行控制，设备命令是对脚本驱动唯一的动态控制方法。设备命令只能在组态工程的脚本中调用，而不能在脚本驱动内部的设备脚本中调用。如果需要在组态工程的运行过程中动态的控制脚本驱动的工作方式，则需要在脚本驱动中添加适当的设备命令，然后在组态工程中需要的地方调用设备命令以控制脚本驱动的工作方式。对于在组态工程运行前就可以确定并且在运行过程中不需要再改变(或者在运行过程中禁止改变)的工作方式，则可以使用设备属性来实现工作方式的控制。设备命令的添加和删除添加一个设备命令到脚本驱动中。执行菜单命令驱动编辑︱添加命令，系统会显示添加设备命令对话框设备命令的名称传入参数的名称传入参数类型设备命令的添加和删除删除指定的设备命令。选中设备窗口中的脚本驱动根节点，展开设备命令节点选中要删除的设备命令执行菜单命令驱动编辑︱删除当前节点，系统会显示删除确认对话框设备命令的使用在组态环境下，脚本驱动的设备命令会在对象帮助窗口中显示。如在脚本驱动中添加如下的设备命令，则在组态环境下的对象帮助窗口中，展开该脚本驱动设备的方法，则可以看到设备命令。其中，左图为脚本驱动开发环境，右图为组态环境在组态环境中，双击对象帮助窗口中“方法”下面的设备命令，即可把设备命令添加到脚本中。注意：上述使用设备命令的方式仅适用于脚本驱动而不能用于普通的DLL驱动。全局变量全局变量的定义；全局变量的添加和删除；全局变量的使用全局变量的定义全局变量用于保存数据，它在所有的脚本中都可使用，并且在整个脚本驱动的运行期内都可见，它主要用于：可以在不同的脚本之间共享信息；在脚本驱动运行时期内可以持续地保存的数据，尤其是保存一些脚本驱动运行时的状态信息；全局变量的添加和删除执行菜单命令驱动编辑|添加全局变量，系统会显示添加全局变量对话框：输入全局变量的名称选择全局变量的类型是否设置为数组全局变量的添加和删除选中要删除的全局变量，执行菜单命令驱动编辑|删除当前结点，系统会显示删除确认画面：全局变量的使用建议在使用全局变量之前执行必要的初始化操作，以保证脚本驱动内的所有全局变量的初始状态是预期的状态。全局变量的初始化应在初始化脚本中完成。系统保证在运行环境下最先调用初始化脚本；在脚本中引用全局变量跟使用局部变量的方法相同；设备脚本初始化脚本：MCGSE组态软件运行环境调用该脚本执行脚本驱动的初始化操作。脚本名称为“InitDevice”；采集脚本：采集脚本会在每一个采集周期到达之后，被MCGSE组态软件运行环境所调用。该脚本实现了从设备采集数据并向组态工程上报采集、处理后的数据。它的脚本名称为“CollectData”。单通道写脚本：在组态软件的运行环境下，当与通道关联的实时数据对象的值被组态工程的用户手动修改后，运行环境会调用单通道写脚本。用于接收用户的输入并向设备发送控制命令。它的脚本名称为“SingleChanWrite”。退出脚本：主要用于在运行环境退出时，执行一些与设备相关的清理操作。该脚本是脚本驱动中最后一个被运行环境调用的脚本。目前仅少数设备需要释放资源、保存数据和状态。对于多数设备，因为不需要这些清理操作，可以不编写该脚本。它的脚本名称为“ExitDevice”。结束谢谢大家!