DioSetCountMatchValue

Function

Sets the comparison register.

Format

Ret = DioSetCountMatchValue ( Id , ChNo , ChNum , CompareRegNo, CompareCount )

Parameters

Id [C:short] [Python: ctypes.c_short]
Specifies the device ID retrieved from DioInit.

ChNo [C:short *] [Python: ctypes.POINTER(ctypes.c_short)]
Specifies the start address of the array that stores the channel numbers to set.

ChNum [C:short] [Python: ctypes.c_short]
Specifies the number of channels specified in ChNo.

CompareRegNo [C:short *] [Python: ctypes.POINTER(ctypes.c_short)]
Specifies the start address of the array that stores the register number of the comparison registers.

Device	Settable value
CPSN-DI-16BCL	0 only

CompareCount [C:unsigned int *] [Python: ctypes.POINTER(ctypes.c_uint)]
Specifies the start address of the array that stores the comparison values to be set in the comparison registers.

Specifiable range:
For 32-bit counter devices : 0h <= Count <= FFFFFFFFh

Return Value

Ret [C:long] [Python: ctypes.c_long]

Definition	Value [Dec]	Description
DIO_ERR_SUCCESS	0	Normal complete
DIO_ERR_DLL_INVALID_ID	10001	Invalid ID is specified.
DIO_ERR_DLL_CALL_DRIVER	10002	Driver cannot be called (failed in ioctl).
DIO_ERR_DLL_BUFF_ADDRESS	10100	Invalid data buffer address.
DIO_ERR_SYS_NOT_SUPPORTED	20001	This function cannot be used for this device.
DIO_ERR_SYS_CH_NO	20105	Channel No. is outside the setting range.
DIO_ERR_SYS_CH_NUM	20106	Channel number is outside the setting range.
DIO_ERR_SYS_CMP_REG_NO	20800	Comparision register No. is outside the setting range.
DIO_ERR_SYS_CMP_REG_VAL	20801	Comparision register value is outside the setting range.

The other errors: (See also: Error code details)

Remarks

- You can use DioGetCountStatus to check if it matches the specified count value.

Example

C	Ret = DioSetCountMatchValue( Id , &ChNo[0] , ChNum , &CompareRegNo[0], &CompareCount[0] );
Python	Ret = cdio.DioSetCountMatchValue( Id , ChNo , ChNum , CompareRegNo, CompareCount )