Omega Vehicle Security OMB-NETSCAN 1500 User Manual download pdf (Page 181)

Appendix A

API Command Reference

NetScan User’s Manual A-41

- 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:

- Read the oldest scan

currently residing in the acquisition buffer,

- Read the oldest complete

trigger block currently residing in the acquisition buffer, and

- Read all the

scan data that currently resides in the acquisition buffer.

Query the contents of the data buffer.

DESCRIPTION

The Read Buffered Data (

) 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 (

) 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 (

) 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 (

) command may be issued.

The Set Query Terminators (

) 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 (

)

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$

1 2 ... 176 177 178 179 180 181 182 183 184 185 186 ... 255 256

Comments to this Manuals

No comments

Omega Vehicle Security OMB-NETSCAN 1500 User Manual Page 181

Comments to this Manuals

Related products and manuals for Measuring, testing & control Omega Vehicle Security OMB-NETSCAN 1500