ADT652驱动程序使用说明书.docx

1、ADT652驱动程序使用说明书SBS ADT652卡 驱动程序包使用说明书目 录SBS ADT652卡 驱动程序包使用说明书 1一. 介绍 41) 产品名称 42) 硬件介绍 43) 开发目的 44) 使用环境 45) 相关产品 4二. 驱动程序说明 51) 文件列表 52) 安装步骤 53) API函数 6 ADT652_DevLoad：加载设备驱动 6 ADT652_DevClose：卸载设备驱动 6 ADT652_InitBoard：设备初始化 6 ADT652_SetEvent：将通知事件发送到驱动程序 7 ADT652_ConfigIOPorts：配置数字I/O口 7 ADT652_

2、ReadDigitIO：读数字I/O口 7 ADT652_WriteDigitIO：写数字I/O口 8 ADT652_ClearIRQ：清除中断 8 ADT652_ClockMode：设置计数器定时器工作方式 9 ADT652_ClockDivisor：设置计数器定时器计数值 9 ADT652_ReadPITStatus：读取计数器定时器的状态 10 ADT652_ClockReadBack：读回计数器定时器的计数值 10 ADT652_ADSettings：设置模拟输入电压的量程和极性 10 ADT652_SetChannel：设置模拟输入通道 11 ADT652_EnableIRQ：设置中

3、断使能 11 ADT652_DisableIRQ：设置中断禁止 12 ADT652_SetIRQSource：选择中断源 12 ADT652_ADConfig：配置A/D 12 ADT652_WriteDataDA：向DA通道写DA代码 13 ADT652_ChannelSwitch：AD通道切换状态 14 ADT652_IRQStatus：中断状态 14 ADT652_StartConversion：启动A/D变换 14 ADT652_ConversionDone：监测A/D变换的状态 15 ADT652_ReadData：读取A/D变换的数据 15 ADT652_DigitToSBS：将A

4、/D变换的数据转换为输入电压值 15 ADT652_ReadADFIFOFlag：读取A/D的FIFO数据标志 16 ADT652_ADFIFOReset：复位A/D的FIFO 16 ReadIOPort：读取IO地址 16 WriteIOPort：写入IO地址 17 ADT652_GetFifo 17三. 示例程序说明 181) 硬件设置 182) 使用说明 18关键字： ADT652卡驱动、A/D变换、D/A变换、数字I/O、计数器/定时器摘要： 本文档描述了SBS ADT652卡在Windows NT(2000)下驱动程序的使用方法，主要包括了SBS ADT652卡的初始化、加载、配置、

5、A/D变换、D/A变换、I/O控制、计数/定时的API函数接口。 缩微语：无一. 介绍1) 产品名称本文档描述的对象是：SBS ADT652 Driver for Windows NT(2000).2) 硬件介绍ADT652 模块化中速模拟输入模块可将与IBM PC 兼容的PC/104 CPU 模块系统构成一个高性能的数据采集与控制系统。结构紧凑，适于嵌入式与便携式应用的ADT652 模块的特点是： 八/十六个单端模拟输入通道 12 位100KHz A/D 变换器 5V 10V 或0 到+10V 模拟输入量程可选 可用软件配置增益 -5+5V，-10+10V, 05V,010V模拟输出量程可选

6、 24 通道基于uPD71055 芯片的可编程数字量I/O 三个独立的16 位10MHz 定时器/计数器(或5MHz)3) 开发目的本文描述的是SBS ADT652卡在Windows NT(2000)操作系统下的驱动程序。使用本文描述的驱动程序，应用系统开发用户可以快速地把SBS ADT652卡集成到基于Windows NT(2000)的应用环境，屏蔽了实际的硬件系统，通过驱动提供的API函数接口，用户可以更方便、快捷地实现面对应用的开发，也可使应用系统具有较好的可移植性。4) 使用环境操作系统：Windows XP调试环境：isual C+6.0硬件环境：CDM1351-10D 、ADT65

