Programmer's Quick Reference Agilent 83480A Analyzer, Agilent 54750A Oscilloscope Agilent part number: 83480-90052 Printed in USA June 2000 Agilent Technologies Lightwave Division 1400 Fountaingrove Parkway Santa Rosa, CA 95403-1799, USA (707) 577-1400 Notice This manual and any information contained herein are provided \as is" and are subject to change without notice. Agilent Technologies makes no warranty of any kind with regard to this material, including but not limited to, the implied warranties of merchantability and tness for a particular purpose. Agilent Technologies shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. Copyright Agilent Technologies 2000 c All Rights Reserved. Reproduction, adaptation, or translation without prior written permission is prohibited, except as allowed under the copyright laws. HP and Hewlett-Packard are U.S. registered trademarks of Hewlett-Packard Company. About This Quick Reference This quick reference is intended for use by the experienced programmer. It contains a listing of all the programming commands. Refer to the Agilent 83480A, Agilent 54750A Programmer's Guide for detailed programming information. The following notation conventions are used in this book: computer All characters appearing in computer type are key words type and must be entered exactly as shown. CAPITAL Capital letters indicate the short form of a command. The LETTERS actual command is not case sensitive and can be entered in upper or lowercase. < > Characters appearing in angular brackets indicate values that are dened in the programmer's guide. [] Square brackets indicate that whatever occurs within the brackets is optional. fg Braces are used to clarify which elements are to be chosen from. j \Or", indicates a choice of exactly one element from a list (for example, j indicates or but not both). 3 4 Contents Common Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 7 Root Level Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 9 System Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 12 Acquire Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 13 Calibration Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 14 Channel Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 17 Disk Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 19 Display Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 20 FFT Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 23 Function Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 24 Hardcopy Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 27 Histogram Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 29 Limit Test Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 31 Marker Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 35 Mask Test Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 37 Measure Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 43 Pixel Memory Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 51 Service Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 52 Timebase Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 53 Trigger Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 55 TriggerN Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 56 Waveform Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 57 Waveform Memory Commands : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 61 5 6 Common Commands *CLS Clears the status data structures and the Request-for-OPC ag. *ESE[?]Sets the Standard Event Status Enable Register bits. *ESR? Reads the Standard Event Status Register. *IDN? Returns the instrument model number, option, serial number, and software version. *LRN[?] Sends a response message (learn string) that contains the instrument's current setup. *OPC[?] Sets the operation complete bit when all pending device operations have nished. *OPT[?] Returns the model number and serial number of the mainframe and all installed plug-in options. *RCL Recalls the state of the instrument from the specied save/recall register. *RST Places the instrument in a known state. *SAV Stores the current state of the instrument in a save/recall register. *SRE[?] Sets the Service Request Enable Register bits. 7 Common Commands *STB? Reads the Status Byte. *TRG Has the same eect as the Group Execute Trigger message (GET) or RUN command. *TST? Causes the instrument to perform a self-test and places a result in the output queue. *WAI Prevents the instrument from executing any further commands or queries until all currently executing commands are completed. 8 Root Level Commands :AER? Reads the Arm Event Register. :AUToscale Causes the instrument to evaluate all input signals and to nd the optimum conditions for displaying the signal. :BLANK fCHANnel j FUNCtion j WMEMory j PMEMory j FFT j HISTogramg Turns o an active channel, function, waveform memory, pixel memory, FFT, or histogram. :CDISplay Clears the display and resets all associated measurements. :DIGitize [ ] [, ] Initializes the selected channels, functions, or FFT to \unacquired," and then acquires them according to the current instrument settings. :ERASe [PMEMory ] Erases the specied pixel memory. :HEEN[?] Sets the Histogram Event Enable register. :HER? Reads the Histogram Event Register. :LER? Reads the Local (LCL) Event Register. :LTEE[?] Sets the Limit Test Event Enable register. :LTER? Returns the Limit Test Event Register. 9 Root Level Commands :MENU[?] fAPPLication j CHANnel j ACQuire j TIMebase j TRIGger j DISK j DISPlay j MARKer j MEASure j MATH j WAVeform j SETup j PRINt j HELP j UTILity j FFT j LTESt j HISTogram j MTESt j MEYEg Selects one of the menus on the front panel. :MERGe [PMEMory ] Stores the active display into the pixel memory. :MODel? fFRAMe j PLUGin g Returns the Agilent Technologies model number for the frame or plug-in. :MTEE[?] Sets the Mask Event Enable register. :MTER? Reads the Mask Event Register. :OPEE[?] Sets the Operation Status Enable register. :OPER? Reads the Operation Status Register. :PRINt Outputs a copy of the screen to a printer or other device destination specied in the Hardcopy subsystem. :RECall:SETup Recalls a setup. :RUN Places the instrument in the running state, in which waveforms are acquired according to the current settings. :SERial[?] fFRAMe j PLUGin g, Sets the serial number for the instrument frame or plug-in. :SINGle Causes the instrument to make a single acquisition when the next trigger event occurs. 10 Root Level Commands :STOP Causes the instrument to stop acquiring data for the active display. :STORe:PMEM1 PMEM1 Stores the current display in pixel memory 1. :STORe:SETup Saves the current instrument setup in setup memories 0 through 9. :STORe:WAVeform fCHANnel j FUNCtion j WMEMory j HISTogram j FFT g, fWMEMory g Copies a channel, function, stored waveform, histogram, or FFT to a waveform memory. :TEER[?] Sets the Trigger Event Enable Register. :TER? Reads the Trigger Event Register. :UEE[?] Sets the User Event Enable register. :UER? Reads the User Event Register. :VIEW fCHANnel j FUNCtion j WMEMory j PMEMory j HISTogram j FFTg Turns on a channel, function, pixel memory, waveform memory, histogram, or FFT. 11 System Commands :SYSTem:DATE[?] < day>, , Sets the date in the instrument. :SYSTem:DSP[?] Writes a quoted string, excluding quotes, to the advisory line of the instrument display. :SYSTem:ERRor? [fNUMBer j STRingg] Outputs the next error number in the error queue over the HP-IB. :SYSTem:HEADer[?] fON j 1 j OFF j 0g Species whether the instrument will output a header for query responses. :SYSTem:KEY[?] Simulates the pressing of a specied front-panel key. :SYSTem:LONGform[?] fON j 1 j OFF j 0g Species the format for query response headers. :SYSTem:SETup[?] Sets up the instrument, as dened by the data in the setup string from the controller. :SYSTem:TIME[?] , , Sets the time in the instrument. 12 Acquire Commands :ACQuire:AVERage[?] fON j 1 j OFF j 0g Controls averaging. :ACQuire:BEST fTHRuput j FLATnessg Improves step atness. Agilent 54750A only. :ACQuire:COUNt[?] Sets the number of averages. :ACQuire:POINts[?] fAUTO j g Species the requested record length for an acquisition. 13 Calibration Commands :CALibrate:FRAMe:CANCel Is equivalent to pressing the Cancel softkey when in the front-panel Calibrate Frame menu. This command cancels the calibration on the instrument mainframe. :CALibrate:FRAMe:CONTinue Is equivalent to pressing the front-panel CONTINUE softkey when in the Calibration Frame menu. This command continues the calibration on the instrument mainframe. :CALibrate:FRAMe:DATA[?] Sends the FRAMe data to the instrument. :CALibrate:FRAMe:DONE? Returns the pass/fail status of the last frame calibration. :CALibrate:FRAMe:LABel[?]