软件产品帮助文档

Transcription

1 北京阿尔泰科技发展有限公司 USB2812 WIN2000/XP 驱动程序使用说明书 请您务必阅读 使用纲要, 他会使您事半功倍! 目 录 USB2812 WIN2000/XP 驱动程序使用说明书...1 第一章版权信息与命名约定...2 第一节 版权信息...2 第二节 命名约定...2 第二章使用纲要...2 第一节 如何管理 USB 设备...2 第二节 如何批量取得 AD 数据...2 第三节 哪些函数对您不是必须的...4 第三章 USB 设备专用函数接口介绍...5 第一节 设备驱动接口函数列表 ( 每个函数省略了前缀 USB2812_ )...5 第二节 设备对象管理函数原型说明...6 第三节 AD 采样操作函数原型说明...10 第四节 AD 硬件参数系统保存与读取函数原型说明...13 第五节 DA 模拟量输出操作函数原型说明...15 第六节 CNT 计数与定时器操作函数原型说明...15 第七节 DIO 数字开关量输入输出简易操作函数原型说明...17 第四章硬件参数结构...18 第五章数据格式转换与排列规则...22 第一节 AD 原始数据 LSB 转换成电压值 Volt 的换算方法...22 第二节 AD 采集函数的 ADBuffer 缓冲区中的数据排放规则...22 第三节 DA 电压值转换成 LSB 原码数据的换算方法...23 第六章上层用户函数接口应用实例...24 第一节 简易程序演示说明...24 第二节 高级程序演示说明...24 第七章基于 USB 总线的大容量连续数据采集详述...24 第八章公共接口函数介绍...26 第一节 公用接口函数总列表 ( 每个函数省略了前缀 USB2812_ )...27 第二节 线程操作函数原型说明...27 第三节 文件对象操作函数原型说明...29 第四节 各种参数保存和读取函数原型说明...33 第五节 其他函数原型说明...35 提醒用户 : 通常情况下,WINDOWS 系统在安装时自带的 DLL 库和驱动不全, 所以您不管使用那种语言编程, 请您最好先安装上 Visual C++6.0 版本的软件, 方可使我们的驱动程序有更完备的运行环境 有关设备驱动安装和产品二次发行请参考 USB2812Inst.doc 文档 1

2 USB2811 WIN2000/XP 驱动程序使用说明书版本 : 第一章版权信息与命名约定 第一节 版权信息 本软件产品及相关套件均属北京市阿尔泰科贸有限公司所有, 其产权受国家法律绝对保护, 除非本公司书 面允许, 其他公司 单位及个人不得非法使用和拷贝, 否则将受到国家法律的严厉制裁 您若需要我公司产品 及相关信息请及时与我们联系, 我们将热情接待 第二节 命名约定 一 为简化文字内容, 突出重点, 本文中提到的函数名通常为基本功能名部分, 其前缀设备名如 USBxxxx_ 则被省略 如 USB2815_CreateDevice 则写为 CreateDevice 二 函数名及参数中各种关键字缩写规则 缩写 全称 汉语意思 缩写 全称 汉语意思 Dev Device 设备 DI Digital Input 数字量输入 Pro Program 程序 DO Digital Output 数字量输出 Int Interrupt 中断 CNT Counter 计数器 Dma Direct Memory 直接内存存取 DA Digital convert 数模转换 Access to Analog AD Analog convert to Digital 模数转换 DI Differential ( 双端或差分 ) 注 : 在常量选项中 Npt Not Empty 非空 SE Single end 单端 Para Parameter 参数 DIR Direction 方向 SRC Source 源 ATR Analog Trigger 模拟量触发 TRIG Trigger 触发 DTR Digital Trigger 数字量触发 CLK Clock 时钟 Cur Current 当前的 GND Ground 地 OPT Operate 操作 Lgc Logical 逻辑的 ID Identifier 标识 Phys Physical 物理的 以上规则不局限于该产品 第二章使用纲要 第一节 如何管理 USB 设备由于我们的驱动程序采用面向对象编程, 所以要使用设备的一切功能, 则必须首先用 CreateDevice 函数创建一个设备对象句柄 hdevice, 有了这个句柄, 您就拥有了对该设备的控制权 然后将此句柄作为参数传递给其他函数, 如 InitDeviceAD 可以使用 hdevice 句柄以初始化设备的 AD 部件并启动 AD 设备,ReadDeviceAD 函数可以用 hdevice 句柄实现对 AD 数据的采样批量读取,SetDeviceDO 函数可用实现开关量的输出等 最后可以通过 ReleaseDevice 将 hdevice 释放掉 第二节 如何批量取得 AD 数据 当您有了 hdevice 设备对象句柄后, 便可用 InitDeviceAD 函数初始化 AD 部件, 关于采样通道 频率等的参数的设置是由这个函数的 padpara 参数结构体决定的 您只需要对这个 padpara 参数结构体的各个成员简单赋 2

3 北京阿尔泰科技发展有限公司值即可实现所有硬件参数和设备状态的初始化, 然后这个函数启动 AD 设备 接着便可用 ReadDeviceAD 反复读取 AD 数据以实现连续不间断采样当您需要关闭 AD 设备时,ReleaseDeviceAD 便可帮您实现 ( 但设备对象 hdevice 依然存在 ) ( 注 :ReadDeviceAD 虽然主要面对批量读取, 高速连续采集而设计, 但亦可用它以少量点如 32 个点读取 AD 数据, 以满足慢速采集需要 ) 具体执行流程请看下面的图 注意 : 图中较粗的虚线表示对称关系 如红色虚线表示 CreateDevice 和 ReleaseDevice 两个函数的关系是 : 最初执行一次 CreateDevice, 在结束是就须执行一次 ReleaseDevice 绿色虚线 InitDeviceAD 与 ReleaseDeviceAD 成对称方式出现 3

4 USB2811 WIN2000/XP 驱动程序使用说明书版本 : 开始 创建设备对象 CreateDevice() 重新初始化 AD 初始化和启动 AD InitDeviceAD() 读取 AD 数据 ReadDeviceAD () 接着上次再读 AD 数据 用户对采集到的 AD 数据进行处理其代码应由用户根据需要编写 需要再紧接着读取 AD 数据以实现连续采集吗? 是 否 释放和停止 AD 设备 ReleaseDeviceAD() 需要改变通道或频率后再采集吗? 释放设备对象 ReleaseDevice() 不需要 结束 图 AD 采集实现过程第三节 哪些函数对您不是必须的当公共函数如 CreateFileObject,WriteFile,ReadFile 等一般来说都是辅助性函数, 除非您要使用存盘功能 它们只是对我公司驱动程序的一种功能补充, 对用户额外提供的 4

5 北京阿尔泰科技发展有限公司 第三章 USB 设备专用函数接口介绍 第一节 设备驱动接口函数列表 ( 每个函数省略了前缀 USB2812_ ) 本章函数是设备使用 USB 方式传输时所使用的 函数名函数功能备注 1 设备对象操作函数 CreateDevice 创建 USB 对象 ( 用设备逻辑号 ) CreateDeviceEx 创建 USB 对象 ( 用设备物理号 ) 上层及底层用户 GetDeviceCount GetDeviceCurrentID 取得设备总数 取得设备当前 ID 号 ListDeviceDlg 列表所有同一种 USB 各种配置上层及底层用户 ResetDevice ReleaseDevice 2 AD 采样操作函数 InitDeviceAD ReadDeviceAD ReleaseDeviceAD 复位 USB 设备 关闭设备, 且释放 USB 总线设备对象 初始化 USB 设备 AD 部件, 准备传数 连续批量读取 USB 设备上的 AD 数据 释放 USB 设备对象中的 AD 部件 3 辅助函数 ( 硬件参数设置 保存 读取函数 ) LoadParaAD SaveParaAD 从 Windows 系统中读取硬件参数 往 Windows 系统保存硬件参数 ResetParaAD 将注册表中的 AD 参数恢复至出厂默认值上层用户 4 DA 输出操作函数 WriteDeviceDA 5 计数器操作函数 SetDeviceCNT GetDeviceCNT 6 开关量函数 GetDeviceDI SetDeviceDO 使用需知 Visual C++ & C++Builder: 输出模拟信号到指定通道 设置计数器的初值 取得各路计数器的当前计数值 开关输入函数 开关输出函数 首先将 USB2812.h 和 USB2812.lib 两个驱动库文件从相应的演示程序文件夹下复制到您的源程序文件 夹中, 然后在您的源程序头部添加如下语句, 以便将驱动库函数接口的原型定义信息和驱动接口导入库 (USB2812.lib) 加入到您的工程中 #include USB2812.H 在 VC 中, 为了使用方便, 避免重复定义和包含, 您最好将以上语句放在 StdAfx.h 文件 一旦完成了 以上工作, 那么使用设备的驱动程序接口就跟使用 VC/C++Builder 自身的各种函数, 其方法一样简单, 毫 无二别 关于 USB2812.h 和 USB2812.lib 两个文件均可在演示程序文件夹下面找到 5

6 USB2811 WIN2000/XP 驱动程序使用说明书版本 : 首先将 USB2812.Bas 驱动模块头文件从 VB 的演示程序文件夹下复制到您的源程序文件夹中, 然后将此模块文件加入到您的 VB 工程中 其方法是选择 VB 编程环境中的工程 (Project) 菜单, 执行其中的 " 添加模块 "(Add Module) 命令, 在弹出的对话中选择 USB2812.Bas 模块文件即可, 一旦完成以上工作后, 那么使用设备的驱动程序接口就跟使用 VB 自身的各种函数, 其方法一样简单, 毫无二别 请注意, 因考虑 Visual C++ 和 Visual Basic 两种语言的兼容问题, 在下列函数说明和示范程序中, 所举的 Visual Basic 程序均是需要编译后在独立环境中运行 所以用户若在解释环境中运行这些代码, 我们不保证能完全顺利运行 首先将 USB2812.Pas 驱动模块头文件从 Delphi 的演示程序文件夹下复制到您的源程序文件夹中, 然 后将此模块文件加入到您的 Delphi 工程中 其方法是选择 Delphi 编程环境中的 View 菜单, 执行其中的 "Project Manager" 命令, 在弹出的对话中选择 *.exe 项目, 再单击鼠标右键, 最后 Add 指令, 即可将 USB2812.Pas 单元模块文件加入到工程中 或者在 Delphi 的编程环境中的 Project 菜单中, 执行 Add To Project 命令, 然后选择 *.Pas 文件类型也能实现单元模块文件的添加 最后请在使用驱动程序接口的源程 序文件中的头部的 Uses 关键字后面的项目中加入 : USB2812 如 : uses Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs, USB2812; // 注意 : 在此加入驱动程序接口单元 USB2812 LabView / CVI: LabVIEW 是美国国家仪器公司 (National Instrument) 推出的一种基于图形开发 调试和运行程序的集成化环境, 是目前国际上唯一的编译型的图形化编程语言 在以 PC 机为基础的测量和工控软件中, LabVIEW 的市场普及率仅次于 C++/C 语言 LabVIEW 开发环境具有一系列优点, 从其流程图式的编程 不需预先编译就存在的语法检查 调试过程使用的数据探针, 到其丰富的函数功能 数值分析 信号处理和设备驱动等功能, 都令人称道 关于 LabView/CVI 的驱动程序接口的详细说明请参考其演示源程序 第二节 设备对象管理函数原型说明 创建设备对象函数函数原型 : HANDLE CreateDevice(int DeviceLgcID = 0) Declare Function CreateDevice Lib "USB2812" (Optional ByVal DeviceLgcID As Long = 0) As Long Function CreateDevice(DeviceLgcID:Integer = 0):Integer; StdCall; External 'USB2812' Name 'CreateDevice'; LabView: CreateDevice DeviceID Return Device Object 功能 : 该函数负责创建设备对象, 并返回其设备对象句柄 参数 : DeviceLgcID 设备逻辑 ID( Identifier ) 标识号 当向同一个 Windows 系统中加入若干相同类型的 USB 设备时, 系统将以该设备的 基本名称 与 DeviceLgcID 标识值为名称后缀的标识符来确认和管理该设备 比如若用户往 Windows 系统中加入第一个 USB2812 AD 模板时, 系统则以 USB2812 作为基本名称, 再以 DeviceLgcID 6