7、2卡驱动程序：SBS ADT652 Driver for Windows2K/XP V6.05) 相关产品 二. 驱动程序说明6) 文件列表本驱动程序包提供如下文件：1） ADT652CD1Sys.sys ：该文件为驱动主体文件，包含所有API函数的实现。 2） ADT652.dll：该文件为动态链接库文件。3） ADT652.lib：该文件为静态链接库文件。4） ADT652.h ：该文件为API函数的声明头文件，在使用API函数之前必须被包含。5） ADT652CD1Sys.inf ：该文件为设备信息文件。7) 安装步骤安装步骤如下： 1、在控制面板中选择添加新硬件2、添加新硬件3、显示所

8、有设备4、从磁盘安装5、选择文件目录Driver下的ADT652CD1Sys.inf，进行安装6、配置资源，根据需要选择基地址、中断；需要注意，用中断7一定要关闭并口！7、重新启动系统8、将ADT652.dll, ADT652.lib和ADT652.h拷贝至你的应用程序所在目录下。在应用工程中引入ADT652.lib: A、如果你的ADT6520.lib放在VC标准的LIB文件夹中 单击Project- Project Settings. 在link选卡的object/library modules中加上ADT652.lib即可 B. 如果你的ADT652.lib不是放在VC标准的LIB文件夹

9、中 单击Project- Add to Project- files. 找到ADT652.lib文件,按OK 。8) API函数 ADT652_DevLoad：加载设备驱动函数原型：HANDLE ADT652_DevLoad( )函数说明：该函数通知系统加载设备驱动，然后才能对其它函数进行操作。输入：无输出：无返回值：成功返回标识此设备驱动的句柄，失败返回INVALID_HANDLE_VALUE。 ADT652_DevClose：卸载设备驱动函数原型：BOOL ADT652_DevClose(HANDLE hDevice)函数说明：该函数通知系统卸载设备驱动输入：hDevice：从ADT652

10、_DevLoad( )函数中返回的句柄输出：无返回值：成功返回1，失败返回0。 ADT652_InitBoard：设备初始化函数原型：BOOL ADT652_InitBoard (HANDLE hDevice,unsigned int BaseAddr,int irq_chn)函数说明：该函数对设备进行初始化，包括设置设备基地址、中断号等。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄BaseAddr：设备基地址irq_chn：设备中断号输出：无返回值：成功返回1，失败返回0。 ADT652_SetEvent：将通知事件发送到驱动程序函数原型：int ADT600_

11、SetEvent(HANDLE hDevice, HANDLE hEvent)函数说明：该函数用来将通知事件发送到驱动程序。具体参照示例程序。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄hEvent: 事件句柄输出：无返回值：成功返回0，失败返回非0的错误值。 ADT652_ConfigIOPorts：配置数字I/O口 函数原型：void ADT652_ConfigIOPorts(HANDLE hDevice,unsigned char Port0, unsigned char Port1,unsigned char Port2)函数说明：该函数对71055芯片的

12、3个I/O口工作于模式0进行配置输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄Port0：71055芯片的口，表示输入，表示输出Port1：71055芯片的B口，表示输入，表示输出Port2：71055芯片的C口，表示输入，表示输出输出：无返回值：无 ADT652_ReadDigitIO：读数字I/O口 函数原型：unsigned char ADT652_ReadDigitIO(HANDLE hDevice,unsigned char InputPort);函数说明：该函数对71055芯片的3个I/O口进行读操作。输入：hDevice：从ADT652_DevLoad

13、( )函数中返回的句柄InputPort：71055芯片的3个I/O口，表示口，表示口，表示口输出：无返回值：返回从指定I/O口读出的值 ADT652_WriteDigitIO：写数字I/O口 函数原型：void ADT652_WriteDigitIO(HANDLE hDevice,unsigned char OutputPort, unsigned char v);函数说明：该函数对71055芯片的3个I/O口进行写操作。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄OutputPort：71055芯片的3个I/O口，表示口，表示口，表示口v： 从指定I/O口写入

14、的值 输出：无返回值：无 ADT652_ClearIRQ：清除中断 函数原型：void ADT652_ClearIRQ(HANDLE hDevice)函数说明：该函数用于清除中断。在中断产生后必须调用该函数。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄输出：无返回值：无 ADT652_ClockMode：设置计数器定时器工作方式 函数原型：void ADT652_ClockMode(HANDLE hDevice,unsigned char Clock, unsigned char Mode)函数说明：该函数对82C54芯片的3个计数器定时器的工作方式进行设置（AD

