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