7 北京阿尔泰科技发展有限公司的初值组合成该设备的标识符 USB 来确认和管理这第一个设备, 若用户接着再添加第二个 USB2812 AD 模板时, 则系统将以 USB 来确认和管理第二个设备, 若再添加, 则以此类推 所以当用户要创建设备句柄管理和操作第一个 USB 设备时,DeviceLgcID 应置 0, 第二应置 1, 也以此类推 默认值为 0 返回值 : 如果执行成功, 则返回设备对象句柄 ; 如果没有成功, 则返回错误码 INVALID_HANDLE_VALUE 由于此函数已带容错处理, 即若出错, 它会自动弹出一个对话框告诉您出错的原因 您只需要对此函数的返回值作一个条件处理即可, 别的任何事情您都不必做 相关函数 :ReleaseDevice 创建设备对象函数 ( 扩展函数 ) 函数原型 : HANDLE CreateDeviceEx(int D Declare Function evicephysid = 0) CreateDeviceEx Lib "USB2812" (ByVal DevicePhysID As Long = 0) As Long Function CreateDeviceEx(DevicePhysID:Integer = 0):Integer; LabView: 请参考相关演示程序 StdCall; External 'USB2812' Name 'CreateDeviceEx'; 功能 : 该函数负责创建设备对象, 并返回其设备对象句柄 设备对象句柄是访问某一台设备的唯一依据 不同 DevicePhysID 创建的设备对象句柄用于访问不同的设备 只有成功创建 DevicePhysID 指定设备的句柄后, 设备对用户来讲才是可用的 因为每一个访问设备的驱动函数接口都需要 hdevice 这个设备句柄参数 参数 : DevicePhysID 设备物理 ID( Identifier ) 标识号 如果您使用单个 USB2812 设备, 该参数等于 0 即可, 且下 面的内容您不必阅读 但如果您需要多卡工作时, 此参数便大有用武之地, 请阅读下以内容 假如您所选用的产品只有 32 个 AD 通道, 而您需要 128 路信号, 那么您就需要同时使用四块卡来实现此功能 具体办法是您需要将 128 路信号依次分配到四个卡上, 如下表 : 卡号信号通道物理 ID 号逻辑 ID 号第一块 1 ~32 0 若第二个加载此卡, 则为 1, 否则为其他号第二块 33~64 1 若最先加载此卡, 则为 0, 否则为其他号第三块 65~96 2 若第四个加载此卡, 则为 3, 否则为其他号第四块 97~128 3 若第三个加载此卡, 则为 2, 否则为其他号从上表可知, 如果使用您物理 ID 号, 那么不管怎么安装您的硬件设备, 其卡的物理编址不会发生任何变化, 在软件上您用相应的物理 ID 号创建的设备对象所访问设备在物理顺序上不会发生变化, 它始终对应于您的事先分配的信号通道 而使用逻辑 ID 号则不然, 同样的逻辑 ID 值可能在不同的拔插顺序下会指向不同的物理设备而使软件的通道序列与硬件上无法一一对应 为了更好的保证物理通道序列与软件通道序列的对应关系, 请务必保证板上的物理 ID 设置不重号 否则,CreateDevice () 只能创建重号中逻辑号最小的一个设备的对象, 且具体创建的是哪一个设备也只能由用户根据采样信号特征等大概地确定 需要注意的是, 物理 ID 号的设置有限的 如果实际设备数量超过这个有限值, 那么超过的部分的物理 ID 号均设置为最大物理 ID 号, 在创建设备对象时自动按逻辑 ID 处理 比如该产品的物理 ID 最多只能管理 16 个设备 (ID 值为 0~15), 如果您要使用 18 个设备, 那么为第 个设备创建设备对象时, 其 DevicePhysID 应分别等于 返回值 : 如果执行成功, 则返回设备对象句柄 ; 如果没有成功, 则返回错误码 INVALID_HANDLE_VALUE 由于此函数已带容错处理, 即若出错, 它会自动弹出一个对话框告诉您出错的原因 您只需要对此函数的返回值作一个条件处理即可, 别的任何事情您都不必做 相关函数 :ReleaseDevice 7

8 USB2811 WIN2000/XP 驱动程序使用说明书版本 : Visual C++ & C++Builder 程序举例 : HANDLE hdevice; // 定义设备对象句柄 hdevice=createdevice(0); // 创建设备对象, 并取得设备对象句柄 if(hdevice==invalide_handle_ VALU E) // 判断设备对象句柄是否有效 { return; // 退出该函数 } : Visual Basic 程序举例 : Dim hdevice As Long ' 定义设备对象句柄 hdevice = CreateDevice(0) ' 创建设备对象, 并取得设备对象句柄, 管理第一个 USB 设备 If hdevice = INVALID_HANDLE_VALUE Then ' 判断设备对象句柄是否有效 Else Exi t Sub ' 退出该过程 End If : 取得在系统中的设备总台数函数原型 : Visual C++ & C++Builder: int GetDeviceCount (HANDLE hdevice) Declare Function GetDeviceCount Lib "USB2812" (ByVal hdevice As Long ) As Integer Function GetDeviceCount (hdevice : Integer): Integer; StdCall; External 'USB2812' Name ' GetDeviceCount '; LabView: 请参考相关演示程序 功能 : 取得在系统中物理设备的总台数 参数 :hdevice 设备对象句柄, 它应由 Crea tedevice创建 返回值 : 若成功, 则返回实际设备台数, 否则返回 0, 用户可以用 GetLastError 捕获错误码 相关函数 :CreateDevice ReleaseDevice 取得当前设备对象句柄指向的设备所在的设备 ID 函数原型 : Visual C++ & C++Builder: BOOL GetDeviceCurrentID (HANDLE hdevice, PLONG DevicePhysID, PLONG DeviceLgcID) Declare Function GetDeviceCurrentID Lib "USB2812" (ByVal hdevice As Long, _ ByRef DevicePhysID As Long, _ ByRef DeviceLgcID As Long ) As Boolean Function GetDeviceCurrentID (hdevice : Integer; DevicePhysID : PArrayLong; DeviceLgcID : PArrayLong;): Boolean; StdCall; External 'USB2812' Name ' GetDeviceCurrentID '; 8

9 北京阿尔泰科技发展有限公司 LabView: 请参考相关演示程序 功能 : 取得指定设备对象所代表的设备在设备链中的物理设备 ID 号和逻辑 ID 号 参数 : hdevice 设备对象句柄, 它应由 CreateDevice 创建 DevicePhysI D 指针参数, 取得指定设备的物理 ID 该号可以由用户设置板上 JP1 跳线器获得 当多卡工 作时, 该物理 ID 号能让用户准确的辩别每一个卡所处的编址 该编址除了用户能手动改变以外, 不会随着系 统加载卸载设备的顺序或者是用户插拔设备的顺序而改变其相应的物理编址, 它只会改变其逻辑编址, 即 DeviceLgcID 的值 比如您使用某一产品, 该产品只有 32 个 AD 通道, 而您需要 128 个通道采样, 那么您就需 要四块卡来实现此功能 在实际采样中, 您需要对将 128 路信号依次分配到四个卡上, 如下表 : 卡号 信号通道 物理 ID 号 逻辑 ID 号 第一块 1 ~32 0 若第二个加载此卡, 则为 1, 否则为其他号 第二块 33~64 1 若最先加载此卡, 则为 0, 否则为其他号 第三块 65~96 2 若第四个加载此卡, 则为 3, 否则为其他号 第四块 97~128 3 若第三个加载此卡, 则为 2, 否则为其他号 从上表可知, 如果使用您物理 ID 号, 那么不管怎么安装您的硬件设备, 那么其卡的物理编址不会发生任 何变化, 在软件上您用相应的物理 ID 号创建的设备对象所访问设备在物理上不会发生变化, 它始终对应于您 的事先分配的信号通道 而使用逻辑 ID 号则不然, 同样的逻辑 ID 值可能在不同的拔插顺序下会指向不同的物 理设备而使软件的通道序列与硬件上无法一一对应 返回值 : 若成功, 则返回由 hdevice 参数代表的设备在设备链中的设备 ID, 否则返回 -1, 用户可以用 GetLastError 捕获错误码 注意其返回的 ID 是一定与在 CreateDevice 函数中指定的 DeviceLgcID 参数值相等 相关函数 :CreateDevice ReleaseDevice 用对话框控件列表计算机系统中所有 USB2812 设备各种配置信息函数原型 : Visual C++ & C++Builder: BOOL ListDeviceDlg (void) Declare Function ListDeviceDlg Lib "USB2812" ( )As Boolean Function ListDeviceDlg ( ): Boolean; StdCall; External 'USB2812' Name ' ListDeviceDlg '; 请参考相关演示程序 功能 : 列表系统中 USB2812 的硬件配置信息 参数 : 无 返回值 : 若成功, 则弹出对话框控件列表所有 USB2812 设备的配置情况 相关函数 :CreateDevice ReleaseDevice 复位整个 USB 设备函数原型 : Visual C++ & C++Builder: BOOL ResetDevice (HANDLE hdevice) 9

10 USB2811 WIN2000/XP 驱动程序使用说明书版本 : Declare Function ResetDevice Lib "USB2812" (ByVal hdevice As Long ) As Boolean Function ResetDevice (hdevice : Integer):Boolean; StdCall; External 'USB2812' Name 'ResetDevice'; LabView: 请参考相关演示程序 功能 : 复位整个 USB 设备, 相当于它与 PC 机端重新建立 其效果与重新插上 USB 设备等同 一般在出错情况下, 想软复位来建决重连接问题, 就可以调用该函数解决此问题 参数 :hdevice 设备对象句柄, 它应由 CreateDevice 创建 由它指向要复位的设备 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 :CreateDevice ReleaseDevice 释放设备对象所占的系统资源及设备对象函数原型 : Visual C++ & C++Builder: BOOL ReleaseDevice(HANDLE hdevice) Declare Function ReleaseDevice Lib "USB2812" (ByVal hdevice As Long ) As Boolean Function ReleaseDevice(hDevice : Integer):Boolean; StdCall; External 'USB2812' Name 'ReleaseDevice'; LabView: ReleaseDevice hdevice Return Boolean Value 功能 : 释放设备对象所占用的系统资源及设备对象自身 参数 :hdevice 设备对象句柄, 它应由 CreateDevice 创建 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 :CreateDevice 应注意的是,CreateDevice 必须和 ReleaseDevice 函数一一对应, 即当您执行了一次 CreateDevice, 再一次执行这些函数前, 必须执行一次 ReleaseDevice 函数, 以释放由 CreateDevice 占用的系统软硬件资源, 如系统内存等 只有这样, 当您再次调用 CreateDevice 函数时, 那些软硬件资源才可被再次使用 第三节 AD 采样操作函数原型说明 初始化设备对象函数原型 : Visual C++ & C++Builder: BOOL InitDeviceAD( HANDLE hdevice, PUSB2812_PARA_AD padpara ) Declare Function InitDeviceAD Lib "USB2812" (ByVal hdevice As Long, _ ByRef padpara As USB2812_PARA _AD) As Boolean Function InitDeviceAD( hdevice : Integer; padpara:pusb2812_para_ad):boolean; StdCall; External 'USB2812' Name 'InitDeviceAD'; LabView: 10