15、T652有2个82C54，共计6个数器定时器）。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄Clock：82C54芯片的3个计数器定时器，表示计数器，表示计数器，表示计数器（对于ADT652，第二个82C54的3个计数器定时器分别表示为：3表示计数器，4表示计数器，5表示计数器）Mode：82C54芯片的工作方式，分别表示方式方式输出：无返回值：无 ADT652_ClockDivisor：设置计数器定时器计数值函数原型：void ADT652_ClockDivisor(HANDLE hDevice,unsigned char Clock, unsigned int

16、 Divisor)函数说明：该函数对82C54芯片的3个计数器定时器的计数值进行设置（ADT652有2个82C54，共计6个数器定时器）输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄Clock：82C54芯片的3个计数器定时器，表示计数器，表示计数器，表示计数器（对于ADT652，第二个82C54的3个计数器定时器分别表示为：3表示计数器，4表示计数器，5表示计数器）Divisor： 16位计数器定时器的计数值 输出：无返回值：无 ADT652_ReadPITStatus：读取计数器定时器的状态函数原型：char ADT652_ReadPITStatus(HANDL

17、E hDevice,unsigned char Timer)函数说明：该函数对82C54芯片的3个计数器定时器的单次计数状态进行读取（ADT652有2个82C54，共计6个数器定时器）。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄Timer：82C54芯片的3个计数器定时器，表示计数器，表示计数器，表示计数器（对于ADT652，第二个82C54的3个计数器定时器分别表示为：3表示计数器，4表示计数器，5表示计数器）输出：无返回值：单次计数结束返回，否则返回。 ADT652_ClockReadBack：读回计数器定时器的计数值函数原型：unsigned int AD

18、T652_ClockReadBack(HANDLE hDevice, char Timer)函数说明：该函数对82C54芯片的3个计数器定时器的计数值进行读取（ADT652有2个82C54，共计6个数器定时器）。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄Timer：82C54芯片的3个计数器定时器，表示计数器，表示计数器，表示计数器（对于ADT652，第二个82C54的3个计数器定时器分别表示为：3表示计数器，4表示计数器，5表示计数器）输出：无返回值：返回读取的计数器定时器的计数值。 ADT652_ADSettings：设置模拟输入电压的量程和极性函数原型：v

19、oid ADT652_ADSettings(HANDLE hDevice,float Range, char Polarity)函数说明：该函数对模拟输入电压的量程和极性进行设置。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄Range：模拟输入电压的量程,可输入5和10Polarity：模拟输入电压的极性,0表示单极性,1表示双极性 输出：无返回值：无。 ADT652_SetChannel：设置模拟输入通道函数原型：void ADT652_SetChannel(HANDLE hDevice,unsigned int ChannelL, unsigned int C

20、hannelH)函数说明：该函数对模拟输入通道进行设置。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄ChannelL：模拟输入低通道, 可输入015，分别表示通道1通道16ChannelH：模拟输入高通道, 可输入015，分别表示通道1通道16注：低通道和高通道相同表示同一通道。输出：无返回值：无。 ADT652_EnableIRQ：设置中断使能函数原型：void ADT652_EnableIRQ(HANDLE hDevice)函数说明：该函数设置中断使能。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄输出：无返回值：无。 ADT652

21、_DisableIRQ：设置中断禁止函数原型：void ADT652_DisableIRQ (HANDLE hDevice)函数说明：该函数设置中断禁止。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄输出：无返回值：无。 ADT652_SetIRQSource：选择中断源函数原型：void ADT652_SetIRQSource(HANDLE hDevice,unsigned char IrqSou)函数说明：该函数选择中断源。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄IrqSou：0表示AD转换数据有效，1表示计数/定时器0输出，2

