| PCI-9112 | cPCI-9112 | cPCI-9112R | LPCI-9112 |
| Single-ended (default setting) | JP5 | <img src="images/ce642c7ef6b5f5a30e7f70bb05efd061418c0bca45865bc9cb06a592960f97b6.jpg"/> | JELE | JP4 | <img src="images/420ed6031743b1bd00b0b158da9c055f03c36b5111a6eece0604231873471bb0.jpg"/> | W131E | JP5 | <img src="images/f595752fbe9e46c0c709d30cb1ed291012956579c0e84c1e9cd65d51a64de153.jpg"/> | DIEF | [SINGLE] | <img src="images/4459011f460e4455b6d339e1fa4bdd4c96edc16362e16f53b27b022e02663e64.jpg"/> | DIEF |
| <img src="images/cba5e6aced49560c95d6aaf798bf39e2df27b7948092b22e73642d5ae5e67388.jpg"/> | <img src="images/c10c4add685f15ec9cf48a4521e57ed2dc517bf98f272975fe273f5d4c796c94.jpg"/> | <img src="images/ec6b0ab2824e63fcb2348267a50ea5105610ed3acdfd6e11f8a05c59efcdb49b.jpg"/> |
| DIFF | DIFF | DIFF | DIFF | DIFF | SINGLE | DIFF | SINGLE |
| Differential Input | SINGLE | SINGLE | SINGLE | SINGLE | SINGLE | DIFF | [SINGLE] | <img src="images/507e6eb820ede9205f14eb27f67e7e37d77c08fe37c3aa5f101c7680317a1306.jpg"/> | DIFF |
| JP5 | <img src="images/c5c73890e43372ef9686963dc1c0b714ee7f3a85856bda4cbabeff496495026c.jpg"/> | JP1<img src="images/5a5f703877a030b80491fb3fbfad2cdda665a931d6538ffdc8e7f5194ec831ae.jpg"/> | JP4 | <img src="images/d6117abde7875ada4ff68de3dc3e44d82d609111ff936021ad747c41cfdac276.jpg"/> | JP1<img src="images/342fe26ba87a1d4e832515a7c460541e8fdccf1e216a0085fcd7a1d6dfec83ef.jpg"/> | JP5 | <img src="images/f4f45b8fa289eda8765d8851665c3ac3fbf23e4dab0e5e0bc00fd62341db67ee.jpg"/> | <img src="images/99c10abfe36442560584be0639266959356f5ced02fbd53af11b7f9c2fca73bc.jpg"/> | <img src="images/507e6eb820ede9205f14eb27f67e7e37d77c08fe37c3aa5f101c7680317a1306.jpg"/> | <img src="images/98cc123ff1f4ea00ae94b5a0783aee983d3d1d66641b1a9d8bd7142e1395a528.jpg"/> |
| DIFF | DIFF | DIFF | DIFF | DIFF | SINGLE | DIFF | SINGLE |
Figure 2-5: Analog Input Mode Setting
# 2.6 Clock Source Setting
The programmable interval timer 8254 is used in the PCI-9112. It provides 3 independent 16-bit programmable down counters. The input to counter 2 is connected to a precision 2MHz oscillator for the internal pacer. The input of counter 1 is cascaded from the output of counter 2. Channel 0 is free for user applications. There are two selections for the clock source of channel 0: the internal
2MHz clock or an external clock signal from connector CN3 pin 35. The setting for clock source is shown below:
Figure 2-6: Timer's Clock Source Setting
# 2.7 D/A Reference Voltage Setting
The D/A converter's reference voltage source can be supplied both internally and external. The external reference voltage comes from connector CN3 pin 31 (ExtRef1) and pin12 (ExtRef2), see section 3.1. The reference source of the D/A channel 1 and channel 2 are selected by JP4, respectively. The possible settings are shown below:
| D/A CH1 is ExternalD/A CH2 is External | JP4 (PCI-9112, cPCI-9112R)JP5 (cPCI-9112, LPCI-9112) |
| INTREFExtRef1 | <img src="images/2175069b30fe24439192032f932d91b75e26731f25dfecb51e3567879af8a72c.jpg"/> | INTREFExtRef2 |
| D/A CH1 is ExternalD/A CH2 is Internal | INTREFExtRef1 | <img src="images/0057f0ead9110c7c4994c59b1b0d7d52fc5379ac6892f0e335f5444ff7a40029.jpg"/> | INTREFExtRef2 |
| D/A CH1 is InternalD/A CH2 is External | INTREFExtRef1 | <img src="images/c6b63baec15dc5a8fb182430cc1ad4ced697d169cfdc5a8583cfd729b1322f2d.jpg"/> | INTREFExtRef2 |
| D/A CH1 is InternalD/A CH2 is Internal (default setting) | INTREFExtRef1 | <img src="images/262c75bfd3267013d89d3103b5b505ee55f2bf7755bd376a4aae3ac716c62988.jpg"/> | INTREFExtRef2 |
Figure 2-7: Analog Output Voltage Setting
The internal D/A reference voltage can be set to -5V or -10V by JP3. The possible configurations are specified as Figure 2.7. Note that the internal reference voltage is used only when the JP4 is set to internal reference only.
| A/D Mode | @ Description |
| AD_MODE_0 | Software Trigger, Software Polling |
| AD_MODE_1 | Timer Trigger, Interrupt Transfer |
| AD_MODE_2 | Timer Trigger, DMA (bus mastering) Transfer |
| AD_MODE_3 | External Trigger, Software Polling |
| AD_MODE_4 | External Trigger, Interrupt Transfer |
| AD_MODE_5 | External Trigger, DMA (bus mastering) Transfer |
# @ Syntax
# Visual C++ (Windows-95)
```txt
int W_9112_AD_Set_Mode (int card_number, int ad mode)
```
# Visual Basic (Windows-95)
```txt
W_9112_AD_Set_Mode (ByVal card_number As Long, ByVal ad_mode As Long) As Long
```
# C/C++ ( DOS)
```txt
int _9112_AD_Set_Mode (int card_number, int ad_mode)
```
# @ Argument
card\_number:the card number of PCI-9112
ad\_mode: AD trigger and data transfer mode (Please refer to above table.)
# @ Return Code
```txt
ERR_NoError
ERR_BoardNoInit
ERR_InvalidMode
```
# @ Example
```c
#include "9112.h"
main()
{
Int baseAddr, irqNo;
_9112_Initial(CARD_1, &baseAddr, &irqNo);
/* Assume NoError when Initialize PCI-9112 */
_9112_AD_Set_Range(CARD_1, AD_B_5_V);
printf("The A/D analog input range is +/- 5V\n");
_9112_AD_Set_Mode(CARD_1, AD_MODE_4);
```
```c
printf("Now, The Internal Timer Pacer trigger is set \n");
/* All A/D conversion will be trigger by internal timer pacer, and the converted data should be transferred in the interrupt service routine. (ISR). */
}
```
# 5.11 \_9112\_AD\_Set\_Autoscan
# @ Description
This function is used to enable or disable an automatic hardware channel scan. If the PCI-9112 is set as enable mode, then the A/D channel can be converted automatically, that is, the hardware will automatically decrement until it reaches channel 0. Then, loop back to the channel it started from and continue decrementing again. For example, the channel is set as 4, the A/D conversion sequence will be 4, 3, 2, 1, 0, 4, 3, 2, 1, 0, 4, 3, 2, 1, 0, 4, 3,
If the auto-scan is set to disable, the scan will scan a single channel only, such as channel 4.
# @ Syntax
Visual C++ (Windows-95)
```txt
int W_9112_AD_Set_Autoscan (int card_number, int autoscan)
Visual Basic (Windows-95)
int W_9112_AD_Set_Autoscan (ByVal card_number As Long, ByVal autoscan As Long) As Long
C/C++ (DOS)
int _9112_AD_Set_Autoscan (int card_number, int autoscan)
```
# @ Argument
```txt
card_number:the card number of PCI-9112
```
```batch
autoscan: TRUE or FALSE
```
# @ Return Code
ERR\_NoError, ERR\_BoardNoInit
# @ Example
See the demo program 'AD\_DEMO4.C'
# 5.12 \_9112\_AD\_Soft\_Trig
# @ Description
This function is used to trigger the A/D conversion by software. When the function is called, a trigger pulse will be generated and A/D conversion will start, and the converted data will be stored in the base address Base + 0x10 after the conversion.
# @ Syntax
Visual C++ (Windows-95)
int W 9112 AD AD Soft Trig (int card number)
Visual Basic (Windows-95)
W\_9112\_ AD\_Soft\_Trig (ByVal card\_number As Long)
As Long
C/C++ ( DOS)
int \_9112\_AD\_Soft\_Trig (int card\_number)
# @ Argument:
card\_number:the card number of PCI-9112
# @ Return Code:
ERR\_NoError, ERR\_BoardNoInit
# 5.13 \_9112\_AD\_Aquire
# @ Description
This function is used to poll the AD conversion data. It will trigger the AD conversion, and read the 12-bit A/D data until the data is ready ('data ready' bit becomes low).
# @ Syntax
Visual C++ (Windows-95)
```c
int W_9112_AD_Aquire (int card_number, int *ad_data)
```
Visual Basic (Windows-95)
```txt
W_9112_AD_Aquire (ByVal card_number As Long, ad_data As Long) As Integer
```
C/C++ ( DOS)
```txt
int _9112_AD_Aquire (int card_number, int *ad_data)
```
# @ Argument
card\_number:the card number of PCI-9112
ad\_data: 12-bit A/D converted value, the value should be within 0 to 4095.
▶ Bit 0 \~ Bit 3: is the converted channel number
▶ Bit 4 \~ Bit 15: is the converted A/D data.
# @ Return Code:
```txt
ERR_NoError, ERR_BoardNoInit
ERR_AD_AquireTimeOut
```
# @ Example
```c
#include "9112.h"
main()
{
int ad_data;
int errCode;
Int baseAddr, irqNo;
_9112_Initial(CARD_1, &baseAddr, &irqNo);
/* Assume NoError when Initialize PCI-9112 */
/* Set to software trigger at first*/
_9112_AD_Set_Mode(CARD_1, AD_MODE_0);
/* then trigger the AD */
_9112_AD_Soft_Trig(CARD_1);
/* wait for AD data ready then read it */
errCode = _9112_AD_Aquire(CARD_1, &ad_data);
```
```txt
if( errCode == ERR_NoError )
printf("The AD value is %d.\n", ad_data );
else
printf("AD conversion error happen\n");
} Also See Demo Program 'AD_DEMO1.C'
```
# 5.14 \_9112\_AD\_DMA\_Start
# @ Description
This function will perform A/D conversion N times with DMA data transfer. It takes place in the background which will not stop until the Nth conversion has completed or your program executes a \_9112\_AD\_DMA\_Stop() function to stop the process.
After executing this function, it is necessary to check the status of the operation by using the function \_9112\_AD\_DMA\_Status(). This function is performed on single A/D channel when the A/D channel auto-scan is set as FALSE. If the A/D channel auto-scan is TRUE, the conversion will be multiple channels by sequence.
The PCI-9112 Bus mastering DMA is different from tradition PC style DMA. It is described below:
Bus Mastering DMA mode for PCI-9112:
PCI bus mastering offers the highest possible speed available on the PCI-9112. When the function \_9112\_AD\_Set\_Mode is set as AD\_MODE\_2 (Timer Trigger & DMA transfer) or AD\_MODE\_5 (External Trigger & DMA transfer), it will enable PCI bus mastering operation. This is conceptually similar to DMA (Direct Memory Access) transfers in a PC but is really PCI bus mastering. It does not use an 8237-style DMA controller in the host computer and therefore isn't limited to 64K maximum groups. PCI-9112 bus mastering works as follows:
1. To set up the bus mastering, first do all normal PCI-9112 initialization necessary to control the board in status mode. This includes testing for the presence of the PCI BIOS, determining the base addresses, slot number, vendor and device ID's, I/O or memory, space allocation, etc. Please make sure your PCI-9112 is plugged into a bus-mastering slot, otherwise this function will not work.
2. Load the PCI controller with the count and 32-bit physical address of the start of previously allocated destination memory, which will accept A/D data. This count is the number of bytes (not longwords!) transferred during the bus mastering operation and can be a large number up to 64 million (2^26) bytes. Although the PCI-9112 transfers are always longwords, this is 16 million longwords (2^24) or 32 million A/D samples but use the byte-count.
3. After the A/D conversion has started, the A/D converted data is stored in the FIFO of the PCI controller. Each bus mastering data transfer continually tests if any data in the FIFO and then blocks transfer, the system will continuously loop until the conditions are satisfied again but will not exit the block transfer cycle if the block count is not complete. If there is momentarily no A/D data, the PCI-9112 will relinquish the bus temporarily but returns immediately when more A/D samples appear. This operation continues until the whole block is done.
4. This operation proceeds transparently until the PCI controller transfer byte count is complete. All normal PCI bus operation applies here such as a receiver, which cannot accept the transfers, higher priority devices requesting the PCI bus, etc. Remember that only one PCI initiator can have bus mastership at any one time. However, review the PCI priority and "fairness" rules. Also study the effects of the Latency Timer. And be aware that the PCI priority strategy (round robin rotated, fixed priority, custom, etc.) is unique to your host PC and is explicitly not defined by the PCI standard. You must determine this priority scheme for your own PC (or replace it).
5. The interrupt request from the PCI controller can be optionally set up to indicate that this longword count is complete although this can also be determined by polling the PCI controller.
# @ Syntax
# Visual C++ (Windows-95)
```txt
int W_9112_AD_DMA_Start (int card_number, int auto_scan, int ad_ch_no, int ad_range, int count, HANDLE memID, int c1, int c2)
```
# Visual Basic (Windows-95)
```txt
W_9112_AD_DMA_Start (ByVal card_number As Long, ByVal auto_scan As Long, ByVal ad_ch_no As Long, ByVal ad_range As Long, ByVal count As Long, ByVal memID As Long, ByVal c1 As Long, ByVal c2 As Long) As Long
```
# C/C++ ( DOS)
```c
int _9112_AD_DMA_Start (int card_number, int auto_scan, int ad_ch_no, int ad_range, int count, unsigned long *ad_buffer, int c1, int c2)
```
# @ Argument
card\_number:the card number of PCI-9112
auto\_scan: TRUE or FALSE
Example1:
auto\_scan is FALSE, ad\_ch\_no is 3. Using DMA mode to read A/D data only channel 3.
Example2: auto\_scan is TRUE, ad\_ch\_no is 3. Using DMA mode to read A/D data with multi-channel, channel 3, 2, 1 and 0. Reading sequence is channel 3, 2, 1, 0, 3, 2, 1, 0, 3, 2, 1, 0....
ad\_ch\_no: A/D channel number
ad\_range:A/D analog input range, the possible values are shown in section 4.3.8.
count: the number of A/D conversion
ad\_buffer(DOS): the start address of the memory buffer to store the AD data, the buffer size must large than the number of AD conversion.
In DOS environment, please make sure this memory is double-word alignment. Every 16-bit unsigned integer data in ad\_buffer:
D11 D10 D9 ....D1 D0 C3 C2 C1 C0
D11, D10, ..., D1, D0: A/D converted data
C3, C2, C1, C0: converted channel no.
memID(Windows-95): the memory ID of the allocated system DMA memory. In Windows 95 environment, before calling W\_9112\_AD\_DMA\_Start, W\_9112\_Alloc\_DMA\_Mem must be called to allocate a contiguous DMA memory. W\_9112\_Alloc\_DMA\_Mem will return a memory ID for identify the allocated DMA memory, as well as the linear address of the DMA memory for user to access the data. The format of the A/D data is the same as DOS buffer (ad\_buffer argument).
c1: the 16-bit timer frequency divider of timer channel #1
c2: the 16-bit timer frequency divider of timer channel #2
# @ Return Code
```erlang
ERR_NoError, ERR_BoardNoInit,
ERR_InvalidADChannel, ERR_AD_InvalidRange,
ERR_InvalidTimerValue
```
# @ Example
See Demo Program 'AD\_DEMO3.C', 'AD\_DEMO6.C'
# 5.15 \_9112\_AD\_DMA\_Status
# @ Description
Since the \_9112\_AD\_DMA\_Start function executes in the background, you can issue the function \_9112\_AD\_DMA\_Status to check its operation status.
# @ Syntax
Visual C++ (Windows-95)
```c
int W_9112_AD_DMA_Status (int card_number, int *status, int *count)
```
Visual Basic (Windows-95)
```txt
W_9112_AD_Status (ByVal card_number As Long, status As Long, count As Long) As Long
```
C/C++ ( DOS)
```c
int _9112_AD_DMA_Status(int card_number, int *status, int *count)
```
# @ Argument
card\_number:the card number of PCI-9112
status: status of the DMA data transfer
▶ 0: AD\_DMA\_STOP: DMA is completed
▶ 1: AD\_DMA\_RUN: DMA is not completed
count: the number of A/D data which has been transferred.
# @ Return Code
```txt
ERR_NoError, ERR_BoardNoInit
```
# @ Example
See Demo Program 'AD\_DEMO3.C', 'AD\_DEMO6.C'
# 5.16 \_9112\_AD\_DMA\_Stop
# @ Description
This function is used to stop the DMA data transferring. After executing this function, the internal A/D trigger is disable and the A/D timer (timer #1 and #2) is stopped. The function returns the amount of data, which have been transferred, no matter if the A/D DMA data transfer is stopped by this function or by the DMA terminal counts ISR.
# @ Syntax
Visual C++ (Windows-95)
```c
int W_9112_AD_DMA_Stop (int card_number, int * count)
```
Visual Basic (Windows-95)
```txt
W_9112_AD_DMA_Stop (ByVal card_number As Long, count As Long) As Long
```
C/C++ ( DOS)
```c
int _9112_AD_DMA_Stop (int card_number, int *count)
```
# @ Argument
card number: the card number of PCI-9112
count: the number of A/D converted data which has been transferred.
# @ Return Code
```txt
ERR_NoError
ERR_BoardNoInit
```
# @ Example
See Demo Program 'AD\_DEMO3.C', 'AD\_DEMO6.C'
# 5.17 \_9112\_ContDmaStart
# @ Description
This function will perform A/D conversion continuously with DMA data transfer. It takes place in the background which will not stop until your program execute \_9112\_ContDmaStop() function to stop the process.
After executing this function, it is necessary to check the status of the double buffer by using the function \_9112\_CheckHalfReady() and using \_9112\_DblBufferTransfer() to get the A/D converted data.
There is a group of functions for continuous A/D conversion using DMA. They are:
▶ \_9112\_ContDmaStart();
▶ \_9112\_CheckHalfReady();
▶ \_9112\_DblBufferTransfer();
▶ \_9112\_GetOverrunStatus();
▶ \_9112\_ContDmaStop();
# @ Syntax
# Visual C++ (Windows-95)
```txt
int W_9112_ContDmaStart (int card_number, int auto_scan, int ad_ch_no, int ad_range, int count, HANDLE memID, int c1, int c2)
```
# Visual Basic (Windows-95)
```txt
W_9112_ContDmaStart (ByVal card_number As Long, ByVal auto_scan As Long, ByVal ad_ch_no As Long, ByVal ad_range As Long, ByVal count As Long, ByVal memID As Long, ByVal c1 As Long ByVal c2 As Long) As Long
```
# C/C++ ( DOS)
```c
int _9112_ContDmaStart (int card_number, int auto_scan, int ad_ch_no, int ad_range, int count, int *db_buffer, int c1, int c2)
```
# @ Argument
card\_number:the card number of PCI-9112
auto\_scan: TRUE or FALSE
Example1: auto\_scan is FALSE, ad\_ch\_no is 3. Using DMA mode to read A/D data only channel 3.
Example 2: auto\_scan is TRUE, ad\_ch\_no is 3. Using DMA mode to read A/D data with multi-channel, channel 3, 2, 1 and 0. Reading sequence is channel 3, 2, 1, 0, 3, 2, 1, 0, 3, 2, 1, 0....
ad\_ch\_no: A/D channel number
ad\_range:A/D analog input range, please refer to the section 4.3.8 for the possible values.
count: the number of A/D conversion
db\_buffer(DOS): the start address of the circular buffer to store the AD data, the buffer size must large than the number of AD conversion.
In DOS environment, please make sure this memory is double-word alignment. Every 16-bit unsigned integer data in ad\_buffer:
D11 D10 D9 ....D1 D0 C3 C2 C1 C0
D11, D10, ..., D1, D0: A/D converted data
C3, C2, C1, C0: converted channel no.
memID(Windows-95): the memory ID of the allocated system DMA memory to act as the circular buffer. In Windows 95 environment, before calling W\_9112\_ContDmaStart, W\_9112\_Alloc\_DMA\_Mem must be called to allocate a contiguous DMA memory. W\_9112\_Alloc\_DMA\_Mem will return a memory ID for identify the allocated DMA memory, as well as the linear address of the DMA memory for user to access the data. The format of the A/D data is the same as DOS buffer (ad\_buffer argument).
c1: the 16-bit timer frequency divider of timer channel #1
c2: the 16-bit timer frequency divider of timer channel #2
# @ Return Code
```erlang
ERR_NoError, ERR_BoardNoInit,
ERR_InvalidADChannel, ERR_AD_InvalidRange,
ERR_InvalidTimerValue
```
# @ Example
See Demo Program 'AD\_DEMO5.C'
# 5.18 \_9112\_CheckHalfReady
# @ Description
When using \_9112\_ContDmaStart() to convert A/D data, you must use \_9112\_CheckHalfReady() to check the data ready or not status in the circular buffer. The size of the data is half of the circular buffer (count/2) and can be retrieved using \_9112\_DblBufferTransfer().
# @ Syntax
# Visual C++ (Windows-95)
```txt
int W_9112_CheckHalfReady (int card_number, int * halfReady)
```
# Visual Basic (Windows-95)
int W\_9112\_CheckHalfReady (ByVal card\_number As Long, halfReady As Long) As Long
C/C++ ( DOS)
int \_9112\_CheckHalfReady(int card\_number, int \*halfReady)
# @ Argument
card\_number:the card number of PCI-9112
halfReady: TRUE or FALSE.
# @ Return Code
ERR\_NoError, ERR\_BoardNoInit
# @ Example
See Demo Program 'AD\_DEMO5.C'
# 5.19 \_9112\_DblBufferTransfer
# @ Description
Use this function to move converted A/D data to user buffers.
# @ Syntax
Visual C++ (Windows-95)
int W\_9112\_DblBufferTransfer (int card\_number, unsigned long far \* userBuffer)
Visual Basic (Windows-95)
W\_9112\_DblBufferTransfer (ByVal card\_number As Long, userBuffer As Long) As Long
C/C++ ( DOS)
int \_9112\_DblBufferTransfer(int card\_number, unsigned long \*userBuffer)
# @ Argument:
card\_number:the card number of PCI-9112 userBuffer: user buffer for A/D converted data, size of user buffer is half of doubleBuf (count /2).
# @ Return Code:
ERR\_NoError, ERR\_BoardNoInit
# @ Example:
See Demo Program 'AD\_DEMO5.C'
# 5.20 \_9112\_GetOverrunStatus
# @ Description
When using \_9112\_ContDmaStart() to convert A/D data and \_9112\_DblBufferTransfer is not used to move converted data the double buffer overrun will occur, you can use this function to check overrun counts.
# @ Syntax
Visual C++ (Windows-95)
```c
int W_9112_GetOverrunStatus (int card_number, int * overrunCount)
```
Visual Basic (Windows-95)
```txt
W_9112_GetOverrunStatus(ByVal card_number As Long, overrunCount As Long) As Long
```
C/C++ ( DOS)
```txt
int _9112_GetOverrunStatus (int card_number, int *overrunCount)
```
# @ Argument
card\_number:the card number of PCI-9112
overrunCount: number of overrun counts.
# @ Return Code
ERR\_NoError, ERR\_BoardNoInit
# @ Example
See Demo Program 'AD\_DEMO5.C'
# 5.21 \_9112\_ContDmaStop
# @ Description
This function is used to stop continuous DMA data transfers.
# @ Syntax
Visual C++ (Windows-95)
int W\_9112\_ContDmaStop (int card\_number)
Visual Basic (Windows-95)
W\_9112\_ContDmaStop (ByVal card\_number As Long) As Long
C/C++ ( DOS)
int \_9112\_ContDmaStop (int card\_number)
# @ Argument:
card\_number:the card number of PCI-9112
# @ Return Code:
ERR\_NoError, ERR\_BoardNoInit
# @ Example:
See Demo Program 'AD\_DEMO5.C'
# 5.22 \_9112\_AD\_INT\_Start
# @ Description
This function will perform A/D conversion N times with interrupt data transfer. It takes place in the background and will not stop until the Nth conversion has been completed or your program executes the \_9112\_AD\_INT\_Stop() function to stop the process. After executing this function, it is necessary to check the status of the operation by using the function 9112\_AD\_INT\_Status(). The function is performed on single A/D channel with a fixed analog input range.
# @ Syntax
# Visual C++(Windows-95)
```c
int W_9112_AD_INT_Start(int card_number, int auto_scan, int ad_ch_no, int ad_range, int count, unsigned long *ad_buffer, int c1, int c2)
```
# Visual Basic (Windows-95)
```txt
W_9112_AD_INT_Start (ByVal card_number As Long, ByVal auto_scan As Long, ByVal ad_ch_no As Long, ByVal ad_range As Long, ByVal count As Long, ad_buffer As Integer, ByVal c1 As Long, ByVal c2 As Long) As Long
```
# C/C++ (DOS)
```c
int _9112_INT_Start (int card_number, int auto_scan, int ad_ch_no, int ad_range, int count, unsigned long *ad_buffer, int c1, int c2)
```
# @ Argument
card\_number:the card number of PCI-9112
auto\_scan: TRUE or FALSE
Example1: auto\_scan is FALSE, ad\_ch\_no is 3. Using DMA mode to read A/D data only channel 3.
Example2: auto\_scan is TRUE, ad\_ch\_no is 3. Using INT mode to read A/D data with multi-channel, channel 3, 2, 1 and 0. Reading sequence is channel 3, 2, 1, 0, 3, 2, 1, 0, 3, 2, 1, 0....
ad\_ch\_no:A/D channel number
ad\_range:A/D analog input range, please refer to the section 4.3.8 for the possible values.
count: the number of A/D conversion
ad\_buffer: the start address of the memory buffer to store the AD data, the buffer size must large than the number of AD conversion.
Under DOS environment, please make sure this memory is double-word alignment. Every 16-bit unsigned integer data in ad\_buffer:
D11 D10 D9 ....D1 D0 C3 C2 C1 C0
D11, D10, ..., D1, D0: A/D converted data
C3, C2, C1, C0: converted channel no.
c1: the 16-bit timer frequency divider of timer channel #1
c2: the 16-bit timer frequency divider of timer channel #2
# @ Return Code
```txt
ERR_NoError, ERR_BoardNoInit
ERR_InvalidADChannel, ERR_AD_InvalidRange
ERR_InvalidTimerValue
```
# @ Example
See Demo Program 'AD\_DEMO2.C', 'AD\_DEMO5.C'
# 5.23 \_9112\_AD\_INT\_Status
# @ Description
Since the \_9112\_AD\_INT\_Start() function executes in the background, you can issue the function \_9112\_AD\_INT\_Status to check the status of interrupt operation.
# @ Syntax
Visual C++ (Windows-95)
```c
int W_9112_AD_INT_Status (int card_number, int *status, int *count)
```
Visual Basic (Windows-95)
```txt
W_9112_INT_Status (ByVal card_number As Long, status As Long, count As Long) As Long
```
C/C++ ( DOS)
```c
int _9112_AD_INT_Status(int card_number, int *status, int *count)
```
# @ Argument
card\_number:the card number of PCI-9112
status: status of the INT data transfer
▶ 0: AD\_INT\_STOP: DMA is completed
▶ 1: AD\_INT\_RUN: DMA is not completed
count: current conversion count number.
# @ Return Code
ERR\_NoError, ERR\_BoardNoInit
# @ Example
See Demo Program 'AD\_DEMO2.C', 'AD\_DEMO5.C'
# 5.24 \_9112\_AD\_INT\_Stop
# @ Description
This function is used to stop the interrupt data transfer function. After executing this function, the internal AD trigger is disabled and the AD timer is stopped. The function returns the amount of data which has been transferred, no matter whether if the AD interrupt data transfer is stopped by this function or by the \_9112\_AD\_INT\_Stop() itself.
# @ Syntax
Visual C++ (Windows-95)
```c
int W_9112_AD_INT_Stop(int card_number, int *count)
Visual Basic (Windows-95)
W_9112_INT_Stop(ByVal card_number As Long, count As Long) As Long
C/C++ (DOS)
int _9112_AD_INT_Stop(int card_number, int *count)
```
# @ Argument:
card\_number:the card number of PCI-9112
count: the number of A/D data which has been transferred.
# @ Return Code:
```txt
ERR_NoError
ERR_BoardNoInit
```
# @ Example:
See Demo Program 'AD\_DEMO2.C', 'AD\_DEMO5.C'
# 5.25 \_9112\_AD\_Timer
# @ Description
This function is used to setup Timer #1 and #2. Timer #1 and #2 are used as frequency divider for generating constant A/D sampling rate. It is possible to stop the pacer trigger by setting any one of the dividers as 0. Because the AD conversion rate is limited due to the conversion time of the AD converter, the highest sampling rate of the PCI-9112 cannot exceed 100 KHz. The multiplication of the dividers must be larger than 20.
# @ Syntax
Visual C++ (Windows-95)
```txt
int W_9112_AD_Timer (int card_number, unsigned int c1, unsigned int c2)
```
Visual Basic (Windows-95)
```txt
W_9112_Timer (ByVal card_number As Long, c1 As Long, c2 As Long) As Long
```
C/C++ ( DOS)
```c
int _9112_AD_Timer(int card_number, unsigned int c1, unsigned int c2)
```
# @ Argument
card\_number:the card number of PCI-9112
c1: frequency divider of timer #1
c2: frequency divider of timer #2
Note: the A/D sampling rate is equal to:2MHz / (c1 \* c2).
# @ Return Code
```txt
ERR_NoError
ERR_BoardNoInit
ERR_InvalidTimerValue
```
# @ Example
```c
main()
{
int errCode;
Int baseAddr, irqNo;
_9112_Initial(CARD_1, &baseAddr, &irqNo);
/* Assume NoError when Initialize PCI-9112 */
_9112_AD_Timer(CARD_1, 10, 10);
/* set AD sampling rate to 2MHz/(10*10) */
_9112_AD_Timer(CARD_1, 0, 0);
/* stop the pacer trigger */
}
```
# 5.26 \_9112\_TIMER\_Start
# @ Description
Timer #0 on the PCI-9112 is available for programming by the user. This function is used to program Timer #0. This timer can be used as a frequency generator if internal clocks are used. It can also be used as an event counter if an external clock is used. The entire 8253 mode is available. Please refer to section 5.4 "Timer/Counter operation" for more details.
# @ Syntax
# Visual C++ (Windows-95)
```c
int W_9112_TIMER_Start (int card_number, int timer_mode, unsigned int c0)
```
# Visual Basic (Windows-95)
W\_9112\_TIMER\_Start(ByVal card\_number As Long, timer\_mode As Long, c0 As Long) As Long
# C/C++ ( DOS)
int \_9112\_TIMER\_Start(int card\_number, int timer\_mode, unsigned int c0)
# @ Argument
card\_number:the card number of PCI-9112
timer\_mode: the 8253 timer mode, the possible values are:
▶ TIMER\_MODE0, TIMER\_MODE1,
▶ TIMER\_MODE2, TIMER\_MODE3,
▶ TIMER\_MODE4, TIMER\_MODE5.
c0: the counter value of timer
# @ Return Code
ERR\_NoError, ERR\_BoardNoInit
ERR\_InvalidTimerMode, ERR\_InvalidTimerValue
# 5.27 \_9112\_TIMER\_Read
# @ Description
This function is used to read the counter value of Timer #0.
# @ Syntax
Visual C++ (Windows-95)
int W\_9112\_TIMER\_Read (int card\_number, unsigned int far \* counter\_value)
# Visual Basic (Windows-95)
W\_9112\_TIMER\_Read (ByVal card\_number As Long, counter\_value As Long) As Long
# C/C++ (DOS)
int \_9112\_TIMER\_Read (int card\_number, unsigned int \*counter\_value)
# @ Argument:
card\_number:the card number of PCI-9112
counter\_value: the counter value of the Timer #0
# @ Return Code:
ERR\_NoError, ERR\_BoardNoInit
# 5.28 \_9112\_TIMER\_Stop
# @ Description
This function is used to stop the timer operation. The timer is set to the 'One-shot' mode with counter value '0'. That is, the clock output signal will be set to high after executing this function.
# @ Syntax
Visual C++(Windows-95)
int W\_9112\_TIMER\_Stop (int card\_number, unsigned int \* counter value)
Visual Basic (Windows-95)
W\_9112\_TIMER\_Stop (ByVal card\_number As Long, counter\_value As Long) As Long
C/C++ (DOS)
int \_9112\_TIMER\_Stop (int card\_number, unsigned int \*counter\_value)
# @ Argument:
card\_number:the card number of PCI-9112
counter\_value: the current counter value of the Timer #0
# @ Return Code:
ERR\_NoError
ERR\_BoardNoInit
# 5.29 \_9112\_Alloc\_DMA\_Mem
# @ Description
Contacts Windows 95 system to allocate a block of contiguous memory for DMA transfer. This function is only available in Windows 95 version.
# @ Syntax
# Visual C++(Windows-95)
int W\_9112\_Aalloc\_DMA\_Mem (unsigned long buf\_size, HANDLE \*memID, unsigned long \*linearAddr)
# Visual Basic (Windows-95)
W\_9112\_Alloc\_DMA\_Mem (ByVal buf\_size As Long, memID As Long, linearAddr As Long) As Long
# @ Argument:
buf\_size:Bytes to allocate. Please be careful, the unit of this @ Argument is BYTE, not SAMPLE.
memID: If the memory allocation is successful, driver returns the ID of that memory in this @ Argument. Use this memory ID in W\_9112\_AD\_DMA\_Start or W\_9112\_ContDmaStart function call.
linearAddr:The linear address of the allocated DMA memory. You can use this linear address as a pointer in C/C++ to access the DMA data.
# @ Return Code:
ERR\_NoError
ERR\_AllocDMAMemFailed
# 5.30 \_9112\_Free\_DMA\_Mem
# @ Description
De-allocate a system DMA memory under Windows 95 environment. This function is only available in Windows 95 version.
# @ Syntax
Visual C++(Windows-95)
int W 9112 Free DMA Mem (HANDLE memID)
Visual Basic (Windows-95)
W\_9112\_Free\_DMA\_Mem (ByVal memID As Long) As Long
# @ Argument:
memID:The memory ID of the system DMA memory to deallocate.
# @ Return Code:
ERR\_NoError
# 5.31 \_9112\_Get\_Sample
# @ Description
For programming languages without pointer support such as Visual Basic, programmers can use this function to access the index-th data in DMA buffer. This function is only available in Windows 95 version.
# @ Syntax
Visual C++(Windows-95)
int W\_9112\_Get\_Sample (unsigned long linearAddr, unsigned index, unsigned short \*ai\_data)
Visual Basic (Windows-95)
W\_9112\_Get\_Sample (ByVal linearAddr As Long, ByVal idx As Long, ai\_data As Integer) As Long
# @ Argument:
linearAddr:The linear address of the allocated DMA memory.
index:The index of the sample to retrieve. The first sample is with index 0.
ai\_data:Returns the sample retrieved.
# @ Return Code:
ERR\_NoError
# 6 Calibration
In data acquisition processes, how to calibrate your measurement devices to maintain its accuracy is very important. Users can calibrate the analog input and output channels under the users' operating environment to maximize the accuracy. This chapter will guide you though how to calibrate the PCI-9112.
# 6.1 What you need
Before calibrating your PCI-9112 card, you need to prepare the following equipment's and materials for the calibration process:
▶ Calibration program: Once the program is executed, it will guide you through the calibration process. This program is included in the delivered package.
▶ A 5 1/2 digit multimeter (6 1/2 is recommended)
An adjustable voltage calibrator or a very stable and noise free DC voltage generator. The calibrator should be able to provide voltage accuracy of up to 1/2 LSB. In bipolar 5V input range mode (GAIN = 1), the voltage of 1/2 LSB is 1.22mV (i.e. (10V / 4096) / 2). When in unipolar 1.25V input range (GAIN = 8), the voltage of 1/2 LSB is 0.153mV (i.e. (1.25V / 4096) / 2).
# 6.2 VR Assignment
There are five variable resistors (VR) on the PCI-9112 board for making adjustments on the A/D and D/A channels. The function of each VR is specified in Table 6-1.
| AD_DEMO1.C: | A/D conversion using software trigger and program data transfer. |
| AD_DEMO2.C | A/D conversion using interrupts and program data transfer. |
| AD_DEMO3.C: | A/D conversion using DMA data transfer. |
| AD_DEMO4.C: | A/D conversion using software trigger and program data transfer. (Autoscan enable, multi-channel) |
| AD_DEMO5.C | A/D conversion using interrupt and program data transfer. (Autoscan enable, multi-channel) |
| AD_DEMO6.C: | A/D conversion using DMA data transfer. (Autoscan enable, multi-channel) |
| AD_DEMO5.C: | Continuous A/D conversion using DMA transfer |
| DA_DEMO.C: | D/A conversion |
| DIO_DEMO.C: | Read/Write data from digital input/output channels |
Table 8-1: DOS Examples
# Windows 95 DLL:
There are several demonstration programs for Windows 95 DLL. They can provide assistance when programming your application using C/C++ or Visual Basic Language to link DLL libraries.
The description of these programs are specified as follows:
| Samples\sdk\9112\ 9112util.exe | A/D conversion using software trigger and program data transfer. Visual C/C++ program. |
| Samples\sdk\9112int\ 9112int.exe | A/D conversion using interrupt data transfer. Visual C/C++ program. |
| Samples\sdk\9112dma\ 9112dma.exe | A/D conversion using DMA data transfer. Visual C/C++ program. |
| Samples\sdk\9112cdma\ 9112cdma.exe | A/D conversion using DMA data transfer with double-buffering mechanism. Visual C/C++ program. |
| Samples\vb\9112\vb9112.exe | A/D conversion using software trigger and program data transfer, D/A conversion, and digital I/O. Visual Basic program. |
| Samples\vb\9112int\vb9112i.exe | A/D conversion using interrupt data transfer. Visual Basic program. |
| Samples\vb\9112dma\vb9112d.exe | A/D conversion using DMA data transfer. Visual Basic program. |
Table 8-2: Windows 95 DLLs
# Warranty Policy
Thank you for choosing ADLINK. To understand your rights and enjoy all the after-sales services we offer, please read the following carefully.
1. Before using ADLINK's products please read the user manual and follow the instructions exactly. When sending in damaged products for repair, please attach an RMA application form which can be downloaded from: http://rma.adlinktech.com/policy/.
2. All ADLINK products come with a two-year guarantee:
The warranty period starts from the product's shipment date from ADLINK's factory.
▶ Peripherals and third-party products not manufactured by ADLINK will be covered by the original manufacturers' warranty.
For products containing storage devices (hard drives, flash cards, etc.), please back up your data before sending them for repair. ADLINK is not responsible for loss of data.
▶ Please ensure the use of properly licensed software with our systems. ADLINK does not condone the use of pirated software and will not service systems using such software. ADLINK will not be held legally responsible for products shipped with unlicensed software installed by the user.
For general repairs, please do not include peripheral accessories. If peripherals need to be included, be certain to specify which items you sent on the RMA Request & Confirmation Form. ADLINK is not responsible for items not listed on the RMA Request & Confirmation Form.
3. Our repair service is not covered by ADLINK's two-year guarantee in the following situations:
▶ Damage caused by not following instructions in the user's manual.
▶ Damage caused by carelessness on the user's part during product transportation.
▶ Damage caused by fire, earthquakes, floods, lightening, pollution, other acts of God, and/or incorrect usage of voltage transformers.
▶ Damage caused by unsuitable storage environments (i.e. high temperatures, high humidity, or volatile chemicals).
▶ Damage caused by leakage of battery fluid during or after change of batteries by customer/user.
▶ Damage from improper repair by unauthorized technicians.
▶ Products with altered and/or damaged serial numbers are not entitled to our service.
▶ Other categories not protected under our warranty.
4. Customers are responsible for shipping costs to transport damaged products to our company or sales office.
5. To ensure the speed and quality of product repair, please download an RMA application form from our company website: http://rma.adlinktech.com/policy. Damaged products with attached RMA forms receive priority.
If you have any further questions, please email our FAE staff: service@adlinktech.com.
[🔗 Link to the original document](.lpci-9112-manual-4/lpci-9112-manual-4.pdf)