11 北京阿尔泰科技发展有限公司 InitDeviceAD hdevice padpara Return Boolean Value 功能 : 它负责初始化设备对象中的 AD 部件, 为设备操作就绪有关工作, 如预置 AD 采集通道, 采样频率等, 然后启动 AD 设备开始 AD 采集, 随后, 用户便可以连续调用 ReadDeviceAD 读取 USB 设备上的 AD 数据以实现连续采集 参数 : hdevice 设备对象句柄, 它应由 USB 设备的 CreateDevice 创建 padpar a 设备对象参数结构, 它决定了设备对象的各种状态及工作方式, 如 AD 采样通道 采样频率等 请参考 AD 硬件参数介绍 返回值 : 如果初始化设备对象成功, 则返回 TRUE, 且 AD 便被启动 否则返回 FALSE, 用户可用 GetLastError 捕获当前错误码, 并加以分析 相关函数 : CreateDevice ReadDeviceAD ReleaseDevice 注意 : 该函数将试图占用系统的某些资源, 如系统内存区 DMA资源等 所以当用户在反复进行数据采集之前, 只须执行一次该函数即可, 否则某些资源将会发生使用上的冲突, 便会失败 除非用户执行了 ReleaseDeviceAD 函数后, 再重新开始设备对象操作时, 可以再执行该函数 所以该函数切忌不要单独放在循环语句中反复执行, 除非和 ReleaseDeviceAD 配对 批量读取 USB 设备上的 AD 数据函数原型 : Visual C++ & C++Builder: BOOL ReadDeviceAD (HANDLE hdevice, USHORT ADBuffer[], LONG nreadsizewords, PLONG nretsizewords = NULL) Declare Function ReadDeviceAD Lib "USB2812" (ByVal hdevice As Long, _ ByRef ADBuffer As Integer, _ ByVal nreadsizewords As Long, _ Optional ByRef nretsizewords As Long = 0) As Boolean Function ReadDeviceAD( hdevice : Integer; ADBuffer : SmallInt; nreadsizebytes:longword; nretsizewords : Pointer = 0) : Boolean; StdCall; External 'USB2812' Name 'ReadDeviceAD'; LabView: ReadDeviceAD hdevice Input padbuffer nreadsizewords Return Boolean Value Output padbuffer 功能 : 读取 USB 设备 AD 部件上的批量数据 它不负责初始化 AD 部件, 待读完整过指定长度的数据才返 回 它必须在 InitDeviceAD 之后,ReleaseDeviceAD 之前调用 参数 : 11

12 USB2811 WIN2000/XP 驱动程序使用说明书版本 : hdevice 设备对象句柄, 它应由 CreateDevice 创建 ADBuffe r 用户数据缓冲区地址 接受的是从设备上采集的 LSB 原码数据, 关于如何将 LSB 原码数据转换成电压值, 请参考 数据格式转换与排列规则 章节 nreadsizewords 读取数据的长度 ( 以字为单位 ), 为了提高读取速率, 根据特定要求, 其长度必须指定为 256 字的整数倍长, 如 等字长, 同时, 数据长度也要为采样通道数的整数倍, 以便于通道数据对齐处理, 所以 nreadsizewords 为 (256*(LastChannel FirstChannel + 1)) 的整数倍 否则,USB 设备对象将失败该读操作 nretsizewords 在当前操作中该函数实际读取的点数 只有当函数成功返回时该参数值才有意义, 而当函数返回失败时, 则该参数的值与调用此函数前的值相等, 不会因为函数被调用而改变, 因此最好在读取 AD 数据前, 将此参数值赋初值 0 需要注意的是在函数成功返回后, 若此参数值等于 0, 则需要重新调用此函数读取 AD 数据, 直到此参数的值不等于 0 为止 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 : CreateDevice InitDeviceAD ReleaseDevice 释放设备对象中的 AD 部件函数原型 : Visual C++ & C++Builder: BOOL ReleaseDeviceAD(HANDLE hdevice) Declare Function ReleaseDeviceAD Lib "USB2812" (ByVal hdevice As Long ) As Boolean Function ReleaseDeviceAD(hDevice : Integer):Boolean; StdCall; External 'USB2812' Name 'ReleaseDeviceAD'; LabView: ReleaseDeviceAD hdevice Return Boolean Value 功能 : 释放设备对象中的 AD 部件所占用的系统资源 参数 :hdevice 设备对象句柄, 它应由 CreateDevice 创建 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 :CreateDevice InitDeviceAD ReleaseDevice 应注意的是,InitDeviceAD 必须和 ReleaseDeviceAD 函数一一对应, 即当您执行了一次 InitDeviceAD, 再一 次执行这些函数前, 必须执行一次 ReleaseDeviceAD 函数, 以释放由 InitDeviceAD 占用的系统软硬件资源, 如系 统内存等 只有这样, 当您再次调用 InitDeviceAD 函数时, 那些软硬件资源才可被再次使用 这个对应关系对 于非连续采样的场合特别适用 比如用户先采集一定长度的数据后, 然后对根据这些数据或其他条件, 需要改变采样通道或采样频率等配置时, 则可以先用 ReleaseDeviceAD 释放先已由 InitDeviceAD 占用的资源, 然后再用 InitDeviceAD 重新分配资源和初始化设备状态, 即可实现所提到的功能 以上函数调用一般顺序 1 CreateDevice 2 InitDeviceAD 3 ReadDeviceAD 4 ReleaseDeviceAD 5 ReleaseDevice 用户可以反复执行第 3 步, 以实现高速连续不间断数据采集 如果在采集过程中要改变设备状态信息, 如采样通道等, 则执行到第 4 步后再回到第 2 步用新的状态信息重新初始设备 12

13 北京阿尔泰科技发展有限公司注意在第 3 步中, 若其 ReadDeviceAD 函数成功返回, 且 nretsizewords 参数值等于 0, 则需要重新执行第 3 步, 直到不等于 0 为止 第四节 AD 硬件参数系统保存与读取函数原型说明 从 Windows 系统中读入硬件参数函数函数原型 : Visual C++ & C++Builder: BOOL LoadParaAD(HANDLE hdevice, PUSB2812_PARA_AD padpara) Declare Function LoadParaAD Lib "USB2812" (ByVal hdevice As Long, _ ByRef padpara As USB2812_PARA_AD) As Boolean Function LoadParaAD(hDevice : Integer; padpara:pusb2812_para_ad):boolean; StdCall; External 'USB2812' Name 'LoadParaAD'; LabView: LoadParaAD hdevice Return Boolean Value Input padpara Output padpara 功能 : 负责从 Windows 系统中读取设备硬件参数 参数 : hdevice 设备对象句柄, 它应由 CreateDevice 创建 padpara 属于 PUSB2812_PARA 的结构指针型, 它负责返回 USB 硬件参数值, 关于结构指针类型 PUSB2812_PARA 请参考相应 USB2812.h 或该结构的帮助文档的有关说明 返回值 : 若成功, 返回 TRUE, 否则返回 FALSE 相关函数 : CreateDevice SaveParaAD ReleaseDevice Visual C++ & C++Builder 举例 : : USB2812_PARA_AD ADPara; HANDLE hdevice; HDevice = CreateDevice(0) ; // 管理秕一个 USB 设备 if(!loadparaad(hdevice, &ADPara)) { AfxMessageBox( 读入硬件参数失败, 请确认您的驱动程序是否正确安装 ); Return; // 若错误, 则退出该过程 } : Visual Basic 举例 : : Dim ADPara As USB2812_PARA_AD Dim hdevice As Long : hdevice = CreateDevice(0) 管理第一个 USB 设备 If Not LoadParaAD(hDevice, ADPara) Then MsgBox 读入硬件参数失败, 请确认您的驱动程序是否正确安装 Exit Sub ' 若错误, 则退出该过程 End If : 往 Windows 系统写入设备硬件参数函数函数原型 : Viusal C++ & C++Builder: BOOL SaveParaAD(HANDLE hdevice, PUSB2812_PARA_AD padpara) 13

14 USB2811 WIN2000/XP 驱动程序使用说明书版本 : Declare Function SaveParaAD Lib "USB2812" (ByVal hdevice As Long, _ ByRef padpara As USB2812_PARA_AD) As Boolean Function SaveParaAD (hdevice : Integer; padpara:pusb2812_para_ad):boolean; StdCall; External 'USB2812' Name 'SaveParaAD'; LabView: SaveParaAD hdevice padpara Return Boolean Value 功能 : 负责把用户设置的硬件参数保存在 Windows 系统中, 以供下次使用 参数 : hdevice 设备对象句柄, 它应由 CreateDevice 创建 padpara AD 设备硬件参数, 请参考 硬件参数结构 章节 返回值 : 若成功, 返回 TRUE, 否则返回 FALSE 相关函数 : CreateDevice LoadParaAD ReleaseDevice AD 采样参数复位至出厂默认值函数函数原型 : Viusal C++ & C++ Builder: BOOL ResetParaAD (HANDLE hdevice, PUSB2812_PARA_AD padpara) Declare Function ResetParaAD Lib "USB2812" (ByVal hdevice As Long, _ ByRef padpara As USB2812_PARA_AD) As Boolean Function ResetParaAD ( hdevice : Integer; padpara : PUSB2812_PARA_AD) : Boolean; StdCall; External 'USB2812' Name ' ResetParaAD '; 请参考相关演示程序 功能 : 将系统中原来的 AD 参数值复位至出厂时的默认值 以防用户不小心将各参数设置错误造成一时无法确定错误原因的后果 参数 : hdevice设备对象句柄, 它应由 CreateDevice或 CreateDeviceEx 创建 padpara 设备硬件参数, 它负责在参数被复位后返回其复位后的值 关于 USB2812_PARA_AD 的详细介绍请参考 USB2812.h 或 USB2812.Bas 或 USB2812.Pas 函数原型定义文件, 也可参考本文 硬件参数结构 关于该结构的有关说明 返回值 : 若成功, 返回 TRUE, 否则返回 FALSE 相关函数 : CreateDevice LoadParaAD SaveParaAD ResetParaAD ReleaseDevice 注意 : 在您编写工程应用软件时, 若要更方便的保存和读取您特有的软件参数, 请不防使用我们为您提供 14

