CompuScope SDK Manua.. - Egmont Instruments

gage_select_board
Syntax
C:
int16 GAGEAPI gage_select_board (int16 board);
Visual BASIC:
Function gage_select_board (ByVal board As Integer) As Integer
Remarks
The gage_select_board routine is for use with a Multi-Card CompuScope system. Once called with an
argument that specifies the board number, gage_select_board directs subsequent subroutine calls to this
specified board.
In a Master/Slave CompuScope system, the Master controls many functions, such as the sampling rate and
trigger controls. Furthermore, only the Master CompuScope needs to be sent the gage_start_capture
command and only the Master needs to be polled with gage_triggered and gage_busy. Commands that
control these functionalities that are managed by the Master CompuScope are automatically only sent to
the Master CompuScope. However, the captured data must be downloaded separately from each
CompuScope in the Master/Slave system. Also, channel parameters, such as input range, coupling and
terminating impedance must be separately sent to each CompuScope, after calling the gage_select_board
routine.
In a Multiple/Independent CompuScope system, all functions (i.e. the initialization, setup, capture and data
transfer) must be performed separately for each CompuScope, using gage_select_board routine.
The board number is the CompuScope board to which all subsequent subroutines call will be applied. The
board number assignments can be determined using a CompuScope configuration utility, such as Gage
Config or Instrument Manager.
Return Value
The integer returned equals the value passed to the function as board. If an error occurs or the value
passed to the function exceeds the number of boards installed in the system then the return value does not
equal board and gage_get_error_code may be called to obtain the error code.
See also
gage_driver_initialize
Examples
C:
current_board = gage_select_board (i);
Visual BASIC:
current_board = gage_select_board (i)
CompuScope API Reference Manual
47