User manual

Appendix A API Commands
ChartScan User’s Manual A-9
Command Syntax Description
R
Read Buffered Data
Rtype
Read scan data from the acquisition buffer where
type
is the
type of data request being made. Valid options for
type
are:
1
- Read the oldest scan currently residing in the acquisition
buffer,
2
- Read the oldest complete trigger block currently
residing in the acquisition buffer, and
3
- Read all the scan data
that currently resides in the acquisition buffer.
R?
Query the contents of the data buffer.
R#
Read Last Readings
R#chans
Queries the last readings from the HLL Registers for specified
channels.
chans
may be in two forms:
chan
(for a single channel where
1
<
chan
<
max
) or
first-last
(for a range of channels
where
1
<
first
<
last
<
max
),
where max = 128 for ChartScan/1400.
S
Set Real Time Clocks
Stime
Set the unit’s internal real-time clock where
time
is in the
standard time/date stamp format:
HH:MM:SS:T, mm/dd/yy
where
H
is hours,
MM
is minutes,
SS
is seconds,
T
is tenths of a
second,
mm
is month,
dd
is day, and
yy
is year.
S?
Query the internal real-time clock.
T
Set Trigger
Configuration
Tstart,
stop,
re-arm,
sync
Configure an acquisition of scan data with the following
parameters:
start
is the start event and
stop
is the stop event
re-arm
determines if the unit should continue acquiring after the
first acquisition completes, where
1
is on and
0
is off.
sync
determines if acquisition events should be synchronized
with the internal timebases, where
1
is on and
0
is off.
T?
Query the present trigger configuration
U
User Status
Ureq
Request information about various internal conditions of the unit
where
req
refers to one of the following request types:
0
- Query and clear the Event Status Register (ESR)
1
- Query the Status Byte Register (STB)
2
- Query and clear Calibration Status Register (CSR)
3
- Query system settings
4
- Query current High/Low/Last registers
5
- Query and clear current High/Low/Last
6
- Query the Buffer Status String
7
- Query assigned alarm outputs
8
- Query configured channels
9
- Query digital inputs
10
- Query memory option (in Kbytes)
11
- Query all channels having programmed valid alarm setpoints
12
- Query last calibration time/date
13
- Query last scan read
14
- Query card IDs
15
- Query product information
16
- Query measuring parameters
17
- Query root mean square (RMS)
18
- Query acquisition states and various system flags
V
Set User Terminator
Vval
Set the User Terminator value to any character whose numeric
value (ASCII value)
val
is in the range
0
to
255
.
V?
Query the present user terminator value.
W#
Set Average Weight
W#wt
In Normal mode, specify the number of samples to average for line
cycle integration or high-speed multi-channel use; where
wt
is
the average weight. Valid options for
wt
are:
1
,
2
,
4
,
8
,
16
,
32
,
64
,
128
, and
256
(with
32
being the default value).
X
Execute
X
Execute preceding command string.
Y
Set Counts
Ypre,post,
stop
When in Normal mode, set acquisition counts where
pre
is the
pre-trigger count,
post
is the post-trigger count and
stop
is
the post-stop count.
Select Blocks
Y0,count,0
When in High-speed, single-channel mode (burst mode), set
count
; where
count
is the number of 256 sample blocks to be
collected
Y?
Query current acquisition count selections.