15 北京阿尔泰科技发展有限公司 的辅助函数 :SaveParaInt LoadParaInt SaveParaString LoadParaString, 详细说明请参考共用函数介绍章节 中的 其他函数原型说明 第五节 DA 模拟量输出操作函数原型说明 输出模拟信号到指定通道函数原型 : Visual C++ & C++Builder: BOOL WriteDeviceDA ( HANDLE hdevice, SHORT ndadata, int ndachannel) Declare Function WriteDeviceDA Lib "USB2812" (ByVal hdevice As Long, _ ByVal ndadata As Integer,_ ByVal ndachannel As Integer) As Boolean Function WriteDeviceDA ( hdevice : Integer; ndadata : SmallInt; ndachannel : Integer) : Boolean; StdCall; External 'USB2812' Name ' WriteDeviceDA '; 请参考相关演示程序 功能 : 输出 DA 原始数据到 CN1 上的 VOUT0 上 参数 : hdevice设备对象句柄, 它应由 CreateDevice或 CreateDeviceEx 创建 ndadata 指输出的 DA 原始码数据, 它的取值范围为 [0, 65535], 它与实际输出模拟量值的对应关系请参考 DA 电压值转换成 LSB 原码数据的换算方法 章节 ndachannel 需要指定的模拟量通道号, 其取值范围为 [0, 7] 返回值 : 若成功, 返回 TRUE, 输出 DA 原始数据到 CN1 上的 VOUT0 上 ; 否则返回 FALSE, 您可以调用 GetLastErrorEx 函数取得错误或错误字符信息 相关函数 : CreateDevice ReleaseDevice 以上函数调用一般顺序 1 CreateDevice 2 WriteDeviceDA 3 ReleaseDevice 用户可以反复执行第 2 步, 以进行模拟量输出不断变化 ( 可以和 AD 采样同时进行, 互不影响 ) 第六节 CNT 计数与定时器操作函数原型说明 设置计数器的初值函数原型 : Visual C++ & C++Builder: BOOL SetDeviceCNT(HANDLE hdevice, ULONG ContrlMode, ULONG CNTVal, ULONG ulchannel) 15

16 USB2811 WIN2000/XP 驱动程序使用说明书版本 : Declare Function SetDeviceCNT Lib "USB2812" (ByVal hdevice As Long, _ ByVal ContrlMode As Long, _ ByVal CNTVal As Long, _ ByVal ulchannel As Long) As Boolean Function SetDeviceCNT (hdevice : Integer; ContrlMode : LongWord; CNTVal : LongWord; ulchannel : LongWord) : Boolean; StdCall; External 'USB2812' Name ' SetDeviceCNT '; 请参考相关演示程序 功能 : 设置计数器的初值 参数 : hdevice设备对象句柄, 它应由 CreateDevice创建 ContrlMode 方式控制字 其选项值如下表 : 常量名常量值功能定义 USB2812_GATEMODE_POSITIVE_0 0x0000 计数结束产生中断 USB2812_GATEMODE_RISING_1 0x0001 可编程单拍脉冲 USB2812_GATEMODE_POSITIVE_2 0x0002 频率发生器 USB2812_GATEMODE_POSITIVE_3 0x0003 方波发生器 USB2812_GATEMODE_POSITIVE_4 0x0004 软件触发选通 USB2812_GATEMODE_RISING_5 0x0005 硬件触发选通 CNTVal 计数初值 ulchannel 计数器通道选择, 取值为 [0,2] 返回值 : 若成功, 返回 TRUE, 否则返回 FALSE 相关函数 : CreateDevice GetDeviceCNT ReleaseDevice 取得各路计数器的当前计数值函数原型 : Visual C++ & C++Builder: BOOL GetDeviceCNT (HANDLE hdevice, PULONG pcntval, ULONG ulchannel) Declare Function GetDeviceCNT Lib "USB2812" (ByVal hdevice As Long, _ ByRef pcntval As Integer, _ ByVal ulchannel As Long) As Boolean Function GetDeviceCNT ( hdevice : Integer; pcntval: Pointer; pcontrolmode: Pointer; ulchannel: LongWord) : Boolean; 16

17 北京阿尔泰科技发展有限公司 StdCall; External 'USB2812' Name ' GetDeviceCNT '; 请参考相关演示程序 功能 : 取得各路计数器的当前计数值 参数 : hdevice设备对象句柄, 它应由 CreateDevice创建 pcntval 取得计数初值 ulchannel 计数器通道选择, 取值为 [0,2] 返回值 : 若成功, 返回 TRUE, 否则返回 FALSE 相关函数 : CreateDevice SetDeviceCNT ReleaseDevice 第七节 DIO 数字开关量输入输出简易操作函数原型说明 十六路开关量输入函数原型 : Visual C++ & C++Builder: BOOL GetDeviceDI (HANDLE hdevice, BYTE bdists[16]) Declare Function GetDeviceDI Lib "USB2812" (ByVal hdevice As Long, _ ByVal bdists(0 to 15 ) As Long) As Boolean Function GetDeviceDI ( hdevice : Integer; bdists:pointer):boolean; StdCall; External 'USB2812' Name ' GetDeviceDI '; LabView: GetDeviceDI hdevice Return Boolean Value pdipara Output pdipara 功能 : 负责将 USB 设备上的输入开关量状态读入内存 参数 : hdevice 设备对象句柄, 它应由 CreateDevice 决定 bdists 十六路开关量输入状态的参数结构, 共有 16 个成员变量, 分别对应于 DI0-DI15 路开关量输入状态 位 如果 bdists[0] 为 1 则使 0 通道处于开状态, 若为 0 则 0 通道为关状态 其他同理 具体定义请参考 DI 数字开关量输入参数介绍 章节 返回值 : 若成功, 返回 TRUE, 其 bdists[x] 中的值有效 ; 否则返回 FALSE, 其 bdists[x] 中的值无效 相关函数 : CreateDevice SetDeviceDO ReleaseDevice 十六路开关量输出函数原型 : Visual C++ & C++Builder: BOOL SetDeviceDO (HANDLE hdevice, BYTE bdosts[16]) Declare Function SetDeviceDO Lib "USB2812" ( ByVal hdevice As Long, _ ByVal bdosts(0 to 15 )As Long) As Boolean Function SetDeviceDO (hdevice : Integer; bdosts:pointer):boolean; 17

18 USB2811 WIN2000/XP 驱动程序使用说明书版本 : LabView: hdevice Input pdopara StdCall; External 'USB2812' Name ' SetDeviceDO '; SetDeviceDO Return Boolean Value 功能 : 负责将 USB 设备上的输出开关量置成相应的状态 参数 : hdevice 设备对象句柄, 它应由 CreateDevice 决定 bdosts 十六路开关量输出状态的参数结构, 共有 16 个成员变量, 分别对应于 DO0-DO15 路开关量输出状态位 比如置 bdosts[0] 为 1 则使 0 通道处于 开 状态, 若为 0 则置 0 通道为 关 状态 其他同理 请注意, 在实际执行这个函数之前, 必须对这个参数结构的 DO0 至 DO15 共 16 个成员变量赋初值, 其值必须为 1 或 0 具体定义请参考 DO 数字开关量输出参数介绍 返回值 : 若成功, 返回 TRUE, 否则返回 FALSE 相关函数 : CreateDevice GetDeviceDI ReleaseDevice 以上函数调用一般顺序 1 CreateDevice 2 SetDeviceDO ( 或 GetDeviceDI, 当然这两个函数也可同时进行 ) 3 ReleaseDevice 用户可以反复执行第 2 步, 以进行数字 I/O 的输入输出 ( 数字 I/O 的输入输出及 AD 采样可以同时进行, 互不影响 ) 第四章硬件参数结构 AD 硬件参数介绍 (USB2812_PARA_AD) Visual C++ & C++Builder: typedef struct _USB2812_PARA_AD // 板卡各参数值 { LONG CheckStsMode; // FIFO 采样标志 LONG ADMode; // AD 模式选择 ( 连续采集 / 分组采集 ) LONG FirstChannel; // 首通道, 取值范围为 [0, 31] LONG LastChannel; // 末通道, 取值范围为 [0, 31] LONG Frequency; // 采集频率, 单位为 Hz, 取值范围为 [31, ] LONG InputRange; // 模拟量输入量程范围 LONG GroupInterval; // 分组采样时的组间间隔 ( 单位 : 微秒 ) LONG LoopsOfGroup; // 组循环次数 LONG Gains; // 增益控制字 LONG TriggerMode; // 触发模式选择 ( 软件触发 后触发 ) LONG TriggerType; // 触发类型选择 ( 边沿触发 / 脉冲触发 ) LONG TriggerDir; // 触发方向选择 ( 正向 / 负向触发 ) LONG TrigLevelVolt; // 触发电平 (-10000mV mV) LONG TrigWindow; // 触发灵敏度 (1-255), 单位 :0.5 微秒 LONG GroundingMode; // 接地方式 ( 单端或双端选择 ) 18

19 北京阿尔泰科技发展有限公司 } USB2812_PARA_AD, *PUSB2812_PARA_AD; Private Type USB2812_PARA_AD CheckStsMode As Long End Type ADMode As Long ' FIFO 采样标志 ' AD 模式选择 ( 连续采集 / 分组采集 ) FirstChannel As Long ' 首通道, 取值范围为 [0, 31] LastChannel As Long ' 末通道, 取值范围为 [0, 31] Frequency As Long InputRange As Long GroupInterval As Long LoopsOfGroup As Long Gains As Long TriggerMode As Long ' AD 采样频率, 单位 Hz, 取值范围为 [31, ] ' 模拟量输入量程范围 ' 分组间隔, 单位微秒 ' 组循环次数 ' 增益控制字 ' 触发模式选择 ( 软件触发 后触发 ) TriggerType As Long ' 触发类型选择 ( 边沿 / 电平触发类型 ) TriggerDir As Long ' 触发方向选择 ( 正向 / 负向触发方向 ) TrigLevelVolt As Long TrigWindow As Long ' 触发电平 (-10000mV mV) ' 触发灵敏度 (1-255), 单位 :0.5 微秒 GroundingMode As Long ' 接地方式 ( 单端或双端选择 ) Type // 定义结构体数据类型 PUSB2812_PARA_AD = ^USB2812_PARA_AD; // 指针类型结构 USB2812_PARA_AD = record // 标记为记录型 CheckStsMode : LongInt; // FIFO 采样标志 ADMode : LongInt; // AD 模式选择 ( 连续采集 / 分组采集 ) FirstChannel : LongInt; // 首通道, 取值范围为 [0, 31] LastChannel : LongInt; // 末通道, 取值范围为 [0, 31] Frequency : LongInt; // 采集频率, 单位为 Hz, 取值范围为 [31, ] InputRange : LongInt; // 模拟量输入量程范围 GroupInterval : LongInt; // 分组采样时的组间间隔 ( 单位 : 微秒 ) LoopsOfGroup : LongInt; // 组循环次数 Gains : LongInt; // 增益控制字 TriggerMode : LongInt; // 触发模式选择 ( 软件触发 后触发 ) TriggerType : LongInt; // 触发类型选择 ( 边沿触发 / 脉冲触发 ) TriggerDir : LongInt; // 触发方向选择 ( 正向 / 负向触发 ) TrigLevelVolt : LongInt; // 触发电平 (-10000mV mV) TrigWindow : LongInt; // 触发灵敏度 (1-255), 单位 :0.5 微秒 GroundingMode : LongInt; // 接地方式 ( 单端或双端选择 ) End; LabView: 首先请您关注一下这个结构与前面 ISA 总线部分中的硬件参数结构 PARA 比较, 该结构实在太简短了 其原因就是在于 USB 设备是系统全自动管理的设备, 什么端口地址, 中断号,DMA 等将与 USB 设备的用户永远告别, 一句话 USB 设备简单得就象使用电源插头一样 19

