CompuScope SDK Manua.. - Egmont Instruments

gage_calculate_mra_addresses
Syntax
C:
int32 GAGEAPI gage_calculate_mra_addresses (int16 board_type, uInt16 version, int16 chan,
int16 op_mode, float tbs, int32 far *trig, int32 far *start,
int32 far *end, int16 data);
Visual BASIC:
Function gage_calculate_mra_addresses (ByVal board_type As Integer, ByVal version As Integer,
ByVal chan As Integer, ByVal op_mode As Integer,
ByVal tbs As Single, trig As Long, start As Long,
ending As Long, ByVal ad_data As Integer) As Long
Remarks
This routine corrects the trigger addresses when reading the data from a CompuScope Multiple Record
capture. Due to the architecture of the hardware, the lowest few significant bits (depending on the
CompuScope model) of the trigger address are not maintained. These bits are called Enhanced Trigger
Bits (ETBs). With the appropriate CompuScope hardware modification, these bits are embedded within an
early data point (typically the first) of each Multiple Record group. The gage_calculate_mra_addresses
routine is used to adjust the trigger address according to the Embedded ETBs.
Embedded ETBs is a standard feature on most PCI and cPCI CompuScopes. In order to determine if your
CompuScope manual supports embedded ETBs, run a board information query using the CompuScope
configuration utility as described in the Driver Installation Guide for CompuScope Cards. The feature will
show up as MULTIPLE_RECORD_ADJUST.
The gage_calculate_mra_addresses routine must be called after the raw Multiple Record trigger address
has been determined by calling the gage_calculate_mr_addresses routine. For a CompuScope with
embedded ETBs, the trigger address returned by gage_calculate_mr_addresses actually contains the
address of the data point containing the embedded ETBs. The user then downloads the data point at this
location and passes it to gage_calculate_mra_addresses as the data parameter.
gage_calculate_mra_addresses then returns the true adjusted start, trigger and end addresses.
board_type is the type of the CompuScope hardware being used. The CompuScope board type can be
determined by calling gage_get_driver_info routine and passing the board_type field to this routine.
version is the hardware version of the current CompuScope. The CompuScope board version can be
determined by calling gage_get_driver_info routine and passing the board_version field to
gage_calculate_mra_addresses routine.
chan is set to 0 for getting addresses for channel A on current CompuScope, and is set to 1 for getting
addresses for channel B on current CompuScope.
op_mode is the mode that was set when calling gage_capture_mode routine. Use the value that
controlled the most recent data capture, either GAGE_SINGLE_CHAN or GAGE_DUAL_CHAN.
GAGE_QUAD_CHAN can also be used for digital input CompuScopes such as CS3200.
tbs is the "Time Between Samples" in nanoseconds for the captured signal. For example, if you have
sampled the signal at 10 MS/s then this value would be 100.0. Similarly, a signal sampled at 1 kS/s would
require this value to be set to 1000000.0.
*trig is the adjusted trigger address.
CompuScope API Reference Manual 20