1、LabWindows/CVI編程說(shuō)明2009-8-3VER1.0北京瑞博華公司的板卡全面支持LabWindows/CVI的編程，而且編程方法非常簡(jiǎn)潔、為您快速開(kāi)發(fā)應(yīng)用系統(tǒng)創(chuàng)造條件。本公司提供完整的編程實(shí)例和詳盡的說(shuō)明，以及全漢字的軟件注解，還有本公司提供全面的編程技術(shù)與駛件技術(shù)服務(wù)，這些都為您的開(kāi)發(fā)鋪平了道路。由于采用相同的接【I方式，本例程對(duì)北京瑞博華公司的全部產(chǎn)品都適用。為了便您理解和應(yīng)用，本說(shuō)明主要以實(shí)例為基礎(chǔ)來(lái)說(shuō)明在LabWindows/CVI卜的編程方法，本實(shí)例的開(kāi)發(fā)環(huán)境是CVI8.5o一、編程實(shí)例的主要文件搜索文件夾11;卜!DeyelopCVI_rbhYjAdcard.libi大

2、小|類(lèi)型|修改日期Demo.hcvi.RBX.cws甲CVTRBK.exe百CVI_RBH.prjcKBHCVI_Demo.c.yRBHCVIDemo.hULrLabWindows/CW例程目錄說(shuō)明.txt11KBLibrary2009-8-2IE5KBCHeelerfile2009-8-3174KBUbWiKdows/CVI.2009-8-32C211KB應(yīng)用程序2009-8-32C5KBLbWindowE兀VI2009-8-32C11KBCSourcefile2009-3-32C3KBCHeaderfile2009-8-31712KBUbWiKdows/CVI.2009-8-32C1KB文

3、本文檔2009-3-32C圖1編程實(shí)例文件目錄如圖1所示，目錄中包括9個(gè)文件，這9個(gè)文件分為三類(lèi)，分別介紹如卜：第一類(lèi)：北京瑞博華公司提供的接口程序：Acard.Lib:北京瑞博華公司專(zhuān)用的庫(kù)接II聲明程序，通過(guò)該程序?qū)崿F(xiàn)對(duì)動(dòng)態(tài)鏈接庫(kù)(DLL)訪(fǎng)問(wèn)。該程序訪(fǎng)問(wèn)的DLL是Adcaird.dlL,Adcard.dll隨駛件提供，當(dāng)安裝驅(qū)動(dòng)程序時(shí)，Windows系統(tǒng)會(huì)自動(dòng)將Adcard.dll程序復(fù)制到系統(tǒng)盤(pán)上，如c:Wmdovssystem32目錄中。建議用戶(hù)保持默認(rèn)狀況，不必管Adcard.dll程序。ADCARD_CVI.H：這是瑞博華公司專(zhuān)為L(zhǎng)abWmdows/CVI提供的頭文件，通過(guò)該文件

4、，就可以實(shí)現(xiàn)對(duì)瑞博華公司提供的函數(shù)庫(kù)進(jìn)行操作。該文件應(yīng)該包含在用戶(hù)的應(yīng)用程序中。第二類(lèi)：設(shè)計(jì)文件CVI_REH.cws：例程工作空間文件Cl_RBH.prj：例程工程文件CXRBH.exe：生成的可執(zhí)行文件，用戶(hù)可以直接運(yùn)行該程序RBHCX7I_Demo.uir:用戶(hù)界面文件，實(shí)現(xiàn)主要功能RBHCT_Demo.c:應(yīng)用軟件源程序，實(shí)現(xiàn)主要功能RBHCl_Demo.h:應(yīng)用軟件的頭文件第三類(lèi)：說(shuō)明文件：說(shuō)明txt,該文件記錄軟件的基本情況。編程實(shí)例的開(kāi)發(fā)過(guò)程創(chuàng)e:nserUCIJQDevelopCyi_rbhVCYI_RBH.cvs-ADCABD_CVI.HFileEditViewBuildRu

