GtDio6xProbeGetData

Applies To

GX5961

Purpose

Returns the data recorded by the probe.

Syntax

GtDio6xProbeGetData (nHandle, lStartingAddress, lArraySize, palProbeData, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Session identifier:

●     Board handle is used when communicating with the hardware. The Board handle session identifier is returned by calling GtDio6xInitialize or GtDio6xSetupInitialization.
lStartingAddress
LONG
Specifies the vector offset to query
Must be in the range of 0-262143.
lArraySize
LONG
Used to specify the number of elements in the probe array, plProbeData, as well as the number of elements to retrieve.
 The lStartingAddress plus the lArraySize must be less than or equal to 262144.
palProbeData
PLONG
Used to return the probe data results.
The array must have at least as many elements as is specified in the lArraySize parameter.
pnStatus
PSHORT
Returned status: 0 on success, negative value on failure.

Comments

The probe memory stores eight bits of data from the AUX0 input for every vector.

The bit descriptions for the probe memory are:

Bit
Description
0
Good 1 level at window 3 open.
1
Good 0 level at window 3 open.
2
Good 1 level at window 3 close.
3
Good 0 level at window 3 close.
4
Positive transition at good 1 level.
5
Positive transition at good 0 level.
6
Negative transition at good 1 level.
7
Negative transition at good 0 level.

Example

The following example gets the first 20 recorded results from the probe memory:

 

LONG alProbeData[20];

 

GtDio6xProbeSetDataMode(nHandle, GTDIO6X_ENABLED, &nStatus);

GtDio6xSequencerRun(nHandle, 0, &nStatus);

GtDio6xProbeGetData(nHandle, 0, 20, alProbeData, &nStatus);

 

See Also

GtDio6xProbeSetDataMode, GtDio6xProbeGetDataMode, GtDio6xProbeSetParameters, GtDio6xProbeGetParameters, GtDio6xWriteVectorMemory, GtDio6xReadVectorMemory, GtDio6xGetErrorString