DM6430 Driver for Windows 98/NT4/2000/XP User`s Manual version
Contents
1. ClearDINFIFO6430 void ClearDINFIFO6430 RTDHANDLE hBoard Description This routine is used to clear the Digital Input FIFO Parameters hBoard device handle ClearIRQ16430 void ClearIRQ16430 RTDHANDLE hBoard Description This routine is used to clear the IRQ 1 circuitry and status bit Parameters hBoard device handle ClearIRQ26430 23 DM6430 Driver for Windows 98 NT4 2000 XP void ClearIRQ26430 RTDHANDLE hBoard Description This routine is used to clear the IRQ 2 status bit Parameters hBoard device handle ClearIrg5812_6430 void ClearIrq5812_6430 RTDHANDLE hBoard uchar8 SelectedChip Description This routine clears the selected DIO chips IRQ status bit Parameters hBoard device handle SelectedChip 0 1 2 ClearRegister6430 void ClearRegister6430 RTDHANDLE hBoard uint16 ClearValue Description This routine is used to write the clear register with one command and issue a clear to the board Parameters hBoard device handle ClearValue 1 65535 ClockDivisor6430 void ClockDivisor6430 RTDHANDLE hBoard uchar8 Timer uint16 Divisor Description This routine is used to set the divisor of a designated counter on the 8254 programmable interval timer PIT This procedure assumes that the counter has already been set to receive the least significant uchar8 LSB of the divisor followed by the most significant uchar8 MSB Parameters hBoard device handle Timer 0 1 2 Divisor 0 652. Entry 2 will sample AIN1 which is now connected to EAINI and simultaneously outputs 3 on Digital Port 1 As a result the expansion board switches to EAIN4 Next entry 3 samples AIN2 and outputs 3 on Digital Port 1 which makes the expansion board to switch again to EAIN4 When executing entry 1 again AIN1 is sampled which is now connected to EAIN4 and so on NOTE If you only need to use the A D part of the table you do not have to program the Digital Table However if you only want to use the Digital part of the table you must program the A D part of the table NOTE When the Channel Gain Latch is used Digital Table is ignored When using the Channel Gain Table you should group your entries to maximize the throughput of your module Low level input signals and varying gains are likely to drop the throughput rate because low level inputs must drive out high level input residual signals To maximize throughput Q Keep channels configured for a certain range grouped together even if they are out of sequence Use external signal conditioning if you are performing high speed scanning of low level signals This increases throughput and reduces noise Q If you have room in the channel gain table you can make an entry twice to make sure that sufficient settling time has been allowed and an accurate reading has been taken Set the skip bit for the first entry so that it is ignored Q For best results do not use
3. This routine checks to see if the digital I O chip has generated an interrupt Parameters DM6430 Driver for Windows 98 NT4 2000 XP 34 hBoard device handle Returns 1 if IRQ has been generated 0 if no IRQ IsDINFIFOEmpty6430 uintl6 IsDINFIFOEmpty6430 RTDHANDLE hBoard Description This routine checks to see if the Digital Input FIFO is empty Parameters hBoard device handle Returns 1 if FIFO is empty 0 if FIFO is not empty IsDINFIFOFull6430 uintl6 IsDINFIFOFull6430 RTDHANDLE hBoard Description This routine checks to see if the Digital Input FIFO is full Parameters hBoard device handle Returns 1 if FIFO is full 0 if FIFO is not full IsDINFIFOHalf6430 uintl6 IsDINFIFOHalf6430 RTDHANDLE hBoard Description This routine checks to see if the Digital Input FIFO is half full Parameters hBoard device handle 35 DM6430 Driver for Windows 98 NT4 2000 XP Returns 1 if FIFO is half full 0 if FIFO is not half full IsFirstADDMADone6430 uintl6 IsFirstADDMADone6430 RTDHANDLE hBoard Description This routine checks to see if the A D DMA transfer is done on the first channel Parameters hBoard device handle Returns 1 if DMA is done 0 if DMA is not done IsIRQ16430 uint16 IsIRQ16430 RTDHANDLE hBoard Description This routine checks the IRQ status bit Parameters hBoard device handle Returns 1 if IRQ has been generated 0 if no IRQ IsIRQ26430 uint16 IsIRQ26430 RTDHANDLE hBo
4. enabled DoneTimer6430 void DoneTimer6430 RTDHANDLE hBoard Description Initialize the timers for high speed to ensure the immediate load Parameters hBoard device handle DM6430 Driver for Windows 98 NT4 2000 XP 26 EnableIrg5812_6430 void EnableIrq5812_6430 RTDHANDLE hBoard uchar8 SelectedChip uchar8 Enable Description This routine enables the selected DIO chips interrupt Parameters hBoard device handle SelectedChip 05 15 2288 Enable 0 Disabled 1 Enabled EnableTables6430 void EnableTables6430 RTDHANDLE hBoard uint16 Enable AD Table uint16 Enable_Digital_Table Description This Routine Enables and Disables both the AD and Digital Tables Parameters hBoard device handle Enable_AD_ Table 0 disable 1 enable Enable_Digital_Table 0 disable 1 enable 27 DM6430 Driver for Windows 98 NT4 2000 XP FlushDMA6430 void FlushDMA6430 RTDHANDLE hBoard Description This routine flushes the DMA buffer Parameters hBoard device handle DM6430 Driver for Windows 98 NT4 2000 XP 28 GetAutoincDataByte6430 BOOL GetAutoincDataByte6430 RTDHANDLE hBoard AutoincSetup autoincsetup uintl6 DataNum Description This routine is used to get the data with autoincrement driver mode It uses the INP_B command to read data Parameters hBoard device handle autoincsetup parameters for autoincrement command DataNum number of data item to read Return value TRUE on success
5. 0 255 O In 1 Out SetPort1Direction5812_6430 void SetPort1 Direction5812_6430 RTDHANDLE hBoard uchar8 SelectedChip uchar8 Direction Description This routine sets the selected DIO chips port direction Parameters hBoard device handle SelectedChip 0 1 2 51 DM6430 Driver for Windows 98 NT4 2000 XP Direction 0 In 1 Out SetStartTrigger6430 void SetStartTrigger6430 RTDHANDLE hBoard uint16 Start Trigger Description This routine selects the start trigger Parameters hBoard device handle Start Trigger 0 software trigger 1 external trigger 2 digital interrupt 3 User TC Counter 1 out 4 reserved 5 reserved 6 reserved 7 gate mode SetStopTrigger6430 void SetStopTrigger6430 RTDHANDLE hBoard uint16 Stop Trigger Description This routine selects the stop trigger Parameters hBoard device handle Stop_Trigger 0 software trigger 1 external trigger 2 digital interrupt 3 sample counter 4 about software trigger 5 about external trigger 6 about digital interrupt 7 about user TC counter 1 out SetTriggerPolarity6430 void SetTriggerPolarity6430 RTDHANDLE hBoard uint16 Polarity Description This routine sets the external trigger polarity Parameters hBoard device handle DM6430 Driver for Windows 98 NT4 2000 XP 52 Polarity 0 positive edge 1 negative edge SetTriggerRepeat6430 void SetTriggerRepeat6430 RTDHANDLE hBoard uint16 Repeat Descrip
6. Each board has a unique device number between 0 and 9 I O port base address The I O base address of the board IRQ number The IRQ number using of the board DMA channel The DMA channel using of the board DMA buffer size The DMA buffer size It should not be more than 64k Dual DMA channel If this check box is set it means that this is a driver for the second DMA channel of the same board 7 DM6430 Driver for Windows 98 NT4 2000 XP Register Press this button to store the settings in the Windows registry Refresh Press this button to get the information from the registry about the selected device number Under Windows 98 2000 XP same changes can be made using Control Panel System Hardware Device Manager WinRT Devices Do not forget that all boards are required different driver devices and in your C program must be used the DEVICE_NO according to the driver device number Installing a second board in the system It is possible to use more than one board in the system using the RTD s data acquisition board drivers Please follow the next steps to install a multi board system Install the first board with all software and make sure that everything is working well Place the second board in an empty slot in the PC and switch on the computer Windows NT4 0 After the system startup start the installation program and answer YES to the next board installation question Restarting the system with t
7. NT4 2000 XP Direct Memory Access DMA DMA transfers data between peripheral device and PC memory without using the processor as an intermediate This method allows very fast data transfer rates The DM6430 driver provides an interface for the user to handle the DMA channels of the board The driver handles the dual DMA mode of the DM6430 too The following program steps are necessary to use the DMA Q Q Initialize the board setup triggering modes Install the DMA handler InstalIDMA6430 DEVICE_NO amp dmasetup TRUE 0 0 Program DMA channel SetADDMA6430 DEVICE_NO ADDMAChannel 0 Perform data collection Close DMA channel DelInstallIDMA6430 DEVICE_NO 0 To see how to use the DMA channel on the DM6430 board see the dma and wdma example programs DM6430 Driver for Windows 98 NT4 2000 XP 18 Driver API Function Groups Driver Initialization Functions OpenBoard CloseBoard General Board Control Functions InitBoard6430 ClearBoard6430 ClearRegister6430 ReadStatus6430 LoadControlRegister6430 LoadTriggerRegister6430 FIFO Manipulation ClearADFIFO6430 IsADFIFOEmpty6430 Is ADFIFOFull6430 ClearDINFIFO6430 IsDINFIFOEmpty6430 IsDINFIFOHaIf6430 IsDINFIFOFull6430 ReadDINFIFO6430 DMA Functions InstalIDMA DelnstalIDMA Start DM A FlushDMA SetADDMA6430 ClearADDMADone6430 IsADDMADone6430 IsFirstADDMADone6430 A D Converter IsADHalted6430 IsADConverting6430 SetADSampleCounterStop6430 SetADP
8. arrays acquiring data for a specified period and taking a specified number of samples Random Channel Scan In this mode the Channel Gain Table is incrementally scanned through with each selected A D Conversion Signal pulse starting a conversion at the channel and gain specified in the current table entry Before starting a conversion sequence Channel Gain Table you need to load the table with the desired data Then make sure that the Channel Gain Table is enabled by the function EnableTables6430 This enables the A D an Digital portion of the Channel Gain Table as well Each rising edge of selected A D Conversion Signal starts a conversion using the current Channel Gain data and then increments to the next position in the table When the last entry is reached the next pulse starts the table over again Programmable Burst In this mode a single trigger initiates a scan of the entire Channel Gain Table Before starting a burst of the Channel Gain Table you need to load the table with the desired data Then enable the Channel Gain Table by EnableTable6430 Burst is used when you want one sample from a specified number of channels for each trigger The burst trigger starts the Burst Clock and the Burst Clock initiates each conversion At high speeds the burst mode emulates simultaneous sampling of multiple input channels For time critical simultaneous sampling applications a simultaneous sample and hold board can be used SS8 eight channe
9. 16 Se_Diff Description This routine loads the channel gain latch Parameters hBoard device handle Channel 0 15 Gain 0 xl 1 x2 2 x4 DM6430 Driver for Windows 98 NT4 2000 XP 48 3 x8 4 reserved 5 reserved 6 reserved 7 reserved Se_Diff 0 single ended 1 differential SetConversionSelect6430 void SetConversionSelect6430 RTDHANDLE hBoard uint16 Select Description This routine selects the conversion mode Parameters hBoard device handle Select 0 software trigger 1 pacer clock 2 burst clock 3 digital interrupt SetIRQ1_6430 void SetIRQ1_6430 RTDHANDLE hBoard uint16 Source uint16 Channel Description This routine sets the source and channel for interrupt 1 Parameters hBoard device handle Source 0 A D sample counter 1 A D start convert 2 A D End of Convert 3 A D Write FIFO 4 A D FIFO half full 5 A D DMA done 6 Reset channel gain table 7 Pause channel gain table 8 External Pacer Clock 9 External trigger 10 Digital chip interrupt 11 User TC out 0 12 User TC out 0 inverted 13 User TC out 1 14 Digital Input FIFO half full 15 DIN Write FIFO 16 31 reserved Channel 0 disabled 49 DM6430 Driver for Windows 98 NT4 2000 XP 3 IRQ 3 5 IRQ 5 9 IRQ9 10 IRQ 10 11 IRQ 11 12 IRQ 12 15 IRQ 15 SetIRQ2_6430 void SetIRQ2_6430 RTDHANDLE hBoard uint16 Source uint16 Channel Description This routine sets the source and
10. 535 ClockMode6430 DM6430 Driver for Windows 98 NT4 2000 XP 24 void ClockMode6430 RTDHANDLE hBoard uchar8 Timer uchar8 Mode Description This routine is used to set the mode of a designated counter in the 8254 programmable interval timer PIT Parameters hBoard device handle Timer 0 1 2 Mode 0 1 2 3 4 5 CloseBoard6430 BOOL CloseBoard6430 LONG DEVICE_NO LPSTR szBuf Description This routine is used to close board driver Parameters DeviceNumber WinRT device number to load szBuf message buffer Return value TRUE on success FALSE on error ConfigDINClock6430 void ConfigDINClock6430 RTDHANDLE hBoard uint16 DIN Clock Description This routine configures the Digital Input FIFO clock source Parameters hBoard device handle DIN_Clock 0 user T C out 0 1 user T C out 1 2 write A D FIFO 3 external pacer clock 4 external trigger 5 reserved 6 reserved 7 reserved 25 DM6430 Driver for Windows 98 NT4 2000 XP DelInstalIDMA6430 BOOL DelnstallIDMA6430 RTDHANDLE hBoard int dma ch index Description This routine is used to remove DMA handler Parameters hBoard device handle dma_ch_index DMA channel index 0 1 Returns 0 if success error code if not success DINClockEnable6430 void DINClockEnable6430 RTDHANDLE hBoard uint16 DIN Clock Description This routine enables the Digital Input FIFO clock Parameters hBoard device handle DIN Clock 0 disabled 1
11. DLE hBoard Description This routine is used to reset both the AD Table and the Digital Table pointers to the first location in the table Parameters hBoard device handle 45 DM6430 Driver for Windows 98 NT4 2000 XP SelectClock5812_6430 void SelectClock5812_6430 RTDHANDLE hBoard uchar8 SelectedChip uchar8 Clock Description This routine sets the selected DIO chips clock source Parameters hBoard device handle SelectedChip 0 1 2 Clock 0 8 MHz 1 Programmable clock SelectIrqMode5812_6430 void SelectIrqMode5812_643007 RTDHANDLE hBoard uchar8 SelectedChip uchar8 IrqMode Description This routine sets the selected DIO chips Irq mode Parameters hBoard device handle SelectedChip 0 1 2 IrqMode 0 Event mode 1 Match mode SelectRegister5812_6430 void SelectRegister5812_6430 RTDHANDLE hBoard uchar8 SelectedChip uchar8 Select Description This routine picks the different registers on the selected DIO chip Parameters hBoard device handle SelectedChip 0 1 2 Select 0 Clear mode 1 Port 0 direction 2 Port 0 mask 3 Port 0 compare SelectTimerCounter6430 void SelectTimerCounter64300 RTDHANDLE hBoard uint16 Select DM6430 Driver for Windows 98 NT4 2000 XP 46 Description This routine selects one of the four 8254 timer chips Parameters hBoard device handle Select 0 Clock TC Pacer amp Burst clocks 1 User TC A D sample counter amp User
12. DM6430 Driver for Windows 98 NT4 2000 XP User s Manual version 4 0 AA a l i LN TID RTD Embedded Technologies Inc Real Time Devices Accessing the Analog World SWM 640010003 Rev B ISO9001 and AS9100 Certified RTD Embedded Technologies INC 103 Innovation Blvd State College PA 16803 0906 Phone 1 814 234 8087 FAX 1 814 234 5218 E mail sales rtd com techsupport rtd com web site http www rtd com DM6430 Driver for Windows 98 NT4 2000 XP Revision History 08 06 2003 revision A issued Documented for ISO9000 09 12 2003 revision B issued Version 4 0 released Company name changed Windows 2000 XP support added Windows 95 support removed interface of the following functions changed OpenBoard6430 SetPacerClock6430 SetBurstClock6430 SetUserClock6430 DM6430 Driver for Windows 98 NT4 2000 XP Published by RTD Embedded Technologies Inc 103 Innovation Blvd State College PA 16803 0906 Copyright 2003 RTD Embedded Technologies Inc All rights reserved Printed in U S A The RTD Logo is a registered trademark of RTD Embedded Technologies cpuModule and utilityModule are trademarks of RTD Embedded Technologies PS 2 PC XT PC AT and IBM are trademarks of International Business Machines Inc MS DOS Windows Windows 95 Windows 98 Windows NT Windows 2000 and Windows XP are trademarks of Microsoft Corp PC 104 is a registered trademark of PC 104 C
13. FALSE on error GetAutoincDataWord6430 BOOL GetAutoincDataWord6430 RTDHANDLE hBoard AutoincSetup autoincsetup uint16 DataNum Description This routine is used to get the data with autoincrement driver mode It uses the INP_W command to read data Parameters hBoard device handle autoincsetup parameters for autoincrement command DataNum number of data item to read Return value TRUE on success FALSE on error GetErrorStatus6430 BOOL GetErrorStatus6430 RTDHANDLE hBoard LONG ErrorCode LPSTR ErrorString Description This routine is used to get the error code and string in case of errors The function clears the last error code Parameters 29 DM6430 Driver for Windows 98 NT4 2000 XP hBoard device handle ErrorCode Error Code ErrorString Return error string GetIRQCounter6430 void GetIRQCounter6430 RTDHANDLE hBoard IRQSetup irqsetup Description This routine is used to get the counter incremented by IRQ Parameters hBoard device handle irqsetup return parameters to caller DM6430 Driver for Windows 98 NT4 2000 XP 30 InitBoard6430 void InitBoard6430 RTDHANDLE hBoard Description This Routine Should always be called first This clears the board and variables the driver uses Parameters hBoard device handle InstallCallbackIRQHandler6430 BOOL InstallCallbackIR QHandler6430 RTDHANDLE hBoard isr_t handler Description This routine is used to install IRQ handler function
14. MA channel acquisition The data is displayed numerically on Sampling on pacer clock the screen Start trigger software Stop trigger software speedtst Sampling on pacer clock It demonstrates three methods of data Start trigger software acquisition with interrupt Stop trigger software e callback function Using IRQ handler function e poll the IRQ counter e get data with autoincrement mode DM6430 Driver for Windows 98 NT4 2000 XP 56 Win32 Windows applications 57 It programs the digital port 0 to input port to output Single DMA channel acquisition Sampling on pacer clock Start trigger software Stop trigger software Dual DMA channel acquisition Sampling on pacer clock Start trigger software Stop trigger software High speed digital input example The user timer counter is programmed to sample the digital input At digital FIFO half full generated an interrupt and the data is stored and displayed The user timer counter is programmed to generate interrupts The analog input sampled when the IT occurs Random channel acquisition with CGT The pacer clock programmed to start conversion with burst clock Sampling on pacer clock Start trigger software Stop trigger software Interrupt on sample counter Sampling on pacer clock Start trigger software Stop trigger sample counter Interrupt on sample counter Single A D sampling Start trigger software Stop trigger software xample on how
15. Mask5812_6430 void LoadMask5812_6430 RTDHANDLE hBoard uchar8 SelectedChip uchar8 Mask Description This routine loads the selected DIO chips mask register Parameters hBoard device handle SelectedChip 0 1 2 Mask 0 255 LoadTriggerRegister6430 void LoadTriggerRegister6430 RTDHANDLE hBoard uint16 Value Description This routine loads the trigger register with one write operation Parameters hBoard device handle DM6430 Driver for Windows 98 NT4 2000 XP 40 41 Value 0 65535 DM6430 Driver for Windows 98 NT4 2000 XP OpenBoard6430 BOOL OpenBoard6430 int num int device_id LPSTR szBuf BoardConfig boardconfig Description This routine is used to open board driver Parameters num the number of the board device_id 6430h hexadecimal szBuf return string BoardConfig Return board configuration Return value TRUE on success FALSE on error DM6430 Driver for Windows 98 NT4 2000 XP 42 ReadADData6430 intl6 ReadADData6430 RTDHANDLE hBoard Description This Routine Reads the Data from the FIFO Parameters hBoard device handle Returns 16 bit AD Data ReadChannelGainDataStore6430 uintl6 ReadChannelGainDataStore6430 RTDHANDLE hBoard Description This Routine Reads the Channel Gain Data from the FIFO when the Channel Gain Data Store feature of the board is enabled Parameters hBoard device handle Returns 16 bit value Bottom 8 bits A D table value Upper 8 bits digital ta
16. Parameters hBoard device handle isrT handler user callback function Return value TRUE on success FALSE on error InstallCounter RQHandler6430 BOOL InstallCounterIRQHandler6430 RTDHANDLE hBoard IRQSetup irqsetup Description This routine is used to install IRQ handler function Parameters hBoard device handle irqsetup return parameters to caller Return value TRUE on success FALSE on error InstalIDMA6430 BOOL InstalIDMA6430 RTDHANDLE hBoard DMASetup dmasetup BOOL fill UCHAR fill_byte int dma_ch_index 31 DM6430 Driver for Windows 98 NT4 2000 XP Description This routine is used to install DMA handler Parameters hBoard device handle dmasetup return parameters to caller fill TRUE if buffer fill is necessary fill_byte DMA buffer filler dma_ch_index DMA channel index 0 1 Return value TRUE on success FALSE on error IsAboutTrigger6430 uintl6 IsAboutTrigger6430 RTDHANDLE hBoard Description This routine checks to see if the about trigger has occurred Parameters hBoard device handle Returns 1 if trigger has occurred 0 if trigger has not occurred IsADConverting6430 uint16 IsADConverting6430 RTDHANDLE hBoard Description This routine checks to see if the AD converting Parameters hBoard device handle Returns 1 if AD is converting 0 if AD is not converting IsADDMADone6430 uintl6 IADDMADone6430 RTDHANDLE hBoard DM6430 Driver for Windows 98 NT4 2000 XP 32 Descri
17. Q External Trigger Interrupt is generated when the external trigger line is pulsed Q Digital Interrupt Interrupt is generated when the Advanced Digital Trigger signals a Digital Interrupt This interrupt can be used to detect and react on certain patterns on Digital Input Port 0 User Timer Counter 0 Out User Timer Counter 0 Out inverted Q User Timer Counter 1 Out Interrupt is generated on the ticks of User T CO i e when the counter counts down to zero This interrupt gives you a general purpose means of measuring real time frequency or counting events It is also intended to use for Pulse output generation Digital Input FIFO Half Full Interrupt is generated when the Digital Input FIFO is half full Digital Input FIFO Write Interrupt is generated when sample enters the Digital Input FIFO D To service interrupts with the DM6430 Driver is very simple Actually when you install your interrupt handler it is not a real Interrupt Service Routine since you can not do that under Windows Your handler is an ordinary routine which is called by the real Interrupt Service Routine implemented by the DM6430 driver The driver s Interrupt Service Routine schedules your interrupt handler for execution as a separate thread acknowledges the interrupt to the board s interrupt controller and returns After returning the scheduled thread starts executing your interrupt handler 17 DM6430 Driver for Windows 98
18. UT OF THE USE OR INABILITY TO USE THE PRODUCT SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR CONSUMER PRODUCTS AND SOME STATES DO NOT ALLOW LIMITATIONS ON HOW LONG AN IMPLIED WARRANTY LASTS SO THE ABOVE LIMITATIONS OR EXCLUSIONS MAY NOT APPLY TO YOU THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM STATE TO STATE DM6430 Driver for Windows 98 NT4 2000 XP 58 RTD Embedded Technologies Inc 103 Innovation Blvd State College PA 16803 0906 USA Our website www rtd com 59 DM6430 Driver for Windows 98 NT4 2000 XP
19. adChannelGainDataStore6430 SetChannelGain6430 LoadADTable6430 LoadDigitalTable6430 External Trigger Configuration Functions SetTriggerPolarity6430 Error Handling Functions GetErrorStatus6430 21 DM6430 Driver for Windows 98 NT4 2000 XP Alphabetical Driver API Functions Reference ChannelGainDataStore6430 void ChannelGainDataStore6430 RTDHANDLE hBoard uint16 Enable Description This routine enables the Channel Gain Data Store feature of the board Parameters hBoard device handle Enable 0 Disable 1 Enable ClearADFIFO6430 void ClearADFIFO6430 RTDHANDLE hBoard Description This routine is used to clear all the data from the A D FIFO Parameters hBoard device handle ClearADDMADone6430 void CleaarADDMADone6430 RTDHANDLE hBoard Description This routine is used to clear the A D DMA done status bit Parameters hBoard device handle ClearBoard6430 void ClearBoard6430 RTDHANDLE hBoard Description This routine is used to clear board DM6430 Driver for Windows 98 NT4 2000 XP 22 Parameters hBoard device handle ClearChannelGainTable6430 void ClearChannelGainTable6430 RTDHANDLE hBoard Description This routine is used to clear both the AD Table and the Digital Table Parameters hBoard device handle ClearChip5812_6430 void ClearChip5812_6430 RTDHANDLE hBoard uchar8 SelectedChip Description This routine clears the selected DIO chip Parameters hBoard device handle SelectedChip 0 1 2
20. ard Description This routine checks the IRQ 2 status bit Parameters hBoard device handle Returns 1 if IRQ has been generated DM6430 Driver for Windows 98 NT4 2000 XP 36 0 if no IRQ IsPacerClockOn6430 uint16 IsPacerClockOn6430 RTDHANDLE hBoard Description This routine checks to see if the pacer clock is running Parameters hBoard device handle Returns 1 if Pacer Clock is on 0 if Pacer Clock is off 37 DM6430 Driver for Windows 98 NT4 2000 XP LoadADSampleCounter6430 LoadADSampleCounter6430 RTDHANDLE hBoard uint16 NumOfSamples Description This routine loads the A D sample counter Parameters hBoard device handle NumOfSamples 0 65535 LoadADTable6430 void LoadADTable6430 RTDHANDLE hBoard uintl6 Num of Entry ADTableRow ADTable Description This routine loads the AD Table with the given number of entries Parameters hBoard device handle Num_of_Entry 1 1024 The struct ADTableRow is defined in REG6430 h typedef struct uintl6 Channel 0 15 uint16 Gain 0 xl 1 x2 2 x4 3 x8 4 reserved 5 reserved 6 reserved 7 reserved uintl6 Se_Diff 0 single ended 1 differential uint16 Pause 0 disabled 1 enabled uintl6 Skip 0 disabled 1 enabled ADTableRow DM6430 Driver for Windows 98 NT4 2000 XP 38 LoadCompare5812_6430 void LoadCompare5812_6430 RTDHANDLE hBoard uchar8 SelectedChip uchar8 Compare Description This routine loads the se
21. ation utility and the readme txt file The example programs will be installed in the target directory under the Examples folder This folder contains the example program sources for the DM6430 board and the project files for Microsoft Visual C users to rebuild the programs The example programs are compiled with the Microsoft Visual C ver 6 0 In case of different version of Visual C is installed on your PC please rebuild the executable files Uninstallation you can uninstall the DM6430 driver and example programs under the Control panel with the Add Remove Programs tool DM6430 Driver for Windows 98 NT4 2000 XP 6 The DM6430 board driver The RTD s DM6430 board driver handles the hardware through the BlueWater s WinRT driver The WinRT driver provides the low level access to the board and the RTD s Drvr6430 dll provides the device API for the programmers and communicates with the hardware through the WinRT driver The RTD board drivers has multi board feature It means that it is possible to use more than one board in the system The base address of the DM6430 board can be set by DIP switch If you are using multiple boards in your system you need assign a different base address to each board The IRQ and DMA channels are set programmatically When you install a WinRT driver for the board you must select the IRQ and DMA channel and during the operating of the board must be used this IRQ and DMA channels Eac
22. auseEnable6430 ReadADData6430 StartConversion6430 SetConversionSelect6430 SetStartTrigger6430 SetStopTrigger6430 SetTriggerRepeat6430 19 DM6430 Driver for Windows 98 NT4 2000 XP D A Converter LoadDAC6430 LoadDAC26430 Pacer Clock Handling SetPacerClock6430 IsPacerClockOn6430 SetPacerClockSource6430 Burst Clock Handling SetBurstClock6430 IsBurstClockOn6430 SetBurstTrigger6430 About Counter Functions IsAboutTrigger6430 Sample Counter Functions LoadADSampleCounter6430 Digital O Functions IsDigitalIRQ6430 LoadDINConfigRegister6430 ConfigDINClock6430 DINClockEnable6430 SelectRegister5812 ClearChip58 12 SetPortODirection58 12 SetPort 1 Direction58 12 LoadMask58 12 LoadCompare5812 ReadDIO5812 ReadCompareRegister5812 SelectClock5812 WriteDIO5812 Interrupt Handling InstallCallbackIRQHandler InstallCounterI RQHandler RemoveIRQHandler GetIRQCounter ClearIRQ16430 ClearIRQ26430 IsIRQ16430 IsIRQ26430 DM6430 Driver for Windows 98 NT4 2000 XP 20 LoadIRQRegister6430 SetIRQ16430 SetIRQ26430 ClearIrg5812 EnableIrg5812 SelectIrqMode58 12 IsChipIRQ58 12 Autoincrement Data Handling GetAutoincDataByte GetAutoincDataWord User Timer Counter Functions SelectTimerCounter6430 ClockMode6430 ClockDivisor6430 SetUserClock6430 ReadTimerCounter6430 DoneTimer6430 Channel Gain Table Latch Manipulation ClearChannelGainTable6430 ResetChannelGainTable6430 EnableTables6430 ChannelGainDataStore6430 Re
23. ble value ReadCompareRegister5812_6430 uchar8 ReadCompareRegister5812_6430 RTDHANDLE hBoard uchar8 SelectedChip Description This routine reads the selected DIO chips compare register Parameters hBoard device handle SelectedChip 0 1 2 ReadDINFIFO6430 uintl6 ReadDINFIFO6430 RTDHANDLE hBoard 43 DM6430 Driver for Windows 98 NT4 2000 XP Description This Routine Reads the Data from the Digital Input FIFO Parameters hBoard device handle Returns 8 bit value ReadDIO5812_6430 uchar8 ReadDIO5812_6430 RTDHANDLE hBoard uchar8 SelectedChip uchar8 Port Description This routine reads the selected DIO chips port Parameters hBoard device handle SelectedChip 0 1 2 Port 0 1 ReadStatus6430 uint16 ReadStatus6430 RTDHANDLE hBoard Description This routine returns the status from the board Parameters hBoard device handle Returns 16 bit unsigned integer ReadTimerCounter6430 uintl6 ReadTimerCounter6430 RTDHANDLE hBoard uchar8 Timer uchar8 Clock Description This routine is used to read the contents of the selected timer counter Parameters hBoard device handle DM6430 Driver for Windows 98 NT4 2000 XP 44 Timer 0 1 Clock 0 1 2 Returns uintl6 RemoveIRQHandler6430 void RemoveIRQHandler6430 RTDHANDLE hBoard Description This routine is used to uninstall IRQ handler function Parameters hBoard device handle ResetChannelGainTable6430 void ResetChannelGainTable6430 RTDHAN
24. ccossstecsodestesssvestecssecdesesbecsosssbecseess 13 MEASUREMENT SCENARIOS ccscsesssessscssssscsesesescscsesescscsesesssesesescssescscscsesscsescscsssserscstetsteeaes 13 CHANNEL GAIN CIRCUITRY a E E E E E E R T 13 TINEBRRUPTS aserne E TAEA ENESE RESE PETATE SAE EAAS 16 DIRECT MEMORY ACCESS DMA recni iiien E Ee E E EE R i E ria 18 DRIVER API FUNCTION GROUPS ssssscssssscccssssccccssscccssssccccssecccsssccccsseccsessseccessecscessnee 19 DRIVER INITIALIZATION FUNCTIONS 0 scsssesesssssssssescsessscssscscsssesscssscssssescscscscscstssssssessteteees 19 GENERAL BOARD CONTROL FUNCTIONS M u WG Gssseeveveveveverererereren enes ene eres even en ener ere een ener ener een ener eee 19 FIFO MANIPULATION Gd wsssseeeeeeverererereeereeeeenee eee eee ener eres enes renere renere renere renen ener ener ener ener ener enen eee 19 DIMA FUNCTIONS 2 Es E ale ar EE E ES ere eee EE 19 AJD CONVERTER susende ENEAN AE EEE Denner dernede 19 D A CONVERTER sas nere n ooo geese 20 PACER CLOCK HANDLING ss aars asec gese E BAL aa SES ORS oo 20 BURST CLOCK HANDLING ccccscsesesesssesessscscsessscsessssescsesescsesesscscseseseseaeseseseaessseaeeeseseseaessaeees 20 ABOUT COUNTER FUNCTIONS ccscssssssssssssssscsssssssssesssesssssssescsesescssescsssesesesesesesesesesesesuseseseees 20 SAMPLE COUNTER FUNCTIONS onenn uan ce cobcus a a covucs scnseusdocebocs Cocuedes ce covies ieendbuscecesee 20 DIGITAL IVO FUNCTIONS vee arsen de cette uk e
25. channel for interrupt 2 Parameters hBoard device handle Source 0 A D sample counter 1 A D start convert 2 A D End of Convert 3 A D Write FIFO 4 A D FIFO half full 5 A D DMA done 6 Reset channel gain table 7 Pause channel gain table 8 External Pacer Clock 9 External trigger 10 Digital chip interrupt 11 User TC out 0 12 User TC out 0 inverted 13 User TC out 1 14 Digital Input FIFO half full 15 DIN Write FIFO 16 31 reserved Channel 0 disabled 3 IRQ3 5 IRQ5 9 IRQ9 10 IRQ 10 11 IRQ 11 12 IRQ 12 15 IRQ 15 SetPacerClock6430 float32 SetPacerClock6430 RTDHANDLE hBoard float32 ClockRate Description This routine sets the pacer clock rate It will automatically decide whether to use a 16 or 32 bit clock depending on the rate DM6430 Driver for Windows 98 NT4 2000 XP 50 Parameters hBoard device handle ClockRate 100 KHz or less Returns The actual clock frequency that is programmed SetPacerClockSource6430 void SetPacerClockSource6430 RTDHANDLE hBoard uint16 Source Description This routine sets the pacer clock source Parameters hBoard device handle Source 0 Internal 1 External SetPortODirection5812_ 6430 void SetPort0Direction5812_6430 RTDHANDLE hBoard uchar8 SelectedChip uchar8 Direction Description This routine sets the selected DIO chips port 0 direction Parameters hBoard device handle SelectedChip 0 1 2 Direction
26. h board requires a unique WinRT device to handle the hardware Also the second DMA channel of the DM6430 board requires a unique device The maximum number of devices is 32 The DM6430 board has a dual DMA feature working with two DMA channels parallel This operating mode requires a different driver device for the second DMA channel So every DM6430 board uses two WinRT devices one after the other and they are using successive driver ID s During the installation the Setup exe program set the default driver values Board 1 0x300 base address DMA channel 5 DMA buffer size 0x4000 and IRQ 11 Board 1 2 nd DMA channel DMA channel 6 DMA buffer size 0x4000 If these settings are not proper to your PC configuration you can modify the settings with the Drvr_cfg exe program in Windows NT4 0 In case of Windows 98 2000 XP the operating system uses a WDM driver and it can be configured in the Control Panel System Hardware Device Manager The Driver Configuration As in the previous chapter mentioned after installing the driver the default settings are used If these settings are not proper to your PC configuration or there are other RTD boards used you can modify the settings Under Windows NT driver can be configured with the Drvr_cfg exe program This program is installed on your PC during the setup process and it can be started from the Start menu Program options Device number The number of device which handles the board
27. h entry 1 and so on When the Channel Gain Latch is used or in burst mode Pause Bit is ignored DM6430 Driver for Windows 98 NT4 2000 XP 14 Skip Skip Bit When the Skip Bit is set the entry is skipped which means that the A D conversion is performed but the resulting sample is not written into the A D FIFO This feature provides a way to sample multiple channels at different rates without saving unwanted data EXAMPLE In this example we want to sample AIN1 in every second and AIN4 in every three seconds For this end we must create CGT with six entries Entry 1 AIN1 Skip Bit 0 Entry 2 AIN4 Skip Bit 1 Entry 3 AIN1 Skip Bit 0 Entry 4 AIN4 Skip Bit 1 Entry 5 AIN1 Skip Bit 0 Entry 6 AIN4 Skip Bit 0 Next we set the Pacer Clock to run at 2 Hz 0 5 seconds This allows us to sample each channel once per second the maximum sampling rate required by one of the channels pacer clock rate number of different channels sampled x fastest sample rate The first Pacer Clock pulse starts an A D conversion according to the parameters set in the first entry of the Channel Gain Table and each successive clock pulse incrementally steps through the table entries The first clock pulse takes a sample on AIN1 The second pulse looks at the second entry in the table and sees that the Skip Bit is set Sample is taken but is not stored in the FIFO The third pulse takes a sample on AIN1 again the fourth pulse skips t
28. he next entry and the fifth pulse takes our third reading on AIN1 On the sixth pulse the Skip Bit is disabled AIN4 is sampled and sample is stored to the FIFO Then the sequence starts over again with entry 1 Samples are not stored when they are not wanted saving memory and eliminating the need to throw away unwanted data NOTE When the Channel Gain Latch is used Skip Bit is ignored DO 8 Bit Digital Table The digital portion of the Channel Gain Table also referred to as Digital Table can be used to control input expansion boards such as the TMX32 Analog Input Expansion board The expansion board is driven at the same speed as the A D conversions are performed with no software overhead EXAMPLE Let us consider the following simple example on driving an analog input expansion board In this example we have a TMX32 expansion board connected to AIN1 on the DM6430 We have three signals to sample one is connected to the first channel of the expansion board EAIN1 the second is connected to the fourth channel of the expansion board EAIN4 and the third is connected directly to AIN2 of the DM6430 We need to create the following Channel Gain Table DM6430 Driver for Windows 98 NT4 2000 XP Entry 1 AIN1 gain 1 DO 0 Entry 2 AIN1 gain 4 DO 3 Entry 3 AIN2 gain 1 DO 3 Execution starting with entry 1 samples AIN1 and simultaneously outputs 0 on Digital Port 1 This will cause the expansion board to switch to EAIN1
29. he two board example program is possible to test the working of both boards Please note that during the second board installation the driver and example program files will be refreshed thus you need to save the important changes before starting the install Windows 98 2000 XP You need only the installation diskette 0 to install the next boards Follow the steps described in the readme txt file on diskette 0 Working with Other Boards Using the WinRT Driver As you may have in your computer other RTD boards which uses the WinRT driver or a board from other manufacturer with WinRT our installation program automatically detects the WinRT settings from the system registry file and installs the appropriate next WinRT device You can see an informational dialog box about this issue during the setup As an application written for the DM6430 board should know which WinRT device is assigned to the board the installation program generates the file wrtdev txt in the Examples directory containing the actual device number The example programs are reading this file at the startup to identify this number If the other board in your system which uses the WinRT driver does not handle the situation when there is other WinRT based application install this board firstly and then install the DM6430 which handles correctly this state DM6430 Driver for Windows 98 NT4 2000 XP 8 Using Windows registry keys The RTD board drivers are using the next regis
30. in This field specifies the gain to apply to the input Available choices are1x 2x 4x 8x Se Diff Pause Analog Input Type Pause Bit If this bit is enabled by the SetADPauseEnable6430 function execution of the Channel Gain Table stops after executing this entry Execution is resumed with the next CGT entry when the programmed Pacer Clock start trigger occurs EXAMPLE Pause Bit can be used when you have two sequence of entries each to be NOTE executed on a different event trigger Suppose that CGT is driven by the Pacer Clock and the Pacer Clock is started on the External Trigger The External Trigger comes from a device whose pulses indicate two different events Odd pulses indicate an event on which you want to react by sampling AINI and AIN2 on even pulses you want to sample AIN3 AIN4 and AINS In this case you would create a 5 entry CGT Entry 1 AINI Pause Bit 0 Entry 2 AIN2 Pause Bit 1 Entry 3 AIN3 Pause Bit 0 Entry 4 AIN4 Pause Bit 0 Entry 5 AINS Pause Bit I In this case the first pulse on the External Trigger line starts executing the CGT at the rate of the Pacer Clock After executing the first two entries execution stops and is waiting for the next External Trigger pulse The second pulse resumes execution and entries 3 4 and 5 are executed at the rate of the Pacer Clock Execution pauses again after executing entry 5 A third External trigger pulse continues execution wit
31. l boards are available from Real Time Devices Programmable Multi Scan This mode when the A D Conversion Start Signal is the Burst Clock lets you scan the Channel Gain Table after a Burst Clock Start Signal When the Channel Gain Table is empty the Burst Clock is stopped and will wait for a new Start Signal Channel Gain Circuitry Channel Gain Tables are traditionally for implementing random channel scan analog input on boards where a single A D converter is multiplexed for 8 16 or more analog input channels 13 DM6430 Driver for Windows 98 NT4 2000 XP The Channel Gain Circuitry embeds a 1024x24 bit on board memory Channel Scan Memory called Channel Gain Table CGT for historical reasons Every 24 bit row entry in a CGT is an instruction executed by the Channel Gain circuitry Execution happens at a programmable rate Channel Gain Latch CGL provided for easy single channel analog input can be perceived as a special single row CGT for the following description Unless explicitly indicated explanation holds for the CGL as well The table below pictures the format of a CGT entry DO Skip Pause SeDiff Gain Channel 8 bits lbt 1bt 1bit 3 bits 4bits Channel Analog Input Channel Specifies the Analog Input channel to sample Depending on your configuration you may have 8 differential channels AIN1 AIN8 or 16 Single Ended channels AIN1 AIN16 Gain Analog Input Ga
32. lected DIO chips compare register Parameters hBoard device handle SelectedChip O51 Drs Compare 0 255 LoadControlRegister6430 void LoadControlRegister6430 RTDHANDLE hBoard uint16 Value Description This routine loads the control register with one write operation Parameters hBoard device handle Value 0 65535 LoadDAC6430 LoadDAC26430 void LoadDAC6430 RTDHANDLE hBoard int16 Data void LoadDAC26430 RTDHANDLE hBoard int16 Data Description This routine loads the DAC value If the board is assembled with two D A converters the second DAC is accessible with the LoadDAC26430 function Parameters hBoard device handle Data 0 65535 LoadDigitalTable6430 void LoadDigitalTable6430 RTDHANDLE hBoard uintl6 Num of Chan uchar8 Channel Description This routine loads the Digital Table with the given number of entries Parameters hBoard device handle 39 DM6430 Driver for Windows 98 NT4 2000 XP Channel 0 255 Num of Chan 1 1024 LoadDINConfigRegister6430 void LoadDINConfigRegister6430 RTDHANDLE hBoard uint16 Value Description This routine loads the Digital Input configuration register with one write operation Parameters hBoard device handle Value 0 65535 LoadIRQRegister6430 void LoadIRQRegister6430 RTDHANDLE hBoard uint16 Value Description This routine loads the interrupt register with one write operation Parameters hBoard device handle Value 0 65535 Load
33. ng Interface with a lot of function calls to perform all the data acquisition tasks of the board users The board driver is based on the BlueWater System s WinRT device driver kit There are example programs to demonstrate the various board features and the usage of the driver API The example programs are written in Microsoft Visual C ver 6 0 Installation Installation of the Driver and Example Programs Before installing the driver and example program files you need to install the DM6430 board in your PC Please follow the instructions of the manufacturer how to install the board in a computer To install the drivers for the DM6430 under Windows 98 2000 XP you need the installation diskette 0 The readme txt file on this diskette describes the necessary installation steps For Windows NT4 0 the installation diskette 0 is not needed On the installation diskette 1 you can found the Setup exe program which installs on your PC the DM6430 board driver and example programs The setup program automatically detects your operating system and installs the appropriate files on your PC After starting the setup please follow the instructions on the screen to install the programs You can select the directory where to install the files The setup also adds to the Start menu under the Programs folder of your Windows system the RTD Embedded Technologies folder It contains shortcuts to the example programs the driver configur
34. ologies All replaced parts and products become the property of RTD Embedded Technologies Before returning any product for repair customers are required to contact the factory for an RMA number THIS LIMITED WARRANTY DOES NOT EXTEND TO ANY PRODUCTS WHICH HAVE BEEN DAMAGED AS A RESULT OF ACCIDENT MISUSE ABUSE such as use of incorrect input voltages improper or insufficient ventilation failure to follow the operating instructions that are provided by RTD Embedded Technologies acts of God or other contingencies beyond the control of RTD Embedded Technologies OR AS A RESULT OF SERVICE OR MODIFICATION BY ANYONE OTHER THAN RTD Embedded Technologies EXCEPT AS EXPRESSLY SET FORTH ABOVE NO OTHER WARRANTIES ARE EXPRESSED OR IMPLIED INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FIT NESS FOR A PARTICULAR PURPOSE AND RTD Embedded Technologies EXPRESSLY DISCLAIMS ALL WARRANTIES NOT STATED HEREIN ALL IMPLIED WARRANTIES INCLUDING IMPLIED WARRANTIES FOR MECHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE LIMITED TO THE DURATION OF THIS WARRANTY IN THE EVENT THE PRODUCT IS NOT FREE FROM DEFECTS AS WARRANTED ABOVE THE PURCHASER S SOLE REMEDY SHALL BE REPAIR OR REPLACEMENT AS PROVIDED ABOVE UNDER NO CIRCUMSTANCES WILL RTD Embedded Technologies BE LIABLE TO THE PURCHASER OR ANY USER FOR ANY DAMAGES INCLUDING ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES EXPENSES LOST PROFITS LOST SAVINGS OR OTHER DAMAGES ARISING O
35. onsortium All other trademarks appearing in this document are the property of their respective owners Table of Contents TABLE OF CONTENTS wissscicsvesssssessonsesessonssesiesigsnasessevensossescedssdeasssesiaseosesdeessbentessvasesodestaseosesse 4 INTRODUCTION skies onus cosesdeevsgubsces suabiesvessesesssbecscaveanssssvesesheeses 5 INSTALLATION isessssisssscecsdsccosstonssscUescssssncesessssccedecsessssusceccessssastsecsdceseteesooseedsasense cs kessi isossa Eso 6 INSTALLATION OF THE DRIVER AND EXAMPLE PROGRAMS scscscsssescsesssssssssssssessssssststssssstenees 6 THE DM6430 BOARD DRIVER sssssesesesssssssesessscsesesessscsesssesesscssescsescscscscecsesecsnssesesteretsssaeees 7 THE DRIVER CONFIGURATION 0 scscsesesssssssssssessscssssscsessssscsesesssesesesusesssesesesesesesesesesesesesesrsteees 7 INSTALLING A SECOND BOARD IN THE SYSTEM ecssscsssessssssscssssssscscssscssssscsssesessscsssesestsssssrsteeaes 8 WORKING WITH OTHER BOARDS USING THE WINRT DRIVER 0 ccccccceeeeeeeseseseseseeeseseseseseseeees 8 USING WINDOWS REGISTRY KEYS s ccsssssssssessscssscsescsescscsesesessscscsscsscssscssscsescscscscscscstetstssssseaes 9 THE DRIVER API FUNCTIONS sicccscccccsessscsssecsessssacsosssacesetensossssssscesesacsesiecccecesciossesseos iesseseses 11 USING THE DRIVER WITHOUT THE WINDOWS GUL cccssccsssssscsssscccsssecessssccsssnee 12 DM6430 FEATURES eiccissscssccssesvensesnsvonsecosicssussesocsescaseesecdessvsn
36. ption This routine checks to see if the A D DMA transfer is done Parameters hBoard device handle Returns 1 if DMA is done 0 if DMA is not done Is ADFIFOEmpty6430 uintl6 ISADFIFOEmpty6430 RTDHANDLE hBoard Description This routine checks to see if the A D FIFO is empty Parameters hBoard device handle Returns 1 if FIFO is empty 0 if FIFO is not empty Is ADFIFOFull6430 uint16 ISADFIFOFull6430 RTDHANDLE hBoard Description This routine checks to see if the A D FIFO is full Parameters hBoard device handle Returns 1 if FIFO is full 0 if FIFO is not full IsADHalted6430 uint16 IsADHalted6430 RTDHANDLE hBoard Description This routine checks to see if the AD is halted 33 DM6430 Driver for Windows 98 NT4 2000 XP Parameters hBoard device handle Returns 1 if AD is halted 0 if AD is not halted IsBurstClockOn6430 uintl6 IsBurstClockOn6430 RTDHANDLE hBoard Description This routine checks to see if the burst clock is enabled Parameters hBoard device handle Returns 1 if Burst Clock is on 0 if Burst Clock is off IsChipIRQ5812_6430 uchar8 IsChipIrq5812_6430 RTDHANDLE hBoard uchar8 SelectedChip Description This routine checks to see if the selected DIO chip has generated an interrupt Parameters hBoard device handle SelectedChip 0 1 2 Returns 1 if IRQ has been generated 0 if no IRQ IsDigitalIRQ6430 uint16 IsDigitalIRQ6430 RTDHANDLE hBoard Description
37. the channel gain table when measuring steady state signals Use the single convert mode to step through the channels Interrupts Controller can receive interrupt request from up to 15 sources These 15 sources cover the most important internal signals of the board plus 2 external signals Q A D Sample Counter Countdown Interrupt is generated when the A D Sample Counter counts down to zero This interrupt can be used to count more than 65535 samples by counting the turnovers of the Sample Counter DM6430 Driver for Windows 98 NT4 2000 XP 16 Q A D Start Convert Interrupt is generated when a conversion is started Q A D End Of Convert Interrupt is generated when an end of convert is issued by the A D converter Q A D FIFO Write Interrupt is generated when sample enters the A D FIFO This interrupt can be used for reading and processing samples real time A D FIFO Half Full Interrupt is generated when the A D FIFO is half full Q A D DMA Done Interrupt is generated when the A D DMA done flag goes high Q CGT Reset Interrupt is generated when the Channel Gain Table recycles execution to the first table entry This interrupt can be used for reading and processing a burst of samples from different channels real time Q CGT Pause Interrupt is generated when Channel Gain Table execution is paused waiting for a new trigger Q External Pacer Clock Interrupt is generated when the external pacer clock line is pulsed
38. timer counters 2 reserved 3 reserved SetADDMA6430 void SetADDMA6430 RTDHANDLE hBoard uint16 Channel1 uint16 Channel2 Description This routine sets the A D DMA channels Parameters hBoard device handle Channel1 0 disabled 5 DRQ 5 5 DRQ 6 7 DRQ7 Channel2 0 disabled 5 DRQ5 6 DRQ6 7 DRQ7 SetADPauseEnable6430 void SetPauseEnable6430 RTDHANDLE hBoard uint16 Enable Description This routine enables and disables the A D pause bit Parameters hBoard device handle Enable 0 Enable 1 Disable SetADSampleCounterStop6430 void SetSampleCounterStop6430 RTDHANDLE hBoard uint16 Enable Description This routine enables and disables the A D sample counter stop bit 47 DM6430 Driver for Windows 98 NT4 2000 XP Parameters hBoard device handle Enable 0 Enable 1 Disable SetBurstClock6430 float32 SetBurstClock6430 RTDHANDLE hBoard float32 BurstRate Description This routine sets the burst clock rate Parameters hBoard device handle Burst Rate 100 KHz or less Returns The actual clock frequency that is programmed SetBurstTrigger6430 void SetBurstTrigger6430 RTDHANDLE hBoard uint16 Burst_Trigger Description This routine selects the burst trigger Parameters hBoard device handle Burst_Trigger 0 Software trigger 1 pacer clock 2 external trigger 3 digital interrupt SetChannelGain6430 void SetChannelGain6430 RTDHANDLE hBoard uint16 Channel uint16 Gain uint
39. tion This routine sets the trigger repeat bit Parameters hBoard device handle Repeat 0 Single Cycle 1 Repeat Cycle SetUserClock6430 float32 SetUserClock6430 RTDHANDLE hBoard uchar8 Timer float32 InputRate float32 OutputRate Description This routine sets the user timer counters Parameters hBoard device handle Timer 0 1 2 InputRate Input clock to selected timer OutputRate Desired output rate from selected timer Returns The actual clock frequency that is programmed StartConversion6430 void StartConversion6430 RTDHANDLE hBoard Description This routine is used to create software triggers or enable hardware triggers depending on the conversion mode Parameters hBoard device handle StartDMA6430 void Start DMA6430 RTDHANDLE hBoard ULONG UserLength int dma_ch_index 53 DM6430 Driver for Windows 98 NT4 2000 XP Description This routine starts DMA Parameters hBoard device handle UserLengt user definable dma length dma_ch_index DMA channel index 0 1 DM6430 Driver for Windows 98 NT4 2000 XP 54 WriteDIO5812_6430 void WriteDIO5812_6430 RTDHANDLE hBoard uchar8 SelectedChip uchar8 Port uchar8 Data Description This routine writes the selected DIO chips port Parameters hBoard device handle SelectedChip 05 152 88 Port 0 1 Data 0 255 55 DM6430 Driver for Windows 98 NT4 2000 XP Example Programs Reference Win32 console applications Single D
40. to use two boards Demonstration of user counters The user can change the output voltage with the on screen slider The user can set the digital output port the program reads the input port The data displayed graphically on the screen It demonstrates the high speed gap free data acquisition The data stored in file The data displayed graphically and stored in file The data displayed graphically The samples numerically are displayed On sample counter IT the program reads and displays the samples graphically On sample counter IT the program reads and displays the samples graphically The user can repeat the measure by pressing a key The user can sample an analog input by pressing a button The sample displayed on the screen in Volts multi board feature count the elapsed time in seconds DM6430 Driver for Windows 98 NT4 2000 XP Limited Warranty RTD Embedded Technologies Inc warrants the hardware and software products it manufactures and produces to be free from defects in materials and workmanship for one year following the date of shipment from RTD Embedded Technologies INC This warranty is limited to the original purchaser of product and is not transferable During the one year warranty period RTD Embedded Technologies will repair or replace at its option any defective products or parts at no additional charge provided that the product is returned shipping prepaid to RTD Embedded Techn
41. try keys Windows NT 4 0 HKEY_LOCAL_MACHINE System i CurrentControlSet Services WinRT WinRTdev0 one per device Parameters SectionO WinRTdev1 Parameters Section0 Windows 98 Enum key path HKEY_LOCAL_MACHINE Enum Windows 98 Class key path HKEY LOCAL MACHINE i System CurrentControlSet Services Class WinRTDevices DM6430 Driver for Windows 98 NT4 2000 XP Windows 2000 XP device class information HKEY_LOCAL_MACHINE System i CurrentControlSet f Control Class D695ED6A 630D 4D83 D8B F1F0AC107AD0 0001 DM6430 Driver for Windows 98 NT4 2000 XP 10 The Driver Api Functions The resources on the DM6430 board can be accessed from Windows through the driver API Application Programming Interface functions The executable code of these functions is located in the Drvr6430 dll file To write applications using the API functions you must include the Reg6430 H header file and link the program with the Drvr6430 lib import library file In the example programs you can find different examples how to use the driver 11 DM6430 Driver for Windows 98 NT4 2000 XP Using the Driver without the Windows GUI This driver is based on the Win32 system and can run only under Windows However the user who is not familiar with the Windows Graphical User Interface can use the driver API functions in Win32 console applications
42. which has an MS DOS like text mode interface In console applications is not necessary to use the Windows graphical environment but all the driver s API functions are accessible The Microsoft Visual C compiler supports writing console applications DM6430 Driver for Windows 98 NT4 2000 XP 12 DM6430 Features Measurement Scenarios Through selecting different options for A D Conversion Trigger SetConversionSelect6430 Burst Clock Start Trigger SetBurstTrigger6430 and creating different Channel Gain Tables you have innumerable sampling scenarios The following bullets try to enumerate only the most frequently used measurement setups Q Single Conversion In this mode a single channel is sampled whenever StartConversion6430 is called The Channel Gain Latch see SetChannelGain6430 specifies the channel to sample This is the easiest scenario of all It can be used in a variety of applications such as sample every time a key is pressed on the keyboard sample with each iteration of a loop or watch the system clock and sample every five seconds Multiple Conversions In this mode conversions are continuously performed at the rate of the Pacer Clock or other selected A D Conversion Signal rate The pacer clock can be internal or external The maximum rate supported by the board is 100KHz If you use the internal pacer clock you must program it to run at the desired rate SetPacerClock6430 This mode is ideal for filling
43. xe cede ba cub ats eRe Wick Sone a aa re ce cub des Se 20 INTERRUPT HANDLING rrn a ERR RER GeO ad 20 AUTOINCREMENT DATA HANDLING 0 ccsssesesesesessscscscsescssscscsesseeesesesesesesesesessaeseseseseseaeeeaeaes 21 USER TIMER COUNTER FUNCTIONS s scsssssesesessssscscscsssessssscsesesesscscscscsescscsescsssssssesestetsteeaes 21 CHANNEL GAIN TABLE LATCH MANIPULATION 0 scscssssssssscsssesssssesessssssscssscssssscsessssststsreeaes 21 EXTERNAL TRIGGER CONFIGURATION FUNCTIONS 0 scscssssssssscssssscssssssssscscsssesssssssssesrstsrseees 21 ERROR HANDLING FUNCTIONS rsa n E R orden acd uatecacer dus vaecwadgeaserdesvectuderae 21 ALPHABETICAL DRIVER API FUNCTIONS REFERENCE ccccsssssssscccsssscssecccceseses 22 EXAMPLE PROGRAMS REFERENCE cssssscsssssscssssccessscccsssssccccssccccesscccessceccessssseceses 56 WIN32 CONSOLE APPLICATIONS cscsccceeeeeseseseseseseseseseseceseseseseseseseseeeseseseseseceseseseseseseeeseseeeeees 56 WIN32 WINDOWS APPLICATIONS ccccccseeeeseseseseseseseseseseseseceseseseseseeeseseseseseseseseseseseseseeeseeesesens 57 LIMITED WARRANTY ccsssssssssssesssssrenssssssenssscsssnsesceseesseesensesessenseseseeneesessenessesessessesesnens 58 Introduction The DM6430 data acquisition board Windows 98 NT4 0 2000 XP driver was designed for programmers who write Windows based application programs for the RTD s DM6430 board The driver provides an Application Programmi
Download Pdf Manuals
Related Search