5、nInstrumentLibraryToolsWindowOptionsHelp曰CIKBH白SourceFilesIIIEAdcard.lib：ABCAKD.CVI.H|RBHCVIJ)mohRBHCVI-Dmo.u讓RBHC/IJemo.cttendifKBHCVIDemo.c型HC”I_DemohInterfaceFilesKBHCVI.Demo.uir自BlnulwkFiles白DVserISDCARDCVI.HFiles/i關(guān)鍵是添加Adcard.lib和ADCARDCVI.H這兩個(gè)文件/Initial():ReturnADCardErrororint_stdcallInitialf

6、intIOBase,int/Startlntr():Retur0orBuffSizeBQ|LibrariesInstr-umentsDWORDStdcallStartlntr(WORDNumBufWORDBegChnDWORDFrqSaWORDAmpGaiint_stdcallStartSnapshot(intNumBintBeaChn.圖2添加Adcard.lib和ADCARD_CVI.H文件界而如圖2所示，開(kāi)發(fā)本軟件的關(guān)鍵是在工程中添加adcard.lib和ADCARD_CVI.H這兩個(gè)文件。然后就可以如同正常的LabWmdows/CXT軟件的開(kāi)發(fā)。三、實(shí)例程序的功能八/3圖3實(shí)例程序的功

7、能圖3所示為本例程的運(yùn)行界而，可以看出，例程實(shí)現(xiàn)了波形曲線(xiàn)顯示與AD結(jié)果顯示，述有開(kāi)關(guān)量輸出與輸入功能。針對(duì)圖3,各個(gè)部分的功能如下:中間部分是波形的曲線(xiàn)顯示，中間右側(cè)是各個(gè)通道的模擬最采集電壓值。1：設(shè)定曲線(xiàn)顯示對(duì)應(yīng)的通道號(hào)，用戶(hù)可以改變?cè)撝祵?shí)現(xiàn)對(duì)不同通道的現(xiàn)實(shí)。2：設(shè)定曲線(xiàn)X方向的顯示點(diǎn)數(shù)，通過(guò)調(diào)整該參數(shù)，可以實(shí)現(xiàn)波形的壓縮與展寬。対觀察波形總體和觀察波形局部很有幫助。3：幅值設(shè)置，通過(guò)設(shè)置該值，可以實(shí)現(xiàn)波形在Y軸的壓縮與展寬，對(duì)觀察不同幅值的信號(hào)有幫助。4：同時(shí)顯示各個(gè)通道的電壓數(shù)值，該數(shù)據(jù)是對(duì)一定采集結(jié)果取平均后的結(jié)果，方便觀察直流信號(hào)。5：狀態(tài)燈，當(dāng)進(jìn)入采集狀態(tài)時(shí)，該信號(hào)燈交替亮滅，

8、當(dāng)停止采集時(shí)，信號(hào)燈滅。6：退出程序，并停止采集7：停止采集命令8：?jiǎn)?dòng)采集命令9：設(shè)定采集的通道數(shù)、采集頻率，起始通道數(shù)10：顯示當(dāng)前采集的數(shù)據(jù)塊數(shù)。該數(shù)據(jù)不應(yīng)該達(dá)到用戶(hù)軟件設(shè)定的內(nèi)存緩沖區(qū)數(shù)，如果達(dá)到了用戶(hù)設(shè)定的緩沖區(qū)數(shù)，表明可能產(chǎn)生數(shù)據(jù)丟失，解決的方法是增加內(nèi)存緩沖區(qū)塊數(shù)NumBuf這個(gè)變hl的值，或增人NumSamp這個(gè)參數(shù)。11：開(kāi)關(guān)量輸出功能。通道號(hào)為設(shè)定開(kāi)關(guān)量輸出的通道號(hào)，該通道號(hào)以8位為一組，如通道號(hào)=0,表示第一個(gè)8位，當(dāng)通道號(hào)=1表示為第二個(gè)8位。字節(jié)HEX為對(duì)應(yīng)通道號(hào)的輸出數(shù)據(jù)，該數(shù)據(jù)用十六進(jìn)制方式給出，每一位對(duì)應(yīng)一個(gè)開(kāi)關(guān)最通道。DO命令按鈕就是把設(shè)定通道的數(shù)據(jù)通過(guò)驅(qū)動(dòng)程

