Mitsubishi Electric MELSEC iQ-R Series Manual page 34

CITL_GetCollectData
This function acquires data sampled in data sampling in each sequence scan.
■ Format
short CITL_GetCollectData (short* psBuf, unsigned long ulBufSize, unsigned long* pulRecordNum)
■ Argument
Argument
psBuf
ulBufSize
pulRecordNum
Specify the acquired data storage destination size (ulBufSize) as follows:
• 1 record size  sizeof(short)  Number of records to be acquired
■ Description
• Acquired data is stored in the acquired data storage destination (psBuf) in word units in the order specified with the
CITL_SetCollectData function. To 1 point of sampled points, a bit device and a word device are stored per 1 point, a double-
word device is stored per 1/2 points (two words are used) for one word in the acquired data storage destination (psBuf).
• Sampled records are stored all or from the oldest one for the size specified to the acquired data storage destination size
(ulBufSize) in the acquired data storage destination (psBuf). When a numerical value which cannot be divided by the data
size required for 1 record is specified to the acquired data storage destination size (ulBufSize), data that can be stored in
the acquired data storage destination size (ulBufSize) is stored in the acquired data storage destination (psBuf).
• The number of records of data stored in the acquired data storage destination (psBuf) is stored in the storage destination
for the number of records (pulRecordNum).
• The following table shows the data to be stored in the acquired data storage destination (psBuf). (When outputting an index
of header information, a date and time, and the data missing status)
*1
Storage position
psBuf[0]
psBuf[1]
psBuf[2]
psBuf[3]
psBuf[4]
psBuf[5]
psBuf[6]
psBuf[7]

psBuf[7+(n-1)]

psBuf[(k+n)(m-1)]
psBuf[(k+n)(m-1)+1]
psBuf[(k+n)(m-1)+2]

psBuf[(k+n)(m-1)+7]

psBuf[(k+n)(m-1)+7+(n-1)]
*1 Information and data when using a double word (2 words) are stored from the lower word.
*2 A record refers to data to be sampled in one sequence scan. (Data set with the CITL_SetCollectData function)
3 DETAILS OF FUNCTION
32
3.1 C Intelligent Function Module Dedicated Functions
Name
Acquired data storage destination
Acquired data storage destination
size
Storage destination for the number of
records
Description
Index
Date and time
(Number of elapsed seconds from 00:00:00 on January 1st 1970)
Date and time
(Nanoseconds less than a second from the number of elapsed seconds
(unit: 100 s))
Data missing status
(0: Data is not missing, 1: Data is missing)
Sampled data (start)

Sampled data (end)







Sampled data (end)
Description
Specify the storage destination of acquired data.
Specify the size of the area reserved in the acquired data storage destination
in byte units.
Specify the storage destination for the number of records.
IN/OUT
OUT
IN
OUT
*2
Record
1 record

m record