DioRealTimeCompareSetupInputDataClockEdge

Applies To

GX5290, GX5295, File

Purpose

Sets the input data strobe edge.

Syntax

DioRealTimeCompareSetupInputDataClockEdge (nHandle, nEdge, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Board or File Board handle.
nEdge
SHORT
Input data clock edge:
0. DIO_RISING_EDGE: Input data clock rising edge
1. DIO_FALLING_EDGE: Input data clock falling edge
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The response data which is clocked by the strobe is fed to the real time comparator using the same clock as the output data and the mask data. The user can set the input data (response data) clock edge to either capture the input data on the falling or rising edge. This can assist in aligning the input data with the other two sources of data, the masked and expected memory data to correctly compare.

The Rising/Falling parameter defines the edge of the data clock that is used to transfer the data sampled by the strobe into the input pipeline. This parameter is used to avoid meta stable conditions where the sample strobe and the data clock might overlap, causing ambiguous data storage. Using the falling edge of the data clock to transfer sampled data to the input pipeline places the data in the pipeline one cycle earlier than using the rising edge of the data clock (it uses the falling edge of the previous vector clock cycle not the rising edge of the current vector clock cycle).

The board has to be in Real Time Compare operating mode prior calling this function. See the DioDomainSetupOperatingMode function for more details.

Note: the Real Time Compare functionality is supported by GX529x boards with firmware versions 0x8A00 and above..

Example

The following example sets the input data clock edge:

 

DioRealTimeCompareSetupInputDataClockEdge (nHandle, DIO_RISING_EDGE, &nStatus);

 

See Also

DioRealTimeCompareSetupConditionValue, DioRealTimeCompareSetupDataDelay, DioRealTimeCompareGetInputDataClockEdge, DioRealTimeCompareSetupResultsDataType, DioRealTimeCompareSetupStopCondition, DioRealTimeCompareWriteExpectedMemory, DioRealTimeCompareWriteMaskMemory, DioRealTimeCompareReadResults