9、序送到換件。12：開(kāi)關(guān)量輸入功能。輸入的開(kāi)關(guān)量用十六進(jìn)制方式給出，每個(gè)字節(jié)的一位對(duì)應(yīng)一個(gè)開(kāi)關(guān)量輸入通道的值。四、實(shí)例程序說(shuō)明實(shí)例代碼總體結(jié)構(gòu)非常簡(jiǎn)單，明了，并且有詳細(xì)的注解。1.申明程序申明程序的關(guān)鍵是要加入北京瑞博華公司的定義文件includeinclude/*Needediflinkinginexternalcompiler,hamilessotherwise*/存includeanalysis.hJincludeMusennt.hHinclude,rbhcM_demo.hu存includeutLlLtv.hJincludeADCARD_CVLIT北京瑞博華公司板卡的定義文件2配置程序de

10、fineMAX_NUMSAMP10000每通道存放的數(shù)據(jù)點(diǎn)數(shù)#defineMAX_CHN32最人通道數(shù)defineMAX.RECORD100000記錄的數(shù)據(jù)點(diǎn)數(shù)3.數(shù)組與玉量的定義/數(shù)組定義unsignedshortstaticADEuffEMAXCHNMAXNUMSAMP+l/每次讀取數(shù)據(jù)的緩沖區(qū)unsignedshortstaticADReco【d_ChnMAX_CHNMAX_RECOR叨總數(shù)據(jù)的緩沖區(qū)doubleChnbhie_ADMAX_CHN各個(gè)通道的AD值unsignedshortDIVhlue3,開(kāi)關(guān)鼠采集結(jié)果函數(shù)定義intReadADResult(voidvoidADJiiLd

11、al(void),voidReadDevoid變量定義Hitpanelhandle,/主而板unsignedcharswHiner=0,unsignedcharFlagStartAD=O,intChn_Dnnv畫(huà)圖的通道intXNum_Drav/doubleYScaleXilueOldDmw;mtRecordPtL-,/數(shù)據(jù)記錄的指針，指向卜一個(gè)存放數(shù)據(jù)的地址定義采集的參數(shù)intNumBuf,/采集的通道數(shù)mtNumSamp,mtBegClin,mtNumChii,mtFrqSamp,mtFrqFilter,mtAmpGam,下面的參數(shù)從驅(qū)動(dòng)程序中讀出chai:ADCai:d_Name100,

12、/采集卡名稱(chēng)intMaxchn,intLowFreq,mtHigliFreq,mtMinSampNum,floatVZero,floatVMax,mtMaxBinChii,最人通道數(shù)最低的采樣頻率最高的采樣頻率/最少的每包采樣點(diǎn)數(shù)/AD轉(zhuǎn)換結(jié)果的零點(diǎn)AD值/AD轉(zhuǎn)換結(jié)呆的最人AD值最大二進(jìn)制開(kāi)關(guān)量個(gè)數(shù)4.初始化釆集參數(shù)的子程序這里關(guān)鍵是應(yīng)用了Configlnfo函數(shù)，自動(dòng)讀取零點(diǎn)對(duì)應(yīng)的AD值和最人電壓時(shí)對(duì)應(yīng)的AD值,從而使本程序能夠自動(dòng)應(yīng)用于各種精度的采集卡voidAD_Imdal(void)NumBuf=20,NumSamp=1000,BegChn=0,NumChn=5,FrqSainp=1

