Instruction Manual

Revision Date: 08/02/02
LabPro Technical Manual 41
Command 5 Data Control
This command selects the type of data to be retrieved, as well as the starting and ending data points to be
retrieved. This is the only command that requires “Get” statement to follow each Command 5 regardless of
the host. Sampling must be completed before sending Command 5 to control the data. Before sending
Command 5, do a Get statement to ensure that sampling is completed or send Command 7 to check the
status and verify that sampling is completed. Data End must be greater than or equal to Data Begin (unless
Data End = 0). Both DataBegin and DataEnd must be less than or equal to the number of samples reported
in the status command.
Syntax:
{5,
channel, dataselect, databegin, dataend, step
}
Parameter List:
channel – indicates which channel on which this command operates. The possible values are
Channel number Description
-1 Recorded time
0 Lowest active channel
1 – 4 Analog channels 1 through 4
11, 12 Sonic Channel 1, Sonic Channel 2
21, 22 Digital Input 1, Digital Input 2
Dataselect – indicates what conversion equation is to be applied to the desired channel. If Data Select =
0, 1, or 2 and Command 3 Filter = 1-6, data will be filtered according to the filter selected in
Command 3. If Data Select = 3, 4,or 5; the filter setting in Command 3 will be ignored.
Dataselect may have the following values
dataselect Filter
0 Raw collected data (filtered)
1 d/dt (filtered)
2
d
2
/dt
2
(filtered)
3 Raw collected data (unfiltered)
4 d/dt (unfiltered)
5
d
2
/dt
2
(unfiltered)
databegin – indicates which data point (or row) the data block should start. Any integer value from zero
to the last data point collected may be used. If this value is zero (0), the first data point
collected will be used to mark the beginning of the data. This parameter persists until LabPro
receives a Command 0 (Reset), Command 3 (Data Collection Setup), or another Command 5
(Data Control). Hence subsequent Get statements will return data with this databegin as the
starting point.
dataend – indicates which data point (or row) the data block should end at. Any integer value from
zero to the last data point collected may be used. If this value is zero (0), the last data point
collected will be used to mark the ending of the data. This parameter persists until LabPro
receives a Command 0 (Reset), Command 3 (Data Collection Setup), or another Command 5
(Data Control). Hence subsequent Get statements will return data with this dataend as the
ending point.
step – every nth point starting with first point in window. This first occurred in firmware 6.06227.
If your LabPro firmware is pre 6.06227, do not include this parameter. This parameter
persists until LabPro receives a Command 0 (Reset) or another Command 5 (Data Control).
Hence subsequent Get statements will return data every n points. A new Command 3 (Data
Collection Setup) will not reset this parameter as it does with the two former parameters.
Return values:
No information is returned until the next get command.
Example 1: Get all filtered, raw unfiltered data collected on analog channel 1. In the case of the calculator,
store the data in list L1. Then, look at the data in rows 1 through 7.