Measurement Computing TempBook rev.3.0 - Manual (Page 68)

9-8 tbkCommand Reference (Standard API) TempBook User’s Manual
tbkInit
DLL Function int tbkInit(uchar lptPort, uchar lptIntr);
C tbkInit(unsigned int lptPort, unsigned char lptIntr);
QuickBASIC BtbkInit% (ByVal lptPort%, ByVal lptIntr%)
Visual Basic VBtbkInit% (lptPort%, lptIntr%)
Turbo Pascal tbkInit( lptPort:byte; lptIntr:byte ):integer;
Parameters
unchar lptIntr
The LPT interrupt level (7 for LPT1)
uchar lptPort The LPT port number (See table below for definitions.)
Description
Value
LPT1 0x00
LPT2 0x01
LPT3 0x02
LPT4 0x03
Returns TerrNotOnLine - No communication with TempBook
TerrBadChannel - Invalid LPT channel
TerrNoTempBook - No TempBook/66detected
TerrNoError - No error
See Also tbkSelectPort, tbkClose
Program References None
tbkInit is used to perform multiple functions: initialize subroutine library variables, establish
communications with a TempBook unit, reset the TempBook hardware to power-on conditions, and
select the TempBook as the current TempBook. tbkInit can be called to reinitialize the
TempBook only after the tbkClose command is called to terminate communications with the
TempBook.
tbkInit will perform the following tasks:
•
Stop any current acquisition
•
Set the scan group to channel 1 with a gain of 1
•
Set the pacer clock to 100 kHz
•
Reset the counter/timers
Note: tbkInit must be called before any other TempBook function
tbkRd
DLL Function int tbkRd(uint chan, uint *sample, uchar gain);
C tbkRd(unsigned chan, unsigned *sample, unsigned char gain);
QuickBASIC BtbkRd% (ByVal chan%, sample%, ByVal gain%)
Visual Basic VBtbkRd% (chan%, sample%, gain%)
Turbo Pascal tbkRd( chan:word; sample:WordP; gain:byte ):integer;
Parameters
uint chan A single channel number (see table at end of chapter for valid values).
unit *sample A pointer to a value where an A/D sample is stored
unchar gain The channel gain (see table at end of chapter for valid values)
Returns TerrFIFOFull - Buffer Overrun
TerrInvGain - Invalid gain
TerrInvChan - Invalid channel
TerrNoError - No Error
See Also tbkRdN, tbkSetMux, tbkSetTrig, tbkSoftTrig, tbkRdFore
Program References None
tbkAdcRd is used to take a single reading from the given A/D channel. This function will use a
software trigger to immediately trigger and acquire one sample from the specified A/D channel.