Table of Contents
Advertisement
XPS-Q8 Controller
12.0
Data Gathering
The XPS controller provides four methods for data gathering:
1. Time-based (internal) data gathering. With this method one data set is gathered for
every n
th
servo cycle.
2. Event-based (internal) data gathering. With this method one data set is gathered at
an event.
3. Function-based (internal) data gathering. With this method one data set is gathered
by a function.
4. Trigger-based (external) data gathering. With this method one data set is gathered
for every n
th
external trigger input (see also chapter 13.0: "Output Triggers").
Method 1, 2, and 3, these are also referred to as internal or servo cycle synchronous data
gathering. With the trigger-based data gathering, this is also referred to as an external
data gathering, as the event that triggers the data gathering or the receipt of a trigger
input, is asynchronous to the servo cycle.
The time-based, the event-based and the function-based data gathering store the data in
a common file called gathering.dat. The trigger-based (external) data gathering stores
the data in a different file, called ExternalGathering.dat. The type of data that can be
gathered differs also between the internal and the external data gathering.
Before starting any data gathering, the type of data to be gathered needs to be defined
using the functions GatheringConfigurationSet() (in case of an internal data gathering)
or ExternalGatheringConfigurationSet() (in case of an external data gathering). Refer to
the Programmer's Manual and the Gathering functions for a complete list of data types.
During data gathering, new data is appended to a buffer. With the functions
GatheringCurrentNumberGet() and GatheringExternalCurrentNumberGet(), the current
number of data sets in this buffer and the maximum possible number of data sets that
fits into this buffer can be recalled. The maximum possible number of data sets equals
1,000,000 divided by the number of data types belonging to one data set.
The function GatheringDataGet(index) returns one set of data from the buffer. Here, the
index 0 refers to the 1st data set, the index (n-1) to the n-th data set. When using this
function from the Terminal screen of the XPS utility, the different data types belonging
to one data line are separated by a semicolon (;).
To save the data from the buffer to the flash disk of the XPS controller, use the
functions GatheringStopAndSave() and GatheringExternalStopAndSave(). These
functions will store the gathering files in the ..\Admin\Public folder of the XPS
controller under the name Gathering.dat (with function GatheringStopAndSave() for
internal gathering) or GatheringExternal.dat (with function
GatheringExternalStopAndSave() for external gathering).
The functions GatheringStopAndSave() and
GatheringExternalStopAndSave() overwrite any older files with the
same name in the ..\Admin\Public folder. After a data gathering, it is
required to rename or better, to relocate valid data files using an ftp
link to the XPS controller (see chapter 5: "FTP connection").
A gathering file can have a maximum of 1,000,000 data entries and a maximum of 25
different data types. The first line of the data file contains the sample period in seconds
(minimum period = 0.000125 s), the second line contains the names of the data type(s)
and the other lines contain the acquired data. A sample file is shown below.
147
CAUTION
XPSDocumentation V1.4.x (EDH0301En1060 — 10/17)
Motion Tutorial
Advertisement
Table of Contents
