Programmer Manual AM700 Audio Measurement Set 070-9001-01 This document applies to firmware version 1.04 and above.
Copyright Tektronix, 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 Technical 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 FAR 52.
Table of Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Manual Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi xxi Getting Started GPIB and RS-232C Remote Operation . . . . . . . . . . . . . . . . . . . . . . . . . . Accessories for Remote Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . Control Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents ROUTe Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INPut Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SENSe Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CSTReam Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CALCulate Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AMEasure Subsystem . . .
Table of Contents CMODe Subsystem (FFT / MTONe Analyzer) . . . . . . . . . . . . . . . . . . . . CMODe Subsystem (SOUNd and DAUDio) . . . . . . . . . . . . . . . . . . . . . . CMODe Subsystem (Trigger) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CSTReam Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DISPlay Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FORMat Subsystem . . . . . . . . . . . . . .
Table of Contents Status Questionable Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status Questionable Input Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status Questionable Input Summary Registers . . . . . . . . . . . . . . . . . . . . STATus:QUEStionable Registers Conditions . . . . . . . . . . . . . . . . . . . . . SOURce Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INSTrument Conditions . . . . . . . .
Table of Contents List of Figures Figure 1–1: AM700 Rear Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–7 Figure 1–2: GPIB Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–7 Figure 1–3: COM1 and COM2 serial ports . . . . . . . . . . . . . . . . . . . . . 1–8 Figure 1–4: Remote contact-closure connector . . . . . . . . . . . . . . . . . . 1–9 Figure 1–5: Configure system setup communicate menu . . . . . . . . . .
Table of Contents vi Table 2–1: SCPI subsystems implemented in the AM700 . . . . . . . . . 2–1 Table 2–2: New command subsystems implemented in the AM700 . 2–2 Table 3–1: IEEE mandated commands . . . . . . . . . . . . . . . . . . . . . . . . 3–1 Table 3–2: SCPI required commands . . . . . . . . . . . . . . . . . . . . . . . . . 3–2 Table 3–3: SCPI command syntax symbols . . . . . . . . . . . . . . . . . . . . 3–3 Table 3–4: Summary of STATus:OPERation . . . . . . . . . . . . . . . . . . .
Table of Contents SCPI Command List ROOT:SUBSystem:SUBSystem:COMMand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–4 AMEasure[1–4]:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–7 AMEasure[1–4]:HISTory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–7 AMEasure[1–5]:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents viii AMEasure:SETTled:FREQuency:RESolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–16 AMEasure:SETTled:FREQuency:TOLerance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–16 AMEasure:SETTled:IMD:RESolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–16 AMEasure:SETTled:IMD:TOLerance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents AMEasure[1–5]:MODE? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–28 AMEasure[1–5]:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–28 AMEasure[3–5]:MTONe:FUNCtion LEVel|CROSstalk|LDIFference|PDIFference|MDIStortion . . . . . . . . . . . . . . . . . . . . . . 3–28 AMEasure[3–5]:MTONe:INPut CHANnel1|CHANnel2 . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents x CMODe:FFT FFT|MTONe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–45 CMODe:FFT:MTONe[1|2]:AVECtor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–45 CMODe:FFT:MTONe[1|2]:FILE:NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–45 CMODe:FFT:MTONe[1|2]:FVECtor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents DISPlay:WINDow98:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–57 DISPlay:WINDow98:STATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–57 DISPlay:WINDow99:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–57 DISPlay:WINDow99:TEXT[:DATA] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents xii GCONtrol:ANALog:MODE HRESolution|HBW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–69 GCONtrol:DIGital:MODE AES|DSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–70 GCONtrol:OUTPut:STATe ON|OFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–70 HCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents MMEMory:COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–85 MMEMemory:DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–85 MMEMory:DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–86 MMEMory:FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents xiv PROGram:SELected:DEFine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–98 PROGram:SELected:DELete:SELected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–98 PROGram:SELected:DELete:ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–98 PROGram[SELected]:LABel? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents SOURce[5|6]:DAUDio:UBITs:MODE NULL|FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–110 SOURce[5|6]:DAUDio:UBITs:FILE:NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–110 SOURce[5|6]:DAUDio:UBITs:FILE:LNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–111 SOURce[5–8]:DITHer:TYPE RECTangular|TRIangular|NONE . . . . . . . . . . . . . . . . . . . . . 3–111 SOURce[1–8]:FOLLow[:STATe] . . . . . . . . . . . .
Table of Contents xvi SOURce[1–8]:FUNCtion:SHApe TPOLarity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–126 SOURce[1–8]:FUNCtion:SHApe USER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–126 SOURce[1–8]:FUNCtion:SHApe MTONe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–126 SOURce[1–8]:LIST:DIRection:FORward|BACKward . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–128 SOURce[1–8]:LIST:DWELl .
Table of Contents STATus:QUEue:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–143 STATus:OPERation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–144 STATus:OPERation[:EVENt]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–145 STATus:OPERation:CONDition? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents xviii STATus:QUEStionable:NTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–155 STATus:QUEStionable:PTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–155 STATus:QUEStionable:INPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–157 STATus:QUEStionable:INPut[1|3|5|6|7][:EVENt]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents STATus:QUEStionable:SOURce[1–8]:NTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–166 STATus:QUEStionable:SOURce[1–8]:MAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–166 STATus:QUEStionable:SOURce[1–8]:SUMMary[:EVENt]? . . . . . . . . . . . . . . . . . . . . . . . . 3–167 STATus:QUEStionable:SOURce[1–8]:SUMMary:CONDition? . . . . . . . . . . . . . . . . . . . . . . 3–167 STATus:QUEStionable:SOURce[1–8]:SUMMary:ENABle . . .
Table of Contents xx TRACe:DATA:VALue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–180 TRACe[:DATA]:VALue? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–180 TRACe:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–180 STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface 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.
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.
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 Tcl. The Tcl commands permit a programmer to build conditional tests and create their own functions. The Tcl interpreter in the AM700 allows imbedding SCPI commands in a function program using the “scpi” Tcl command.
Getting Started Table 1–1: IEEE 488.1 interface functions implemented in the AM700 IEEE 488.
Getting Started Table 1–2: IEEE 488.2 status reporting commands (cont.) Command Name Function *ESE? Standard Event Status Enable Query Queries the contents of the Standard Event Status Enable Register. *ESR? Standard Event Status Register Query Queries the contents of the Standard Event Status Register. Reading the register clears it. *SRE NRf Service Request Enable Command Sets the Service Request Enable Register bits.
Getting Started Table 1–4: Synchronization commands RS-232C Interface Information Command Name Function *OPC Operation Complete Command Causes the AM700 to Generate the operation complete message in the Standard Event Status Register when all pending selected device operations have been finished. *OPC? Operation Complete Query Places an ASCII “1” in the AM700’s output queue when all pending selected device operations have been finished.
Getting Started Table 1–5: Serial port protocol (cont.
Getting Started Rear Panel I/O Connectors Figure 1–1: AM700 Rear Panel 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).
Getting Started COM1 and COM2 Serial Ports 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 1 COM 2 Figure 1–3: COM1 and COM2 serial ports REMOTE Connector 1–8 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.
Getting Started REMOTE 1 2 6 3 4 7 8 5 9 DB-9 FEMALE REMOTE CONNECTOR Pin 1 Pins 2, 4, 6, 8 Pin 3 to Pin 9 Pin 5 to Pin 9 Pin 7 TTL-Level Input Ground Normally Open Normally Closed +5 V Output @ 5 mA Figure 1–4: Remote contact-closure connector Table 1–6: Remote connector pins Remote connector Control Type Contact Closure Connector DB-9, female Pin 1, TTL Level Input 0 to +5V, 100 mA. Input is protected.
Getting Started Table 1–6: Remote connector pins (cont.) Remote connector Pin 3 to Pin 9, Contact Closure 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. Pin 5 to Pin 9 Reserved, normally-closed contact Pin 7, +5 V Output +5 V @ 5 mA. This output is provided to drive the TTL-Level input through an external contactclosure relay.
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 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.
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.
Getting Started Table 1–8: Apple LaserWriter connections ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ Connecting an HP LaserJet, DeskJet, or ThinkJet Male DB-25 connector pin number (Apple LaserWriter end) Female DB-9 connector pin number (AM700 end) 1 (shield GND) shield GND 3 (RXD) 3 (TXD) 2 (TXD) 2 (RXD) 5 (CTS) 7 (RTS) 4 (
Getting Started ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁ ÁÁÁÁÁÁÁÁÁÁÁÁÁ Table 1–9: HP LaserJet cable connections Connecting an ASCII Printer Male DB-25 connector pin number (HP LaserJet end) Female DB-9 connector pin number (AM700 end) 1 (shield ground) shield ground 3 (RxD) 3 (TXD) 2 (Tx
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.
Getting Started Screen dumps print when you press the Copy button. 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 The AM700 supports the following printer and hard-copy types: PostScript Image HP DeskJet Epson (24 pin) Tag Image File Format (TIFF) Interleaf Image When the Copy Format is either PostScript or TIFF the Copy Style may be set to Color.
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.
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.
Getting Started Acquisition Ch A ROUTe Select Impedance Gain/Attnuation INPut THD Notch Select Select High res ADC High BW ADC SENse 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.
Getting Started Signal Routing Input Sense Acquisition channel A Analog A input generator A ROUTe1 INPut1 SENSe1 INPut2 SENSe2 High RES High BW CSTR1:FEED ’SENS1’ CSTR2:FEED ’SENS3’ CSTReam1 CSTReam2 Acquisition channel B Analog B input generator B ROUTe2 INPut3 SENSe3 INPut4 Front panel XLR Rear panel BNC Rear panel optical Digital main ROUTe3 SENSe4 SENSe5 SENSe7 DSP Port Digital main A B A To CALCulate INPut6 SENSe8 Rear panel reference High BW INPut5 SENSe6 Rear panel DSP H
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. ROUTe Subsystem The ROUTe Subsystem commands are used for switching signals in the input. No processing is done. To use the ROUTe commands, selectable routes must have a numerical assignments.
Getting Started Syntax: ROUTe[1|2|3]:CLOSE 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. To 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 number for the designated route.
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.
Getting Started IMPedance. Another choice in the Input subsystem is the input impedance setting. 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: Example: INPut:IMPedance 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.
Getting Started SENSe[5–8]:DAUDio:INTerface:BWIDth LOW|MEDium|HIGH SENSe[5–8]:DAUDio:INTerface:JGAin NORMal|HIGH CSTReam Subsystem Example: 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.
Getting Started 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.
Getting Started 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.
Getting Started AMEasure Subsystem Suffixes: 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.
Getting Started 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.
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? STATus Subsystem The STATus subsystem controls the status-reporting structures of the AM700. These structures conform to the IEEE 488.2 specification.
Getting Started Syntax: Query: INST:NSEL INST:NSEL? returns the number of the selected application. Syntax: Query: INST:SEL INST:SEL? returns a short form name for the selected application. Syntax: Query: INST:LSEL app_descriptive_name INST:LSEL? returns a long descriptive name of the selected application.
Getting Started AM700 File Structure. The upper level of the AM700 files comprise ROM, NVRAM, and DOS logical directories. Under those, other directories or files may exist. Certain directories are accessible by the user for storage use or information. File Names. The 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..
Getting Started MMEM:CDIR .. To 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.
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).
Getting Started GCONtrol:ANALog:MODE HRes|HBW GCONtrol:OUTPut:STATe ON|OFF OUTPUT CONNECTORS SOURce1 high resolution high bandwidth OUTPut1 Analog generator Channel A SOURce2 OUTPut2 SOURce3 Analog generator Channel B SOURce4 Analog Generator GCONtrol:DIGItal:MODE AES|DSP Digital Audio Generator SOURce5 digital main digital DSP digital reference OUTPut3 SOURce6 Digital generator channels A and B SOURce7 OUTPut4 DSP generator channels A and B SOURce8 SOURce9 OUTPut5 Digital reference
Getting Started SOURce Subsystem Commands. Commands in the source subsystem control the 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.
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 Subsystem Use in the AM700 CALCulate Averaging and FFT parameters CALIBration Calibration start and Conversion Factors DISPlay Selection and presentation styles for data and controlling the view windows and cursors FORMat Sets program names to either character or string data types.
SCPI Conformance Information Table 2–1: SCPI subsystems implemented in the AM700 (cont.) Subsystem Use in the AM700 TRIGger Starting and stopping the sweep UNIT Selection of units for input or output of certain parameters. Trace data does not follow units. Table 2–2: New command subsystems implemented in the AM700 2–2 Subsystem Use in the AM700 AMEasurement Controls the measurement setups for Audio Analyzer, FFT Analyzer, Digital Interface Tester, and the Audio Monitor.
SCPI Conformance Information 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.
SCPI Conformance Information SCPI References The following is a list of reference documents related to standards tested by the AM700 Audio Test 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.
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 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 Mnemonic Name 488.2 Section *CLS Clear Status Command 10.3 *ESE Standard Event Status Enable Command 10.
AM700 SCPI Commands Required Commands The following commands are required in all SCPI instruments: Table 3–2: SCPI required commands Mnemonic Command description section (SCPI Std) Syntax and style section (SCPI Std) :SYSTem :ERRor? 19.7 :VERSion? 19.
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.
AM700 SCPI Commands Example: CALC:AVER:COUN 32 calc:aver:coun 32 calculate:average:count 32 CALCULATE:AVERAGE:COUNT 32 Command Notation in this Manual 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.
AM700 SCPI Commands Example: Explanation of Example: Error: Coupled Commands: *RST: 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. When the example is not self explanatory, additional explanation is provided in this heading. Errors actions that may occur are given in this heading.
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 Subsystem (Audio Analyzer) AMEasure[1–5]:MODE 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] AME5 XY RTD AMEasure[1–4]:REFerence:CLEar Usage: Command only. Clears the reference trace for the given measurement.
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.
AMEasure Subsystem (Audio Analyzer) AMEasure[1–4]:XY:X:INPut 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.
AMEasure Subsystem (Audio Analyzer) THDN range = 0 to 100 Units: Units of the numeric value depend on the setting of AME:REG:FUNC . 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 Parameters: FREQuency|LEVel|THD|THDN Usage: Sets or queries the measurement function attached to the REGulation mode input.
AMEasure Subsystem (Audio Analyzer) AMEasure[1–4]:REGulation:TARGet 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 Subsystem (Audio Analyzer) AMEasure[1–4]:REGulation:FREQuency:MODE Parameters: LINear|LOGarithmic Usage: Sets or queries the stepping mode of the regulation test signal. The steps will be either linearly or logarithmically spaced as selected for the designated AME. Query: AME[1–4]:REG:FREQ:MODE? returns LINEAR or LOGARITHMIC spacing of the regulation sweep steps for the designated AME. *RST: Set mode to LINEAR.
AMEasure Subsystem (Audio Analyzer) AMEasure[1–4]:REGulation:LEVel:LOWer Usage: Sets or queries the lower amplitude setting for the LEVel. Query: AME[1–4]:REG:LEV:LOW? returns the lower amplitude setting used for a regualtion mode voltage sweep for the designated AME. *RST: Sets the Voltage Min level to 0.5000 volt. AMEasure[1–4]:REGulation:LEVel:UPPer Usage: Sets or queries the upper amplitude setting for the Regulation Level. Range: 0.000 to 173.62 V –97.
AMEasure Subsystem (Audio Analyzer) AMEasure:SETTled:CROSstalk:TOLerance 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 Usage: Sets or queries the amount of delay time after the generator has changed state to wait before looking for a new data point.
AMEasure Subsystem (Audio Analyzer) AMEasure:SETTled:FREQuency:RESolution Usage: Sets or queries the settling resolution setting of the frequency measurement for the designated AME. Range: 0 to 1000 Hz. Query: AME:SETT:FREQ:RES? returns the setting of the global resolution for frequency for settled data. *RST: 0.10 Hz. AMEasure:SETTled:FREQuency:TOLerance Usage: Sets or queries the settling tolerance setting of the frequency measurement for the designated AME.
AMEasure Subsystem (Audio Analyzer) AMEasure:SETTled:IMD:TOLerance Usage: Sets or queries the settling tolerance setting of the intermodulation distortion measurement for the designated AME. Range: 0 to 100% Query: AME:SETT:IMD:TOL? returns the global setting for IMD tolerance for settled data points. *RST: 0.100% AMEasure:SETTled:LDIFference:RESolution Usage: Sets or queries the settling resolution setting of the level difference measurement for the designated AME.
AMEasure Subsystem (Audio Analyzer) AMEasure:SETTled:LEVel:MINimum 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.
AMEasure Subsystem (Audio Analyzer) AMEasure:SETTled:PDIFference:RESolution Usage: Sets or queries the global settling resolution setting of the phase difference for settled data points. Range: 0 to 180 degrees. Query: AME:SETT:PDIF:RES? returns the global setting for phase difference resolution for settled data points. *RST: 1.000 degree.
AMEasure Subsystem (Audio Analyzer) AMEasure:SETTled:SEParation:TOLerance 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 Usage: Sets or queries the glopbal settling resolution setting of the total harmonic distortion measurement.
AMEasure Subsystem (Audio Analyzer) AMEasure:SETTled:THDN:RESolution 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 Usage: Sets or queries the settling tolerance setting of the THDN measurement for the designated AME.
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 Usage: Sets or queries the Variation percentage setting in the AA measurements settling menu.
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 recognition for the designated AME. *RST: Sets sweep detection to Falling sweeps. AMEasure[1–4]:SWEep:FREQuency:DELta Usage: Sets or queries the amount of frequency change to use to determine that a frequency sweep is occurring.
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 Subsystem (Audio Analyzer) AMEasure[1–4]:XY:X:FUNCtion 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 Parameters: CHANnel1|CHANnel2 Usage: Sets or queries the source of the input to the y-axis in XY mode.
AMEasure Subsystem (Audio Analyzer) AMEasure[1–4]:XY:Y:FUNCtion Parameters: FREQuency|THD|THDN|IMD|PDIFference|SEParation| CROSStalk|LDIFference|LEVel 3–26 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.
AMEasure Subsystem (FFT) 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.
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 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.
AMEasure Subsystem (FFT) Query: AME[3–5]:MTON:FUNC? returns the selected measurement for the designated AME. *RST: AME3 AME4 AME5 LEVEL LEVEL LDIFFERENCE AMEasure[3–5]:MTONe:INPut CHANnel1|CHANnel2 Usage: This configures the measurement channel on which the requested multitone measurement is made. The use of this channel is described specifically for each possible MTONe[3–5]:FUNCtion value. Query: AME[3–5]:MTON:INP? returns the input channel for the designated AME.
AMEasure Subsystem (Digital Interface Tester) AMEasure Subsystem (Digital Interface Tester) The Digital Interface Tester has AMEasure command support for four separate measurements. They are the following: AMEasure1: Bit Activity AMEasure2: Channel Status AMEasure3: Eye Diagram AMEasure4: Jitter Spectrum AMEasure:DAUDio:CSTatus(1–2):DATA? Suffixes: CST1 is the first or left channel CST2 is the second or right channel. Usage: Query only.
AMEasure Subsystem (Digital Interface Tester) AMEasure[1–4]:STATe ON|OFF Usage: Turn the designated AMEasure for the Digital Interface Tester on or off. Query: AME[1–4]:STAT? returns 0 for off and 1 for on for the designated AMEasure. *RST: Sets AME1 state on and AME[2–4] states off.
AMEasure Subsystem (Audio Monitor) AMEasure Subsystem (Audio Monitor) The Audio Monitor has minimal use of the AMEasure commands, only being able to turn a scope channel on or off or querying the state of the channels, on or off. AMEasure[1–2]:STATe? 3–32 Suffixes: AME1 AME2 Scope Channel 1 Scope Channel 2 Usage: Sets or queries the state of the designated AMEasurement. Query: AME[1–2]:STAT? returns 1 or 0 for ON or OFF. *RST: Sets AME[1–2] states on.
CALCulate Subsystem (Average) CALCulate Subsystem (Average) Usage: The CALCulate subsystem for Average control the number of averages, the averaging mode, and turning averaging on and off. Averaging is available in the FFT Analyzer and the Jitter Spectrum display of the Digital Interface Tester. Suffixes: CALC3 CALC4 FFT View 1 and Digital Interface Tester Jitter View.
CALCulate Subsystem (Average) Query: CALC[3|4]:AVER:TYPE? returns the current setting for the designated CALC block as MAXIMUM, MINIMUM, or EXPONENTIAL. *RST: Sets AVER:TYPE to EXPonential. CALCulate[3|4]:FEED? 3–34 Usage: Query to determine the signal feed for the AVERage CALC blocks. Query: CALC[3|4]:FEED? returns the feed for the designated CALC block. FFT CALC3 is fed by ’CALC:TRAN:FREQ:MAG’, CALC4 is fed by ’CALC2:TRAN:FREQ:MAG’, and Jitter Spectrum CALC3 is fed by ’SENse 11’.
CALCulate Subsystem (FFT Analyzer) CALCulate Subsystem (FFT Analyzer) Usage: This is the CALCulate Subsystem for the FFT Analyzer. The CALCulate subsystem performs post–acquisition data processing. Functions in the SENSe subsystem are related to data acquisition, while CALCulate subsystem operates on the data acquired by a SENSe function. A number of independent subsystems comprise the CALCulate subsystem. Each of the subsystems is a sub–block of the CALCulate block.
CALCulate Subsystem (FFT Analyzer) Query: CALCulate[1–2]:TRANsform:FREQuency:STARt? returns the span start frequency. *RST: Sets STARt to 20 CALCulate[1–2]:TRANsform:FREQuency:SPAN Usage: Specifies the frequency span of FFT output. Range: Range of span is dependent on the input. Range = (427/512) * Sampling Rate * 0.5 / Zoom Factor. Input High Res High BW Sampling rate Range (Hz) Zoom factor 48 kHz 200.156 100 400.312 50 800.624 25 1000.78 20 2000.
CALCulate Subsystem (FFT Analyzer) ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁ ÁÁÁÁÁÁÁ AES 32 kHz 918.468 20 1838.94 10 3677.87 5 4597.34 4 9194.68 2 18389.4 1 (Full span) 133.438 100 266.875 50 533.75 25 667.187 20 1334.38 10 2668.75 5 3335.94 4 6671.87 2 13343.
CALCulate Subsystem (FFT Analyzer) Resolution: Resolution = Sampling Rate / 1024 Default: Omitting the suffix number of CALC is the same as CALC1. Query: CALCulate[1–2]:TRANsform:FREQuency:CENTer? returns the CENTer frequency setting. Error: Entering a number for CENTer outside the span range does what? Entering a number that is not on a resolution point does what? *RST: Sets CENTer to MID full span.
CALibration Subsystem CALibration Subsystem CALibration[:ALL]? Usage: This query causes the AM700 to initiate a calibration procedure and return a numeric response that indicates the result of the calibration. Response: A numeric value is returned which represents an error status. A zero is returned if the calibration succeeds. NOTE. The “Calibrate Now” button is provided in the user interface as a way to perform the “CAL:ALL?” query.
CALibration Subsystem CALibration:OUTPut:POWer:REFerence:RESistance Usage: Set the user’s external resistor values to use in the AM700 display of output power (dBm). Range: 0.001 to 200000.0 Resolution: 0.001 Units: Ohms (impedance) *RST: No change NOTE. Output dBm calculation takes both this reference resistance and the generator source impedance into account. CALibration:VOLTage:FS 3–40 Usage: Sets or queries the rms voltage corresponding to 0 dBFS.
CMODe Subsystem (Audio Analyzer) CMODe Subsystem (Audio Analyzer) Usage: The CMODe:ENABle commands control the display of the real-time measurement readout in the Real Time window of Audio Analyzer. The CMODe:FILTer command select from a set of standard filters for use in making Audio Analyzer measurements. CMODe:ENABle:CHANnel[1|2] Usage: Sets or queries the state of the Enables for channels 1 and 2 in the Audio Analyzer.
CMODe Subsystem (Audio Analyzer) CMODe:ENABle:THD Usage: Turns the THD measurements on and off in the Real_Time measurement window of Audio Analyzer. Query: CMOD:ENAB:THD? returns 0 for THD measurement disabled or 1 for THD measurement enabled in the Audio Analyzer Real–Time window. *RST: Sets the THD enable measurement to off. CMODe:ENABle:WOW Usage: Turns the Wow and Flutter measurement on and off in the Realtime measurements window of Audio Analyzer.
CMODe Subsystem (Audio Analyzer) CMODe:FILTer:TYPE[1|2] ’filter_name’ Usage: Selects the filter type used for Audio Analyzer measurements. NOTE. Parameters are case sensitive and must be entered as indicated in the parameters list in single quotation marks.
CMODe Subsystem (Audio Analyzer) 3–44 AM700 Audio Measurement Set Programmer Manual
CMODe Subsystem (FFT/MTONe Analyzer) CMODe Subsystem (FFT / MTONe Analyzer) Usage: Commands under CMODe:FFT are used to switch the FFT Analyzer operations between Zoom mode and Multitone measurements and to designate signal sources for the multitone signal. The CMODe:FFT:WINDow commands permit specifying a user specified window file. CMODe:FFT FFT|MTONe Usage: Selects either FFT (Zoom) or Multitone measurements for the FFT Analyzer. Default: The power on default for CMODe is FFT.
CMODe Subsystem (FFT/MTONe Analyzer) CMODe:FFT:MTONe[1|2]:NTONes? Usage: Returns the number of tones making up the designated multitone signal. CMODe:FFT:MTONe[1|2]:RLENgth? Usage: Returns the record length of the file used to create the designated multitone signal. CMODe:FFT:MTONe[1|2]:SOURce GENerator|FILE Usage: Selects the source of the multitone signal from either the generator or a file.
CMODe Subsystem (FFT/MTONe Analyzer) Query: CMODe:FFT:MTONe[1|2]:SUFFix? returns the number of the source (generator) designated to send the multitone signal. Example: CMOD:FFT:MTON1:SUFF 5 selects digital generator channel A as the source of the multitone signal for multitone 1. *RST: CMOD:FFT:MTON1:SUFF set to 1. CMOD:FFT:MTON2:SUFF set to 2. CMODe:FFT:WINDow:FILE:NAME Usage: Designates the file name for a user-specified window.
CMODe Subsystem (SOUNd and DAUDio) CMODe Subsystem (SOUNd and DAUDio) Usage: The CMODe commands found here are used for setting the digital audio sample rate clock source and turning off Sound and selecting the Sound source. CMODe:DAUDio:SRATe:SOURce CSTatus|CLOCk Usage: Selects the users preference for determination of audio sampling rate on input digital audio signals. Digital audio has a sample rate embedded in its channel status block, but can be sent on the interface at a different sampling rate.
CMODe Subsystem (TRIGger) CMODe Subsystem (Trigger) The CMODe commands found here are used to control the Trigger modes of the Audio Monitor. CMODe:TRIGger:LEVel Usage: Sets the trigger level for the Audio Monitor trigger system. Range: –173.62 to +173.62 V Units: V or mV. Units follows the setting of the UNIT:VOLT command. Query: CMOD:TRIG:LEV? returns the current trigger level setting in volts or millivolts. *RST: Sets trigger level to 0.00 V.
CMODe Subsystem (TRIGger) CMODe:TRIGger:SLOPe RISing|FALLing Usage: Selects either the rising or the falling edge of the selected trigger signal as the triggering edge when the Audio Monitor trigger system is enabled. Query: CMOD:TRIG:SLOP? returns the trigger slope setting. *RST: Sets TRIGger SLOPe to RISing. CMODe:TRIGger:SOURce CHANnel1|CHANnel2|EXTernal 3–50 Usage: Selects the source to supply the trigger signal.
CSTReam Subsystem CSTReam Subsystem Usage: CSTReam is used to select the two inputs to the measurement applications. The AM700 has many possible input channels and sources, but most applications only can measure two channels of audio, and the CSTReam feeds are constrained as appropriate for the measurement being made. Range: CSTReam1, CSTReam2 CSTReam1 feeds channel one of the application. CSTReam2 feeds channel two of the application.
CSTReam Subsystem Default: Omitting the suffix on CSTReam is the same as CSTReam1. Query: CSTR[1|2]:FEED? returns the data feed for the designated CSTReam. Example: Use SENSe1 audio (Analog A high resolution A/D converter output) for the application’s channel one measurements: CSTR1:FEED `SENS1' *RST: 3–52 Sets CSTR1:FEED to SENS1 and CSTR2:FEED to SENS3.
DISPlay Subsystem DISPlay Subsystem The DISPlay Subsystem controls the selection and presentation of text, graphs, and TRACe information. DISPlay does not modify the way in which data is output to a controller. DISPlays are separated into WINDows. A window consits of three overlapping planes: text, graphics, and traces and all of these may be displayed at the same time in a given window.
DISPlay Subsystem DISPlay:MENU:CLEar[:IMMediate] Usage: Command only. Clears menus, dialog boxes, and notifiers from the display. DISPlay[:WINDow[1–4]]:CURSor[:POSition[1|2]] Usage: Sets the cursor position of the designated cursor in the designated window to a given x-axis value. The x-axis scaling is application specific. Range: 0 to maximum x-axis value in display.
DISPlay Subsystem DISPlay:WINDow98:DISMiss:[ALL] Usage: Turns off all notifier windows that occur in the display to show a warning or provide some item of information about some event. Query: No query for this command. The associated DISP:WIND98:STAT? query is used to determine if a notifier window is displayed. *RST: All notifiers are removed from the display.
DISPlay Subsystem DISPlay[:WINDow[1-n|60|98|99]][:STATe] Usage: Controls whether WINDow(n) is visible or not. The command DISPlay ON|OFF refers to this node. Multiple instances of WINDow may exist under a particular DISPlay. Omitting the suffix from WINDow defaults to WINDow1. Parameters: 0 1 Turns the designated window off Turns the designated window on Range: Windows 1–n, specify the view windows in application.
DISPlay Subsystem DISPlay:WINDow98:STATe Usage: Sets or queries the state of the notifier box display. Query: DISP:WIND98:STAT? returns 0 or 1 for OFF or ON. *RST: Turns off the notifier display. DISPlay:WINDow98:STATe? Query: DISP:WIND98:STAT? returns a 1 if there is a notifier being displayed or 0 if not. DISPlay:WINDow99:STATe Usage: Sets or queries the state of the dialog box display. Query: DISP:WIND99:STAT? returns 0 or 1 for OFF or ON.
DISPlay Subsystem DISPlay:WINDow99:TEXT:CLEar Usage: Clears text from the dialog box, WINDow99. DISPlay[:WINDow[1–4]]:Y[:AXIS]:DUAL Usage: Sets or queries the state of the dual-trace display of traces. Query: DISP:WINDow2:Y:AXIS:DUAL? returns 1 for dual ON and 0 for dual OFF (single trace). *RST: Set DUAL Off. DISPlay[:WINDow[1–4]]:TRACe[1|2]:PERSistence 3–58 Usage: Used to set or query the state of persistence in the interpolator traces.
DISPlay Subsystem DISPlay[:WINDow[1–4]]:TRACe[1|2]:STYle:CSTatus:FORMat Usage: Used to set or query the format of the Digital Interface Tester Channel Status display. Either option for TRACe may be used, or it may be omitted. Parameters: Character data values are: HEXadecimal BINary TRANsmit DECoded Query: DISP:WIND[1–4]:TRAC:STY:CST:FORM? *RST: Sets the FORMat to DECoded.
DISPlay Subsystem DISPlay[:WINDow[1–4]]:TRACe[1|2]:STYle:CSTatus:SUBFrame A|B|BOTH Usage: Sets the Digital Interface Tester Bit Activity display to show either A or B subframes or both. Either option for TRACe may be used, or it may be omitted. Query: DISP:WIND[1–4]:TRAC[1|2]:STY:CST:SUBF? returns the setting as A, B, or BOTH. *RST: Sets SUBFrame to BOTH. DISPlay[:WINDow[1–4]]:TRACe[1|2]:STYLe:PLOT:LINes Usage: Sets the Audio Analyzer display of data to be a line graph of the data.
DISPlay Subsystem DISPlay:WINDow:TRAce[:X]:AXIS:UNIT Usage: Used to set the units of the traces’ x-axes. Example: DISP:WIND:TRAC:X:AXIS:UNIT khz or DISP:WIND:TRAC:AXIS:UNIT khz sets the x-axes units to kilohertz. Query: DISP:WIND:TRAC:X:AXIS:UNIT? or DISP:WIND:TRAC:AXIS:UNIT? returns the setting of the x-axis units. *RST: Sets x-axis units to Hz.
DISPlay Subsystem Example: DISP:WIND5:TRAC2:AXIS:UNIT dbm sets the Ch 1 Level units in the real-time analyzer to dbm. Example: The tcl command that follows will print all the units for Ch 1 in the real-time analyzer box: foreach s { 1 2 3 4 5 6} {puts stdout [scpi ”DISP:WIND5:TRAC$s:AXIS:UNIT?”] } Query: DISP:WIND5:TRAC2:AXIS:UNIT? returns the setting of the Ch 1 Level units. Suffixes: The suffixes for generator TRACe are counted across the rows (through one channel, and then the next).
DISPlay Subsystem DISPlay[:WINDow[1–4]]:TRACe[1|2]:X[:SCALe]:AUTO ONCE Usage: This command scales the X-axis TRACe[1|2] to display the full trace horizontally once for each time this command is used. Query: DISP:WIND1:TRAC1:X:SCAL:AUTO? DISPlay[:WINDow[1–4]]:TRACe[1|2]:X[:SCALe]:CENTer Usage: Sets or queries the valued represented by the center point of the x-axis. This value may be bounded by a range of data.
DISPlay Subsystem DISPlay[:WINDow[1–4]]:TRACe[1|2]:X[:SCALe]:RIGHt Usage: Sets or queries the value represented by the maximum (right) edge of the x-axis. This value may be bounded by a range of data. When a new RIGHT value is entered, the divisions of the scale remain the same, but the CENTer and LEFT values are changed. Query: DISP:WIND1:TRAC1:X:SCAL:RIGH? returns the value of the right edge of the x-axis scale of trace 1 in window 1.
DISPlay Subsystem DISPlay:WINDow[5|16]:TRACe[1–16]:Y:AXIS:UNIT Usage: Used to set the y-axis units of the specified trace in the anayzer real-time measurement traces (WIND5) or the generator (WIND60). Suffixes: The TRACe suffixes for the y-axis are the same as for the x-axis. DISPlay[:WINDow[1–4]]:TRACe[1|2]:Y[:SCALe]:AUTO ONCE Usage: This command scales the y-axis of the designated trace to display the full amplitude of the trace data vertically.
DISPlay Subsystem DISPlay[:WINDow[1–4]]:TRACe[1|2]:Y[:SCALe]:TOP Usage: Sets or queries the value represented by the top edge of the display. The value may be bounded by the range of data. Range: Depends on y–axis scale units: voltage is 173.62 Volts, dBr is 1.000. Query: DISP:WIND1:TRACe1:Y:SCALe:TOP? returns the value of the top of the y-axis scale of trace1 in window 1. *RST: Sets the TOP to the maximum value for the appliation.
DISPlay Subsystem Eye Diagram Jitter Parameters: INTerpolator PPlot BGRaph SPECtrogram TABLe Parameters: BIT CST EYED INT :TRACe[1|2]:STYle:CSTatus commands) EYED Interpolator, Bar Graph, and Spectrogram Plot of fft data points with interpolated data for a continuous live trace. Point-to-point plot of frequency-amplitude pairs Bar graph display of amplitude and fft bin width Time versus Frequency with z-axis display of amplitude Tabular display of frequency-amplitude pairs.
FORMat Subsystem FORMat Subsystem Default units are defined, where applicable, for each SCPI command. The UNIT subsystem provides a mechanism to change the default values. The units selected apply to the designated command parameters for both command and response. FORMat:PNAMe STRing|CHARacter 3–68 Usage: Sets or queries the format for a PROGram name.
GCONtrol Subsystem GCONtrol Subsystem GCONtrol is the root command for controlling the AM700 audio signal generator. 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. The commands under the ANAlog node control the modes of the analog audio generator. Selection of the high resolution or the high bandwidth generator is done with the MODE command.
GCONtrol Subsystem Example: gcon:anal:mode hres sets the Analog generator to high resolution mode. Query: GCON:ANAL:MODE? returns the selected generator, HRES or HBWAN. *RST: Sets the analog mode to high resolution, HRES. GCONtrol:DIGital:MODE AES|DSP Usage: Selects between the AES standard format generator or the DSP, digital signal processor, as the source of the digital audio signal. Query: GCON:DIG:MODE? returns the selected digital generator mode, AES or DSP.
HCOPy Subsystem HCOPy Subsystem The AM700 support for hardcopy is non-standard to the 1994 SCPI manual for hardcopy, but it more closely tracks the way this feature has been previously implemented. In the SCPI manual, the MMEMory:OPEN and HCOPy:CLOSe commands were to be used to open and close the file specified by MMEM:NAME to accommodate feeding data from the HCOPy subsystem. This state-dependent style of feeding data is not used in the AM700. The AM700 GPIB usage of hardcopy-to-file is as follows.
HCOPy Subsystem HCOPy[:IMMediate] Usage: Causes the currently visible screen to be printed to the currently-selected hardcopy device, using the currently-selected hardcopy format. Query: Event only, no query. HCOPy:ABORT Usage: Aborts any printing currently in progress, and discards any print jobs which are pending. Intermediate files are sent to a spool directory before being spooled. The spool directory can hold 5 to 10 hardcopy intermediate files.
HCOPy Subsystem Query: hcop:dest? returns the current setting for the hardcopy destination. Default: The power up default is SYST:COMM:SER (serial port 1). *RST: Sets the copy destination to an empty string. HCOPy:DEVice:COLor Usage: Sets or queries the state of the color output for PostScript and TIFF formatted files. When set to ON, printer output will be color formatted.
HCOPy Subsystem ELQuality Epson Letter Quality. Good for various Epson LQ and compatible printers. TIFF Tagged Image File Format. This is a bit-mapped image that may be output in color, depending on the setting of HCOP:DEV:COL. Default: The power up default is the last setting. Query: HCOP:DEV:LANG? returns the hardcopy output language format presently selected. *RST: Not changed by *RST.
INPut Subsystem INPut Subsystem The commands under the INPut subsystem are used to select the INPut signal source and set the input impedance and range of the analog inputs, A and B. As indicated in the commands, not all INPut suffixes are available for all the commands. Parameters: INPut1 INPut3 INPut5 INPut6 INPut7 Analog A Analog B Digital_Main DSP Digital Reference INPut[1|3]:IMPedance Usage: Set input impedance of the two analog inputs, A and B.
INPut Subsystem Resolution: 6 dBu steps. Error: Entering a that is not at one of the range step values causes the range setting to go to the next higher valid range step. No error is generated. Query: INPut[1|3]:RANGe? returns the range setting for designated analog input. *RST: At *RST, the clipping point is set to 10.954 V peak. INPut[1|3]:RANGe:AUTO ON|OFF|ONCE 3–76 Usage: Used to control the Auto-range feature for ON, OFF, or ONCE.
INSTrument Subsystem INSTrument Subsystem Within the AM700 thare 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. Usage: Commands in this subsystem are used to selected the different AM700 applications by name, number, or descriptive_name. Queries in this subsystem permit you to determine what the available strings are that may be used to select an application.
INSTrument Subsystem INSTrument:LSELect:USER Usage: Selects an instrument (application) to run on the User button by long descriptive name. The string data returned by INST:LCAT? provides the long descriptive names for the applications. Example: inst:sel:user ”Audio Monitor” selects the Audio Monitor to run on the User button. Query: INSTrument:LSELect:USER? returns the of the application assigned to run on the User button.
INSTrument Subsystem Parameters: NSEL? 1 2 3 4 5 6 SEL? FFT Analyzer Monitor Digital Diagnostics PanelCal LSEL? ”FFT Analyzer” ”Audio Analyzer” ”Audio Monitor” ”Digital Interface Tester” ”Diagnostics” ”Touch Panel Calibration” Query: INSTrument:NSELect? returns the application number of the selected application. *RST: *RST has no effect on instrument selection. INSTrument:NSELect:USER Usage: Selects the application to run on the User button by number.
INSTrument Subsystem Digital Digital Interface Tester Diagnostics Diagnostics PanelCal Touch Panel Calibration Example: inst:sel analyzer selects the Audio Analyzer application to run. Query: INSTrument:SELect? returns the short name for the selected application. *RST: *RST has no effect on instrument selection. INSTrument:SELect:USER Usage: Used to select the application that runs with the User button by short name.
MMEMory Subsystem MMEMory Subsystem 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/} The device portion is optional.
MMEMory Subsystem AM700 File Structure The upper level of the AM700 files comprise ROM, NVRAM, and DOS logical directories. Under those, other directories or files may exist. Certain directories are accessible by the user for storage use or information. Certain other directories are accessible by AM700 operating system firmware only. File Names The AM700 allows an optional mass storage unit specifier (a logical directory name) with any file name given to the MMEMory commands.
MMEMory Subsystem MMEMory:CATalog? Usage: The CATalog command is query-only and returns information on the current contents and state of the current working directory. Upon a CATalog? query, the AM700 reads the current working directory and returns its directory information in the following format: ,{,} Two numeric parameters and as many strings as there are files in the directory list are returned.
MMEMory Subsystem MMEMory:CDIRectory '[device:/]directory_name' Usage: Changes the working directory in the file system. The parameter is a string. The contents of the parameter are dependent on the file system being accessed. If no parameter is specified, the directory is set to the *RST value There is a concept of a current directory in the MMEMory subsystem.
MMEMory Subsystem MMEMory:CLOSe Usage: Closes the file specified in MMEMory:NAME. Error: An attempt to close a file that is not open causes error –256, (File name not found) to be generated MMEMory:COPY [device:/]{path_name/}source_file , [device:/]{path_name/}destination_file Usage: Copies an existing file into a new file. The copy is byte-for-byte, even for text files.
MMEMory Subsystem Query: MMEM:DATA? returns the contents of the file in definite length block data format. Again if the is a path string, single quotes must be used around the filename string. Example: MMEM:DATA? rom:/mtone/asgmton3.ton returns the contents of the file used to generate MTONE1. #3113am700 multitone 1.0 12 46.875 0 140.625 0 281.250 0 656.250 0 1031.250 0 2015.625 0 4031.250 0 8109.375 0 15000.
MMEMory Subsystem New data arriving from overwrites the contents of the specified file. Parameters: Two data handles are allowed: ”” and ”hcopy”. If ”hcopy”, hardcopy output will be written to the file specified by MMEMory:NAME ['device:]' (assuming the file has been MMEM:OPENed). Error: If the generates new data and the file is not open, error –256, (File name not found) is generated. Query: mmem:feed? returns the data feed name to the file specified in NAME.
MMEMory Subsystem Error: Attempting to open a file that is already open causes a “File name error” (–256) to be generated. Example: mmem:name nvram:/tests/test1 ;mmem:open;mmem:feed hcopy ;mmem:close Query: mmem:open? Explanation of Example: 3–88 The example command names a file named test1 in nvram, opens the named file, and copies the hcopy data to the open file, then closes the named file.
OUTPut Subsystem OUTPut Subsystem Usage: The majority of the OUTPut command control the digital audio generator; two are used to set the analog generator output impedance and select whether the common is floating or referenced to ground. OUTput commands pertain only to the generator. The DAUDio node contains commands used to control the output of the digital audio generator. Commands under the CLOCk subnode are used to adjust the main to ref clock phasing.
OUTPut Subsystem Parameters: frequency from 30 kHz to 52 kHz, with a resolution of 0.001 Hz. Range: 30,000 to 52,000 Resolution: 0.001 Hz Units: Hz Query: OUTP3:DAUD:INT:CLOC:VFR? returns the variable clock frequency setting. *RST: 48000.0 OUTPut3:DAUDio:INTerface:CLOCk:FRequency:ADJust Usage: Add a small offset to the digital interface clock frequency when :CLOCk:MODe is set to AUDio or DARS.
OUTPut Subsystem OUTPut3:DAUDio:INTerface:VOLTage:BALanced Usage: Sets the voltage output level at the balanced connectors. The balanced to unbalanced ratio is always 5:1 so the balanced and unbalanced output levels are not independently settable. Range: 0.01 to 10.23 Vpp Resolution: 0.01 Vpp Query: OUTP3:DAUD:INT:VOLT:BAL? returns the voltage setting output to the balanced output connectors. *RST: 5.
OUTPut Subsystem OUTPut:COMMon FLOat|GROund Usage: Selects whether the analog outputs are floating (with no ground reference) or referenced to ground. Query: OUTP:COMM? returns “FLOAT” or “GROUND”. *RST: Set the output common to FLOAT. OUTPut3:FILTer[:LPASs][:STATe] Usage: Turns the long cable simulation filter on in the output path. Query: OUTPut:FILTer[:LPAss][:STATe]? returns 1 for ON and 0 for OFF.
PROGram Subsystem PROGram Subsystem These SCPI commands are for the PROGram subsystem as implemented in the AM700 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 Tcl 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.
PROGram Subsystem PROGram:CATalog? Usage: This is a query only command that lists all the programs stored in the function directories of both nvram: and rom:. If there are functions of the same name in both directories, only one will be shown. This can be confusing so different names should be used for naming functions in nvram:/functions directory. Query: PROG:CAT? returns a comma separated list of the defined functions. Each string contains the name of a program.
PROGram Subsystem To download and overwrite an existing function file of the same name, the first file must be deleted. Program names entered as character data are not case sensitive and are reported back as all capitalized characters. Those entered as string data will be reported back as entered. Query: PROG:EXPL:DEF? returns the contents of the explicitly named function file back to the controller via the GPIB interface in definite length arbitrary block data format.
PROGram Subsystem PROGram:EXPLicit:STATe ,RUN|STOP Usage: The explicitly named function is started by setting state to RUN. If the state is already RUN, a second run of the same function is started. When set to STOP, all instances started through this interface or the Function user interface will be stopped. There is a maximum of 10 concurrently running functions. Query: PROG:EXPL:STAT? returns the state of the explicitly named function as RUN or STOP.
PROGram Subsystem PROGram:EXPLicit:TIMed:CLEar Usage: Remove all the cron_strings for the function explicitly named by ‘’. PROGram:EXPLicit:TIMed:ADD ,’cron_string’ {,’cron_string’} Usage: Adds to the current set of cron_strings for the explicitly named program. PROGram:EXPLicit:USER:CLEar Usage: Command only. Clears any assignment to the User button, including an application assignment.
PROGram Subsystem PROGram:SELected:DEFine Usage: Creates and downloads programs to the selected progname. The must be in definite length arbitrary block data format for down loading to the AM700. The program name used is the currently selected program name. The specified program must have a unique name. To download and overwrite an existing program of the same name, the first program must be deleted.
PROGram Subsystem PROGram:SELected:LNAME? Usage: Query only that returns a full pathname that may be used with the MMEMory subsystem or in Tcl scripts. The returned long name is string data. Example: PROG:SEL:LNAME? returns the full pathname to the selected . ”nvram:/function/PROG” PROGram:SELected:NAME Usage: Names the program to be used as the selected function by the other PROG:SEL commands.
PROGram Subsystem PROGram:SELected:STATe RUN|STOP Usage: The selected function is started by setting state to RUN. If the state is already RUN, a second run of the function is started. When set to STOP, all instances started through this interface or the Function user interface will be stopped. There is a maximum of 10 concurrently running functions. Query: PROGram:SELected:STATe? returns the state of the selected function as RUN or STOP.
PROGram Subsystem PROGram:SELected:USER:SET Usage: Command only. Assigns the selected function to the function user button. PROGram:SELected:USER:STATe Usage: An nr1 argument of 1 assigns the selected function to the user button. If the argument is 0, and the current setting is also the current function, the user button becomes unassigned. Query: PROG:SEL:USER:STAT? returns a 1 only if the selected function name is assigned to the user button.
ROUTe Subsystem ROUTe Subsystem Signal routing is the block where the user has access to actual signals. ROUTe[1–3]:CLOSe Usage: Sets the route setting. If all the specified channels cannot be closed, an execution error is reported.
ROUTe Subsystem You must use a valid channel number (see Parameters) for the designated route to get a return. When the query is correctly stated, the command returns 0 for open and 1 for closed. Example: rout1:clos? 1 returns 1 or 0 for closed or open. rout3:clos? 6 returns 1 or 0 for closed or open. *RST: Sets ROUT1:CLOS 1, ROUT2:CLOS 2, and ROUT3:CLOS 6. ROUTe[1–3]:CLOSe:STATe? Query: ROUTe:CLOSe:STATe? returns the number of the closed route (selected input connector).
SENSe Subsystem SENSe Subsystem 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.
SENSe Subsystem Parameters: MED for 120 Hz HIGH for 1200 Hz The LF REJ filter is always engaged for SENSe11. *RST: MED SENSe11:DAUDio:INTerface:JGAin NORMal|HIGH Usage: Set or query the gain used in the eye/jitter detection circuitry. Parameters: NORMal is X1 gain HIGH is X8 gain Query: SENS11:DAUD:INT:JGA? returns NORMAL or HIGH. *RST: NORMAL SENSe5:DAUDio:INTerface:CORRection:EQualization? Usage: Query only. Indicates the amount of equalization applied by automatic equalization circuitry.
SENSe Subsystem NOTE. This value is only updated when measurements are being made on the digital input. This usually means that the digital generator must be in AES mode and CSTReam1 or CSTREAM2 is fed with SENSE5 or SENSe6. Query: SENSe(5|7):DAUDio:INTerface:FREQuency? returns the digital interface clocking frequency. For example, 48000.1 SENSe5:DAUDio:INTerface:FREQuency:RATio? Usage: Query only.
SENSe Subsystem SENSe5:DAUDio:INTerface:VOLTage:AC? Usage: Query only. Used to determine the peak-to-peak voltage of the digital main input signal. Query: SENS5:DAUD:INT:VOLT:AC? Query only. returns the voltage of the digital main input in volts peak-to-peak.
SOURce:DAUDio Subsystem SOURce:DAUDio Subsystem SOURce is the root command in the SOURce Subsystem for the AM700. The SOURce setup commands are divided into several sections. Each section or subsystem deals with controls that directly affect device-specific settings of the AM700; not those related to the signal-oriented characteristics. These commands are referenced through the SOURce node.
SOURce:DAUDio Subsystem SOURce[5|6]:DAUDio:AUDio:WSIZe Usage: Selects the word size used for the digital audio signal from the generator. Parameters: 8 to 24 Current software in the AM700 forces both channels on a digital interface to have the same word length. Changes to one channel will then cause the same change in the other channel. Query: SOUR[5|6]:DAUD:AUD:WSIZ? returns the setting for the number of bytes used for generating the digital audio signal. *RST: Set WSIZe to 24.
SOURce:DAUDio Subsystem SOURce[5|6]:DAUDio:CSTatus:FILE:NAME Usage: Designates the filename to be used for setting user bits when the :CSTatus:MODE command is set to FILE. Query: SOUR[5|6]:DAUD:CST:FILE:NAME? returns the file name without the path. *RST: Sets filename to ”cd.cst.” The path to the default filename is ”rom:/cstatus/cd.cst.” SOURce[5|6]:DAUDio:UBITs:MODE NULL|FILE Usage: Sets or queries the selection for generating user bits on the digital interface.
SOURce:DAUDio Subsystem SOURce[5|6]:DAUDio:UBITs:FILE:LNAME Usage: Designates the filename with will path to be used for setting user bits when the :UBITs:MODE command is set to FILE. Query: SOUR[5|6]:DAUD:UBIT:FILE:LNAME? returns the name with path for the file to be used. *RST: Set long filename to rom:/userbits/null.usr. SOURce[5–8]:DITHer:TYPE RECTangular|TRIangular|NONE Usage: Selects the shape of the dither applied to the signal of the designated source.
SOURce:FOLLow Subsystem SOURce:FOLLow Subsystem SOURce[1–8]:FOLLow[:STATe] Usage: Turns follow mode on or off for a designated source channel. Parameters: Boolean – ON|OFF or 1|0. Suffixes: 1 2 Analog generator HR A Analog generator HB A 3 4 Analog generator HR B Analog generator HB B 5 6 Digital generator SF 1 Digital generator SF 2 7 8 Digital Signal Processor A Digital Signal Processor B Query: SOUR[1–8]:STAT? returns 1 for on and 0 for off for the designated generator.
SOURce:FREQuency Subsystem SOURce:FREQuency Subsystem SOURce[1–8]:FREQuency Usage: Sets the sine–wave frequency of the designated source. This frequency setting is used as the fixed signal frequency when generating a sine–wave.
SOURce:FREQuency Subsystem Query: SOUR[1–8]:FREQ:MODE? returns the operating mode of a designated SOURce as CW or FIXED for non–sweeping, SWEEP for a frequency sweep, or LIST for generating signals from a list of frequencies. Coupled Commands: List: *RST: Sets frequency mode to SWEep. SOURce:LIST:FREQuency SOURce:LIST:DWELl SOURce[1–8]:FREQuency:STARt Usage: Sets the start frequency of a frequency sweep for the designated SOURce. Range: 10 to 20000.
SOURce:FUNCtion Subsystem SOURce:FUNCtion Subsystem Usage: The FUNCtion subsystem controls the shape and attributes of the output signal of the AM700 internal signal generator. The switch settings provided by this function are not horizontally compatible and represent what the source can be configured to generate directly. Most of the generated signals are selected using the SOURce:FUNCtion:SHAPe command. FUNCtion:MODE is omitted as the only is VOLTage.
SOURce:FUNCtion Subsystem SOURce[1–8]:FUNCtion:SHAPe Default: The last selected signal type is generated unless the AM700 has been reset. The reset default is a sinusoidal CW signal of 1 kHz at 0 dBu. Parameters: Query: Coupled Commands: *RST: SOURce:FUNCtion? returns the shape, frequency, and amplitude of the output signal.
SOURce:FUNCtion Subsystem SOURce[5–6]:FUNCtion:SHAPe JSINe Usage: Used to apply jitter to the digital interface signal from the A and B digital generators (suffix SOURce5 and SOURce6 respectively). Acts just like sine wave, but puts jitter on the digital interface. The jitter signal is sinusoidal phase modulation of the digital interface clock. When jittered sine is selected on either digital source channel it forces the other channel to also use jittered sine.
SOURce:FUNCtion Subsystem Resolution: 0.01 Units: UIpp (peak-to-peak unit intervals) SOURce[1–8]:FUNCtion:SHAPe TBURst Usage: This command generates a sine-wave burst with variable amplitude, frequency, and on and off times. The burst always begins and ends at the positive sine-wave zero crossing. The generator converts the width-time parameter into the nearest number of cycles of sine wave to generate. Range: Frequency Amplitude Burst Period Burst Width 10 Hz to 80,000 Hz 0.0625 V to 19.
SOURce:FUNCtion Subsystem Example: sour:volt 4 sour:freq 3000 sour:burs:per 5 sour:burs:wid 5e–1 SOURce:TBURst:PERiod Usage: PERiod is an integer containing the number of cycles until burst repeats (i.e.: off time = period – width). PERiod is constrained to be greater than WIDTh. The generator converts the width-time parameter into the nearest number of cycles of sine wave to generate.
SOURce:FUNCtion Subsystem *RST: 64 SOURce[1–8]:FUNCtion:SHAPe SIMD Usage: Generates a two-tone intermodulation signal with one tone variable in frequency. The IM frequency is 60 Hz for SMPTE. Ratio is the amplitude ratio of the two tones expressed in an integer. The integer expresses the amplitude multiple of the IM-frequency tone with respect to the amplitude of the Frequency tone and is commonly set to 4.
SOURce:FUNCtion Subsystem Example: SOUR1:VOLT:LEV 3;:SOUR1:SIMD:FREQ 7000;:SOUR1:FUNC:SHAP SIMD;:SOUR1:SIMD:RAT 3;:SOUR1:SIMD:VFR 100 *RST: Amplitude Ratio Variable Frequency Amplitude Fixed Frequency 4.0 7000 Hz 0.00 dBu 60 Hz The amplitude of the frequency signal is controllable using the AMPLITUDE knob of the generator. The frequency is controllable using the FREQUENCY knob of the generator.
SOURce:FUNCtion Subsystem Range: 40 to 500 Hz Resolution: 1 Hz Query: SOURce:SIMD:IMFRequency? *RST: 60 SOURce:SIMD:RATio Usage: Sets the amplitude ratio between the two frequencies of the SIMD signal. Range: 1.0 to 8.0 Resolution: 0.1 Query: SOURce:SIMD:RATio? *RST: 4 SOURce[1–8]:FUNCtion:SHAPe CIMD SOURce:CIMD:TYPE CCIF Usage: Generates a two-tone intermodulation signal. Both tones are typically swept in tandem with a constant frequency separation.
SOURce:FUNCtion Subsystem Units: Frequency Amplitude Spacing Ratio Hz Volts Hz None Resolution: Center Frequency 0.1 Amplitude Spacing 0.1 Hz Ratio 0.
SOURce:FUNCtion Subsystem SOURce:CIMD:RATio Usage: Set amplitude ratio of one frequency to the other in the CIMD signal. This is nomally 1:1. Query: SOURce:CIMD:RATio? returns the ratio of the amplitudes of the two frequencies of the CIMD signal. SOURce:CIMD:SPACing Usage: Set the frequency spacing between the two frequencies of the CIMD signal. Query: SOURce:CIMD:SPACing? returns the frequency spacing in Hz. between the two frequencies of the CIMD signal.
SOURce:FUNCtion Subsystem Units: Start Frequency Stop Frequency Hz Hz Resolution: Frequency 0.34 Hz (high res.), 11.7 Hz (high BW) Start Frequency 0.34 Hz (high res.), 11.7 Hz (high BW) Stop Frequency 0.34 Hz (high res.), 11.7 Hz (high BW) Coupled SOURce:FREQuency:STARt Commands: SOURce:FREQuency:STOP Example: SOUR:VOLT 3;FREQ:STA 30;FREQ:STOP 5,000;FUNC:SHA:PCH The amplitude of the PCHirp signal is controllable using the AMPLITUDE knob of the generator.
SOURce:FUNCtion Subsystem Example: SOUR1:FUNC:SHA POL;SOUR1:VOLT:LEV 12;:SOUR1:FREQ:CW 2000 The generator AMPLITUDE knob controls the test signal amplitude (SOURce:VOLTage) and the FREQUENCY knob control the signal frequency (SOURce:FREQuency:CW). These parameters may be controlled individually with SCPI commands. Example: SOUR:VOLT 5E–1 SOUR:FREQ 500 SOURce[1–8]:FUNCtion:SHApe TPOLarity Usage: Selects the Tektronix Polarity Signal.
SOURce:FUNCtion Subsystem Units: Amplitude Frequency Record Length Resolution: Tones Volts Peak Hz Bytes Frequency Amplitude Coupled Commands: SOURce:LIST:VOLTage Query: SOUR[1–8]:FUNC:SHAP? (Sampling rate)/(Record Length) Hz The Generator Amplitude knob controls the peak voltage level of the test signal (SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]). The Frequency control knob is not assigned.
SOURce:LIST Subsystem SOURce:LIST Subsystem Usage: Commands in the SOURce:LIST subsystem permit defining voltage and frequency points and dwell time per point to be used for generating a signal from a LIST. When the generator is set to Multitone, the list of frequencies is looked at to produce the multitone output signal. The default is that all sources use the same list, but a separate list may be entered for each source if separate signals are selected (B does not follow A).
SOURce:LIST Subsystem SOURce[1–8]:LIST:DWELl Usage: Sets the dwell times for each point in a list, up to 128 points, for the designated source. Each list definition for the same source list (volts, frequency, and dwell) must contain exactly the same number of points. Query: SOURce[1–8]:LIST:DWELl? returns a comma separated list of the point dwell times for the designated source. Example: SOUR1:LIST:DWEL .5,.5..8,.8,.8,1,1,1.2,1,.8 *RST: Sets the dwell time to 1.0 second.
SOURce:LIST Subsystem Example: SOUR1:LIST:VOLT 0.025,0.050,0.075,1.0,1.025,2.0,3.0,2.5,1,5,0.5 Query: SOUR[1–8]:LIST:VOLT? returns a comma separated list of the point voltages. *RST: Sets the level to 2.2185 dBu (1 volt). NOTE. When the list is used to generate a multitone test signal, the level setting for each tone is used only to provide the relative amplitude relationship between the individual tones.
SOURce:MTONe Subsystem SOURce:MTONe Subsystem SOURce[1–8]:MTONe:MODE LIST|FILE Usage: Designates whether the multitone signal from a designated source is generated using the list or a user file. Query: SOURce[1–8]:MTONe:LIST? returns LIST or FILE as the source of the multitone frequency set for the designated source. *RST: Sets MODE to LIST for all sources.
SOURce:STATe Subsystem SOURce:STATe Subsystem SOURce[1–8]:STATe Usage: Enables individual sources. When a source is off, its output is silence. This is not the same as GCON:STAT ON|OFF. GCON controls the states of all the generators not individual outputs.
SOURce:SWEep Subsystem SOURce:SWEep Subsystem SOURce[1–8]:SWEep:COUNt Usage: Sets or queries the number of sweeps that are enabled by a single trigger event for the designated SOUR.
SOURce:SWEep Subsystem SOURce[1–8]:SWEep:DWELl Usage: Sets the dwell time for points in a sweep for the designated source. Note that dwell cannot exceed TIME/POINts. Trying to set it to a greater value causes an error. When changing dwell time, the number of points does not change, but the sweep time does to accomodate the new dwell x points time Range: for dwell time is from 0.1 to 600.00. Units: Seconds Resolution: 0.
SOURce:SWEep Subsystem Query: SOURce[1–8]:SWEep:SPACing? returns LINEAR or LOGARITHMIC for the spacing setting of the designated SOURce. *RST: Sets spacing to LOGarithmic. SOURce[1–8]:SWEep:TIME Usage: Sets the sweep time duration. This is interactive with dwell time as the dwell per point adjusts to make the new sweep time. Range: Sweep time is from 1.00 to 1228800.00. Units: Seconds Query: SOURce[1–8]:SWEep:TIME? returns the sweep time in seconds.
SOURce:USER Subsystem SOURce:USER Subsystem SOURce[1–8]:USER:DATA:SCALing[:STATe] Usage: Turns scaling of the user data on or off. ON causes the user data to be scaled; OFF uses the user data as is for amplitude.
SOURce:USER Subsystem SOURce[1–8]:USER:DATA:FILE:LNAME? Usage: Query only that returns the complete path name to the user data file named by SOUR[1–8]:USER:DATA:FILE:NAME for the designated source. Example: SOUR[1–8]:USER:DATA:FILE:LNAME? returns "rom:/signals/sample.dat" as the default user data file.
SOURce:VOLTage Subsystem SOURce:VOLTage Subsystem Usage: The SOURce setup commands are divided into several sections. Each section or subsystem deals with a specific grouping of controls that affect different aspects of the AM700 SOURce commands.
SOURce:VOLTage Subsystem SOURce[1–8]:VOLTage:STOP Usage: Sets the stopping voltage for a voltage sweep. Query: SOURce:VOLTAGE:STOP? returns the maximum level of a voltage sweep for the designated SOURce. *RST: Sets STOP to 2.0000. Default unit is volts. SOURce[1–8]:VOLTage[:LEVel] Usage: Sets the voltage level of the designated source. Query: SOURce[1–8]:VOLTage? returns the level of the fixed voltage signal for the designated SOURce. *RST: Sets LEVel to 0.
STATus Subsystem STATus Subsystem The STATus subsystem controls the status-reporting registers of the AM700. These registers conform to the IEEE 488.2 specification. The status reporting registers may comprise a condition register, an event register, an enable register, and negative and positive transition filters. There is a queue for status. The queue provides a human readable record of instrument errors.
STATus Subsystem A portion of the register structure is illustrated in Figure 3–1. The example shows the bit progression through the registers when the Waiting for Multitone 1 bit changes from a 0 to a 1 state to show that multitone 1 was detected.
STATus Subsystem Bit 15 14 13 Prog Run STAT:OPER:EVENT? 12 Inst Syst Sum 11 10 9 8 7 6 5 Trig 4 3 2 Sweep 1 0 CAL R2 Result STAT:OPER:ENAB 1 Mask STAT:OPER:PTR 1 STAT:OPER:COND? Mask 0⇒1 STAT:OPER:TRIG:EVENT? R1 Result STAT:OPER:TRIG:ENAB 1 Mask STAT:OPER:TRIG:PTR 1 STAT:OPER:TRIG:COND Mask 0⇒1 Waiting for Multitone 1 Figure 3–1: Status register operation showing a bit transition event for multitone 3–142 AM700 Audio Measurement Set Programmer Manual
STATus Subsystem STATus:PRESet Usage: Configure the SCPI and device-dependent status data registers so that device-dependent events are reported at a higher level through the mandatory part of the status-reporting system. Device dependent events are summarized in the mandatory structures as defined in part by IEEE 488.2. SCPI-required structures make of the rest of the mandatory reporting system.
STATus Subsystem The following commands can be applied to all SCPI status registers by prefixing the command with the node(s) that represent the particular register to be controlled.
STATus Subsystem STATus:OPERation[:EVENt]? Usage: Returns the content of the OPERation:EVENt register. Reading the register clears it. Query: Query only. STATus:OPERation:CONDition? Usage: Returns the contents of the OPERation:CONDition register. Reading this register is non-destructive. Query: Query only. STATus:OPERation:ENABle Usage: Sets the enable mask to allow true conditions in the OPERation register to be reported in the summary bit.
STATus Subsystem STATus:OPERation:NTRansition Usage: Sets the negative transition filter. Setting a bit in the positive transition filter causes a 1 to 0 transition in the corresponding bit of the associated condition register to cause a 1 to be written in the associated bit of the corresponding event register. Parameters: The parameter may be a decimal number, or it may be sent as a non-decimal numeric mask.
STATus:OPERation:INSTrument Registers STATus:OPERation:INSTrument Registers The following status register commands for OPERation:INSTrument registers follow the same format as the STAT:OPER registers just defined.
STATus:OPERation:INSTrument Registers STATus:OPERation:INSTrument[:EVENt]? Usage: Returns the content of the OPERation:INSTrument:EVENt register. Reading the register clears it. Query: Query only. STATus:OPERation:INSTrument:CONDition? Usage: Returns the content of the OPERation:INSTrument:CONDition register. Reading the register clears it. Query: Query only.
STATus:OPERation:INSTrument Registers Parameters: The parameter may be a decimal number, or it may be sent as a non-decimal numeric mask. Query: Returns the status of the OPERation:INSTrument:PTRansition register as an value representing the bit states of the OPERation:INSTrument register bits. STATus:OPERation:INSTrument:NTRansition Usage: Sets the negative transition filter.
STATus:OPERation:TRIGger Registers STATus:OPERation:TRIGger Registers The following status register commands for STATus:OPERation:TRIGger registers follow the same format as the STAT:OPER registers. Table 3–7: Trigger conditions used by the FFT application Condition Definition Condition Number Summary bits Awaiting Mtone on Ch 1 700 Set when waiting for a multitone signal on the given channel. Goes to STAT:OPER:TRIG bit 3. Waiting Mtone on Ch 2 701 Goes to STAT:OPER:TRIG bit 4.
STATus:OPERation:TRIGger Registers Table 3–9: TRIGger subsystem layer-change events Condition definition Condition number Summary bits or action Save selected state 1200 Causes the current state to be saved.
STATus:OPERation:SYSTem Registers STATus:OPERation:SYSTem Registers STATus:OPERation Table 3–10: STATus:OPERation Condition definition Condition number Status Calibration 100 Set if calibration is occurring Sweep 103 Set when a sweep is started; cleared with a sweep is finished Trigger for Monitor and FFT 105 Status Bits: 3 Waiting for Mtone Ch 1 4 Waiting for Mtone Ch 2 5 Triggered Ch 1 6 Triggered Ch 2 STAT:OPER:SYST Summary Table 3–11: System conditions 3–152 Condition Definition Conditio
STATus:OPERation:SYSTem Registers Table 3–11: System conditions (cont.
Status Questionable Registers Status Questionable Registers STATus:QUEStionable? Table 3–12: STATus:QUEStionable Condition definition Condition number Status Temperature 201 Too hot – set when over temperature is sensed.
Status Questionable Registers STATus:QUEStionable[:EVENt]? STATus:QUEStionable:CONDition? STATus:QUEStionable:ENAble STATus:QUEStionable:NTRansition STATus:QUEStionable:PTRansition AM700 Audio Measurement Set Programmer Manual 3–155
Status Questionable Input Registers Status Questionable Input Registers Table 3–13: STATus:QUEStionable:INPut:SUMmary Condition Definition Condition Number Summary bits Input 1 207 1 Protected 2 Clipped 3 Unlocked Input 2 208 Input 3 209 Input 4 210 Input 5 211 Input 6 212 Input 7 213 Input 8 214 Input 9 215 Input 10 216 Input 11 217 Input 12 218 Input 13 219 Input 14 220 Input 15 221 Parameters: INPut1 INPut3 INPut5 INPut6 INPut7 3–156 Analog A Analog B Digital Main DSP
Status Questionable Input Registers STATus:QUEStionable:INPut The status bits are the following: Status Bit: 1 – Input protected 2 – Input clipped 3 – Input unlocked STATus:QUEStionable:INPut[1|3|5|6|7][:EVENt]? STATus:QUEStionable:INPut[1|3|5|6|7]:CONDition? STATus:QUEStionable:INPut[1|3|5|6|7]:ENABle STATus:QUEStionable:INPut[1|3|5|6|7]:PTRansition STATus:QUEStionable:INPut[1|3|5|6|7]:NTRansition STATus:QUEStionable:INPut[1|3|5|6|7]:MAP ,
Status Questionable Input Summary Registers Status Questionable Input Summary Registers Parameters: INPut1 INPut3 INPut5 INPut6 INPut7 Analog A Analog B Digital Main DSP Digital Reference STATus:QUEStionable:INPut[1|3|5|6|7]:SUMMary[:EVENt]? STATus:QUEStionable:INPut[1|3|5|6|7]:SUMMary:CONDition? STATus:QUEStionable:INPut:SUMmary STATus:QUEStionable:INPut[1|3|5|6|7]:SUMMary:ENABle STATus:QUEStionable:INPut[1|3|5|6|7]:SUMMary:PTRansition STATus:QUEStionable:INPut[1|3|5|6|7]
STATus:QUEStionable Registers Conditions STATus:QUEStionable Registers Conditions STATus:QUEStionable Define: STAT QUES TEMP 201 Usage: Too hot. Set when over temperature is sensed.
Source Summary SOURce Summary Parameters: STAT QUES SOUR 204 Usage: Summary of STAT QUES SOUR SUMM *.
INSTrument Conditions INSTrument Conditions Table 3–15: INSTrument conditions Condition Definition Condition Number Summary bits Freeze active 401 Set when Freeze is active Condition definition Condition number Summary bits Input 1 Protected 600 Set when protection is enabled for the given input Input 2 Protected 601 Input 3 Protected 602 Input 4 Protected 603 Input 1 Unlocked 608 Input 2 Unlocked 609 Input 3 Unlocked 610 Input 4 Unlocked 611 Input 5 Unlocked 612 Input 6 Unlocke
INSTrument Conditions Table 3–16: INPut conditions (cont.
User Modifiable Conditions and Events User Modifiable Conditions and Events Table 3–17: User modifiable conditions Condition Definition Condition Number Summary bits or action User modifiable convent base 9000 User triggers User modifiable 0 9100 User modifiable 1 9101 User modifiable 2 9102 User modifiable 3 9103 User modifiable 4 9104 User modifiable 5 9105 User modifiable 6 9106 User modifiable 7 9107 Table 3–18: User modifiable events Event Definition Condition Number Summary bi
User Modifiable Conditions and Events Table 3–18: User modifiable events (cont.
Status Questionable Instrument Registers Status Questionable Instrument Registers STATus:QUEStionable:INSTrument[:EVENt]? STATus:QUEStionable:INSTrument:CONDition? STATus:QUEStionable:INSTrument:ENABle STATus:QUEStionable:INSTrument:PTRansition STATus:QUEStionable:INSTrument:NTRansition STATus:QUEStionable:INSTrument:MAP , AM700 Audio Measurement Set Programmer Manual 3–165
Status Questionable Source Registers Status Questionable Source Registers Suffixes: SOURce1 SOURce2 Analog generator HR A Analog generator HR B SOURce3 SOURce4 Analog generator HB A Analog generator HB B SOURce5 SOURce6 Digital generator DSF 1 Digital generator DSF 2 SOURce7 SOURce8 Digital Signal Processor A Digtial Signal Processor B STATus:QUEStionable:SOURce[1–8][:EVENt]? STATus:QUEStionable:SOURce[1–8]:CONDition? STATus:QUEStionable:SOURce[1–8]:ENABle STATus:QUEStionable:SOURc
Status Questionable Source Summary Registers Status Questionable Source Summary Registers Suffixes: SOURce1 SOURce2 Analog generator HR A Analog generator HR B SOURce3 SOURce4 Analog generator HB A Analog generator HB B SOURce5 SOURce6 Digital generator DSF 1 Digital generator DSF 2 SOURce7 SOURce8 Digital Signal Processor A Digtial Signal Processor B STATus:QUEStionable:SOURce[1–8]:SUMMary[:EVENt]? STATus:QUEStionable:SOURce[1–8]:SUMMary:CONDition? STATus:QUEStionable:SOURce[1–8]:SUMMary:ENABle <
SYSTem Subsystem SYSTem Subsystem Usage: Commands under the COMMunicate node are used to set the communication parameters for the GPIB and RS232 interfaces and the remote connector. The COMMunicate commands are divided into those for the GPIB interface, those for the SERial interface, and those for the remote connector. There are two serial ports: COM1 and COM2, that require parameter settings.
SYSTem Subsystem GPIB port and it does not reply to controller commands. Off bus ceases remote communication between the AM700 and any other device on the bus. Query: SYST:COMM:GPIB[:SELF]:MODE? returns the current setting for the GPIB mode TLISTEN if it is in the TLISten mode. If the AM700 is in TONLY mode, it does not respond to any controller commands and no reply is sent. If the AM700 is off bus, no reply is sent.
SYSTem Subsystem Query: SYST:COMM:SER[1–2]:BITS? returns the stop bits setting, 1 or 2, for the designated serial port. *RST: 8 SYSTem:COMMunicate:SERial[1–2]:CONTrol:RTS ON|RFR|IBFull Usage: Sets or queries the selection for hardware handshaking of the data. ON means that the RTS line is always held high and corresponds to RTS/CTS off. IBFull and RFR mean the the same thing; use CTS and RTS together to provide flow control. RFR and IBFull both correspond to RTS/CTS on.
SYSTem Subsystem SYSTem:COMMunicate:SERial[1–2]:PACe XON|NONE Usage: Used to select either software data handshaking (XON/XOFF) or NONE. Query: SYST:COMM:SER[1–2]:PAC? *RST: NONE SYSTem:COMMunicate:SERial[1–2]:PARity[:TYPE] EVEN|ODD|ZERO|ONE|NONE Usage: Sets or queries the parity setting for the digital data words. Query: SYST:COMM:SER[1–2]:PAR:TYPE? *RST: NONE SYSTem:COMMunicate:RELay[:STATe] Usage: Used to set or query to state of the Remote relay on the rear panel of the AM700.
SYSTem Subsystem Must be . The month number value is rounded to the nearest integer from 1 to 12 inclusive. The numbers have the common correspondence to months: example 1 is January and 12 is December, etc. Must be . The day number is rounded to the nearest integer in the range of numbers based on the . The days of each month are tracked correctly and leap years will have February 29th.
SYSTem Subsystem SYSTem:KLOCk [0|1] Usage: SYST:KLOC 1 locks out the local keyboard inputs. When local lockout is activated, the “focus” button at the top right of the display changes to say “Remote (Unlock)”. Pressing the Enter button (located just to the right) also cancels the local lockout and assigns 0 to the SYST:KLOC state as does the SYST:KLOC 0 command. Query: SYST:KLOC? returns a 1 if local lockout is activated or 0 if local local lockout is not activated.
SYSTem Subsystem Must be a The second value is rounded to the nearest second in the range of 0 to 60. A number of 60 is allowed since rounding may cause a number greater than 59.5 to be rounded to 60. When this element is rounded to 60 it is set to 0, and the minute value is incremented. Carries that advance the time past 24 hours are rippled through the date. Query: syst:time? returns three number fields separated by commas. is a NR1 format number from 0 to 23.
TRACe Subsystem TRACe Subsystem A TRACe area is a named entity stored in instument memory. The content of the TRACe memory may be queried to output the trace data. The Audio Analyzer reference traces may now be assigned to, using the commands detailed below. However, there is no way to assign units or sources for the traces (such as THD vs Frequency). Therefore, if a trace is first assigned after the application is started, unitless numbers are assigned to a unitless trace.
TRACe Subsystem DIT_BAH_Z DIT_JSPECT FFT Analyzer Trace Data FFTMAG_1 FFTMAG_2 MT_CH1_DIST MT_CH1_LEV MT_CH1_XTALK MT_CH2_DIST MT_CH2_LEV MT_CH2_XTALK MT_D_LEV MT_D_PHASE Bit Activity Z Subframe (not viewed) Jitter Spectrum Trace Data FFT bin data of CH1 FFT bin data of CH2 Distortion + Noise of CH1 Level of CH1 Crosstalk on CH1 Distortion + Noise of CH2 Level of CH2 Crosstalk on CH2 Level Diff between CH1 and CH2 Phase Diff between CH1 and CH2 Audio Analyzer Trace Data (AME1 through AME4) AME1_1 Active
TRACe Subsystem THDN1 THDN2 WOW1 WOW2 THD + Noise on CH1 THD + Noise on CH2 Wow and Flutter on CH1 Wow and Flutter on CH2 Each of the real time traces have corresponding REF traces (for example FREQ1_REF or THDN2_REF) that can be set. Whenever any of the real time reference traces are set, the real-time box automatically changes to a delta mode for the current unit shown. Example: TRAC:DATA FREQ1_REF, 100 sets the reference value for the channel 1 frequency to 100 Hz.
TRACe Subsystem The units of the returned data pairs depend on the measurement setup in the view. The possible choices are: Frequency, Level, THD, THD+N, IMD, Phase Diff, Separation, Crosstalk + Noise, and Level Difference versus either Frequency or Level. The default units for the traces follow those of the real-time measurements units.
TRACe Subsystem TRACe:DATA ,[X,Y]{,X,Y} Usage: TRAC:DATA can be used to assign new values to the measurement trace and available reference traces. Previous trace values are discarded. For XY plots, the numbers that are assigned are XY pairs. Example: TRAC:DATA AME1_REF,10000,0.5,15000,0.25 sets the reference trace for the first measurement to two points (presumably level versus frequency).
TRACe Subsystem the Audio Analyzer traces and the multitone traces. The fft trace queries return the amplitude of the data, in dBu, in each bin only for each of the bins and the monitor traces return the amplitude of the data points. You should always check the number of data points if you ever query the trace data for monitor. The compressed (unzoomed) display may contain up to 2 seconds worth of data points at the sampling rate.
TRIGger Subsystem TRiGger Subsystem The trigger subsystem in the AM700 contains commands only to start and stop a sweep. If a change to a list or sweep is made after a sweep is started, that sweep must either finish naturally or be terminated with STOP before the change is effected and a new sweep started; the change will not be seen in the middle of a sweep in progress. STARt Usage: Starts a sweep. STOP Usage: Stops a sweep.
UNIT Subsystem UNIT Subsystem Default units are defined, where applicable, for each SCPI command. The UNIT subsystem provides a mechanism to change the default values. The units selected apply to the designated command parameters for both command and response, but NOT to the displayed units in the AM700 displays. AM700 Use of the Unit Subsystem Example: A simple version of the UNIT subsystem is in place in the AM700.
UNIT Subsystem UNIT:IMPedance [Ohm|kOhm] Usage: Sets or queries the unit associated with an IMPedance query reply or command entry. Query: unit:imp? returns the current IMPedence unit setting as Ohm or kOhm. *RST: Sets the impedance unit to Ohm. UNIT:RATio [PCT|DB] Usage: Sets or queries the unit associated with a RATio query reply or command entry. Query: UNIT:RAT? returns the current unit setting for ratio as either % or dB.
UNIT Subsystem dBv is a voltage ratio between the measured voltage and 1 V. dBFS is a voltage ratio between the measured voltage and the full scale voltage calibration factor CAL:VOLT:FS. It is primarily intended for digital levels. Query: UNIT:VOLT? returns the current unit setting associated with a VOLTage query reply or command entry. *RST: Sets the VOLTage unit to V.
Examples
Examples The example given here is based on writing a function. Functions can be learned through the front panel, but they may also be written externally to the AM700 Audio Measurement Set loaded when needed. Functions are a list of SCPI (Tcl) commends used to direct the measurements of the audio measurement set. Writing a Function Functions may be created externally to the AM700 using Tcl programming and loaded through the floppy disk drive into the file system of the AM700.
Examples The Tcl parser looks first to see if it is a Tcl command that it knows about; if so, it runs it as a Tcl command. If not, the parser looks for an *, a ?, or a : in the command lines to see if it is a SCPI command. Putting the letters “scpi” in front of the SCPI commands immediately tells the Tcl parser that it is a SCPI command and passes it to the SCPI parser. The example function program shown uses some of the commands that may be needed to change application, signals, and displays.
Examples +!"%+ )')2!+ %-%0!2.0 /321 12$.32 ” )')2!+ ” %2 2(% 2. )21 $%&!3+2 12!2%1 1#/) %+%#2 2(% $)')2!+ '%-%0!2.0 &.0 ,%!130%,%-2 (!1 !-$ (!1 1#/) 1%-1 1#/) 1%-1 %+%#2 2(% 2%12 1)'-!+ 2. "% '%-%0!2%$ &.++.51 "6 $%&!3+2 1#/) !*% 130% 2(% $)')2!+ )-/32 /!2( )1 2(% &0.-2 /!-%+ #.--%#2.0 1#/) 30- .- 2(% '%-%0!2.
Examples Running a Function Function are stored in two different directories in the AM700. Those stored in rom:/function are permanently stored for specific purposes by the factory. Those stored in nvram:/function are user generated. From the front panel, stored functions may be started using menu choices called up by the Function button.
Examples 3. Use the PROG:SEL:STAT RUN command to start the named function. Send PROG:SEL:STAT STOP to stop the running function if is is not self terminating. Timed Functions A timed function may be set to run at certain times by setting a time for it to start using the PROGram commands. The PROG:SEL:NAME command names the file that a following PROG:SEL:TIMed:SET command associates with the cron_string or strings that are given.
Examples An * in a field means to do it on all occurrence. An exception to the * usage is that if both the day of the week and the day of the month fields have an * it just means “every day.” If only one of these two fields has an *, that field is ignored, and if neither has an *, both fields are used. Example: 0 0,12 * * * specifies a time of midnight and noon every day.
Examples Usage: Displays the message in a notifier on the screen, requiring one of the buttons to be pressed. The argument is a semicolon-separated list of button names. There are different kinds of notifiers, though `notifier' `warning' and 'error' look alike to the Tcl parser. If 'wait' is specified, the command returns only after a button has been pressed, and the return value of the command is the number of the button that was pressed (the numbering starts with 1).
Examples can be used for. The user can use these to signal between functions concurrently or consecutively running. Command: cp Usage: Copy a file from one location to another. cp Command: Usage: event Usage string returned from Tcl: usage: event trigger event wait The is one of those documented. The user-modifiable events (on which trigger can be used) are numbered 9200 through 9207.
Index
Index A Accessories, Remote Control, 1–1 AM700 SCPI Control Model, 1–17 AMEasure Subsystem, 1–28, 3–7 Analog Signal Path, 1–18 arbitrary block data, 3–93 Auto Range, 1–23 C calculate blocks, 1–25, 1–26 CALCulate Subsystem, 1–25, 3–33 CALibration Subsystem, 3–39 CMODe Subsystem, 3–41 COM1 and COM2 Connectors, 1–8 Command Notation, 3–4 command path, syntax, 3–4 Command Subsystems, 2–1 Commands IEEE 488.
Index F L FFT Analyzer, Multitone measurements, 1–27 File Names, 3–82 Capacity, 3–82 File Structure, 3–82 FORMat Subsystem, 3–68 Functions PROGram Subsystem, 3–93 running, 4–4 startup.
Index R T range setting, 1–23 references, 2–4 Remote Connector, 1–8 ROUTe Subsystem, 3–102 Route Subsystem, 1–21 Route suffixes, 1–21 Tcl Commands, 1–2 in functions, 4–1 programming changes, 4–6 TIFF, 1–16 Timed Functions, running, 4–5 TRACe Subsystem, 1–28, 3–175 TRIGger Subsystem, 3–181 S SCPI, 1–1 AM700 Model, 1–17 Background Information, 2–3–2–6 Functional Areas, 1–17 Implemented Command Subsystems, 2–1 SCPI Version, 2–1 screen dumps, 1–16 selected, 3–93 SENSe Subsystem, 3–104 Sense Subsystem, 1–24
Index Index–4 AM700 Audio Measurement Set Programmer Manual