20 USB2811 WIN2000/XP 驱动程序使用说明书版本 : 硬件参数说明 : 此结构主要用于设定设备硬件参数值, 用这个参数结构对设备进行硬件配置完全由 InitDeviceAD 函数完成 CheckStsMode 查询 FIFO 状态的模式, 它用于同步 AD 的采样时序 由于有不同的采样频率, 因此写入 FIFO 数据的速度也不一样, 所以需要依据 FIFO 的半满或者是非空标志同步对 FIFO 数据的读取 如果选择半 满查询模式, 则在启动 AD 采样后不能马上读取 FIFO 中的数据, 而是要等到 FIFO 的半满状态建立时才能读取 数据, 此种模式用于大批量高速采样情况下 ( 实时性要求不大 ) 如果选择非空查询模式, 则在启动 AD 采样后, 只要 FIFO 中不为空, 那怕只有一个数据时也能读取, 此种模式用于较低速, 但快速取得小批量数据的情况下 ( 实 时性要求较高 ) 常量名常量值功能定义 USB2812_CHKSTSMODE_HALF 0x0000 查询 FIFO 半满标志 ( 建议高频率采集时使用 ) USB2812_CHKSTSMODE_NPT 0x0001 查询 FIFO 非空标志 ( 建议高实时采集时使用 ) ADMode AD 采样模式 它的取值如下表 : 常量名常量值功能定义 USB2812_ADMODE_SEQUENCE 0x0000 连续采集模式 USB2812_ADMODE_GROUP 0x0001 分组采集模式连续采集方式的情况是 : 在由 Fr equency指定的采样频率下所采集的全部数据在时间轴上是等简隔的, 比如将 Frequency 指定为 100KHz, 即每隔 10 微秒采样一个点, 总是这样重复下去 而分组采集方式的情况是 : 所有采集的数据点在时间轴上被划分成若干个等长的组, 而组内通常有大于 2 个点的数据, 组内各点频率由 Frequency 决定, 组间间隔由 GroupInterval 决定 比如用户要求在对 0-15 通道共 16 个通道用 100KHz 频率每采集一个轮回后, 要求间隔 1 毫秒后, 再对这 16 个通道采集下一个轮回, 那么分组采集便是最佳方式, 它可以将组间延时误差控制在 0.5 微秒以下 关于分组与连续采集更详细的说明请参考硬件说明书 如下图 : t nt mt nt mt nt 其中 :t 为所需触发 A/D 转换的周期 Cycle, 它由 Frequency 参数的倒数决定 Cycle = 1 / Frequency n 为每组的通道数 ChannelCount 决定, 即 ChannelCount = LastChannel-FirstChannel+1 nt 为每组操作所需时间即 Cycle * ChannelCount * LoopsofGroup ( 此处假定 LoopsofGroup=1) mt 为每组操作之间所间隔的时间, 它由 GroupInterval 参数决定, 单位为 1uS FirstChannel 首通道值, 取值范围应根据设备的总通道数设定, 本设备的 AD 采样首通道取值范围为 0~31, 要求首通道等于或小于末通道 LastChannel 末通道值, 取值范围应根据设备的总通道数设定, 本设备的 AD 采样首通道取值范围为 0~31, 要求末通道大于或等于首通道 注 : 当首通道和末通道相等时, 即为单通道采集 Frequency AD 采样频率, 本设备的频率取值范围为 [31Hz, 250kHz] 注意: 在内时钟 ( 即 ClockSource = USB2812_CLOCKSRC_IN) 方式下 : 若连续采集 ( 即 ADMode = USB2812_ADMODE_SEQUENCE) 时, 此参数控制各处通道间的采样频率 若分组采集 ( 即 ADMode= USB2812_ADMODE_GROUP) 时, 则此参数控制各组组内的采样频率, 而组间时间则由 GroupInterval 决定 在外时钟 ( 即 ClockSource = USB2812_CLOCKSRC_OUT) 方式下 : 若连续采集 ( 即 ADMode = USB2812_ADMODE_SEQUENCE) 时, 此参数自动失效, 因为外时钟的频率代替了此参数设定的频率 若为分组采集 ( 即 ADMode= USB2812_ADMODE_GROUP) 时, 则该参数控制各组组内的采样频率, 而外时钟则是每组的触发频率 此时,GroupInterval 参数无效 InputRange 模拟量输入量程范围 20

21 北京阿尔泰科技发展有限公司常量名 常量值 功能定义 USB2812_INPUT_N10000_P10000mV 0x00 ±10000mV USB2812_INPUT_N5000_P5000mV 0x01 ±5000mV USB2812_INPUT_N2500_P2500mV 0x02 ±2500mV USB2812_INPUT_0_P10000mV 0x03 0~10000mV GroupInterval 分组间隔, 指定两组间的时间间隔, 单位微秒, 取值范围为 [1, 32767] LoopsOfGroup 组循环次数 ( 在分组采集时有效 ), 即指每一组采集从首通道依次采集到末通道后再回到首通 道的次数 比如 =1 则表示从首通道采集到末通道后则自动进入分组间隔准备采集下一组 若 =2, 则表示从首 通道采集到末通道后再回到首通道采集到末通道一遍后进入组间间隔, 依此类推 Gains 程控增益放大倍数, 被采样的外界信号经通道开关选通后进入一个程控增益放大器如 AD8251 芯片, 它可以将原始模拟信号放大指定倍数后再进入 AD 转换器被转换 常量名常量值功能定义 USB2812_GAINS_1MULT 0x00 1 倍增益 ( 使用 AD8251 放大器 ) USB2812_GAINS_2MULT 0x01 2 倍增益 ( 使用 AD8251 放大器 ) USB2812_GAINS_4MULT 0x02 4 倍增益 ( 使用 AD8251 放大器 ) USB2812_GAINS_8MULT 0x03 8 倍增益 ( 使用 AD8251 放大器 ) TriggerMode AD 触发模式, 若等于常量 USB2812_TRIGMODE_SOFT 则为内部软件触发, 若等于常量 USB2812_TRIGMODE_POST 则为外部硬件后触发 两种方式的主要区别是 : 外触发是当设备被 InitDeviceAD 函 数初始化就绪后, 并没有立即启动 AD 采集, 仅当外接管脚 ATR 上有一个符合要求的信号时,AD 转换器便被启 动, 且按用户预先设定的采样频率由板上的硬件定时器时定触发 AD 等间隔转换每一个 AD 数据, 其触发条件由 触发类型和触发方向及触发电平决定 常量名 常量值 功能定义 USB2812_TRIGMODE_SOFT 0x0000 软件内触发方式 USB2812_TRIGMODE_POST 0x0001 硬件后触发方式 TriggerType AD 外触发方式使用信号方向 它的其选项值如下表 : 常量名 常量值 功能定义 USB2812_TRIGTYPE_EDGE 0x0000 边沿触发 USB2812_TRIGTYPE_PULSE 0x0001 脉冲触发 ( 电平方式 ), 适用于采集馒头波信号 TriggerDir AD 外触发方式使用信号方向 它的其选项值如下表 : 常量名 常量值 功能定义 USB2812_TRIGDIR_NEGATIVE 0x0000 负向触发 ( 低脉冲 / 下降沿触发 ) USB2812_TRIGDIR_POSITIVE 0x0001 正向触发 ( 高脉冲 / 上升沿触发 ) USB2812_TRIGDIR_POSIT_NEGAT 0x0002 正负向触发 ( 高 / 低脉冲或上升 / 下降沿触发 ) TrigLevelVolt 触发电平, 取值范围为 (+10000mV mV) TrigWindow 触发灵敏窗时间值, 取值范围为 (1-255), 单位为 0.5 微秒 GroundingMode 接地方式 ( 单端或双端 ) 选择 : 常量名 常量值 功能定义 USB2812_GNDMODE_SE 0x0000 单端方式 (SE:Single end) USB2812_GNDMODE_DI 0x0001 双端方式 (DI:Differential) 21

22 USB2811 WIN2000/XP 驱动程序使用说明书版本 : 相关函数 : InitDeviceAD LoadParaAD SaveParaAD 第五章数据格式转换与排列规则 第一节 AD 原始数据 LSB 转换成电压值 Volt 的换算方法 在换算过程中弄清模板精度 ( 即 Bit 位数 ) 是很关键的, 因为它决定了 LSB 数码的总宽度 CountLSB 比 如 12 位的模板 CountLSB 为 4096 其他类型同理均按 2 n =LSB 总数 (n 为 Bit 位数 ) 换算即可 压值 值 量程 ( 毫伏 ) 计算机语言换算公式 ( 标准 C 语法 ) Volt 取值范围 mv ±10000 Volt = ( /8192) * (ADBuffer[0] &0x1FFF) [ , ] ±5000 Volt = ( /8192) * (ADBuffer[0] &0x1FFF) [ , ] ±2500 Volt = ( /8192) * (ADBuffer[0]&0x1FFF) [ , ] 0~10000 Volt = ( /8192) * (ADBuffer[0] &0x1FFF) [0.00, ] 换算举例 :( 设量程为 ±10000mV, 这里只转换第一个点 ) Visual C++&C++Builder: USHORT Lsb; // 定义存放标准 LSB 原码的变量 float Volt; // 定义存放转换后的电压值的变量 float PerLsbVolt = /8192; // 求出每个 LSB 原码单位电压值 Lsb = ADBuffer[0] &0x1FFF; Volt = PerLsbVolt * Lsb ; // 用单位电压值与 LSB 原码数量相乘减去偏移求得实际电 Dim Lsb As Long ' 定义存放标准 LSB 原码的变量 Dim Volt As Single ' 定义存放转换后的电压值的变量 Dim PerLsbVolt As Single PerLsbVolt = /8192 ' 求出每个 LSB 原码单位电压值 Lsb = ADBuffer(0) AND 8191 ' 将其转换成无符号 13 位有效数据 Volt = PerLsbVolt * Lsb ' 用单位电压值与 LSB 原码数量相乘减去偏移求得实际电压值 Lsb : Word; // 定义存放标准 LSB 原码的变量 Volt :Single; // 定义存放转换后的电压值的变量 PerLsbVolt : Single; PerLsbVolt := /8192; // 求出每个 LSB 原码单位电压值 Lsb := ADBuffer[0] &0x1FFF; Volt := PerLsbVolt * Lsb ; // 用单位电压值与 LSB 原码数量相乘减去偏移求得实际电压 第二节 AD 采集函数的 ADBuffer 缓冲区中的数据排放规则 当首末通道相等时, 即为单通道采集, 假如 FirstChannel=5, LastChannel=5, 其排放规则如下 : 数据缓冲区索引号 通道号 两通道采集 (CH0 CH1) 数据缓冲区索引号

