组态王软件驱动程序开发

组态王驱动开发包

用户手册

北京亚控科技发展有限公司

1. 版权

本开发包版权属于北京亚控科技发展有限公司，任何组织、团体、个人，未经亚控公司允许，不得擅自拷贝，使用，对于购买本开发包的组织、团体、个人，只能内部使用，不得擅自泄漏给第三方。

2. 概述

本开发包采用微软标准的COM组件技术，采用该技术，在创建接口时，可以创建多个互相独立对象，每个对象都可以拥有自己的变量。

最后的结果是一个DLL文件。接口中的各函数，是被组态王的两个应用程序---TouchExplorer.exe和TouchVew.exe调用的。如果这两个应用程序都不启动，函数中的代码将永远没有机会执行。

组态王的驱动程序是组态王和硬件设备连接的桥梁，本开发包用于开发组态王的驱动程序。只要拥有硬件的通讯协议，即可以使用本开发包开发组态王的驱动程序。

本开发包只能使用VC++开发。

3. 开发包3.0修订目的

a)通用版和嵌入版统一到一套代码中，通用版和嵌入版实现同步更新。

b)生成设备类，为多设备型号驱动提供解决方法。

c)详尽、稳健的基类代码。

d)完善的功能与向导。

e)规范各类帮助函数。

f)规范编码格式、统一使用英文版。

g)修改部分功能的实现方法。

4. 开发包使用

我们提供一个开发向导工具“DriverToolKit3.0.0.0.exe”，使用这个工具，能够自动地生成驱动代码框架。

运行工具，如下图：

请在下页输入您的目标文件夹

点击“安装”，开发包即安装完成。

使用开发包向导创建驱动的过程：

（1）启动Visual 2003。

（2）新建一个工程，“项目类型”选择“Visual C++项目”，“模板”选择“KingView Wizard”，在下面的编辑框中输入工程的名字以及存储路径，点击“确定”。（3）这个创建向导分3页，第一页是“概述”，显示的是默认的设置信息，如果您不需要改变这些，直接点击“确定”即可成功的创建驱动框架。

（4）第二页是“驱动类型和编译选项”，包含如下部分：

驱动类型:

o串口驱动(适用于查询式设备)

这个类型，是我们一般常用的，适合于普通的上位查询，设备应答的通讯类

型。

o串口驱动(适用于实时上发数据的设备，非重叠IO)

这种方式，适用于下位设备实时上发数据的情况，驱动中需要创建一个线程

来监视串口事件的通讯类型，采用非重叠IO方式。

o串口驱动(适用于实时上发数据的设备，重叠IO，WinCE不支持)

这种方式，同上一种，也是适用于下位设备实时上发数据的情况，驱动中需

要创建一个线程来监视串口的通讯类型。与前一种不同的是：采用了重叠

IO方式。我们不推荐使用这种方式，因为WINCE系统不支持这种方式，使

用这种方式开发的驱动，将不能在WINCE系统的嵌入式设备中运行。

o以太网驱动(TCP服务器端)

这是针对于TCP方式通讯的驱动，适用于设备为客户端，组态王为Server，

组态王查询，设备应答的通讯类型。如果遇到设备主动实时上发数据的情况，

驱动中提供了相应的函数，可以直接调用函数，启动线程来监听网络事

件。

o以太网驱动(TCP客户端)

这是TCP方式通讯客户端的驱动，适用于组态王查询、设备应答的通讯类型。

这种方式需要驱动主动去连接设备。如果遇到设备主动实时上发数据的情

况，驱动中提供了相应的函数，可以直接调用函数，启动线程来监听网络事

件。

o以太网驱动(UDP服务器端)

目前还没有实现，参考TCP方式，代码中需要改动的地方有标注。

o以太网驱动(UDP客户端)

目前还没有实现，参考TCP方式，代码中需要改动的地方有标注。

设备名称:

默认的设备名称是“Name1”，可以自由填写，但须注意应该与设备列表中的设备名称保持一致。

尝试连接类型:

当组态王与设备通讯失败了，组态王会周期性的尝试与设备通讯，这个过程，我们称之为“尝试连接”。

尝试连接，目前准备了如下几种类型：

o永远为True,常用于板卡驱动。

o程序员自由定义，常用于网络通讯或实时上发数据的设备。

o使用“PACKET”进行通讯，适用于普通的驱动。

（5）第三页是“驱动基本信息”，包含如下条目：

驱动基本信息

o驱动名称

o版本

o描述

o程序员

o项目经理

这些信息将被自动保存到历史文件（History.txt）中，同时也是保存在工程的ReadMe文件中，可以随工程浏览。

其他支持:

o USB 通讯

o ADO 数据库操作

（6）点击“确定”后，将完成驱动工程的创建工作。

5. 工程转换工具

我们要求通用版和嵌入版使用同一套代码，做到通用版和嵌入版驱动实现同步更新，这就需要一个工具来将通用版工程文件转换为嵌入版工程文件。

同时，考虑到有的开发者习惯使用Visual Studio 98进行开发编译，我们也要有一个工具来将Visual Studio 2003的工程文件转换成Visual Studio 98的工程文件。

我们提供一个转换工具kvdriver（包含3个文件，kvdriver.exe, vc7tovc6.exe,vc7toevc.exe）,使用这个工具，可以根据Visual Studio 2003的工程文件，创建成Visual Studio 98和EVC的工程文件，开发者可以在不同的开发环境间自由选择。

驱动开发包安装完成后，这个工具存放在目录KingViewDriver下。

在使用的时候，可以把这个工具放在系统文件夹C:\WINDOWS\system32中，这样可以在命令行中输入“kvdriver”，然后把需要转换的Visual Studio 2003工程文件拖动过来运行即可，如下所示：