Appendix A API Command Reference
NetScan User’s Manual A-9
Command
Syntax
Description
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 NetScan.
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.