23 北京阿尔泰科技发展有限公司通道号 四通道采集 (CH0 - CH3) 数据缓冲区索引号 通道号 其他通道方式以此类推 如果用户是进行连续不间断循环采集, 即用户只进行一次初始化设备操作, 然后不停的从设备上读取 AD 数据, 那么需要用户特别注意的是应处理好各通道数据排列和对齐问题, 尤其任意通道数采集时 否则, 用户无法将规则排放在缓冲区中的各通道数据正确分离出来 怎样正确处理呢? 我们建议的方法是, 每次从设备上读取的点数应置为所选通道数量的整数倍长 ( 在 USB 设备上同时也应 32 的整数倍 ), 这样便能保证每读取的这批数据在缓冲区中的相应位置始终固定对应于某一个通道的数据 比如用户要求对 1 2 两个 AD 通道的数据进行连续循环采集, 则置每次读取长度为其 2 的整倍长 2n(n 为每个通道的点数 ), 这里设为 2048 试想, 如此一来, 每次读取的 2048 个点中的第一个点始终对应于 1 通道数据, 第二个点始终对应于 2 通道, 第三个点再应于 1 通道, 第四个点再对应于 2 通道 以此类推 直到第 2047 个点对应于 1 通道数据, 第 2048 个点对应 2 通道 这样一来, 每次读取的段长正好包含了从首通道到末通道的完整轮回, 如此一来, 用户只须按通道排列规则, 按正常的处理方法循环处理每一批数据 而对于其他情况也是如此, 比如 3 个通道采集, 则可以使用 3n(n 为每个通道的点数 ) 的长度采集 为了更加详细地说明问题民, 请参考下表 ( 演示的是采集 共三个通道的情况 ) 由于使用连续采样方式, 所以表中的数据序列一行的数字变化说明了数据采样的连续性, 即随着时间的延续, 数据的点数连续递增, 直至用户停止设备为止, 从而形成了一个有相当长度的连续不间的多通道数据链 而通道序列一行则说明了随着连续采样的延续, 其各通道数据在其整个数据链中的排放次序, 这是一种非常规则而又绝对严格的顺序 但是这个相当长度的多通道数据链则不可能一次通过设备对象函数如 ReadDeviceAD 函数读回, 即便不考虑是否能一次读完的问题, 但对用户的实时数据处理要求来说, 一次性读取那么长的数据, 则往往是相当矛盾的 因此我们就得分若干次分段读取 但怎样保证既方便处理, 又不易出错, 而且还高效 还是正如前面所说, 采用通道数的整数倍长读取每一段数据 如表中列举的方法 1( 为了说明问题, 我们每读取一段数据只读取 2n 即 3*2=6 个数据 ) 从方法 1 不难看出, 每一段缓冲区中的数据在相同缓冲区索引位置都对应于同一个通道 而在方法 2 中由于每次读取的不是通道整数倍长, 则出现问题, 从表中可以看出, 第一段缓冲区中的 0 索引位置上的数据对应的是第 1 通道, 而第二段缓冲区中的 0 索引位置上的数据则对应于第 2 通道的数据, 而第三段缓冲区中的数据则对应于第 3 通道, 这显然不利于循环有效处理数据 在实际应用中, 我们在遵循以上原则时, 应尽可能地使每一段缓冲足够大, 这样, 可以一定程度上减少数据采集程序和数据处理程序的 CPU 开销量 数据序列 通道序列 方法 缓冲区号第一段缓冲第二段缓冲区第三段缓冲区第 n 段缓冲 方法 第一段缓冲区第二段缓冲区第三段缓冲区第四段缓冲区第五段缓冲区第 n 段缓 第三节 DA 电压值转换成 LSB 原码数据的换算方法 量程 ( 伏 ) 计算机语言换算公式 ( 标准 C 语法 ) Lsb 取值范围 0~5000mV Lsb = Volt / ( / 4096 ) [0,4095] 0~10000mV Lsb = Vol t/ ( / 4096 ) [0,4095] ±5000mV Lsb = Volt / ( / 4096) [0,4095] ±10000mV Lsb = Volt / ( / 4096 ) [0,4095] 23

24 USB2811 WIN2000/XP 驱动程序使用说明书版本 : 请注意这里求得的 LSB 数据就是用于 WriteDeviceDA 中的 ndadata 参数的 第六章上层用户函数接口应用实例 如果您想快速的了解驱动程序的使用方法和调用流程, 以最短的时间建立自己的应用程序, 那么我们强烈建议您参考相应的简易程序 此种程序属于工程级代码, 可以直接打开不用作任何配置和代码修改即可编译通过, 运行编译链接后的可执行程序, 即可看到预期效果 如果您想了解硬件的整体性能 精度 采样连续性等指标以及波形显示 数据存盘与分析 历史数据回放等功能, 那么请参考高级演示程序 特别是许多不愿意编写任何程序代码的用户, 您可以使用高级程序进行采集 显示 存盘等功能来满足您的要求 甚至可以用我们提供的专用转换程序将高级程序采集的存盘文件转换成相应格式, 即可在 Excel MatLab 第三方软件中分析数据 ( 此类用户请最好选用通过 Visual C++ 制作的高级演示系统 ) 第一节 简易程序演示说明一 怎样使用 ReadDeviceAD 函数进行 AD 连续数据采集其详细应用实例及工程级代码请参考 Visual C++ 简易演示系统及源程序, 您先点击 Windows 系统的 [ 开始 ] 菜单, 再按下列顺序点击, 即可打开基于 VC 的 Sys 工程 ( 主要参考 USB2812.h 和 Sys.cpp) [ 程序 ] [ 阿尔泰测控演示系统 ] [Microsoft Visual C++] [ 简易代码演示 ] [AD 采集演示源程序 ] 其简易程序默认存放路径为 : 系统盘 \ART\USB2812\SAMPLES\VC\SIMPLE\AD 二 怎样使用 SetDeviceDO 和 GetDeviceDI 函数进行开关量输入输出操作其详细应用实例及正确代码请参考 Visual C++ 简易演示系统及源程序, 您先点击 Windows 系统的 [ 开始 ] 菜单, 再按下列顺序点击, 即可打开基于 VC 的 Sys 工程 ( 主要参考 USB2812.h 和 Sys.cpp) [ 程序 ] [ 阿尔泰测控演示系统 ] [Microsoft Visual C++] [ 简易代码演示 ] [ 开关量演示源程序 ] 其默认存放路径为 : 系统盘 \ART\USB2812\SAMPLES\VC\SIMPLE\DIO 第二节 高级程序演示说明高级程序演示了本设备的所有功能, 您先点击 Windows 系统的 [ 开始 ] 菜单, 再按下列顺序点击, 即可打开基于 VC 的 Sys 工程 ( 主要参考 USB2812.h 和 DADoc.cpp) [ 程序 ] [ 阿尔泰测控演示系统 ] [Microsoft Visual C++] [ 高级代码演示 ] 其默认存放路径为 : 系统盘 \ART\USB2812\SAMPLES\VC\ADVANCED 其他语言的演示可以用上面类似的方法找到 第七章基于 USB 总线的大容量连续数据采集详述 与 ISA PCI 设备同理, 使用子线程跟踪 AD 转换进度, 并进行数据采集是保持数据连续不间断的最佳方案 但是与 ISA 总线设备不同的是,USB 设备在这里不使用动态指针去同步 AD 转换进度, 因为 ISA 设备环形内存池的动态指针操作是一种软件化的同步, 而 USB 设备不再有软件化的同步, 而完全由硬件和驱动程序自动完成 这样一来, 用户要用程序方式实现连续数据采集, 其软件实现就显得极为容易 每次用 ReadDeviceAD 函数读取 AD 数据时, 那么设备驱动程序会按照 AD 转换进度将 AD 数据一一放进用户数据缓冲区, 当完成该次所指定的点数时, 它便会返回, 当您再次用这个函数读取数据时, 它会接着上一次的位置传递数据到用户数据缓冲区 只是要求每两次 ReadDeviceAD 之间的时间间隔越短越好 但是由于我们的设备是通常工作在一个单 CPU 多任务的环境中, 由于任务之间的调度切换非常平凡, 特别是当用户移动窗口 或弹出对话框等, 则会使当前线程猛地花掉大量的时间去处理这些图形操作, 因此如果 24

25 北京阿尔泰科技发展有限公司处理不当, 则将无法实现高速连续不间断采集, 那么如何更好的克服这些问题呢? 用子线程则是必须的 ( 在这里我们称之为数据采集线程 ), 但这还不够, 必须要求这个线程是绝对的工作者线程, 即这个线程在正常采集中不能有任何窗口等图形操作 只有这样, 当用户进行任何窗口操作时, 这个线程才不会被堵塞, 因此可以保证正常连续的数据采集 但是用户可能要问, 不能进行任何窗口操作, 那么我如何将采集的数据显示在屏幕上呢? 其实很简单, 再开辟一个子线程, 我们称之数据处理线程, 也叫用户界面线程 最初, 数据处理线程不做任何工作, 而是在 Win32 API 函数 WaitForSingleObject 的作用下进入睡眠状态, 此时它不消耗 CPU 任何时间, 即可保证其他线程代码有充分的运行机会 ( 这里当然主要指数据采集线程 ), 当数据采集线程取得指定长度的数据到用户空间时, 则再用 Win32 API 函数 SetEvent 将指定事件消息发送给数据处理线程, 则数据处理线程即刻恢复运行状态, 迅速对这批数据进行处理, 如计算 在窗口绘制波形 存盘等操作 可能用户还要问, 既然数据处理线程是非工作者线程, 那么如果用户移动窗口等操作堵塞了该线程, 而数据采集线程则在不停地采集数据, 那数据处理线程难道不会因此而丢失数据采集线程发来的某一段数据吗? 如果不另加处理, 这个情况肯定有发生的可能 但是, 我们采用了一级缓冲队列和二级缓冲队列的设计方案, 足以避免这个问题 即假设数据采集线程每一次从设备上取出 8K 数据, 那么我们就创建一个缓冲队列, 在用户程序中最简单的办法就是开辟一个两维数组如 ADBuffer[Count][DataLen], 我们将 DataLen 视为数据采集线程每次采集的数据长度,Count 则为缓冲队列的成员个数 您应根据您的计算机物理内存大小和总体使用情况来设定这个数 假如我们设成 32, 则这个缓冲队列实际上就是数组 ADBuffer[32][8192] 的形式 那么如何使用这个缓冲队列呢? 方法很简单, 它跟一个普通的缓冲区如一维数组差不多, 唯一不同是, 两个线程首先要通过改变 Count 字段的值, 即这个下标 Index 的值来填充和引用由 Index 下标指向某一段 DataLen 长度的数据缓冲区 需要注意的两个线程不共用一个 Index 下标变量 具体情况是当数据采集线程在 AD 部件被 InitDeviceAD 初始化之后, 首次采集数据时, 则将自己的 ReadIndex 下标置为 0, 即用第一个缓冲区采集 AD 数据 当采集完后, 则向数据处理线程发送消息, 且两个线程的公共变量 SegmentCounts 加 1,( 注意 SegmentCounts 变量是用于记录当前时刻缓冲队列中有多少个已被数据采集线程使用了, 但是却没被数据处理线程处理掉的缓冲区数量 ) 然后再接着将 ReadIndex 偏移至 1, 再用第二个缓冲区采集数据 再将 SegmentCounts 加 1, 至到 ReadIndex 等于 15 为止, 然后再回到 0 位置, 重新开始 而数据处理线程则在每次接受到消息时判断有多少由于自已被堵塞而没有被处理的缓冲区个数, 然后逐一进行处理, 最后再从 SegmentCounts 变量中减去在所接受到的当前事件下所处理的缓冲区个数 因此, 即便应用程序突然很忙, 使数据处理线程没有时间处理已到来的数据, 但是由于缓冲区队列的缓冲作用, 可以让数据采集线程先将数据连续缓存在这个区域中, 由于这个缓冲区可以设计得比较大, 因此可以缓冲很大的时间, 这样即便是数据处理线程由于系统的偶而繁忙面被堵塞, 也很难使数据丢失 而且通过这种方案, 用户还可以在数据采集线程中对 SegmentCounts 加以判断, 观察其值是否大小了 32, 如果大于, 则缓冲区队列肯定因数据处理采集的过度繁忙而被溢出, 如果溢出即可报警 因此具有强大的容错处理 25

