PDF《北京阿尔泰科技发展有限公司》

北京阿尔泰科技发展有限公司 ART2933 WIN2000/XP 驱动程序使用说明书 请您务必阅读《使用纲要》,他会使您事半功倍! 目录ART2933 WIN2000/XP 驱动程序使用说明书

1

第一章 版权信息与命名约定.

2

第一节、版权信息

2

第二节、命名约定

2

第二章 使用纲要

2

第一节、如何管理 PC104 设备.2

第二节、如何批量取得 AD 数据.2

第三节、如何实现开关量的简便操作.4

第四节、哪些函数对您不是必须的.5

第三章 PC104 设备专用函数接口介绍.5

第一节、设备驱动接口函数列表(每个函数省略了前缀 ART2933_5

第二节、设备对象管理函数原型说明.6

第三节、AD 采样操作函数原型说明.8

第四节、AD 硬件参数系统保存与读取函数原型说明.10

第五节、DA 模拟量输出操作函数原型说明.13

第六节、CNT 计数与定时器操作函数原型说明.14

第七节、DIO 数字开关量输入输出简易操作函数原型说明.15

第四章 硬件参数结构

17

第五章 数据格式转换与排列规则.18

第一节、AD 原始数据 LSB 转换成电压值 Volt 的换算方法.18

第二节、AD 采集函数的 ADBuffer 缓冲区中的数据排放规则.19

第三节、DA 电压值转换成 LSB 原码数据的换算方法.20

第六章 上层用户函数接口应用实例.20

第一节、简易程序演示说明.21

第二节、高级程序演示说明.21

第七章 公共接口函数介绍

21

第一节、公用接口函数总列表(每个函数省略了前缀 ART2933_21

第二节、线程操作函数原型说明.22

第三节、IO 端口读写函数原型说明.24

第四节、文件对象操作函数原型说明.28 提醒用户: 通常情况下,WINDOWS 系统在安装时自带的 DLL 库和驱动不全,所以您不管使用那种语言编程, 请您最好先安装上 Visual C++6.0 版本的软件,方可使我们的驱动程序有更完备的运行环境. 有关设备驱动安装和产品二次发行请参考 ART2933Inst.doc 文档.

1 ART2933 WIN2000/XP 驱动程序使用说明书 版本:6.001

第一章 版权信息与命名约定

第一节、版权信息 本软件产品及相关套件均属北京市阿尔泰科贸有限公司所有,其产权受国家法律绝对保护,除非本公司书 面允许,其他公司、单位及个人不得非法使用和拷贝,否则将受到国家法律的严厉制裁.您若需要我公司产品 及相关信息请及时与我们联系,我们将热情接待.

第二节、命名约定

一、 为简化文字内容, 突出重点, 本文中提到的函数名通常为基本功能名部分, 其前缀设备名如 PC104xxxx_ 则被省略.如ART2933_CreateDevice 则写为 CreateDevice.

二、函数名及参数中各种关键字缩写规则 缩写 全称 汉语意思 缩写 全称 汉语意思 Dev Device 设备 DI Digital Input 数字量输入 Pro Program 程序 DO Digital Output 数字量输出 Int Interrupt 中断 CNT Counter 计数器 Dma Direct Memory Access 直接内存存取 DA Digital convert 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 物理的 以上规则不局限于该产品.

第二章 使用纲要

第一节、如何管理 PC104 设备 由于我们的驱动程序采用面向对象编程,所以要使用设备的一切功能,则必须首先用CreateDevice函数创 建一个设备对象句柄hDevice,有了这个句柄,您就拥有了对该设备的控制权.然后将此句柄作为参数传递给 其他函数, 如InitDeviceAD可以使用hDevice句柄以初始化设备的AD部件并启动AD设备, ReadDeviceAD函数可 以用hDevice句柄实现对AD数据的采样批量读取,SetDeviceDO函数可用实现开关量的输出等.最后可以通过 ReleaseDevice将hDevice释放掉.

第二节、如何批量取得 AD 数据 当您有了hDevice设备对象句柄后,便可用InitDeviceAD函数初始化AD部件,关于采样通道、频率等的参 数的设置是由这个函数的pADPara参数结构体决定的.您只需要对这个pADPara参数结构体的各个成员简单赋

2 北京阿尔泰科技发展有限公司 值即可实现所有硬件参数和设备状态的初始化,然后这个函数启动AD设备.接着便可用ReadDeviceAD反复读 取AD数据以实现连续不间断采样当您需要关闭AD设备时, ReleaseDeviceAD便可帮您实现 (但设备对象hDevice 依然存在).(注:ReadDeviceAD虽然主要面对批量读取,高速连续采集而设计,但亦可用它以少量点如

32 个点读取AD数据,以满足慢速采集需要).具体执行流程请看下面的图 2.1.1. 注意:图中较粗的虚线表示对称关系.如红色虚线表示CreateDevice和ReleaseDevice两个函数的关系是: 最初执行一次CreateDevice, 在结束是就须执行一次ReleaseDevice. 绿色虚线InitDeviceAD与ReleaseDeviceAD 成对称方式出现.

3 ART2933 WIN2000/XP 驱动程序使用说明书 版本:6.001 开始 创建设备对象 CreateDevice()

第三节、如何实现开关量的简便操作 当您有了hDevice设备对象句柄后,便可用SetDeviceDO函数实现开关量的输出操作,其各路开关量的输出 状态由其bDOSts[16]中的相应元素决定.由GetDeviceDI函数实现开关量的输入操作,其各路开关量的输入状态 初始化和启动 AD InitDeviceAD() 读取 AD 数据 ReadDeviceAD () 用户对采集到的 AD 数据进行处理 其代码应由用户根据需要编写 需要再紧接着读取 AD 数据 以实现连续采集吗? 是 释放和停止 AD 设备 ReleaseDeviceAD() 需要改变通道或频率后再 采集吗? 否 重新初始化 AD 接着上次再读 AD 数据 不需要 释放设备对象 ReleaseDevice() 结束2.1.1 AD 图 采集实现过程

4 北京阿尔泰科技发展有限公司 由其bDISts[16]中的相应元素决定.

第四节、哪些函数对您不是必须的 当公共函数如CreateFileObject,WriteFile,ReadFile等一般来说都是辅助性函数,除非您要使用存盘功能. 它们

第三章 PC104 设备专用函数接口介绍

第一节、设备驱动接口函数列表(每个函数省略了前缀 ART2933_ ) 只是对我公司驱动程序的一种功能补充,对用户额外提供的. 本章函数是设备使用 PC104 方式传输时所使用的. 函数名 函数功能 备注 ① 设备对象操作函数 创建 PC104 对象(用设备逻辑号) CreateDevice GetDeviceCurrentBaseAddr 取得当前设备基地址 ReleaseDevice 关闭设备,且释放 PC104 总线设备对象 ② AD 采样操作函数 InitDev ceAD 初始化 PC104 设备 AD 部件,准备传数 i ReadDeviceAD 连续批量读取 PC104 设备上的 AD 数据 ReleaseDeviceAD 释放 PC104 设备对象中的 AD 部件 ③ 辅助函数(硬件参数设置、保存、读取函数) LoadParaAD 从Windows 系统中读取硬件参数 SaveParaAD 往Windows 系统保存硬件参数 ResetParaAD 将注册表中的 AD 参数恢复至出厂默认值 层用户 上LoadBaseAddr 将基地址从系统中读出 SaveBaseAddr 将基地址保存至系统中 ④ DA 输出操作函数 WriteDeviceDA 输出模拟信号到指定通道 ⑤计数器操作函数 SetDeviceCNT 设置计数器的初值 GetDeviceCNT 取得各路计数器的当前计数值 ⑥开关量函数 GetDeviceDI 开关输入函数 SetDeviceDO 开关输出函数 RetDeviceDO 回读开关量输出状态 使&

C++Builder: T2933.lib 两个驱动库文件从相应的演示程序文件夹下复制到您的源程序文件 夹中 ,避免重复定义和包含,您最好将以上语句放在 StdAfx.h 文件.一旦完成了 以上工作, 用需知 Visual C++ 首先将 ART2933.h 和AR ,然后在您的源程序头部添加如下语句,以便将驱动库函数接口的原型定义信息和驱动接口导入库 (ART2933.lib)加入到您的工程中. #include ART2933.H 在VC 中,为了使用方便 那么使用设备的驱动程序接口就跟使用 VC/C++Builder 自身的各种函数,其方法一样简单,毫5ART2933 WIN2000/XP 驱动程序使用说明书 版本:6.001 无二别. 关于 ART2933.h 和ART2933.lib 两个文件均可在演示程序文件夹下面找到. isual Basic: RT2933.Bas 驱动模块头文件从 VB 的演示程序文件夹下复制到您的源程序文件夹中, 然后将 注意,因考虑 Visual C++和Visual Basic 两种语言的兼容问题,在下列函数说明和示范程序中,所 举的 elphi: 将ART2933.Pas 驱动模块头文件从 Delphi 的演示程序文件夹下复制到您的源程序文件夹中,然Dndows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs, abView / CVI: 美国国家仪器公司(National Instrument)推出的一种基于图形开发、 调试和运行程序的集成

第二节、设备对象管理函数原型说明 C++ Builder: wBaseAddress) CreateDevice Lib ART2933 (ByVal wBaseAddress As Integer) As Long reateDevice(wBaseAddress : Word):Integer;

e '

CreateDevice'

;

LabView: V 首先将 A 此模块文件加入到您的 VB 工程中.其方法是选择 VB 编程环境中的工程(Project)菜单,执行其中的 添加 模块 (Add Module)命令,在弹出的对话中选择 ART2933.Bas 模块文件即可,一旦完成以上工作后,那么使 用设备的驱动程序接口就跟使用 VB 自身的各种函数,其方法一样简单,毫无二别. 请Visual Basic 程序均是需要编译后在独立环境中运行.所以用户若在解释环境中运行这些代码,我们 不保证能完全顺利运行. D 首先 后将此模块文件加入到您的 Delphi 工程中.其方法是选择 Delphi 编程环境中的 View 菜单,执行其中的 Project Manager 命令,在弹出的对话中选择*.exe 项目,再单击鼠标右键,最后 Add 指令,即可将 ART2933.Pas 单元模块文件加入到工程中.或者在 elphi 的编程环境中的 Project 菜单中,执行 Add To Project 命令,然后选择*.Pas 文件类型也能实现单元模块文件的添加.最后请在使用驱动程序接口的源程 序文件中的头部的 Uses 关键字后面的项目中加入: ART2933 .如: uses Wi ART2933;

// 注意: 在此加入驱动程序接口单元 ART2933 L LabVIEW 是 化环境,是目前国际上唯一的编译型的图形化编程语言.在以 PC 机为基础的测量和工控软件中, LabVIEW 的市场普及率仅次于 C++/C 语言.LabVIEW 开发环境具有一系列优点,从其流程图式的编程、 不需预先编译就存在的语法检查、调试过程使用的数据探针,到其丰富的函数功能、数值分析、信号处理 和设备驱动等功能,都令人称道.关于 LabView/CVI 的驱动程序接口的详细说明请参考其演示源程序. ? 创建设备对象函数 函数原型: Visual C++ &

HANDLE CreateDevice(WORD Visual Basic: Declare Function Delphi: Function C StdCall;

External '

ART2933'

Nam Return Device Object DeviceID CreateDevice

6 北京阿尔泰科技发展有限公司 功能:该函数负责创建设备对象,并返回其设备对象句柄. 参数: w wB Ba as se eA Ad dd dr re es ss s 设备基地址.板基地址可设置成 200H~3F0H 之间可被

16 整除的二进制码,板基地址默认 为3VALID_HANDLE_VALUE. 由于 00H,将占用基地址起的连续

32 个I/O 地址.具体设置请参考硬件说明书. 返回值: 如果执行成功, 则返回设备对象句柄;

如果没有成功, 则返回错误码 IN 此函数已带容错处理,即若出错,它会自动弹出一个对话框告诉您出错的原因.您只需要对此函数的返回 值作一个条件处理即可,别的任何事情您都不必做. 相关函数:ReleaseDevice ? 取得当前设备基地址 C++Builder: seAddr (HANDLE hDevice) n GetDeviceCurrentBaseAddr Lib ART2933 (ByVal hDevice As Long) As Integer GetDeviceCurrentBaseAddr (hDevice : Integer): Word;

Name '

GetDeviceCurrentBaseAddr '

;

LabView: 演示程序. 能:取得当前设备基地址. 函数原型: Visual C++ &

WORD GetDeviceCurrentBa Visual Basic: Declare Functio Delphi: Function StdCall;

External '

ART2933'

请参考相关 功 参数:h hD De ev vi ic c 它应由CreateDevice e e 设备对象句柄, 创建. 可以用 GetLastError 捕获错误码. 返回值:若成功,则返回实际设备台数,否则返回 0,用户 相关函数:CreateDevice ReleaseDevice 释放设备对象所占的系统资源及设备对象 C++Builder: LE hDevice) n ReleaseDevice Lib ART2933 (ByVal hDevice As Long ) As Boolean ReleaseDevice(hDevice : Integer):Boolean;

StdCall;

External '

ART2933'

Name '

ReleaseDevice'

;

? 函数原型: Visual C++ &

BOOL ReleaseDevice(HAND Visual Basic: Declare Functio Delphi: Function LabView: h........