Home
GPH-3300
Contents
1. WNC Cal unsigned long ulCount yord pData Parameters nCh Contains the channel number of the data to which pData points ulCount Contains an index of the data pointed by pData in the buffer pData Points to the data to be processed in this function After processing restore the processed data into the area pointed by pData Return Value The fnConv function has no return value Copyright 2002 2003 Interface Corporation All rights reserved d Interface 87 GPH 3300 Help for Linux 5 1 32 CallbackProc This CallbackProc function is a placeholder for a callback routine This function is called when the analog output is completed Supply a pointer to your function for the IpCallbackProc parameter in the DaSetBoardConfig function LPDACALLBACK CallbackProc INE nReserved ye Parameter nReserved Reserved Return Value This function has no return value Copyright 2002 2003 Interface Corporation All rights reserved d Interface 88 GPH 3300 Help for Linux 5 2 Structures 5 2 1 DASMPLREQ Structure The DASAMPLREQ structure contains analog output conditions This structure is used by the DaDataConv and DaSetSamplingConfig functions typedef struct unsigned long UOC OUN DASMPLCHREQ SmplChReq 256 unsigned long ulSamplingMode it loe E Syme Lie testo 5 unsigned long ulSmplRepeat unsigned long ulTrigMode unsigned long UUs ob OTHO EISE 4 unsigned long ulrrigDelay unsigned long ulEC
2. 119 870 IAG EE a E E E E A A A E E E E T 119 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 3 GPH 3300 Help for Linux Chapter 1 Introduction a ai 1 1 Summary The GPH 3300 software controls Interface analog output boards from your application running on Linux or RTLinux Application software should link controls the analog output boards through the provided application programming interface API This document includes the information for using the GPH 3300 on Linux 1 2 Features The GPH 3300 supports up to 2 data The maximum number of actual data that you can handle at a time depends on the amount of memory installed on your computer Analog output can synchronously start or stop with triggers The trigger delay function enables to delay the start or stop of analog output Output range selection and offset gain calibration are programmable by software Some boards don t support them The GPH 3300 supports every Interface analog output board The GPH 3300 supports the parallel analog output update so you can simultaneously analog output on two or more boards The GPH 3300 provides the calibration program The GPH 3300 provides useful sample program they help you to develop the application programs The analog output data can be saved into the disk and the saved data can be used with various application or programs
3. Using the trigger delay capability the timing when the analog output starts or stops changes depending on the number of the data output before or after the trigger 4 1 2 External Trigger The external trigger capability determines that the analog output starts or stops when an external signal is asserted External Trigger Input Pin It depends on the board specifications Data Transfer Mode External Trigger Input Pin Programmed I O EXINT IN EXTRG IN External Trigger Input Configuration Either rising or falling edge can be selected to assert a trigger This capability depends on the board specifications please refer to the user s manual of your board Using the trigger delay capability the timing when the analog output starts or stops changes depending on the number of the data output before or after the trigger Copyright 2002 2003 Interface Corporation All rights reserved d Interface 20 GPH 3300 Help for Linux 4 1 3 External Trigger with Mask Using a General Purpose Digital Input Pin This capability adds the mask conditions to the analog trigger capability When the signal on the specified general purpose digital input pin hereafter DI pin is low level the assertion of the external trigger signal is recognized as valid assertion In other words if the signal on the DI pin is high level the assertion of the external trigger signal is ignored or masked The digital input pin depends on th
4. if nRet Dernte Status Error nn DaClose 1 exit 1 7 j jwhile Status DA STATUS STOP SAMPLING j Start the analog output update as the overlapped operation on the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 58 GPH 3300 Help for Linux 5 1 14 DaStartFileSampling The DaStartFileSampling function reads data from a data file and outputs them to the board ine TIBI SE cue Te Eat de Sendo a inep TME nDevice Char szPathName unsigned long ulFileFlag unsigned long ulSmplNum Parameters nDevice Specifies the device number opened by the DaOpen function szPathName Specifies the data file containing the output data ulFileFlag Specifies the format of the data file FLAG BIN FLAG CSV CSV format physical value ulSmplNum Specifies the number of data Return Value The DaStartFileSampling function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR START SAMPLING DA ERROR INVALID PARAMETER DA ERROR FILE OPEN DA ERROR FILE CLOSE DA ERROR FILE READ Comments If you use a CSV format file the output update may not operate at the specified rate because the data conversions from physical values to binary values need more time or overhead Repetition isn t av
5. DA PCI C PCI Linux RT GPH 3300 Analog Output Board Driver Software for Linux RTLinux Help for Linux de Interface www interface co jp GPH 3300 Help for Linux Contents Sae dM aires Tm 4 B EIU RR RT M 4 UU d acit SS RTT E 4 Ghapter2 Product Specifications zesiseeskkbiaaqtk bunt pa REP aua ER bd a EEUU Ad adn dorso ddr Urdu 5 2 1 Operating Environments cccccecccccssscecceseecceuscecceuececsuececsuueeessuececseueeessuueeessueeeeseeeessaueeeessaueeessueeeesegeeessenseesagss 5 22 Ve Ct 90 E PRIN E E A E 5 2 3 Functional Specifications NR TE 6 Chapter 3 Installation and Board Configuration eeeeeeeeeeeeeeeeeeeeeeeeeeee 7 3 1 Installing the Linux Driver Software ssesssssssssssssssseeennenee nennen nnne nn nnn n nnne enne nnn nnns nnns nire nns 7 3 2 Loading the Driver ModU lGS E T 3 3 Co nfiguring i a demnm T AEO T ea E EE E E E E E inane 9 35 COMPING the Progra eria aE EEA RA ee Aarin ee eee eee 10 36 RUNNING Ne Progr aM aceea E EEA A EEE aE EREE EE 10 3 7 Data Acquisition Programming Technique sssssssssssssssseseeeee nennen nnne nnne nnne nenne nnne nnne rn 11 3 7 1 Continuous Analog Output Update lssssssssssssssssesssseeeeee nennen nnne nn sna nnne
6. Not enough memory is available to process GPH 3300 Help for Linux 5 4 Kylix In this document all examples of programs are written in C This section contains helpful information for Kylix programmers Note Kylix does not support SH 5 4 1 Function Definitions C Kylix long DaSetBoardConfig Eine Tome Dao cis echac Go mine int ipte we eer mDewuees Jubesger s unsigned Uu Siete WEE OTS mer wee ULSmeleuiiiecsilze Caicinal Wong VO pReserved pReserved pointer pPurppDACATLDLSAOK pCall Back Proc pCalilBbackProc PEEDACALLBACK sik ale nReserved nReserved Integer Eon 9 cdleeile oue e GCO OOR ec 1 In Kylix a function module that has a return value uses the function reserved word A function module that has no return value uses the procedure reserved word 2 In Kylix a variable is written in front of the data type of that 3 In Kylix data type are written in the different way of C Example int unsigned long Cardinal pointer 4 When you write a variable passed by reference write var in front of the variable 5 In Kylix data type is written at the end of the variable argument list 6 To call the library function write cdecl external library name To call the callback routine you don t need to write external library name Copyright 2002 2003 Interface Corporation All rights reserved d Interface 105 GPH 3300 Help for Linux 5 4 2 Structure C Kylix
7. Copyright 2002 2003 Interface Corporation All rights reserved d Interface 48 GPH 3300 Help for Linux 5 1 9 DaSetMode The DaSetMode function configures the board specific functionality PCI PAZ 3305 Configures the waveform generation mode PCI 3335 PCI 3337 Enables or disables the external trigger output through the EXTRG OUT pin PCI PAZ 3310 Enables or disables the external clock output through the EXCLK OUT pin PCI 3335 PCI PAZ 3336 PCI 3337 PCI PAZ 3340 int DaSetMode WME nDevice PDASMPLREO pDaMode Parameters nDevice Specifies the device number opened by the DaOpen function pDaMode Points to the DAMODEREQ structure Return Value The DaSetMode function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NOT SUPPORTED DA ERROR ILLEGAL PARAMETER DA ERROR NULL POINTER Comments The DaSetMode function isn t available while analog output is running Please refer to the user s manual of the board and Waveform Generation Mode for details For the PCI PAZ 3310 PCI 3335 PCI PAZ 3336 PCI 3337 and PCI PAZ 3340 specify DA EXCLK IN to the ulExClock member of the DAMODEREQ structure to disable the external clock output through the EXCLK OUT pin For the PCI 3335 and PCI 3337 specify DA EXTRQG IN to the ulExControl membe
8. DA LOW EDGE DasmploContftig uLTrigDLi 7 Configure the analog output update conditions nRet DaSetSamplingConfig DeviceNo amp DaSmplConfig Prepare output data Store analog output data to SmplData 512 2 fora OF pL 512 itri SmplData i 0 i Copyright 2002 2003 Interface Corporation All rights reserved n Interface 16 GPH 3300 Help for Linux Continued SmplData i 1 Set the analog output data nRet DaSetSamplingData DeviceNo amp SmplData 0 0 512 Wait for an assertion of the external trigger Start continuous analog output nRet DaStartSampling DeviceNo FLAG SYNC DaClose DeviceNo return O0 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 17 GPH 3300 Help for Linux 3 7 5 External Clock An external clock can be used as an analog output update pacer clock To use the external clock specify zero to analog output update rates The DaStartSampling function starts continuous analog output update on the board Example C int DaOutput int DeviceNo int nBet 3X7 DASMPLREQ DaSmplConfig unsigned short SmplDatal5l12 I2 1 nRet DaOpen DeviceNo Specify a buffer size nRet DaSetBoardConfig DeviceNo 512 NULL NULL 0 Dasempicontig ulchCount 27 ulChNo 1 ulRange DA 5V ulChNo 2 DaSmplConfig SmplChReq sulRange DA OV DaSmplConfig ulSamplingMode DA IO SAMPLING DaS
9. GPH 3300 Help for Linux Bit Arrangement of Data 8 bits one unsigned char 8 bit used bit7 bitO 12 bits one unsigned short 16 bit used bit15 bit12 bit 1 bitO Data Area Size Required data area 1s given by the following equation Data area byte the number of channels the number of data data unit in bytes required for the resolution Where data unit 1s as follows Data Unit byte 8 bits 12 bits d bits O 2 24 bits A IN NO le Example For 4 channels 100 data and 16 bit resolution Required data area byte 4 100 2 800 4 2 3 Digital Input Data This data shows a status of general purpose digital input pins on the board The polarity and the number of pins depend on the board specifications Please refer to the user s manual Bit Arrangement of Digital Input Data bit31 ipe bitl6 bit15 bit0 Unsigned long 32 bits gnod tong CES OO Notused me m 4 2 4 Digital Output Data This data controls general purpose digital output pins on the board The polarity and the number of pins depend on the board specifications Please refer to the user s manual Bit Arrangement of Digital Output Data bit31 T bitl6 bitl5 bitO Unsigned long 32 bits gnod long COMI TNotused ours our Copyright 2002 2003 Interface Corporation All rights reserved fr Interface 23 GPH 3300 Help for Linux 4 3 Averaging Analog data can
10. The GPH 3300 supports data conversion from binary to physical value and vice versa The noise can be removed by using the averaging Copyright 2002 2003 Interface Corporation All rights reserved d Interface 4 GPH 3300 Help for Linux Chapter 2 Product Specifications pL OLD OIL l 2 1 Operating Environments The following table shows operating environments for the GPH 3300 Interface Single Board Computer Interface Mother Board Computer Driver Type Source Code Open Policy Driver module partially open Library source code closed Common module open Build Support Makefile provided Help File PDF format 2 2 Target Boards PCI expansion boards PCI series Programmed I O PCI 3310 PCI 3325 PCI 3329 PCI 3336 PCI 3338 PCI 3340 PCI 3341A PCI 3342A PCI 3343A PCI 3345A PCI 3346A PCI 3347 PCI 3521 DA PCI 3522A DA PCI 3523A DA PCI 3525 DA PCI 3305 PCI 3335 PCI 3337 PCI 3174 DA PCL3175 DA PCI 3176 DA PCI expansion boards PAZ series Programmed I O PAZ 3310 PAZ 3325 PAZ 3329 PAZ 3336 mene PAZ 3338 PAZ 3340 PAZ 3521 DA CompactPCI expansion boards Major Data Transfer Mode Programmed I O CTP 3174 DA CTP 3175 DA CTP 3182 DA CTP 3325 CTP 3329 CTP 3338 CTP 3340A CTP 3340B CTP 3340C CTP 3340D CTP 3342 CTP 3343 CTP 3346 CTP 3347 CTP 3348 CTP 3349 CTP 3350 CTP 3351 CTP 3521 DA CTP 3522 DA CTP 3523 DA Copyright 2002 2003 Interface Corporation All rights reserved d I
11. The operation was successfully completed n DaSmplChReq 0 ulChNo 1 DaSmplChReq 0 ulRange DA 5V DaSmplChReq 1 ulChNo 2 DaSmplChReq l1 ulRange DA 5V Data 0 0x8000 Data 1 OxC000 One analog data output nRet DaOutputDA 1 2 amp DaSmplChReq 0 amp Data 0 if nRet DA ERROR SUCCESS printf Failed to output data n else printf The operation was successfully completed n nRet DaClose 1 Ip uBer ie DA ERROR SUCCESS prrincr Falled cO Close the Dosrd NWg s else printf The operation was successfully completed n return 0 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 9 GPH 3300 Help for Linux 3 5 Compiling the Program Compile the program made in 3 4 Programming Type the command as follows gcc o datest datest c lgph3300 3 6 Running the Program Run the program as follows Refer to 3 7 Data Acquisition Programming Technique for more details of how to program Copyright 2002 2003 Interface Corporation All rights reserved d Interface 10 GPH 3300 Help for Linux 3 7 Data Acquisition Programming Technique 3 7 1 Continuous Analog Output Update First specify a buffer size to store output data by using the DaSetBoardConfig function Second configure analog output update conditions of the board by using the DaSetSamplingConfig function Finally store the data into the output buffer of the board by usi
12. 2 Write codes between begin and eng 3 In Kylix the assignment operator is 4 In Kylix the address operator is 5 In Kylix a leading means hexadecimal Copyright 2002 2003 Interface Corporation All rights reserved d Interface 108 GPH 3300 Help for Linux 5 5 Test Driver The GPH 3300 has the test driver capable of checking the functions of the GPH 3300 without using the board To use the test driver link 1ibgpg3300t so instead of 11ibgpg3300 so The following shows the example to compile the test c program that uses the test driver gcc o test test c lpthread 1gpg3300t Each function checks whether parameters are correctly specified or not As error codes refer to Return Value for details DaGetMode Returns DA ERROR SUCCESS if the process was successfully completed DaStartSampling Returns DA ERROR SUCCESS if the process was successfully completed DaSyncSampling Returns DA ERROR SUCCESS if the process was successfully completed DaStopSampling Returns DA ERROR SUCCESS if the process was successfully completed DaSetInterval Returns DA ERROR SUCCESS if the process was successfully completed DaGetInterval Returns DA ERROR SUCCESS if the process was successfully completed DaGetFunction Returns DA ERROR SUCCESS if the process was successfully completed DaDataConv The process was successfully completed Copyright 2002 2003 Interface Corporation All rights reserved d Interfac
13. 4 6 12 Analog Output Update Condition Boara pt Board You can configure the analog output update conditions of the board by using the DaSetSamplingConfig or DaSetFifoConfig function In each case of using these functions the last configuration condition is valid The following table shows the correspondence of the members of the DASMPLREQ structure to the DAFIFOREQ structure DASMPLREQ Structure DAFIFOREQ Structure ulChCount ulChCount SmplChReq SmpIChReq ulSamplingMode fSmplFreq fSmplFreq ulSmplRepeat ulSmplRepeat ulTrigMode ulStartTrigCondition ulStopTrigCondition ulTrigPoint ulStartTrigCondition uTrgDeay ulECIkEdge ulTrigEdge ulTrigEdge ulTrigDI ulSmplNum Copyright 2002 2003 Interface Corporation All rights reserved d Interface 35 GPH 3300 Help for Linux Chapter 5 Reference 5 1 List of Functions Applicable No Function Description Note DaOopn Opens a board and enables to access to the board EE il Closes a board and releases the resources Any nes accesses to the board are forbidden mm Closes a board and releases the resources Any subsequent accesses to the board are forbidden In addition the analog output status after closing the board is selectable by the parameter 04 DaGetDevicelnfo Retrieves specifications of the board DEM d DaSetBoardConfig Configures event handling of the board 6 DaGetBoardConfig Retrieves an event source on the
14. 92 5 2 3 DABOARDSPEC Structure ssssssssssssessssseeeeennn nennen enne nnns ner nene rn nnns nnns nnne e rrr nnn nnns 93 EAR MP zie eir RN u 95 529 DAMOD BC imei E Um m UU uu Tm 98 5 2 6 DAP PORE G SUC 99 smog cud ace aca tesa P aascont 103 ced ee PP P 105 5 4 1 Function Definitions seeessssseessseseeeeeeee nennen menn nnne nn nnn nnns na nnns snas nenne sa enrenar anne nnns 105 Sm uice M LC 106 5 4 3 Example RNNRRRRERERRRTE M 107 Sa T O O a A E E ESEE E I E E EE E E EE 109 Chapter 6 Sample Programs cccceccseccsececceeeteeceecseeteeeeeeeeeteesueteeeeeeegetseeaeeteeeaeenaes 110 ERIRE EE 218 E home t ee PEE E E SI ee A A oe ee ee E A eee eee eee 110 S8 4 ro AT 110 exo a 10 610 6 em RT PET 9 111 X p o S 111 55 TOS A OG aco ccacecececeaeatese ccpeecaredcnsins toa UU E E GEM M i MA MEME UE LG RAD EDEE 112 OO a cM T L n 112 6 7
15. DaFifoConfig nRet DaOpen 1 if nRet exit 1 nRet DaGetFifoConfig 1 amp DaFifoConfig i1f nRet ir 1507 rsSDablTOCODnrtig ulohGounbtj zs 41 printf Output channel dMn DaFifoConfig SmplChReq i ulChNo Retrieve the analog output update conditions of the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 14 GPH 3300 Help for Linux 5 1 25 DaSetlnterval The DaSetInterval function configures the interval timer cycle This function is applicable only to the PCI 3525 int DaSetInterval TE nDevice unsigned long UL IEE E els Parameters nDevice Specifies the device number opened by the DaOpen function ulInterval Specifies the interval timer cycle in the range of 0 through 16777215 in us If the cycle is 0 the interval timer will be stopped Note us means microsecond Return Value The DaSetInterval function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR INVALID PARAMETER DA ERROR NOT SUPPORTED Comment The following figure shows behavior of analog output update when an interval timer is set to both the start trigger condition and stop trigger condition With the first timer event analog output update starts With the second timer event the analog output
16. Sample Programs TOP ISVIIX noceat iter tnde sega rre orit bacis uU eate Sas E eU she eU eoa tx IURE bows tus ud ta EEE EE 113 Sueca VUY PTOA o Tm 114 Te DA CAN ADC a Progra pete sence ace ties ci eases neesc cession ic fe mas ee gata cm 114 7 1 1 Required Items for the Calibration Program ccccccccccssececeseeeeeeeeeeeeseeeeeeseeeeeeseeeeesaeeeeseeeeesaeeeeeeesaees 114 7 1 2 Starting the Calibration Program ccccccccssccceseeeeeeeeeeeeseeeeeseeeeeseeeeeeseeeeeeseeeeeeseeeeesaeeeeesaneeeesseeseesaees 114 7 1 3 Selecting the BOard ccccccsscccssscecceeeeecssecccsueeecseueeecsseeessscessegeeessueeeeseuseecsegeeessseseesssgeeesseneessaggs 114 7 1 4 Selecting the Calibration ParaMeters ccccccccccseecceceeeeeeseeeeeseeeeeeeeeeeeeseeeeeeseeeeeseaeeeesaeeeeeeseeeeesaaes 115 7 1 5 Calibrating the On Board Potentiometer cccccecccccseeeeeeeeeeeeseeeeesaeeeeeseeeeeeaeeeeesaeeeeeseeeeeseneeeeesaees 118 Chapter 8 Important Information cece ec ecceeec eee eeeeeteeeeeeeeeeeeeeeeceeeeeeseeteeeneetaeeneeees 119 em Belus 119 8 2 Copyrights and Intellectual Property Rights ccccccsecceceeeeeeeeeeeeeeeeeeeseeeeeseaeeeeseeeeeeseeeeseeueeeesseeeeesaeeeesaeees 119 8 3 Warning Regarding Medical and Clinical Use of Interface Products eeseeeseseeseeenneeennnee 119 oA Limitation or Lia DINIY c
17. Ww Interface 42 GPH 3300 Help for Linux 5 1 5 DaSetBoardConfig The DaSetBoardConfig function configures event handling of the board uma Sem ouucdc onus TQ nDevice unsigned ong a STONES IRE e NONIUS pReserved PLPDACALLBACK pCallBackProc LINE Re Sie 7a Parameters nDevice Specifies the device number opened by the DaOpen function ulSmplBufferSize Specifiesa size of the buffer to store output data The default value is 1024 pReserved Reserved Specify NULL pCallBackProc Specifies an address of user callback routine to be called when the analog output stops If you don t use a callback routine specify NULL in C The default setting is NULL nReserved Reserved Specify 0 Return Value The DaSetBoardConfig function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR ILLEGAL PARAMETER Comments The data stored in the buffer are cleared 1f the output buffer size is changed The buffer size cannot be changed while analog output is running The syntax of the callback routine is as follows in C Please refer to the CallBackProc function void CALLBACK CallBackProc int nReserved Copyright 2002 2003 Interface Corporation All rights reserved de Interface 43 GPH 3300 Help for Linux Example int nRBe t unsigned long ulSmplBufferSi
18. be averaged by using the DaDataConv function The two following methods are supported Simple averaging Shifted averaging Simple Averaging El Averaged Data Data gt Tt After averaging n raw data by this method the effective analog output rate and the number of effective data averaged are reduced to 1 n from their originals Assume that the number of raw data is N the number of effective data will be N n after averaging When N is not divisible by n the remainder is not used for averaging When you use the DaDataConv function specify DA CONV AVERAGE and n for uEffect and uCount respectively For the numerical formulas please refer to the followings The data series before averaging x Kk 0 N 1 TE ee 9 M The data series after averaging y i n i 1 1 i Um S X S sigma Copyright 2002 2003 Interface Corporation All rights reserved fr Interface 24 GPH 3300 Help for Linux Shifted Averaging gt lt gt lt gt gt RawData__ Data Data Data Data Data Data LI 4 pm NENNEN PEE Assume that the number of raw data is N After averaging n raw data the number of effective data Averaged Data averaged is N n 1 The analog output update rate is not changed When you use the DaDataConv function specify DA CONV AVERAGE2 and n for uEffect and uCount respectively For the
19. board EFE DaSetSamplingConfig Configures analog output update conditions of the board pom DaGetSamplingConfig Retrieves analog output update conditions of the board DaSetMode Configures the board specific functionality DaGetMode Retrieves configuration information of the board specific functionality DaSetSamplingData Stores data into the output buffer of the board DaClearSamplingData Clears the data in the output buffer DaStartSampling Starts the analog output update on the board IEEE Reads data from a data file and outputs them to the NM board c Emm Di output update on boards connected in parallel DaStopSampling Stops the analog output update performed as the overlapped operation NN Retrieves the analog output update status of the EN board DaSetOutputMode Enables or disables the simultaneous analog output DaGetOutputMode Retrieves the configuration of the simultaneous iE 3 output 20 DaOutputDA utDA Outputs one Outputs one analog data on the board si data on the board pr DalInputDI Reads general purpose digital input pins on the board Copyright 2002 2003 Interface Corporation All rights reserved de Interface 36 GPH 3300 Help for Linux Continued fs meen etn d No Function Description Note on the board board at FIFO data transfer mode bl eal nm RR board at FIFO data transfer mode anena _ a 4 DaGetInterval Retrieves the i
20. is as follows first data third data fifth data n 0 original 524288th sample upper limit of the buffer 1 second 524288th sample upper limit of the buffer second 2 Analog Output Counter The frequency based waveform generation mode allows to keep the counter or clear it when the output stops When next output starts the following output can start at previous kept counter value Copyright 2002 2003 Interface Corporation All rights reserved Wy Interface 29 GPH 3300 Help for Linux 4 5 3 Independent Programmable Range Settings The PCI PAZ 3305 supports independent programmable voltage ranges Each channel can be individually configured for output ranges You can configure the ranges by using the DaSetMode function The maximum voltage range is 10 0 V in software Copyright 2002 2003 Interface Corporation All rights reserved n Interface 30 GPH 3300 Help for Linux 4 6 Attentions 4 6 1 Basic Flow of Programs First use the DaOpen function to initialize the board After the initialization successfully completed place your program codes as required Before exiting your program use the DaClose or DaCloseEx function to close the board and release resources properly 4 6 2 External Clock External Trigger and Mask Programmed I O mode 3174 DA 3175 DA 3174 DA 3176 DA 3174 DA 3175 DA 3182 3176 DA 3310 3310 3325 3325 3329 3338 3325 3329 3329 3336 3340A 3340B 33
21. nnn nna nn 11 3 7 2 One Shot Analog Output sssssssssssssssesseseeenn nennen nennen nnne nnne nnne nn nnns nennen nn nnns nnns 12 3 7 3 Parallel Analog Output UDUalG acusa c ntt tient potato bent ac tout Fes obtutu e bb axae brass Gur ted pbentu cA Rue NEN eAKtE 13 Sie rel Mal NI ero MR m s 16 Sm oic eio CERNERET 18 Chapter 4 Functional Descriptions seeseeseessseseeennennnemnnennm nnne nnne 20 ME Me NEF HEI TU C I UU TT 20 4 1 1 IUS dea MNT m S 20 A t2 EXernal TOOGE dots C ys 20 4 1 3 External Trigger with Mask Using a General Purpose Digital Input Pin seeeessseeuesssss 21 A Mice dB mr 21 2 2 Data FOIT ndsutesscsistiivert issus ideuMe bidon dudas Fd CcU PREMIER PPPUSUU M UNI R YPUDU tM IMiuU P edbK bic TREO aMbPU DU EK FOUND PIN ECKE Nd 22 42 1 Data TYPO EEE 22 A 2Ang COUN UN D ec cdacet ties cepenactassacs icaseacecnaseeaelteseatentoadacsieescasacs anteetiseecensuzesee a aueenesaeteessvusansescectieasce 22 M2 IG Ried Mr A 23 aS SPI ODIIEOTisimB r m 23 Bed PAV Sl AONIG Ar TT 24 AA iqu igore MOU ERE 8 eee are a ann cies eb ad saree bae eee Que seen ats eee ae te ann eae e eae dite A tans tebe nadie don eaten eee 26 4 5 Waveform Generation Mode applicable only to
22. numerical formulas please refer to the followings The data series before averaging x k 0 N 1 The data series after averaging y i 0 N n e DU S S Sigma Copyright 2002 2003 Interface Corporation All rights reserved d Interface 25 GPH 3300 Help for Linux 4 4 Interpolation The GPH 3300 provides the interpolation capability to reduce quantization error by the digital to analog conversion This product adopts the linear interpolation When an interpolation parameter n is given new data of n 1 points are generated between two data sampled from a source waveform Where we assume that the sampled source waveform described by a series of data x k 1 2 N N is the number of data that consist of the source waveform sampled new points of data x 9 xj xy 1 Xy doe Xp p Xp n Xj between x and x are calculated as follows Xy j X Xk 1 X G N where j 2 0 1 n As a result the analog output rate of the new waveform results in n times that of the source waveform The new waveform consists of Nn n 1 points of data When you use the DaDataConv function specify DA CONV SMOOTH and n for uEffect and uCount respectively Zt update interval Copyright 2002 2003 Interface Corporation All rights reserved de Interface 26 GPH 3300 Help for Linux 4 5 Waveform Generation Mode applicable only to the PCI PAZ 3305 The PCI PAZ 3305 supports the two followi
23. purpose digital output pins Example int nRet nRet DaOutputDO 1 0x03 Write data 03h to the general purpose digital output pins on the board whose device number 1s 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 71 GPH 3300 Help for Linux 5 1 23 DaSetFifoConfig The DaSetFifoConfig function configures analog output update conditions of the board at FIFO data transfer mode This function is applicable only to the PCI 3525 int DaSetFifoConfig iLigue nDevice PDAFIFOREQ I9DISUE SL OC ORE 3 6f Parameters nDevice Specifies the device number opened by the DaOpen function pDaFifoConfig Points to the DAFIFOREQ structure Return Value The DaSetFifoConfig function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR ILLEGAL PARAMETER DA ERROR NULL POINTER DA ERROR NOT SUPPORTED Comment The number of analog output channels and repetitions cannot be changed while the analog output 1s running Copyright 2002 2003 Interface Corporation All rights reserved d Interface 72 GPH 3300 Help for Linux Example int nker DAFIFOREQ DaFifoConfig Dabrrotonrig ul cn0oBHo 1 DaFifoConfig SmplChReq 0 ulChNo 1 Dasifoconzig omplohReqIroO ulRenge DA SV DaFifoConfig fSmplFreq 10000 DaFifoConfig
24. setting DA EXTTRG External trigger DA EXTTRG DI External trigger with mask using general purpose digital input pin ulTrigPoint Specifies the trigger timing One of the following codes must be set exclusively DA TRIG START Start trigger default setting DA TRIG STOP Stop trigger DA TRIG START STOP Start stop trigger ulTrigDelay Specifies the number of analog output data for post trigger This member is available when the trigger mode except DA FREERUN is set and the trigger timing except DA TRIG START STOP is set Number of analog output data for post trigger 1 through 1073741824 No trigger delay 0 The default seting value is 0 ulEClkEdge Specifies the edge polarity of the external clock signal This member is available when the fSmplFreq is O Of DA DOWN EDGE Falling edge default setting DA UP EDGE Rising edge ulTrigEdge Specifies the polarity of the external trigger This member is available when the trigger mode is the external trigger or the external trigger with mask using a general purpose digital input pin DA DOWN EDGE Falling edge default setting DA UP EDGE Rising edge Copyright 2002 2003 Interface Corporation All rights reserved n Interface 90 GPH 3300 Help for Linux ulrPzgbDl Selects a general purpose digital input pin to be used with the trigger conditions While the status of the digital input pin 1s low the assertion of the external trigger is valid The number of digital
25. the DaSetSamplingConfig function 4 6 3 Attention to External Trigger PCI Board 3335 3337 If you specify the DA EXTTRG parameter with the DA TRIG STOP or DA TRIG START STOP parameters in the DASMPLREQ structure the number of analog output data should be 524288 4 6 4 Reset in Capability PCI PAZ Board 3310 3335 3336 3337 3310 3336 When a signal is asserted on the RESET IN pin the analog output ranges of all channels are reinitialized to unipolar 0 V to 5 V The output voltage of each channel is set to 0 V PCI PAZ Board 3340 3340 When a signal is asserted on the RESET IN pin the output voltage of each channel is set to 0 V CTP Board 3340A 3340B 3340C 3340D When a signal is asserted on the RESET IN pin the output voltage of each channel is set to 0 V CTP Board When a signal is asserted on the RESET IN pin the output voltage of each channel is set to 0 V Software can generate an event during analog output Copyright 2002 2003 Interface Corporation All rights reserved d Interface 32 GPH 3300 Help for Linux 4 6 5 Handling Data Greater than Buffer Memory Size PCI Board 3335 3337 The driver software can handle analog output data greater than on board buffer memory size at a time But if the number of analog output data is greater than on board buffer memory size the output cannot repeat 4 6 6 Current Loop Open Failure Event PAZ CTP Board When a current loop o
26. the functional configuration of the CN3 connector on the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 81 GPH 3300 Help for Linux 5 1 29 DaDataConv The DaDataConv function converts forms of the analog data Averaging and interpolation can be done with the conversion You can supply the user defined function to perform user specific conversion inte Dabakwa DN unsigned long ulSrcFormCode Vod Poro Data a e T O lence TREES E Orem E suba PDASMPLREQ pSrcSmplReq unsigned long ulDestFormCode AONO pDestData unsigned long pulDestSmplDataNum PDASMPLREQ pDestSmplReq unsigned long ulEffect sonsskennmce ee m c Eo E o UU COMBE OC Oi NCO Parameters ulSrcFormCode Specifies an original data form stored in the buffer pointed by pSrcData DA DATA PHYSICAL Physical value voltage V or current mA DA DATA BIN8 8 bit binary DA DATA BINI2 12 bit binary DA DATA BINI6 16 bit binary DA DATA BIN24 24 bit binary The binary data means that the data can be input from or output to the board directly pSrcData Points to the source data to be converted ulSrcSmplDataNum Specifies the number of source data to be converted pSrcSmplReq Points to the DASMPLREQ structure containing the analog output conditions of the source data Copyright 2002 2003 Interface Corporation All rights reserved d Interface 82 ulDestFormCode pDDSSTtOStag pul
27. ul FormCode Specifies the data format DA DATA PHYSICAL Physical value voltage V or current mA DA DATA BIN8 8 bit binary DA DATA BINI2 12 bit binary DA DATA BINI6 16 bit binary DA DATA BIN24 24 bit binary ulSmplNum Specifies the number of analog data GIChCoUms Specifies the number of channels Return Value The DaWriteFile function returns DA ERROR SUCCESS if the process 1s successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NULL POINTER DA ERROR FILE OPEN DA ERROR FILE CLOSE DA ERROR FILE WRITE DA ERROR INVALID DATA FORMAT Copyright 2002 2003 Interface Corporation All rights reserved d Interface 85 GPH 3300 Help for Linux Comment The data are written into the file in the same format in the buffer the binary data are written into the binary format file the physical data are written into the CSV format file Example int nRet char pszPathName DATA CSV nRet DaWriteFile pszPathName pSmplData DA DATA PHYSICAL 1024 1 Write 1024 physical data per channel into the DATA CSV file from the buffer pSmplData Copyright 2002 2003 Interface Corporation All rights reserved d Interface 86 GPH 3300 Help for Linux 5 1 31 fnConv The fnConv function is a placeholder for a callback routine used in the DaDataConv function This function 1s called when each data 1s converted CONSUE EXOQ C 28 QUO ONT
28. 40C Board 3336 3338 3338 3340 3340D 3342 3343 3340 3341A 3521 DA 3346 3347 3348 3342A 3343A 3349 3350 3351 3345A 3346A 3521 DA 3522 DA 3523 DA 3347 3521 DA 3522A DA 3523A DA A signal connected to the EXINT IN pin is handled as an external clock signal or an external trigger signal depending on the settings If you use an external trigger with mask using a general purpose digital input pin use the EXINT IN and INI pins or EXINT IN and IN2 pins for the mask condition FIFO mode An external clock capability is not supported A signal connected to the EXTRG IN pin is handled as an external trigger signal A trigger delay capability is not supported An external trigger with mask using a general purpose digital input pin capability is not supported Memory mode 1 PCI Board 3335 3337 A signal connected to the EXCLK IN pin is handled as an external clock signal A signal connected to the EXTRG IN pin is handled as an external trigger signal Copyright 2002 2003 Interface Corporation All rights reserved n Interface 31 GPH 3300 Help for Linux Memory mode 2 A signal connected to the CN4 is handled as an external clock signal A signal connected to the CN3 is handled as an external trigger signal The direction input or output depends on the settings Input and output cannot be specified at the same time When you use an external clock signal set fSmplFreq to 0 by using
29. 53 eM Pu 2 DaClearsaMmpOlMO ale RTT 55 SN NE Fo Di an AIO lale E UT 56 5 1 14 DaStanFileSampling ERN ES 59 Copyright 2002 2003 Interface Corporation All rights reserved Wy Interface 2 GPH 3300 Help for Linux Slo Da Sync SalI AG ERR MET ERR 61 9 1 16 Da topo amp t T P 63 UNG I C6 Ls eir UI PER Ro cee R ee cna ER 64 95 1 18 Da SO lotir OG MERE 66 5 1 19 DaGetOutputMode irca oscdcntterd ere tesieiccsttsinow acd eeeedesdned Pacdwnden ce nade eoaabedarwasededeeesbencs dase asdeeas haces eaceacgaateactons 67 5 1 20 DY O10 0 0 DRM 68 r UDI EDI R 70 SN AU Me UU O eae c tee sase 71 51 29 a CU OG Oat T 72 31 24 Dat S Cl MOC ONG sae cce seep c 74 ME a1 B Fh 522 epee eee eee P 75 SW WERE T 77 Ska Ae Ut WHC EON TERR TERRE TU TER 78 5 1 28 DaGetFunction MM 80 SNE SBER ie Pol TM E EEA E EEE ENA AE EEA AE EN E 82 om nS 3E iUd F IE a a A 85 MEE O eee EA E E A A E 87 SN I Val Gz llozie duiyc chem eR Hp 88 spiegel M eee 89 NAMUR BI izeRc 89 5 2 2 DASMPLCHREQ SUCUT s
30. 6 5 fifosampling c This sample program performes the analog output update as a non overlapped operation at the FIFO data transfer mode This program 1s applicable only to the PCI 3525 The following table shows the analog output update conditions Configure them according to your board Setting Number of channels Analog output update rate 10 kHz Channel and range Channel 1 4 5 V 6 6 adasync c This sample program synchronously starts the analog output update and sampling on the PCI 3525 board Spedifiy the device number to control 2 Configure the analog output update condition to start the analog output synchronizing with the sampling by the DaStartSampling function 3 The sampling stop when it reaches the specified number The analog output update stop when the sampling completed The following tables show the sampling and analog output update conditions Configure them according to your boards AD Setting Number of channels Sampling rate Channel and range Channel 1 4 5 V Channel and range Channel 2 5 V Start trigger condition Stop trigger condition The specified number of data 1s sampled Copyright 2002 2003 Interface Corporation All rights reserved d Interface 112 GPH 3300 Help for Linux DA Setting Number of channels Analog output update rate 10 kHz Channel and range Channel 1 5 V Start trigger condition Software start Stop trigger condition 6 7 Sample Pr
31. Data 0 0 512 Start the analog output update nRet BDabtartoamplrng beviceNo FLAG SYNC DaClose DeviceNo return O0 3 7 2 One Shot Analog Output The software paced one analog output needs to use the DaOutputDA function Example C int DaOutput int DeviceNo int Ret DASMPLCHREQ DaSmplChReq 2 unsigned short Data 2 nRet DaOpen DeviceNo DaSmplChReq 0 ulChNo 1 DaSmplChReq 0 ulRange DA 5V DaSmplChReq 1 ulChNo 2 DaSmplChReq 1 ulRange DA 5V Data 0 0x800 Data 1 0OxCO00 One analog output nRet DaOutputDA DeviceNo 2 amp DaSmplChReq 0 amp Data 0 nRet DaClose DeviceNo return O0 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 12 GPH 3300 Help for Linux 3 7 3 Parallel Analog Output Update In the parallel analog output update configuration a single master and one or more slave boards exist in the system The following shows how to start the parallel analog output update 1 Specify a buffer size to store output data for each board by using the DaSetBoardConfig function 2 Configure analog output update conditions for each board by using the DaSetSamplingConfig function 3 Store the data into the output buffer for each board by using the DaSetSamplingData function 4 Call the DaSyncSampling function in the slave boards 5 Call the DaSyncSampling function in the master board Then each board synchronou
32. DestSmplDataNum pDestSmplReq ulEffect ulCount DENCONV Return Value GPH 3300 Help for Linux Specifies an original data form stored in the buffer pointed by pDestData DA DATA PHYSICAL DA DATA PHYSICAL Physical value value xa Chee or current mA DA DATA BINS DATA BIN8 8 bit gbitbimry DA DATA BINI2 12 bit binary DA DATA BINI6 16 bit binary DA DATA BIN24 24 bit binary The binary data means that the data can be input from or output to the board directly Points to the buffer to receive data converted Points to a variable to receive the number of data converted Points to the DASMPLREQ structure to receive the analog output condition of converted data Specifies the additional data processing i 9 No averaging and no interpolation DA CONV SMOOTH Converts the data with interpolation DA CONV AVERAGEI Converts the data with the simple averaging DA CONV AVERAGE2 Converts the data with the shifted averaging Specifies the number of original data to average or interpolate If ulEffect is set to 0 ulCount is ignored Points to the user supplied function to achieve arbitrary data processing If you don t use this capability specify NULL to pfnConv The DaDataConv function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NULL POINTER DA ERROR INVALID DATA FO
33. I 3341A PCI 3342A PCI 3343A PCI 3345A PCI 3346A PCI 3347 PCI PAZ 3521 PCI 3522A PCI 3523A Ime BE AQ OX c U e Lag Ime nDevice unsigned long ulMode f Parameters nDevice Specifies the device number opened by the DaOpen function ulMode Specifies a role of the board master or slave by using the following codes exclusively DA MASTER MODE DA SLAVE MODE Copyright 2002 2003 Interface Corporation All rights reserved d Interface 61 GPH 3300 Help for Linux Return Value The DaSyncSampling function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NOT SUPPORTED DA ERROR START SAMPLING DA ERROR INVALID PARAMETER Comments The DaSyncSampling function always performs as an overlapped operation The driver software is capable of event signaling and callback of your procedure at completion of the parallel analog output update You should configure event settings and register your callback routine to the master board not to slave boards Use the DaStopSampling function to terminate the analog output update in progress Use the DaSetSamplingConfig and DaSetMode functions to setup analog output update conditions The driver software uses an output update rate of the master board in the parallel analog output update Configure
34. IC VIO EVOSCeI ei UDASMPLCHREQ record puaerberwew lex wc deos Ceca unsigned long ulRange ulRange Cardinal DASMPLCHREQ PDASMPLCHREQ end 1 In Kylix a structure is called a record and write structure name record 2 In Kylix a variable is written in front of the data type of that 3 In Kylix write end at the end of the record Copyright 2002 2003 Interface Corporation All rights reserved d Interface 106 GPH 3300 Help for Linux 5 4 3 Example The following programs show how to write a callback routine C vord CALLBACK CallBackProc rint nReserved void main unsigned Long Se Smp ue sz e DaOpen 1 ulSmplBufferSize 2048 De SexElsxoxe dete Gba vel wWISimlje l Burr rer Swe c S BUE n Cell M IBS Ck Pror void CallBackProc int nReserved JU Wisi jocOees sie T OE elie Cellliscicl mow E line c Kylix D procedure CallBackProc nReserved Integer cdecl procedure Trormimhormereate sender obses var ulSmplBufferSize Cardinal begin DaOpen 1 ulSmplBufferSize 2048 IpresexexElsroxe sel eae Tr IS e CUOI mp l Bur Tero ize NUL e e C To Tess te died Pete e Nn end procedure CallBackProc nReserved Integer cdecl begin JT Beste pro CIS caine Ox T Ede ecliiblori es ebd SC end Copyright 2002 2003 Interface Corporation All rights reserved d Interface 107 GPH 3300 Help for Linux 1 Declare a variable or function after the var reserved word
35. NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR INVALID PARAMETER DA ERROR USED AD DA ERROR NOT SUPPORTED Copyright 2002 2003 Interface Corporation All rights reserved d Interface 78 GPH 3300 Help for Linux Comments The operation of this function depends on the setting of CN3 in the GPH 3100 Refer to the following table to check variable combination of codes before you use this function AD AD CN FREE FREE Available Available Available Not available When DA CN Dl is specified for CN3 CN3 is INI When DA CN DO is specified for CN3 CN3 is OUTI Example int nRet unsigned long ulCnNo 3 unsigned long ulFunction DA EXTRG IN nRet DaOpen 1 if nRet exit 1 nRet DaSetFunction 1 ulCnNo ulFunction Configure the function of the CN3 connector to an external trigger input on the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 79 GPH 3300 Help for Linux 5 1 28 DaGetFunction The DaGetFunction function retrieves the functional configuration of the CN3 connector This function 1s applicable only to the PCI 3525 int DaGetFunction iia nDevice unsigned long BICMOS unsigned long Veil IPDUONOTE ml Oya Parameters nDevice Specifies the device number opened by the DaOpen function ulCnNo Specifies the connector number to retrieve the functinal configuration Specify 3 pulFunction Points to a variable to rec
36. No DA MASTER MODE return O0 Note You can use the same external signal to synchronize analog output update timing on each board Refer to 3 7 4 External Trigger and 3 7 5 External Clock respectively Copyright 2002 2003 Interface Corporation All rights reserved d Interface 15 GPH 3300 Help for Linux 3 7 4 External Trigger The analog output update can start at the assertion of an external trigger Configure the analog output update conditions by using the DaSetSamplingConfig function The DaStartSampling function starts continuous analog output on the board Example C int DaOutput int DeviceNo int Ret c DASMPLREQ DaSmplConfig unsigned short SmplDatal5l12 I2 1 nRet DaOpen DeviceNo Specify a buffer size nRet DaSetBoardConfig DeviceNo 512 NULL NULL 0 LE nRBec I DA ERROR SUCCESSO Xecurnm NRE DaSmplConfig ulChCount 2 ulChNo 1 ulRange DA oV ulchNo 2 DaSmplConfig SmplChReq ulRange DA 95V DaS8mplConfig ulSamplingMode DA IO SAMPLING DaSmplConfig fSmplFreq 10000 0 DaSmplConfig SmplChReq DaSmplConfig SmplChReq 9 O DaSmplConfig SmplChReq 1 i 0 0 1 1 DaSmplConfig ulSmplRepeat 1 DaSmplConfig ulTrigMode DA EXTTRG External trigger Das5mpiConrig ulTrrigPornt DA TRIG START Start analog output update by the trigger DasmplConfig ulTrigDelay 0 DaSmplConfig ulEClkEdge DA LOW EDGE DaSmplConfig ulTrigEdge
37. OINTER Comments For the PCI PAZ 3305 the DAMODEREQ structure contains the waveform generation parameters For the PCT 3335 and PCI 3337 the ulExControl member of the DAMODEREQ structure contains the mode of the EXTRG OUT pin DA EXTRQG IN trigger output disabled or DA EXTRG OUT trigger output enabled For the PCI PAZ 3310 PCI 3335 PCI PAZ 3336 PCI 3337 and PCI PAZ 3340 the ulExClock member of the DAMODEREQ structure contains the mode of the EXCLK OUT pin DA EXCLK IN or DA EXCLK OUT Copyright 2002 2003 Interface Corporation All rights reserved d Interface 51 Example int nRet DAMODEREO DaMode nRet DaGetMode 1 amp DaMode i1f nRet DaMode ulPulseMode DA MODE SYNTHE nRet DaSetMode 1 amp DaMode Retrieve the board specific parameters of the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved Ww Interface 52 GPH 3300 Help for Linux GPH 3300 Help for Linux 5 1 11 DaSetSamplingData The DaSetSamplingData function stores data into the output buffer of the board Lele TIBI See Seidl abre COQUE 16 TQS nDevice VON Dsmpil Daca unsigned long ulSmplDataNum Parameters nDevice Specifies the device number opened by the DaOpen function pSmplData Points to the application buffer containing data to be transferred into the output buffer ulSmplDataNum Specifies the number of data Return Value The DaSetSamplingData function return
38. R The analog output update is waiting for a trigger DA STATUS NOW SAMPLING The analog output update is running ulDaSmplCount Points to a variable to receive the number of data that have already been output ulDaAvailCount Points to a variable to receive the number of data not to be output ulDaAvailRepeat Points to a variable to receive the repetition counts not to be done The PCI 3335 and PCI 3337 boards can not retrieve the repetition counts The value is always 0 Return Value The DaGetStatus function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following code Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NULL POINTER Copyright 2002 2003 Interface Corporation All rights reserved d Interface 64 Example int nRet unsigned long ulDaSmplStatus unsigned long ulDaSmplCount unsinged long ulDaAvailCount unsigend long ulDaAvailRepeat nRet DaGetStatus 1 amp ulDaSmplStatus amp ulDaSmplCount amp ulDaAvailCount amp ulDaAvailRepeat i1f nRet printf Status XWMn ulDaSmplStatus printi Counti dXu ulDaSmplCount Retrieve the analog output update status on the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 65 GPH 3300 Help for Linux GPH 3300 Help for Linux 5 1 18 DaSetOutputMode The DaSetOutputMode func
39. RMAT DA ERROR INVALID AVERAGE OR SMOOTHING DA ERROR INVALID SOURCE DATA Copyright 2002 2003 Interface Corporation All rights reserved d Interface 83 GPH 3300 Help for Linux Comment If averaging or interpolation is applied to the data processing the analog output conditions of the converted data are changed from the original depending on the additional processing conditions Example int nRet nRet DaDataConv DA DATA BIN12 amp pSrcBuffer amp pSrcSmplDataNum amp pSrcSmplReq DA DATA BIN16 amp pDestBuffer amp puDestSmplDataNum amp pDestSmplReq 0 0 NULL The conversion is done under the conditions as follows Source data format 12 bit binary Analog output conditions for source data Specified by the DASMPLREQ structure Converted data format 16 bit binary Analog output conditions for converted data Stored to the DASMPLREQ structure Additional data processing None User function None Copyright 2002 2003 Interface Corporation All rights reserved d Interface 84 GPH 3300 Help for Linux 5 1 30 DaWriteFile The DaWriteFile function writes data to the file from the buffer Binary and CSV formats are supported int DaWriteFile Sneis pszPathName MINOS Ponp Doca unsigned long ulFormCode unsigned long ulSmplNum unsigne MEn ull Ode CONDE Parameters pszPathName Specifies the path to the data file pSmplData Points to the buffer containing analog data to be saved
40. ROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NOT SUPPORTED DA ERROR NULL POINTER Comment The DaInputDI function isn t applicable to the board PCI PAZ 3305 that has no general purpose digital input pins Example int nRet unsigned long ulData nRet DalInputDI 1 amp ulData 1f nRet prantf Inpur Datat lt xX n ulData j Read the status of general purpose digital input pins on the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 70 GPH 3300 Help for Linux 5 1 22 DaOutputDO The DaOutputDO function writes data to general purpose digital output pins on the board Tie Bre Omnes SEC IO Int nDevice unsigned long ulData 3 Parameters nDevice Specifies the device number opened by the DaOpen function ulData Specifies the digital data to be output Please refer to 4 2 Data Format Return Value The DaOutputDO function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NOT SUPPORTED DA ERROR INVALID PARAMETER Comment The DaOutputDO function isn t applicable to the board PCI PAZ 3305 that has no general
41. a for each of 2 channels into the buffer of the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 54 GPH 3300 Help for Linux 5 1 12 DaClearSamplingData The DaClearSamplingData function clears the data in an output buffer int DaClearSamplingData BIOS nDevice Parameter nDevice Specifies the device number opened by the DaOpen function Return Value The DaClearSamplingData function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following code Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER Example Int nket nRet DaClearSamplingData 1 Clear the data in the output buffer on the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 55 GPH 3300 Help for Linux 5 1 13 DaStartSampling The DaStartSampling function starts an analog output update on the board inte Dastarksamp ling EET nDevice Unis epee deuote re DEL e ZR eum sic Ne Parameters nDevice UJlovnoEklag Return Value Specifies the device number opened by the DaOpen function Specifies whether the analog output update process is performed as an overlapped operation or not FLAG SYNC Specifies that the analog output update is performed as a non overlapped operation FLAG ASYNC Specifies that the analog output u
42. aConfigMaster DaConfigSlavel ulChCount 2 DaConfigSlavel SmplChReq 0 ulChNo 1 DaConfigSlavel SmplChReqr0 ulBange DA SV DaConfigSlavel SmplChReq 1 ulChNo 2 DaContfig5lavel omplOhRegIl ulRange DA SV Configure the analog output update conditions slave board 1 nRet DaSetSamplingConfig SlavelNo amp DaConfigSlavel DaConfigSlave2 ulChCount 2 DaConfigSlave2 SmplChReq 0 ulChNo 1 DaConfigSlave2 SmplChReq 0 ulRange DA 5V DaConfigSlave2 SmplChReq 1 ulChNo 2 Daconfigolave2z omplObRegll lRdnge DA SV Configure the analog output update conditions nRet DaSetSamplingConfig Slave2No Prepare output data slave board 2 amp DaConfigSlave2 for i 0 i lt 512 itt DataMaster i 0 i DataSlavel i 0 i DataSlave2 i 0 i DataMaster i 1 512 1 DataSlavel i 1 512 i DataSlave2 i 1 512 1 Set the analog output data DaSetSamplingData MasterNo amp DataMaster 0 0 512 DaSetSamplingData SlavelNo amp DataSlavel 0 0 512 DaSetSamplingData Slave2No amp DataSlave2 0 0 512 slave boards DA SLAVE MODE Parallel analog output update REC DaSyncSampling Slave2No Copyright 2002 2003 Interface Corporation All rights reserved d Interface 14 GPH 3300 Help for Linux Continued nRet DaSyncSampling Slave3No DA SLAVE MODE Parallel analog output update master board nRet DaSyncSampling Master
43. ailable All of data previously existed in the output buffer are deleted when the analog output is started by the DaStartFileSampling function Copyright 2002 2003 Interface Corporation All rights reserved d Interface 59 GPH 3300 Help for Linux Example int nRet ARGC DaStartkuilesamplrngi iL Ltest dat PELAG Cov LO2Z4 Start the analog output on the board whose device number is 1 with reading the data from test dat Copyright 2002 2003 Interface Corporation All rights reserved d Interface 60 GPH 3300 Help for Linux 5 1 15 DaSyncSampling The DaSyncSampling function enables you to achieve a synchronous analog output update on boards connected in parallel A single master board distributes its internal analog output update pacer clock signal to other slave boards for the concurrent update without practical phase delay Calling the DaSyncSampling function on each slave board place the slave board into standby state for parallel update Calling the DaSyncSampling function on a master board starts the simultaneous update on it with the waiting slave boards The DaSyncSampling function is applicable to the boards that have parallel simultaneous analog output update capability and they are listed below The parallel update is not supported between different type of boards You should connect the same type boards by the synch cables Model PCI PAZ 3310 PCI PAZ 3329 PCI PAZ 3336 PCI PAZ 3340 PC
44. amplin s Return to the application s analog output update Return control e e Running the continuous e Signal event e analog output update Processing of the callback amp Signal event End of the continuous routine Invoke the callback routine analog output update Completion of the continuous analog output update is notified by the event signaling 2 The overlapped continuous analog output update can be aborted by the DaStopSampling function 3 Zero cannot be specified to the repetition count of the ulSmplRepeat member in the DASMPLREQ structure for non overlapped analog output update operation Copyright 2002 2003 Interface Corporation All rights reserved d Interface of GPH 3300 Help for Linux Example int i nRet unsinged short SmplData 4096 2 unsinged long Status Count AvailCount AvailRepeat nRet DaClearSamplingData 1 Prepare output data for i 0 i lt 4096 i SmplData i 0 i SmplData i 1 A095 a Set the analog output data into the output buffer nRet DaSetSamplingData 1 amp SmplData 0 0 4096 i1f nRet nRet DaStartSampling 1l FLAG SYNC Start the analog output as a non overlapped operation on the board whose device number is 1 nket Dastartoamplingil FLAG ASINC if nRet do nRet DaGetStatus 1 amp Status amp Count amp AvailCount amp AvailRepeat
45. controled by using the DaInputDI and DaOutputDo functions 4 6 11 Analog Output Update Rate Limitation 3340B 3340C 3342 3343 3347 3348 3350 3351 3343A 3521 DA 3522 DA 3523 DA 3346A 3521 DA 3522A DA 3521 DA 3523A DA The analog output update rate is configurable by the DaSetSamplingConfig function and the rate is obtained by the following equation _ p J NO NI Where f Update rate Hz f0 Base clock frequency Hz 8 MHz NO Integer divisor of the counter 2 through 65535 NI Integer divisor of the counter 2 through 65535 The actual analog output update rate has some errors against the specified rate to the DaSetSamplingConfig function because the ideal combination of integer divisors NO and NZ could not be obtained for the rate 8 MHz BEEN le CLKO OSC NO Counter 0 OUTO E CLKI NI Counter 1 OUTI gt Update pacer clock Programmable timer Copyright 2002 2003 Interface Corporation All rights reserved d Interface 34 GPH 3300 Help for Linux Example When an analog output update rate of 300 Hz is specified to the DaSetSamplingConfig function appropriate integer divisors of NO and N are 3 and 8889 respectively And actual update rate becomes 299 99625 Hz 8000000 8000000 299 9850008 2 13334 26668 8000000 8000000 56 T 3 8880 26667 8000000 8000000 2 13333 26666 300 007502
46. device number is Use the device number obtained by the invalid device number setting program DA ERROR ALREADY OPEN 0xC0000004 The specified device The device used by another process cannot be opened cannot be accessed because it has already been opened by another process DA ERROR NOT SUPPORTED 0xC0000009 The specified function is The function is not available because the not supported board does not support DA ERROR NOW SAMPLING 0xC0001001 The analog output is The specified analog output has already running now been called The specified function is not available while the analog output is running DA ERROR STOP SAMPLING 0xC0001002 The analog output is The specified analog output is not stopped available while the analog output has been stopped DA ERROR START SAMPLING 0xC0001003 Failed to start the analog There is no analog output data in the output output buffer DA ERROR INVALID PARAMETER 0xC0001021 The specified parameters Specify correct values are invalid DA ERROR ILLEGAL PARAMETER 0xC0001022 The specified analog Invalid analog output conditions are output settings are specified invalid DA ERROR NULL POINTER 0xC0001023 A NULL pointer is A NULL pointer is specified for source specified data in the data conversion function The pointer to the buffer that receives the converted data is NULL DA ERROR SET DATA 0xC0001024 The time out interval The analog output data couldn t be elapsed wh
47. e 109 GPH 3300 Help for Linux Chapter 6 Sample Programs FF ioJAAU SC c SELL LLL EOXA ULULLULLDLLLLETGCLLLK OGQMlE332 2k202 03 5s1ILS 1 AA LDDEALALLGCM S Executable files of the sample programs are not included with this product Please make your executable files before you use the sample programs The sample program sources and makefiles are located in the usr src interface gph3300 1386 linux samples directory 6 1 sampledata c This sample program performes the analog output update as a non overlapped operation Specify the device number to control 2 Select either of sine waveform or square waveform 3 Analog output data of 200 samples will be updated When 0 is specified as the number of repeat analog output update will be continuously repeated The following table shows the analog output update conditions Configure them according to your board Setting Number of channels Channel and range Channel 2 5 V 6 2 async c This sample program performes the analog output update as an overlapped operation Specify the device number to control Select either of sine waveform or square waveform Analog output data will be continuously updated To stop output press the q key pam cm iw us When the analog output update is finished an ending message will be displayed The following table shows the analog output update conditions Configure them according to your board Setting Number o
48. e board specifications Data Transfer Mode Digital Input Pin Programmed I O INI or IN2 selectable Memory PCI 3335 and PCI 3337 Memory PCI PAZ 3305 The analog output doesn t start with this trigger The analog output starts with this AC trigger External trigger DI input pin 4 1 4 Trigger Delays Using trigger delay capability actual analog output starts or stops after a trigger 1s asserted The GPH 3300 has the following trigger delay capability Post Trigger Delay An actual start point or stop point is delayed by the time according to the number of post trigger data Copyright 2002 2003 Interface Corporation All rights reserved d Interface 21 GPH 3300 Help for Linux 4 2 Data Format 4 2 1 Data Type The GPH 3300 handles the three following data types Data Type Analog output data Data handled by the DaStartSampling and DaOutputDA functions Digital input data Data handled by the DaInputDI function Digital output data Data handled by the DaOutputDO function 4 2 2 Analog Output Data The following tables describe how the data are stored Data storage format Data format in a frame Bit arrangement of data Data area size Data Storage Format Data Format in a Frame Channel 1 Channel 2 Using the DaOutputDA function only one frame of analog output data exists in the buffer Copyright 2002 2003 Interface Corporation All rights reserved d Interface 22
49. e n key to go next step 2 Ifyou press the n key the following message will appear To save the settings press the y key If you don t need to save the settings press the n key Save y n y 3 After you press the y or n key the following instructions will appear Press the n key to go next step Press the q key to exit the program Press the n key to go next step Press the q key to exit q Copyright 2002 2003 Interface Corporation All rights reserved d Interface 118 GPH 3300 Help for Linux Chapter 8 Important Information Eu E 8 1 Limited Warranty Interface does not warrant uninterrupted or error free operations of the software product The entire risks as to the quality of or arising out of use or performance of the software products if any remains with you Interface believes that information contained in the document is accurate The document is carefully reviewed for technical accuracy Interface reserves the right to make changes to subsequent editions of this document without prior notice to holders of this edition Interface is not liable for any damages arising out of or related to this document or the information contained in it Charts and tables contained in this document are only for illustration purposes and may vary depending upon a user s specific application All official specifications in metric English unit supplied for convenience 8 2 Copyrights and Intellectual Property Righ
50. e of the EXTRG OUT pin DA EXTRG IN Disables the external trigger output DA EXTRG OUT Enables the external trigger output default setting Copyright 2002 2003 Interface Corporation All rights reserved d Interface 96 GPH 3300 Help for Linux ulExclock For the PCI PAZ 3305 Specifies the configurations of the connector CN4 DA EXCLK IN External clock input default setting DA EXCLK OUT External clock output For the PCI PAZ 3310 PCI 3335 PCI PAZ 3336 PCI 3337 and PCI PAZ 3340 Specifies the mode of the EXCLK OUT pin DA EXCLK IN Disables the external clock output DA EXCLK OUT Enables the external clock output default setting Copyright 2002 2003 Interface Corporation All rights reserved d Interface 97 GPH 3300 Help for Linux 5 2 5 DAMODECHREQ Structure The DAMODECHREQ structure contains the channel specific analog output range configurations This structure 1s one of members of the DAMODEREQ structure and is used for the DaSetMode function typedef struct unsigned long ulRange POET folt unsigned long ELLE aL dee eer DAMODECHREQ PDAMODECHREQ Member Description ulRange Specifies the analog output range DA RANGE UNIPOLAR Unipolar range default setting DA RANGE BIPOLAR Bipolar range fVolt Specifies an absolute value of the maximum voltage of the range specified by the ulRange member in the range of 1 024 V to 10 0 V The voltage is 5 0 V at the default set
51. ecified the last data will be output until the new data 1s set Copyright 2002 2003 Interface Corporation All rights reserved d Interface 101 GPH 3300 Help for Linux Retrigger This capability makes analog output update restart when the condition the start trigger condition is satisfied after analog output is finished is satisfied The DA RETRG cannot be set with DA TRG FREERUN FIFO reset If DA FIFO RESET is set the data will be output from the head of the FIFO at the next analog output update When this code is not set the rest data of the previous analog output will be output Two or more codes setting To set two or more codes use OR operators Example DAFIFOREQ FifoConfig PitToConi ig UlLetoplrioCondi tion DA TRG SIGTIMER DA RETRG DA FIFO RESET ErItoCohrrc ulTrrigbdoe DA START DOWN EDGE DA STOP UP EDGE Copyright 2002 2003 Interface Corporation All rights reserved d Interface 102 GPH 3300 Help for Linux 5 3 Return Values Comments Solutions DA ERROR SUCCESS The process was successfully completed DA ERROR NOT DEVICE 0xC0000001 The specified driver The specified device is not found Make cannot be called sure that the board and the device driver correctly installed in your computer DA ERROR NOT OPEN 0xC0000002 The specified driver Errors occurred while the system opens cannot be opened the device DA ERROR INVALID DEVICE NUMBER 0xC0000003 The
52. eive the function of the connector specified by ulCnNo External trigger input DA CN EXCLK IN External clock input DA CN EXCLK OUT External clock output DA CN EXINT IN External interrupt input DA CN ATRG OUT Analog trigger output DA CN DI General purpose digital input DA CN DO General purpose digital output Return Value The DaGetFunction function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR INVALID PARAMETER DA ERROR NULL POINTER DA ERROR USED AD DA ERROR NOT SUPPORTED Copyright 2002 2003 Interface Corporation All rights reserved d Interface 80 GPH 3300 Help for Linux Comments The operation of this function depends on the setting of CN3 in the GPH 3100 Refer to the following table to check variable combination of codes before you use this function AD AD CN FREE FREE Available Available Available Not available The default value is retrieved by calling this function if the functional configurations are not changed in the DaSetFunction Example int nRet int nDevice 1 unsigned long ulCnNo 3 unsigned long ulFunction nRet DaOpen nDevice if nRet exit 1 nRet DaGetFunction nDevice ulCnNo amp ulFunction ir inBert preintrt Nod FUNCTION 2lx n dlCnNo ulLFuncrion Retrieve
53. esources Any subsequent accesses to the board are forbidden In addition the analog output status after closing the board is selectable by the parameter int DaCloseEx ILIQue nDevice LINE Mon Se SITE Parameters nDevice Specifies the device number opened by the DaOpen function nFinalState Specifies the output status after closing the board DA OUTPUT RESET Resets the analog output status to the default settings DA OUTPUT MAINTAIN Maintains the analog output status including the output code and the output range when the board is closed Return Value The DaCloseEx function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following code Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR INVALID PARAMETER Comments f you access to the board again reopen it to call the DaOpen function If this function is called while an output is running the output is terminated To close the board use either the DaClose function or DaCloseEx function depending on the purpose If the board is closed with specifying DA OUTPUT MAINTAIN the board is set to the last state when the DaOpen function is called When the PCI 3525 is closed by the DaCloseEx function supplied with DA OUTPUT MAINTAIN the CN4 connector on the board is set to the analog output mode AOUT In this case any functions provided by GPH 3100 cannot co
54. f channels Default value of the board Analog output update rate Default value of the board Channel and range Channel 1 4 5 V Channel and range Channel 2 5 V Copyright 2002 2003 Interface Corporation All rights reserved d Interface 110 GPH 3300 Help for Linux 6 3 outputda c This sample program performes one analog output update Specify the device number to control 2 Specify the output voltage and one analog output data will be updated 3 An operation as step 2 will be continued until the output voltage greater than the full scale voltage is specified The following table shows the analog output update conditions Configure them according to your board Setting Number of channels Channel and range Channel 1 5 V 6 4 file c This sample program performs the analog output update from the specified file 1 Write 1024 binary data to the test dat file by using the DaWriteFile function 2 Specify the device number to control 3 Analog output data from the test dat file will be updated as a non overlapped operation The following table shows the analog output update conditions Configure them according to your board Setting Number of channels 1 Default value of the board Number of repeat 100 Analog output update rate 1000 Hz Channel and range Channel 1 5 V Copyright 2002 2003 Interface Corporation All rights reserved d Interface 111 GPH 3300 Help for Linux
55. face 45 GPH 3300 Help for Linux Example int nRet unsigned long ulBufferSize ulEventFactor void event proc int dummy printf Analog outputs completed n nRet DaGetBoardConfig 1 amp ulBufferSize amp ulEventFactor i1f nRet printf Buffer Size 1Xn ulBufferSize printr Source SIX ulEventFactof s nhRet DaSetBoardConfig J 100 NULL event proc 0 if nRet nRet Da5rtartoampling l FLAG ASYNC Retrieve an event source on the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved de Interface 46 GPH 3300 Help for Linux 5 1 7 DaSetSamplingConfig The DaSetSamplingConfig function configures analog output update conditions of the board Time c DIeUSXent o a ique Comin her Int nDevice PDASMPLREQ pDaSmplConfig Parameters nDevice Specifies the device number opened by the DaOpen function pDaSmplConfig Points to the DASMPLREQ structure Return Value The DaSetSamplingConfig function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR ILLEGAL PARAMETER DA ERROR NULL POINTER DA ERROR NOT ALLOCATE MEMORY Comment The number of analog output channels and repetitions cannot be changed while the analog output is running Example int nRet DASMPLREQ DaSmplCon
56. fig DaSmplConfig ulChCount 2 DaSmplConfig SmplChReq 0 ulChNo ds DaSmplConfig SmplChReq 1 ulChNo NO Ne nRet DaSetSamplingConfig 1 amp DaSmplConfig Configure the analog output update conditions of the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved Ww Interface 47 GPH 3300 Help for Linux 5 1 8 DaGetSamplingConfig The DaGetSamplingConfig function retrieves analog output update conditions of the board um ciae sss e oT CN IOE nDevice PDASMPLREQ pDaSmplConfig Parameters nDevice Specifies the device number opened by the DaOpen function pDaSmplConfig Points to the DASMPLREQ structure to receive analog output update conditions Return Value The DaGetSamplingConfig function returns DA ERROR SUCCESS if the process 1s successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NULL POINTER Comment The default settings of the DASMPLREQ structure can be retrieved by calling this function immediately after opening the board Example int nRet unsigned long i DASMPLREQ DaSmplConfig nRet DaGetSamplingConfig 1 amp DaSmplConfig 1 nRet Ifi rsU zx DaomplConrzg ulchoounui xT 1 printf Output channel dMn DaSmplConfig SmplChReq i ulChNo Retrieve the analog output update conditions of the board whose device number is 1
57. g The DaStopSampling function stops the analog output update performed as an overlapped operation Loe DaScoosemyol aime ge nDevice Parameter nDevice Specifies the device number opened by the DaOpen function Return Value The DaStopSampling function returns AD ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR STOP SAMPLING Comment If the callback routine is set by using the DaSetBoardConfig function after this function is called the callback function executes Example int nRet nRet DaStopSampling 1 Stop the analog output update of the board whose device number is 1 immediately Copyright 2002 2003 Interface Corporation All rights reserved d Interface 63 GPH 3300 Help for Linux 5 1 17 DaGetStatus The DaGetStatus function retrieves the analog output update status of the board ipe Dee estes t ESTE nDevice unsigne Ikon mUDBIEUSITOL SE CHEST uno rone dextera eto DIS eget C cua unsigned long ulDaAvailCount unsigned long ulDaAvailRepeat f Parameters nDevice Specifies the device number opened by the DaOpen function ulDaSmplStatus Points to a variable to receive the output status The variable will contain one of the followings DA STATUS STOP SAMPPLING The analog output update is stopped DA STATUS WAIT TRIGGE
58. g ong iong Rome ong DABOARDSPEC Member ulBoardType ulBoardID ulSamplingMode ulChCount ulResolution wlLBoardlype ilL sue euis ulSamplingMode DEBEO OXDEaUT ulLResolueion ulRange UU e eed 7 DEI S ULL IDO 2 DABIOAIRIDIS PEC Description Receives the board model Example If you use the PCI PAZ 3329 this member will contain 3329 in decimal If you use the CTP 3346 this member will contain 3346 in decimal Receives the board ID RSWI value of the board Receives the data transfer mode that the board supports Data Transfer Mode 0 Programmed 1 0 FIFO 3 through 31 0 Not supported 1 Supported Receives the number of channels Receives the resolution of the board Example If you use a 12 bit analog output board this member will contain 12 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 93 GPH 3300 Help for Linux ulRange Receives the output ranges that the board supports 0 Voltage range 0 Vto l V Voltage range 0 V to 42 5 V Voltage range 0 V to 5 V Voltage range 0 V to 10 V LL Voltage range 5 V Voltage range 10 V TT 0 Not supported 1 Supported W IN ulIsolation Receives the isolation capability DA ISOLATION DA NOT ISOLATION Not isolated ulDi Receives the number of the general purpose digital input pins on the board ulDo Receives the number of the general purpose digital outp
59. he board The default values are retrieved by calling the DaGetSamplingConfig function after the board is opened ulSmplRepeat Specify the repetitions of analog output from 1 through 65535 When you specify 0 the driver software repeatedly updates analog outputs until the DaStopSampling function is called or the stop condition is satisfied The default setting value 1s 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 99 GPH 3300 Help for Linux ulSmplNum Specifies the event interval according to the count of output update from 1 through 16777215 When DA TRG SMPLNUM is specified to ulStopTrigCondition analog output update will be stopped when the event is occurred The default setting value is 1 UlStartTrigCondition Specifies start trigger condition of analog output One of the following H codes must be set exclusively DA TRG FREERUN No trigger default setting DA TRG EXTTRG External trigger DA TRG AD PRETRG AD pre trigger DA TRG AD POSTTRG AD post trigger ulStopTrigCondition Specifies stop trigger condition of analog output One of the following l codes must be set exclusively DA TRG SIGTIMER Interval timer AD pre trigger AD post trigger The following codes are ORed with the stop trigger condition DA RETRG DA FIFO RESET Resets FIFO Copyright 2002 2003 Interface Corporation All rights reserved d Interface 100 GPH 3300 Help for Linux ulECl
60. ile the analog obtained The buffer is cleared The output is running buffer is empty so no data is returned Copyright 2002 2003 Interface Corporation All rights reserved d Interface 103 GPH 3300 Help for Linux Continued Comments Solutions 0xC0001025 DA ERROR USED AD The AD driver is using the specified function now DA ERROR FILE OPEN 0xC0001041 Failed to open the file DA ERROR FILE CLOSE 0xC0001042 Failed to close the file Failed to read the file DA ERROR FILE READ 0xC0001043 DA ERROR FILE WRITE 0xC0001044 Failed to write the file DA ERROR INVALID DATA FORMAT 0xC0001061 The specified data format 1s invalid 0xC0001062 DA ERROR INVALID AVERAGE OR SMOOTHING The specified averaging or interpolations are invalid DA ERROE INVALID SOURCE DATA 0xC0001003 Data specified as source is invalid DA ERROR NOT ALLOCATE MEMORY 0xC0001081 Not enough memory Copyright 2002 2003 Interface Corporation All rights reserved d Interface 104 Release the functional configuration that the AD driver is using Then call the function again The specified file doesn t exist Errors occurred while the file is accessed Errors occurred while the file is accessed Errors occurred while the file is accessed Use valid data formats The number of averaging or interpolations is invalid Make sure that specified address of source data is correct
61. input pins available for the mask setting depends on the board specifications This member is available when the trigger mode is an external trigger with mask using a digital input pin The format of ulTrigDI is the same as digital input data Please refer to 4 2 Data Format The default setting value is 0 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 91 GPH 3300 Help for Linux 5 2 2 DASMPLCHREQ Structure The DASMPLCHREQ structure contains the channel specific analog output conditions for each channel This structure is used for the member of the DASMPLREQ structure and the DaOutputDA function typedef struct unsigned long DUE Te OT unsigned long ulRange JC BYE MT ade EO cr lt 2 DAS M2 ICIS Member Description ulChNo Specifies the channel number to output data The range is from 1 through the maximum number of channels that the board provides ulRange Specifies the output range of the channel specified by ulChNo Please select one of the following codes Voltage range 1 V Copyright 2002 2003 Interface Corporation All rights reserved d Interface 92 GPH 3300 Help for Linux 5 2 3 DABOARDSPEC Structure The DABOARDSPEC structure contains the specifications of the board This structure is used for the DaGetDevicelnfo function typedef struct unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned ong ong Wong Wong On
62. ited to the amount paid by the customer for that product 8 5 Trademark Products and company names are trademarks registered trademarks or servicemarks of their respective Owners Copyright 2002 2003 Interface Corporation All rights reserved lInterlace 119
63. kEdge Specifies the edge polarity of the external clock signal This member is available when the fSmplFreq is 0 0f DA DOWN EDGE Falling edge default setting DA UP EDGE Rising edge ulTrigEdge Specifies an edge polarity of each start trigger and or stop trigger when an external trigger is used Use an OR operator when a code is required for each lt Start trigger gt DA START DOWN EDGE Falling edge default setting DA START UP EDGE Rising edge lt Stop trigger gt DA STOP DOWN EDGE Falling edge default setting DA STOP UP EDGE Rising edge Notes Start Stop trigger condition If the same condition is set to both the start trigger condition and stop trigger condition the operation is toggeled When the first time the condition is satisfied analog output update starts At the next time the condition is satisfied the output update stops With the retrigger function output start and stop will be repeated alternately FIFO empty If DA TRG FIFO EMPTY is set to the stop trigger condition analog output update will stop when the output FIFO buffer is empty Analog output update will not start even if you set the new data to the FIFO buffer If both DA TRG FIFO EMPTY and DA RETRG are set to the stop trigger condition you must set the new data when analog output update is finished If not so analog output update will not restart by retrigger capability If a condition except DA TRG FIFO EMPTY is sp
64. l the Linux driver software according to the instructions of the installer dish install Please refer to the README HTM for details of how to install the driver software 3 2 Loading the Driver Modules Load the GPH 3300 driver modules with insmod The following shows an example for the kernel version 24 2 cd lib modules 2 4 2 misc insmod dpg0100 0 tinsmod cp3300 0 Load the dpg0100 o and then load the cp3300 You must follow this loading order 3 3 Configuring the Device Numbers 1 Start the device number setting utility dpg0101 t usr bin dpg0101 2 When the device number setting utility starts the following information and prompt will be displayed psi di dir dir di dir di div dir di div dir di div dir di dir dir di div dis div dir dis div di dii div dir di di dir dir div di dir dir dis dir dir di dir dir di di dir di di diis Setup Utility Version 1 01 02 Copyright 2002 Interface Corporation All rights reserved psi di dir di dir dir di div dir di div dir di dir dir di dir dir dir div dis di dir dis div di di div dir di di dir dir div dis di dir dis dir dir di div dir di di dir di di diris Enter the model number of the product GPG GPH Copyright 2002 2003 Interface Corporation All rights reserved d Interface T GPH 3300 Help for Linux 3 Enter 3300 and press the Enter key The software searches every Interface analog out
65. lkEdge unsigned long DU Late 1 oUeeloie unsigned long DuPar sonde DASMPLREQ PDASMPLREQ Member Description ulChCount Specifies the number of channels to output data It is in the range of 1 through the maximum number of channels that the board provides The default seting value is 1 Specifies the channel numbers in the DASMPLCHREQ structure SmplChReq Specifies the DASMPLCHREQ structure containing the analog output conditions for each channel ulSamplingMode Specifies the data transfer mode Available modes depend on the board DA IO SAMPLING Programmed I O DA FIFO SAMPLING FIFO DA MEM SAMPLING fSmplFreq Specifies the analog output update rate in Hz You can specify this from 0 01f to the maximum output update rate that the board supports To use the external clock please specify 0 0f to this member The default setting is depending on the board The default values are retrieved by calling the DaGetSamplingConfig function after the board 1s opened Copyright 2002 2003 Interface Corporation All rights reserved d Interface 89 GPH 3300 Help for Linux ulSmplRepeat Specify the repetitions of analog output from 1 through 65535 When you specify 0 the driver software repeatedly updates analog outputs until the DaStopSampling function 1s called The default setting value is 1 ulTrigMode Specifies the trigger mode One of the following codes must be set exclusively DA FREERUN No trigger default
66. mplConfig SmplChReq DaSmplConfig SmplChReq O 9 DaSmplConfig SmplChReq 1 1 0 0 1 1 DaSmplConfig fSmplFreq 0 0 Use the external clock DaSmplConfig ulSmplRepeat 1 DaSmplConfig ulTrigMode DA FREERUN DaompilConrig ulTr EsgPolnt DA TRIG START DaSmplConfig ulTrigDelay 0 DaSmplConfig ulEClkEdge DA LOW EDGE DaSmplConfig ulTrigEdge DA LOW EDGE Daompiconr2gsulrrPQioDr U Configure the analog output update conditions nRet DaSetSamplingConfig DeviceNo amp DaSmplConfig Store analog output data to SmplData 512 2 FOr i 0 i lt 512 f i SmplData i 0 i smplLData lily LL 512 i j Set the analog output data nRet DaSetSamplingData DeviceNo amp SmplData 0 0 512 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 18 GPH 3300 Help for Linux Continued Start the analog output update with the external clock pulses nRet DaStartSampling DeviceNo FLAG SYNC nRet DaClose DeviceNo return O0 Copyright 2002 2003 Interface Corporation All rights reserved n Interface 19 GPH 3300 Help for Linux Chapter 4 Functional Descriptions rum MRELILL l M 4 1 Triggering 4 1 1 Trigger Overviews Trigger signals decide when to start and or stop the analog output The tigger has the two following types External trigger External trigger with mask using a general purpose digital input pin
67. ng the DaSetSamplingData function Then start continuous analog output update by using the DaStartSampling function When you use the PCI PAZ 3305 board the DaSetMode function configures the board specific functionality Example C int DaOutput int DeviceNo int IR t 1 DASMPLREQ DaSmplConfig unsigned short SmplData 512 2 nRet DaOpen DeviceNo Specify a buffer size nRet DaSetBoardConfig DeviceNo 512 NULL NULL 0 DaomplContfig ulChCount 2 DaSmplConfig SmplChReq 0 ulChNo 1 DaSmplConfig SmplChReq 0 ulRange DA 5V DaSmplConfig SmplChReq 1 ulChNo 2 DaSmplConfig SmplChReq 1 ulRange DA 5V DaSmplConfig ulSamplingMode DA IO SAMPLING DaSmplConfig fSmplFreq 10000 0 DaSmplConfig ulSmplRepeat 1 DaSmplConfig ulTrigMode DA FREE RUN DaSmplConfig ulTrigPoint DA TRIG START DaSmplConfig ulTrigDelay 0 DaSmplConfig ulEClkEdge DA LOW EDGE DaSmplConfig ulTrigEdge DA LOW EDGE DasmplCosurig uglrr ogDL 0 Configure AREST DaSetSamplingConfig DeviceNo analog output update conditions amp DaSmplConfig Prepare output data Store analog output data to SmplData 512 2 for i 0 i 52 x EE d Copyright 2002 2003 Interface Corporation All rights reserved n Interface 11 GPH 3300 Help for Linux Continued SmplData i 0 i SmplData i 1 512 ij j Set the analog output data nRet DaSetSamplingData DeviceNo amp Smpl
68. ng the wait state 1s defined as follows You can specify the frame frequency in the range of 0 01 Hz to 2 5 MHz wait N th sample frame 3 DA Latching When the waveform output is completed the last output data is hold or set to the lowest value of the output range negative full scale output code of 0000h depending on the DA latch settings The following figure shows the DA latching capability DA latch not cleared The last output voltage is retained DA latch cleared The code 0 is output A waveform output is completed Negative full scale value Copyright 2002 2003 Interface Corporation All rights reserved n Interface 28 GPH 3300 Help for Linux 4 Update Pacer Clock Selection You can select the update pacer clock in time based waveform generation mode Internal programmable timer 0 MHz to 2 5 MHz variable Crystal 5 MHz fixed If 0 is specified as the update rate in the fSmplFreq member of the DASMPLREQ structure an external update pacer clock is used 4 5 2 Frequency Based Waveform Generation Mode In the frequency Based waveform generation mode the update pacer clock is fixed at 524288 Hz 1 Frequency Based Waveform Generation A waveform that has a frequency given by the origianl frequency multiplied by the n th power of two can be generated The waveform data thinned out from source data are output For example one is specified as the power the output data sequence
69. ng waveform generation modes Time based waveform generation Waves are generated by using 1 microsecond of the base clock Frequency based waveform generation Waves are generated by using 1 Hz of the base frequency Mode Time based waveform generation Frequency based waveform generation Number of Data through 524288 524288 All Output Data 5 MHz fixed Intervals between Waves Supported Not supported Repetition through 65536 Infinite Infinite 4 5 1 Time Based Waveform Generation Mode 1 Generation Mode Selection Two output modes are available in the time based waveform generation mode Single output mode Repeat output mode Single Output Mode One cycle or one frame of waveform is output in this mode The following figure shows a waveform that consists of N samples 336 1 PE di I I I I I I K 524288th sampl frame SALIDAS upper limit of the buffer N th sample Copyright 2002 2003 Interface Corporation All rights reserved de Interface 27 GPH 3300 Help for Linux Repeat Output Mode The waveform can be output repeatedly in this mode The repetition is 1 through 65536 or infinite If you specify infinite as the repetition the output continuously performs until the DaStopSampling function 1s called 1 N th sample 2 Variable Frame Cycle in the Repeat Output Mode A wait state can be inserted between one waveform and the next waveform A frame includi
70. nterface 9 GPH 3300 Help for Linux 2 3 Functional Specifications wenn 0 01 Hz to 5 MHz emor only for the PCI PAZ 3305 Trigger capabilities External trigger External trigger with mask using general purpose digital input pins Trigger timing Analog output start trigger and stop trigger are available Start trigger delay capabilities Available data for post trigger 1 through 2 Stop trigger delay capabilities Available data for post trigger 1 through 2 Event notifications The analog output is terminated The analog output is stopped The current loop open failure is detected The reset input signal is asserted Data processings Averaging simple shifted Interpolation Data conversion from binary to physical value and vice versa Notes The maximum output update rate depends on the board specifications operating environments and other conditions Each output update rate in the table 1s a single channel update rate When two or more channels are output simultaneously the rate may decrease depending on the number of channels These values depend on the board specifications Copyright 2002 2003 Interface Corporation All rights reserved d Interface 6 GPH 3300 Help for Linux Chapter 3 Installation and Board Configuration 3 1 Installing the Linux Driver Software 1 Install the board into the open slot according to the manual came with the board 2 Run Linux 3 Instal
71. nterval timer cycle 27 Configures the function of the CN3 connector DaGetFunction Retrieves the functional configuration of the CN3 connector gt e gt DaDataConv Converts forms of the analog data Averaging and interpolation can be done with the conversion UCM NEM CSV formats are supported 3 fnConv Is a placeholder for a callback routine used in the DaDataConv function This function is called when each data is converted 32 CallBackProc Is a placeholder for a callback routine This function is called when the analog output is completed Notes 1 These functions are applicable to the PCI PAZ 3305 PCI PAZ 3310 PCI 3335 PCI PAZ 3336 PCI 3337 and PCI PAZ 3340 2 This function is applicable to the PCI PAZ 3310 PCI PAZ 3329 PCI PAZ 3336 PCI PAZ 3340 PCI 3341A PCI 3342A PCI 3343A PCI 3345A PCI 3346A PCI 3347 PCI PAZ 3521 PCI 3522A and PCI 3523A 3 These functions are applicable to the PCI PAZ 3329 PCI PAZ 3338 CTP 3329 and CTP 3338 4 These functions are applicable only to the PCI 3525 Copyright 2002 2003 Interface Corporation All rights reserved Ww Interface 37 GPH 3300 Help for Linux 5 1 1 DaOpen The DaOpen function opens a board and enables to access to the board int DaOpen BIOS nDevice Parameter nDevice Specifies the device number to open Return Value The DaOpen function returns DA ERROR SUCCESS if the process is successfully completed Otherwise thi
72. ntrol CN4 To resolve this situation reopen PCI 3525 by the DaOpen function and then close the board by the DaClose function Copyright 2002 2003 Interface Corporation All rights reserved d Interface 40 GPH 3300 Help for Linux Example int nRet nRet DaOpen 1 1f nRet nRet DaCloseEx l DA OUTPUT MAINTAIN Close the board whose device number is 1 and the output status is maintained Copyright 2002 2003 Interface Corporation All rights reserved d Interface 41 GPH 3300 Help for Linux 5 1 4 DaGetDevicelnfo The DaGetDeviceInfo function retrieves specifications of the board int DaGetDeviceInfo TOE nDevice PDABOARDSPEC pBoardSpec de Parameters nDevice Specifies the device number opened by the DaOpen function pBoardSpec Points to the DABOARDSPEC structure to receive the specifications of the board Return Value The DaGetDevicelnfo function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NULL POINTER Example int nRet DABOARDSPEC BoardSpec nRet DaOpen 1 1f nRet nRet DaGetDeviceInfo 1 amp BoardSpec if nRet printf Board model Sd n BoardSpec ulBoardType Retrieve the specifications of the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved
73. numbers The following table shows the calibration parameters Calibration Channel Selects the channel Range Selects the range Calibration Item Selects an item Calibration Channel 1 through 4 Unipolar 0 V to 5 V Unipolar O V to 10 Bipolar 5 V to 5 V Bipolar 10 V to 10 Enter the output range Copyright 2002 2003 Interface Corporation All rights reserved ge o 115 GPH 3300 Help for Linux 2 The selected parameters will be displayed Please check the selections are correct Press the y key to start calibration under the conditions If not so press the n key Caribration channel 1 Caribration range 5 V to 5 V 3 Ifyou press the n key you need to configure the parameters again If you press the y key the following instruction will be displayed Enter the calibration item Calibration Item Offset Half scale range Enter the calibration item Calibration Order PCI expansion boards PCI series Ist Offset PCI 3176 PCI 3310 PCI 3335 PCI 3336 PCI 3337 PCI 3340 PCI 3347 2nd Gain 3rd Half scale range PCI expansion boards PAZ series PAZ 3176 PAZ 3310 PAZ 3336 PAZ 3340 CompactPCI expansion boards CTP 3340A CTP 3340B CTP 3340C CTP 3340D CTP 3347 PCI expansion boards PCI series No applicable PCI 3174 PCI 3175 PCI 3305 PCI 3325 PCI 3329 PCI 3338 PCI 3341A PCI 3342A PCI 3343A PCI 3345A PCI 3346A PCI 3521 PCI 3522A PCI 3523A PCI 3525 PCI expan
74. ograms for Kylix The following sample programs are provided for Kylix Sample Program Description outputda k dpr Kylix version of the outputda c sample program sampledata k dpr Kylix version of the sampledata c sample program Compile and run them in the kylix directory as follows cd usr src interface gph3300 1386 linux samples kylix make sample Copyright 2002 2003 Interface Corporation All rights reserved d Interface 113 GPH 3300 Help for Linux Chapter7 Utility Program Qu OOLOA coceaeiaAALDA L i 1L OLLLCIL LL LLLA S3 bJ 3 LLLLLLLoa 7 1 DA Calibration Program We ship the board after it was fully calibrated at 25 degrees centigrade 77 degrees Fahrenheit Adjustments and calibration may be necessary under the following conditions Ambient temperature changes Output configuration changes To optimize measurement accuracy 7 1 1 Required Items for the Calibration Program Interface analog output board Interface analog output board calibration program Terminal block which 1s appropriate for the board Multimeter Use 5 or more digit digital multimeter Cables Use a shielded cable less than or equal to 50 cm 7 1 2 Starting the Calibration Program Change the current directory to interface gph3300 1i386 bin under the target directory at the installation and run cdaadjust then the DA Calibration Program will start This calibration program is neces
75. output ranges and output configurations for each channel on each board When you select the programmed I O mode as a data transfer mode on each board connected you should configure each board to be the same number of channels to output and the same number of the data Only start trigger with no delay is available for triggering in this parallel analog output Available trigger modes depend on the data transfer mode Data Transfer Mode Trigger Modes Available Programmed I O External trigger External A cc with mask using general purpose digital input pin Memory sd External trigger ss ssi is sCid trigger You can specify the master mode only one of the boards in the parallel analog output The others should be specified as the slave mode In execution order of the DaSyncSampling function first you should call this function to each salve board in sequence to place them into the ready state and then call this function to the master board to start the analog output update in parallel Example int nRet nRet DaSyncSampling 2 DA SLAVE MODE nket DaSyncSampling 1 DA MASTER MODE Configure a board whose device number is 2 as a slave board and a board whose device number is as a master board then start simultaneous analog output update in parallel Copyright 2002 2003 Interface Corporation All rights reserved d Interface 62 GPH 3300 Help for Linux 5 1 16 DaStopSamplin
76. pdate is performed as an overlapped operation The DaStartSampling function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR START SAMPLING DA ERROR INVALID PARAMETER Copyright 2002 2003 Interface Corporation All rights reserved d Interface 56 GPH 3300 Help for Linux Comments The analog output update stops when updating all analog output data specified by the DaSetSamplingData function are completed If you choose the repetition the analog output update stops when the specified repetitions are completed 1 Overlapped non overlapped operations Non overlapped operation FLAG SYNC An applications wait until the continuous analog output update is completed User application Lib Driver Board Beginning of the continuous DaStartSampling lanalo g output update e e e Running the continuous gt Running the continuous analog output update analog output update Return to the application The process is successfully completed End of the continuous analog output update Overlapped Operation FLAG ASYNC Control returns immediately without waiting for the completion of the continuous analog output update User application Lib Driver Board Application Beginning of the continuous e DaStartS
77. pen failure is detected on any output channels an interrupt occurs Then a current loop open failure event is signaled At this moment DA EVENT CURRENT OFF of event source is set in the ulSmplEventFactor argument of the DaGetBoardConfig function The output channel on which the current loop open failure was detected cannot be determined by software 4 6 7 Range Configuration bana PL PAZ Board Before one analog data is output by the DaOutputDA function you need to configure the range by using the DaSetSamplingConfig or DaSetMode functions 4 6 8 Number of Analog Output Data PAZ Board The number of analog output data you can specify 1s 1 through 524288 4 6 9 External Clock Board 3310 3335 3336 3310 3336 3340A 3340B 3337 3340 3340 3340C 3340D The EXCLK OUT pin outputs an internal analog update pacer clock depending on the settings The DaSetMode function configures this feature To output an internal update pacer clock signal through the EXCLK OUT pin specify DA EXCLK OUT to the ulExClock member of the DAMODEREQ structure If you specify DA EXCLK IN the EXCLK OUT pin disconnects the clock signal and output high level signal Copyright 2002 2003 Interface Corporation All rights reserved de Interface 33 GPH 3300 Help for Linux 4 6 10 Genelar Purpose T 3174 DA 3175 DA 3174 DA 3174 DA 3175 DA 3176 DA 3176 DA 3182 DA The general purpose digital input output pins cannot be
78. put board installed on the system then displays information about them RSW1 ADDA Dev No 4 Select the command KKKKKKKKKKKKK Command KKKKKKKKKKKK 1 Change the Device Number Delete the Device Number Load new device setting file Run the initialization program 99 Exit the program psi di dir di div div di di dir di div dir di div di di dir dir di div di dir dir dir div dir di div dir di dir dir dis Enter the command number Change the device number Changes the device number of the board l D Delete the device number Deletes the device number To delete it enter the ID of the board Load new device setting file Loads other device setting file Run the initialization program The GPH 3300 doesn t support this command 99 Exit the program Exit the device number setting utility Copyright 2002 2003 Interface Corporation All rights reserved d Interface 8 GPH 3300 Help for Linux 3 4 Programming This section explains how to write the program to output one sample using the PCI PAZ 3310 board whose RSWI setting value is 0 When you use Kylix refer to 5 4 Kylix After writing the program save this file named as datest c tinclude lt stdio h gt Finclude fbida bh int main int nRet DASMPLCHREQ DaSmplChReq 2 unsigned short Data 2 nRet DaOpen 1 if nRet DA ERROR SUCCESS printf Failed to open the device Wn else printf
79. r of the DAMODEREQ structure to disable the external trigger output through the EXTRG OUT pin Copyright 2002 2003 Interface Corporation All rights reserved d Interface 49 GPH 3300 Help for Linux Example int nRet DAMODEREQ DaMode nRet DaGetMode 1 amp DaMode if nRet DaMode ulPulseMode DA MODE SYNTHE nRet DaSetMode 1 amp DaMode Configure the board specific parameters of the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 50 GPH 3300 Help for Linux 5 1 10 DaGetMode The DaGetMode function retrieves configuration information of the board specific functionality PCI PAZ 3305 Retrieves the waveform generation mode PCI 3335 PCI 3337 Retrieves the operation mode of the EXTRG OUT pin PCI PAZ 33 10 Retrieves the operation mode of the EXCLK OUT pin PCI 3335 PCI PAZ 3336 PCI 3337 PCI PAZ 3340 int DaGetMode WME nDevice PDASMPLREO pDaMode Parameters nDevice Specifies the device number opened by the DaOpen function pDaMode Points to the DAMODEREQ structure to receive board specific configurations Return Value The DaGetMode function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NOT SUPPORTED DA ERROR ILLEGAL PARAMETER DA ERROR NULL P
80. s DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR INVALID PARAMETER DA ERROR NULL POINTER DA ERROR SET DATA Comments This function only stores the data into the output buffer To start analog output please call the DaStartSampling function If you call this function while the analog output is running the data are set to the output buffer as the next output data The new data will be output after the output of the previously set data is completed In this case once output of new data starts old data no longer are needed This function appends new data at the tail of the existing data in the output buffer except the PCI 3335 and PCI 3337 For the PCI 3335 and PCI 3337 all data stored in the output buffer are discarded and the new data are stored from the top of the output buffer For the PCI PAZ 3305 this function isn t available while analog output is running Copyright 2002 2003 Interface Corporation All rights reserved n Interface 53 GPH 3300 Help for Linux Example Int X nker unsinged shot SmplData 4096 2 Prepare output data for i 0 i lt 4096 itt SmplData i 0 i empiData r l 4095 a Set the analog output data into the output buffer nRet DaSetSamplingData 1 amp wSmplData 0 0 4096 Store 4096 dat
81. s function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR ALREADY OPEN DA ERROR INVALID DEVICE NUMBER DA ERROR NOT OPEN DA ERROR USED AD Example int nRet nRet DaOpen 1 Open the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved Ww Interface 38 GPH 3300 Help for Linux 5 1 2 DaClose The DaClose function closes a analog output board and releases the resources Any subsequent accesses to the board are forbidden int DaClose IL OVE nDevice Parameter nDevice Specifies the device number opened by the DaOpen function Return Value The DaClose function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following code Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER Comments If you access to the board again reopen it to call the DaOpen function If this function is called while an output is running the output is terminated After closing the board output voltage on every analog output channel is set to 0 V Example int nRet nRet DaOpen 1 1f nRet nRet DaClose 1 Close the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved Wy Interface 39 GPH 3300 Help for Linux 5 1 3 DaCloseEx The DaCloseEx function closes a board and releases the r
82. s successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NULL POINTER DA ERROR NOT SUPPORTED Example int nRet unsigned long ulInterval nRet DaOpen 1 if nRet exit 1 nRet DaGetInterval l amp ullnterval ii aket DA ERROR SUCCESS prilntri 1nterval Slu n ullnterval Retrieve the interval timer cycle on the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface Tf GPH 3300 Help for Linux 5 1 27 DaSetFunction The DaSetFunction function configures the function of the CN3 connector This function is applicable only to the PCI 3525 int Dace rUn tion Int nDevice unsigned long vL CANO unsigned long DLP were 3 Ore Parameters nDevice Specifies the device number opened by the DaOpen function ulCnNo Specifies the connector number to configure the function Specify 3 ulFunction Specifies the function of the connector specified by ulCnNo DA CN FREE The connector is not used default setting DA CN EXTRG IN External trigger input DA CN EXTRG OUT External trigger output DA CN EXCLK IN External clock input Return Value The DaSetFunction function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR
83. sary for the following boards PCI PAZ 3176 PCI PAZ 33 10 PCI 3335 PCI PAZ 3336 PCI 3337 PCI PAZ 3340 PCI 3347 CTP 3340A CTP 3340B CTP 3340C CTP 3340D CTP 3347 7 1 3 Selecting the Board 1 Enter the device number The device number should be set by the device number setting utility DPG 0101 p db di dir di dir di di dir di dir di dir dir di dir di dir dir di dir di dis di di di di dir dir di dir di dis di di dir di dis dir di dis di di di di dir di DA Caribration Program Version 1 01 02 Copyright 2000 2002 Interface Corporation All rights reserved p di di dir di dir dir di dir dir di div di dir di dir dir dir di di dir dis dir di di dir dis di di diro di div dis di dir dis dir div dir div dir di di dir di dir diis Enter the device number Copyright 2002 2003 Interface Corporation All rights reserved n Interface 114 GPH 3300 Help for Linux 2 The board model and RSWI value will be displayed If you select the board that is unnessesary to calibrate the messages This board is calibration free Program is terminated will be displayed and the program will be terminated 3 To start the calibration of the selected board press the y key If not so press the n key Board Information Device No 1 Board Type PCI PAZ 3310 7 1 4 Selecting the Calibration Parameters 1 Configure the calibration parameters and enter the corresponding
84. sion boards PAZ series PAZ 3174 PAZ 3305 PAZ 3325 PAZ 3329 PAZ 3338 PAZ 3521 CompactPCI expansion boards CTP 3174 CTP 3175 CTP 3182 CTP 3325 CTP 3329 CTP 3338 CTP 3342 CTP 3343 CTP 3346 CTP 3348 CTP 3349 CTP 3350 CTP 3351 CTP 3521 CTP 3522 CTP 3523 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 116 GPH 3300 Help for Linux 4 The configration information will be displayed Then connect the multimeter to the channel according to the instructions on the screen Calibration Item V Offset Connection to the Multimeter Connect channel 1 to your multimeter After the connection is completed Pres the y key Pres the y key after ready to run y 5 Apply the voltage to the calibration channel with the accurate voltage supply Press the y key after you ready to run Copyright 2002 2003 Interface Corporation All rights reserved d Interface 117 GPH 3300 Help for Linux 7 1 5 Calibrating the On Board Potentiometer This program displays the goal and tolerance of voltage and you can calibrate the potentiometer according to the instructions on the screen Target Value Max 4 998932 V Goal 4 999237 V Min 4 999542 V Press the u key to increase the volume Press the d key to decrease the volume Press the n key to go next step n 1 Press the u key to increase the volume Press the d key to decrease the volume Press th
85. sly starts analog output update Example C int DaOutput int MasterNo int SlavelNo int Slave2No Int nRet 15 DASMPLREQ DaConfigMaster DASMPLREQ DaConfigSlavel DASMPLREQ DaConfigSlave2 unsigned short DataMaster 512 2 unsigned short DataSlavel 512 2 unsigned short DataSlave2 512 2 nRet DaOpen MasterNo Master board nRet DaOpen SlavelNo Slave board 1 nRet DaOpen Slave2No Slave board 2 Specify a buffer size DaSetBoardConfig MasterNo 512 NULL NULL O0 DaSetBoardConfig SlavelNo 512 NULL NULL O DaSetBoardConfig Slave2No 512 NULL NULL O0 DaConfigMaster ulChCount 2 ulChNo 1 ulRange DA 5V ulChNo 2 DaConfigMaster SmplChReq Ju ulRange DA 9V DaConfigMaster ulSamplingMode DA IO SAMPLING DaConfigMaster fSmplFreq 10000 0 DaConfigMaster SmplChReq DaConfigMaster SmplChReq O 9 DaConfigMaster SmplChReq l1 1 0 0 1 1 DaConfigMaster ulSmplRepeat 1 DaConfigMaster ulTrigMode DA FREE RUN DacontigMaster ullIrigPouant DA TRIG START DaConfigMaster ulTrigDelay 0 DaConfigMaster ulEClkEdge DA LOW EDGE Copyright 2002 2003 Interface Corporation All rights reserved d Interface 13 DaConfigMaster ulTrigEdge DaConfigMaster Configure the analog output update conditions ulTr igDr GPH 3300 Help for Linux Continued Us DA LOW EDGE master board nRet DaSetSamplingConfig MasterNo amp D
86. ssee nennen nennen nennen nnne a nnne rnnt rennen nen 33 4 6 9 External Clock QUO UR 33 4 6 10 Genelar Purpose Digital Input Output eessseessssssssesssseenneeen nennen nennen nnn nnne nnns 34 4 6 11 Analog Output Update Rate Limitation cece cecccceececeeeeeeeeeeseeeeeeeeececessecesseeetsneeeseueessaneensaees 34 4 6 12 Analog Output Update Condition cece cccccececeeeeeeeececeeeeeeeeeeseeeeseeeeseecessucesseeesseeceseueeeseeeessaees 35 Chapter PRelelell Buone cive vbitevubsiibewwbsisevvagbut stuba bets sias suo vn oria rasa o ti vnda wd 36 s ME eM Fe LI ION NENNT mmm 36 er DIOD c ee ee 38 SERE e EC seat setae 39 DAC OS ON EMO e 40 SMEDE EiB Y eigo RT T EEE 42 SDa eE omde ON PENDET eee ee eee eer ee eee 43 SE EID IET isto cite Breq MM T 45 SNMNEB c cerhdenjelevue p 47 5 1 8 DaGetSamplingConfig cscs ais ciesinee nants snicxednadcacacehcuezedalednanbanessnisndlendbeaasiddaedeede ahinextaniesauesdaedsantelenddtacnbaneoneeiice 48 eV WA De QUIM 49 51 10 AS NOS T aE 51 5 1 11 DaSetSamplingDat cc cccccccccccecseeeeeeeeeeeeeeeeeeaeeeeeeeeeeeeseeeeeaeeeeeseeeeeeseeeeesaaeeeeseaeeeesaseeeeesseeeeesaaeees
87. the PCI PAZ 3305 0 ccccccccecseeeeeeeeeeeeeeeeeeeaeeeeeeaeeeesaeeeeeseaees 27 4 5 1 Time Based Waveform Generation MOde ccccccccceeeeeeeeeeeeeeeeeeseeeeeseeeeeeseeeeeeseeeeesseeeeesaeeeeesaneeeeess 27 4 5 2 Frequency Based Waveform Generation MOdG ccccccseeeeecneeeeeeeeeeeeaeeeeeeaeeeeeseeeeesaeeeesaaeeeeseeeeesaaas 29 4 5 3 Independent Programmable Range Settings cccceeccccseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeseeeeesaeeeesaeeeeeseeeeeeeeas 30 zem Nigel T 31 AOA Basic FIOW Of Programs eccouneimerinisao eo eeeko tonis So tenete aciem OmU SU Ud epe EEE p Pase V teo epu ure ss oS rupe esM eiai 31 4 6 2 External Clock External Trigger and MaSK cccccsecccceececeeceeeceeeeeeeseeeeseeseeeeeseeeeseeeessesessseeessaees 31 4 6 3 Attention to External Trigger u iscovt ctas ticxau gat ra Faada dt ges ra bn HD apa iM epe Rp ac uu Va tenia FoadiR tw des EHE Ede dRKR adt QEA 32 4 6 4 Reset in Capability sseeeesssssssssssseseeenneeen nennen nnne n nnne nnne annees nne n nnn nnns nnne nne 32 4 6 5 Handling Data Greater than Buffer Memory Size ssssssssssssssssseeee nennen nennen 33 4 6 6 Current Loop Open Failure Event ccccccccccceececeececeeceeeeeeeseeeeceeceseeeeeaeeeeseeceseeeesseesseeeeseeeeeseeensaees 33 A OF Range C Onl AU OM MEMO 33 4 6 8 Number of Analog Output Data sssssssssssssssssss
88. the configration of the simultaneous analog output DA SYNC OUTPUT The simultaneous analog output is enabled DA NORMAL OUTPUT The simultaneous analog output is disabled default setting Return Value The DaGetOutputMode function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NOT SUPPORTED DA ERROR NULL POINTER Example int nRet Unsigned long ulMode nRet DaGetOutputMode 1 amp ulMode Retrieve the configuration of the simultaneous analog outupt of the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 67 GPH 3300 Help for Linux 5 1 20 DaOutputDA The DaOutputDA function outputs one shot analog data on the board ido n DER ORDRES EUR DAT TME nDevice iuniore cbe me CU PUE PDASMPLCHREQ pSmplChReq vord pData Parameters nDevice Specifies the device number opened by the DaOpen function ulCh Specifies the number of channels to which data are output Each channel number is specified in the ulChNo member of the DASMPLCHREQ structure The settable range is 1 through the maximum number of channels of the board pulSmplChReq Points to the DASMPLCHREQ structure pData Points to the buffer containing data to be output Please refer to 4 2 Data Format Return Val
89. tings for unipolar range 0 V to 5 V and for bipolar range 5 V to 5 V ulFilter Specifies the low pass filter to reduce the glitches appeared on the output waveforms DA FILTER OFF Not used default setting DA FILTER ON Copyright 2002 2003 Interface Corporation All rights reserved d Interface 98 GPH 3300 Help for Linux 5 2 6 DAFIFOREQ Structure The DAFIFOREQ structure contains analog output update conditions for the FIFO data transfer mode This structure is used by the DaSetFifoConfig function typedef struct unsigned long lela OUN DAC METOHREQ SmplLehReq Zo 6 ic LOGE ESMmplE reg unsigned long ulSmplRepeat unsigned long Ukome Num unsigned long DLE el te 1G bre ab oT One ab ean unsigned long UBL SECOS abo eel TE Tb GLO unsigned long ulEClkEdge unsigned long ulTrigEdge Jo DYEIEOE BOIS Eon le DESSEN TEE Member Description ulChCount Specifies the number of channels to output data It 1s in the range of 1 through the maximum number of channels that the board provides The default setting value is 1 Specifies the channel numbers in the DASMPLCHREQ structure SmplChReq Specifies the DASMPLCHREQ structure containing the analog output conditions for each board fSmplFreq Specifies the analog output update rate in Hz You can specify this from 0 01f to the maximum output update rate that the board supports To use the external clock please specify 0 0f to this member The default setting is depending on t
90. tion enables or disables the simultaneous analog output This function is applicable only to the PCI PAZ 3329 PCI PAZ 3338 CTP 3329 and CTP 3338 int DaSetOutputMode iLigue nDevice unsigned long ulMode Ve Parameters nDevice Specifies the device number opened by the DaOpen function ulMode Specifies the simultaneous analog output enabled or disabled DA SYNC OUTPUT Enables the simultaneous analog output DA NORMAL OUTPUT Disables the simultaneous analog output default setting Return Value The DaSetOutputMode function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NOT SUPPORTED DA ERROR INVALID PARAMETER Example int nRet nRet DaSetOutputMode l1 DA SYNC OUTPUT Enable the simultaneous analog output of the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 66 GPH 3300 Help for Linux 5 1 19 DaGetOutputMode The DaGetOutputMode function retrieves the configuration of the simultaneous analog output This function is applicable only to the PCI PAZ 3329 PCI PAZ 3338 CTP 3329 and CTP 3338 int DaGetOutputMode iLigue nDevice unsigned long ulMode Ve Parameters nDevice Specifies the device number opened by the DaOpen function ulMode Points to a variable to receive
91. ts Interface owns all titles and intellectual property rights in and to the products The products includes computer software may include audio visual content such as images text or pictures No part of this publication may not be reproduced or altered in any form or by any means without written prior permission of Interface Corporation 8 3 Warning Regarding Medical and Clinical Use of Interface Products Interface products are not designed with components intended to ensure a level of reliability suitable for use under conditions that might cause serious injury or depth Interface products are not designed with components and testing intended to ensure a level of reliability suitable for use in treatment and diagnosis of human Applications of Interface products involving medical or clinical treatment can create a potential for accidental injury caused by product failure or by errors on the part of the user or application engineer 8 4 Limitation of Liability Interface will not be liable for any special incidental indirect or consequential damages whatsoever including but not limited to damages for lost of profits or confidential or other information for business interruption for personal injury for loss of privacy even if interface or any reseller has been advised of the possibility of such damages Customer s right to recover damages caused by fault or negligence on the part of Interface Corporation shall be lim
92. ue The DaOutputDA function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR ILLEGAL PARAMETER DA ERROR INVALID PARAMETER DA ERROR NULL POINTER Comment For example if you want to output data on the channel 1 channel 3 channel 5 and channel 7 the number of channel is four Each channel number is stored in the ulChNo member of the DASMPLCHREQ structure Copyright 2002 2003 Interface Corporation All rights reserved d Interface 68 GPH 3300 Help for Linux Example int nRet DASMPLCHREQ SmplChReq 4 SmplChReq 0 ulChNo 1 SmplChReq 1 ulChNo 3 oSmplChReq 2 ulChNo 5 SmplChReq 3 ulChNo 7 nRet DaOutputDA 1 4 amp SmplChReq 0 pData Output data to channel 1 channel 3 channel 5 and channel 7 on the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 69 GPH 3300 Help for Linux 5 1 21 DalnputDI The DaInputDI function reads general purpose digital input pins on the board Tie Dolna ESTE nDevice uno rigne d dion rs c Ul iDerce 3 Parameters nDevice Specifies the device number opened by the DaOpen function ulData Points to a variable to receive the digital input data Please refer to 4 2 Data Format Return Value The DaInputDI function returns DA ER
93. ulSmplRepeat 1 DaFifoConfig ulSmplNum 100 DaritoConi 1g ulStarcirgcondition DA TRG FREERUN DaFifoConfig ulStopIrgCondition DA TRG SMPLNUM DaskifoContzig ulbClkEdge DA DOWN EDGE DaFifoConfig ulETrgEdge DA START DOWN EDGE nRet DaOpen 1 if nRet exit 1 nBet DaSetbiroConfig 1 amp DaFifoConfig Configure the analog output update conditions of the board whose device number 1s 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 173 GPH 3300 Help for Linux 5 1 24 DaGetFifoConfig The DaGetFifoConfig function retrieves analog output update conditions of the board at FIFO data transfer mode This function is applicable only to the PCI 3525 int DaGetFifoConfig mt nDevice PDAFIFOREQ D TE O ORE 3 OT Parameters nDevice Specifies the device number opened by the DaOpen function pDaFifoConfig Points to the DAFIFOREQ structure to receive analog output update conditions Return Value The DaGetFifoConfig function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following codes Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NULL POINTER DA ERROR NOT SUPPORTED Comment The default settings of the DAFIFOREQ structure can be retrieved by calling the DaGetFifoConfig function immediately after opening the board Example int nRet unsigned long 1i DAFIFOREQ
94. update stops If retrigger capability is set to the conditions these operations will be performed repeatedly with timer events Start by software by the DaStartSampling function l l Timer cycle i l i Analo g output i i i Start trigger and stop trigger i l without retrigger l i i i l I Analog output i Analo g output i l Analo g output l l Start trigger and stop trigger I with retrigger Start Stop Start Stop Start Stop Copyright 2002 2003 Interface Corporation All rights reserved d Interface 15 GPH 3300 Help for Linux Example int nRet nRet DaOpen 1 if nRet exit 1 nRet DaSetInterval l 1000 Configure the interval timer cycle to 1 ms on the board whose device number 1s 1 Copyright 2002 2003 Interface Corporation All rights reserved d Interface 76 GPH 3300 Help for Linux 5 1 26 DaGetinterval The DaGetInterval function retrieves the interval timer cycle This function 1s applicable only to the PCI 3525 int DaGetInterval aLigue nDevice unsigned hole oud nr eivai Ne Parameters nDevice Specifies the device number opened by the DaOpen function pullin erval Points to a variable to receive the interval timer cycle in the range of 0 through 16777215 in us If the cycle is 0 the interval timer is stopped Note us means microsecond Return Value The DaGetInterval function returns DA ERROR SUCCESS if the process i
95. ut pins on the board Copyright 2002 2003 Interface Corporation All rights reserved d Interface 94 GPH 3300 Help for Linux 5 2 4 DAMODEREQ Structure The DAMODEREQ structure contains board specific parameters used in the DaSetMode and DaGetMode functions typedef struct DAMODECHREO unsigned long unsigned long unsigned long it LOeve unsigned long unsigned long unsigned long unsigned long unsigned long ModeChReq 2 DUE Same TQUE ulPulseMode ullnterval flntervalCycle ulCounterClear jp Ipse ne elg ULL Semio liner OC k UAL note e obe UAL Chol DAMODEREQ PDAMODEREQ Member ModeChReq ulSyntheOut ulPulseMode ullInterval flntervalCycle Description Specifies the channel specific output range configurations DAMODECHREQ structure First element and second element of the array correspond channel 1 and channel 2 respectively You have to configure the condition for 2 channels Specifies the waveform generation mode DA MODE CUT Time based waveform generation default setting DA MODE SYNTHE Frequency based waveform generation Specifies the multiplier for the frequency based waveform generation It must be one of the power of two less than or equal to 524288 The default setting value 1s 1 Specifies whether the wait state 1s inserted or not in the repeat output mode DA REPEAT NONINTERVAL Repeat without the wait state default setting DA REPEAT INTERVAL Repeat with the
96. wait state Specifies the frame frequency in the repeat output mode You can specify it from 0 01 to 2500000 in Hz The default settoing value 1s 1 0 Hz Copyright 2002 2003 Interface Corporation All rights reserved d Interface 95 GPH 3300 Help for Linux ulCounterClear Specifies the analog output counter status when the analog output update starts DA COUNTER CLEAR Cleared default setting DA COUNTER NONCLEAR ulDaLatch Specifies whether the output voltages are hold DA latch not cleared or set to the lowest voltage of the range DA latch cleared when the analog output is completed DA LATCH CLEAR IDASATOHGOIEAR Pfhevoluseisscbtoihelowesbvdliaseof voltage is set to the lowest voltage of the E EE DA DA COUNTER NONCLEAR NONCLEAR The Thevolageisheld is held ulSamplingClock Specifies the analog output update pacer clock source The internal programmable timer enables the output update rate up to 2 5 MHz in variable Fixed 5 MHz clock source is also available DA CLOCK TIMER The update pacer clock source is the internal programmable timer The frequency is 2 5 MHz at the default setting DA CLOCK FIXED The update pacer clock source is the fixed 5 MHz clock ulExContro l For the PCI PAZ 3305 Specifies the configurations of the connector CN3 DA EXTRG IN External trigger input default setting DA EXTRG OUT External trigger output For the PCI 3335 and PCI 3337 Specifies the mod
97. ze void CALLBACK CallBackProc int dummy ulSmplBufferSize 2048 nRet DaSetBoardConfig 1 ulSmplBufferSize NULL CallBackProc 0 Set event handling on the board whose device number is 1 Copyright 2002 2003 Interface Corporation All rights reserved Ww Interface 44 GPH 3300 Help for Linux 5 1 6 DaGetBoardConfig The DaGetBoardConfig function retrieves an event source on the board int DaGetBoardConfig TQ nDevice unsigned lona aol S T EISE US Sal ey unsigned long ulSmplEventFactor Ve Parameters nDevice Specifies the device number opened by the DaOpen function ulSmplBufferSize Points toa variable to receive the output buffer size ulSmplEventFactor Points to a variable to receive an event source of the analog output DA EVENT STOP TRIGGER The analog output has been stopped because a trigger is asserted DA EVENT STOP FUNCTION The analog output has been stopped by software DA EVENT STOP SAMPLING The analog output terminated DA EVENT RESET IN The reset input signal is asserted DA EVENT CURRENT OFF The power failure has been detected Return Value The DaGetBoardConfig function returns DA ERROR SUCCESS if the process is successfully completed Otherwise this function returns the following code Please refer to the error codes DA ERROR NOT DEVICE DA ERROR INVALID DEVICE NUMBER DA ERROR NULL POINTER Copyright 2002 2003 Interface Corporation All rights reserved n Inter
Download Pdf Manuals
Related Search
GPH 3300 gp 3300 gp 3300i power push gp 3300 generator gph3000w gps3300-1 gp3300i gh3300 gp3300 generac gh3300 datasheet gp330004 gp3300dn gp3300 generac parts gp3300i generac
Related Contents
GRILLE D`ÉVALUATION DU RISQUE RÉSISTANCE GRAMINÉES Anleitung DRS 200 Sony LMP600 projection lamp Samsung SGH-X820 Εγχειρίδιο χρήσης USER MANUAL - Mega Systems Progress Lighting P6419-31 Installation Guide Users Manual Addendum – OS v3.1 (671) June 16 Turbo-V 300HT PCB Controller User Manual aumento de cobertura establecimiento : jardín Copyright © All rights reserved.
Failed to retrieve file