26 USB2811 WIN2000/XP 驱动程序使用说明书版本 : 缓冲队列 padbuffer0 填充由 ReadIndex 指向的缓冲区 padbuffer1 padbuffer2 处理由 CurrentIndex 指向的缓冲区 数据采集线程 padbuffer3 数据处理线程 数据流向 padbuffer4 : : 数据流向 发出同步信号 SetEvent padbuffern-1 padbuffern 等待同步信号 WaitForSingleObjec 同步事件 hevent 下面只是简要的策略说明, 其详细应用实例请参考 Visual C++ 测试与演示系统, 您先点击 Windows 系统的 [ 开始 ] 菜单, 再按下列顺序点击, 即可打开基于 VC 的 Sys 工程 [ 程序 ] [ 阿尔泰测控演示系统 ] [Microsoft Visual C++ Sample ] 下面只是基于 C 语言的简要的策略说明, 其详细应用实例及正确代码请参考 Visual C++ 测试与演示系统, 您先点击 Windows 系统的 [ 开始 ] 菜单, 再按下列顺序点击, 即可打开基于 VC 的 Sys 工程 (ADDoc.h 和 ADDoc.cpp) [ 程序 ] [ 阿尔泰测控演示系统 ] [Microsoft Visual C++ Sample] 然后, 您着重参考 ADDoc.cpp 源文件中以下函数 : void CADDoc::StartDeviceAD() // 启动线程函数 UINT ReadDataThread (PVOID hwnd) // 读数据线程 UINT ProcessDataThread (PVOID hwnd) // 绘制数据线程 void CADDoc::StopDeviceAD() // 终止采集函数 第八章公共接口函数介绍 这部分函数不参与本设备的实际操作, 它只是为您编写数据采集与处理程序时的有力手段, 使您编写应用程序更容易, 使您的应用程序更高效 26

27 北京阿尔泰科技发展有限公司 第一节 公用接口函数总列表 ( 每个函数省略了前缀 USB2812_ ) 函数名 函数功能 备注 1 创建 Visual Basic 子线程, 线程数量可达 32 个以上 CreateVBThread 在 VB 环境中建立子线程对象 在 VB 中可实现多线程 TerminateVBThread 终止 VB 的子线程 CreateSystemEvent 创建系统内核事件对象 用于线程同步或中断 ReleaseSystemEvent 释放系统内核事件对象 2 文件对象操作函数 CreateFileObject 初始设备文件对象 WriteFile 请求文件对象写用户数据到磁盘文件 ReadFile 请求文件对象读数据到用户空间 SetFileOffset 设置文件指针偏移 GetFileLength 取得文件长度 ReleaseFile 释放已有的文件对象 GetDiskFreeBytes 取得指定磁盘的可用空间 ( 字节 ) 适用于所有设备 3 各种参数保存和读取函数 SaveParaInt 保存整型参数到注册表 LoadParaInt 从注册表中读取整型参数值 SaveParaString 保存字符参数到注册表 LoadParaString 从注册表中读取字符参数值 4 其他函数 kbhit 探测用户是否有击键动作 getch 等待并获取用户击键值 GetLastErrorEx 取得驱动函数错误信息 第二节 线程操作函数原型说明 ( 如果您的 VB6.0 中线程无法正常运行, 可能是 VB6.0 语言本身的问题, 请选用 VB5.0) 在 VB 环境中, 创建子线程对象, 以实现多线程操作 BOOL CreateVBThread(HANDLE *hthread, LPTHREAD_START_ROUTINE RoutineAddr) Declare Function CreateVBThread Lib "USB2812" (ByRef hthread As Long, _ ByVal RoutineAddr As Long ) As Boolean 功能 : 该函数在 VB 环境中解决了不能实现或不能很好地实现多线程的问题 通过该函数用户可以很轻松地实现多线程操作 参数 : hthread 若成功创建子线程, 该参数将返回所创建的子线程的句柄, 当用户操作这个子线程时将用到这个句柄, 如启动线程 暂停线程以及删除线程等 RoutineAddr 作为子线程运行的函数的地址, 在实际使用时, 请用 AddressOf 关键字取得该子线程函数的地址, 再传递给 CreateVBThread 函数 返回值 : 当成功创建子线程时, 返回 TRUE, 且所创建的子线程为挂起状态, 用户需要用 Win32 API 函数 27

28 USB2811 WIN2000/XP 驱动程序使用说明书版本 : ResumeThread 函数启动它 若失败, 则返回 FALSE, 用户可用 GetLastError 捕获当前错误码 相关函数 : CreateVBThread TerminateVBThread 注意 : RoutineAddr 指向的函数或过程必须放在 VB 的模块文件中, 如 USB2812.Bas 文件中 Visual Basic 程序举例 : ' 在模块文件中定义子线程函数 ( 注意参考实例 ) Function NewRoutine() As Long ' 定义子线程函数 : ' 线程运行代码 NewRoutine = 1 ' 返回成功码 End Function ' ' 在窗体文件中创建子线程 : Dim hnewthread As Long If Not CreateVBThread(hNewThread, AddressOf NewRoutine) Then ' 创建新子线程 MsgBox " 创建子线程失败 " Exit Sub End If ResumeThread (hnewthread) ' 启动新线程 : : 在 VB 中, 删除子线程对象 BOOL TerminateVBThread(HANDLE hthread) Declare Function TerminateVBThread Lib "USB2812" (ByVal hthread As Long) As Boolean 功能 : 在 VB 中删除由 CreateVBThread 创建的子线程对象 参数 :hthread 指向需要删除的子线程对象的句柄, 它应由 CreateVBThread 创建 返回值 : 当成功删除子线程对象时, 返回 TRUE, 否则返回 FALSE, 用户可用 GetLastError 捕获当前错误码 相关函数 : CreateVBThread TerminateVBThread Visual Basic 程序举例 : : If Not TerminateVBThread (hnewthread) ' 终止子线程 MsgBox " 创建子线程失败 " Exit Sub End If : 创建内核系统事件 HANDLE CreateSystemEvent(void) 28

29 北京阿尔泰科技发展有限公司 Declare Function CreateSystemEvent Lib " USB2812 " ( ) As Long Function CreateSystemEvent( ) : Integer; StdCall; External 'USB2812' Name ' CreateSystemEvent '; CreateSystemEvent Return hevent Object 功能 : 创建系统内核事件对象, 它将被用于中断事件响应或数据采集线程同步事件 参数 : 无任何参数 返回值 : 若成功, 返回系统内核事件对象句柄, 否则返回 -1( 或 INVALID_HANDLE_VALUE) 释放内核系统事件 BOOL ReleaseSystemEvent(HANDLE hevent) Declare Function ReleaseSystemEvent Lib " USB2812 " (ByVal hevent As Long) As Boolean Function ReleaseSystemEvent(hEvent : Integer) : Boolean; 请参见相关演示程序 StdCall; External 'USB2812' Name ' ReleaseSystemEvent '; 功能 : 释放系统内核事件对象 参数 :hevent 被释放的内核事件对象 它应由 CreateSystemEvent 成功创建的对象 返回值 : 若成功, 则返回 TRUE 第三节 文件对象操作函数原型说明 创建文件对象 函数原型 : HANDLE CreateFileObject (HANDLE hdevice, LPCTSTR strfilename, int Mode) Declare Function CreateFileObject Lib "USB2812" (ByVal hdevice As Long, _ Function CreateFileObject ( hdevice : Integer; 请参见相关演示程序 strfilename : string; Mode : Integer) : Integer; ByVal strfilename As String, _ ByVal Mode As Integer) As Long Stdcall; external 'USB2812' Name ' CreateFileObject '; 29

30 USB2811 WIN2000/XP 驱动程序使用说明书版本 : 功能 : 初始化设备文件对象, 以期待 WriteFile 请求准备文件对象进行文件操作 参数 : hdevice 设备对象句柄, 它应由 CreateDevice 或 CreateDeviceEx 创建 strfilename 与新文件对象关联的磁盘文件名, 可以包括盘符和路径等信息 在 C 语言中, 其语法格式如 : C:\\USB2812\\Data.Dat, 在 Basic 中, 其语法格式如 : C:\USB2812\Data.Dat Mode 文件操作方式, 所用的文件操作方式控制字定义如下 ( 可通过或指令实现多种方式并操作 ): 常量名常量值功能定义 USB2812_modeRead 0x0000 只读文件方式 USB2812_modeWrite 0x0001 只写文件方式 USB2812_modeReadWrite 0x0002 既读又写文件方式 USB2812_modeCreate 0x1000 如果文件不存在可以创建该文件, 如果存在, 则重建此文 件, 且清 0 返回值 : 若成功, 则返回文件对象句柄 相关函数 : CreateDevice CreateFileObject WriteFile ReadFile ReleaseFile ReleaseDevice 通过设备对象, 往指定磁盘上写入用户空间的采样数据 函数原型 : BOOL WriteFile(HANDLE hfileobject, PVOID pdatabuffer, LONG nwritesizebytes) Declare Function WriteFile Lib "USB2812" (ByVal hfileobject As Long,_ Function WriteFile(hFileObject: Integer; 详见相关演示程序 pdatabuffer : Pointer; nwritesizebytes : Integer) : Boolean; ByRef pdatabuffer As Byte,_ Stdcall; external 'USB2812' Name ' WriteFile '; ByVal nwritesizebytes As Long) As Boolean 功能 : 通过向设备对象发送 写磁盘消息, 设备对象便会以最快的速度完成写操作 注意为了保证写入的数据是可用的, 这个操作将与用户程序保持同步, 但与设备对象中的环形内存池操作保持异步, 以得到更高的数据吞吐量, 其文件名及路径应由 CreateFileObject 函数中的 strfilename 指定 参数 : hfileobject 设备对象句柄, 它应由 CreateFileObject 创建 pdatabuffer 用户数据空间地址, 可以是用户分配的数组空间 nwritesizebytes 告诉设备对象往磁盘上一次写入数据的长度 ( 以字节为单位 ) 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 : CreateFileObject WriteFile ReadFile ReleaseFile 30

31 北京阿尔泰科技发展有限公司 通过设备对象, 从指定磁盘文件中读采样数据 函数原型 : BOOL ReadFile( HANDLE hfileobject, PVOID pdatabuffer, LONG OffsetBytes, LONG nreadsizebytes) Declare Function ReadFile Lib "USB2812" ( ByVal hfileobject As Long, _ Function ReadFile( hfileobject : Integer; 详见相关演示程序 pdatabuffer : Pointer; OffsetBytes : Integer; nreadsizebytes : Integer) : Boolean; ByRef pdatabuffer As Integer, _ ByVal OffsetBytes As Long, _ Stdcall; external 'USB2812' Name ' ReadFile '; ByVal nreadsizebytes As Long) As Boolean 功能 : 将磁盘数据从指定文件中读入用户内存空间中, 其访问方式可由用户在创建文件对象时指定 参数 : hfileobject 设备对象句柄, 它应由 CreateFileObject 创建 pdatabuffer 用于接受文件数据的用户缓冲区指针, 可以是用户分配的数组空间 OffsetBytes 指定从文件开始端所偏移的读位置 nreadsizebytes 告诉设备对象从磁盘上一次读入数据的长度 ( 以字为单位 ) 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 : CreateFileObject WriteFile ReadFile ReleaseFile 设置文件偏移位置 函数原型 : BOOL SetFileOffset (HANDLE hfileobject, LONG noffsetbytes) Declare Function SetFileOffset Lib "USB2812" (ByVal hfileobject As Long, Function SetFileOffset ( hfileobject : Integer; 详见相关演示程序 noffsetbytes : LongInt) : Boolean; ByVal noffsetbytes As Long) As Boolean Stdcall; external 'USB2812' Name ' SetFileOffset '; 31

