Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference Agilent Technologies
Notices © Agilent Technologies, Inc. 2008–2013 Warranty No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Agilent Technologies, Inc. as governed by United States and international copyright laws. The material contained in this document is provided “as is,” and is subject to being changed, without notice, in future editions.
Contents 1 Introduction to SCPI 1 Introduction to the SCPI Language 2 SCPI Conventions and Data Formats 3 Command separators 3 Syntax conventions 5 Syntax diagram conventions 7 Data types and formats 8 Input message terminators 9 Using device clear 10 SCPI Status System 11 Questionable Data register 13 Standard Event register 14 Status Byte register 15 2 IEEE-488.
APPLy:DC 37 APPLy:USER 38 APPLy? 39 iv 4 Output Configuration Commands 41 [SOURce:]FUNCtion[:SHAPe] 42 [SOURce:]FREQuency 44 [SOURce:]VOLTage[:LEVel][:IMMediate][:AMPLitude] 45 [SOURce:]VOLTage[:LEVel][:IMMediate]:OFFSet 47 [SOURce:]VOLTage[:LEVel][:IMMediate]:HIGH 48 [SOURce:]VOLTage[:LEVel][:IMMediate]:LOW 49 [SOURce:]VOLTage[:LEVel][:IMMediate]:UNIT 50 [SOURce:]FUNCtion:SQUare:DCYCle 51 [SOURce:]FUNCtion:RAMP:SYMMetry 52 OUTPut[:STATe] 53 OUTPut:LOAD 54 5 Pulse Configuration Commands 57 [SOURce:]PUL
[SOURce:]PM:DEViation 77 [SOURce:]PM:STATe 78 7 Shift Keying Commands 79 [SOURce:]ASKey:INTernal:RATE 80 [SOURce:]ASKey:STATe 81 [SOURce:]FSKey:FREQuency 82 [SOURce:]FSKey:INTernal:RATE 83 [SOURce:]FSKey:STATe 84 [SOURce:]PSKey:DEViation 85 [SOURce:]PSKey:INTernal:RATE 86 [SOURce:]PSKey:STATe 87 8 Frequency Sweep Commands 89 [SOURce:]FREQuency:STARt 90 [SOURce:]FREQuency:STOP 91 [SOURce:]SWEep:SPACing 92 [SOURce:]SWEep:TIME 93 [SOURce:]SWEep:STATe 94 9 Triggering Commands 95 TRIGger[:SEQuence]:SOURce 9
vi 11 SYSTem Commands 111 SYSTem:CDEScription? 112 SYSTem:ERRor? 113 SYSTem:VERSion? 114 12 Phase-Lock Commands 115 [SOURce:]PHASe:SOURce 116 [SOURce:]PHASe[:ADJust] 117 UNIT:ANGLe 118 [SOURce:]PHASe:REFerence 119 [SOURce:]PHASe:UNLock:ERRor[:STATe] 120 OUTPut:PHASe[:STATe] 121 13 Status Reporting Commands 123 STATus:PRESet 124 STATus:QUEStionable:CONDition? 125 STATus:QUEStionable:ENABle 126 STATus:QUEStionable[:EVENt]? 128 14 CALibration Commands 129 CALibration:SECure:STATe 130 CALibration:SECure
Instrument errors 152 Self-test errors 153 Calibration errors 153 Arbitrary waveform errors 155 17 U2761A Programmer’s Reference Factory Default Settings 157 vii
viii U2761A Programmer’s Reference
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 1 Introduction to SCPI Introduction to the SCPI Language 2 SCPI Conventions and Data Formats 3 Command separators 3 Syntax conventions 5 Syntax diagram conventions 7 Data types and formats 8 Input message terminators 9 Using device clear 10 SCPI Status System 11 Questionable Data register 13 Standard Event register 14 Status Byte register 15 This chapter introduces the remote programming basics of the U2761A USB modula
1 Introduction to SCPI Introduction to the SCPI Language SCPI, also known as the Standard Commands for Programmable Instruments, is an ASCII-based instrument command language designed for test and measurement instruments. SCPI defines how you communicate with an instrument from a bus controller. SCPI commands are based on a hierarchical structure, similar to the file systems used by many bus controllers. This hierarchical structure is also known as a tree system.
Introduction to SCPI 1 SCPI Conventions and Data Formats Command separators Using a colon ( : ) A colon ( : ) is used to separate a command keyword from a lower- level keyword. When a colon is inserted between two command mnemonics, the colon moves the path down one level in the present path (for the specified root- level command) of the command tree.
1 Introduction to SCPI Use a semicolon and a colon to link commands from different subsystems. For example, in the following command string, an error is generated if you do not use both the semicolon and colon: → SWE:STAT ON;:TRIG:SOUR EXT Using a comma ( , ) If a command requires more than one parameter, you must separate adjacent parameters using a comma as shown in the following example: → APPL:SIN 5 KHZ, 3.0 VPP, –2.
Introduction to SCPI 1 Using “ * ” commands Commands starting with a “*” are called common commands. They are required to perform the identical function for all instruments that are compliant with the IEEE- 488.2 interface standard. The IEEE- 488.2 standard defines a set of common commands that perform functions such as reset, self- test, and status operations. Common commands always begin with an asterisk (*), are three characters in length, and may include one or more parameters.
1 Introduction to SCPI Square brackets “[ ]” Some commands and parameters are enclosed in square brackets “[ ]”. Items within the square brackets are optional and can be omitted. For example, the syntax statement below shows that SOURce: is optional and can be omitted: [SOURce:]PULSe:PERiod PULSe:PERiod The brackets are not sent with the command string. Parenthesis “( )” Parameters within parentheses are used to specify an address list. The notation (@1) specifies address 1.
Introduction to SCPI 1 Syntax diagram conventions Root keyword Second level Third level space Option 1 , Parameter Option 2 Option 3 Figure 1-1 Typical syntax diagram Solid lines represent the recommended path. Ovals enclose the short form command mnemonics. The command mnemonic must be entered exactly as shown. Ovals are also used to represent discrete parameters and command separators. Rectangles enclose the parameters required.
1 Introduction to SCPI Data types and formats The SCPI language defines different data formats for use in program messages and response messages. Instruments are flexible listeners and can accept commands and parameters in various formats. However, SCPI instruments are precise talkers. This means that SCPI instruments always respond to a particular query in a predefined, rigid format.
Introduction to SCPI 1 String Parameters that contain virtually any set of ASCII characters. A string must begin and end with matching quotes; either with a single quote or a double quote. You can include the quote delimiter as part of the string by typing it twice without any characters in between. The following command uses a string parameter: CALibration:STRing Address list An address list must be preceded with the “@” symbol and must be enclosed in parentheses “( )”.
1 Introduction to SCPI Using device clear Device clear is an IEEE- 488 low- level bus message that you can use to return the instrument to a responsive state (for example, during a lengthy query). Different programming languages and IEEE- 488 interface cards provide access to this capability through their own unique commands. The status registers, the error queue, and all configuration states are left unchanged when a device clear message is received.
Introduction to SCPI 1 SCPI Status System The status system records various instrument conditions and states in several register groups. Each register group is made up of several low-level registers called Condition register, Event register, and Enable register which control the action of specific bits within the register group. A Condition register continuously monitors the state of the instrument. The bits in the condition register are updated in realtime and the bits are not latched or buffered.
1 Introduction to SCPI Figure 1-2 Status system diagram 12 U2761A Programmer’s Reference
Introduction to SCPI 1 Questionable Data register The Questionable Data register group provides the information on the quality or integrity of the U2761A. The outputs of the Questionable Data group are logically-ORed into the Questionable summary bit (3) of the Status Byte register. Bit definitions: Questionable Data register Bit number Decimal value Definition 0 to 3 Not Used Not Used 0 is returned 4 Over Temperature 16 Internal temperature is over the limit.
1 Introduction to SCPI Standard Event register The Standard Event register group reports the following types of instrument events: power on detected, command syntax errors, command execution errors, device errors (self-test or calibration), query errors, or when an *OPC command is executed. All of these conditions can be reported in the Standard Event summary bit through the enable register.
Introduction to SCPI 1 Status Byte register The Status Byte register group reports the conditions from the other status registers. Clearing an event register from one of the other registers will clear the corresponding bits in the Status Byte condition register. Data that is waiting in the U2761A output buffer is immediately reported on the “Message Available” bit (bit 4).
1 16 Introduction to SCPI U2761A Programmer’s Reference
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 2 IEEE-488.2 Common Commands *CLS *ESE *ESR? *IDN? *OPC *RST *SRE *STB? *TRG *TST? *WAI 18 19 20 21 22 23 24 26 27 28 29 This section describes the IEEE-488.2 common commands supported by the U2761A.
2 IEEE-488.2 Common Commands *CLS Syntax *CLS *CLS This command is used to clear the event registers in all register groups, and also clears the error queue. Example The following command clears the event register bits.
IEEE-488.2 Common Commands 2 *ESE Syntax *ESE space value ? *ESE This command sets the bits in the Standard Event enable register. The selected bits are then reported to bit 5 of the Status Byte register. *ESE? This query reads the enable register and returns a decimal value which corresponds to the binary- weighted sum of all bits set in the register.
2 IEEE-488.2 Common Commands *ESR? Syntax *ESR ? *ESR? This query reads the event register of the Standard Event register group and returns a decimal value which corresponds to the binary- weighted sum of all bits set in the register. Remarks • Once a bit is set, it will remain set until cleared by a clear status (*CLS) command or queried by this command. • For more information on the Standard Event register, refer to Chapter 1, “Status system diagram” on page 12.
IEEE-488.2 Common Commands 2 *IDN? Syntax *IDN ? *IDN? This query reads the U2761A identification string which contains four comma-separated fields. The first field is the manufacturer's name, the second field is the model number of the U2761A, the third field is the serial number, and the fourth field is the firmware revision number. This query returns an ASCII string with the following format. AGILENT TECHNOLOGIES,U2761A,,m.mm-f.ff- b.bb m.mm = main firmware revision number f.
2 IEEE-488.2 Common Commands *OPC Syntax *OPC ? *OPC This command sets the “Operation Complete” bit (bit 0) in the Standard Event register when all pending operations have completed. This command is used in the triggered sweep mode to provide a way to poll (interrupt) the PC when the *TRG command has completed. *OPC? This query sends 1 to the output buffer when all pending operations have completed. Examples The following command sets the “Operation Complete” bit (bit 0).
IEEE-488.2 Common Commands 2 *RST Syntax *RST *RST This command resets the U2761A to its factory default state, which is the state when the U2761A is powered on. This command will abort a sweep in progress, but does not affect stored Arbitrary waveforms. NOTE Refer to Chapter 17, “Factory Default Settings” on page 157 for a complete listing of the U2761A default settings. Example The following command resets the U2761A.
2 IEEE-488.2 Common Commands *SRE Syntax *SRE space value ? *SRE This command enables the bits in the Status Byte enable register. The selected enabled bits are summarized in the “Master Summary” bit (bit 6) of the Status Byte register. If any of the selected bit condition changes from 0 to 1, a Service Request is generated. *SRE? This query reads the enable register and returns a decimal value that corresponds to the binary-weighted sum of all bits set in the register.
IEEE-488.2 Common Commands 2 The following query returns the bit enabled in the register.
2 IEEE-488.2 Common Commands *STB? Syntax *STB ? *STB? This query reads the summary (condition) of the Status Byte register and returns a decimal value which corresponds to the binary- weighted sum of all bits set in the register. This query is similar to a Serial Poll but it is processed like any other instrument command. This is a read- only register and the bits are not cleared when you read the register.
IEEE-488.2 Common Commands 2 *TRG Syntax *TRG *TRG This command triggers a sweep from the remote interface only if the bus (software) trigger source is currently selected. Example The following command triggers a sweep.
2 IEEE-488.2 Common Commands *TST? Syntax *TST ? *TST? This query performs a self-test on the U2761A and returns +0 (pass) or +1 (fail). If the test fails, one or more error messages will be generated to provide additional information on the failure. Example The following query returns the self-test status.
IEEE-488.2 Common Commands 2 *WAI Syntax *WAI *WAI This command sets the U2761A to wait for the completion of all pending operations before executing any additional command over the interface. Example The following command sets the U2761A to wait until all pending operations have completed.
2 30 IEEE-488.
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 3 APPLy Commands Using the APPLy Command 32 APPLy:SINusoid 33 APPLy:SQUare 34 APPLy:RAMP 35 APPLy:PULSe 36 APPLy:DC 37 APPLy:USER 38 APPLy? 39 This section describes the APPLy commands used to program the U2761A over the remote interface. The waveform is output as soon as the APPLy command is executed for each function.
3 APPLy Commands Using the APPLy Command The APPLy command provides the most straightforward method to program the U2761A over the remote interface.
APPLy Commands 3 APPLy:SINusoid Syntax APPL :SIN space frequency , amplitude , offset APPLy:SINusoid [ [, [,] ]] This command outputs a Sine wave with the specified frequency, amplitude, and DC offset. The waveform is output as soon as the command is executed.
3 APPLy Commands APPLy:SQUare Syntax APPL :SQU space frequency , amplitude , offset APPLy:SQUare [ [, [,] ]] This command outputs a Square wave with the specified frequency, amplitude, and DC offset. The waveform is output as soon as the command is executed.
APPLy Commands 3 APPLy:RAMP Syntax APPL :RAMP space frequency , amplitude , offset APPLy:RAMP [ [, [,] ]] This command outputs a Ramp wave with the specified frequency, amplitude, and DC offset. The waveform is output as soon as the command is executed.
3 APPLy Commands APPLy:PULSe Syntax APPL :PULS space frequency , amplitude , offset APPLy:PULSe [ [, [,] ]] This command outputs a Pulse wave with the specified frequency, amplitude, and DC offset. The waveform is output as soon as the command is executed.
APPLy Commands 3 APPLy:DC Syntax APPL :DC space frequency , DEF amplitude , offset DEF APPLy:DC [ [,|DEFault> [,] ]] This command outputs a DC voltage with the level specified by the offset parameter. The DC voltage is output as soon as the command is executed. Parameters Item Type Range of values Default value frequency|DEFault Numeric N/A DEFault amplitude|DEFault Numeric N/A DEFault offset Numeric • ±2.
3 APPLy Commands APPLy:USER Syntax APPL :USER space frequency , amplitude , offset APPLy:USER [ [, [,] ]] This command outputs a user- defined Arbitrary waveform with the specified frequency, amplitude, and DC offset. The waveform is output as soon as the command is executed.
APPLy Commands 3 APPLy? Syntax APPL ? APPLy? This query returns the U2761A current configuration of the function, frequency, amplitude, and offset in a quoted string (the quotation marks are returned as part of the string). Example The following query returns the function, frequency, amplitude, and offset values. APPL? Typical response: "SIN +1.0000000000000E+03,+1.0000000000000E+00,+0.
3 40 APPLy Commands U2761A Programmer’s Reference
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 4 Output Configuration Commands [SOURce:]FUNCtion[:SHAPe] 42 [SOURce:]FREQuency 44 [SOURce:]VOLTage[:LEVel][:IMMediate][:AMPLitude] 45 [SOURce:]VOLTage[:LEVel][:IMMediate]:OFFSet 47 [SOURce:]VOLTage[:LEVel][:IMMediate]:HIGH 48 [SOURce:]VOLTage[:LEVel][:IMMediate]:LOW 49 [SOURce:]VOLTage[:LEVel][:IMMediate]:UNIT 50 [SOURce:]FUNCtion:SQUare:DCYCle 51 [SOURce:]FUNCtion:RAMP:SYMMetry 52 OUTPut[:STATe] 53 OUTPut:LOAD 54 Thi
4 Output Configuration Commands [SOURce:]FUNCtion[:SHAPe] Syntax SOUR : FUNC :SHAP space SIN SQU RAMP PULS DC USER ? [SOURce:]FUNCtion[:SHAPe] {SINusoid|SQUare|RAMP|PULSe|DC| USER} This command sets the output function. [SOURce:]FUNCtion[:SHAPe]? This query returns the selected output function as SIN, SQU, RAMP, PULS, DC, or USER.
Output Configuration Commands 4 Examples The following command sets the output function to Square. FUNC SQU The following query returns the output function.
4 Output Configuration Commands [SOURce:]FREQuency Syntax SOUR : FREQ space frequency ? [SOURce:]FREQuency This command sets the output frequency. [SOURce:]FREQuency? This query returns the frequency setting in Hz for the currently selected function.
Output Configuration Commands 4 [SOURce:]VOLTage[:LEVel][:IMMediate][:AMPLitude] Syntax SOUR : VOLT :LEV :IMM :AMPL space amplitude VPP VRMS DBM ? [SOURce:]VOLTage[:LEVel][:IMMediate][:AMPLitude] [VPP|VRMS|DBM] This command sets the output amplitude with optional unit. [SOURce:]VOLTage[:LEVel][:IMMediate][:AMPLitude]? This query returns the output amplitude for the currently selected function and unit.
4 Output Configuration Commands Examples The following command sets the output amplitude to 5 Vpp. VOLT 5 VPP The following query returns the output amplitude. VOLT? Typical response: +5.
Output Configuration Commands 4 [SOURce:]VOLTage[:LEVel][:IMMediate]:OFFSet Syntax SOUR : VOLT :LEV :IMM :OFFS space offset ? [SOURce:]VOLTage[:LEVel][:IMMediate]:OFFSet This command sets the offset voltage. [SOURce:]VOLTage[:LEVel][:IMMediate]:OFFSet? This query returns the offset voltage for the currently selected function. Parameter Item offset Type Numeric Range of values Default value load)[1] • ±2.48 V (Into 50 Ω • ±4.
4 Output Configuration Commands [SOURce:]VOLTage[:LEVel][:IMMediate]:HIGH Syntax SOUR : VOLT :LEV :IMM :HIGH space voltage ? [SOURce:]VOLTage[:LEVel][:IMMediate]:HIGH This command sets the high voltage level. [SOURce:]VOLTage[:LEVel][:IMMediate]:HIGH? This query returns the high voltage level for the currently selected function. Parameter Item Type Range of values Default value voltage Numeric • –2.46 V to 2.5 V (Into 50 Ω load) • –4.92 V to 5 V (Into open circuit) 0.
Output Configuration Commands 4 [SOURce:]VOLTage[:LEVel][:IMMediate]:LOW Syntax SOUR : VOLT :LEV :IMM :LOW space voltage ? [SOURce:]VOLTage[:LEVel][:IMMediate]:LOW This command sets the low voltage level. [SOURce:]VOLTage[:LEVel][:IMMediate]:LOW? This query returns the low voltage level for the currently selected function. Parameter Item Type Range of values Default value voltage Numeric • –2.5 V to 2.46 V (Into 50 Ω load) • –5 V to 4.92 V (Into open circuit) –0.
4 Output Configuration Commands [SOURce:]VOLTage[:LEVel][:IMMediate]:UNIT Syntax SOUR : VOLT :LEV :IMM :UNIT space VPP VRMS DBM ? [SOURce:]VOLTage[:LEVel][:IMMediate]:UNIT {VPP|VRMS|DBM} This command sets the unit for the output amplitude. [SOURce:]VOLTage[:LEVel][:IMMediate]:UNIT? This query returns the unit for the output amplitude as VPP, VRMS, or DBM.
Output Configuration Commands 4 [SOURce:]FUNCtion:SQUare:DCYCle Syntax SOUR : FUNC :SQU :DCYC space percent ? [SOURce:]FUNCtion:SQUare:DCYCle This command sets the duty cycle percentage for the Square wave. [SOURce:]FUNCtion:SQUare:DCYCle? This query returns the current duty cycle setting in %.
4 Output Configuration Commands [SOURce:]FUNCtion:RAMP:SYMMetry Syntax SOUR : FUNC :RAMP :SYMM space percent ? [SOURce:]FUNCtion:RAMP:SYMMetry This command sets the symmetry percentage for the Ramp wave. [SOURce:]FUNCtion:RAMP:SYMMetry? This query returns the current symmetry setting in %. Parameter NOTE Item Type Range of values Default value percent Numeric 0% to 100% 100% Setting the symmetry to 50% will produce a Triangle wave, and 0% for a Negative Ramp wave.
Output Configuration Commands 4 OUTPut[:STATe] Syntax OUTP :STAT space 0|OFF 1|ON ? OUTPut[:STATe] {0|OFF|1|ON} This command disables or enables the U2761A output. OUTPut[:STATe]? This query returns the output state as 0 if the output is disabled, or 1 if the output is enabled. Parameter Item Type Range of values Default value state Boolean 0|OFF|1|ON 0 Examples The following command turns on the output. OUTP ON The following query returns the output state.
4 Output Configuration Commands OUTPut:LOAD Syntax OUTP :LOAD space ohms INF ? OUTPut:LOAD {|INFinity} This command specifies the desired output termination (the impedance of the load attached to the U2761A output) value. The specified value is used in internal calculations for the amplitude, offset, and high/low level settings. Setting INFinity or 9.9E+37 indicates that the output termination is “high impedance”. OUTPut:LOAD? This query returns the current output termination value in Ω or 9.
Output Configuration Commands 4 Examples The following command specifies the output termination value as 2 kΩ. OUTP:LOAD 2000 The following query returns the output termination value. OUTP:LOAD? Typical response: +2.
4 56 Output Configuration Commands U2761A Programmer’s Reference
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 5 Pulse Configuration Commands [SOURce:]PULSe:PERiod 58 [SOURce:]FUNCtion:PULSe:HOLD 59 [SOURce:]FUNCtion:PULSe:WIDTh 60 [SOURce:]FUNCtion:PULSe:DCYCle 62 This section describes the Pulse configuration commands used to program the U2761A to output a Pulse waveform. These commands allow you to configure the pulse period, pulse hold, pulse width, and pulse duty cycle.
5 Pulse Configuration Commands [SOURce:]PULSe:PERiod Syntax SOUR : PULS :PER space seconds ? [SOURce:]PULSe:PERiod This command sets the period for the Pulse wave. [SOURce:]PULSe:PERiod? This query returns the period of the Pulse wave in seconds. Parameter Item Type Range of values Default value seconds Numeric 200 ns to 2000 s 1 ms Examples The following command sets the period to 1 s. PULS:PER 1 The following query returns the pulse period. PULS:PER? Typical response: +1.
Pulse Configuration Commands 5 [SOURce:]FUNCtion:PULSe:HOLD Syntax SOUR : FUNC :PULS :HOLD space WIDT DCYC ? [SOURce:]FUNCtion:PULSe:HOLD {WIDTh|DCYCle} This command sets the U2761A to hold either the pulse width or pulse duty cycle setting constant as the period is varied. [SOURce:]FUNCtion:PULSe:HOLD? The query returns the pulse hold setting as WIDT or DCYC.
5 Pulse Configuration Commands [SOURce:]FUNCtion:PULSe:WIDTh Syntax SOUR : FUNC :PULS :WIDT space seconds ? [SOURce:]FUNCtion:PULSe:WIDTh This command sets the pulse width in seconds. The pulse width represents the time from the 50% threshold of the pulse rising edge to the 50% threshold of the next falling edge. [SOURce:]FUNCtion:PULSe:WIDTh? This query returns the pulse width in seconds. Parameter Item Type Range of values Default value seconds Numeric 40 ns to 1999.
Pulse Configuration Commands 5 The following query returns the pulse width. FUNC:PULS:WIDT? Typical response: +2.
5 Pulse Configuration Commands [SOURce:]FUNCtion:PULSe:DCYCle Syntax SOUR : FUNC :PULS :DCYC space percent ? [SOURce:]FUNCtion:PULSe:DCYCle This command sets the pulse duty cycle percentage. [SOURce:]FUNCtion:PULSe:DCYCle? This query returns the current pulse duty cycle in %. Parameter Item percent Type Range of values Default value Numeric 0% to 100%[1] 50% [1] The pulse duty cycle is limited by minimum pulse width restrictions which prevent you from setting exactly 0% or 100%.
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 6 Modulation Commands [SOURce:]AM:INTernal:FUNCtion 64 [SOURce:]AM:INTernal:FREQuency 66 [SOURce:]AM:DEPTh 67 [SOURce:]AM:STATe 68 [SOURce:]FM:INTernal:FUNCtion 69 [SOURce:]FM:INTernal:FREQuency 71 [SOURce:]FM:DEViation 72 [SOURce:]FM:STATe 73 [SOURce:]PM:INTernal:FUNCtion 74 [SOURce:]PM:INTernal:FREQuency 76 [SOURce:]PM:DEViation 77 [SOURce:]PM:STATe 78 This section describes the Modulation commands used to generate m
6 Modulation Commands [SOURce:]AM:INTernal:FUNCtion Syntax SOUR : AM :INT :FUNC space SIN SQU RAMP NRAM TRI USER ? [SOURce:]AM:INTernal:FUNCtion {SINusoid|SQUare|RAMP|NRAMp| TRIangle|USER} This command sets the modulating waveform of the amplitude modulation. The available modulating waveform types consist of sinusoid, square, ramp, negative ramp, triangle, and user- defined. [SOURce:]AM:INTernal:FUNCtion? This query returns the selected modulating waveform as SIN, SQU, RAMP, NRAM, TRI, or USER.
Modulation Commands 6 Examples The following command sets the modulating waveform to Sine. AM:INT:FUNC SIN The following query returns the modulating waveform.
6 Modulation Commands [SOURce:]AM:INTernal:FREQuency Syntax SOUR : AM :INT :FREQ space frequency ? [SOURce:]AM:INTernal:FREQuency This command sets the frequency of the modulating waveform. [SOURce:]AM:INTernal:FREQuency? This query returns the modulating frequency in Hz. Parameter Item Type Range of values Default value frequency Numeric 2 mHz to 20 kHz 100 Hz Examples The following command sets the modulating frequency to 500 Hz.
Modulation Commands 6 [SOURce:]AM:DEPTh Syntax SOUR : AM :DEPT space depth in percent ? [SOURce:]AM:DEPTh This command sets the amplitude modulation depth in %. The modulation depth represents the extent of the amplitude variation. [SOURce:]AM:DEPTh? This query returns the modulation depth in %. Parameter Item Type Range of values Default value depth Numeric 0% to 100% 100% Remarks At 0% depth, the output amplitude is half of the selected value.
6 Modulation Commands [SOURce:]AM:STATe Syntax SOUR : AM :STAT space 0|OFF 1|ON ? [SOURce:]AM:STATe {0|OFF|1|ON} This command disables or enables the amplitude modulation. [SOURce:]AM:STATe? This query returns the amplitude modulation state as 0 if the modulation is disabled, or 1 if the modulation is enabled.
Modulation Commands 6 [SOURce:]FM:INTernal:FUNCtion Syntax SOUR : FM :INT :FUNC space SIN SQU RAMP NRAM TRI USER ? [SOURce:]FM:INTernal:FUNCtion {SINusoid|SQUare|RAMP|NRAMp| TRIangle|USER} This command sets the modulating waveform of the frequency modulation. The available modulating waveform types consist of sinusoid, square, ramp, negative ramp, triangle, and user- defined. [SOURce:]FM:INTernal:FUNCtion? This query returns the selected modulating waveform as SIN, SQU, RAMP, NRAM, TRI, or USER.
6 Modulation Commands Examples The following command sets the modulating waveform to Sine. FM:INT:FUNC SIN The following query returns the modulating waveform.
Modulation Commands 6 [SOURce:]FM:INTernal:FREQuency Syntax SOUR : FM :INT :FREQ space frequency ? [SOURce:]FM:INTernal:FREQuency This command sets the frequency of the modulating waveform. [SOURce:]FM:INTernal:FREQuency? This query returns the modulating frequency in Hz. Parameter Item Type Range of values Default value frequency Numeric 2 mHz to 20 kHz 100 Hz Examples The following command sets the modulating frequency to 500 Hz.
6 Modulation Commands [SOURce:]FM:DEViation Syntax SOUR : FM :DEV space peak deviation in Hz ? [SOURce:]FM:DEViation This command sets the peak frequency deviation in Hz. The deviation setting represents the peak variation in frequency of the modulated waveform from the carrier frequency. [SOURce:]FM:DEViation? This query returns the frequency deviation in Hz.
Modulation Commands 6 [SOURce:]FM:STATe Syntax SOUR : FM :STAT space 0|OFF 1|ON ? [SOURce:]FM:STATe {0|OFF|1|ON} This command disables or enables the frequency modulation. [SOURce:]FM:STATe? This query returns the frequency modulation state as 0 if the modulation is disabled, or 1 if the modulation is enabled.
6 Modulation Commands [SOURce:]PM:INTernal:FUNCtion Syntax SOUR : PM :INT :FUNC space SIN SQU RAMP NRAM TRI USER ? [SOURce:]PM:INTernal:FUNCtion {SINusoid|SQUare|RAMP|NRAMp| TRIangle|USER} This command sets the modulating waveform of the phase modulation. The available modulating waveform types consist of sinusoid, square, ramp, negative ramp, triangle, and user- defined. [SOURce:]PM:INTernal:FUNCtion? This query returns the selected modulating waveform as SIN, SQU, RAMP, NRAM, TRI, or USER.
Modulation Commands 6 Examples The following command sets the modulating waveform to Sine. PM:INT:FUNC SIN The following query returns the modulating waveform.
6 Modulation Commands [SOURce:]PM:INTernal:FREQuency Syntax SOUR : PM :INT :FREQ space frequency ? [SOURce:]PM:INTernal:FREQuency This command sets the frequency of the modulating waveform. [SOURce:]PM:INTernal:FREQuency? This query returns the modulating frequency in Hz. Parameter Item Type Range of values Default value frequency Numeric 2 mHz to 20 kHz 10 Hz Examples This command sets the modulating frequency to 500 Hz.
Modulation Commands 6 [SOURce:]PM:DEViation Syntax SOUR : PM :DEV space deviation in degrees ? [SOURce:]PM:DEViation This command sets the phase deviation in degrees. The deviation setting represents the peak variation in phase of the modulated waveform from the carrier waveform. [SOURce:]PM:DEViation? This query returns the phase deviation in degrees.
6 Modulation Commands [SOURce:]PM:STATe Syntax SOUR : PM :STAT space 0|OFF 1|ON ? [SOURce:]PM:STATe {0|OFF|1|ON} This command disables or enables the phase modulation. [SOURce:]PM:STATe? This query returns the phase modulation state as 0 if the modulation is disabled, and 1 if the modulation is enabled.
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 7 Shift Keying Commands [SOURce:]ASKey:INTernal:RATE 80 [SOURce:]ASKey:STATe 81 [SOURce:]FSKey:FREQuency 82 [SOURce:]FSKey:INTernal:RATE 83 [SOURce:]FSKey:STATe 84 [SOURce:]PSKey:DEViation 85 [SOURce:]PSKey:INTernal:RATE 86 [SOURce:]PSKey:STATe 87 This section describes the Shift keying commands used to perform shift keying modulations of the U2761A.
7 Shift Keying Commands [SOURce:]ASKey:INTernal:RATE Syntax SOUR : ASK :INT :RATE space rate in Hz ? [SOURce:]ASKey:INTernal:RATE This command sets the rate at which the output amplitude “shifts” between two preset amplitudes. [SOURce:]ASKey:INTernal:RATE? This query returns the amplitude-shift keying (ASK) rate in Hz. Parameter Item Type Range of values Default value rate Numeric 2 mHz to 100 kHz 10 Hz Remark The modulating waveform is a Square wave with a 50% duty cycle.
Shift Keying Commands 7 [SOURce:]ASKey:STATe Syntax SOUR : ASK :STAT space 0|OFF 1|ON ? [SOURce:]ASKey:STATe {0|OFF|1|ON} This command disables or enables the amplitude-shift keying (ASK) modulation. [SOURce:]ASKey:STATe? This query returns the ASK modulation state as 0 if the modulation is disabled, and 1 if the modulation is enabled.
7 Shift Keying Commands [SOURce:]FSKey:FREQuency Syntax SOUR : FSK :FREQ space frequency ? [SOURce:]FSKey:FREQuency This command sets the frequency-shift keying (FSK) alternate or “hop” frequency. [SOURce:]FSKey:FREQuency? This query returns the “hop” frequency in Hz.
Shift Keying Commands 7 [SOURce:]FSKey:INTernal:RATE Syntax SOUR : FSK :INT :RATE space rate in Hz ? [SOURce:]FSKey:INTernal:RATE The command sets the rate at which the output frequency “shifts” between the carrier frequency and “hop” frequency. [SOURce:]FSKey:INTernal:RATE? This query returns the frequency-shift keying (FSK) rate in Hz.
7 Shift Keying Commands [SOURce:]FSKey:STATe Syntax SOUR : FSK :STAT space 0|OFF 1|ON ? [SOURce:]FSKey:STATe {0|OFF|1|ON} This command disables or enables the frequency-shift keying (FSK) modulation. [SOURce:]FSKey:STATe? This query returns the FSK modulation state as 0 if the modulation is disabled, and 1 if the modulation is enabled.
Shift Keying Commands 7 [SOURce:]PSKey:DEViation Syntax SOUR : PSK :DEV space deviation in degrees ? [SOURce:]PSKey:DEViation This command sets the phase-shift keying (PSK) deviation in degrees. The deviation setting represents the phase variation of the shifted waveform from the carrier waveform. [SOURce:]PSKey:DEViation? This query returns the PSK deviation in degrees.
7 Shift Keying Commands [SOURce:]PSKey:INTernal:RATE Syntax SOUR : PSK :INT :RATE space rate in Hz ? [SOURce:]PSKey:INTernal:RATE This command sets the rate at which the output phase “shifts” between two preset phases. [SOURce:]PSKey:INTernal:RATE? This query returns the phase-shift keying (PSK) rate in Hz. Parameter Item Type Range of values Default value rate Numeric 2 mHz to 100 kHz 10 Hz Remark The modulating waveform is a Square wave with a 50% duty cycle.
Shift Keying Commands 7 [SOURce:]PSKey:STATe Syntax SOUR : PSK :STAT space 0|OFF 1|ON ? [SOURce:]PSKey:STATe {0|OFF|1|ON} This command disables or enables the phase-shift keying (PSK) modulation. [SOURce:]PSKey:STATe? This query returns the PSK modulation state as 0 if the modulation is disabled, and 1 if the modulation is enabled.
7 88 Shift Keying Commands U2761A Programmer’s Reference
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 8 Frequency Sweep Commands [SOURce:]FREQuency:STARt 90 [SOURce:]FREQuency:STOP 91 [SOURce:]SWEep:SPACing 92 [SOURce:]SWEep:TIME 93 [SOURce:]SWEep:STATe 94 This section describes the Frequency sweep commands used to configure the sweep settings of the U2761A. These commands allow you to set the start and stop frequency values, sweep spacing, sweep time, and sweep state.
8 Frequency Sweep Commands [SOURce:]FREQuency:STARt Syntax SOUR : FREQ :STAR space frequency ? [SOURce:]FREQuency:STARt This command sets the start frequency. [SOURce:]FREQuency:STARt? This query returns the start frequency in Hz. Parameter Item Type Range of values Default value frequency Numeric • 1 μHz to 20 MHz (for sine and square) • 1 μHz to 200 kHz (for ramp and arbitrary) 100 Hz Examples The following command sets the start frequency to 500 Hz.
Frequency Sweep Commands 8 [SOURce:]FREQuency:STOP Syntax SOUR : FREQ :STOP space frequency ? [SOURce:]FREQuency:STOP This command sets the stop frequency. [SOURce:]FREQuency:STOP? This query returns the stop frequency in Hz. Parameter Item Type Range of values Default value frequency Numeric • 1 μHz to 20 MHz (for sine and square) • 1 μHz to 200 kHz (for ramp and arbitrary) 1 kHz Examples The following command sets the stop frequency to 10 kHz.
8 Frequency Sweep Commands [SOURce:]SWEep:SPACing Syntax SOUR : SWE :SPAC space LIN LOG ? [SOURce:]SWEep:SPACing {LINear|LOGarithmic} This command sets either the linear or logarithmic spacing for the sweep. [SOURce:]SWEep:SPACing? This query returns the selected spacing as LIN or LOG. Parameter Item Type Range of values Default value spacing Discrete LINear or LOGarithmic LINear Examples The following command sets the sweep spacing to linear.
Frequency Sweep Commands 8 [SOURce:]SWEep:TIME Syntax SOUR : SWE :TIME space seconds ? [SOURce:]SWEep:TIME This command sets the number of seconds required to sweep from the start frequency to the stop frequency. [SOURce:]SWEep:TIME? This query returns the sweep time in seconds.
8 Frequency Sweep Commands [SOURce:]SWEep:STATe Syntax SOUR : SWE :STAT space 0|OFF 1|ON ? [SOURce:]SWEep:STATe {0|OFF|1|ON} This command disables or enables the sweep mode. [SOURce:]SWEep:STATe? This query returns the sweep state as 0 if the sweep mode is disabled, or 1 if the sweep mode is enabled. Parameter Item Type Range of values Default value state Boolean 0|OFF|1|ON 0 Remark The U2761A does not allow the sweep mode to be enabled at the same time that any modulation mode is enabled.
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 9 Triggering Commands TRIGger[:SEQuence]:SOURce 96 TRIGger[:SEQuence][:IMMediate] 98 TRIGger[:SEQuence]:SLOPe 99 OUTPut:TRIGger:SLOPe 100 OUTPut:TRIGger[:STATe] 102 This section describes the Triggering commands used to control the trigger functions of the U2761A. These commands allow you to configure the trigger source, trigger slope, and trigger output state, as well as enable you to trigger a sweep.
9 Triggering Commands TRIGger[:SEQuence]:SOURce Syntax TRIG :SEQ :SOUR space IMM EXT BUS STRG ? TRIGger[:SEQuence]:SOURce {IMMediate|EXTernal|BUS|STRG} This command sets the source from which the U2761A will accept a trigger. • When the Immediate (internal) source is selected, the U2761A outputs continuously when the sweep mode is enabled. • When the External source is selected, the U2761A accepts a hardware trigger applied to the Trig In connector.
Triggering Commands 9 Examples The following command sets the trigger source to Immediate. TRIG:SOUR IMM The following query returns the trigger source.
9 Triggering Commands TRIGger[:SEQuence][:IMMediate] Syntax TRIG :SEQ :IMM TRIGger[:SEQuence][:IMMediate] This command triggers a sweep from the remote interface. This command can be used with any of the available trigger sources. Example The following command triggers a sweep.
Triggering Commands 9 TRIGger[:SEQuence]:SLOPe Syntax TRIG :SEQ :SLOP space POS NEG ? TRIGger[:SEQuence]:SLOPe {POSitive|NEGative} This command sets the rising or falling edge for the trigger signal on the Trig In connector to start the sweep. TRIGger[:SEQuence]:SLOPe? This query returns the selected trigger slope as POS or NEG. Parameter Item Type Range of values Default value slope Discrete POSitive|NEGative POSitive Examples The following command sets the trigger slope to Positive.
9 Triggering Commands OUTPut:TRIGger:SLOPe Syntax OUTP :TRIG :SLOP space POS NEG ? OUTPut:TRIGger:SLOPe {POSitive|NEGative} This command sets the rising or falling edge for the “trigger out” signal at the beginning of the sweep. When enabled using the OUTPut:TRIGger[:STATe] command, a TTL- compatible Square waveform with the specified edge is output from the Trig Out connector at the beginning of the sweep. OUTPut:TRIGger:SLOPe? This query returns the selected trigger slope as POS or NEG.
Triggering Commands 9 Examples The following command sets the trigger slope to Positive. OUTP:TRIG:SLOP POS The following query returns the trigger slope.
9 Triggering Commands OUTPut:TRIGger[:STATe] Syntax OUTP :TRIG :STAT space 0|OFF 1|ON ? OUTPut:TRIGger[:STATe] {0|OFF|1|ON} This command disables or enables the “trigger out” signal on the Trig Out connector. When enabled, a TTL- compatible Square waveform with the specified edge is output from the Trig Out connector at the beginning of the sweep. OUTPut:TRIGger[:STATe]? This query returns the trigger output state as 0 if the “trigger out” signal is disabled, or 1 if the signal is enabled.
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 10 Arbitrary Waveform Commands DATA:DAC VOLATILE 104 FORMat:BORDer 106 DATA:ATTRibute:AVERage? 107 DATA:ATTRibute:CFACtor? 108 DATA:ATTRibute:POINts? 109 DATA:ATTRibute:PTPeak? 110 This section describes the Arbitrary waveform commands used to configure the user- defined Arbitrary waveforms for the U2761A. These commands allow you to download the arbitrary data and configure the byte order format.
10 Arbitrary Waveform Commands DATA:DAC VOLATILE Syntax DATA :DAC VOLATILE , space binary block value , value , ... DATA:DAC VOLATILE, {|, , . . . } This command downloads the arbitrary data in binary block or decimal integer values from –8191 to +8191 into volatile memory. You can download from 1 point (a DC signal) to 65536 (64K) points per waveform in IEEE- 488.2 binary block format or as a list of values.
Arbitrary Waveform Commands 10 • In the IEEE- 488.2 binary block format, a block header precedes the waveform data. The block header has the following format: # Start of data block 5 32768 Number of digits to follow Even number of bytes to follow (32768 bytes = 16384 points) The U2761A represents binary data as 16- bit integers, which are sent as two bytes. Therefore, the total number of bytes is always twice the number of data points in the waveform (and must always be an even number).
10 Arbitrary Waveform Commands FORMat:BORDer Syntax FORM :BORD space NORM SWAP ? FORMat:BORDer {NORMal|SWAPped} This command sets the byte order format for binary block downloads. For the Normal byte order, the most significant byte (MSB) of each data point is assumed first. For the Swapped byte order, the least significant byte (LSB) of each data point is assumed first. FORMat:BORDer? This query returns the selected byte order format as NORM or SWAP.
Arbitrary Waveform Commands 10 DATA:ATTRibute:AVERage? Syntax DATA :ATTR :AVER ? DATA:ATTRibute:AVERage? This query returns the arithmetic average of all data points for the Arbitrary waveform. Example The following query returns the average of the data points. DATA:ATTR:AVER? Typical response: +0.
10 Arbitrary Waveform Commands DATA:ATTRibute:CFACtor? Syntax DATA :ATTR :CFAC ? DATA:ATTRibute:CFACtor? This query returns the crest factor of all data points for the Arbitrary waveform. Remarks Crest factor is the ratio of a signal peak value to its RMS value and will differ according to waveshape. The crest factor can be computed as follows: Crest factor = Vpeak / Vrms The typical crest factor values for several common waveforms are stated in the following table: Waveform Crest factor Sine 1.
Arbitrary Waveform Commands 10 DATA:ATTRibute:POINts? Syntax DATA :ATTR :POIN ? DATA:ATTRibute:POINts? This query returns the number of points for the Arbitrary waveform from 1 to 65536 points. Example The following query returns the points for the Arbitrary waveform. DATA:ATTR:POIN? Typical response: +4.
10 Arbitrary Waveform Commands DATA:ATTRibute:PTPeak? Syntax DATA :ATTR :PTP ? DATA:ATTRibute:PTPeak? This query returns the peak-to-peak value of all data points for the Arbitrary waveform from “0” to “16382”, with “16382” indicating full amplitude available. Example The following query returns the peak- to- peak value of the data points. DATA:ATTR:PTP? Typical response: +1.
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 11 SYSTem Commands SYSTem:CDEScription? 112 SYSTem:ERRor? 113 SYSTem:VERSion? 114 This section provides the system- related information such as error conditions and chassis identity. This information is not directly related to waveform generation but is an important part of the U2761A system.
11 SYSTem Commands SYSTem:CDEScription? Syntax SYST :CDES ? SYSTem:CDEScription? This query identifies which slot and chassis that the U2761A is plugged into the U2781A modular instrument chassis, and returns the slot and chassis number respectively. Remarks • If the U2761A is in standalone mode, then this query would return +7,+0. • Refer to the U2781A Modular Instrument Chassis User's Guide for details.
SYSTem Commands 11 SYSTem:ERRor? Syntax SYST :ERR ? SYSTem:ERRor? This query returns the next error number and its corresponding message string from the error queue. The queue is a first-in, first-out (FIFO) buffer that stores errors as they occur. Errors are cleared as you read them. Remarks • If more than 20 errors have occurred, the last error stored in the queue (the most recent error) is replaced with –350,"Queue overflow".
11 SYSTem Commands SYSTem:VERSion? Syntax SYST :VERS ? SYSTem:VERSion? This query returns the SCPI standard version with which the U2761A is in compliance. The response format is in the form of YYYY.V, where YYYY represents the year of the version and V represents the version number for that year. Example The following query returns the SCPI version. SYST:VERS? Typical response: 1997.
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 12 Phase-Lock Commands [SOURce:]PHASe:SOURce 116 [SOURce:]PHASe[:ADJust] 117 UNIT:ANGLe 118 [SOURce:]PHASe:REFerence 119 [SOURce:]PHASe:UNLock:ERRor[:STATe] 120 OUTPut:PHASe[:STATe] 121 This section describes the Phase-lock commands used to configure the phase- lock settings of the U2761A.
12 Phase-Lock Commands [SOURce:]PHASe:SOURce Syntax SOUR : PHAS :SOUR space INT EXT CCG ? [SOURce:]PHASe:SOURce {INTernal|EXTernal|CCG} This command sets the phase source to synchronize the output waveform. Chassis reference clock (CCG) is the synchronized phase source from the U2781A modular instrument chassis. [SOURce:]PHASe:SOURce? This query returns the selected phase source as INT, EXT, or CCG.
Phase-Lock Commands 12 [SOURce:]PHASe[:ADJust] Syntax SOUR : PHAS :ADJ space angle ? [SOURce:]PHASe[:ADJust] This command adjusts the phase offset of the output waveform in degrees or radians as specified by the UNIT:ANGLe command. [SOURce:]PHASe[:ADJust]? This query returns the adjusted phase offset in the specified unit.
12 Phase-Lock Commands UNIT:ANGLe Syntax UNIT :ANGL space DEG RAD ? UNIT:ANGLe {DEGree|RADian} This command sets either degrees or radians for the phase offset value. UNIT:ANGLe? This query returns the selected unit as DEG or RAD. Parameter Item Type Range of values Default value unit Discrete DEGree|RADian DEGree Examples The following command sets the phase offset unit to degrees. UNIT:ANGL DEG The following query returns the phase offset unit.
Phase-Lock Commands 12 [SOURce:]PHASe:REFerence Syntax SOUR : PHAS :REF [SOURce:]PHASe:REFerence This command immediately sets the zero-phase reference point without changing the output of the U2761A. This command resets the phase offset value returned by the [SOURce:]PHASe[:ADJust] command but does not affect the output waveform. Example The following command sets the zero-phase reference point.
12 Phase-Lock Commands [SOURce:]PHASe:UNLock:ERRor[:STATe] Syntax SOUR : PHAS :UNL :ERR :STAT space 0|OFF 1|ON ? [SOURce:]PHASe:UNLock:ERRor[:STATe] {0|OFF|1|ON} This command disables or enables the U2761A to generate an error if the phase-lock is ever lost. [SOURce:]PHASe:UNLock:ERRor[:STATe]? This query returns the phase-lock error state as 0 if disabled, or 1 if enabled.
Phase-Lock Commands 12 OUTPut:PHASe[:STATe] Syntax OUTP :PHAS :STAT space 0|OFF 1|ON ? OUTPut:PHASe[:STATe] {0|OFF|1|ON} This command disables or enables the 10 MHz reference phase output. OUTPut:PHASe[:STATe]? This query returns the phase output state as 0 if the output is disabled, or 1 if the output is enabled. Parameter Item Type Range of values Default value state Boolean 0|OFF|1|ON 0 Examples The following command enables the phase output.
12 122 Phase-Lock Commands U2761A Programmer’s Reference
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 13 Status Reporting Commands STATus:PRESet 124 STATus:QUEStionable:CONDition? 125 STATus:QUEStionable:ENABle 126 STATus:QUEStionable[:EVENt]? 128 This section describes the Status reporting commands used to determine the operating condition of the U2761A at any time. Refer to Chapter 1, “SCPI Status System” on page 11 for more information on the status registers.
13 Status Reporting Commands STATus:PRESet Syntax STAT :PRES STATus:PRESet This command clears all bits in the Questionable Data enable register. Example The following command presets the Questionable enable register.
Status Reporting Commands 13 STATus:QUEStionable:CONDition? Syntax STAT :QUES :COND ? STATus:QUEStionable:CONDition? This query returns the binary-weighted sum of all bits set in the Questionable Data condition register. The condition register is a read-only register, which holds the live (unlatched) questionable status of the instrument. The bits are not cleared when you read the register.
13 Status Reporting Commands STATus:QUEStionable:ENABle Syntax STAT :QUES :ENAB space value STATus:QUEStionable:ENABle This command enables the bits in the Questionable Data enable register. The selected bits are then reported to the Status Byte register. The enable register is a mask for enabling specific bits from the Questionable event register to set the questionable summary bit (QUES) of the Status Byte register.
Status Reporting Commands 13 Examples The following command enables bit 4 (decimal value = 16) in the enable register. STAT:QUES:ENAB 16 The following query returns the bit enabled in the register.
13 Status Reporting Commands STATus:QUEStionable[:EVENt]? Syntax STAT :QUES :EVEN ? STATus:QUEStionable[:EVENt]? This query returns the binary-weighted sum of all bits set in the Questionable Data event register. This is a read- only register and the bits are cleared when you read the register. Remarks • Once a bit is set, it remains set until cleared by reading the event register or the clear status (*CLS) command.
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 14 CALibration Commands CALibration:SECure:STATe 130 CALibration:SECure:CODE 131 CALibration:SETup 132 CALibration:VALue 133 CALibration:COUNt? 134 CALibration:STRing 135 This section describes the Calibration commands used to configure the calibration settings for the U2761A.
14 CALibration Commands CALibration:SECure:STATe Syntax CAL :SEC :STAT space OFF , code ON RESET CALibration:SECure:STATe {OFF|ON|RESET}, This command unsecures or secures the U2761A for calibration. If you forget your security code, you can reset the code by specifying U2761A. CALibration:SECure:STATe? This query returns the security state as 0 (OFF) if the U2761A is unsecured, or 1 (ON) if secured.
CALibration Commands 14 CALibration:SECure:CODE Syntax CAL :SEC :CODE space new code CALibration:SECure:CODE This command inputs a new security code. To change the security code, you must first unsecure the U2761A using the old security code, and then enter a new code. The security code is stored in nonvolatile memory.
14 CALibration Commands CALibration:SETup Syntax CAL :SET space 1 2 3 ... 115 ? CALibration:SETup <1|2|3| . . . |115> This command configures the U2761A internal state for each of the calibration steps to be performed. Before any calibration step is performed for the U2761A, the default setup is 0. CALibration:SETup? This query reads the calibration setup number and returns a value from 1 to 115.
CALibration Commands 14 CALibration:VALue Syntax CAL :VAL space value ? CALibration:VALue This command specifies the measured value of the known calibration signal depending on the calibration steps. CALibration:VALue? This query returns the calibration value. NOTE Refer to the Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Service Guide for the range of values of each calibration step. Examples The following command sets the value to 1×107.
14 CALibration Commands CALibration:COUNt? Syntax CAL :COUN ? CALibration:COUNt? This query determines the number of times the U2761A has been calibrated, where the count number is incremented by one for each calibration step. The calibration count is stored in nonvolatile memory. NOTE Ensure that your U2761A has been calibrated before it leaves the factory. When you receive your U2761A from the factory, be sure to read the count to determine its initial value.
CALibration Commands 14 CALibration:STRing Syntax CAL :STR space quoted string ? CALibration:STRing This command stores a message in nonvolatile calibration memory. Storing a message will overwrite any message previously stored in memory. CALibration:STRing? This query reads the calibration message and returns a quoted string.
14 136 CALibration Commands U2761A Programmer’s Reference
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 15 CONFigure Command CONFigure:SSI 138 The CONFigure:SSI command handles the synchronization status when the U2761A is used in the U2781A modular instrument chassis.
15 CONFigure Command CONFigure:SSI Syntax CONF :SSI space NONE , ( @address , address ) MAST SLAV CONFigure:SSI {NONE|MASTer|SLAVe}, (@
[,]) This command sets the synchronization status (master/slave) when used in the U2781A modular instrument chassis. The master/slave mode forces the U2761A trigger source to Simultaneous Synchronization Interface (SSI). This command is only operational when used in the U2781A chassis.CONFigure Command 15 Examples The following example sets one U2761A unit to master and one U2761A unit to slave. U2781A Trigger bus 0 1 2 3 4 5 6 7 U2761A Master U2761A Slave (Unit 1) (Unit 2) For Unit 1: CONF:SSI MAST, (@0) For Unit 2: CONF:SSI SLAV, (@0) The following queries return the status and address.
15 140 CONFigure Command U2761A Programmer’s Reference
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 16 Error Messages Error Messages 142 Command errors 142 Execution errors 144 Device-dependent errors 151 Query errors 152 Instrument errors 152 Self-test errors 153 Calibration errors 153 Arbitrary waveform errors 155 The U2761A SCPI command errors are summarized in this chapter.
16 Error Messages Error Messages Error messages are created once an erroneous condition has been detected. • Errors are retrieved in first- in- first- out (FIFO) order using the SYSTem:ERRor? command. The first error returned is the first error that was stored. Errors are cleared as you retrieve them. • If more than 20 errors have occurred, the last error stored in the queue (the most recent error) is replaced with –350,"Queue overflow".
Error Messages 16 Table 16-1 Command errors (continued) –108 Parameter not allowed More parameters were received than were expected for the command. You may have entered an extra parameter or added a parameter to a command that does not require a parameter. –109 Missing parameter Fewer parameters were received than were expected for this command. You have omitted one or more parameters that are required for this command.
16 Error Messages Table 16-1 Command errors (continued) –158 String data not allowed A character string was received, but is not allowed for this command –161 Invalid block data The number of data bytes sent does not match the number of bytes specified in the header –168 Block data not allowed Data was sent in the arbitrary block format but is not allowed for this command –170 to –178 Expression errors The U2761A does not accept mathematical expressions Execution errors The execution errors are li
Error Messages 16 Table 16-2 Execution errors (continued) –221 Settings conflict; frequency reduced for user function When you change to the arbitrary function (output frequency limit is 200 kHz) from a function that allows a higher frequency, the U2761A will automatically adjust the frequency to 200 kHz –221 Settings conflict; frequency forced duty cycle change If the Square wave function is selected and you change to a frequency that cannot produce the current duty cycle, the duty cycle is automatica
16 Error Messages Table 16-2 Execution errors (continued) –221 Settings conflict; pulse width increased due to large period The U2761A has adjusted the pulse width to the new minimum determined by the current period –221 Settings conflict; pulse width decreased due to period The U2761A has decreased the pulse width to accommodate the specified period –221 Settings conflict; FSK hopping frequency changed due to function The FSK hopping frequency is greater than the maximum frequency of the switched fu
Error Messages 16 Table 16-2 Execution errors (continued) –221 Settings conflict; PSK turned off by selection of other mode or modulation The U2761A will allow only one modulation or sweep mode to be enabled at the same time –221 Settings conflict; sweep turned off by selection of other mode or modulation The U2761A will allow only one modulation or sweep mode to be enabled at the same time –221 Settings conflict; 10MHz reference connector used by phase output If you have enabled the output 10 MHz re
16 Error Messages Table 16-2 Execution errors (continued) –222 Data out of range; amplitude; value clipped to upper limit The waveform amplitude has been limited to an upper boundary –222 Data out of range; offset; value clipped to lower limit The offset voltage has been limited to a lower boundary –222 Data out of range; offset; value clipped to upper limit The offset voltage has been limited to an upper boundary –222 Data out of range; HIGH value; value clipped to lower limit The high voltage has
Error Messages 16 Table 16-2 Execution errors (continued) –222 Data out of range; load; value clipped to upper limit The output load is limited to an upper boundary of 10 kΩ by the U2761A hardware –222 Data out of range; pulse period; value clipped to lower limit The pulse period has been limited to a lower boundary –222 Data out of range; pulse period; value clipped to upper limit The pulse period has been limited to an upper boundary –222 Data out of range; pulse width; value clipped to lower lim
16 Error Messages Table 16-2 Execution errors (continued) –222 Data out of range; FM deviation limited by maximum frequency The frequency deviation is limited to the upper limit –222 Data out of range; PM deviation; value clipped to lower limit The phase deviation is limited to the lower limit by the current function phase –222 Data out of range; PM deviation; value clipped to upper limit The phase deviation is limited to the upper limit by the current function phase –222 Data out of range; shift k
Error Messages 16 Table 16-2 Execution errors (continued) –222 Data out of range; phase offset; value clipped to lower limit The phase offset is limited to the lower limit by the U2761A hardware –222 Data out of range; phase offset; value clipped to upper limit The phase offset is limited to the upper limit by the U2761A hardware Device-dependent errors The table below contains the device-dependent errors.
16 Error Messages Query errors The list of query errors is shown in the following table.
Error Messages 16 Self-test errors The table below shows the self- test errors.
16 Error Messages Table 16-7 Calibration errors (continued) 708 Calibration error; perform setting is not allowed The calibration setting was predetermined by calibration setup and modification to the setting is not allowed 755 Calibration error; timebase calibration is not completed The timebase calibration steps have not fully completed before exiting calibration mode 756 Calibration error; DC offset calibration is not completed The DC offset calibration steps have not fully completed before exitin
Error Messages 16 Arbitrary waveform errors The table below shows the Arbitrary waveform errors. Table 16-8 Arbitrary waveform errors Error number Arbitrary waveform errors 770 Volatile arb waveform memory corruption detected The volatile memory used to store the Arbitrary waveforms has detected a checksum error. The Arbitrary waveform cannot be retrieved from memory.
16 156 Error Messages U2761A Programmer’s Reference
Agilent U2761A USB Modular Function/Arbitrary Waveform Generator Programmer’s Reference 17 Factory Default Settings The factory default settings are listed in this chapter.
17 Factory Default Settings The factory default settings in the following table are used when the U2761A is powered on. Sending the *RST command will reset the U2761A to its factory default state. Table 17-1 Factory default settings Features Factory default settings Output configuration Function Sine wave Frequency 1 kHz Amplitude 1 Vpp Offset 0V Voltage (High/Low) 0.5 V/–0.
Factory Default Settings 17 Table 17-1 Factory default settings (continued) Features Factory default settings FM deviation 100 Hz PM deviation 180 ° Modulation state Off Shift keying modulation Carrier waveform (ASK, FSK, PSK) 1 kHz Sine wave Rate (ASK, FSK, PSK) 10 Hz FSK hop frequency 100 Hz PSK deviation 180 ° Shift keying state Off Frequency sweep Start/Stop frequency 100 Hz/1 kHz Sweep spacing Linear Sweep time 1s Sweep state Off Trigger Source Immediate Trigger slope Pos
17 Factory Default Settings Table 17-1 Factory default settings (continued) Features Factory default settings Phase output state Off Calibration Calibration security state On Calibration security code U2761A Calibration setup number 0 Configure SSI state 160 None U2761A Programmer’s Reference
www.agilent.