驅(qū)動(dòng)程序使用說明書

SBSADT652卡驅(qū)動(dòng)程序包使用說明書目錄TOC\o"1-4"\h\zSBSADT652卡驅(qū)動(dòng)程序包使用說明書 1一. 介紹 41) 產(chǎn)品名稱 42) 硬件介紹 43) 開發(fā)目的 44) 使用環(huán)境 45) 相關(guān)產(chǎn)品 4二. 驅(qū)動(dòng)程序說明 51) 文獻(xiàn)列表 52) 安裝環(huán)節(jié) 53) API函數(shù) 6 ADT652_DevLoad：加載設(shè)備驅(qū)動(dòng) 6 ADT652_DevClose：卸載設(shè)備驅(qū)動(dòng) 6 ADT652_InitBoard：設(shè)備初始化 6 ADT652_SetEvent：將告知事件發(fā)送到驅(qū)動(dòng)程序 7 ADT652_ConfigIOPorts：配置數(shù)字I/O口 7 ADT652_ReadDigitIO：讀數(shù)字I/O口 7 ADT652_WriteDigitIO：寫數(shù)字I/O口 8 ADT652_ClearIRQ：清除中斷 8 ADT652_ClockMode：設(shè)立計(jì)數(shù)器／定期器工作方式 9 ADT652_ClockDivisor：設(shè)立計(jì)數(shù)器／定期器計(jì)數(shù)值 9 ADT652_ReadPITStatus：讀取計(jì)數(shù)器／定期器的狀態(tài) 10 ADT652_ClockReadBack：讀回計(jì)數(shù)器／定期器的計(jì)數(shù)值 10 ADT652_ADSettings：設(shè)立模擬輸入電壓的量程和極性 10 ADT652_SetChannel：設(shè)立模擬輸入通道 11 ADT652_EnableIRQ：設(shè)立中斷使能 11 ADT652_DisableIRQ：設(shè)立中斷嚴(yán)禁 12 ADT652_SetIRQSource：選擇中斷源 12 ADT652_ADConfig：配置A/D 12 ADT652_WriteDataDA：向DA通道寫DA代碼 13 ADT652_ChannelSwitch：AD通道切換狀態(tài) 14 ADT652_IRQStatus：中斷狀態(tài) 14 ADT652_StartConversion：啟動(dòng)A/D變換 14 ADT652_ConversionDone：監(jiān)測A/D變換的狀態(tài) 15 ADT652_ReadData：讀取A/D變換的數(shù)據(jù) 15 ADT652_DigitToSBS：將A/D變換的數(shù)據(jù)轉(zhuǎn)換為輸入電壓值 15 ADT652_ReadADFIFOFlag：讀取A/D的FIFO數(shù)據(jù)標(biāo)志 16 ADT652_ADFIFOReset：復(fù)位A/D的FIFO 16 ReadIOPort：讀取IO地址 16 WriteIOPort：寫入IO地址 17 ADT652_GetFifo 17三. 示例程序說明 181) 硬件設(shè)立 182) 使用說明 18

關(guān)鍵字：ADT652卡驅(qū)動(dòng)、A/D變換、D/A變換、數(shù)字I/O、計(jì)數(shù)器/定期器摘要：本文檔描述了SBSADT652卡在WindowsNT(2023)下驅(qū)動(dòng)程序的使用方法，重要涉及了SBSADT652卡的初始化、加載、配置、A/D變換、D/A變換、I/O控制、計(jì)數(shù)/定期的API函數(shù)接口。縮微語：無

