DioReadCountSR


Function

Retrieves the count values on the wireless I/O device.

Format

Ret = DioReadCountSR ( Id , ChNo , ChNum , Count, Timestamp , Mode )

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 for which count values are to be acquired.

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

Count[C:unsigned int *] [Python: ctypes.POINTER(ctypes.c_uint)]
Specifies the start address of the array that stores the count values.

Timestamp [C:unsigned short *] [Python: ctypes.POINTER(ctypes.c_ushort)]
Specify the address of the variable to store the timestamp.

Mode [C:unsigned char] [Python: ctypes.c_ubyte]
Specify where to refer to the input data.

Definition

Value

[Dec]

Description

DIONET_MODE_DIRECT

0

Refer to the input data of Terminal.

DIONET_MODE_AP

1

Refer to the input data of Gateway.

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.

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

Remarks

Retrieves the count values of the specified channels.
To acquire data, there are two methods. One is acquiring data stored in master unit, the other one is acquiring data directly from slave unit.
Please refer to the wireless I/O specification for features of each acquisition method.

For the data acquisition method, when acquiring the data stored in the master unit, you can acquire the time stamp of the data stored in the master unit.
The time stamp returns the time since the last update in seconds.
If the time stamp is longer than the update interval of the slave unit, the data from the slave unit is not reaching the master unit for some reason.
Please use it to check the validity of the data saved in the master unit.

Example

C

Ret = DioReadCountSR( Id , &ChNo[0] , ChNum , &Count[0], &Timestamp , Mode );
 

Python

Ret = cdio.DioReadCountSR( Id , ChNo , ChNum , Count , ctypes.byref(Timestamp) , Mode )
 

See Also

DioStartCount
DioReadCount