REC.RETRIEVEDATA

Description

REC.RETRIEVEDATA retrieves a section of recorded data according to REC.RETRIEVESIZE from the received index; if no index is received, the drive retrieves the data from next section. An index is supplied to enable multiple retrieves and to give better control on the buffer in case of overflow.  If no index or a negative value is present, then the index is ignored.

WorkBench uses this parameter to retrieve the data continuously for real time recoding.

The size of the data returned by this command depends on the number set by REC.RETRIEVESIZE.

Use REC.RETRIEVE for complete recording information view.

Notes:

  • If REC.RETRIEVESIZE is larger than the buffer size, then it simply returns the whole buffer (no error).
  • If the index is received, the data will be continuously returned starting from the given index (default starting index is 0).
  • If the index is out of the bounds of the buffer, then it will be ignored.
  • If recorder is active and REC.STOPTYPE==0, then this parameter returns an error.
  • If REC.STOPTYPE==1, then this parameter returns the next section of data in the buffer (even if it reached the end of the buffer, it will return to the beginning of the buffer and add the data from index 0.)
  • If REC.STOPTYPE==1 and the retrieve is too slow (gets overrun by the recorder), an overflow error message is returned instead of the retrieved data.
  • If REC.STOPTYPE==0 and no index is received, continuously send the sections of data until the end of the buffer is reached. Then, return to the beginning of buffer and continue.
  • A new REC.TRIG command automatically sets the index to 0.

Example

The following example retrieves data from index 100 in the size of 10 (hence places 100 to 109 in the buffer)

REC.NUMPOINTS 1000
REC.RETRIVESIZE 10
REC.TRIG
REC.RETRIEVEDATA 100

General Information

Type

R/W Parameter

Units

N/A

Range

N/A

Default Value

N/A

Data Type

N/A

See Also

REC.RETRIEVE, REC.RETRIEVEHDR, REC.RETRIEVESIZE

Start Version

M_01-00-00-000

Variants Supported

Variant Supported
AKD Base Yes
AKD with Position Indexer Yes
AKD EtherCAT Yes
AKD CANopen Yes
AKD BASIC Yes
AKD SynqNet Yes*
AKD EtherNet/IP Yes
AKD PROFINET Yes
AKD Sercos® III Yes
AKD-N Yes
AKD-C Yes

*In SynqNet, a parameter may be available in the firmware but have no effect on the system. See SynqNet Supported Parameters.

Fieldbus Information

If your drive type is listed as supported but no index, address, or instance number is listed, then this parameter is accessible through WorkBench, but not over your fieldbus type. For information on SynqNet parameters see SynqNet Supported Parameters.

Related Topics

Scope