介紹產(chǎn)品名稱本文檔描述的對象是：SBSADT652DriverforWindowsNT(2023).硬件介紹ADT652模塊化中速模擬輸入模塊可將與IBMPC兼容的PC/104CPU模塊系統(tǒng)構(gòu)成一個(gè)高性能的數(shù)據(jù)采集與控制系統(tǒng)。結(jié)構(gòu)緊湊，適于嵌入式與便攜式應(yīng)用的ADT652模塊的特點(diǎn)是：八/十六個(gè)單端模擬輸入通道12位100KHzA/D變換器±5V±10V或0到+10V模擬輸入量程可選可用軟件配置增益-5~+5V，-10~+10V,0~5V,0~10V模擬輸出量程可選24通道基于uPD71055芯片的可編程數(shù)字量I/O三個(gè)獨(dú)立的16位10MHz定期器/計(jì)數(shù)器(或5MHz)開發(fā)目的本文描述的是SBSADT652卡在WindowsNT(2023)操作系統(tǒng)下的驅(qū)動(dòng)程序。使用本文描述的驅(qū)動(dòng)程序，應(yīng)用系統(tǒng)開發(fā)用戶可以快速地把SBSADT652卡集成到基于WindowsNT(2023)的應(yīng)用環(huán)境，屏蔽了實(shí)際的硬件系統(tǒng)，通過驅(qū)動(dòng)提供的API函數(shù)接口，用戶可以更方便、快捷地實(shí)現(xiàn)面相應(yīng)用的開發(fā)，也可使應(yīng)用系統(tǒng)具有較好的可移植性。使用環(huán)境操作系統(tǒng)：WindowsXP調(diào)試環(huán)境：ＶisualC++6.0硬件環(huán)境：CDM1351-10D、ADT652卡驅(qū)動(dòng)程序：SBSADT652DriverforWindows2K/XPV6.0相關(guān)產(chǎn)品

驅(qū)動(dòng)程序說明文獻(xiàn)列表本驅(qū)動(dòng)程序包提供如下文獻(xiàn)：ADT652CD1Sys.sys：該文獻(xiàn)為驅(qū)動(dòng)主體文獻(xiàn)，包含所有API函數(shù)的實(shí)現(xiàn)。ADT652.dll：該文獻(xiàn)為動(dòng)態(tài)鏈接庫文獻(xiàn)。ADT652.lib：該文獻(xiàn)為靜態(tài)鏈接庫文獻(xiàn)。ADT652.h：該文獻(xiàn)為API函數(shù)的聲明頭文獻(xiàn)，在使用API函數(shù)之前必須被包含。ADT652CD1Sys.inf：該文獻(xiàn)為設(shè)備信息文獻(xiàn)。安裝環(huán)節(jié)安裝環(huán)節(jié)如下：1、在控制面板中選擇添加新硬件2、添加新硬件3、顯示所有設(shè)備4、從磁盤安裝5、選擇文獻(xiàn)目錄Driver下的ADT652CD1Sys.inf，進(jìn)行安裝6、配置資源，根據(jù)需要選擇基地址、中斷；需要注意，用中斷7一定要關(guān)閉并口！7、重新啟動(dòng)系統(tǒng)8、將ADT652.dll,ADT652.lib和ADT652.h拷貝至你的應(yīng)用程序所在目錄下。在應(yīng)用工程中引入ADT652.lib:A、假如你的ADT6520.lib放在VC標(biāo)準(zhǔn)的LIB文獻(xiàn)夾中單擊Project->ProjectSettings...在link選卡的object/librarymodules中加上ADT652.lib即可B.假如你的ADT652.lib不是放在VC標(biāo)準(zhǔn)的LIB文獻(xiàn)夾中單擊Project->AddtoProject->files...找到ADT652.lib文獻(xiàn),按OK。