32 USB2811 WIN2000/XP 驱动程序使用说明书 版本 : 功能 : 设置文件偏移位置, 用它可以定位读写起点 参数 :hfileobject 文件对象句柄, 它应由 CreateFileObject 创建 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 : CreateFileObject WriteFile ReadFile ReleaseFile 取得文件长度 ( 字节 ) 函数原型 : ULONG GetFileLength (HANDLE hfileobject) Declare Function GetFileLength Lib "USB2812" (ByVal hfileobject As Long) As Long Function GetFileLength (hfileobject : Integer) : LongWord; 详见相关演示程序 Stdcall; external 'USB2812' Name ' GetFileLength '; 功能 : 取得文件长度 参数 :hfileobject 设备对象句柄, 它应由 CreateFileObject 创建 返回值 : 若成功, 则返回 >1, 否则返回 0, 用户可以用 GetLastError 捕获错误码 相关函数 : CreateFileObject WriteFile ReadFile ReleaseFile 释放设备文件对象 函数原型 : BOOL ReleaseFile(HANDLE hfileobject) Declare Function ReleaseFile Lib "USB2812" (ByVal hfileobject As Long) As Boolean Function ReleaseFile(hFileObject : Integer) : Boolean; 详见相关演示程序 Stdcall; external 'USB2812' Name ' ReleaseFile '; 功能 : 释放设备文件对象 参数 :hfileobject 设备对象句柄, 它应由 CreateFileObject 创建 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 : CreateFileObject WriteFile ReadFile ReleaseFile 取得指定磁盘的可用空间 LONGLONG GetDiskFreeBytes(LPCTSTR strdiskname ) 32

33 北京阿尔泰科技发展有限公司 Declare Function GetDiskFreeBytes Lib "USB2812" (ByVal strdiskname As String ) As Currency GetDiskFreeBytes DiskName Return Disk Free Space 功能 : 取得指定磁盘的可用剩余空间 ( 以字为单位 ) 参数 :strdiskname 需要访问的盘符, 若为 C 盘为 "C:\\", D 盘为 "D:\\", 以此类推 返回值 : 若成功, 返回大于或等于 0 的长整型值, 否则返回零值, 用户可用 GetLastError 捕获错误码 注意使用 64 位整型变量 第四节 各种参数保存和读取函数原型说明 将整型变量的参数值保存在系统注册表中 函数原型 : BOOL SaveParaInt( HANDLE hdevice, LPCTSTR strparaname, int nvalue) Declare Function SaveParaInt Lib "USB2812" (ByVal hdevice As Long,_ Function SaveParaInt( hdevice : Integer; 详见相关演示程序 strparaname : String; nvalue : Integer) : Boolean; ByVal strparaname As String,_ ByVal nvalue As Integer) As Boolean Stdcall; external 'USB2812' Name ' SaveParaInt '; 功能 : 将整型变量的参数值保存在系统注册表中 具体保存位置视设备逻辑号而定 如逻辑号为 0 的其他参数保存位置为 :HKEY_CURRENT_USER\Software\Art\USB2812\Device-0\Others 参数 : hdevice 设备对象句柄, 它应由 CreateDevice 或 CreateDeviceEx 创建 strparaname 整型参数字符名 它指名该参数在注册表中的字符键项 nvalue 整型参数值 它保存在由 strparaname 命名的键项里 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 : SaveParaInt LoadParaInt SaveParaString LoadParaString 将整型变量的参数值从系统注册表中读出函数原型 : UINT LoadParaInt( HANDLE hdevice, LPCTSTR strparaname, int ndefaultval) Declare Function LoadParaInt Lib "USB2812" (ByVal hdevice As Long,_ ByVal strparaname As String,_ ByVal ndefaultval As Integer) As Long 33

34 USB2811 WIN2000/XP 驱动程序使用说明书版本 : Function LoadParaInt ( hdevice : Integer; 详见相关演示程序 strparaname : String; ndefaultval: Integer) : Longword; Stdcall; external 'USB2812' Name ' LoadParaInt '; 功能 : 将整型变量的参数值从系统注册表中读出 读出参数值的具体位置视设备逻辑号而定 如逻辑号为 0 的其他参数保存位置为 :HKEY_CURRENT_USER\Software\Art\USB2812\Device-0\Others 参数 : hdevice 设备对象句柄, 它应由 CreateDevice 或 CreateDeviceEx 创建 strparaname 整型参数字符名 它指名该参数在注册表中的字符键项 ndefaultval 若 strparaname 指定的键项不存在, 则由该参数指定的默认值返回 返回值 : 若指定的整型参数项存在, 则返回其整型值 否则返回由 ndefaultval 指定的默认值 相关函数 : SaveParaInt LoadParaInt SaveParaString LoadParaString 将字符变量的参数值保存在系统注册表中 函数原型 : BOOL SaveParaString ( HANDLE hdevice, LPCTSTR strparaname, LPCTSTR strparaval) Declare Function SaveParaString Lib "USB2812" (ByVal hdevice As Long,_ Function SaveParaString (hdevice : Integer; 详见相关演示程序 strparaname : String; strparaval: String) : Boolean; ByVal strparaname As String,_ ByVal strparaval As String) As Boolean Stdcall; external 'USB2812' Name ' SaveParaString'; 功能 : 将整型变量的参数值保存在系统注册表中 具体保存位置视设备逻辑号而定 如逻辑号为 0 的其他参数保存位置为 :HKEY_CURRENT_USER\Software\Art\USB2812\Device-0\Others 参数 : hdevice 设备对象句柄, 它应由 CreateDevice 或 CreateDeviceEx 创建 strparaname 整型参数字符名 它指名该参数在注册表中的字符键项 strparaval 字符参数值 它保存在由 strparaname 命名的键项里 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 : SaveParaInt LoadParaInt SaveParaString LoadParaString 将字符变量的参数值从系统注册表中读出 函数原型 : 34

35 北京阿尔泰科技发展有限公司 BOOL LoadParaString ( HANDLE hdevice, LPCTSTR strparaname, LPCTSTR strparaval, LPCTSTR strdefaultval) Declare Function LoadParaString Lib "USB2812" (ByVal hdevice As Long,_ Function LoadParaString ( hdevice : Integer; 详见相关演示程序 strparaname : String; strparaval : String; strdefaultval : String) : Boolean; ByVal strparaname As String,_ ByVal strparaval As String,_ ByVal strdefaultval As String) As Boolean Stdcall; external 'USB2812' Name ' LoadParaString '; 功能 : 将字符变量的参数值从系统注册表中读出 读出参数值的具体位置视设备逻辑号而定 如逻辑号为 0 的其他参数保存位置为 :HKEY_CURRENT_USER\Software\Art\USB2812\Device-0\Others 参数 : hdevice 设备对象句柄, 它应由 CreateDevice 或 CreateDeviceEx 创建 strparaname 字符参数字符名 它指名该参数在注册表中的字符键项 strparaval 取得 strparaname 指定的键项的字符值 strdefaultval 若 strparaname 指定的键项不存在, 则由该参数指定的默认值返回 返回值 : 若成功, 则返回 TRUE, 否则返回 FALSE, 用户可以用 GetLastError 捕获错误码 相关函数 : SaveParaInt LoadParaInt SaveParaString LoadParaString 第五节 其他函数原型说明 探测用户是否有按键动作 函数原型 : BOOL kbhit (void) Declare Function kbhit Lib "USB2812" () As Boolean Function kbhit () : Boolean; 详见相关演示程序 Stdcall; external 'USB2812' Name ' kbhit '; 功能 : 探测用户是否用键盘按键动作, 主要应在基于 VB DELPHI 等控制台应用程序中 参数 : 无 返回值 : 若自上次探测过后, 若用户有键盘按键动作, 则返回 TRUE, 否则返回 FALSE 35

36 USB2811 WIN2000/XP 驱动程序使用说明书版本 : 相关函数 : getch kbhit 等待按键动作并返回按键值 函数原型 : char getch (void) Declare Function getch Lib "USB2812" () As String Function getch () : char; 详见相关演示程序 Stdcall; external 'USB2812' Name 'getch'; 功能 : 探等待用户键盘按键并以字符方式返回按键值, 主要应在基于 VB DELPHI 等控制台应用程序中 参数 : 无 返回值 : 若用户没有按键动作, 此函数一直不返回, 一旦用户有按键动作, 便立即返回, 且返回其当前按键值 (ACII 码 ) 相关函数 : getch kbhit 怎样获取驱动函数错误信息 函数原型 : DWORD GetLastErrorEx (LPCTSTR strfuncname, LPCTSTR strerrormsg) Declare Function GetLastErrorEx Lib "USB2812" (ByVal strfuncname As String,_ Function GetLastErrorEx (strfuncname: String; 详见相关演示程序 strerrormsg: String) : LongWord; ByVal strerrormsg As String) As Long Stdcall; external 'USB2812' Name ' GetLastErrorEx '; 功能 : 将当某个驱动函数出错时, 可以调用此函数获得具体的错误和错误信息字串 参数 : strfuncname 出错函数的名称 注意此函数必须是完整名称, 如 AD 初始化函数 USB2812_InitDeviceAD 出现错误, 此时调用该函数时, 此参数必须为 USB2812_InitDeviceAD, 否则得不到相应信息 strerrormsg 取得指定函数的错误信息串 返回值 : 返回错误码 相关函数 : 无 Visual C++ & C++Builder 程序举例 : char strerrormsg[256]; // 用于返回错误信息字串, 要求其空间足够大 DWORD dwerrorcode; int DeviceLgcID = 0; hdevice = USB2812_CreateDevice ( DeviceLgcID ); // 创建设备对象, 并取得设备对象句柄 if(hdevice == INVALIDE_HANDLE_VALUE); // 判断设备对象句柄是否有效 36

37 北京阿尔泰科技发展有限公司 { dwerrorcode = USB2812_GetLastErrorEx( USB2812_CreateDevice, strerrormsg); AfxMessageBox(strErrorMsg); // 以对话框方式显示错误信息 return; // 退出该函数 } : Visual Basic 程序举例 : Dim strerrormsg As String ' 用于返回错误信息字串, 要求其空间足够大 Dim dwerrorcode As Long Dim DeviceLgcID As Long DeviceLgcID = 0 hdevice = USB2812_CreateDevice ( DeviceLgcID ) ' 创建设备对象, 并取得设备对象句柄 If hdevice = INVALID_HANDLE_VALUE Then ' 判断设备对象句柄是否有效 dwerrorcode = USB2812_GetLastErrorEx( USB2812_CreateDevice, strerrormsg) MsgBox strerrormsg ' 以对话框方式显示错误信息 Exit Sub ' 退出该过程 End If : 37