This document applies to firmware version 1.04
and above.
Copyright T ektronix, Inc. All rights reserved. Licensed software products are owned by Tektronix
or its suppliers and are protected by United States copyright laws and international treaty provisions.
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in
subparagraph (c)(1)(ii) of the Rights in T echnical Data and Computer Software clause at DFARS
252.227-7013, or subparagraphs (c)(1) and (2) of the Commercial Computer Software – Restricted
Rights clause at F AR 52.227-19, as applicable.
T ektronix products are covered by U.S. and foreign patents, issued and pending. Information in this
publication supercedes that in all previously published material. Specifications and price change
privileges reserved.
Printed in the U.S.A.
T ektronix, Inc., P.O. Box 1000, Wilsonville, OR 97070–1000
TEKTRONIX and TEK are registered trademarks of T ektronix, Inc.
This manual is for the programmer who is writing remote control programs for the
AM700 Audio Measurement Set.
Manual Content
Getting Started provides information about the remote control capabilities of
the AM700 Audio Measurement Set. This information includes the IEEE 488.1
interface function implemented, the IEEE 488.2 status reporting commands, a
description of the rear panel remote connectors, how to configure the AM700 for
remote control, and how to connect printers.
Additionally, a SCPI model of the AM700 is developed to show how SCPI
commands are used to control the AM700 operations.
SCPI Conformance Information describes the SCPI subsystems implemented
in the AM700 and provides some background on what SCPI is and is not. A list
of references related to the standards tested by the AM700 is also provided in
this section.
AM700 SCPI Commands starts with a list of the IEEE mandated commands,
a list of the SCPI required commands, and information on optional commands.
The SCPI command syntax is described, and an explanation of the command
notations used in this manual is given. That introductory material is followed by
a complete set of the SCPI commands that the AM700 responds to in alphabetical order. How the commands are used is explained in some detail along with
the query, if there is one, and explanatory examples.
Examples provides information on how to write a function and gives a small
sample function program as an example of how a function might be used. How
to run a function and how to make a timed functions are described. A short
description of Tcl commands that were added or changed, and their limitations as
used in functions is also provided in this section.
AM700 Audio Measurement Set Programmer Manual
xxi
Preface
xxii
AM700 Audio Measurement Set Programmer Manual
Getting Started
Getting Started
This section gives the GPIB and RS-232C features for remote control of the AM700.
The AM700 is designed to use the GPIB port for remote control operations. The
serial RS-232C port support serial printer operations.
GPIB and RS-232C Remote Operation
The AM700 has very complete and flexible remote control capabilities through its
GPIB interface. The GPIB interface is used to send commands that are intended for
the control of the GPIB interface itself and for sending SCPI commands intended for
remote control of the AM700 operation. This section defines the interface
commands and printer connections for output of hardcopy reports.
Accessories
for Remote
Control
Control
Protocol
AM700 Audio Measurement Set Programmer Manual
The following accessories are needed or recommended:
GPIB Cable: double shielded in various lengths (user supplied)
Programmer Manual
Programmer Quick Reference
The AM700 uses SCPI-1994 as its primary control protocol. SCPI (Standard
Commands for Programmable Instruments) is an emerging standard promoted by a
consortium of test and measurement equipment vendors, including T ektronix. The
intent of SCPI is to provide a consistent and standard command language for all test
and measurement equipment. SCPI is layered on top of IEEE 488.2, and contains
several 488.2 commands and status structures.
Remote control of the AM700 makes it possible to do most of the user interface
operations available via the front panel, plus several things that come with a
protocol such as SCPI. These other things are the following:
Immediately place an application in a certain state.
1–1
Getting Started
Query internal data points not directly accessible to a user at the front panel.
Place prompting messages on the screen and query for key presses for
interactive procedures.
Set up timed functions.
The programming language for functions is T cl. The Tcl commands permit a
programmer to build conditional tests and create their own functions. The T cl
interpreter in the AM700 allows imbedding SCPI commands in a function program
using the “scpi” T cl command. The parser directs the SCPI commands appropriately . The Tcl command language is documented in Part I: The Tcl Language of the
book Tcl and the Tk Toolkit, by John K. Ousterhout: Addison-Wesley Publishing
Company, 1994.
Control Ports
GPIB
Interface
Information
The instrument may be controlled from the following sources:
The user operating the front panel keys, touch panel, and, for certain
operations, an external keyboard.
The GPIB port; a standard IEEE-488.2 interface.
Though it is not advised, whenever it is not explicitly disabled as part of the
protocol it is possible to control the instrument through both the front panel and the
GPIB interface port at the same time.
In normal GPIB remote operation the AM700 is controlled with an external
instrument controller . The only time the AM700 will attempt to take control of the
GPIB is when a hardcopy is requested from the front panel with the print port
configured to ‘GPIB’.
IEEE 488.1 Interface Functions. The GPIB interface function set implemented in
the AM700 GPIB interface and the capability level is given in T able 1–1.
1–2
AM700 Audio Measurement Set Programmer Manual
Getting Started
Table 1–1: IEEE 488.1 interface functions implemented in the AM700
FunctionImplementedNotes
Source HandshakeSH1Complete capability
Acceptor HandshakeAH1Complete capability
TalkerT6Basic Talker, Serial Poll, Unaddr if
Talker (extended)TE0No capability
ListenerL4Basic Listener, Unaddr if MTA
Listener (extended)LE0No capability
Service RequestSR1Complete capability
Remote LocalRL0No local lock out
Parallel PollPP0No capability
Device ClearDC1Complete capability
Device TriggerDT0No capability
ControllerC0No capability
Electrical InterfaceE2Three-state bus drivers
MLA
IEEE 488.2
Commands
Complete details of IEEE 488.2 commands and operation are found in IEEE STD
488.2-1992, IEEE Standard Codes, Formats, Protocols, and Common Commands. A
brief summary of those implemented in the AM700 is given in the following tables.
Table 1–2: IEEE 488.2 status reporting commands
CommandNameFunction
*CLSClear Status CommandClears status data structures and forces
*ESE NRfStandard Event Status Enable
Command
AM700 Audio Measurement Set Programmer Manual
the device to the Operation Completed
Command Idle State and the Operation
Complete Query Idle State.
Sets the Standard Event Status Enable
Register bits.
1–3
Getting Started
Table 1–2: IEEE 488.2 status reporting commands (cont.)
CommandFunctionName
*ESE?Standard Event Status Enable
Query
Queries the contents of the Standard
Event Status Enable Register.
*ESR?Standard Event Status Regis-
ter Query
Queries the contents of the Standard
Event Status Register. Reading the
register clears it.
*SRE NRfService Request Enable
Command
Sets the Service Request Enable Register
bits.
*SRE?Service Request Enable QueryQueries the Service Request Enable
Register. Returns an NR1 that is the value
of the service request enable register.
*STB?Read Status Byte QueryQueries the status byte. Returns an NR1
that is the value of the status byte and the
master summary message.
Table 1–3: Internal operation commands
CommandNameFunction
*IDN?Identification QueryQueries the id of the AM700.
*RSTReset CommandDoes a AM700 reset.
*TST?Self-Test QueryThis is currently a “NO-OP” It is effect
just tests the remote connectivity and
does not change the operating state of
the AM700.
1–4
AM700 Audio Measurement Set Programmer Manual
Getting Started
Table 1–4: Synchronization commands
CommandNameFunction
*OPCOperation Complete
Command
*OPC?Operation Complete QueryPlaces an ASCII “1” in the AM700’s
*WAIWait-to-Continue CommandPrevents the AM700 from executing
Causes the AM700 to Generate the
operation complete message in the
Standard Event Status Register when all
pending selected device operations
have been finished.
output queue when all pending selected
device operations have been finished.
further commands or queries until the
no-operation-pending flag is TRUE.
RS-232C
Interface
Information
The COM1 and COM2 ports may be configured as serial RS-232C DTE ports.
These are DB-9 male connectors. The Serial Interface parameters given in
T able 1–5 are user selectable using menu control. If you are connecting the port to
another terminal, you will need a null modem connector to make the appropriate
connections. A user-supplied printer cable is needed to make the connection
between the AM700 and the user’s printer .
Table 1–5: Serial port protocol
CapabilitiesDescription
Serial ports
COM1 and COM2RS-232C
ConnectorDB-9, male. Configured as DTE ports.
Serial interface parameters
RS-232C
Baud RateUser selectable: 300, 600, 1200, 2400, and 9600,
19,200, and 38,400.
Flow ControlXON/XOFF, CTS/RTS, and None.
AM700 Audio Measurement Set Programmer Manual
1–5
Getting Started
Table 1–5: Serial port protocol (cont.)
Serial interface parameters
Signal Bits7 or 8
Stop Bits1 or 2
ParityOdd, Even, and None
1–6
AM700 Audio Measurement Set Programmer Manual
Rear Panel I/O Connectors
Figure 1–1: AM700 Rear Panel
Getting Started
GPIB
Connector
The GPIB connector (shown in Figure 1–2) provides a remote control interface to
the AM700. It is a standard IEEE 488 parallel GPIB connector. One- and two-meter,
double-shielded GPIB cables are available as optional accessories (refer to the
AM700 Audio Measurement Set User Manual).
GPIB
Figure 1–2: GPIB Connector
AM700 Audio Measurement Set Programmer Manual
1–7
Getting Started
COM1 and
COM2 Serial
Ports
REMOTE
Connector
These two male DB-9 connectors (shown in Figure 1–3) provide the interface for
RS-232C serial output as DTE ports. These connectors support RS-232C printer
output.
COM 1COM 2
Figure 1–3: COM1 and COM2 serial ports
The Remote connector (shown in Figure 1–4) provides a user interface for
contact-closure remote control. The AM700 may use this port to control external
devices that are actuated via a contact-closure. The TTL-Level input may be used
with external contact-closure relay or switch to initiate an action for the AM700. A
possible use of this feature is to use a foot switch to signal the AM700 in a running
function for production line testing. This type of operation leaves the operator’s
hands free to make connections to the equipment under test and operate the AM700
making the measurements without having to have immediate access to the front
panel of the AM700. A function program has to be written with the appropriate
commands to make use of the remote connector for the operation just described.
1–8
AM700 Audio Measurement Set Programmer Manual
REMOTE
1 2 3 4 5
6 7 8 9
DB-9 FEMALE REMOTE CONNECTOR
Pin 1TTL-Level Input
Pins 2, 4, 6, 8Ground
Pin 3 to Pin 9Normally Open
Pin 5 to Pin 9Normally Closed
Pin 7+5 V Output @ 5 mA
Figure 1–4: Remote contact-closure connector
Getting Started
Table 1–6: Remote connector pins
Remote connector
Control TypeContact Closure
ConnectorDB-9, female
Pin 1, TTL
Level Input
0 to +5V , 100 mA. Input is protected. Use the +5 V
output of pin 7 to drive this input via an external
contact-closure relay. The state of the TTL input
(HIGH or LOW) can be read and used as an external
trigger input.
Pins 2, 4, 6, and 8Ground
AM700 Audio Measurement Set Programmer Manual
1–9
Getting Started
Table 1–6: Remote connector pins (cont.)
Remote connector
Pin 3 to Pin 9,
Contact Closure
Pin 5 to Pin 9Reserved, normally-closed contact
Pin 7, +5 V Output+5 V @ 5 mA. This output is provided to drive the
System Communication
The Communication selections shown in Figure 1–5 provide the choices needed to
define the serial communications parameters for serial ports COM1 and COM2, and
setting the GPIB communications mode and the GPIB address. The conventional
choices in serial communications of Baud rate, stop bits, parity, hardware handshaking, and software handshaking for RS-232 are provided. With the first release,
the serial ports are unidirectional, output only, for support of serial printers.
GPIB choices permit you to select the mode of operation and the GPIB address of
the AM700. GPIB modes of operation are T alk/Listen, Hardcopy, and Off Bus.
T alk/Listen mode is used for remote control of the AM700 via the GPIB port.
Hardcopy is the talk only mode and is used to output screens and data to a GPIB
printer. Off Bus turns of the GPIB interface, and the AM700 will not communicate
with any other device on the bus.
Normally open. Maximum voltage: 220 VDC;
Maximum current: 2 A; Maximum power: 60 W.
The state of the contact-closure relay (open or closed)
is settable from a function key and using SCPI
remote control.
TTL-Level input through an external contactclosure relay.
1–10
AM700 Audio Measurement Set Programmer Manual
Getting Started
Figure 1–5: Configure system setup communicate menu
Connecting Printers
This topic discusses connecting an EPSON LQ, Apple LaserWriter, HP LaserJet,
DeskJet, or ThinkJet, or generic ASCII printer to the AM700.
Connecting
an EPSON LQ
Printer
AM700 Audio Measurement Set Programmer Manual
The default configuration is set for use with the EPSON LQ letter quality printer
with serial interface C 823051. The default configuration of the EPSON LQ printer
is adequate for use with the AM700. Refer to the user’s manual for your printer for
information on any changes you might wish to made to the printer setup.
With the AM700 and printer power off, connect the serial printer cable from the
25-pin DB-25 female connector on the printer’s rear panel to COM2 on the back of
the AM700 (a 9-pin DB-9 male connector). If you have not changed the factory
1–11
Getting Started
Á
Á
default values, all you need to do now is turn on the AM700 and the printer. If you
have changed some factory default values, be sure the values shown in the following
example are set.
Making Your Own LQ Cable. If the correct printer cable is not readily available,
one can be easily constructed. A male 25-pin DB-25 connector, a female DB-9
connector, and an appropriate length of four-conductor cable are the materials
needed for the cable. Table 1–7 lists the wiring connections for making a cable to
use with an Epson LQ printer.
Note the following when connecting an Apple LaserWriter to a AM700 serial port:
Setting Up The AM700. Set the selected port’s Baud Rate to 9600, Flow Control to
XON/XOFF, Character Size to 8, Reset Character to Ctrl-D, and Carrier Detect
to Disabled.
Setting Up The LaserWriter. Set the rear panel switch to the 9600 position.
The cable connecting the AM700 and the LaserWriter should be wired as described
in Table 1–8. The cable must have a female DB-9 connector on the AM700 end and
a male DB-25 connector on the LaserWriter end.
1–12
AM700 Audio Measurement Set Programmer Manual
Table 1–8: Apple LaserWriter connections
Á
Á
Getting Started
Connecting
an HP
LaserJet,
DeskJet, or
ThinkJet
Male DB-25 connector pin number (Apple
LaserWriter end)
1 (shield GND)
3 (RXD)
2 (TXD)
5 (CTS)
4 (RTS)
ББББББББББ
7 (signal GND)
Female DB-9 connector pin number
(AM700 end)
shield GND
3 (TXD)
2 (RXD)
7 (RTS)
8 (CTS)
БББББББББББ
5 (signal GND)
You will have to configure both the AM700 and the printer to respond correctly.
Setting up the AM700. In Configure menus under System Setup Copy set the Copy
Format to HP printer type. Select the output port from the Copy Destination
choices.
Setting up the port for communications is done in the Configure menus under the
System Setup Communicate choices, shown in Figure 1–5. For the selected port, set
the Baud Rate to any value from 300 to 19200, set Protocol to None, Flow Control
to XON/XOFF, Reset Character to None, Parity to None, Character Size to 8, and
Carrier Detect to Disabled.
Setting up the HP LaserJet, DeskJet, or ThinkJet. Set the baud rate to the same as
the AM700.
Making Your
Own LaserJet
T able 1–9 lists the wiring connections for making a cable to use with an HP LaserJet
printer.
The AM700 can also be configured to operate with a generic ASCII printer. A
generic ASCII printer is assumed to only print text; graphic functions are not
supported.
Hardcopy Output
Hard copies of data, screens, files, limits, and other data outputs of the AM700 will
be available on printers or plotters connected to RS-232C or GPIB ports.
Pressing the Copy button sends a copy of the display in the selected format to the
print spooler (temporary memory space) where it is queued for printing. The LED in
the Copy button flashes as long as the copy remains in the spooler.
T o select the output format for a copy, you must use the menu selections for Copy
found in the Configure menu under System Setup. Press and hold the Copy button to
display the Copy Configuration screen (see Figure 1–6).
NOTE. Pressing and holding the Copy button immediately brings up the
Configure menu, with the System Setup choices for Copy displayed. This
is the same screen that is displayed by pressing the Configure button,
then System Setup, and then Copy.
AM700 Audio Measurement Set Programmer Manual
Getting Started
In this screen you may set the following copy functions:
Copy output format
Copy destination
File name when File is the selected copy destination
After setting copy options, touch the Accept Changes soft key to save your
selections, exit the Copy Configuration screen, and return to the measurement
display .
Figure 1–6: The copy configuration menu
Delete all copies from the spooler by pressing and holding the copy button to
display the Copy Configuration menu. Then touch the Cancel Pending Hardcopy
soft key.
AM700 Audio Measurement Set Programmer Manual
1–15
Getting Started
Screen dumps print when you press the Copybutton. The image currently on the
screen is printed. Graphic displays are printed only when the printer port is
formatted for a graphics printer.
Copy Formats
Copy
Destination
The AM700 supports the following printer and hard-copy types:
PostScript Image
HP DeskJet
Epson (24 pin)
T ag Image File Format (TIFF)
Interleaf Image
When the Copy Format is either PostScript or TIFF the Copy Style may be set to
Color.
Printouts are spooled to the currently selected printer port, which may be one of the
following:
GPIB
COM 0 or COM 1 (RS-232)
File on floppy disk
File in internal nonvolatile file system
None (This choice disables hard copy output.)
When the Copy Destination is set to File, the Output File selection is active. This
choice brings up a file browser, shown in Figure 1–7, to let you select or name the
output file name for the hard copy. You may name a file by touching the Filename
soft key. This displays a keyboard to type in the new file name. Hard copy files may
be sent directly to the floppy disk for later printing. A limited number of screen
dumps may be stored in NVRAM for later transfer to a floppy disk. The available
memory in the internal NVRAM of the AM700 depends on how much of the
memory is used for other user files.
1–16
AM700 Audio Measurement Set Programmer Manual
Getting Started
Figure 1–7: Hard Copy output file selector
Copy Styles
This controls the choice of the color output for PostScript and TIFF formatted files.
When set to Color, printer output will be color formatted. If a copy format other
than PostScript or TIFF is used, the Color state is ignored, and the file is output as
monochrome (gray scale) only.
AM700 SCPI Control Model
The AM700 functional areas are divided as to task to perform. In a like manner
SCPI commands are organized to command the task required in each functional
area. The AM700 is logically divided between its hardware functions needed to
acquire signals for processing and the display of the results and its software
functions that do the signal processing needed to produce the measurement results.
The measurement results in most cases, consist of a display trace of the acquired
AM700 Audio Measurement Set Programmer Manual
1–17
Getting Started
data after processing and numerical values of key features of a measurement.
Examples of display numerical value are the amplitude at a frequency, the frequency
at a cursor location, the THD + N, etc.
An illustration (see Figure 1–8) of how the AM700 is modeled for SCPI control is a
useful start in determining which SCPI system and subsystem commands are used to
control the AM700 functions. After that connection is made, the actual SCPI
commands required to perform a measurement task may be developed.
Input signals
Figure 1–8: AM700 SCPI systems for measurements
AM700 Analog Signal Path
In the AM700, the hardware of the analog signal path is organized in functional
blocks. These blocks are assigned SCPI System commands related to the functions
to be done as shown in Figure 1–9. Signal Routing is shown in Figure 1–10.
ROUTe
INPut
SENse
CALCulate
TRACe
Signal routing only;
no processing
Analog processing
Conversion to digital
Measurements
T o display
1–18
AM700 Audio Measurement Set Programmer Manual
Acquisition Ch A
Getting Started
ROUTe
INPut
SENse
Select
Impedance
Gain/Attnuation
THD Notch
SelectSelect
High res ADCHigh BW ADC
Decimation
Select
Figure 1–9: Analog hardware SCPI system subsystems
Some of the hardware choices are user selectable depending on the measurement
application in use. Examples of these choices are the channel to be acquired and
whether the measurement will be in High Resolution Mode or in High Bandwidth
Mode. Other hardware choices are made as required by the measurement application
selected by the user.
AM700 Audio Measurement Set Programmer Manual
1–19
Getting Started
SignalRoutingInputSense
Acquisition channel A
Analog A input
generator A
Analog B input
generator B
Front panel XLR
Rear panel BNC
Rear panel optical
Rear panel DSP
Rear panel
reference
ROUTe1
Acquisition channel B
ROUTe2
Digital main
ROUTe3
DSP Port
Digital
reference
INPut1
INPut3
INPut5
INPut6
INPut7
INPut2
INPut4
SENSe1
SENSe2
SENSe3
SENSe4
SENSe5
SENSe6
SENSe7
SENSe8
SENSe9
SENSe10
High RES
High BW
High RES
High BW
A
B
A
B
A
B
CSTR1:FEED ’SENS1’
CSTR2:FEED ’SENS3’
CSTReam1
CSTReam2
T o CALCulate
Digital main
Eye pattern
Figure 1–10: AM700 signal routing to CSTReam
AM700 Signal Selection and Routing
Signals to acquire must be selected and routed to the CALCulate blocks for
measurement. Since the AM700 has multiple input choice for analog and digital
1–20
AM700 Audio Measurement Set Programmer Manual
SENSe11
Getting Started
signals, the routing commands take on suffixes and channel_list numbers to provide
the control needed. Figure 1–10 illustrates the selection paths available in the
AM700.
ROUT e
Subsystem
The ROUT e Subsystem commands are used for switching signals in the input. No
processing is done. T o use the ROUTe commands, selectable routes must have a
numerical assignments.
In the AM700 the route and close suffix numbers are as follows:
ROUTe suffixes:
1Analog acquisition channel A
2Analog acquisition channel B
3AES/EBU digital audio
CLOSe <channel_list> indices:
1Analog input channel A
4Analog generator channel B
6Balanced (FP) digital audio
7Unbalanced (RP) digital audio
8Optical (RP) digital audio
9AES Generator
AM700 Audio Measurement Set Programmer Manual
1–21
Getting Started
Syntax:ROUTe[1|2|3]:CLOSE <channel_list>
or
ROUTe[1|2|3]:CLOSE:STATE?
Only certain closures go with a given route: The acceptable routes and closures are:
rout1:clos 1|3
rout2:clos 2|4
rout3:clos 6|7|8|9
Example:The Close command allows specific individual channels to be closed or
queried. T o select the generator as the signal source for the Analog A input, the
command is:
ROUT1:CLOS 3
The rout2[1|2|3]:close:state? query returns the <channel_list> number
for the designated route. If all the specified channels cannot be closed (trying to
close two channels at the same time if that is not allowed) an execution error is
reported. See the ROUT e Subsystem Command description in Section 3 for
complete information on the route command as used in the AM700.
The Input subsystem commands set the conditions prior to sampling. Here the
choices of input impedance and input range are made. The input choices are also
user selectable from within some measurement applications. The choices of
selecting the filtered output are not is a measurement choice that will be made as
needed by the application. Selections for the notch filter range and use are not
selectable via remote control.
INP3Analog acquisition channel ‘B’
The syntax for the Input commands is as follows:
INPut:RANGe 0.0870 to 173.616
INPUT:IMPedance 150|600|200000
1–22
AM700 Audio Measurement Set Programmer Manual
Getting Started
Range. The AM700 treats attenuation and gain as joined parameters that define the
input range setting. A range window has a dynamic range of approximately 100 dB,
but the location of the range window may be positioned within overall dynamic
range of approximately +44 to –122 dBu. The numeric value in the Range command
is the level at which the input signal will clip (the maximum signal level for the
range window). The default range setting is AUTO. In AUTO, the input signal is
examined and the range window is positioned to produce a useful measurement on
the applied signal. Setting the range to a specified value turns off AUTO.
Syntax:INPUt:RANGe:AUTO <Boolean>|ONCE
INPut:RANGe <numeric_value>
Example:The first of the two following examples turns autoranging on; the second sets
the signal clipping level at +35 dBu.
INPut:RANGe:AUTO ON
INPut:RANge 43
Range:The numerical_value for range is 0.0870 to 173.616 volts in 12, 6 dB steps:
Setting the value for a number that is in between the step settings defaults the range
to the next highest valid range step. For example, if you set it for 2 volts, the actual
setting will be 2.7512 for clipping at approximately 11 dBu.
AM700 Audio Measurement Set Programmer Manual
1–23
Getting Started
IMPedance.
The Input command in the AM700 uses suffixes to designate the input that has the
impedance setting applied. Syntax for the Impedance command is as follows:
Syntax:INPut:IMPedance <numeric_value>
Example:This command sets the input impedance for Analog A to 600 ohms.
INPut1:IMPedance 600
or
inp:imp 600
Range:The input impedance choices are: 150, 600, and 200000 ohms with 200000
being the power on default.
SENSe
Subsystem
Suffixes:SENSe suffixes: 5Subframe ‘A’ digital audio
The SENSe setup commands are used to control some parameters of the digital
audio measurement function, and to query measurements made on the digital
interface. Commands in this subsystem are used to control the acquisition methods
of the AM700. Commands under the :DATA:DAUDio subnode control how digital
audio signals are acquired and queries to determine measurements. The Sense
commands uses the following suffixes to direct the action of the Sense command.
Analog Sense is controlled by the applications as needed to perform the selected
measurements.
Another choice in the Input subsystem is the input impedance setting.
6Subframe ‘B’ digital audio
7DSP port ‘A’
8DSP port ‘B’
9Digital reference ‘A’
10Digital reference ‘B’
11Eye Pattern
A few SENSe commands related to the digital audio signal are the following:
CSTReam commands direct the appropriate Sense output to the measurement
channels. The choices are constrained to appropriate selections by the applications.
The sense choices are fed to the FFT Analyzer calculate blocks by a
CSTReam:FEED command using the following syntax.
CSTReam2:FEED SENSe3
CSTReam1:FEED SENSe5
CSTReam2:FEED SENSe6
or cstr1:feed sens1
etc.
In the first example, cstream1 is fed by the output of sense1, the Analog A
high resolution A/D converter, and cstream2 is fed by sense3, also the high
resolution A/D converter. In example two, the cstreams are fed by the digital
audio channel A and channel B signals.
A number of independent subsystems comprise the CALCulate subsystem. Each of
the subsystems is a sub-block of the CALCulate block. Data flows through the
sub-blocks in serial fashion. The CALCulate block has more than one instance of
some of the sub-blocks. The same named sub-blocks are differentiated by a numeric
suffix. The syntax of the CALCulate subsystem commands are application
dependent. One example of the signal flow in show in Figure 1–11. It illustrates the
FFT CALCulate subsystem.
Suffixes:CALCulate1Trace1 Zoom
CALCulate2Trace2 Zoom
CALCulate3Trace1 Average
CALCulate4Trace2 Average
AM700 Audio Measurement Set Programmer Manual
1–25
Getting Started
HARD WIRE
CSTReam1
CALCulate1
:FEED CSTReam1
FFT Analyzer SCPI Commands.
In the FFT Analyzer, the calculate blocks are
separated by channels and function. Calculate1 is used for the fft zoom functions of
channel 1 and is fed by the CSTReam1 feed. Calculate2 is also used for the fft zoom
functions, but for channel 2. It is fed by the CSTReam2 feed where the feeds are one
of the SENSe signals. Calculate3 and Calculate4 control the averaging commands of
the FFT Analyzer. As with calc1 and calc2 there are two channels, and calc3
controls the averaging on channel 1 while calc4 controls the averaging on channel 2.
CALCulate1:
CALCulate1
:TRANsform
:FREQuency
:STARt <numeric_value>
:CENTer
CALCulate2:
CALCulate3:
CALCulate4:
CALCulate5:
LogZoom FFTAveraging
CALCulate6:
TRACe1:DATA?
TRACe2:DATA?
HARD WIRE
CSTReam2
CALCulate2
:FEED CSTReam2
Figure 1–11: FFT CALCulate subsystem block
1–26
LogZoom FFTAveraging
CALCulate4
:AVERage
:COUNt <numeric_value>
:AVERage
STATe ON|OFF
AVERage?
AM700 Audio Measurement Set Programmer Manual
The FFT Analyzer application also contains the Multitone measurement calculate
blocks. A special SCPI command switches the FFT Analyzer between the two
functions as shown in Figure 1–12. The calculate block results are given different
trace names. The trace names for the FFT calculate block results are found using the
TRACe:CAT? command. The reply to the query is application specific and returns
the names for the Audio Analyzer traces when that application is running.
Measurement
Input 1
CMODe:FFT FFT|MTONe
CSTReam1
CALCulate FFT
CALCulate
MULTITONE
Result1
Result2
Result3
Result4
Result9
Result10
Result11
Result12
TRACe:CAT?
TRACe:DATA? FFTMAG_1
Getting Started
DISPlay
Measurement
Input 2
Result5
Result6
CALCulate FFT
CSTReam2
CALCulate
MULTITONE
Result7
Result8
Result13
Result14
Result15
Result16
Figure 1–12: Switching Between FFT and Multitone
AM700 Audio Measurement Set Programmer Manual
1–27
Getting Started
AMEasure
Subsystem
Suffixes:AME1MEAS 1
The AMEasure subsystem provide commands that set up the AM700 to perform
selected measurements and to control some parameter settings of applications. The
commands are application specific. The majority of the AMEasure commands are
used for the Audio Analyzer application. These commands include those used to
control settling time, command regulation mode, and select the measurements to be
done by the Audio Analyzer.
AME2MEAS 2
AME3MEAS 3
AME4MEAS 4
FFT and the AMEasure Subsystem. FFT supports 5 separate measurements. They
are as follows:
AMEasure1: FFT on channel 1
AMEasure2: FFT on channel 2
AMEasure3: Configurable Multitone
AMEasure4: Configurable Multitone
AMEasure5: Configurable Multitone
These measurements ‘assignments are described by the the AME:MODE command.
FFT implements AME:MODE, with the following initial values for each suffix
combination:
The trace subsystem contains measurement results for display and remote query.
Trace queries are used to return the measurement data held in a trace. Different
AM700 Audio Measurement Set Programmer Manual
traces are selected by trace name; not suffixes. Trace commands are also application
specific and will change with the Instrument selection.
A useful query in the Trace subsystem is one that returns the names of the defined
traces.
Query:TRACe:CATalog?
or
trac:cat?
If there are no named traces, a single empty string is returned. When multiple traces
are defined, the names are returned in a comma separated list of trace_name strings.
A listing of the possible trace names by application is provided in the TRACe
subsystem commands in AM700 SCPI Commands, Section 3.
Getting Started
DISPlay
Subsystem
SYSTem
Subsystem
The display commands control the number and type of displays that are available
for a running application. The adjustments available in the DISPlay subsystem
include controlling display brightness, turning on and off view windows (graphs,
text, and generator control panel), enabling and positioning cursors, entering text in
a text view window (dialog box), assigning X- and Y-axis scales, and switching the
graphical plotting methods (point-to-point, linear or logarithmic). The complete set
of commands for the DISPlay subsystem are given in AM700 SCPI Commands,
Section 3.
Windows 1 through n specify the view windows in the application. Presently, there
are four graphical displays, WIN1 through WIN4, the Real Time measurement
readouts, WIN5, the Generator Status display, WIN60, the notifier displays,
WIN98, and a text dialog box, WIN99.
Status, ID, errors, and other required interface type operations related to running the
AM700 remotely are included in the SYST em commands. A following query of the
system commands is very useful:
SYSTem:ERRor?
This query returns error messages from the error message stack until all messages
have been read. If no error exists, it returns “0, NO ERROR.”
AM700 Audio Measurement Set Programmer Manual
1–29
Getting Started
Also found in the system commands are the ones used for setting the communications parameters for RS-232 communications (baud rate, data bits, and parity) and
the GPIB address and the following commands for setting and querying the internal
clock of the AM700:
SYST:TIME?
SYST:DATE?
ST ATus
Subsystem
INSTrument
Subsystem
Usage:Commands in this subsystem are used to switch between AM700 applications
The ST ATus subsystem controls the status-reporting structures of the AM700. These
structures conform to the IEEE 488.2 specification. The different structures may be
looked at a set of registers: these are a condition register, an event register, an enable
register, and negative and positive transition filters. The AM700 is multiple logical
instruments and provides for the QUEStionable and OPERation registers. These
registers are further subdivided into other groupings as follows:
There is a queue for status. The queue provides a human readable record of
instrument events. A programmer may individually enable events into the queue.
Within the AM700 there are multiple logical instruments. The INSTrument
subsystem commands provide the controls and queries needed to switch instruments
and the find out what the name, number, or short form name.
either by name or number. Several query commands are used to return the
names and application numbers. These are the several versions of catalog
queries. The catalog queries, INST:CAT, INST:CAT:FULL, INST:LCAT, and
INST:LCAT:FULL all return comma separated list of the application name
strings. Instruments are selectable by number, short name, and long name.
1–30
AM700 Audio Measurement Set Programmer Manual
Getting Started
Syntax:INST:NSEL <app_number>
Query:INST:NSEL? returns the number of the selected application.
Syntax:INST:SEL <app_name>
Query:INST:SEL? returns a short form name for the selected application.
Syntax:INST:LSEL app_descriptive_name
Query:INST:LSEL? returns a long descriptive name of the selected application.
The Mass Memory subsystem behavior in the AM700 is very similar to to the
documented SCPI behavior. One major divergence form standard SCPI is the
absence of msus (mass storage unit specifier) support in the AM700. The
AM700 allows an optional mass storage unit specifier with any filename given to
the MMEMory commands. The syntax of the file name is:
<[device:]{/path_name/path_name/}<file_name>
The device portion is optional.“device” can be one of “rom”, “nvram”, or “dos”.
Once past the device specification, the name looks pretty much like a UNIX file
name. Slashes separate the path-name components.
Mass MEMory provides mass storage capabilities for the AM700. Mass storage is
either internal or external and the AM700 supports both.
The CLOSe, FEED, NAME, and OPEN commands are used to stream data from
anywhere in the data flow into a file for saving HCOPy output.
Mass storage media may be formatted in one of a number of standard formats. The
AM700 does not support the SCPI mass storage unit specifier <msus>.
1–31
Getting Started
AM700 File Structure.
and DOS logical directories. Under those, other directories or files may exist.
Certain directories are accessible by the user for storage use or information.
The upper level of the AM700 files comprise ROM, NVRAM,
File Names. The <file_name> parameter in the MMEMory subsystem is a string.
The contents of the string are dependent on the needs of the format of the mass
storage media. In particular, the file name may contain / for specifying sub-directories.. File names may be absolute, rooted, or relative. Absolute file names use the
complete name with device and total path to the file. Rooted file names use the path
within a designated device and may be used after changing directory to that device.
Relative file names are assumed to be in the current working directory.
Note that this syntax places some restrictions on the <file_name> (for example,
commas are not allowed).
The AM700 allows an optional mass storage unit specifier (a logical directory
name) with any file name given to the MMEMory commands. The syntax of the file
name is:
The device and path portions are optional and not needed if the file name is in the
current working directory. “device” can be one of “rom”, “nvram”, or “dos”. Legal
dos file names are permitted. That is a file name of eight characters maximum
length followed by a file extension up to three characters in length. Filenames are
not case sensitive and must be single quoted in the SCPI commands. An example is:
MMEM:DEL nvram:/function/usrtone1.ton
Moving Between Directories. Changing directories is done using the MMEMe-
T o list the files in a directory use the MMEMemory:CATalog? query. First change
directory to the one you are interested in, and then cat the directory.
MMEM:CDIR nvram:/function or
MMEM:CDIR dos:/
MMEM:CAT?
This returns a comma separated list of the directories and files in the directory and
the number of bytes they contain.
Copy a dos file from a floppy disk into the nvram function file using the MMEMe-
The PROGram subsystem as implemented in the AM700 is for the selection and
running of functions. These commands provide features needed to generate and
control one or more user-programmed tasks in the AM700. Functions are files in
T cl programming language permanently included in the “rom:/functions” directory
and any user generated files in the “nvram:/functions” directory. The function names
are the file names found in those two directories.
Function programs may be loaded either using the DOS file transfer capabilities of
the MMEMory subsystem or using the PROGram subsystem commands for
unloading via the GPIB interface. Function programs loaded using the GPIB
interface must be formatted as arbitrary block program data. Function programs may
be loaded from a floppy disk through the DOS interface using the file browser
screens called up when the front panel Storage button is pressed. Refer the Function
information in the Examples section for more information on writing and running
functions.
Selection of the generator modes and controlling the output states is done using the
special commands of the GCONtrol subsystem. Signal selection is done using the
SOURce commands. See the block diagram in Figure 1–13.
1–33
Getting Started
GCONtrol MODE Commands. The following commands control the generator
signal source. The first sets either the high resolution generator or the high
bandwidth generator for the analog signal. The second determines whether the
digital mode signal is output from the digital main generator (AES) or the digital
signal processor (DSP).
signal selections from the AM700 generator. The commands are divided between
those used to control the digital generator and those used to control the analog
generator. SOURce suffixes are used to provide the necessary identification.
Suffixes:SOURce1 is analog generator HR A
SOURce2 is analog generator HR B
SOURce3 is analog generator HB A
SOURce4 is analog generator HB B
SOURce5 is digital generator A
SOURce6 is digital generator B
SOURce7 is DSP A
SOURce8 is DSP B
The generator output for Analog high resolution may be different signals on each
channel. For high bandwidth, both channels output either the same signal or either
output may be set to send silence.
Setting the type of signal output wanted from the generator is done using commands
of the following syntax:
where each of the shape parameters is a different signal type available from the
generator.
Commands in the source subsystem control the
1–36
AM700 Audio Measurement Set Programmer Manual
SCPI Conformance Information
SCPI Conformance Information
The AM700 commands are based on SCPI VERSION 1994.0.
SCPI Command Subsystems Implemented in the AM700
Table 2–1: SCPI subsystems implemented in the AM700
SubsystemUse in the AM700
CALCulateAveraging and FFT parameters
CALIBrationCalibration start and Conversion Factors
DISPlaySelection and presentation styles for data and
controlling the view windows and cursors
FORMatSets program names to either character or string
data types.
HCOPyFormatting and output of screen dumps.
INPutSelection of input parameters
INSTrumentSelection of Application
MMEMoryAM700 memory commands
OUTPutSelection of output parameters
PROGramControl of the function programs
ROUTeSelection of input routing
SENSeSelection of input processing
SOURceSelection of generator
ST ATusSetting and querying the AM700 status registers
SYSTemControl of the communication parameters,
hardcopy operation, setting the clock
TRACeQuerying the displayed traces for name, number of
points, and trace data
AM700 Audio Measurement Set Programmer Manual
2–1
SCPI Conformance Information
Table 2–1: SCPI subsystems implemented in the AM700 (cont.)
SubsystemUse in the AM700
TRIGgerStarting and stopping the sweep
UNITSelection of units for input or output of certain
Table 2–2: New command subsystems implemented in the AM700
SubsystemUse in the AM700
AMEasurementControls the measurement setups for Audio
CMODeControls selection of modes within an application
CSTReamDirects the two measurement channels into the
GCONtrolControls the Audio Generator
parameters. Trace data does not follow units.
Analyzer, FFT Analyzer, Digital Interface Tester,
and the Audio Monitor.
CALC blocks.
2–2
AM700 Audio Measurement Set Programmer Manual
SCPI Background Information
Reference: Standard Command for Programmable Instruments, SCPI 1994.
Instruments that conform to the 1993 SCPI standard will be able to meet the
requirements of IEEE Std. 488.1-1987 Standard Digital Interface for Programmable
Instrumentation and IEEE Std. 488.2-1987 Codes, Formats and Common Commands
For Use With IEEE Std. 488.1-1987. Conformance to the standards just mentioned
is not required in recognition that some instruments use hardware interfaces other
than IEEE 488.1-1987, but SCPI is based on the concepts and terminology used by
those standards.
SCPI Conformance Information
SCPI Goal
SCPI
Compliance
Criteria
SCPI is not a programming language, it is a standard definition for instrument
commands, parameters, data, and status. SCPI is intended to reduce the program
development time for programmable Automatic T est Equipment. This is accomplished by providing a consistent programming environment for instrument control
and data usage. Program messages, instrument responses, and data formats across all
conforming SCPI instruments are defined to be common.
SCPI program commands and parameters are sent from a controller to a SCPI
instrument using IEEE 488.1, VXIbus, RS-232C, or any other recognized interface.
SCPI is layered on top of the hardware-independent portion of the controller-toinstrument interface.
SCPI instruments are very flexible in accepting a range of commands and parameter
formats, and instrument responses back to the controller can be either data or status
information. Data information can be formatted to be device- and measurementindependent.
All SCPI instruments conform to the specifications for devices in IEEE 488.2,
except that certain requirements of that standard are not required when an
instrument does not implement an IEEE 488.1 interface. Additionally, a SCPI
instrument can parse <compound command program header> and <compound query
program header> to handle the tree-structured commands in SCPI.
AM700 Audio Measurement Set Programmer Manual
2–3
SCPI Conformance Information
SCPI
References
The following is a list of reference documents related to standards tested by the
AM700 Audio T est Set
ANSI S1.4
ANSI X3.4-1977, American National Standard Code for Information
Interchange; ISO Std. 646-1983, ISO 7-bit Coded Character Set for Information
Interchange
ANSI X3.42-1975, American National Standard Representation of Numeric
Values in Character Strings for Information Interchange; ISO Std. 6093-1985,
Representation of Numeric Values in Character Strings for Information
Interchange
ANSI/IEEE Std 181-1977, IEEE Standard on Pulse Measurement and
Analysis by Objective Techniques
ANSI/IEEE Std 194-1977, IEEE Standard Pulse Terms and Definitions
ANSI/IEEE Std. 260-1978, An American National Standard IEEE Standard
Letter Symbols for Units of Measurement (SI Units, Customary Inch-Pounds
Units, and Certain Other Units); ISO Std. 1000-1981, SI Units and Recommendations for the Use of Their Multiples and Certain Other Units
ANSI/IEEE Std 488.1-1987, IEEE Standard Digital Interface for Program-
mable Instrumentation
2–4
ANSI/IEEE Std 488.2-1992, IEEE Standard Codes, Formats, Protocols, and
Common Commands for use with ANSI/IEEE Std 488.1-1987
ANSI/IEEE Std 754-1985, IEEE Standard for Binary Floating-Point
Arithmetic
Bell Telephone “Per BTSM 41004”
CCIR Recommendation 468-2
CCITT Recommendation P53
Dolby Labs Bulletin No 19/4
Fields and Waves in Communication Electronics, Ramo, Whinnery, and Van
Duzer
AM700 Audio Measurement Set Programmer Manual
SCPI Conformance Information
IEC Recommendation 179
IEEE Micro, Volume 8, Number 4, August, 1988, pp 62-76
ISO Std, 2955-1983, Information processing-Representation of SI and other
units in systems with limited character sets
On the Use of Windows for Harmonic Analysis with the Discrete Fourier
Transform, F.J. Harris, Proc. of the IEEE, Vol 66-1, January, 1978, pp 51-83
Standard Commands for Programmable Instruments (SCPI), Version 1993.0,
February, 1993. SCPI Consortium, 8380 Hercules Drive, Suite P3, La Mesa, CA
91942.
VXI Consortium INC, VMEbus Extensions for Instrumentation Systems
Specification, Revision 1.3
TCL and the Tk Toolkit, John K. Ousterhout:Addison-Wesley Publishing Co.
1994.
AM700 Audio Measurement Set Programmer Manual
2–5
SCPI Conformance Information
2–6
AM700 Audio Measurement Set Programmer Manual
AM700 SCPI Commands
AM700 SCPI Commands
The AM700 is a multi-function measurement tool. Many commands are specific to
the needs of the measurement function in use, and, as needed, the various SCPI
commands will have multiple subsets.
IEEE Mandated Commands
All SCPI instruments implement all the common commands declared mandatory by
IEEE 488.2. These are the following:
Table 3–1: IEEE mandated commands
MnemonicName488.2 Section
*CLSClear Status Command10.3
*ESEStandard Event Status Enable Command10.10
*ESE?Standard Event Status Enable Query10.11
*ESR?Standard Event Status Register Query10.12
*IDN?Identification Query10.14
*OPCOperation Complete Command10.18
*OPC?Operation Complete Query10.19
*RSTReset Operation10.32
*SREService Request Enable Command10.34
*SRE?Service Request Enable Query10.35
*STB?Read Status Byte Query10.36
*TST?Self–Test Query (A self–test is NOT done)10.38
*WAIWait–to–Continue Command10.39
The optional commands described by IEEE Std 488.2 are not required by SCPI.
AM700 Audio Measurement Set Programmer Manual
3–1
AM700 SCPI Commands
Required Commands
The following commands are required in all SCPI instruments:
All other commands in the SCPI “Command Descriptions” are considered optional
in that they depend on the capabilities of the SCPI instrument. Commands that are
used will be implemented exactly as specified by using the SCPI defined commands. Certain commands, if used, require that other commands also be implemented. If a command is implemented where the instrument will not support all the SCPI
3–2
AM700 Audio Measurement Set Programmer Manual
AM700 SCPI Commands
alternative parameter values, a subset may be used. If the instrument does not
support an alternative value of the complete set, it may generate an error on receipt.
However, an instrument must handle all of the parameters in a SCPI command set
even if an alternative does not apply to the instrument’s capabilities.
Table 3–3: SCPI command syntax symbols
SymbolsDescription
[ ]Encloses a set of variables that are selectable or one or more parameters
that are optional when controlling the instrument. Omitting the optional
element causes the default action to occur.
{ }Encloses one or more parameters than may be included zero or more
times.
?Indicates a query by appending to the last keyword in a command. Not all
commands have a query, and some commands are only queries.
|May be read as “or” and is used to separate alternative parameter options.
< >Encloses a SCPI–defined parameter.
:Separates elements of a SCPI command.
;Separates SCPI commands in a command list.
,Separates arguments in a SCPI argument list.
( )Indicates a range of suffixes available for a SCPI command.
A query is formed by appending a question mark (?) to the last keyword in a
command. Not all commands have a query form, and some commands exist only as
a query.
The AM700 accepts only the exact short and the exact long forms. Sending a header
that is not either causes an error to be generated. In the following commands, the
CAPITAL letters indicate the short form mnemonic that may be used to reduce the
typing required. The AM700 parser accepts either uppercase or lowercase letters; it
is not case sensitive.
In the listing of SCPI commands for the AM700, descriptive headings are used to
divide the information into more easily identified parts. Those headings and their
content is shown here to aid in interpreting the commands. When a heading does not
apply it is omitted to save space and avoid the need to read such things as “No query
at this level” and “No *RST action or event.”
ROOT:SUBSystem:SUBSystem:COMMand The complete path for a command is given
here.
Usage:What the command does and amplifying information is provided in this
heading.
Suffixes:If commands are identified by the addition of suffix numbers, the meaning of
those numbers is provided in this heading.
Parameters: If the command arguments are data handles, the ones used with the command
are provided in this heading.
Default:Where there are default choices or actions, they are given in this heading.
Range:With a <numeric_value> argument, the number range is given in this heading.
Units:When a <numeric_value> argument has units they are given in this heading.
Resolution: The step size of varying the <numeric_value> is given in this this heading
Query:When an command has a valid query, that query and its expected return is
provided in this heading.
Response:When there is a range of responses to a query, the list is given in this heading.
3–4
AM700 Audio Measurement Set Programmer Manual
AM700 SCPI Commands
Example:An example of the command usage is provided here. Sometimes the short form
of the keywords will be used and sometimes lowercase characters are used to
remind you that these forms are valid.
Explanation
of Example:
Error:Errors actions that may occur are given in this heading. Common errors such as
Coupled
Commands:
*RST:If there is a state change to an argument as a result of sending the *RST
When the example is not self explanatory, additional explanation is provided in
this heading.
mistyping the command are usually not included in this heading.
When additional commands are linked to the possible action of a command is
ways that are not obvious, they are given here.
command to the AM700, that is given in this heading.
AM700 Audio Measurement Set Programmer Manual
3–5
AM700 SCPI Commands
3–6
AM700 Audio Measurement Set Programmer Manual
AMEasure Subsystem (Audio Analyzer)
AMEasure Subsystem
The AMEasure subsystem provide commands that quickly set up the AM700 to
perform selected measurements and to control some parameter settings of
applications. The commands are application specific and are divided as such to
make them easier to locate by application. The majority of the AMEasure
commands are used for the Audio Analyzer application.
AMEasure[1–4]:STATe <Boolean>
Parameters: ON|OFF and 1|0
Usage:Enables the AMEasurement for the designated AME.
Suffixes:AME1MEAS 1
AME2MEAS 2
AME3MEAS 3
AME4MEAS 4
Query:AME[1–4]:STAT? returns 0 for off or 1 for on for the designated AME.
*RST:AME[1–4] State ON
AMEasure[1–4]:HISTory <numeric_value>
Parameters: 0 to 4
Usage:Sets the number of traces to be held as history in a display. 0 is no history, and
only the current trace is displayed. A setting of 4 hold four traces as history.
Acquiring another trace past four deletes the oldest trace.
Query:AME[1–4]:HIST? returns the current History setting for the designated AME.
*RST:Sets HIST ory to 0.
AM700 Audio Measurement Set Programmer Manual
3–7
AMEasure Subsystem (Audio Analyzer)
AMEasure[1–5]:MODE <char_data>
Parameters: XY|REGulation|RTDisplay
Usage:Sets or queries the operation mode of the designated AME. AME[1–4] may not
be set to RTD. AME5 may only be set to RTD.
Query:AME[1–5]:MODE? returns the operation mode of the designated AME.
*RST:AME[1–4]XY
AME5RTD
AMEasure[1–4]:REFerence:CLEar
Usage:Command only. Clears the reference trace for the given measurement.
AMEasure[1–4]:REFerence:FILE[:NAME] ’<file_name>’
Usage:Sets or returns the name of the file that is used by the LOAD and STORE
commands, to handle reference data. The file name includes the path. This
value is saved when the state is saved. However, reference data is not
automatically loaded when the instrument is started.
Example:AME:REF:FIL:NAME ’nvram:ref’ names the file “ref” in the “nvram”
directory as the file to be used by the LOAD and STORE commands for
reference data.
Query:AMEasure[1–4]:REFerence:FILE[:NAME]? returns the name of the
file designated to be used by the reference LOAD and STORE commands.
AMEasure[1–4]:REFerence:FILE:LOAD
Usage:Command only. Loads the reference trace from the file name that was
previously set by the AMEasure[1–4]:REFerence:FILE[:NAME] command.
3–8
AM700 Audio Measurement Set Programmer Manual
AMEasure Subsystem (Audio Analyzer)
AMEasure[1–4]:REFerence:FILE:STORe
Usage:Command only. Stores the reference trace to the file name that was previously
set by the AMEasure[1–4]:REFerence:FILE[:NAME] command.
AMEasure[1–4]:REFerence:SET
Usage:Command only used to store or save a reference trace for comparison. The front
trace of the designated AME is copied for use as a reference. If the frontmost
trace is empty, it clears the reference memory. With regards to the measurement, this is the same as pressing the “Set Ref” button on the front panel. The
“reference available” message should appear in the view window when the
reference is set.
AMEasure[1–4]:REFerence:STATe?
Usage:Query only, It returns 1 if, and only if, there is a valid reference for the given
measurement type.
Query:AME[1–4]:REF:STAT? returns 0 for no valid reference or 1 if there is a
valid reference for on for the designated AME.
AMEasure[1–4]:XY:TRACkgen <Boolean>
Usage:Sets or queries the state of TRACkgen for the designated AME in XY mode.
Example:AME1:XY:TRAC ON enables tracking of the generator
Parameters: ON|OFF or 1|0
Query:AME[1–4]:XY:TRAC? returns 0 for tracking disabled or 1 for enabled.
*RST:Sets XY mode Track Generator to tracking enabled.
AM700 Audio Measurement Set Programmer Manual
3–9
AMEasure Subsystem (Audio Analyzer)
AMEasure[1–4]:XY:X:INPut <char_data>
Parameters: CHANnel1|CHANnel2|ANALog1|ANALog2|DIGital1|DIGital2
Usage:Sets or queries the source of the input to the x-axis for the designated AME in
XY mode.
Query:AME[1–4]:XY:X:INP? returns the measurement channel currently
supplying input to the designated AME.
*RST:AME1CHANNEL1
AME2CHANNEL2
AME3CHANNEL1
AME4CHANNEL1
AMEasure[1–4]:REGulation:COUNt <numeric_value>
Usage:Sets or queries the Sweep Count setting of the designated AME for the
regulation mode sweep count.
Range:0 to 10000 counts.
Query:AME[1–4]:REG:COUN? returns the current setting for the regulation mode
sweep.
*RST:Sets count to 1.
AMEasure[1–4]:REGulation:ERRor <numeric_value>
Usage:Sets or queries the Target Error value of the designated AME for regulation
mode operation.
Range:Range of the numeric value depends on the setting of AME:REG:FUNC
<char_data>.
FREQ range = 0 to 81000
LEV range = –97.7815 to 47.0104
THD range = 0 to 100
3–10
AM700 Audio Measurement Set Programmer Manual
AMEasure Subsystem (Audio Analyzer)
THDN range = 0 to 100
Units:Units of the numeric value depend on the setting of AME:REG:FUNC
<char_data>.
FREQ units = Hz
LEV units = dBu
THD units = %
THD+N units = %
Query:AME:REG:ERR? returns the current setting for the regulation Target Error in
the default units.
*RST:–17.7815 dBu
AMEasure[1–4]:REGulation:FUNCtion <char_data>
Parameters: FREQuency|LEVel|THD|THDN
Usage:Sets or queries the measurement function attached to the REGulation mode
input.
Query:AME:[1–4]:REG:FUNC? returns the currently selected function for the
designated AME.
*RST:Sets AME[1–4] Function to LEVEL
AMEasure[1–4]:REGulation:INPut <char_data>
Parameters: CHANnel1|CHANnel2
Usage:Sets are queries the input source for REGulation mode for the designated AME.
Query:AME[1–4]:REG:INP? returns the input source for the designated AME.
*RST:Sets the AME [1–4] input source to CHANNEL1.
AM700 Audio Measurement Set Programmer Manual
3–11
AMEasure Subsystem (Audio Analyzer)
AMEasure[1–4]:REGulation:TARGet <numeric_data>
Usage:Sets the Target Value for use in regulation mode.
Range:0 to 173.62 V
–97.7815 to 47.0104 dBu
–100 to 44.7920 dBV
Units:Units are set by UNIT:VOLT command. Choices are V, mV, dBu, dBFS, and
dBV
Query:AME[1–4]:REG:TAR? returns the current setting for the regulation Target
Value in the units set by the UNIT:VOLT command.
*RST:Sets the regulation target value to 1.000 volt.
AMEasure[1–4]:REGulation:GENerator <char_data>
Parameters: ANAlog1|ANAlog2|DIGital1|DIGital2
Usage:Sets or queries the generator that will supply the regulation mode signal for the
designated AME.
Query:AME[1–4]:REG:GEN? returns the generator name supplying the regulation
Usage:Sets or queries the settling tolerance setting of the THD measurement for the
designated AME.
Range:0 to 100%
Query:AME[1–4]:SETT:CROS:TOL? returns
*RST:1.000%
AMEasure:SETTled:DELay <numeric_value>
Usage:Sets or queries the amount of delay time after the generator has changed state to
wait before looking for a new data point. This setting is used to accomodate
propagation delay and settling of the device under test. This setting is used in
Regulation mode when the measurement is closed loop (that is when the
measurement is driving the generator).
Range:0 to 100 seconds
Query:AME:SETT:DEL? returns the delay time that will be used when a closed loop
measurement is being done. This is the amount of time that the Audio Analyzer
waits after changing the generator before it begins looking for a new data point.
*RST:Sets the delay time to 0.5 seconds.
AMEasure:SETTled:ENABle <Boolean>
Usage:Sets or queries the state of enabling for settling. When settling is not enabled,
any data received will be plotted. When settling is enabled, the settings for
minimum level, tolerance, resolution, variation, etc. must be met before a data
point is plotted.
Query:AME:SETT:ENAB? returns 1 for enabled or 0 for not enabled.
*RST:Set settling to enabled for all AMEasures.
Usage:Sets or queries the settling tolerance setting of the level difference measurement
for the designated AME.
Range:0 to 100%
Query:AME[:SETT:LDIF:TOL? returns the global tolerance setting for level
difference to be considered settled data.
*RST:1.000%
AM700 Audio Measurement Set Programmer Manual
3–17
AMEasure Subsystem (Audio Analyzer)
AMEasure:SETTled:LEVel:MINimum <numeric_value>
Usage:Sets or queries the minimum amplitude of data to consider in determining if a
signal is being received.
Range: 0 to 173.72 V
(–97.7816 to 47.0104 dBu)
Query:AME:SETT:LEV:MIN? returns the minimum level in volts of data to be
considered in finding a settled data points.
*RST:0.0001 Volt
AMEasure:SETTled:LEVel:RESolution <numeric_value>
Usage:Sets or queries the global settling resolution setting of the level measurement.
Range:0.0100 mV to 173619.99 mV
Query:AME:SETT:LEV:RES? returns the global settingin volts for level resolution
for settled data points.
*RST:0.0050 Volt
AMEasure:SETTled:LEVel:TOLerance <numeric_value>
Usage:Sets or queries the global settling tolerance setting of the level measurement.
Range:0 to 100%
Query:AME:SETT:LEV:TOL? returns the global setting for level tolerance for
Usage:Sets or queries the global settling tolerance setting of the channel separation
measurement.
Range:0 to 100%
Query:AME:SETT:SEP:TOL? returns the global setting of tolerance used for the
separation measurement.
*RST:1.000%
AMEasure:SETTled:THD:RESolution <numeric_value>
Usage:Sets or queries the glopbal settling resolution setting of the total harmonic
distortion measurement.
Range:0 to 100%
Query:AME:SETT:THD:RES? returns the global setting of resolution used for the
THD measurement.
*RST:0.003%
AMEasure:SETTled:THD:TOLerance <numeric_value>
Usage:Sets or queries the glopbal settling tolerance setting of the total harmonic
distortion measurement.
Range:0 to 100%
Query:AME:SETT:THD:TOL? returns the settling tolerance percentage used for the
THD measurement.
*RST:3%
3–20
AM700 Audio Measurement Set Programmer Manual
AMEasure Subsystem (Audio Analyzer)
AMEasure:SETTled:THDN:RESolution <numeric_value>
Usage:Sets or queries the settling resolution setting of the total harmonic distortion
plus noise measurement.
Range:0 to 100%
Query:AME:SETT:THDN:RES? returns the global settling resolution setting of the
THDN measurement.
*RST:0.003%
AMEasure:SETTled:THDN:TOLerance <numeric_value>
Usage:Sets or queries the settling tolerance setting of the THDN measurement for the
designated AME.
Range:0 to 100%
Query:AME:SETT:THDN:TOL? returns the global settling tolerance setting of the
THDN measurement.
*RST:3%
AMEasure:SETTled:TIMeout <numeric_value>
Usage:Sets or queries the settling timeout setting. If a settled data point has not been
found in the set delay time in a closed loop measurement, the generator is
switched to the next step and a the Audio Analyzer looks for a new settled data
point.
Range:0 to 100 seconds
Query:AME:SETT:TIM? returns
*RST:Sets the timeout value to 5.00 seconds.
AM700 Audio Measurement Set Programmer Manual
3–21
AMEasure Subsystem (Audio Analyzer)
AMEasure[1–4]:SETTled:TYPE FLAT:EXPonential
Usage:Sets or queries the settling type selected for the designated AME.
Query:AME[1–4]:SETT:TYPE? returns the selected settling type for the designated
AME.
*RST:Sets the settling type to EXPonential for all AMEasures.
AMEasure:SETTled:VARiation:AMOunt <numeric_value>
Usage:Sets or queries the Variation percentage setting in the AA measurements settling
menu.
Range:0 to 100%
Query:AME:SETT:VAR:AMO? returns variation setting in percentage that will be
used to determine that settling should be restarted. The parameter being
checked for change depends on the setting of the Variation type in the
AME:SETT:VAR:TYPE command.
Usage:Sets or queries the type of variation being looked for to determine if settling
needs to be restarted. The choices are BOTH for both amplitude and frequency,
EITHer for either amplitude or frequency, INDependent for looking only for
independent axis variations, and DEPendent for looking only for dependent axis
variations.
Query:AME:SETT:VAR:TYPE? returns the settling variation type setting for the
designated AME. Responses are DEPENDENT , INDEPENDENT, BOTH,
EITHER as set for the type.
*RST:Sets the settling variation type to independent for all measurements.
3–22
AM700 Audio Measurement Set Programmer Manual
AMEasure Subsystem (Audio Analyzer)
AMEasure[1–4]:SWEep:DIRection RISing|FALLing
Usage:Sets or queries the direction of the sweep being looked for by the AM700.
Query:AME[1–4]:SWE:DIR? returns RISING or FALLING for the setting of sweep
Usage:Sets or queries the amount of frequency change to use to determine that a
frequency sweep is occurring.
Range:0 to 500 Hz
Query:AME[1–4]:SWE:FREQ:DEL? returns the numeric value in Hz or kHz
depending on the setting of UNIT:FREQ Hz|kHz for the designated
measurement.
*RST:Sets Delta to 500 Hz.
AMEasure[1–4]:SWEep:LEVel:DELta <numeric_value>
Usage:Sets or queries the amount of Amplitude change to use to determine that a
voltage sweep is occurring.
Range:0.00 to 173.62 V
0.00 to 17300.00 mV
–97.7816 to 47.014 dBu
–100.00 to 44.7920 dBV
Units:Units of the parameter accepted by the AM700 or reported back by the AM700
depend on the setting of UNIT:VOLT V|mV|dBu|dBV|dBFS.
AM700 Audio Measurement Set Programmer Manual
3–23
AMEasure Subsystem (Audio Analyzer)
NOTE. Numeric values reported back by the AM700 will match the units
set by SCPI, but will not match the displayed values when the front panel
set units and the SCPI set units do not match.
Query:AME[1–4]:SWE:LEV:DEL? returns the numeric value of the minimum level
change that will be used to recognize that a voltage sweep is occuring. The
numeric value reported back matches the units set by SCPI in the UNIT:VOLT
command.
*RST:Set Frequency Min Rise/Fall to 1.
AMEasure[1–4]:SWEep:MODE FREQuency|LEVel
Usage:Sets or queries the type of sweep, frequency or voltage, that will be detected.
Query:AME[1–4]:SWE:MODE? returns FREQUENCY or LEVEL for the setting of
the sweep type detection for the designated measurement.
*RST:Sets sweep detection type to Frequency sweep in all measurements.
AMEasure[1–4]:SWEep:STATe <Boolean>
Parameters: ON|OFF and 1|0
Usage:Sets or queires the state of the AM700 SWEep recognition, ON or OFF
Query:AME[1–4]:SWE:STAT? return 0 for sweep detection disabled or 1 for
enabled in the designated measuement.
*RST:Sets sweep detection to enabled in all measurements.
3–24
AM700 Audio Measurement Set Programmer Manual
AMEasure Subsystem (Audio Analyzer)
AMEasure[1–4]:XY:X:FUNCtion <char_data>
Parameters: FREQuency|LEVel
Usage:Sets or queries the measurement function attached to the x-axis in XY mode.
Query:AME[1–4]:XY:X:FUNC? returns the measurement functions currently
attached to the x-axis of the designated AME in XY mode.
*RST:AME[1–4]FREQUENCY
AMEasure[1–4]:XY:Y:INPut <char_data>
Parameters: CHANnel1|CHANnel2
Usage:Sets or queries the source of the input to the y-axis in XY mode.
Query:AME[1–4]:XY:Y:INP? returns the currently selected input source for the Y
Usage:Sets or queries the measurement function attached to the y-axis of the
designated AME in XY mode.
Query:AME[1–4]:XY:Y:FUNC? returns the measurement function attached to the
y-axis in XY mode.
*RST:AME1LEVEL
AME2LEVEL
AME3LDIFFERENCE
AME4PDIFFERENCE
3–26
AM700 Audio Measurement Set Programmer Manual
AMEasure Subsystem (FFT)
FFT supports 5 separate measurements. They are:
AMEasure1: FFT on channel 1
AMEasure2: FFT on channel 2
AMEasure3: Configurable Multitone
AMEasure4: Configurable Multitone
AMEasure5: Configurable Multitone
These measurements ‘assignments’ are described by the the AME:MODE
command. FFT implements AME:MODE, with the following initial values for each
suffix combination:
The AME:MODE values (and hence, the measurement mode) are not changeable
within FFT. That is to say, the type of multitone measurement made by measurements 3 through 5 can be altered (using AMEasure), but the measurements can not
be configured to make FFT measurements.
Each of the five listed measurements can be individually enabled and disabled. The
command to enable/disable the measurements is:
AME[1–5]:STA T <Boolean>
All five measurements are enabled when FFT starts.
The FFT measurements (measurements 1 and 2) are not configurable from within
the AMEasure subsystem.
The multitone measurements (measurements 3, 4, and 5) are configurable within the
AMEasure subsystem.
AM700 Audio Measurement Set Programmer Manual
3–27
AMEasure Subsystem (FFT)
AMEasure[1–5]:MODE?
Usage:Queries the designated AMEasure to determine what mode it is operating in.
These modes are fixed by design so that AME[1–2] always return FFT and
AME[3–5] always return MTONE.
Query:AME[1–5]:MODE? returns FFT or MTONE depending on the AME queried.
AMEasure[1–5]:STATe <Boolean>
Usage:Turns the designated AMEasure (1 through 5) ON or OFF.
Parameters: ON or OFF and 1 or 0.
Query:AME[1–5]:STAT? returns 1 for on or 0 for off.
*RST:Sets AME[1–5] states on.