DioRealTimeCompareSetupMode

Applies To

GX5295, File

Purpose

Sets the Real Time Compare mode.

Syntax

DioRealTimeCompareSetupMode (nHandle, nMode, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Board or File Board handle.
nMode
SHORT
2   DIO_RTC_MODE_DEFAULT: Default Real Time Compare mode operating mode. Supported by supported only by GX529x boards with firmware versions 0x8A00 and above.
3   DIO_RTC_MODE_FIRST_FAIL_PER_CHANNEL: In this mode all default Real Time Compare operating mode are supported, but in addition when running vectors only the first failure per channels will be logged. Supported by supported only by GX5295 boards with firmware versions 0xF605 and above.
pnStatus
LONG
Returned status: 0 on success, negative number on failure.

Comments

The DIO_RTC_MODE_FIRST_FAIL_PER_CHANNEL Real Time Compare mode is useful for a go-no-go testing where the user wants to know which channels failed at least once and the failure vector address.

NOTE: All boards in the domain have to set the Real Time Compare mode to DIO_RTC_MODE_FIRST_FAIL_PER_CHANNEL mode using DioRealTimeCompareSetupMode API prior calling this function. See the DioRealTimeCompareSetupMode function for more details.

Example

The following example initializes a master board in slot 6 and a slave board in slot 7. Sets both boards to operate in Real Time Compare mode. Sets the domain to be in Real Time Compare mode, Set the Real Time Compare mode to DIO_RTC_MODE_FIRST_FAIL_PER_CHANNEL mode, and enables all even channels in the master board. And reads the board active channels real time compare pass fail statues:

 

SHORT nMasterHandle1, nSlave1, nDensity, nBanks, nStatus;

DWORD dwChannelsStatus, dwActiveChannels;

 

DioSetupInitialization (0, 1, 0x106, &nDensity, &nBanks, &nMasterHandle1, &nStatus);

DioSetupInitialization (nMasterHandle1, 1, 0x107, &nDensity, &nBanks, &nSlave11, &nStatus);

DioDomainSetupOperatingMode (nMasterHandle, DIO_OPERATING_MODE_REAL_TIME_COMPARE, &nStatus);

DioRealTimeCompareSetupMode (nMasterHandle, DIO_RTC_MODE_FIRST_FAIL_PER_CHANNEL, &nStatus);

DioRealTimeCompareClearResultMemory (nMasterHandle, DIO_RTC_MODE_FIRST_FAIL_PER_CHANNEL, &nStatus);

DioRealTimeCompareSetupActiveChannels(nMasterHandle, 0xAAAAAAAA, &nStatus);

DioRealTimeCompareGetActiveChannels(nMasterHandle, &dwActiveChannels, &nStatus);

DioRealTimeCompareReadChannelsStatus (nMasterHandle, &dwChannelsStatus, pnStatus)

 

See Also

DioRealTimeCompareClearChannelsStatus, DioRealTimeCompareReadChannelsStatus, DioRealTimeCompareSetupActiveChannels, DioRealTimeCompareReadChannelsStatus, DioRealTimeCompareSetupActiveChannels,  DioRealTimeCompareSetupMode, DioRealTimeCompareSetupConditionValue, DioRealTimeCompareSetupDataDelay, DioRealTimeCompareSetupInputDataClockEdge, DioRealTimeCompareSetupResultsDataType, DioRealTimeCompareSetupStopCondition, DioRealTimeCompareWriteExpectedMemory, DioRealTimeCompareWriteMaskMemory,  DioRealTimeCompareReadResults