DioRealTimeCompareGetDomainFailStatus

Applies To

GX5295

Purpose

Returns a boolean value if the last run had any real time compare failures.

Syntax

DioRealTimeCompareGetDomainFailStatus (nHandle, pbFailStatus, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Board or File Board handle.
pbFailStatus
PBOOL
Returns a boolean value if the last run had any real time compare failures.
0       No real time compare failures
1    At least one real time compare failure.
pnStatus
LONG
Returned status: 0 on success, negative number on failure.

Comments

All boards in the domain have to be in Real Time Compare operating mode prior calling this function. See the DioDomainSetupOperatingMode function for more details.

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.

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

Note: Real Time Compare with per channel fail functionality is supported only by GX5295 boards with firmware versions 0xF605 and above.

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

DioRealTimeCompareReadChannelsStatus, DioRealTimeCompareReadChannelsStatus, DioRealTimeCompareSetupActiveChannels, DioRealTimeCompareSetupMode, DioRealTimeCompareSetupConditionValue, DioRealTimeCompareSetupDataDelay, DioRealTimeCompareSetupInputDataClockEdge, DioRealTimeCompareSetupResultsDataType, DioRealTimeCompareSetupStopCondition, DioRealTimeCompareWriteExpectedMemory, DioRealTimeCompareWriteMaskMemory, DioGetErrorString