22、表示外部中断，3表示计数/定时器1输出，4表示计数/定时器3输出，5表示计数/定时器4输出，6表示计数/定时器5输出。输出：无返回值：无。注： AD 转换数据有效表示：当FIFOEn 为“1”时，FIFO 半满标记（HF）触发中断当FIFOEn 为“0”时，AD 转换结束触发中断 FIFOEn是函数ADT652_ADConfig的参数 ADT652_ADConfig：配置A/D函数原型：void ADT652_ADConfig(HANDLE hDevice unsigned char Timer2Con, unsigned char DMACon,unsigned char ADTrig,un

23、signed char GainCon，unsigned char FIFOEn);函数说明：该函数用来配置A/D的转换触发方式、可编程增益放大控制和FIFO 选择等。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄 Timer2Con：A/D转换计数/定时器2(OUT2)触发使能控制。置“0”时为不允许计数/定时器2(OUT2)触发(缺省)。置“1”时为允许计数/定时器2(OUT2)触发。DMACon： A/D转换DMA传送使能控制。置“0”时为不允许DMA(缺省)。置“1”时为允许DMA。ADTrig： A/D转换触发方式配置。置“0”时为软件触发。置“1”时为硬

24、件触发。GainCon： 可编程增益放大控制。 置“1”时增益为1。 置“2”时增益为2。 置“4”时增益为4。 置“8”时增益为8。通过增益放大可对一些较弱信号进行采集，提高其精度。 FOFIEn：AD 转换数据FIFO 选择置“0”时为FIFO 禁止。置“1”时为AD 转换的数据进入FIFO。输出：无返回值：无。 ADT652_WriteDataDA：向DA通道写DA代码函数原型：void ADT652_WriteDataDA(HANDLE hDevice,unsigned int DAChannel, int DigitalValue)函数说明：该函数向DA通道写DA代码。输入：hDev

25、ice：从ADT652_DevLoad( )函数中返回的句柄DAChannel：DA通道，可输入03，分别表示通道0通道3DigitalValue： DA代码输出：无返回值：无 ADT652_ChannelSwitch：AD通道切换状态函数原型：unsigned char ADT652_ChannelSwitch(HANDLE hDevice)函数说明：该函数返回AD通道切换状态。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄输出：无返回值：AD通道切换完成返回0，否则返回1 ADT652_IRQStatus：中断状态函数原型：unsigned char ADT65

26、2_IRQStatus(HANDLE hDevice)函数说明：该函数返回中断状态。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄输出：无返回值：有中断返回1，否则返回0 ADT652_StartConversion：启动A/D变换函数原型：void ADT652_StartConversion(HANDLE hDevice)函数说明：该函数用于软件启动A/D变换。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄输出：无返回值：无。 ADT652_ConversionDone：监测A/D变换的状态函数原型：char ADT652_Conve

27、rsionDone(HANDLE hDevice)函数说明：该函数用于监测A/D变换的状态。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄输出：无返回值：A/D变换结束返回0, 否则返回1。 ADT652_ReadData：读取A/D变换的数据函数原型：int ADT652_ReadData(HANDLE hDevice)函数说明：该函数用于读取A/D变换的数据。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄输出：无返回值：返回读取的A/D变换的数据。 ADT652_DigitToSBS：将A/D变换的数据转换为输入电压值 函数原型：fl

28、oat ADT652_DigitToSBS(HANDLE hDevice,int DigitalValue,int *Curcha)函数说明：该函数用于将A/D变换的数据转换为输入电压值。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄DigitalValue：A/D变换的数据输出：*Curcha：指向当前采样通道返回值：返回转换后的输入电压值。 ADT652_ReadADFIFOFlag：读取A/D的FIFO数据标志函数原型：unsigned char ADT652_ReadADFIFOFlag(HANDLE hDevice)函数说明：该函数用于读取A/D的FIFO

29、数据标志。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄输出：无返回值：返回1表示FIFO数据半满，返回2表示FIFO数据全满，返回3表示FIFO数据空。 ADT652_ADFIFOReset：复位A/D的FIFO函数原型：void ADT652_ADFIFOReset(HANDLE hDevice)函数说明：该函数用于复位A/D的FIFO。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄输出：无返回值：无。 ReadIOPort：读取IO地址函数原型：unsigned charReadIOPort(HANDLE hDevice,unsigned int portAddr)函数说明：该函数对指定的IO地址进行读取。输入：hDevice：从ADT652_DevLoad( )函数中返回的句柄portAddr：IO地址输出：无返回值：返回从指定的IO地址读取的值。 WriteIOPort：写入IO地址 函数原型：void WriteIOPort(HANDLE hDevice,unsigned