API函數(shù)ADT652_DevLoad：加載設(shè)備驅(qū)動(dòng)函數(shù)原型：HANDLEADT652_DevLoad()函數(shù)說明：該函數(shù)告知系統(tǒng)加載設(shè)備驅(qū)動(dòng)，然后才干對其它ＡＰＩ函數(shù)進(jìn)行操作。輸入：無輸出：無返回值：成功返回標(biāo)記此設(shè)備驅(qū)動(dòng)的句柄，失敗返回INVALID_HANDLE_VALUE。ADT652_DevClose：卸載設(shè)備驅(qū)動(dòng)函數(shù)原型：BOOLADT652_DevClose(HANDLEhDevice)函數(shù)說明：該函數(shù)告知系統(tǒng)卸載設(shè)備驅(qū)動(dòng)．輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：成功返回1，失敗返回0。ADT652_InitBoard：設(shè)備初始化函數(shù)原型：BOOLADT652_InitBoard(HANDLEhDevice,unsignedintBaseAddr,intirq_chn)函數(shù)說明：該函數(shù)對設(shè)備進(jìn)行初始化，涉及設(shè)立設(shè)備基地址、中斷號(hào)等。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄BaseAddr：設(shè)備基地址irq_chn：設(shè)備中斷號(hào)輸出：無返回值：成功返回1，失敗返回0。ADT652_SetEvent：將告知事件發(fā)送到驅(qū)動(dòng)程序函數(shù)原型：intADT600_SetEvent(HANDLEhDevice,HANDLEhEvent)函數(shù)說明：該函數(shù)用來將告知事件發(fā)送到驅(qū)動(dòng)程序。具體參照示例程序。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄hEvent:事件句柄輸出：無返回值：成功返回0，失敗返回非0的錯(cuò)誤值。ADT652_ConfigIOPorts：配置數(shù)字I/O口函數(shù)原型：voidADT652_ConfigIOPorts(HANDLEhDevice,unsignedcharPort0,unsignedcharPort1,unsignedcharPort2)函數(shù)說明：該函數(shù)對71055芯片的3個(gè)I/O口工作于模式0進(jìn)行配置輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄Port0：71055芯片的Ａ口，１表達(dá)輸入，０表達(dá)輸出Port1：71055芯片的B口，１表達(dá)輸入，０表達(dá)輸出Port2：71055芯片的C口，１表達(dá)輸入，０表達(dá)輸出輸出：無返回值：無ADT652_ReadDigitIO：讀數(shù)字I/O口函數(shù)原型：unsignedcharADT652_ReadDigitIO(HANDLEhDevice,unsignedcharInputPort);函數(shù)說明：該函數(shù)對71055芯片的3個(gè)I/O口進(jìn)行讀操作。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄InputPort：71055芯片的3個(gè)I/O口，０表達(dá)Ａ口，１表達(dá)Ｂ口，２表達(dá)Ｃ口輸出：無返回值：返回從指定I/O口讀出的值A(chǔ)DT652_WriteDigitIO：寫數(shù)字I/O口函數(shù)原型：voidADT652_WriteDigitIO(HANDLEhDevice,unsignedcharOutputPort,unsignedcharv);函數(shù)說明：該函數(shù)對71055芯片的3個(gè)I/O口進(jìn)行寫操作。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄OutputPort：71055芯片的3個(gè)I/O口，０表達(dá)Ａ口，１表達(dá)Ｂ口，２表達(dá)Ｃ口v：從指定I/O口寫入的值輸出：無返回值：無ADT652_ClearIRQ：清除中斷函數(shù)原型：voidADT652_ClearIRQ(HANDLEhDevice)函數(shù)說明：該函數(shù)用于清除中斷。在中斷產(chǎn)生后必須調(diào)用該函數(shù)。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：無ADT652_ClockMode：設(shè)立計(jì)數(shù)器／定期器工作方式函數(shù)原型：voidADT652_ClockMode(HANDLEhDevice,unsignedcharClock,unsignedcharMode)函數(shù)說明：該函數(shù)對82C54芯片的3個(gè)計(jì)數(shù)器／定期器的工作方式進(jìn)行設(shè)立（ADT652有2個(gè)82C54，共計(jì)6個(gè)數(shù)器／定期器）。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄Clock：82C54芯片的3個(gè)計(jì)數(shù)器／定期器，０表達(dá)計(jì)數(shù)器０，１表達(dá)計(jì)數(shù)器１，２表達(dá)計(jì)數(shù)器２（對于ADT652，第二個(gè)82C54的3個(gè)計(jì)數(shù)器／定期器分別表達(dá)為：3表達(dá)計(jì)數(shù)器０，4表達(dá)計(jì)數(shù)器１，5表達(dá)計(jì)數(shù)器２）Mode：82C54芯片的工作方式，０～５分別表達(dá)方式０～方式５輸出：無返回值：無ADT652_ClockDivisor：設(shè)立計(jì)數(shù)器／定期器計(jì)數(shù)值函數(shù)原型：voidADT652_ClockDivisor(HANDLEhDevice,unsignedcharClock,unsignedintDivisor)函數(shù)說明：該函數(shù)對82C54芯片的3個(gè)計(jì)數(shù)器／定期器的計(jì)數(shù)值進(jìn)行設(shè)立（ADT652有2個(gè)82C54，共計(jì)6個(gè)數(shù)器／定期器）輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄Clock：82C54芯片的3個(gè)計(jì)數(shù)器／定期器，０表達(dá)計(jì)數(shù)器０，１表達(dá)計(jì)數(shù)器１，２表達(dá)計(jì)數(shù)器２（對于ADT652，第二個(gè)82C54的3個(gè)計(jì)數(shù)器／定期器分別表達(dá)為：3表達(dá)計(jì)數(shù)器０，4表達(dá)計(jì)數(shù)器１，5表達(dá)計(jì)數(shù)器２）Divisor：16位計(jì)數(shù)器／定期器的計(jì)數(shù)值輸出：無返回值：無ADT652_ReadPITStatus：讀取計(jì)數(shù)器／定期器的狀態(tài)函數(shù)原型：charADT652_ReadPITStatus(HANDLEhDevice,unsignedcharTimer)函數(shù)說明：該函數(shù)對82C54芯片的3個(gè)計(jì)數(shù)器／定期器的單次計(jì)數(shù)狀態(tài)進(jìn)行讀?。ˋDT652有2個(gè)82C54，共計(jì)6個(gè)數(shù)器／定期器）。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄Timer：82C54芯片的3個(gè)計(jì)數(shù)器／定期器，０表達(dá)計(jì)數(shù)器０，１表達(dá)計(jì)數(shù)器１，２表達(dá)計(jì)數(shù)器２（對于ADT652，第二個(gè)82C54的3個(gè)計(jì)數(shù)器／定期器分別表達(dá)為：3表達(dá)計(jì)數(shù)器０，4表達(dá)計(jì)數(shù)器１，5表達(dá)計(jì)數(shù)器２）輸出：無返回值：單次計(jì)數(shù)結(jié)束返回１，否則返回０。ADT652_ClockReadBack：讀回計(jì)數(shù)器／定期器的計(jì)數(shù)值函數(shù)原型：unsignedintADT652_ClockReadBack(HANDLEhDevice,charTimer)函數(shù)說明：該函數(shù)對82C54芯片的3個(gè)計(jì)數(shù)器／定期器的計(jì)數(shù)值進(jìn)行讀?。ˋDT652有2個(gè)82C54，共計(jì)6個(gè)數(shù)器／定期器）。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄Timer：82C54芯片的3個(gè)計(jì)數(shù)器／定期器，０表達(dá)計(jì)數(shù)器０，１表達(dá)計(jì)數(shù)器１，２表達(dá)計(jì)數(shù)器２（對于ADT652，第二個(gè)82C54的3個(gè)計(jì)數(shù)器／定期器分別表達(dá)為：3表達(dá)計(jì)數(shù)器０，4表達(dá)計(jì)數(shù)器１，5表達(dá)計(jì)數(shù)器２）輸出：無返回值：返回讀取的計(jì)數(shù)器／定期器的計(jì)數(shù)值。ADT652_ADSettings：設(shè)立模擬輸入電壓的量程和極性函數(shù)原型：voidADT652_ADSettings(HANDLEhDevice,floatRange,charPolarity)函數(shù)說明：該函數(shù)對模擬輸入電壓的量程和極性進(jìn)行設(shè)立。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄Range：模擬輸入電壓的量程,可輸入5和10Polarity：模擬輸入電壓的極性,0表達(dá)單極性,1表達(dá)雙極性輸出：無返回值：無。ADT652_SetChannel：設(shè)立模擬輸入通道函數(shù)原型：voidADT652_SetChannel(HANDLEhDevice,unsignedintChannelL,unsignedintChannelH)函數(shù)說明：該函數(shù)對模擬輸入通道進(jìn)行設(shè)立。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄ChannelL：模擬輸入低通道,可輸入0～15，分別表達(dá)通道1～通道16ChannelH：模擬輸入高通道,可輸入0～15，分別表達(dá)通道1～通道16注：低通道和高通道相同表達(dá)同一通道。輸出：無返回值：無。ADT652_EnableIRQ：設(shè)立中斷使能函數(shù)原型：voidADT652_EnableIRQ(HANDLEhDevice)函數(shù)說明：該函數(shù)設(shè)立中斷使能。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：無。ADT652_DisableIRQ：設(shè)立中斷嚴(yán)禁函數(shù)原型：voidADT652_DisableIRQ(HANDLEhDevice)函數(shù)說明：該函數(shù)設(shè)立中斷嚴(yán)禁。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：無。ADT652_SetIRQSource：選擇中斷源函數(shù)原型：voidADT652_SetIRQSource(HANDLEhDevice,unsignedcharIrqSou)函數(shù)說明：該函數(shù)選擇中斷源。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄IrqSou：0表達(dá)AD轉(zhuǎn)換數(shù)據(jù)有效，1表達(dá)計(jì)數(shù)/定期器0輸出，2表達(dá)外部中斷，3表達(dá)計(jì)數(shù)/定期器1輸出，4表達(dá)計(jì)數(shù)/定期器3輸出，5表達(dá)計(jì)數(shù)/定期器4輸出，6表達(dá)計(jì)數(shù)/定期器5輸出。輸出：無返回值：無。注：AD轉(zhuǎn)換數(shù)據(jù)有效表達(dá)：當(dāng)FIFOEn為“1”時(shí)，F(xiàn)IFO半滿標(biāo)記（HF）觸發(fā)中斷當(dāng)FIFOEn為“0”時(shí)，AD轉(zhuǎn)換結(jié)束觸發(fā)中斷FIFOEn是函數(shù)ADT652_ADConfig的參數(shù)ADT652_ADConfig：配置A/D函數(shù)原型：voidADT652_ADConfig(HANDLEhDeviceunsignedcharTimer2Con,unsignedcharDMACon,unsignedcharADTrig,unsignedcharGainCon，unsignedcharFIFOEn);函數(shù)說明：該函數(shù)用來配置A/D的轉(zhuǎn)換觸發(fā)方式、可編程增益放大控制和FIFO選擇等。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄Timer2Con：A/D轉(zhuǎn)換計(jì)數(shù)/定期器2(OUT2)觸發(fā)使能控制。置“0”時(shí)為不允許計(jì)數(shù)/定期器2(OUT2)觸發(fā)(缺省)。置“1”時(shí)為允許計(jì)數(shù)/定期器2(OUT2)觸發(fā)。DMACon：A/D轉(zhuǎn)換DMA傳送使能控制。置“0”時(shí)為不允許DMA(缺省)。置“1”時(shí)為允許DMA。ADTrig：A/D轉(zhuǎn)換觸發(fā)方式配置。置“0”時(shí)為軟件觸發(fā)。置“1”時(shí)為硬件觸發(fā)。GainCon：可編程增益放大控制。置“1”置“2”置“4”置“8”通過增益放大可對一些較弱信號(hào)進(jìn)行采集，提高其精度。FOFIEn：AD轉(zhuǎn)換數(shù)據(jù)FIFO選擇置“0”時(shí)為FIFO嚴(yán)禁。置“1”時(shí)為AD轉(zhuǎn)換的數(shù)據(jù)進(jìn)入FIFO。輸出：無返回值：無。ADT652_WriteDataDA：向DA通道寫DA代碼函數(shù)原型：voidADT652_WriteDataDA(HANDLEhDevice,unsignedintDAChannel,intDigitalValue)函數(shù)說明：該函數(shù)向DA通道寫DA代碼。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄DAChannel：DA通道，可輸入0～3，分別表達(dá)通道0～通道3DigitalValue：DA代碼輸出：無返回值：無ADT652_ChannelSwitch：AD通道切換狀態(tài)函數(shù)原型：unsignedcharADT652_ChannelSwitch(HANDLEhDevice)函數(shù)說明：該函數(shù)返回AD通道切換狀態(tài)。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：AD通道切換完畢返回0，否則返回1ADT652_IRQStatus：中斷狀態(tài)函數(shù)原型：unsignedcharADT652_IRQStatus(HANDLEhDevice)函數(shù)說明：該函數(shù)返回中斷狀態(tài)。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：有中斷返回1，否則返回0ADT652_StartConversion：啟動(dòng)A/D變換函數(shù)原型：voidADT652_StartConversion(HANDLEhDevice)函數(shù)說明：該函數(shù)用于軟件啟動(dòng)A/D變換。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：無。ADT652_ConversionDone：監(jiān)測A/D變換的狀態(tài)函數(shù)原型：charADT652_ConversionDone(HANDLEhDevice)函數(shù)說明：該函數(shù)用于監(jiān)測A/D變換的狀態(tài)。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：A/D變換結(jié)束返回0,否則返回1。ADT652_ReadData：讀取A/D變換的數(shù)據(jù)函數(shù)原型：intADT652_ReadData(HANDLEhDevice)函數(shù)說明：該函數(shù)用于讀取A/D變換的數(shù)據(jù)。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：返回讀取的A/D變換的數(shù)據(jù)。ADT652_DigitToSBS：將A/D變換的數(shù)據(jù)轉(zhuǎn)換為輸入電壓值函數(shù)原型：floatADT652_DigitToSBS(HANDLEhDevice,intDigitalValue,int*Curcha)函數(shù)說明：該函數(shù)用于將A/D變換的數(shù)據(jù)轉(zhuǎn)換為輸入電壓值。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄DigitalValue：A/D變換的數(shù)據(jù)輸出：*Curcha：指向當(dāng)前采樣通道返回值：返回轉(zhuǎn)換后的輸入電壓值。ADT652_ReadADFIFOFlag：讀取A/D的FIFO數(shù)據(jù)標(biāo)志函數(shù)原型：unsignedcharADT652_ReadADFIFOFlag(HANDLEhDevice)函數(shù)說明：該函數(shù)用于讀取A/D的FIFO數(shù)據(jù)標(biāo)志。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：返回1表達(dá)FIFO數(shù)據(jù)半滿，返回2表達(dá)FIFO數(shù)據(jù)全滿，返回3表達(dá)FIFO數(shù)據(jù)空。ADT652_ADFIFOReset：復(fù)位A/D的FIFO函數(shù)原型：voidADT652_ADFIFOReset(HANDLEhDevice)函數(shù)說明：該函數(shù)用于復(fù)位A/D的FIFO。輸入：hDevice：從ADT652_DevLoad()函數(shù)中返回的句柄輸出：無返回值：無。ReadIOPort：讀取IO地址函數(shù)原型：unsignedcharReadIOP