Appendix A
API Command Reference
NetScan User’s Manual
A-41
R
- Read Buffered Data
TYPE
Buffer
EXECUTION
Immediate
SYNTAX
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.
DESCRIPTION
The Read Buffered Data (
R
) command may only be used to extract data from the acquisition buffer which has
been collected as a result of an acquisition that has been previously configured. For more information regarding
the configuration of acquisitions, refer to the Set Trigger Configuration (
T
) command.
Since the unit’s buffer is organized as a FIFO (first in, first out), the Read Buffer Data command will always read
the oldest data available in the buffer first. As the controller requests buffer scan data, the unit supplies the
oldest available scan. After the scan is supplied, that scan is no longer available. As scan data is read from the
acquisition buffer, the data is removed from the buffer and, thereafter, may not be referenced or read.
This command operates as follows: When a Read Buffer Data (
R
) command is interpreted, the requested scan
data, if it exists, is moved, one scan at a time, from the Acquisition Buffer to the output queue where it will wait in
state until you remove it. Once the data is removed from the output queue, the next Read Buffered Data
command may be issued.
Note: If the appropriate amount of scan data is not in the acquisition buffer at the time these commands are
issued, a conflict error will result.
The Scan Available bit in the Status Byte (STB) register may be queried or Serial Polled to determine if there is
any buffer scan data available. For a more complete description of how much data is available in the acquisition
buffer at any particular time, the Buffer Status String (
U6
) command may be issued.
The Set Query Terminators (
Q
) command determines the format for the terminators for acquisition buffer data.
For more information regarding the acquisition buffer terminators, refer to the Set Query Terminators (
Q
)
command.
Note: In High-speed, single-channel (burst mode), “scan” means one block of 256 samples.
EXAMPLE
S% = 0
‘ Wait for a scan
While (S% and 8) = 0
PRINT#1 “U1X"
INPUT#1, A$
S%=VAL(A$)
WEND
PRINT#1,"R1X"
‘ Get the scan
LINE INPUT#1, A$
Summary of Contents for OMB-NETSCAN 1500
Page 6: ...iv NetScan User s Manual...
Page 18: ...1 12 Configuring and Starting NetScan NetScan User s Manual Notes...
Page 38: ...3 8 General Information and Specifications NetScan User s Manual Notes...
Page 82: ...4 44 ChartView Software Reference NetScan User s Manual Notes...
Page 118: ...6 20 Calibration NetScan User s Manual...
Page 140: ...A ii NetScan User s Manual...
Page 192: ...API Command Reference Appendix A A 52 NetScan User s Manual Notes...
Page 237: ...Appendix D Registers Data Formats Queries NetScan User s Manual D 13...
Page 244: ...NetScan Program Examples Appendix E E 2 NetScan User s Manual...
Page 248: ...ASCII Code Summary Appendix F F 4 NetScan User s Manual Notes...
Page 250: ...NetScan Error Messages Appendix G G 2 NetScan User s Manual Notes...
Page 252: ...Abbreviations Appendix H H 2 NetScan User s Manual Notes...
Page 254: ...NetScan User s Manual...