13、0000,FrqFilter=1000,AinpGain=lFlagStartAD=O,RecordPtrO,直接從驅(qū)動(dòng)程序讀出參數(shù)，關(guān)鍵是Vzero,TvIax這兩個(gè)參數(shù)，通過(guò)自動(dòng)讀出，可以使本程序各種精度都能正確工作XNum_DL-aw=100,/曲線(xiàn)顯示設(shè)置，X方向的數(shù)據(jù)點(diǎn)數(shù)Chn_Drav=0,曲線(xiàn)顯示設(shè)置，顯示的通道YScale_ylue_Old_Dra=5.0,/|llia顯示設(shè)置，Y方向的量程人小，用觀察小信號(hào)非常方便Configlnf(&ADCai:d_NameO,&Maxchn,&L0vFi:eq,&HlghFi:eq,&M：LnSampNum,&VZeg，&VMax,&Ma

14、xEmChn丿，5.主程序主程序的關(guān)鍵是在推出是調(diào)用Stoplntr函數(shù)，確保推出是停止采集。mtmain(mtargc,cliar*argv)mr1,if(ImtCVlRTE(0,arg0)=0)/*Needediflinkrnginexternalcompiler,harmlessotherwise*/return/*outofmemory*/if(panelhandle=LoadPanel(0,PbhcvLdemo.uiL,PANEL)0)return-1,AD_InKKd()進(jìn)行采集的初始化DisplavPanel(panelliandle力RunUserlnterface(力Disc

15、ardPanel(panelliandle),L=StopInmj確保退出程序時(shí)停止采集CloseCVIRTE(),return0,定時(shí)器程序定時(shí)器程序是高速連續(xù)采集的關(guān)鍵程序，在本程序中顯示三個(gè)功能：高速、連續(xù)模擬量采集與曲線(xiàn)顯示、數(shù)字顯示功能；開(kāi)關(guān)量采集與現(xiàn)實(shí)功能采集狀態(tài)信號(hào)燈控制功能定時(shí)器功能mtCVICALLBACKTIMER_AD(mtpanel,mtcontrol,intevent,void*callbackData,mteventData1,inteventData2)Lilt1,switch(event)caseEVENT_TIMER_TICKiffFlagStaitAD兀et

16、um0,女II果定時(shí)器沒(méi)有啟動(dòng)就退出i=ReadxA.DResult(),采集模擬量ReadDI(J,開(kāi)關(guān)量采集卜面控制LED燈，當(dāng)啟動(dòng)采集時(shí)，該狀態(tài)燈一亮一滅if(swTimer=0)svTLmer=l,亮滅標(biāo)志置1SetCtdal(paneUPANEL_LED_AD,0力標(biāo)志燈亮elseswTimeLOy/亮滅標(biāo)志清零SetCtdal(paneUPANEL_LED_ADJ力標(biāo)志燈滅break,return0,定時(shí)器程序在定時(shí)器程序中被調(diào)用開(kāi)關(guān)量采集命令voidReadDevoid)charDLStr5O,unsignedcharStxl3,mt1,L=Rbh_DI(2,&DIVdue0”/

17、從驅(qū)動(dòng)程序得到開(kāi)關(guān)量采集結(jié)果顯示開(kāi)關(guān)量采集結(jié)果，用十六進(jìn)制方式表示，每個(gè)字節(jié)的8位，每位代表一個(gè)開(kāi)關(guān)量狀態(tài)sprmtf(DiStr,HByteO=%02x,Bytel=%02xH,DIVilue0,DIVilue1),SetCtrlXal(panelhandle,PANEL_DISTR、DiStr),8模擬量采集與曲線(xiàn)顯示、數(shù)字顯示的功能在定時(shí)器程序中被調(diào)用這部分是信號(hào)采集的關(guān)鍵與難點(diǎn)。重點(diǎn)是理解數(shù)據(jù)是如何解包，實(shí)現(xiàn)各個(gè)通道的數(shù)據(jù)采集功能，還要了解如何實(shí)現(xiàn)高速連續(xù)采集功能。/讀取采集結(jié)果mtReadADResult(void)mtstaticplotAD,doubleLBuf,inttemp,

18、inttempPtr,doublestaticClinRecord2048,mtMeanNum,/進(jìn)行數(shù)據(jù)平均的方法charstr100,LBuf=(uiisignedshort丿Query讀取硬件狀態(tài)，看看有多少緩沖區(qū)已經(jīng)填滿(mǎn)SetCrrlV鉉(panelhandle,PANEL.NUMERIC,LEuF”/將緩沖區(qū)狀態(tài)在屏幕上顯示出來(lái)，如呆該數(shù)據(jù)小于用戶(hù)設(shè)定的采樣緩沖區(qū)數(shù)，就表明數(shù)據(jù)采集是連續(xù)可靠的。if(!LBuf)return0外本次定時(shí)器未讀取到數(shù)據(jù)，就退出foi-(L=04LBuf,L+)/將全部緩沖區(qū)讀出j=ADResult(structstructADResult*)ADBuf

19、F),/從碩件將數(shù)據(jù)讀取到用戶(hù)緩沖區(qū)，這是數(shù)據(jù)采集的關(guān)鍵下面的程序是對(duì)數(shù)據(jù)進(jìn)行解包的關(guān)鍵,也演示了如何實(shí)現(xiàn)連續(xù)采集的功能tempPtL-=l,/由于第一個(gè)數(shù)據(jù)是序列號(hào)，所以要跳過(guò)去for(i1=0lNumSamp41+)讀取每一個(gè)點(diǎn)for(L2=0,L2i2+)讀取每一個(gè)通道將數(shù)據(jù)從緩沖區(qū)中讀出，對(duì)應(yīng)各個(gè)通道ADRecord_Clini2RecordPtr=ADBufftempPtr,tempPAH%/指向ADBuff的卜一個(gè)數(shù)據(jù)指向卜一個(gè)數(shù)據(jù)點(diǎn)，這是一個(gè)全局變杲，每次采集自動(dòng)疊加，保證連續(xù)記錄RecordPtr+,if(RecordPtr=NLX_RECORD)RecordPtr=0,如果數(shù)

20、據(jù)已經(jīng)填滿(mǎn),就從頭開(kāi)始填,可見(jiàn)是一個(gè)循壞緩沖區(qū)全部數(shù)據(jù)讀取完成，并存放到ADRecord_Chn的數(shù)組中下面的程序演示如何得到最新的100個(gè)點(diǎn)的各個(gè)通道采集結(jié)果ResetTextBox(panelliandle,PANELTEXTBOX,MeanNum=100,FoqL=OyLjMeanNum,j+)temp=tenip+ADRecord_ClinitenipPtr+,累加利ILf(rempPtr=MAX_RECORD)tempPtr=0,指針可能回頭ChnValueADEildoubLejtemp/MeanNum,得到平均值Chnblue_ADL=(doubleXChnPikie_ADLVZ

21、e2yVMax*10方如果AD鼠程是-5V到+5V/ClinRecordi=(doubleXClin:hlue_xA.DL-VZerojATvfax*10)+5,/如果AD吊程是0-10VFmt(str,H%sii+)這里演示從ADBuff中讀取數(shù)據(jù)，用戶(hù)也可以從ADRecord_Chn中讀取數(shù)據(jù)temp=ADBuffl+i*NumClui+Clui_Drav/得到Chn_Draw通道的數(shù)據(jù)ChiiRecordi=(doubleXtenip-VZeroj/XTvfax*10),如果AD吊程是至IJ+5V/ChnRecordi=(doubleXtemp-VZero)ATvax*10)+5,/11

22、果AD吊程是0J0V下面畫(huà)出圖形if(plotAD0)DeleteGrapliPlot(panelhandle,PANEL_GRAPH_WAVE,plotAD,1),/曲線(xiàn)清除plotAD=0,plotAD=PlotY(panelliandle,PANEL_GRAPH_WAVE,ClinRecord,XNum_DraxAL_DOUBLE,AL_THIN_LINE,AL_EMPTY_SQUARE,VAL_SOLID,1,VAL_RED”/畫(huà)出新的曲線(xiàn)return0,9各種命令功能/命令功能mtCVICALLEACKDISPLAYTUNC(mtpanel,mtcontrol,intevent,vo

23、id*callbackData,mteventDatal,inteventData2)mti,intChiiXilue,doubleXalue,if(event=EVENT_COMMIT)switch(control)casePANEL_STOP_AD停止采集命令i=StopIntr()停止采集命令FlagStartAD=0,/啟動(dòng)采集標(biāo)志清零SetCtrlAttribute(panel,PANEL_TIMER1,ATTR_ENABLED,0”/停定時(shí)器SetCtrlAttnbute(panel,PANEL_STOP_AD,ATTR_DIMMED,1),/停止采集命令無(wú)效SetCtrlAttn

24、bute(panel,PANEL_START,ATTR_DIMMED,0),啟動(dòng)采集命令有效break,casePANEL_START啟動(dòng)采集命令if(FlagStanAD=l丿iretum0,如果已經(jīng)啟動(dòng)就退出i=StopIngJ,/停止采集命令()，i=Imdal(0,0,0,0),進(jìn)行采集的初始化GetCtrLd(panelTANEL_NUMCHN,&NumChn方讀取通道數(shù)GetCtrLd(panelTANEL_FREQSAMJ&Fi:qSamp方讀取采樣頻率GetCtdVal(panelANEL.BEGCHN.&BegChii),讀取起始通道號(hào)L=StartIntr(kNumBuf,

25、NumSanip,BegClin,NumClinJrqSamprqFilterinpGain/啟動(dòng)采集功能FlagStartAD=l,啟動(dòng)采集標(biāo)，忐置位，表示己經(jīng)進(jìn)入采集狀態(tài)SetCtdAttnbute(panel,PANEL_TIMER1,ATTRJNTERVAL,0.2方設(shè)定定時(shí)器的時(shí)間間隔SetCtdAttnbute(panel,PANEL_TIMER1,ATTRENABLED,1),使能定時(shí)器SetCtrlAttnbute(panel,PANEL_STOP_AD,ATTR_DIMMED,0),使能停止采集命令SetCtdAttnbute(panel,PANEL_STxRT,ATTR_D

26、IMMED,1),屏蔽采集命令無(wú)效break,casePANEL_DO開(kāi)關(guān)最輸出采集命令,字節(jié)輸出模式，位輸出模式將其它例程GetCtrllCpanelANEL.DOCHNi力得到開(kāi)關(guān)起輸出的通道號(hào)GetCuT01(panelTANEL_CHNALUE,&Chn01ue”/得到開(kāi)關(guān)鼠輸出字節(jié)if(L3X=3,iqchn01ue255)Chnilue=255,L=Rbh_DO(LQinblue/從硬件輸出break,casePANEL_DISPLAYCHN曲線(xiàn)顯示時(shí)選擇通道號(hào)GetCtdl(panellnndleANELDISPLxWCHN,&i),if(i(NumCliii-l)i=NumCh

27、ii-1,Chn_Dmv=i.,SetCuibl(panelhandleTANEL_DISPLAYCHNj方break,casePANEL_DISPLAY_X_NUM讓圖形在X方向可以展開(kāi)和壓縮GetCtil譏(panelTANEL_DISPLAY_X_NUM,&L)0X方向顯示的點(diǎn)數(shù)if(i(NumSamp)i=NumSamp,XNunvDrax-i,設(shè)置畫(huà)圖的點(diǎn)數(shù)l=SetAxisScalingMode(panel,PANEL_GRAPH_WAVE,AL_EOTTOM_XAXIS,VAL_MANUAL,OANum_Drav方break,casePANEL_DISPLAYr_Y_VALUE:

28、讓圖形在Y方向可以展開(kāi)和壓縮GetCtrLPd(panelTANEL_DISPLAV_Y_VALUE,&hhe力/ZX方向顯示點(diǎn)數(shù)Lf(yalueYScale_alue_OLd_Draw)/IncreaseYScale_iilue_01d_DraxA-YScale_Vhhie_01d_DraM*2,else/decreaseYScale_iilue_01d_DraxA-YScale_Vhhie_Old_Draw*0.5,if(YScale_hlue_01d_DnHv=500JVScal.e_Vdue_Oki_Draw=50(if(YScaLe_lue_Old.Drav=0.001)YScale_Value_OLd_Dra=0.001,SetCtiLVd(panelhaiidleTANEL_DISPLAY_Y_VALUE,YScale_Vdue_Old_Dimq設(shè)置幅值，便于Y方向調(diào)整i=SetAxisScalmgMode(panel,PANEL_GRAPH_WAVE,：L_LEFT_YAXIS,：L_MANUAL/rScale_Vdue_Old_Draw,YScale_Vihie_Old_DEHV方break,casePANEL_QUTT/點(diǎn)擊退出命令StopImrQ停止采集命令QuitUserlnterface(0),b