GX5290, GX5295, File
Writes a block of mask memory to the specified board (Master or Slave).
DioRealTimeCompareWriteMaskMemory (nHandle, pvMemory, dwStart, dwSize, pnStatus)
Name |
Type |
Comments |
nHandle |
SHORT |
DIO or File Board handle. |
pvMemory |
PVOID |
Pointer to an array, array data type needs to comply with the I/O width settings and board type, see comments for details. |
dwStart |
DWORD |
Starting step to read from. |
dwSize |
DWORD |
Number of steps to read. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The program counter will be set to zero upon return.
Number of Channels |
Array Type |
32 |
Array data type is Double Word (DWORD) when I/O configuration is set to 32-bits width (default). GX5291: Maximum array size is 32M of double words. GX5292: Maximum array size is 64M of double words. GX5293: Maximum array size is 64M of double words. GX5295: Maximum array size is 64M of double words. |
16 |
Array data type is Word (WORD) when I/O configuration is set to 16-bits width (channels 0-15). GX5291: Maximum array size is 64M words. GX5292: Maximum array size is 128M words. GX5293: Maximum array size is 128M words. GX5295: Maximum array size is 128M words. |
8 |
Array data type is Byte (BYTE) when I/O configuration is set to 8-bits width (channels 0-7). GX5291: Maximum array size is 128MB. GX5292: Maximum array size is 256MB. GX5293: Maximum array size is 256MB. GX5295: Maximum array size is 256MB. |
4 |
Array data type is Byte (BYTE) when I/O configuration is set to 8-bits width (channels 0-3). Bits 4-7 of the array are not used and treated as don’t’ care. GX5291: Maximum array size is 256MB GX5292: Maximum array size is 512MB GX5293: Maximum array size is 512MB GX5295: Maximum array size is 512MB |
2 |
Array data type is Byte (BYTE) when I/O configuration is set to 8-bits width (channels 0-1). Bits 2-7 of the array are not used and treated as don’t’ care. GX5291: Maximum array size is 512MB GX5292: Maximum array size is 1GB GX5293: Maximum array size is 1GB GX5295: Maximum array size is 1GB |
1 |
Array data type is Byte (BYTE) when I/O configuration is set to 8-bits width (channel 0). . Bits 1-7 of the array are not used and treated as don’t’ care. GX5291: Maximum array size is 1GB GX5292: Maximum array size is 2GB GX5293: Maximum array size is 2GB GX5295: Maximum array size is 2GB |
Note: The board must be in HALT state before calling this function.
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.
The following example writes 64 steps from the Master board expected memory beginning at step 128:
DWORD adwMemory[64];
DioRealTimeCompareWriteMaskMemory (nHandle, adwMemory , 128, 64, &nStatus);
DioRealTimeCompareReadResults, DioRealTimeCompareSetupConditionValue, DioRealTimeCompareSetupDataDelay, DioRealTimeCompareGetInputDataClockEdge, DioRealTimeCompareSetupResultsDataType, DioRealTimeCompareSetupStopCondition, DioRealTimeCompareWriteExpectedMemory, DioRealTimeCompareWriteMaskMemory