Programming Guide Agilent Technologies PSG Family Signal Generators This guide applies to the signal generator models and associated serial number prefixes listed below. Depending on your firmware revision, signal generator operation may vary from descriptions in this guide. E8241A: US4124 E8244A: US4124 E8251A: US4124 E8254A: US4124 Part Number: E8251-90025 Printed in USA February 2002 © Copyright 2001, 2002 Agilent Technologies Inc.
ii
Contents 1. Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Introduction to Remote Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 IO Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Queries Using NI-488.2 and C++. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Queries Using VISA and C. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Generating a CW Signal Using VISA and C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Generating an Externally Applied AC-Coupled FM Signal Using VISA and C . . . . Generating an Internal AC-Coupled FM Signal Using VISA and C . . . . . . . . . . . . .
Contents Data Questionable Power Status Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Questionable Frequency Status Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Questionable Modulation Status Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Questionable Calibration Status Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 127 130 133 4. Command Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents *TST? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . *WAI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Calibration subsystem (:CALibration) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :DCFM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents :CATalog:BINary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :CATalog:LIST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :CATalog:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :CATalog:UFLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :CATalog[:ALL] .
Contents :QUEStionable:CALibration:NTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :QUEStionable:CALibration:PTRansition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :QUEStionable:CALibration[:EVENt] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :QUEStionable:CONDition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :QUEStionable:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents :VERSion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trigger Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :ABORt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :INITiate:CONTinuous[:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents :FLATness:STORe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Frequency Subsystem ([:SOURce]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :FREQuency:FIXed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :FREQuency:MODE . . . . . .
Contents :LIST:DWELl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :LIST:DWELl:POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :LIST:DWELl:TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :LIST:FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :LIST:FREQuency:POINts . .
Contents :PM[1]|2:INTernal[1]|2:FUNCtion:NOISe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :PM[1]|2:INTernal[1]|2:FUNCtion:RAMP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :PM[1]|2:INTernal[1]|2:FUNCtion:SHAPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :PM[1]|2:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :PM[1]|2:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents SCPI Command Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :SYSTem:IDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8340B/41B Compatible Commands (firmware ≥ C.01.21) . . . . . . . . . . . . . . . . . . . . 836xxB/L Compatible SCPI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8373xB and 8371xB Compatible SCPI Commands . . . . . . . . . . . . . . . .
Contents xiv
1 Getting Started 1
Getting Started Introduction to Remote Operation Introduction to Remote Operation PSG family signal generators support the following interfaces: • General Purpose Interface Bus (GPIB) • Local Area Network (LAN) • ANSI/EIA232 (RS-232) serial connection Each of these interfaces, in combination with an IO library and programming language, can be used to remotely control the signal generator.
Getting Started Introduction to Remote Operation Interfaces GPIB GPIB is used extensively when a dedicated computer is available for remote control of each instrument or system. Data transfer is fast because the GPIB handles information in 8-bit bytes. GPIB is physically restricted by the location and distance between the instrument/system and the computer; cables are limited to an average length of two meters per device with a total length of 20 meters.
Getting Started Introduction to Remote Operation Programming Language The programming language is used along with Standard Commands for Programming Instructions (SCPI) and IO library functions to remotely control the signal generator. Common programming languages include: • C/C++ • Agilent BASIC • LabView • Java Java is a U.S. trademark of Sun Microsystems, Inc.
Getting Started Using GPIB Using GPIB The GPIB allows instruments to be connected together and controlled by a computer. The GPIB and its associated interface operations are defined in the ANSI/IEEE Standard 488.1-1987 and ANSI/IEEE Standard 488.2-1992. See the IEEE website, www.ieee.org, for details on these standards. 1. Installing the GPIB Interface Card A GPIB interface card must be installed in your computer.
Getting Started Using GPIB Table 1-2 NI-GPIB Interface Card for PC-Based Systems Interface Card Operating System IO Library Languages Backplane /BUS Max IO National Instrument’s PCI-GPIB Windows 95/98/2000/ ME/NT VISA NI-488.2 C/C++, Visual BASIC, LabView PCI 32 bit 1.5 Mbytes/s National Instrument’s PCI-GPIB+ Windows NT VISA NI-488.2 C/C++, Visual BASIC, LabView PCI 32 bit 1.5 Mbytes/s NI-488.
Getting Started Using GPIB 2. Selecting IO Libraries for GPIB The IO libraries are included with your GPIB interface card. These libraries can also be downloaded from the National Instruments website or the Agilent website. The following is a discussion on these libraries. VISA VISA is an IO library used to develop IO applications and instrument drivers that comply with industry standards. It is recommended that the VISA library be used for programming the signal generator.
Getting Started Using GPIB Table 1-4 Agilent GPIB Cables Model 10833A 10833B 10833C 10833D 10833F 10833G Length 1 meter 2 meters 4 meters .5 meter 6 meters 8 meters 4. Verifying GPIB Functionality Use the VISA Assistant, available with the Agilent IO Library or the Getting Started Wizard available with the National Instrument IO Library, to verify GPIB functionality. These utility programs allow you to communicate with the signal generator and verify its operation over the GPIB.
Getting Started Using GPIB GPIB Function Statements Function statements are the basis for GPIB programming and instrument control. These function statements combined with SCPI provide management and data communication for the GPIB interface and the signal generator. This section describes functions used by different IO libraries. Refer to the NI-488.2 Function Reference Manual for Windows, Agilent Standard Instrument Control Library reference manual, and Microsoft® Visual C++ 6.
Getting Started Using GPIB Remote Function The Agilent BASIC function REMOTE and the other listed IO library functions cause the signal generator to change from local operation to remote operation. In remote operation, the front panel keys are disabled except for the Local key and the line power switch. Pressing the Local key on the signal generator front panel restores manual operation. Table 1-6 Agilent BASIC VISA NI-488.
Getting Started Using GPIB VISA Library NI-488.2 Library SICL The VISA library, at this time, does not have a similar command. The NI-488.2 library function places the instrument described in the parameter list in remote mode by asserting the Remote Enable (REN) GPIB line. The lockout state is then set using the Local Lockout (LLO) GPIB message. Local control can be restored only with the EnableLocal NI-488.2 routine or hard reset. The parameter list describes the interface or device descriptor.
Getting Started Using GPIB Clear Function The Agilent BASIC function CLEAR and the other listed IO library functions cause the signal generator to assume a cleared condition. Table 1-9 Agilent BASIC VISA NI-488.
Getting Started Using GPIB NI-488.2 Library SICL The NI-488.2 library function addresses the GPIB and writes data to the signal generator. The parameter list includes the instrument address, session id, and the data to send. The Agilent SICL function converts data using the format string. The format string specifies how the argument is converted before it is output. The function sends the characters in the format string directly to the instrument.
Getting Started Using LAN Using LAN The signal generator can be remotely programmed via a LAN interface and LAN-connected computer using one of several LAN interface protocols. The LAN allows instruments to be connected together and controlled by a LAN-based computer. LAN and its associated interface operations are defined in the IEEE 802.2 standard. See the IEEE website for more details.
Getting Started Using LAN 2. Setting Up the LAN Interface For LAN operation, an IP address must be assigned to the signal generator and the signal generator connected to the LAN. Your IT administrator can issue a hostname and IP address for the signal generator. 1. Press Utility > GPIB/RS-232 LAN > LAN Setup. 2. Press Hostname. Use the alphanumeric softkeys to enter a hostname. The name is not case sensitive. 3. Press Enter. 4. Press IP Address. Use the left and right arrow keys to move the cursor.
Getting Started Using LAN Table 1-12 Ping Responses Normal Response for UNIX A normal response to the ping command will be a total of 9 or 10 packets received with a minimal average round-trip time. The minimal average will be different from network to network. LAN traffic will cause the round-trip time to vary widely. Normal Response for DOS or Windows A normal response to the ping command will be a total of 9 or 10 packets received if 10 echo requests were specified.
Getting Started Using LAN Using VXI-11 The signal generator supports the LAN interface protocol described in the VXI-11 standard. VXI-11 is an instrument control protocol based on Open Network Computing/Remote Procedure Call (ONC/RPC) interfaces running over TCP/IP. It is intended to provide GBIB capabilities such as SRQ (Service Request), status byte reading, and DCAS (Device Clear State) over a LAN interface.
Getting Started Using LAN Figure 1-2 18 Show Devices Form Chapter 1
Getting Started Using LAN Using Sockets LAN Sockets LAN is a method used to communicate with the signal generator over the LAN interface using the Transmission Control Protocol/ Internet Protocol (TCP/IP). A socket is a fundamental technology used for computer networking and allows applications to communicate using standard mechanisms built into network hardware and operating systems.
Getting Started Using LAN Using TELNET LAN TELNET provides a means of communicating with the signal generator over the LAN. The TELNET client, run on a LAN connected computer, will create a login session on the signal generator. A connection, established between computer and signal generator, generates a user interface display screen with SCPI> prompts on the command line. Using the TELNET protocol to send commands to the signal generator is similar communicating with the signal generator over GPIB.
Getting Started Using LAN Figure 1-3 Connect Form Using TELNET On a PC With a Host/Port Setting Menu GUI 1. On your PC click Start > Run. 2. Type telnet then click the Ok button. The TELNET connection screen will be displayed. 3. Click on the Connect menu then select Remote System. A connection form will be displayed. Refer to Figure 1-3. 4. Enter the hostname, port number, and TermType then click Connect. Refer to Figure 1-3.
Getting Started Using LAN Figure 1-4 TELNET Window The Standard UNIX TELNET Command Synopsis telnet [host [port]] Description This command is used to communicate with another host using the TELNET protocol. When the command telnet is invoked with host or port arguments, a connection is opened to the host, and input is sent from the user to the host. Options and Parameters The command telnet operates in character-at-a-time or line-by-line mode. In line-by-line mode, typed text is echoed to the screen.
Getting Started Using LAN NOTE If your TELNET connection is in line-by-line mode, there is no local echo. This means you cannot see the characters you are typing until you press the Enter key. To remedy this, change your TELNET connection to character-by-character mode. Escape out of TELNET and, at the telnet> prompt, type mode char. If this does not work, consult your TELNET program’s documentation.
Getting Started Using LAN Using FTP FTP allows users to transfer files between the signal generator and any computer connected to the LAN. For example, you can use FTP to download instrument screen images to a computer. When logged onto the signal generator with the FTP command, the signal generator’s file structure can be accessed. Figure 1-5 shows the FTP interface and lists the directories in the signal generator’s user level directory.
Getting Started Using LAN The following steps outline a sample FTP session from the MS-DOS Command Prompt: 1. On the PC click Start > Programs > Command Prompt. 2. At the command prompt enter: ftp < IP address > or < hostname > 3. At the user name prompt, press enter. 4. At the password prompt, press enter. You are now in the signal generator’s user directory. Typing help at the command prompt will show you the FTP commands that are available on your system. 5. Type quit or bye to end your FTP session.
Getting Started Using RS-232 Using RS-232 The RS-232 serial interface can be used to communicate with the signal generator. The RS-232 connection is standard on most PCs and can be connected to the signal generator’s rear-panel AUXILIARY INTERFACE connector using the cable described in Table 1-13 on page 27. Many functions provided by GPIB, with the exception of indefinite blocks, serial polling, GET, non-SCPI remote languages, and remote mode are available using the RS-232 interface.
Getting Started Using RS-232 2. Setting Up the RS-232 Interface 1. Press Utility > GPIB/RS-232 > RS-232 Baud Rate > 9600 Use baud rates 57600 or lower only. Select the signal generator’s baud rate to match the baud rate of your computer or UNIX workstation or adjust the baud rate settings on your computer to match the baud rate setting of the signal generator. NOTE The default baud rate for VISA is 9600. This baud rate can be changed with the “VI_ATTR_ASRL_BAUD” VISA attribute. 2.
Getting Started Using RS-232 3. Verifying RS-232 Functionality You can use the HyperTerminal program available on your computer to verify the RS-232 interface functionality. To run the HyperTerminal program, connect the RS-232 cable between the computer and the signal generator, set the signal generator’s baud rate to 9600, and perform the following steps: 1. On the PC click Start >Programs > Accessories > HyperTerminal. 2. Select HyperTerminal. 3.
Getting Started Using RS-232 If You Have Problems 1. Verify that the baud rate, parity, stop bits, and flow control are the same for the computer and signal generator. 2. Verify that the RS-232 cable is identical to the cable specified in Table 1-13. 3. Verify that the application is using the correct computer COM port and that the RS-232 cable is properly connected to that port.
Getting Started Using RS-232 30 Chapter 1
2 Programming Examples 31
Programming Examples Using the Programming Examples Using the Programming Examples The programming examples for remote control of the signal generator use the GPIB, LAN, and RS-232 interfaces and demonstrate instrument control using different I/O libraries and programming languages. Many of the example programs in this chapter are interactive; the user will be prompted to perform certain actions or verify signal generator operation or functionality.
Programming Examples Using the Programming Examples Programming Examples Development Environment The C/C++ examples in this guide were written using an IBM-compatible personal computer (PC) with the following configuration: • Pentium® processor • Windows NT 4.0 operating system • C/C++ programming language with the Microsoft Visual C++ 6.
Programming Examples GPIB Programming Examples GPIB Programming Examples • “Interface Check using Agilent BASIC” on page 35 • “Interface Check Using NI-488.2 and C++” on page 36 • “Interface Check using VISA and C” on page 37 • “Local Lockout Using Agilent BASIC” on page 38 • “Local Lockout Using NI-488.2 and C++” on page 39 • “Queries Using Agilent BASIC” on page 41 • “Queries Using NI-488.
Programming Examples GPIB Programming Examples Interface Check using Agilent BASIC This simple program causes the signal generator to perform an instrument reset. The SCPI command *RST places the signal generator into a pre-defined state and the remote annunciator (R) appears on the front panel display. The following program example is available on the PSG Family Documentation CD-ROM as basicex1.txt.
Programming Examples GPIB Programming Examples Interface Check Using NI-488.2 and C++ This example uses the NI-488.2 library to verify that the GPIB connections and interface are functional. Launch Microsoft Visual C++ 6.0, add the required files, and enter the following code into your .cpp source file. The following program example is available on the PSG Family Documentation CD-ROM as niex1.cpp.
Programming Examples GPIB Programming Examples Interface Check using VISA and C This program uses VISA library functions and the C language to communicate with the signal generator. The program verifies that the GPIB connections and interface are functional. Launch Microsoft Visual C++ 6.0, add the required files, and enter the following code into your .cpp source file. The following program example is available on the PSG Family Documentation CD-ROM as visaex1.cpp.
Programming Examples GPIB Programming Examples Local Lockout Using Agilent BASIC This example demonstrates the Local Lockout function. Local Lockout disables the front panel signal generator keys. The following program example is available on the PSG Family Documentation CD-ROM as basicex2.txt. 10 !************************************************************************* 20 ! 30 ! PROGRAM NAME: basicex2.
Programming Examples GPIB Programming Examples Local Lockout Using NI-488.2 and C++ This example uses the NI-488.2 library to set the signal generator local lockout mode. Launch Microsoft Visual C++ 6.0, add the required files, and enter the following code into your .cpp source file. The following program example is available on the PSG Family Documentation CD-ROM as niex2.cpp. // // // // // // // // ************************************************************************************ PROGRAM NAME: niex2.
Programming Examples GPIB Programming Examples cout<
Programming Examples GPIB Programming Examples Queries Using Agilent BASIC This example demonstrates signal generator query commands. The signal generator can be queried for conditions and setup parameters. Query commands are identified by the question mark as in the identify command *IDN? The following program example is available on the PSG Family Documentation CD-ROM as basicex3.txt.
Programming Examples GPIB Programming Examples 420 430 440 450 460 470 480 490 500 510 520 530 540 550 560 570 580 42 END IF OUTPUT Sig_gen;"*IDN?" ! Querys for signal generator ID ENTER Sig_gen;C$ ! Enter in the signal generator ID ! Print the signal generator ID to the controller display PRINT PRINT "This signal generator is a ";C$ PRINT ! The next command is a query for the signal generator’s GPIB address OUTPUT Sig_gen;"SYST:COMM:GPIB:ADDR?" ENTER Sig_gen;D$ ! Enter in the signal generator’s address !
Programming Examples GPIB Programming Examples Queries Using NI-488.2 and C++ This example uses the NI-488.2 library to query different instrument states and conditions. Launch Microsoft Visual C++ 6.0, add the required files, and enter the following code into your .cpp source file. The following program example is available on the PSG Family Documentation CD-ROM as niex3.cpp. //************************************************************************************* // PROGRAM NAME: niex3.
Programming Examples GPIB Programming Examples cin.ignore(10000,’\n’); ibwrt(sig, ":FREQ:MODE?",11); // Querys source frequency mode ibrd(sig, rdVal,100); // Enters in the source frequency mode rdVal[ibcntl] = ’\0’; // Null character indicating end of array cout<<"Source frequency mode is "<
Programming Examples GPIB Programming Examples Queries Using VISA and C This example uses VISA library functions to query different instrument states and conditions. Launch Microsoft Visual C++ 6.0, add the required files, and enter the following code into your .cpp source file. The following program example is available on the PSG Family Documentation CD-ROM as visaex3.cpp. //**************************************************************************************** // PROGRAM FILE NAME:visaex3.
Programming Examples GPIB Programming Examples getch(); viPrintf(vi, "POW:AMPL?\n"); viScanf(vi, "%t", rdBuffer); // Querys the power level // Reads the response into rdBuffer // Prints the source power level printf("Source power (dBm) is : %s\n", rdBuffer); printf("Press any key to continue\n"); printf("\n"); // Prints new line character to the display getch(); viPrintf(vi, "FREQ:MODE?\n"); // Querys the frequency mode viScanf(vi, "%t", rdBuffer); // Reads the response into rdBuffer // Prints the source f
Programming Examples GPIB Programming Examples Generating a CW Signal Using VISA and C This example uses VISA library functions to control the signal generator. The signal generator is set for a CW frequency of 500 kHz and a power level of −2.3 dBm. Launch Microsoft Visual C++ 6.0, add the required files, and enter the code into your .cpp source file. The following program example is available on the PSG Family Documentation CD-ROM as visaex4.cpp.
Programming Examples GPIB Programming Examples viPrintf(vi, "POW:AMPL -2.3 dBm\n"); // Set the power level to -2.
Programming Examples GPIB Programming Examples Generating an Externally Applied AC-Coupled FM Signal Using VISA and C In this example, the VISA library is used to generate an ac-coupled FM signal at a carrier frequency of 700 MHz, a power level of −2.5 dBm, and a deviation of 20 kHz. Before running the program: • Connect the output of a modulating signal source to the signal generator’s EXT 2 input connector. • Set the modulation signal source for the desired FM characteristics.
Programming Examples GPIB Programming Examples printf("for an AC-coupled FM signal\n"); printf("Press any key to continue\n"); printf("\n"); getch(); printf("\n"); viPrintf(vi, viPrintf(vi, viPrintf(vi, viPrintf(vi, viPrintf(vi, viPrintf(vi, viPrintf(vi, viPrintf(vi, "*RST\n"); "FM:SOUR EXT2\n"); "FM:EXT2:COUP AC\n"); "FM:DEV 20 kHz\n"); "FREQ 700 MHz\n"); "POW:AMPL -2.
Programming Examples GPIB Programming Examples Generating an Internal AC-Coupled FM Signal Using VISA and C In this example the VISA library is used to generate an ac-coupled internal FM signal at a carrier frequency of 900 MHz and a power level of −15 dBm. The FM rate will be 5 kHz and the peak deviation will be 100 kHz. Launch Microsoft Visual C++ 6.0, add the required files, and enter the following code into your .cpp source file.
Programming Examples GPIB Programming Examples viPrintf(vi, "FREQ 900 MHz\n"); viPrintf(vi, "POW -15 dBm\n"); viPrintf(vi, "FM2:STAT ON\n"); viPrintf(vi, "OUTP:STAT ON\n"); printf("\n"); // // // // // // Sets carrier frequency to 700 MHz Sets the power level to -2.
Programming Examples GPIB Programming Examples Generating a Step-Swept Signal Using VISA and C In this example the VISA library is used to set the signal generator for a continuous step sweep on a defined set of points from 500 MHz to 800 MHz. The number of steps is set for 10 and the dwell time at each step is set to 500 ms. The signal generator will then be set to local mode which allows the user to make adjustments from the front panel. Launch Microsoft Visual C++ 6.
Programming Examples GPIB Programming Examples viPrintf(vi, "INIT:CONT ON\n"); // Begins the step sweep operation // Print user information printf("The signal generator is in step sweep mode. The frequency range is\n"); printf("500 to 800 mHz. There is a .5 sec dwell time at each 30 mHz step.
Programming Examples GPIB Programming Examples Saving and Recalling States Using VISA and C In this example, instrument settings are saved in the signal generator’s save register. These settings can then be recalled separately; either from the keyboard or from the signal generator’s front panel. Launch Microsoft Visual C++ 6.0, add the required files, and enter the following code into your .cpp source file. The following program example is available on the PSG Family Documentation CD-ROM as visaex8.cpp.
Programming Examples GPIB Programming Examples printf("used to save and recall an instrument’s state\n"); printf("\n"); viPrintf(vi, "*RST\n"); // Resets the signal generator viPrintf(vi, "FREQ 5 MHz\n"); // Sets sig gen frequency viPrintf(vi, "POW:ALC OFF\n"); // Turns ALC Off viPrintf(vi, "POW:AMPL -3.2 dBm\n"); // Sets power for -3.
Programming Examples GPIB Programming Examples Reading the Data Questionable Status Register Using VISA and C In this example, the signal generator’s data questionable status register is read. You will be asked to set up the signal generator for error generating conditions. The data questionable status register will be read and the program will notify the user of the error condition that the setup caused. Follow the user prompts presented when the program runs. Launch Microsoft Visual C++ 6.
Programming Examples GPIB Programming Examples viClear(vi); // Clears the signal generator // Prints user information printf("Programming example to demonstrate reading the signal generator’s Status Byte\n"); printf("\n"); printf("Manually set up the sig gen for an unleveled output condition:\n"); printf("* Set signal generator output amplitude to +20 dBm\n"); printf("* Set frequency to maximum value\n"); printf("* Turn On signal generator’s RF Output\n"); printf("* Check signal generator’s display for the
Programming Examples GPIB Programming Examples printf("Press Enter when ready\n"); printf("\n"); getch(); // Waits for keyboard user input viPrintf(vi, "STAT:QUES:MOD:ENAB 16\n"); // Enables the Data Questionable // Modulation Condition Register // bits ’0’,’1’,’2’,’3’ and ’4’ viPrintf(vi, "STAT:QUES:MOD:COND?\n"); // Querys the register for any // set bits viScanf(vi, "%s", rdBuffer); // Reads the decimal sum of the // set bits num=(int (rdBuffer[1]) -(’0’)); // Converts string data to numeric switch (num)
Programming Examples GPIB Programming Examples Reading the Service Request Interrupt (SRQ) Using VISA and C This example demonstrates use of the Service Request (SRQ) interrupt. By using the SRQ, the computer can attend to other tasks while the signal generator is busy performing a function or operation. When the signal generator finishes it’s operation, or detects a failure, then a Service Request can be generated.
Programming Examples GPIB Programming Examples ViStatus viStatus = 0; char rdBuffer[MAX_CNT]; // Declares a variable of type ViStatus // for GPIB verifications // Declare a block of memory data viStatus=viOpenDefaultRM(&defaultRM);// Initialize VISA session if(viStatus < VI_SUCCESS){ // If problems, then prompt user printf("ERROR initializing VISA...
Programming Examples GPIB Programming Examples viStatus = viInstallHandler(vi, VI_EVENT_SERVICE_REQ, interupt, rdBuffer); // The next line of code enables the // detection of an event viStatus = viEnableEvent(vi, VI_EVENT_SERVICE_REQ, VI_HNDLR, VI_NULL); viPrintf(vi, "FREQ:MODE LIST\n");// Sets frequency mode to list viPrintf(vi, "LIST:TYPE STEP\n");// Sets sweep to step viPrintf(vi, "LIST:TRIG:SOUR IMM\n");// Immediately trigger the sweep viPrintf(vi, "LIST:MODE AUTO\n");// Sets mode for the list sweep viP
Programming Examples GPIB Programming Examples viClose(event); return VI_SUCCESS; // Closes the event } Chapter 2 63
Programming Examples LAN Programming Examples LAN Programming Examples • “VXI-11 Programming Using SICL in C” on page 65 • “VXI-11 Programming Using VISA in C” on page 66 • “Setting Parameters and Sending Queries Using Sockets and C” on page 72 • “Setting the Power Level and Sending Queries Using PERL” on page 89 • “Generating a CW Signal Using Java” on page 91 The LAN programming examples in this section demonstrate the use of VXI-11 and Sockets LAN to control the signal generator.
Programming Examples LAN Programming Examples VXI-11 Programing The signal generator supports the VXI-11 standard for instrument communication over the LAN interface. Agilent IO Libraries support the VXI-11 standard and must be installed on your computer before using the VXI-11 protocol. Refer to “Using VXI-11” on page 17 of this Programming Guide for information on configuring and using the VXI-11 protocol. The VXI-11 examples use TCPIP0 as the board address.
Programming Examples LAN Programming Examples char buf[256]; ionerror(I_ERROR_EXIT); // Variable for id string // Register SICL error handler // Open SICL instrument handle using VXI-11 protocol sprintf(instNameBuf, "lan[%s]:inst0", instrumentName); id = iopen(instNameBuf); // Open instrument session itimeout(id, 1000); // Set 1 second timeout for operations printf("Setting frequency to 1 Ghz...\n"); iprintf(id, "freq 1 GHz\n"); // Set frequency to 1 GHz printf("Waiting for source to settle...
Programming Examples LAN Programming Examples // screen. Next the signal generator is set for a -5 dBm power level and then // queried for the power level. The power level is printed to the screen. // // IMPORTANT: Set up the LAN Client using the IO Config utility // //**************************************************************************************** #include #include #include #include #include "StdAfx.h"
Programming Examples LAN Programming Examples status = viRead(instr, (ViBuf)buffer, MAX_COUNT, &retCount); buffer[retCount]= ’\0’; // Indicate the end of the string printf("Power level = "); // Print header to the screen printf(buffer); // Print the queried power level printf("\n"); status = viClose(instr); // Close down the system status = viClose(defaultRM); return 0; } 68 Chapter 2
Programming Examples LAN Programming Examples Sockets LAN Programming using C The program listing shown in “Setting Parameters and Sending Queries Using Sockets and C” on page 72 consists of two files; lanio.c and getopt.c. The lanio.c file has two main functions; int main() and an int main1(). The int main() function allows communication with the signal generator interactively from the command line. The program reads the signal generator's hostname from the command line, followed by the SCPI command.
Programming Examples LAN Programming Examples The int main1() function will output a sequence of commands in a program format. If you want to run a program using a sequence of commands then perform the following: 1. Rename the lanio.c int main1() to int main() and the original int main() to int main1(). 2. In the main(), openSocket() function, change the “your hostname here” string to the hostname of the signal generator you want to control. 3. Resave the lanio.c program 4.
Programming Examples LAN Programming Examples The int main1() function will output a sequence of commands in a program format. If you want to run a program using a sequence of commands then perform the following: 1. Enter the hostname of your signal generator in the openSocket function of the main1() function of the lanio.c program 2. Rename the lanio.cpp int main1() function to int main() and the original int main() function to int main1(). 3. Select Rebuild All from Build menu. Then select Execute Lanio.
Programming Examples LAN Programming Examples Setting Parameters and Sending Queries Using Sockets and C The following programming examples are available on the PSG Family Documentation CD-ROM as lanio.c and getopt.c. /*************************************************************************** * $Header: lanio.c 04/24/01 * $Revision: 1.1 $ * $Date: 04/24/01 * PROGRAM NAME: lanio.c * * $Description: Functions to talk to an Agilent signal generator * via TCP/IP. Uses command-line arguments.
Programming Examples LAN Programming Examples * routines typically use the lower level read() and write() calls. * * - In the Windows environment, file operations such as read(), write(), * and close() cannot be assumed to work correctly when applied to * sockets. Instead, the functions send() and recv() MUST be used. *****************************************************************************/ /* Support both Win32 and HP-UX UNIX environment */ #ifdef _WIN32 /* Visual C++ 6.
Programming Examples LAN Programming Examples # include
Programming Examples LAN Programming Examples /*************************************************************************** * > $Function: openSocket$ * * $Description: open a TCP/IP socket connection to the instrument $ * * $Parameters: $ * (const char *) hostname . . . . Network name of instrument. * This can be in dotted decimal notation. * (int) portNumber . . . . . . . The TCP/IP port to talk to. * Use 7777 for the SCPI port. * * $Return: (int) . . . . . . . . A file descriptor similar to open(1).
Programming Examples LAN Programming Examples peeraddr_in.sin_family = AF_INET; peeraddr_in.
Programming Examples LAN Programming Examples **************************************************************************/ char * recv_line(SOCKET sock, char * result, int maxLength) { #ifdef WINSOCK int cur_length = 0; int count; char * ptr = result; int err = 1; while (cur_length < maxLength) { /* Get a byte into ptr */ count = recv(sock, ptr, 1, 0); /* If no chars to read, stop. */ if (count < 1) { break; } cur_length += count; /* If we hit a newline, stop.
Programming Examples LAN Programming Examples } /*************************************************************************** * > $Function: queryInstrument$ * * $Description: send a SCPI command to the instrument, return a response.$ * * $Parameters: $ * (FILE *) . . . . . . . . . file pointer associated with TCP/IP socket. * (const char *command) . . SCPI command string. * (char *result) . . . . . . where to put the result. * (size_t) maxLength . . . . maximum size of result array in bytes.
Programming Examples LAN Programming Examples { if (ch == ’#’) { /* binary data encountered - figure out what it is */ long numDigits; long numBytes = 0; /* char length[10]; */ count = recv(sock, tmp_buf, 1, 0); /* read 1 char */ ch = tmp_buf[0]; if ((count < 1) || (ch == EOF)) break; /* End of file */ if (ch < ’0’ || ch > ’9’) break; numDigits = ch - ’0’; /* unexpected char */ if (numDigits) { /* read numDigits bytes into result string.
Programming Examples LAN Programming Examples if (recv_line(sock, result, maxLength) == NULL) break; if (strlen(result)==1 && *result == ’\n’) break; resultBytes += strlen(result); result += strlen(result); } while (1); } } else { /* ASCII response (not a binary block) */ *result = (char)ch; if (recv_line(sock, result+1, maxLength-1) == NULL) return 0; /* REMOVE trailing newline, if present. And terminate string.
Programming Examples LAN Programming Examples break; } puts(result_str); } while (1); } /*************************************************************************** * > $Function: isQuery$ * * $Description: Test current SCPI command to see if it a query. $ * * $Return: (unsigned char) . . . non-zero if command is a query. 0 if not.
Programming Examples LAN Programming Examples /*************************************************************************** * > $Function: main$ * * $Description: Read command line arguments, and talk to signal generator. Send query results to stdout. $ * * $Return: (int) . . .
Programming Examples LAN Programming Examples if (optind < argc) { strcat(command, " "); } else { strcat(command, "\n"); } } } else { /*Only provided; input on */ strcpy(command, ""); if (optind > argc) { usage(basename); exit(1); } } } else { /* no hostname! */ usage(basename); exit(1); } /****************************************************** /* open a socket connection to the instrument /******************************************************/ #ifdef WINSOCK if (init_winsock() != 0) { e
Programming Examples LAN Programming Examples long bufBytes; bufBytes = queryInstrument(instSock, command, charBuf, INPUT_BUF_SIZE); if (!quiet) { fwrite(charBuf, bufBytes, 1, stdout); fwrite("\n", 1, 1, stdout) ; fflush(stdout); } } else { commandInstrument(instSock, command); } } else { /* read a line from */ while ( gets(charBuf) != NULL ) { if ( !strlen(charBuf) ) continue ; if ( *charBuf == ’#’ || *charBuf == ’!’ ) continue ; strcat(charBuf, "\n"); if (!quiet) { if (number) { char num[10]; spri
Programming Examples LAN Programming Examples { fwrite(" ", 2, 1, stdout) ; fwrite(charBuf + strlen(charBuf)+1, bufBytes, 1, stdout); fwrite("\n", 1, 1, stdout) ; fflush(stdout); } } else { commandInstrument(instSock, charBuf); } if (number) number++; } } if (show_errs) { showErrors(instSock); } #ifdef WINSOCK closesocket(instSock); close_winsock(); #else close(instSock); #endif /* WINSOCK */ return 0; } /* End of lanio.
Programming Examples LAN Programming Examples /*********************************************/ /* open a socket connection to the instrument*/ /*********************************************/ #ifdef WINSOCK if (init_winsock() != 0) { exit(1); } #endif /* WINSOCK */ instSock = openSocket("xxxxxx", SCPI_PORT); /* Put your hostname here */ if (instSock == INVALID_SOCKET) { fprintf(stderr, "Unable to open socket.\n"); return 1; } /* fprintf(stderr, "Socket opened.
Programming Examples LAN Programming Examples PRORGAM DESCRIPTION: getopt returns the next option letter in argv (starting from argv[1]) that matches a letter in optstring. optstring is a string of recognized option letters; if a letter is followed by a colon, the option is expected to have an argument that may or may not be separated from it by white space. optarg is set to point to the start of the option argument on return from getopt.
Programming Examples LAN Programming Examples posn = strchr(optstring, c); /* DDP */ if (posn == NULL || c == ’:’) { fprintf(stderr, "%s: unknown option -%c\n", argv[0], c); return(’?’); } posn++; if (*posn == ’:’) { if (*scan != ’\0’) { optarg = scan; scan = NULL; } else { optarg = argv[optind]; optind++; } } return(c); } 88 Chapter 2
Programming Examples LAN Programming Examples Sockets LAN Programming Using PERL This example uses PERL script to control the signal generator over the sockets LAN interface. The signal generator power level is set to − 5 dBm, queried for operation complete and then queried for it’s identify string. This example was developed using PERL version 5.6.0 and requires a PERL version with the IO::Socket library. 1.
Programming Examples LAN Programming Examples $response = <$sock>; chomp $response; print "Instrument ID: $response\n"; 90 Chapter 2
Programming Examples LAN Programming Examples Sockets LAN Programming Using Java In this example the Java program connects to the signal generator via sockets LAN. This program requires Java version 1.1 or later be installed on your PC. To run the program perform the following steps: 1. In the code example below, type in the hostname or IP address of your signal generator. For example, String instrumentName = (your signal generator’s hostname). 2. Copy the program as ScpiSockTest.
Programming Examples LAN Programming Examples // Setup read/write mechanism BufferedWriter out = new BufferedWriter( new OutputStreamWriter(t.getOutputStream())); BufferedReader in = new BufferedReader( new InputStreamReader(t.getInputStream())); System.out.println("Setting frequency to 1 GHz..."); out.write("freq 1GHz\n"); // Sets frequency out.flush(); System.out.println("Waiting for source to settle..."); out.write("*opc?\n"); // Waits for completion out.flush(); String opcResponse = in.
Programming Examples RS-232 Programming Examples RS-232 Programming Examples • “Interface Check Using Agilent BASIC” on page 94 • “Interface Check Using VISA and C” on page 95 • “Queries Using Agilent BASIC” on page 97 • “Queries Using VISA and C” on page 98 Before Using the Examples On the signal generator select the following settings: • Baud Rate - 9600 must match computer’s baud rate • Transmit Pace - None • Receive Pace - None • RTS/CTS - None • RS-232 Echo - Off Chapter 2 93
Programming Examples RS-232 Programming Examples Interface Check Using Agilent BASIC This example program causes the signal generator to perform an instrument reset. The SCPI command *RST will place the signal generator into a pre-defined state. The serial interface address for the signal generator in this example is 9. The serial port used is COM1 (Serial A on some computers). Refer to “Using RS-232” on page 26 for more information.
Programming Examples RS-232 Programming Examples Interface Check Using VISA and C This program uses VISA library functions to communicate with the signal generator. The program verifies that the RS-232 connections and interface are functional. In this example the COM2 port is used. The serial port is referred to in the VISA library as ‘ASRL1’ or ‘ASRL2’ depending on the computer serial port you are using. Launch Microsoft Visual C++, add the required files, and enter the following code into the .
Programming Examples RS-232 Programming Examples if(viStatus){ // If operation fails, prompt user printf("Could not open ViSession!\n"); printf("Check instruments and connections\n"); printf("\n"); exit(0);} // initialize device viStatus=viEnableEvent(vi, VI_EVENT_IO_COMPLETION, VI_QUEUE,VI_NULL); viClear(vi); // Sends device clear command // Set attributes for the session viSetAttribute(vi,VI_ATTR_ASRL_BAUD,baud); viSetAttribute(vi,VI_ATTR_ASRL_DATA_BITS,8); viPrintf(vi, "*RST\n"); // Resets the signal g
Programming Examples RS-232 Programming Examples Queries Using Agilent BASIC This example program demonstrates signal generator query commands over RS-232. Query commands are of the type *IDN? and are identified by the question mark that follows the mnemonic. Start Agilent BASIC, type in the following commands, and then RUN the program: The following program example is available on the PSG Family Documentation CD-ROM as rs232ex2.txt.
Programming Examples RS-232 Programming Examples Queries Using VISA and C This example uses VISA library functions to communicate with the signal generator. The program verifies that the RS-232 connections and interface are functional. Launch Microsoft Visual C++, add the required files, and enter the following code into your .cpp source file. The following program example is available on the PSG Family Documentation CD-ROM as rs232ex2.cpp.
Programming Examples RS-232 Programming Examples printf("\n"); exit(0);} // Set timeout for 5 seconds viSetAttribute(instr, VI_ATTR_TMO_VALUE, 5000); // Asks for sig gen ID string status = viWrite(instr, (ViBuf)"*IDN?\n", 6, &retCount); // Reads the sig gen response status = viRead(instr, (ViBuf)buffer, MAX_COUNT, &retCount); buffer[retCount]= ’\0’; // Indicates the end of the string printf("Signal Generator ID: "); // Prints header for ID printf(buffer); // Prints the ID string to the screen printf("\n");
Programming Examples RS-232 Programming Examples 100 Chapter 2
3 Programming the Status Register System 101
Programming the Status Register System Overview Overview During remote operation, it is important to monitor the status of the signal generator. In most applications, it is sufficient to use the :SYSTem:ERRor? query (Refer to “:ERRor[:NEXT]” on page 208) to see if any errors have been posted in the signal generator's error queue. The status register system, described in this chapter, is an alternative method to monitor the status of the signal generator.
Programming the Status Register System Overview Figure 3-1 Chapter 3 The Overall Status Byte Register System 103
Programming the Status Register System Status Register Bit Values Status Register Bit Values Each bit in a register is represented by a numerical value based on its location (see Table 3-1). • To enable a particular bit, send its value with the command. • To enable more than one bit, send the sum of all the bits that you are interested in. • A query returns the sum of all bits that are true. Example: Enable Bit 0 and Bit 6 of *ESE 1. Add the value of bit 0 (1) and the value of bit 6 (64). 2.
Programming the Status Register System Accessing Status Register Information Accessing Status Register Information 1. Determine which register contains the bit that reports the condition. 2. Send the unique SCPI query that reads that register. 3. Examine the bit to see if the condition has changed.
Programming the Status Register System Accessing Status Register Information Deciding How to Monitor You can use either of two methods to programmatically access the information in status registers (either method allows you to monitor one or more conditions). • The polling method In the polling method, the signal generator has a passive role. It tells the controller that conditions have changed only when the controller asks the right question.
Programming the Status Register System Accessing Status Register Information Using the Service Request (SRQ) Method The programming language, I/O interface, and programming environment must support SRQ interrupts (example: BASIC used with GPIB.) Using this method, you must do the following: 1. determine which bit monitors the condition 2. determine how that bit reports to the request service (RQS) bit of the status byte 3.
Programming the Status Register System Accessing Status Register Information If a program enables the controller to detect and respond to service requests, it should instruct the controller to perform a serial poll when SRQ is true. Each device on the bus returns the contents of its status byte register in response to this poll. The device whose RQS bit is set to 1 is the device that requested service.
Programming the Status Register System Accessing Status Register Information *SRE, *SRE? (service request enable) sets and queries the value of the Service Request Enable Register. *STB? (status byte) queries the value of the status byte register without erasing its contents. :STATus:PRESet presets all transition filters, non-IEEE 488.2 enable registers, and error/event queue enable registers. (Refer to Table 3-2.
Programming the Status Register System Status Byte Group Status Byte Group The Status Byte Group includes the Status Byte Register and the Service Request Enable Register.
Programming the Status Register System Status Byte Group Status Byte Register Table 3-3 Status Byte Register Bits Bit Description 0,1 Unused. These bits are always set to 0. 2 Error/Event Queue Summary Bit. A 1 in this bit position indicates that the SCPI error queue is not empty. The SCPI error queue contains at least one error message. 3 Data Questionable Status Summary Bit. A 1 in this bit position indicates that the Data Questionable summary bit has been set.
Programming the Status Register System Status Byte Group Service Request Enable Register The Service Request Enable Register lets you choose which bits in the Status Byte Register triggers a service request 112 *SRE is the sum of the decimal values of the bits you want to enable except bit 6. Bit 6 cannot be enabled. Example: Enable bits 7 and 5 to trigger a service request when either corresponding status group register summary bit sets to 1. Send the command *SRE 160 (128 + 32).
Programming the Status Register System Status Groups Status Groups The Standard Operation Status Group and the Data Questionable Status Group each consist of the following registers; the Standard Event Status Group is similar but does not have negative or positive transition filters. Condition Register Negative Transition Filter Positive Transition Filter Event Register Event Enable Register A condition register continuously monitors the hardware and firmware status of the signal generator.
Programming the Status Register System Status Groups Byte Register. Standard Event Status Group The Standard Event Status Group is used to determine the specific event that set bit 5 in the Status Byte Register. This group consists of the Standard Event Status Register (an event register) and the Standard Event Status Enable Register.
Programming the Status Register System Status Groups Standard Event Status Register Table 3-4 Bit Standard Event Status Register Bits Description 0 Operation Complete. A 1 in this bit position indicates that all pending signal generator operations were completed following execution of the *OPC command. 1 Request Control. This bit is always set to 0. (The signal generator does not request control.) 2 Query Error. A 1 in this bit position indicates that a query error has occurred.
Programming the Status Register System Status Groups Standard Event Status Enable Register The Standard Event Status Enable Register lets you choose which bits in the Standard Event Status Register set the summary bit (bit 5 of the Status Byte Register) to 1. 116 *ESE is the sum of the decimal values of the bits you want to enable.
Programming the Status Register System Status Groups Standard Operation Status Group The Standard Operation Status Group is used to determine the specific event that set bit 7 in the Status Byte Register. This group consists of the Standard Operation Condition Register, the Standard Operation Transition Filters (negative and positive), the Standard Operation Event Register, and the Standard Operation Event Enable Register.
Programming the Status Register System Status Groups Standard Operation Condition Register The Standard Operation Condition Register continuously monitors the hardware and firmware status of the signal generator. Condition registers are read only. Table 3-5 Bit Description 0 Unused. This bit is always set to 0. 1 Settling. A 1 in this bit position indicates that the signal generator is settling. 2 Unused. These bits are always set to 0. 3 Sweeping.
Programming the Status Register System Status Groups Standard Operation Transition Filters (negative and positive) The Standard Operation Transition Filters specify which types of bit state changes in the condition register set corresponding bits in the event register. Changes can be positive (0 to 1) or negative (1 to 0).
Programming the Status Register System Status Groups Data Questionable Status Group The Data Questionable Status Group is used to determine the specific event that set bit 3 in the Status Byte Register. This group consists of the Data Questionable Condition Register, the Data Questionable Transition Filters (negative and positive), the Data Questionable Event Register, and the Data Questionable Event Enable Register.
Programming the Status Register System Status Groups Data Questionable Condition Register The Data Questionable Condition Register continuously monitors the hardware and firmware status of the signal generator. Condition registers are read only. Table 3-6 Bit 0, 1, 2 Data Questionable Condition Register Bits Description Unused. These bits are always set to 0. 3 Power (summary). This is a summary bit taken from the QUEStionable:POWer register.
Programming the Status Register System Status Groups Query: STATus:QUEStionable:CONDition? Response: The decimal sum of the bits set to 1 Example: The decimal value 520 is returned. The decimal sum = 512 (bit 9) + 8 (bit 3). Data Questionable Transition Filters (negative and positive) The Data Questionable Transition Filters specify which type of bit state changes in the condition register set corresponding bits in the event register. Changes can be positive (0 to 1) or negative (1 to 0).
Programming the Status Register System Status Groups Data Questionable Event Enable Register The Data Questionable Event Enable Register lets you choose which bits in the Data Questionable Event Register set the summary bit (bit 3 of the Status Byte Register) to 1. Command: STATus:QUEStionable:ENABle command where is the sum of the decimal values of the bits you want to enable.
Programming the Status Register System Status Groups Data Questionable Power Status Group The Data Questionable Power Status Group is used to determine the specific event that set bit 3 in the Data Questionable Condition Register. This group consists of the Data Questionable Power Condition Register, the Data Questionable Power Transition Filters (negative and positive), the Data Questionable Power Event Register, and the Data Questionable Power Event Enable Register.
Programming the Status Register System Status Groups Data Questionable Power Condition Register The Data Questionable Power Condition Register continuously monitors the hardware and firmware status of the signal generator. Condition registers are read only. Table 3-7 Bit Data Questionable Power Condition Register Bits Description 0 Unused. This bit is always set to 0. 1 Unleveled. A 1 in this bit indicates that the output leveling loop is unable to set the output power. 2 Unused.
Programming the Status Register System Status Groups Data Questionable Power Event Register The Data Questionable Power Event Register latches transition events from the condition register as specified by the transition filters. Event registers are destructive read-only. Reading data from an event register clears the content of that register.
Programming the Status Register System Status Groups Data Questionable Frequency Status Group The Data Questionable Frequency Status Group is used to determine the specific event that set bit 5 in the Data Questionable Condition Register. This group consists of the Data Questionable Frequency Condition Register, the Data Questionable Frequency Transition Filters (negative and positive), the Data Questionable Frequency Event Register, and the Data Questionable Frequency Event Enable Register.
Programming the Status Register System Status Groups Data Questionable Frequency Condition Register The Data Questionable Frequency Condition Register continuously monitors the hardware and firmware status of the signal generator. Condition registers are read-only. Table 3-8 Bit Data Questionable Frequency Condition Register Bits Description 0 Synthesizer Unlocked. A 1 in this bit indicates that the synthesizer is unlocked. 1 10 MHz Reference Unlocked.
Programming the Status Register System Status Groups Data Questionable Frequency Event Register Latches transition events from the condition register as specified by the transition filters. Event registers are destructive read-only. Reading data from an event register clears the content of that register.
Programming the Status Register System Status Groups Data Questionable Modulation Status Group The Data Questionable Modulation Status Group is used to determine the specific event that set bit 7 in the Data Questionable Condition Register. This group consists of the Data Questionable Modulation Condition Register, the Data Questionable Modulation Transition Filters (negative and positive), the Data Questionable Modulation Event Register, and the Data Questionable Modulation Event Enable Register.
Programming the Status Register System Status Groups Data Questionable Modulation Condition Register The Data Questionable Modulation Condition Register continuously monitors the hardware and firmware status of the signal generator. Condition registers are read-only. Table 3-9 Bit Data Questionable Modulation Condition Register Bits Description 0 Modulation 1 Undermod. A 1 in this bit indicates that the External 1 input, ac coupling on, is less than 0.97 volts. 1 Modulation 1 Overmod.
Programming the Status Register System Status Groups Data Questionable Modulation Transition Filters (negative and positive) The Data Questionable Modulation Transition Filters specify which type of bit state changes in the condition register set corresponding bits in the event register. Changes can be positive (0 to 1) or negative (1 to 0).
Programming the Status Register System Status Groups Data Questionable Calibration Status Group The Data Questionable Calibration Status Group is used to determine the specific event that set bit 8 in the Data Questionable Condition Register. This group consists of the Data Questionable Calibration Condition Register, the Data Questionable Calibration Transition Filters (negative and positive), the Data Questionable Calibration Event Register, and the Data Questionable Calibration Event Enable Register.
Programming the Status Register System Status Groups Data Questionable Calibration Condition Register The Data Questionable Calibration Condition Register continuously monitors the calibration status of the signal generator. Condition registers are read only. Table 3-10 Bit 0 1−14 15 Data Questionable Calibration Condition Register Bits Description DCFM/DCΦM Zero Failure. A 1 in this bit indicates that the DCFM/DCΦM zero calibration routine has failed. This is a critical error.
Programming the Status Register System Status Groups Data Questionable Calibration Event Enable Register The Data Questionable Calibration Event Enable Register lets you choose which bits in the Data Questionable Calibration Event Register set the summary bit (bit 8 of the Data Questionable Condition register) to 1. Command: STATus:QUEStionable:CALibration:ENABle , where is the sum of the decimal values of the bits you want to enable.
Programming the Status Register System Status Groups 136 Chapter 3
4 Command Reference 137
Command Reference Command Reference Information Command Reference Information SCPI Command Listings The Table of Contents lists the PSG SCPI commands without the parameters. The SCPI command subsystem name will generally have the first part of the command in parenthesis that is repeated in all commands within the subsystem. The title(s) beneath the subsystem name is the remaining command syntax.
Command Reference SCPI Basics SCPI Basics This section describes the general use of the Standard Commands for Programmable Instruments (SCPI) language for the PSG Family of signal generators. It is not intended to teach you everything about the SCPI language; the SCPI Consortium or IEEE can provide that level of detailed information. For a list of the specific commands available for the signal generator, refer to the Table of Contents.
Command Reference SCPI Basics Command Syntax A typical command is made up of keywords prefixed with colons (:). The keywords are followed by parameters. The following is an example syntax statement: [:SOURce]:POWer[:LEVel] MAXimum|MINimum In the example above, the [:LEVel] portion of the command immediately follows the :POWer portion with no separating space. The portion following the [:LEVel], MINimum|MAXimum, are the parameters (argument for the command statement).
Command Reference SCPI Basics Table 4-2 Command Syntax Characters, Keywords, and Syntax Example Upper-case lettering indicates the minimum set of characters required for the command. [:SOURce]:FREQuency[:CW]?, Lower-case lettering indicates the portion of the command that is optional; it can either be included with the upper-case portion of the command or omitted. This is the flexible format principle called forgiving listening.
Command Reference SCPI Basics Command Types Commands can be separated into two groups: common commands and subsystem commands. Figure 4-1, shows the separation of the two command groups. Common commands are used to manage macros, status registers, synchronization, and data storage and are defined by IEEE 488.2. They are easy to recognize because they all begin with an asterisk. For example *IDN?, *OPC, and *RST are common commands.
Command Reference SCPI Basics Command Tree Most programming tasks involve subsystem commands. SCPI uses a structure for subsystem commands similar to the file systems on most computers. In SCPI, this command structure is called a command tree and is shown in Figure 4-2. Figure 4-2 Simplified Command Tree The command closest to the top is the root command, or simply “the root.” Notice that you must follow a particular path to reach lower level commands.
Command Reference SCPI Basics Command Parameters and Responses SCPI defines different data formats for use in program and response messages. It does this to accommodate the principle of forgiving listening and precise talking. For more information on program data types refer to IEEE 488.2. Forgiving listening means the command and parameter formats are flexible.
Command Reference SCPI Basics The following are examples of numeric parameters: 100 no decimal point required 100. fractional digits optional −1.23 leading signs allowed 4.56E3 space allowed after the E in exponential −7.89E−001 use either E or e in exponential +256 leading plus sign allowed .5 digits left of decimal point optional Extended Numeric Parameters Most subsystems use extended numeric parameters to specify physical quantities.
Command Reference SCPI Basics Discrete Parameters Discrete parameters use mnemonics to represent each valid setting. They have a long and a short form, just like command mnemonics. You can mix upper and lower case letters for discrete parameters. The following examples of discrete parameters are used with the command :TRIGger[:SEQuence]:SOURce BUS|IMMediate|EXTernal.
Command Reference SCPI Basics String Parameters String parameters allow ASCII strings to be sent as parameters. Single or double quotes are used as delimiters. The following are examples of string parameters: ’This is valid’ "This is also valid" ’SO IS THIS’ Real Response Data Real response data represent decimal numbers in either fixed decimal or scientific notation.
Command Reference SCPI Basics Discrete Response Data Discrete response data are similar to discrete parameters. The main difference is that discrete response data only return the short form of a particular mnemonic, in all upper case letters. The following are examples of discrete response data: IMM EXT INT NEG Numeric Boolean Response Data Boolean response data returns a binary numeric value of one or zero. String Response Data String response data are similar to string parameters.
Command Reference SCPI Basics Program Messages The following commands will be used to demonstrate the creation of program messages: [:SOURce]:FREQuency:STARt [:SOURce]:FREQuency:STOP [:SOURce]:FREQuency[:CW] [:SOURce]:POWer[:LEVel]:OFFSet Example 1 :FREQuency:STARt 500MHZ;STOP 1000MHZ This program message is correct and will not cause errors; STARt and STOP are at the same path level.
Command Reference SCPI Basics File Name Variables File name variables, such as "", represent two formats, "" and "". The following shows the file name syntax for the two formats, but uses "FLATCAL" as the file name in place of the variable "": Format 1 "FLATCAL" Format 2 "FLATCAL@USERFLAT" Format 2 uses the file system extension (@USERFLAT) as part of the file name syntax. Use Format 2 when the command does not specify the file system.
Command Reference SCPI Basics MSUS (Mass Storage Unit Specifier) Variable The variable "" enables a command to be file system specific when working with user files. Some commands use it as the only command parameter, while others can use it in conjunction with a file name when a command is not file system specific. When used with a file name, it is similar to Format 2 in the “File Name Variables” on page 150.
Command Reference SCPI Basics Quote Usage with SCPI Commands As a general rule, programming languages require that SCPI commands be enclosed in double quotes as shown in the following example: ":FM:EXTernal:IMPedance 600" However, when a string is the parameter for a SCPI command, additional quotes or other delimiters may be required to identify the string. Your programming language may use two sets of double quotes, one set of single quotes, or back slashes with quotes to signify the string parameter.
Command Reference SCPI Basics Binary, Decimal, Hexadecimal, and Octal Formats Command values may be entered using a binary, decimal, hexadecimal, or octal format. When the binary, hexadecimal, or octal format is used, their values must be preceded with the proper identifier. The decimal format (default format) requires no identifier and the signal generator assumes this format when a numeric value is entered without one.
Command Reference IEEE 488.2 Common Commands IEEE 488.2 Common Commands *CLS Supported All *CLS The Clear Status (CLS) command clears the Status Byte Register, the Data Questionable Event Register, the Standard Event Status Register, the Standard Operation Status Register and any other registers that are summarized in the status byte.
Command Reference IEEE 488.2 Common Commands *ESE? Supported All *ESE? The Standard Event Status Enable (ESE) query returns the value of the Standard Event Status Enable Register. *RST N/A Range N/A Key Entry N/A Remarks Refer to “Standard Event Status Group” on page 114 and “Standard Event Status Enable Register” on page 116 for more information. *ESR? Supported CAUTION All This is a destructive read. The data in the register is latched until it is queried. Once queried, the data is cleared.
Command Reference IEEE 488.2 Common Commands *IDN? Supported All *IDN? The Identification (IDN) query outputs an identifying string. The response will show the following information: , , , *RST N/A Range N/A Key Entry Diagnostic Info Remarks The identification information can be modified. Refer to “:SYSTem:IDN” on page 294 for more information.
Command Reference IEEE 488.2 Common Commands *OPC? Supported All *OPC? The Operation Complete (OPC) query returns the ASCII character 1 when all pending operations have finished. *RST N/A Range N/A Key Entry N/A Remarks N/A *PSC Supported All *PSC ON|OFF|1|0 The Power-On Status Clear (PSC) command controls the automatic power-on clearing of the Service Request Enable Register, the Standard Event Status Enable Register, and device-specific event enable registers.
Command Reference IEEE 488.2 Common Commands *PSC? Supported All *PSC? The Power-On Status Clear (PSC) query returns the flag setting as enabled by the *PSC command. *RST N/A Range N/A Key Entry N/A Remarks N/A *RCL Supported All *RCL , The Recall (RCL) command recalls the signal generator’s state from the specified memory register of the specified sequence .
Command Reference IEEE 488.2 Common Commands *SAV Supported All *SAV , The Save (SAV) command saves the state of the signal generator to the specified memory register of the specified sequence . *RST N/A Range Registers: 0–99 Key Entry Save Reg Remarks N/A Sequences: 0–9 Save Seq[n] Reg[nn] *SRE Supported All *SRE The Service Request Enable (SRE) command sets the value of the Service Request Enable Register.
Command Reference IEEE 488.2 Common Commands *SRE? Supported All *SRE? The Service Request Enable (SRE) query returns the value of the Service Request Enable Register. *RST N/A Range 0–63 or 128–191 Key Entry N/A Remarks Refer to “Status Byte Group” on page 110 and “Service Request Enable Register” on page 112 for more information. *STB? Supported All *STB? The Read Status Bye (STB) query returns the value of the status byte including the master summary status (MSS) bit.
Command Reference IEEE 488.2 Common Commands *TST? Supported All *TST? The Self-Test (TST) query initiates the internal self-test and returns one of the following results: 0 This shows that all tests passed. 1 This shows that one or more tests failed. *RST N/A Range N/A Key Entry Run Complete Self Test Remarks N/A *WAI Supported All *WAI The Wait-to-Continue (WAI) command causes the signal generator to wait until all pending commands are completed, before executing any other commands.
Command Reference Calibration subsystem (:CALibration) Calibration subsystem (:CALibration) :DCFM Supported PSG-A Series :CALibration:DCFM This command initiates a DCFM or DCΦM calibration depending on the currently active modulation. This calibration eliminates any dc or modulation offset of the carrier signal. NOTE 162 If the calibration is performed with a dc signal applied, any deviation provided by the dc signal will be removed and the new zero reference point will be at the applied dc level.
Command Reference Communication Subsystem (:SYSTem:COMMunicate) Communication Subsystem (:SYSTem:COMMunicate) :GPIB:ADDRess Supported All :SYSTem:COMMunicate:GPIB:ADDRess :SYSTem:COMMunicate:GPIB:ADDRess? This command sets the GPIB address of the signal generator. *RST N/A Range 0–30 Key Entry GPIB Address Remarks The setting enabled by this command is not affected by signal generator power-on, preset, or *RST.
Command Reference Communication Subsystem (:SYSTem:COMMunicate) :LAN:IP Supported All :SYSTem:COMMunicate:LAN:IP "" :SYSTem:COMMunicate:LAN:IP? This command sets the LAN IP address for the signal generator. *RST N/A Range N/A Key Entry IP Address Remarks The setting enabled by this command is not affected by signal generator power-on, preset, or *RST.
Command Reference Communication Subsystem (:SYSTem:COMMunicate) :PMETer:CHANnel Supported All :SYSTem:COMMunicate:PMETer:CHANnel A|B :SYSTem:COMMunicate:PMETer:CHANnel? This command sets the measurement channel on the power meter that is controlled by the signal generator. *RST N/A Choices A Key Entry Meter Channel A B Remarks A single-channel power meter uses channel A and selecting channel B will have no effect.
Command Reference Communication Subsystem (:SYSTem:COMMunicate) :PMETer:TIMEout Supported All :SYSTem:COMMunicate:PMETer:TIMEout [
Command Reference Communication Subsystem (:SYSTem:COMMunicate) :SERial:ECHO Supported All :SYSTem:COMMunicate:SERial:ECHO ON|OFF|1|0 :SYSTem:COMMunicate:SERial:ECHO? This command enables or disables the RS-232 echo. *RST N/A Choices ON OFF Key Entry RS-232 ECHO Off On Remarks The setting enabled by this command is not affected by signal generator power-on, preset, or *RST.
Command Reference Communication Subsystem (:SYSTem:COMMunicate) :SERial:RESet Supported All :SYSTem:COMMunicate:SERial:RESet This event command resets the RS-232 buffer and will discard any unprocessed SCPI input received by the RS-232 port. *RST N/A Range N/A Key Entry Reset RS-232 Remarks N/A :SERial:TOUT Supported All :SYSTem:COMMunicate:SERial:TOUT :SYSTem:COMMunicate:SERial:TOUT? This command sets the value for the RS-232 serial port time-out.
Command Reference Communication Subsystem (:SYSTem:COMMunicate) :SERial:TRANsmit:PACE Supported All :SYSTem:COMMunicate:SERial:TRANsmit:PACE XON|NONE :SYSTem:COMMunicate:SERial:TRANsmit:PACE? This command sets XON/XOFF handshaking when the signal generator is transmitting data. *RST N/A Choices XON Key Entry Trans/Recv Pace None Xon Remarks The serial receive and serial transmit commands are coupled. Changing the choice for one will enable the same choice for the other.
Command Reference Diagnostic Subsystem (:DIAGnostic) Diagnostic Subsystem (:DIAGnostic) [:CPU]:INFOrmation:BOARds Supported All :DIAGnostic[:CPU]:INFOrmation:BOARds? This query returns a list of the installed boards in the signal generator. The information will be returned in the following format: "" This information format will repeat with as many iterations as the number of detected boards in the signal generator.
Command Reference Diagnostic Subsystem (:DIAGnostic) [:CPU]:INFOrmation:CCOunt:PON Supported All :DIAGnostic[:CPU]:INFOrmation:CCOunt:PON? This query returns the cumulative number of times that the signal generator’s line power has been cycled. *RST N/A Range N/A Key Entry Diagnostic Info Remarks N/A [:CPU]:INFOrmation:DISPlay:OTIMe Supported All :DIAGnostic[:CPU]:INFOrmation:DISPlay:OTIMe? This query returns the cumulative number of hours that the signal generator’s display has been on.
Command Reference Diagnostic Subsystem (:DIAGnostic) [:CPU]:INFOrmation:OPTions:DETail Supported All :DIAGnostic[:CPU]:INFOrmation:OPTions:DETail? This query returns the options that are installed along with the option revision and DSP version if applicable. *RST N/A Range N/A Key Entry Options Info Remarks N/A [:CPU]:INFOrmation:OTIMe Supported All :DIAGnostic[:CPU]:INFOrmation:OTIMe? This query returns the cumulative number of hours that the signal generator has been on.
Command Reference Diagnostic Subsystem (:DIAGnostic) [:CPU]:INFOrmation:SDATe Supported All :DIAGnostic[:CPU]:INFOrmation:SDATe? This query returns the date and time of the signal generator’s main firmware.
Command Reference Display Subsystem (:DISPlay) Display Subsystem (:DISPlay) :BRIGhtness Supported All :DISPlay:BRIGhtness :DISPlay:BRIGhtness? This command sets the display brightness. The brightness can be set to the minimum level (0.02), maximum level (1), or in between by using fractional numeric values (0.03–0.99). *RST N/A Range 0.02–1 Key Entry Brightness Remarks The setting enabled by this command is not affected by signal generator power-on, preset, or *RST.
Command Reference Display Subsystem (:DISPlay) :CONTrast Supported All :DISPlay:CONTrast :DISPlay:CONTrast? This command sets the contrast of the of the signal generator’s LCD display. The contrast can be set to the maximum level (1), minimum level (0), or in between by using fractional numeric values (0.001–0.999).
Command Reference Display Subsystem (:DISPlay) :REMote Supported All :DISPlay:REMote ON|OFF|1|0 :DISPlay:REMote? This command enables or disables the source’s display updating when the signal generator is remotely controlled. ON (1) This choice updates the signal generator display so you can see the settings as the commands are executed, however, this will degrade the signal generator speed. OFF (0) This choice turns off the display updating while further optimizing the signal generator for speed.
Command Reference Memory Subsystem (:MEMory) Memory Subsystem (:MEMory) :CATalog:BINary Supported All :MEMory:CATalog:BINary? This command outputs a list of the binary files. The return data will be in the following form: ,{,""} The signal generator will return the two memory usage parameters and as many file listings as there are files in the directory list.
Command Reference Memory Subsystem (:MEMory) :CATalog:LIST Supported All :MEMory:CATalog:LIST? This command outputs a list of the list sweep files. The return data will be in the following form: ,{,""} The signal generator will return the two memory usage parameters and as many file listings as there are files in the directory list.
Command Reference Memory Subsystem (:MEMory) :CATalog:UFLT Supported All :MEMory:CATalog:UFLT? This command outputs a list of the user flatness correction files. The return data will be in the following form: ,{,""} The signal generator will return the two memory usage parameters and as many file listings as there are files in the directory list.
Command Reference Memory Subsystem (:MEMory) :COPY[:NAME] Supported All :MEMory:COPY[:NAME] "","" This command makes a duplicate of the requested file. *RST N/A Range N/A Key Entry Copy File Remarks Refer to “File Name Variables” on page 150 for information on the file name syntax. :DATA Supported All :MEMory:DATA "", :MEMory:DATA? "" This command loads into the memory location "".
Command Reference Memory Subsystem (:MEMory) :DELete:ALL Supported CAUTION All Using this command deletes all user files including binary, list, state, and flatness correction files, and any saved setups which use the table editor. You cannot recover the files after sending this command. :MEMory:DELete:ALL This command clears the file system of all user files.
Command Reference Memory Subsystem (:MEMory) :DELete:LIST Supported All :MEMory:DELete:LIST This command deletes all list files. *RST N/A Range N/A Key Entry Delete All List Files Remarks N/A :DELete:STATe Supported All :MEMory:DELete:STATe This command deletes all state files. *RST N/A Range N/A Key Entry Delete All State Files Remarks N/A :DELete:UFLT Supported All :MEMory:DELete:UFLT This command deletes all user flatness correction files.
Command Reference Memory Subsystem (:MEMory) :DELete[:NAME] Supported All :MEMory:DELete[:NAME] "" This command clears the user file system of "". *RST N/A Range N/A Key Entry Delete File Remarks Refer to “File Name Variables” on page 150 for information on the file name syntax. :FREE[:ALL] Supported All :MEMory:FREE[:ALL]? This command returns the number of bytes left in the user file system.
Command Reference Memory Subsystem (:MEMory) :MOVE Supported All :MEMory:MOVE "","" This command renames the requested file in the memory catalog. *RST N/A Range N/A Key Entry Rename File Remarks Refer to “File Name Variables” on page 150 for information on the file name syntax.
Command Reference Mass Memory Subsystem (:MMEMory) Mass Memory Subsystem (:MMEMory) :CATalog Supported All :MMEMory:CATalog? "" This command outputs a list of the files from the specified file system. The variable "" (mass storage unit specifier) represents ":". The file systems and types are shown in Table 4-4.
Command Reference Mass Memory Subsystem (:MMEMory) :COPY Supported All :MMEMory:COPY "","" This command makes a duplicate of the requested file. *RST N/A Range N/A Key Entry Copy File Remarks Refer to “File Name Variables” on page 150 for information on the file name syntax. :DATA Supported All :MMEMory:DATA "", :MMEMory:DATA? "" This command loads into the memory location "".
Command Reference Mass Memory Subsystem (:MMEMory) :DELete[:NAME] Supported All :MMEMory:DELete[:NAME] "",[""] This command clears the user file system of "" with the option of specifying the file system separately. The variable "" (mass storage unit specifier) represents ":". For a list of the file systems refer to Table 4-4 on page 185.
Command Reference Mass Memory Subsystem (:MMEMory) :MOVE Supported All :MMEMory:MOVE "","" This command renames the requested file in the memory catalog. *RST N/A Range N/A Key Entry Rename File Remarks Refer to “File Name Variables” on page 150 for information on the file name syntax. :STORe:LIST Supported All :MMEMory:STORe:LIST "" This command stores the current list sweep data to a file.
Command Reference Output Subsystem(:OUTPut) Output Subsystem(:OUTPut) :MODulation[:STATe] Supported PSG-A Series :OUTPut:MODulation[:STATe] ON|OFF|1|0 :OUTPut:MODulation[:STATe]? This command enables or disables the modulation of the RF output with the currently active modulation type(s). *RST 1 Choices ON Key Entry Mod On/Off Remarks Most modulation types can be simultaneously enabled except FM with ΦM.
Command Reference Status Subsystem (:STATus) Status Subsystem (:STATus) :OPERation:CONDition Supported All :STATus:OPERation:CONDition? This command returns the decimal sum of the bits for the registers that are set to one and are part of the Standard Operation Status Group. For example, if a sweep is in progress (bit 3), the value 8 is returned. *RST N/A Range 0–32767 Key Entry N/A Remarks Refer to “Standard Operation Condition Register” on page 118 for more information.
Command Reference Status Subsystem (:STATus) :OPERation:NTRansition Supported All :STATus:OPERation:NTRansition :STATus:OPERation:NTRansition? This command determines what bits in the Standard Operation Condition Register will set the corresponding bit in the Standard Operation Event Register when that bit has a negative transition (1 to 0). The variable is the sum of the decimal values of the bits that you want to enable.
Command Reference Status Subsystem (:STATus) :OPERation[:EVENt] Supported CAUTION All This is a destructive read. The data in the register is latched until it is queried. Once queried, the data is cleared. :STATus:OPERation[:EVENt]? This command returns the decimal sum of the bits in the Standard Operation Event Register. For example, if a sweep is in progress (bit 3), the value 8 is returned.
Command Reference Status Subsystem (:STATus) :QUEStionable:CALibration:CONDition Supported PSG-A Series :STATus:QUEStionable:CALibration:CONDition? This command returns the decimal sum of the bits in the Data Questionable Calibration Condition Register. For example, if the DCFM or DCΦM zero calibration fails (bit 0), a value of 1 is returned.
Command Reference Status Subsystem (:STATus) :QUEStionable:CALibration:NTRansition Supported PSG-A Series :STATus:QUEStionable:CALibration:NTRansition :STATus:QUEStionable:CALibration:NTRansition? This command determines what bits in the Data Questionable Calibration Condition Register will set the corresponding bit in the Data Questionable Calibration Event Register when that bit has a negative transition (1 to 0).
Command Reference Status Subsystem (:STATus) :QUEStionable:CALibration[:EVENt] Supported CAUTION PSG-A Series This is a destructive read. The data in the register is latched until it is queried. Once queried, the data is cleared. :STATus:QUEStionable:CALibration[:EVENt]? This command returns the decimal sum of the bits in the Data Questionable Calibration Event Register. For example, if the DCFM or DCΦM zero calibration has failed, bit 0 will return a value of 1.
Command Reference Status Subsystem (:STATus) :QUEStionable:ENABle Supported All :STATus:QUEStionable:ENABle :STATus:QUEStionable:ENABle? This command determines what bits in the Data Questionable Event Register will set the Data Questionable Status Group Summary bit (bit 3) in the Status Byte Register. The variable is the sum of the decimal values of the bits that you want to enable.
Command Reference Status Subsystem (:STATus) :QUEStionable:FREQuency:ENABle Supported All :STATus:QUEStionable:FREQuency:ENABle :STATus:QUEStionable:FREQuency:ENABle? This command determines what bits in the Data Questionable Frequency Event Register will set the frequency summary bit (bit 5) in the Data Questionable Condition Register. The variable is the sum of the decimal values of the bits that you want to enable.
Command Reference Status Subsystem (:STATus) :QUEStionable:FREQuency:PTRansition Supported All :STATus:QUEStionable:FREQuency:PTRansition :STATus:QUEStionable:FREQuency:PTRansition? This command determines what bits in the Data Questionable Frequency Condition Register will set the corresponding bit in the Data Questionable Frequency Event Register when that bit has a positive transition (0 to 1). The variable is the sum of the decimal values of the bits that you want to enable.
Command Reference Status Subsystem (:STATus) :QUEStionable:FREQuency[:EVENt] Supported CAUTION All This is a destructive read. The data in the register is latched until it is queried. Once queried, the data is cleared. :STATus:QUEStionable:FREQuency[:EVENt]? This command returns the decimal sum of the bits in the Data Questionable Frequency Event Register. For example, if the 1 GHz internal reference clock is unlocked (bit 2), a value of 4 is returned.
Command Reference Status Subsystem (:STATus) :QUEStionable:MODulation:ENABle Supported PSG-A Series :STATus:QUEStionable:MODulation:ENABle :STATus:QUEStionable:MODulation:ENABle? This command determines what bits in the Data Questionable Modulation Event Register will set the modulation summary bit (bit 7) in the Data Questionable Condition Register. The variable is the sum of the decimal values of the bits that you want to enable.
Command Reference Status Subsystem (:STATus) :QUEStionable:MODulation:PTRansition Supported PSG-A Series :STATus:QUEStionable:MODulation:PTRansition :STATus:QUEStionable:MODulation:PTRansition? This command determines what bits in the Data Questionable Modulation Condition Register will set the corresponding bit in the Data Questionable Modulation Event Register when that bit has a positive transition (0 to 1).
Command Reference Status Subsystem (:STATus) :QUEStionable:MODulation[:EVENt] Supported CAUTION PSG-A Series This is a destructive read. The data in the register is latched until it is queried. Once queried, the data is cleared. :STATus:QUEStionable:MODulation[:EVENt]? This command returns the decimal sum of the bits in the Data Questionable Modulation Event Register.
Command Reference Status Subsystem (:STATus) :QUEStionable:NTRansition Supported All :STATus:QUEStionable:NTRansition :STATus:QUEStionable:NTRansition? This command determines what bits in the Data Questionable Condition Register will set the corresponding bit in the Data Questionable Event Register when that bit has a negative transition (1 to 0). The variable is the sum of the decimal values of the bits that you want to enable.
Command Reference Status Subsystem (:STATus) :QUEStionable:POWer:ENABle Supported All :STATus:QUEStionable:POWer:ENABle :STATus:QUEStionable:POWer:ENABle? This command determines what bits in the Data Questionable Power Event Register will set the power summary bit (bit 3) in the Data Questionable Condition Register. The variable is the sum of the decimal values of the bits that you want to enable.
Command Reference Status Subsystem (:STATus) :QUEStionable:POWer:PTRansition Supported All :STATus:QUEStionable:POWer:PTRansition :STATus:QUEStionable:POWer:PTRansition? This command determines what bits in the Data Questionable Power Condition Register will set the corresponding bit in the Data Questionable Power Event Register when that bit has a positive transition (0 to 1). The variable is the sum of the decimal values of the bits that you want to enable.
Command Reference Status Subsystem (:STATus) :QUEStionable:POWer[:EVENt] Supported CAUTION All This is a destructive read. The data in the register is latched until it is queried. Once queried, the data is cleared. :STATus:QUEStionable:POWer[:EVENt]? This command returns the decimal sum of the bits in the Data Questionable Power Event Register. For example, if the RF output signal is unleveled (bit 1), a value of 2 is returned.
Command Reference Status Subsystem (:STATus) :QUEStionable:PTRansition Supported All :STATus:QUEStionable:PTRansition :STATus:QUEStionable:PTRansition? This command determines what bits in the Data Questionable Condition Register will set the corresponding bit in the Data Questionable Event Register when that bit has a positive transition (0 to 1). The variable is the sum of the decimal values of the bits that you want to enable.
Command Reference System Subsystem (:SYSTem) System Subsystem (:SYSTem) :CAPability Supported All :SYSTem:CAPability? This command queries the signal generator’s capabilities and outputs the appropriate specifiers: (RFSOURCE WITH((AM|FM|PULM|PM|LFO)&(FSSWEEP|FLIST)&(PSSWEEP|PLIST) &TRIGGER&REFERENCE)) This is a list of the SCPI-defined basic functionality of the signal generator and the additional capabilities it has in parallel (a&b) and singularly (a|b).
Command Reference System Subsystem (:SYSTem) :HELP:MODE Supported All :SYSTem:HELP:MODE SINGle|CONTinuous :SYSTem:HELP:MODE? This command sets the mode of the signal generator’s help function. SINGle Help is provided only for the next key that you press. CONTinuous Help is continuously provided for the next key and subsequent keys you press. In addition, the key’s function is executed. Pressing the Help hardkey in either mode, while the help dialog box is displayed, will turn help off.
Command Reference System Subsystem (:SYSTem) :PON:TYPE Supported All :SYSTem:PON:TYPE PRESet|LAST :SYSTem:PON:TYPE? This command sets the defined conditions for the signal generator at power on. PRESet This choice sets the conditions to factory- or user-defined as determined by the choice for the preset type. Refer to “:PRESet:TYPE” on page 212 for selecting the type of preset. LAST This choice retains the settings at the time the signal generator was last powered down.
Command Reference System Subsystem (:SYSTem) :PRESet:ALL Supported All :SYSTem:PRESet:ALL This command sets all states of the signal generator back to their factory default settings, including states that are not normally affected by signal generator power-on, preset, or *RST.
Command Reference System Subsystem (:SYSTem) :PRESet:TYPE Supported All :SYSTem:PRESet:TYPE NORMal|USER :SYSTem:PRESet:TYPE? This command toggles the preset state between factory- and user-defined conditions. *RST N/A Choices NORMal Key Entry Preset Normal User Remarks Refer to “:PRESet[:USER]:SAVE” for saving the USER choice preset settings. USER The setting enabled by this command is not affected by signal generator power-on, preset, or *RST.
Command Reference System Subsystem (:SYSTem) :SSAVer:DELay Supported All :SYSTem:SSAVer:DELay :SYSTem:SSAVer:DELay? This command sets the amount of time before the display light or display light and text is switched off. This will occur if there is no input via the front panel during the delay period. The variable is a whole number measured in hours.
Command Reference System Subsystem (:SYSTem) :SSAVer:STATe Supported All :SYSTem:SSAVer:STATe ON|OFF|1|0 :SYSTem:SSAVer:STATe? This command enables or disables the display screen saver. *RST N/A Choices ON Key Entry Screen Saver Off On Remarks The setting enabled by this command is not affected by signal generator power-on, preset, or *RST. OFF 1 0 :VERSion Supported All :SYSTem:VERSion? This command returns the SCPI version number with which the signal generator complies.
Command Reference Trigger Subsystem Trigger Subsystem :ABORt Supported All :ABORt This command causes the list or step sweep in progress to abort. *RST N/A Range N/A Key Entry N/A Remarks If INIT:CONT[:ALL] is set to ON, the sweep will immediately re-initiate. The pending operation flag affecting *OPC, *OPC?, and *WAI will undergo a transition once the sweep has been reset.
Command Reference Trigger Subsystem :INITiate[:IMMediate][:ALL] Supported All :INITiate[:IMMediate][:ALL] This command arms or arms and starts a single list or step sweep.
Command Reference Trigger Subsystem :TRIGger[:SEQuence]:SLOPe Supported All :TRIGger[:SEQuence]:SLOPe POSitive|NEGative :TRIGger[:SEQuence]:SLOPe? This command sets the polarity of the ramp or sawtooth waveform slope present at the TRIGGER IN connector that will trigger a list or step sweep.
Command Reference Trigger Subsystem :TRIGger[:SEQuence][:IMMediate] Supported All :TRIGger[:SEQuence][:IMMediate] This event command enables an armed list or step sweep to immediately start without the selected trigger occurring.
Command Reference Unit Subsystem (:UNIT) Unit Subsystem (:UNIT) :POWer Supported All :UNIT:POWer DBM|DBUV|DBUVEMF|V|VEMF :UNIT:POWer? This command terminates an amplitude value in the selected unit of measure. *RST DBM Choices DBM Key Entry dBm Remarks All power values in this chapter are shown with DBM as the unit of measure. If a different unit of measure is selected, replace DBM with the newly selected unit whenever it is indicated for the value.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) Amplitude Modulation Subsystem ([:SOURce]) :AM[1]|2... Supported PSG-A Series [:SOURce]:AM[1]|2... This prefix enables the selection of the AM path and is part of most SCPI commands associated with this subsystem. The two paths are equivalent to the AM Path 1 2 softkey. AM[1] AM Path 1 2 with 1 selected AM2 AM Path 1 2 with 2 selected When just AM is shown in a command, this means the command applies globally to both paths.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM:INTernal:FREQuency:STEP[:INCRement] Supported PSG-A Series [:SOURce]:AM:INTernal:FREQuency:STEP[:INCRement] [:SOURce]:AM:INTernal:FREQuency:STEP[:INCRement]? This command sets the step increment for the amplitude modulation internal frequency. The variable sets the entered value in units of hertz. *RST Ν/Α Range 0.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM:MODE Supported PSG-A Series [:SOURce]:AM:MODE DEEP|NORMal [:SOURce]:AM:MODE? This command sets the mode for the amplitude modulation. DEEP This choice enables the amplitude modulation depth greater dynamic range with the ALC enabled. The minimum carrier amplitude with this choice is −10 dBm. DEEP has no specified parameters and emulates the amplitude modulation NORMal mode with the ALC disabled.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM[1]|2:EXTernal[1]|2:COUPling Supported PSG-A Series [:SOURce]:AM[1]|2:EXTernal[1]|2:COUPling AC|DC [:SOURce]:AM[1]|2:EXTernal[1]|2:COUPling? This command sets the coupling for the amplitude modulation source through the selected external input connector. AC This choice will only pass ac signal components. DC This choice will pass both ac and dc signal components.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM[1]|2:INTernal[1]:FREQuency:ALTernate Supported PSG-A Series [:SOURce]:AM[1]|2:INTernal[1]:FREQuency:ALTernate [:SOURce]:AM[1]|2:INTernal[1]:FREQuency:ALTernate? This command sets the frequency for the alternate signal. *RST +4.00000000E+002 Range Dual-Sine: 0.5HZ–1MHZ Key Entry AM Tone 2 Rate Remarks The alternate signal frequency is the second tone of a dual-sine or the stop frequency of a swept-sine waveform.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM[1]|2:INTernal[1]:SWEep:RATE Supported PSG-A Series [:SOURce]:AM[1]|2:INTernal[1]:SWEep:RATE [:SOURce]:AM[1]|2:INTernal[1]:SWEep:RATE? This command sets the sweep rate for the amplitude-modulated, swept-sine waveform. The variable has a minimum resolution of 0.5 hertz. *RST +4.00000000E+002 Range 0.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM[1]|2:INTernal[1]|2:FREQuency Supported PSG-A Series [:SOURce]:AM[1]|2:INTernal[1]|2:FREQuency |UP|DOWN [:SOURce]:AM[1]|2:INTernal[1]|2:FREQuency? This command sets the internal amplitude modulation rate for the following applications: • the first tone of a dual-sine waveform • the start frequency for a swept-sine waveform • the frequency rate for all other waveforms *RST +4.00000000E+002 Range Dual-Sine & Sine: 0.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM[1]|2:INTernal[1]|2:FUNCtion:RAMP Supported PSG-A Series [:SOURce]:AM[1]|2:INTernal[1]|2:FUNCtion:RAMP POSitive|NEGative [:SOURce]:AM[1]|2:INTernal[1]|2:FUNCtion:RAMP? This command sets the slope type for the ramp modulated waveform. *RST POS Choices POSitive Key Entry Positive Remarks Refer to “:AM[1]|2:INTernal[1]|2:FUNCtion:SHAPe” for the waveform selection.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM[1]|2:SOURce Supported PSG-A Series [:SOURce]:AM[1]|2:SOURce INT[1]|INT2|EXT[1]|EXT2 [:SOURce]:AM[1]|2:SOURce? This command sets the source to generate the amplitude modulation. INT This choice selects internal source 1 or 2 to provide an ac-coupled signal. EXT This choice selects the EXT 1 INPUT or the EXT 2 INPUT connector to provide an externally applied signal that can be ac- or dc-coupled.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM[1]|2:TYPE Supported PSG-A Series [:SOURce]:AM[1]|2:TYPE LINear|EXPonential [:SOURce]:AM[1]|2:TYPE? This command sets the measurement type and unit for the depth of the AM signal. LINear This choice enables linear depth values in units of percent/volt. EXPonential This choice enables exponential depth values in units of dB/volt.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM[1]|2[:DEPTh][:LINear] Supported PSG-A Series [:SOURce]:AM[1]|2[:DEPTh][:LINear] |UP|DOWN [:SOURce]:AM[1]|2[:DEPTh][:LINear]? This commands sets the depth of the AM signal. *RST +1.00000000E-001 Range 0.0–100PCT Choices Key Entry AM Depth Remarks LINear must be the current measurement choice for this command to have any affect. Refer to “:AM[1]|2:TYPE” on page 229 for setting the AM measurement mode.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM[1]|2[:DEPTh][:LINear]:TRACk Supported PSG-A Series [:SOURce]:AM[1]|2[:DEPTh][:LINear]:TRACk ON|OFF|1|0 [:SOURce]:AM[1]|2[:DEPTh][:LINear]:TRACk? This command enables or disables the coupling of the AM depth values between the paths (AM[1] and AM2). ON (1) This choice will link the depth value of AM[1] with AM2; AM2 will assume the AM[1] depth value.
Command Reference Amplitude Modulation Subsystem ([:SOURce]) :AM[:DEPTh]:STEP[:INCRement] Supported PSG-A Series [:SOURce]:AM[:DEPTh]:STEP[:INCRement] [:SOURce]:AM[:DEPTh]:STEP[:INCRement]? This command sets the depth increment value for the LINear measurement choice. The variable sets the increment value in units of percent. *RST Ν/Α Range 0.1–100 Key Entry Incr Set Remarks Refer to “:AM[1]|2:TYPE” on page 229 for setting the AM measurement choice.
Command Reference Correction Subsystem ([:SOURce]:CORRection) Correction Subsystem ([:SOURce]:CORRection) :FLATness? Supported All [:SOURce]:CORRection:FLATness? This command queries the user flatness correction file for the frequency and amplitude values. The returned values will be in the following form: , The number of paired values returned will be the same as the number of correction flatness points.
Command Reference Correction Subsystem ([:SOURce]:CORRection) :FLATness:PAIR Supported All [:SOURce]:CORRection:FLATness: PAIR [],[] This command sets a frequency and amplitude correction pair. *RST N/A Range 20 GHz Models Frequency: 100kHZ–20GHZ Correction (Std.): −20 to 25DB Correction (Opt. 1E1): −135 to 25DB 40 GHz Models Frequency: 100kHZ–40GHZ Correction (Std.): −20 to 25DB Correction (Opt.
Command Reference Correction Subsystem ([:SOURce]:CORRection) :FLATness:PRESet Supported CAUTION All The current correction data will be overwritten once this command is executed. Save the current data if needed. Refer to “:FLATness:STORe” for storing user flatness files. [:SOURce]:CORRection:FLATness:PRESet This command presets the user flatness correction to a factory-defined setting that consists of one point.
Command Reference Correction Subsystem ([:SOURce]:CORRection) [:STATe] Supported All [:SOURce]:CORRection[:STATe] ON|OFF|1|0 [:SOURce]:CORRection[:STATe]? This command enables or disables the user flatness corrections.
Command Reference Frequency Subsystem ([:SOURce]) Frequency Subsystem ([:SOURce]) :FREQuency:FIXed Supported All [:SOURce]:FREQuency:FIXed [:SOURce]:FREQuency:FIXed? This command sets the RF output frequency. *RST 20 GHz Models: +2.0000000000000E+10 40 GHz Models: +4.0000000000000E+10 Range 20 GHz Models: 100kHZ–20GHZ 40 GHz Models: 100kHZ–40GHZ Key Entry Frequency Remarks A frequency change may affect the current output power.
Command Reference Frequency Subsystem ([:SOURce]) :FREQuency:MULTiplier Supported All [:SOURce]:FREQuency:MULTiplier [:SOURce]:FREQuency:MULTiplier? This command sets the multiplier for the signal generator’s carrier frequency. *RST +1 Range Negative Values: –1000 to –.001 Positive Values: .001–1000 Key Entry Freq Multiplier Remarks For any multiplier other than one, the MULT indicator is shown in the frequency area of the display.
Command Reference Frequency Subsystem ([:SOURce]) :FREQuency:OFFSet:STATe Supported All [:SOURce]:FREQuency:OFFSet:STATe ON|OFF|1|0 [:SOURce]:FREQuency:OFFSet:STATe? This command enables or disables the offset frequency. *RST 0 Choices ON Key Entry Freq Offset Remarks Entering OFF (0) will set the frequency offset to 0 Hz. OFF 1 0 :FREQuency:REFerence Supported All [:SOURce]:FREQuency:REFerence [:SOURce]:FREQuency:REFerence? This command sets the output reference frequency.
Command Reference Frequency Subsystem ([:SOURce]) :FREQuency:STARt Supported All [:SOURce]:FREQuency:STARt [:SOURce]:FREQuency:STARt? This command sets the frequency start point for a step sweep. *RST 20 GHz Models: +2.0000000000000E+10 40 GHz Models: +4.
Command Reference Frequency Subsystem ([:SOURce]) :FREQuency[:CW] Supported All [:SOURce]:FREQuency[:CW] [:SOURce]:FREQuency[:CW]? This command sets the signal generator’s output frequency for the CW and FIXed frequency modes. *RST 20 GHz Models: +2.0000000000000E+10 40 GHz Models: +4.0000000000000E+10 Range 20 GHz Models: 100kHZ–20GHZ 40 GHz Models: 100kHZ–40GHZ Key Entry Frequency Remarks Refer to “:FREQuency:MODE” on page 237 for setting the frequency type.
Command Reference Frequency Subsystem ([:SOURce]) :PHASe[:ADJust] Supported All [:SOURce]:PHASe[:ADJust] [:SOURce]:PHASe[:ADJust]? This command adjusts the phase of the modulating signal. The query will only return values in radians. *RST +0.00000000E+000 Range Radians: –3.14 to 3.
Command Reference Frequency Subsystem ([:SOURce]) :ROSCillator:SOURce:AUTO Supported All except signal generators with Option UNJ [:SOURce]:ROSCillator:SOURce:AUTO ON|OFF|1|0 [:SOURce]:ROSCillator:SOURce:AUTO? This command enables or disables the ability of the signal generator to automatically select between the internal and an external reference oscillator.
Command Reference Frequency Modulation Subsystem ([:SOURce]) Frequency Modulation Subsystem ([:SOURce]) :FM[1]|2... Supported PSG-A Series [:SOURce]:FM[1]|2... This prefix enables the selection of the FM path and is part of most SCPI commands associated with this subsystem. The two paths are equivalent to the FM Path 1 2 softkey. FM[1] FM Path 1 2 with 1 selected FM2 FM Path 1 2 with 2 selected When just FM is shown in a command, this means the command applies globally to both paths.
Command Reference Frequency Modulation Subsystem ([:SOURce]) :FM:INTernal:FREQuency:STEP[:INCRement] Supported PSG-A Series [:SOURce]:FM:INTernal:FREQuency:STEP[:INCRement] [:SOURce]:FM:INTernal:FREQuency:STEP[:INCRement]? This command sets the step increment for the internal frequency modulation. The variable sets the entered value in units of hertz. *RST Ν/Α Range 0.
Command Reference Frequency Modulation Subsystem ([:SOURce]) :FM[1]|2:EXTernal[1]|2:IMPedance Supported PSG-A Series [:SOURce]:FM[1]|2:EXTernal[1]|2:IMPedance <50|600> [:SOURce]:FM[1]|2:EXTernal[1]|2:IMPedance? This command sets the input impedance for the selected external input. *RST +5.
Command Reference Frequency Modulation Subsystem ([:SOURce]) :FM[1]|2:INTernal[1]:FREQuency:ALTernate:AMPLitude:PERCent Supported PSG-A Series [:SOURce]:FM[1]|2:INTernal[1]:FREQuency:ALTernate:AMPLitude: PERCent [:SOURce]:FM[1]|2:INTernal[1]:FREQuency:ALTernate:AMPLitude:PERCent? This command sets the amplitude of the second tone for a dual-sine waveform as a percentage of the total amplitude.
Command Reference Frequency Modulation Subsystem ([:SOURce]) :FM[1]|2:INTernal[1]:SWEep:TRIGger Supported PSG-A Series [:SOURce]:FM[1]|2:INTernal[1]:SWEep:TRIGger BUS|IMMediate|EXTernal|KEY [:SOURce]:FM[1]|2:INTernal[1]:SWEep:TRIGger? This command sets the trigger source for the frequency modulated swept-sine waveform. 248 BUS This choice enables GPIB triggering using the *TRG or GET command or LAN triggering using the *TRG command.
Command Reference Frequency Modulation Subsystem ([:SOURce]) :FM[1]|2:INTernal[1]|2:FREQuency Supported PSG-A Series [:SOURce]:FM[1]|2:INTernal[1]|2:FREQuency |UP|DOWN [:SOURce]:FM[1]|2:INTernal[1]|2:FREQuency? This command sets the internal frequency modulation rate for the following applications: • the first tone of a dual-sine waveform • the start frequency for a swept-sine waveform • the frequency rate for all other waveforms *RST +4.00000000E+002 Range Dual-Sine & Sine: 0.
Command Reference Frequency Modulation Subsystem ([:SOURce]) :FM[1]|2:INTernal[1]|2:FUNCtion:RAMP Supported PSG-A Series [:SOURce]:FM[1]|2:INTernal[1]|2:FUNCtion:RAMP POSitive|NEGative [:SOURce]:FM[1]|2:INTernal[1]|2:FUNCtion:RAMP? This command sets either a positive or negative ramp as the internally modulated waveform. *RST POS Choices POSitive Key Entry Positive Remarks Refer to “:FM[1]|2:INTernal[1]|2:FUNCtion:SHAPe” for the waveform selection.
Command Reference Frequency Modulation Subsystem ([:SOURce]) :FM[1]|2:SOURce Supported PSG-A Series [:SOURce]:FM[1]|2:SOURce INT[1]|INT2|EXT1|EXT2 [:SOURce]:FM[1]|2:SOURce? This command sets the source to generate the frequency modulation. INT This choice selects internal source 1 or 2 to provide an ac-coupled signal. EXT This choice selects the EXT 1 INPUT or the EXT 2 INPUT connector to provide an externally applied signal that can be ac- or dc-coupled.
Command Reference Frequency Modulation Subsystem ([:SOURce]) :FM[1]|2[:DEViation] Supported PSG-A Series [:SOURce]:FM[1]|2[:DEViation] [:SOURce]:FM[1]|2[:DEViation]? This command sets the frequency modulation deviation. *RST Range 252 +1.00000000E+003 Frequency Deviation 100kHZ−250MHZ 0–1MHZ > 250−500MHZ 0–500kHZ > 500MHZ−1 GHZ 0–1MHZ > 1−2GHZ 0–2MHZ > 2−3.2GHZ 0–4MHZ > 3.
Command Reference Frequency Modulation Subsystem ([:SOURce]) :FM[1]|2[:DEViation]:TRACk Supported PSG-A Series [:SOURce]:FM[1]|2[:DEViation]:TRACk ON|OFF|1|0 [:SOURce]:FM[1]|2[:DEViation]:TRACk? This command enables or disables the deviation coupling between the paths (FM[1] and Fm2). ON (1) This choice will link the deviation value of FM[1] with FM2; FM2 will assume the FM[1] deviation value.
Command Reference List/Sweep subsystem ([:SOURce]) List/Sweep subsystem ([:SOURce]) :LIST:DIRection Supported All [:SOURce]:LIST:DIRection UP|DOWN [:SOURce]:LIST:DIRection? This command sets the direction of a list or step sweep. UP This choice enables a sweep in an ascending order: • first to last point for a list sweep • start to stop for a step sweep DOWN 254 This choice reverses the direction of the sweep.
Command Reference List/Sweep subsystem ([:SOURce]) :LIST:DWELl Supported All [:SOURce]:LIST:DWELl {,} [:SOURce]:LIST:DWELl? This command sets the dwell time for the current list sweep points. The variable is measured in units of seconds with a 0.001 resolution. NOTE The dwell time () does not begin until the signal generator has settled for the current frequency and/or amplitude change.
Command Reference List/Sweep subsystem ([:SOURce]) :LIST:DWELl:TYPE Supported All [:SOURce]:LIST:DWELl:TYPE LIST|STEP [:SOURce]:LIST:DWELl:TYPE? This command toggles the dwell time for the list sweep points between the values defined in the list sweep and the value for the step sweep. LIST This choice selects the dwell times from the list sweep. Refer to “:LIST:DWELl” on page 255 for setting the list dwell points. STEP This choice selects the dwell time from the step sweep.
Command Reference List/Sweep subsystem ([:SOURce]) :LIST:FREQuency:POINts Supported All [:SOURce]:LIST:FREQuency:POINts? This command queries the current list sweep file for the number of frequency points. *RST N/A Range N/A Key Entry N/A Remarks N/A :LIST:MANual Supported All [:SOURce]:LIST:MANual [:SOURce]:LIST:MANual? This command sets a list or step sweep point as the current sweep point controlling the frequency and power output.
Command Reference List/Sweep subsystem ([:SOURce]) :LIST:MODE Supported All [:SOURce]:LIST:MODE AUTO|MANual [:SOURce]:LIST:MODE? This command sets the operating mode for the current list or step sweep. AUTO This choice enables the selected sweep type to perform a sweep of all points. MANual This choice enables you to select a sweep point which controls the frequency and/or amplitude according to the sweep type.
Command Reference List/Sweep subsystem ([:SOURce]) :LIST:POWer:POINts Supported All [:SOURce]:LIST:POWer:POINts? This command queries the number of power points in the current list sweep file. *RST N/A Range N/A Key Entry N/A Remarks N/A :LIST:TRIGger:SOURce Supported All [:SOURce]:LIST:TRIGger:SOURce BUS|IMMediate|EXTernal|KEY [:SOURce]:LIST:TRIGger:SOURce? This command sets the point trigger source for a list or step sweep event.
Command Reference List/Sweep subsystem ([:SOURce]) :LIST:TYPE Supported All [:SOURce]:LIST:TYPE LIST|STEP [:SOURce]:LIST:TYPE? This command toggles between the two types of sweep. *RST STEP Choices LIST Key Entry Sweep Type List Step Remarks N/A STEP :LIST:TYPE:LIST:INITialize:FSTep Supported CAUTION All The current list sweep data will be overwritten once this command is executed. If needed, save the current data. Refer to “:STORe:LIST” on page 184 for storing list sweep files.
Command Reference List/Sweep subsystem ([:SOURce]) :LIST:TYPE:LIST:INITialize:PRESet Supported CAUTION All The current list sweep data will be overwritten once this command is executed. If needed, save the current data. Refer to “:STORe:LIST” on page 188 for storing list sweep files. [:SOURce]:LIST:TYPE:LIST:INITialize:PRESet This command replaces the current list sweep data with a factory-defined file consisting of one point at a frequency, amplitude, and dwell time.
Command Reference List/Sweep subsystem ([:SOURce]) :SWEep:DWELl Supported All [:SOURce]:SWEep:DWELl [:SOURce]:SWEep:DWELl? This command enables you to set the dwell time for a step sweep. The variable is measured in units of seconds with a 0.001 resolution. NOTE The dwell time () does not begin until the signal generator has settled for the current frequency and/or amplitude change.
Command Reference Low Frequency Output Subsystem ([:SOURce]:LFOutput) Low Frequency Output Subsystem ([:SOURce]:LFOutput) :AMPLitude Supported PSG-A Series [:SOURce]:LFOutput:AMPLitude [:SOURce]:LFOutput:AMPLitude? This command sets the amplitude for the signal at the LF OUTPUT connector. *RST 0.00 Range 0.000VP–3.
Command Reference Low Frequency Output Subsystem ([:SOURce]:LFOutput) :FUNCtion[1]:FREQuency:ALTernate:AMPLitude:PERCent Supported PSG-A Series [:SOURce]:LFOutput:FUNCtion[1]:FREQuency:ALTernate:AMPLitude: PERCent [:SOURce]:LFOutput:FUNCtion[1]:FREQuency:ALTernate:AMPLitude:PERCent? This command sets the amplitude of the second tone for a dual-sine waveform as a percentage of the total LF output amplitude.
Command Reference Low Frequency Output Subsystem ([:SOURce]:LFOutput) :FUNCtion[1]:SWEep:TRIGger Supported PSG-A Series [:SOURce]:LFOutput:FUNCtion[1]:SWEep:TRIGger BUS|IMMediate|EXTernal|KEY [:SOURce]:LFOutput:FUNCtion[1]:SWEep:TRIGger? This command sets the trigger source for the internally generated swept-sine waveform signal at the LF output. BUS This choice enables GPIB triggering using the *TRG or GET command or LAN triggering using the *TRG command.
Command Reference Low Frequency Output Subsystem ([:SOURce]:LFOutput) :FUNCtion[1]|2:FREQuency Supported PSG-A Series [:SOURce]:LFOutput:FUNCtion[1]|2:FREQuency [:SOURce]:LFOutput:FUNCtion[1]|2:FREQuency? This command sets the internal modulation frequency for the following applications: • the first tone of a dual-sine waveform • the start frequency for a swept-sine waveform • the frequency rate for all other waveforms *RST +4.00000000E+002 Range Dual-Sine & Sine: 0.
Command Reference Low Frequency Output Subsystem ([:SOURce]:LFOutput) :FUNCtion:NOISe Supported PSG-A Series [:SOURce]:LFOutput:FUNCtion[1]|2:SHAPe:NOISe UNIForm|GAUSsian [:SOURce]:LFOutput:FUNCtion[1]|2:SHAPe:NOISe? This command sets the noise type at the LF output when NOISe is the selected waveform. *RST UNIF Choices UNIForm Key Entry Uniform Remarks Refer to “:FUNCtion[1]|2:SHAPe” on page 266 for selecting the waveform type.
Command Reference Low Frequency Output Subsystem ([:SOURce]:LFOutput) :SOURce Supported PSG-A Series [:SOURce]:LFOutput:SOURce INT[1]|INT2|FUNCtion[1]|FUNCtion2 [:SOURce]:LFOutput:SOURce? This command sets the low frequency source for the LF output. INT This choice enables you to output a signal where the frequency and shape of the signal is set by the internal source as it is being used by a modulation.
Command Reference Phase Modulation subsystem ([:SOURce]) Phase Modulation subsystem ([:SOURce]) :PM[1]|2... Supported PSG-A Series [:SOURce]:PM[1]|2... This prefix enables the selection of the ΦM path and is part of most SCPI commands associated with this subsystem. The two paths are equivalent to the ΦM Path 1 2 softkey. PM[1] ΦM Path 1 2 with 1 selected PM2 ΦM Path 1 2 with 2 selected When just PM is shown in a command, this means the command applies globally to both paths.
Command Reference Phase Modulation subsystem ([:SOURce]) :PM:INTernal:FREQuency:STEP[:INCRement] Supported PSG-A Series [:SOURce]:PM:INTernal:FREQuency:STEP[:INCRement] [:SOURce]:PM:INTernal:FREQuency:STEP[:INCRement]? This command sets the step increment for the phase modulation internal frequency. The variable sets the entered value in units of hertz. *RST Ν/Α Range 0.
Command Reference Phase Modulation subsystem ([:SOURce]) :PM[1]|2:EXTernal[1]|2:COUPling Supported PSG-A Series [:SOURce]:PM[1]|2:EXTernal[1]|2:COUPling AC|DC [:SOURce]:PM[1]|2:EXTernal[1]|2:COUPling? This command sets the coupling for the phase modulation source through the selected external input connector. AC This choice will only pass ac signal components. DC This choice will pass both ac and dc signal components.
Command Reference Phase Modulation subsystem ([:SOURce]) :PM[1]|2:INTernal[1]:FREQuency:ALTernate Supported PSG-A Series [:SOURce]:PM[1]|2:INTernal[1]:FREQuency:ALTernate [:SOURce]:PM[1]|2:INTernal[1]:FREQuency:ALTernate? This command sets the frequency for the alternate signal. *RST +4.00000000E+002 Range Dual-Sine: 0.5HZ–1MHZ Key Entry ΦM Stop Rate Remarks The alternate frequency is the second tone of a dual-sine or the stop frequency of a swept-sine waveform.
Command Reference Phase Modulation subsystem ([:SOURce]) :PM[1]|2:INTernal[1]:SWEep:RATE Supported PSG-A Series [:SOURce]:PM[1]|2:INTernal[1]:SWEep:RATE [:SOURce]:PM[1]|2:INTernal[1]:SWEep:RATE? This command sets the sweep rate for a phase-modulated, swept-sine waveform. The variable has a minimum resolution of 0.5 hertz. *RST +4.00000000E+002 Range 0.
Command Reference Phase Modulation subsystem ([:SOURce]) :PM[1]|2:INTernal[1]|2:FREQuency Supported. PSG-A Series [:SOURce]:PM[1]|2:INTernal[1]|2:FREQuency |UP|DOWN [:SOURce]:PM[1]|2:INTernal[1]|2:FREQuency? This command sets the internal modulation frequency rate for the following applications: • the first tone of a dual-sine waveform • the start frequency for a swept-sine waveform • the frequency rate for all other wave forms *RST +4.00000000E+002 Range Dual-Sine & Sine: 0.
Command Reference Phase Modulation subsystem ([:SOURce]) :PM[1]|2:INTernal[1]|2:FUNCtion:RAMP Supported PSG-A Series [:SOURce]:PM[1]|2:INTernal[1]|2:FUNCtion:RAMP POSitive|NEGative [:SOURce]:PM[1]|2:INTernal[1]|2:FUNCtion:RAMP? This command specifies the slope type for the ramp-modulated waveform. *RST POS Key Entry Positive Choices POSitive Remarks Refer to “:PM[1]|2:INTernal[1]|2:FUNCtion:SHAPe” for the waveform selection.
Command Reference Phase Modulation subsystem ([:SOURce]) :PM[1]|2:SOURce Supported PSG-A Series [:SOURce]:PM[1]|2:SOURce INT[1]|INT2|EXT1|EXT2 [:SOURce]:PM[1]|2:SOURce? This command sets the source to generate the phase modulation. INT This choice selects internal source 1 or 2 to provide an ac-coupled signal. EXT This choice selects the EXT 1 INPUT or the EXT 2 INPUT connector to provide an externally applied signal that can be ac- or dc-coupled.
Command Reference Phase Modulation subsystem ([:SOURce]) :PM[1]|2[:DEViation] Supported PSG-A Series [:SOURce]:PM[1]|2[:DEViation] |UP|DOWN [:SOURce]:PM[1]|2[:DEViation]? This command sets the deviation of the phase modulation. The variable will accept RAD (radians), PIRAD (pi-radians), and DEG (degrees); however, the query will only return values in radians. *RST Range +0.
Command Reference Phase Modulation subsystem ([:SOURce]) :PM[1]|2[:DEViation]:TRACk Supported PSG-A Series [:SOURce]:PM[1]|2[:DEViation]:TRACk ON|OFF|1|0 [:SOURce]:PM[1]|2[:DEViation]:TRACk? This command enables or disables the deviation coupling between the paths (PM[1] and PM2). ON (1) This choice will link the deviation value of PM[1] with PM2; PM2 will assume the PM[1] deviation value.
Command Reference Power Subsystem ([:SOURce]) Power Subsystem ([:SOURce]) :POWer:ALC:BANDwidth|BWIDth Supported All [:SOURce]:POWer:ALC:BANDwidth|BWIDth [] [:SOURce]:POWer:ALC:BANDwidth|BWIDth? This command sets the bandwidth of the automatic leveling control (ALC) loop. *RST 100.
Command Reference Power Subsystem ([:SOURce]) :POWer:ALC:LEVel Supported All with Option 1E1 [:SOURce]:POWer:ALC:LEVel DB [:SOURce]:POWer:ALC:LEVel? This command sets the ALC level when the attenuator hold is active. *RST +1.00000000E+000 Range −20 to 25 Key Entry Set ALC Level Remarks Use this command when the automatic attenuation mode is set to OFF (0). Refer to “:POWer:ATTenuation:AUTO” on page 283 for choosing the attenuator mode.
Command Reference Power Subsystem ([:SOURce]) :POWer:ALC:SOURce Supported All [:SOURce]:POWer:ALC:SOURce INTernal|DIODe|MMHead [:SOURce]:POWer:ALC:SOURce? This command enables you to select the ALC leveling source.
Command Reference Power Subsystem ([:SOURce]) :POWer:ALC[:STATe] Supported All [:SOURce]:POWer:ALC[:STATe] ON|OFF|1|0 [:SOURce]:POWer:ALC[:STATe]? This command enables or disables the automatic leveling control (ALC) circuit. *RST 1 Choices ON Key Entry ALC Off On Remarks An alternative to setting the ALC to OFF (0), is to set the ALC to a narrow bandwidth. OFF 1 0 The purpose of the ALC circuit is to hold output power at the desired level in spite of drift due to temperature and time.
Command Reference Power Subsystem ([:SOURce]) :POWer:ATTenuation:AUTO Supported All with Option 1E1 [:SOURce]:POWer:ATTenuation:AUTO ON|OFF|1|0 [:SOURce]:POWer:ATTenuation:AUTO? This command sets the state of the attenuator hold function. ON (1) This choice enables the attenuators to operate normally. OFF (0) This choice holds the attenuator at its current setting or at a selected value that will not change during power adjustments.
Command Reference Power Subsystem ([:SOURce]) :POWer:REFerence Supported All [:SOURce]:POWer:REFerence [:SOURce]:POWer:REFerence? This command sets the current output power reference. *RST +0.00000000E+000 Range −400 to 300DBM Key Entry Ampl Ref Set Remarks The power reference range is affected by power offset. :POWer:REFerence:STATe Supported All [:SOURce]:POWer:REFerence:STATe ON|OFF|1|0 [:SOURce]:POWer:REFerence:STATe? This command enables or disables the RF output reference.
Command Reference Power Subsystem ([:SOURce]) :POWer:STARt Supported All [:SOURce]:POWer:STARt [:SOURce]:POWer:STARt? This command sets the amplitude of the first point in a step sweep. *RST −1.35000000E+002 Range Refer to “:POWer[:LEVel][:IMMediate][:AMPLitude]” on page 287 for output power ranges. Key Entry Ampl Start Remarks During an amplitude sweep operation, signal generators with Option 1E1 protect the step attenuator by automatically switching to attenuator hold (OFF) mode.
Command Reference Power Subsystem ([:SOURce]) :POWer[:LEVel][:IMMediate]:OFFSet Supported All [:SOURce]:POWer[:LEVel][:IMMediate]:OFFSet [:SOURce]:POWer[:LEVel][:IMMediate]:OFFSet? This command sets the power offset value. *RST +0.00000000E+000 Range −200DB to 200DB Key Entry Ampl Offset Remarks This simulates a power level at a test point beyond the RF OUTPUT connector without changing the actual RF output power. The offset value only affects the displayed amplitude setting.
Command Reference Power Subsystem ([:SOURce]) :POWer[:LEVel][:IMMediate][:AMPLitude] Supported All [:SOURce]:POWer[:LEVel][:IMMediate][:AMPLitude] [:SOURce]:POWer[:LEVel][:IMMediate][:AMPLitude]? This command sets the RF output power. *RST −1.35000000E+002 Range 20 GHz Models: E8241A & E8251A Frequency range 250kHZ−3.2GHZ > 3.
Command Reference Pulse Modulation Subsystem ([:SOURce]) Pulse Modulation Subsystem ([:SOURce]) :PULM:INTernal[1]:DELay Supported PSG-A Series [:SOURce]:PULM:INTernal[1]:DELay [
Command Reference Pulse Modulation Subsystem ([:SOURce]) :PULM:INTernal[1]:DELay:STEP Supported PSG-A Series [:SOURce]:PULM:INTernal[1]:DELay:STEP [
Command Reference Pulse Modulation Subsystem ([:SOURce]) :PULM:INTernal[1]:PERiod Supported PSG-A Series [:SOURce]:PULM:INTernal[1]:PERiod |UP|DOWN [:SOURce]:PULM:INTernal[1]:PERiod? This command sets the period for the internally generated pulse modulation source. *RST +2.
Command Reference Pulse Modulation Subsystem ([:SOURce]) :PULM:INTernal[1]:PWIDth Supported PSG-A Series [:SOURce]:PULM:INTernal[1]:PWIDth [
Command Reference Pulse Modulation Subsystem ([:SOURce]) :PULM:SOURce Supported PSG-A Series [:SOURce]:PULM:SOURce INTernal|EXTernal [:SOURce]:PULM:SOURce? This command sets the source for the pulse modulation.
Command Reference Pulse Modulation Subsystem ([:SOURce]) :PULM:STATe Supported PSG-A Series [:SOURce]:PULM:STATe ON|OFF|1|0 [:SOURce]:PULM:STATe? This command enables or disables pulse modulation for the selected path.
Command Reference SCPI Command Compatibility SCPI Command Compatibility :SYSTem:IDN Supported All :SYSTem:IDN "" This command modifies the identification string that the *IDN? query returns. Sending an empty string returns the query output to its factory shipped setting. The maximum string length is 72 characters.
Command Reference SCPI Command Compatibility 8340B/41B Compatible Commands (firmware ≥ C.01.21) The tables in this section provide the following: Table 4-5 on page 296: a comprehensive list of 8340B/41B programming codes, listed in alphabetical order. The equivalent SCPI command sequence for each supported code is provided; codes that are not supported by the PSG family are indicated as such in the command column.
Command Reference SCPI Command Compatibility Table 4-5 Code 8340B/41B Programming Codes and Equivalent SCPI Sequences Description Equivalent SCPI Command Sequence A1 Leveling, internal POWer:ALC:SOURce INTernal A2a Leveling, external diode detector POWer:ALC:SOURce DIODe POWer:ALC:SOURce:EXTernal:COUPling DB A3 Leveling, power meter not supported AK Amplitude marker not supported AL Alternate state not supported AM0 Amplitude modulation off AM1:State OFF|0 AM2:State OFF|0 AM1b Amp
Command Reference SCPI Command Compatibility Table 4-5 Code 8340B/41B Programming Codes and Equivalent SCPI Sequences Description Equivalent SCPI Command Sequence DF Delta frequency FREQuency:MODE LIST POWer:MODE FIXED LIST:TYPE STEP INITiate:CONTinuous[:ALL] ON|1 LIST:TRIGger:SOURce BUS FREQuency:STARt FREQuency:STOP DN Step down supported, see Table 4-6 on page 304 DU0 Display off DISPlay[:WINDow][:STATe] OFF|0 DU1 Display on DISPlay[:WINDow][:STATe] ON|1 EFc Entry
Command Reference SCPI Command Compatibility Table 4-5 Code 8340B/41B Programming Codes and Equivalent SCPI Sequences Description Equivalent SCPI Command Sequence GZ GHz terminator GHZ HZ Hz terminator HZ IF Increment frequency TRIGger[:SEQuence][:IMMediate] or FREQuency[:CW] UP IL 123b Input learn data not supported IP Instrument preset STATus:QUEStionable:POWer:NTRansition 0 STATus:QUEStionable:POWer:PTRansition 2 STATus:QUEStionable:POWer:ENABle 2 STATus:QUEStionable:FREQuency:NTRansition
Command Reference SCPI Command Compatibility Table 4-5 Code 8340B/41B Programming Codes and Equivalent SCPI Sequences Description Equivalent SCPI Command Sequence M2 Marker 2 on not supported M3 Marker 3 on not supported M4 Marker 4 on not supported M5 Marker 5 on not supported MC Marker to CF not supported MD Marker delta not supported MO Marker off not supported MP Marker sweep M1-M2 not supported MS msec terminator not supported MZ MHz terminator MHZ NA Configure for net
Command Reference SCPI Command Compatibility Table 4-5 Code 8340B/41B Programming Codes and Equivalent SCPI Sequences Description Equivalent SCPI Command Sequence OPFA Output start frequency FREQuency:START? OPFB Output stop frequency FREQuency:STOP? OPFM1 Output FM sensitivity FM2[:DEViation]? OPPL Output power level POWer[:LEVel][:IMMediate][:AMPLitude]? OPSF Output frequency step size FREQuency[:CW]:STEP[:INCRement]? OPSL Output power slope supported, but no equivalent SCPI command seq
Command Reference SCPI Command Compatibility Table 4-5 Code 8340B/41B Programming Codes and Equivalent SCPI Sequences Description Equivalent SCPI Command Sequence S2 Sweep, single not supported S3 Sweep, manual not supported SC Seconds terminator not supported SF Frequency step size FREQuency[:CW]:STEP[:INCRement] SG Sweep, single not supported SH Shift prefix not supported SHA1 Disable ALC, set power not supported SHA2 External source module leveling not supported SHA
Command Reference SCPI Command Compatibility Table 4-5 Code 8340B/41B Programming Codes and Equivalent SCPI Sequences Description Equivalent SCPI Command Sequence SHM4 Diagnostic: test/display results not supported SHM5 Diagnostics off not supported SHMO All markers off not supported SHMP Marker sweep, M1-M2 not supported SHPL Set power level step POWer[:LEVel][:Immediate][:AMPLitude]:STEP[: INCREment] SHPM Enable 8756A/57A compatibility not supported SHPS Decouple attenuator and
Command Reference SCPI Command Compatibility Table 4-5 Code 8340B/41B Programming Codes and Equivalent SCPI Sequences Description Equivalent SCPI Command Sequence SHKZ Write to IO not supported SHHZ Read from IO not supported SL0 Power slope off POWer:SLOPe:STATe OFF|0 SL1 Power slope on POWer:SLOPe:STATe ON|1 POWer:SLOPe [DB/freqsuffix] SM Sweep, manual not supported SN Steps, maximum SWEep:POINts SP Set power step size POWer[:LEVel][:Immediate][:AMPLitude]:STEP[: INCREm
Command Reference SCPI Command Compatibility Table 4-6 Code Programming Codes that Set the Active Function; RB Compatibility; OA Query & UP/DN SCPI Commands Sets Compatible Comp. Comp.
Command Reference SCPI Command Compatibility Table 4-6 Code Programming Codes that Set the Active Function; RB Compatibility; OA Query & UP/DN SCPI Commands Sets Compatible Comp. Comp.
Command Reference SCPI Command Compatibility Table 4-7 Bit Number Decimal Value 8340 Status Byte Masks 7 6 5 4 3 2 1 0 128 64 32 16 8 4 2 1 RM Mask Function SRQ on New frequencies or sweep time in effect GPIB syntax error End of sweep RF settled Change in Numeric extended entry status byte completed (GPIB or front panel) Any front panel key pressed Request Service (RQS) PSG Bit(s) 0 #6 Status Group #5 Std Event Register Service Request Enable #3 #1 #3 0 0 Operation Opera
Command Reference SCPI Command Compatibility Table 4-8 8340 OS Status Byte #1 Bit Number Decimal Value 7 6 5 4 128 64 32 16 Function SRQ on New frequencies or sweep time in effect GPIB syntax error End of sweep Request Service (RQS) PSG Bit(s) 0 #6 #5 Status Group Register Status Byte #3 Standard Event Operation Event Event—Negative transition Bit Number 3 2 1 0 Decimal Value 8 4 2 1 Function SRQ on RF settled PSG Bit(s) Change in Numeric entry completed Any extended
Command Reference SCPI Command Compatibility Table 4-9 OS Status Byte #2 Bit Number Decimal Value Function 7 6 5 4 128 64 32 16 Fault indicator on PSG Bit(s) #0—2 and #5—6 RF unleveled #5 #1 Status Group Data Data Questionable Questionable Frequency (Summary) Register Condition Power failure RF unlocked #3 Data Data Questionable Questionable Power (Summary) Event— Condition Pos.
Command Reference SCPI Command Compatibility 836xxB/L Compatible SCPI Commands Table 4-10 is a comprehensive list of 836xxB/L SCPI commands arranged by subsystem. Commands that are supported by the PSG Family are identified, in addition to commands that are unsupported. Use the legend within the table to determine command compatibility. Some of the PSG supported commands are a subset of the 836xxB/L commands.
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L *STB? Y Y *TRG Y Y *TST? Y Y *WAI Y Y Y Y Abort Subsystem :ABORt Amplitude Modulation Subsystem :AM[:DEPTh] [PCT]|MAXimum|MINimum|DB Y :AM[:DEPTh]? [MAXimum|MINimum] Y :AM:INTernal:FREQuency []|MAXimum| MINimum Y :AM:INTernal:FREQuency? [MAXimum|MINimum] Y :AM:INTernal:FUNCtion SINusoid|
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L Calibration Subsystem :CALibration:AM:AUTO ON|OFF|1|0 N :CALibration:AM:AUTO? N :CALibration:AM[:EXECute] N :CALibration:PEAKing:AUTO ON|OFF|1|0 N N :CALibration:PEAKing:AUTO? N N :CALibration:PEAKing[:EXECute] N N :CALibration:PMETer:DETector:INITiate? IDETector|DIODe N N :CALibration:PMETer:DETector:NEXT? [
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L :CORRection:FLATness:POINts? [MAXimum|MINimum] Y Y :CORRection[:STATe] ON|OFF|1|0 Y Y :CORRection[:STATe]? Y Y :DIAGnostics:ABUS? N N :DIAGnostics:ABUS:AVERage N N :DIAGnostics:ABUS:AVERage? N N :DIAGnostics:ABUS:STATus? N N :DIAGnostics:INSTrument:PMETer:ADDRess N N :DIAGnostics:INSTrumen
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L :DIAGnostics:TEST:ENABle {}1*?|ALL N N :DIAGnostics:TEST[:EXECute] N N :DIAGnostics:TEST:LOG:SOURce ALL|FAIL N N :DIAGnostics:TEST:LOG:SOURce? N N :DIAGnostics:TEST:LOG[:STATe]? N N :DIAGnostics:TEST:LOG[:STATe] ON|OFF|1|0 N N :DIAGnostics:TEST:LOOP ON|OFF|1|0 N N :DIAGnostics:TEST:LOOP? N N :DIAGnos
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B :FM:INTernal:FREQuency []|MAXimum| MINimum Y :FM:INTernal:FREQuency? [MAXimum|MINimum] Y :FM:INTernal:FUNCtion SINusoid|SQUare|TRIangle|RAMP|NOISe Y :FM:INTernal:FUNCtion? Y :FM:SOURce INTernal|EXTernal Y :FM:SOURce? Y :FM:SENSitivity |MAXimum|MINimum Y :FM:SENSitivity? [MAXimum|MINimum] Y :FM:STATe
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L :FREQuency:MANual [freq suffix]|MAXimum|MINimum|UP| DOWN N N :FREQuency:MANual? [MAXimum|MINimum] N N :FREQuency:MODE FIXed|CW|SWEep|LIST Y Y :FREQuency:MODE? Y Y :FREQuency:MULTiplier |MAXimum|MINimumb Y Y :FREQuency:MULTiplier? [MAXimum|MINimum] Y Y :FREQuency:MULTiplier:STATe ON|OFF|1|0 N N :FREQuency:M
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L :FREQuency:STOP []|MAXimum|MINimum|UP| DOWN Y Y :FREQuency:STOP? [MAXimum|MINimum] Y Y :INITiate:CONTinuous ON|OFF|1|0 Y Y :INITiate:CONTinuous? Y Y :INITiate[:IMMediate] Y Y :LIST:DWELl {[
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L Y Y :MARKer[n]:AMPLitude[:STATe] ON|OFF|1|0 N N :MARKer[n]:AMPLitude[:STATe]? N N :MARKer[n]:AMPLitude:VALue [DB]|MAXimum|MINimum N N :MARKer[n]:AMPLitude:VALue? [MAXimum|MINimum] N N :MARKer[n]:AOFF N N :MARKer[n]:DELTa? , N N :MARKer[n]:FREQuency []|MAXimum| MINimum N N :
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B :MODulation:OUTPut:STATe ON|OFF|1|0 Y :MODulation:OUTPut:STATe? Y :MODulation:STATe? Y 83620L & 83640L Power Subsystem :POWer:ALC:BANDwidth|:BWIDth []| MAXimum|MINimum Y Y :POWer:ALC:BANDwidth?|:BWIDth? [MAXimum|MINimum] Y Y :POWer:ALC:BANDwidth|:BWIDth:AUTO ON|OFF|1|0 Y Y :POWer:ALC:BANDwidth|:BWIDth:AUTO? Y Y :PO
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L :POWer:ATTenuation:AUTO ON|OFF|1|0 Y Y :POWer:ATTenuation:AUTO? Y Y :POWer:CENTer []|MAXimum|MINimum|UP|DOWN Y Y :POWer:CENTer? [MAXimum|MINimum] Y Y :POWer[:LEVel] []|MAXimum|MINimum|UP| DOWN Y Y :POWer[:LEVel]? [MAXimum|MINimum] Y Y :POWer:MODE FIXed|SWEep Y Y :POWer:MODE? Y Y
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L :POWer:SPAN? [MAXimum|MINimum] Y Y :POWer:STARt |MAXimum|MINimum|UP|DOWN Y Y :POWer:STARt? [MAXimum|MINimum] Y Y :POWer:STATe ON|OFF|1|0 Y Y :POWer:STATe? Y Y :POWer:STEP:AUTO ON|OFF|1|0 Y Y :POWer:STEP:AUTO? Y Y :POWer:STEP[:INCRement] [DB]|MAXimum|MINimum Y Y :POWer:STEP[:INCRement]? [MAXimum|MI
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B :PULM:INTernal:PERiod [
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L :ROSCillator:SOURce? Y Y :ROSCillator:SOURce:AUTO ON|OFF|1|0 Y Y :ROSCillator:SOURce:AUTO? Y Y :ROSCillator:SOURce INTernal|EXTernal|NONE Y Y :STATus:OPERation:CONDition? Y Y :STATus:OPERation:ENABle Y Y :STATus:OPERation:ENABle? Y Y :STATus:OPERation[:EVENt]? Y Y :STATus:OPERation:NTRansition Y
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L Y Y :SWEep:CONTrol:STATe ON|OFF|1|0 N N :SWEep:CONTrol:STATe? N N :SWEep:CONTrol:TYPE MASTer|SLAVe N N :SWEep:CONTrol:TYPE? N N :SWEep:DWELl [
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L :SWEep:POINts? [MAXimum|MINimum] Y Y :SWEep:STEP []|MAXimum|MINimum N N :SWEep:STEP? [MAXimum|MINimum] N N :SWEep:TIME [
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L :SYSTem:MMHead:SELect FRONt|REAR|NONEc Y Y :SYSTem:MMHead:SELect? Y Y :SYSTem:PRESet[:EXECute] Y Y :SYSTem:PRESet:SAVE Y Y :SYSTem:PRESet:TYPE FACTory|USER Y Y :SYSTem:PRESet:TYPE? Y Y :SYSTem:SECurity:COUNt de Y Y :SYSTem:SECurity:COUNt? [MINimum|MAXimum] Y Y :SYSTem:SECurity[:STATe] ON|OFF|1|0e Y Y :S
Command Reference SCPI Command Compatibility Table 4-10 836xxB/L SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83620B & 83640B 83620L & 83640L :UNIT:POWer {} Y Y :UNIT:POWer? Y Y a. The identification information can be modifed for the PSG to reflect the signal generator that is being replaced. Refer to “:SYSTem:IDN” on page 294 for more information. b. A multiplier of zero is not allowed. c.
Command Reference SCPI Command Compatibility 8373xB and 8371xB Compatible SCPI Commands Table 4-11 is a comprehensive list of 8373xB and 8371xB SCPI commands arranged by subsystem. Commands that are supported by the PSG Family are identified, in addition to commands that are unsupported. Use the legend within the table to determine command compatibility. Some of the PSG supported commands are subsets of the 8373xB and 8371xB commands.
Command Reference SCPI Command Compatibility Table 4-11 8373xB and 8371xB SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83731B & 83732B 83711B & 83712B *PMC N N *PSC Y Y *PSC? Y Y *RCL Y Y *RMC N N *RST Y Y *SAV Y Y *SRE Y Y *SRE? Y Y *STB? Y Y *TST? Y Y *WAI Y Y Abort Subsystem :ABORt Y Amplitude Modulation Subsystem [:SOURce]:AM[:DEPTh] Y [:SOURce]:AM[:DEPTh] []|DB Y [:SOURce]:AM[
Command Reference SCPI Command Compatibility Table 4-11 8373xB and 8371xB SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83731B & 83732B [:SOURce]:AM:INTernal:FUNCtion SINusoid|SQUare|TRIangle| RAMP|NOISe|UNIForm|GAUSsian Y [:SOURce]:AM:SENSitivity |MIN|MAX|DEF N [:SOURce]:AM:SOURce FEED [:SOURce]:AM:SOURce INTernal|EXTernal N Y [:SOURce]:AM:SOURce? Y [:SOURce]:AM:STATe ON|OFF Y [:SOURce]:AM:STATe? Y [:SOURce]:AM:TYPE LINear|EXPonential Y [:SOURce]:AM:TYPE? Y
Command Reference SCPI Command Compatibility Table 4-11 8373xB and 8371xB SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83731B & 83732B 83711B & 83712B [:SOURce]:CORRection:CSET[:SELect]? N N [:SOURce]:CORRection:CSET:STATe ON|OFF|1|0 N N [:SOURce]:CORRection:CSET:STATe? N N Frequency Modulation Subsystem [:SOURce]:FM:COUPling AC|DC Y [:SOURce]:FM:COUPling? Y [:SOURce]:FM[:DEViation] Y [:SOURce]:FM[:DEViation]:STEP[:INCRement] []
Command Reference SCPI Command Compatibility Table 4-11 8373xB and 8371xB SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83731B & 83732B 83711B & 83712B [:SOURce]:FREQuency[:CW|:FIXed]:STEP? Y Y [:SOURce]:FREQuency:MULTiplier |UP|DOWN|DEFaultb Y Y [:SOURce]:FREQuency:MULTiplier? Y Y [:SOURce]:FREQuency:MULTiplier:STEP[:INCRement] incr| MINimum|MAXimum|DEFault N N [:SOURce]:FREQuency:MULTiplier:STEP[:INCRement]? N N :MEMory:CATalog[:ALL]? Y Y :MEMory:CATal
Command Reference SCPI Command Compatibility Table 4-11 8373xB and 8371xB SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family [:SOURce]:MODulation:STATe? 83731B & 83732B 83711B & 83712B Y Output Subsystem :OUTPut:IMPedance? N N :OUTPut:PROTection[:STATe] ON|OFF N N :OUTPut:PROTection[:STATe]? N N :OUTPut[:STATe] ON|OFF|1|0 Y Y :OUTPut[:STATe]? Y Y Phase Modulation Subsystem [:SOURce]:PM:COUPling AC|DC Y [:SOURce]:PM[:DEViation] Y [:SOURce]:PM[:DEViati
Command Reference SCPI Command Compatibility Table 4-11 8373xB and 8371xB SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83731B & 83732B 83711B & 83712B [:SOURce]:POWer:ALC:PMETer:STEP incr|MINimum|MAXimum| DEFault N N [:SOURce]:POWer:ALC:PMETer:STEP? N N [:SOURce]:POWer:ALC:SOURce PMETer [:SOURce]:POWer:ALC:SOURce INTernal|DIODe N Y N Y [:SOURce]:POWer:ALC:SOURce? Y Y [:SOURce]:POWer:ATTenuation:AUTO ONCE [:SOURce]:POWer:ATTenuation:AUTO ON|OFF N Y N Y [:SOURce]
Command Reference SCPI Command Compatibility Table 4-11 8373xB and 8371xB SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83731B & 83732B 83711B & 83712B Pulse Subsystem [:SOURce]:PULSe:DELay delay|MINimum|MAXimum|UP|DOWN| DEFault Y [:SOURce]:PULSe:DELay? Y [:SOURce]:PULSe:DELay:STEP [
Command Reference SCPI Command Compatibility Table 4-11 8373xB and 8371xB SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83731B & 83732B [:SOURce]:PULSe:WIDTh:STEP [
Command Reference SCPI Command Compatibility Table 4-11 8373xB and 8371xB SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83731B & 83732B 83711B & 83712B :SYSTem:COMMunicate:GPIB:ADDRess Y Y :SYSTem:COMMunicate:GPIB:ADDRess? Y Y :SYSTem:COMMunicate:PMETer:ADDRess Y Y :SYSTem:COMMunicate:PMETer:ADDRess? Y Y :SYSTem:ERRor? Y Y :SYSTem:KEY keycode|MINimum|MAXimum N N :SYSTem:KEY? N N :SYSTem:LANGuage "COMP=8673"|"COMPatibility=8673" :SYSTem:LANGuage "S
Command Reference SCPI Command Compatibility Table 4-11 8373xB and 8371xB SCPI Commands Y= Supported by PSG Family N= Not supported by PSG Family 83731B & 83732B 83711B & 83712B :UNIT:POWer? Y Y :UNIT:TIME N N :UNIT:TIME? N N :UNIT:VOLTage {} N N :UNIT:VOLTage? N N a. The identification information can be modifed for the PSG to reflect the signal generator that is being replaced. Refer to “:SYSTem:IDN” on page 294 for more information. b. A multiplier of zero is not allowed.
Command Reference SCPI Command Compatibility 338 Chapter 4
Index Symbols phase modulation subsystem keys ΦM Tone 2 Ampl Percent of Peak softkey, 272 softkey, 269, 272, 273, 274, 276, 277, 278 Numerics softkey, 279 1 kHz softkey, 279 10 kHz softkey, 279 100 kHz softkey, 279 8340B/41B, compatible commands, 295 836xxB/L, compatible commands, 309 8371xB, compatible commands, 327 8373xB, compatible commands, 327 A abort function, 9 address GPIB address, 7 IP address, 15 Adjust Phase softkey, 242 Agilent BASIC, 35 SICL, 34 VISA, 34 Agilent BASIC, 4 Agilent VISA, 7, 14,
Index ABORT, 9 CLEAR, 12 ENTER, 13 LOCAL, 11 LOCAL LOCKOUT, 10 OUTPUT, 12 REMOTE, 10 Binary softkey, 177, 185 binary values, 153 bit status, how and what to monitor, 105 bit values, 104 boolean SCPI parameters, 146 boolean, numeric response data, 148 Brightness softkey, 174 Bus softkey, 217, 225, 248, 259, 265, 273 C C/C++, 4 include files, 33 calibration subsystem keys DCFM/DCΦM Cal, 162 clear command, 12 clear function, 12 CLS command, 108 command compatibility.
Index Delete All List Files, 182 Delete All State Files, 182 Delete All UFLT Files, 182 Delete File, 183 developing programs, 33 Diagnostic Info softkey, 156, 170, 171, 172, 173 diagnostic subsystem keys Diagnostic Info, 170, 171, 172, 173 Installed Board Info, 170 Options Info, 171, 172 discrete response data, 148 discrete SCPI parameters, 146 display contrast hardkeys, 175 display subsystem keys Brightness, 174 display contrast, 175 Inverse Video Off On, 175 Update in Remote Off On, 176 Do Power Search so
Index FM Start Rate, 249 FM Stop Rate, 246 FM Sweep Rate, 247 FM Tone 1 Rate, 249 FM Tone 2 Amp Percent of Peak, 247 FM Tone 2 Rate, 246 Free Run, 248 Gaussian, 249 Incr Set, 245 Internal 1, 251 Internal 2, 251 Negative, 250 Noise, 250 Positive, 250 Ramp, 250 Sine, 250 Square, 250 Swept-Sine, 250 Triangle, 250 Trigger Key, 248 Uniform, 249 frequency subsystem keys Adjust Phase, 242 Freq, 237 Freq Multiplier, 238 Freq Offset, 238, 239 Freq Ref Off On, 239 Freq Ref Set, 239 Freq Start, 240 Freq Stop, 240 Freq
Index Internal softkeys Internal, 281 Internal 1, 251, 276 Internal 1 Monitor, 268 Internal 2, 251, 276 Internal 2 Monitor, 268 Internal Square, 292 Inverse Video Off On softkey, 175 IO libraries, 2, 3, 5, 7, 9, 26 IP address, 15 configuration, 15 See also hostname IP Address softkey, 164 iremote, 10 J Java example, 91 L LabView, 4 LAN, 3 configuration, 15 hostname configuration, 15 interface, 3 IO libraries, 14 IP address configuration, 15 overview, 14 program examples, 64 sockets, 64 sockets LAN, 14 TEL
Index M Manual Mode Off On softkey, 258 manual operation, 10 Manual Point softkey, 257 mass memory subsystem keys Binary, 185 Copy File, 186 Delete File, 187 List, 185 Load From Selected File, 187 Rename File, 188 State, 185 Store To File, 188 User Flatness, 185 memory subsystem keys All, 179, 183 Binary, 177 Copy File, 180 Delete All Binary Files, 181 Delete All Files, 181 Delete All List Files, 182 Delete All State Files, 182 Delete All UFLT Files, 182 Delete File, 183 List, 178 Load From Selected File, 1
Index Ext1, 276 Ext2, 276 FM ΦM Normal High BW, 270 Free Run, 273 Gaussian, 274 Incr Set, 270, 278 Internal 1, 276 Internal 2, 276 Negative, 275 Noise, 275 Positive, 275 Ramp, 275 Sine, 275 Square, 275 Swept-Sine, 275 Triangle, 275 Trigger Key, 273 Uniform, 274 Phase Ref Set softkey, 241 ping program, 15 polling method (status registers), 106 ports, 69 Positive softkey, 227, 250, 267, 275 positive transition filter, description, 113 Power Meter softkey, 165 Power On Last Preset softkey, 210 Power Search Man
Index data questionable modulation event, 132 data questionable modulation event enable, 132 data questionable power condition, 125 data questionable power event, 126 data questionable power event enable, 126 in status groups (descriptions), 113 overall system, 103 standard event status, 115 standard event status enable, 116 standard operation condition, 118 standard operation event, 119 standard operation event enable, 119 status byte, 111 remote annunciator, 94 remote function, 10 remote interface, 2 GPIB
Index SCPI register model, 102 Screen Saver softkeys Screen Saver, 213 Screen Saver Delay:, 213 Screen Saver Off On, 214 Select Seq: softkey, 158 service request method (status registers), 106 service request method, using, 107 Set ALC Level softkey, 280 Set Atten softkey, 282 SetRWLS, 11 SICL, 7, 14, 26, 34 iabort, 9 iclear, 12 igpibllo, 11 iprintf, 13 iremote, 10 iscanf, 13 signal generator monitoring status, 102 Sine softkey, 227, 250, 266, 275 Single Sweep softkey, 216 sockets example, 69, 72 Java, 91 L
Index STB command, 108 Step Dwell softkey, 262 Store To File softkey, 184, 188, 235 string response data, 148 string SCPI parameter, 147 strings, quote usage, 152 subsystems, SCPI commands.
