Agilent B2900 Series Precision Source/Measure Unit SCPI Command Reference Agilent Technologies
Notices © Agilent Technologies, Inc. 2011 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.
In This Manual This manual contains reference information to help you program the Agilent B2900 Source/Measure Unit series over the remote interface using the SCPI programming language. The Agilent B2900 supports the SCPI programming language on all of its remote I/O interfaces. • Chapter 1, “Programming Basics.
Contents 1. Programming Basics SCPI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Multiple Commands in a Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Moving Between Subsystems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Including Common Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Using Queries .
Contents Source Output Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-24 Measurement Ranges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-27 Controlling Source/Measure Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29 Reading Source/Measure Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-37 Using Advanced Functions. . .
Contents :CALCulate:CLIMits:CLEar:AUTO:DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3 :CALCulate:CLIMits:CLEar[:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4 :CALCulate:CLIMits::DIGital[:DATA] . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4 :CALCulate:CLIMits:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5 :CALCulate:CLIMits:STATe . . . . . . . . . . . . . . . . . . . .
Contents DISPlay Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23 :DISPlay:CSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23 :DISPlay:DIGits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23 :DISPlay:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Other LXI Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-40 LXI Trigger Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-42 MEASure Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44 :MEASure?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents :OUTPut:RECall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59 :OUTPut:SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59 :OUTPut[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-60 PROGram Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents :SENSe::RANGe:AUTO:LLIMit . . . . 4-78 :SENSe::RANGe:AUTO:MODE . . . . . . . . . . . . . . . 4-79 :SENSe::RANGe:AUTO:THReshold . . . . . . . . . . . 4-80 :SENSe::RANGe:AUTO:ULIMit . . . . 4-80 :SENSe::RANGe[:UPPer]. . . . . . . . . 4-81 :SENSe:DATA?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents [:SOURce]::RANGe:AUTO:LLIMit . . . . . . . . . . . . . . . . . . . . . 4-96 [:SOURce]:: . . . . . . . . . . . . . . . . . . . . . . . . . 4-97 [:SOURce]::STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-98 [:SOURce]:DIGital:DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-99 [:SOURce]:DIGital:EXTernal[n]:FUNCtion . . . . . . . . . . . . . . . . . . . . . . . .
Contents :STATus::CONDition? . . . . . . . . . . 4-115 :STATus::ENABle. . . . . . . . . . . . . . 4-118 :STATus:[:EVENt]?. . . . . . . . . . . . . 4-118 :STATus::NTRansition . . . . . . . . . . 4-119 :STATus::PTRansition . . . . . . . . . . 4-120 :STATus:PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents :SYSTem:COMMunicate:LAN:UPDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-133 :SYSTem:COMMunicate:LAN:WINS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-134 :SYSTem:DATA:QUANtity? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-134 :SYSTem:DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-135 :SYSTem:ERRor:ALL?. . . . . . . . . . . . . . . . .
Contents :TRACe:FEED:CONTrol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-146 :TRACe:FREE? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-147 :TRACe:POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-147 :TRACe:POINts:ACTual? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents No Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Command Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4 Execution Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8 Device-Dependent Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 Programming Basics
Programming Basics This chapter describes a basic information for programming Agilent B2900, and consists of the following sections.
Programming Basics SCPI Commands SCPI Commands SCPI (Standard Commands for Programmable Instruments) is a programming language for controlling test and measurement instruments. SCPI provides instrument control with a standardized command syntax and style, as well as a standardized data interchange format. SCPI has two types of commands, common and subsystem. • Common commands Common commands are defined by the IEEE 488.
Programming Basics SCPI Commands • Use a semicolon to separate commands within a message. • There is an implied header path that affects how commands are interpreted by the instrument. The header path can be thought of as a string that is inserted before each command within a message. For the first command in a message, the header path is a null string.
Programming Basics SCPI Commands Including Common Commands You can combine common commands and subsystem commands into a single message. Treat the common command as a message unit by separating it with a semicolon (the message unit separator). Common commands do not affect the header path; you may insert them anywhere in the message. OUTPut OFF;*RCL 1;OUTPut ON Using Queries Observe the following precautions when using queries.
Programming Basics SCPI Messages SCPI Messages There are two types of SCPI messages, program and response. • A program message consists of one or more properly formatted SCPI commands sent from the controller to the instrument. The message, which may be sent at any time, requests the instrument to perform some action. • A response message consists of data in a specific SCPI format sent from the instrument to the controller.
Programming Basics SCPI Messages *RST VOLTage 20 Message Unit Separator When two or more message units are combined into a compound message, separate the units with semicolons. STATus:OPERation?;QUEStionable? Root Specifier When it precedes the first header of a message unit, a colon is interpreted as a root specifier. It tells the command parser that this is the root or the top node of the command tree.
Programming Basics SCPI Messages Numeric Suffix All command headers can be accompanied by a numeric suffix for differentiating multiple instances of the same structure, i.e. for multi-channel instruments. The numeric suffix can be appended to both long and short forms. For example, TRIG1 is the short form of TRIGger1. A numeric suffix of 1 is implied on all command headers that do not explicitly define a suffix; thus, TRIG is equivalent to TRIG1.
Programming Basics SCPI Command Completion SCPI Command Completion SCPI commands sent to the instrument are processed either sequentially or in parallel. Sequential commands finish execution before the subsequent command is started. Parallel commands allow other commands to begin executing while the parallel command is still executing. The *WAI, *OPC, and *OPC? common commands provide different ways of indicating when all transmitted commands, including any parallel ones, have completed their operations.
Programming Basics SCPI Conventions and Data Formats SCPI Conventions and Data Formats The SCPI conventions shown in Table 1-1 are used throughout this document. Data programmed or queried from the instrument is coded in ASCII. The data may contain numeric values or character strings. Table 1-1 SCPI Conventions and Data Formats Convention Description Angle brackets < > Items within angle brackets are parameter abbreviations. For example, indicates a specific form of numerical data.
Programming Basics SCPI Conventions and Data Formats Convention Description Expanded decimal format that includes , MIN, and MAX. Examples: 273, 27.3, 2.73E+02, MAX. MIN and MAX are the minimum and maximum limit values that are implicit in the range specification for the parameter. Non-decimal numeric value. May also be represented in binary preceded by “#B”, octal preceded by “#Q”, or hexadecimal preceded by “#H”.
Programming Basics Data Output Format Data Output Format B2900 supports the following data output formats for sending the result data. The data contains all of the elements specified by the :FORMat:ELEMents:SENSe or :FORMat:ELEMents:CALCulate command. Available elements are voltage measurement data, current measurement data, resistance measurement data, calculation result data, time data, status data, and source output setting data. A terminator (0x0a, 1 byte) is attached to the end of each data.
Programming Basics Data Output Format terminator (1 byte). An 8-byte data is used for each data element. Each element consists of a fraction (bits 0 (LSB) to 51), exponent (bits 52 to 62), and sign (bit 63). Order of bytes set by :FORMat:BORDer NORMal (default): byte 1 to 8 Order of bytes set by :FORMat:BORDer SWAPped: byte 8 to 1 NaN indicates “not a number”. +infinity indicates positive infinity. -infinity indicates negative infinity.
Programming Basics Data Output Format Table 1-2 Bit Definitions of Status Data Bit 0 Description 0: Voltage source Decimal value 0 or 1 1: Current source 1 and 2 Compliance condition 0, 2, 4, or 6 0: No or 1, 2, 3: Yes 3 Over voltage condition 0 or 8 0: No or 1: Yes 4 Over current condition 0 or 16 0: No or 1: Yes 5 High temperature condition 0 or 32 0: No or 1: Yes 13 Measurement range overflow 0 or 8192 0: No or 1: Yes 14 Offset compensation enable condition 0 or 16384 0: No or 1: Y
Programming Basics Data Output Format Table 1-3 Composite Limit Test Result Bit Definitions for Sorting Mode Bit20 Bit19 Bit18 Bit17 Bit16 Result 0 0 0 0 1 Limit 1: Passed limit test or failed compliance test 0 0 0 1 0 Limit 2: Passed limit test or failed compliance test 0 0 0 1 1 Limit 3: Passed limit test or failed compliance test 0 0 1 0 0 Limit 4: Passed limit test or failed compliance test 0 0 1 0 1 Limit 5: Passed limit test or failed compliance test 0 0 1 1
Programming Basics Data Output Format Table 1-4 Composite Limit Test Result Bit Definitions for Grading Mode Bit20 Bit19 Bit18 Bit17 Bit16 0 0 0 0 0 Passed all limit tests 1 0 0 0 1 Limit 1: Failed upper limit 0 0 0 0 1 Limit 1: Failed lower limit or failed compliance test 1 0 0 1 0 Limit 2: Failed upper limit 0 0 0 1 0 Limit 2: Failed lower limit or failed compliance test 1 0 0 1 1 Limit 3: Failed upper limit 0 0 0 1 1 Limit 3: Failed lower limit or failed c
Programming Basics GPIB Capability GPIB Capability The following table lists the GPIB capabilities and functions of the B2900. These functions provide the means for an instrument to receive, process, and transmit, commands, data, and status over the GPIB bus.
Programming Basics Status Byte Status Byte Status byte bits are turned off or on (0 or 1) to represent the instrument operation status. When you execute a serial poll, an external computer (controller) reads the contents of the status byte, and responds accordingly. When an unmasked status bit is set to “1”, the instrument sends an SRQ to the controller, causing the controller to perform an interrupt service routine.
Programming Basics Status System Diagram Status System Diagram Figure 1-1 • Figure 1-1, “B2900 Status System Overview.” • Figure 1-2, “Measurement Status register.” • Figure 1-3, “Questionable Status register.” • Figure 1-4, “Standard Event Status register.” • Figure 1-5, “Operation Status register.
Programming Basics Status System Diagram Figure 1-2 Measurement Status register Measurement Status C T 0 1 2 3 4 0 1 5 6 7 8 9 10 11 12 13 14 15 2 3 4 5 6 7 8 9 10 11 12 EV EN Ch1 Limit Summary Ch1 Reading Available Ch1 Reading Overflow Ch1 Buffer Available Ch1 Buffer Full 0 <1 > <2 > 4 5 < 16 > < 32 > Ch2 Limit Summary Ch2 Reading Available Ch2 Reading Overflow Ch2 Buffer Available Ch2 Buffer Full 6 7 8 < 64 > < 128 > 13 14 15 1 2 3 <4 > <8 > < 256 > < 512 > 9 10 11 < 1024 > < 2048 >
Programming Basics Status System Diagram Figure 1-3 Questionable Status register Channel 1 Channel 2 0 1 2 3 … Notes: C = Condition register T = Transition filter EV = Event register EN = Enable register 13 14 15 Questionable Status :STAT :QUES :VOLT ? :STAT :QUES :CURR ? (Same as Voltage Summary ) :STAT :QUES :TEMP ? (Same as Voltage Summary ) :STAT :QUES :CAL ? (Same as Voltage Summary ) :STAT :QUES :TEST ? (Same as Voltage Summary ) C T 0 1 2 3 0 1 2 3 4 4 5 6 7 8 9 10 11 12 13 14 15 :STAT
Programming Basics Status System Diagram Figure 1-4 Standard Event Status register Standard Event Status EV EN Operation Complete 0 1 <1 > <2 > Query Error Device Error Execution Error Command Error 2 3 <4 > <8 > < 16 > < 32 > 4 5 6 7 Power On *ESR ? Figure 1-5 < 64 > < 128 > *ESE *ESE ? Notes: C = Condition register T = Transition filter EV = Event register EN = Enable register Operation Status register Operation Status C T 0 0 1 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 2 3 4 5 6 7
Programming Basics Non-Volatile Settings Non-Volatile Settings The following tables show the factory-shipped non-volatile settings of the instrument. Information in non-volatile memory is NOT lost when power is turned off. These settings are all customer-configurable. Table 1-5 Non-volatile Communication Settings Setup item Factory default setting DHCP Enabled IP address 169.254.5.2 Subnet mask 255.255.0.0 Default gateway 0.0.0.0 Obtain DNS server from DHCP Enabled DNS server 0.0.0.
Programming Basics Non-Volatile Settings Setup item Table 1-6 Factory default setting SCPI telnet command interface Enabled SCPI socket command interface Enabled SCPI HiSLIP command interface Enabled Web interface Enabled Command prompt for a Telnet session B2900A> Welcome message for a Telnet session Welcome to Agilent B2900A Series Other Non-volatile Settings Setup item Channel grouping Factory default setting “1” for 1-ch models “1-2” for 2-ch models Remote display Enabled Display col
2 Subsystem Command Summary
Subsystem Command Summary This chapter lists all of the SCPI subsystem commands for Agilent B2900 and provides the summary information of the command.
Subsystem Command Summary NOTE All commands described in this chapter are effective for the default remote control mode which supports all B2900 functions. B2900 uses this mode if it is not changed since the instrument is shipped from the factory. You may want to use existing programs for controlling existing instruments, such as Series 2400 from Keithley Instruments, Inc. To do so, refer to Chapter 6, “Using Your Existing Programs.
Subsystem Command Summary Setting Source/Measure Unit Setting Source/Measure Unit Figure 2-1 To Perform Staircase Sweep Measurement Staircase sweep source :FUNC DC, :CURR:MODE SWE or :VOLT:MODE SWE Voltage or current Stop value Trigger Trigger Trigger :CURR:STOP or :VOLT:STOP :TRIG:ACQ:DEL :SENS:WAIT :SOUR:WAIT :TRIG:TRAN:DEL Previous value : Measurement :CURR:STAR or :VOLT:STAR Start value Figure 2-2 Time To Perform Pulsed Sweep Measurement Pulsed sweep source :FUNC PULS, :CURR:MODE SWE or
Subsystem Command Summary Setting Source/Measure Unit Figure 2-3 Variety of Sweep Outputs Single Sweep :SWE:STA SING DC output :FUNC DC Double Sweep :SWE:STA DOUB Pulse output :FUNC PULS DC output :FUNC DC Pulse output :FUNC PULS Pulse output :FUNC PULS DC output :FUNC DC Pulse output :FUNC PULS Linear Sweep :SWE:SPAC LIN DC output :FUNC DC Logarithmic Sweep :SWE:SPAC LOG Figure 2-4 To Perform Spot Measurement Constant source :FUNC DC, :CURR:MODE FIX or :VOLT:MODE FIX Voltage or current :CURR
Subsystem Command Summary Setting Source/Measure Unit Table 2-1 SOURce Subsystem Command [:SOUR[c]]:CURR:CENT data [:SOUR[c]]:VOLT:CENT data [:SOUR[c]]:CURR:CENT? [DEFault|M INimum|MAXimum] [:SOUR[c]]:VOLT:CENT? [DEFault|M INimum|MAXimum] [:SOUR[c]]:CURR:SPAN data [:SOUR[c]]:VOLT:SPAN data [:SOUR[c]]:CURR:SPAN? [DEFault|M INimum|MAXimum] [:SOUR[c]]:VOLT:SPAN? [DEFault|M INimum|MAXimum] Summary Sets the center or span value of the current or voltage sweep output.
Subsystem Command Summary Setting Source/Measure Unit Command [:SOUR[c]]:CURR:MODE mode [:SOUR[c]]:VOLT:MODE mode [:SOUR[c]]:CURR:MODE? [:SOUR[c]]:VOLT:MODE? Summary Selects the source mode, fixed, list sweep, or sweep, of the specified source channel. FIX mode=SWEep|LIST|FIXed [:SOUR[c]]:VOLT:POIN points Sets the number of sweep steps for the current or voltage sweep output.
Subsystem Command Summary Setting Source/Measure Unit Command Summary Reset setting [:SOUR[c]]:CURR:RANG:AUTO:LLIM r ange Specifies the lower limit for the automatic output ranging operation, and sets the minimum range which provides the best resolution to apply the specified value. 1.00E-06 A for current range, or 0.
Subsystem Command Summary Setting Source/Measure Unit Command [:SOUR[c]]:CURR:STEP step [:SOUR[c]]:VOLT:STEP step [:SOUR[c]]:CURR:STEP? [DEFault|M INimum|MAXimum] [:SOUR[c]]:VOLT:STEP? [DEFault|M INimum|MAXimum] Summary Sets the sweep step value of the current or voltage sweep output. Reset setting 0 step=MINimum|MAXimum|DEFault| minimum to maximum source value, in A or V. See “Source Output Ranges” on page 2-24.
Subsystem Command Summary Setting Source/Measure Unit Command Summary [:SOUR]:DIG:EXT[n]:TOUT[:EDGE]:W IDT width Sets the pulse width of the output trigger for the specified GPIO pin. [:SOUR]:DIG:EXT[n]:TOUT[:EDGE]:W IDT? [DEFault|MINimum|MAXimum] width=MINimum|MAXimum|DEFault| 1E-5 to 1E-2 seconds [:SOUR]:DIG:EXT[n]:TOUT:TYPE typ e Selects the output trigger type for the specified GPIO pin.
Subsystem Command Summary Setting Source/Measure Unit Command Summary [:SOUR[c]]:LIST:CURR:APP append_ list Adds the source output current or voltage data to the end of the list set by the [:SOUR[c]]:LIST: command, to which some data might be appended to by this command. Total number of data in the list must be 2500. [:SOUR[c]]:LIST:VOLT:APP append_ list Reset setting append_list: List of the output current or voltage data. Multiple data can be set to append_list.
Subsystem Command Summary Setting Source/Measure Unit Command [:SOUR[c]]:PULS:WIDT width [:SOUR[c]]:PULS:WIDT? [DEFault|M INimum|MAXimum] Summary Sets the pulse width for the specified channel. The pulse width is the time from starting the pulse peak output (or starting the pulse level transition) to the end of the pulse peak output.See Figures 2-2 and 2-4.
Subsystem Command Summary Setting Source/Measure Unit Command [:SOUR[c]]:SWE:RANG mode [:SOUR[c]]:SWE:RANG? Summary Selects the output ranging mode of the sweep output for the specified channel. Reset setting BEST mode=BEST|FIXed|AUTO [:SOUR[c]]:SWE:SPAC mode [:SOUR[c]]:SWE:SPAC? Selects the scale of the sweep output for the specified channel. See Figure 2-3. LIN mode=LOGarithmic|LINear [:SOUR[c]]:SWE:STA mode [:SOUR[c]]:SWE:STA? Sets the sweep mode for the specified channel.
Subsystem Command Summary Setting Source/Measure Unit Command [:SOUR[c]]:WAIT:GAIN gain [:SOUR[c]]:WAIT:GAIN? [DEFault|M INimum|MAXimum] Summary Sets the gain value used for calculating the source wait time for the specified channel. Reset setting 1 gain=MINimum|MAXimum|DEFault| 0 to 100 [:SOUR[c]]:WAIT:OFFS offset [:SOUR[c]]:WAIT:OFFS? [DEFault|M INimum|MAXimum] Sets the offset value used for calculating the source wait time for the specified channel.
Subsystem Command Summary Setting Source/Measure Unit Table 2-2 SENSe Subsystem Command :SENS[c]:CURR[:DC]:APER time :SENS[c]:RES:APER time :SENS[c]:VOLT[:DC]:APER time :SENS[c]:CURR[:DC]:APER? [DEFaul t|MINimum|MAXimum] :SENS[c]:RES:APER? [DEFault|MINi mum|MAXimum] :SENS[c]:VOLT[:DC]:APER? [DEFaul t|MINimum|MAXimum] Summary Sets the integration time for one point measurement. time=MINimum|MAXimum|DEFault| +8E-6 to +2 seconds Reset setting 0.1 PLC, =0.
Subsystem Command Summary Setting Source/Measure Unit Command Summary :SENS[c]:CURR[:DC]:NPLC:AUTO mod e Enables or disables the automatic NPLC function. :SENS[c]:RES:NPLC:AUTO mode mode=1|ON|0|OFF :SENS[c]:VOLT[:DC]:NPLC:AUTO mod e The automatic NPLC on/off works with the automatic aperture on/off set by the :SENS::APER:AU TO command. So the last command setting is effective for both functions.
Subsystem Command Summary Setting Source/Measure Unit Command Summary Reset setting :SENS[c]:CURR[:DC]:RANG:AUTO:LLI M range Specifies the lower limit for the automatic measurement ranging operation, and sets the minimum measurement range which provides the best resolution to measure the specified value. 1.00E-06 A, 2 , or 0.
Subsystem Command Summary Setting Source/Measure Unit Command Summary :SENS[c]:RES:RANG:AUTO:ULIM rang e Specifies the upper limit for the automatic measurement ranging operation, and sets the maximum measurement range which provides the best resolution to measure the specified value. This is effective for resistance measurements set to the AUTO mode by the :SENS:RES:MODE command.
Subsystem Command Summary Setting Source/Measure Unit Command Summary :SENS[c]:FUNC:OFF:ALL Disables all measurement functions. :SENS[c]:FUNC:OFF:COUN? Returns the number of measurement functions that are disabled. :SENS[c]:FUNC[:ON] fctn[,fctn[,f ctn]] Enables the specified measurement functions. :SENS[c]:FUNC[:ON]? fctn=“CURRent[:DC]”|“VOLTage[:DC]” |“RESistance” :SENS[c]:FUNC[:ON]:ALL Enables all measurement functions.
Subsystem Command Summary Setting Source/Measure Unit Command :SENS[c]:TOUT:SIGN output{,outpu t} :SENS[c]:TOUT:SIGN output{,outpu t} :SENS[c]:TOUT:SIGN output{,outpu t} :SENS[c]:TOUT:SIGN? Summary Selects the trigger output for the status change between the trigger layer and the acquire device action.
Subsystem Command Summary Setting Source/Measure Unit Command :SENS[c]:WAIT:GAIN gain :SENS[c]:WAIT:GAIN? [DEFault|MIN imum|MAXimum] Summary Sets the gain value used for calculating the measurement wait time for the specified channel. Reset setting 1 gain=MINimum|MAXimum|DEFault| 0 to 100 :SENS[c]:WAIT:OFFS offset :SENS[c]:WAIT:OFFS? [DEFault|MIN imum|MAXimum] Sets the offset value used for calculating the measurement wait time for the specified channel.
Subsystem Command Summary Setting Source/Measure Unit Table 2-3 OUTPut Subsystem Command :OUTP[c]:FILT:AUTO mode :OUTP[c]:FILT:AUTO? Summary Enables or disables the automatic filter function. Reset setting OFF mode=1|ON|0|OFF :OUTP[c]:FILT[:LPAS]:FREQ freq :OUTP[c]:FILT[:LPAS]:FREQ? [DEFa ult|MINimum|MAXimum] Sets the cutoff frequency of the output filter. This command setting is ignored if the automatic filter function is enabled by the :OUTP:FILT:AUTO command. MIN freq=MINimum|MAXimum|DEFault| 31.
Subsystem Command Summary Setting Source/Measure Unit Command :OUTP[c]:OFF:MODE mode :OUTP[c]:OFF:MODE? Summary Selects the source condition after output off. Reset setting NORM mode=ZERO|HIZ|NORMal :OUTP[c]:ON:AUTO mode :OUTP[c]:ON:AUTO? Enables or disables the automatic output on function. ON mode=1|ON|0|OFF :OUTP[c]:PROT[:STAT] mode :OUTP[c]:PROT[:STAT]? Enables or disables the over voltage/ current protection. ON mode=1|ON|0|OFF :OUTP[c]:REC index Recalls the channel setup.
Subsystem Command Summary Setting Source/Measure Unit Source Output Ranges Table 2-4 Voltage Output Range Setting resolution Range value DC output voltage or pulse peak/base voltage B2901A B2902A B2911A B2912A 0.2 V 1 V 0.1 V 0 |V| 0.21 V 2V 10 V 1 V 0 |V| 2.1 V 20 V 100 V 10 V 0 |V| 6 V 200 V 1 mV 100 V Maximum current a DC output 3.03 A Pulsed output Pulse width t b 3.03 A with 50 s t tmax 10.5 A with 50 s t 1 ms 6 V < |V| 21 V 1.515 A 1.
Subsystem Command Summary Setting Source/Measure Unit Table 2-6 Current Output Range Setting resolution B2901A B2902A B2911A B2912A DC output current or pulse peak/base current a b 10 nA d ― 10 fA 0 |I| 10.5 nA 100 nA 1 pA 100 fA 0 |I| 105 nA 1 A 10 pA 1 pA 0 |I| 1.05 A 10 A 100 pA 10 pA 0 |I| 10.5 A 100 A 1 nA 100 pA 0 |I| 105 A 1 mA 10 nA 1 nA 0 |I| 1.05 mA 10 mA 100 nA 10 nA 0 |I| 10.
Subsystem Command Summary Setting Source/Measure Unit a. Table 2-5 shows the limitations when using Channels 1 and 2 for DC output or Pulsed output with 50 s t tmax (=99.9999 ks). b. Maximum base current is 500 mA for the pulse with 50 s t 1 ms, and 50 ms for the pulse with 50 s t 2.5 ms or 50 s t 10 ms. c. Maximum duty cycle is 99.9999 % for the pulse with 50 s t tmax, and 2.5 % for the pulse with 50 s t 1 ms, 50 s t 2.5 ms, or 50 s t 10 ms. d.
Subsystem Command Summary Setting Source/Measure Unit Measurement Ranges Table 2-7 Table 2-8 Voltage Measurement Range Range value Voltage measurement value Resolution 0.2 V 0 |V| 0.212 V 0.1 V 2V 0 |V| 2.12 V 1 V 20 V 0 |V| 21.2 V 10 V 200 V 0 |V| 212 V 100 V Range value Current measurement value Resolution 10 nA a 0 |I| 10.6 nA 10 fA 100 nA 0 |I| 106 nA 100 fA 1 A 0 |I| 1.06 A 1 pA 10 A 0 |I| 10.
Subsystem Command Summary Setting Source/Measure Unit Table 2-9 Resistance Measurement Range1 Range value Resistance measurement value Display resolution Test current 2 0
Subsystem Command Summary Controlling Source/Measure Trigger Controlling Source/Measure Trigger Figure 2-6 Transient and Acquire Device Actions TRANsient device action - for voltage or current output TRAN:DELay TRAN:DELay Step value Step value Trigger Trigger ACQuire device action - for voltage or current measurement ACQ:DELay Measure Trigger NOTE ACQ:DELay Measure Trigger If channels are set as shown below, the device actions start simultaneously.
Subsystem Command Summary Controlling Source/Measure Trigger • Figure 2-7 To synchronize acquire actions (measurement) • Trigger source is set to the same mode. • Delay time is set to the same value. • Measurement wait time control is set to OFF. • Measurement ranging mode is set to the fixed mode.
Subsystem Command Summary Controlling Source/Measure Trigger Figure 2-8 B2900 Trigger System INITiate[:ACQ|:TRAN] ABORt[:ACQ|:TRAN] *RST DCL SDC *RCL Idle No INITiated? Yes Trigger output ARM Layer Trigger output before ARM (*1) after ARM (*1) ARM count = 0 ARM[:ACQ|:TRAN]:SOURce AINT BUS TIMer ARM INT1-2 events EXT1-14 LAN ARM[:ACQ|:TRAN]:BYPass OFF or ONCE ARM[:ACQ|:TRAN]:IMMediate ARM[:ACQ|:TRAN]:TIMer Yes No Event detector (*1) ARM[:ACQ|:TRAN]:TOUTput[:STATe ] OFF or ON ARM[:ACQ|:TRAN]:TOU
Subsystem Command Summary Controlling Source/Measure Trigger Table 2-10 TRIGger Subsystem Command :ABOR:ACQ [chanlist] :ABOR:TRAN [chanlist] :ABOR[:ALL] [chanlist] :ARM:ACQ[:IMM] [chanlist] :ARM:TRAN[:IMM] [chanlist] :ARM[:ALL][:IMM] [chanlist] Summary Reset setting Aborts the specified device action for the (@1) for 1-ch specified channel. Trigger status is models changed to idle.
Subsystem Command Summary Controlling Source/Measure Trigger Command :ARM[c]:ACQ[:LAY]:DEL delay :ARM[c]:TRAN[:LAY]:DEL delay :ARM[c][:ALL][:LAY]:DEL delay :ARM[c]:ACQ[:LAY]:DEL? [delay] :ARM[c]:TRAN[:LAY]:DEL? [delay] Summary Sets the arm delay for the specified device action. Reset setting 0 delay=MINimum|MAXimum|DEFault| 0 to 100 seconds Query does not support delay=0 to 100.
Subsystem Command Summary Controlling Source/Measure Trigger Command :ARM[c]:ACQ[:LAY]:TOUT:SIGN output {,output} :ARM[c]:TRAN[:LAY]:TOUT:SIGN outpu t{,output} :ARM[c][:ALL][:LAY]:TOUT:SIGN outp ut{,output} :ARM[c]:ACQ[:LAY]:TOUT:SIGN? Summary Reset setting Selects the trigger output for the status EXT1 change between the idle state and the arm layer.
Subsystem Command Summary Controlling Source/Measure Trigger Command :TRIG[c]:ACQ:COUN count :TRIG[c]:TRAN:COUN count :TRIG[c][:ALL]:COUN count :TRIG[c]:ACQ:COUN? [count] :TRIG[c]:TRAN:COUN? [count] :TRIG[c][:ALL]:COUN? count :TRIG[c]:ACQ:DEL delay :TRIG[c]:TRAN:DEL delay :TRIG[c][:ALL]:DEL delay :TRIG[c]:ACQ:DEL? [delay] :TRIG[c]:TRAN:DEL? [delay] Summary Sets the trigger count for the specified device action.
Subsystem Command Summary Controlling Source/Measure Trigger Command :TRIG[c]:ACQ:SOUR[:SIGN] source :TRIG[c]:TRAN:SOUR[:SIGN] source :TRIG[c][:ALL]:SOUR[:SIGN] source :TRIG[c]:ACQ:SOUR[:SIGN]? :TRIG[c]:TRAN:SOUR[:SIGN]? :TRIG[c]:ACQ:TIM interval :TRIG[c]:TRAN:TIM interval :TRIG[c][:ALL]:TIM interval :TRIG[c]:ACQ:TIM? [interval] :TRIG[c]:TRAN:TIM? [interval] :TRIG[c][:ALL]:TIM? interval :TRIG[c]:ACQ:TOUT:SIGN output{,out put} :TRIG[c]:TRAN:TOUT:SIGN output{,ou tput} :TRIG[c][:ALL]:TOUT:SIGN output{,o utput
Subsystem Command Summary Reading Source/Measure Data Reading Source/Measure Data Figure 2-9 Measurement Data Flow Sense (Voltage, Current) VOLT CURR RES TIME STAT SOUR FETCh? READ? MEASure? SENS[1|2]:DATA? MATH Feeding CALC TIME STAT CALC[1|2]:MATH:DATA? Limit Test Offset Binning CALC TIME STAT CALC[1|2]:DATA? Trace Feeding VOLT CURR RES CALC TIME STAT SOUR MEAN SDEV MIN MAX PKPK TRACe[1|2]:DATA? TRACe[1|2]:STAT:DATA? Agilent B2900 SCPI Command Reference, Edition 2 2- 37
Subsystem Command Summary Reading Source/Measure Data Figure 2-10 Composite Limit Test Flowchart Example for Sorting Mode START Wait for SOT Source and Sense Perform Limit X ? No Yes Pass ? Yes No No Last Limit ? Yes Yes Display “FAIL” Display “PASS” Output Fail Pattern Output Pass Pattern Another Device ? SORTING MODE END 2- 38 Agilent B2900 SCPI Command Reference, Edition 2
Subsystem Command Summary Reading Source/Measure Data Figure 2-11 Composite Limit Test Flowchart Example for Grading Mode START Wait for SOT Source and Sense Perform Limit X ? No Yes No Pass ? No Display “FAIL” Yes Last Limit ? Immediate ? Yes No Yes Yes Pass ? Display“PASS” First Failure ? No No Yes Immediate ? Yes Yes Save Fail Pattern Output Pass Pattern No Output Fail Pattern Another Data ? No Failures ? Immediate ? No Yes No Yes Output Saved Fail Pattern Yes Output Pa
Subsystem Command Summary Reading Source/Measure Data Table 2-11 FETCh Subsystem Command :FETC:ARR? [chanlist] Summary Reset setting Returns the array data which contains all of the voltage measurement data, current measurement data, resistance measurement data, time data, status data, or source output setting data specified by the :FORM:ELEM:SENS command.
Subsystem Command Summary Reading Source/Measure Data Table 2-12 FORMat Subsystem Command Summary :FORM:BORD byte_order Sets the byte order of binary output data. :FORM:BORD? byte_order=NORMal|SWAPped :FORM[:DATA] format Sets the data output format. :FORM[:DATA]? format=ASCii|REAL,32|REAL,64 :FORM:DIG format Sets the response format of the bit pattern defined by :CALC:xxxx:DIG[:DATA].
Subsystem Command Summary Reading Source/Measure Data Table 2-13 READ Subsystem Command :READ:ARR? [chanlist] Summary Reset setting Executes the :INIT command and the :FETC:ARR? command in series, and returns the array data which contains all data for the element specified by the :FORM:ELEM:SENS command.
Subsystem Command Summary Reading Source/Measure Data Table 2-14 MEASure Subsystem Command :MEAS? [chanlist] Summary Reset setting Executes a spot measurement (one-shot measurement) and returns the measurement result data. Measurement items can be specified by the :FORM:ELEM:SENS command.
Subsystem Command Summary Reading Source/Measure Data Command Summary :CALC[c]:CLIM:FAIL:DIG[:DATA] pa ttern Defines a fail pattern that appears near the end of the flowcharts shown in Figures 2-10 and 2-11. This is a bit pattern used to indicate the composite limit test fail. :CALC[c]:CLIM:FAIL:DIG[:DATA]? Reset setting 0 pattern=0 to 16383 :CALC[c]:CLIM:MODE mode :CALC[c]:CLIM:MODE? Sets the operation mode of the composite limit test. GRAD mode=GRADing|SORTing.
Subsystem Command Summary Reading Source/Measure Data Command :CALC[c]:DATA? [offset[,size]] Summary :CALC[c]:DATA? returns limit test data. offset=CURRent|STARt|0 to maximum Reset setting STAR and all data size=1 to maximum :CALC[c]:DATA:LAT? :CALC[c]:DATA:LAT? returns the last limit test data. Elements of the returned data are specified by the :FORM:ELEM:CALC command. The limit test data can be expressed by the following formula.
Subsystem Command Summary Reading Source/Measure Data Command :CALC[c]:LIM[m]:COMP:DIG[:DATA] pattern :CALC[c]:LIM[m]:COMP:DIG[:DATA]? Summary Defines the bit pattern used to indicate a failure of the compliance status check specified by m. Reset setting 0 pattern=0 to 16383 :CALC[c]:LIM[m]:COMP:FAIL criter ia Sets the judgement criteria for the compliance status check specified by m.
Subsystem Command Summary Reading Source/Measure Data Command :CALC[c]:LIM[m]:PASS:DIG[:DATA] pattern :CALC[c]:LIM[m]:PASS:DIG[:DATA]? Summary Defines the bit pattern used to indicate a pass of the limit test specified by m. The bit pattern is used for the SORT composite limit test. Reset setting 0 pattern=0 to 16383 :CALC[c]:LIM[m]:STAT mode :CALC[c]:LIM[m]:STAT? Enables or disables the limit test specified by m.
Subsystem Command Summary Reading Source/Measure Data Command Summary Reset setting :CALC[c]:MATH[:EXPR]:CAT? Returns the list of all the predefined and user-defined math expression names. POWER, OFFCOMPO HM, VOLTCOEF, VARALPHA :CALC[c]:MATH[:EXPR][:DEF] defin ition Defines a math expression which will be a user-defined math expression. Maximum of 32 math expressions can be defined including the predefined math expressions. (VOLT * CURR) definition: Up to 256 ASCII characters.
Subsystem Command Summary Reading Source/Measure Data Command :CALC[c]:OFFS offset :CALC[c]:OFFS? [MINimum|MAXimum| DEFault] Summary Sets the null offset value used for calculating the limit test data. 0 offset=MINimum|MAXimum|DEFault| -9.999999E+20 to +9.999999E+20 :CALC[c]:OFFS:ACQ Automatically sets the null offset value used for calculating the limit test data. :CALC[c]:OFFS:STAT mode Enables or disables the null offset function used for calculating the limit test data.
Subsystem Command Summary Reading Source/Measure Data Command Summary Reset setting Returns the available size (available) and the total size (total) of the trace buffer. :TRAC[c]:FREE? Response is available,total. :TRAC[c]:POIN points :TRAC[c]:POIN? [MINimum|MAXimum| DEFault] Sets the size of the trace buffer. This command is effective when the trace buffer control mode is set to NEV by the :TRAC[c]:FEED:CONT command.
Subsystem Command Summary Using Advanced Functions Using Advanced Functions Table 2-17 HCOPy Subsystem Command Summary :HCOP:SDUM:DATA? Returns the data of the front panel screen image. The response is a definite length arbitrary binary block. :HCOP:SDUM:FORM format Sets the format of the image data. :HCOP:SDUM:FORM? format=JPG|BMP|PNG|WMF Table 2-18 Reset setting JPG DISPlay Subsystem Command Summary Reset setting Selects the color set of the front panel display.
Subsystem Command Summary Using Advanced Functions Command :DISP[:WIND[d]]:TEXT:DATA text :DISP[:WIND[d]]:TEXT:DATA? Summary Sets the text message displayed on the center of the upper or lower display area of the front panel display. Reset setting “” text: Up to 32 ASCII characters. :DISP[:WIND[d]]:TEXT:STAT :DISP[:WIND[d]]:TEXT:STAT? Shows or hides the text message set by the :DISP[:WIND[d]]:TEXT:DATA command. OFF mode=1|ON|0|OFF Enables or disables the zoom function of the front panel display.
Subsystem Command Summary Using Advanced Functions Command :MMEM:LOAD:MACR macro,file_name Summary Reset setting Loads a macro from the specified file in the current directory. macro: Name of macro. file_name: Name of the file which contains the macro. :MMEM:LOAD:STAT file_name Loads an instrument setup from the specified file in the current directory. file_name: Name of the file which contains the instrument setup. :MMEM:MDIR directory Creates a new directory.
Subsystem Command Summary Using Advanced Functions Command Summary Reset setting Saves the macro to the specified file in the current directory. :MMEM:STOR:MACR macro,file_name macro: Name of macro. file_name: Name of the file to save the macro. Saves the instrument setup to the specified file in the current directory. :MMEM:STOR:STAT file_name file_name: Name of the file to save the instrument setup.
Subsystem Command Summary Using Advanced Functions Command :PROG[:SEL]:APP program_code Summary Reset setting Adds a program code to the end of a program stored in the program memory. program_code: Program code. Up to 256 byte per execution. Sum of all program size in the program memory must be up to 100 KB. :PROG[:SEL]:DEF program_code :PROG[:SEL]:DEF? Defines a program in the program memory by entering the initial program code. program_code: Program code. Up to 256 byte per execution.
Subsystem Command Summary Using Advanced Functions Command :PROG[:SEL]:STAT operation :PROG[:SEL]:STAT? Summary Reset setting Changes the execution status of a program stored in the program memory. operation=RUN|PAUSe|STEP|STOP| CONTinue :PROG[:SEL]:WAIT? timeout Blocks other commands until the program execution status changes to Paused or Stopped. timeout: Timeout value, in seconds. :PROG:VAR[h] value :PROG:VAR[h]? Sets a value to the variable specified by h.
Subsystem Command Summary Using Advanced Functions Command Summary :SYST:COMM:GPIB[:SELF]:ADDR addr ess Sets the GPIB address of the instrument. Reset setting address=0 to 30 :SYST:COMM:GPIB[:SELF]:ADDR? :SYST:COMM:LAN:ADDR address :SYST:COMM:LAN:ADDR? [CURR|STAT] Sets the static LAN (IP) address of the instrument. The setting is enabled by the :SYST:COMM:LAN:UPD command. address=A.B.C.D, 15 characters maximum. A, B, C, and D must be a number from 0 to 225.
Subsystem Command Summary Using Advanced Functions Command :SYST:COMM:LAN:GAT address :SYST:COMM:LAN:GATE address :SYST:COMM:LAN:GAT? [CURR|STAT] :SYST:COMM:LAN:GATE? [CURR|STAT] Summary Reset setting Sets the IP address of the default gateway. The setting is enabled by the :SYST:COMM:LAN:UPD command. address=A.B.C.D, 15 characters maximum. A, B, C, and D must be a number from 0 to 225.
Subsystem Command Summary Using Advanced Functions Command Summary :SYST:COMM:LAN:TELN:WMES message Sets the welcome message displayed during a Telnet session when starting the communication with the instrument. :SYST:COMM:LAN:TELN:WMES? Reset setting message: Welcome message. Up to 63 characters. :SYST:COMM:LAN:UPD Disconnects all active LAN and Web Interface connections, updates the LAN setup, and restarts the LAN interface with the new setup.
Subsystem Command Summary Using Advanced Functions Command Summary :SYST:ERR:COUN? Returns the number of items in the error/event queue. :SYST:ERR[:NEXT]? Reads and removes the top item in the error/event queue, and returns the top code and message. :SYST:FAN:MODE mode Sets the fan control mode. :SYST:FAN:MODE? mode=NORMal|RACK :SYST:GRO[:DEF] chanlist Defines the channel group.
Subsystem Command Summary Using Advanced Functions Command Summary :SYST:LOCK:REQ? Requests a lock of the current I/O interface. :SYST:PON memory Specifies the power-on state. Reset setting RST memory=RST|RCL0|RCL1|RCL2|RCL3| RCL4 :SYST:PRES Presets the instrument settings and the front panel display. :SYST:SET data Sends or loads the instrument setup data. :SYST:SET? data: Instrument setup data. Parameter data type is a definite length arbitrary binary block.
Subsystem Command Summary Using Advanced Functions Table 2-22 STATus Subsystem Command Summary Reset setting Returns the value of the measurement, operation, or questionable status condition register. :STAT:MEAS:COND? :STAT:OPER:COND? :STAT:QUES:COND? :STAT:OPER:ENAB mask Sets the measurement, operation, or questionable status enable register.
Subsystem Command Summary Using Advanced Functions Command :STAT:QUES:CAL:COND? :STAT:QUES:CURR:COND? Summary Reset setting Returns the value of the questionable status condition register. :STAT:QUES:TEMP:COND? :STAT:QUES:TEST:COND? :STAT:QUES:VOLT:COND? :STAT:QUES:CAL:ENAB mask :STAT:QUES:CURR:ENAB mask :STAT:QUES:TEMP:ENAB mask :STAT:QUES:TEST:ENAB mask Sets the questionable calibration, current, temperature, test, or voltage status enable register.
Subsystem Command Summary Using Advanced Functions Command :STAT:QUES:CAL[:EVEN]? :STAT:QUES:CURR[:EVEN]? :STAT:QUES:TEMP[:EVEN]? Summary Reset setting Returns the value of the questionable calibration, current, temperature, test, or voltage status event register. :STAT:QUES:TEST[:EVEN]? :STAT:QUES:VOLT[:EVEN]? :STAT:QUES:VOLT:NTR filter Sets the negative transition filter in the questionable calibration, current, temperature, test, or voltage status register.
3 Common Commands
Common Commands This chapter describes common commands and queries of IEEE 488.2. The commands available for Agilent B2900 are listed in Table 3-1.
Common Commands *CAL? *CAL? This query command performs the self-calibration, and returns the execution result. Execution Conditions Open the measurement terminals before starting the self-calibration. Syntax *CAL? Query response result <^END> result is 0 or 1 that indicates the calibration result. Response data type is NR1.
Common Commands *CLS *CLS This command clears the Status Byte register, the Standard Event Status register, and the Error Queue. This command does not clear the enable registers. For the SCPI status system, see “Status System Diagram” on page 1-19. Also, this command stops the monitoring of pending operations by the *OPC command. This command does not have query form.
Common Commands *ESE *ESE This command sets the bits of the Standard Event Status Enable register. This command programs the Standard Event Status Enable register bits. The programming determines which events of the Standard Event Status Enable register are allowed to set the ESB (Event Summary Bit) of the Status Byte register. A 1 in the bit position enables the corresponding event. For the SCPI status system, see “Status System Diagram” on page 1-19.
Common Commands *ESR? *ESR? This query returns the present contents of the Standard Event Status register. The event register is a read-only register, which stores (latches) all standard events. Reading the Standard Event Status Enable register clears it. For the SCPI status system, see “Status System Diagram” on page 1-19. Syntax *ESR? Query response register <^END> register is the binary-weighted sum of all bits set in the register.
Common Commands *ESR? Table 3-2 bit Standard Event Register Bit Definitions decimal value description definition 0 1 OPC (operation complete) All commands prior to and including *OPC have been executed. 1 2 Not used 0 is returned. 2 4 QYE (query error) The instrument tried to read the output buffer but it was empty. Or, a new command line was received before a previous query has been read. Or, both the input and output buffers are full.
Common Commands *IDN? *IDN? This query command returns the instrument’s (mainframe) identification string which contains four comma-separated fields. Syntax *IDN? Query response Agilent Technologies,model,serial,revision <^END> model: mainframe model number serial: mainframe serial number revision: firmware revision number Response data type is AARD.
Common Commands *OPC *OPC This command starts to monitor pending operations, and sets/clears the operation complete (OPC) bit in the Standard Event Status register as follows. • If there is no pending operation, the OPC bit is set to 1. • If there are any pending operations, the OPC bit is set to 0. The bit will be set to 1 again when all pending operations are completed. The *OPC command is required to enable the OPC bit.
Common Commands *RCL *RCL This command restores the instrument to a state that was previously stored in one of the memory locations 0 through 9 with the *SAV command. Syntax *RCL memory Parameter memory Remarks The device state stored in the location 0 is automatically recalled at power turn-on when the Output Power-On state is set to *RCL 0. One of the memory locations 0 to 9. Parameter data type is NR1. You cannot recall the instrument state from a storage location that is empty or was deleted.
Common Commands *RST *RST This command performs an instrument reset. This command resets the volatile memory of the instrument to the initial setting. Syntax *RST Remarks This command cancels any measurement or output trigger actions presently in process, and resets the Waiting for arm and trigger bits in the Status Operation Condition register.
Common Commands *SAV *SAV This command stores the present state of the instrument to the specified location in non-volatile memory. Up to 10 states can be stored in the memory locations 0 through 9. Any state previously stored in the same location will be overwritten. Use the *RCL command to retrieve instrument states. Syntax *SAV memory Parameter memory Remarks If a particular state is desired at power-on, it should be stored in the location 0.
Common Commands *SRE *SRE This command sets the value of the Service Request Enable register. This register determines which bits from the Status Byte register are summed to set the Master Status Summary (MSS) bit and the Request for Service (RQS) summary bit. A 1 in the bit position enables the corresponding event. For the SCPI status system, see “Status System Diagram” on page 1-19.
Common Commands *SRE Table 3-3 bit Status Byte Register Bit Definitions decimal value description definition 0 1 Measurement status summary One or more bits are set in the Measurement Status register (bits must be enabled, see :STATus::ENABle command). 1 2 Not used 0 is returned. 2 4 Error queue not empty One or more errors have been stored in the Error Queue (see :SYSTem:ERRor[:NEXT]? command).
Common Commands *STB? *STB? This query reads the Status Byte register, which contains the status summary bits and the Output Queue MAV bit. The Status Byte register is a read-only register and the bits are not cleared when it is read. For the SCPI status system, see “Status System Diagram” on page 1-19. Syntax *STB? Query response register <^END> register is the binary-weighted sum of all bits set in the register.
Common Commands *TRG *TRG This common command generates a trigger when the trigger subsystem has BUS selected as its source. The command has the same affect as the Group Execute Trigger (GET) command.
Common Commands *TST? *TST? This query causes the instrument to do a self-test and report any errors. A 0 indicates the instrument passed self-test. If all tests pass, you can have a high confidence that the instrument is operational. Syntax *TST? Query response result <^END> result is 0 or 1 that indicates the self-test result. Response data type is NR1.
Common Commands *WAI *WAI This command instructs the instrument not to process any further commands until all pending operations are completed. Pending operations are as defined under the *OPC command. Syntax *WAI Remarks *WAI can be aborted only by sending the instrument a Device Clear command.
4 Subsystem Commands
Subsystem Commands This chapter describes subsystem commands available for Agilent B2900 in alphabetical order. There are the following subsystems.
Subsystem Commands :CALCulate:CLIMits:CLEar:AUTO CALCulate Subsystem For the numeric suffixes [c], [m], and [n], see “Numeric Suffix” on page 1-8. :CALCulate:CLIMits:CLEar:AUTO Enables or disables the automatic clear function of the composite limit test. Syntax :CALCulate[c]:CLIMits:CLEar:AUTO mode :CALCulate[c]:CLIMits:CLEar:AUTO? Parameter mode 0|OFF|1|ON (default). Parameter data type is boolean.
Subsystem Commands :CALCulate:CLIMits:CLEar[:IMMediate] Parameter time Query response time value (+1E-5 to 60 seconds)|MINimum|MAXimum|DEFault (default is +1E-4). Parameter data type is NRf+. Query does not support time=value. If you specify the value less than MIN or greater than MAX, time is automatically set to MIN or MAX. time returns the present setting of delay time for the automatic clear. If a parameter is specified, time returns the value assigned to DEF, MIN, or MAX.
Subsystem Commands :CALCulate:CLIMits:MODE Example :CALC:CLIM:FAIL:DIG:DATA 64 :CALC2:CLIM:PASS:DIG? :CALCulate:CLIMits:MODE Sets the operation mode of the composite limit test to GRADing or SORTing. Syntax :CALCulate[c]:CLIMits:MODE mode :CALCulate[c]:CLIMits:MODE? Parameter mode SORT (sorting)|GRAD (grading, default). Parameter data type is CPD. mode=GRAD performs limit tests for up to 12 test limits until a failure is detected. See Figure 2-11 for an example of a flowchart under the grading mode.
Subsystem Commands :CALCulate:CLIMits:STATe:ANY? mode is 0 or 1, and indicates that the composite limit test is off or on, respectively. Response data type is NR1 or NDN. Example :CALC:CLIM:STAT 1 :CALC2:CLIM:STAT? :CALCulate:CLIMits:STATe:ANY? Checks if the present composite limit test contains a limit test, which is a pass/fail judgement. It is performed at the “Pass?” step in Figures 2-10 and 2-11. Syntax :CALCulate[c]:CLIMits:STATe:ANY? Query response status status returns 0 or 1.
Subsystem Commands :CALCulate:DATA? result returns IMM or END. Response data type is CRD. Example :CALC:CLIM:UPD END :CALC2:CLIM:UPD? :CALCulate:DATA? Returns limit test data. Elements of the returned data are specified by the :FORMat:ELEMents:CALCulate command. The limit test data can be expressed by the following formula.
Subsystem Commands :CALCulate:DATA:LATest? :CALCulate:DATA:LATest? Returns the latest limit test data. Elements of the returned data are specified by the :FORMat:ELEMents:CALCulate command. The limit test data can be expressed by the following formula. limit test data = input data - null offset input data: Data specified by :CALCulate:FEED null offset: Data set by :CALCulate:OFFSet or :CALCulate:OFFSet:ACQuire If the null offset function is disabled by the :CALCulate:OFFSet:STATe command, null offset=0.
Subsystem Commands :CALCulate:DIGital: Query response pin pin returns NONE or a comma separated EXT string. Response data type is CRD. Example :CALC:DIG:BIT EXT9,EXT10,EXT11 :CALC2:DIG:BIT? :CALCulate:DIGital: Assigns the GPIO pin for the BUSY (busy), EOT (end of test), or SOT (start of test) signal line for the composite limit test.
Subsystem Commands :CALCulate:LIMit:COMPliance:DIGital[:DATA] :CALCulate[c]:FEED? Parameter type Data type. MATH|RESistance|CURRent|VOLTage (default). Parameter data type is CPD. type=VOLT specifies the voltage measurement data. type=CURR specifies the current measurement data. type=RES specifies the resistance calculation data given by the following formula. Resistance=Vmeas/Imeas Where, Vmeas is the voltage measurement data, and Imeas is the current measurement data.
Subsystem Commands :CALCulate:LIMit:COMPliance:FAIL Query response bit_pattern bit_pattern returns the fail bit pattern in the format specified by the :FORMat:DIGital command. Response data type is NR1 or NDN. Example :CALC:LIM:COMP:DIG:DATA 64 :CALC2:LIM12:COMP:DIG? :CALCulate:LIMit:COMPliance:FAIL Sets the judgement criteria for the compliance status check specified by m.
Subsystem Commands :CALCulate:LIMit:FUNCtion Example :CALC2:LIM12:FAIL? :CALCulate:LIMit:FUNCtion Sets the type of the limit test specified by m. Syntax :CALCulate[c]:LIMit[m]:FUNCtion type :CALCulate[c]:LIMit[m]:FUNCtion? Parameter type COMPliance|LIMit (default). Parameter data type is CPD. type=COMP sets the compliance status check which checks if the channel is in the compliance status.
Subsystem Commands :CALCulate:LIMit::DIGital[:DATA] limit returns the present setting of the lower/upper limit used for the limit test specified by m. If a parameter is specified, limit returns the value assigned to DEF, MIN, or MAX. Response data type is NR3. Example :CALC:LIM:LOW -2.5 :CALC2:LIM12:UPP? :CALCulate:LIMit::DIGital[:DATA] Defines the bit pattern used to indicate failed-by-exceeding-lower-limit or failed-by-exceeding-upper-limit of the limit test specified by m.
Subsystem Commands :CALCulate:LIMit:STATe Parameter bit_pattern Query response bit_pattern 0 (default setting in decimal expression) to 16383. Parameter data type is NR1 or NDN. bit_pattern returns the pass bit pattern in the format specified by the :FORMat:DIGital command. Response data type is NR1 or NDN. Example :CALC:LIM:PASS:DIG:DATA 64 :CALC2:LIM12:PASS:DIG? :CALCulate:LIMit:STATe Enables or disables the limit test specified by m.
Subsystem Commands :CALCulate:MATH:DATA:LATest? Parameter offset Indicates the beginning of the data received. n|CURRent|STARt (default). Parameter data type is NR1 or CPD. offset=n specifies the n+1th data. n is an integer, 0 to maximum (depends on the buffer state). offset=CURR specifies the present data position. offset=STAR specifies the top of the data buffer. Same as offset=0. size Query response Number of data to be received. 1 to maximum (depends on the buffer state).
Subsystem Commands :CALCulate:MATH[:EXPRession]:CATalog? :CALCulate:MATH[:EXPRession]:CATalog? Returns the list of all the predefined and user-defined math expression names. Syntax :CALCulate[c]:MATH[:EXPRession]:CATalog? Query response catalog catalog returns all of the predefined and user-defined math expression names. Response data type is AARD.
Subsystem Commands :CALCulate:MATH[:EXPRession][:DEFine] Resources used in the expressions The following resources can be used in user-defined math expressions. • Reserved variables The variables listed in Table 4-1 are reserved for reading the channel output or measurement data. Scalar variable is used for spot measurement data. Vector (array) variable is used for sweep measurement data. • Math operators The following operators are available.
Subsystem Commands :CALCulate:MATH[:EXPRession][:DEFine] Table 4-2 Arithmetic and Unary Operators Priority of task Operator High : : : : : () Low + and ^ Description Parentheses Unary plus operator and unary minus operator Exponentiation operator * and / Multiplication operator and division operator + and - Additive operator and subtraction operator Predefined math expressions The following math expressions are already defined in the instrument.
Subsystem Commands :CALCulate:MATH[:EXPRession]:DELete:ALL VOLTCOEF Calculates voltage coefficient using the following formula. VOLTCOEF = (RES[c][1]-RES[c][0]) / (RES[c][1] * (VOLT[c][1]-VOLT[c][0])) * 100 % where, RES[c][0] and RES[c][1] are resistance measurement data at the first and second measurement points, respectively, and VOLT[c][0] and VOLT[c][1] are voltage measurement data at the first and second measurement points, respectively.
Subsystem Commands :CALCulate:MATH:STATe Existing user-defined math expression can be changed by executing this command with its name, and executing the :CALCulate:MATH[:EXPRession][:DEFine] command with a new definition. Syntax :CALCulate[c]:MATH[:EXPRession]:NAME name :CALCulate[c]:MATH[:EXPRession]:NAME? Parameter name Query response name Name of a math expression. Up to 32 ASCII characters without any control characters, space characters, single and double quotes, and comma.
Subsystem Commands :CALCulate:MATH:UNITs :CALCulate:MATH:UNITs Defines the unit name for the math expression. Syntax :CALCulate[c]:MATH:UNITs unit :CALCulate[c]:MATH:UNITs? Parameter unit Query response unit Unit name. Up to 32 ASCII characters. Parameter data type is SPD. unit returns the unit name of the math expression. Response data type is SRD. Example :CALC:MATH:UNIT “amps” :CALC2:MATH:UNIT? :CALCulate:OFFSet Sets the null offset value used for calculating the limit test data.
Subsystem Commands :CALCulate:OFFSet:ACQuire :CALCulate:OFFSet:ACQuire Automatically sets the null offset value used for calculating the limit test data. The null offset value will be the currently available value read by the :CALCulate:DATA:LATest? or :SENSe:DATA:LATest? command. Or, it will be 0.0 if a currently available value does not exist.
Subsystem Commands :DISPlay:CSET DISPlay Subsystem For the numeric suffix [d], see “Numeric Suffix” on page 1-8. :DISPlay:CSET Selects the color set of the front panel display. This command setting is not changed by power off or the *RST command. Syntax :DISPlay:CSET color :DISPlay:CSET? Parameter color Color set of the front panel display. 1|2. Parameter data type is NR1. color=1 selects the default color set. color=2 selects the alternative color set.
Subsystem Commands :DISPlay:ENABle digits=6 selects 5½ digit resolution. digits=7 selects 6½ digit resolution. Query response digits digits returns the present setting. If a parameter is specified, digits returns the value assigned to DEF, MIN, or MAX. Response data type is NR1. Example :DISP:DIG 4 :DISP:DIG? MAX :DISPlay:ENABle Enables or disables the front panel display under remote operation. This command setting is not changed by power off or the *RST command.
Subsystem Commands :DISPlay[:WINDow]:DATA? :DISPlay:VIEW? Parameter mode SINGle1|SINGle2|DUAL|GRAPh|ROLL. Parameter data type is CPD. mode=SINGle1 sets the channel 1 display mode. Default setting for 1-channel models. mode=SINGle2 sets the channel 2 display mode. Only on 2-channel models. mode=DUAL sets channel 1, and channel 2 display mode. Only on 2-channel models. Default setting. mode=GRAPh sets the graph display mode for the sweep measurement results.
Subsystem Commands :DISPlay[:WINDow]:TEXT:DATA For the DUAL display mode, the :DISP:WIND2:DATA? command returns the data displayed on the lower display area. For the GRAPh or ROLL display mode, response returns “-----------,-----------,-----------,-----------”. Example :DISP:DATA? :DISP:WIND2:DATA? :DISPlay[:WINDow]:TEXT:DATA Sets the text message displayed on the center of the upper or lower display area of the front panel display.
Subsystem Commands :DISPlay:ZOOM Example :DISP:TEXT:STAT 1 :DISPlay:ZOOM Enables or disables the zoom function of the front panel display. This function is effective for the Dual view and Single view. If this function is enabled, the setup information is not displayed and the measurement result is zoomed. Then, Syntax • the Dual view displays the primary measurement data with a large font, and the secondary measurement data with a small font, for each channel.
Subsystem Commands :FETCh:ARRay? FETCh Subsystem :FETCh:ARRay? Returns the array data which contains all of the voltage measurement data, current measurement data, resistance measurement data, time data, status data, or source output setting data specified by the :FORMat:ELEMents:SENSe command. The data is not cleared until the :INITiate, :MEASure, or :READ command is executed. Syntax :FETCh:ARRay? [chanlist] Parameter chanlist Channels to return the data. Parameter data type is channel list.
Subsystem Commands :FETCh:ARRay:? Example :FORM:ELEM:SENS CURR,SOUR :FETC:ARR? (@1,2) :FETCh:ARRay:? Returns the array data which contains all of the current measurement data, resistance measurement data, source output setting data, status data, time data, or voltage measurement data specified by CURRent, RESistance, SOURce, STATus, TIME, or VOLTage.
Subsystem Commands :FETCh[:SCALar]? This example shows the data containing the current data (ch1currN) of the 10-step sweep measurement by channel 1, and the current data (ch2currN) of the 5-step sweep measurement by channel 2. If the measurement function is not enabled or no data exists, response returns +9.910000E+37 (ASCII) or NaN (IEEE-754) which indicates “not a number”.
Subsystem Commands :FETCh[:SCALar]:? Example :FORM:ELEM:SENS CURR,SOUR :FETC? (@1,2) :FETCh[:SCALar]:? Returns the latest current measurement data, resistance measurement data, source output setting data, status data, time data, or voltage measurement data specified by CURRent, RESistance, SOURce, STATus, TIME, or VOLTage. The data is not cleared until the :INITiate, :MEASure, or :READ command is executed.
Subsystem Commands :FETCh[:SCALar]:? Example :FETC:CURR? (@2,1) 4- 32 Agilent B2900 SCPI Command Reference, Edition 2
Subsystem Commands :FORMat:BORDer FORMat Subsystem :FORMat:BORDer This command is effective when the data output format is set to the IEEE-754 binary format by using the :FORMat[:DATA] command. This command sets the byte order of binary output data. Syntax :FORMat:BORDer byte_order :FORMat:BORDer? Parameter byte_order NORMal (default)|SWAPped. Parameter data type is CPD. byte_order=NORMal sets the normal byte order. For the IEEE-754 single precision format, byte 1 to byte 4 are sent in this order.
Subsystem Commands :FORMat:DIGital format=ASCii specifies the ASCII format (default). format=REAL,32 specifies the IEEE-754 single precision format. 4-byte data. format=REAL,64 specifies the IEEE-754 double precision format. 8-byte data. Query response format format returns ASC, REAL,32, or REAL,64. Response data type is CRD. Example :FORM REAL32 :FORM? :FORMat:DIGital Sets the response format of the bit pattern defined by the following commands.
Subsystem Commands :FORMat:ELEMents:SENSe For the data stored in the trace buffer, this command is effective for the calculation result data or limit test data that is specified by the :TRACe:FEED MATH|LIM command. If all elements are specified by this command, the result data contains the all elements shown below. Then the order of elements is exclusive. For example, if TIME is not specified, the data contains the calc and status data in this order.
Subsystem Commands :FORMat:SREGister Syntax :FORMat:ELEMents:SENSe type{,type} :FORMat:ELEMents:SENSe? Parameter type Data element included in the data. VOLTage|CURRent|RESistance|TIME|STATus|SOURce. Parameter data type is CPD. VOLT selects the voltage measurement data voltage. CURR selects the current measurement data current. RES selects the resistance measurement data resistance. TIME selects the time data time (timestamp of the measurement start trigger). STAT selects the status data status.
Subsystem Commands :HCOPy:SDUMp:DATA? HCOPy Subsystem :HCOPy:SDUMp:DATA? Returns the data of the front panel screen image. The format of the image data is set by the :HCOPy:SDUMp:FORMat command. Syntax :HCOPy:SDUMp:DATA? Query response The response is a definite length arbitrary binary block. Example :HCOP:SDUM:DATA? :HCOPy:SDUMp:FORMat Sets the format of the image data. The front panel screen image will be created in the format set by this command.
Subsystem Commands :LXI:IDENtify[:STATe] LXI Subsystem :LXI:IDENtify[:STATe] Changes the LXI status indicator state. Syntax :LXI:IDENtify[:STATe] mode :LXI:IDENtify[:STATe]? Parameter mode 0|OFF (default)|1|ON . Parameter data type is boolean. mode=1 or ON changes the LXI status indicator to the Identify state. mode=0 or OFF changes the LXI status indicator to the No Fault state.
Subsystem Commands :LXI:MDNS:HNAMe[:RESolved]? Example :LXI:MDNS:ENAB 0 :LXI:MDNS:ENAB? :LXI:MDNS:HNAMe[:RESolved]? Returns the resolved mDNS hostname. Syntax :LXI:MDNS:HNAMe[:RESolved]? Query response desired mDNS hostname-N N is an integer appended as necessary to make the name unique. Response data type is SRD. Example :LXI:MDNS:HNAM? :LXI:MDNS:SNAMe:DESired Sets the desired mDNS service name.
Subsystem Commands Other LXI Subsystem Commands N is an integer appended as necessary to make the name unique. Response data type is SRD. Example :LXI:MDNS:SNAM? Other LXI Subsystem Commands Agilent B2900 also supports the following commands. For details, refer to SCPI documents.
Subsystem Commands Other LXI Subsystem Commands • :LXI:EVENt:INPut:LAN[:SET]:IDENtifier • :LXI:EVENt:INPut:LAN[:SET]:IDENtifier? • :LXI:EVENt:LOG:CIRCular[:ENABle] • :LXI:EVENt:LOG:CIRCular[:ENABle]? • :LXI:EVENt:LOG:ENABle • :LXI:EVENt:LOG:ENABle? • :LXI:EVENt:LOG:SIZE • :LXI:EVENt:LOG:SIZE? • :LXI:EVENt:STATus:ENABle • :LXI:EVENt:STATus:ENABle? • :LXI:EVENt[:OUTPut]:LAN[:SET]:DESTination • :LXI:EVENt[:OUTPut]:LAN[:SET]:DESTination? • :LXI:EVENt[:OUTPut]:LAN[:SET]:DRIVe • :LXI:EV
Subsystem Commands LXI Trigger Events • :TRIGger:LXI:LAN[:SET]:ENABle • :TRIGger:LXI:LAN[:SET]:ENABle? • :TRIGger:LXI:LAN[:SET]:FILTer • :TRIGger:LXI:LAN[:SET]:FILTer? • :TRIGger:LXI:LAN[:SET]:IDENtifier • :TRIGger:LXI:LAN[:SET]:IDENtifier? LXI Trigger Events B2900 provides a subset of the LXI Trigger Events (IVI-3.15 IviLxiSync) functionality in the trigger system. • Device Model Figure 4-1 shows the high-level LXI device model defined in IVI-3.15.
Subsystem Commands LXI Trigger Events • Instrument Specific Events B2900 has the ARM-TRIGger model for each channel and actions (transition and acquire), and provides following events.
Subsystem Commands :MEASure? MEASure Subsystem :MEASure? Executes a spot measurement (one-shot measurement) and returns the measurement result data. Measurement conditions must be set by SCPI commands or front panel operation before executing this command. Measurement items can be selected by the :FORMat:ELEMents:SENSe command. Syntax :MEASure? [chanlist] Parameter chanlist Channels to perform measurement. Parameter data type is channel list. (@1)|(@2)|(@1,2)|(@1:2)|(@2,1)|(@2:1).
Subsystem Commands :MEASure:? :MEASure:? Executes a spot measurement (one-shot measurement) and returns the measurement result data. Measurement conditions must be set by SCPI commands or front panel operation before executing this command. Measurement item can be set to CURRent, RESistance, or VOLTage.
Subsystem Commands :MMEMory:CATalog? MMEMory Subsystem :MMEMory:CATalog? Returns the memory usage and availability. Also returns the list of files and folders in the current specified directory. Syntax :MMEMory:CATalog? [directory] Parameter directory Directory name, |USB:\. Either / (slash) or \ (backslash) can be used as the path separator. Up to 255 ASCII characters. Parameter data type is SPD. If directory is not set, this function is applied to the current directory.
Subsystem Commands :MMEMory:COPY Syntax :MMEMory:CDIRectory directory :MMEMory:CDIRectory? Parameter directory Directory name, |USB:\. Either / (slash) or \ (backslash) can be used as the path separator. Up to 255 ASCII characters. Parameter data type is SPD. If directory=, the next current directory will be \. If directory=USB:\, the next current directory will be USB:\.
Subsystem Commands :MMEMory:DELete :MMEMory:DELete Deletes a file in the current directory. Syntax :MMEMory:DELete file_name Parameter file_name Name of the file to delete. Up to 255 ASCII characters. Parameter data type is SPD. Error occurs if the specified file does not exist. Example :MMEM:DEL “original_copy.dat” :MMEMory:LOAD:MACRo Loads a macro from the specified file in the current directory. Syntax :MMEMory:LOAD:MACRo macro,file_name Parameter macro Name of macro.
Subsystem Commands :MMEMory:MOVE Syntax :MMEMory:MDIRectory directory Parameter directory Directory name, |USB:\. Either / (slash) or \ (backslash) can be used as the path separator. Up to 255 ASCII characters. Parameter data type is SPD. If directory=, this command creates a \ directory. If directory=USB:\, this command creates a USB:\ directory. Where, USB:\ is the root directory of the USB memory connected to the B2900 front panel.
Subsystem Commands :MMEMory:STORe:DATA<:LIMit|:MATH|:SENSe|[:ALL]> Parameter directory Directory name, |USB:\. Either / (slash) or \ (backslash) can be used as the path separator. Up to 255 ASCII characters. Parameter data type is SPD. If directory=, this command removes the \ directory. If directory=USB:\, this command removes the USB:\ directory. Where, USB:\ is the root directory of the USB memory connected to the B2900 front panel.
Subsystem Commands :MMEMory:STORe:STATe Syntax :MMEMory:STORe:MACRo macro,file_name Parameter macro Name of macro. file_name Name of the file used to save the macro. File extention must be mac, which is meaningful for the :MMEMory:CATalog? result. Length of parameters is up to 255 ASCII characters. Parameter data type is SPD. Example :MMEM:STOR:MACR “abc”,“MacroData1.mac” :MMEMory:STORe:STATe Saves the instrument setup to the specified file in the current directory.
Subsystem Commands :MMEMory:STORe:TRACe Example :MMEM:STOR:TRAC “AllTraceData1.
Subsystem Commands :OUTPut:FILTer:AUTO OUTPut Subsystem For the numeric suffix [c], see “Numeric Suffix” on page 1-8. :OUTPut:FILTer:AUTO Enables or disables the automatic filter function. Syntax :OUTPut[c]:FILTer:AUTO mode :OUTPut[c]:FILTer:AUTO? Parameter mode 1|ON|0|OFF (default). Parameter data type is boolean. mode=0 or OFF disables the automatic filter function. mode=1 or ON enables the automatic filter function.
Subsystem Commands :OUTPut:FILTer[:LPASs][:STATe] Parameter frequency value (31.830 Hz to +31.831 kHz)|MINimum|MAXimum| DEFault. Parameter data type is NRf+. Query does not support frequency=value. If you specify the value less than MIN or greater than MAX, frequency is automatically set to MIN or MAX. The cutoff frequency can be expressed by the following formula, using the time constant set by the :OUTPut:FILTer[:LPASs]:TCONstant command.
Subsystem Commands :OUTPut:FILTer[:LPASs]:TCONstant :OUTPut:FILTer[:LPASs]:TCONstant Sets the time constant instead of setting the cutoff frequency of the output filter. This command setting is ignored if the automatic filter function is enabled by the :OUTPut:FILTer:AUTO command. Syntax :OUTPut[c]:FILTer[:LPASs]:TCONstant time_constant :OUTPut[c]:FILTer[:LPASs]:TCONstant? [time_constant] Parameter time_constant value (5 s to 5 ms)|MINimum|MAXimum| DEFault. Parameter data type is NRf+.
Subsystem Commands :OUTPut:LOW Query response mode mode is 0 or 1, and indicates that the high capacitance mode is off or on, respectively. Response data type is NR1. Example :OUTP:HCAP 1 :OUTP2:HCAP:STAT? :OUTPut:LOW Selects the state of the low terminal. Before executing this command, the source output must be disabled by the :OUTPut[:STATe] command. Or else, an error occurs. Syntax :OUTPut[c]:LOW low_state :OUTPut[c]:LOW? Parameter low_state FLOat|GROund (default).
Subsystem Commands :OUTPut:OFF:MODE mode=1 or ON enables the automatic output off function. If this function is enabled, the source output is automatically turned off immediately when the grouped channels change status from busy to idle. Query response mode mode is 0 or 1, and indicates that the automatic output off function is off or on, respectively. Response data type is NR1. Example :OUTP:OFF:AUTO 1 :OUTP2:OFF:AUTO? :OUTPut:OFF:MODE Selects the source condition after output off.
Subsystem Commands :OUTPut:ON:AUTO NOTE This command setting is not applied to the output-off process triggered by the emergency condition such as the over voltage/current protection, interlock open, and over temperature protection. Then the output voltage is immediately set to 0 V and the output switch is set to off. Query response mode mode is NORM, HIZ, or ZERO, and indicates the source condition after output off. Response data type is CRD.
Subsystem Commands :OUTPut:RECall Syntax :OUTPut[c]:PROTection[:STATe] mode :OUTPut[c]:PROTection[:STATe]? Parameter mode 0|OFF|1|ON (default). Parameter data type is boolean. mode=0 or OFF disables the over voltage/current protection. mode=1 or ON enables the over voltage/current protection. Query response mode mode is 0 or 1, and indicates that the over voltage/current protection is off or on, respectively. Response data type is NR1.
Subsystem Commands :OUTPut[:STATe] Example :OUTP:SAVE 1 :OUTPut[:STATe] Enables or disables the source output. Syntax :OUTPut[c][:STATe] mode :OUTPut[c][:STATe]? Parameter mode 1|ON|0|OFF (default). Parameter data type is boolean. mode=1 or ON enables the source output. mode=0 or OFF disables the source output. Query response mode mode is 0 or 1, and indicates that the source output is off or on, respectively. Response data type is NR1.
Subsystem Commands :PROGram:CATalog? PROGram Subsystem For the numeric suffix [h], see “Numeric Suffix” on page 1-8. :PROGram:CATalog? Returns the names of all programs defined in the program memory. Even if a name is selected by the :PROGram[:SELected]:NAME command, this command does not return the name if the program is empty. Syntax :PROGram:CATalog? Query response program_names program_names returns the names of all programs defined in the program memory. Response data type is AARD.
Subsystem Commands :PROGram:PON:RUN :PROGram:PON:RUN Enables or disables the power-on program. The specified program automatically runs with each power-on. The program is specified by the :PROGram:PON:COPY command. Syntax :PROGram:PON:RUN mode mode 1|ON|0|OFF (default). Parameter data type is boolean. mode=1 or ON enables power-on program. mode=0 or OFF disables power-on program. Query response mode mode is 0 or 1, and indicates that the power-on program is disable or enable, respectively.
Subsystem Commands :PROGram[:SELected]:DEFine Before executing this command, the program must be selected by the :PROGram[:SELected]:NAME command with a new program name. Or else, an error occurs. Attempting to overwrite an existing program causes an error. Delete the program first by using the :PROGram[:SELected]:DELete[:SELected] command. Syntax :PROGram[:SELected]:DEFine program_code :PROGram[:SELected]:DEFine? Parameter program_code Program code. Up to 256 byte per execution.
Subsystem Commands :PROGram[:SELected]:DELete:ALL Example :PROG:NAME “program1” :PROG:DEF #220:SOUR:FUNC:MODE CURR :PROGram[:SELected]:DELete:ALL Deletes all programs stored in the program memory. If any of the programs are in the RUN state, this command causes an error and does not delete any program. Syntax :PROGram[:SELected]:DELete:ALL Example :PROG:DEL:ALL :PROGram[:SELected]:DELete[:SELected] Deletes a program stored in the program memory.
Subsystem Commands :PROGram[:SELected]:NAME :PROGram[:SELected]:NAME Selects the program for performing the action by the following commands. If name does not specify the program stored in the program memory, this command creates a new program with the specified name and selects the program. If name specifies an existing program, this command selects the program. Syntax :PROGram[:SELected]:NAME name :PROGram[:SELected]:NAME? Parameter name Query response name Program name.
Subsystem Commands :PROGram[:SELected]:WAIT? :PROG:SEL:STAT? Table 4-3 Execution Status Changed by :PROG:STAT Command Present execution status operation Running Paused Stopped RUN Error to Running to Running PAUSe to Paused Paused Stopped STEP Error to Running to Paused to Running to Paused STOP to Stopped to Stopped Stopped CONTinue Error to Running Error :PROGram[:SELected]:WAIT? Blocks other commands until the program execution status changes to Paused or Stopped.
Subsystem Commands :PROGram:VARiable :PROGram:VARiable[h]? Parameter value Example :PROG:VAR “1” Value of the variable specified by h. Up to 32 ASCII characters. Parameter data type is SPD.
Subsystem Commands :READ:ARRay? READ Subsystem :READ:ARRay? Executes the :INITiate command and the :FETCh:ARRay? command in series, and returns the array data which contains all of the voltage measurement data, current measurement data, resistance measurement data, time data, status data, or source output setting data specified by the :FORMat:ELEMents:SENSe command. The data is not cleared until the :INITiate, :MEASure, or :READ command is executed.
Subsystem Commands :READ:ARRay:? Example :FORM:ELEM:SENS CURR,SOUR :READ:ARR? (@1,2) :READ:ARRay:? Executes the :INITiate command and the :FETCh:ARRay:? command in series, and returns the array data which contains all of the current measurement data, resistance measurement data, source output setting data, status data, time data, or voltage measurement data specif
Subsystem Commands :READ[:SCALar]? This example shows the data containing the current data (ch1currN) of the 10-step sweep measurement by channel 1, and the current data (ch2currN) of the 5-step sweep measurement by channel 2. If the measurement function is not enabled or no data exists, response returns +9.910000E+37 (ASCII) or NaN (IEEE-754) which indicates “not a number”.
Subsystem Commands :READ[:SCALar]: ? Example :FORM:ELEM:SENS CURR,SOUR :READ? (@1,2) :READ[:SCALar]:? Executes the :INITiate command and the :FETCh[:SCALar]:? command in series, and returns the latest current measurement data, resistance measurement data, source output setting data, status data, time data, or voltage measurement data specified by CURRent, RESistan
Subsystem Commands :READ[:SCALar]: ? If the measurement function is not enabled or no data exists, response returns +9.910000E+37 (ASCII) or NaN (IEEE-754) which indicates “not a number”.
Subsystem Commands :SENSe::APERture SENSe Subsystem For the numeric suffix [c], see “Numeric Suffix” on page 1-8. :SENSe:: APERture Sets the integration time for one point measurement. Syntax :SENSe[c]::APERture time :SENSe[c]::APERture? [time] For , set CURRent[:DC], RESistance, or VOLTage[:DC].
Subsystem Commands :SENSe::NPLCycles Syntax :SENSe[c]::APERture:AUTO mode :SENSe[c]::APERture:AUTO? For , set CURRent[:DC], RESistance, or VOLTage[:DC]. Specifying the measurement item is not important because the mode value is common for all items. Parameter mode 0|OFF|1|ON (default). Parameter data type is boolean.
Subsystem Commands :SENSe::NPLCycles:AUTO Parameter nplc value (+4E-4 to +100 for 50 Hz or +4.8E-4 to +120 for 60 Hz)|MINimum|MAXimum|DEFault (default is 0.1 PLC, power line cycles). Parameter data type is NRf+. Query does not support nplc=value. If you specify the value less than MIN or greater than MAX, nplc is automatically set to MIN or MAX.
Subsystem Commands :SENSe::PROTection[:LEVel] Query response mode mode is 0 or 1, and indicates that the automatic NPLC function is off or on, respectively. Response data type is NR1. Example :SENS:CUR:NPLC:AUTO 0 :SENS2:CURR:DC:NPLC:AUTO? :SENSe::PROTection [:LEVel] Sets the compliance value of the specified channel.
Subsystem Commands :SENSe::RANGe:AUTO For , specify CURRent[:DC] for current compliance, or VOLTage[:DC] for voltage compliance. Query response status status is 1 or 0, and indicates if the channel is in the compliance state or not. Response data type is NR1.
Subsystem Commands :SENSe::RANGe:AUTO:LLIMit :SENSe:: RANGe:AUTO:LLIMit Specifies the lower limit for the automatic measurement ranging operation, and sets the minimum measurement range which provides the best resolution to measure the specified value. If the minimum measurement range is the same as the maximum measurement range, the measurement is performed by using this range.
Subsystem Commands :SENSe::RANGe:AUTO:MODE :SENSe::RANGe:AU TO:MODE Selects the operation mode of the automatic measurement ranging. This command setting is not effective if the automatic ranging is disabled by the :SENSe::RANGe:AUTO command.
Subsystem Commands :SENSe::RANGe:AUTO:THReshold mode returns NORM, RES, or SPE, and indicates that the operation mode of automatic measurement ranging. Response data type is CRD. Example :SENS:CURR:RANG:AUTO:MODE SPE :SENS2:CURR:DC:RANG:AUTO:MODE? :SENSe::RANGe:AU TO:THReshold Sets the threshold rate for the automatic measurement ranging operation.
Subsystem Commands :SENSe::RANGe[:UPPer] Syntax :SENSe[c]:RESistance:RANGe:AUTO:ULIMit range :SENSe[c]:RESistance:RANGe:AUTO:ULIMit? [range] :SENSe[c]:[:DC]:RANGe:AUTO:ULIMit? For , specify CURRent for the current measurement, or VOLTage for the voltage measurement. Parameter range Query response range value (see Table 2-9)|MINimum|MAXimum| DEFault (default is 200 M). Parameter data type is NRf+.
Subsystem Commands :SENSe:DATA? value for resistance measurement: See Table 2-9. This is available for the resistance measurements set to the AUTO mode which is selected by the :SENSe:RESistance:MODE command. range=UP sets the next higher measurement range. range=DOWN sets the next lower measurement range. Query response range range returns the present setting of the measurement range. If a parameter is specified, range returns the value assigned to DEF, MIN, or MAX. Response data type is NR3.
Subsystem Commands :SENSe:DATA:LATest? As shown in the following example, response may contain multiple data and elements. This example contains the current data (ch1currN) and source data (ch1sourN) of the 10-step sweep measurement by channel 1. With the ASCII data output format, each data is separated by a comma. ch1curr1,ch1sour1,ch1curr2,ch1sour2, ...... ch1curr10,ch1sour10 If the measurement function is not enabled or no data exists, response returns +9.
Subsystem Commands :SENSe:FUNCtion:OFF:ALL :SENSe[c]:FUNCtion:OFF? Parameter function “CURRent[:DC]”|“VOLTage[:DC]”|“RESistance” (default). Case insensitive. Parameter data type is SPD. function=“CURRent[:DC]” selects the current measurement function. function=“VOLTage[:DC]” selects the voltage measurement function. function=“RESistance” selects the resistance measurement function.
Subsystem Commands :SENSe:FUNCtion[:ON]:ALL Parameter function “CURRent[:DC]”|“VOLTage[:DC]”|“RESistance” Default is “VOLT”,“CURR”. Case insensitive. Parameter data type is SPD. function=“CURRent[:DC]” selects the current measurement function. function=“VOLTage[:DC]” selects the voltage measurement function. function=“RESistance” selects the resistance measurement function. See “:SENSe:RESistance:MODE” on page 4-86 for resistance measurements.
Subsystem Commands :SENSe:REMote Parameter function “CURRent[:DC]”|“VOLTage[:DC]”|“RESistance”. Parameter data type is SPD. function=“CURRent[:DC]” specifies the current measurement function. function=“VOLTage[:DC]” specifies the voltage measurement function. function=“RESistance” specifies the resistance measurement function. Query response response response returns 0 or 1, and indicates that the specified measurement function is now disabled or enabled respectively.
Subsystem Commands :SENSe:RESistance:OCOMpensated Parameter mode MANual (default)|AUTO. Parameter data type is CPD. If mode=MANual is selected, the source and measurement condition must be set manually. If the resistance measurement function is enabled, the resistance is calculated by voltage/current. The resistance measurement range cannot be set. If mode=AUTO is selected, the channel automatically sets the current source and voltage measurement if the resistance measurement function is enabled.
Subsystem Commands :SENSe:TOUTput:SIGNal mode=1 or ON enables offset-compensated resistance measurement. Query response mode mode is 0 or 1, and indicates that offset-compensated resistance measurement is off or on, respectively. Response data type is NR1. Example :SENS:RES:OCOM 1 :SENS2:RES:OCOM? :SENSe:TOUTput:SIGNal Selects the trigger output for the status change between the trigger layer and the acquire device action. Multiple trigger output ports can be set.
Subsystem Commands :SENSe:WAIT:AUTO :SENSe[c]:TOUTput[:STATe]? Parameter mode Trigger output ON or OFF. 1|ON|0|OFF (default). Parameter data type is boolean. mode=1 or ON enables the trigger output. mode=0 or OFF disables the trigger output. Query response response response returns 1 or 0, and indicates that the trigger output is on or off, respectively. Response data type is NR1.
Subsystem Commands :SENSe:WAIT:GAIN :SENSe:WAIT:GAIN Sets the gain value used for calculating the measurement wait time for the specified channel. See :SENSe:WAIT[:STATe]. Syntax :SENSe[c]:WAIT:GAIN gain :SENSe[c]:WAIT:GAIN? [gain] Parameter gain Query response gain value (0 to 100)|MINimum|MAXimum|DEFault (default is 1). Parameter data type is NRf. Query does not support gain=value. gain returns the present setting of the gain value.
Subsystem Commands :SENSe:WAIT[:STATe] :SENSe:WAIT[:STATe] Enables or disables the measurement wait time for the specified channel. The wait time is defined as the time the measurement channel cannot start measurement after the start of a DC output or the trailing edge of a pulse. Syntax :SENSe[c]:WAIT[:STATe] mode :SENSe[c]:WAIT[:STATe]? Parameter mode 0|OFF|1|ON (default). Parameter data type is boolean. mode=0 or OFF disables the measurement wait time. The wait time is set to 0.
Subsystem Commands [:SOURce]:: SOURce Subsystem For the numeric suffixes [c] and [n], see “Numeric Suffix” on page 1-8. [:SOURce]:: Sets the center or span value of the current or voltage sweep output. Syntax [:SOURce[c]]:: data [:SOURce[c]]::? [data] For , specify CURRent for current output, or VOLTage for voltage output.
Subsystem Commands [:SOURce]:[:LEVel]:TRIGgered[:AMPLitude] Syntax [:SOURce[c]]:[:LEVel][:IMMediate][:AMPLitude] level [:SOURce[c]]:[:LEVel][:IMMediate][:AMPLitude]? [level] For , specify CURRent for current output, or VOLTage for voltage output. Parameter level Query response level Current or voltage output level. value (see “Source Output Ranges” on page 2-24) |MINimum|MAXimum|DEFault (default is 0).
Subsystem Commands [:SOURce]::MODE Example :VOLT:TRIG 3 :SOUR2:CURR:LEV:TRIG:AMPL? [:SOURce]::MODE Selects the source mode, fixed, list sweep, or sweep, of the specified source channel. Syntax [:SOURce[c]]::MODE mode [:SOURce[c]]::MODE? Parameter mode Source mode. SWEep|LIST|FIXed (default). Parameter data type is CPD. mode=FIX sets the constant current or voltage source.
Subsystem Commands [:SOURce]::RANGe points = span/step + 1 (where step is not 0) points=1 sets step=0. If points is changed, span works as a constant and step is changed. If step is changed, span works as a constant and points is changed. If span is changed, points works as a constant and step is changed. The calculated points value is rounded down to an integer.
Subsystem Commands [:SOURce]::RANGe:AUTO Example :CURR:RANG 1E-6 :SOUR2:VOLT:RANG? [:SOURce]::RANGe:AUTO Enables or disables the automatic ranging function for the specified source channel. Syntax [:SOURce[c]]::RANGe:AUTO mode [:SOURce[c]]::RANGe:AUTO? For , specify CURRent for current output, or VOLTage for voltage output. Parameter mode 0|OFF|1|ON (default). Parameter data type is boolean.
Subsystem Commands [:SOURce]:: For , specify CURRent for current output, or VOLTage for voltage output. Parameter range value (see “Source Output Ranges” on page 2-24) |MINimum| MAXimum|DEFault. Parameter data type is NRf+. Query does not support range=value. value for current output: See Table 2-6. value for voltage output: See Table 2-4. Query response range range returns the present setting.
Subsystem Commands [:SOURce]::STEP Query response data data returns the present setting. If a parameter is specified, data returns the value assigned to DEF, MIN, or MAX. Response data type is NR3. Example :VOLT:STOP 10 :SOUR2:CURR:STAR? [:SOURce]::STEP Sets the sweep step value of the current or voltage sweep output.
Subsystem Commands [:SOURce]:DIGital:DATA step returns the present setting. If a parameter is specified, step returns the value assigned to DEF, MIN, or MAX. Response data type is NR3. Example :VOLT:STEP 0.5 :SOUR2:CURR:STEP? [:SOURce]:DIGital:DATA Sets the output data to the GPIO pins (digital control port) and read data from the GPIO pins. Syntax [:SOURce]:DIGital:DATA data [:SOURce]:DIGital:DATA? Parameter data Query response data Output data. value (0 to 16383)(default is 0).
Subsystem Commands [:SOURce]:DIGital:EXTernal[n]:POLarity function=TINP assigns the trigger input. function=TOUT assigns the trigger output. Query response function function returns DIO, DINP, TOUT, or TINP. Response data type is CRD. Example :DIG:EXT TOUT :SOUR:DIG:EXT14:FUNC? [:SOURce]:DIGital:EXTernal[n]:POLarity Sets the polarity of the input/output function for the specified GPIO pin.
Subsystem Commands [:SOURce]:DIGital:EXTernal[n]:TOUTput[:EDGE]:WIDTh Parameter position Output trigger timing. BEFore|AFTer|BOTH (default). Parameter data type is CPD. type=BEFore enables trigger output at the beginning of arm, trigger, and device actions (transient or acquire). type=AFTer enables trigger output at the end of arm, trigger, and device actions (transient or acquire). type=BOTH enables trigger output at both beginning and end of arm, trigger, and device actions (transient or acquire).
Subsystem Commands [:SOURce]:DIGital:INTernal[c]:TOUTput[:EDGE]:POSition Syntax [:SOURce]:DIGital:EXTernal[n]:TOUTput:TYPE type [:SOURce]:DIGital:EXTernal[n]:TOUTput:TYPE? Parameter type Trigger type. EDGE (default)|LEVel. Parameter data type is CPD. type=EDGE selects the Edge trigger. type=LEVel selects the Level trigger. Query response response response returns the present setting of trigger type, EDGE or LEV. Response data type is CRD.
Subsystem Commands [:SOURce]:FUNCtion:MODE :SOUR:DIG:INT2:TOUT:POS? [:SOURce]:FUNCtion:MODE Selects the source output mode of the specified channel. Syntax [:SOURce[c]]:FUNCtion:MODE mode [:SOURce[c]]:FUNCtion:MODE? Parameter mode Source output mode. CURRent|VOLTage (default). Parameter data type is CPD. mode=CURR sets the specified channel to the current source. Voltage compliance for the current source is set by the :SENS:VOLT:PROT[:LEV] command.
Subsystem Commands [:SOURce]:FUNCtion:TRIGgered:CONTinuous shape returns DC or PULS. Response data type is CRD. Example :FUNC PULS :SOUR2:FUNC:SHAP? [:SOURce]:FUNCtion:TRIGgered:CONTinuous Enables or disables continuous trigger output for the specified channel. Syntax [:SOURce[c]]:FUNCtion:TRIGgered:CONTinuous mode [:SOURce[c]]:FUNCtion:TRIGgered:CONTinuous? Parameter mode 0|OFF (default)|1|ON. Parameter data type is boolean. mode=1 or ON enables continuous trigger output.
Subsystem Commands [:SOURce]:LIST::APPend Parameter list List of the output current or voltage data. Default is 0. Parameter data type is NRf. Maximum of 2500 data can be set to list. Each data must be separated by a comma, for example: list=0.1,0.2,0.3. For effective values of the output current or voltage data, see “Source Output Ranges” on page 2-24. Query response list list returns the present setting of the list. Multiple data is separated by a comma.
Subsystem Commands [:SOURce]:LIST::STARt For , specify CURRent for current output, or VOLTage for voltage output. Query response number_of_data number_of_data returns the number of data in the list. Response data type is NR1. Example :LIST:VOLT:POIN? :SOUR2:LIST:CURR:POIN? [:SOURce]:LIST::STARt Specifies the list sweep start point by using the index of the list.
Subsystem Commands [:SOURce]:PULSe:WIDTh Parameter delay Query response delay Delay time. value (0.0 to 99999.9, in seconds)|MINimum| MAXimum|DEFault (default is 0). Parameter data type is NRf+. Query does not support delay=value. delay returns the present setting. If a parameter is specified, delay returns the value assigned to DEF, MIN, or MAX. Response data type is NR3. Example :PULS:DEL 1E-3 :SOUR2:PULS:DEL? [:SOURce]:PULSe:WIDTh Sets the pulse width for the specified channel.
Subsystem Commands [:SOURce]:SWEep:POINts Syntax [:SOURce[c]]:SWEep:DIRection direction [:SOURce[c]]:SWEep:DIRection? Parameter direction Sweep direction. DOWN|UP (default). Parameter data type is CPD. direction=UP sets the sweep direction from start value to stop value. The sweep measurement is performed from the start value to the stop value given by the following formula, even if the specified stop value does not satisfy it.
Subsystem Commands [:SOURce]:SWEep:RANGing If points is changed, span works as a constant and step is changed. If step is changed, span works as a constant and points is changed. If span is changed, points works as a constant and step is changed. The calculated points value is rounded down to an integer. The sweep measurement is performed from the start value to the stop value given by the following formula, even if the specified stop value does not satisfy it.
Subsystem Commands [:SOURce]:SWEep:SPACing mode returns the present setting of the output ranging mode, BEST, FIX, or AUTO. Response data type is CRD. Example :SWE:RANG BEST :SOUR2:SWE:RANG? [:SOURce]:SWEep:SPACing Selects the scale of the sweep output for the specified channel. Syntax [:SOURce[c]]:SWEep:SPACing mode [:SOURce[c]]:SWEep:SPACing? Parameter mode Sweep scale. LOGarithmic|LINear (default). Parameter data type is CPD. mode=LIN selects the linear scale sweep output.
Subsystem Commands [:SOURce]:TOUTput:SIGNal mode=DOUBle sets the sweep mode to double sweep. Double sweep performs the sweep from start to stop to start. Query response mode mode returns SING or DOUB, and indicates that the sweep mode is single or double, respectively. Response data type is CRD. Example :SWE:STA DOUB :SOUR2:SWE:STA? [:SOURce]:TOUTput:SIGNal Selects the trigger output for the status change between the trigger layer and the transient device action.
Subsystem Commands [:SOURce]:WAIT:AUTO Syntax [:SOURce[c]]:TOUTput[:STATe] mode [:SOURce[c]]:TOUTput[:STATe]? Parameter mode Trigger output ON or OFF. 1|ON|0|OFF (default). Parameter data type is boolean. mode=1 or ON enables the trigger output. mode=0 or OFF disables the trigger output. Query response response response returns 1 or 0, and indicates that the trigger output is on or off, respectively. Response data type is NR1.
Subsystem Commands [:SOURce]:WAIT:GAIN [:SOURce]:WAIT:GAIN Sets the gain value used for calculating the source wait time for the specified channel. See [:SOURce]:WAIT[:STATe]. Syntax [:SOURce[c]]:WAIT:GAIN gain [:SOURce[c]]:WAIT:GAIN? [gain] Parameter gain Query response gain value (0 to 100)|MINimum|MAXimum|DEFault (default is 1). Parameter data type is NRf. Query does not support gain=value. gain returns the present setting of the gain value.
Subsystem Commands [:SOURce]:WAIT[:STATe] [:SOURce]:WAIT[:STATe] Enables or disables the source wait time for the specified channel. This wait time is defined as the time the source channel cannot change the output after the start of a DC output or the trailing edge of a pulse. Syntax [:SOURce[c]]:WAIT[:STATe] mode [:SOURce[c]]:WAIT[:STATe]? Parameter mode 0|OFF|1|ON (default). Parameter data type is boolean. mode=0 or OFF disables the source wait time. The wait time is set to 0.
Subsystem Commands :STATus::CONDition? STATus Subsystem :STATus:: CONDition? Returns the value of the measurement, operation, or questionable status condition register. See Table 4-4 to 4-6 for the bit definitions. The register setting is not changed by this command.
Subsystem Commands :STATus::CONDition? bit decimal value 8 256 Calibration Channel 1 and/or 2 failed calibration. 9 512 Self-test Channel 1 and/or 2 failed self-test. 10 1024 Interlock Interlock circuit is open.
Subsystem Commands :STATus::CONDition? Table 4-6 Operation Status Condition Register Bit Definitions bit decimal value 0 1 Calibration/Self-test Running Self-calibration or Self-test is in progress. 1 2 Ch1 Transition Idle Channel 1 is in the transition idle state. 2 4 Ch1 Waiting for Transition Trigger Channel 1 is waiting for the transition trigger. 3 8 Ch1 Waiting for Transition Arm Channel 1 is waiting for the transition arm.
Subsystem Commands :STATus::ENABle :STATus:: ENABle Sets the measurement, operation, or questionable status enable register. The enable register is a mask which allows true conditions in the event register to be reported in the summary bit.
Subsystem Commands :STATus::NTRansition value returns the present setting of the specified event register. It is the sum of the binary-weighted values for the set bits. Response data type is NR1 (decimal) or NDN (binary, octal, or hexadecimal) selected by the :FORMat:SREGister command.
Subsystem Commands :STATus::PTRansition :STATus:: PTRansition Sets the positive transition filter in the measurement, operation, or questionable status register. If you set a bit of the filter, a 0-to-1 transition of its register bit sets the corresponding bit of the event register.
Subsystem Commands :STATus:QUEStionable::CONDition? Syntax :STATus:QUEStionable::C ONDition? For , specify CALibration for the questionable calibration status condition register, CURRent for the questionable current status condition register, TEMPerature for the questionable temperature status condition register, TEST for the questionable self-test status condition regi
Subsystem Commands :STATus:QUEStionable::CONDition? Table 4-8 Questionable Current Register Bit Definitions bit decimal value 0 1 Ch1 Over Current Over current in channel 1. 1 2 Ch2 Over Current Over current in channel 2. Not used 0 is returned. 3 to 15 Table 4-9 description definition Questionable Temperature Register Bit Definitions bit decimal value 0 1 Ch1 Over Temperature Over temperature in channel 1.
Subsystem Commands :STATus:QUEStionable::ENABle :STATus:QUEStionable::ENABle Sets the questionable calibration, current, temperature, test, or voltage status enable register. The enable register is a mask which allows true conditions in the event register to be reported in the summary bit.
Subsystem Commands :STATus:QUEStionable::NTRansition For , specify CALibration for the questionable calibration status condition register, CURRent for the questionable current status condition register, TEMPerature for the questionable temperature status condition register, TEST for the questionable self-test status condition register, or VOLTage for the questionable voltage status condition register.
Subsystem Commands :STATus:QUEStionable::PTRansition filter returns the present setting of the negative transition filter in the specified register. Response data type is NR1 (decimal) or NDN (binary, octal, or hexadecimal) selected by the :FORMat:SREGister command.
Subsystem Commands :SYSTem:BEEPer[:IMMediate] SYSTem Subsystem For the numeric suffix [c], see “Numeric Suffix” on page 1-8. :SYSTem:BEEPer[:IMMediate] Generates a beep sound of the specified frequency and duration. Syntax :SYSTem:BEEPer[:IMMediate] frequency, time Parameter frequency Frequency, in Hz. 55 to 6640 Hz. Parameter data type is NRf. time Duration, in seconds. 0.05 to 12.75 seconds. Parameter data type is NRf+. Example :SYST:BEEP 100,0.
Subsystem Commands :SYSTem:COMMunicate:ENABle :SYSTem:COMMunicate:ENABle Enables or disables the remote interface GPIB, USB, or LAN, the remote service Sockets, Telnet, VXI-11, HiSLIP, or the built-in Web Interface. The setting is effective after rebooting the instrument. This command setting is not changed by power off or the *RST command. Syntax :SYSTem:COMMunicate:ENABle mode, interface :SYSTem:COMMunicate:ENABle? interface Parameter mode Interface on or off. 1|ON|0|OFF.
Subsystem Commands :SYSTem:COMMunicate:LAN:ADDRess :SYSTem:COMMunicate:LAN:ADDRess Sets the static LAN (IP) address of the instrument. The setting is enabled by the :SYSTem:COMMunicate:LAN:UPDate command. This command setting is not changed by power off or the *RST command. Syntax :SYSTem:COMMunicate:LAN:ADDRess address :SYSTem:COMMunicate:LAN:ADDRess? [CURRent|STATic] Parameter address Query response address IP address of the instrument. It must be in the A.B.C.
Subsystem Commands :SYSTem:COMMunicate::CONTrol? :SYSTem:COMMunicate::CONTrol? Returns the control connection port number of the specified port. Syntax :SYSTem:COMMunicate::CONTrol? Query response port_number port_number returns the control connection port number of the specified port. Response data type is NR1. Example :SYST:COMM:TCP:CONT? :SYSTem:COMMunicate:LAN:DHCP Enables or disables the use of the Dynamic Host Configuration Protocol (DHCP).
Subsystem Commands :SYSTem:COMMunicate:LAN:DNS :SYSTem:COMMunicate:LAN:DNS Sets the IP address of the DNS server. This command setting is not changed by power off or the *RST command. Syntax :SYSTem:COMMunicate:LAN:DNS[c] address :SYSTem:COMMunicate:LAN:DNS[c]? [CURRent|STATic] Parameter address Query response address IP address of the DNS server. It must be in the A.B.C.D format with 15 characters maximum. A, B, C, and D must be a number from 0 to 255. Parameter data type is SPD.
Subsystem Commands :SYSTem:COMMunicate:LAN: Parameter address Query response address IP address of the default gateway. It must be in the A.B.C.D format with 15 characters maximum. A, B, C, and D must be a number from 0 to 225. Parameter data type is SPD. address returns the IP address of the default gateway. If the CURRent parameter is set, address returns the present setting. If the STATic parameter is set, address returns the reserved value for the next startup.
Subsystem Commands :SYSTem:COMMunicate:LAN:SMASk mac_address returns the MAC address of the instrument. Response data type is SRD. Example :SYST:COMM:LAN:MAC? :SYSTem:COMMunicate:LAN:SMASk Sets the static subnet mask. The setting is enabled by the :SYSTem:COMMunicate:LAN:UPDate command. This command setting is not changed by power off or the *RST command.
Subsystem Commands :SYSTem:COMMunicate:LAN:TELNet:WMESsage Parameter prompt Query response prompt Command prompt. Up to 15 characters. Parameter data type is SPD. prompt returns the command prompt. Response data type is SRD. Example :SYST:COMM:LAN:TELN:PROM “A-B2911A-00001> ” :SYST:COMM:LAN:TELN:PROM? :SYSTem:COMMunicate:LAN:TELNet:WMESsage Sets the welcome message displayed during a Telnet session when starting communication with the instrument.
Subsystem Commands :SYSTem:COMMunicate:LAN:WINS :SYSTem:COMMunicate:LAN:WINS Sets the IP address of the WINS server. This command setting is not changed by power off or the *RST command. Syntax :SYSTem:COMMunicate:LAN:WINS[c] address :SYSTem:COMMunicate:LAN:WINS[c]? [CURRent|STATic] Parameter address Query response address IP address of the WINS server. It must be in the A.B.C.D format with 15 characters maximum. A, B, C, and D must be a number from 0 to 255. Parameter data type is SPD.
Subsystem Commands :SYSTem:DATE :SYSTem:DATE Sets the date of the internal clock. This command setting is not changed by power off or the *RST command. Syntax :SYSTem:DATE year, month, day :SYSTem:DATE? Parameter Query response year Year. 4-digit integer. Parameter data type is NR1. month Month. Integer from 1 to 12. Parameter data type is NR1. day Day. Integer from 1 to 31. Parameter data type is NR1. response response returns year, month, day. Each value is separated by a comma.
Subsystem Commands :SYSTem:ERRor:CODE[:NEXT]? code returns the error/event code. Multiple responses are listed in the FIFO (first-in-first-out) order, separated by a comma. Response data type is NR1. If the queue is empty, the response is +0. Example :SYST:ERR:CODE:ALL? :SYSTem:ERRor:CODE[:NEXT]? Reads and removes the top item in the error/event queue, and returns the top code. Syntax :SYSTem:ERRor:CODE[:NEXT]? Query response code code returns the error/event code. Response data type is NR1.
Subsystem Commands :SYSTem:FAN:MODE response returns code,message which contains the error/event code and message. Multiple responses are listed in the FIFO (first-in-first-out) order, separated by a comma. Data type of code is NR1 and message is SRD. If the queue is empty, the response is +0,“No error”. Example :SYST:ERR? :SYSTem:FAN:MODE Sets the fan control mode. This command setting is not changed by power off or the *RST command.
Subsystem Commands :SYSTem:GROup:RESet Syntax :SYSTem:GROup[:DEFine] grouplist :SYSTem:GROup[:DEFine]? Parameter grouplist Channel group setting. Parameter data type is channel list. See “Channel List Parameter” on page 1-8. grouplist=(@1,2) for making the group of the channels 1 and 2, or grouplist=(@1),(@2) for breaking the group. Query response grouplist grouplist returns the channel group setting. Response data type is channel list.
Subsystem Commands :SYSTem:LFRequency Syntax :SYSTem:LANGuage mode :SYSTem:LANGuage? Parameter mode B2900 control command set. “DEFault”|“2400”. Parameter data type is SPD. mode=“DEF” selects the default command set which supports all B2900 functions. mode=“2400” selects the conventional command set designed for existing programs which you created for controlling existing instruments, such as Series 2400 by Keithley Instruments, Inc.
Subsystem Commands :SYSTem:LOCK:NAME? :SYSTem:LOCK:NAME? Returns the current I/O interface (the I/O interface in use by the querying computer). Syntax :SYSTem:LOCK:NAME? Query response response response returns GPIB, USB, VXI11, or LAN , indicating the I/O interface being used by the querying computer. Example :SYST:LOCK:NAME? Remarks Use this command to determine the interface you are currently using.
Subsystem Commands :SYSTem:LOCK:REQuest? Remarks When a lock is active, Bit 13 in the Standard Operation Register will be set (see :STATus::CONDition? command). When the lock is released on all I/O interfaces, this bit will be cleared. Note that for each successful lock request, a lock release is required. Two requests require two releases. :SYSTem:LOCK:REQuest? Requests a lock of the current I/O interface.
Subsystem Commands :SYSTem:PRESet The power-on state can be selected from the factory default reset condition (RST) and user conditions RCL0, RCL1, RCL2, RCL3, and RCL4 which can be defined by the *SAV 0, *SAV 1, *SAV 2, *SAV 3, and *SAV 4 commands, respectively. Syntax :SYSTtem:PON memory Parameter memory Example :SYST:PON RCL0 Power-on state, RST(default)|RCL0|RCL1|RCL2|RCL3|RCL4 Parameter data type is CPD. :SYSTem:PRESet Presets the instrument settings and the front panel display.
Subsystem Commands :SYSTem:TIME:TIMer:COUNt? Query response minute Minute. Integer from 0 to 59. Parameter data type is NR1. second Second. Integer from 0 to 59. Parameter data type is NR1. response response returns hour, minute, second. Each value is separated by a comma. Response data type is NR1. Example :SYST:TIME 23,59,59 :SYSTem:TIME:TIMer:COUNt? Returns the present count of the timer.
Subsystem Commands :SYSTem:TIME:TIMer:COUNt:RESet[:IMMediate] :SYST:TIME:TIM:COUN:RES:AUTO? :SYSTem:TIME:TIMer:COUNt:RESet[:IMMediate] Resets the timer count immediately. Syntax :SYSTem:TIME:TIMer:COUNt:RESet[:IMMediate] Example :SYST:TIME:TIM:COUN:RES :SYSTem:VERSion? Returns the version of the SCPI standard. This command setting is not changed by power off or the *RST command. Syntax :SYSTem:VERSion? Query response response response returns the version of the SCPI standard.
Subsystem Commands :TRACe:CLEar TRACe Subsystem For the numeric suffix [c], see “Numeric Suffix” on page 1-8. :TRACe:CLEar Clears the trace buffer of the specified channel. This command is effective when the trace buffer control mode is set to NEV by the :TRACe:FEED:CONTrol command. Syntax :TRACe[c]:CLEar Example :TRAC2:CLE :TRACe:DATA? Returns data in the trace buffer. The data placed in the buffer is specified by the :TRACe:FEED command.
Subsystem Commands :TRACe:FEED :TRACe:FEED Specifies the data placed in the trace buffer. This command is effective when the trace buffer control mode is set to NEV by the :TRACe:FEED:CONTrol command. Syntax :TRACe[c]:FEED type :TRACe[c]:FEED? Parameter type Data type. MATH|LIMit|SENSe (default). Parameter data type is CPD.
Subsystem Commands :TRACe:FREE? mode=NEV disables write operation to the trace buffer. The :TRACe:CLEar, :TRACe:FEED, and :TRACe:POINts commands can be used. mode=NEXT enables write operation until buffer full. Buffer full changes mode to NEV automatically. No error occurs. Query response mode mode returns the present setting of the control mode, NEXT or NEV. Response data type is CRD.
Subsystem Commands :TRACe:POINts:ACTual? Example :TRAC:POIN 10000 :TRAC2:POIN? :TRACe:POINts:ACTual? Returns the number of data in the trace buffer. Syntax :TRACe[c]:POINts:ACTual? Query response points points returns the number of data in the trace buffer. Response data type is NR1. Example :TRAC2:POIN:ACT? :TRACe:STATistic:DATA? Returns the result of the statistical operation for the data stored in the trace buffer.
Subsystem Commands :TRACe:TSTamp:FORMat Parameter operation Statistical operation. MINimum|MAXimum|SDEViation| PKPK|MEAN (default). Parameter data type is CPD. operation=MEAN sets the operation for obtaining the mean value. operation=SDEV sets the operation for obtaining the standard deviation. operation=PKPK sets the operation for obtaining the peak to peak value. operation=MIN sets the operation for obtaining the minimum value. operation=MAX sets the operation for obtaining the maximum value.
Subsystem Commands :ABORt<:ACQuire|:TRANsient|[:ALL]> TRIGger Subsystem For the numeric suffix [c], see “Numeric Suffix” on page 1-8. :ABORt<:ACQuire|:TRANsient|[:ALL]> Aborts the specified device action for the specified channel. Trigger status is changed to idle. Syntax :ABORt<:ACQuire|:TRANsient|[:ALL]> [chanlist] For <:ACQuire|:TRANsient|[:ALL]>, specify :ACQuire for measurement, :TRANsient for source output, or :ALL for both device actions. Parameter chanlist Channels.
Subsystem Commands :ARM<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:BYPass If this parameter is not specified, chanlist=(@1) is set. Example :ARM:ACQ (@2) :ARM<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:BYPas s Enables or disables a bypass for the event detector in the arm layer.
Subsystem Commands :ARM<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:DELay Parameter arm_count Arm count. value (1 to 100000 or 2147483647)|INFinity| MINimum|MAXimum|DEFault (default is 1). Parameter data type is NRf+. value=2147483647 indicates infinity. Query does not support arm_count=value and INFinity. Arm count Trigger count must be less than 100001. Query response response response returns the present setting of arm count.
Subsystem Commands :ARM<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:SOURce:LAN :ARM<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:SOUR ce:LAN Specifies one or more LXI triggers used for the arm source for the specified device action. Syntax :ARM[c]<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:SOURce:LAN lan_id{,lan_id} :ARM[c]<:ACQuire|:TRANsient>[:LAYer]:SOURce:LAN? For <:ACQuire|:TRANsient|[:ALL]> and <:ACQuire|:TRANsient>, specify :ACQuire for measurement, :TRANsient for source output, or :ALL for both device actions.
Subsystem Commands :ARM<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:TIMer source=AINT (automatic internal) automatically selects the arm source most suitable for the present operating mode by using internal algorithms. source=BUS selects the remote interface trigger command such as the group execute trigger (GET) and the *TRG command. source=TIMer selects a signal internally generated every interval set by the :ARM<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:TIMer command.
Subsystem Commands :ARM<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:TOUTput:SIGNal Example :ARM:TIM 2E-4 :ARM2:TRAN:TIM? :ARM<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:TOUT put:SIGNal Selects the trigger output for the status change between the idle state and the arm layer. Multiple trigger output ports can be set.
Subsystem Commands :IDLE<:ACQuire|:TRANsient|[:ALL]>? Syntax :ARM[c]<:ACQuire|:TRANsient|[:ALL]>[:LAYer]:TOUTput[:STATe] mode :ARM[c]<:ACQuire|:TRANsient>[:LAYer]:TOUTput[:STATe]? For <:ACQuire|:TRANsient|[:ALL]> and <:ACQuire|:TRANsient>, specify :ACQuire for measurement, :TRANsient for source output, or :ALL for both device actions. Parameter mode Trigger output ON or OFF. 1|ON|0|OFF (default). Parameter data type is boolean. mode=1 or ON enables the trigger output.
Subsystem Commands :INITiate[:IMMediate]<:ACQuire|:TRANsient|[:ALL]> :INITiate[:IMMediate]<:ACQuire|:TRANsient|[:ALL]> Initiates the specified device action for the specified channel. Trigger status is changed from idle to initiated. Syntax :INITiate[:IMMediate]<:ACQuire|:TRANsient|[:ALL]> [chanlist] For <:ACQuire|:TRANsient|[:ALL]>, specify :ACQuire for measurement, :TRANsient for source output, or :ALL for both device actions. Parameter chanlist Channels. Parameter data type is channel list.
Subsystem Commands :TRIGger<:ACQuire|:TRANsient|[:ALL]>:COUNt :TRIG2:TRAN:BYP? :TRIGger<:ACQuire|:TRANsient|[:ALL]>:COUNt Sets the trigger count for the specified device action. Syntax :TRIGger[c]<:ACQuire|:TRANsient|[:ALL]>:COUNt trigger_count :TRIGger[c]<:ACQuire|:TRANsient>:COUNt? [trigger_count] :TRIGger[c][:ALL]:COUNt? trigger_count For <:ACQuire|:TRANsient|[:ALL]>, specify :ACQuire for measurement, :TRANsient for source output, or :ALL for both device actions.
Subsystem Commands :TRIGger<:ACQuire|:TRANsient|[:ALL]>[:IMMediate] Parameter delay Query response response Trigger delay, in seconds. value (0 to 100)|MINimum| MAXimum|DEFault (default is 0). Parameter data type is NRf+. Query does not support delay=value. response returns the present setting of trigger delay. If a parameter is specified, response returns the value assigned to DEF, MIN, or MAX. Response data type is NR3. Example :TRIG:DEL 0.
Subsystem Commands :TRIGger<:ACQuire|:TRANsient|[:ALL]>:SOURce[:SIGNal] :TRIGger[c]<:ACQuire|:TRANsient>:SOURce:LAN? For <:ACQuire|:TRANsient|[:ALL]> and <:ACQuire|:TRANsient>, specify :ACQuire for measurement, :TRANsient for source output, or :ALL for both device actions. Parameter lan_id Query response response LAN ID of the LXI trigger. LAN0|LAN1|LAN2|LAN3|LAN4| LAN5|LAN6|LAN7. All is selected as default. Parameter data type is CPD. response returns the present setting, LAN0 through LAN7.
Subsystem Commands :TRIGger<:ACQuire|:TRANsient|[:ALL]>:TIMer source=INT1 or INT2 selects a signal from the internal bus 1 or 2, respectively. source=LANn selects a LXI trigger specified by the :TRIGger<:ACQuire|:TRANsient|[:ALL]>:SOURce:LAN command. source=EXTn selects a signal from the GPIO pin n, which is an input port of the Digital I/O D-sub connector on the rear panel. n=1 to 14.
Subsystem Commands :TRIGger<:ACQuire|:TRANsient|[:ALL]>:TOUTput:SIGNal :TRIGger<:ACQuire|:TRANsient|[:ALL]>:TOUTput:S IGNal Selects the trigger output for the status change between the arm layer and the trigger layer. Multiple trigger output ports can be set.
Subsystem Commands :TRIGger<:ACQuire|:TRANsient|[:ALL]>:TOUTput[:STATe] For <:ACQuire|:TRANsient|[:ALL]> and <:ACQuire|:TRANsient>, specify :ACQuire for measurement, :TRANsient for source output, or :ALL for both device actions. Parameter mode Trigger output ON or OFF. 1|ON|0|OFF (default). Parameter data type is boolean. mode=1 or ON enables the trigger output. mode=0 or OFF disables the trigger output.
Subsystem Commands :TRIGger<:ACQuire|:TRANsient|[:ALL]>:TOUTput[:STATe] 4- 164 Agilent B2900 SCPI Command Reference, Edition 2
5 Error Messages
Error Messages This chapter shows the error code/messages returned from Agilent B2900 when any error occurred during a SCPI program is executed. Error messages are classified by error number as listed in the following table.
Error Messages No Error No Error This message indicates that Agilent B2900 has no errors. Error 0 No error The error queue is completely empty. Every error/event in the queue has been read or the queue was purposely cleared by power-on, *CLS, and so on.
Error Messages Command Error Command Error If syntax of SCPI command is not valid, a -1XX error occurs. Error -100 Command error Generic syntax error that cannot be determined more specifically. Error -101 Invalid character An invalid character for the type of a syntax element was received; for example, a header containing an ampersand. Error -102 Syntax error An unrecognized command or data type was received; for example, a string was received when B2900 does not accept strings.
Error Messages Command Error Error -111 Header separator error An illegal character for a header separator was received; for example, no white space between the header and parameter. Error -112 Program mnemonic too long A keyword in the command header contains more than twelve characters. Error -113 Undefined header An undefined command header was received; for example, *XYZ.
Error Messages Command Error The suffix does not follow the correct syntax or the suffix is inappropriate. Error -134 Suffix too long The suffix contains more than 12 characters. Error -138 Suffix not allowed A suffix was received after a numeric parameter that does not allow suffixes. Error -140 Character data error An error was detected in a character parameter. This error message is reported if B2900 cannot determine the more specific errors -141 through -148.
Error Messages Command Error Error -161 Invalid block data An invalid block data was received; for example, an END message was received before the length was satisfied. Error -168 Block data not allowed A legal block data was received but was not allowed at this point. Error -170 Expression error An error was detected in an expression. This error is reported if B2900 cannot determine more specific errors -171 and -178.
Error Messages Execution Error Execution Error Agilent B2900 reports -2XX errors when it is unable to perform a valid programming command. Error -200 Execution error Generic execution error for B2900 that cannot be determined more specifically. Error -220 Parameter error; Invalid channel list Parameter error; Invalid group defnition Invalid channel list or group defnition was specified. Set appropriate value.
Error Messages Execution Error Error -233 Invalid version The version of the data format is incorrect to the instrument. Error -240 Hardware error A hardware problem in B2900. This error message is reported if B2900 cannot detect the more specific error -241. Error -241 Hardware missing; To recover channel, execute *TST? A program command or query could not be executed because of missing hardware; for example, an option was not installed. Execute the *TST? command to recover or unlock channel.
Error Messages Device-Dependent Error Device-Dependent Error -3XX errors indicate that Agilent B2900 has detected an error that is not a command error, a query error, or an execution error; some device operations did not properly complete, possibly due to an abnormal hardware or firmware condition. These codes are also used for self-test response errors. Error -300 Device-specific error Generic device-dependent error for B2900 that cannot be determined more specifically.
Error Messages Query Error Query Error If the output queue control of Agilent B2900 detects one of following problems, a -4XX error occurs. Error -400 • An attempt was made to read data from the output queue when no output data is present or pending. • Data in the output queue has been lost. Query error Generic query error for B2900 that cannot be determined more specifically.
Error Messages B2900 Specific Error B2900 Specific Error Positive error numbers are Agilent B2900 specific errors, not standard SCPI errors. Consult service for errors 111 to 140. Error 111 Self-calibration failed; Voltage offset, item; channel n Failed the voltage offset self-calibration specified by item and channel n. Error 112 Self-calibration failed; Current offset, item; channel n Failed the current offset self-calibration specified by item and channel n.
Error Messages B2900 Specific Error Error 134 Self-test failed; DAC/ADC, item; channel n Failed the DAC/ADC test specified by item and channel n. Error 135 Self-test failed; Loop control, item; channel n Failed the loop control test specified by item and channel n. Error 136 Self-test failed; I sense, item; channel n Failed the current sense test specified by item and channel n. Error 137 Self-test failed; V sense, item; channel n Failed the voltage sense test specified by item and channel n.
Error Messages B2900 Specific Error Error 214 Display must be enabled Display is currently disabled. Set remote display on. Error 215 Remote sensing must be on Remote sensing must be on to perform the requested operation. Error 216 Auto resistance measurement must be off Automatic resistance measurement must be off to perform the requested operation. Error 301 Emergency; Overvoltage status detected; Channel n Overvoltage status was detected in channel n.
Error Messages B2900 Specific Error Error 308 Emergency; High temperature4 status detected; Channel n High temperature 4 status was detected in channel n. All channel output is changed to 0 V and the all output switch is opened. Execute the *TST? command. Error 311 Emergency; Abuse detected; Channel n Abuse status was detected in channel n. All channel output is changed to 0 V and the all output switch is opened. Execute the *TST? command.
Error Messages B2900 Specific Error Error 324 Emergency; SMU power supply was turned off; Channel n SMU power supply was turned off because emergency status was detected in channel n. All channels were disabled. Execute the *TST? command. Error 331 Emergency; Interlock open detected Interlock open was detected. All channel output is changed to 0 V and the all output switch is opened. Execute the *TST? command. Do not open interlock circuit while SMU is in high voltage state.
Error Messages B2900 Specific Error Error 356 Emergency; Sense data FIFO overflow detected; Channel n Sense data FIFO overflow was detected in channel n. All channel output is changed to 0 V and the all output switch is opened. Execute the *TST? command. Error 361 Emergency; Internal communication failure detected by CPU; Channel n Channel n internal communication failure was detected by CPU. All channel output is changed to 0 V and the all output switch is opened. Execute the *TST? command.
Error Messages B2900 Specific Error Error 702 ProgramMemory; Invalid variable number Appropriate variable name must be specified. Error 703 ProgramMemory; Query command is not supported Memory program cannot contain query command. Error 704 ProgramMemory; Program is not selected Appropriate program name must be specified. Error 705 ProgramMemory; Cannot execute program while another program is running Another program is running. Execute the program after it is stopped.
Error Messages B2900 Specific Error Error 713 ProgramMemory; Cannot set multiple INIT commands in program line A program line cannot contain multiple INIT commands. Error 714 ProgramMemory; Invalid character in program line Program line contains invalid character. Use appropriate characters. Error 715 ProgramMemory; Invalid character in program name Appropriate program name must be specified. Error 716 ProgramMemory; Program count overflow Program memory cannot save the program.
Error Messages B2900 Specific Error Expression contains invalid floating point number. Enter appropriate expression. Error 812 Calculate; Invalid data handle index Vector expression contains invalid index value of an array. Enter appropriate expression. Error 813 Calculate; Divided by zero Denominator must not be zero. Enter appropriate expression. Error 814 Calculate; Log of zero Expression cannot contain log 0. Enter appropriate expression.
Error Messages B2900 Specific Error Error 823 Calculate; Missmatched vector lengths Vector length of grouped channels must be the same. Error 824 Calculate; Invalid character in math name Appropriate math expression name must be specified. Error 861 Trace; Illegal with storage active Storage device must be idle to perform the requested operation. Error 862 Trace; No trace data Trace buffer must contain data to perform the requested operation. Error 870 Macro file size error Macro file size error.
Error Messages B2900 Specific Error 5- 22 Agilent B2900 SCPI Command Reference, Edition 2
6 Using Your Existing Programs
Using Your Existing Programs Agilent B2900 supports two command sets, default and conventional. The default command set is designed to support all B2900 functions. The conventional command set is designed for using existing programs for controlling existing instruments, such as Series 2400 from Keithley Instruments, Inc. To switch the command set To switch to the conventional command set, enter the :SYSTem:LANGuage “2400” command or use the front panel keys System>SCPI>2400.
Using Your Existing Programs Conventional commands supported by B2900 Conventional commands supported by B2900 :ABORt :ARM[:SEQuence[1]][:LAYer[1]]:COUNt :ARM[:SEQuence[1]][:LAYer[1]]:COUNt? :ARM[:SEQuence[1]][:LAYer[1]]:SOURce? :ARM[:SEQuence[1]][:LAYer[1]][:TCONfigure]:DIRection SOURce|ACCeptor :ARM[:SEQuence[1]][:LAYer[1]][:TCONfigure]:DIRection? :ARM[:SEQuence[1]][:LAYer[1]]:TIMer :ARM[:SEQuence[1]][:LAYer[1]]:TIMer? :CALCulate[1]:DATA:LATest? :CALCulate[1]:DATA? :CA
Using Your Existing Programs Conventional commands supported by B2900 :CALCulate2:CLIMits:FAIL:SOURce2 :CALCulate2:CLIMits:FAIL:SOURce2? :CALCulate2:CLIMits:MODE GRADing|SORTing :CALCulate2:CLIMits:MODE? :CALCulate2:CLIMits:PASS:SOURce2 :CALCulate2:CLIMits:PASS:SOURce2? :CALCulate2:DATA:LATest? :CALCulate2:DATA? :CALCulate2:FEED CALCulate[1]|VOLTage|CURRent|RESistance :CALCulate2:FEED? :CALCulate2:LIMit[1]:COMPliance:FAIL IN|OUT :CALCulate2:LIMit[1]:COMPliance:FAIL? :CALCulate2:LIMit[1]:
Using Your Existing Programs Conventional commands supported by B2900 :CALCulate2:LIMit[2|3|5-12]:UPPer:SOURce2 :CALCulate2:LIMit[2|3|5-12]:UPPer:SOURce2? :CALCulate2:LIMit4:SOURce2 :CALCulate2:LIMit4:SOURce2? :CALCulate2:NULL:ACQuire :CALCulate2:NULL:OFFSet :CALCulate2:NULL:OFFSet? [DEFault|MINimum|MAXimum] :CALCulate2:NULL:STATe :CALCulate2:NULL:STATe? :CALCulate3:DATA? :CALCulate3:FORMat MEAN|SDEViation|MAXimum|MINimum|PKPK :CALCulate3:FORMat? :CONFigu
Using Your Existing Programs Conventional commands supported by B2900 :DISPlay:WINDow2:TEXT:STATe? :FETCh? :FORMat:BORDer :FORMat:BORDer? :FORMat:ELEMents:CALCulate :FORMat:ELEMents:CALCulate? :FORMat:ELEMents[:SENSe[1]] :FORMat:ELEMents[:SENSe[1]]? :FORMat:SOURce2 :FORMat:SOURce2? :FORMat:SREGister :FORMat:SREGister? :FORMat[:DATA] [,NRf] :FORMat[:
Using Your Existing Programs Conventional commands supported by B2900 [:SENSe[1]]:CURRent[:DC]:PROTection[:LEVel] [:SENSe[1]]:CURRent[:DC]:PROTection[:LEVel]? DEFault|MINimum|MAXimu m [:SENSe[1]]:CURRent[:DC]:PROTection:TRIPped? [:SENSe[1]]:CURRent[:DC]:RANGe:AUTO [:SENSe[1]]:CURRent[:DC]:RANGe:AUTO? [:SENSe[1]]:CURRent[:DC]:RANGe:AUTO:LLIMit [:SENSe[1]]:CURRent[:DC]:RANGe:AUTO:LLIMit? [:SENSe[1]]:CURRent[:DC]:RANGe:AUTO:ULIMit? [:SENSe[1]]:CURRent[:DC]:RANGe[:UPP
Using Your Existing Programs Conventional commands supported by B2900 [:SENSe[1]]:RESistance:OCOMpensated [:SENSe[1]]:RESistance:OCOMpensated? [:SENSe[1]]:RESistance:RANGe:AUTO [:SENSe[1]]:RESistance:RANGe:AUTO? [:SENSe[1]]:RESistance:RANGe:AUTO:LLIMit [:SENSe[1]]:RESistance:RANGe:AUTO:LLIMit? [:SENSe[1]]:RESistance:RANGe:AUTO:ULIMit [:SENSe[1]]:RESistance:RANGe:AUTO:ULIMit? [:SENSe[1]]:RESistance:RANGe[:UPPer] [:SENSe[1]]:RESistance:RANGe[:UP
Using Your Existing Programs Conventional commands supported by B2900 :SOURce[1]:CURRent:CENTer? [DEFault|MINimum|MAXimum] :SOURce[1]:CURRent[:LEVel][:IMMediate][:AMPLitude] :SOURce[1]:CURRent[:LEVel][:IMMediate][:AMPLitude]? [DEFault|MINimum| MAXimum] :SOURce[1]:CURRent[:LEVel]:TRIGgered[:AMPLitude] :SOURce[1]:CURRent[:LEVel]:TRIGgered[:AMPLitude]? [DEFault|MINimum|M AXimum] :SOURce[1]:CURRent:MODE :SOURce[1]:CURRent:MODE? :SO
Using Your Existing Programs Conventional commands supported by B2900 :SOURce[1]:LIST:CURRent:APPend {,}.. :SOURce[1]:LIST:CURRent:POINts? :SOURce[1]:LIST:CURRent:STARt :SOURce[1]:LIST:CURRent:STARt? :SOURce[1]:LIST:VOLTage {,}.. :SOURce[1]:LIST:VOLTage? :SOURce[1]:LIST:VOLTage:APPend {,}..
Using Your Existing Programs Conventional commands supported by B2900 :SOURce[1]:VOLTage:PROTection[:LEVel] :SOURce[1]:VOLTage:PROTection[:LEVel]? [DEFault|MINimum|MAXimum] :SOURce[1]:VOLTage:PROTection:TRIPped? :SOURce[1]:VOLTage:RANGe :SOURce[1]:VOLTage:RANGe? [DEFault|MINimum|MAXimum] :SOURce[1]:VOLTage:RANGe:AUTO :SOURce[1]:VOLTage:RANGe:AUTO? :SOURce[1]:VOLTage:SPAN :SOURce[1]:VOLTage:SPAN? [D
Using Your Existing Programs Conventional commands supported by B2900 :SOURce2:TTL4:MODE? :STATus:MEASurement:CONDition? :STATus:MEASurement:ENABle :STATus:MEASurement:ENABle? :STATus:MEASurement[:EVENt]? :STATus:OPERation:CONDition? :STATus:OPERation:ENABle :STATus:OPERation:ENABle? :STATus:OPERation[:EVENt]? :STATus:PRESet :STATus:QUEStionable:CONDition? :STATus:QUEStionable:ENABle :STATus:QUEStionable:ENABle? :STATus:QUEStionable[:EVENt]? :STATus:QUEue:CLEar :STATus:QUEue[:N
Using Your Existing Programs Conventional commands supported by B2900 :SYSTem:PRESet :SYSTem:RSENse :SYSTem:RSENse? :SYSTem:TIME? :SYSTem:TIME:RESet :SYSTem:TIME:RESet:AUTO :SYSTem:TIME:RESet:AUTO? :SYSTem:VERSion? :TRACe:CLEar :TRACe:DATA? :TRACe:FEED :TRACe:FEED? :TRACe:FEED:CONTrol :TRACe:FEED:CONTrol? :TRACe:FREE? :TRACe:POINts :TRACe:POINts? [MINimum|MAXimum|DEFault] :TRACe:POINts:ACTual? :TRACe:TSTamp:FORMat
Using Your Existing Programs Conventional commands partially supported by B2900 Conventional commands partially supported by B2900 • May need to change the parameter values. :SYSTem:BEEPer[:IMMediate] , • Parameters TLINk and BSTest do not work. No error. :ARM[:SEQuence[1]][:LAYer[1]]:SOURce :TRIGger[:SEQuence[1]]:SOURce • Ignored. Causes no action or response.
Using Your Existing Programs Conventional commands partially supported by B2900 :SYSTem:RWLock :TRIGger:CLEAr :TRIGger:SEQuence2:SOURce :TRIGger:SEQuence2:TOUT • Always returns the specific value.
Using Your Existing Programs Conventional commands partially supported by B2900 :SOURce[1]:VOLTage[:LEVel]:TRIGgered:SFACtor? (returns 1.
Using Your Existing Programs Conventional commands not supported by B2900 Conventional commands not supported by B2900 :ARM[:SEQuence[1]][:LAYer[1]][:TCONfigure][:ASYNchronous]:ILINe <1|2|3|4 > :ARM[:SEQuence[1]][:LAYer[1]][:TCONfigure][:ASYNchronous]:OLINe <1|2|3|4 > :ARM[:SEQuence[1]][:LAYer[1]][:TCONfigure][:ASYNchronous]:OUTPut :CALCulate2:CLIMits:FAIL:SMLocation |NEXT :CALCulate2:CLIMits:PASS:SMLocation |NEXT :DISPlay[:WINDow[1]]:DATA? :DISPlay:WINDow2:DATA? :OUTPut[1]:I
Using Your Existing Programs Conventional commands not supported by B2900 :STATus:QUEue:ENABle (NR1 list) :SYSTem:CCHeck ON|OFF :SYSTem:LFRequency:AUTO :SYSTem:MEP[:STATe] :SYSTem:RCMode :TRIGger[:SEQuence[1]][:TCONfigure][:ASYNchronous]:ILINe <1|2|3|4> :TRIGger[:SEQuence[1]][:TCONfigure][:ASYNchronous]:INPut :TRIGger[:SEQuence[1]][:TCONfigure][:ASYNchronous]:OLINe <1|2|3|4> :TRIGger[:SEQuence[1]][:TCONfigure][:ASYNchronous]:OUTPut
