Agilent E4991A RF Impedance/Material Analyzer Programming Manual Sixth Edition Agilent Part No.
Notices The information contained in this document is subject to change without notice. This document contains proprietary information that is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced, or translated to another language without the prior written consent of Agilent Technologies. Microsoft®,MS-DOS®,Windows®,Visual C++®,Visual Basic®,VBA® and Excel® are registered UNIX is a registered trademark in U.S.
button. sample Indicates the menu, button, or box labeled “sample”, which can be clicked to carry out the settings and choice. Menu indicates menu bar, pull-down menu, and short-cut menu. Button refers to the buttons in dialog box and setup toolbar. Box indicates the spin box, drop-down list box, text box, and list box. SAMPLE Indicates the block or toolbar labeled “SAMPLE“. Block indicates the key group on the front panel.
E4991A Documentation Map The following manuals are available for the Agilent E4991A. • Operational Manual (Part Number: E4991-900x0, attached to optional ABA) This manual describes most of the basic information necessary to use the E4991A. It provides a function overview, detailed operation procedure for each function (from preparation for measurement to analysis of measurement results), measurement examples, specifications, and supplemental information.
To Make Effective Use of This Manual 19 Contents of this manual 20 How to use this manual 23 Selecting the structure of remote control system 23 Sample programs 24 Outline of Remote Control 25 Outline of GPIB remote control system 26 System structure 26 Sending GPIB command messages 29 Remote control using E4991A macros 32 System structure 32 How to operate macros 33 Sending command messages 34 Remote mode 34 Remote control using remote user interface function and application software 35 System structure 35
Example program using HTBasic 55 Example program using macro (E4991A VBA) 59 Combination of Several Sweep Conditions (Segment Sweep) 64 Create/Edit Segment Sweep Table 64 Example program for setting the segment sweep conditions 66 Example program using HTBasic 66 Example program using macro (E4991A VBA) 70 Preparation for Accurate Measurement 73 Calibration 74 Define Calibration Kit 74 Define Load Standard Value Used for Measurement of Dielectric Material 75 Select Calibration Data Measurement Points 75 Mea
Example Programs for Reading Internal Data Arrays 129 Reading the data trace array (ASCII format) 129 Reading the dc bias level monitor array 133 Measurement Result Processing 139 Using Marker Function 140 Markers 140 Moving Markers and Reading at Marker Positions 141 Setting Δ Mode 142 Entering Marker Values as E4991A Setting 143 Marker Search Function 144 Limit Test Function 147 Statistical Analysis Function 149 Example Programs for Marker Search Function 150 Example Programs for Marker Limit Test Functio
Error Handling 201 Using the Error Queue 202 Using Status Report Mechanism 203 Example Program for Error Handling 204 Using HTBasic 204 Using the macro (E4991A VBA) 206 Shutting Down the Instrument 209 Shutdown Procedure 210 Use of Macros 211 Overview of Macros 212 Macro Function Overview 213 Starting Up and Closing Visual Basic Editor 214 Starting up Visual Basic Editor 214 Quitting Visual Basic Editor 214 Displaying the E4991A measurement screen 214 Making/Editing Macros 215 Elements of Visual Basic Edito
Programming with VISA 247 STEP 1. Starting up VISA system 248 STEP 2. Connection 248 STEP 3. Communication 249 STEP 4.
CALC{1-5}:EPAR:SIM 297 CALC{1-5}:FORM 298 CALC:FORM:PAR:DIE 300 CALC{1-3}:FORM:PAR:EPH 301 CALC:FORM:PAR:MAG 302 CALC{1-5}:FORM:UNIT:ANGL 303 CALC{1-5}:MARK{1-8} 304 CALC{1-5}:MARK{1-8}:ACT 305 CALC{1-5}:MARK:AOFF 305 CALC{1-5}:MARK:APE:SET 306 CALC{1-5}:MARK:APE:EXC:X 307 CALC{1-5}:MARK:APE:EXC:Y 308 CALC:MARK:COUP 309 CALC{1-5}:MARK:DISC 309 CALC{4-5}:MARK:FORM 310 CALC{1-5}:MARK:FUNC 311 CALC{1-5}:MARK:FUNC:DOM 312 CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM 313 CALC{1-5}:MARK:FUNC:DOM:LIM:ALL 314 CALC{1-5}:MARK:FU
CALC{1-5}:MARK{1-8}:X 338 CALC{1-5}:MARK{1-8}:Y? 339 CALC{1-5}:MATH:FUNC 340 CALC{1-5}:MATH:MEM 341 CALC{1-3}:MATH:OFFS 342 CALC{1-5}:MST 343 CALC{1-5}:MST:DATA? 344 DATA:CAD{1-8}? 345 DATA:CCO{1-6} 346 DATA:CMD{1-2}? 347 DATA:CMP{1-3} 348 DATA:RAW? 349 DATA:SEGM{1-16}:CAD{1-8}? 350 DATA:SEGM{1-16}:CCO{1-6} 351 DATA:SEGM{1-16}:CMD{1-2}? 352 DATA:SEGM{1-16}:CMP{1-3} 353 DISP:BACK 354 DISP:ENAB 354 DISP:FORM 355 DISP:TEXT 355 DISP:TEXT{1-3}:SET 356 DISP:TRAC{1-5} 356 DISP:TRAC{1-5}:GRAT:FORM 357 DISP:TRAC{1-3
FREQ:SPAN 377 FREQ:SPAN:FULL 377 FREQ:STAR 378 FREQ:STOP 379 HCOP 380 HCOP:ABOR 380 HCOP:CONT 380 HCOP:IMAG 381 INIT 382 INIT:CONT 382 MMEM:CAT? 383 MMEM:CDIR 383 MMEM:COPY 384 MMEM:DEL 384 MMEM:LOAD 385 MMEM:LOAD:MACR 385 MMEM:LOAD:TRAC 386 MMEM:MDIR 386 MMEM:MOVE 387 MMEM:RDIR 388 MMEM:STOR 388 MMEM:STOR:CITI{1-3} 389 MMEM:STOR:GRAP 389 MMEM:STOR:GRAP:BMP 390 MMEM:STOR:MACR 390 MMEM:STOR:TRAC 391 MMEM:STOR:TRAC:ASC 391 MMEM:STOR:TRAC:SEL{1-4} 392 MODE 393 PROG:CAT? 394 PROG:NAME 394 PROG:STAT 395 PROG:WAI
SEGM{1-16}:FREQ:STAR 409 SEGM{1-16}:FREQ:STOP 410 SEGM{1-16}:POW 411 SEGM:POW:STAT 412 SEGM{1-16}:SWE:POIN 413 SEGM{1-16}:VOLT 414 SEGM{1-16}:VOLT:LIM 415 SEGM{1-16}:VOLT:OFFS 416 SEGM:VOLT:OFFS:STAT 417 SEGM:VOLT:STAT 418 SENS:CORR1 419 SENS:CORR1:CKIT 420 SENS:CORR1:CKIT:LIST 421 SENS:CORR1:CKIT:STAN1:C 422 SENS:CORR1:CKIT:STAN1:G 423 SENS:CORR1:CKIT:STAN1:LIST:B 424 SENS:CORR1:CKIT:STAN1:LIST:G 425 SENS:CORR1:CKIT:STAN2:L 426 SENS:CORR1:CKIT:STAN2:LIST:R 427 SENS:CORR1:CKIT:STAN2:LIST:X 428 SENS:CORR1:CK
SENS:CORR2:EDEL:TIME 453 SENS:CORR2:FIXT 454 SENS:CORR2:FIXT:EDEL:MODE:DIST? 455 SENS:CORR2:FIXT:EDEL:USER:DIST 456 SOUR:CURR 457 SOUR:CURR:CENT 458 SOUR:CURR:LIM:OFFS 459 SOUR:CURR:MODE 460 SOUR:CURR:OFFS 461 SOUR:CURR:OFFS:CENT 462 SOUR:CURR:OFFS:SPAN 463 SOUR:CURR:OFFS:STAR 464 SOUR:CURR:OFFS:STAT 465 SOUR:CURR:OFFS:STOP 466 SOUR:CURR:SPAN 467 SOUR:CURR:STAR 468 SOUR:CURR:STOP 469 SOUR:POW 470 SOUR:POW:CENT 471 SOUR:POW:MODE 472 SOUR:POW:SPAN 473 SOUR:POW:STAR 474 SOUR:POW:STOP 475 SOUR:VOLT 476 SOUR:VOL
STAT:QUES:HARD? 495 STAT:QUES:HARD:COND? 495 STAT:QUES:HARD:ENAB 496 STAT:QUES:HARD:NTR 497 STAT:QUES:HARD:PTR 498 STAT:QUES:LIM? 499 STAT:QUES:LIM:COND? 499 STAT:QUES:LIM:ENAB 500 STAT:QUES:LIM:NTR 501 STAT:QUES:LIM:PTR 502 STAT:QUES:NTR 503 STAT:QUES:PTR 504 STAT:QUES:SEAR? 504 STAT:QUES:SEAR:COND? 505 STAT:QUES:SEAR:ENAB 505 STAT:QUES:SEAR:NTR 506 STAT:QUES:SEAR:PTR 507 SWE:DIR 508 SWE:DWEL1 508 SWE:DWEL2 509 SWE:DWEL3 510 SWE:POIN 511 SWE:STIM{1-4}? 512 SWE:TIME 513 SWE:TIME:AUTO 514 SWE:TYPE 515 SYST:B
TRIG:SLOP 526 TRIG:SOUR 526 COM Interface Reference 527 Conventions of COM Interface 528 Explanation 528 VB Syntax 528 Parameter 528 Response 529 Examples 529 Application object 530 Name property 530 VBAVersion property 530 Connection property 531 SingleMeasure method 532 CalMeasure method 533 CompenMeasure method 534 GetTextData method 535 GetScreenImage method 535 WaitForEvent method 536 SweepEnd event 537 SweepStart event 538 CompleteSweepAveraging event 538 Unlocked event 539 DcBiasOverload event 539 Rf
GPIB Command List By Function 569 GPIB Command List By Function 570 Table of corresponding 4291B vs.
1. To Make Effective Use of This Manual 1 To Make Effective Use of This Manual This chapter describes the contents of this programming manual and how to use it.
To Make Effective Use of This Manual Contents of this manual Contents of this manual This is the programming manual of the E4991A RF Impedance/Material Analyzer. The contents of each chapter in this manual are as follows. Chapter 1, “To Make Effective Use of This Manual” This chapter describes the contents of this programming manual and how to use it.
Chapter 13, “Use of Macros” This chapter explains how to use the macro function of the Agilent E4991A to create macro programs with the Visual Basic editor. Information is also given on how to execute produced macros. Chapter 14, “Outline of Programming Using COM” This chapter gives the required information for programming with the COM interface of the Agilent E4991A. For more basic information on the COM interface, refer to Chapter 18, “COM Interface Reference.
To Make Effective Use of This Manual Contents of this manual Appendix F, “List of Responses to Measurement Failure” This appendix lists the Agilent E4991A’s responses to various types of measurement failure. Appendix G, “Messages” The Agilent E4991A provides error messages as well as messages that indicate the internal operating status of the equipment. This appendix describes such messages in order of error number.
How to use this manual When writing programs, it is not necessarily required to use all the information in this manual. Basically, the structure of remote control system that the user decides will determine required equipment, programming language that is necessary to understand, and command set to control the E4991A.
To Make Effective Use of This Manual How to use this manual Sample programs The sample program disk (Agilent Parts No. E4991-180x0) and CD-ROM (Agilent Parts No. E4991-905x0) contain HTBasic sample programs and E4991A VBA sample programs shown in this manual. These sample program disks are DOS formatted. How to load the sample program To use the sample program on HTBasic, load it by GET command on HTBasic. The following is an example of loading a sample program, "setup.htb". GET "setup.
2. Outline of Remote Control 2 Outline of Remote Control This chapter explains the system structures, required equipment, and set up methods needed to structure the remote control system of the E4991A.
Outline of Remote Control Outline of GPIB remote control system Outline of GPIB remote control system This section explains the system structures and required equipment for sending GPIB command messages. In Chapter 17, you can also find more on the GPIB commands used to control the E4991A from an external computer through the GPIB interface. System structure Connect the E4991A to an external computer and peripheral equipment with a GPIB cable.
Outline of Remote Control Outline of GPIB remote control system Required equipment 1. The Agilent E4991A RF Impedance/Material Analyzer and the accessories required to measure a DUT a. Set the GPIB address of the E4991A. System - GPIB Setup... - E4991A Address: (drop-down box) b. Turn the E4991A’s main power off and then back on again. 2. GPIB system controller To use an external computer as the system controller, a Personal Computer (IBM compatible) or work station with a GPIB interface is required.
Outline of Remote Control Outline of GPIB remote control system The sizes and configurations of possible GPIB systems • A maximum of 15 devices can be connected to one GPIB system. • Keep the length of cable between devices within 1 m. The total length of connecting cable in a single GPIB system should not exceed 2 m × the number of connected devices (the controller is counted as one device). Also, you cannot construct a system having more than 20 m in total cable length.
Outline of Remote Control Outline of GPIB remote control system Sending GPIB command messages Learning about GPIB commands To find information on a particular GPIB command, refer to the following sections in this book. The procedures used to write basic programs for the E4991A are explained from Chapter 2 to Chapter 11. Program examples using HTBasic are also given.
Outline of Remote Control Outline of GPIB remote control system The concept of command tree The command at the highest-level position in the command tree hierarchy is called “root command” or simply “root.” To access a lower command in the tree structure’s hierarchy, a particular “path” has to be specified in the same way as a directory path in the DOS file system. The current path is set as “root” after the power is turned on or a reset is executed.
Outline of Remote Control Outline of GPIB remote control system Grammar for massages The grammar used for sending program messages by GPIB is described below. Program massage means a massage sent to the measurement equipment by the user through an external computer for controlling the measurement equipment. A program message contains one or more commands and the parameters required for them.
Outline of Remote Control Remote control using E4991A macros Remote control using E4991A macros This section describes the system structures and command sets used for controlling the E4991A and peripheral equipment with the instrument’s macro functions. NOTE The E4991A is shipped with a macro function. A macro allows you to automatically execute a series of multiple commands with a single command.
Outline of Remote Control Remote control using E4991A macros Required equipment 1. The Agilent E4991A RF Impedance/Material Analyzer and the accessories required to measure a DUT 2. Peripheral equipment depending on the user’s purpose 3. USB/GPIB interface(82357A). To use the VBA remote control system, you need to set the USB/GPIB interface correctly. For detail, refer to Operation Manual. NOTE Do not connect two or more USB/GPIB interfaces.
Outline of Remote Control Remote control using E4991A macros Sending command messages When controlling the E4991A or peripheral equipment by macro functions, the command set differs depending on the target of control. Commands to control E4991A The command used to control the E4991A is written in the E4991A COM interface. The following two types of E4991A COM interfaces can be used.
Outline of Remote Control Remote control using remote user interface function and application software Remote control using remote user interface function and application software System structure Connect the E4991A to a personal computer with a LAN cable. Figure 2-4 outlines the system structure for using the remote user interface function.
Outline of Remote Control Remote control using remote user interface function and application software Required equipment 1. The Agilent E4991A RF Impedance/Material Analyzer and the accessories required to measure a DUT It is not necessary to select the system-controller mode or the addressable-only mode of the GPIB system. 2. Personal Computer A personal computer (IBM compatible personal computer) with a LAN interface is required. 3.
Outline of Remote Control Remote control using remote user interface function and application software Sending command messages Basically, the commands used to control the E4991A are written in the E4991A COM interface. The following two types of E4991A COM interfaces can be used. To use the COM interface in combination with the GPIB command offered by the E4991A, it is necessary to understand how to use GPIB command.
Outline of Remote Control Remote control using remote user interface function and application software 38 Chapter 2
3. Setting Measurement Conditions 3 Setting Measurement Conditions This chapter explains how to set the measurement conditions of the Agilent E4991A.
Setting Measurement Conditions Set Measurement Parameter Set Measurement Parameter The measurement mode (Impedance/Magnetic/Dielectric measurement) and the display trace type (Scalar/Complex trace) determine the parameters available. The following section explains how to set the measurement parameters.
Setting Measurement Conditions Set Measurement Parameter Parameters for Scalar Trace Measurement Parameters Table 3-1 shows measurement parameters available for a scalar trace. Use the following GPIB command to specify a trace number (1, 2, or 3) and select measurement parameters. Note that up to three measurement parameters can be displayed at a time.
Setting Measurement Conditions Set Measurement Parameter Table 3-1 Measurement Parameters for Scalar Trace Measurement parameter GPIB parameter Description εr' DCR Real part of complex permittivity*2 εr'' DCLF Imaginary part of complex permittivity *1*2 tanδ(ε) DCLT Dielectric loss tangent*2 *1. Parameters selectable when the Magnetic Material measurement mode is selected. *2. Parameters selectable when the Dielectric Material measurement mode is selected.
Setting Measurement Conditions Set Measurement Parameter Parameters for Complex Trace Measurement parameters Table 3-2 shows measurement parameters available for a complex trace. Use the following GPIB command to specify a trace number (4 or 5) and select measurement parameters. Note that up to two measurement parameters can be displayed at any one time.
Setting Measurement Conditions Set Sweep Conditions Set Sweep Conditions The following section explains how to set the sweep conditions. The sweep condition is a common parameter to all of traces. Select Sweep Parameter The user must select a desired combination of a sweep parameter and a sweep type. E4991A provides the following combinations of four sweep parameters and three sweep types.
Setting Measurement Conditions Set Sweep Conditions Set Sweep Range Sweep range can be set in two ways: by specifying the center value and span value of the sweep range or by specifying the sweep start value and sweep stop value. Use the following GPIB commands to set a sweep range. NOTE When sweep start or stop values are changed, center and span values are also changed accordingly. The E4991A provides a GPIB command to specify the sweep range for each sweep parameter.
Setting Measurement Conditions Set Sweep Conditions DC Bias Voltage Sweep If dc bias voltage sweep is selected as the sweep parameter, use one of the following GPIB commands to set the sweep range.
Setting Measurement Conditions Set Sweep Conditions Set Sweep Time Use the following GPIB command to select whether the sweep time is set to automatic setting or manual setting. If automatic setting is selected, this sets the shortest sweep time from among all of the E4991A pre-defined sweep times. • SWE:TIME:AUTO on page 514 If manual setting is selected, use the following GPIB command to perform sweep within the specified sweep time.
Setting Measurement Conditions Set Measurement Source Set Measurement Source The following section explains how to set a measurement source. The measurement source is a parameter common to all of the traces. Set Source Set CW Frequency If the sweep parameter is set to oscillator level sweep, dc bias voltage sweep, or dc bias current sweep, use the following GPIB command to set the CW frequency.
Setting Measurement Conditions Set Measurement Source Set DC Bias (DC Bias Function) If the sweep parameter is set to frequency sweep or oscillator level sweep, the following GPIB command can be used to apply the dc bias to the DUT in either fixed voltage or current source mode.
Setting Measurement Conditions Set Averaging Set Averaging The E4991A has two types of averaging functions: sweep averaging and point averaging (Figure 3-1). Sweep Averaging Use the following GPIB command to turn sweep averaging on or off. • CALC:AVER on page 289 After enabling sweep averaging, use the following GPIB command to set the averaging factor. • CALC:AVER:COUN on page 290 The following GPIB command can be used to restart the sweep.
Setting Measurement Conditions Set Display Scale Set Display Scale When the measurement screen is set to display a graph, the display scale for the specified trace can be set automatically to the most appropriate value or can be set manually to a desired value. Select Trace for Which Scale Is Set If both data and memory traces are displayed on the screen, use the following GPIB command to select the trace (data trace, memory trace, or both traces) for which the scale is to be set.
Setting Measurement Conditions Set Display Scale Log Y-Axis Format Use the following GPIB commands to set the maximum and minimum values of the scale. Display format Log Y-axis format Parameter to be set GPIB command Maximum value DISP:TRAC{1-3}:Y:TOP on page 372 Minimum value DISP:TRAC{1-3}:Y:BOTT on page 365 Polar Format Use the following GPIB command to set the scale value of the outermost circle.
Setting Measurement Conditions Set Display Scale Figure 3-2 Display Scale Parameters 3. Setting Measurement Conditions Use the following GPIB commands to set the scale parameters shown in Figure 3-2.
Setting Measurement Conditions Example program for setting the measuring conditions Example program for setting the measuring conditions An example program for setting the measuring conditions is shown below. This program sets the E4991A as follows after resetting it. When the setting is complete, a completion message is displayed.
Setting Measurement Conditions Example program for setting the measuring conditions Example program using HTBasic The program shown in Example 3-1 is saved under the filename setup.htb on the sample programs disk. The details of this program are explained as follows. Sets the GPIB address of the E4991A. Lines 250 - 290 Substitutes a variable for the trace number.
Setting Measurement Conditions Example program for setting the measuring conditions Example 3-1 Setting measuring conditions (HTBasic) 10 INTEGER Trc1,Trc2,Trc3,Trc4,Trc5 20 INTEGER Nop,Sweep_avg_coun 30 REAL Start_freq,Stop_freq,Sweep_delay 40 REAL Sour_curr,Dc_bias_v,Dc_bias_i_lim 50 REAL Full_sacle1,Full_scale2,Full_scale4 60 REAL Ref_val1,Ref_val2,Ref_val4 70 REAL Ref_pos1,Ref_pos2,Ref_pos4 80 REAL Top_scale1,Top_scale2,Top_scale4 90 REAL Bottom_scale1,Bottom_scale2,Bottom_scale4 100 DIM Trac1$[3],Tra
Setting Measurement Conditions Example program for setting the measuring conditions Chapter 3 3. Setting Measurement Conditions 550 Sweep_t_auto$="ON" 560 Sweep_delay=0 570 Sour_curr_mode$="FIX" 580 Sour_curr=1.E-3 590 Dc_bias_v=15 600 Dc_bias_i_lim=1.0E-2 610 ! 620 List_page1$="OFF" 630 List_page2$="OFF" 640 List_page4$="OFF" 650 Disp_trac1$="DATA" 660 Disp_trac2$="DATA" 670 Disp_trac4$="DATA" 680 Top_scale1=100 690 Bottom_scale1=.
Setting Measurement Conditions Example program for setting the measuring conditions 1060 OUTPUT @Agte4991a;"SWE:POIN "&VAL$(Nop) 1070 OUTPUT @Agte4991a;"SWE:DIR "&Sweep_dir$ 1080 OUTPUT @Agte4991a;"CALC:AVER:COUN "&VAL$(Sweep_avg_coun) 1090 OUTPUT @Agte4991a;"CALC:AVER "&Sweep_avg$ 1100 OUTPUT @Agte4991a;"AVER "&Point_avg$ 1110 OUTPUT @Agte4991a;"SWE:TIME:AUTO "&Sweep_t_auto$ 1120 OUTPUT @Agte4991a;"SWE:DWEL1 "&VAL$(Sweep_delay) 1130 ! 1140 ! Source Setting 1150 ! 1160 OUTPUT @Agte4991a;"SOUR:CURR:MODE "&So
Setting Measurement Conditions Example program for setting the measuring conditions Example program using macro (E4991A VBA) The program shown in Example 3-2 is saved under the filename setup.bas on the sample programs disk. The details of this program are explained as follows. Substitutes a variable for the trace number. Lines 320 - 460 Substitutes variables for the on/off status of each trace display, measurement parameter, trace display format, and Y-axis display format.
Setting Measurement Conditions Example program for setting the measuring conditions Example 3-2 Setting measuring conditions (macro) 10 Sub Main() 20 Dim trc1 As Integer, trc2 As Integer, trc3 As Integer 30 Dim trc4 As Integer, trc5 As Integer 40 Dim nop As Integer, sweep_avg_coun As Integer 50 Dim start_freq As Double, stop_freq As Double, sweep_delay As Double 60 Dim sour_curr As Double, dc_bias_v As Double, dc_bias_i_lim As Double 70 Dim full_scale1 As Double, full_scale2 As Double, full_scale4 As Doub
Setting Measurement Conditions Example program for setting the measuring conditions Chapter 3 3.
Setting Measurement Conditions Example program for setting the measuring conditions 940 SCPI.Output "CALC" & CStr(trc4) & ":FORM " & m_para4 950 SCPI.Output "DISP:TRAC" & CStr(trc4) & ":GRAT:FORM " & disp_form4 960 970 SCPI.Output "DISP:TRAC" & CStr(trc3) & " " & trac3 980 SCPI.Output "DISP:TRAC" & CStr(trc5) & " " & trac5 990 1000 ' Sweep & Average Setting 1010 1020 SCPI.Output "SWE:TYPE " & sweep_type 1030 1040 SCPI.Output "FREQ:STAR " & CStr(start_freq) 1050 SCPI.
Setting Measurement Conditions Example program for setting the measuring conditions 1410 SCPI.Output "CALC" & CStr(trc4) & ":MATH:FUNC " & disp_trac4 1420 1430 ' DC Bias ON 1440 1450 SCPI.Output "SOUR:VOLT:OFFS:STAT ON" 1460 1470 buff = SCPI.Query("*OPC?") 1480 1490 MsgBox ("Measurement Condition Setup Complete") 1500 1510 End 1520 1530 End Sub 3.
Setting Measurement Conditions Combination of Several Sweep Conditions (Segment Sweep) Combination of Several Sweep Conditions (Segment Sweep) The Agilent E4991A allows you to set combinations of up to 16 segments, each with its own sweep conditions, to perform segment sweep. A segment sweep table must be created before segment sweep can be performed.
Setting Measurement Conditions Combination of Several Sweep Conditions (Segment Sweep) Set Each Segment Parameter Individually Use the following GPIB command to set each parameter in the segment sweep table.
Setting Measurement Conditions Example program for setting the segment sweep conditions Example program for setting the segment sweep conditions An example program for setting the segment sweep conditions is described below. This program sets the segment sweep conditions as follows after resetting the E4991A. When the setting is complete, a completion message is displayed.
Setting Measurement Conditions Example program for setting the segment sweep conditions Example 3-3 Lines 520 - 540 Reads out the total number of segments created and indicates that the creation of the segment sweep table is complete. Line 600 -760 When the dc bias function is installed, this sub program sets the start/stop frequency, number of measurement points, point averaging factor, and the oscillator output level.
Setting Measurement Conditions Example program for setting the segment sweep conditions 410 DATA 100E6, 1E9, 101, 4, 0.1 420 DATA 1E9, 3E9, 51, 4, 0.1 430 ! 440 RESTORE Data_wo_bias 450 FOR Segm_no=1 TO No_of_segment 460 READ Start_f,Stop_f,Nop,Point_avg,Osc 470 CALL Segm_tbl(@Agte4991a,Segm_no,Start_f,Stop_f,Nop,Point_avg,Osc_unit$, Osc) 480 NEXT Segm_no 490 END IF 500 ! 510 Finish_entry:! 520 OUTPUT @Agte4991a;"SEGM:COUN?" 530 ENTER @Agte4991a;Seg_count 540 PRINT "Preparation of Segment Table finished.
Setting Measurement Conditions Example program for setting the segment sweep conditions 830 OUTPUT "&VAL$(Stop_f) 840 OUTPUT "&VAL$(Nop) 850 OUTPUT "&VAL$(Point_avg) 860 OUTPUT "&VAL$(Osc) 870 ! 880 SUBEND @Agte4991a;"SEGM"&VAL$(Seg_no)&":FREQ:STOP @Agte4991a;"SEGM"&VAL$(Seg_no)&":SWE:POIN @Agte4991a;"SEGM"&VAL$(Seg_no)&":AVER:COUN @Agte4991a;"SEGM"&VAL$(Seg_no)&":"&Osc_unit$&" 3.
Setting Measurement Conditions Example program for setting the segment sweep conditions Example program using macro (E4991A VBA) The program shown in Example 3-4 is saved under the filename segm_set.bas on the sample programs disk. The details of this program are explained as follows. Example 3-4 Lines 90 - 110 Substitutes a variable for the total number of segments to be created. In addition, substitutes variables for the oscillator level and the setting units of the dc bias.
Setting Measurement Conditions Example program for setting the segment sweep conditions Chapter 3 3. Setting Measurement Conditions 70 Dim osc_unit As String, dcbias_unit As String 80 90 no_of_segment = 3 100 osc_unit = "VOLT" 110 dcbias_unit = "CURR" 120 130 start_f(1) = 1000000# 140 stop_f(1) = 100000000# 150 nop(1) = 101 160 point_avg(1) = 32 170 osc(1) = 0.1 180 dcbias(1) = 10 190 dcbias_lim(1) = 0.
Setting Measurement Conditions Example program for setting the segment sweep conditions 600 610 Sub segm_tbl_bias(segm_no As Integer, start_f, stop_f As Double, nop, point_avg As Integer, osc_unit As String, osc As Double, dcbias_unit As String, dcbias, dcbias_lim As Double) 620 630 SCPI.Output "SEGM" & CStr(segm_no) & ":FREQ:STAR " & CStr(start_f) 640 SCPI.Output "SEGM" & CStr(segm_no) & ":FREQ:STOP " & CStr(stop_f) 650 SCPI.Output "SEGM" & CStr(segm_no) & ":SWE:POIN " & CStr(nop) 660 SCPI.
4. Preparation for Accurate Measurement 4 Preparation for Accurate Measurement This chapter explains how to perform calibration as well as electrical length and fixture compensation for the Agilent E4991A.
Preparation for Accurate Measurement Calibration Calibration To assure accurate measurements, calibration must be performed on the DUT port on the test head. In the Dielectric Material measurement mode, calibration should be performed on the surface of the test fixture that makes contact with the DUT. The following section explains how to perform calibration.
Preparation for Accurate Measurement Calibration Define Load Standard Value Used for Measurement of Dielectric Material Selection When performing calibration in the dielectric material measurement mode, use the following GPIB command to select whether the Load standard included with the Agilent 16453A or a user-defined Load standard is used.
Preparation for Accurate Measurement Calibration Measure Calibration Data Perform Measurement Use the following GPIB command to measure Open/Short/Load and, if necessary, Low-loss capacitor calibration data used to calculate calibration coefficients. • SENS:CORR1:COLL on page 437 NOTE If a trigger source is set to an external trigger, execution of the above command does not start calibration data measurement. After executing this command, prepare a trigger.
Preparation for Accurate Measurement Calibration Calibration Data Array/Calibration Coefficient Array The calibration data array contains Open/Short/Load/Low-loss capacitor measurement data in the complex format. This measurement data is used for calculating calibration coefficients. The calibration coefficient array contains calibration coefficients in the complex format. They are calculated by using the calibration data array. The calibration data and coefficient arrays can be read.
Preparation for Accurate Measurement Calibration Example program for execution of calibration The example program described below is used to measure each standard of the calibration kit to make the calibration function effective. When a user-defined calibration kit is used, after defining standard values, the calibration function is enabled by measuring each standard for Open, Short, Load, and Low-loss capacitor.
Preparation for Accurate Measurement Calibration Lines 1220 - 1230 Sets the bit 0 of the operation status event register at 1 only when the operation status condition register bit 0 transits from 1 to 0 (negative transition). Lines 1240 - 1250 Sets bit 0 of the operation status event register as effective and, upon completion of calibration, sets bit 7 of the status byte register as effective. Lines 1260 - 1270 Sets the branch for the SRQ interruption and enables SRQ interruption.
Preparation for Accurate Measurement Calibration 260 270 280 290 300 310 320 330 340 350 360 370 380 390 400 410 420 430 440 450 460 470 480 490 500 510 520 530 540 550 560 570 580 590 600 610 620 630 640 650 660 670 680 690 700 710 720 730 740 750 760 770 780 790 800 810 820 830 80 CALL Inp_data("Open(G)",Open_g) CALL Inp_data("Open(C)",Open_c) OUTPUT @Agte4991a;"SENS:CORR1:CKIT:STAN1:G "&VAL$(Open_g) OUTPUT @Agte4991a;"SENS:CORR1:CKIT:STAN1:C "&VAL$(Open_c) ! ! Entry Short Std.
Preparation for Accurate Measurement Calibration Chapter 4 4.
Preparation for Accurate Measurement Calibration 1410 OUTPUT @Agte4991a;"SYST:ERR?" 1420 ENTER @Agte4991a;Err_no,Err_mes$ 1430 IF Err_no=0 THEN 1440 PRINT Standard$&" data measurement completion" 1450 PRINT 1460 RETURN 0 1470 ELSE 1480 PRINT "Error: "&Err_mes$ 1490 PRINT "Program interruption" 1500 PRINT 1510 RETURN -1 1520 END IF 1530 ELSE 1540 PRINT "Program interruption" 1550 PRINT 1560 RETURN -1 1570 END IF 1580 FNEND 1590 ! 1600 SUB Inp_data(Mes$,Inp_val) 1610 DIM Inp_char$[9] 1620 PRINT "Input "&Mes$
Preparation for Accurate Measurement Calibration Example program using macro (E4991A VBA) The program shown in Example 4-2 is saved under the filename cal_meas.bas on the sample programs disk. The details of this program are explained as follows. Substitutes a variable for the calibration kit type and the obtained calibration data point. Lines 160 - 170 Sets the calibration kit type and selects the measurement point for the calibration.
Preparation for Accurate Measurement Calibration 10 Sub Main() 20 Dim buff As String, file As String 30 Dim Cal_kit As String, Cal_point As String 40 Dim Cal_a1 As Variant, Cal_a2 As Variant 50 Dim Cal_b1 As Variant, Cal_b2 As Variant 60 Dim Cal_c1 As Variant, Cal_c2 As Variant 70 Dim Open_g As Double, Open_c As Double 80 Dim Short_r As Double, Short_l As Double 90 Dim Load_r As Double, Load_l As Double 100 Dim Result As Integer, Nop_cal As Integer, Inp_char As Integer 110 Dim iFileNo As Integer, i As Integ
Preparation for Accurate Measurement Calibration Chapter 4 85 4. Preparation for Accurate Measurement 570 MsgBox "All cal-data measurement completion", vbOKOnly, "Calibration" 580 590 SCPI.Output "FORM:DATA ASC" 600 SCPI.Output "DATA:CCO1?" 610 SCPI.Enter Cal_a1, "#" 620 SCPI.Output "DATA:CCO2?" 630 SCPI.Enter Cal_b1, "#" 640 SCPI.Output "DATA:CCO3?" 650 SCPI.Enter Cal_c1, "#" 660 SCPI.Output "DATA:CCO4?" 670 SCPI.Enter Cal_a2, "#" 680 SCPI.Output "DATA:CCO5?" 690 SCPI.Enter Cal_b2, "#" 700 SCPI.
Preparation for Accurate Measurement Calibration 1130 1140 If Inp_char = vbOK Then 1150 Select Case Standard 1160 Case "Open" 1170 bool = CalMeasure(CalOpen) 1180 Case "Short" 1190 bool = CalMeasure(CalShort) 1200 Case "Load" 1210 bool = CalMeasure(CalLoad) 1220 Case "Low-loss C" 1230 bool = CalMeasure(CalLowLossC) 1240 End Select 1250 1260 If bool = 0 Then 1270 MsgBox Standard & " Calibration aborted!", vbOKOnly, "Calibration" 1280 Cal = -1 1290 Else 1300 Cal = 0 1310 End If 1320 Else 1330 Cal = -1 1340 En
Preparation for Accurate Measurement Calibration Example program for calibration coefficient transfer The example program shown below is for transferring a saved calibration coefficient array. Example program using HTBasic Example 4-3 shows an example program that enables the calibration function by transferring the calibration coefficient array saved in Example 4-1. This program is saved under the filename cal_inp.htb on the sample programs disk. Example 4-3 Line 70 Sets the GPIB address.
Preparation for Accurate Measurement Calibration 290 ! 300 ASSIGN @File TO File$ 310 ENTER @File;Cal_a1(*),Cal_b1(*),Cal_c1(*),Cal_a2(*),Cal_b2(*),Cal_c2(*) 320 ASSIGN @File TO * 330 ! 340 ! Input Calibration Data 350 ! 360 OUTPUT @Agte4991a;"FORM:DATA ASC" 370 OUTPUT @Agte4991a;"DATA:CCO1 ";Cal_a1(*) 380 OUTPUT @Agte4991a;"DATA:CCO2 ";Cal_b1(*) 390 OUTPUT @Agte4991a;"DATA:CCO3 ";Cal_c1(*) 400 OUTPUT @Agte4991a;"DATA:CCO4 ";Cal_a2(*) 410 OUTPUT @Agte4991a;"DATA:CCO5 ";Cal_b2(*) 420 OUTPUT @Agte4991a;"DATA:C
Preparation for Accurate Measurement Calibration Example program using macro (E4991A VBA) Example 4-4 shows an example program that enables the calibration function by transferring the calibration coefficient array saved in Example 4-2. This is saved under the filename cal_inp.bas on the sample programs disk. Example 4-4 Line 70 Sets the GPIB address. Line 90 Substitutes a variable for the file name for storing the calibration coefficient array.
Preparation for Accurate Measurement Calibration 320 330 340 350 360 370 380 390 400 410 420 430 440 450 460 470 480 490 500 510 520 530 540 550 560 570 580 590 600 610 620 630 640 650 660 670 680 690 700 710 720 730 740 750 760 770 780 790 800 810 820 90 For i = Input Next i For i = Input Next i For i = Input Next i For i = Input Next i For i = Input Next i For i = Input Next i 1 To Nop_cal * 2 #iFileNo, Cal_a1(i) 1 To Nop_cal * 2 #iFileNo, Cal_b1(i) 1 To Nop_cal * 2 #iFileNo, Cal_c1(i) 1 To Nop_cal * 2
Preparation for Accurate Measurement Electrical Length Compensation Electrical Length Compensation Test Fixture Selection (Set Electrical Length) Use the following GPIB command to select whether to use the Agilent test fixture or a custom test fixture. • SENS:CORR2:FIXT on page 454 Table 4-1 lists the valid combination of test fixtures, the need for Option 002 (Material Measurement option), and measurement modes.
Preparation for Accurate Measurement Electrical Length Compensation Add Offset Delay Time (Port Extension Compensation) In addition to the electrical length of the test fixture, if offset delay time occurs due to port extension, use the following GPIB command to remove the offset delay time.
Preparation for Accurate Measurement Fixture Compensation Fixture Compensation The following section explains how to perform fixture compensation. Define Fixture Compensation Kit The values of the Open/Short standard included with the fixture compensation kit can be set to any values.
Preparation for Accurate Measurement Fixture Compensation Select Fixture Compensation Data Measurement Points Select fixture compensation data measurement points from the following table. Note that when fixed points are used to measure fixture compensation data, fixture compensation coefficients are calculated through interpolation.
Preparation for Accurate Measurement Fixture Compensation Measure Fixture Compensation Data Perform Measurement Use the following GPIB command to measure the Open/Short fixture compensation data used to calculate fixture compensation coefficients. • NOTE SENS:CORR2:COLL on page 449 With a trigger source is set to an external trigger, the above command does not start measurement of fixture compensation data. After executing this command, prepare a trigger.
Preparation for Accurate Measurement Fixture Compensation Fixture Compensation Data Array/Fixture Compensation Coefficient Array The fixture compensation data array contains Open or Short measurement data in the complex format. This data is used for calculating fixture compensation coefficients. The fixture compensation coefficient array contains fixture compensation coefficients in the complex format. These coefficients are calculated by using the Open or Short measurement data.
Preparation for Accurate Measurement Fixture Compensation Example program for execution of fixture compensation After connecting a text fixture, the program shown below enables the fixture compensation function of the fixture compensation kit. In this program, after defining the standard values for the Open/Short state of the fixture compensation kit by using values prepared by the user, the fixture compensation function is enabled by measuring each standard.
Preparation for Accurate Measurement Fixture Compensation read and write operations of the fixture compensation coefficient. Lines 940 - 950 Prompts connection of the standard for fixture compensation measurement specified by the variable Standard$ and waits for the input of [Y] or [y] after the connection. Line 970 Clears the status byte register and operation status event register.
Preparation for Accurate Measurement Fixture Compensation Chapter 4 99 4. Preparation for Accurate Measurement 180 ! Entry Electrical Length of User's Test Fixture 190 ! 200 IF Fix_type$="USER" THEN 210 CALL Inp_data("User's Fixture Electrical Delay(m)",E_length) 220 OUTPUT @Agte4991a;"SENS:CORR2:FIXT:EDEL:USER:DIST "&VAL$(E_length) 230 END IF 240 ! 250 PRINT "Do you want to entry the comp.
Preparation for Accurate Measurement Fixture Compensation 740 OUTPUT @Agte4991a;"DATA:CMP2?" 750 ENTER @Agte4991a;Comp_b(*) 760 ! 770 File$="COMP_COEF" 780 Data_size=(Nop_comp*2*2)*8 790 CREATE File$,Data_size 800 ASSIGN @File TO File$;FORMAT OFF 810 OUTPUT @File;Comp_a(*),Comp_b(*) 820 ASSIGN @File TO * 830 ! 840 PRINT "Compensation Coefficient File Saving Complete" 850 ! 860 Prog_end: END 870 ! 880 ! Fixture Compensation Data Measurement Function 890 ! 900 DEF FNFixt_comp(@Agte4991a,Standard$) 910 DIM Inp
Preparation for Accurate Measurement Fixture Compensation 1310 ! 1320 SUB Inp_data(Mes$,Inp_val) 1330 DIM Inp_char$[9] 1340 PRINT "Input "&Mes$ 1350 Inp_start: INPUT "Value?",Inp_val 1360 PRINT Mes$&" Value: ";Inp_val 1370 PRINT 1380 INPUT "OK? [Y/N]",Inp_char$ 1390 IF UPC$(Inp_char$)<>"Y" THEN Inp_start 1400 SUBEND 4.
Preparation for Accurate Measurement Fixture Compensation Example program using macro (E4991A VBA) The program shown in Example 4-6 is saved under the filename com_meas.bas on the programs disk. The details of this program are explained as follows. Lines 110 - 120 Substitutes a variable for the type of text fixture and the obtained fixture compensation data point. Lines 140 - 150 Sets the type of test fixture and the obtained fixture compensation data point.
Preparation for Accurate Measurement Fixture Compensation without problem, it returns the value of 0. Line 970 When the standard is not connected, the function program returns the value of -1. Lines 1020 - 1060 Inputs the specified data. Example 4-6 Measurement of fixture compensation data (macro) Chapter 4 103 4.
Preparation for Accurate Measurement Fixture Compensation 470 MsgBox "All compen-data measurement completion", vbOKOnly, "Compensation" 480 490 SCPI.Output "FORM:DATA ASC" 500 SCPI.Output "DATA:CMP1?" 510 SCPI.Enter Comp_a, "#" 520 SCPI.Output "DATA:CMP2?" 530 SCPI.Enter Comp_b, "#" 540 550 SCPI.Output "SWE:POIN?" 560 SCPI.
Preparation for Accurate Measurement Fixture Compensation 990 1000 1010 1020 1030 1040 1050 1060 End Function Sub Inp_data(Mes As String, Inp_val As Double) Inp_val = Val(InputBox(Mes, "Input values")) End Sub 4.
Preparation for Accurate Measurement Fixture Compensation 106 Chapter 4
5 Measurement Start and Detection of Measurement End 107 5. Measurement Start and Detection of Meas. End This chapter explains how to prepare a trigger for starting measurement and detecting the end of measurement with the Agilent E4991A.
Measurement Start and Detection of Measurement End Measurement Trigger (Measurement Start) Measurement Trigger (Measurement Start) Trigger System The E4991A trigger system has three states: “Idle,” “Waiting for trigger,” and “Measuring.” as shown in Figure 5-1. Figure 5-1 Trigger System The following section explains the state transitions of the trigger system. Idle State Immediately after the E4991A is powered on, the trigger system is in the Idle state.
Measurement Start and Detection of Measurement End Measurement Trigger (Measurement Start) Waiting for Trigger State (Trigger Detection State) When a trigger is made (detected) or the command for TRIG on page 525 is executed during Waiting for trigger, the trigger system transits to the Measurement state and measurement (sweep) starts. How a trigger is made depends on the trigger source setting. Use the following GPIB command to set the trigger source.
Measurement Start and Detection of Measurement End Measurement Trigger (Measurement Start) Figure 5-2 Transition from Waiting for Trigger to Measuring Measurement State If delay time is specified in the Measurement state, measurement (sweep) starts after the specified delay time has elapsed. When all of the measurements are completed, depending on the setting of the trigger system’s continuous initiation (INIT:CONT), the trigger system transits as follows.
Measurement Start and Detection of Measurement End Measurement Trigger (Measurement Start) Trigger Measurement Continuous Measurement (making a trigger automatically and continuously) Step 1. Use the TRIG:SOUR command to set the trigger source to internal trigger. Step 2. If the trigger system is not initiated (in Idle state), use the INIT:CONT command to enable the trigger system’s continuous initiation. Measurement at any time (making a trigger from an external controller) Step 1.
Measurement Start and Detection of Measurement End Waiting for Measurement End (Detection of Sweep End) Waiting for Measurement End (Detection of Sweep End) Using the Status Register The state of the E4991A can be monitored through status registers. This section explains how to detect measurement end by using status registers. For details on the status report system, including bit configuration of status registers, see B, “GPIB Status Report System,” on page 555.
Measurement Start and Detection of Measurement End Waiting for Measurement End (Detection of Sweep End) Figure 5-3 SRQ Generation Sequence (at measurement end) Adding Wait Time The user can have a controller wait until the E4991A completes measurement by using, for example, the WAIT command in HTBasic. Using this command is very simple, but if the wait time is improperly set, an unexpected error may result. 113 5. Measurement Start and Detection of Meas.
Measurement Start and Detection of Measurement End Example Programs for Detecting Measurement End Example Programs for Detecting Measurement End The following example programs can be used for the detection of measurement end. Example program using HTBasic (SRQ) Example 5-1 shows an example program for detecting measurement end by using an SRQ. After setting the number of times for sweep averaging at 4 and setting the SRQ, a sweep is performed four times.
Measurement Start and Detection of Measurement End Example Programs for Detecting Measurement End Lines 430 - 440 Example 5-1 Indicates measurement end and disables the SRQ interruption.
Measurement Start and Detection of Measurement End Example Programs for Detecting Measurement End Example program using macro (E4991A VBA) You are not able to use an SRQ in the macro program (E4991A VBA), which uses the SingleMeasure method instead of an SRQ. Example 5-2 shows an example program for detecting measurement end by using the SingleMeasure method. After setting the number of sweep averaging to 4, start a sweep by executing SingleMeasure method.
Measurement Start and Detection of Measurement End Example Programs for Detecting Measurement End 220 230 240 250 260 270 bool = SingleMeasure If bool = 0 Then MsgBox ("Sweep Aborted") End End Sub 117 5. Measurement Start and Detection of Meas.
Measurement Start and Detection of Measurement End Example Programs for Detecting Measurement End 118 Chapter 5
6. Read and Write Measurement Data 6 Read and Write Measurement Data This chapter explains how to read and write Agilent E4991A measurement data.
Read and Write Measurement Data Data Transfer Format Data Transfer Format When a measurement condition setting is read from the E4991A, for example, when the FREQ:STAR command in the query format is used to read a sweep start frequency value, the ASCII format is used regardless of the data transfer format setting.
• Floating Point Format Figure 6-2 shows the floating point format. A numeric value is represented as a floating point. For example, the numeric 1000 is expressed as “1.0E3”. Figure 6-2 Floating Point Format IEEE 32-Bit Floating Point Format In this format, a numeric consists of four bytes. Therefore, assuming that one measurement point consists of two pieces of a numeric, when 201 measurement points are transferred, the total data length is 1608 bytes.
Read and Write Measurement Data Data Transfer Format IEEE 64-Bit Floating Point Format In this format, a numeric consists of eight bytes. Therefore, assuming that one measurement point consists of two pieces of a numeric, when 201 measurement points are transferred, the total data length is 3216 bytes. The numeric is transferred in the format shown in Figure 6-4.
Internal Data Flow Data Processing Flow Figure 6-5 shows an overview of the E4991A internal data processing flow. Figure 6-5 E4991A Data Processing Flow The following section explains the internal data arrays show in Figure 6-5. Internal Data Arrays Raw Data Array The raw data array contains the results of calibration, fixture electrical length/port extension compensation, and fixture compensation performed on the measured raw data. It is stored as a complex format (R-X).
Read and Write Measurement Data Internal Data Flow Data Array The data array contains the results of the sweep averaging performed on the raw data array. It is stored as a complex format (R-X). Reading or writing the data array is not allowed. Memory Array The memory array contains the copied data array. Reading or writing the memory array is not allowed. Data Trace Array The data trace array contains the number of measurement points of results obtained by measurement parameter conversion on the data array.
Calibration Data Arrays The calibration data arrays contain Open/Short/Load/Low-loss capacitor measurement data in the complex format. This data is used to calculate calibration coefficients. There are eight arrays containing Open/Short/Load/Low-loss capacitor measurement data. Use the following GPIB command to read the calibration data array.
Read and Write Measurement Data Internal Data Flow Calibration Coefficient Arrays The calibration coefficient arrays contain calibration coefficients in the complex format. These were calculated using a calibration data array. As shown in the following table, there are six arrays containing calibration coefficients: A1, B1, C1, A2, B2, and C2. Use the following GPIB command to read or write a calibration coefficient array.
Fixture Compensation Data Arrays The fixture compensation data array contains Open/Short measurement data in the complex format. This data is used to calculate fixture compensation coefficients. There are two arrays containing Open/Short measurement data. Use the following GPIB command to read the fixture compensation data array.
Read and Write Measurement Data Internal Data Flow Fixture Compensation Coefficient Arrays The fixture compensation coefficient array contains fixture compensation coefficients in the complex format. These were calculated using a fixture compensation data array. As shown in the following table, there are three arrays containing fixture compensation coefficients A, B, and C. Use the following GPIB command to read or write a fixture compensation coefficient array.
Example Programs for Reading Internal Data Arrays Reading the data trace array (ASCII format) An example program for reading the data trace array is shown. In the program, the data trace array is read in ASCII transfer format. Example program using HTBasic The program shown in Example 6-1 is saved under the filename asc_read.htb on the sample programs disk. Below is an explanation of the program’s details.
Read and Write Measurement Data Example Programs for Reading Internal Data Arrays 220 ! 230 OUTPUT @Agte4991a;"DISP:TRAC"&VAL$(Trc1)&":Y:AUTO" 240 ! 250 OUTPUT @Agte4991a;"FORM:DATA ASC" 260 ! 270 OUTPUT @Agte4991a;"CALC"&VAL$(Trc1)&":DATA? FDATA" 280 ENTER @Agte4991a;Meas_data(*) 290 OUTPUT @Agte4991a;"SWE:STIM1?" 300 ENTER @Agte4991a;Swp_prm(*) 310 ! 320 END 330 ! 340 SUB Sweep(@Agte4991a) 350 DIM Buff$[9] 360 INTEGER Swp_bool 370 ! 380 OUTPUT @Agte4991a;"CALC:AVER?" 390 ENTER @Agte4991a;Swp_bool 400 IF S
Example program using macro (E4991A VBA) The program shown in Example 6-2 is saved under the filename asc_read.bas on the sample programs disk. Below is an explanation of the program’s details. Example 6-2 Lines 60 - 70 Substitutes variables for the trace number and number of measurement points. Line 110 Resets the E4991A. Lines 130 - 140 Turns on Trace 1 and sets the measurement point.
Read and Write Measurement Data Example Programs for Reading Internal Data Arrays 250 260 270 280 290 300 310 320 330 340 350 360 370 380 390 132 If bool = 0 Then MsgBox ("Sweep Aborted") ElseIf bool = 1 Then SCPI.Output "DISP:TRAC" & CStr(trc1) & ":Y:AUTO" SCPI.Output "FORM:DATA ASC" SCPI.Output "CALC" & CStr(trc1) & ":DATA? FDATA" SCPI.Enter meas_data, "#" SCPI.Output "SWE:STIM3?" SCPI.
Reading the dc bias level monitor array By using the dc bias monitor function, the example program shown below can read the monitor value at each measurement point. Example program using HTBasic The dc bias monitor value taken during the dc bias voltage sweep is read in binary transfer format (IEEE 64-bit floating-point) and the results are displayed. The program shown in Example 6-3 is saved under the filename bias_mon.htb on the sample programs disk. Below is an explanation of the program’s details.
Read and Write Measurement Data Example Programs for Reading Internal Data Arrays 90 100 110 120 130 140 150 160 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 360 370 380 390 400 410 420 430 440 450 460 470 480 490 500 510 520 530 540 550 560 570 580 590 600 610 620 630 640 650 660 134 ! ASSIGN @Agte4991a TO 717 ASSIGN @Binary TO 717;FORMAT OFF ! Trc1=1 Trc2=2 Start_bias$="0V" Stop_bias$="40V" Lim_bias$="50MA" Nop=41 Swp_count=1 Cw_freq$="100MHZ" Osc_level$="0.
670 ENTER @Agte4991a USING "#,8A";Header$ 680 ENTER @Binary;Swp_prm(*) 690 ENTER @Agte4991a USING "#,1A";Buff$ 700 ! 710 PRINT "BIAS MONITOR RESULT" 720 PRINT 730 PRINT "DC Bias[V] Z[ohm] Mon Bias[V]" 740 PRINT "---------------------------------------" 750 FOR I=1 TO Nop 760 PRINT Swp_prm(I),Meas_data(I),Mon_bias(I) 770 NEXT I 780 ! 790 END 800 ! 810 SUB Sweep(@Agte4991a) 820 DIM Buff$[9] 830 INTEGER Swp_bool 840 ! 850 OUTPUT @Agte4991a;"CALC:AVER?" 860 ENTER @Agte4991a;Swp_bool 870 IF Swp_bool=1 THEN OUTPU
Read and Write Measurement Data Example Programs for Reading Internal Data Arrays Example program using macro (E4991A VBA) The dc bias monitor value at the time of the dc bias voltage sweep is read in ASCII transfer format and the results are saved to a specified file. When using a macro, you cannot select a binary transfer format. The program shown in Example 6-4 is saved under the filename bias_mon.bas on the sample programs disk. Below is an explanation of the program’s details.
40 Dim start_bias As Double, stop_bias As Double, lim_bias As Double 50 Dim cw_freq As Double, osc_level As Double 60 Dim trc1 As Integer, trc2 As Integer, nop As Integer, swp_count As Integer 70 Dim i As Integer, swp_bool As Integer, bool As Integer 80 Dim fileNum As Integer 90 Dim file As String 100 110 trc1 = 1 120 trc2 = 2 130 start_bias = 0 140 stop_bias = 40 150 lim_bias = 0.05 160 nop = 41 170 swp_count = 1 180 cw_freq = 100000000# 190 osc_level = 0.1 200 210 ' E4991A settings 220 230 SCPI.
Read and Write Measurement Data Example Programs for Reading Internal Data Arrays 600 SCPI.Enter meas_data, "#" 610 SCPI.Output "CALC" & CStr(trc1) & ":DATA:MON? V" 620 SCPI.Enter mon_bias, "#" 630 SCPI.Output "SWE:STIM3?" 640 SCPI.Enter swp_prm, "#" 650 660 file = "a:\mon_data.txt" 670 fileNum = FreeFile 680 Open file For Output As #fileNum 690 Print #fileNum, "Bias Monitor Result" 700 Print #fileNum, "" 710 Print #fileNum, "DC Bias[V] Z[ohm] Mon.
7. Measurement Result Processing 7 Measurement Result Processing This chapter explains how to process measurement results by using the Agilent E4991A’s marker function and equivalent circuit analysis function.
Measurement Result Processing Using Marker Function Using Marker Function Markers Turning On/Off Markers Markers must first be displayed on a specified trace before the marker function can be used. The E4991A allows you to display up to nine markers (markers 1-8 and a reference marker) on one trace. Use the following GPIB command to turn on/off Markers 1-8. • CALC{1-5}:MARK{1-8} on page 304 Use the following GPIB command to turn on/off the reference marker (Marker R).
Measurement Result Processing Using Marker Function Selecting Trace for Which Markers Are Displayed Use the following GPIB command to select whether markers are displayed on a data trace or a memory trace. • CALC{1-5}:MARK:ON on page 327 Displaying Marker List Use the following GPIB command to display a list of all markers on the screen.
Measurement Result Processing Using Marker Function Reading Measurement Value at Marker Position The following GPIB command can be used to select a marker from 1-8 and read the measurement value at the specified marker position. • CALC{1-5}:MARK{1-8}:Y? on page 339 The following GPIB command can be used to read the measurement value at the reference marker position.
Measurement Result Processing Using Marker Function Entering Marker Values as E4991A Setting The stimulus value or measurement value at an active marker position can be used as the E4991A internal setting as follows. The stimulus value at an active marker position is entered as the center value of the sweep range. • The range between the stimulus values at an active marker and a Δ marker is entered as the span value of the sweep range if the Δ marker mode is enabled.
Measurement Result Processing Using Marker Function Marker Search Function The marker search function allows you to search for a certain point on a trace and have the active marker move to that point. Selecting Points to Search for The marker search function can be used to search for the following points on a trace. • Maximum value • Minimum value • Positive peak value • Negative peak value • Target value Use the following GPIB command to select the point to search for.
Measurement Result Processing Using Marker Function Defining a Target The marker’s target search function can be used to search for a specified target. Use the following GPIB command to specify a target value. • CALC{1-5}:MARK:FUNC:TARG on page 324 Defining a Peak • CALC{1-5}:MARK:APE:EXC:X on page 307 • CALC{1-5}:MARK:APE:EXC:Y on page 308 The following GPIB command can be used to define a peak based on the stimulus value and the measurement value at an active marker position.
Measurement Result Processing Using Marker Function Performing Marker Search The following GPIB command can be used to perform marker search only once for a specified target on a specified trace. When the specified target is found, the active marker moves to that point.
Measurement Result Processing Using Marker Function Limit Test Function The marker’s limit test function can be used to determine whether the measurement value at the marker position specified as the test marker falls within the range of the test limit. Setting Test Marker Before performing limit tests, the following GPIB command must be used to select one of markers 1-8 as the test marker. 7.
Measurement Result Processing Using Marker Function Reading Limit Test Results Limit test results can be read in two ways: Reading the test result of a specified test marker or reading the overall evaluation results of all test markers (that is, the test results for all of the test markers are logically ANDed). Use the following GPIB command to read the test result of a specified test marker (1-8).
Measurement Result Processing Using Marker Function Statistical Analysis Function The E4991A has a function to analyze the statistical information of a specified trace, including averages, standard deviation, and the difference between maximum and minimum values. Use the following GPIB command to turn on/off the statistical analysis function. • The statistical analysis function can only be used when the marker function is enabled.
Measurement Result Processing Using Marker Function Example Programs for Marker Search Function Example programs for the marker search function are shown below. After a sweep is performed, the positive and negative peaks are searched within the range of 100 MHz - 1 GHz by the marker function, a marker is placed at each location, and the marked values are read and displayed. Example program using HTBasic Example 7-1 shows an example program for the marker search function.
Measurement Result Processing Using Marker Function Lines 1080 - 1120 In the function sub-program (FNPeak_found), reads the marker search results at the specified trace by using questionable status marker condition resistor. When marker search failure occurs, a bit on the specified trace is set to 1and the function sub-program returns the value of 1. Example 7-1 Searching for a peak by using a marker (HTBasic) Chapter 7 151 7.
Measurement Result Processing Using Marker Function "&VAL$(Delta_x) 480 OUTPUT @Agte4991a;"CALC"&VAL$(Trc1)&":MARK:APE:EXC:Y "&VAL$(Delta_y) 490 ! 500 PRINT "Search Range: "&VAL$(Sear_start/1.E+6)&"MHz "&VAL$(Sear_stop/1.
Measurement Result Processing Using Marker Function Chapter 7 7. Measurement Result Processing 930 OUTPUT @Agte4991a;"*OPC?" 940 ENTER @Agte4991a;Buff$ 950 ! 960 ON INTR 7 GOTO Swp_end 970 ENABLE INTR 7;2 980 OUTPUT @Agte4991a;"INIT" 990 DISP "Now Measuring...
Measurement Result Processing Using Marker Function Example program using macro (E4991A VBA) Example 7-2 shows an example program for the marker search function. This program is saved under the filename mkr_sear.bas on the sample programs disk. Below is an explanation of the program’s details. Lines 110 - 180 Substitutes variables for the trace number, marker number, partial search range, and defined peak value. Line 220 Resets the E4991A.
Measurement Result Processing Using Marker Function active marker (negative peak) position when a negative peak is found. Example 7-2 Line 910 Stops the execution of the macro. Lines 950 - 1510 In the function program (peak_not_found), reads the marker search results at the specified trace by using the questionable status marker condition resistor. When marker search failure occurs, the bit on the specified trace is set to 1and the function program returns a value of 1.
Measurement Result Processing Using Marker Function " ON" 470 SCPI.Output "CALC" & CStr(trc1) & ":MARK" & CStr(mkr2) & " ON" 480 SCPI.Output "CALC" & CStr(trc1) & ":MARK:DISC OFF" 490 500 SCPI.Output "CALC" & CStr(trc1) & ":MARK:FUNC:DOM ON" 510 SCPI.Output "CALC" & CStr(trc1) & ":MARK" & CStr(mkr) & ":ACT" 520 SCPI.Output "CALC" & CStr(trc1) & ":MARK" & CStr(mkr) & ":X " & CStr(sear_start) 530 SCPI.Output "CALC" & CStr(trc1) & ":MARK:FUNC:DOM:STAR" 540 SCPI.
Measurement Result Processing Using Marker Function Chapter 7 7. Measurement Result Processing CStr(n_peak_y) & "[ohm] @" & CStr(n_peak_x / 1000000#) & "MHz") 880 End If 890 End If 900 910 End 920 930 End Sub 940 950 Private Function peak_not_found(trc As Integer) 960 Dim reg As String 970 Dim div As Integer, Mo As Integer 980 990 SCPI.Output "STAT:QUES:SEAR:COND?" 1000 SCPI.
Measurement Result Processing Using Marker Function 1450 1460 1470 1480 1490 1500 1510 158 Case 4 peak_not_found = trc4 Case 5 peak_not_found = trc5 End Select End Function Chapter 7
Measurement Result Processing Using Marker Function Example Programs for Marker Limit Test Function Below are example programs for the limit test function. After sweeping, this executes a limit test at the specified test marker position and displays the PASS/FAIL test results. Example program using HTBasic Line 70 Sets the GPIB address. Lines 90 - 100 Substitutes a variable for the trace number.
Measurement Result Processing Using Marker Function Example 7-3 Execution of the limit test using a marker (HTBasic) 10 20 30 40 50 60 70 80 90 100 110 120 130 140 150 160 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 360 370 380 390 400 410 420 430 440 450 460 470 480 490 500 510 520 530 ON" 540 160 DIM Mkr1_stim(8),Mkr1_upp(8),Mkr1_low(8),Mkr1_meas(8) DIM Ref_judge$[4],Mkr1_judge$(8)[4],All_judge$[4] REAL Ref_stim,Ref_upp,Ref_low,Ref_meas INTEGER Trc1,Trc2,Mkr ! CLEAR SCR
Measurement Result Processing Using Marker Function Chapter 7 161 7.
Measurement Result Processing Using Marker Function -" 960 PRINT " R",Ref_stim,Ref_low,Ref_meas,Ref_upp,Ref_judge$ 970 FOR Mkr=1 TO 8 980 PRINT Mkr,Mkr1_stim(Mkr),Mkr1_low(Mkr),Mkr1_meas(Mkr),Mkr1_upp(Mkr),Mkr1_ judge$(Mkr) 990 NEXT Mkr 1000 PRINT "----------------------------------------------------------------" 1010 PRINT "total "&All_judge$ 1020 ! 1030 END 1040 ! 1050 SUB Sweep(@Agte4991a) 1060 DIM Buff$[9] 1070 INTEGER Swp_bool 1080 ! 1090 OUTPUT @Agte4991a;"CALC:AVER?" 1100 ENTER @Agte4991a;Swp_bool 11
Measurement Result Processing Using Marker Function Example program using macro (E4991A VBA) Example 7-4 shows an example program for the marker limit test. This program is saved under the filename lim_test.bas on the sample programs disk. Below is an explanation of the program’s details. Substitutes a variable for the trace number. Line 130 - 410 Substitutes variables for the stimulus value of the test marker and the upper and lower values of the test limit. Line 450 Resets the E4991A.
Measurement Result Processing Using Marker Function Example 7-4 Execution of the limit test using a marker (macro) 10 Sub Main() 20 Dim mkr1_stim(8) As Double, mkr1_upp(8) As Double, mkr1_low(8) As Double 30 Dim mkr1_meas(8) As Double 40 Dim ref_stim As Double, ref_upp As Double, ref_low As Double, ref_meas As Double 50 Dim ref_judge As String, mkr1_judge(8) As String, all_judge As String 60 Dim trc1 As Integer, trc2 As Integer, mkr As Integer 70 Dim swp_bool As Integer, bool As Integer 80 Dim file As Str
Measurement Result Processing Using Marker Function Chapter 7 165 7. Measurement Result Processing 530 SCPI.Output "CALC" & CStr(trc1) & ":MARK:REF ON" 540 SCPI.Output "CALC" & CStr(trc1) & ":MARK:REF:FUNC:DOM:LIM ON" 550 SCPI.Output "CALC" & CStr(trc1) & ":MARK:REF:X " & CStr(ref_stim) 560 SCPI.Output "CALC" & CStr(trc1) & ":MARK:REF:FUNC:DOM:LIM:UP " & CStr(ref_upp) 570 SCPI.Output "CALC" & CStr(trc1) & ":MARK:REF:FUNC:DOM:LIM:LOW " & CStr(ref_low) 580 590 For mkr = 1 To 8 600 SCPI.
Measurement Result Processing Using Marker Function 970 Open file For Output As #1 980 Print #1, "Marker Limit Test Results" 990 Print #1, "" 1000 Print #1, " Mkr freq.
Measurement Result Processing Equivalent Circuit Analysis Equivalent Circuit Analysis Selecting an Equivalent Circuit Model The E4991A allows you to select one of the following five types of circuit models to perform equivalent circuit analysis. DUT type A Inductor with high core loss B Inductor and resistor C Resistor with high resistance D Capacitor E Oscillator and resonator 7. Measurement Result Processing Equivalent circuit model type Typical frequency characteristics*1 *1.
Measurement Result Processing Equivalent Circuit Analysis Performing Equivalent Circuit Analysis Use the following GPIB command to perform equivalent circuit analysis. • NOTE CALC{1-5}:EPAR on page 295 Equivalent circuit analysis is performed within the range specified for marker search. Use the following GPIB command in the query format to read equivalent circuit analysis results (equivalent circuit parameters: R1, C1, L1, and C0).
Measurement Result Processing Equivalent Circuit Analysis Example Programs for Equivalent Circuit Analysis Below are example programs of equivalent circuit analysis. After a sweep, the equivalent circuit model is set to E, the equivalent circuit analysis is performed, and the results are read and displayed. In addition, frequency characteristics are simulated using the parameters of the analysis results. Example program using HTBasic Example 7-5 Line 60 Sets the GPIB address.
Measurement Result Processing Equivalent Circuit Analysis 90 100 110 120 130 140 150 160 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 360 370 380 390 400 410 420 430 440 450 460 470 480 490 500 510 520 530 540 550 560 570 580 590 600 610 620 630 640 650 660 Stop_f$="150MHZ" Nop=201 Trc1=1 Trc2=2 Swp_count=1 Equ_model$="E" ! ! E4991A settings ! OUTPUT @Agte4991a;"SYST:PRES" ! OUTPUT @Agte4991a;"DISP:TRAC"&VAL$(Trc1)&" ON" OUTPUT @Agte4991a;"CALC"&VAL$(Trc1)&":FORM Z" OUTPUT @A
Measurement Result Processing Equivalent Circuit Analysis Chapter 7 7.
Measurement Result Processing Equivalent Circuit Analysis Example program using macro (E4991A VBA) Example 7-6 shows an example program for the equivalent circuit analysis. This program is saved under the filename circuit.bas on the sample programs disk. Below is an explanation of the details of the program. Example 7-6 Lines 120 - 180 Substitutes variables for the sweep range, number of measurement points, trace number, sweep averaging factor, and type of the equivalent circuit model.
Measurement Result Processing Equivalent Circuit Analysis Chapter 7 173 7. Measurement Result Processing 100 Dim msg As String 110 120 start_f = "50MHZ" 130 stop_f = "150MHZ" 140 nop = 201 150 trc1 = 1 160 trc2 = 2 170 swp_count = 1 180 equ_model = "E" 190 200 ' E4991A settings 210 220 SCPI.Output "SYST:PRES" 230 ' 240 SCPI.Output "DISP:TRAC" & CStr(trc1) & " ON" 250 SCPI.Output "CALC" & CStr(trc1) & ":FORM Z" 260 SCPI.Output "DISP:TRAC" & CStr(trc2) & " ON" 270 SCPI.
Measurement Result Processing Equivalent Circuit Analysis 610 620 630 640 650 660 670 680 690 700 710 720 730 740 750 760 770 780 790 800 810 820 830 840 850 860 870 880 174 SCPI.Output SCPI.Output SCPI.Output SCPI.Output SCPI.Output SCPI.Output "CALC" & CStr(trc1) & ":EPAR:SIM" "CALC" & CStr(trc2) & ":EPAR:SIM" "DISP:TRAC" & CStr(trc1) & ":Y:FOR AND" "DISP:TRAC" & CStr(trc2) & ":Y:FOR AND" "DISP:TRAC" & CStr(trc1) & ":Y:AUTO" "DISP:TRAC" & CStr(trc2) & ":Y:AUTO" SCPI.Output "FORM:DATA ASC" SCPI.
8. Save and Recall Files 8 Save and Recall Files This chapter explains how to save the Agilent E4991A’s measurement condition settings or measurement results to a file and how to later recall them from the file.
Save and Recall Files Saving and Recalling Files Saving and Recalling Files Current Folder Basically, file save and recall operations are performed on the specified files in the current folder. Specifying Current Folder Use the following GPIB command to change the current folder. In the factory default settings, the current folder is set to “D:\Documents.” • MMEM:CDIR on page 383 Recalling File List The following GPIB command can be used to recall a list of files in the current folder.
Save and Recall Files Saving and Recalling Files Saving Files The E4991A allows saving the following measurement condition settings and measurement results to a file. Saved Files The E4991A provides several GPIB commands corresponding to the types of files to be saved, as shown in the table below. File type State file (with extension .sta) Data file (with extension .dat) Data file (with extension .txt) (with extension .jpg) Graphics file (with extension .bmp) CITIfile (with extension .
Save and Recall Files Saving and Recalling Files Recalling Files The following GPIB commands can be used to recall measurement condition settings and measurement results. File type State file (with extension .sta) Data file in binary format (with extension .dat) Macro program (with extension .lcr) What is recalled GPIB command Recalls what was saved with the MMEM:STOR command. MMEM:LOAD on page 385 Recalls an internal data array saved in binary format with the MMEM:STOR:TRAC command.
Save and Recall Files Folder and File Manipulation Folder and File Manipulation The E4991A allows the following operations to manipulate folders and files. Folders Create Use the following GPIB command to create a new folder. • MMEM:MDIR on page 386 Delete Use the following GPIB command to delete a folder. • MMEM:RDIR on page 388 Files Use the following GPIB command to rename an existing file. The original and renamed file names must be specified with an extension.
Save and Recall Files Example Programs for Saving/Recalling a File Example Programs for Saving/Recalling a File Example programs for saving/recalling a file are shown below. A file is saved/recalled by choosing the appropriate sub-program from a menu. Example program using HTBasic Example 8-1 shows an example program for saving/recalling a file using HTBasic. This program is saved under the filename save_rec.htb on the sample programs disk. Below is an explanation of the program’s details.
Save and Recall Files Example Programs for Saving/Recalling a File Example 8-1 Saving/Recalling (HTBasic) Chapter 8 8.
Save and Recall Files Example Programs for Saving/Recalling a File 550 IF UPC$(Inp_chr$)="Y" THEN 560 INPUT "Input new current folder name you wish",Holder$ 570 Holder$=""""&Holder$&"""" 580 OUTPUT @Agte4991a;"MMEM:CDIR "&Holder$ 590 OUTPUT @Agte4991a;"SYST:ERR?" 600 ENTER @Agte4991a;Err_no,Err_mes$ 610 IF Err_no<>0 THEN 620 BEEP 630 PRINT Err_mes$&" occured" 640 PRINT 650 GOTO Input_name 660 ELSE 670 PRINT "new current holder name: "&Holder$ 680 PRINT 690 END IF 700 END IF 710 SUBEND 720 ! 730 SUB Save_sta
Save and Recall Files Example Programs for Saving/Recalling a File Chapter 8 183 8.
Save and Recall Files Example Programs for Saving/Recalling a File [Y/N]",Inp_chr$ 1630 IF UPC$(Inp_chr$)="N" THEN 1640 IF UPC$(File_type$[1,1])="A" THEN 1650 OUTPUT @Agte4991a;"MMEM:STOR:TRAC:ASCII "&File$ 1660 ELSE 1670 OUTPUT @Agte4991a;"MMEM:STOR:TRAC "&File$ 1680 END IF 1690 OUTPUT @Agte4991a;"SYST:ERR?" 1700 ENTER @Agte4991a;Err_no,Err_mes$ 1710 IF Err_no<>0 THEN 1720 BEEP 1730 PRINT Err_mes$&" occured" 1740 PRINT 1750 GOTO Input_name 1760 ELSE 1770 PRINT "save done" 1780 PRINT 1790 END IF 1800 ELSE 1
Save and Recall Files Example Programs for Saving/Recalling a File Chapter 8 185 8. Save and Recall Files 2180 PRINT 2190 PRINT "1: 1 Port" 2200 PRINT "2: 2 Port Series" 2210 PRINT "3: 2 Port Shunt" 2220 PRINT 2230 INPUT "Select the CITIfile model type [1-3]",Model 2240 ! 2250 Input_name:! 2260 INPUT "Input CITIfile name without extension you wish to save.
Save and Recall Files Example Programs for Saving/Recalling a File 2720 2730 2740 2750 2760 2770 2780 2790 2800 2810 2820 2830 186 BEEP PRINT Err_mes$&" occured" PRINT GOTO Input_name ELSE PRINT "save done" PRINT END IF ELSE GOTO Input_name END IF SUBEND Chapter 8
Save and Recall Files Example Programs for Saving/Recalling a File Example program using macro (E4991A VBA) Example 8-2 shows an example program for saving/recalling a file using a Macro. This program is saved under the filename save_rec.bas on the sample programs disk. Below is an explanation of the program’s details. Lines 80 - 400 User selects the menu item for saving/recalling the specified file and changes the current folder.
Save and Recall Files Example Programs for Saving/Recalling a File msg7 & msg8 & msg9 & msg10, "file menu") 200 210 Select Case ans 220 Case "1" 230 Call chn_curr_holder 240 Case "2" 250 Call save_state 260 Case "3" 270 Call recall_state 280 Case "4" 290 Call save_data 300 Case "5" 310 Call recall_data 320 Case "6" 330 Call save_citi 340 Case "7" 350 Call save_graphics 360 Case "8", "" 370 GoTo menu_end 380 End Select 390 400 GoTo menu 410 420 menu_end: 430 End 440 End Sub 450 460 Private Sub chn_curr_holde
Save and Recall Files Example Programs for Saving/Recalling a File Chapter 8 189 8. Save and Recall Files 760 Dim msg As String, file As String, err_mes As String 770 Dim err_no As Integer 780 790 input_name: 800 msg = "Input the state file name without extension you wish to save.
Save and Recall Files Example Programs for Saving/Recalling a File 1300 End If 1310 input_end: 1320 End Sub 1330 1340 Private Sub save_data() 1350 Dim msg As String, file As String, file_type As String 1360 Dim err_mes As String, bool As String 1370 Dim i As Integer, err_no As Integer 1380 1390 For i = 1 To 4 1400 Select Case i 1410 Case 1 1420 ans = MsgBox("Do you want to save the data array?", vbYesNo) 1430 Case 2 1440 ans = MsgBox("Do you want to save the data trace array?", vbYesNo) 1450 Case 3 1460 ans
Save and Recall Files Example Programs for Saving/Recalling a File Chapter 8 191 8. Save and Recall Files 1810 ElseIf err_no = 0 Then 1820 MsgBox ("save done") 1830 End If 1840 ElseIf ans = vbYes Then 1850 GoTo input_name 1860 End If 1870 input_end: 1880 End Sub 1890 1900 Private Sub recall_data() 1910 Dim msg As String, file As String, err_mes As String 1920 Dim err_no As Integer 1930 1940 input_name: 1950 msg = "Input the binary data file file name without extension you wish to recall.
Save and Recall Files Example Programs for Saving/Recalling a File 2340 file = InputBox(msg, "file name") 2350 If file = "" Then GoTo input_end 2360 file = """" & file & """" 2370 msg = "file name : " & file & vbCrLf & vbCrLf & "Do you want to change the file name again?" 2380 ans = MsgBox(msg, vbYesNo) 2390 If ans = vbNo Then 2400 SCPI.Output "*CLS" 2410 SCPI.Output "MMEM:STOR:CITI" & CStr(model) & " " & file 2420 SCPI.Output "SYST:ERR?" 2430 SCPI.Enter err_no, "#" 2440 SCPI.
Save and Recall Files Example Programs for Saving/Recalling a File 2880 2890 2900 2910 2920 2930 2940 2950 End If ElseIf ans = vbYes Then GoTo input_name End If input_end: End Sub 8.
Save and Recall Files Example Programs for Saving/Recalling a File 194 Chapter 8
9. Using Printer 9 Using Printer This chapter explains how to use a printer connected to the Agilent E4991A to print out measurement results and other information from the instrument.
Using Printer Printing out to a Printer Connected to E4991A Printing out to a Printer Connected to E4991A The E4991A allows the user to print out, for example, the graphical images displayed on the LCD screen. For details on how to connect a printer and available printers, refer to the operation manual. Selecting Print Contents The following information can be printed out to a printer.
10 Setting the Display 197 10. Setting the Display This chapter explains how to set the display screen of the Agilent E4991A.
Setting the Display Setting the Display Setting the Display The E4991A provides several GPIB commands that can be applied to the entire screen (all windows) or to a specific trace. GPIB Commands for Entire Screen (windows) Enable/Disable Update of Displayed Information The following GPIB command can be used to enable/disable update of the entire screen.
Setting the Display Setting the Display Use Memory Trace Use the following GPIB command to copy the measurement data to the memory trace. • CALC{1-5}:MATH:MEM on page 341 Select Trace to Be Displayed If measurement data is not copied to memory, only the data trace can be displayed on the screen. If measurement data is copied to memory, one of the following can be selected for display on the screen.
Setting the Display When Data Trace Is Refreshed When Data Trace Is Refreshed The timing used for refreshing the data trace can be set to any point. When you want to update trace data frequently, use the following GPIB command to specify when it should be refreshed. Refresh for Each Sweep Use the following GPIB command to specify that the data trace be refreshed each time sweep is completed.
11. Error Handling 11 Error Handling This chapter describes how the Agilent E4991A handles errors in program execution.
Error Handling Using the Error Queue Using the Error Queue The error queue contains the error numbers and messages of any errors that have occurred, which could provide very useful information depending on the circumstances. Use the following GPIB command to read the error queue. • SYST:ERR? on page 517 Also, the following GPIB command can be used to obtain the number of errors in the queue. • SYST:ERR:COUN? on page 518 The error queue can be used in the following ways. 1.
Using Status Report Mechanism The E4991A’s status can be monitored through a set of status registers. The Standard Event Status Register indicates whether an error has occurred. A program uses SRQ (Service Request) to detect an error based on the information from these registers. To detect an error with SRQ, use the following GPIB commands. • *SRE on page 283 • *ESE on page 280 Then perform the following procedure. Step 1.
Error Handling Example Program for Error Handling Example Program for Error Handling Using HTBasic Example 11-1 shows a program that uses SRQ to detect an error. This program is saved as error.htb on the sample programs disk. After setting SRQ, this program intentionally generates an error by issuing an invalid command not provided by the E4991A and performs error handling.
160 OUTPUT @Agte4991a;"FREQ:STAR 1MHZ" 170 PRINT "Set Start Frequency:1MHz" 180 OUTPUT @Agte4991a;"FREQ*STOP 3GHZ" 190 PRINT "Set Stop Frequency :3GHz" 200 OUTPUT @Agte4991a;"*OPC?" 210 ENTER @Agte4991a;Buff$ 220 GOTO Skip_err_proc 230 Err_proc: OFF INTR 7 240 OUTPUT @Agte4991a;"SYST:ERR?" 250 ENTER @Agte4991a;Err_no,Err_mes$ 260 PRINT "Error occurred!!" 270 PRINT " No:";Err_no,"Description: "&Err_mes$ 280 PRINT "PROGRAM INTERRUPT!!" 290 GOTO Prog_end 300 Skip_err_proc: PRINT "PROGRAM DONE!" 310 Prog_end: E
Error Handling Example Program for Error Handling Using the macro (E4991A VBA) Example 11-2 shows a program that uses an event to detect an error from the E4991A. This program performs error handling when the E4991A shows a measurement failure. It generates an error message and stops execution of the macro. This program is saved as error.bas (lines 10 - 300) and bsc_meas.cls (lines 1000 - 4050) on the sample programs disk.
150 SCPI.Output "CALC:AVER:COUN " & CStr(swp_count) 160 SCPI.Output "CALC:AVER ON" 170 180 SCPI.Output "TRIG:SOUR INT" 190 SCPI.Output "INIT:CONT OFF" 200 SCPI.Output "ABOR" 210 220 swp_bool = SCPI.Query("CALC:AVER?") 230 If swp_bool = 1 Then SCPI.Output "CALC:AVER:CLE" 240 250 bool = SingleMeasure 260 If bool = 0 Then MsgBox ("Sweep Aborted") 270 280 Set Err.Evnt = Nothing 290 300 End Sub 1000 Public WithEvents Evnt As E4991ALib.
Error Handling Example Program for Error Handling 208 Chapter 11
12. Shutting Down the Instrument 12 Shutting Down the Instrument This chapter explains how to properly shut down the Agilent E4991A.
Shutting Down the Instrument Shutdown Procedure Shutdown Procedure The following GPIB command can be used to remotely shut down the E4991A. This command cannot be used to the instrument’s power on. • SYST:POFF on page 523 When the above command is used to shut down the E4991A, the standby switch remains pressed, unlike when the instrument is shut down by using the standby switch on the front panel. To turn the power on again from this state, use one of the following methods.
13. Use of Macro 13 Use of Macros This chapter explains how to use the macro function of the Agilent E4991A to create macro programs with the Visual Basic editor. Information is also given on how to execute produced macros.
Use of Macros Overview of Macros Overview of Macros The E4991A is loaded with a macro function. A macro program allows you to automatically execute a series of multiple commands by performing a single command. A macro allows you to combine the steps in a complicated procedure into a single step for a wide variety of applications as well as to control peripheral equipment.
Use of Macros Macro Function Overview Macro Function Overview By using the macro function, you can execute the following operations. 1. Control the E4991A From E4991A VBA through COM object, you can control the E4991A. 2. Control peripheral equipment You can use a macro (E4991A VBA) to control peripheral equipment connected through the USB/GPIB interface of the E4991A. 3.
Use of Macros Starting Up and Closing Visual Basic Editor Starting Up and Closing Visual Basic Editor Visual Basic Editor is software used for making and editing macros. The following procedures explain how to start up and quit Visual Basic Editor. Starting up Visual Basic Editor Start up Visual Basic Editor as follows. Step 1. From the measurement screen of the E4991A, use the following menu command. Utility - Visual Basic Editor...
Use of Macros Making/Editing Macros Making/Editing Macros The actual steps in making macros are briefly explained here. Only the basics of using E4991A VBA are explained, so when you make an actual macro, please refer to E4991A VBA help. Elements of Visual Basic Editor Each major part of Visual Basic Editor and its operations are explained here. Tool bar In the initial setup of Visual Basic Editor, the standard tool bar shown below is displayed.
Use of Macros Making/Editing Macros Window right after startup When Visual Basic Editor is started up, several windows are initially displayed. Here, the most important windows are described. • Project explorer A list of macros (modules) made or loaded by Visual Basic Editor is displayed here. Module is explained under “Module” on page 221. • Property window In E4991A VBA, a program is represented on the user form by either a command button, called a “control,” or a text box.
Use of Macros Making/Editing Macros Figure 13-2 Editor screen of Visual Basic right after startup 13.
Use of Macros Making/Editing Macros Other windows The following windows are not displayed after startup of Visual Basic Editor but are needed for programming. Some of the windows displayed in Visual Basic Editor are not introduced here. • Form designer By using the form designer, you can make your own user forms. When the corresponding macro is executed, the user form will be displayed on the screen.
Use of Macros Making/Editing Macros • Code window The screen used to input program code is the code window. When adding a module to the project, or by double-clicking the control arranged on the user form, the code window is opened. For explanations of each part of the code window, please refer to “Parts of the code window” on page 226. Figure 13-4 Display screen of code window 13.
Use of Macros Making/Editing Macros • Object browser The object browser provides access to the object and is displayed as follows. Step 1. T object browser can be displayed by the following menu command. View - Object Browser In E4991A, the settings of measurement conditions and the software for calling measurement values are provided in the form of individual objects for each use. Using the object browser, you can refer to the software objects provided by the E4991A (COM Interface).
Use of Macros Making/Editing Macros Project and module In the project explorer, the macro currently used is displayed. Here, the elements of project and module are briefly described. Figure 13-6 Example display screen of project explorer The element that gathers and manages a micro’s module group is called a project. With the E4991A, it is impossible to distinguish and use multiple projects within the project explorer.
Use of Macros Making/Editing Macros • User form The program (procedure) is shown on the control pasted on the user form. The extension “*.frm” is attached to a user form. Step 1. User form is added to a project by the following menu command. Insert - UserForm After the user form is added, the code window describing its code is not displayed but can be viewed double-clicking on the appropriate control on the user form.
Use of Macros Making/Editing Macros Exporting modules Saving the created modules individually in folders is called exporting. A module is exported by following the procedure below. NOTE When you export a module, the designated module is saved in a folder but not in the project unit. For how to save a macro in the project unit, please refer to “Saving macros” on page 232. Step 1. In the project explorer, right-click on the module you want to export, which will display the shortcut menu. Step 2.
Use of Macros Making/Editing Macros Importing modules Calling an exported module and inserting it into project is called importing. A module is imported by following the procedure below. Step 1. Display the Import File dialogue box by the following menu command. File - Import File... Figure 13-8 Example display screen of Import File dialogue box Step 2. In the Import File dialogue box, select the file to import. Next, click the Open button to import the file into the project.
Use of Macros Making/Editing Macros Removing modules The procedure for removing unnecessary modules from a macro is explained below. In the following example, a standard module called “Module1” is removed. Step 1. In the project explorer, right-click the “Modulel” module under the “Modules” icons to display the shortcut menu. Step 2. Next, click Remove Module1 in the shortcut menu. Step 3. When the next dialog box asks you if you want to export module1 before removing it, click the No button. 13.
Use of Macros Making/Editing Macros Describing macros The following explains each part of the code window used in making macros and how to describes programs. Parts of the code window You describe macros in the code window. Double-click on any module from the property explorer to open the code window. Figure 13-9 Example display screen of code window • Object box In this list box select the object that you want to display in the code window.
Use of Macros Making/Editing Macros Structure of macro Each part of a macro is explained by using the following example of a simple macro. The parts of the program are indicated by the numbers to the right in parentheses (these numbers are not used in the actual program).
Use of Macros Making/Editing Macros E4991A Library The COM Interface is provided to control the E4991A. In Visual Basic Editor, you can see a list of COM Interfaces that work with the E4991A by opening the object browser while programming. This also displays the VBA Syntax and a simple explanation of the E4991A COM Interface. Since explanations of the E4991A COM Interface are not included in E4991A VBA help, please refer to Chapter 18, “COM Interface Reference,” on page 527. Step 1.
Use of Macros Making/Editing Macros Debugging macros In order to eliminate disruptive errors (bugs) from macros, the operation of debugging is necessary. E4991A VBA has a tool that can search for bugs and resolve such situations. Types of bugs and debugging The following types of bugs are the most common. • Syntax error (compile error) A syntax error occurs by inputting a statement that violates the grammar rules of Visual Basic. For example, an error in spelling is a syntax error.
Use of Macros Executing and Terminating Macros Executing and Terminating Macros Executing macros With the E4991A, macros can be executed in the following four ways. Executing macros from Visual Basic Editor Step 1. You can display the Macros dialogue box by using either of the following methods. • Type the [F5] key from the keyboard. • Use the Run - Run menu command in Visual Basic Editor. Step 2. In the Macros dialogue box, execute the selected macro (procedure).
Use of Macros Executing and Terminating Macros Executing macros by GPIB commands You can execute a macro by using a GPIB command. First, specify the macro to be executed by using the following GPIB command. • PROG:NAME on page 394 By continuously using the following GPIB command, execute the macro. • PROG:STAT on page 395 Display screen right after execution of a macro When you execute a macro, the Macros dialogue box first opens. Specify the macro to be executed in this box.
Use of Macros Saving/Loading Macros Saving/Loading Macros The following explains how to save and load macros in the project unit. Saving macros A macros is saved in a filename with the extension (*.lcr). Saving from Visual Basic Editor A macro that has been made or edited is saved by the following procedure. Step 1. Display the Save As dialogue box from the Visual Basic Editor by the using the following menu command. File - Save xxxx The filename is typed in the “xxxx” part. Step 2.
Use of Macros Saving/Loading Macros Saving from the E4991A measurement screen The following procedure can be used to save the macro from the measurement screen of the E4991A. Step 1. Display the Save Program dialogue box from the measurement screen of the E4991A by using the following menu command. Utility - Save Program Step 2. After inputting the filename of the macro and the name of the folder to save it in, click the OK button to save the macro.
Use of Macros Using E4991A VBA Help Using E4991A VBA Help If you don’t know how to use a particular operation of E4991A VBA, you can find more on the topic in the E4991A VBA help (Visual Basic Reference). Displaying the E4991A VBA help screen Step 1. The E4991A VBA help screen is displayed from Visual Basic Editor by using the following menu command. Help - Microsoft Visual Basic Help You can also display the E4991A VBA help screen by typing [F1] from the keyboard.
Use of Macros Using E4991A VBA Help Displaying topics of E4991A VBA Each topic in E4991A VBA help is organized within a hierarchical structure. Double-click items to display their contents in the window pane to the right of the topic list. In addition, E4991A VBA has the following help tools.
Use of Macros Using E4991A VBA Help 236 Chapter 13
14. Outline of Programming Using COM 14 Outline of Programming Using COM This chapter gives the required information for programming with the COM interface of the Agilent E4991A. For more basic information on the COM interface, refer to Chapter 18, “COM Interface Reference.
Outline of Programming Using COM Outline of E4991A COM Outline of E4991A COM COM is the abbreviation of “Component Object Model.” The following gives a simplified concept of COM and describes the COM interface specifications. NOTE The company shall not guarantee the operation of the E4991A COM on any application software other than E4991A VBA (Visual Basic for Application). E4991A COM Object The parts of the E4991A COM object interface are classified as follows.
Outline of Programming Using COM Outline of E4991A COM Limitations on using the E4991A COM object When the E4991A cannot be controlled by only using a E4991A COM object, it is necessary to combine the following COM object methods with their corresponding E4991A GPIB commands.
Outline of Programming Using COM Outline of E4991A COM Table 14-1 Function comparison of GPIB commands and COM objects Saving/recalling files Saves measurement parameter of E4991A, measurement results, etc. in files and recall saved contents. Using printer Outputs measurement results of E4991A to the printer. No dedicated COM interface is prepared.
Outline of Programming Using COM Outline of E4991A COM Table 14-1 Status report system Function comparison of GPIB commands and COM objects Checks the condition of the E4991A Use the GPIB Status report system. Use the GPIB Status report system as a rule. *1 Original COM objects are prepared to detect the following events. System setting Checks whether remote user interface function and E4991A are connected. Not prepared.
Outline of Programming Using COM E4991A COM Object Model E4991A COM Object Model The following objects are prepared for the E4991A. Figure 14-1 E4991A COM Object Model Application Object The application object is positioned at the top of the hierarchical structure of the E4991A COM object model. Property Name Reads the application name “E4991A”. VBAVersion Reds the version of the E4991A VBA. Connection Reads whether it is connected with the E4991A by using the user interface function.
Outline of Programming Using COM E4991A COM Object Model SCPI Object SCPI objects are the group of objects prepared for combined use with the E4991A’s GPIB commands. Property Name Reads “SCPI”. Method Enter Reads returned value of GPIB command executed by Query. Output Executes GPIB command. Query Executes GPIB command by Query and reads the response. 14.
Outline of Programming Using COM E4991A Library E4991A Library The E4991A library is required when writing programs or executing them on the E4991A or on a personal computer with a remote user interface function using E4991A VBA. The The E4991A library is pre-programmed for browsing through E4991A VBA. Where to install the E4991A library The E4991A library is installed in the following location on a personal computer equipped with the E4991A remote user interface function. Library name: E4991A x.
1. Chapter Title 2. Chapter Title 3. Chapter Title 4. Chapter Title 15 Controlling Peripherals 245 15. Controlling Peripherals This chapter explains how to control peripherals connected to the Agilent E4991A by using the software (VISA) installed in the instrument.
Controlling Peripherals Overview Overview The E4991A macro function (E4991A VBA) can be used not only to automate measurements but also to control external measurement instruments connected via USB/GPIB interface by acting as a self-contained system controller (refer to “Remote control using E4991A macros” on page 32).
Programming with VISA 1. Chapter Title Controlling Peripherals Programming with VISA Figure 15-1 shows the flow of controlling the instrument with VISA. When developing a VISA program in the Visual Basic language, a special programing notice (in the readme text file listed below) must be reviewed. Figure 15-1 • visa.hlp (on-line help for the VISA library) • vbreadme.txt (notes on using the VISA library with VB) 2.
Controlling Peripherals Programming with VISA STEP 1. Starting up VISA system The VISA system startup session is processed in Lines 150 to 160 in Example 15-1. VISA’s viOpenDefaultRM function initializes and starts up the VISA system. The viOpenDefaultRM function must be executed before other VISA functions are called, and the parameter of this function is startup information (Defrm in Example 15-1).
(param4) Description 1. Chapter Title Controlling Peripherals Programming with VISA Timeout (Enter 0) (param5) Description Connection information (output) Data type Long integer type The communication session is conducted in Lines 230 to 280 and Line 410 in Example 15-1. VISA’s viVPrintf function sends a program message (GPIB command) to the specified instrument.
Controlling Peripherals Programming with VISA variable (Res in Example 15-1). Syntax viVScanf(param1,param2,param3) Parameters (param1) Description Connection information (input) Data type Long integer type (param2) Description Format parameter for the output variable Data type Character string type (param3) Description Output variable (output) Data type Character string type STEP 4. Disconnection The disconnection session is handled in Lines 190 to 200 in Example 15-1.
Application program using DC power supply (Agilent E3631A) The sample program shown below controls the DC power supply (Agilent E3631A) connected via GPIB while using the E4991A as the system controller. This program is stored on the sample program disk. Its filename is ext_cont.bas. NOTE Assigns settings for the DC power supply output current to a variable. Line 120 Sets the trigger source of the E4991A to the GPIB trigger via the COM interface.
Controlling Peripherals Programming with VISA 170| 180| ' Opens the session to the specified instrument. 190| status = viOpen(Defrm, "GPIB0::5::INSTR", 0, 0, Dcsp) 200| If (status <> VI_SUCCESS) Then GoTo VisaErrorHandler 210| 220| ' Asks for the instrument to turn the dc power on.
16. Application Program 16 Application Programs This chapter gives measurement examples (sample programs) using the HTBasic program and the instrument’s macro program (E4991A VBA).
Application Programs Basic Measurement Basic Measurement This application program performs a measurement similar to that of the “Basic operation of RF device measurement” in the E4991A Installation and Quick Start Guide. HTBasic example program Example 16-1 shows a basic measurement program example (HTBasic) to find the self-resonance point of an inductor. This program is saved under the file name bsc_meas.htb on the sample programs disk.
key after completion of preparation. If any other key is input, the program is aborted. The subprogram FNMessage is explained later. Lines 490 - 510 Returns the E4991A to the default status. Lines 550 - 610 Sets the sweep conditions. In addition, sets the trigger source to the GPIB trigger. Lines 650 - 740 Display traces 1, 2, and 3, and sets the measurement parameter and display format for each trace. In addition, the three traces are superimposed and displayed in one window.
Application Programs Basic Measurement Line 1760 Cancels the event start branch of the SRQ interruption. Lines 1810 - 1830 Executes the auto-scale adjustment for traces 1, 2, and 3, and sets it to the optimum scale. Lines 1870 - 1900 Sets On marker 1 for trace 1. After specifying marker 1 as an active marker, searches for the maximum value (self-resonance point) using the marker search function. Lines 1940 - 1970 Reads out the stimulus value (frequency) and the measurement value (impedance) for trace 1.
Example 16-1 Measuring the self-resonant point of an inductor 10 !***************************************************************** 20 !* E4991A + 16197A Impedance Measurement (Using Chip Inductor) 30 !* HTBasic Sample Program 40 !***************************************************************** 50 ! 60 !################################################################# 70 ! STEP1: Preparation for a Measurement 80 !################################################################# 90 ! 100 DIM Inp_char$[9],B
Application Programs Basic Measurement 480 ! 490 OUTPUT @Agte4991a;"SYST:PRES" 500 OUTPUT @Agte4991a;"*OPC?" 510 ENTER @Agte4991a;Buff$ 520 ! 530 ! -> Specifying Sweep Conditions 540 ! 550 OUTPUT @Agte4991a;"SWE:POIN ";Nop 560 OUTPUT @Agte4991a;"SWE:TYPE "&Swp_type$ 570 OUTPUT @Agte4991a;"FREQ:STAR ";Start 580 OUTPUT @Agte4991a;"FREQ:STOP ";Stop 590 OUTPUT @Agte4991a;"SOUR:CURR:MODE FIX" 600 OUTPUT @Agte4991a;"SOUR:CURR ";Curr_lev 610 OUTPUT @Agte4991a;"TRIG:SOUR BUS" 620 ! 630 ! -> Specifying Measurement P
1030 Reply=FNMessage(@Agte4991a,"Do you want to measure a LOW-LOSS CAPACITOR?") 1040 IF Reply=0 THEN 1050 Result=FNCal(@Agte4991a,"LOW-LOSS C") 1060 IF Result<>0 THEN Prog_int 1070 END IF 1080 ! 1090 OUTPUT @Agte4991a;"SENS:CORR1:COLL:SAVE" 1100 OUTPUT @Agte4991a;"*OPC?" 1110 ENTER @Agte4991a;Buff$ 1120 PRINT "All cal-data measurement completion" 1130 PRINT 1140 ! 1150 Cal_skip: ! 1160 ! 1170 !################################################################# 1180 ! STEP4: Connect the Test Fixture 1190 ! STE
Application Programs Basic Measurement 1530 ! 1540 Meas_start: ! 1550 Reply=FNMessage(@Agte4991a,"Connect the DUT to electrode plate on the fixture.
2070 2080 2090 2100 2110 2120 2130 2140 2150 2160 2170 2180 2190 2200 2210 2220 2230 2240 2250 2260 2270 2280 2290 2300 2310 2320 2330 2340 2350 2360 2370 2380 2390 2400 2410 2420 2430 2440 2450 2460 2470 2480 2490 2500 2510 2520 2530 2540 2550 2560 2570 2580 2590 2600 2610 2620 2630 2640 IF Reply=0 THEN Meas_start PRINT PRINT "Program ended!" GOTO Prog_end ! Prog_int: ! PRINT "Program interruption" ! Prog_end: END ! ! DEF FNCal(@Agte4991a,Standard$) DIM Inp_char$[9],Err_mes$[50] INTEGER Err_no ! Inp_char$
Application Programs Basic Measurement 2650 ! 2660 ! 2670 DEF FNFixt_comp(@Agte4991a,Standard$) 2680 DIM Inp_char$[9],Err_mes$[50] 2690 INTEGER Err_no 2700 ! 2710 Inp_char$="Y" 2720 ! 2730 PRINT "Connect "&Standard$&" standard to electrode plate on the fixture.
3220 3230 3240 GOTO Inp_start END SELECT FNEND Chapter 16 263 16.
Application Programs Basic Measurement Macro (E4991A VBA) Example Program Example 16-2 and Example 16-3 show how a basic measuring program (E4991A VBA) finds the self-resonance point of the inductor. The specifications for this application program are in accordance with the aforementioned “HTBasic example program” on page 254. This program is saved under the filenames bsc_meas.lcr (macro program). The structure and functions of the program are shown as follows.
Example 16-2) in the module only. For more on the execution of macros, see “Executing macros” on page 230. The details of the program (bsc_meas/bas) are explained below. The line numbers are added for the sake of explanation but are usually not displayed. Lines 50 - 60 Defines the variable (Err) to use the event created in the class module (class name: clsErr). Next, sets the object variable (Err.Evnt) to the E4991A library. Lines 200 - 240 Substitutes variables for the sweep condition.
Application Programs Basic Measurement Lines 1120 - 1150 Prompts the connection of the 1619A text fixture and waits for the Yes button to be clicked after the connection. Click the No Button to abort the program. Next, sets the test fixture to be used to the 16197A. Line 1210 Sets the fixture compensation data to fixed frequency point/fixed power point. Lines 1250 - 1290 Measures the open/short compensation data. The subprogram Fixt_comp is explained below.
variable Standard and waits for the completion of measurement. Lines 2350 - 2400 If measurement of the fixture compensation data is not completed because of some kind of error, displays a message indicating interruption of measurement and returns the function program return value as -1. When measurement of the fixture compensation data is completed, returns the function program return value as 0. Below is an explanation of the function program Message for displaying messages.
Application Programs Basic Measurement 330| Cal_type = "FIX" ' Calibration Type: FIXED 340| Fixture = "FXT16197A" ' Test Fixture: 16197A 350| Mkr_src = "MAX" ' Specified Search Function: MAXIMUM 360| 370| Reply = Message("All the preparations for a measurement are complete?") 380| If Reply <> 0 Then GoTo Prog_int 390| 400| ' STEP2: Specifying Measurement Conditions 410| 420| ' Reset the E4991A to the Default State 430| 440| SCPI.Output "SYST:PRES" 450| buff = SCPI.
880| Result = Cal("OPEN") 890| If Result <> 0 Then GoTo Prog_int 900| 910| Result = Cal("SHORT") 920| If Result <> 0 Then GoTo Prog_int 930| 940| Result = Cal("LOAD") 950| If Result <> 0 Then GoTo Prog_int 960| 970| Reply = Message("Do you want to measure a LOW-LOSS CAPACITOR?") 980| If Reply = 0 Then 990| Result = Cal("LOW-LOSS C") 1000| If Result <> 0 Then GoTo Prog_int 1010| End If 1020| 1030| SCPI.Output "SENS:CORR1:COLL:SAVE" 1040| buff = SCPI.
Application Programs Basic Measurement 1400| 1410| ' STEP8: Auto Scaling & Maximum Point Search 1420| 1430| ' Performing a Single Sweep 1440| 1450| SCPI.Output "CALC:AVER:CLE" 1460| Answer = SingleMeasure 1470| If Answer = 0 Then 1480| MsgBox "A single sweep aborted", vbOKOnly, "Impedance measurement" 1490| GoTo Prog_int 1500| End If 1510| 1520| ' Performing an Auto-scale 1530| 1540| Auto_scaling: 1550| SCPI.Output "DISP:TRAC1:Y:AUTO" 1560| SCPI.Output "DISP:TRAC2:Y:AUTO" 1570| SCPI.
1920| 1930| Dim Reply As Integer 1940| Dim Answer As Long 1950| 1960| Reply = Message("Connect " & Standard & " standard to DUT port.
Application Programs Basic Measurement 2460| 2470| Function Message(Mes As String) As Integer 2480| 2490| Dim Inp_char As Integer 2500| 2510| Inp_char = MsgBox(Mes, vbYesNo + vbQuestion, "Impedance measurement") 2520| 2530| If Inp_char = vbYes Then 2540| Message = 0 2550| Else 2560| Message = -1 2570| End If 2580| 2590| End Function Example 16-3 Measuring the self-resonant point of an inductor (bsc_meas.cls) When using the event provided in the E4991A, the following programing steps are created.
150| 160| End Sub 170| 180| Private Sub Evnt_RfOverload() 190| 200| MsgBox "Error: RF overload" & vbCrLf & vbCrLf & "Program interruption", vbExclamation, "E4991A Internal Error" 210| End 220| 230| End Sub 240| Chapter 16 273 16.
Application Programs Basic Measurement 274 Chapter 16
17. GPIB Command Reference 17 GPIB Command Reference This chapter provides the GPIB command reference of the Agilent E4991A. The command references are written in abbreviated form and listed in alphabetic order.
GPIB Command Reference Format Conventions This section defines the terms and symbols used as conventions in the command references. Format The section titled “Format” shows the format(s) that is (are) used to transmit the command to the E4991A. Each format consists of the command label and parameter fields, which are separated by spaces. If two or more parameters appear in a format, they are separated by commas (,). Two periods (..
GPIB Command Reference Parameters Parameters The section titled “Parameters” describes the parameters required to transmit the command. If a parameter is of a numeric (integer or floating-point) or a character string type and enclosed within angle brackets (< >), the “Parameters” section contains the parameter’s description, range, initial setting, etc. If a parameter is enclosed within braces ({ }), i.e., selectable, the section contains a description of the options. Data format 1.
GPIB Command Reference Query response Query response The section titled “Query response” shows the format of the data that are read out when the command can enable Query (i.e., data readout). The parameters read out are enclosed within braces ({ }). If the pair of braces contains items separated by vertical strokes (|), this indicates that only one of them will be read out. If two or more parameters are to be read out, they are separated by commas (,). Two periods (..
GPIB Command Reference *CLS IEEE subsystem This section describes the GPIB commands of the IEEE subsystem. *CLS *CLS Description Initializes the following. (No query) Front Panel Equivalents • Error Queue • Status Byte Register • Operation Status Register • Questionable Status Register • Questionable Status Hardware Register • Questionable Status Limit Register • Questionable Status Search Register • Standard Event Status Register 17. GPIB Command Reference Format Unavailable.
GPIB Command Reference *ESE *ESE Format *ESE *ESE? Description Sets the value of the Standard Event Status Enable register. See Figure B-3, “Status Register Structure (1/2),” on page 561, for details of the status register structure. Parameters Description Value of the Enable register Data type Integer Range 0 to 255 Default 0 If the specified parameter is outside the range, the bit-by-bit logical sum resulting from an AND operation with 255 (0xff) will be assumed.
GPIB Command Reference *IDN? *IDN? Format *IDN? Description Returns the E4991A product information. (Query only) Query response {string 1},{string 2},{string 3},{string 4}<^END> The following product information is read out: Manufacturer. Always "Agilent Technologies". {string 2} Model number. Always "E4991A". {string 3} Serial number {string 4} Firmware version number (e.g., "01.00") 17. GPIB Command Reference Front Panel Equivalents {string 1} Unavailable.
GPIB Command Reference *OPT? *OPT? Format *OPT? Description Returns the identification code(s) of the option(s) installed on the E4991A. If no option is installed, this command returns 0. If two or more options are installed, it returns a string of the option identification codes separated by commas (,).
GPIB Command Reference *SRE *SRE Format *SRE *SRE? Description Sets the value of the Service Request Enable register. See Figure B-3, “Status Register Structure (1/2),” on page 561, for details of the status register structure. 17.
GPIB Command Reference *TRG *TRG Format *TRG Description Triggers the E4991A when the trigger source has been set for the GPIB (specified as "BUS" in the TRIG:SOUR). Related commands TRIG:SOUR command on page 526 Front Panel Equivalents Unavailable. *TST? Format *TST? Description Executes a self-test and returns the test results. (Query only) Query response {numeric}<^END> Description Front Panel Equivalents 0 Result of the self-test is PASS.
GPIB Command Reference *WAI Table 17-1 Overlapped Commands DISPlay Subsystem: DISP:TEXT on page 355 CALCulate:MARKer Subsystem: CALC{1-5}:MARK:SET on page 336 SENS:CORR1:COLL on page 437 SENS:CORR1:COLL:FPO on page 438 SENS:CORR1:COLL:SAVE on page 439 SENS:CORR2:COLL on page 449 SENS:CORR2:COLL:FPO on page 450 SENS:CORR2:COLL:SAVE on page 451 SENS:CORR2:FIXT on page 454 SENS:CORR2:FIXT:EDEL:US ER:DIST on page 456 SENSe:AVERage Subsystem: AVER on page 287 AVER:COUN on page 288 SENSe:FREQuency
GPIB Command Reference ABOR E4991A GPIB command This section describes the GPIB commands specific to E4991A. ABOR Format ABORt Description Resets the trigger system to put the trigger sequence in the idle state. Also sets the continuous activation of trigger system to off. (No query) Related commands INIT:CONT command on page 382 INIT command on page 382 Front Panel Equivalents Unavailable.
GPIB Command Reference AVER AVER Format [SENSe:]AVERage[:STATe] {ON|OFF|1|0} [SENSe:]AVERage[:STATe]? Description Turns on/off the point averaging function. In addition, use the AVER:COUN command to set the averaging factor. 17. GPIB Command Reference Parameters Description Query response ON or 1 (Default) Turns on the point averaging function. OFF or 0 Turns off the point averaging function.
GPIB Command Reference AVER:COUN AVER:COUN Format [SENSe:]AVERage:COUNt [SENSe:]AVERage:COUNt? Description Sets the averaging factor when using the point averaging function. Only setting the averaging factor does not set the point averaging function to on. Use the AVER command to set the point averaging function to on. In addition, use the SEGM{1-16}:AVER:COUN command to set the point averaging factor for the segment sweep.
GPIB Command Reference CALC:AVER CALC:AVER Format CALCulate:AVERage[:STATe] {ON|OFF|1|0} CALCulate:AVERage[:STATe]? Description Turns on/off the sweep averaging function. In addition, use the CALC:AVER:COUN command to set the averaging factor. 17. GPIB Command Reference Parameters Description Query response ON or 1 Turns on the sweep averaging function. OFF or 0 (Default) Turns off the sweep averaging function.
GPIB Command Reference CALC:AVER:COUN CALC:AVER:COUN Format CALCulate:AVERage:COUNt CALCulate:AVERage:COUNt? Description Sets the averaging factor when using the sweep averaging function. Only setting the averaging factor does not set the sweep averaging function to on. In addition, use the CALC:AVER command to set the sweep averaging function to on.
GPIB Command Reference CALC:BMON CALC:BMON Format CALCulate[:EVALuate]:BMONitor[:STATe] {ON|OFF|1|0} CALCulate[:EVALuate]:BMONitor[:STATe]? Description Turns on/off the dc bias monitor function. This command is available when Option 001 (dc bias function) is installed. 17. GPIB Command Reference It is necessary to set markers with the CALC{1-5}:MARK{1-8} command or the CALC{1-5}:MARK:REF command before sending this command.
GPIB Command Reference CALC:DATA:MON? CALC:DATA:MON? Format CALCulate:DATA:MONitor? {V|I} Description Reads the dc bias level monitor array of all measurement points. This command is available when Option 001 (dc bias function) is installed. The dc bias monitor function has to be set to on by using the CALC:BMON command before sending this command. (Query only) Parameters Description Query response V Specifies the voltage value. I Specifies the current value. {numeric 1}, {numeric 2},..
GPIB Command Reference CALC{1-5}:DATA? CALC{1-5}:DATA? Format CALCulate{1-5}:DATA? {FDATA|FMEM} Description Reads the data trace array or the memory trace array. (Query only) Parameters CALCulate{1-5} Description 17.
GPIB Command Reference CALC{1-5}:DATA:EPAR CALC{1-5}:DATA:EPAR Format CALCulate{1-5}:DATA:EPARameter {EQC0|EQC1|EQL1|EQR1}, CALCulate{1-5}:DATA:EPARameter? {EQC0|EQC1|EQL1|EQR1} Description Sets each value of equivalent circuit parameters. Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-5}:EPAR CALC{1-5}:EPAR Format CALCulate{1-5}:EPARameters Description Executes the equivalent circuit analysis in the selected equivalent circuit model. In addition, executes the equivalent circuit analysis in the marker partial search range. When the marker partial search range is not set to on with the CALC{1-5}:MARK:FUNC:DOM command, executes the equivalent circuit analysis in the entire sweep range.
GPIB Command Reference CALC{1-5}:EPAR:CIRC CALC{1-5}:EPAR:CIRC Format CALCulate{1-5}:EPARameters:CIRCuit[:TYPE] {A|B|C|D|E} CALCulate{1-5}:EPARameters:CIRCuit[:TYPE]? Description Specifies the equivalent circuit model in the equivalent circuit analysis. Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-5}:EPAR:SIM CALC{1-5}:EPAR:SIM Format CALCulate{1-5}:EPARameters:SIMulation Description Simulates and displays the frequency characteristic of the equivalent circuit. (No query) In addition, the simulation result is stored in the memory trace so that it can be read with the CALC{1-5}:DATA? command. Sub-block CALCulate{1-5} 17. GPIB Command Reference Parameters Description Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-5}:FORM CALC{1-5}:FORM Format • With scalar trace CALCulate{1-3}:FORMat {Z|Y|LS|LP|CS|CP|RS|RP|D|Q|R|X|G|B|ZPH|YPH|RC|RCPH|RCX|RCY|P|PRE|PLF|P LT|DC|DCR|DCLF|DCLT} CALCulate{1-3}:FORMat? • With complex trace CALCulate{4-5}:FORMat {Z|Y|RC|P|DC} CALCulate{4-5}:FORMat? Description Sets the measurement parameters. A maximum of five measurement parameters can be arbitrarily selected.
GPIB Command Reference CALC{1-5}:FORM Description Absolute value of reflection coefficient (|Γ|) RCPH Phase of reflection coefficient (θγ) RCX Real part of reflection coefficient (Γx) RCY Imaginary part of reflection coefficient (Γy) P*1 Absolute value of complex permeability (|μr|) PRE*1 Real part of complex permeability (μr') PLF*1 Imaginary part of complex permeability (μr") PLT*1 Magnetic loss tangent (tanδ (μ)) DC*2 Absolute value of complex permittivity (|εr|) DCR*2 Real part of com
GPIB Command Reference CALC:FORM:PAR:DIE Query response • With scalar trace: {Z|Y|LS|LP|CS|CP|RS|RP|D|Q|R|X|G|B|ZPH|YPH|RC|RCPH|RCX|RCY|P|PRE|PLF|P LT|DC|DCR|DCLF|DCLT}<^END> • With complex trace {Z|Y|RC|P|DC}<^END> Related commands MODE command on page 393 Front Panel Equivalents Meas/Format - Meas/Format...
GPIB Command Reference CALC{1-3}:FORM:PAR:EPH CALC{1-3}:FORM:PAR:EPH Format CALCulate{1-3}:FORMat:PARameter:EPHase {ON|OFF|1|0} CALCulate{1-3}:FORMat:PARameter:EPHase? Description Turns on/off the expanded phase display function, which allows phases to be below -180 or above 180 degrees, when the measurement parameter is the phase. This command is ignored for measurement parameters other than phase. 17.
GPIB Command Reference CALC:FORM:PAR:MAG CALC:FORM:PAR:MAG Format CALCulate:FORMat:PARameter:MAGnetic ,, CALCulate:FORMat:PARameter:MAGnetic? Description Sets the inner diameter, outer diameter, and height of the toroidal core in the magnetic measurement. This command is available when Option 002 (material measurement software) is installed.
GPIB Command Reference CALC{1-5}:FORM:UNIT:ANGL CALC{1-5}:FORM:UNIT:ANGL Format CALCulate{1-5}:FORMat:UNIT:ANGLe {DEG|RAD} CALCulate{1-5}:FORMat:UNIT:ANGLe? Description Sets the display unit for the phase display format. Parameters CALCulate{1-5} 17. GPIB Command Reference Sub-block Description Specifies the trace number (1 to 5). Description Query response DEG (Default) Specifies the display unit as degree (°). RAD Specifies the display unit as radian.
GPIB Command Reference CALC{1-5}:MARK{1-8} CALC{1-5}:MARK{1-8} Format CALCulate{1-5}:MARKer{1-8}[:STATe] {ON|OFF|1|0} CALCulate{1-5}:MARKer{1-8}[:STATe]? Description Turns on/off markers 1-8. In addition, use the CALC{1-5}:MARK:REF command to turn on/off the reference marker. Also, use the CALC{1-5}:MARK:AOFF command to simultaneously turn off all of the markers displayed on the trace. Parameters Sub-block Description CALCulate{1-5} Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-5}:MARK{1-8}:ACT CALC{1-5}:MARK{1-8}:ACT Format CALCulate{1-5}:MARKer{1-8}:ACTivate Description Sets the specified marker to the active marker. (No query) In addition, use the CALC{1-5}:MARK:REF:ACT command to set the reference marker to the active marker. Sub-block 17. GPIB Command Reference Parameters Description CALCulate{1-5} Specifies the trace number (1 to 5). MARKer{1-8} Specifies the marker number (1 to 8).
GPIB Command Reference CALC{1-5}:MARK:APE:SET CALC{1-5}:MARK:APE:SET Format CALCulate{1-5}:MARKer:APEak:SET Description Sets the ΔX and ΔY values of peak definition so that the active marker position is recognized as the peak. Therefore, ΔX is set to the stimulus value difference between the active marker and the adjacent left measurement point, while ΔY is set to the measurement value difference between them.
GPIB Command Reference CALC{1-5}:MARK:APE:EXC:X CALC{1-5}:MARK:APE:EXC:X Format CALCulate{1-5}:MARKer:APEak:EXCursion:X CALCulate{1-5}:MARKer:APEak:EXCursion:X? Description Sets the ΔX value to define the peak in the marker peak search function. In addition, use the CALC{1-5}:MARK:APE:EXC:Y command to set the ΔY value. 17. GPIB Command Reference Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-5}:MARK:APE:EXC:Y CALC{1-5}:MARK:APE:EXC:Y Format CALCulate{1-5}:MARKer:APEak:EXCursion:Y CALCulate{1-5}:MARKer:APEak:EXCursion:Y? Description Sets the ΔY value to define the peak in the marker peak search function. In addition, use the CALC{1-5}:MARK:APE:EXC:X command to set the ΔX value. Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5).
GPIB Command Reference CALC:MARK:COUP CALC:MARK:COUP Format CALCulate:MARKer:COUPle {ON|OFF|1|0} CALCulate:MARKer:COUPle? Description As the marker movement setting, selects either the mode in which the markers on all traces are coupled when moved (coupled marker mode) or the mode in which the markers on the differernt traces are moved separately (uncoupled marker mode). Parameters Description ON or 1 (Default) Specifies the coupled marker mode. OFF or 0 Specifies the uncoupled marker mode.
GPIB Command Reference CALC{4-5}:MARK:FORM CALC{4-5}:MARK:FORM Format CALCulate{4-5}:MARKer:FORMat {REALIMAG|LINMAGPHASE|LOGMAGPHASE|RX|GB|SWRPHASE} CALCulate{4-5}:MARKer:FORMat? Description Specifies the format for reading the marker position measurement value when the complex trace is displayed. In addition, use the CALC{1-5}:MARK{1-8}:Y? command or the CALC{1-5}:MARK:REF:Y command to read the measurement value at the marker position.
GPIB Command Reference CALC{1-5}:MARK:FUNC CALC{1-5}:MARK:FUNC Format CALCulate{1-5}:MARKer:FUNCtion[:SELect] {MAXimum|MINimum|PPEak|NPEak|TARget} CALCulate{1-5}:MARKer:FUNCtion[:SELect]? Description Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5). Description Query response MAXimum (Default) Specifies the maximum search. MINimum Specifies the minimum search. PPEak Specifies the positive peak search. NPEak Specifies the negative peak search.
GPIB Command Reference CALC{1-5}:MARK:FUNC:DOM CALC{1-5}:MARK:FUNC:DOM Format CALCulate{1-5}:MARKer:FUNCtion:DOMain[:STATe] {ON|OFF|1|0} CALCulate{1-5}:MARKer:FUNCtion:DOMain[:STATe]? Description Turns on/off the partial search function of the marker search function. In addition, use the CALC{1-5}:MARK:FUNC:DOM:STAR command and the CALC{1-5}:MARK:FUNC:DOM:STOP command or the CALC{1-5}:MARK:FUNC:DOM:SPAN command to set the partial search range line.
GPIB Command Reference CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM Format CALCulate{1-5}:MARKer{1-8}:FUNCtion:DOMain:LIMit[:STATe] {ON|OFF|1|0} CALCulate{1-5}:MARKer{1-8}:FUNCtion:DOMain:LIMit[:STATe]? Description Selects whether to set the specified marker as the test marker when using the limit test function. Sub-block 17. GPIB Command Reference Parameters Description CALCulate{1-5} Specifies the trace number (1 to 5). MARKer{1-8} Specifies the marker number (1 to 8).
GPIB Command Reference CALC{1-5}:MARK:FUNC:DOM:LIM:ALL CALC{1-5}:MARK:FUNC:DOM:LIM:ALL Format CALCulate{1-5}:MARKer:FUNCtion:DOMain:LIMit:ALL[:STATe] {ON|OFF|1|0} CALCulate{1-5}:MARKer:FUNCtion:DOMain:LIMit:ALL[:STATe]? Description Turns on/off the marker limit test function. Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5). Description Query response ON or 1 Turns on the marker limit test function. OFF or 0 (Default) Turns off the marker limit test function.
GPIB Command Reference CALC{1-5}:MARK:FUNC:DOM:LIM:ALL:RES? CALC{1-5}:MARK:FUNC:DOM:LIM:ALL:RES? Format CALCulate{1-5}:MARKer:FUNCtion:DOMain:LIMit:ALL:RESult? Description Returns the limit test result (logical conjunction of all test results of every test marker operated by AND) at all test marker positions. (Query only) Parameters CALCulate{1-5} Query response 17. GPIB Command Reference Sub-block Description Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM:LOW CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM:LOW Format CALCulate{1-5}:MARKer{1-8}:FUNCtion:DOMain:LIMit:LOWer CALCulate{1-5}:MARKer{1-8}:FUNCtion:DOMain:LIMit:LOWer? Description Sets the lower test limit value at the specified marker position when using the limit test function. In addition, use the CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM:UP command to set the upper test limit value.
GPIB Command Reference CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM:RES? CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM:RES? Format CALCulate{1-5}:MARKer{1-8}:FUNCtion:DOMain:LIMit:RESult? Description Returns the limit test result at the specified marker position. (Query only) Parameters Query response Description CALCulate{1-5} Specifies the trace number (1 to 5). MARKer{1-8} Specifies the marker number (1 to 8). 17.
GPIB Command Reference CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM:UP CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM:UP Format CALCulate{1-5}:MARKer{1-8}:FUNCtion:DOMain:LIMit:UPper CALCulate{1-5}:MARKer{1-8}:FUNCtion:DOMain:LIMit:UPper? Description Sets the upper test limit value at the specified marker position when using the limit test function. In addition, use the CALC{1-5}:MARK{1-8}:FUNC:DOM:LIM:LOW command to set the lower test limit value.
GPIB Command Reference CALC{1-5}:MARK:FUNC:DOM:SPAN CALC{1-5}:MARK:FUNC:DOM:SPAN Format CALCulate{1-5}:MARKer:FUNCtion:DOMain:SPAN CALCulate{1-5}:MARKer:FUNCtion:DOMain:SPAN? Description If the reference marker is set to on, sets the marker partial search range using the span of the reference marker and the active marker. The span value in the partial search range is read when executing the command by query. 17.
GPIB Command Reference CALC{1-5}:MARK:FUNC:DOM:STAR CALC{1-5}:MARK:FUNC:DOM:STAR Format CALCulate{1-5}:MARKer:FUNCtion:DOMain:STARt CALCulate{1-5}:MARKer:FUNCtion:DOMain:STARt? Description Sets the stimulus value of the active marker position on the left range line of the marker partial search range. This left range line is read when executing the command by query. In addition, use the CALC{1-5}:MARK:FUNC:DOM:STOP command to set the right range line.
GPIB Command Reference CALC{1-5}:MARK:FUNC:EXEC CALC{1-5}:MARK:FUNC:EXEC Format CALCulate{1-5}:MARKer:FUNCtion:EXECute [MAXimum|MINimum|PPEak|NPEak|TARget] Description Executes the marker search only once. (No query) Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5). Description MAXimum Searches the maximum value. MINimum Searches the minimum value. PPEak Searches the positive peak. NPEak Searches the negative peak. TARget Searches the target.
GPIB Command Reference CALC{1-5}:MARK:FUNC:EXEC:LEFT CALC{1-5}:MARK:FUNC:EXEC:LEFT Format CALCulate{1-5}:MARKer:FUNCtion:EXECute:LEFT Description Searches the peak/target on the left side of the active marker in the marker search function. Before executing this command, it is necessary to set the search objective (positive peak/negative peak/target) with the CALC{1-5}:MARK:FUNC command. (No query) Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-5}:MARK:FUNC:EXEC:RIGH CALC{1-5}:MARK:FUNC:EXEC:RIGH Format CALCulate{1-5}:MARKer:FUNCtion:EXECute:RIGHt Description Searches the peak/target on the right side of the active marker in the marker search function. Before executing this command, it is necessary to set the search objective (positive peak/negative peak/target) with the CALC{1-5}:MARK:FUNC command. (No query) 17.
GPIB Command Reference CALC{1-5}:MARK:FUNC:TARG CALC{1-5}:MARK:FUNC:TARG Format CALCulate{1-5}:MARKer:FUNCtion:TARGet CALCulate{1-5}:MARKer:FUNCtion:TARGet? Description Sets the target value to perform the target search with the CALC{1-5}:MARK:FUNC command or the CALC{1-5}:MARK:FUNC:EXEC command in the marker search. Use the relative value from the reference marker to set the target value because the set value is used as the relative value from the reference value in the Δ mode.
GPIB Command Reference CALC{1-5}:MARK:FUNC:TRAC CALC{1-5}:MARK:FUNC:TRAC Format CALCulate{1-5}:MARKer:FUNCtion:TRACking {ON|OFF|1|0} CALCulate{1-5}:MARKer:FUNCtion:TRACking? Description Turns on/off the marker search tracking function. Setting on the search tracking automatically executes the marker search for the search function selected with the CALC{1-5}:MARK:FUNC command for every sweep. 17. GPIB Command Reference Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-5}:MARK:LIST CALC{1-5}:MARK:LIST Format CALCulate{1-5}:MARKer:LIST {ON|OFF|1|0} CALCulate{1-5}:MARKer:LIST? Description Displays the marker list. In addition, it is necessary to set the specified trace to the active trace with the DISP:TRAC{1-5}:SEL command when you want to display the marker list. Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5). Description Query response ON or 1 Displays the marker list.
GPIB Command Reference CALC{1-5}:MARK:ON CALC{1-5}:MARK:ON Format CALCulate{1-5}:MARKer:ON {DATA|MEMory} CALCulate{1-5}:MARKer:ON? Description Selects the trace to display the marker. Parameters CALCulate{1-5} 17. GPIB Command Reference Sub-block Description Specifies the trace number (1 to 5). Description DATA (Default) Displays the marker on the data trace. MEMory*1 Displays the marker on the memory trace. *1.
GPIB Command Reference CALC{1-5}:MARK:REF CALC{1-5}:MARK:REF Format CALCulate{1-5}:MARKer:REFerence[:STATe] {ON|OFF|1|0} CALCulate{1-5}:MARKer:REFerence[:STATe]? Description Turns on/off the reference marker (marker R). However, only displaying the reference marker does not set on the Δ mode for using the reference marker in Δ mode. Use the CALC{1-5}:MARK:REF:TYPE command to turn on the Δ mode. In addition, use the CALC{1-5}:MARK{1-8} command to turn on/off markers 1-8.
GPIB Command Reference CALC{1-5}:MARK:REF:ACT CALC{1-5}:MARK:REF:ACT Format CALCulate{1-5}:MARKer:REFerence:ACTivate Description Sets the reference marker to the active marker. (No query) In addition, use the CALC{1-5}:MARK{1-8}:ACT command to set markers 1-8 to the active marker. Sub-block CALCulate{1-5} 17. GPIB Command Reference Parameters Description Specifies the trace number (1 to 5). Related commands CALC{1-5}:MARK{1-8}:ACT command on page 305 Front Panel Equivalents Marker - Marker...
GPIB Command Reference CALC{1-5}:MARK:REF:FUNC:DOM:LIM:LOW CALC{1-5}:MARK:REF:FUNC:DOM:LIM:LOW Format CALCulate{1-5}:MARKer:REFerence:FUNCtion:DOMain:LIMit:LOWer CALCulate{1-5}:MARKer:REFerence:FUNCtion:DOMain:LIMit:LOWer? Description Sets the lower test limit value at the reference marker position when using the limit test function. In addition, use the CALC{1-5}:MARK:REF:FUNC:DOM:LIM:UP command to set the upper test limit value.
GPIB Command Reference CALC{1-5}:MARK:REF:FUNC:DOM:LIM:RES? CALC{1-5}:MARK:REF:FUNC:DOM:LIM:RES? Format CALCulate{1-5}:MARKer:REFerence:FUNCtion:DOMain:LIMit:RESult? Description Returns the limit test result at the reference marker position. (Query only) Parameters CALCulate{1-5} Query response Description 17. GPIB Command Reference Sub-block Specifies the trace number (1 to 5). {PASS|FAIL|NONE}<^END> Description PASS Passed FAIL Failed NONE No limit test is executed.
GPIB Command Reference CALC{1-5}:MARK:REF:FUNC:DOM:LIM:UP CALC{1-5}:MARK:REF:FUNC:DOM:LIM:UP Format CALCulate{1-5}:MARKer:REFerence:FUNCtion:DOMain:LIMit:UPper CALCulate{1-5}:MARKer:REFerence:FUNCtion:DOMain:LIMit:UPper? Description Sets the upper test limit value at the reference marker position when using the limit test function. In addition, use the CALC{1-5}:MARK:REF:FUNC:DOM:LIM:LOW command to set the lower test limit value.
GPIB Command Reference CALC{1-5}:MARK:REF:TYPE CALC{1-5}:MARK:REF:TYPE Format CALCulate{1-5}:MARKer:REFerence:TYPE {OFF|DELTA|FIXDELTA} CALCulate{1-5}:MARKer:REFerence:TYPE? Description Selects the type of reference marker (marker R). Parameters CALCulate{1-5} 17. GPIB Command Reference Sub-block Description Specifies the trace number (1 to 5). Description OFF (Default) Sets the Δ mode to off. DELTA Sets the Δ mode to on.
GPIB Command Reference CALC{1-5}:MARK:REF:X CALC{1-5}:MARK:REF:X Format CALCulate{1-5}:MARKer:REFerence:X CALCulate{1-5}:MARKer:REFerence:X? Description Moves the reference marker (marker R) to the position of the stimulus value specified on the trace. The stimulus value at the reference marker position is read when executing the command by query. In addition, use the CALC{1-5}:MARK:REF:Y command to read the measurement value at the reference marker position.
GPIB Command Reference CALC{1-5}:MARK:REF:Y CALC{1-5}:MARK:REF:Y Format CALCulate{1-5}:MARKer:REFerence:Y , CALCulate{1-5}:MARKer:REFerence:Y? Moves the reference marker (marker R) to the specified measurement value when the Δ mode is set to fixed Δ. In addition, use the CALC{1-5}:MARK:REF:X command to move the reference marker position to the specified stimulus value. Parameters • With scalar trace: Sub-block CALCulate{1-3} Description Specifies the trace number (1 to 3).
GPIB Command Reference CALC{1-5}:MARK:SET CALC{1-5}:MARK:SET Format CALCulate{1-5}:MARKer:SET {CENTer|DELTASPAN|STARt|STOP|REFerence|OFFSet} Description Performs the E4991A’s settings by using the stimulus/measurement value at the active marker positions. (No query) Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5). Description CENTer Sets the stimulus value at the active marker position to the center value in the sweep range.
GPIB Command Reference CALC{1-5}:MARK:UNIT CALC{1-5}:MARK:UNIT Format CALCulate{1-5}:MARKer:UNIT {SPARameter|TIME|IOMega} CALCulate{1-5}:MARKer:UNIT? Description Specifies the display method of the marker value on the X-axis. Parameters CALCulate{1-5} 17. GPIB Command Reference Sub-block Description Specifies the trace number (1 to 5). Description SPARameter (Default) Specifies the display for sweep parameter. TIME Specifies the display for time (required sweep time from start to end).
GPIB Command Reference CALC{1-5}:MARK{1-8}:X CALC{1-5}:MARK{1-8}:X Format CALCulate{1-5}:MARKer{1-8}:X CALCulate{1-5}:MARKer{1-8}:X? Description Moves the marker to the stimulus value specified on the trace. The stimulus value at the marker position is read when executing the command by query.
GPIB Command Reference CALC{1-5}:MARK{1-8}:Y? CALC{1-5}:MARK{1-8}:Y? Format CALCulate{1-5}:MARKer{1-8}:Y? Description Reads the measurement value at the marker position. When the Δ mode is set to on and this command is executed, the measurement value at the marker position is read in the form of a relative value to the reference marker. (Query only) Parameters Query response 17. GPIB Command Reference Sub-block Description CALCulate{1-5} Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-5}:MATH:FUNC CALC{1-5}:MATH:FUNC Format CALCulate{1-5}:MATH:FUNCtion {DATA|AND|MEM|DMNM|PER|DDVM} CALCulate{1-5}:MATH:FUNCtion? Description Selects the trace to be displayed. Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5). Description DATA (Default) Displays the data trace. AND Displays both the data trace and the memory trace. MEM Displays the memory trace. DMNM Displays the data trace.
GPIB Command Reference CALC{1-5}:MATH:MEM CALC{1-5}:MATH:MEM Format CALCulate{1-5}:MATH:MEMorize Description Copies the data trace to the memory trace. (No query) In addition, use the CALC{1-5}:MATH:FUNC command to display the memory trace. And, use the CALC{1-5}:DATA? command to read the memory trace content. Sub-block CALCulate{1-5} 17. GPIB Command Reference Parameters Description Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-3}:MATH:OFFS CALC{1-3}:MATH:OFFS Format CALCulate{1-3}:MATH:OFFSet CALCulate{1-3}:MATH:OFFSet? Description Sets the offset value to be subtracted from the data trace for the scalar trace. Parameters Sub-block CALCulate{1-3} Description Specifies the trace number (1 to 3). Description Offset value Data type Floating point Range same Y-axis scale range Default 0 Unit Variable depending on the measurement parameter.
GPIB Command Reference CALC{1-5}:MST CALC{1-5}:MST Format CALCulate{1-5}[:EVALuate]:MSTatistics[:STATe] {ON|OFF|1|0} CALCulate{1-5}[:EVALuate]:MSTatistics[:STATe]? Description It is necessary to set markers on with the CALC{1-5}:MARK{1-8} command or the CALC{1-5}:MARK:REF command when you want to display the statistical analysis results. In addition, use the CALC{1-5}:MST:DATA? command to read the statistical value. Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5).
GPIB Command Reference CALC{1-5}:MST:DATA? CALC{1-5}:MST:DATA? Format CALCulate{1-5}[:EVALuate]:MSTatistics:DATA? {MEAN|SDEV|PEAK} Description Reads the statistical analysis result. (Query only) In addition, use the CALC{1-5}:MST command to turn on/off the statistical analysis function. Parameters Sub-block CALCulate{1-5} Description Specifies the trace number (1 to 5). Description Query response MEAN Specifies the average value. SDEV Specifies the standard deviation.
GPIB Command Reference DATA:CAD{1-8}? DATA:CAD{1-8}? DATA[:DATA]:CAD{1-8}? Description Reads the calibration data array. (Query only) NOTE This command can be used to read a calibration data array that is measured with the calibration data measurement points of “User-defined frequency points” or “User-defined power points.” Parameters The calibration data arrays include a total of eight standard measurement data (two measurements each) of Open/Short/Load/Low-loss capacitor.
GPIB Command Reference DATA:CCO{1-6} DATA:CCO{1-6} Format DATA[:DATA]:CCO{1-6} ,,..,, DATA[:DATA]:CCO{1-6}? Description Sets the calibration coefficient array for calibration. The calibration coefficient array is read during execution by query. Parameters There are a total of six calibration coefficient arrays for each coefficient of A1, B1, C1, A2, B2, and C2. CC01 to CC06 correspond to these data arrays.
GPIB Command Reference DATA:CMD{1-2}? DATA:CMD{1-2}? DATA[:DATA]:CMD{1-2}? Description Reads the fixture compensation data array. (Query only) NOTE This command can be used to read a fixture compensation data array measured with the fixture compensation data measurement points of “User-defined frequency points” or “User-defined power points.” Parameters The fixture compensation data arrays include two standard measurement data of Open/Short. CMD1 and CMD2 correspond to these data arrays.
GPIB Command Reference DATA:CMP{1-3} DATA:CMP{1-3} Format DATA[:DATA]:CMP{1-3} ,,..,, DATA[:DATA]:CMP{1-3}? Description Sets the fixture compensation coefficient array. The fixture compensation coefficient array is read when executing the command by query. Parameters There are three fixture compensation coefficient arrays for the coefficients of A, B, and C. CMP1 to CMP3 correspond to these data arrays.
GPIB Command Reference DATA:RAW? DATA:RAW? Format DATA[:DATA]:RAW? Description Reads the raw data array. (Query only) Query response {numeric 1}, {numeric 2},.., {numeric N × 2 - 1}, {numeric N × 2}<^END> Description Real part of data (complex type) at the n-th measurement point {numeric n × 2} Imaginary part of data (complex type) at the n-th measurement point 17. GPIB Command Reference {numeric n × 2 - 1} The data consist of the real and imaginary parts of a complex number.
GPIB Command Reference DATA:SEGM{1-16}:CAD{1-8}? DATA:SEGM{1-16}:CAD{1-8}? Format DATA[:DATA]:SEGMent{1-16}:CAD{1-8}? Description Reads the calibration data array of the segment sweep.
GPIB Command Reference DATA:SEGM{1-16}:CCO{1-6} FORM:DATA command on page 374 Front Panel Equivalents Unavailable. DATA:SEGM{1-16}:CCO{1-6} DATA[:DATA]:SEGMent{1-16}:CCO{1-6} ,,..,, Description Sets the calibration coefficient array for calibration of the segment sweep. The calibration coefficient array is read when executing by query. Parameters There are a total of six calibration coefficient arrays for the coefficients of A1, B1, C1, A2, B2, and C2.
GPIB Command Reference DATA:SEGM{1-16}:CMD{1-2}? DATA:SEGM{1-16}:CMD{1-2}? Format DATA[:DATA]:SEGMent{1-16}:CMD{1-2}? Description Reads the fixture compensation data array of the segment sweep.
GPIB Command Reference DATA:SEGM{1-16}:CMP{1-3} DATA:SEGM{1-16}:CMP{1-3} Format DATA[:DATA]:SEGMent{1-16}:CMP{1-3} ,,..,, DATA[:DATA]:SEGMent{1-16}:CMP{1-3}? Sets the fixture compensation coefficient array for the segment sweep. The fixture compensation coefficient array is read when executing by query. Parameters There are three fixture compensation coefficient arrays for the coefficients of A, B, and C. CMP1 to CMP3 correspond to these data arrays.
GPIB Command Reference DISP:BACK DISP:BACK Format DISPlay:BACKlight {ON|OFF|1|0} DISPlay:BACKlight? Description Turns on/off the LCD backlight. Parameters Description ON or 1 (Default) Turns on the LCD backlight. OFF or 0 Turns off the LCD backlight. Query response {1|0}<^END> Front Panel Equivalents Unavailable. DISP:ENAB Format DISPlay:ENABle {ON|OFF|1|0} DISPlay:ENABle? Description Sets whether to update the information shown on the screen.
GPIB Command Reference DISP:FORM DISP:FORM Format DISPlay[:WINDow]:FORMat {SPLit|OVERlay} DISPlay[:WINDow]:FORMat? Description When displaying plural scalar traces, selects whether to arrange all displayed traces so that they overlap in a single window screen or so that they are divided and displayed in individual window screens. Description SPLit Divides traces to show them in individual window screens. OVERlay (Default) Displays all traces in a single window screen.
GPIB Command Reference DISP:TEXT{1-3}:SET DISP:TEXT{1-3}:SET Format DISPlay[:WINDow]:TEXT{1-3}:SET Description Displays the text information on the screen. (No query) Parameters Sub-block Description TEXT1 Specifies the display of segment sweep table. TEXT2 Specifies the display of setting parameters. TEXT3 Specifies the display of limit test menu. Related commands DISP:TEXT command on page 355 Front Panel Equivalents Stimulus - Sweep Setup... - Segment Table Menu Display - Display...
GPIB Command Reference DISP:TRAC{1-5}:GRAT:FORM DISP:TRAC{1-5}:GRAT:FORM Format DISPlay[:WINDow]:TRACe{1-5}:GRATicule:FORMat {RECTangle|POLar|SMITh|ADMittance|CPLane} DISPlay[:WINDow]:TRACe{1-5}:GRATicule:FORMat? Selects the trace display format. Parameters The following display formats can be selected: • 17.
GPIB Command Reference DISP:TRAC{1-3}:REF DISP:TRAC{1-3}:REF Format DISPlay[:WINDow]:TRACe{1-3}:REFerence[:STATe] {ON|OFF|1|0} DISPlay[:WINDow]:TRACe{1-3}:REFerence[:STATe]? Description Selects whether to display the scale reference line for the linear Y-axis format. Parameters Sub-block Description TRACe{1-3} Specifies the trace number (1 to 3) Description Query response ON or 1 (Default) Displays the reference line. OFF or 0 Does not display the reference line.
GPIB Command Reference DISP:TRAC{1-5}:TEXT DISP:TRAC{1-5}:TEXT Format DISPlay[:WINDow]:TRACe{1-5}:TEXT[:STATe] {ON|OFF|1|0} DISPlay[:WINDow]:TRACe{1-5}:TEXT[:STATe]? Description Switches between the graph display and list display on the specified trace. Parameters TRACe{1-5} 17. GPIB Command Reference Sub-block Description Specifies the trace number (1 to 5) Description Query response ON or 1 Specifies the list display. OFF or 0 (Default) Specifies the graph display.
GPIB Command Reference DISP:TRAC{1-5}:TITL DISP:TRAC{1-5}:TITL Format DISPlay[:WINDow]:TRACe{1-5}:TITLe[:STATe] {ON|OFF|1|0} DISPlay[:WINDow]:TRACe{1-5}:TITLe[:STATe]? Description Sets whether to display the trace title. In addition, use the DISP:TRAC{1-5}:TITL:DATA command to set the string to be displayed in the trace title area. Parameters Sub-block TRACe{1-5} Description Specifies the trace number (1 to 5) Description Query response ON or 1 (Default) Displays the title.
GPIB Command Reference DISP:TRAC{1-5}:TITL:DATA DISP:TRAC{1-5}:TITL:DATA Format DISPlay[:WINDow]:TRACe{1-5}:TITLe:DATA DISPlay[:WINDow]:TRACe{1-5}:TITLe:DATA? Description Sets the string to be displayed in the trace title area. In addition, use the DISP:TRAC{1-5}:TITL command to display the trace title. 17.
GPIB Command Reference DISP:TRAC{4-5}:X:RLEV DISP:TRAC{4-5}:X:RLEV Format DISPlay[:WINDow]:TRACe{4-5}:X[:SCALe]:RLEVel DISPlay[:WINDow]:TRACe{4-5}:X[:SCALe]:RLEVel? Description Sets the reference value (center value) of the X-axis in the complex plane format. In addition, use the DISP:TRAC{1-5}:Y:RLEV command to set the reference value of the Y-axis.
GPIB Command Reference DISP:TRAC{1-5}:X:SPAC DISP:TRAC{1-5}:X:SPAC Format DISPlay[:WINDow]:TRACe{1-5}:X:SPACing {LINear|LOGarithmic|OBASe} DISPlay[:WINDow]:TRACe{1-5}:X:SPACing? Description Selects whether to display the frequency span as the range from the minimum value to the maximum value or to display it divided by segment at the time of segment sweep. Sub-block TRACe{1-5} 17.
GPIB Command Reference DISP:TRAC{1-5}:Y:AUTO DISP:TRAC{1-5}:Y:AUTO Format DISPlay[:WINDow]:TRACe{1-5}:Y[:SCALe]:AUTO Description Executes autoscale so that the trace fits the scale.
GPIB Command Reference DISP:TRAC{1-3}:Y:BOTT DISP:TRAC{1-3}:Y:BOTT Format DISPlay[:WINDow]:TRACe{1-3}:Y[:SCALe]:BOTTom DISPlay[:WINDow]:TRACe{1-3}:Y[:SCALe]:BOTTom? Description Sets the minimum scale value in the Y-axis direction for the scalar trace. In addition, use the DISP:TRAC{1-3}:Y:TOP command to set the maximum scale value. 17.
GPIB Command Reference DISP:TRAC{1-5}:Y:FOR DISP:TRAC{1-5}:Y:FOR Format DISPlay[:WINDow]:TRACe{1-5}:Y[:SCALe]:FOR {DATA|MEMory|AND} DISPlay[:WINDow]:TRACe{1-5}:Y[:SCALe]:FOR? Description Selects the trace to set the scale. Parameters Sub-block TRACe{1-5} Description Specifies the trace number (1 to 5) Description DATA Specifies the data trace to set the scale. MEMory*1 Specifies the memory trace to set the scale. AND*1 Specifies both the data trace and memory trace to set the scale. *1.
GPIB Command Reference DISP:TRAC{1-5}:Y:FULL DISP:TRAC{1-5}:Y:FULL Format DISPlay[:WINDow]:TRACe{1-5}:Y[:SCALe]:FULL DISPlay[:WINDow]:TRACe{1-5}:Y[:SCALe]:FULL? Description Sets the following parameters for the display trace: Full-scale value in the linear Y-axis format • Scale value in the polar format • Full-scale value in the complex plane format 17.
GPIB Command Reference DISP:TRAC{1-5}:Y:PDIV Related commands DISP:TRAC{1-5}:Y:PDIV command on page 368 Front Panel Equivalents Scale - Scale... - Full-scale|Scale DISP:TRAC{1-5}:Y:PDIV Format DISPlay[:WINDow]:TRACe{1-5}:Y[:SCALe]:PDIVision DISPlay[:WINDow]:TRACe{1-5}:Y[:SCALe]:PDIVision? Description Sets the Y-axis direction scale by using a one-tenths value of full-scale. However, the setting value here does not always have a one-to-one correspondence to the scale value per division.
GPIB Command Reference DISP:TRAC{1-5}:Y:RLEV DISP:TRAC{1-5}:Y:RLEV Format DISPlay[:WINDow]:TRACe{1-5}:Y[:SCALe]:RLEVel DISPlay[:WINDow]:TRACe{1-5}:Y[:SCALe]:RLEVel? Description Sets the following parameters for the display trace. Reference value in the linear Y-axis format • Reference value of Y-axis in the complex plain format (center value) 17.
GPIB Command Reference DISP:TRAC{1-3}:Y:RPOS DISP:TRAC{1-3}:Y:RPOS Format DISPlay[:WINDow]:TRACe{1-3}:Y[:SCALe]:RPOSition DISPlay[:WINDow]:TRACe{1-3}:Y[:SCALe]:RPOSition? Description Sets the following parameter for the display trace.
GPIB Command Reference DISP:TRAC{1-3}:Y:SPAC DISP:TRAC{1-3}:Y:SPAC Format DISPlay[:WINDow]:TRACe{1-3}:Y:SPACing {LINer|LOGarithmic} DISPlay[:WINDow]:TRACe{1-3}:Y:SPACing? Description Selects the Y-axis display format when the rectangle format is selected. In addition, use the DISP:TRAC{1-5}:GRAT:FORM command to select the trace display format. 17. GPIB Command Reference Parameters Sub-block TRACe{1-3} Description Specifies the trace number (1 to 3).
GPIB Command Reference DISP:TRAC{1-3}:Y:TOP DISP:TRAC{1-3}:Y:TOP Format DISPlay[:WINDow]:TRACe{1-3}:Y[:SCALe]:TOP DISPlay[:WINDow]:TRACe{1-3}:Y[:SCALe]:TOP? Description Sets the maximum scale value in the Y-axis direction for the scalar trace. In addition, use the DISP:TRAC{1-3}:Y:BOTT command to set the minimum scale value. Parameters Sub-block TRACe{1-3} Description Specifies the trace number (1 to 3).
GPIB Command Reference FORM:BORD FORM:BORD Format FORMat:BORDer {NORMal|SWAPped} FORMat:BORDer? Description Selects the transfer order (byte order) of each byte of data (8 bytes) when binary transfer is selected for the data transfer format with the FORM:DATA command. Description Query response NORMal (Default) Specifies the byte order to start the transfer from the byte that contains MSB (Most Significant Bit).
GPIB Command Reference FORM:DATA FORM:DATA Format FORMat:DATA {ASCii[,0]|REAL[,32]|REAL,64} FORMat:DATA? Description Sets the transfer format used for data transfer with the following GPIB commands: • DATA:CAD{1-8}? command on page 345 • DATA:SEGM{1-16}:CAD{1-8}? command on page 350 • DATA:CCO{1-6} command on page 346 • DATA:SEGM{1-16}:CCO{1-6} command on page 351 • DATA:CMD{1-2}? command on page 347 • DATA:SEGM{1-16}:CMD{1-2}? command on page 352 • DATA:CMP{1-3} command on page 348 • DAT
GPIB Command Reference FREQ FREQ Format [SENSe:]FREQuency[:CW|:FIXed] [SENSe:]FREQuency[:CW|:FIXed]? Sets the CW frequency for the oscillator level sweep, dc bias voltage sweep, or dc bias current sweep. Parameters Either CW or FIXed can be written when describing the sub-block of the command, although [:CW|:FIXes] in the sub-block part can be omitted. 17.
GPIB Command Reference FREQ:CENT FREQ:CENT Format [SENSe:]FREQuency:CENTer [SENSe:]FREQuency:CENTer? Description Sets the center value in the frequency sweep range (linear/log sweep). In addition, use the FREQ:SPAN command to set the span value in the sweep range. Parameters Description Center value in the sweep range Data type Floating point Range 1E6 to 3E9 Default 1.
GPIB Command Reference FREQ:SPAN FREQ:SPAN Format [SENSe:]FREQuency:SPAN [SENSe:]FREQuency:SPAN? Description Sets the span value in the frequency sweep range (linear/log sweep). In addition, use the FREQ:CENT command to set the center value in the sweep range. 17. GPIB Command Reference Parameters Description Span value in the sweep range Data type Floating point Range 1E6 to 2999E6 Default 2.
GPIB Command Reference FREQ:STAR FREQ:STAR Format [SENSe:]FREQuency:STARt [SENSe:]FREQuency:STARt? Description Sets the start value in the frequency sweep range (linear/log sweep). In addition, use the FREQ:STOP command to set the stop value in the sweep range.
GPIB Command Reference FREQ:STOP FREQ:STOP Format [SENSe:]FREQuency:STOP [SENSe:]FREQuency:STOP? Description Sets the stop value in the frequency sweep range (linear/log sweep). In addition, use the FREQ:STAR command to set the start value in the sweep range. 17.
GPIB Command Reference HCOP HCOP Format HCOPy[:IMMediate] Description Outputs the print content selected with the HCOP:CONT command to a printer connected to the E4991A. (No query) Related commands HCOP:CONT command on page 380 Front Panel Equivalents See Operation Manual HCOP:ABOR Format HCOPy:ABORt Description Aborts the print outputs.
GPIB Command Reference HCOP:IMAG HCOP:IMAG Format HCOPy:IMAGe {INVert|MONochrome} HCOPy:IMAGe? Description Selects the print color for the printer output. Parameters 17. GPIB Command Reference Description INVert*1 (Default) Specifies the color image (but background color is always white). MONochrome Specifies the monochrome image (inverted screen display color). *1.Can be selected when the print content is chosen for the measurement result graph display using the HCOP:CONT command.
GPIB Command Reference INIT INIT Format INITiate[:IMMediate] Description The trigger system is started from the idle state when this command is executed. The idle state is resumed when the trigger cycle is performed once. Executing this command results in an error when the trigger system is not in the idle state or the trigger system is set to be started continuously (continuous start is specified with the INIT:CONT command).
GPIB Command Reference MMEM:CAT? MMEM:CAT? Format MMEMory:CATalog? Description Returns the list of files present in the current folder. (Query only) Query response {string}<^END> Front Panel Equivalents Save/Recall - Save State...|Save Data...|Save Graphics...|Recall State...|Recall Data... MMEM:CDIR Format MMEMory:CDIRectory MMEMory:CDIRectory? Description Changes the current folder when saving or recalling the file.
GPIB Command Reference MMEM:COPY MMEM:COPY Format MMEMory:COPY , Description Copies the file. (No query) Parameters Description Source file name to copy (with extension) Destination file name to copy (with extension) Range Maximum 255 characters (including the extension) Maximum 255 characters (including the extension) Source and destination file names to copy have to be specified with an extension attached.
GPIB Command Reference MMEM:LOAD MMEM:LOAD Format MMEMory:LOAD[:STATe] Description Recalls the state file of the E4991A. (No query) Parameters Front Panel Equivalents Description File name to be recalled (no extension needs to be attached to the file name). Range Maximum 255 characters Save/Recall - Recall State... - OK MMEM:LOAD:MACR Format MMEMory:LOAD:MACRo Description Load the macro.
GPIB Command Reference MMEM:LOAD:TRAC MMEM:LOAD:TRAC Format MMEMory:LOAD:TRACe Description Recalls the internal data array of the E4991A saved with the MMEM:STOR:TRAC command. (No query) Parameters Description File name to be recalled (no extension needs to be attached to the file name). Range Maximum 255 characters Related commands MMEM:STOR:TRAC command on page 391 Front Panel Equivalents Save/Recall - Recall Data...
GPIB Command Reference MMEM:MOVE MMEM:MOVE Format MMEMory:MOVE , Description Changes the specified file to another name. (No query) Parameters Description Original file name (with extension) Changed file name (with extension) Range Maximum 255 characters (including the extension) Maximum 255 characters (including the extension) 17. GPIB Command Reference The file name has to be specified with an extension attached. Front Panel Equivalents Unavailable.
GPIB Command Reference MMEM:RDIR MMEM:RDIR Format MMEMory:RDIRectory Description Deletes the folder. (No query) Parameters Front Panel Equivalents Description Folder name Range Up to 255 strings (including extension) Save/Recall - Save State...|Save Data...|Save Graphics...|Recall State...|Recall Data... - Delete MMEM:STOR Format MMEMory:STORe[:STATe] Description Saves the state file of E4991A.(No query) The contents saved in the state file are as follows.
GPIB Command Reference MMEM:STOR:CITI{1-3} MMEM:STOR:CITI{1-3} Format MMEMory:STORe:CITI{1-3} Description Saves the measurement data of the E4991A in the CITI file format. (No query) Parameters Description CITI1 Specifies 1-port model. CITI2 Specifies 2-port Series model. CITI3 Specifies 2-port Shunt model. 17.
GPIB Command Reference MMEM:STOR:GRAP:BMP MMEM:STOR:GRAP:BMP Format MMEMory:STORe:GRAPh:BMP Description Saves graph display of the screen in the Windows Bitmap format. (No query) Parameters Description Saved file name (no need to attach extension to the file name) Range Up to 255 strings Related commands MMEM:STOR:GRAP command on page 389 Front Panel Equivalents Save/Recall - Save Graphics...
GPIB Command Reference MMEM:STOR:TRAC MMEM:STOR:TRAC Format MMEMory:STORe:TRAC[:BINary] Description Saves the specified internal data array in binary form. (No query) In addition, select the saving data array with the MMEM:STOR:TRAC:SEL{1-4} command. 17.
GPIB Command Reference MMEM:STOR:TRAC:SEL{1-4} MMEM:STOR:TRAC:SEL{1-4} Format MMEMory:STORe:TRACe:SELect{1-4} {ON|OFF|1|0} MMEMory:STORe:TRACe:SELect{1-4}? Description When saving the internal data array with the MMEM:STOR:TRAC command or MMEM:STOR:TRAC:ASC command, sets whether to save the data array. Parameters Sub-block Description SELect1 Specifies data array. SELect2 Specifies data trace array. SELect3 Specifies memory array. SELect4 Specifies memory trace array.
GPIB Command Reference MODE MODE Format [SENSe:]MODE {IMPedance|PERMITtivity|PERMEAbility} [SENSe:]MODE? Description Selects the measurement mode of the E4991A. Parameters 17. GPIB Command Reference Description IMPedance (Default) Specifies the impedance measurement mode. PERMITtivity*1 Specifies the dielectric measurement mode. PERMEAbility*1 Specifies the magnetic measurement mode. *1.This can be selected if Option 002 (materials measurement software) is installed.
GPIB Command Reference PROG:CAT? PROG:CAT? Format PROGram:CATalog? Description Returns a list of macros. (Query only). Query response {String}<^END> Format of strings is .. When multiple macros exist, they are separated by commas (,). Also, when no macro exists, empty quotation marks (“”) are returned. Front Panel Equivalents Utility - VBA Macros... PROG:NAME Format PROGram[:SELected]:NAME PROGram[:SELected]:NAME? Description Defines the macro name.
GPIB Command Reference PROG:STAT PROG:STAT Format PROGram[:SELected]:STATe {RUN|STOP} PROGram[:SELected]:STATe? Description Sets the macro status. Parameters 17. GPIB Command Reference Description Query response RUN Executes macro. STOP (Default) Stops macro. {RUN|STOP}<^END> Related commands PROG:NAME command on page 394 Front Panel Equivalents Utility - Visual Basic Editor...
GPIB Command Reference SEGM{1-16}:AVER:COUN SEGM{1-16}:AVER:COUN Format [SENSe:]SEGMent{1-16}:AVERage:COUNt [SENSe:]SEGMent{1-16}:AVERage:COUNt? Description When creating the segment sweep table, sets the point averaging factor. Parameters Sub-block SEGMent {1-16} Description Specifies the segment number (1 to 16).
GPIB Command Reference SEGM:COUN SEGM:COUN Format [SENSe:]SEGMent:COUNt [SENSe:]SEGMent:COUNt? Description After clearing the segment parameters within the segment sweep table, creates the specified number of new segments. In addition, all of the default segment parameters are inputted within the segment table. 17. GPIB Command Reference Parameters Description Total number of segments Data type Integer Range 0*1 to 16 Default 0 *1.
GPIB Command Reference SEGM{1-16}:CURR SEGM{1-16}:CURR Format [SENSe:]SEGMent{1-16}:CURRent[:LEVel] [SENSe:]SEGMent{1-16}:CURRent[:LEVel]? Description When creating the segment sweep table, sets the oscillator current level. Parameters Sub-block SEGMent {1-16} Description Specifies the segment number (1 to 16). Description Oscillator current level Data type Floating point Range 0.1E-3 to 10E-3 Default 2E-3 Resolution 0.
GPIB Command Reference SEGM:CURR:OFFS:STAT SEGM:CURR:OFFS:STAT Format [SENSe:]SEGMent:CURRent:OFFSet:STATe {ON|OFF|1|0} [SENSe:]SEGMent:CURRent:OFFSet:STATe? Description When creating the segment sweep table, selects the voltage mode to set the dc bias level. This command can be used when Option 001 (dc bias function) is installed. Parameters Description Query response ON or 1 (Default) Specifies the current mode. OFF or 0 Specifies the voltage mode.
GPIB Command Reference SEGM{1-16}:CURR:LIM SEGM{1-16}:CURR:LIM Format [SENSe:]SEGMent{1-16}:CURRent:LIMit [SENSe:]SEGMent{1-16}:CURRent:LIMit? Description When creating the segment sweep table, sets the dc bias current limit maximum value. This command is available when Option 001 (dc bias function) is installed. Parameters Sub-block SEGMent {1-16} Description Specifies the segment number (1 to 16).
GPIB Command Reference SEGM{1-16}:CURR:OFFS SEGM{1-16}:CURR:OFFS Format [SENSe:]SEGMent{1-16}:CURRent:OFFSet [SENSe:]SEGMent{1-16}:CURRent:OFFSet? Description When creating the segment sweep table, sets the dc bias current level. This command is available when Option 001 (dc bias function) is installed. Sub-block SEGMent {1-16} 17. GPIB Command Reference Parameters Description Specifies the segment number (1 to 16).
GPIB Command Reference SEGM:CURR:STAT SEGM:CURR:STAT Format [SENSe:]SEGMent:CURRent:STATe {ON|OFF|1|0} [SENSe:]SEGMent:CURRent:STATe? Description When creating the segment sweep table, selects the current mode to set the oscillator level. In addition, use the SEGM{1-16}:CURR command to set the oscillator current level. Parameters Description ON or 1 Specifies the current mode. OFF or 0 (Default) Specifies the mode other than the current mode.*1 *1.
GPIB Command Reference SEGM{1-16}:DATA SEGM{1-16}:DATA [SENSe:]SEGMent{1-16}:DATA ,,,,,, Description When creating/editing the segment sweep table, simultaneously sets the parameter values of all segments. Before executing this GPIB command, you need to set the oscillator level to be read as current, dBm, or voltage by using the SEGM:CURR:STAT command, SEGM:POW:STAT command, or SEGM:VOLT:STAT command, respectively.
GPIB Command Reference SEGM{1-16}:DATA Default voltage: voltage: current: 100E-3 0 2E-3 current: current: voltage: 2E-3 100E-6 1 V/A A/V power: -13.01 Unit V/A/dBm If the specified parameter is outside the range, the minimum (if the lower limit of the range is exceeded) or maximum value (if the upper limit is exceeded) will be assumed.
GPIB Command Reference SEGM:DATA:ALL SEGM:DATA:ALL [SENSe:]SEGMent:DATA:ALL ,,,,,, Description When creating the segment sweep table, sets the same content parameter values in all of the segments. Before executing this GPIB command, you need to set the oscillator level to be read as current, dBm, or voltage by using the SEGM:CURR:STAT command, SEGM:POW:STAT command, or SEGM:VOLT:STAT command, respectively.
GPIB Command Reference SEGM:DEL:ALL Default voltage: voltage: current: 100E-3 0 2E-3 current: current: voltage: 2E-3 100E-6 1 V/A A/V power: -13.01 Unit V/A/dBm If the specified parameter is outside the range, the minimum (if the lower limit of the range is exceeded) or maximum value (if the upper limit is exceeded) will be assumed.
GPIB Command Reference SEGM{1-16}:FREQ:CENT SEGM{1-16}:FREQ:CENT Format [SENSe:]SEGMent{1-16}:FREQuency:CENTer [SENSe:]SEGMent{1-16}:FREQuency:CENTer? Description When creating the segment sweep table, sets the center value in the frequency sweep range. In addition, use the SEGM{1-16}:FREQ:SPAN command when setting the span value in the sweep range. 17. GPIB Command Reference Parameters Sub-block SEGMent {1-16} Description Specifies the segment number (1 to 16).
GPIB Command Reference SEGM{1-16}:FREQ:SPAN SEGM{1-16}:FREQ:SPAN Format [SENSe:]SEGMent{1-16}:FREQuency:SPAN [SENSe:]SEGMent{1-16}:FREQuency:SPAN? Description When creating the segment sweep table, sets the span value in the frequency sweep range. In addition, use the SEGM{1-16}:FREQ:CENT command when setting the center value in the sweep range. Parameters Sub-block SEGMent {1-16} Description Specifies the segment number (1 to 16).
GPIB Command Reference SEGM{1-16}:FREQ:STAR SEGM{1-16}:FREQ:STAR Format [SENSe:]SEGMent{1-16}:FREQuency:STARt [SENSe:]SEGMent{1-16}:FREQuency:STARt? Description When creating the segment sweep table, sets the start value in the frequency sweep range. In addition, use the SEGM{1-16}:FREQ:STOP command when setting the stop value in the sweep range. 17. GPIB Command Reference Parameters Sub-block SEGMent {1-16} Description Specifies the segment number (1 to 16).
GPIB Command Reference SEGM{1-16}:FREQ:STOP SEGM{1-16}:FREQ:STOP Format [SENSe:]SEGMent{1-16}:FREQuency:STARt [SENSe:]SEGMent{1-16}:FREQuency:STARt? Description When creating the segment sweep table, sets the stop value in the frequency sweep range. In addition, use the SEGM{1-16}:FREQ:STAR command when setting the start value in the sweep range. Parameters Sub-block SEGMent {1-16} Description Specifies the segment number (1 to 16).
GPIB Command Reference SEGM{1-16}:POW SEGM{1-16}:POW Format [SENSe:]SEGMent{1-16}:POWer[:LEVel] [SENSe:]SEGMent{1-16}:POWer[:LEVel]? Description When creating the segment sweep table, sets the oscillator power level. Parameters SEGMent {1-16} 17. GPIB Command Reference Sub-block Description Specifies the segment number (1 to 16). Description Oscillator power level Data type Floating point Range -40 to 1 Default -13.
GPIB Command Reference SEGM:POW:STAT SEGM:POW:STAT Format [SENSe:]SEGMent:POWer:STATe {ON|OFF|1|0} [SENSe:]SEGMent:POWer:STATe? Description When creating the segment sweep table, selects the power mode to set the oscillator level. In addition, use the SEGM{1-16}:POW command to set the oscillator power level. Parameters Description ON or 1 Specifies the power (dBm) mode. OFF or 0 (Default) Specifies a mode other than power mode.*1 *1.
GPIB Command Reference SEGM{1-16}:SWE:POIN SEGM{1-16}:SWE:POIN Format [SENSe:]SEGMent{1-16}:SWEep:POINts [SENSe:]SEGMent{1-16}:SWEep:POINts? Description When creating the segment sweep table, sets the number of points measured at each segment. Sub-block SEGMent {1-16} 17. GPIB Command Reference Parameters Description Specifies the segment number (1 to 16). Description Number of measurement points Data type Integer Range 2 to 801*1 Default 2 *1.
GPIB Command Reference SEGM{1-16}:VOLT SEGM{1-16}:VOLT Format [SENSe:]SEGMent{1-16}:VOLTage[:LEVel] [SENSe:]SEGMent{1-16}:VOLTage[:LEVel]? Description When creating the segment sweep table, sets the oscillator voltage level. Parameters Sub-block SEGMent {1-16} Description Specifies the segment number (1 to 16).
GPIB Command Reference SEGM{1-16}:VOLT:LIM SEGM{1-16}:VOLT:LIM Format [SENSe:]SEGMent{1-16}:VOLTage:LIMit [SENSe:]SEGMent{1-16}:VOLTage:LIMit? Description When creating the segment sweep table, sets the dc bias voltage limit maximum value. This command is available when Option 001 (dc bias function) is installed. Sub-block SEGMent {1-16} 17. GPIB Command Reference Parameters Description Specifies the segment number (1 to 16).
GPIB Command Reference SEGM{1-16}:VOLT:OFFS SEGM{1-16}:VOLT:OFFS Format [SENSe:]SEGMent{1-16}:VOLTage:OFFSet [SENSe:]SEGMent{1-16}:VOLTage:OFFSet? Description When creating the segment sweep table, sets the dc bias voltage level. This command is available when Option 001 (dc bias function) is installed. Parameters Sub-block SEGMent {1-16} Description Specifies the segment number (1 to 16).
GPIB Command Reference SEGM:VOLT:OFFS:STAT SEGM:VOLT:OFFS:STAT Format [SENSe:]SEGMent:VOLTage:OFFSet:STATe {ON|OFF|1|0} [SENSe:]SEGMent:VOLTage:OFFSet:STATe? Description When creating the segment sweep table, selects the voltage mode to set the dc bias level. This command can be used when Option 001 (dc bias function) is installed. Parameters Description Query response ON or 1 Specifies the voltage mode. OFF or 0 (Default) Specifies the current mode.
GPIB Command Reference SEGM:VOLT:STAT SEGM:VOLT:STAT Format [SENSe:]SEGMent:VOLTage:STATe {ON|OFF|1|0} [SENSe:]SEGMent:VOLTage:STATe? Description When creating the segment sweep table, selects the voltage mode to set the oscillator level. In addition, use the SEGM{1-16}:VOLT command to set the oscillator voltage level. Parameters Description ON or 1 (Default) Specifies the voltage mode. OFF or 0 Specifies a mode other than the voltage mode.*1 *1.
GPIB Command Reference SENS:CORR1 SENS:CORR1 Format SENSe:CORRection1[:STATe] {OFF|0} SENSe:CORRection1[:STATe]? Description Resets the calibration data array and calibration coefficient array and turns off the calibration function. The calibration function cannot be set to on with this command. 17. GPIB Command Reference Parameters Description OFF or 0 (Default) Query response Turns off the calibration function.
GPIB Command Reference SENS:CORR1:CKIT SENS:CORR1:CKIT Format SENSe:CORRection1:CKIT {DEFault|PTFE|USER} SENSe:CORRection1:CKIT? Description When measuring the calibration data, selects whether to use the 7-mm calibration kit supplied with the E4991A or a user-defined calibration kit prepared by the user. Also, in the dielectric measurement, selects the Load standard attached by Agilent test fixture. When the dielectric measurement is selected, “PTFE” is selected automatically.
GPIB Command Reference SENS:CORR1:CKIT:LIST SENS:CORR1:CKIT:LIST Format SENSe:CORRection1:CKIT:LIST[:STATe] {ON|OFF|1|0} SENSe:CORRection1:CKIT:LIST[:STATe]? Description When using a user-defined calibration kit for executing calibration, selects whether to specify the input value with or without the list setting function for each standard value of the calibration kit. 17.
GPIB Command Reference SENS:CORR1:CKIT:STAN1:C SENS:CORR1:CKIT:STAN1:C Format SENSe:CORRection1:CKIT:STANdard1:C SENSe:CORRection1:CKIT:STANdard1:C? Description Defines the capacitance value (C) of the Open standard of a user-defined calibration kit.
GPIB Command Reference SENS:CORR1:CKIT:STAN1:G SENS:CORR1:CKIT:STAN1:G Format SENSe:CORRection1:CKIT:STANdard1:G SENSe:CORRection1:CKIT:STANdard1:G? Description Defines the conductance value (G) of the Open standard of a user-defined calibration kit. Parameters 17.
GPIB Command Reference SENS:CORR1:CKIT:STAN1:LIST:B SENS:CORR1:CKIT:STAN1:LIST:B Format SENSe:CORRection1:CKIT:STANdard1:LIST:B ,,.., SENSe:CORRection1:CKIT:STANdard1:LIST:B? Description Defines the susceptance value (B) of the Open standard of a user-defined calibration kit with the list setting function.
GPIB Command Reference SENS:CORR1:CKIT:STAN1:LIST:G SENS:CORR1:CKIT:STAN1:LIST:G Format SENSe:CORRection1:CKIT:STANdard1:LIST:G ,,.., SENSe:CORRection1:CKIT:STANdard1:LIST:G? Description Defines the conductance value (G) of the Open standard of a user-defined calibration kit with the list setting function.
GPIB Command Reference SENS:CORR1:CKIT:STAN2:L SENS:CORR1:CKIT:STAN2:L Format SENSe:CORRection1:CKIT:STANdard2:L SENSe:CORRection1:CKIT:STANdard2:L? Description Defines the inductance value (L) of the Short standard of a user-defined calibration kit.
GPIB Command Reference SENS:CORR1:CKIT:STAN2:LIST:R SENS:CORR1:CKIT:STAN2:LIST:R Format SENSe:CORRection1:CKIT:STANdard2:LIST:R ,,.., SENSe:CORRection1:CKIT:STANdard2:LIST:R? Description Defines the resistance value (R) of the Short standard of a user-defined calibration kit by using the list setting function.
GPIB Command Reference SENS:CORR1:CKIT:STAN2:LIST:X SENS:CORR1:CKIT:STAN2:LIST:X Format SENSe:CORRection1:CKIT:STANdard2:LIST:X ,,.., SENSe:CORRection1:CKIT:STANdard2:LIST:X? Description Defines the reactance value (X) of the Short standard of a user-defined calibration kit by using the list setting function.
GPIB Command Reference SENS:CORR1:CKIT:STAN2:R SENS:CORR1:CKIT:STAN2:R Format SENSe:CORRection1:CKIT:STANdard2:R SENSe:CORRection1:CKIT:STANdard2:R? Description Defines the resistance value (R) of the Short standard of a user-defined calibration kit. Parameters 17.
GPIB Command Reference SENS:CORR1:CKIT:STAN3:L SENS:CORR1:CKIT:STAN3:L Format SENSe:CORRection1:CKIT:STANdard3:L SENSe:CORRection1:CKIT:STANdard3:L? Description Defines the inductance value (L) of the Load standard of a user-defined calibration kit.
GPIB Command Reference SENS:CORR1:CKIT:STAN3:LIST:R SENS:CORR1:CKIT:STAN3:LIST:R Format SENSe:CORRection1:CKIT:STANdard3:LIST:R ,,.., SENSe:CORRection1:CKIT:STANdard3:LIST:R? Description Defines the resistance value (R) of the Load standard of a user-defined calibration kit by using the list setting function.
GPIB Command Reference SENS:CORR1:CKIT:STAN3:LIST:X SENS:CORR1:CKIT:STAN3:LIST:X Format SENSe:CORRection1:CKIT:STANdard3:LIST:X ,,.., SENSe:CORRection1:CKIT:STANdard3:LIST:X? Description Defines the reactance value (X) of the Load standard of a user-defined calibration kit by using the list setting function.
GPIB Command Reference SENS:CORR1:CKIT:STAN3:R SENS:CORR1:CKIT:STAN3:R Format SENSe:CORRection1:CKIT:STANdard3:R SENSe:CORRection1:CKIT:STANdard3:R? Description Defines the resistance value (R) of the Load standard of a user-defined calibration kit. Parameters 17.
GPIB Command Reference SENS:CORR1:CKIT:STAN7:PLF SENS:CORR1:CKIT:STAN7:PLF Format SENSe:CORRection1:CKIT:STANdard7:PLFactor SENSe:CORRection1:CKIT:STANdard7:PLFactor? Description Defines the dielectric dissipation factor of the Load standard of the calibration kit in dielectric measurement. This command can be used when Option 002 (material measurement software) is installed.
GPIB Command Reference SENS:CORR1:CKIT:STAN7:PRE SENS:CORR1:CKIT:STAN7:PRE Format SENSe:CORRection1:CKIT:STANdard7:PREal SENSe:CORRection1:CKIT:STANdard7:PREal? Description Defines the dielectric constant ratio of the Load standard of the calibration kit in dielectric measurement. This command can be used when Option 002 (material measurement software) is installed. 17.
GPIB Command Reference SENS:CORR1:CKIT:STAN7:THIC SENS:CORR1:CKIT:STAN7:THIC Format SENSe:CORRection1:CKIT:STANdard7:THICkness SENSe:CORRection1:CKIT:STANdard7:THICkness? Description Defines the thickness of the Load standard of the calibration kit in dielectric measurement. This command can be used when Option 002 (material measurement software) is installed.
GPIB Command Reference SENS:CORR1:COLL SENS:CORR1:COLL Format SENSe:CORRection1:COLLect[:ACQuire] {STAN1|STAN2|STAN3|STAN4|STAN5|STAN6|STAN7} Description Measures calibration data. (No query) Parameters For impedance measurement or magnetic measurement: 17. GPIB Command Reference Description STAN1 Open calibration data is measured. STAN2 Short calibration data is measured. STAN3 Load calibration data is measured. STAN4 Low-loss capacitor calibration data is measured.
GPIB Command Reference SENS:CORR1:COLL:FPO SENS:CORR1:COLL:FPO Format SENSe:CORRection1:COLLect:FPOints {FIXed|FUSer|USER} SENSe:CORRection1:COLLect:FPOints? Description Selects whether to measure the calibration data at the measurement point prepared by the E4991A (fixed point) or at the measurement point set by the user (user-defined point).
GPIB Command Reference SENS:CORR1:COLL:SAVE SENS:CORR1:COLL:SAVE Format SENSe:CORRection1:COLLect:SAVE Description By using the acquired calibration data, calculates the calibration coefficient and automatically sets the calibration function to on. If this command is used before measuring all of the calibration data of Open, Short, and Load with the SENS:CORR1:COLL command, an error will occur and the command will be ignored. (No query) 17.
GPIB Command Reference SENS:CORR2:CKIT:LIST SENS:CORR2:CKIT:LIST Format SENSe:CORRection2:CKIT:LIST[:STATe] {ON|OFF|1|0} SENSe:CORRection2:CKIT:LIST[:STATe]? Description When executing fixture compensation with the fixture compensation kit, selects whether to specify the input value with or without using the list setting function on each standard value of the fixture compensation kit.
GPIB Command Reference SENS:CORR2:CKIT:STAN1:C SENS:CORR2:CKIT:STAN1:C Format SENSe:CORRection2:CKIT:STANdard1:C SENSe:CORRection2:CKIT:STANdard1:C? Description Defines the capacitance value (C) of the Open standard of the fixture compensation kit. Parameters 17.
GPIB Command Reference SENS:CORR2:CKIT:STAN1:G SENS:CORR2:CKIT:STAN1:G Format SENSe:CORRection2:CKIT:STANdard1:G SENSe:CORRection2:CKIT:STANdard1:G? Description Defines the conductance value (G) of the Open standard of the fixture compensation kit.
GPIB Command Reference SENS:CORR2:CKIT:STAN1:LIST:B SENS:CORR2:CKIT:STAN1:LIST:B Format SENSe:CORRection2:CKIT:STANdard1:LIST:B ,,.., SENSe:CORRection2:CKIT:STANdard1:LIST:B? Description Defines the susceptance value (B) of the Open standard of the fixture compensation kit by using the list setting function.
GPIB Command Reference SENS:CORR2:CKIT:STAN1:LIST:G SENS:CORR2:CKIT:STAN1:LIST:G Format SENSe:CORRection2:CKIT:STANdard1:LIST:G ,,.., SENSe:CORRection2:CKIT:STANdard1:LIST:G? Description Defines the conductance value (G) of the Open standard of the fixture compensation kit by using the list setting function..
GPIB Command Reference SENS:CORR2:CKIT:STAN2:L SENS:CORR2:CKIT:STAN2:L Format SENSe:CORRection2:CKIT:STANdard2:L SENSe:CORRection2:CKIT:STANdard2:L? Description Defines the inductance value (L) of the Short standard of the fixture compensation kit. Parameters 17.
GPIB Command Reference SENS:CORR2:CKIT:STAN2:LIST:R SENS:CORR2:CKIT:STAN2:LIST:R Format SENSe:CORRection2:CKIT:STANdard2:LIST:R ,,.., SENSe:CORRection2:CKIT:STANdard2:LIST:R? Description Defines the resistance value (R) of the Short standard of the fixture compensation kit by using the list setting function.
GPIB Command Reference SENS:CORR2:CKIT:STAN2:LIST:X SENS:CORR2:CKIT:STAN2:LIST:X Format SENSe:CORRection2:CKIT:STANdard2:LIST:X ,,.., SENSe:CORRection2:CKIT:STANdard2:LIST:X? Description Defines the reactance value (X) of the Short standard of the fixture compensation kit by using the list setting function.
GPIB Command Reference SENS:CORR2:CKIT:STAN2:R SENS:CORR2:CKIT:STAN2:R Format SENSe:CORRection2:CKIT:STANdard2:R SENSe:CORRection2:CKIT:STANdard2:R? Description Defines the resistance value (R) of the Short standard of the fixture compensation kit.
GPIB Command Reference SENS:CORR2:COLL SENS:CORR2:COLL Format SENSe:CORRection2:COLLect[:ACQuire] {STAN1|STAN2|STAN9} Description Measures fixture compensation data. (No query) Parameters For impedance measurement: Description Open compensation data is measured. STAN2 Short compensation data is measured. 17. GPIB Command Reference STAN1 For magnetic measurement: Description STAN9 Front Panel Equivalents Short compensation data is measured. Stimulus - Cal/Comp...
GPIB Command Reference SENS:CORR2:COLL:FPO SENS:CORR2:COLL:FPO Format SENSe:CORRection2:COLLect:FPOints {FIXed|FUSer|USER} SENSe:CORRection2:COLLect:FPOints? Description Selects whether to measure the fixture compensation data at the measurement point prepared by the E4991A (fixed point) or at the measurement point set by the user (user-defined point).
GPIB Command Reference SENS:CORR2:COLL:OPEN SENS:CORR2:COLL:OPEN Format SENSe:CORRection2:COLLect:OPEN[:STATe] {ON|OFF|1|0} SENSe:CORRection2:COLLect:OPEN[:STATe]? Description Parameters Description Query response ON or 1 Turns on the Open compensation function. OFF or 0 (Default) Turns off the Open compensation function. {1|0}<^END> Related commands SENS:CORR2:COLL command on page 449 Front Panel Equivalents Stimulus - Cal/Comp...
GPIB Command Reference SENS:CORR2:COLL:SHOR SENS:CORR2:COLL:SHOR Format SENSe:CORRection2:COLLect:SHORt[:STATe] {ON|OFF|1|0} SENSe:CORRection2:COLLect:SHORt[:STATe]? Description Turns on/off the Short compensation function. At this time, the fixture compensation coefficient is re-calculated. If this command is executed before measuring the Short compensation data with the SENS:CORR2:COLL command, an error will occur and the command will be ignored.
GPIB Command Reference SENS:CORR2:EDEL:TIME SENS:CORR2:EDEL:TIME Format SENSe:CORRection2:EDELay:TIME SENSe:CORRection2:EDELay:TIME? Description If there is an error related to port extension, aside from electrical length of the test fixture, an offset delay time is set and compensated. 17.
GPIB Command Reference SENS:CORR2:FIXT SENS:CORR2:FIXT Format SENSe:CORRection2:FIXTure {NONE|FXT16191A|FXT16192A|FXT16193A|FXT16194A|FXT16196A|FXT16196B|F XT16196C|FXT16197A|FXT16453A|FXT16454S|FXT16454L|USER} SENSe:CORRection2:FIXTure? Description Selects the test fixture. Parameters Description NONE (Default in impedance measurement) No test fixture is selected. FXT16191A Specifies Agilent 16191A. FXT16192A Specifies Agilent 16192A. FXT16193A Specifies Agilent 16193A.
GPIB Command Reference SENS:CORR2:FIXT:EDEL:MODE:DIST? Front Panel Equivalents Stimulus - Cal/Comp... - Fixture Type SENS:CORR2:FIXT:EDEL:MODE:DIST? SENSe:CORRection2:FIXTure:EDELay:MODEl:DISTance? {NONE|FXT16191A|FXT16192A|FXT16193A|FXT16194A|FXT16196A|FXT16196B|F XT16196C|FXT16197A} Description Reads the standard value of the electrical length of the specified Agilent test fixture. (Query only) 17.
GPIB Command Reference SENS:CORR2:FIXT:EDEL:USER:DIST SENS:CORR2:FIXT:EDEL:USER:DIST Format SENSe:CORRection2:FIXTure:EDELay:USER:DISTance SENSe:CORRection2:FIXTure:EDELay:USER:DISTance? Description Sets the electrical length that compensates for the delay caused by the connection of a custom test fixture. If you want to configure the instrument for your custom test fixture connected to the DUT PORT, use this command to set an electrical length that can compensate for the resulting delay.
GPIB Command Reference SOUR:CURR SOUR:CURR Format SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude] SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]? Description Sets the oscillator current level when the sweep parameter is set to frequency sweep, dc bias voltage sweep, or dc bias current sweep. 17. GPIB Command Reference Parameters Description Oscillator current level Data type Floating point Range 0.1E-3 to 10E-3 Default 2.0E-3 Resolution 0.
GPIB Command Reference SOUR:CURR:CENT SOUR:CURR:CENT Format SOURce:CURRent:CENTer SOURce:CURRent:CENTer? Description Sets the center value in the oscillator current level sweep range. In addition, use the SOUR:CURR:SPAN command to set the span value in the sweep range. Parameters Description Center value in the sweep range Data type Floating point Range 0.1E-3 to 10E-3 Default 6.0E-3 Resolution 0.
GPIB Command Reference SOUR:CURR:LIM:OFFS SOUR:CURR:LIM:OFFS Format SOURce:CURRent:LIMit:OFFSet SOURce:CURRent:LIMit:OFFSet? Description Sets the dc bias current limit maximum value when the dc bias output mode is set to the voltage sweep mode or the fixed voltage source mode. This command can be used when Option 001 (dc bias function) is installed. 17.
GPIB Command Reference SOUR:CURR:MODE SOUR:CURR:MODE Format SOURce:CURRent:MODE {FIXed|SWEep} SOURce:CURRent:MODE? Description Selects the oscillator current level mode. Parameters Description Query response FIXed (Default) Specifies the fixed current mode. SWEep Specifies the current sweep mode. {FIX|SWE}<^END> Related commands SWE:TYPE command on page 515 SOUR:POW:MODE command on page 472 SOUR:VOLT:MODE command on page 479 Front Panel Equivalents Stimulus - Source...
GPIB Command Reference SOUR:CURR:OFFS SOUR:CURR:OFFS Format SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet? Description Sets the dc bias current level in the fixed current source mode. This command can be used when Option 001 (dc bias function) is installed. 17.
GPIB Command Reference SOUR:CURR:OFFS:CENT SOUR:CURR:OFFS:CENT Format SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet:CENTer SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet:CENTer? Description Sets the center value in the dc bias current sweep range. This command can be used when Option 001 (dc bias function) is installed. In addition, in order to set the span value of the sweep range, the SOUR:CURR:OFFS:SPAN command is used.
GPIB Command Reference SOUR:CURR:OFFS:SPAN SOUR:CURR:OFFS:SPAN Format SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet:SPAN SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet:SPAN? Description Sets the span value in the dc bias current sweep range. This command can be used when Option 001 (dc bias function) is installed.
GPIB Command Reference SOUR:CURR:OFFS:STAR SOUR:CURR:OFFS:STAR Format SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STARt SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STARt? Description Sets the start value in the dc bias current sweep range. This command can be used when Option 001 (dc bias function) is installed. In addition, use the SOUR:CURR:OFFS:STOP command to set the stop value of the sweep range.
GPIB Command Reference SOUR:CURR:OFFS:STAT SOUR:CURR:OFFS:STAT Format SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STATe {ON|OFF|1|0} SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STATe? Description Turns on/off the dc bias output in the current sweep mode or the fixed current source mode. This command can be used when Option 001 (dc bias function) is installed. 17. GPIB Command Reference Parameters Description ON or 1 Turn on the dc bias output.
GPIB Command Reference SOUR:CURR:OFFS:STOP SOUR:CURR:OFFS:STOP Format SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STOP SOURce:CURRent[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STOP? Description Sets the stop value in the dc bias current sweep range. This command can be used when Option 001 (dc bias function) is installed. In addition, use the SOUR:CURR:OFFS:STAR command to set the start value in the sweep range.
GPIB Command Reference SOUR:CURR:SPAN SOUR:CURR:SPAN Format SOURce:CURRent:SPAN SOURce:CURRent:SPAN? Description Sets the span value in the oscillator current level sweep range. In addition, use the SOUR:CURR:CENT command to set the center value of the sweep range. 17. GPIB Command Reference Parameters Description Span value in the sweep range Data type Floating point Range 0 to 9.9E-3 Default 4E-3 Resolution 0.
GPIB Command Reference SOUR:CURR:STAR SOUR:CURR:STAR Format SOURce:CURRent:STARt SOURce:CURRent:STARt? Description Sets the start value in the oscillator current level sweep range. In addition, use the SOUR:CURR:STOP command to set the stop value of the sweep range. Parameters Description Start value in the sweep range Data type Floating point Range 0.1 to 10E-3 Default 4E-3 Resolution 0.
GPIB Command Reference SOUR:CURR:STOP SOUR:CURR:STOP Format SOURce:CURRent:STOP SOURce:CURRent:STOP? Description Sets the stop value in the oscillator current level sweep range. In addition, use the SOUR:CURR:STAR command to set the start value of the sweep range. 17. GPIB Command Reference Parameters Description Stop value in the sweep range Data type Floating point Range 0.1 to 10E-3 Default 8E-3 Resolution 0.
GPIB Command Reference SOUR:POW SOUR:POW Format SOURce:POWer[:LEVel][:IMMediate][:AMPLitude] SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]? Description Sets the oscillator power level when the sweep parameter is set to frequency sweep, dc bias voltage sweep, or dc bias current sweep. Parameters Description Oscillator power level Data type Floating point Range -40 to 1 Default -13.
GPIB Command Reference SOUR:POW:CENT SOUR:POW:CENT Format SOURce:POWer:CENTer SOURce:POWer:CENTer? Description Sets the center value in the oscillator power level sweep range. In addition, use the SOUR:POW:SPAN command to set the span value of the sweep range. 17. GPIB Command Reference Parameters Description Center value in the sweep range Data type Floating point Range -40 to 1 Default -3.
GPIB Command Reference SOUR:POW:MODE SOUR:POW:MODE Format SOURce:POWer:MODE {FIXed|SWEep} SOURce:POWer:MODE? Description Selects the oscillator power level mode. Parameters Description Query response FIXed (Default) Specifies the fixed power mode. SWEep Specifies the power sweep mode. {FIX|SWE}<^END> Related commands SWE:TYPE command on page 515 SOUR:CURR:MODE command on page 460 SOUR:VOLT:MODE command on page 479 Front Panel Equivalents Stimulus - Source...
GPIB Command Reference SOUR:POW:SPAN SOUR:POW:SPAN Format SOURce:POWer:SPAN SOURce:POWer:SPAN? Description Sets the span value in the oscillator power level sweep range. In addition, use the SOUR:POW:CENT command to set the center value of the sweep range. 17. GPIB Command Reference Parameters Description Span value in the sweep range Data type Floating point Range 0 to 41 Default 6.
GPIB Command Reference SOUR:POW:STAR SOUR:POW:STAR Format SOURce:POWer:STARt SOURce:POWer:STARt? Description Sets the start value in the oscillator power level sweep range. In addition, use the SOUR:POW:STOP command to set the stop value of the sweep range. Parameters Description Start value in the sweep range Data type Floating point Range -40 to 1 Default -6.
GPIB Command Reference SOUR:POW:STOP SOUR:POW:STOP Format SOURce:POWer:STOP SOURce:POWer:STOP? Description Sets the stop value in the oscillator power level sweep range. In addition, use the SOUR:POW:STAR command to set the start value of the sweep range. 17. GPIB Command Reference Parameters Description Stop value in the sweep range Data type Floating point Range -40 to 1 Default -0.
GPIB Command Reference SOUR:VOLT SOUR:VOLT Format SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude] SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]? Description Sets the oscillator voltage level when the sweep parameter is set to frequency sweep, dc bias voltage sweep, or dc bias current sweep.
GPIB Command Reference SOUR:VOLT:CENT SOUR:VOLT:CENT Format SOURce:VOLTage:CENTer SOURce:VOLTage:CENTer? Description Sets the center value in the oscillator voltage level sweep range. In addition, use the SOUR:VOLT:SPAN command to set the span value of the sweep range. 17.
GPIB Command Reference SOUR:VOLT:LIM:OFFS SOUR:VOLT:LIM:OFFS Format SOURce:VOLTage:LIMit:OFFSet SOURce:VOLTage:LIMit:OFFSet? Description Sets the maximum value of the dc bias voltage limit when the dc bias output mode is set to current sweep mode or fixed current source mode. This command is available when Option 001 (dc bias function) is installed.
GPIB Command Reference SOUR:VOLT:MODE SOUR:VOLT:MODE Format SOURce:VOLTage:MODE {FIXed|SWEep} SOURce:VOLTage:MODE? Description Selects the oscillator voltage level mode. Parameters 17. GPIB Command Reference Description Query response FIXed (Default) Specifies the fixed voltage mode. SWEep Specifies the voltage sweep mode.
GPIB Command Reference SOUR:VOLT:OFFS SOUR:VOLT:OFFS Format SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet? Description Sets the dc bias voltage level in the fixed voltage source mode. This command can be used when Option 001 (dc bias function) is installed.
GPIB Command Reference SOUR:VOLT:OFFS:CENT SOUR:VOLT:OFFS:CENT Format SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet:CENTer SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet:CENTer? Description Sets the center value in the dc bias voltage sweep range. This command can be used when Option 001 (dc bias function) is installed.
GPIB Command Reference SOUR:VOLT:OFFS:SPAN SOUR:VOLT:OFFS:SPAN Format SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet:SPAN SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet:SPAN? Description Sets the span value in the dc bias voltage sweep range. This command can be used when Option 001 (dc bias function) is installed. In addition, use the SOUR:VOLT:OFFS:CENT command to set the center value of the sweep range.
GPIB Command Reference SOUR:VOLT:OFFS:STAR SOUR:VOLT:OFFS:STAR Format SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STARt SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STARt? Description Sets the start value in the dc bias voltage sweep range. This command can be used when Option 001 (dc bias function) is installed. 17. GPIB Command Reference In addition, use the SOUR:VOLT:OFFS:STOP command to set the stop value of the sweep range.
GPIB Command Reference SOUR:VOLT:OFFS:STAT SOUR:VOLT:OFFS:STAT Format SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STATe {ON|OFF|1|0} SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STATe? Description Turns on/off the dc bias output in the voltage sweep mode or fixed voltage source mode. This command can be used when Option 001 (dc bias function) is installed. Parameters Description ON or 1 Turn on the dc bias output.*1 OFF or 0 (Default) Turn off the dc bias output. *1.
GPIB Command Reference SOUR:VOLT:OFFS:STOP SOUR:VOLT:OFFS:STOP Format SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STOP SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]:OFFSet:STOP? Description Sets the stop value in the dc bias voltage sweep range. This command can be used when Option 001 (dc bias function) is installed. 17. GPIB Command Reference In addition, use the SOUR:VOLT:OFFS:STAR command to set the start value in the sweep range.
GPIB Command Reference SOUR:VOLT:SPAN SOUR:VOLT:SPAN Format SOURce:VOLTage:SPAN SOURce:VOLTage:SPAN? Description Sets the span value in the oscillator voltage level sweep range. In addition, use the SOUR:VOLT:CENT command to set the center value of the sweep range. Parameters Description Span value in the sweep range Data type Floating point Range 0 to 497E-3 Default 200.
GPIB Command Reference SOUR:VOLT:STAR SOUR:VOLT:STAR Format SOURce:VOLTage:STARt SOURce:VOLTage:STARt? Description Sets the start value in the oscillator voltage level sweep range. In addition, use the SOUR:VOLT:STOP command to set the stop value in the sweep range. 17.
GPIB Command Reference SOUR:VOLT:STOP SOUR:VOLT:STOP Format SOURce:VOLTage:STOP SOURce:VOLTage:STOP? Description Sets the stop value in the oscillator voltage level sweep range. In addition, use the SOUR:VOLT:STAR command to set the start value in the sweep range.
GPIB Command Reference STAT:OPER? STAT:OPER? Format STATus:OPERation[:EVENt]? Description Returns the value of the Operation Status Event register. (Query only) See Figure B-3, “Status Register Structure (1/2),” on page 561, for details of the status register structure. Query response {numeric}<^END> Returns the integer value. Related commands *CLS command on page 279 Front Panel Equivalents Unavailable.
GPIB Command Reference STAT:OPER:ENAB STAT:OPER:ENAB Format STATus:OPERation:ENABle STATus:OPERation:ENABle? Description Sets the value of the Operation Status Enable register. See Figure B-3, “Status Register Structure (1/2),” on page 561, for details of the status register structure.
GPIB Command Reference STAT:OPER:NTR STAT:OPER:NTR Format STATus:OPERation:NTRansition STATus:OPERation:NTRansition? Description Sets the value of the negative transition filter of the Operation Status register. See Figure B-3, “Status Register Structure (1/2),” on page 561, for details of the status register structure. 17.
GPIB Command Reference STAT:OPER:PTR STAT:OPER:PTR Format STATus:OPERation:PTRansition STATus:OPERation:PTRansition? Description Sets the value of the positive transition filter of the Operation Status register. See Figure B-3, “Status Register Structure (1/2),” on page 561, for details of the status register structure.
GPIB Command Reference STAT:PRES STAT:PRES Format STATus:PRESet Description Initializes the Operation Status and the Questionable Status. (No query) Front Panel Equivalents Unavailable. Format STATus:QUEStionable[:EVENt]? Description Returns the value of the Questionable Status Event register. (Query only) 17. GPIB Command Reference STAT:QUES? See Figure B-3, “Status Register Structure (1/2),” on page 561, for details of the status register structure.
GPIB Command Reference STAT:QUES:ENAB STAT:QUES:ENAB Format STATus:QUEStionable:ENABle STATus:QUEStionable:ENABle? Description Sets the value of the Questionable Status Enable register. See Figure B-3, “Status Register Structure (1/2),” on page 561, for details of the status register structure.
GPIB Command Reference STAT:QUES:HARD? STAT:QUES:HARD? Format STATus:QUEStionable:HARDware[:EVENt]? Description Returns the value of the Questionable Status Hardware Event register. (Query only) See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure. Query response {numeric}<^END> Returns the integer value. Related commands *CLS command on page 279 Front Panel Equivalents Unavailable.
GPIB Command Reference STAT:QUES:HARD:ENAB STAT:QUES:HARD:ENAB Format STATus:QUEStionable:HARDware:ENABle STATus:QUEStionable:HARDware:ENABle? Description Sets the value of the Questionable Status Hardware Enable register. See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure.
GPIB Command Reference STAT:QUES:HARD:NTR STAT:QUES:HARD:NTR Format STATus:QUEStionable:HARDware:NTRansition STATus:QUEStionable:HARDware:NTRansition? Description Sets the value of the negative transition filter of the Questionable Status Hardware register. See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure. 17.
GPIB Command Reference STAT:QUES:HARD:PTR STAT:QUES:HARD:PTR Format STATus:QUEStionable:HARDware:PTRansition STATus:QUEStionable:HARDware:PTRansition? Description Sets the value of the positive transition filter of the Questionable Status Hardware register. See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure.
GPIB Command Reference STAT:QUES:LIM? STAT:QUES:LIM? Format STATus:QUEStionable:LIMit[:EVENt]? Description Returns the value of the Questionable Status Limit Event register. (Query only) See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure. Query response {numeric}<^END> Returns the integer value. Related commands *CLS command on page 279 Front Panel Equivalents Unavailable.
GPIB Command Reference STAT:QUES:LIM:ENAB STAT:QUES:LIM:ENAB Format STATus:QUEStionable:LIMit:ENABle STATus:QUEStionable:LIMit:ENABle? Description Sets the value of the Questionable Status Limit Enable register. See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure.
GPIB Command Reference STAT:QUES:LIM:NTR STAT:QUES:LIM:NTR Format STATus:QUEStionable:LIMit:NTRansition STATus:QUEStionable:LIMit:NTRansition? Description Sets the value of the negative transition filter of the Questionable Status Limit register. See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure. 17.
GPIB Command Reference STAT:QUES:LIM:PTR STAT:QUES:LIM:PTR Format STATus:QUEStionable:LIMit:PTRansition STATus:QUEStionable:LIMit:PTRansition? Description Sets the value of the positive transition filter of the Questionable Status Limit register. See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure.
GPIB Command Reference STAT:QUES:NTR STAT:QUES:NTR Format STATus:QUEStionable:NTRansition STATus:QUEStionable:NTRansition? Description Sets the value of the negative transition filter of the Questionable Status register. See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure. 17.
GPIB Command Reference STAT:QUES:PTR STAT:QUES:PTR Format STATus:QUEStionable:PTRansition STATus:QUEStionable:PTRansition? Description Sets the value of the positive transition filter of the Questionable Status register. See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure.
GPIB Command Reference STAT:QUES:SEAR:COND? STAT:QUES:SEAR:COND? Format STATus:QUEStionable:SEARch:CONDition? Description Returns the value of the Questionable Status Search Condition register. (Query only) See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure. {0}<^END> 17. GPIB Command Reference Query response Returns 0 for all query. Front Panel Equivalents Unavailable.
GPIB Command Reference STAT:QUES:SEAR:NTR STAT:QUES:SEAR:NTR Format STATus:QUEStionable:SEARch:NTRansition STATus:QUEStionable:SEARch:NTRansition? Description Sets the value of the negative transition filter of the Questionable Status Search register. See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure.
GPIB Command Reference STAT:QUES:SEAR:PTR STAT:QUES:SEAR:PTR Format STATus:QUEStionable:SEARch:PTRansition STATus:QUEStionable:SEARch:PTRansition? Description Sets the value of the positive transition filter of the Questionable Status Search register. See Figure B-4, “Status Register Structure (2/2),” on page 562, for details of the status register structure. 17.
GPIB Command Reference SWE:DIR SWE:DIR Format [SENSe:]SWEep:DIRection {UP|DOWN} [SENSe:]SWEep:DIRection? Description Selects the direction of the sweep. Parameters Description UP (Default) Specifies the direction toward the increasing stimulus value. DOWN Specifies the direction toward the decreasing stimulus value. Query response {UP|DOWN}<^END> Front Panel Equivalents Stimulus - Sweep Setup...
GPIB Command Reference SWE:DWEL2 SWE:DWEL2 Format [SENSe:]SWEep:DWELl2 [SENSe:]SWEep:DWELl2? Description Sets the delay time for each measurement point. In addition, when automatic sweep time is set to auto with the SWE:TIME:AUTO command, the delay time is reset to 0 second. 17.
GPIB Command Reference SWE:DWEL3 SWE:DWEL3 Format [SENSe:]SWEep:DWELl3 [SENSe:]SWEep:DWELl3? Description Sets the delay time for each segment in the segment sweep mode. In addition, when automatic sweep time is set to auto with the SWE:TIME:AUTO command, the delay time is reset to 0 second.
GPIB Command Reference SWE:POIN SWE:POIN Format [SENSe:]SWEep:POINts [SENSe:]SWEep:POINts? Description Sets the number of points measured at each sweep. Parameters 17. GPIB Command Reference Description Number of points Data type Integer Range 2 to 801 Default 201 If the specified parameter is outside the range, the minimum (if the lower limit of the range is exceeded) or maximum value (if the upper limit is exceeded) will be assumed.
GPIB Command Reference SWE:STIM{1-4}? SWE:STIM{1-4}? Format [SENSe:]SWEep:STIMulus{1-4}? Description Reads the stimulus value at all measurement points. (Query only) Parameters Sub-block Description STIMulus1 Specifies the stimulus value at the frequency sweep. STIMulus2 Specifies the stimulus value at the oscillator level sweep. STIMulus3*1 Specifies the stimulus value at the dc bias voltage sweep. STIMulus4*1 Specifies the stimulus value at the dc bias current sweep. *1.
GPIB Command Reference SWE:TIME SWE:TIME Format [SENSe:]SWEep:TIME [SENSe:]SWEep:TIME? Description Sets the sweep time. Parameters 17. GPIB Command Reference Description Sweep time Data type Floating point Range 0 to approximately. (Nop × 20) Default 1.45 Resolution 1E-4 Unit s (seconds) If the specified parameter is outside the range, the minimum (if the lower limit of the range is exceeded) or maximum value (if the upper limit is exceeded) will be assumed.
GPIB Command Reference SWE:TIME:AUTO SWE:TIME:AUTO Format [SENSe:]SWEep:TIME:AUTO {ON|OFF|1|0} [SENSe:]SWEep:TIME:AUTO? Description Selects the automatic sweep time either by auto setting or by manual setting. Parameters Description ON or 1 (Default) Specifies the auto setting*1. OFF or 0 Specifies the manual setting*2. *1.The shortest sweep time is set of the present setting of E4991A. *2.By using the SWE:TIME command, sets the sweep time.
GPIB Command Reference SWE:TYPE SWE:TYPE Format [SENSe:]SWEep:TYPE {LINear|LOGarithmic|SEGMent|POWer|DCV|DCI} [SENSe:]SWEep:TYPE? Description Selects the sweep parameter (sweep type). Parameters 17. GPIB Command Reference Description LINear (Default) Specifies the frequency sweep (linear sweep). LOGaritmic Specifies the frequency sweep (log sweep). SEGMent*1 Specifies the frequency sweep (segment sweep). POWer Specifies the oscillator level sweep (linear sweep).
GPIB Command Reference SYST:BEEP SYST:BEEP Format SYSTem:BEEPer[:IMMediate] Description Produces a beep sound. (No query) Front Panel Equivalents Unavailable. SYST:BEEP:STAT Format SYSTem:BEEPer:STATe {ON|OFF|1|0} SYSTem:BEEPer:STATe? Description Turns on/off the beep output. Parameters Description ON or 1 (Default) Enables the beep sound. OFF or 0 Disables the beep sound. Query response {1|0}<^END> Front Panel Equivalents System - System...
GPIB Command Reference SYST:DATE SYST:DATE Format SYSTem:DATE ,, SYSTem:DATE? Description Sets date. Parameters 17. GPIB Command Reference Description year month day Data type Integer Integer Integer Range 1980 to 2099 1 to 12 1 to 31 When the specified parameter is not within the valid configuration range, an error will occur and the command will be ignored.
GPIB Command Reference SYST:ERR:COUN? SYST:ERR:COUN? Format SYSTem:ERRor:COUNt? Description Returns number of errors stored in the error cue. (Query only) Query response {numeric}<^END> Returns the integer value. Related commands SYST:ERR? command on page 517 Front Panel Equivalents Unavailable. SYST:EXTR? Format SYSTem:EXTRef? Description Returns whether an external reference signal is being received from the external reference signal input connector located in the rear panel.
GPIB Command Reference SYST:IND:POIN:SET SYST:IND:POIN:SET Format SYSTem:INDex:POINt:SET SYSTem:INDex:POINt:SET? Description Sets the timing of the measurement index signal for every measurement point. Query response {1|0}<^END> 17. GPIB Command Reference Description 1 The timing of the measurement index signal for every measurement is being selected. 0 (Default) The timing of the measurement index signal for every measurement is not being selected.
GPIB Command Reference SYST:IND:TIME SYST:IND:TIME Format SYSTem:INDex:TIME SYSTem:INDex:TIME? Description Sets the amount of time between internal measurement and trace display when setting the timing of the measurement index signal. Parameters Query response Description Timing of the measurement index signal Data type Floating point Range 0.001 to 5 Default 0.3 Resolution 0.
GPIB Command Reference SYST:IND:TIME:SET SYST:IND:TIME:SET Format SYSTem:INDex:TIME:SET SYSTem:INDex:TIME:SET? Allows the user to set the amount of time between internal measurement and trace display when setting the timing of the measurement index signal. Query response {1|0}<^END> Description 1(Default) The timing of the measurement index signal is being selected. 0 The timing of the measurement index signal is not being selected.
GPIB Command Reference SYST:KLOC SYST:KLOC Format SYSTem:KLOCk[:FPANel] {ON|OFF|1|0} SYSTem:KLOCk[:FPANel]? Description Specifies whether to lock the front panel key, rotary knob, and the keyboard. The specifications of this command are identical to the SYST:KLOC:KBD command.
GPIB Command Reference SYST:KLOC:MOUS SYST:KLOC:MOUS Format SYSTem:KLOCk:MOUSe {ON|OFF|1|0} SYSTem:KLOCk:MOUSe? Description Specifies whether to lock the mouse. Parameters 17. GPIB Command Reference Description Query response ON or 1 Mouse locked OFF or 0 (Default) Mouse unlocked {1|0}<^END> Related commands SYST:KLOC command on page 522 SYST:KLOC:KBD command on page 522 Front Panel Equivalents Unavailable. SYST:POFF Format SYSTem:POFF Description Turns E4991A's main power off.
GPIB Command Reference SYST:TIME SYST:TIME Format SYSTem:TIME ,, SYSTem:TIME? Description Sets time of internal clock. Parameters Description hour (24 hour format) minute second Data type Integer Integer Integer Range 0 to 23 0 to 59 0 to 59 When the specified parameter is not within the valid configuration range, an error will occur and the command will be ignored.
GPIB Command Reference TRIG TRIG TRIGger[:SEQuence][:IMMediate] Description The trigger system immediately triggers and executes measurements during the trigger event detection state. An error will occur if the trigger sequence is not in the trigger event detection state. (No query) Front Panel Equivalents Unavailable. 17.
GPIB Command Reference TRIG:SLOP TRIG:SLOP Format TRIGger[:SEQuence]:SLOPe {POSitive|NEGative} TRIGger[:SEQuence]:SLOPe? Description Selects the polarity of the trigger signal that is to be received by the external trigger input connector, located on the rear panel. When set to positive, a trigger is executed when the signal changes from a low level to a high level. When set to negative, a trigger is executed by the opposite signal level change direction.
18. COM Interface Reference 18 COM Interface Reference This chapter gives COM interface references of the Agilent E4991A classified according to object.
COM Interface Reference Conventions of COM Interface Conventions of COM Interface Explanation The section titled “Explanation” describes the method of controlling the E4991A with the COM interface. VB Syntax The section titled “VB Syntax” describes the format to use for writing programs in Visual Basic. Parameter The section titled “Parameter” describes the parameters required for the methods of COM object.
COM Interface Reference Conventions of COM Interface Data type String (BSTR) Name String type Memory requirement 1 byte/character (alphanumeric) Range • Fixed-length character Declaration of the number of characters is required.
COM Interface Reference Application object Application object This section explains Application object. Name property Explanation Reads application name (Read only). VB syntax Application.Name or Name Response Reading in string type. Always “E4991A”. Examples The following is a program example of reading the application name and displaying it in the message box. Example 18-1 Example of using Name property Dim Name As String Name = Application.
COM Interface Reference Application object Connection property Explanation Reads whether a personal computer is connected to the E4991A by using the E4991A remote user interface function. When this COM object is executed by the installed E4991A VBA, it will always read 1. (Read only) VB syntax Application.Connection or Connection Response Value of long integer type (1 or 0) is sent back.
COM Interface Reference Application object SingleMeasure method Explanation Executes sweep under current setting once and waits for the completion of the sweep. If sweep averaging is enabled, sweep is performed the same number of times as that of the sweep averaging factor. This method sends a response back. VB syntax Application.SingleMeasure or SingleMeasure Response Value of long integer type (1 or 0) is sent back. 1 Sweep was completed. 0 Sweep was interrupted.
COM Interface Reference Application object CalMeasure method Explanation Measures calibration data (Open/Short/Load/Low-loss capacitor) and waits for the completion of measurement. This method sends a response back. VB syntax Application.CalMeasure(CalType) or CalMeasure(CalType) Parameter Response CalType: To be selected from the following.
COM Interface Reference Application object CompenMeasure method Explanation Measures fixture compensation data (Open/Short) and waits for the completion of measurement. This method sends a response back. VB syntax Application.CompenMeasure(CompenType) or CompenMeasure(CompenType) Parameter Response CompenType: To be select from the following. CompenOpen Specifies measurement of Open compensation data. CompenShort Specifies measurement of Short compensation data.
COM Interface Reference Application object GetTextData method Explanation Copies main setting parameters or measurement data of the E4991A to the clipboard in CSV format in order to paste them into an application like Microsoft Word or Microsoft Excel. This method can be performed by a personal computer that uses the E4991A remote user interface function. VB syntax Application.GetTextData(DataName) or GetTextData(DataName) Parameter DataName: To be selected from the following.
COM Interface Reference Application object WaitForEvent method Explanation Waits for the occurrence of a specified event for the specified period of time. This method sends a response back. VB syntax Application.WaitForEvent(EventName, MaxTime) or WaitForEvent(EventName, MaxTime) Parameter EventName: To be selected from the following events. SweepEnd Specifies the completion of sweep. SweepStart Specifies the start of sweep.
COM Interface Reference Application object SweepEnd event Explanation Indicates specified sweep (measurement) is completed. Parameter SweepMode: To be selected from the following. Measure Specifies sweep Calibration Specifies measurement of calibration data Compensation Specifies measurement of fixture compensation data Examples The following is an example of displaying a message when measurement of calibration data is completed.
COM Interface Reference Application object SweepStart event Explanation Indicates specified sweep (measurement) has started. Parameter SweepMode: To be selected from the following.
COM Interface Reference Application object Unlocked event Explanation Indicates that “PLL Unlock” error was detected in the E4991A. Examples The following is an example of stopping a program by force when a “PLL Unlock” error occurs during measurement. The following program has to be described in user form or class module. Example 18-13 Example of using Unlocked event Public WithEvents Evnt As E4991ALib.
COM Interface Reference Application object RfOverload event Explanation Indicates that “RF overload” error was detected in the E4991A. Examples The following is an example of stopping a program by force when the “RF overload” error occurs during measurement. The following program has to be described in user form or class module. Example 18-15 Example of using RfOverload event Public WithEvents Evnt As E4991ALib.
COM Interface Reference SCPI object SCPI object This section explains details of the SCPI object. Name property Explanation Reads object name "SCPI" (Read only) VB syntax Application.SCPI.Name or SCPI.Name Reading in string type. Always "SCPI". Examples The following is a program example of reading the object name and displaying it in the message box. Example 18-16 Example of using Name property 18. COM Interface Reference Response Dim Name As String Name = Application.SCPI.
COM Interface Reference SCPI object Enter method Explanation Reads the returned value of an E4991A GPIB command executed by Query using the Output method. VB syntax Application.SCPI.Enter(Res,[fmt]) or SCPI.Enter(Res,[fmt]) Parameter fmt: Specifies option parameters. The method of reading data can be specified by the following option parameters. # Receives data divided by comma (,). * Skips data and clears one data item in the queue.
COM Interface Reference SCPI object Output method Explanation Executes a GPIB command of the E4991A. VB syntax Application.SCPI.Output(Cmd) or SCPI.Output(Cmd) Parameter Cmd: Specifies GPIB command by enclosing it within double quotation marks (“”) in the form of a string. Examples The following is a program example of using the Output method. Example 18-18 Example of using Output method Application.SCPI.Output "DISP:TRAC1 ON" Application.SCPI.
COM Interface Reference How to read array data How to read array data In the case of using the Output method to send GPIB commands with “?”, the returned values are built up in the queue provided in the E4991A main body. The Enter method is the object used to read data from that queue. If the data is a single data item that is not divided with commas (,), it can be read as is.
COM Interface Reference How to read array data • Example 18-21 When the data type is string: No specification of option parameters Assume there are returned values ("Agilent, E4991A, 113,1.0") from "SCPI.Output "*IDN?" kept in the queue. Dim Val as String SCPI.Output "*IDN?" SCPI.Enter Val If "SCPI.Enter Val" is executed here, the entire data is read as one string and substituted into Val (Val = "Agilent, E4991A, 113,1.0"). At this point, the queue becomes empty.
COM Interface Reference How to read array data Specifying option parameters When the Enter method is executed while specifying option parameters, it becomes possible to read the data divided with commas (,) in the required form. Aim: Reading the “n”th data • Example 18-23 When the data type is numeric: Specifying option parameters “*” and “#” Assume there are returned values ("1,2,3,4") of "SCPI.Output "DATA:RAW?" kept in the queue. The method to read the 3rd data item and empty the queue is as follows.
COM Interface Reference How to read array data • Example 18-24 When the data type is string: Specifying option parameters “*” and “#” Assume there are returned values ("Agilent, E4991A, 113,1.0") from "SCPI.Output "*IDN?" kept in the queue. The method used to read the 2nd data item ("E4991A") divided with commas (,) and empty the queue is as follows. Dim Val as String SCPI.Output "*IDN?" SCPI.Enter Val, "#" SCPI.Enter Val, "#" SCPI.Enter Val, "*" When "SCPI.
COM Interface Reference How to read array data Aim: Skipping data and emptying the queue Basically, regardless of the specified data type of the variable, specifying only "*" as the option parameter and executing the command with the Enter method cancels all of the data, and the queue becomes empty. • Example 18-26 When the data type is numeric: Specifying option parameter “*” only Assume there are returned values ("1,2,3,4") of "SCPI.Output "DATA:RAW?" kept in the queue. Dim Dummy as Double SCPI.
A. Manual Changes A Manual Changes This appendix contains the information required to adapt this manual to versions or configurations of the Agilent E4991A manufactured earlier than the current printing date of this manual. The information contained elsewhere in this manual applies directly to E4991A units bearing the serial number printed on this manual’s title page.
Manual Changes Manual Changes Manual Changes To adapt this manual to your E4991A, refer to Table A-1 and Table A-2. Table A-1 Table A-2 Manual Changes by Serial Number Serial Prefix or Number Make Manual Changes JP2KH or MY432 Change1 JP1KH, JP2KH or MY432 Change 2 Manual Changes by Firmware Version Version Make Manual Changes Agilent Technologies uses a two-part, ten-character serial number that is stamped on the serial number plate (Figure A-1).
Manual Changes Manual Changes An outline of a remote control system using the macro functions is shown in ê} A-2. Figure A-2 Structure example of GPIB remote control system Required equipment 1. The Agilent E4991A RF Impedance/Material Analyzer and the accessories required to measure a DUT When using macro functions to control the E4991A, it is not necessary to select the system-controller mode or the addressable-only mode of the GPIB system.
Manual Changes Manual Changes information on the basics of E4991A VBA programming, standard control, and functions. Change 2 Outline of GPIB remote control system This section explains the system structures and required equipment for sending GPIB command messages. In Chapter 17, you can also find more on the GPIB commands used to control the E4991A from an external computer through the GPIB interface. System structure Connect the E4991A to an external computer and peripheral equipment with a GPIB cable.
Manual Changes Manual Changes Required Equipment 1. The Agilent E4991A RF Impedance/Material Analyzer and the accessories required to measure a DUT When using an external computer as the system controller, it is necessary to set the E4991A in addressable-only mode and set the GPIB address as required. This setting is made by the following front panel operation. a. Set the E4991A in addressable-only mode. System - GPIB Setup... - Control Mode [Addressable Only] b. Set the GPIB address of the E4991A.
Manual Changes Manual Changes 554 Appendix A
B GPIB Status Report System B. GPIB Status Report System This appendix describes the status report system in the Agilent E4991A GPIB system.
GPIB Status Report System General Model of Status Registers General Model of Status Registers The E4991A has a status report system that notifies users of its states. Figure B-1 General Model of Status Registers The status report system has a hierarchical structure as shown in Figure B-1. When the instrument meets a certain condition, the corresponding bit in the appropriate event register is set to 1. By monitoring event registers, users can grasp the state of the instrument.
GPIB Status Report System General Model of Status Registers Event Registers The bits in an event register reflect corresponding the E4991A states such as event occurrence. These bits are used to constantly monitor the E4991A state changes, and if a certain condition defined for each bit is met, the corresponding bit is changed to 1. Note that no GPIB command can change the status of event register bits. The E4991A has the following types of event registers.
GPIB Status Report System General Model of Status Registers Status Byte Register When an event register bit enabled by the corresponding enable register bit is set to 1, the corresponding summary bit in the Status Byte Register is also set to 1. In addition to the summary bit for the event register, the Status Event Register has a bit indicating the status of the output queue and a bit indicating SRQ status.
GPIB Status Report System General Model of Status Registers Transition Filter and Condition Register The E4991A status transition filter allows the user to select the transition direction of a bit’s status in the status register, which sets the bit in the event register. If the status register has transition filters, a lower level register called “condition register” exists under the event register. The transition filer lies between the event register and the condition register.
GPIB Status Report System Status Register Structure Status Register Structure Status registers have the structure shown in Figure B-3 and Figure B-4. The Status Byte Register has summary bits for the registers in the lower level. This section explains each layer in the E4991A’s status register structure. For details on each bit in each status register, see Table B-1 to Table B-7.
GPIB Status Report System Status Register Structure Figure B-3 Status Register Structure (1/2) B.
GPIB Status Report System Status Register Structure Figure B-4 Status Register Structure (2/2) 562 Appendix B
GPIB Status Report System Status Register Structure Table B-1 Status Bit Definition of Status Byte Register Bit position 0-1 Name Description Not used Always 0. 2 Error/Event Queue Set to 1 when the error/event queue contains data; reset to 0 when all of the data has been retrieved. 3 Questionable Status Register Summary Bit Set to 1 when one of the enabled bits in the Questionable Status Register is set to 1.
GPIB Status Report System Status Register Structure Table B-2 Status Bit Definition of Standard Event Status Register Bit position Name Description 0 Operation Compete bit Set to 1 upon completion of all operations done by commands that proceed the *OPC? command. 1 Not used Always 0. 2 Query Error Bit 1. Set to 1 when the E4991A has no transferred data in the output queue in spite of a Query request. 2.
GPIB Status Report System Status Register Structure Table B-3 Status Bit Definition of Operation Status Event Register Bit position 0 Name Description Calibrating Set to 1 when the E4991A is measuring calibration data. When measurement is completed, this bit is set to 0. 1-2 Not used Always 0. 3 Sweeping Set to 1 when the E4991A is sweeping. When sweep is completed, this bit is set to 0. 4 Measuring Set to 1 when the E4991A is measuring. When measurement is completed, this bit is set to 0.
GPIB Status Report System Status Register Structure Table B-5 Status Bit Definition of Questionable Status Hardware Event Register Bit position Name Description 0 Not used Always 0. 1 PLL Unlocked Set to 1 when an unlocked phase lock loop has been detected in the E4991A. 2 DC Bias Overload Set to 1 when dc bias current exceeding the maximum current limit is supplied or dc bias voltage exceeding the maximum voltage limit is detected.
GPIB Status Report System Status Register Structure Table B-7 Status Bit Definition of Questionable Status Search Event Register Bit position Name Description 0 Not used Always 0. 1 Trace 1: Marker Search Fail Set to 1 when the marker search has failed in trace 1. 2 Trace 2: Marker Search Fail Set to 1 when the marker search has failed in trace 2. 3 Trace 3: Marker Search Fail Set to 1 when the marker search has failed in trace 3.
GPIB Status Report System Status Register Structure 568 Appendix B
C. GPIB Command List By Function C GPIB Command List By Function This appendix lists the Agilent E4991A GPIB commands according to function.
GPIB Command List By Function GPIB Command List By Function GPIB Command List By Function Function Measurement Conditions Item to be set or executed Preset GPIB command Turns off the continuous activation of the trigger system. *RST on page 282 Turns on the continuous activation of the trigger system. SYST:PRES on page 523 Selects measurement mode (Impedance/Dielectric/Magnetic measurement).
Function Measurement conditions Item to be set or executed Sweep dc bias current sweep range (Option 001) Start/stop Center/span dc bias voltage sweep range (Option 001) GPIB command SOUR:CURR:OFFS:STAT on page 465 On/Off Start value SOUR:CURR:OFFS:STAR on page 464 Stop value SOUR:CURR:OFFS:STOP on page 466 Center value SOUR:CURR:OFFS:CENT on page 462 Span value SOUR:CURR:OFFS:SPAN on page 463 Maximum voltage limit SOUR:VOLT:LIM:OFFS on page 478 On/Off SOUR:VOLT:OFFS:STAT on page 484 Star
GPIB Command List By Function GPIB Command List By Function Function Measurement conditions Item to be set or executed Only Segment sweep Segment sweep table GPIB command Add segment. SEGM:COUN on page 397 Delete all segments. SEGM:DEL:ALL on page 406 Number of Setting measurement Read total points number.
Function Item to be set or executed Display screen Entire view DISP:ENAB on page 354 Text display screen On/Off DISP:TEXT on page 355 Selection DISP:TEXT{1-3}:SET on page 356 Selects window format (Split window or Overlay). DISP:FORM on page 355 Turns on/off the backlight. DISP:BACK on page 354 Sets when display is refreshed Trace GPIB command Enable/Disable display update. Refreshed for each sweep. SYST:IND:SWE:SET on page 519 Refreshed for each measurement point.
GPIB Command List By Function GPIB Command List By Function Function Item to be set or executed Display screen Scale GPIB command Selects trace to be displayed (Data/Memory/Couple).
Function Calibration Item to be set or executed Calibration kit SENS:CORR1:CKIT on page 420 Defines standard value by user. Turns on/off list setting function. SENS:CORR1:CKIT:LIST on page 421 Defines impedance value using list setting.
GPIB Command List By Function GPIB Command List By Function Function Fixture compensation Item to be set or executed Fixture compensation Defines standard value kit by user. GPIB command Turns on/off list setting function. SENS:CORR2:CKIT:LIST on page 440 Sets impedance value using list setting.
Function Marker Item to be set or executed GPIB command Turns off all makers. CALC{1-5}:MARK:AOFF on page 305 Turns on/off marker coupling function. CALC:MARK:COUP on page 309 Movement mode (Continuous/Discrete) CALC{1-5}:MARK:DISC on page 309 Objective trace selection (Data trace/Memory trace) CALC{1-5}:MARK:ON on page 327 Marker 1-8 On/Off CALC{1-5}:MARK{1-8} on page 304 Sets to active marker. CALC{1-5}:MARK{1-8}:ACT on page 305 Sets/reads stimulus value.
GPIB Command List By Function GPIB Command List By Function Function Marker search function Item to be set or executed Search definition/range Partial search function GPIB command On/Off CALC{1-5}:MARK:FUNC:DOM on page 312 Sets active marker position to left boarder line. CALC{1-5}:MARK:FUNC:DOM:ST AR on page 320 Sets active marker position to right boarder line. CALC{1-5}:MARK:FUNC:DOM:ST OP on page 320 Range between reference marker and active marker.
Function Read and write data Item to be set or executed Data transfer Data array GPIB command FORM:DATA on page 374 Selects format Sets byte order during binary transfer. FORM:BORD on page 373 Calibration Reads calibration data array. DATA:CAD{1-8}? on page 345 Reads/Writes calibration coefficient array. DATA:CCO{1-6} on page 346 Reads fixture compensation data array.
GPIB Command List By Function GPIB Command List By Function Function Macro Status report system Item to be set or executed PROG:CAT? on page 394 Defines the macro name. PROG:NAME on page 394 Sets the macro status. PROG:STAT on page 395 Waits until the macro reaches the stop condition. PROG:WAIT on page 395 Clears register. *CLS on page 279 Reads Status Byte Register. *STB? on page 283 Sets Service Request Enable Register. *SRE on page 283 Standard Event Status Reads register value.
Function Keyboard and Mouse Product information Error message Others Item to be set or executed GPIB command Enables/Disables front panel and keyboard operations. SYST:KLOC:KBD on page 522 SYST:KLOC on page 522 Enables/Disables mouse operations. SYST:KLOC:MOUS on page 523 Powers off E4991A SYST:POFF on page 523 Reads manufacturer, model number, serial number, and firmware version. *IDN? on page 281 Reads option number. *OPT? on page 282 Reads SCPI version.
GPIB Command List By Function GPIB Command List By Function 582 Appendix C
D. Table of corresponding 4291B vs. E4991A GPIB commands D Table of corresponding 4291B vs. E4991A GPIB commands This appendix lists each Agilent E4991A GPIB command along with its corresponding Agilent 4291B GPIB command. Note that the simple commands prepared for the 4291B do not have equivalent E4991A commands.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands Table of Corresponding GPIB Commands ABORt: 4291B feature Reset the trigger system and place all trigger sequences in the idle state. 4291B GPIB command E4991A GPIB command ABOR on page 286 ABOR CALCulate subsystem: 4291B feature 4291B GPIB command E4991A GPIB command Sets the partial search of the marker search function ON CALC:EVAL:BAND:FULL or OFF.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature 4291B GPIB command E4991A GPIB command Sets the threshold ON or OFF. CALC:EVAL:PEAK:THR:STAT None (Cannot set the threshold of the peak search function.) Selects a format to read out the value of a Smith, polar, or admittance chart using markers. CALC:EVAL:R:FORM CALC{4-5}:MARK:FORM on page 310 Returns the Δ marker value. CALC:EVAL:REF:DATA? Combines the following commands to execute. D.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature 4291B GPIB command E4991A GPIB command Moves the marker to the peak to the right of the present marker position. CALC:EVAL:Y:XPOS:RPE Combines the following commands to execute. Moves the marker to the next occurrence of the target value to the right of the present marker position.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature Sets the lower limit value for the segment. 4291B GPIB command CALC:LIM:SEGM:LOW E4991A GPIB command Sets using the following commands. CALC{1-5}:MARK{1-8}:FUNC:DO M:LIM:LOW on page 316 CALC{1-5}:MARK:REF:FUNC:DO M:LIM:LOW on page 330 CALC:LIM:SEGM:MIDD None (Cannot set the limit with the central value and delta value.) Terminates a limit segment definition.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature 4291B GPIB command E4991A GPIB command Sends the compensation coefficient arrays. DATA CMP{1-3} DATA:CMP{1-3} on page 348 Returns the compensation coefficient arrays. DATA? CMP{1-3} In addition, it is possible to send/read the array for each segment if the following command is used. DATA:SEGM{1-16}:CMP{1-3} on page 353 Sends the data array. DATA DATA Returns the data array.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature Returns the limit test result of the fail points. 4291B GPIB command DATA? LFA E4991A GPIB command Combines the following commands in execution.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature Returns the number of the limit test fail points. 4291B GPIB command DATA:POIN? LFA E4991A GPIB command None However, it is possible to specify a marker to read pass/fail by using the following commands.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature Sets the string to the following display area. 4291B GPIB command DISP:TEXT{10-38} E4991A GPIB command Combines the following commands in execution. DISP:TRAC{1-5}:TITL:DATA on page 361 DISP:TRAC{1-5}:TITL on page 360 DISP:TEXT{11-30}:LOC None (Display area of trace title is fixed.) Selects a page of a tabular list. DISP:TEXT{1-8}:PAGE DISP:TEXT{1-3}:SET on page 356 Displays a tabular list.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature 4291B GPIB command E4991A GPIB command Defines the bottom border of the display and adjusts the DISP:TRAC{1-21}:Y:BOTT scale value. DISP:TRAC{1-3}:Y:BOTT on page 365 Couples or uncouples the DATA and MEMORY traces to be scaled. DISP:TRAC{1-21}:Y:COUP DISP:TRAC{1-5}:Y:FOR on page 366 Sets the response value scale per graticule trace.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands INSTrument subsystem: 4291B feature Selects the active channel. 4291B GPIB command INST {CH1|CH2} E4991A GPIB command None (No concept of channel.) With the E4991A, uses the following command when the trace is set to active trace. DISP:TRAC{1-5}:SEL on page 358 INST:COUP None (No concept of channel.) Selects the active channel. INST:NSEL None (No concept of channel.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature Save data arrays that are defined by the MMEMory:STORe:ITEM:TRACe subsystem commands. 4291B GPIB command MMEM:STOR:TRAC E4991A GPIB command Uses the following format to save in a specified data format. MMEM:STOR:TRAC on page 391 MMEM:STOR:TRAC:ASC on page 391 PROGram subsystem: 4291B feature Returns the defined program name.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature 4291B GPIB command E4991A GPIB command SENS:AVER2:COUN CALC:AVER:COUN on page 290 Turns the sweep averaging factor ON or OFF for the active channel. SENS:AVER2 CALC:AVER on page 289 Sets the calibration kit. SENS:CORR1:CKIT SENS:CORR1:CKIT on page 420 Defines a label of the user-modified calibration kit. SENS:CORR1:CKIT:LAB None Stores the user-modified calibration kit into memory.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature Selects the fixture compensation short standard. 4291B GPIB command SENS:CORR2:CKIT:STAN2 E4991A GPIB command SENS:CORR2:CKIT:LIST on page 440 (However, cannot choose open/short alone.) Enters the inductance value of the LOAD standard that is used in LOAD compensation. SENS:CORR2:CKIT:STAN3:L None (No concept of the load compensation function.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature Sets the frequency span. 4291B GPIB command SENS:FREQ:SPAN E4991A GPIB command FREQ:SPAN on page 377 Sets the frequency span value of the difference between the marker and the delta marker values. CALC{1-5}:MARK:SET on page 336 Sets the frequency span value of the "frequency span × zooming aperture". None (No zooming function for sweep span.) Sets the start frequency value.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature 4291B GPIB command E4991A GPIB command Defines the sweep delay times. SENS:SWE:DWEL2 SWE:DWEL1 on page 508 Sets the automatic or manual point delay time. SENS:SWE:DWEL1:AUTO Sets the automatic or manual sweep delay time. SENS:SWE:DWEL2:AUTO None (Delay value = 0 seconds corresponds to the automatic setting for the 4291B.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature 4291B GPIB command E4991A GPIB command SOUR2:CURR:ALC None (Uses SWE:TYPE on page 515 to set the sweep parameter at DC bias current sweep. In addition, uses SEGM:CURR:OFFS:STAT on page 399 for segment sweep when setting the fixed current source mode and SOUR:CURR:OFFS:STAT on page 465 for settings other than the segment sweep.) Sets the dc bias sweep current center value.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature Sets the dc bias sweep voltage center value. 4291B GPIB command SOUR2:VOLT:CENT E4991A GPIB command SOUR:VOLT:OFFS:CENT on page 481 Sets the OSC voltage level sweep center value to the difference between the marker and the delta marker values. CALC{1-5}:MARK:SET on page 336 Sets the OSC voltage level sweep center value of the marker.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature 4291B GPIB command E4991A GPIB command STAT:OPER:NTR on page 491 Sets the positive transition filter of the Operation Status Register. STAT:OPER:PTR STAT:OPER:PTR on page 492 Presets the Operation and Questionable Status Enable Registers and transition filters. STAT:PRES STAT:PRES on page 493 Queries the contents of the Questionable Status Condition Register.
Table of corresponding 4291B vs. E4991A GPIB commands Table of Corresponding GPIB Commands 4291B feature 4291B GPIB command E4991A GPIB command Inputs data to data/memory trace arrays. TRAC Uses the following command to copy data to the memory trace. Inputs data to user traces. TRAC {TRX{18-21}|TRY{18-21}} None (No concept of user trace.) Outputs each trace’s value at a specified point. TRAC:VAL? None (Cannot specify a measurement point to read a trace value.
E. Complex Operation Program E Complex Operation Programs This appendix shows sample programs for implementing complex operations in Visual Basic and HTBasic.
Complex Operation Programs Complex Operation Programs Complex Operation Programs The following section shows sample code fragments that performs addition, subtraction, multiplication, and division operations. By adding this coding to your program, it can handle addition, subtraction, multiplication, and division operations on complexes.
Complex Operation Programs Complex Operation Programs ` ` Dividing Complex ` Public Function complex_div(a As Complex, b As Complex) As Complex Dim c As Complex Dim de As Double de = b.Re ^ 2 - b.Im ^ 2 c.Re = (a.Re * b.Re + a.Im * b.Im) / de c.Im = (a.Im * b.Re - a.Re * b.Im) / de complex_div = c End Function Sample Implementation in HTBasic The following is a sample program in HTBasic that performs addition, subtraction, multiplication, and division operations on complexes.
Complex Operation Programs Complex Operation Programs 320 SUBEND 330 ! 340 ! Dividing Complex Arrays 350 ! 360 SUB Complex_div(A(*),B(*),C(*),Nop) 370 INTEGER I 380 REAL De 390 FOR I=1 TO Nop 400 De=(B(I,1)^2-B(I,2)^2) 410 IF De=0 THEN Err 420 C(I,1)=(A(I,1)*B(I,1)+A(I,2)*B(I,2))/De 430 C(I,2)=(A(I,2)*B(I,1)-A(I,1)*B(I,2))/De 440 NEXT I 450 GOTO Ext 460 Err: DISP "DIVISION BY 0" 470 Ext: ! 480 SUBEND 604 Appendix E
List of Responses to Measurement Failure This appendix lists the Agilent E4991A’s responses to various types of measurement failure. 605 F.
List of Responses to Measurement Failure Behavior under Abnormal Measurement Conditions Behavior under Abnormal Measurement Conditions This section describes abnormal conditions that may occur during measurement and explains the resulting LCD display and GPIB output and how to cope with them. Table F-1 Event • Overload This situation is detected when an internal circuit is temporally overloaded due to connection or disconnection of a DUT during measurement.
G Messages 607 G. Messages The Agilent E4991A provides error messages as well as messages that indicate the internal operating status of the equipment. This appendix describes such messages in order of error number. To search for E4991A error messages in alphabetical order, please refer to the Operation Manual.
Messages Error number: 0 Messages showing the status of the E4991A are displayed in the lower left of the E4991A LCD screen. The messages include error messages that occur during the execution of GPIB commands and others that indicate the internal status of the equipment. Error messages are indicated following the character string “[Err]”, and can be read out by a GPIB command.
Messages Error number: 10 10 Cal measure aborted One of the following problems has occurred. • During the measurement of necessary calibration/fixture compensation data, or during and after the calculation of calibration/fixture compensation factors (with calibration function turned On), setting for calibration/fixture compensation data acquired points (Fixed, Full Range, Fixed, User Pwr or User Freq & Pwr) has been altered.
Messages Error number: 22 22 printer error Printer did not respond to the control given from the E4991A. Please check whether the printer’s power is On or Off, connection status of cable, or paper supplies. 30 No valid memory trace There was no data stored in the Memory Trace and CALC{1-5}:MATH:FUNC command on page 340 was used to attempt displaying the Memory Trace. Before displaying the Memory Trace, use CALC{1-5}:MATH:MEM command on page 341 to store the data into the Memory Trace.
Messages Error number: 62 62 Can’t execute data examination Even though the data for statistic analysis has been acquired, an attempt has been made to read out the statistic analysis results by changing the setting conditions (such as sweep start rate) and using CALC{1-5}:MST:DATA? command on page 344 before the measurement have been updated. After changing the setting conditions, wait for the measurement to be updated, and then read out the statistic analysis results.
Messages Error number: 79 79 Not available for this format Selected measurement parameter or display format could not be executed. For example, during the Dielectric Measurement Mode or in Magnetic Substance Measurement Mode, DISP:TRAC{1-5}:GRAT:FORM command on page 357 has been used in order to set into unchangeable display format (Smith Chart or Admittance Chart). Select the measurement parameter or display format which are possible to be selected.
Messages Error number: 104 104 Save error During the saving of file, there was an error detected on the media in which the data is to be stored. For example, when saving the file into a floppy disk, the space available in the floppy disk was not sufficient. Check the space available in the media in which the date is to be stored. 105 Recall error During reading out (recall) a file, an error has occurred. For example, a file containing invalid data (such as the extension (.
Messages Error number: 140 140 Not allowed for the current trigger source Invalid command has been sent toward presently selected trigger source. For example, during when the trigger source is set on internal trigger (Internal), TRIG:EVEN command on page 525 is used in attempt to set the trigger event mode (Detecting point for putting trigger) at each and every measurement point (On Point) or at each and every segment (On Segment).
Messages Error number: -100 -100 Command error Error has occurred in which the E4991A could not grammatically specify the error message. It shows that the command error which is defined by the IEEE488.2,5.1.1.4 has occurred -101 Invalid character In the series of error message characters, invalid character has been found.
Messages Error number: -112 -112 Program mnemonic too long The length of header is exceeding than 12 characters. The length of header would here refer to the length of the series of characters that are separated with the use of columns (:). Refer to IEEE488.2,7.6.4.1 for further details. -113 Undefined header Though the grammatical structure does not provide any problems, a command not defined by E4991A has been received.
Messages Error number: -148 to see if the suffix can be added to the numeric data element. -148 Character data not allowed On the position where E4991A would not receive character data element, the character data element (not violate the standard) has been found. For example, when a message; "CALC1:MARK:FUNC:TARG MAX" has been sent toward the correct program message; "CALC1:MARK:FUNC:TARG le-12", the character data element will be regarded by E4991A as invalid.
Messages Error number: -213 Trigger command ("*TRG"), or external trigger signal has been received and detected by E4991A but because of the timing with the E4991A (For example, the E4991A trigger was not in waiting condition), it was ignored. When the trigger becomes the waiting condition, set to prepare for trigger command or external trigger signal to be sent. -213 Init ignored Due to the fact that other measurement was already underway, the Measurement Initialize Request ("INIT" command) was ignored.
Messages Error number: -310 -310 System error On E4991A, either of the following so called "System Error" has occurred. -321 Out of memory Memory (RAM) is in shortage. -400 Query error E4991A has found Query error which is not able to specify the error message. This code shows that Query error defined in IEEE488.2, 11.5.1.1.7 or 6.3 has occurred. -410 Query INTERRPUTED This is a condition to create "INTERRUPTED" Query error. (Refer to IEEE488.1, 6.3.2.
Messages Error number: Messages indicating the internal status of the equipment Messages that indicate the internal status of the equipment include messages indicating irregularities of the equipment as well as those indicating the results of processing (elapsing). These messages do not have numbers.
Messages Error number: Messages indicating the results of processing (elapsing) Cal done Calculation and storing of a calibration coefficient completed. Cal measure aborted Measurement of calibration data aborted. Comp done Calculation and storing of a fixture compensation coefficient completed. Comp measure aborted Measurement of a fixture compensation coefficient aborted. Peak not found Peak search function executed, but defined peak not found.
Messages Error number: 622 Appendix G
Index Index Symbols *.bas, 221 *.bmp, 177 *.dat, 177, 178 *.frm, 221 *.jpg, 177 *.lcr, 177, 178, 221 *.sta, 177, 178 *.txt, 177 A ASCII format, 120 auto scale, 51 Autorec.sta, 178 Autost.
Index recall, 178 save, 177 data trace array, 124 date setting, 517 DC bias application program for DC power supply, 248 application program for DC power supply(external instrument), 251 dc bias current limit maximum value, 49 DC bias current/voltage limitation error, 604 DC bias overload error, 604 in case of segment sweep current limit maximum value, 65 output current level, 65 output voltage level, 65 voltage limit maximum value, 65 monitor function dc bias level monitor array, 124 on/off, 49 output cur
Index Index G GPIB controller mode, 33, 551 system controller pass control, 28 what is GPIB, 26 GPIB command *CLS, 279 *ESE, 280 *ESR?, 280 *IDN?, 281 *OPC, 281 *OPC?, 281 *OPT?, 282 *RST, 282 *SRE, 283 *STB?, 283 *TRG, 284 *TST?, 284 *WAI, 284 [SENSe:]AVERage:COUNt, 288 [SENSe:]AVERage[:STATe], 287 [SENSe:]FREQuency:CENTer, 376 [SENSe:]FREQuency:SPAN, 377 [SENSe:]FREQuency:SPAN:FULL, 377 [SENSe:]FREQuency:STARt, 378 [SENSe:]FREQuency:STOP, 379 [SENSe:]FREQuency[:CW|:FIXed], 375 [SENSe:]SEGMent:CURRent:OFF
Index CALCulate{1-5}:MARKer{1-8}:APEak:EXCursion:Y, 308 CALCulate{1-5}:MARKer{1-8}:DISCrete, 309 CALCulate{1-5}:MARKer{1-8}:FORMat, 310 CALCulate{1-5}:MARKer{1-8}:FUNCtion:DOMain:LIM it:RESult?, 317 CALCulate{1-5}:MARKer{1-8}:FUNCtion:DOMain[:ST ATe], 312 CALCulate{1-5}:MARKer{1-8}:FUNCtion:EXECute, 321 CALCulate{1-5}:MARKer{1-8}:FUNCtion:TARGet, 324 CALCulate{1-5}:MARKer{1-8}:FUNCtion:TRACking, 325 CALCulate{1-5}:MARKer{1-8}:FUNCtion[:SELect], 311 CALCulate{1-5}:MARKer{1-8}:X, 338 CALCulate{1-5}:MARKer{1-
Index Index SENSe:CORRection1:CKIT:STANdard7:PLFactor, 434 SENSe:CORRection1:CKIT:STANdard7:PREal, 435 SENSe:CORRection1:CKIT:STANdard7:THICkness, 436 SENSe:CORRection1:COLLect:FPOints, 438 SENSe:CORRection1:COLLect:SAVE, 439 SENSe:CORRection1:COLLect[:ACQuire], 437 SENSe:CORRection1[:STATe], 419 SENSe:CORRection2:CKIT:LIST[:STATe], 440 SENSe:CORRection2:CKIT:STANdard1:C, 441 SENSe:CORRection2:CKIT:STANdard1:G, 442 SENSe:CORRection2:CKIT:STANdard1:LIST:G, 444 SENSe:CORRection2:CKIT:STANdard2:L, 445 SENSe:C
Index TRIGger[:SEQuence]:SLOPe, 526 TRIGger[:SEQuence]:SOURce, 526 TRIGger[:SEQuence][:IMMediate], 525 graph file save, 177 H history, manual printing, 2 I I/O library controlling peripherals from E4991A, 245 IEEE 32 bit floating point format, 121 IEEE 64 bit floating point format, 122 input device lock, 31 Installation and Quick Start Guide, 4 internal data array save selection, 177 Italic Font rules in this manual, 2 K key Font rules in this manual, 2 keyboard lock, 31 L LAN, 35 limit test function, 147
Index Index measurement parameters in case of complex trace, 43 in case of scalar trace, 41 memory array, 124 memory trace, 199 memory trace array, 124 menu Font rules in this manual, 3 message, 605 method, 238 mouse lock, 31 Q questionable status event register, 555 questionable status hardware event register, 555 questionable status limit event register, 555 questionable status search event register, 555 Quick Start Guide, 4 N number of measurement points under linear/log sweep, 44 under segment sweep,
Index lim_test.bas, 163 lim_test.htb, 159 measuring the self-resonant point of an inductor, 257, 267 mkr_sear.bas, 154 mkr_sear.htb, 150 save_rec.bas, 187 save_rec.htb, 180 segm_set.bas, 70 segm_set.htb, 66 setup.bas, 59 setup.htb, 55 sweep.bas, 116 swp_srq.
Index Index U user defined frequency / user defined power points calibration, 75 user defined frequency / user defined power points compensation, 94 V vbreadme.txt, 247 VISA application program for DC power supply(external instrument), 251 control flow with VISA, 247 importing definition files, 246 notes on using VISA library with VB, 247 online help of VISA library, 247 programming using VISA, 247 visa.
