MDO4000B, MDO4000, MSO4000B, DPO4000B And MDO3000 Series Oscilloscopes Programmer Manual MDO4000 B MSO Oscilloscope Rev A
MDO4000-B-MSO-DPO4000B-and-MDO3000-Oscilloscope-Programmer-Manual-Rev-A
MDO4000-B-MSO-DPO4000B-and-MDO3000-Oscilloscope-Programmer-Manual-Rev-A
User Manual: Pdf
Open the PDF directly: View PDF 
.
Page Count: 1112
| Download | |
| Open PDF In Browser | View PDF |
xx ZZZ MDO4000B, MDO4000, MSO4000B, DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual *P077051006* 077-0510-06 xx ZZZ MDO4000B, MDO4000, MSO4000B, DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Revision A MSO4000B, DPO4000B, MDO4000 and MDO4000B models should have firmware version 3.10 or above to use some of the commands listed in this document. www.tektronix.com 077-0510-06 Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions. Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in all previously published material. Specifications and price change privileges reserved. TEKTRONIX and TEK are registered trademarks of Tektronix, Inc. Contacting Tektronix Tektronix, Inc. 14150 SW Karl Braun Drive P.O. Box 500 Beaverton, OR 97077 USA For product information, sales, service, and technical support: In North America, call 1-800-833-9200. Worldwide, visit www.tektronix.com to find contacts in your area. Table of Contents Getting Started Getting Started .................................................................................................... 1-1 New or Changed Functionality Updates that Impact the Programmatic Command Set ............. 1-2 Setting Up Remote Communications Hardware ......................................................... 1-5 Ethernet .................................................................................................. 1-5 USB....................................................................................................... 1-6 GPIB...................................................................................................... 1-8 Setting Up Remote Communications Software .......................................................... 1-9 Using VISA.............................................................................................. 1-9 Using the LXI Web Page and e*Scope ............................................................. 1-11 Using a Socket Server ................................................................................ 1-11 Documentation ........................................................................................ 1-13 Syntax and Commands Command Syntax................................................................................................. Command and Query Structure ............................................................................ Clearing the oscilloscope ................................................................................... Command Entry.............................................................................................. Constructed Mnemonics .................................................................................... Argument Types.............................................................................................. Command Groups .............................................................................................. Acquisition Command Group ............................................................................ Act on Event Command Group .......................................................................... AFG Command Group .................................................................................... Alias Command Group.................................................................................... ARB Command Group .................................................................................... Bus Command Group ..................................................................................... Calibration and Diagnostic Command Group .......................................................... Configuration Command Group.......................................................................... Cursor Command Group .................................................................................. Display Command Group................................................................................. DVM Command Group ................................................................................... Email Command Group ................................................................................... Ethernet Command Group ................................................................................ File System Command Group ............................................................................ Hard Copy Command Group ............................................................................. Histogram Command Group ............................................................................. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-1 2-1 2-3 2-3 2-5 2-7 2-11 2-11 2-11 2-13 2-13 2-14 2-15 2-18 2-20 2-23 2-24 2-25 2-26 2-27 2-27 2-28 2-29 i Table of Contents Horizontal Command Group ............................................................................. 2-29 Mark Command Group.................................................................................... 2-30 Mask Command Group ................................................................................... 2-31 Math Command Group.................................................................................... 2-35 Measurement Command Group .......................................................................... 2-36 Miscellaneous Command Group ......................................................................... 2-38 PictBridge Command Group ............................................................................. 2-40 Power Command Group .................................................................................. 2-41 RF Command Group ...................................................................................... 2-47 Save and Recall Command Group ....................................................................... 2-58 Search Command Group .................................................................................. 2-61 Status and Error Command Group ....................................................................... 2-74 Trigger Command Group ................................................................................. 2-75 Vertical Command Group................................................................................. 2-90 Video Picture Command Group .......................................................................... 2-92 Waveform Transfer Command Group ................................................................... 2-93 Transferring a Waveform from an Oscilloscope to a Computer ................................. 2-94 Transferring a Waveform from a Computer to an Oscilloscope’s Internal Reference Memory ........................................................................................... 2-97 Scaling Waveform Data .............................................................................. 2-99 Further Explanation of the Digital Collection .................................................... 2-100 Zoom Command Group .................................................................................. 2-108 Commands Listed in Alphabetical Order ................................................................... 2-109 Status and Events Status and Events ................................................................................................. Registers ...................................................................................................... Queues ........................................................................................................ Event Handling Sequence................................................................................... Synchronization Methods ................................................................................... 3-1 3-1 3-4 3-5 3-7 Appendices Appendix A: Character Set ..................................................................................... Appendix B: Reserved Words .................................................................................. Appendix C: Factory Defaults ................................................................................. Default Setup ................................................................................................ Appendix D: Waveform Transfer (WFMOutpre and CURVe Query) Examples ......................... Example 1: Analog Waveform (Channels 1–4) ......................................................... Example 2: Digital Waveform (Channels DO-D15) .................................................... Example 3: The Digital Collection with 4 Bytes Per Point and MagniVu Off....................... ii A-1 B-1 C-1 C-1 D-1 D-1 D-3 D-5 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Table of Contents Example 4: The Digital Collection with 8 Bytes Per Point and MagniVu Off....................... D-7 Example 5: The Digital Collection with 4 Bytes Per Point and MagniVu On ..................... D-10 Example 6: The Digital Collection with 8 Bytes Per Point and MagniVu On ..................... D-12 Example 7: RF Frequency Domain Waveform........................................................ D-14 Appendix E: Mask/Limit Command Sequence Examples .................................................. E-1 Example 1: Creating custom masks ...................................................................... E-1 Example 2: Modifying an existing mask................................................................. E-2 Example 3: Creating a limit (template) mask ........................................................... E-3 Appendix F: Search and Trigger Command Sequence Examples.......................................... F-1 Example 1: Single Threshold Edge Search .............................................................. F-1 Example 2: Single Threshold Edge Trigger ............................................................. F-2 Example 3: Dual Threshold Runt Search ................................................................ F-2 Example 4: Single Threshold Logic Search on Three Waveforms.................................... F-3 Appendix G: Application Module-enabled Commands ..................................................... G-1 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual iii Table of Contents List of Figures Figure 3-1: Figure 3-2: Figure 3-3: Figure 3-4: Figure 3-5: Figure 3-6: Figure 3-7: Figure 3-8: iv The Standard Event Status Register (SESR) .................................................... 3-1 The Status Byte Register (SBR) .................................................................. 3-2 The Device Event Status Enable Register (DESER) ........................................... 3-3 The Event Status Enable Register (ESER) ...................................................... 3-3 The Service Request Enable Register (SRER) .................................................. 3-4 Status and Event Handling Process............................................................... 3-6 Command Processing Without Using Synchronization ........................................ 3-9 Processing Sequence With Synchronization................................................... 3-10 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Table of Contents List of Tables Table 1-1: Updates to the MDO4000, MSO4000B, DPO4000B, and MDO3000 Series Oscilloscopes Table 1-2: USB Device Parameters ............................................................................ Table 2-1: Symbols for Backus-Naur Form ................................................................... Table 2-2: Command Message Elements ...................................................................... Table 2-3: Comparison of Header Off and Header On Responses .......................................... Table 2-4: End of Message Terminator ........................................................................ Table 2-5: Channel Mnemonics................................................................................. Table 2-6: Cursor Mnemonics .................................................................................. Table 2-7: Math Specifier Mnemonics ......................................................................... Table 2-8: Measurement Specifier Mnemonics ............................................................... Table 2-9: Reference Waveform Mnemonics ................................................................. Table 2-10: Numeric Arguments................................................................................ Table 2-11: Quoted String Argument .......................................................................... Table 2-12: Block Argument .................................................................................... Table 2-13: Acquisition Commands.......................................................................... Table 2-14: Act on Event ...................................................................................... Table 2-15: AFG Commands.................................................................................. Table 2-16: Alias Commands ................................................................................. Table 2-17: ARB Commands ................................................................................. Table 2-18: Bus Commands ................................................................................... Table 2-19: Calibration and Diagnostic Commands........................................................ Table 2-20: Configuration Commands ....................................................................... Table 2-21: Cursor Commands ............................................................................... Table 2-22: Display Commands .............................................................................. Table 2-23: DVM Commands................................................................................. Table 2-24: EmailCommands ................................................................................. Table 2-25: Ethernet Commands ............................................................................. Table 2-26: File System Commands ......................................................................... Table 2-27: Hard Copy Commands .......................................................................... Table 2-28: Histogram Commands ........................................................................... Table 2-29: Horizontal Commands ........................................................................... Table 2-30: Mark Commands ................................................................................. Table 2-31: Mask commands.................................................................................. Table 2-32: Math Commands ................................................................................. Table 2-33: Measurement Commands ....................................................................... Table 2-34: Miscellaneous Commands ...................................................................... Table 2-35: PictBridge Commands ........................................................................... Table 2-36: Power Commands ................................................................................ MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 1-3 1-7 2-1 2-2 2-3 2-5 2-6 2-6 2-6 2-6 2-6 2-7 2-7 2-8 2-11 2-12 2-13 2-14 2-14 2-15 2-19 2-20 2-23 2-25 2-25 2-26 2-27 2-28 2-29 2-29 2-30 2-30 2-32 2-35 2-36 2-38 2-40 2-41 v Table of Contents Table 2-37: RF Commands .................................................................................... 2-52 Table 2-38: Save and Recall Commands .................................................................... 2-59 Table 2-39: Status and Error Commands .................................................................... 2-74 Table 2-40: Trigger Commands............................................................................... 2-79 Table 2-41: Vertical Commands .............................................................................. 2-90 Table 2-42: Video Picture Commands ....................................................................... 2-93 Table 2-43: Example Command Sequence for Transferring Waveform Data from Oscilloscope to Computer ................................................................................................... 2-95 Table 2-44: Example Command Sequence for Transferring Waveform Data from Computer to Oscilloscope ................................................................................................ 2-98 Table 2-45: Digital Collection: 4 Byte Data................................................................ 2-101 Table 2-46: Digital Collection: 8 Byte Data................................................................ 2-102 Table 2-47: Waveform Transfer Commands................................................................ 2-103 Table 2-48: Zoom Commands ............................................................................... 2-108 Table 2-49: .................................................................................................... 2-121 Table 2-50: Supported display formats...................................................................... 2-164 Table 2-51: Channel Offset Range .......................................................................... 2-216 Table 2-52: DATa and WFMOutpre Parameter Settings .................................................. 2-267 Table 2-53: FPAnel:PRESS arguments ..................................................................... 2-319 Table 2-54: FPAnel:TURN arguments ...................................................................... 2-321 Table 2-55: Math expression elements ...................................................................... 2-399 Table 2-56: Available HDTV formats....................................................................... 2-889 Table 2-57: Waveform Suffixes .............................................................................. 2-938 Table 3-1: SESR Bit Functions ................................................................................. 3-2 Table 3-2: SBR Bit Functions................................................................................... 3-2 Table 3-3: Oscilloscope operations that can generate OPC .................................................. 3-8 Table 3-4: No Event Messages................................................................................ 3-14 Table 3-5: Command Error Messages (CME Bit 5) ........................................................ 3-14 Table 3-6: Execution Error Messages (EXE Bit 4) ......................................................... 3-15 Table 3-7: Device Error Messages (DDE Bit 3) ............................................................ 3-17 Table 3-8: System Event Messages........................................................................... 3-17 Table 3-9: Execution Warning Messages (EXE Bit 4) ..................................................... 3-18 Table 3-10: Execution Warning Messages (EXE Bit 4).................................................... 3-18 Table 3-11: Internal Warning Messages...................................................................... 3-19 Table C-1: Default Values ...................................................................................... C-1 vi MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Getting Started Getting Started This manual explains the use of commands for remotely controlling your oscilloscope. With this information, you can write computer programs to perform functions, such as setting the front-panel controls, taking measurements, performing statistical calculations, and exporting data for use in other programs. Familiarity with the User Manual for your oscilloscope is assumed. You can download the User Manual from the Tektronix website at www.tektronix.com. NOTE. Most examples in this document assume that both HEADer|:HDR and VERBose are set to ON. New in the Programmer Manual The following major changes were made to this version of the programmer manual (077-0510-06): Added MDO3000 series models: Model Analog Channels Analog Bandwidth Spectrum Analyzer Channel Digital Channels AFG Channels Maximum Record Length Aux Input connector MDO3012 2 100 MHz 1 at 9 kHz - 100 MHz 9 kHz - 3 GHz Optional 16 Optional 8.25 GS/s max 10 M Samples on all channels Y MDO3014 4 100 MHz 1 at 9 kHz - 100 MHz 9 kHz - 3 GHz Optional 1 Optional 50 MHz max. MDO3022 2 200 MHz 1 at 9 kHz - 200 MHz 9 kHz - 3 GHz Optional Y MDO3024 4 200 MHz 1 at 9 kHz - 200 MHz 9 kHz - 3 GHz Optional N MDO3032 2 350 MHz 1 at 9 kHz - 350 MHz 9 kHz - 3 GHz Optional Y MDO3034 4 350 MHz 1 at 9 kHz - 350 MHz 9 kHz - 3 GHz Optional N MDO3052 2 500 MHz 1 at 9 kHz - 500 MHz 9 kHz - 3 GHz Optional Y MDO3054 4 500 MHz 1 at 9 kHz - 500 MHz 9 kHz - 3 GHz Optional N MDO3102 2 1 GHz 1 at 9 kHz - 1 GHz 9 kHz - 3 GHz Optional Y MDO3104 4 1 GHz 1 at 9 kHz - 1 GHz 9 kHz - 3 GHz Optional N MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual N 1-1 Getting Started Each of the new MDO3000 series models have the following options available: Option Description MDO3AFG Arbitrary Function Generator MDO3MSO 16-channel digital acquisition MDO3SA Spectrum analyzer input range increased to 9 kHz - 3 GHz. MDO3SEC Add password protected security to enable or disable all communication ports and firmware upgrades to any MDO3000 series oscilloscope New or Changed Functionality Updates that Impact the Programmatic Command Set For your convenience, the table below lists the new and changed functionality that impacts the programmatic command set for the MDO4000B, MDO4000, MSO4000B, DPO4000B and MDO3000 Series Oscilloscopes, along with a hot-linked list of the applicable commands. NOTE. The terms “waveform” and “trace” are used interchangeably. 1-2 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Getting Started Table 1-1: Updates to the MDO4000, MSO4000B, DPO4000B, and MDO3000 Series Oscilloscopes Feature Use these commands Arbitrary Function Generator functionality (MDO3000 series only) AFG:AMPLitude AFG:FREQuency AFG:FUNCtion AFG:HIGHLevel AFG:LEVELPreset AFG:LOWLevel AFG:NOISEAdd:PERCent AFG:NOISEAdd:STATE AFG:OFFSet AFG:OUTPut:LOAd:IMPEDance AFG:OUTPut:STATE AFG:PERIod AFG:PHASe AFG:PULse:WIDth AFG:RAMP:SYMmetryAFG:SQUare:DUty Arbitrary Waveform Generator functionality (MDO3000 series only) – Sine, Square Pulse, Ramp and Noise functions available – Ability to save and recall to or from ARB slots and .csv files AFG:ARBitrary:ARB:DATE? AFG:ARBitrary:ARB :LABel AFG:ARBitrary:ARB :TIMe? AFG:ARBitrary:EMEM:FUNCtion? AFG:ARBitrary:EMEM:GENerate AFG:ARBitrary:EMEM:NUMPoints? AFG:ARBitrary:EMEM:POINTS AFG:ARBitrary:EMEM:POINTS:ENCdg SAVe:WAVEform RECAll:WAVEform Digital Voltmeter functionality (MDO3000 series only) DVM DVM:AUTORange DVM:DISPLAYSTYle DVM:MEASUrement:FREQuency? DVM:MEASUrement:HIStory:AVErage? DVM:MEASUrement:HIStory:MAXimum? DVM:MEASUrement:HIStory:MINImum? DVM:MEASUrement:INFMAXimum? DVM:MEASUrement:INFMINimum? DVM:MEASUrement:VALue? DVM:MODe DVM:SOUrce MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 1-3 Getting Started Table 1-1: Updates to the MDO4000, MSO4000B, DPO4000B, and MDO3000 Series Oscilloscopes (cont.) Feature Use these commands Act on Event functionality Available actions: – Stop acquisitions – Save waveform data to a file – Save a screen image to a file – Send a screen image to a printer – Send a pulse to the Aux Out port – Generate a service request – Send an email – Display a visual notification Available events: – Upon trigger – When a certain number of acquisitions have completed – None ACTONEVent:ACTION:AUXOUT:STATE ACTONEVent:ACTION:PRINT:STATE ACTONEVent:ACTION:SAVEIMAGE:STATE ACTONEVent:ACTION:SAVEWFM:STATE ACTONEVent:ACTION:SRQ:STATE ACTONEVent:REPEATCount ACTONEVent:ACTION:VISUAL:STATE ACTONEVent:EVENTTYPe ACTONEVent:NUMACQs ACTONEVent:REPEATCount Email settings for both email printer support and Act on Event “send an email” action EMAIL:SETUp:FROMADDRess EMAIL:SETUp:HOSTALIASNAMe EMAIL:SETUp:SMTPLOGIn EMAIL:SETUp:SMTPPASSWord EMAIL:SETUp:SMTPPort EMAIL:SETUp:SMTPServer Video Picture functionality (Standard on MDO3000. Requires the DPO4VID application module for use with MSO/DPO4000B, MDO4000 and MDO4000B models) VIDPic:AUTOContrast VIDPic:AUTOContrast:UPDATERate VIDPic:BRIGHTNess VIDPic:CONTRast VIDPic:DISplay VIDPic:FRAMETYPe VIDPic:LOCation:HEIght VIDPic:LOCation:OFFSet VIDPic:LOCation:STARt:LINE VIDPic:LOCation:STARt:PIXel VIDPic:LOCation:WIDth VIDPic:LOCation:X VIDPic:LOCation:Y VIDPic:SOUrce VIDPic:STANdard Dual edge trigger/search functionality TRIGger:A:EDGE:SLOpe SEARCH:SEARCH :TRIGger:A:EDGE:SLOpe 1-4 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Getting Started Table 1-1: Updates to the MDO4000, MSO4000B, DPO4000B, and MDO3000 Series Oscilloscopes (cont.) Feature Use these commands FastAcq™ high-speed waveform acquisition mode New color palettes (Temperature, Spectral, Normal, Inverted) ACQuire:FASTAcq:STATE ACQuire:FASTAcq:PALEtte Digital Channel Activity Monitor DISplay:DIGital:ACTIVity Additional calibration status queries CALibrate:INTERNal:STATus:RF? CALibrate:INTERNal:STATus:SCOPE? CALibrate:RESults:FACtory:AFG? CALibrate:RESults:FACtory:RF? CALibrate:RESults:FACtory:SCOPE? CALibrate:RESults:SPC:RF? CALibrate:RESults:SPC:SCOPE? Additional configuration queries (AFG, ARB, DVM, and VidPic are available for MDO3000 series. VidPic requires the DPO4VID application module for use with MSO/DPO4000B, MDO4000 and MDO4000B models) CONFIGuration:AFG? CONFIGuration:APPLications:CUSTOMMask? CONFIGuration:APPLications:STANDARDMask? CONFIGuration:APPLications:VIDPIC? CONFIGuration:ARB? CONFIGuration:DVM? Math vertical autoscale feature MATH[1]:AUTOSCale Total overshoot measurement type MEASUrement:IMMed:TYPe MEASUrement:MEAS :TYPe Additional RF Spectrogram and Spectrum Trace commands RF:SPECTRogram RF:SPECTRogram:SLICETIMe? RF:SPECTRogram:TIMe? RF:SPECTRUMTrace Ability to save RF baseband I & Q data to a Matlab level 5 file or .TIQ file SAVe:WAVEform:FILEFormat:RF_BB_IQ Setting Up Remote Communications Hardware You can remotely control communications between your oscilloscope and a PC via Ethernet, USB, or GPIB cables. Ethernet If you are using Ethernet, start by connecting an appropriate Ethernet cable to the Ethernet port (RJ-45 connector) on the rear panel of your oscilloscope. This connects the oscilloscope to a 10BASE-T/100BASE-TX/1000BASE-T local area network. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 1-5 Getting Started To change the Ethernet settings on your oscilloscope, do the following: 1. On the front panel, push Utility. 2. Push Utility Page. 3. Select I/O with the Multipurpose knob. 4. Push Network Configuration. 5. On the side menu, if you are on a DHCP Ethernet network and using a through cable, push Automatic (DHCP & Auto-IP). 6. If you are using a cross-over cable, push Manual, and press Set IP Addresses Manually to set a hard coded TCP/IP address. USB 1-6 If you are using USB, start by connecting the appropriate USB cable to the USB 2.0 high-speed (HS) device port on the rear panel of your oscilloscope. This port requires that the cable connected from the port to the host computer meets the USB 2.0 specification for high speed connections. Typically, such cables should be 3 feet or shorter in length, but this is determined by the quality of the cable and, with higher quality cables, this length can be extended. (It is also dependent upon the drive capability of the host USB port to which the instrument is connected.) The use of high quality short cables is recommended to avoid USB connection problems. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Getting Started With USB, the system automatically configures itself. To verify that the USB is enabled: 1. On the front panel, push Utility. 2. Push Utility Page. 3. Select I/O with the Multipurpose knob. 4. Push USB, and verify that USB is enabled. 5. If USB is disabled, push Connect to Computer on the side menu. After connection, the host, with appropriate software, can list the oscilloscope as a USB device with the following parameters: (See Table 1-2.) Table 1-2: USB Device Parameters Parameter Value Manufacturer ID 0x0699 (decimal 1689) Product ID The product id varies by model number as follows: (You can send the USBTMC:PRODUCTID:HEXadecimal? query to read the value) DPO4104B 0x0405 (decimal 1029) DPO4054B 0x0406 (decimal 1030) DPO4034B 0x0407 (decimal 1031) MSO4104B 0x0409 (decimal 1033) MSO4054B 0x040A (decimal 1034) MSO4034B 0x040B (decimal 1035) MDO4104-6 0x040C (decimal 1036) MDO4104-3 0x040D (decimal 1037) MDO4054-6 0x040E (decimal 1038) MDO4054-3 0x040F (decimal 1039) DPO4102B 0x0417 (decimal 1047) DPO4102B-L 0x0418 (decimal 1048) DPO4104B-L 0x0419 (decimal 1049) MSO4102B 0x041A (decimal 1050) MSO4102B-L 0x041B (decimal 1051) MSO4104B-L 0x041C (decimal 1052) DPO4014B 0x0426 (decimal 1062) MSO4014B 0x0428 (decimal 1064) MDO4014-3 0x042a (decimal 1066) MDO4034-3 0x042e (decimal 1070) MDO3000 (all) 0x408 (decimal 1032) Serial number Serial number Manufacturer description “Tektronix” Interface description “USBTMC-USB488” MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 1-7 Getting Started GPIB To use GPIB (General Purpose Interface Bus), start by connecting an appropriate USB cable to the USB 2.0 high-speed (HS) device port on the rear panel of your oscilloscope. Connect the other end to the TEK-USB-488 Adapter host port. Then connect a GPIB cable from the TEK-USB-488 Adapter to your PC. Supply power to the Adapter in either of these two ways: 1. Use the optional 5 VDC power adapter connected to the 5 VDC power input on the Adapter. 2. Use an appropriate USB cable connected to a powered USB host port on your PC and the Device port on the TEK-USB-488 Adapter. The oscilloscope has a USB 2.0 high-speed (HS) device port to control the oscilloscope through USBTMC or GPIB with a TEK-USB-488 Adapter. The USBTMC protocol allows USB devices to communicate using IEEE488 style messages. This lets you run your GPIB software applications on USB hardware. Before setting up the oscilloscope for remote communication using the electronic (physical) GPIB interface, you should familiarize yourself with the following GPIB requirements: A unique device address must be assigned to each device on the bus. No two devices can share the same device address. No more than 15 devices can be connected to any one line. One device should be connected for every 6 feet (2 meters) of cable used. No more than 65 feet (20 meters) of cable should be used to connect devices to a bus. At least two-thirds of the devices on the network should be powered on while using the network. Connect the devices on the network in a star or linear configuration. Do not use loop or parallel configurations. To function correctly, your oscilloscope must have a unique device address. The default setting for the GPIB configuration is GPIB Address 1. 1-8 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Getting Started To change the GPIB address settings, do the following: 1. On the front panel, push Utility. 2. Push Utility Page. 3. Select I/O with the Multipurpose knob. 4. Push GPIB. 5. Enter the GPIB address on the side menu, using the multipurpose knob. This will set the GPIB address on an attached TEK-USB-488 Adapter. The oscilloscope is now set up for bidirectional communication with your controller. Setting Up Remote Communications Software Connect your oscilloscope directly to a computer to let the PC analyze your data, collect screen images, or to control the oscilloscope using a program of your own creation. Three ways to connect your oscilloscope to a computer are through the VISA drivers, the e*Scope Web-enabled tools, or via a socket server. Using VISA VISA lets you use your MS-Windows computer to acquire data from your oscilloscope for use in an analysis package that runs on your PC, such as Microsoft Excel, National Instruments LabVIEW, Tektronix OpenChoice Desktop software, or your own custom software. You can use a common communications connection, such as USB, Ethernet, or GPIB, to connect the computer to the oscilloscope. To set up VISA communications between your oscilloscope and a computer: MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 1-9 Getting Started 1. Load the VISA drivers on your computer. Also, load your application, such as OpenChoice Desktop. You will find the drivers and OpenChoice Desktop software on the appropriate CD that comes with your oscilloscope or at the Tektronix software finder Web page (www.tektronix.com\downloads). 2. Connect the oscilloscope to your computer with the appropriate USB or Ethernet cable. To communicate between the oscilloscope and a GPIB system, connect the oscilloscope to the TEK-USB-488 GPIB-to-USB Adapter with a USB cable. Then connect the adapter to your GPIB system with a GPIB cable. Cycle the power on the oscilloscope. 3. Push Utility. 4. Push Utility Page. 5. Turn multipurpose knob a and select I/O. 6. If you are using USB, the system sets itself up automatically for you, if USB is enabled. Check USB on the lower menu to be sure that USB is enabled. If it is not enabled, push USB. Then push Connect to Computer on the side menu. 7. To use Ethernet, push Ethernet & LXI on the lower menu. Use the side menu buttons to adjust your network settings, as needed. For more information, see the e*Scope setup information below. 8. If you want to change socket server parameters, push Socket Server and enter new values through the resulting side menu. 9. If you are using GPIB, push GPIB. Enter the GPIB address on the side menu, using multipurpose knob a. This will set the GPIB address on an attached TEK-USB-488 Adapter. 10. Run your application software on your computer. Quick Tips Your oscilloscope shipped with a CD containing a variety of Windows-based software tools for efficient connectivity between your oscilloscope and your computer. These include toolbars that speed connectivity with Microsoft Excel and Word. There are also two standalone acquisition programs called NI LabVIEW SignalExpress™, Tektronix Edition and Tektronix OpenChoice Desktop. The rear-panel USB 2.0 high-speed (HS) device port is the correct USB port for computer connectivity. Use the rear- and front-panel USB 2.0 host ports to connect your oscilloscope to USB flash drives, hard drives, printers and keyboards. Use the USB Device port to connect your oscilloscope to a PC or a PictBridge printer. 1-10 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Getting Started Using the LXI Web Page and e*Scope With e*Scope, you can access any Internet-connected MSO/DPO4000B, MDO4000/B or MDO3000 Series oscilloscope from a web browser. To set up e*Scope communications between your oscilloscope and a Web browser running on a remote computer: 1. Connect the oscilloscope to your computer network with an appropriate Ethernet cable. 2. Push Utility. 3. Push Utility Page. 4. Turn multipurpose knob a and select I/O. 5. Push Ethernet & LXI. 6. On top of the side menu, there is an indicator light which turns green for good status and red if the device detects a fault. Look at it to determine the condition of the LAN. 7. Push LAN Settings to display the network parameters configured on your oscilloscope. 8. Push LAN Reset to restore the LAN defaults to your oscilloscope. 9. Push Test Connection to check if your oscilloscope can find an attached network. 10. Push More to see another page of side-menu items. 11. Push Change Names to change the name of the oscilloscope, the network domain, or the service name. 12. Push Change Ethernet & LXI Password to use the LXI password to also protect your oscilloscope from changes made to LAN settings from a Web browser. 13. Start your browser on your remote computer. In the browser address line, enter the host name, a dot, and the domain name together. Alternatively, just enter the IP address of the instrument. Either way, you should then see the LXI Welcome page on your Web browser on your computer screen. 14. Click “Network Configuration” to view and edit the network configuration settings. If you are using a password and changing your settings, you need to know that the default user name is “lxiuser”. 15. For e*Scope, click the Instrument Control (e*Scope) link on the left side of the LXI Welcome page. You should then see a new tab (or window) open in your browser with e*Scope running. Using a Socket Server A socket server provides two-way communication over an Internet Protocol-based computer network. You can use your oscilloscope’s socket server feature to let your oscilloscope talk to a remote-terminal device or computer. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 1-11 Getting Started To set up and use a socket server between your oscilloscope and a remote terminal or computer: 1. Connect the oscilloscope to your computer network with an appropriate Ethernet cable. 2. Push Utility. 3. Push Utility Page. 4. Turn multipurpose knob a and select I/O. 5. Push Socket Server. 6. On the resulting Socket Server side menu, push the top entry to highlight Enabled. 7. Choose whether the protocol should be None or Terminal. A communication session run by a human at a keyboard typically uses a terminal protocol. An automated session might handle its own communications without using such a protocol. 8. If required, change the port number by rotating multipurpose knob a. 9. If required, press OK to set the new port number. 10. After setting up the socket server parameters, you can now have the computer “talk” to the oscilloscope. If you are running an MS Windows PC, you could run its default client with its command-like interface. One way to do this is by typing “ Telnet ” in the Run window. The Telnet window will open on the PC. NOTE. On MS Windows 7, you must first enable Telnet in order for it to work. 11. Start a terminal session between your computer and your oscilloscope by typing in an open command with the oscilloscope's LAN address and port #. You can obtain the LAN address by pushing the Ethernet & LXI bottom menu item and the resulting LAN Settings side menu item to view the resulting Ethernet and LXI Setting screen. You can obtain the port # by pushing the Socket Server bottom menu item and viewing the Current Port side menu item. For example, if the oscilloscope IP address was 123.45.67.89 and the port # was the default of 4000, you could open a session by writing into the MS Windows Telnet screen: o 123.45.67.89 4000 The oscilloscope will send a help screen to the computer when it is done connecting. 1-12 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Getting Started 12. You can now type in a standard query, as found in the programmer manual, such as *idn? The Telnet session window will respond by displaying a character string describing your instrument. You can type in more queries and view more results on this Telnet session window. You can find the syntax for relevant queries and related status codes in other sections of this manual. NOTE. Do not use the computer’s backspace key during an MS Windows' Telnet session with the oscilloscope. Socket Server Terminal Protocol Mode Commands. Following are Tektronix Instrument Control Terminal Session Control commands: !t : set the response timeout in milliseconds. !d : send device clear to the instrument. !r : read response from instrument. !h : print this usage info. NOTE. Commands containing a ? are treated as queries, and the responses are read automatically. Documentation The following documents are available for download at www.tektronix.com: MDO4000B Series Mixed Domain Oscilloscopes User Manual. Information about installing and operating the oscilloscope. MDO4000B Series Mixed Domain Oscilloscopes Specifications and Performance Verification Technical Reference. Oscilloscope specifications and a performance verification procedure. MDO4000 Series Mixed Domain Oscilloscopes User Manual. Information about installing and operating the oscilloscope. MDO4000 Series Mixed Domain Oscilloscopes Specifications and Performance Verification Technical Reference. Oscilloscope specifications and a performance verification procedure. MSO4000B and DPO4000B Series Digital Phosphor Oscilloscopes User Manual. Information about installing and operating the oscilloscope. MSO4000B and DPO4000B Series Digital Phosphor Oscilloscopes Technical Reference. Oscilloscope specifications and a performance verification procedure. MDO3000 Series Mixed Domain Oscilloscopes User Manual. Information about installing and operating the oscilloscope. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 1-13 Getting Started MDO3000 Series Mixed Domain Oscilloscopes Specifications and Performance Verification Technical Reference. Oscilloscope specifications and a performance verification procedure. Getting Started with OpenChoice ™ Solutions Manual. Options for getting data from your oscilloscope into any one of several available analysis tools. TekVISA Programmer Manual. Description of TekVISA, the Tektronix implementation of the VISA Application Programming Interface (API). TekVISA is industry-compliant software for writing interoperable oscilloscope drivers in a variety of Application Development Environments (ADEs). 1-14 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Syntax and Commands Command Syntax You can control the operations and functions of the oscilloscope through the Ethernet port or the USB 2.0 high-speed (HS) device port using commands and queries. The related topics listed below describe the syntax of these commands and queries. The topics also describe the conventions that the oscilloscope uses to process them. See the Command Groups topic in the table of contents for a listing of the commands by command group, or use the index to locate a specific command. Backus-Naur Form Notation This documentation describes the commands and queries using Backus-Naur Form (BNF) notation. Refer to the following table for the symbols that are used. Table 2-1: Symbols for Backus-Naur Form Symbol <> Meaning = Is defined as | Exclusive OR {} Group; one element is required [] .. . Optional; can be omitted Defined element Previous element(s) may be repeated Command and Query Structure Commands consist of set commands and query commands (usually called commands and queries). Commands modify oscilloscope settings or tell the oscilloscope to perform a specific action. Queries cause the oscilloscope to return data and status information. Most commands have both a set form and a query form. The query form of the command differs from the set form by its question mark at the end. For example, the set command ACQuire:MODe has a query form ACQuire:MODe?. Not all commands have both a set and a query form. Some commands have set only and some have query only. Messages A command message is a command or query name followed by any information the oscilloscope needs to execute the command or query. Command messages may contain five element types, defined in the following table. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-1 Command Syntax Table 2-2: Command Message Elements Commands Symbol Meaning This is the basic command name. If the header ends with a question mark, the command is a query. The header may begin with a colon (:) character. If the command is concatenated with other commands, the beginning colon is required. Never use the beginning colon with command headers beginning with a star (*). This is a header subfunction. Some command headers have only one mnemonic. If a command header has multiple mnemonics, a colon (:) character always separates them from each other. This is a quantity, quality, restriction, or limit associated with the header. Some commands have no arguments while others have multiple arguments. A separates arguments from the header. A separates arguments from each other. A single comma is used between arguments of multiple-argument commands. Optionally, there may be white space characters before and after the comma. A white space character is used between a command header and the related argument. Optionally, a white space may consist of multiple white space characters. Commands cause the oscilloscope to perform a specific function or change one of the settings. Commands have the structure: [:] [ [ ]...] A command header consists of one or more mnemonics arranged in a hierarchical or tree structure. The first mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off the previous one. Commands at a higher level in the tree may affect those at a lower level. The leading colon (:) always returns you to the base of the command tree. 2-2 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Syntax Queries Queries cause the oscilloscope to return status or setting information. Queries have the structure: [:] [:] [ [ ]...] You can specify a query command at any level within the command tree unless otherwise noted. These branch queries return information about all the mnemonics below the specified branch or level. Headers Use the HEADer command to control whether the oscilloscope returns headers as part of the query response. If header is on, the query response returns command headers, then formats itself as a valid set command. When header is off, the response includes only the values. This may make it easier to parse and extract the information from the response. The table below shows the difference in responses. Table 2-3: Comparison of Header Off and Header On Responses Query Header Off Header On TIME? 14:30:00 :TIME “14:30:00” ACQuire:NUMAVg? 100 :ACQUIRE:NUMAVG 100 Clearing the oscilloscope You can clear the Output Queue and reset the oscilloscope to accept a new command or query by using the selected Device Clear (DCL) function. Command Entry The following rules apply when entering commands: You can enter commands in upper or lower case. You can precede any command with white space characters. White space characters include any combination of the ASCII control characters 00 through 09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal). The oscilloscope ignores commands consisting of any combination of white space characters and line feeds. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-3 Command Syntax Abbreviating You can abbreviate many oscilloscope commands. Each command in this documentation shows the minimum acceptable abbreviations in capitals. For example, you can enter the command ACQuire:NUMAvg simply as ACQ:NUMA or acq:numa. Abbreviation rules may change over time as new oscilloscope models are introduced. Thus, for the most robust code, use the full spelling. If you use the HEADer command to have command headers included as part of query responses, you can further control whether the returned headers are abbreviated or are full-length with the VERBose command. Concatenating You can concatenate any combination of set commands and queries using a semicolon (;). The oscilloscope executes concatenated commands in the order received. When concatenating commands and queries, you must follow these rules: 1. Separate completely different headers by a semicolon and by the beginning colon on all commands except the first one. For example, the commands TRIGger:MODe NORMal and ACQuire:NUMAVg 8, can be concatenated into the following single command: TRIGger:MODe NORMal;:ACQuire:NUMAVg 8 2. If concatenated commands have headers that differ by only the last mnemonic, you can abbreviate the second command and eliminate the beginning colon. For example, you can concatenate the commands ACQuire:MODe ENVelope and ACQuire:NUMAVg 8 into a single command: ACQuire:MODe ENVelope; NUMAVg 8 The longer version works equally well: ACQuire:MODe ENVelope;:ACQuire:NUMAVg 8 3. Never precede a star (*) command with a colon: ACQuire:STATE 1;*OPC Any commands that follow will be processed as if the star command was not there so the commands, ACQuire:MODe ENVelope;*OPC;NUMAVg 8 will set the acquisition mode to envelope and set the number of acquisitions for averaging to 8. 4. When you concatenate queries, the responses to all the queries are concatenated into a single response message. For example, if the display graticule is set to Full and the display style is set to dotsonly, the concatenated query DISplay:GRAticule?;STYle:DOTsonly? will return the following. If the header is on: DISPLAY:GRATICULE FULL;:DISPLAY:STYLE:DOTSONLY 1 2-4 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Syntax If the header is off: FULL;1 1. Set commands and queries may be concatenated in the same message. For example, ACQuire:MODe SAMple;NUMAVg?;STATE? is a valid message that sets the acquisition mode to sample. The message then queries the number of acquisitions for averaging and the acquisition state. Concatenated commands and queries are executed in the order received. Here are some invalid concatenations: DISPlay:STYle:DOTsonly OFF;ACQuire:NUMAVg 8 (no colon before ACQuire) DISPlay:GRAticule FULL;:STYle:DOTSONLY OFF (extra colon before STYle. DISPlay:GRAticule FULL;:*TRG (colon before a star (*) command) MATH:HORizontal:SCAle 1.0e-1;HORizontal:POSition 5.0el (levels of the mnemonics are different; either remove the second use of HORizontal: or place :MATH in front of HORizontal:POSition) Terminating This documentation uses (End of Message) to represent a message terminator. Table 2-4: End of Message Terminator Symbol Meaning Message terminator The end-of-message terminator must be the END message (EOI asserted concurrently with the last data byte). The last data byte may be an ASCII line feed (LF) character. This oscilloscope does not support ASCII LF only message termination. The oscilloscope always terminates outgoing messages with LF and EOI. Constructed Mnemonics Some header mnemonics specify one of a range of mnemonics. For example, a channel mnemonic can be CH1, CH2, CH3, or CH4. You use these mnemonics in the command just as you do any other mnemonic. For example, there is a CH1:POSition command, and there is also a CH2:POSition command. In the command descriptions, this list of choices is abbreviated as CH . MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-5 Command Syntax Cursor Position Mnemonics When cursors are displayed, commands may specify which cursor of the pair to use. Table 2-5: Channel Mnemonics Symbol Meaning CH A channel specifier; is 1 through 4. Table 2-6: Cursor Mnemonics Math Specifier Mnemonics Symbol Meaning CURSOR A cursor selector; is either 1 or 2. POSITION A cursor selector; is either 1 or 2. HPOS A cursor selector; is either 1 or 2. Commands can specify the mathematical waveform to use as a mnemonic in the header. Table 2-7: Math Specifier Mnemonics Measurement Specifier Mnemonics Symbol Meaning Math A math waveform specifier; is 1. Commands can specify which measurement to set or query as a mnemonic in the header. Up to eight automated measurements may be displayed. Table 2-8: Measurement Specifier Mnemonics Symbol Meaning MEAS A measurement specifier; is 1 through 8. Channel Mnemonics Commands specify the channel to use as a mnemonic in the header. Reference Waveform Mnemonics Commands can specify the reference waveform to use as a mnemonic in the header. Table 2-9: Reference Waveform Mnemonics 2-6 Symbol Meaning REF A reference waveform specifier; is 1, 2, 3, or 4 for 4-channel oscilloscopes and 1 or 2 for 2-channel oscilloscopes. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Syntax Argument Types Commands use arguments such as enumeration, numeric, quoted string and block. Each of these arguments are listed in detail below. Enumeration Enter these arguments as unquoted text words. Like key words, enumeration arguments follow the same convention where the portion indicated in uppercase is required and that in lowercase is optional. For example: SAVe:WAVEform:FILEFormat INTERNal Numeric Many oscilloscope commands require numeric arguments. The syntax shows the format that the oscilloscope returns in response to a query. This is also the preferred format when sending the command to the oscilloscope, though any of the formats will be accepted. This documentation represents these arguments as described below. Table 2-10: Numeric Arguments Symbol Meaning Signed integer value Floating point value without an exponent Floating point value with an exponent Signed or unsigned integer in binary format Most numeric arguments will be automatically forced to a valid setting, by either rounding or truncating, when an invalid number is input, unless otherwise noted in the command description. Quoted String Some commands accept or return data in the form of a quoted string, which is simply a group of ASCII characters enclosed by a single quote (') or double quote ("). The following is an example of a quoted string: "This is a quoted string". This documentation represents these arguments as follows: Table 2-11: Quoted String Argument Symbol Meaning Quoted string of ASCII text MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-7 Command Syntax A quoted string can include any character defined in the 7-bit ASCII character set. Follow these rules when you use quoted strings: 1. Use the same type of quote character to open and close the string. For example: "this is a valid string". 2. You can mix quotation marks within a string as long as you follow the previous rule. For example: "this is an 'acceptable' string". 3. You can include a quote character within a string by repeating the quote. For example: "here is a "" mark". 4. Strings can have upper or lower case characters. 5. If you use a GPIB network, you cannot terminate a quoted string with the END message before the closing delimiter. 6. A carriage return or line feed embedded in a quoted string does not terminate the string. The return is treated as another character in the string. 7. The maximum length of a quoted string returned from a query is 1000 characters. Here are some invalid strings: "Invalid string argument' (quotes are not of the same type) "test " (termination character is embedded in the string) Block Several oscilloscope commands use a block argument form, as defined in the table below. Table 2-12: Block Argument Symbol Meaning A nonzero digit character in the range of 1–9 A digit character, in the range of 0–9 A character with the hexadecimal equivalent of 00 through FF (0 through 255 decimal) A block of data bytes defined as: ::= {# [ ...][ ...] |#0[ ...] } specifies the number of elements that follow. Taken together, the and elements form a decimal integer that specifies how many elements follow. 2-8 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Syntax MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-9 Command Syntax 2-10 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups This manual lists the MDO4000B, MDO4000, MSO4000B, DPO4000B and MDO3000 Series IEEE488.2 commands in two ways. First, it presents them by functional groups. Then, it lists them alphabetically. The functional group list starts below. The alphabetical list provides detail on each command. Acquisition Command Group Use the commands in the Acquisition Command Group to set up the modes and functions that control how the oscilloscope acquires signals input to the channels, and processes them into waveforms. Using the commands in this group, you can do the following: Start and stop acquisitions. Control whether each waveform is simply acquired, averaged, or enveloped over successive acquisitions of that waveform. Set the controls or conditions that start and stop acquisitions. Control acquisition of channel waveforms. Set acquisition parameters. Table 2-13: Acquisition Commands Command Description ACQuire? Returns acquisition parameters ACQuire:FASTAcq Sets or queries the fast acquisition feature. ACQuire:FASTAcq:PALEtte Sets (or queries) which palette to use for fast acquisition mode. ACQuire:FASTAcq:STATE Turns fast acquisition mode on or off, or queries the state of the mode. ACQuire:MAGnivu This command specifies the MagniVu feature ACQuire:MAXSamplerate? Returns the maximum real-time sample rate ACQuire:MODe Specifies the acquisition mode of the oscilloscope for all analog channel waveforms. ACQuire:NUMACq? Returns number of acquisitions that have occurred ACQuire:NUMAVg This command specifies the number of acquisitions for an averaged waveform ACQuire:NUMEnv This command controls the number of envelopes (when acquisition mode is set to ENVelope using ACQuire:MODe). ACQuire:STATE Starts or stops the acquisition system ACQuire:STOPAfter This command specifies whether the acquisition is continuous or single sequence Act on Event Command Group Use the Act on Event commands to Act once a certain type of Event has happened. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-11 Command Groups Available actions: - Stop acquisitions - Save waveform data to a file - Save a screen image to a file - Send a screen image to a printer - Send a pulse to the Aux Out port - Generate a service request - Send an email - Display a visual notification Available events: - Upon trigger -When a certain number of acquisitions have completed - None Table 2-14: Act on Event Command Description ACTONEVent:ACTION:AUXOUT: STATE Sends a pulse to the AUX OUT port when a specified event occurs, or queries the state of the “pulse to aux out” action. ACTONEVent:ACTION:EMAIL: STATE Sends an email when a specified event occurs, or queries the state of the “send email” action. ACTONEVent:ACTION:PRINT: STATE Sends a screen image to a printer when a specified event occurs, or queries the state of the “send screen image” action. ACTONEVent:ACTION: SAVEIMAGE:STATE Saves a screen image to file when a specified event occurs, or queries the state of the “save screen image to a file” action. ACTONEVent:ACTION:SAVEWFM: STATE Saves the currently selected waveform data to a file when a specified event occurs, or queries the state of the “save waveform to file” action. ACTONEVent:ACTION:SRQ:STATE Sets or returns the enabled state of the generate service request (SRQ) action when a specified event occurs. The default state is 0. ACTONEVent:ACTION:STOPACQ: STATE Stops acquisitions when a specified event occurs, or queries the state of the “stop acquisition” action. ACTONEVent:ACTION:VISUAL: STATE Sends a visual notification when a specified event occurs, or queries the state of the “send a visual notification” action. ACTONEVent:EVENTTYPe Specifies (or queries) which event to act on (TRIGger, ACQCOMPLete, or NONe) when using an Act on Event command. ACTONEVent:NUMACQs Sets (or queries) the number of acquisitions to complete for the event type ACQCOMPLete. ACTONEVent:REPEATCount Sets or returns the number of events to run. 2-12 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups AFG Command Group Use the AFG commands for Arbitrary Function Generator functionality. Available for the MDO3000 series only. Requires the MDO3AFG option to be installed. The AFG functionality is available when either the time domain acquisition or RF acquisition is active. Table 2-15: AFG Commands Command Description AFG:AMPLitude Sets (or queries) the AFG amplitude in volts, peak to peak. AFG:FREQuency Sets (or queries) the AFG frequency. AFG:FUNCtion Sets (or queries) which AFG function to execute. AFG:HIGHLevel Sets (or queries) the AFG high level, in volts. AFG:LEVELPreset Sets (or queries) the AFG preset levels to values that correspond to the logic standard specified by the argument The presets set the vertical controls for AMPLitude, OFFSet , HIGHLevel, and LOWLevel. AFG:LOWLevel Sets (or queries) the AFG low level, in volts. AFG:NOISEAdd:PERCent Sets (or queries) the AFG additive noise level as a percentage. AFG:NOISEAdd:STATE Sets (or queries) the AFG additive noise state. AFG:OFFSet Sets (or queries) the AFG offset, in volts. AFG:OUTPut:LOAd:IMPEDance Sets (or queries) the AFG output load impedance. AFG:OUTPut:STATE Sets (or queries) the AFG output state. AFG:PERIod Sets (or queries) the period of the AFG waveform, in seconds. AFG:PHASe Sets (or queries) the AFG phase. AFG:PULse:WIDth Sets (or queries) the AFG pulse width, in seconds. AFG:RAMP:SYMmetry Sets (or queries) the AFG ramp symmetry as a percentage. AFG:SQUare:DUty Sets (or queries) the AFG duty cycle, as a percentage. Alias Command Group Use the Alias commands to define new commands as a sequence of standard commands. You may find this useful when repeatedly using the same commands to perform certain tasks like setting up measurements. Aliases are similar to macros but do not include the capability to substitute parameters into alias bodies. To use Alias commands, first define the alias, then turn on the alias state. The alias mechanism obeys the following rules: MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-13 Command Groups the alias name must consist of a valid IEEE488.2 message unit, which may not appear in a message preceded by a colon, comma, or a command or query program header. the alias name may not appear in a message followed by a colon, comma, or question mark. an alias name must be distinct from any keyword or keyword short form. an alias name cannot be redefined without first being deleted using one of the alias deletion functions. alias names do not appear in response messages. Table 2-16: Alias Commands Command Description ALIas:CATalog? Returns a list of the currently defined alias labels ALIas:DEFine Assigns a sequence of program messages to an alias label ALIas:DELEte:ALL Deletes all existing aliases ALIas:DELEte[:NAMe] Removes a specified alias ALIas[:STATE] This command specifies the alias state ARB Command Group Use the ARB commands for Arbitrary Waveform Generator functionality. Available for the MDO3000 series only. Requires the MDO3AFG option to be installed. Table 2-17: ARB Commands Command Description AFG:ARBitrary:ARB :DATE? Returns the date that the data in the specified arbitrary waveform slot 1-4 was saved. AFG:ARBitrary:ARB :LABel Sets (or queries) the waveform label for arbitrary waveform slots 1- 4. AFG:ARBitrary:ARB :TIMe? Returns the time that the data in the specified arbitrary waveform slot was saved. AFG:ARBitrary:EMEM:FUNCtion? Returns the currently selected arbitrary waveform pre-defined function. AFG:ARBitrary:EMEM:GENerate This command generates the arbitrary waveform function specified by the enumeration argument, with the number of points optionally specified by the NR1 argument. To query the arbitrary waveform function set by this command, use AFG:ARBitrary:EMEM:FUNCtion? AFG:ARBitrary:EMEM:NUMPoints? Returns the number of points in the AFB arbitrary waveform edit memory. AFG:ARBitrary:EMEM:POINTS Specifies which points to load into the AFG arbitrary waveform edit memory. AFG:ARBitrary:EMEM:POINTS: ENCdg This command specifies the data encoding format for the AFG:ARBitrary:EMEM:POINTS query (either ASCII or binary). 2-14 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Bus Command Group Use the Bus commands when working with serial or parallel bus measurements. Bus commands let you specify the bus number (B1-B4), except for MDO3000, which has only two buses (B1-B2). Parallel bus trigger and analysis functionality is included standard with the MSO and MDO Series. All other bus triggers require installation of an application module. A table is available that lists all commands enabled by each application module (See page G-1, Application Module-enabled Commands.) For I2C or SPI bus signals, install the DPO4EMBD application module, except for MDO3000 models, which require MDO3EMBD. For RS-232, RS-422, RS-485, or UART bus signals, install the DPO4COMP module, except for MDO3000 models, which require MDO3COMP. For I2S, Left Justified (LJ), Right Justified (RJ), or TDM bus signals, install the DPO4AUDIO module, except for MDO3000 models, which require MDO3AUDIO. For CAN or LIN bus signals, install the DPO4AUTO or DPO4AUTOMAX module, except for MDO3000 models, which require MDO3AUTO. For FlexRay bus signals, install the DPO4AUTOMAX module, except for MDO3000 models, which require MDO3FLEX. For Ethernet signals, when tested with the MDO4000/B and MSO/DPO4000B, install the DPO4ENET module. Note that ≥350 MHz bandwidth models are recommended for 100BASE-TX. For MIL-STD-1553 bus signals, install the DPO4AERO module, except for MDO3000 models, which require MDO3AERO. For USB bus signals, install the DPO4USB module, except for MDO3000 models, which require MDO3USB. Note that 1 GHz bandwidth models are recommended for high-speed (HS) USB. NOTE. The Search Command Group and the Trigger Command Group also contain bus-related commands. Table 2-18: Bus Commands Commands Description BUS? Returns the parameters for each serial (if installed) and parallel bus. BUS:B :AUDio:BITDelay This command specifies the number of delay bits for the AUDIO bus BUS:B :AUDio:BITOrder This command specifies the bit order for the AUDIO bus BUS:B :AUDio:CHANnel:SIZe This command specifies the number of bits per channel for the AUDIO bus MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-15 Command Groups Table 2-18: Bus Commands (cont.) Commands Description BUS:B :AUDio:CLOCk:POLarity This command specifies the clock polarity for the AUDIO bus BUS:B :AUDio:CLOCk:SOUrce This command specifies the clock source waveform for the AUDIO bus BUS:B :AUDio:DATa:POLarity This command specifies the data polarity for the AUDIO bus BUS:B :AUDio:DATa:SIZe This command specifies the number of bits per word for the AUDIO bus BUS:B :AUDio:DATa:SOUrce This command specifies the data source waveform for the AUDIO bus BUS:B :AUDio:DISplay:FORMat This command specifies the display format for the AUDIO bus BUS:B :AUDio:FRAME:SIZe This command specifies the number of channels in each frame for the AUDIO bus BUS:B :AUDio:FRAMESync: POLarity This command specifies the frame sync polarity for the AUDIO bus BUS:B :AUDio:FRAMESync: SOUrce This command specifies the frame sync source waveform for the AUDIO bus BUS:B :AUDio:TYPe This command specifies the audio format (type) for the AUDIO bus BUS:B :AUDio:WORDSel: POLarity This command specifies the word select polarity for the AUDIO bus BUS:B :AUDio:WORDSel:SOUrce This command specifies the word select source waveform for the AUDIO bus BUS:B :CAN:BITRate This command specifies the bit rate for the CAN bus BUS:B :CAN:PRObe This command specifies the probing method for the CAN bus BUS:B :CAN:SAMPLEpoint This command specifies the sample point (in %) to sample during each bit period BUS:B :CAN:SOUrce This command specifies the CAN bus data source BUS:B :DISplay:FORMat Sets the display format for the numerical information in the specified bus waveform BUS:B :DISplay:TYPe Sets the display type for the specified bus BUS:B :ETHERnet:PRObe This command specifies the Ethernet probe type: differential or single-ended. BUS:B :ETHERnet:PROTOcol Use this command to set the Ethernet protocol type to TCP/IPv4, or to OTHER. BUS:B :ETHERnet:SOUrce: DIFFerential This command specifies the Ethernet data source for differential input. BUS:B :ETHERnet:SOUrce: DMINus This command specifies the Ethernet data source for D- input for single-ended probing. BUS:B :ETHERnet:SOUrce: DPLUs This command specifies the Ethernet data source for the D+ input for single-ended probing. BUS:B :ETHERnet:TYPe This command specifies the Ethernet standard type: 10Base-T or 100Base-T. BUS:B :FLEXray:BITRate This command specifies the bit rate for the FlexRay bus signal BUS:B :FLEXray:CHannel This command specifies the FlexRay bus ID format BUS:B :FLEXray:SIGnal This command specifies the FlexRay bus standard BUS:B :FLEXray:SOUrce This command specifies the FlexRay bus data source BUS:B :I2C:ADDRess:RWINClude Sets and returns whether the read/write bit is included in the address BUS:B :I2C{:CLOCk|:SCLk}: SOUrce This command specifies the I2C bus SCLK source BUS:B :I2C{:DATa|:SDAta}: SOUrce This command specifies the I2C bus SDATA source 2-16 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-18: Bus Commands (cont.) Commands Description BUS:B :LABel This command specifies the waveform label for the specified bus BUS:B :LIN:BITRate This command specifies the bit rate for the LIN bus. BUS:B :LIN:IDFORmat This command specifies the LIN bus ID format BUS:B :LIN:POLarity This command specifies the LIN bus polarity BUS:B :LIN:SAMPLEpoint This command specifies the point to sample during each bit period, as a percent, for the LIN bus. BUS:B :LIN:SOUrce This command specifies the LIN bus data source BUS:B :LIN:STANDard This command specifies the LIN bus standard BUS:B :MIL1553B:POLarity This command sets the MIL-STD-1553 bus polarity to normal or inverted. BUS:B :MIL1553B: RESPonsetime:MAXimum This command specifies the maximum response time to a valid command issued for the MIL-STD-1553 bus. BUS:B :MIL1553B: RESPonsetime:MINimum This command specifies the minimum response time to a valid command issued for the MIL-STD-1553 bus. BUS:B :MIL1553B:SOUrce This command specifies the source for differential input for the MIL-STD-1553 bus. BUS:B :PARallel:BIT :SOUrce This command specifies the bit source for the parallel bus. BUS:B :PARallel:CLOCk:EDGE This command specifies the clock edge for the parallel bus BUS:B :PARallel:CLOCk: ISCLOCKed This command specifies the state of the clock function for the parallel bus. BUS:B :PARallel:CLOCk:SOUrce This command specifies the clock source waveform for the parallel bus. BUS:B :PARallel:WIDth This command specifies the number of bits to use for the width of the parallel bus. BUS:B :POSition This command specifies the position of the bus waveform on the display. BUS:B :RS232C:BITRate This command specifies the bit rate for the RS-232 bus. BUS:B :RS232C:DATABits This command specifies the number of bits in the data frame for the RS-232 bus. BUS:B :RS232C:DELIMiter This command specifies the delimiting value for a packet on the RS-232 bus. BUS:B :RS232C:DISplaymode This command specifies the display mode for the RS-232 bus (frame or packet). BUS:B :RS232C:PARity This command specifies parity for the RS-232 bus BUS:B :RS232C:POLarity This command specifies the polarity for the RS-232C bus BUS:B :RS232C:RX:SOUrce This command specifies the RX source waveform for the RS-232 bus. BUS:B :RS232C:TX:SOUrce This command specifies the TX source waveform for the RS-232 bus. BUS:B :SPI:BITOrder This command specifies the bit order for the SPI bus BUS:B :SPI{:CLOCk|:SCLk}: POLarity This command specifies the SCLK polarity for the SPI bus. BUS:B :SPI{:CLOCk|:SCLk}: SOUrce This command specifies the SCLK source for the SPI bus. BUS:B :SPI:DATa{:IN|:MISO}: POLarity This command specifies the MISO polarity for the SPI bus. BUS:B :SPI:DATa{:IN|:MISO}: SOUrce This command specifies the MISO source for the SPI bus. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-17 Command Groups Table 2-18: Bus Commands (cont.) Commands Description BUS:B :SPI:DATa{:OUT|:MOSI}: POLarity This command specifies the MOSI polarity for the SPI bus. BUS:B :SPI:DATa{:OUT|:MOSI}: SOUrce This command specifies the MOSI source for the SPI bus. BUS:B :SPI:DATa:SIZe This command specifies the number of bits per word (data size) for the specified SPI bus. BUS:B :SPI:FRAMING This command specifies the type of framing to use for the SPI bus. BUS:B :SPI:IDLETime This command specifies the idle time, in seconds, for the SPI bus. BUS:B :SPI{:SELect|:SS}: POLarity This command specifies the polarity for the SPI bus. BUS:B :SPI{:SELect|:SS}:SOUrce This command specifies the source waveform for the SPI bus. BUS:B :STATE This command specifies the on/off state of the bus. BUS:B :TYPe This command specifies the bus type BUS:B :USB:BITRate This command specifies the bit rate for the USB bus. BUS:B :USB:PRObe This command specifies the type of probe connected to the USB bus. BUS:B :USB:SOUrce:DIFFerential This command specifies the source waveform for the eUSB bus when using a differential probe. BUS:B :USB:SOUrce:DMINus This command specifies the source waveform for the USB bus D- input. BUS:B :USB:SOUrce:DPLUs This command specifies the source for the USB D+ input. BUS:LOWerthreshold:CH This command specifies the lower threshold for each channel. BUS:LOWerthreshold{:MATH|: MATH1} This command specifies the lower threshold for the math waveform. BUS:LOWerthreshold:REF This command sets the lower threshold for each reference waveform. BUS:THReshold:CH This command specifies the threshold for a channel. BUS:THReshold:D This command specifies the threshold for a digital channel. BUS:UPPerthreshold:CH This command specifies the upper threshold for each channel. BUS:UPPerthreshold{:MATH|: MATH1} This command specifies the upper threshold for the math waveform. BUS:UPPerthreshold:REF This command sets the upper threshold for each reference waveform. Calibration and Diagnostic Command Group The Calibration and Diagnostic commands provide information about the current state of oscilloscope calibration. They also initiate internal signal path calibration (SPC) or execute diagnostic tests. Commands that are specific to factory calibration are not described in this manual. Instead, they are described in the Service Manual Documentation CD-ROM in PDF format. You can also order a printed copy. 2-18 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-19: Calibration and Diagnostic Commands Command Description *CAL? Instructs the oscilloscope to perform self-calibration and returns the oscilloscope self calibration status. CALibrate:FACtory:STATus? Returns the factory calibration status value saved in nonvolatile memory. CALibrate:FACtory:STATus:AFG? Returns the factory calibration status for the Arbitrary Function Generator portion of the instrument, if present. CALibrate:FACtory:STATus:RF? Returns the factory calibration status value saved in nonvolatile memory for the RF portion of the oscilloscope. CALibrate:FACtory:STATus:SCOPE? Returns the factory calibration status value saved in nonvolatile memory for the non-RF portion of the oscilloscope. CALibrate:INTERNal Starts a signal path compensation CALibrate:INTERNal:STARt Starts the internal signal path calibration. CALibrate:INTERNal:STATus? Returns the current status of the internal signal path calibration. CALibrate:INTERNal:STATus:RF? This query returns the status of the last SPC run for the RF portion of the instrument: (doesn't include the analog channels). CALibrate:INTERNal:STATus: SCOPE? This query returns the status of the last SPC run for the oscilloscope portion of the instrument (doesn't include the RF portion). CALibrate:RESults? Returns the status of all calibration subsystems without performing an SPC operation. CALibrate:RESults:FACtory? Returns the status of internal and factory calibration. CALibrate:RESults:FACtory:AFG? This query returns the factory calibration status for the Arbitrary Function Generator portion of the instrument, if present. CALibrate:RESults:FACtory:RF? This query returns the factory calibration status for the RF portion of the instrument, if present. CALibrate:RESults:FACtory:SCOPE? This query returns the factory calibration status for the oscilloscope (doesn't include RF or AFG) of the instrument. CALibrate:RESults:SPC? Returns the results of the last SPC operation. CALibrate:RESults:SPC:RF? This query returns the status of the last SPC run for the RF portion of the instrument (doesn't include analog channels) . This query is synonymous with CALibrate:INTERNal:STATus:RF? CALibrate:RESults:SPC:SCOPE? This query returns the status of the last SPC run for the oscilloscope portion of the instrument (doesn't include the RF portion). This query is synonymous to CALibrate:INTERNal:STATus:SCOPE? CALibrate:RF This command begins the RF calibration process. CALibrate:RF:STARt This command is identical to CALIBRATE:RF. CALibrate:RF:STATus? This query returns the status of the last RF calibration. DIAg:LOOP:OPTion Sets the self-test loop option. DIAg:LOOP:OPTion:NTIMes Sets the self-test loop option to run N times. DIAg:LOOP:STOP Stops the self-test at the end of the current loop. DIAg:RESUlt:FLAg? Returns the pass/fail status from the last self-test sequence execution. DIAg:RESUlt:LOG? Returns the internal results log from the last self-test sequence execution. DIAg:SELect Runs self tests on the specified system subsystem. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-19 Command Groups Table 2-19: Calibration and Diagnostic Commands (cont.) Command Description DIAg:SELect: Specifies which of the subsystems will be tested when the DIAg:STATE EXECute command is run. DIAg:STATE Sets the oscilloscope operating state. Configuration Command Group Use the queries in the Configuration Command Group to determine whether a particular feature is present. “RF” commands work on MDO models only Table 2-20: Configuration Commands 2-20 Command Description CONFIGuration:ADVMATH? This query returns a boolean value to indicate whether the instrument supports the advanced math feature. CONFIGuration:AFG? Indicates whether or not the arbitrary function generator hardware is present, and the arbitrary function generation feature is enabled. CONFIGuration:ANALOg:BANDWidth? This query returns the maximum bandwidth for analog channels. CONFIGuration:ANALOg:GNDCPLG? This query returns a boolean value to indicate whether the instrument supports the ground coupling feature for analog channels. As this feature is not supported on MSO/DPO4000B or MDO4000/B models, this query always returns 0. CONFIGuration:ANALOg:MAXBANDWidth? Returns the maximum bandwidth for analog channels. CONFIGuration:ANALOg: MAXSAMPLERate? This query returns the maximum sample rate for analog channels. CONFIGuration:ANALOg:NUMCHANnels? This query returns the number of analog channels. CONFIGuration:ANALOg:RECLENS? This query returns a list of supported record lengths for analog channels. CONFIGuration:ANALOg:VERTINVert? This query returns a boolean value to indicate whether the instrument supports the vertical invert feature for analog channels. CONFIGuration:APPLications: CUSTOMMask? Indicates whether the Custom Mask test feature is present and enabled. CONFIGuration:APPLications:LIMITMask? This query returns a boolean value to indicate whether the instrument supports the mask/limit test application feature. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-20: Configuration Commands (cont.) Command Description CONFIGuration:APPLications:POWer? This query returns a boolean value to indicate whether the optional power application feature is present. CONFIGuration:APPLications: STANDARDMask? Indicates whether the Standard Mask test feature is present and enabled. CONFIGuration:APPLications:VIDPIC? Indicates whether the Video Picture feature is present and enabled. CONFIGuration:ARB? Indicates whether or not the arbitrary function generator hardware is present, and the user-defined arbitrary waveform generation feature is enabled. Note that this is different than the CONFIGuration:AFG? query. CONFIGuration:AUXIN? This query returns a boolean value to indicate whether the instrument has an Aux Input connector. CONFIGuration:BUSWAVEFORMS:AUDIO? This query returns a boolean value to indicate whether the optional audio bus triggering and analysis feature is present. CONFIGuration:BUSWAVEFORMS:CAN? This query returns a boolean value to indicate whether the optional CAN bus triggering and analysis feature is present. CONFIGuration:BUSWAVEFORMS: ETHERNET? This query returns a boolean value to indicate whether the optional Ethernet triggering and analysis feature is present. CONFIGuration:BUSWAVEFORMS: FLEXRAY? This query returns a boolean value to indicate whether the optional FlexRay bus triggering and analysis feature is present. CONFIGuration:BUSWAVEFORMS:I2C? This query returns a boolean value to indicate whether the optional I2C bus triggering and analysis feature is present. CONFIGuration:BUSWAVEFORMS:LIN? This query returns a boolean value to indicate whether the optional LIN bus triggering and analysis feature is present. CONFIGuration:BUSWAVEFORMS: MIL1553B? This query returns a boolean value to indicate whether the optional MIL-STD-1553 bus triggering and analysis feature is present. CONFIGuration:BUSWAVEFORMS: NUMBUS? This query returns the number of bus waveforms. CONFIGuration:BUSWAVEFORMS: PARallel? This query returns a boolean value to indicate whether the parallel bus triggering and analysis feature is present. CONFIGuration:BUSWAVEFORMS: RS232C? This query returns a boolean value to indicate whether the optional RS232 bus triggering and analysis feature is present. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-21 Command Groups Table 2-20: Configuration Commands (cont.) 2-22 Command Description CONFIGuration:BUSWAVEFORMS:SPI? This query returns a boolean value to indicate whether the optional SPI bus triggering and analysis feature is present. CONFIGuration:BUSWAVEFORMS:USB? This query returns a boolean value to indicate whether the USB bus triggering and analysis feature is present. CONFIGuration:BUSWAVEFORMS:USB: HS? This query returns a boolean value to indicate whether the high-speed USB bus triggering and analysis feature is present. CONFIGuration:DIGITAl:MAGnivu? This query returns a boolean value to indicate whether the instrument supports the MagniVu feature for digital channels. If there are no digital channels, the value returned is 0. CONFIGuration:DIGITAl: MAXSAMPLERate? This query returns the maximum sample rate for digital channels, in samples per second. CONFIGuration:DIGITAl:NUMCHANnels? This query returns the number of digital channels. CONFIGuration:DVM? Indicates whether the Digital Voltmeter hardware is present. and the DVM feature is enabled. CONFIGuration:EXTVIDEO? This query returns a boolean value to indicate whether the optional extended video trigger features are present. CONFIGuration:HISTOGRAM? This query returns a boolean value to indicate whether the waveform histogram feature is present. CONFIGuration:NETWORKDRIVES? This query returns a boolean value to indicate whether network drives are present. CONFIGuration:NUMMEAS? This query returns the number of periodic measurements. CONFIGuration:REFS:NUMREFS? This query returns the number of reference waveforms. CONFIGuration:RF:ADVTRIG? This query returns a boolean value to indicate whether the advanced RF trigger and analysis feature is present. CONFIGuration:RF:BANDWidth? This query returns the maximum bandwidth, in hertz, for RF channels. If there are no RF channels, the value returned is 0. CONFIGuration:RF:MAXBANDWidth? Returns the maximum bandwidth, in hertz, for RF channels. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-20: Configuration Commands (cont.) Command Description CONFIGuration:RF:NUMCHANnels? This query returns the number of RF channels present. CONFIGuration:ROSC? This query returns a boolean value to indicate whether the instrument has an external reference oscillator (ROSC) input. Cursor Command Group Use the commands in the Cursor Command Group to control the cursor display and readout. You can use these commands to control the setups for cursor 1 and cursor 2, such as cursor position. You can also use the commands to select one of the following cursor functions: Off. Turns off the display of all cursors. Waveform Cursors. Consists of two cursors. Waveform cursors enable you to conveniently measure waveform amplitude and time. Screen Cursors. Consists of two pairs of independent horizontal and vertical cursors. You can use these cursors to indicate an arbitrary position within the waveform display area. Table 2-21: Cursor Commands Command Description CURSor? Returns cursor settings CURSor:DDT? Returns the cursor deltaY/deltaT (dY/dT) readout CURSor:FUNCtion This command specifies the cursor type CURSor:HBArs? Returns hbar cursor settings CURSor:HBArs:DELTa? Returns hbars cursors vertical difference CURSor:HBArs:POSITION This command specifies the hbar cursor vertical position CURSor:HBArs:UNIts Returns hbar cursor units CURSor:HBArs:USE Sets the horizontal bar cursor measurement scale, for use with ratio cursors CURSor:MODe This command specifies whether cursors move in unison or separately CURSor:SOUrce This command specifies the cursor source, which can be one of channels 1–4, reference waveforms 1–4, math waveform, bus 1–4, digital channels 0– 15 (MSO/MDO4000 models and MDO3000 models with option MDO3MSO installed), the RF time domain traces, (MDO4000/B models) or AUTO. CURSor:VBArs? This command specifies the position of vertical bar cursors CURSor:VBArs:ALTERNATE ? Returns the alternate readout for the waveform (Vbar) cursors CURSor:VBArs:DELTa? Returns the horizontal difference between vbar cursors CURSor:VBArs:HPOS ? Returns the vertical value of the specified vertical bar tick MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-23 Command Groups Table 2-21: Cursor Commands (cont.) Command Description CURSor:VBArs:POSITION This command specifies the vbar cursor horizontal position CURSor:VBArs:UNIts This command specifies the horizontal units for vbar cursors CURSor:VBArs:USE Sets the vertical bar cursor measurement scale CURSor:VBArs:VDELTa? Returns the vertical difference between the two vertical bar cursor ticks CURSor:XY:POLar:RADIUS:DELta? Returns the difference between the cursors X radius and the cursor Y radius CURSor:XY:POLar:RADIUS: POSITION ? Returns the polar radius of the specified cursor CURSor:XY:POLar:RADIUS:UNIts? Returns the polar radius units CURSor:XY:POLar:THETA:DELta? Returns the XY cursor polar coordinate delta CURSor:XY:POLar:THETA: POSITION ? Returns the cursor X or cursor Y polar coordinate CURSor:XY:POLar:THETA:UNIts? Returns the cursor polar coordinate units CURSor:XY:PRODUCT:DELta? Returns the difference between the cursors X position and cursor Y position CURSor:XY:PRODUCT: POSITION ? Returns the position of the X or Y cursor used to calculate the X × Y cursor measurement CURSor:XY:PRODUCT:UNIts? Returns the XY cursor product units CURSor:XY:RATIO:DELta? Returns the ratio of the difference between the cursor X position and cursor Y position CURSor:XY:RATIO:POSITION ? Returns the X or Y position for the specified cursor CURSor:XY:RATIO:UNIts? Returns the X and Y cursor units for the ratio measurement CURSor:XY:READOUT This command specifies the XY cursor readout selection. CURSor:XY:RECTangular:X:DELta? Returns the cursor X delta value in rectangular coordinates CURSor:XY:RECTangular:X: POSITION This command specifies the cursor X rectangular coordinates CURSor:XY:RECTangular:X:UNIts? Returns the Cursor X rectangular units CURSor:XY:RECTangular:Y:DELta? Returns The cursor Y delta value in rectangular coordinates CURSor:XY:RECTangular:Y: POSITION > This command specifies the cursor Y rectangular coordinate CURSor:XY:RECTangular:Y:UNIts? Returns the cursor Y rectangular units Display Command Group Use the commands in the Display Command Group to change the graticule style, the display intensities, and to set the characteristics of the waveform display. NOTE. Your settings globally affect all displayed waveforms. 2-24 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-22: Display Commands Command Description DISplay? Returns current display settings DISplay:CLOCk This command specifies the display of the date/time stamp DISplay:DIGital:ACTIVity Sets or returns the state of the digital channel monitor display. DISplay:DIGital:HEIght This command specifies the number of available digital waveform position slots. DISplay:GRAticule This command specifies the type of graticule that is displayed DISplay:INTENSITy? Returns all display intensity settings DISplay:INTENSITy:BACKLight This command specifies the backlight intensity for the display DISplay:INTENSITy:BACKLight: AUTODim:ENAble Sets or returns the state of the display auto-dim feature. The default is enabled. DISplay:INTENSITy:BACKLight: AUTODim:TIMe Sets or returns the amount of time, in minutes, to wait for no UI activity before automatically dimming the display. DISplay:INTENSITy:GRAticule This command specifies the graticule intensity for the display DISplay:INTENSITy:WAVEform This command specifies the intensity of the waveforms DISplay:PERSistence This command specifies the display persistence for analog waveforms. This affects the display only. DISplay:STYle:DOTsonly This command turns on or off the dots-only mode for the waveforms displayed in the time domain. DISplay:TRIGFrequency This command switches the trigger frequency readout on or off. DISplay:XY This command turns on or off the XY display mode. DISplay:XY:WITHYT Sets or returns the state of simultaneous display of the XY and YT waveforms when in TRIGgered XY display mode. When both are displayed, the YT waveform is displayed in the upper graticule, and the XY waveform is displayed in the lower graticule. MESSage Sets or queries message box (screen annotation) parameters MESSage:BOX This command specifies the coordinates of the message box MESSage:CLEAR Clears the contents of the message box. MESSage:SHOW This command specifies the contents of the message box MESSage:STATE Controls the display of the message box DVM Command Group Use the commands in the DVM command group for Digital Voltmeter functionality. Available for the MDO3000 series only. Table 2-23: DVM Commands Command Description DVM Resets the Digital Voltmeter measurements and history DVM:AUTORange Sets (or queries) the auto range state for the Digital Voltmeter. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-25 Command Groups Table 2-23: DVM Commands (cont.) Command Description DVM:DISPLAYSTYle Sets (or queries) the display style for the Digital Voltmeter. DVM:MEASUrement:FREQuency? Returns the current frequency value for the Digital Voltmeter. DVM:MEASUrement:HIStory: AVErage? Returns the average readout value for the Digital Voltmeter function over the history period. DVM:MEASUrement:HIStory: MAXimum? Returns the maximum readout value for the DVM function over the history period. DVM:MEASUrement:HIStory: MINImum? Returns the minimum readout value for the DVM function over the history period. DVM:MEASUrement:INFMAXimum? Returns the maximum DVM readout value over the entire time that the DVM has been on since the last change using the DVM:MODe or DVM:SOUrce commands or DVM RESET. DVM:MEASUrement:INFMINimum? Returns the minimum readout value of the DVM function over the entire time that the DVM has been on since the last change using the DVM:MODe or DVM:SOUrce commands or DVM RESET. DVM:MEASUrement:VALue? Returns the DVM readout value (the large displayed value at the top of the DVM screen). DVM:MODe Specifies (or queries) the mode to use for the Digital Voltmeter (ACRMS, ACDCRMS, DC, Frequency, or OFF). DVM:SOUrce Sets (or queries) the source for the Digital Voltmeter: Channel 1 - 4. Email Command Group Use the email commands for both email printer support and Act on Event “send an email” actions. Different email systems require different information. See your system administrator to determine which commands are necessary for your email system. Table 2-24: EmailCommands Command Description EMAIL:SETUp:FROMADDRess Sets (or queries) the sender’s email address for the common server setup information that is shared between the Act on Event commands and the Hardcopy Email commands. EMAIL:SETUp:HOSTALIASNAMe Sets (or queries) the email host alias name for the common server setup information that is shared between the Act on Event commands and the Hardcopy Email commands. EMAIL:SETUp:SMTPLOGIn Sets or returns the email SMTP server login ID for the common server setup information that is shared between the Act on Event commands and the Hardcopy Email commands. EMAIL:SETUp:SMTPPASSWord Sets the email SMTP server login password for the common server setup information that is shared between the Act on Event commands and the Hardcopy Email commands. EMAIL:SETUp:SMTPPort Sets or returns the email SMTP server port number for the common server setup information that is shared between the Act on Event commands and the Hardcopy Email commands EMAIL:SETUp:SMTPServer Sets or returns the email SMTP server DNS name for the common server setup information that is shared between the Act on Event commands and the Hardcopy Email commands. 2-26 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Ethernet Command Group Use the commands in the Ethernet Command Group to set up the 10BASE-T or 100BASE-TX Ethernet remote interface. Table 2-25: Ethernet Commands Command Description ETHERnet:DHCPbootp This command specifies the network initialization search for a DHCP/BOOTP server ETHERnet:DNS:IPADDress This command specifies the network Domain Name Server (Dns) IP address ETHERnet:DOMAINname This command specifies the network domain name ETHERnet:ENET:ADDress? Returns the Ethernet address value assigned to the oscilloscope ETHERnet:GATEWay:IPADDress This command specifies the remote interface gateway IP address ETHERnet:HTTPPort This command specifies the remote interface HTTP port value ETHERnet:IPADDress This command specifies the IP address assigned to the oscilloscope ETHERnet:NAME This command specifies the network name assigned to the oscilloscope ETHERnet:PASSWord This command specifies the Ethernet access password ETHERnet:PING Causes the oscilloscope to ping the gateway IP address ETHERnet:PING:STATus? Returns the results from pinging the gateway IP address ETHERnet:SUBNETMask This command specifies the remote interface subnet mask value File System Command Group Use the commands in the File System Command Group to help you use USB media. You can use the commands to do the following: List the contents of a directory Create and delete directories Create, read, rename, or delete a file Format media When using these commands, keep the following points in mind: File arguments are always enclosed within double quotes: "E:/MYDIR/TEK00001.SET" File names follow the non-case sensitive, MSDOS format: [DRIVE:][\PATH\]filename Path separators may be either forward slashes (/) or back slashes (\) MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-27 Command Groups NOTE. Using back slash as a path separator may produce some unexpected results, depending on how your application treats escaped characters. Many applications recognize the sequence of back slash followed by an alphabetic character as an escaped character, and, as such, interpret that alphabetic character as a control character. For example, the sequence "\n" may be interpreted as a newline character; "\t" may be interpreted as a tab character. To ensure that this interpretation does not occur, you can use double back slashes. For example, "E:\\testfile.txt". Table 2-26: File System Commands Command Description FILESystem? Returns the file system state FILESystem:COPy This command copies a named file to a new file. FILESystem:CWD This command specifies the current working directory for FILESystem commands FILESystem:DELEte Deletes a named file or directory FILESystem:DIR? Returns a list of directory contents FILESystem:FORMat Formats a named drive FILESystem:FREESpace? Returns the number of bytes of free space on the current drive FILESystem:LDIR? Returns a semicolon separated list of every file and directory in a folder. FILESystem:MKDir Creates a new directory FILESystem:MOUNT:AVAILable? This query returns a comma-separated list of available drive letters that can be used for mounting network drives. FILESystem:MOUNT:DRIve This command attempts to mount the network drive specified by the quoted string argument. FILESystem:MOUNT:LIST? This query returns a comma-separated list of the mounted network drives, including the drive letter, server identity (DNS name or IP address), mount path and type. If no network drives are mounted, an empty string is returned. FILESystem:READFile Writes the contents of the specified file to the specified interface FILESystem:REName Assigns a new name to an existing file FILESystem:RMDir Deletes a named directory FILESystem:UNMOUNT:DRIve This command attempts to un-mount the network drive specified by the quoted string argument. FILESystem:WRITEFile Writes the specified block data to the oscilloscope current working directory Hard Copy Command Group Use the commands in the Hard Copy Command Group to make hard copies. PictBridge commands belong to a separate group. (See page 2-40, PictBridge Command Group.) 2-28 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-27: Hard Copy Commands Command Description HARDCopy Sends a copy of the screen display to the selected printer HARDCopy:ACTIVeprinter This command specifies the currently active printer HARDCopy:INKSaver Changes hard copy output to print color traces and graticule on a white background HARDCopy:LAYout This command specifies the page orientation for hard copy HARDCopy:PREVIEW Previews the current screen contents with the InkSaver palette applied HARDCopy:PRINTer:ADD This command is used to add a network or email printer to the list of available printers. HARDCopy:PRINTer:DELete Removes a network printer from the list of available printers HARDCopy:PRINTer:LIST? Displays the list of currently defined printers. HARDCopy:PRINTer:REName Renames a network or email printer on the list of available printers, replacing the currently stored settings with the settings specified in the command. Histogram Command Group Use the commands in the Histogram Command Group to set up a histogram for measurements. Table 2-28: Histogram Commands Command Description HIStogram? Returns all histogram parameters HIStogram:BOX This command specifies the histogram box coordinates HIStogram:BOXPcnt Specifies the histogram box coordinates in terms of percentages of the full screen extents of the source waveform. HIStogram:COUNt Clears the histogram count and statistics HIStogram:DATa? Returns the histogram data HIStogram:DISplay This command specifies the scaling of the histogram display HIStogram:END? Returns the time of the last bin of the histogram HIStogram:MODe This command specifies the type of the histogram, vertical or horizontal HIStogram:SOUrce Sets or queries the source used to create the histogram HIStogram:STARt? Returns the time of the first bin of the histogram Horizontal Command Group Use the commands in the Horizontal Command Group to control the oscilloscope horizontal parameters. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-29 Command Groups Table 2-29: Horizontal Commands Command Description HORizontal? Returns settings for the horizontal commands HORizontal:DELay:MODe This command specifies the horizontal delay mode HORizontal:DELay:TIMe This command specifies the horizontal delay time HORizontal:DIGital:RECOrdlength: MAGnivu? Returns the record length of the MagniVu digital acquisition HORizontal:DIGital:RECOrdlength: MAIn? Returns the record length of the main digital acquisition. HORizontal:DIGital:SAMPLERate: MAGnivu? Returns the sample rate of the Magnivu digital acquisition HORizontal:DIGital:SAMPLERate: MAIn? Returns the sample rate of the main digital acquisition HORizontal:POSition This command specifies the horizontal position, in percent, that is used when delay is off HORizontal:PREViewstate? Returns the display system preview state HORizontal:RECOrdlength This command specifies the record length. HORizontal:SCAle This command specifies the horizontal scale Mark Command Group Use the commands in the Mark Command Group to identify areas of the acquired waveform that warrant further investigation. Table 2-30: Mark Commands Command Description MARK Move to the next or previous mark on the waveform or returns all learnable settings from the mark commands MARK:CREATE Creates a mark on a particular waveform or all waveforms in a column MARK:DELEte Deletes a mark on a particular waveform, all waveforms in a column, or all marks MARK:FREE? Returns how many marks are free to be used MARK:SAVEALL This command saves all current marks on waveforms in the time domain to an internal memory location. (This is equivalent to pressing the “Save All Marks" button in the Search button menu on the front panel.) In order to retrieve the information, use the query form of MARK:USERLIST. MARK:SELected:END? Returns the end of the selected mark, in terms of 0 to 100% of the waveform MARK:SELected:FOCUS? Returns the focus of the selected mark, in terms of 0 to 100% of the waveform MARK:SELected: MARKSINCOLumn? Returns how many marks are in the current zoom pixel column MARK:SELected:OWNer? Returns the owner of the selected mark MARK:SELected:SOURCe? Returns the source waveform of the selected mark MARK:SELected:STARt? Returns the start of the selected mark, in terms of 0 to 100% of the waveform 2-30 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-30: Mark Commands (cont.) Command Description MARK:SELected:STATE? Returns the on or off state of the selected mark MARK:SELected:ZOOm:POSition? Returns the position of the selected mark, in terms of 0 to 100% of the upper window MARK:TOTal? Returns how many marks are used MARK:USERLIST The command creates a single user mark on a waveform in the time domain. The arguments consist of an enumeration specifying the source waveform, followed by 7 time mark parameters. You can create up to 1,024 marks. To save all the marks to memory, use the command MARK:SAVEALL TOUSER. Mask Command Group Use the commands in the Mask Command Group to perform mask and limit testing, useful for long-term signal monitoring, characterizing signals during design, or testing on a production line. The commands simplify many tasks, such as conducting pass/fail tests in search of glitches or other waveform anomalies, comparing a signal against a known good signal, or against a standard or custom mask, counting hits against specific mask segments, and much more. NOTE. In order to use Mask commands, you need to install an optional Limit and mask test application module, Tektronix part number DPO4LMT. Also, ≥350 MHz bandwidth models are recommended for telecommunication standards >55 Mb/s. NOTE. To ensure that Mask commands are enabled, use the command APPLication:TYPe LIMITMask. There are three categories of masks available: Standard The instrument has a built-in set of pre-defined standard telecommunications masks (see the MASK:STANdard command for a complete list). Although these masks are non-editable, they can be copied and used to initialize user-defined custom masks. Limit Test: Limit testing is used to compare a tested signal against a known good or "golden" version of the same signal with user-defined vertical and horizontal tolerances. These non-editable masks are created using a Reference waveform or template. Use the MASK:TEMPLate commands for limit testing. Custom: (also referred to in this document as “user mask”). You can create custom masks and tailor them to your own specific testing requirements. These commands provide granular control over the points of the mask and offer a variety of testing options. For instance, you can specify test duration either by number of waveforms or by time, or specify a violation threshold that must be met before considering a test a failure, or specify an action (such as writing to a MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-31 Command Groups file or sending an SRQ) that is to be performed upon a violation, a test failure, or test completion. Use MASK:CUSTom and then the :MASK:USER commands to create user-defined custom masks. A series of examples showing how to use mask commands for typical tasks is included as an appendix. (See page E-1, Mask/Limit Command Sequence Examples.) Table 2-31: Mask commands Command Description APPLication:TYPe When a mask/limit or power test application module is installed, one of the associated test types is always selected by default. This command allows the test type to be changed from the default. MASK:COPy:SOUrce Specifies the standard mask that is to be copied to a user created custom mask. MASK:COPy:USER Copies the specified standard mask to a user created custom mask. MASK:COUNt Resets to zero the number of hits and failures for all mask segments. MASK:COUNt:FAILURES? Returns the number of pass/fail mask tests that have failed MASK:COUNt:HITS? This query returns the sum of all hits in all mask segments. MASK:COUNt:SEG :HITS? This query returns the number of hits for the specified mask segment. MASK:COUNt:TESTS? Returns the number of pass/fail tests that have occurred MASK:COUNt:VIOLATIONS? Returns the number of test violations that have occurred in the current pass/fail test. MASK:COUNt:WAVEFORMS? Returns the number of waveforms that have been acquired and processed during pass/fail mask testing. MASK:CUSTom Sets the user-defined custom mask to its initialized state, or copies the currently active mask to the user-defined custom mask. MASK:DISplay Controls whether a user-defined custom mask is displayed on the screen. MASK:LOCk Locks the mask to the waveform so that any changes made to the horizontal and/or vertical scale settings of the waveform will redraw the mask segments in proportion. MASK:MARgin:PERCent Sets or returns the tolerance for the mask test. A positive value expands the mask and a negative margin shrinks the mask by the specified percentage. MASK:SOUrce Specifies the mask source waveform to be used during pass/fail mask testing MASK:STANdard Replaces the existing mask, if any, with a specified standard mask. MASK:STOPOnviolation Stops the waveform acquisitions upon the first occurrence of a waveform violation. MASK:TEMPLate:CREATEmask Causes a template mask to be created for limit testing, based on the settings of the MASK:TEMPLate:SOUrce, MASK:TEMPLate:TOLerance:HORizontal, and MASK:TEMPLate:VERTical commands. MASK:TEMPLate:SOUrce Specifies the source waveform to be used to create a mask template for limit testing. MASK:TEMPLate:TOLerance: HORizontal Specifies the +/- horizontal limit (tolerance) for a mask template to be used for limit testing. MASK:TEMPLate:TOLerance: VERTical Specifies the +/- vertical limit (tolerance) for a mask template to be used for limit testing. MASK:TESt:AUXout:COMPLetion Causes the instrument to send a TTL signal to the AUX:out port whenever a pass/fail mask test completes. 2-32 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-31: Mask commands (cont.) Command Description MASK:TESt:AUXout:FAILure Causes the instrument to send a TTL signal to the AUX:out port whenever a pass/fail mask test fails. MASK:TESt:COMPLetion:CRITerion Specifies the criterion to be used for test completion (either by waveform or time) during pass/fail mask testing. MASK:TESt:DELay Specifies the amount of time, in seconds, the instrument should wait after the start of pass/fail mask testing before it evaluates the waveforms. MASK:TESt:HARDCopy Causes the instrument to generate a screen hard copy to the default printer as soon as a pass/fail mask test fails, using the current instrument hard copy settings MASK:TESt:REPeat Causes the mask test cycle to continuously repeat upon the completion of the previous test cycle. MASK:TESt:SAVEIMAGE Causes the instrument to copy the screen image to a USB media file or a mounted network drive if a pass/fail mask test fails. MASK:TESt:SAVEWFM Copies the waveform data from all active channels to a file if a pass/fail mask test fails. MASK:TESt:SRQ:COMPLetion Causes the instrument to send an SRQ command when a pass/fail mask test completes MASK:TESt:SRQ:FAILure Causes the instrument to send an SRQ command when a pass/fail mask test fails. MASK:TESt:STATE Turns the pass/fail mask test on or off. MASK:TESt:STATus? Indicates the result of a pass/fail mask test. MASK:TESt:STOP:FAILure Causes the instrument to stop acquiring data when a pass/fail mask test fails. MASK:TESt:THReshold Specifies the number of failed tested waveforms needed in a pass/fail mask test to cause the test status to change to ‘Failing’. MASK:TESt:TIME Specifies the duration, in seconds, the instrument should run a pass/fail mask test. MASK:TESt:WAVEform Specifies the number of waveforms the instrument should test during a pass/fail mask test. MASK:USER:AMPLitude Specifies the nominal pulse amplitude, in volts, to be used for a user-defined custom mask. MASK:USER:HSCAle Specifies the nominal timing resolution, in time/division, to be used to draw a user-defined custom mask pulse shape. MASK:USER:HTRIGPOS Specifies the nominal trigger position (pulse leading edge) to be used to draw a user-defined custom mask, as a fraction of the display width. MASK:USER:LABel This command specifies a user-defined label for a custom mask. MASK:USER:RECOrdlength Specifies the nominal record length to be used for pulse mask testing with a user-defined custom mask. MASK:USER{:SEG |:MASK } This command deletes the specified mask segment from the current mask segment. There can be up to 8 segments. MASK:USER{:SEG |:MASK }: NR_Pt? This query returns the number of points that make up the specified mask segment of a user-defined custom mask. There can be up to 8 segments. MASK:USER{:SEG |:MASK }: POINTS This command specifies the x and y coordinates of the points that make up the segment 1–8. The units are normal waveform units. The x-coordinate is specified relative to the trigger. The points are specified as a sequence of (x,y) points which traverse the boundary of the segment in a counter-clockwise direction. MASK:USER:TRIGTOSAMP Specifies the nominal time, in seconds, from the (leading edge) trigger position to the pulse bit sampling position, to be used for testing with a user-defined custom mask. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-33 Command Groups Table 2-31: Mask commands (cont.) Command Description MASK:USER:VOFFSet Specifies the nominal value, in volts, to be used to vertically offset the input channels for a user-defined custom mask. MASK:USER:VPOS Specifies the nominal value, in divisions, to be used to vertically position the input channels for a user-defined custom mask. MASK:USER:VSCAle Specifies the nominal value, in volts per division, to be used to vertically scale the input channels for a user-defined custom mask. MASK:USER:WIDth Specifies the nominal bit width value, in seconds, to be used for a user-defined custom mask. RECAll:MASK This command recalls the mask from a specified file that was saved to the current working directory using the SAVe:MASK command. SAVe:MASK This command saves the current mask definition to the file specified with a quoted string, into the current working directory. You can recall the mask from the file by using the command RECAll:MASK. 2-34 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Math Command Group Use the commands in the Math Command Group to create and define a math waveform. First, specify the math type using MATH[1]:TYPe – either dual waveform, FFT, advanced math, or spectrum math. Then, using the MATH[1]:DEFine command, you can build simple math expressions that contain no computation, such as :MATH:DEFine CH1. You can also build complex expressions that consist of up to 128 characters in a quoted string, and comprise many sources, functions, and operands, such as :MATH:DEFINE "SINE(CH1)*(VAR1+CH2)*CH3 - CAREA(CH4)". Note that when your program updates a live waveform or alters a reference waveform, the math waveforms containing those waveforms as sources are also updated to reflect the changes. NOTE. If you set the math type to FFT, your math expression can only be the FFT of a live analog or reference waveform. However, if the math type is set to ADVanced, then you can include FFT as part of a math expression. See the examples of advanced math in MATH[1]:DEFine for more information. Table 2-32: Math Commands Command Description MATH[1]? Returns the definition of the math waveform MATH[1]:AUTOSCale Sets (or queries) the state of automatic vertical scaling of the math waveform. MATH[1]:DEFine This command specifies the current math function as a text string. MATH[1]:HORizontal:POSition This command specifies the math horizontal display position for FFT or (non-live) math reference waveforms MATH[1]:HORizontal:SCAle This command specifies the math horizontal display scale for FFT or for Dual Math waveforms MATH[1]:HORizontal:UNIts Returns the math waveform horizontal unit value MATH[1]:LABel Sets or queries the waveform label for the math waveform MATH[1]:SPECTral:MAG This command specifies the units of spectral magnification in the math string MATH[1]:SPECTral:WINdow This command specifies the window function for math waveform spectral input data MATH[1]:TYPe This command specifies the math waveform type (DUAL, FFT, ADVanced or SPECTRUM). This command is used along with MATH:DEFine. MATH[1]:VERTical:POSition This command specifies the vertical position of the currently selected math type MATH[1]:VERTical:SCAle This command specifies the vertical scale of the currently selected math type MATH[1]:VERTical:UNIts Returns the math waveform vertical units MATHVAR? Returns all numerical values used within math expressions MATHVAR:VAR This command specifies numerical values you can use within math expressions MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-35 Command Groups Measurement Command Group Use the commands in the Measurement Command Group to control the automated measurement system. Up to eight automated measurements can be displayed on the screen. In the commands, these measurement readouts are named MEAS , where is the measurement number. In addition to the eight displayed measurements, the measurement commands let you specify an additional measurement, IMMed. The immediate measurement has no front-panel equivalent. Immediate measurements are never displayed. Because they are computed only when needed, immediate measurements slow the waveform update rate less than displayed measurements. To obtain measurement results, use the MEASUrement:MEAS :VALue? query for displayed results or the MEASUrement:IMMed:VALue? query for immediate measurements. Measurement commands can set and query measurement parameters. You can assign some parameters, such as waveform sources, differently for each measurement. Other parameters, such as reference levels, have only one value, which applies to all measurements. Readout values for the 8 displayed measurements are updated periodically. As such, queries of these measurement values may return 9.91E+37, which represents NaN (not a number) and a measurement warning event (e.g. 2225. “Measurement error. No waveform to measure”) when the measurement is not yet computed. Immediate measurement queries will return values once the measurement has been computed. Example of Immediate Measurements An example command sequence follows that illustrates immediate measurements of Cycle Mean on channel 1: :MEASUrement:IMMed:SOUrce1 CH1 :MEASUrement:IMMed:TYPe CMEan :MEASUrement:IMMed:VALue? -18.5568E-3 :MEASUrement:IMMed:VALue?;VALue?;VALue? -21.6400E-3;-23.8023E-3;-21.0064E-3 Table 2-33: Measurement Commands Command Description MEASUrement? Returns all measurement parameters MEASUrement:CLEARSNapshot Removes the measurement snapshot display MEASUrement:GATing This command specifies the measurement gating MEASUrement:IMMed? Returns all immediate measurement setup parameters 2-36 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-33: Measurement Commands (cont.) Command Description MEASUrement:IMMed:DELay? Returns information about the immediate delay measurement MEASUrement:IMMed:DELay: DIRection This command specifies the search direction to use for immediate delay measurements MEASUrement:IMMed:DELay: EDGE This command specifies the slope of the edge used for immediate delay “from” and “to” waveform measurements MEASUrement:IMMed:SOUrce This command specifies the “from” source for all single channel immediate measurements This command specifies the source to measure “to” for two-channel measurements MEASUrement:IMMed:TYPe This command specifies the type of the immediate measurement MEASUrement:IMMed:UNIts? Returns the units of the immediate measurement MEASUrement:IMMed:VALue? Returns the value of the immediate measurement MEASUrement:INDICators? Returns all measurement indicator parameters MEASUrement:INDICators: HORZ ? Returns the position of the specified horizontal measurement indicator MEASUrement:INDICators: NUMHORZ? Returns the number of horizontal measurement indicators currently being displayed MEASUrement:INDICators: NUMVERT? Returns the number of vertical measurement indicators currently being displayed MEASUrement:INDICators:STATE This command specifies the state of visible measurement indicators MEASUrement:INDICators: VERT ? Returns the value of the specified vertical measurement indicator MEASUrement:MEAS ? Returns all measurement parameters MEASUrement:MEAS :COUNt? Returns the number of values accumulated since the last statistical reset MEASUrement:MEAS :DELay? Returns the delay measurement parameters for the specified measurement MEASUrement:MEAS :DELay: DIRection This command specifies the search direction to use for delay measurements MEASUrement:MEAS :DELay: EDGE This command specifies the slope of the edge to use for delay “from” and “to” waveform measurements MEASUrement:MEAS : MAXimum? Returns the maximum value found since the last statistical reset MEASUrement:MEAS :MEAN? Returns the mean value accumulated since the last statistical reset MEASUrement:MEAS : MINImum? Returns the minimum value found since the last statistical reset MEASUrement:MEAS : SOUrce This command specifies the “from” source for all single channel immediate measurements This command specifies the source to measure “to” for two-channel measurements MEASUrement:MEAS :STATE This command specifies whether the specified measurement slot is computed and displayed MEASUrement:MEAS :STDdev? Returns the standard deviation of values accumulated since the last statistical reset MEASUrement:MEAS :TYPe This command specifies the measurement type MEASUrement:MEAS :UNIts? Returns measurement units MEASUrement:MEAS :VALue? Returns the value of measurement MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-37 Command Groups Table 2-33: Measurement Commands (cont.) Command Description MEASUrement:METHod This command specifies the method used for calculating reference levels MEASUrement:REFLevel? Returns the current reference level parameters MEASUrement:REFLevel:ABSolute: HIGH This command specifies the top reference level for rise time MEASUrement:REFLevel:ABSolute: LOW This command specifies the low reference level for rise time MEASUrement:REFLevel:ABSolute: MID This command specifies the mid reference level for the specified channel in absolute volts MEASUrement:REFLevel:METHod This command specifies the method for assigning high and low reference levels MEASUrement:REFLevel:PERCent: HIGH This command specifies the top reference percent level for rise time MEASUrement:REFLevel:PERCent: LOW This command specifies the low reference percent level for rise time MEASUrement:REFLevel:PERCent: MID This command specifies the mid reference level for the specified channel in percent MEASUrement:STATIstics Clears or returns all of the statistics accumulated for all period measurements (MEAS1 through MEAS4) MEASUrement:STATIstics:MODe Turns measurement statistics on or off MEASUrement:STATIstics: WEIghting Controls the responsiveness of the mean and standard deviation to waveform changes Miscellaneous Command Group Use the commands in the Miscellaneous Command Group to perform actions that do not fit into other categories. Table 2-34: Miscellaneous Commands Command Description APPLication:LICENSE:SLOT : LOCation? This query returns the application license location. < x> can be slot number 1–4. APPLication:LICENSE:SLOT : TRANSFER You can use this command to transfer an application license from the module to internal memory in the oscilloscope, and transfer it back. APPLication:LICENSE:SLOT : TYPe? This query returns the application license type of the module that is currently inserted in the specified application module slot. APPLication:TYPe When a mask/limit or power test application module is installed, one of the associated test types is always selected by default. This command allows the test type to be changed from the default. AUTOSet Sets the vertical, horizontal and trigger controls to provide a stable display of the appropriate waveform. This is equivalent to pressing the front panel Autoset button AUTOSet:ENAble Enables or disables the autoset feature 2-38 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-34: Miscellaneous Commands (cont.) Command Description AUXOut:SOUrce This command specifies the source for the auxiliary-out port. CLEARMenu Clears the current menu from the display DATE This command specifies the date displayed by the oscilloscope *DDT This command specifies the commands that will be executed by the group execute trigger DESkew Causes the deskew values for all channels to be set to the recommended values DISplay:INTENSITy:BACKLight: AUTODim:TIMe This command specifies the state of the deskew table display ETHERnet:LXI:LAN:PASSWord: ENABle This command controls whether LXI (LAN eXtensions for Instrumentation) is password protected. ETHERnet:LXI:LAN:PASSWord: ESCOPEENABle This command controls whether to use the LXI password for e*Scope (effectively equal to enabling password protection for e*Scope). With e*Scope, you can access any Internet-connected MSO/DPO4000B or MDO4000/B Series Oscilloscope from a web browser. ETHERnet:LXI:LAN:RESET This command resets the LXI local area network. The items which this command reset include: DHCP/BOOTP, mDNS and DNS-SD, e*Scope password protection, LXI password protection, and e*Scope and LXI password. ETHERnet:LXI:LAN:SERVICENAMe This command specifies the mDNS service name used for the LXI interface. ETHERnet:LXI:LAN:STATus? This query returns the LXI network status. ETHERnet:NETWORKCONFig This command specifies the Ethernet network configuration setting. FPAnel:HOLD This command is used to emulate the push-and-hold feature of the Cursor button. FPAnel:PRESS Simulates the action of pressing a specified front-panel button FPAnel:TURN Simulates the action of turning a specified front-panel control knob GPIBUsb:ADDress? Returns the current GPIB address GPIBUsb:ID? Returns the identification string of the connected adaptor module and firmware version HEADer|:HDR This command specifies the Response Header Enable State ID? Returns the instrument identification data similar to that returned by the *IDN? IEEE488.2 common query, including the addition of any enabled application modules. However, it does not include the instrument serial number. *IDN? Returns the same information as the ID? command except the data is formatted according to Tektronix Codes & Formats LANGuage This command specifies the user interface display language LOCk This command specifies the front panel lock state *LRN? Returns a listing of oscilloscope settings NEWpass Changes the password for user protected data PASSWord Enables the *PUD and NEWpass set commands PAUSe This command causes the interface to pause the specified number of seconds before processing any other commands. REM Specifies a comment, which is ignored by the oscilloscope MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-39 Command Groups Table 2-34: Miscellaneous Commands (cont.) Command Description ROSc:SOUrce This command specifies the source for the time base reference oscillator. The reference oscillator locks to this source. Depending on the command argument that you specify, you can use an external reference or use the internal crystal oscillator as the time base reference. ROSc:STATE? This query returns an enumeration value that indicates the lock state of the reference oscillator specified by the ROSc:SOUrce command. SET? Returns a listing of oscilloscope settings SOCKETServer:ENAble This command enables or disables the socket server which supports a Telnet or other TCPIP socket connection to send commands and queries to the instrument. SOCKETServer:PORT This command sets the TCPIP port for the socket server connection. SOCKETServer:PROTOCol This command sets the protocol for the socket server. TEKSecure Initializes both waveform and setup memories TIMe This command specifies the time displayed by the oscilloscope TOTaluptime? Returns the total number of hours that the oscilloscope has been turned on since the nonvolatile memory was last programmed *TRG Performs the group execute trigger (GET) *TST? Tests the interface and returns the status UNLock Unlocks front panel USBTMC? Returns the USBTMC information used by the USB hosts to determine the instrument interfaces. USBTMC:PRODUCTID:DECimal? This query returns the product ID number as a decimal. USBTMC:PRODUCTID: HEXadecimal? This query returns the product ID number as a decimal. USBTMC:SERIALnumber? This query returns the serial number of the oscilloscope. USBTMC:VENDORID:DECimal? This query returns the vendor ID number as a decimal. USBTMC:VENDORID:HEXadecimal? This query returns the vendor ID number as a hexadecimal value. The hexadecimal vendor ID for Tektronix instruments is 0x699. VERBose This command specifies the verbose state PictBridge Command Group Use the commands in the PictBridge Command Group to store printer settings. Table 2-35: PictBridge Commands Command Description PICTBridge:DATEPrint Enables or disables printing the date on the print output PICTBridge:DEFault Sets the arguments for all PICTBridge commands to their default values PICTBridge:IDPrint Enables or disables printing the oscilloscope model and serial number on the print output PICTBridge:IMAGESize This command specifies the image print size 2-40 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-35: PictBridge Commands (cont.) Command Description PICTBridge:PAPERSize Sets the output print paper size PICTBridge:PAPERType This command specifies the paper type PICTBridge:PRINTQual This command specifies the output print quality USBDevice:CONFigure Enables or disables the rear USB port for use with Pictbridge printers Power Command Group Use the commands in the Power Command Group for power analysis. The power measurements include: Power quality Switching loss Safe operating area Harmonics Ripple Modulation analysis This command group is available when the DPO4PWR application module is installed, except for the MDO3000 series, which requires the MDO3PWR application module.. NOTE. To ensure that the power commands are enabled, use the command APPLication:TYPe LIMITMask. Table 2-36: Power Commands Command Description APPLication:TYPe When a mask/limit or power test application module is installed, one of the associated test types is always selected by default. This command allows the test type to be changed from the default. POWer:CURRENTSOurce This command specifies the current source for the power application POWer:DISplay This command controls whether or not to display the power test results. POWer:QUALity:VCRESTfactor? This query returns the measurement for the voltage crest factor. POWer:GATESOurce This command specifies the gate source for the power application POWer:GATing This command specifies the power application gating POWer:HARMonics:DISplay:SELect This command specifies the harmonics to be displayed when the harmonics standard is None POWer:HARMonics:DISplay:TYPe This command specifies the display type for harmonics tests POWer:HARMonics:FREQRef This command specifies the frequency reference waveform for harmonics tests MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-41 Command Groups Table 2-36: Power Commands (cont.) Command Description POWer:HARMonics:FREQRef: FIXEDFREQValue This command specifies the fixed reference frequency value for harmonics measurements POWer:HARMonics:IEC:CLAss This command specifies the filtering class for IEC harmonics POWer:HARMonics:IEC:FILter This command specifies the enabled state for filtering of IEC harmonics POWer:HARMonics:IEC: FUNDamental This command specifies the fundamental current for IEC harmonics POWer:HARMonics:IEC:GROUPing This command specifies the enabled state for grouping of IEC harmonics POWer:HARMonics:IEC: INPUTPOWer Sets of returns the class D input power for IEC harmonics POWer:HARMonics:IEC: LINEFREQuency This command specifies the line frequency for the IEC standard POWer:HARMonics:IEC: OBSPERiod This command specifies the IEC observation period POWer:HARMonics:IEC: POWERFACtor This command specifies the power factor for IEC harmonics POWer:HARMonics:MIL: FUNDamental:CALCmethod This command specifies the measurement method for the MIL harmonics fundamental frequency POWer:HARMonics:MIL: FUNDamental:USER:CURrent This command specifies RMS amperes for User calculation method POWer:HARMonics:MIL: LINEFREQuency This command specifies the line frequency for MIL-STD-1399 Section 300A harmonics tests POWer:HARMonics:MIL: POWERLEVel This command specifies the power level for MIL-STD-1399 Section 300A harmonics tests POWer:HARMonics:NR_HARMonics Sets of returns the number of harmonics (a value in the range of 20 to 400) when the harmonics standard is NONe POWer:HARMonics:RESults: HAR<1-400>:FREQuency? Returns the frequency of the harmonic POWer:HARMonics:RESults: HAR<1-400>:IECMAX? The IEC standard specifies harmonics measurements to be computed in windows of time, with each time window being nominally 200 ms. This returns the maximum of the RMS magnitude of the harmonic, computed across successive 200 ms time windows within an observation period entered by the user POWer:HARMonics:RESults: HAR<1-400>:LIMit? The IEC and MIL standards specify a limit for each harmonic magnitude. Returns the limit in absolute units, or as a percentage of the fundamental as specified by the standard. IEC Class C (Table 2) and MIL standards specify the limit as a percentage of the fundamental POWer:HARMonics:RESults: HAR<1-400>:PHASe? Returns the phase of the harmonic in degrees. The phase is measured relative to the zero-crossing of the reference waveform. When there is no reference waveform, the phase is relative to the fundamental component POWer:HARMonics:RESults: HAR<1-400>:RMS:ABSolute? Returns the RMS magnitude of the harmonic expressed in absolute units POWer:HARMonics:RESults: HAR<1-400>:RMS:PERCent? Returns the RMS magnitude of the harmonic expressed as a percentage of the fundamental 2-42 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-36: Power Commands (cont.) Command Description POWer:HARMonics:RESults: HAR<1-400>:TEST:IEC: CLASSALIMit? Returns PASS, FAIL or NA. Specifies if the IEC Class A higher harmonic limit (and conditions) are met POWer:HARMonics:RESults: HAR<1-400>:TEST:IEC:NORMAL? Returns PASS, FAIL or NA. Specifies if the Normal IEC harmonic limits are met POWer:HARMonics:RESults: HAR<1-400>:TEST:IEC:POHCLIMit? Returns PASS, FAIL or NA. Specifies if the higher harmonic limit (and conditions) for the 21st and higher order odd harmonics are met POWer:HARMonics:RESults: HAR<1-400>:TEST:MIL:NORMAL? Returns the test result for the specified harmonic for the MIL-STD-1399 Section 300A testing standard POWer:HARMonics:RESults:IEC: FUNDamental? Returns the IEC fundamental frequency POWer:HARMonics:RESults:IEC: HARM3ALTernate? Returns the IEC harmonics test result for the 3rd harmonic: PASS, FAIL or NA POWer:HARMonics:RESults:IEC: HARM5ALTernate? Returns the IEC harmonics test result for the 5th harmonic: PASS, FAIL or NA POWer:HARMonics:RESults:IEC: POHC? Returns the IEC POHC measurement POWer:HARMonics:RESults:IEC: POHL? Returns the IEC POHL measurement POWer:HARMonics:RESults:IEC: POWer? Returns the IEC input power measurement POWer:HARMonics:RESults:IEC: POWERFactor? Returns the IEC power factor measurement POWer:HARMonics:RESults: PASSFail? Returns the overall harmonics test result: PASS, FAIL or NA POWer:HARMonics:RESults:RMS? Returns the root mean square value of the source waveform POWer:HARMonics:RESults:SAVe Saves the harmonic results to the specified file in CSV format POWer:HARMonics:RESults:THDF? Returns the Total Harmonic Distortion (THD) in percentage, measured as a ratio to the RMS value of the fundamental component of the source waveform POWer:HARMonics:RESults:THDR? Returns the Total Harmonic Distortion (THD) in percentage, measured as a ratio to the RMS value of the source waveform POWer:HARMonics:SOURce This command specifies the source waveform for harmonics tests POWer:HARMonics:STANDard This command specifies the standard for harmonics tests POWer:INDICators This command specifies the state of the measurement indicators for the power application POWer:MODulation:SOUrce This command specifies the source waveform for modulation tests POWer:MODulation:TYPe This command specifies the modulation type POWer:QUALity:APPpwr? Returns the apparent power measurement POWer:QUALity:DISplay:APPpwr This command specifies the display state for the apparent power readout POWer:QUALity:DISplay: FREQuency This command specifies the display state for the frequency readout MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-43 Command Groups Table 2-36: Power Commands (cont.) Command Description POWer:QUALity:DISplay: ICRESTfactor This command specifies the display state for the current crest factor readout POWer:QUALity:DISplay:IRMS This command specifies the display state for the rms current (IRMS) readout POWer:QUALity:DISplay: PHASEangle This command specifies the display state for the phase angle readout POWer:QUALity:DISplay: POWERFACtor This command specifies the display state for the power factor readout POWer:QUALity:DISplay:REACTpwr This command specifies the display state for the reactive power readout POWer:QUALity:DISplay:TRUEpwr This command specifies the display state for the true power readout POWer:QUALity:DISplay: VCRESTfactor This command specifies the display state for the voltage crest factor readout POWer:QUALity:DISplay:VRMS This command specifies the display state for the rms voltage (VRMS) readout POWer:QUALity:FREQREFerence This command specifies the power quality frequency reference POWer:QUALity:FREQuency? Returns the frequency measurement POWer:QUALity:ICRESTfactor? Returns the current crest factor measurement POWer:QUALity:IRMS? Returns the rms current measurement POWer:QUALity:PHASEangle? Returns the phase angle measurement POWer:QUALity:POWERFACtor? Returns the power factor measurement POWer:QUALity:REACTpwr? Returns the reactive power measurement POWer:QUALity:TRUEpwr? Returns the true power measurement POWer:QUALity:VRMS? Returns the rms voltage measurement POWer:REFLevel:ABSolute Sets the reference levels to their default unit values POWer:REFLevel:ABSolute:HIGH This command specifies the top reference level for rise time POWer:REFLevel:ABSolute:LOW This command specifies the low reference level for rise time POWer:REFLevel:ABSolute:MID This command specifies the mid reference level for measurements POWer:REFLevel:HYSTeresis This command specifies the measurement reference level hysteresis value POWer:REFLevel:METHod This command specifies the method used to calculate the 0% and 100% reference level POWer:REFLevel:PERCent Sets the reference levels to the default percentage values POWer:REFLevel:PERCent:HIGH This command specifies the top reference percent level for rise time POWer:REFLevel:PERCent:LOW This command specifies the low reference percent level for rise time POWer:REFLevel:PERCent:MID This command specifies the mid reference percent level for waveform measurements POWer:RIPPle Sets the vertical offset of the source waveform POWer:RIPPle:RESults:AMPLitude? Returns the peak-to-peak ripple measurement POWer:RIPPle:RESults:MAX? Returns the maximum of the peak-to-peak ripple measurements POWer:RIPPle:RESults:MEAN? Returns the mean of the peak-to-peak ripple measurements POWer:RIPPle:RESults:MIN? Returns the minimum of the peak-to-peak ripple measurement POWer:RIPPle:RESults:STDdev? Returns the standard deviation of the peak-to-peak ripple measurements POWer:RIPPle:SOUrce This command specifies the source waveform for ripple tests 2-44 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-36: Power Commands (cont.) Command Description POWer:SOA:LINear:XMAX This command specifies the user XMAX value for use in linear SOA calculations POWer:SOA:LINear:XMIN This command specifies the user XMIN value for use in linear SOA calculations POWer:SOA:LINear:YMAX This command specifies the user YMAX value for use in linear SOA calculations POWer:SOA:LINear:YMIN This command specifies the user YMIN value for use in linear SOA calculations POWer:SOA:LOG:XMAX This command specifies the user XMAX value for use in log SOA calculations POWer:SOA:LOG:XMIN This command specifies the user XMIN value for use in log SOA calculations POWer:SOA:LOG:YMAX This command specifies the user YMAX value for use in log SOA calculations POWer:SOA:LOG:YMIN This command specifies the user YMIN value for use in log SOA calculations POWer:SOA:MASK:DEFine This command specifies the X (volts) and Y (Amps) coordinates of the current SOA mask POWer:SOA:MASK:MAXAmps This command specifies the maximum current applied to SOA mask testing POWer:SOA:MASK:MAXVolts This command specifies the maximum voltage applied to SOA mask testing POWer:SOA:MASK:MAXWatts This command specifies the maximum power applied to SOA mask testing POWer:SOA:MASK:NR_Pt? Returns the number of mask points defined POWer:SOA:MASK:STATE This command specifies the state of the mask for SOA calculations POWer:SOA:MASK:STOPOnviol This command specifies the enabled state of the mask stop on violation condition POWer:SOA:PLOTTYPe This command specifies the SOA plot type POWer:SOA:RESult:FAILures:QTY? Returns the number of failures in the test POWer:SOA:RESult:NUMACq? Returns the number of acquisitions in the test POWer:SOA:RESult:STATE? Returns the pass/fail state of the SOA test POWer:STATIstics Clears all the accumulated statistics of all measurements POWer:STATIstics:MODe Enables or disables the display of the measurement statistics POWer:STATIstics:WEIghting Sets the number of samples which are included for the statistics computations for mean and the standard deviation POWer:SWLoss: CONDCALCmethod This command specifies the power application switching loss conduction calculation method POWer:SWLoss:CONDuction: ENERGY:MAX? Returns the maximum conduction energy for the switching loss calculation POWer:SWLoss:CONDuction: ENERGY:MEAN? Returns the mean conduction energy for the switching loss calculation POWer:SWLoss:CONDuction: ENERGY:MIN? Returns the minimum conduction energy for the switching loss calculation POWer:SWLoss:CONDuction: POWer:MAX? Returns the maximum conduction power for the switching loss calculation POWer:SWLoss:CONDuction: POWer:MEAN? Returns the mean conduction power for the switching loss calculation POWer:SWLoss:CONDuction: POWer:MIN? Returns the minimum conduction power for the switching loss calculation POWer:SWLoss:DISplay This command specifies the display selection for switching loss results POWer:SWLoss:GATe:POLarity This command specifies the switching loss gate polarity MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-45 Command Groups Table 2-36: Power Commands (cont.) Command Description POWer:SWLoss:GATe:TURNON This command specifies the gate turn on level for switching loss power measurements POWer:SWLoss:NUMCYCles? Returns the number of cycles counted for the switching loss calculation POWer:SWLoss:RDSon This command specifies RDSON value for use in switching loss calculations when the conduction calculation method is RDSON POWer:SWLoss:REFLevel: ABSolute:GATEMid This command specifies the mid voltage reference level used in switching loss power measurements in volts POWer:SWLoss:REFLevel: ABSolute:LOWCurrent This command specifies the low current reference level used in switching loss power measurements in amperes POWer:SWLoss:REFLevel: ABSolute:LOWVoltage This command specifies the low voltage reference level used in switching loss power measurements in volts POWer:SWLoss:REFLevel: PERCent:GATEMid This command specifies the mid voltage reference level used in switching loss power measurements in percentage POWer:SWLoss:REFLevel: PERCent:LOWCurrent This command specifies the low current reference level used in switching loss power measurements in percentage POWer:SWLoss:REFLevel: PERCent:LOWVoltage This command specifies the low voltage reference level used in switching loss power measurements in percentage POWer:SWLoss:TOFF:ENERGY: MAX? Returns the maximum Toff energy switching loss calculation POWer:SWLoss:TOFF:ENERGY: MEAN? Returns the mean Toff energy switching loss calculation POWer:SWLoss:TOFF:ENERGY: MIN? Returns the minimum Toff energy switching loss calculation POWer:SWLoss:TOFF:POWer: MAX? Returns the maximum Toff power switching loss calculation POWer:SWLoss:TOFF:POWer: MEAN? Returns the mean Toff power switching loss calculation POWer:SWLoss:TOFF:POWer:MIN? Returns the minimum Toff power switching loss calculation POWer:SWLoss:TON:ENERGY: MAX? Returns the maximum Ton energy switching loss calculation POWer:SWLoss:TON:ENERGY: MEAN? Returns the mean Ton energy switching loss calculation POWer:SWLoss:TON:ENERGY: MIN? Returns the minimum Ton energy switching loss calculation POWer:SWLoss:TON:POWer:MAX? Returns the maximum Ton power switching loss calculation POWer:SWLoss:TON:POWer: MEAN? Returns the mean Ton power switching loss calculation POWer:SWLoss:TON:POWer:MIN? Returns the minimum Ton power switching loss calculation POWer:SWLoss:TOTal:ENERGY: MAX? Returns the maximum total energy switching loss calculation POWer:SWLoss:TOTal:ENERGY: MEAN? Returns the mean total energy switching loss calculation 2-46 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-36: Power Commands (cont.) Command Description POWer:SWLoss:TOTal:ENERGY: MIN? Returns the minimum total energy switching loss calculation POWer:SWLoss:TOTal:POWer: MAX? Returns the maximum total power switching loss calculation POWer:SWLoss:TOTal:POWer: MEAN? Returns the mean total power switching loss calculation POWer:SWLoss:TOTal:POWer:MIN? Returns the minimum total power switching loss calculation POWer:SWLoss:VCEsat This command specifies VCESAT value for use in switching loss calculations when the conduction calculation method is VCESAT POWer:TYPe This command specifies the power application measurement type POWer:VOLTAGESOurce This command specifies the voltage source for the power application RF Command Group The Tektronix MDO4000/B and MDO3000 Series Mixed Domain Oscilloscopes have a built-in RF input, in addition to analog and digital channels, which allows you to display, measure, perform math on and analyze both time and frequency domain signals with one instrument. The MDO4000/B combines the functionality of a mid-range oscilloscope and a standard spectrum analyzer, which makes it able to provide several time-correlated display and measurement options for RF traces. The MDO3000 allows frequency domain measurements but does not offer time-correlated display and measurement options for RF traces. The RF commands are concentrated in the RF Command Group, but also appear in other command groups, including Save and Recall, Waveform Transfer, Trigger and Search. A table is available that links the RF features to their corresponding commands, regardless of command group. (See page 1-2, New or Changed Functionality Updates that Impact the Programmatic Command Set.) Frequency Domain Trace Types The MDO4000/B and MDO3000 support four frequency waveform types: The frequency domain window provides support for four spectrum traces, which may be turned on and off independently. 1. RF Normal trace: Each acquisition is discarded as new data is acquired. 2. RF Max Hold trace: The maximum data values are accumulated over multiple acquisitions of the RF Normal trace. 3. RF Min Hold trace: The minimum data values are accumulated over multiple acquisitions of the RF Normal trace. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-47 Command Groups 4. RF Average trace: Data from the RF Normal trace is averaged over multiple acquisitions. This is true power averaging, which occurs before the log conversion. Each power of 2 average reduces the displayed noise by 3 dB. Time Domain Trace Types The MDO4000/B offers three additional time domain trace types in addition to the usual analog and digital waveforms one expects on an oscilloscope. On these instruments, the time domain window can also display three RF time domain traces derived from the time-domain I&Q data acquired for the RF input. They are time-correlated with the analog and digital channels, and represent a continuous time domain data stream. The time domain trace options are: 1. The RF Amplitude vs. Time trace: The instantaneous amplitude of the input, after band-pass filtering, relative to the current frequency range (as defined by the center frequency and span settings.) 2. The RF Frequency vs. Time trace: The instantaneous frequency of the input, relative to the center frequency. The vertical axis displays frequency. The frequency versus time waveform handle (baseline indicator) indicates the center frequency. When the trace is above the waveform handle, it is above the center frequency. When the trace is below the waveform handle, it is below the center frequency. 3. The RF Phase vs. Time trace: The instantaneous phase of the input, relative to the center frequency. The vertical axis displays phase, with wrapping at roughly +/- 180°. The squelch function is used to suppress the phase and frequency information when the amplitude of the RF input is below a user-specified value. This keeps both the RF Frequency vs. Time and the RF Phase vs. Time traces from displaying broad bands of noise when there is no signal present on the RF input. Time-Correlated Multi-Domain Display (MDO4000/B only.) A single trigger event coordinates acquisition across all analog, digital, and RF inputs. This enables a time-correlated view of both the time and frequency domain signals in a single instrument. Spectrum Time: This is the period of time used to calculate the spectrum shown in the frequency domain graticule. Analog Time: This is the amount of time acquired in the time domain graticule. RF Acquisition Time: This is the amount of time acquired by the RF system. At mid-to-fast time base settings, it equals analog time. At slower time base settings, it can be less than analog time. Acquisition Stages 2-48 RF acquisitions travel through their own signal path before being digitized by the oscilloscope. This signal path includes a combination of analog amplification, MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups attenuation, filtering and down-conversion, depending on the parameters set by the user (frequency, span, reference level, and so forth.) For the MDO4000/B series models, the acquisition system uses one of three frequency bands to acquire RF data depending on where the center frequency and span are set. The bands are: 50 kHz to 3.75 GHz, 2.75 GHz to 4.5 GHz, and 3.5 GHz to 6.0 GHz. For the MDO3000 series models, there is one frequency band (up to 3 GHz depending on the model and installed options). Specifying the Reference Level and Resolution Bandwidth (RBW) Settings Detection Types For the MDO4000/B series models, the reference level is adjustable from –140 dBm to +30 dBm. For the MDO3000 series models, the reference level is adjustable from –140 dBm to +20 dBm. For all series, attenuation is set automatically with the reference level. The RBW setting is adjustable down to 20 Hz. By default, the RBW tracks span in automatic mode in a 1000:1 ratio; this ratio is adjustable. All MDO instruments calculate Fast Fourier Transform calculations (FFTs) with a 1,000 to ~2,000,000 point output, depending on the acquisition settings. It then reduces that FFT output into a 1,000 pixel-wide display (for the MDO4000/B) or 750 pixel-wide display (for the MDO3000). This means that approximately 1 to 2,000 FFT points get compressed into each pixel column. There are four choices as to how this compression is done: +peak, sample, average, and -peak. Triggering Using RF Power Level as a Source You can use the RF power level as a source for triggering with the MDO4000/B series models (but not the MDO3000 models). The MDO4000/B triggered acquisition system is fully integrated with both the frequency and time domains. This means that a single event can trigger all of the analog, digital and RF acquisitions, regardless of whether that event came from an analog, digital or RF input. The RF power level has been distilled through special processing and may be used as a trigger. RF Power may be used as a source for Edge triggering. With an MDO4TRIG application module installed, the RF Power level can also be used as a source for pulse width, timeout, runt, logic and sequence triggering. (For more information, see Triggering on the RF input. (See page 2-75, Trigger Command Group.) Spectrogram Display (MDO4000/B and MDO3000). The spectrogram is a graph of frequency domain traces over time. It provides an intuitive display that is useful for monitoring slowly changing RF events, and for identifying low amplitude signals too subtle for the eye to catch in a regular spectrum display. The x-axis shows frequency, and the y-axis shows time. Amplitude is represented by the color of the trace. Cold colors (blue, green) indicate low amplitude, and hot colors (red, yellow) indicate high amplitude. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-49 Command Groups Spectrogram slices are generated by taking each spectrum and flipping it on its edge, so that it is one pixel row tall. Each new acquisition adds another slice at the bottom of the spectrogram, and the previous acquisitions (slices) move up one row; you can then navigate backwards through the history of the spectrogram by selecting slice numbers to view. (The spectrogram slice trace is displayed as the RF Normal trace.) Spectrum Mode: Triggered and Free Run When only the frequency domain waveforms are displayed (no time domain waveforms), you can choose whether the MDO4000/B should use Triggered mode or Free Run mode. (MDO3000 only uses Free Run mode.) When Triggered mode is selected, you can control all trigger settings, including Normal and Auto triggering. When Free Run mode is selected, the oscilloscope generates RF acquisitions as fast as possible. (To display only the frequency domain waveforms, turn off all time domain waveforms, including channels 1- 4, digital channels 0 - 15, buses, time domain math waveforms, time domain reference waveforms, and any RF vs. Time traces.) When the oscilloscope displays both time and frequency domain waveforms, then the instrument’s trigger system is in control of the Triggered mode and the RF acquisitions. Using Markers in the Frequency Domain for Measurement and Analysis For frequency domain measurements, up to 11 automatic markers are available to assist with quickly identifying the frequency and amplitude of peaks in the spectrum based upon user threshold and excursion settings. If more peaks meet the criteria than the desired number of markers, then the highest amplitude peaks are shown. Two manual markers are also available for measuring non-peak areas of interest, and to measure Noise Density and Phase Noise. If manual markers are off, the reference marker is automatically placed on the highest amplitude peak. With manual markers on, the reference marker becomes the “A” manual marker. Automatic peak markers are on by default. Each automatic marker has a readout associated with it. These can be absolute or delta readouts. An absolute marker readout shows the actual frequency and amplitude of the associated marker. A delta marker readout shows the frequency and amplitude of the automatic markers relative to the Reference Marker. The Reference Marker’s readout indicates absolute frequency and amplitude, regardless of the readout type. (It is marked on the display with a red R in a triangle.) The marker measurement readouts are absolute in dBm or relative to the reference marker in dBc (dB below carrier amplitude). The threshold and excursion settings define which peaks are marked automatically. The threshold is a minimum amplitude that a signal must cross to be a valid peak. If the threshold is lower, more peaks will tend to qualify for markers. If the threshold is higher, fewer peaks tend to qualify for markers. The excursion is how far a signal needs to fall in amplitude between marked peaks to be another valid peak. If the excursion is low, more peaks will tend to qualify for markers. If the excursion is high, fewer peaks will tend to qualify for markers. 2-50 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups When the two manual markers are turned on, the Reference Marker is no longer automatically attached to the highest amplitude peak. It can now be moved to any desired location. This enables easy measurement of any part of the spectrum, as well as delta measurements to any part of the spectrum. This also lets you measure non-peak spectral content of interest. The readouts for manual markers indicate frequency, amplitude and noise (just like automatic marker readouts). Taking Automatic Measurements in the Frequency Domain You can take three automatic measurements in the frequency domain: 1. Channel Power (CP) — The total power within the bandwidth, defined by the Channel Width. 2. Adjacent Channel Power Ratio (ACPR) — The power in the main channel and the ratio of channel power to main power, for the upper and lower halves of each adjacent channel. 3. Occupied Bandwidth (OBW) — The bandwidth that contains the specified percentage of power within the analysis bandwidth. Triggering using RF Power Level as a Source; Searching The ability to use the RF power level as the source for edge triggering and searching is provided standard with the MDO4000/B series. With the MDO4TRIG (Advanced Trigger) application module installed, the RF power level can also be used as the source for pulse width, time-out, runt, logic, and sequence triggering. (See page 2-75, Trigger Command Group.) A number of search commands are also available. (See page 2-61, Search Command Group.) Transferring and Saving RF Trace Information You can perform waveform transfer commands and queries using RF traces. (See page 2-93, Waveform Transfer Command Group.) RF traces can be saved to an .ISF or .CSV file for subsequent recall to any of the 4 internal reference memory locations. The oscilloscope can also save, but not recall, RF acquisitions as .TIQ files. You can import .TIQ files into Tektronix SignalVu-PC software (PC based), SignalVu software (oscilloscope based), RSAVu software (PC based) or into a Tektronix real-time spectrum analyzer for pulse analysis and demodulation analysis. (See page 2-58, Save and Recall Command Group.) NOTE. The RF input replaces the Aux Input connector on the front panel, therefore aux-in commands and arguments are not supported on the MDO4000/B and MDO3000 models with 4-channels. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-51 Command Groups Table 2-37: RF Commands Item Description MARKER:M :AMPLitude: ABSolute? This query returns the actual amplitude (vertical) value of the either of the two manual markers that are available for frequency domain traces, in dBm. MARKER:M :AMPLitude: DELTa? This query returns the delta amplitude (vertical) value of either of the two manual markers that are available for frequency domain traces, in relation to the Reference Marker. MARKER:M :FREQuency: ABSolute This command specifies the actual frequency (horizontal) value of either of the two manual markers that are available for frequency domain traces. MARKER:M :FREQuency: DELTa? This query returns the delta frequency (horizontal) value of either of the two manual markers that are available for frequency domain traces, in relation to the Reference Marker. MARKER:M :NOISEDensity?, This command returns the noise density of the RF_NORMal trace at the specified marker position in /Hz units, where are the units specified by the command RF:UNIts. MARKER:M :PHASENoise? This command returns the phase noise of the RF_NORMal trace at the specified marker position in dBc/Hz units. MARKER:MANual This command switches on or off the manual markers a and b that are available for frequency domain traces. MARKER:PEAK:EXCURsion This command specifies the excursion value, in user-selected units, for the frequency domain trace automatic peak markers. You can select the units with the command RF:UNIts. MARKER:PEAK:MAXimum This command specifies the maximum number of frequency domain trace peaks that should have automatic markers associated with them. This can be a number between 1 and 11. MARKER:PEAK:STATE This command switches on or off the automatic peak markers that are available for frequency domain traces. The default is 1 (on). There are up to 11 automatic markers. MARKER:PEAK:THReshold This command specifies the threshold value, in the same vertical units as the source waveform, of the automatic peak markers available for frequency domain traces. (Use the RF:UNIts to specify the units.) MARKER:REFERence This command changes the Center Frequency to the frequency indicated by the Reference Marker, in effect moving the Reference Marker to the center of the screen. MARKER:REFERence: AMPlitude? This query returns the amplitude (vertical) value of the Reference Marker in dBm when markers are turned on (using the command MARKER:PEAK:STATE or MARKER:MANual). MARKER:REFERence: FREQuency? This query returns the frequency of the Reference Marker when the frequency domain trace markers have been turned on (using either the command MARKER:PEAK:STATE or MARKER:MANual). MARKER:TYPe This command specifies the marker type (either DELTa or ABSolute) to use when the automatic markers for the frequency domain traces are turned on. To turn on the automatic markers, use the command MARKER:PEAK:STATE. RF:CLIPPing? Returns a boolean indicating whether the RF input is “clipping” due to input over/under-range detection. RF:DETECTionmethod:MODe This command specifies whether the RF detection within the oscilloscope occurs automatically or manually. The default is AUTO. If you set the detection method mode to MANual, you are then able to use the related RF:DETECTionmethod commands to specify detection method options for the frequency domain traces (the options are MINUSpeak, SAMple, PLUSpeak and AVErage). 2-52 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-37: RF Commands (cont.) Item Description RF:DETECTionmethod: RF_AVErage This command specifies the detection method the oscilloscope should use when creating an RF Average trace in the frequency domain. The Average trace displays the average of values from multiple acquisitions at each trace point. RF:DETECTionmethod: RF_MAXHold This command specifies the detection method the oscilloscope should use when creating an RF Max Hold trace in the frequency domain. The Max Hold trace displays the largest value in all acquisition history at each trace point. RF:DETECTionmethod: RF_MINHold This command specifies the detection method the oscilloscope should use when creating an RF Min Hold trace in the frequency domain. The Min Hold trace displays the smallest value throughout the acquisition history at each trace point. RF:DETECTionmethod: RF_NORMal This command specifies the detection method the oscilloscope should use when creating an RF Normal trace in the frequency domain. The Normal trace displays the most recently acquired sample at each trace point. RF:FREQuency This command specifies the center frequency of the RF acquisition system. The center frequency range varies with the model: RF:LABel This command specifies a general label for the RF frequency domain traces. RF:MEASUre:ACPR: ADJACENTPAIRs When the RF measurement type has been set to ACPR, the frequency domain displays a Main channel in the center (Ch:Main), and a side channel group on either side of the Main Channel. There can be either 1, 2 or 3 channels within each side group; this command specifies that number. (Lower Area 1, 2 and 3 would be on the left side of the Main channel; Upper Area 1, 2 and 3 would be on the right side). To set the measurement type to ACPR, use the command RFMEASUre:TYPe ACPR. RF:MEASUre:ACPR:CHANBW This command configures the measurement bandwidth to use for the Main channel, as well as the adjacent side channels, when performing ACPR measurements using a frequency domain trace. The RF measurement type must first be set to ACPR using the command RFMEASUre:TYPe ACPR. RF:MEASUre:ACPR: CHANSPACing This command specifies the center-to-center spacing between the Main channel and adjacent channels when performing ACPR measurements using a frequency domain trace. (The RF measurement type must be set to ACPR using the command RF:MEASUre:TYPe.) Note that if the channel spacing is adjusted to be more narrow than the channel bandwidth, then the oscilloscope will automatically decrease the channel bandwidth. NOTE. The oscilloscope will maintain the span to fit all the channels on-screen, plus a margin of 10% (5% on either side.) RF:MEASUre:ACPR:LA1DB? This query measures a ratio between the first lower adjacent side channel and the Main channel when performing ACPR measurements. The power in the adjacent channel is equivalent to the power in the main channel (dBm) added to the power ratio (dB) of the adjacent channel. (The RF measurement type must be set to ACPR using the command RF:MEASUre:TYPe) RF:MEASUre:ACPR:LA2DB? This query measures a ratio between the second lower side channel and the Main channel when performing ACPR measurements using a frequency domain trace. The power in the adjacent channel is equivalent to the power in the main channel (dBm) added to the power ratio (dB) of the adjacent channel. (The RF measurement type must be set to ACPR using the command RF:MEASUre:TYPe) MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-53 Command Groups Table 2-37: RF Commands (cont.) Item Description RF:MEASUre:ACPR:LA3DB? This query measures a ratio between the third lower side channel and the Main channel when performing ACPR measurements using a frequency domain trace. The power in the adjacent channel is equivalent to the power in the main channel (dBm) added to the power ratio (dB) of the adjacent channel. (The RF measurement type must be set to ACPR using the command RF:MEASUre:TYPe.) RF:MEASUre:ACPR:POWer? This query returns the measure of the total RF power in the Main channel when performing ACPR measurements using a frequency domain trace. It uses the units that have been selected with the command RF:UNIts. RF:MEASUre:ACPR:UA1DB? This query measures a ratio between the first upper side channel and the Main channel when performing ACPR measurements using a frequency domain trace. The power in the adjacent channel is equivalent to the power in the main channel (dBm) added to the power ratio (dB) of the adjacent channel. (The RF measurement type must be set to ACPR using the command RF:MEASUre:TYPe.) RF:MEASUre:ACPR:UA2DB? This query measures a ratio between the second upper side channel and the Main channel when performing ACPR measurements using a frequency domain trace. The power in the adjacent channel is equivalent to the power in the main channel (dBm) added to the power ratio (dB) of the adjacent channel. (The RF measurement type must be set to ACPR using the command RF:MEASUre:TYPe.) RF:MEASUre:ACPR:UA3DB? This query measures a ratio between the third upper side channel and the Main channel when performing ACPR measurements using a frequency domain trace. The power in the adjacent channel is equivalent to the power in the main channel (dBm) added to the power ratio (dB) of the adjacent channel. (The RF measurement type must be set to ACPR using the command RF:MEASUre:TYPe.) RF:MEASUre:CP:CHANBW This command specifies the channel bandwidth to use when the RF measurement type has been set to Channel Power (CP) using the command RF:MEASUre:TYPe. RF:MEASUre:CP:POWer? This query returns the total channel power within the displayed channel bandwidth, when the RF measurement type has been set to CP (using the command RF:MEASUre:TYPe). RF:MEASUre:OBW:CHANBW This command specifies the Analysis Bandwidth to use, when the measurement type has been set to OBW (using the command RF:MEASUre:TYPe). Note that the span automatically increases or decreases to be 10% more than the Analysis Bandwidth (providing some room around the signal of interest). RF:MEASUre:OBW:LOWERFreq? This query returns the lower frequency threshold (on the display, the white line to the left bracketing OBW power). The RF measurement type must be set to OBW using the command RF:MEASUre:TYPe. RF:MEASUre:OBW: PERCENTdown This command specifies the percentage of total power within the Analysis Bandwidth (the OBW power) such that half of the remaining power will be below the OBW:LOWERFreq level and the other half of the remaining power will be above the OBW:UPPERFreq level. RF:MEASUre:OBW:POWer? This query returns the total channel power within the occupied bandwidth, when the RF measurement type has been set to OBW (using the command RF:MEASUre:TYPe). RF:MEASUre:OBW:UPPERFreq? This query returns the upper frequency threshhold (on the display, the white line to the right bracketing OBW power). The RF measurement type must be set to OBW using the command RF:MEASUre:TYPe. RF:MEASUre:TYPe This command specifies the RF measurement type: Channel Power, Adjacent Channel Power Ratio, Occupied Bandwidth, or none. 2-54 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-37: RF Commands (cont.) Item Description RF:POSition This command specifies the vertical position for the frequency domain traces. The vertical position is the location of the Reference Level with respect to the top of the graticule, in divisions. The lower limit is –10 divisions. The upper limit is +10 divisions. RF:PRObe:AUTOZero This command executes the attached probe’s AutoZero function, for probes that support this feature. RF:PRObe:CALibrate This command executes a calibration or initialization for a probe attached to the RF input, if the probe is calibratable. RF:PRObe:CALibrate: CALIBRATABLe? This query returns a boolean value that indicates whether the attached probe is calibratable. RF:PRObe:CALibrate:STATE? This command returns the calibration state of the probe connected to the RF input. RF:PRObe:COMMAND This command sets the state of the probe control specified with the first argument to the state specified with the second argument. RF:PRObe:DEGAUss This command starts a degauss/AutoZero cycle on a TekVPI current probe attached to the RF input. RF:PRObe:DEGAUss:STATE? This command returns the state of the probe degauss for the RF input. RF:PRObe:FORCEDRange This command specifies the range of a TekVPI probe attached to the RF input. RF:PRObe:GAIN This command specifies the scale factor for the probe attached to the RF input. RF:PRObe:ID:SERnumber? This query returns the serial number of the probe attached to the RF input. RF:PRObe:ID:TYPe? This query returns the type of probe attached to the RF input. RF:PRObe:PREAmp:MODe Sets or returns the user selected mode for an RF pre-amp connected to the RF input. BYPass or AUTO RF:PRObe:PREAmp:STATus? Returns the actual state of the RF pre-amp connected to the RF input. NONe, ON, or BYPass RF:PRObe:RESistance? This query returns the input resistance of the probe attached to the RF input, if the probe supports it (otherwise, it returns 0.0). The RF input is 50 Ω impedance. RF:PRObe:SIGnal This command specifies the input bypass setting of a TekVPI probe attached to the RF input. The probe must support input bypass. RF:PRObe:UNIts? This query returns a quoted string that describes the units of measure for the probe attached to the RF input. RF:RBW This command specifies the resolution bandwidth (RBW) setting when the RBW mode has been set to MANUAL (using the command RF:RBW:MODe). The resolution bandwidth is the width of the narrowest measurable band of frequencies in a frequency domain trace. The RBW is adjustable down to 20Hz. By default, the RBW tracks the span value in a 1000:1 ratio. RF:RBW:MODe This command specifies the resolution bandwidth (RBW) mode, either automatic or manual. RF:REFLevel This command sets the Reference Level of the RF input. The Reference Level can either be specified as a numeric floating point value, or set automatically. RF:RF_AMPlitude:LABel This command specifies the label for the RF Amplitude vs. Time trace. RF:RF_AMPlitude:VERTical: POSition This command specifies the vertical position of the RF Amplitude vs. Time trace. The position value determines the vertical graticule location at which the trace is displayed. Increasing the position value of a waveform causes the waveform to move up. Decreasing the position value causes the waveform to move down. The minimum is -50 divisions and the maximum is 50 divisions with a resolution of 0.02 divisions. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-55 Command Groups Table 2-37: RF Commands (cont.) Item Description RF:RF_AMPlitude:VERTical: SCAle This command specifies the vertical scale for the RF Amplitude vs. Time trace. For a signal with constant amplitude, increasing the scale causes the waveform to be displayed smaller. Decreasing the scale causes the waveform to be displayed larger. RF:RF_AVErage:COUNt? This query returns the number of RF traces that have been accumulated to create an RF Average frequency domain trace. RF:RF_AVErage:NUMAVg This command specifies the number of acquisitions to be used when creating an RF Average frequency domain trace, which displays the average of values from multiple acquisitions at each trace point. The default is 16. The range is 2 – 512, in exponential increments. RF:RF_FREQuency:LABel This command specifies the label for the RF Frequency vs. Time trace. RF:RF_FREQuency:VERTical: POSition This command specifies the vertical position for the RF Frequency vs. Time trace. The position value determines the vertical graticule location at which the trace is displayed. Increasing the position value of a waveform causes the waveform to move up. Decreasing the position value causes the waveform to move down. The minimum is -50 divisions and the maximum is 50 divisions with a resolution of 0.02 divisions. RF:RF_FREQuency:VERTical: SCAle This command specifies the vertical scale for the RF Frequency vs. Time trace. For a signal with constant amplitude, increasing the scale causes the waveform to be displayed smaller. Decreasing the scale causes the waveform to be displayed larger. RF:RF_PHASe:LABel This command specifies the label for the RF Phase vs. Time trace. RF:RF_PHASe:REFERence: DEGrees Sets or returns the phase, in degrees, at the trigger point for the RF_PHASe time domain trace. RF:RF_PHASe:VERTical:POSition This command specifies the vertical position for RF Phase vs. Time trace. The position value determines the vertical graticule location at which the trace is displayed. Increasing the position value of a waveform causes the waveform to move up. Decreasing the position value causes the waveform to move down. The minimum is -50 divisions and the maximum is 50 divisions with a resolution of 0.02 divisions. RF:RF_PHASe:VERTical:SCAle This command specifies the vertical scale for RF Phase vs. Time trace. For a signal with constant amplitude, increasing the scale causes the waveform to be displayed smaller. Decreasing the scale causes the waveform to be displayed larger. RF:RF_PHASe:WRAP:DEGrees Sets or returns the number of degrees to wrap the RF_PHASe time domain trace. RF:RF_PHASe:WRAP:STATE Sets or returns the state of the phase wrap control for the RF_PHASE time domain trace. RF:RF_V_TIMe:BANDWidth Sets or returns the RF versus time bandwidth as an NR3 value in Hz. RF:SCAle This command specifies the overall vertical scale setting of the frequency domain window. The lower limit is 0.1 dB/division. The upper limit is 100dB/division. The vertical scale is adjustable in a 1–2–5 sequence. RF:SPAN This command specifies the span setting. The span is the range of frequencies that can be observed around the center frequency. This is the width of the frequency domain trace, which is equal to the stop frequency minus the start frequency. The span maximum varies according to the oscilloscope model; either 3GHz or 6GHz. RF:SPANRbwratio This command specifies the ratio of the span to the resolution bandwidth (RBW) that will be used when the RBW Mode is set to AUTO. (In order to set the RBW Mode to AUTO, use the command RF:RBW:MODe.) RF:SPECTRogram Clears the spectrogram. 2-56 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Table 2-37: RF Commands (cont.) Item Description RF:SPECTRogram:NUMSLICEs? This query returns the number of spectrogram slices that are currently being rendered. A spectrogram slice is a section of the spectrogram representing one interval, or slice, of time in the spectrogram record. RF:SPECTRogram:SLICESELect This command specifies the spectrogram slice number that is to be displayed. Allowable slice numbers range from 0 to –327 in full-screen mode, and 0 to –147 in split-screen mode. (The range is negative because the numbering starts with the latest slice (0) and proceeds backwards in time.) The slice can only be selected or changed when acquisitions have been stopped. As soon as acquisitions start again, the slice number is reset to 0 (the latest slice). Attempts to select a slice number outside of range, or when acquisitions are running, are ignored. The query form returns the currently selected spectrogram slice. To use this command, first turn on the spectrogram (RF:SPECTRogram:STATE). Then query the number of slices (RF:SPECTRogram:NUMSLICEs?). Stop the acquisition when you’ve reached the number of desired slices. Then select the slice to display (RF:SPECTRogram:SLICESELect). Each slice of the spectrogram corresponds to a single RF acquisition. The FFT samples the entire spectrum for the incoming signal (at the rate with which new spectrums are acquired). The newest spectrum is on the bottom edge of the spectrogram, and the oldest is on the top edge. When the oscilloscope is stopped, you can scroll “back in time” through the spectrogram using the spectrum slice control. When you select a spectrogram slice, it is displayed in the bottom window as the RF Normal trace. RF:SPECTRogram:SLICETIMe? Returns the time stamp of the selected spectrogram slice, as specified by the command :RF:SPECTRogram:SLICESELect. RF:SPECTRogram:STATE This command switches the frequency domain spectrogram display on or off. RF:SPECTRogram:TIMe? Queries the number of seconds in the spectrogram since continuous acquisition started. The value returned is always <= 0. RF:SPECTRUMMode When only the frequency domain waveforms are displayed, this command specifies the RF spectrum mode: either TRIGgered or FREErun. The default is FREErun. RF:SPECTRUMTrace Resets the spectrum traces, RF_MINHold, RF_MAXHold and RF_AVErage. RF:SQUELCH:STATE This command turns the squelch control on or off for the RF Frequency vs. Time and RF Phase vs. Time traces. When squelch is on, only the portions of these traces where the amplitude exceeds the squelch threshold are displayed. This prevents the display of Phase and/or Frequency for signals that are at or near noise levels. The RF amplitude can be observed in the RF Amplitude vs. Time trace. RF:SQUELCH:THReshold This command specifies the squelch threshold level, in volts, for the RF Frequency vs. Time and RF Phase vs. Time traces. RF:STARt This command specifies to exclude frequencies below a certain level from use. RF:STOP This command specifies to exclude frequencies above a certain level from use. RF:UNIts This command specifies the vertical units to be used in all RF-related absolute logarithmic amplitudes. RF:WINdow This command specifies which window will be used for the windowing function, which is only used for the three time domain RF traces (Amplitude vs. Time, Frequency vs. Time and Phase vs. Time). The default window is Kaiser. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-57 Command Groups Table 2-37: RF Commands (cont.) Item Description SEARCH:SPECTral:LIST? This query will return a list of all automatically placed peak markers displayed in the frequency domain graticule. (To return information about manual markers, use the MARKER:M commands.) SELect:RF_AMPlitude This command switches the RF Amplitude vs. Time trace display on or off in the time domain graticule. SELect:RF_AVErage This command switches the RF Average trace display on or off in the frequency domain graticule. SELect:RF_FREQuency This command switches the RF Frequency vs. Time trace display on or off in the time domain graticule. SELect:RF_MAXHold This command switches the frequency domain Max Hold trace display on or off in the frequency domain graticule. SELect:RF_MINHold This command switches the frequency domain Min Hold trace display on or off in the frequency domain graticule. SELect:RF_NORMal This command switches the frequency domain Normal trace display on or off in the frequency domain graticule. SELect:RF_PHASe This command switches the RF Phase vs. Time trace display on or off in the time domain graticule. Save and Recall Command Group Use the commands in the Save and Recall Command Group to store and retrieve waveforms and settings. When you save a setup, you save all the settings of the oscilloscope. When you recall a setup, the oscilloscope restores itself to the state it was in when you originally saved the setting. NOTE. External file structure is as follows: E: is the USB memory device plugged into the first USB port on the front of the oscilloscope. F: is the USB memory device plugged into the second USB port on the front of the oscilloscope. (Not available for MDO3000 models). G: and H: are the USB memory device plugged into the USB ports on the rear of the oscilloscope. (Not available for MDO3000 models.) I: — Z are for network storage. 2-58 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups NOTE. Analog, digital, and RF waveforms and traces and those waveforms and traces derived from them (such as math and reference) can be saved to an ISF file. When saving all channels in ISF format, a group of files will be saved. Each will have the same value for XXXX, but the YYY values will be set to the different channels that were turned on when the Save All Waveforms operation was performed. The oscilloscope can save, but not recall, RF acquisitions as .TIQ files. You can import .TIQ files into Tektronix SignalVu-PC software (PC based), SignalVu software (oscilloscope based), RSAVu software (PC based) or into a Tektronix real-time spectrum analyzer for pulse analysis and demodulation analysis. Table 2-38: Save and Recall Commands Command Description FACtory Resets the oscilloscope to factory default settings *RCL Recalls saved oscilloscope settings RECAll:SETUp Recalls saved oscilloscope settings RECAll:SETUp:DEMO This command recalls one of the 6 specified built-in demonstration setups of RF functionality. can be 1 through 6. The demonstrations include 1. Multiple Peaks, 2. spectrogram, 3. VCO/PLL Turn On, 4. ASK Modulation, 5. Frequency Hop and 6. Capture BW. RECAll:WAVEform This command (no query form) recalls a stored waveform to a reference memory location, and, for instruments with the arbitrary waveform feature, to arbitrary waveform edit memory (EMEM). Only the first waveform in the .CSV file is recalled for multiple waveform .CSV files. Recall of digital waveforms (D0 through D15) is not supported. *SAV Stores the state of the oscilloscope to a specified memory location SAVe:ASSIgn:TYPe This command specifies the assignment of the save button SAVe:EVENTtable:{BUS |B } Saves event table data from bus to a specified file SAVe:IMAGe Saves a capture of the screen image to the specified file SAVe:IMAGe:FILEFormat This command specifies the file format to use for saving screen images. The file format is not automatically determined by the file name extension. You need to choose a file name with an extension which is consistent with the selected file format SAVe:IMAGe:INKSaver This command specifies the current inksaver setting for the SAVe:IMAGe command SAVe:IMAGe:LAYout This command specifies the layout to use for saved screen images SAVe:SETUp Saves the state of the oscilloscope to a specified memory location or file SAVe:WAVEform This command saves the specified waveform to the specified destination reference memory slot, or saves the specified waveform(s) to the specified destination file. The same function can be accomplished from the front panel Menu->save waveform menu. The type of file saved is dependent upon the SAVe:WAVEform:FILEFormat command. SAVe:WAVEform:FILEFormat This command specifies the format for saving waveforms. This command specifies the file format to be used when saving waveforms — either an internal format, .ISF, or an external comma-delimited spreadsheet format, .CSV, that includes waveform header and timing information. SAVe:WAVEform:FILEFormat: RF_BB_IQ This command specifies the file format for saving the RF baseband I & Q data. The default format is TIQ. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-59 Command Groups Table 2-38: Save and Recall Commands (cont.) Command Description SAVe:WAVEform:GATIng Specifies whether save waveform operations should save the entire waveform or a specified portion of the waveform SETUP :DATE? Returns the date when the specified oscilloscope setup was saved SETUP :LABEL This command specifies the specified oscilloscope setup label SETUP :TIME? Returns the time when the specified oscilloscope setup was saved 2-60 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Search Command Group The search commands let you analyze your source waveform record for conditions specified by a search’s criteria. Once these criteria are matched, the oscilloscope places a search mark at that location in the waveform record. You can then navigate or save the marks. (See page 2-30, Mark Command Group.) When performing an edge, pulse width, runt, transition (rise/fall time), time-out, or bus search, you can use only one waveform at a time. When performing a logic or a setup/hold search, you can use any or all of the displayed waveforms at the same time. For example, with a logic search, you can search for instances when CH1 is high and CH2 is low. Likewise, with a setup and hold search, you can search for instances when the clock source is CH1 and the data sources are CH2 and CH3. With pulse width searching, the oscilloscope can search for pulses with widths less than, greater than, equal to, or not equal to a specified time. Additionally, it can search for pulses with widths within, or outside of a range of two different specified times. Searching can take place on either positive or negative pulses. Searches on RF waveforms can only use time domain traces (RF Amplitude vs. Time, RF Frequency vs. Time and RF Phase vs. Time). (MDO4000/B only.) A series of example command sequences showing different searches and triggers is included as an appendix. (See page F-1, Search and Trigger Command Sequence Examples.) Searching using Thresholds All search types except bus searches use thresholds, which are vertical values that the source waveform must cross in order for a mark to be placed. For example, if you set the search type to EDGE, and the search source to CH1, the search’s slope to RISE, and the search’s threshold value to 1.5V, then that search will find all places where CH1 transitions from below 1.5 volts to above 1.5 volts. Each individual search source waveform has two threshold values: a low threshold and a high threshold. Note that if you change the search source waveform, you must explicitly set the thresholds. For example, if you set the search’s CH1 lower threshold to 1.5 volts, and then decide to change the search’s source waveform to CH2, you must then explicitly set CH2’s lower threshold value to the value you would like (it will not automatically be 1.5 volts). If you have an edge search set up on CH1 with the threshold you’d like, then decide to change to a logic search and change the threshold on CH1 to fit your logic search, and then change back to an edge search, your initial threshold setting on the edge search will be lost. MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-61 Command Groups Bus, Video, and RF application modules A table is available that lists all commands enabled by each application module (See page G-1, Application Module-enabled Commands.) For I2C or SPI bus signals, install the DPO4EMBD application module, except for MDO3000 models, which require MDO3EMBD. For RS-232, RS-422, RS-485, or UART bus signals, install the DPO4COMP module, except for MDO3000 models, which require MDO3AUDIO. For I2S, Left Justified (LJ), Right Justified (RJ), or TDM bus signals, install the DPO4AUDIO module, except for MDO3000 models, which require MDO3AUDIO. For CAN or LIN bus signals, install the DPO4AUTO or DPO4AUTOMAX module, except for MDO3000 models, which require MDO3AUTO. For FlexRay bus signals, install the DPO4AUTOMAX module, except for MDO3000 models, which require MDO3FLEX. For Ethernet signals, when tested with the MDO4000/B and MSO/DPO4000B, install the DPO4ENET module. Note that ≥350 MHz bandwidth models are recommended for 100BASE-TX. For MIL-STD-1553 bus signals, install the DPO4AERO module, except for MDO3000 models, which require MDO3AERO. For USB bus signals, install the DPO4USB module, except for MDO3000 models, which require MDO3USB. Note that 1 GHz bandwidth models are recommended for high-speed (HS) USB. For video signals, install the DPO4VID module, except for the MDO3000 models, which do not require a module. For RF signals (MDO4000/B Series only), install the MDO4TRIG module. Search Commands Command Description SEARCH? Returns all search-related settings SEARCH:SEARCH :COPy Copies the search criteria to the trigger, or the trigger criteria to the search SEARCH:SEARCH :LIST? This query returns a list of all automatically created search marks on waveforms in the time domain (leaving out any manually created marks). These automatic marks are created using a search command. The entries returned are in the form of an enumeration representing the source waveform, followed by 7 time mark parameters. SEARCH:SEARCH :STATE Sets the search state to on or off SEARCH:SEARCH :TOTal? Returns the total number of matches for search SEARCH:SEARCH :TRIGger:A:BUS? Queries the SEARCH:SEARCH :TRIGger:A:BUS settings. 2-62 MDO4000/B, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH :TRIGger:A:BUS:B :AUDio: CONDition This command sets the condition (start of frame or matching data) to be used to search on audio bus data. SEARCH:SEARCH :TRIGger:A:BUS:B :AUDio:DATa: HIVALue This command sets the upper word value to be used to search on audio bus data. SEARCH:SEARCH :TRIGger:A:BUS:B :AUDio:DATa: OFFSet This commands sets the data offset value to be used to search on audio bus data. SEARCH:SEARCH :TRIGger:A:BUS:B :AUDio:DATa: QUALifier This command sets the qualifier (<, >, =, <=, >=, not =, in range, out of range) to be used to search on audio bus data. SEARCH:SEARCH :TRIGger:A:BUS:B :AUDio:DATa: VALue This command sets the lower word value to be used to search on audio bus data. SEARCH:SEARCH :TRIGger:A:BUS:B :AUDio:DATa: WORD This command sets the alignment of the data (left, right or either) to be used to search on audio bus data. SEARCH:SEARCH :TRIGger:A:BUS:B :CAN: CONDition This command sets the condition (start of frame, frame type, identifier, matching data, EOF, missing ACK field, bit-stuffing error) to be used to search on CAN bus data. SEARCH:SEARCH :TRIGger:A:BUS:B :CAN:DATa: DIRection This command sets the data direction (read, write or either) to be used to search on CAN bus data. SEARCH:SEARCH :TRIGger:A:BUS:B :CAN:DATa: QUALifier This command sets the qualifier (<, >, =, not =, <=) to be used to search on CAN bus data. SEARCH:SEARCH :TRIGger:A:BUS:B :CAN:DATa: SIZe This command sets the length of the data string, in bytes, to be used to search on CAN bus data. SEARCH:SEARCH :TRIGger:A:BUS:B