70
3 DETAILS OF FUNCTION
3.1 C Intelligent Function Module Dedicated Functions
CITL_Y_In_Word
This function reads an output signal (Y) in word (16-point) units.
■ Format
short CITL_Y_In_Word (unsigned short usYNo, unsigned short usSize, unsigned short* pusDataBuf, unsigned short
usBufSize)
■ Argument
■ Description
• This function reads an output signal (Y) for the size specified to the read data size (usSize) from a start output signal (Y)
specified to the start output signal (usYNo), and stores it in the data storage destination (pusDataBuf).
• Specify the area size of the data storage destination (pusDataBuf) to the data storage destination size (usBufSize).
• When 0x10 is specified to the start output signal (usYNo) and two words are specified to the read data size (usSize), the
CITL_Y_In_Word function returns an I/O access size error and the value is not read.
• Read data is stored in the data storage destination (pusDataBuf) in ascending order from the lower bit as shown below.
Note that the size of data storage destination (usBufSize) should be equal to or bigger than the read data size (usSize).
■ Return value
■ Relevant function
Page 65 CITL_X_In_Bit
Page 66 CITL_X_In_Word
Page 67 CITL_X_Out_Bit
Page 70 CITL_Y_In_Word
Page 69 CITL_Y_In_Bit
Argument Name Description IN/OUT
usYNo Start output signal Specify a start output signal (Y).
(Only 0x00 and 0x10 can be specified.)
IN
usSize Read data size Specify the read data size in word units.
• When start output signal is 0x00: Only 1 and 2 can be specified.
• When start output signal is 0x10: Only 1 can be specified.
IN
pusDataBuf Data storage destination Specify the storage destination of read data. OUT
usBufSize Data storage destination size Specify the data storage destination size in word units. IN
Storage position Description
pusDataBuf[0] Data of usYNo+FH to usYNo
pusDataBuf[1] Data of usYNo+1FH to usYNo+10H
Return value Description
0 (0000H) Normal
Other than 0 (0000H) Error
For details on the error, refer to the following chapter.
Page 108 ERROR CODE LIST