Agilent Technologies 4288A Programming Manual

Agilent Technologies 4288A Programming Manual

1khz/1mhz capacitance meter
Table of Contents

Advertisement

Agilent 4288A 1KHZ/1MHZ CAPACITANCE METER Programming Manual
Change 1
Following command is available to use on firmware revision 1.30 or later.
Syntax:
[:SENSe]:CORRection:COLLect:LOAD:STANdard3:RANGe:AUTO {ON|OFF|1|0}
[:SENSe]:CORRection:COLLect:LOAD:STANdard3:RANGe:AUTO?
Description:
Sets the Auto Range value as ON/OFF when Load Standard measurement is performed. This command does not
influence the Load Standard measurement and only toggles the auto range setting. The Auto Range ON/OFF
setting for Load Standard measurement is saved in backup memory and can also be saved and restored using
SAVE/RECALL function
Parameter
ON or 1 (Initial
setting)
OFF or 0
Related commands:
:CORR:COLL on page 157
:RANG on page 185
:SYST:PRES on page 194
Equivalent key sequence:
No equivalent key can be used on front panel.
Copyright 2007 Agilent Technologies
C
Manual Change
:CORR:COLL:LOAD:STAN3:RANG:AUTO
Measures the load standard with auto range.
Measures the load standard at measurement range which
has been set just before the load standard measurement is
performed (auto range function is invalid).
Description
Agilent Part No. N/A
Sep 2007

Advertisement

Table of Contents
loading

Summary of Contents for Agilent Technologies 4288A

  • Page 1 Agilent 4288A 1KHZ/1MHZ CAPACITANCE METER Programming Manual Manual Change Agilent Part No. N/A Sep 2007 Change 1 Following command is available to use on firmware revision 1.30 or later. :CORR:COLL:LOAD:STAN3:RANG:AUTO Syntax: [:SENSe]:CORRection:COLLect:LOAD:STANdard3:RANGe:AUTO {ON|OFF|1|0} [:SENSe]:CORRection:COLLect:LOAD:STANdard3:RANGe:AUTO? Description: Sets the Auto Range value as ON/OFF when Load Standard measurement is performed. This command does not influence the Load Standard measurement and only toggles the auto range setting.
  • Page 2 [:SENSe]:CORRection:COLLect:LOAD:STANdard3:RANGe:AUTO {ON|OFF|1|0} [:SENSe]:CORRection:COLLect:LOAD:STANdard3:RANGe:AUTO? 説明: ロードスタンダード測定が行われる場合のオートレンジ値をオン、オフにセットします。このコ マンドはロードスタンダード測定に影響を及ぼさず、オートレンジ設定のみ切り替えます。ロー ドスタンダード測定のオートレンジ オン、オフ設定はバックアップメモリへ保存されます。ま た、SAVE/RECALL 機能を使用して保存し、回復することができます。 パラメータ: 説明 ON または 1 (初期設 オートレンジでロードスタンダードを測定する。 定) OFF または 0 ロードスタンダード測定が実行される直前に設定されていたレ ンジでロードスタンダードを測定する(オートレンジ機能は有 効ではありません) 関連コマンド: :CORR:COLL (157 ページ) :RANG (185 ページ) :SYST:PRES (194 ページ) 対応キー: フロント・パネル・キーからは実行できません。 Copyright 2007 Agilent Technologies ○...
  • Page 3 Agilent 4288A 1 kHz/1 MHz Capacitance Meter Programming Manual Third Edition FIRMWARE REVISIONS/SERIAL NUMBERS This manual applies directly to instruments that have the firmware revision 1.2x and serial number prefix JP1KH. For additional information about firmware revisions and serial numbers, see Appendix A.
  • Page 4 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. Agilent Technologies Japan, Ltd. Component Test PGU-Kobe 1-3-2, Murotani, Nishi-ku, Kobe, Hyogo, 651-2241 Japan ...
  • Page 5 SAMPLE PROGRAMS or modification of any part thereof. Agilent Technologies shall not be liable for the quality, performance, or behavior of the SAMPLE PROGRAMS. Agilent Technologies especially disclaims any responsibility for the operation of the SAMPLE PROGRAMS to be uninterrupted or error-free.
  • Page 6 The following manuals are available for the 4288A. • Operation Manual (Agilent P/N: 04288-900x0) Most of the basic information necessary for using the 4288A is provided in the Operation Manual. It describes installation, preparation, measurement operation including calibration, performances (specifications), and error messages. For GPIB programming, see the Programming Manual.
  • Page 7: Table Of Contents

    Contents 1. Making Effective Use of This Manual Contents of This Manual..............12 How To Use This Manual .
  • Page 8 Contents Turning ON/OFF the compensation function ..........45 Setting up the compensation data .
  • Page 9 4288A GPIB Commands ........
  • Page 10 Contents :CALC:COMP:COUN:MULT:OVLD? ..........140 :CALC:COMP:COUN:OVLD? .
  • Page 11 Change 2 ............... . . 209 B. Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence .
  • Page 12 4268A vs. 4288A GPIB Command Correspondence Table ........
  • Page 13: Making Effective Use Of This Manual

    Making Effective Use of This Manual This chapter provides an overview of this manual as well as useful information to help you navigate through the manual. It also briefly describes how to use this manual, focusing on how you can look up particular commands.
  • Page 14: Contents Of This Manual

    Contents of This Manual Contents of This Manual This manual is a programming guide for the Agilent 4288A 1 kHz/1 MHz capacitance meter. In addition to explanations of how to remotely control the 4288A from BASIC programs, it provides listings and in-depth descriptions of sample HTBasic programs. The chapter-by-chapter contents of this manual are as follows.
  • Page 15 Agilent 4288A than that indicated by the current printing date of this manual. The information in this manual applies directly to the 4288A model that has the serial number prefix listed on the title page of this manual. Appendix B “Information for Replacing 4278A with 4288A”...
  • Page 16: How To Use This Manual

    NOTE Some GPIB commands supported by the 4288A have optional syntax elements. In the command reference conventions, these elements are enclosed between square brackets ([ ]) or printed in lowercase letters. See “Syntax” on page 122 for more information.
  • Page 17: Using Sample Programs

    Making Effective Use of This Manual How To Use This Manual Using sample programs This manual comes with a sample program disk, which contains the source files of the sample programs used in the manual. The disk is DOS-formatted and the files are saved in ASCII format.
  • Page 18 Making Effective Use of This Manual How To Use This Manual Chapter 1...
  • Page 19: Overview Of Remote Control

    Overview of Remote Control This chapter gives an overview of the GPIB remote control system and GPIB commands.
  • Page 20: Setting Up A Gpib Remote Control System

    GPIB bus. How to set up a GPIB remote control system Use GPIB cables to connect the 4288A to an external controller (computer) and any necessary peripherals. Figure 2-1 shows a typical GPIB remote control system.
  • Page 21: Device Selector

    (such as HTBasic) for controlling the instrument via the GPIB interface. 3. Other hardware as needed (extra instruments and/or peripherals) 4. GPIB cables for connecting the 4288A to the external controller and other hardware Possible sizes and configurations of your remote control system •...
  • Page 22 Overview of Remote Control Setting Up a GPIB Remote Control System Setting the GPIB address for the Agilent 4288A Step 1. Press the [Adrs] [Blue] [Lcl] ) key. This brings up the screen shown in Figure 2-2, where the initial value is the current setup of the address (in this example, 17).
  • Page 23: Sending Gpib Command Messages

    4288A-specific commands These commands are specific to the 4288A. They provide access to all measurement features and some generic features built into the 4288A. Commands in this group have a hierarchical (multi-level) structure called the “command tree” (see “GPIB Command Tree”...
  • Page 24: Message Syntax

    Overview of Remote Control Sending GPIB Command Messages Figure 2-3 Using colons and semicolons Message syntax This section describes the syntax for sending program messages via GPIB. Program messages are sent by the user from an external controller to the instrument to control the instrument.
  • Page 25: Setting Up Measurement Conditions And Display

    Setting Up Measurement Conditions and Display This chapter describes how to set up the measurement conditions and display. It also describes how to save/recall the instrument settings including the measurement conditions.
  • Page 26: Setting Up Measurement Conditions

    Setting Up Measurement Conditions and Display Setting Up Measurement Conditions Setting Up Measurement Conditions Selecting measurement parameters To select the measurement parameters, use the following commands. :CALC1:FORM on page 147 • :CALC2:FORM on page 150 • You can select one of the following measurement parameter combinations shown in Table 3-1.
  • Page 27: Selecting Measurement Range

    Setting Up Measurement Conditions and Display Setting Up Measurement Conditions Selecting measurement range Selecting measurement range mode To select the measurement range mode (auto range/hold range), use the following command. :RANG:AUTO on page 185 • Selecting measurement range To select the measurement range, use the following command. •...
  • Page 28: Setting Up Display

    Setting Up Measurement Conditions and Display Setting Up Display Setting Up Display Turning ON/OFF display To turn ON/OFF display of the measurement parameter obtained, the measurement signal level monitored, the handler output (comparator sorting result), the multi-compensation settings, and the compensation data, use the following command. :DISP on page 176 •...
  • Page 29: Displaying Measurement Result As Deviation From Reference Value (Deviation Measurement Mode)

    Setting Up Measurement Conditions and Display Setting Up Display Displaying measurement result as deviation from reference value (deviation measurement mode) You can use the deviation measurement mode to display a relative measurement result as deviation from the reference value instead of displaying its absolute value. To turn ON/OFF the deviation measurement mode, use the following commands.
  • Page 30: Monitoring Measurement Signal Level

    Setting Up Measurement Conditions and Display Monitoring Measurement Signal Level Monitoring Measurement Signal Level Turning ON current level monitor function To turn ON/OFF current level monitor function for the measurement signal, use the following command. :CALC3:MATH:STAT on page 153 • Turning ON voltage level monitor function To turn ON/OFF voltage level monitor function for the measurement signal, use the following command.
  • Page 31: Setting Up Beep

    Setting Up Measurement Conditions and Display Setting Up Beep Setting Up Beep Setting up conditions to make a beep sound To turn ON/OFF the beep sound, use one of the following commands. You can use either of these two commands since both functions are identical. •...
  • Page 32: Saving/Recalling Instrument Setup State (Save/Recall Function)

    Setting Up Measurement Conditions and Display Saving/Recalling Instrument Setup State (save/recall function) Saving/Recalling Instrument Setup State (save/recall function) You can save/recall up to 10 instrument settings into/from the built-in nonvolatile memory (EEPROM). For information on the instrument setups you can save/recall, refer to Table D-1, “Initial settings, settings that can be saved/recalled, settings that can be backed up,”...
  • Page 33: Sample Program

    This program is stored on the sample program disk under the filename “setup.bas.” This program performs reset, sets up the 4288A as shown in the following table, and saves the setups into the built-in nonvolatile memory (save location number: 9).
  • Page 34 Setting Up Measurement Conditions and Display Sample Program The details of each part of the program are described below. Line 70 Sets up the GPIB address. Lines 90 to 170 Assigns the measurement condition setups (primary parameter: Cp, secondary parameter: D, measurement signal frequency: 1 kHz, measurement signal level: 500 mV, measurement range: auto range mode, measurement time: long mode, cable length: 0 m, averaging count: 4, and trigger delay time: 1 ms) to the Pri$, Sec$, Freq, Level,...
  • Page 35 Setting Up Measurement Conditions and Display Sample Program Lines 580 to 640 If Dev_mode_pri$ is “OFF,” specifies the deviation measurement mode for the primary parameter as OFF. Otherwise, specifies the deviation measurement mode for the primary parameter as ON and specifies the deviation display method and the deviation reference value as Dev_mode_pri$ and Dev_ref_pri, respectively.
  • Page 36 Setting Up Measurement Conditions and Display Sample Program OUTPUT @Agt4288a;":SOUR:FREQ ";Freq OUTPUT @Agt4288a;":SOUR:VOLT ";Level IF Range$="AUTO" THEN OUTPUT @Agt4288a;":RANG:AUTO ON" ELSE OUTPUT @Agt4288a;":RANG:AUTO OFF" OUTPUT @Agt4288a;":RANG "&Range$ END IF OUTPUT @Agt4288a;":APER "&Meas_time$ OUTPUT @Agt4288a;":CAL:CABL ";Cable OUTPUT @Agt4288a;":AVER ON" OUTPUT @Agt4288a;":AVER:COUN ";Ave OUTPUT @Agt4288a;":TRIG:DEL ";Delay OUTPUT @Agt4288a;":DISP "&Disp$ OUTPUT @Agt4288a;":DISP:TEXT1:DIG ";Digit...
  • Page 37: Preparation For Accurate Measurement (Executing Compensation)

    Preparation for Accurate Measurement (Executing Compensation) This chapter describes how to execute the compensation function.
  • Page 38: Executing Open/Short/Load Compensation

    Preparation for Accurate Measurement (Executing Compensation) Executing OPEN/SHORT/LOAD Compensation Executing OPEN/SHORT/LOAD Compensation Turning ON/OFF compensation function To turn ON/OFF each type of compensation, use the corresponding command below. Type of compensation Command :CORR:OPEN on page 165 OPEN compensation SHORT compensation :CORR:SHOR on page 165 :CORR:LOAD on page 160 LOAD compensation...
  • Page 39: Reading/Writing Compensation Data (Saving/Recalling Compensation Conditions)

    After saving the compensation conditions to a file, you can recall these conditions on the 4288A at any time from the file. The compensation data is set up in the parameter-oriented format shown in the table below: Type of compensation...
  • Page 40: Sample Program

    Preparation for Accurate Measurement (Executing Compensation) Executing OPEN/SHORT/LOAD Compensation Sample program Example 4-1 shows a sample program to execute the OPEN/SHORT/LOAD compensation. Example 4-2 shows a sample program to read out and recall compensation data saved in a file. These programs are stored on the sample program disk under the filenames “compen.bas”...
  • Page 41 Preparation for Accurate Measurement (Executing Compensation) Executing OPEN/SHORT/LOAD Compensation the measurement frequency to Freq. 2. Lines 600 to 620: Clears the status byte register, operation status event register, and error queue. 3. Lines 640 to 650: Sets the branch destination of the SRQ interrupt and enables the SRQ interrupt.
  • Page 42 Preparation for Accurate Measurement (Executing Compensation) Executing OPEN/SHORT/LOAD Compensation Cable, F_shift, Open, Shor, Load, Load_ref, and Load_para$ to the file. Line 1520 Displays the name of the file to which the compensation state is saved. The Inp_data sub-program of Lines 1540 to 1680 used to input data is described below. Line 1590 Makes the setup to return to the entry start line when an error (for example, due to improper input) occurs so that the user can make the...
  • Page 43 Preparation for Accurate Measurement (Executing Compensation) Executing OPEN/SHORT/LOAD Compensation CASE "Short" Std$="STAN2" CASE "Load" Std$="STAN3" CALL Inp_data("Load(Cp) Value @1kHz",Load1(1)) CALL Inp_data("Load(D) Value @1kHz",Load2(1)) CALL Inp_data("Load(Cp) Value @1MHz",Load1(2)) CALL Inp_data("Load(D) Value @1MHz",Load2(2)) OUTPUT @Agt4288a;":CORR:CKIT:STAN3:FORM "&Load_para$ FOR I=1 TO 2 OUTPUT @Agt4288a;":SOUR:FREQ ";Freq(I) OUTPUT @Agt4288a;":CORR:CKIT:STAN3 ";Load1(I);",";Load2(I) NEXT I END SELECT...
  • Page 44 Preparation for Accurate Measurement (Executing Compensation) Executing OPEN/SHORT/LOAD Compensation 1030 PRINT "Out of limit!!" 1040 GOTO Compen_meas 1050 END IF 1060 NEXT I 1070 PRINT Standard$&" Data Measurement Complete" 1080 OUTPUT @Agt4288a;":SOUR:FREQ ";Curr_freq 1090 RETURN 0 1100 ELSE 1110 PRINT "Program Interruption" 1120 OUTPUT @Agt4288a;":SOUR:FREQ ";Curr_freq 1130...
  • Page 45 Preparation for Accurate Measurement (Executing Compensation) Executing OPEN/SHORT/LOAD Compensation 1660 IF UPC$(Inp_char$)<>"Y" THEN Inp_start 1670 OFF ERROR 1680 SUBEND Example 4-2 reads out data saved into a file by the program of Example 4-1 and recovers the compensation state at the execution of Example 4-1. The program of Example 4-2 is detailed below: Line 70 Sets the GPIB address.
  • Page 46 Preparation for Accurate Measurement (Executing Compensation) Executing OPEN/SHORT/LOAD Compensation Example 4-2 Recovering the compensation state (comp_dat.bas) DIM File_name$[20],Load_para$[5],Img$[30] REAL Freq(1:2),Open(1:2,1:2),Shor(1:2,1:2) REAL Load(1:2,1:2),Load_ref(1:2,1:2) INTEGER Cable,F_shift,Fr CLEAR SCREEN ASSIGN @Agt4288a TO 717 File_name$="Cmp_data" PRINT "[Download Compensation data]" ON ERROR GOTO File_error ASSIGN @File TO File_name$;FORMAT OFF ENTER @File;Cable,F_shift,Open(*),Shor(*),Load(*),Load_ref(*),Loa d_para$ ASSIGN @File TO *...
  • Page 47: Executing Offset Compensation

    Preparation for Accurate Measurement (Executing Compensation) Executing Offset Compensation Executing Offset Compensation Turning ON/OFF the compensation function When you turn ON the offset compensation, assuming that the measured value before compensation is and the offset compensation data is , the measured value is Meas Offset compensated as...
  • Page 48: Using The Multi-Compensation Function

    Preparation for Accurate Measurement (Executing Compensation) Using the Multi-compensation Function Using the Multi-compensation Function Turning ON/OFF the multi-compensation function To turn ON/OFF the multi-compensation function, use the following command. :CORR:MULT on page 161 • Selecting a channel To select a channel for the multi compensation function, use the following command. •...
  • Page 49: Sample Program

    Repeats the following four times (channels: 0 to 3). 1. Line 120: Displays the channel. 2. Line 130: Sets up the channel of the 4288A. 3. Line 140: Uses the FNCompen sub-program to execute the OPEN compensation. For information on the FNCompen sub-program, refer to the description in Example 4-1 on page 40.
  • Page 50 Preparation for Accurate Measurement (Executing Compensation) Using the Multi-compensation Function Example 4-3 Executing the multi compensation (multi.bas) INTEGER Ch,Result CLEAR SCREEN ASSIGN @Agt4288a TO 717 OUTPUT @Agt4288a;":SYST:PRES" OUTPUT @Agt4288a;":CORR:MULT ON" OUTPUT @Agt4288a;":CORR:MULT:CKIT:STAN3 ON" OUTPUT @Agt4288a;":DISP:TEXT2:PAGE 5" FOR Ch=0 TO 3 PRINT "## Channel No.: ";Ch;"##"...
  • Page 51 Preparation for Accurate Measurement (Executing Compensation) Using the Multi-compensation Function END SELECT 630 Compen_meas: PRINT "Set "&Standard$&"-Connection." INPUT "OK? [Y/N]",Inp_char$ IF UPC$(Inp_char$)="Y" THEN FOR I=1 TO 2 PRINT "Frequency:";Freq(I) OUTPUT @Agt4288a;":SOUR:FREQ ";Freq(I) OUTPUT @Agt4288a;"*CLS" OUTPUT @Agt4288a;"*OPC?" ENTER @Agt4288a;Buff$ ! Measurement ON INTR 7 GOTO Meas_end ENABLE INTR 7;2 OUTPUT @Agt4288a;":CORR:COLL "&Std$...
  • Page 52 Preparation for Accurate Measurement (Executing Compensation) Using the Multi-compensation Function 1260 !============================================= 1270 ! Data Input Function 1280 !============================================= 1290 SUB Inp_data(Mes$,Inp_val) 1300 DIM Inp_char$[30] 1310 ON ERROR GOTO Inp_start 1320 Inp_start:! 1330 PRINT "Input "&Mes$ 1340 INPUT "Value?",Inp_char$ 1350 Inp_val=VAL(UPC$(Inp_char$)) 1360 PRINT "Input Value: ";Inp_val...
  • Page 53: Starting (Triggering) Measurement And Waiting For Completion Of Measurement

    Starting (Triggering) Measurement and Waiting for Completion of Measurement This chapter describes how to trigger the instrument to start measurement and how to detect completion of measurement.
  • Page 54: Starting (Triggering) Measurement

    Starting (Triggering) Measurement and Waiting for Completion of Measurement Starting (triggering) Measurement Starting (triggering) Measurement Trigger system The operations performed by the trigger system include detection of the measurement start signal (trigger) and control of the delay time for starting measurement. The trigger system has three states: “idle,”...
  • Page 55 Starting (Triggering) Measurement and Waiting for Completion of Measurement Starting (triggering) Measurement Waiting for trigger state (trigger event detect state) The waiting for trigger state, when the instrument is triggered (a trigger is detected) or the :TRIG command on page 195 is executed, transitions to the measurement state after the trigger delay time (set with the :TRIG:DEL command on page 195) has elapsed (b in Figure 5-1).
  • Page 56: Starting (Triggering) Measurement

    Starting (Triggering) Measurement and Waiting for Completion of Measurement Starting (triggering) Measurement Starting (triggering) measurement Follow the procedure below to perform successive measurements automatically (initial setup). Step 1. Set the trigger mode to the internal trigger with the :TRIG:SOUR command on page 196. Step 2.
  • Page 57: Waiting For Completion Of Measurement (Detecting Completion Of Measurement)

    • The procedure is given below. Step 1. Make the setup so that the 4288A generates an SRQ if bit 4 of the operation status event register is set to 1. Step 2. Trigger the instrument to start a measurement.
  • Page 58: Sample Program

    Starting (Triggering) Measurement and Waiting for Completion of Measurement Waiting For Completion Of Measurement (detecting completion of measurement) Sample program Example 5-1 shows a sample program to detect the completion of measurement using an SRQ. This program is stored on the sample program disk under the filename “srq_meas.bas.”...
  • Page 59: Reading Out Measured Result

    Reading Out Measured Result This chapter describes how to read out the measured result and the measurement signal level monitor result.
  • Page 60: Data Transfer Format

    Reading Out Measured Result Data Transfer Format Data Transfer Format You can select either the ASCII transfer format or binary transfer format when transferring data with the following commands. NOTE The ASCII transfer format is always used when transferring data with commands other than those listed below.
  • Page 61: Ascii Transfer Format

    Reading Out Measured Result Data Transfer Format ASCII transfer format When data is transferred in the ASCII transfer format, values are transferred as ASCII bytes in one of the following formats. According to the specification of IEEE488.2, values are separated by a comma (,). NOTE The string length of numerical values is not constant.
  • Page 62: Binary Transfer Format

    Reading Out Measured Result Data Transfer Format Binary transfer format When data is transferred in the binary transfer format, values (binary data) are transferred in the format shown in Figure 6-3. Figure 6-3 Binary transfer format In this data transfer format, a pounds symbol (#) occurs at the beginning. The 2nd byte <digit count>...
  • Page 63: Reading Out Measured Result

    Reading Out Measured Result Reading Out Measured Result Reading Out Measured Result This section describes how to read out the measured result. You can read out the measured result in two ways: reading out data for each measurement or reading out data of several measurements in batch. The three commands shown in the table below can be used to read out the measured data for each measurement.
  • Page 64: Reading Out Measured Result Using *Trg Command

    Reading Out Measured Result Reading Out Measured Result Reading out measured result using *TRG command This command actually performs two tasks: it triggers the instrument and returns the results. It is useful, for example, when you want to retrieve measurement results immediately after triggering the instrument from an external controller.
  • Page 65 Reading Out Measured Result Reading Out Measured Result Reading out the measured result in ASCII transfer format by using the *TRG Example 6-1 command (trg_a.bas) DIM Buff$[9] REAL Pri_para,Sec_para INTEGER Meas_stat,Comp INTEGER Comp_flag,Cond_reg ASSIGN @Agt4288a TO 717 OUTPUT @Agt4288a;":FORM ASC" OUTPUT @Agt4288a;":INIT:CONT ON"...
  • Page 66 Reading Out Measured Result Reading Out Measured Result The program of Example 6-2 is detailed below. Lines 50 to 60 Sets the GPIB address. Line 70 Sets the data transfer format to the binary format. Lines 90 to 100 Turns ON the trigger system continuous startup and sets the trigger mode to the GPIB trigger.
  • Page 67 Reading Out Measured Result Reading Out Measured Result Reading out the measured result in binary transfer format using *TRG command Example 6-2 (trg_b.bas) DIM Buff$[9],Digit$[1],Read_form$[9],Num_of_byte$[9] REAL Pri_para,Sec_para REAL Meas_stat,Comp INTEGER Comp_flag,Cond_reg ASSIGN @Binary TO 717;FORMAT OFF ASSIGN @Agt4288a TO 717 OUTPUT @Agt4288a;":FORM REAL"...
  • Page 68: Reading Out Measured Result Using :Fetc? Command

    Reading Out Measured Result Reading Out Measured Result Reading out measured result using :FETC? command You can use this readout method when you want to trigger the instrument from any source other than an external controller or when you want to perform a process that is between triggering the instrument and reading out the measured result.
  • Page 69 Reading Out Measured Result Reading Out Measured Result Lines 390 to 410 Displays the measurement status, measured primary parameter result, and measured secondary parameter result. Line 430 If the Comp_flag value is 1 (the comparator function is ON), displays the comparator sorting result. Line 450 If the Comp_flag value is not 1 (the comparator function is OFF), displays “Comparator : OFF.”...
  • Page 70 Reading Out Measured Result Reading Out Measured Result The program of Example 6-4 is detailed below. Lines 50 to 60 Sets the GPIB address. Line 70 Sets the data transfer format to the binary format. Lines 90 to 100 Turns ON the trigger system continuous startup and sets the trigger mode to the external trigger.
  • Page 71 Reading Out Measured Result Reading Out Measured Result Reading out measured result in binary transfer format using :FETC? command Example 6-4 (fetch_b.bas) DIM Buff$[9],Digit$[1],Read_form$[9],Num_of_byte$[9] REAL Pri_para,Sec_para REAL Meas_stat,Comp INTEGER Comp_flag ASSIGN @Binary TO 717;FORMAT OFF ASSIGN @Agt4288a TO 717 OUTPUT @Agt4288a;":FORM REAL" OUTPUT @Agt4288a;":INIT:CONT ON"...
  • Page 72: Reading Out Measured Result Using :Read? Command

    Reading Out Measured Result Reading Out Measured Result Reading out measured result using :READ? command You can use this readout method when you want to read out the result synchronously with the completion of measurement without detecting the time of trigger in the trigger wait state in your program.
  • Page 73 Reading Out Measured Result Reading Out Measured Result Reading out the measured result in ASCII transfer format using the :READ? Example 6-5 command (read_a.bas) DIM Buff$[9] REAL Pri_para,Sec_para INTEGER Meas_stat,Comp INTEGER Comp_flag ASSIGN @Agt4288a TO 717 OUTPUT @Agt4288a;":FORM ASC" OUTPUT @Agt4288a;":INIT:CONT OFF" OUTPUT @Agt4288a;":TRIG:SOUR EXT"...
  • Page 74 Reading Out Measured Result Reading Out Measured Result The program of Example 6-6 is detailed below. Lines 50 to 60 Sets the GPIB address. Line 70 Sets the data transfer format to the binary format. Lines 90 to 100 Turns OFF the trigger system continuous startup and sets the trigger mode to external trigger.
  • Page 75 Reading Out Measured Result Reading Out Measured Result Reading out the measured result in binary transfer format using the :READ? Example 6-6 command (read_b.bas) DIM Buff$[9],Digit$[1],Read_form$[9],Num_of_byte$[9] REAL Pri_para,Sec_para REAL Meas_stat,Comp INTEGER Comp_flag ASSIGN @Binary TO 717;FORMAT OFF ASSIGN @Agt4288a TO 717 OUTPUT @Agt4288a;":FORM REAL"...
  • Page 76 However, the internal processing is started after the completion of display update. The 4288A normally updates display after data output as shown in Figure 6-5. However, if readout of data stagnates due to the external controller, the 4288A may update display before data output.
  • Page 77: Reading Out Results Of Several Measurements In Batch (Using Data Buffer)

    Reading Out Measured Result Reading Out Measured Result Reading out results of several measurements in batch (using data buffer) You can use the data buffer to temporarily store the results of several measurements and then later read out these results in batch. Data buffer types There are three types of data buffers (buffers 1–3).
  • Page 78 Reading Out Measured Result Reading Out Measured Result Figure 6-6 Structure of data buffer Procedure for use Step 1. Use the :DATA:POIN command on page 175 to set up the number of measurements you want to feed into the data buffer. Step 2.
  • Page 79 Reading Out Measured Result Reading Out Measured Result Sample program Example 6-7 shows a sample program to read out the measured result using the data buffer. This program is stored on the sample program disk under the filename “data_buf.bas.” This program executes measurement 50 times, reads out the results of the 50 measurements in batch using data buffer 3, and then displays this information.
  • Page 80 Reading Out Measured Result Reading Out Measured Result ENTER @Agt4288a;Comp_flag IF Comp_flag=1 THEN REDIM Data(1:Point,1:4) ELSE REDIM Data(1:Point,1:3) END IF OUTPUT @Agt4288a;":DATA:POIN BUF3,";Point OUTPUT @Agt4288a;":DATA:FEED:CONT BUF3,ALW" ! Triggering REPEAT OUTPUT @Agt4288a;":TRIG" OUTPUT @Agt4288a;":STAT:OPER:COND?" ENTER @Agt4288a;Cond_reg UNTIL BIT(Cond_reg,10) ! Data reading OUTPUT @Agt4288a;":DATA? BUF3"...
  • Page 81: Reading Out Measurement Signal Level Monitor Result

    Reading Out Measured Result Reading out measurement signal level monitor result Reading out measurement signal level monitor result To read out measurement signal level monitor result, use the following command: • :DATA? {IMON|VMON} on page 171 Example 6-8 shows a sample program to read out the measurement signal level monitor result.
  • Page 82 Reading Out Measured Result Reading out measurement signal level monitor result Example 6-8 Reading out the measurement signal level monitor result (lvl_mon.bas) DIM Buff$[9] REAL V_mon,I_mon ASSIGN @Agt4288a TO 717 OUTPUT @Agt4288a;":FORM ASC" OUTPUT @Agt4288a;":CALC3:MATH:STAT ON" OUTPUT @Agt4288a;":CALC4:MATH:STAT ON" OUTPUT @Agt4288a;":DISP:TEXT2:PAGE 4" OUTPUT @Agt4288a;":INIT:CONT ON"...
  • Page 83: Sorting Based On Measured Result (Comparator Function)

    Sorting Based on Measured Result (Comparator Function) This chapter describes how to use the comparator function to perform sorting based on the measured result.
  • Page 84: Setting Up Comparator Function

    Sorting Based on Measured Result (Comparator Function) Setting Up Comparator Function Setting Up Comparator Function Turning ON/OFF comparator function To enable/disable the comparator function, use the following command. :CALC:COMP on page 134 • Setting up limit range Clearing (resetting) limit range You can clear the ON/OFF state and the lower and upper limit values of all limit ranges (BIN1 to BIN9 and the secondary parameter limit range) and the ON/OFF state of AUX BIN to recover the factory-shipped default values (refer to Table D-1, “Initial settings,...
  • Page 85 Sorting Based on Measured Result (Comparator Function) Setting Up Comparator Function Turning ON/OFF limit range To turn ON/OFF the primary parameter limit range (BIN1 to BIN9), use the following command. • :CALC:COMP:PRIM:BIN{1-9}:STAT on page 143 Only BINs set to ON with the above command become the targets of sorting judgment. In other words, even if the measured result falls within the limit range of a BIN set to OFF, it will not be sorted to that BIN.
  • Page 86: Turning On/Off Aux Bin Function

    Sorting Based on Measured Result (Comparator Function) Setting Up Comparator Function Turning ON/OFF AUX BIN function To turn ON/OFF the AUX BIN function, use the following command. • :CALC:COMP:AUXB on page 135 Depending on the ON/OFF state of the AUX BIN function, the sorting result when the value of the secondary parameter exceeds the limit range varies as shown in Table 7-1.
  • Page 87: Rejecting Excessively Low Measured Results (Low C Reject Function)

    Sorting Based on Measured Result (Comparator Function) Rejecting Excessively Low Measured Results (Low C reject function) Rejecting Excessively Low Measured Results (Low C reject function) Turning ON/OFF Low C reject function To turn ON/OFF the Low C reject function, use the following command. :CREJ on page 166 •...
  • Page 88: Reading Out Sorting Judgment Result

    Sorting Based on Measured Result (Comparator Function) Reading Out Sorting Judgment Result Reading Out Sorting Judgment Result You can read out the sorting judgment result (readout value) along with the measured result by the comparator function according to the correspondences in Figure 7-1. To do this, use the following commands.
  • Page 89 Sorting Based on Measured Result (Comparator Function) Reading Out Sorting Judgment Result Figure 7-1 Sorting judgment flow Chapter 7...
  • Page 90: Reading Out Sort Count Of Each Bin (Bin Count Function)

    Sorting Based on Measured Result (Comparator Function) Reading Out Sort Count Of Each Bin (BIN count function) Reading Out Sort Count Of Each Bin (BIN count function) Turning ON/OFF BIN count function To turn ON/OFF the BIN count function, use the following command. :CALC:COMP:COUN on page 137 •...
  • Page 91: Sample Program

    Sorting Based on Measured Result (Comparator Function) Sample Program Sample Program Example 7-1 shows a sample program of the BIN sort function. This program is stored on the sample program disk under the filename “bin_sort.bas”. This program sets up the limit ranges as shown in the below table, performs measurement 50 times, and then reads out and displays the measured result and comparator sorting result for each measurement.
  • Page 92 Sorting Based on Measured Result (Comparator Function) Sample Program Lines 530 to 550 Sets the ON/OFF state of the AUX BIN function, the ON/OFF state of the Low C reject function, and the limit of the Low C reject function to Aux$, Low_c_rej$, and Low_c_rej_lim.
  • Page 93 Sorting Based on Measured Result (Comparator Function) Sample Program Example 7-1 Sorting using comparator function (comprtr.bas) DIM Pri$[9],Sec$[9],Range$[9],Mode$[9],Aux$[9],Low_c_rej$[9] ,Img$[50] REAL Nom,L_lim(1:3),U_lim(1:3),L_lim_sec,U_lim_sec REAL Low_c_rej_lim,Pri_para,Sec_para INTEGER I,Meas_stat,Comp,Bin(1:11),Ovld ASSIGN @Agt4288a TO 717 Pri$="CP" Sec$="D" Range$="1NF" Mode$="PCNT" Nom=1.E-9 !-- [BIN1] -- L_lim(1)=-1.0 U_lim(1)=1.0 !-- [BIN2] -- L_lim(2)=-2.0 U_lim(2)=2.0 !-- [BIN3] --...
  • Page 94 Sorting Based on Measured Result (Comparator Function) Sample Program OUTPUT @Agt4288a;":CALC:COMP:AUXB "&Aux$ OUTPUT @Agt4288a;":CREJ "&Low_c_rej$ OUTPUT @Agt4288a;":CREJ:LIM ";Low_c_rej_lim OUTPUT @Agt4288a;":CALC:COMP ON" OUTPUT @Agt4288a;":DISP:TEXT2:PAGE 6" ! Trigger setting OUTPUT @Agt4288a;":TRIG:SOUR BUS" ! Bin count setting OUTPUT @Agt4288a;":CALC:COMP:COUN ON" OUTPUT @Agt4288a;":CALC:COMP:COUN:CLE" OUTPUT @Agt4288a;"*OPC?" ENTER @Agt4288a;Buff$ ! Measurement CLEAR SCREEN...
  • Page 95: Avoiding Mistakes Related To Work And Daily Checks

    Avoiding Mistakes Related to Work and Daily Checks This chapter describes how to avoid simple mistakes related to work, how to detect the occurrence of an error, and how to execute the self-test.
  • Page 96: Avoiding Mistakes Related To Work

    Avoiding Mistakes Related to Work and Daily Checks Avoiding Mistakes Related To Work Avoiding Mistakes Related To Work Avoiding improper input from the front panel (key lock function) When you do not need to operate the keys on the front panel, you can disable entry from the front panel keys (key lock function) to avoid improper input due to touching the front panel keys accidentally.
  • Page 97: Detecting The Occurrence Of An Error

    • The procedure is given below. Step 1. Set the 4288A to generate an SRQ if one of the error occurrence bits of the standard event status register is set to 1. Step 2. Perform interrupt handling in the program when SRQ occurs.
  • Page 98 “srq_err.bas”. This program sets up SRQ, intentionally sends a nonexistent command for the 4288A to generate an error, and performs error handling. In the error handling, the program checks which error has occurred, displays the error number and error message, and displays the “PROGRAM INTERRUPT”...
  • Page 99 Avoiding Mistakes Related to Work and Daily Checks Avoiding Mistakes Related To Work Example 8-1 Error occurrence detection using SRQ (srq_err.bas) DIM Buff$[9],Err_mes$[50] INTEGER Err_no ASSIGN @Agt4288a TO 717 OUTPUT @Agt4288a;"*ESE 60" OUTPUT @Agt4288a;"*SRE 32" OUTPUT @Agt4288a;"*CLS" OUTPUT @Agt4288a;"*OPC?" ENTER @Agt4288a;Buff$ ON INTR 7 GOTO Err_proc ENABLE INTR 7;2 OUTPUT @Agt4288a;":CALC1:FORM CS"...
  • Page 100: Daily Checks (Executing The Self-Test)

    Avoiding Mistakes Related to Work and Daily Checks Daily Checks (executing the self-test) Daily Checks (executing the self-test) The 4288A has a self-test function that consists of an internal test and an external test. Internal test To execute the internal test, use the following command.
  • Page 101: Sample Program

    Avoiding Mistakes Related to Work and Daily Checks Daily Checks (executing the self-test) Sample program Example 8-1 shows a sample program to execute the self-test. This program is stored on the sample program disk under the filename “selftest.bas”. This program executes the self-test and displays the result. Line 30 Sets the GPIB address.
  • Page 102 Avoiding Mistakes Related to Work and Daily Checks Daily Checks (executing the self-test) Chapter 8...
  • Page 103: Measurement Applications (Sample Programs)

    Measurement Applications (Sample Programs) This chapter contains sample programs for both basic measurement and measurement using a system integrated with the handler/scanner interface.
  • Page 104: Basic Capacitor Measurement

    When you start this program, the message “Connect Test Fixture, then Push [Enter] key” is displayed. Connect the test fixture suitable for the shape of the capacitor you want to measure to the Agilent 4288A and press the key. [Enter] “Set Open-Connection”...
  • Page 105 Measurement Applications (Sample Programs) Basic Capacitor Measurement Lines 410 to 480 Displays the measured result. Lines 500 to 510 Prompts the user to enter decision on whether to make the measurement again. If the user presses the [Enter] keys, returns to the DUT connection stage and repeats the measurement.
  • Page 106 Measurement Applications (Sample Programs) Basic Capacitor Measurement !============================================= DEF FNCompen(@Agt4288a,Standard$,Limit) DIM Inp_char$[9],Buff$[9],Std$[9],Err$[50] REAL Curr_freq,Freq(1:2),Para1,Para2,Zm,Ym,Gm,Bm REAL Cpref,Dref,Zref,Gref,Bref INTEGER Err_flag OUTPUT @Agt4288a;":SOUR:FREQ?" ENTER @Agt4288a;Curr_freq Freq(1)=1.E+3 Freq(2)=1.E+6 Load_para$="CPD" OUTPUT @Agt4288a;":STAT:OPER:ENAB 128" OUTPUT @Agt4288a;"*SRE 128" SELECT Standard$ CASE "Open" Std$="STAN1" CASE "Short" Std$="STAN2" CASE "Load" Std$="STAN3"...
  • Page 107 Measurement Applications (Sample Programs) Basic Capacitor Measurement 1200 PRINT "R =";Para1,"X =";Para2,"|Z| =";Zm 1210 IF Zm>=Limit THEN Err_flag=1 1220 CASE "Load" 1230 OUTPUT @Agt4288a;":CORR:CKIT:STAN3?" 1240 ENTER @Agt4288a;Cpref,Dref 1250 Bref=2*PI*Freq(I)*Cpref 1260 Gref=Bref*Dref 1270 Zref=1/SQRT(Gref*Gref+Bref*Bref) 1280 Bm=2*PI*Freq(I)*Para1 1290 Gm=Bm*Para2 1300 Zm=1/SQRT(Gm*Gm+Bm*Bm) 1310 PRINT "Cpref=";Cpref,"Dref=";Dref,"|Zref| =";Zref 1320 PRINT "Cp...
  • Page 108: Measurement With Auto-Sorting System

    Measurement Applications (Sample Programs) Measurement with Auto-sorting System Measurement with Auto-sorting System Example 9-2 shows a sample program to measure a capacitor (1 nF), assuming that it is used in the auto-sorting system integrated with the handler. This program is stored on the sample program disk under the filename “meas_sys.bas”.
  • Page 109 Measurement Applications (Sample Programs) Measurement with Auto-sorting System The program is detailed below. Line 70 Sets the GPIB address. Line 90 Assigns the number of measurements (10 times) into the Max_meas variable. Lines 110 to 160 Assigns the setups of the primary parameter (Cp), secondary parameter (D), measurement signal frequency (1 kHz), measurement signal level (1 V), measurement time mode (short), and cable length (1 m) to the Pri$, Sec$, Freq, Lvl, Meas_time$, and Cbl variables,...
  • Page 110 In this example, the status report system is employed to synchronize with the instrument state of the 4288A. For the auto-sorting system using the handler, you can also use handler interface output signals such as /READY_FOR_TRIG, /INDEX, and /EOM for synchronization.
  • Page 111 Measurement Applications (Sample Programs) Measurement with Auto-sorting System Cbl=1 Mode$="PCNT" Nom=1.E-9 !-- [BIN1] -- L_lim(1)=-1.0 U_lim(1)=1.0 !-- [BIN2] -- L_lim(2)=-2.0 U_lim(2)=2.0 !-- [BIN3] -- L_lim(3)=-3.0 U_lim(3)=3.0 !-- [Sec] -- L_lim_sec=0. U_lim_sec=.1 Aux$="ON" Low_c_rej$="ON" Low_c_rej_lim=10.0 OUTPUT @Agt4288a;"*RST" OUTPUT @Agt4288a;":CALC1:FORM ";Pri$ OUTPUT @Agt4288a;":CALC2:FORM ";Sec$ OUTPUT @Agt4288a;":SOUR:FREQ ";Freq OUTPUT @Agt4288a;":SOUR:VOLT ";Lvl OUTPUT @Agt4288a;":APER "&Meas_time$...
  • Page 112 Measurement Applications (Sample Programs) Measurement with Auto-sorting System OUTPUT @Agt4288a;":TRIG:SOUR EXT" OUTPUT @Agt4288a;":INIT:CONT ON" ! Bin count setting OUTPUT @Agt4288a;":CALC:COMP:COUN ON" OUTPUT @Agt4288a;":CALC:COMP:COUN:CLE" OUTPUT @Agt4288a;"*OPC?" ENTER @Agt4288a;Buff$ ! SRQ setting OUTPUT @Agt4288a;":STAT:OPER:ENAB 16" OUTPUT @Agt4288a;"*SRE 128" FOR I=1 TO Max_meas REPEAT OUTPUT @Agt4288a;":STAT:OPER:COND?"...
  • Page 113 Measurement Applications (Sample Programs) Measurement with Auto-sorting System 1430 Freq(1)=1.E+3 1440 Freq(2)=1.E+6 1450 Load_para$="CPD" 1460 OUTPUT @Agt4288a;":STAT:OPER:ENAB 128" 1470 OUTPUT @Agt4288a;"*SRE 128" 1480 SELECT Standard$ 1490 CASE "Open" 1500 Std$="STAN1" 1510 CASE "Short" 1520 Std$="STAN2" 1530 CASE "Load" 1540 Std$="STAN3" 1550 CALL Inp_data("Load(Cp) Value @1kHz",Load1(1)) 1560...
  • Page 114 Measurement Applications (Sample Programs) Measurement with Auto-sorting System 2070 Bm=2*PI*Freq(I)*Para1 2080 Gm=Bm*Para2 2090 Zm=1/SQRT(Gm*Gm+Bm*Bm) 2100 PRINT "Cpref=";Cpref,"Dref=";Dref,"|Zref| =";Zref 2110 PRINT "Cp =";Para1,"D =";Para2,"|Z| =";Zm 2120 IF ABS((Zm-Zref)/Zref)>=Limit THEN Err_flag=1 2130 END SELECT 2140 IF Err_flag<>0 THEN 2150 PRINT "Out of limit!!" 2160 GOTO Compen_meas 2170...
  • Page 115: Measurement With Changing Channels (Scanning)

    Measurement Applications (Sample Programs) Measurement with changing channels (scanning) Measurement with changing channels (scanning) Example 9-3 shows a sample program to measure a capacitor (1 nF) that is used in a four-channel scanning system. This program is stored on the sample program disk under the filename “meas_scn.bas”.
  • Page 116 Measurement Applications (Sample Programs) Measurement with changing channels (scanning) The program is detailed below. Lines 80 to 90 Sets the GPIB address. Lines 110 to 120 Assigns the number of measurements (10 times) and maximum channel number to the Max_meas and Max_chan variables, respectively Lines 140 to 190 Assigns the setups of the primary parameter (Cp), secondary...
  • Page 117 Line 1260: Sets the channel of the 4288A. NOTE In this example, the GPIB command is used to set the channel of the 4288A. When using the scanner interface, you can also use the input signals /CH0 to /CH5 and /CH_VALID to set the channel.
  • Page 118 Measurement Applications (Sample Programs) Measurement with changing channels (scanning) Example 9-3 Scanning measurement (meas_scn.bas) DIM Pri$[9],Sec$[9],Mode$[9],Aux$[9],Meas_time$[9],Low_c_rej$[9] DIM Digit$[1],Read_form$[9],Num_of_byte$[9],Buff$[9],Img$[50] REAL Freq,Lvl,Data(0:3,1:4),Nom,Low_c_rej_lim REAL L_lim(1:3),U_lim(1:3),L_lim_sec,U_lim_sec,Pri_res,Sec_res INTEGER Max_meas,Max_chan,Cbl,Result,Ch,Bin(1:11),Ovld,I CLEAR SCREEN ASSIGN @Binary TO 717;FORMAT OFF ASSIGN @Agt4288a TO 717 Max_meas=10 Max_chan=3 Pri$="CP" Sec$="D" Freq=1.E+3 Lvl=1.0 Meas_time$="SHOR"...
  • Page 119 Measurement Applications (Sample Programs) Measurement with changing channels (scanning) NEXT Ch PRINT "##### Short Data Measurement #####" FOR Ch=0 TO Max_chan OUTPUT @Agt4288a;":CORR:MULT:CHAN ";Ch PRINT "Set the Scanner's Channel to No."&VAL$(Ch)&", and" Result=FNCompen(@Agt4288a,"Short",20) IF Result<>0 THEN Prog_end NEXT Ch PRINT "##### Load Data Measurement #####" FOR Ch=0 TO Max_chan OUTPUT @Agt4288a;":CORR:MULT:CHAN ";Ch PRINT "Set the Scanner's Channel to No."&VAL$(Ch)&", and"...
  • Page 120 Measurement Applications (Sample Programs) Measurement with changing channels (scanning) 1250 FOR Ch=0 TO Max_chan 1260 OUTPUT @Agt4288a;":CORR:MULT:CHAN ";Ch 1270 OUTPUT @Agt4288a;"*CLS" 1280 OUTPUT @Agt4288a;"*OPC?" 1290 ENTER @Agt4288a;Buff$ 1300 ON INTR 7 GOTO Meas_end 1310 ENABLE INTR 7;2 1320 PRINT "Set the Scanner's Channel to No."&VAL$(Ch)&"." 1330 PRINT "Input External Trigger!"...
  • Page 121 Measurement Applications (Sample Programs) Measurement with changing channels (scanning) 1880 Std$="STAN2" 1890 CASE "Load" 1900 Std$="STAN3" 1910 CALL Inp_data("Load(Cp) Value @1kHz",Load1(1)) 1920 CALL Inp_data("Load(D) Value @1kHz",Load2(1)) 1930 CALL Inp_data("Load(Cp) Value @1MHz",Load1(2)) 1940 CALL Inp_data("Load(D) Value @1MHz",Load2(2)) 1950 OUTPUT @Agt4288a;":CORR:CKIT:STAN3:FORM "&Load_para$ 1960 FOR I=1 TO 2 1970...
  • Page 122 Measurement Applications (Sample Programs) Measurement with changing channels (scanning) 2520 GOTO Compen_meas 2530 END IF 2540 NEXT I 2550 PRINT Standard$&" Data Measurement Complete" 2560 OUTPUT @Agt4288a;":SOUR:FREQ ";Curr_freq 2570 RETURN 0 2580 ELSE 2590 PRINT "Program Interruption" 2600 OUTPUT @Agt4288a;":SOUR:FREQ ";Curr_freq 2610 RETURN -1 2620...
  • Page 123: Command Reference

    Command Reference This chapter provides the GPIB command reference for the Agilent 4288A. Each command is fully described and ordered alphabetically based on its abbreviated name format. Use the index to look up a GPIB command by its full syntax. To find a command...
  • Page 124: Notational Conventions In This Command Reference

    The section under the heading “Syntax” describes the syntax used to send the command from the external controller to the 4288A. A syntax consists of a command part and a parameter part, and the separator between these parts is a space.
  • Page 125: Query Response

    Command Reference Query response Query response The section under the heading “Query response” describes the data format read out when query (reading out data) is available with the command. Each readout parameter is enclosed with { } symbols. If there are several items within { } separated by a pipe (|), only one of them is read out.
  • Page 126: Ieee Common Commands

    Command Reference *CLS IEEE Common Commands This section describes the IEEE common commands. *CLS Syntax *CLS Description Clears the following. (No query) • Error Queue • Status Byte Register • Standard Event Status Register • Operation Status Event Register • Questionable Status Event Register Equivalent key No equivalent key is available on the front panel.
  • Page 127: Esr

    *IDN? Syntax *IDN? Description Reads out the product information (manufacturer, model number, serial number, and firmware version number) of the 4288A. (Query only) Query response {string 1},{string 2},{string 3},{string 4}<newline><^END> Readout data is as follows: {string 1} Manufacturer. Agilent Technologies is always read out.
  • Page 128: Opt

    Command Reference *OPT? *OPT? Syntax *OPT? Description Reads out the identification number of an option installed in the 4288A. (Query only) Query response {numeric}<newline><^END> If there is no installed option, 0 is read out. Equivalent key [Config] [Blue] sequence *RCL Syntax *RCL <numeric>...
  • Page 129: Sav

    Command Reference *SAV *SAV Syntax *SAV <numeric> Description Saves the instrument setups to the register of the specified number on EEPROM. For details of saved instrument setups, refer to Appendix D, “Initial Settings.” (No query) Parameters <numeric> Description Specified number Range 0 to 9 Resolution...
  • Page 130: Stb

    Description If the trigger source is set to GPIB (set to BUS with the (:TRIG:SOUR command), triggers the 4288A as it waits for a trigger and reads out the measured data after the measurement is completed. The transfer format of data read out with this command conforms to the setup of the :FORM command.
  • Page 131: Tst

    Command Reference *TST? *TST? Syntax *TST? Description Executes the self-test consisting of the following items and reads out the result. (Query only) Table 10-1 Self-test Items Error Test item Test description code Verifies that the RAM data bus is connected correctly and there is no faulty memory cell.
  • Page 132: 4288A Gpib Commands

    Command Reference :ABOR 4288A GPIB Commands This section describes the GPIB commands of the 4288A. :ABOR Syntax :ABORt Description Resets the trigger system and places the trigger sequence in the idle state. If the trigger system is set to start up successively (ON is specified with the :INIT:CONT command), the trigger system starts up immediately after the transition to the idle state.
  • Page 133: Aver

    Command Reference :AVER :AVER Syntax [:SENSe]:AVERage[:STATe] {ON|OFF|1|0} [:SENSe]:AVERage[:STATe]? Description Turns ON/OFF the averaging function. Parameters Description ON or 1 (initial value) Turns ON the averaging function. OFF or 0 Turns OFF the averaging function. Query response {1|0}<newline><^END> Related commands :AVER:COUN on page 132 Equivalent key [Average] [Blue]...
  • Page 134: Aver:coun

    Command Reference :AVER:COUN :AVER:COUN Syntax [:SENSe]:AVERage:COUNt <numeric> [:SENSe]:AVERage:COUNt? Description Sets the averaging count of the measured value for the averaging function. Unlike setting the averaging count with the front panel keys, using this command to set the averaging count does not automatically turn on the averaging function. Therefore, if the averaging function has been set to off, you have to turn it on by using the :AVER command.
  • Page 135: Cal:cabl

    Command Reference :CAL:CABL :CAL:CABL Syntax :CALibration:CABLe <numeric> :CALibration:CABLe? Description Sets the measurement cable length. Parameters <numeric> Description Desired cable length Range 0 to 2 Initial value Unit m (meter) Resolution If the specified parameter is out of the allowable setup range, the minimum value (if the lower limit of the range is not reached) or the maximum value (if the upper limit of the range is exceeded) is set.
  • Page 136: Calc:comp

    Command Reference :CALC:COMP :CALC:COMP Syntax :CALCulate:COMParator[:STATe] {ON|OFF|1|0} :CALCulate:COMParator[:STATe]? Description Turns ON/OFF the comparator function. This setup is interlocked with the ON/OFF state of the signal output of the handler interface. NOTE Changing the measurement parameter will automatically turn off this function. To avoid this, you have to write a program so that this command is executed after the execution of the measurement parameter setup command (:CALC1:FORM and :CALC2:FORM).
  • Page 137: Calc:comp:auxb

    Command Reference :CALC:COMP:AUXB :CALC:COMP:AUXB Syntax :CALCulate:COMParator:AUXBin {ON|OFF|1|0} :CALCulate:COMParator:AUXBin? Description Turns ON/OFF the AUX_BIN function for sorting of the comparator function. Depending on the ON/OFF state of the AUX_BIN function, the following difference occurs in the sorting result when the measurement result of the secondary parameter exceeds the limit range.
  • Page 138: Calc:comp:beep:cond

    Command Reference :CALC:COMP:BEEP:COND :CALC:COMP:BEEP:COND Syntax :CALCulate:COMParator:BEEPer:CONDition {FAIL|PASS} :CALCulate:COMParator:BEEPer:CONDition? Description Sets the condition for producing a beep sound: when sorting with the comparator fails (sorts into any BIN other than BIN1 to BIN9) or passes (sorts into BIN1 to BIN9). Parameters Description FAIL (initial value) Instructs the instrument to beep when the sorting fails.
  • Page 139: Calc:comp:coun

    Command Reference :CALC:COMP:COUN :CALC:COMP:COUN Syntax :CALCulate:COMParator:COUNt[:STATe] {ON|OFF|1|0} :CALCulate:COMParator:COUNt[:STATe]? Description Turns ON/OFF the BIN counter function of the comparator function. If you turn on this function, the number of DUTs sorted into each BIN based on the comparator sorting result is counted. The maximum count is 999999. If this is exceeded, the count value will not be updated but remain at 999999.
  • Page 140: Calc:comp:coun:data

    Command Reference :CALC:COMP:COUN:DATA? :CALC:COMP:COUN:DATA? Syntax :CALCulate:COMParator:COUNt:DATA? Description Reads out each count value of BIN1 to BIN9, OUT_OF_BINS, and AUX_BIN of the BIN counter function. Reads out all BIN count values regardless of the ON/OFF state of each BIN (set with the :CALC:COMP:PRIM:BIN{1-9}:STAT command).
  • Page 141: Calc:comp:coun:mult:data

    Command Reference :CALC:COMP:COUN:MULT:DATA? :CALC:COMP:COUN:MULT:DATA? Syntax :CALCulate:COMParator:COUNt:MULTi:DATA? Description Reads out each count value of BIN1 to BIN9, OUT_OF_BINS, and AUX_BIN of the selected channel. When the multi-compensation function is tuned off, reads out normal count values (common value for all channels). In other words, this command has the same function as the :CALC:COMP:COUN:DATA? command.
  • Page 142: Calc:comp:coun:mult:ovld

    Command Reference :CALC:COMP:COUN:MULT:OVLD? :CALC:COMP:COUN:MULT:OVLD? Syntax :CALCulate:COMParator:COUNt:MULTi:OVLD? Description Reads out the overload count value of the selected channel. When the multi-compensation function is tuned off, reads out normal count value (common value for all channels). In other words, this command has the same function as the :CALC:COMP:COUN:OVLD? command.
  • Page 143: Calc:comp:mode

    Command Reference :CALC:COMP:MODE :CALC:COMP:MODE Syntax :CALCulate:COMParator:MODE {ABS|DEV|PCNT} :CALCulate:COMParator:MODE? Description Determines how to specify the limit range of the primary parameter for the comparator function. Parameters Description Specifies the limit border value in an absolute value (absolute mode). (initial value) Specifies the border value relative to the reference value as an absolute value (absolute tolerance mode).
  • Page 144: Calc:comp:prim:bin{1-9

    Command Reference :CALC:COMP:PRIM:BIN{1-9} :CALC:COMP:PRIM:BIN{1-9} Syntax :CALCulate:COMParator:PRIMary:BIN{1|2|3|4|5|6|7|8|9} <numeric 1>,<numeric 2> :CALCulate:COMParator:PRIMary:BIN{1|2|3|4|5|6|7|8|9}? Description Sets the limit ranges of BIN1 to BIN9 as the primary parameter used in the comparator function, depending on the designation method set using the :CALC:COMP:MODE command. This command only sets the limit range. To activate it, use the :CALC:COMP:PRIM:BIN{1-9}:STAT command to turn on the BIN for which the limit range has been set.
  • Page 145: Calc:comp:prim:bin{1-9}:Stat

    Command Reference :CALC:COMP:PRIM:BIN{1-9}:STAT :CALC:COMP:PRIM:BIN{1-9}:STAT Syntax :CALCulate:COMParator:PRIMary:BIN{1|2|3|4|5|6|7|8|9}:STATe {ON|OFF|1|0} :CALCulate:COMParator:PRIMary:BIN{1|2|3|4|5|6|7|8|9}:STATe? Description Turns ON/OFF BIN1 to BIN9 of the comparator function. Only BINs that you turn on using this command are used for the sorting judgment of the comparator function. Parameters Description ON or 1 Turns ON BIN.
  • Page 146: Calc:comp:prim:nom

    Command Reference :CALC:COMP:PRIM:NOM :CALC:COMP:PRIM:NOM Syntax :CALCulate:COMParator:PRIMary:NOMinal <numeric> :CALCulate:COMParator:PRIMary:NOMinal? Description Specifies the reference value used when specifying the primary parameter limit range for the comparator function. This value can be used when the limit range designation method is set to either absolute tolerance mode or percent tolerance mode. Parameters <numeric>...
  • Page 147: Calc:comp:sec:lim

    Command Reference :CALC:COMP:SEC:LIM :CALC:COMP:SEC:LIM Syntax :CALCulate:COMParator:SECondary:LIMit <numeric 1>,<numeric 2> :CALCulate:COMParator:SECondary:LIMit? Description Sets the limit range for the secondary parameter used in the comparator function. This command only sets the limit range. To activate the set limit range, use the :CALC:COMP:SEC:STAT command to enable sorting judgment for the measurement result of the secondary parameter.
  • Page 148: Calc:comp:sec:stat

    Command Reference :CALC:COMP:SEC:STAT :CALC:COMP:SEC:STAT Syntax :CALCulate:COMParator:SECondary:STATe {ON|OFF|1|0} :CALCulate:COMParator:SECondary:STATe? Description Sets whether to enable sorting judgment for the measurement result of the secondary parameter when using the comparator function. Parameters Description ON or 1 Enables sorting judgment for the measurement result of the (initial value) secondary parameter.
  • Page 149: Calc1:Form

    Command Reference :CALC1:FORM :CALC1:FORM Syntax :CALCulate1:FORMat {CP|CS} :CALCulate1:FORMat? Description Specifies the primary parameter to be measured. When the secondary parameter has been set to G or RP and the primary parameter is set to CS, the secondary parameter is automatically changed to D. Also, when the secondary parameter has been set to RS and the primary parameter is set to CP, the secondary parameter is automatically changed to D.
  • Page 150: Calc1:Math:expr:name

    Command Reference :CALC1:MATH:EXPR:NAME :CALC1:MATH:EXPR:NAME Syntax :CALCulate1:MATH:EXPRession:NAME {DEV|PCNT} :CALCulate1:MATH:EXPRession:NAME? Description Specifies the expression of the primary parameter used when displaying the measurement result in the deviation measurement mode. Parameters Description Displays the result in the difference between the measurement (initial value) value and the reference value (measurement value - reference value).
  • Page 151: Calc1:Math:stat

    Command Reference :CALC1:MATH:STAT :CALC1:MATH:STAT Syntax :CALCulate1:MATH:STATe {ON|OFF|1|0} :CALCulate1:MATH:STATe? Description Determines whether to use the function (deviation measurement mode) that displays the primary parameter measurement result in deviation from the reference value (set using the :DATA command). NOTE Changing any of the measurement parameters will automatically disable this function. To avoid this, you have to write a program so that this command is executed after the execution of the measurement parameter setup command (:CALC1:FORM and :CALC2:FORM).
  • Page 152: Calc2:Form

    Command Reference :CALC2:FORM :CALC2:FORM Syntax :CALCulate2:FORMat {D|Q|G|RP|RS} :CALCulate2:FORMat? Description Specifies the secondary parameter to be measured. If the primary parameter has been set to CP and the secondary parameter is set to RS, the primary parameter is automatically changed to CS. Also, if the primary parameter has been set to CS and the secondary parameter is set to G or RP, the primary parameter is automatically set to CP.
  • Page 153: Calc2:Math:expr:name

    Command Reference :CALC2:MATH:EXPR:NAME :CALC2:MATH:EXPR:NAME Syntax :CALCulate2:MATH:EXPRession:NAME {DEV|PCNT} :CALCulate2:MATH:EXPRession:NAME? Description Specifies the expression of the secondary parameter used when displaying the measurement result in the deviation measurement mode. Parameters Description Displays the result as the difference between the measurement (initial value) value and the reference value (measurement value - reference value).
  • Page 154: Calc2:Math:stat

    Command Reference :CALC2:MATH:STAT :CALC2:MATH:STAT Syntax :CALCulate2:MATH:STATe {ON|OFF|1|0} :CALCulate2:MATH:STATe? Description Determines whether to use the function (deviation measurement mode) that displays the secondary parameter measurement result as deviation from the reference value (set using the :DATA command). NOTE Changing any of the measurement parameters will automatically disable this function. To avoid this, you have to write a program so that this command is executed after the execution of the measurement parameter setup command (:CALC1:FORM and :CALC2:FORM).
  • Page 155: Calc3:Math:stat

    Command Reference :CALC3:MATH:STAT :CALC3:MATH:STAT Syntax :CALCulate3:MATH:STATe {ON|OFF|1|0} :CALCulate3:MATH:STATe? Description Determines whether to use the monitor function of the current flowing through the DUT during measurement. Parameters Description ON or 1 Enables the current monitor function. OFF or 0 (initial value) Disables the current monitor function.
  • Page 156: Corr:ckit:stan1:Form

    Command Reference :CORR:CKIT:STAN1:FORM :CORR:CKIT:STAN1:FORM Syntax [:SENSe]:CORRection:CKIT:STANdard1:FORMat {GB|CPG} [:SENSe]:CORRection:CKIT:STANdard1:FORMat? Description Sets the parameter types of the OPEN compensation data. Parameters Description GB (initial value) Specifies G as the primary parameter and B as the secondary parameter. Specifies CP as the primary parameter and G as the secondary parameter.
  • Page 157: Corr:ckit:stan3

    Command Reference :CORR:CKIT:STAN3 :CORR:CKIT:STAN3 Syntax [:SENSe]:CORRection:CKIT:STANdard3 <numeric 1>,<numeric 2> [:SENSe]:CORRection:CKIT:STANdard3? Description Defines the values of the LOAD compensation standard for the parameters you specify by using the :CORR:CKIT:STAN3:FORM command. These are set as the standard values for the measurement frequency when executing the command (set with the :SOUR:FREQ command).
  • Page 158: Corr:ckit:stan3:Form

    Command Reference :CORR:CKIT:STAN3:FORM :CORR:CKIT:STAN3:FORM Syntax [:SENSe]:CORRection:CKIT:STANdard3:FORMat {CPD|CPQ|CPG|CPRP|CSD|CSQ|CSRS} [:SENSe]:CORRection:CKIT:STANdard3:FORMat? Description Sets the types of parameters used to define the standard for LOAD compensation. Parameters Description Specifies CP as the primary parameter, D as the secondary parameter. (initial value) Specifies CP as the primary parameter, Q as the secondary parameter. Specifies CP as the primary parameter, G as the secondary parameter.
  • Page 159: Corr:coll

    Command Reference :CORR:COLL :CORR:COLL Syntax [:SENSe]:CORRection:COLLect[:ACQuire] {STANdard1|STANdard2|STANdard3} Description Measures the compensation data for OPEN/SHORT/LOAD compensation and turns on the compensation function. These compensation data are measured for the measurement frequency used in executing the command (set with the :SOUR:FREQ command). When using the multi-compensation function (set to ON with the :CORR:MULT command), this is measured as the compensation data for the selected channel when executing the command (selected with the :CORR:MULT:CHAN command).
  • Page 160: Corr:data

    Command Reference :CORR:DATA :CORR:DATA Syntax [:SENSe]:CORRection:DATA {STANdard1|STANdard2|STANdard3},<numeric 1>,<numeric 2> [:SENSe]:CORRection:DATA? {STANdard1|STANdard2|STANdard3} Description Sets the compensation data for OPEN/SHORT/LOAD compensation. These compensation data are measured for the measurement frequency used in executing the command (set with the :SOUR:FREQ command). When using the multi-compensation function (set to ON with the :CORR:MULT command), this is set as the compensation data for the selected channel when executing the command (selected with the :CORR:MULT:CHAN command).
  • Page 161 Command Reference :CORR:DATA • When specifying STANdard3 as parameter 1: Parameter 2: <numeric 1> Parameter 3: <numeric 2> Description Value of the secondary Value of the primary parameter parameter Range -999.999 to 999.999 -99.9999E9 to 99.9999E9 Initial value 100E-9 Unit F (farad) Depends on the type of parameter.
  • Page 162: Corr:load

    Command Reference :CORR:LOAD :CORR:LOAD Syntax [:SENSe]:CORRection:LOAD[:STATe] {ON|OFF|1|0} [:SENSe]:CORRection:LOAD[:STATe]? Description Turns ON/OFF the LOAD compensation function. With the LOAD compensation set to ON, if you change the cable length (set with the :CAL:CABL command) or frequency shift (set with the :SYST:FSH command), the LOAD compensation is automatically changed to OFF.
  • Page 163: Corr:mult

    Command Reference :CORR:MULT :CORR:MULT Syntax [:SENSe]:CORRection:MULTiple[:STATe] {ON|OFF|1|0} [:SENSe]:CORRection:MULTiple[:STATe]? Description Turns ON/OFF the multi-compensation function. This setup is interlocked with the ON/OFF state of the signal output of the scanner interface. Parameters Description ON or 1 Turns ON the multi-compensation function. OFF or 0 (initial value) Turns OFF the multi-compensation function.
  • Page 164: Corr:mult:ckit:stan3

    Command Reference :CORR:MULT:CKIT:STAN3 :CORR:MULT:CKIT:STAN3 Syntax [:SENSe]:CORRection:MULTiple:CKIT:STANdard3[:STATe] {ON|OFF|1|0} [:SENSe]:CORRection:MULTiple:CKIT:STANdard3[:STATe]? Description Determines whether to define the standard values for LOAD compensation for each channel individually when using the multi-compensation function (set to ON with the :CORR:MULT command). Parameters Description ON or 1 Enables channel-by-channel value definition.
  • Page 165: Corr:offs

    Command Reference :CORR:OFFS :CORR:OFFS Syntax [:SENSe]:CORRection:OFFSet[:STATe] {ON|OFF|1|0} [:SENSe]:CORRection:OFFSet[:STATe]? Description Turns ON/OFF the offset compensation function. NOTE Changing this parameter will automatically turn off this function. To avoid this, you have to write a program so that this command is executed after the execution of the measurement parameter setup command (:CALC1:FORM and :CALC2:FORM).
  • Page 166: Corr:offs:data

    Command Reference :CORR:OFFS:DATA :CORR:OFFS:DATA Syntax [:SENSe]:CORRection:OFFSet:DATA <numeric 1>,<numeric 2> [:SENSe]:CORRection:OFFSet:DATA? Description Sets the compensation values for the primary parameter and secondary parameter used in the offset compensation function. These compensation data are measured for the measurement frequency used in executing the command (set with the :SOUR:FREQ command).
  • Page 167: Corr:open

    Command Reference :CORR:OPEN :CORR:OPEN Syntax [:SENSe]:CORRection:OPEN[:STATe] {ON|OFF|1|0} [:SENSe]:CORRection:OPEN[:STATe]? Description Turns ON/OFF the OPEN compensation. With the OPEN compensation set to ON, if you change the cable length (set with the :CAL:CABL command) or frequency shift (set with the :SYST:FSH command), the OPEN compensation is automatically changed to OFF.
  • Page 168: Crej

    Command Reference :CREJ :CREJ Syntax [:SENSe][:FIMPedance]:CREJect[:STATe] {ON|OFF|1|0} [:SENSe][:FIMPedance]:CREJect[:STATe]? Description Enables/disables the Low C reject function. When you enable the Low C reject function, if the measured value of the primary parameter (Cp or Cs) is too small (equal to or less than the boundary value specified with the :CREJ:LIM command), Low C is detected.
  • Page 169: Crej:lim

    Command Reference :CREJ:LIM :CREJ:LIM Syntax [:SENSe][:FIMPedance]:CREJect:LIMit <numeric> [:SENSe][:FIMPedance]:CREJect:LIMit Description Sets the boundary value (percentage of the measurement range) within the detection range of Low C when you turn on the Low C reject function. The measurement range to which the set value is applied differs depending on the setup of the measurement range mode as shown below.
  • Page 170: Data

    Command Reference :DATA :DATA The function of this command when executed varies depending on the 1st parameter specified as shown in the table below. 1st parameter Function BUF1, BUF2 or Reads out data in data buffer 1, data buffer 2, or data buffer 3. For details, refer to :DATA? {BUF1|BUF2|BUF3} on page 168.
  • Page 171 Command Reference :DATA Query response When specifying BUF1 or BUF2 as parameter {numeric 1},{numeric 2},{numeric 3},…,{numeric (N × 3)}<newline><^END> The N sets of measurement data (a data set consists of the measurement status, measured value, and comparator sorting result) fed into the data buffer are read out in the order of measurement.
  • Page 172 Command Reference :DATA When specifying BUF3 as parameter (Comparator: OFF) × … {numeric 1},{numeric 2},{numeric 3}, ,{numeric (N 3)}<newline><^END> The N sets of measurement data (a data set consists of the measurement status, measured value, and comparator sorting result) fed into the data buffer are read out in the order of measurement.
  • Page 173 Command Reference :DATA :DATA? {IMON|VMON} Syntax :DATA[:DATA]? {IMON|VMON} Description Reads out the current monitor value or voltage monitor value of the measured signal. If the monitor function is disabled (OFF has been specified with the :CALC3:MATH:STAT command or :CALC4:MATH:STAT command) or the measurement fails, 9.9E37 is read out.
  • Page 174 Command Reference :DATA :DATA {REF1|REF2} Syntax :DATA[:DATA] {REF1|REF2},<numeric> :DATA[:DATA]? {REF1|REF2} Description Sets the reference value used in the deviation measurement mode for the primary parameter or secondary parameter. This reference value is used when the deviation measurement mode has been enabled for the primary parameter or secondary parameter (ON has been specified with the :CALC1:MATH:STAT command or :CALC2:MATH:STAT command).
  • Page 175: Data:feed

    Command Reference :DATA:FEED :DATA:FEED Syntax :DATA:FEED {BUF1|BUF2},{"CALCulate1"|"CALCulate2"|""} :DATA:FEED? {BUF1|BUF2} Description Selects the measurement data fed into data buffer 1 or data buffer 2 from the following: primary parameter, secondary parameter, or none to be fed. The query response is a string with double quotation marks (“).
  • Page 176: Data:feed:cont

    Command Reference :DATA:FEED:CONT :DATA:FEED:CONT Syntax :DATA:FEED:CONTrol {BUF1|BUF2|BUF3},{ALWays|NEVer} :DATA:FEED:CONTrol? {BUF1|BUF2|BUF3} Description Determines whether to feed the measurement data into data buffer 1, data buffer 2, or data buffer 3. Parameters Description BUF1 Specifies data buffer 1 as the buffer to which the {ALWays|NEVer} setup is applied or reads out the setup of data buffer 1.
  • Page 177: Data:poin

    Command Reference :DATA:POIN :DATA:POIN Syntax :DATA:POINts {BUF1|BUF2|BUF3},<numeric> :DATA:POINts? {BUF1|BUF2|BUF3} Description Specifies the size of data buffer 1, data buffer 2, or data buffer 3 in number of measurements. Executing this command returns the pointer to the specified data buffer (the location to feed measurement data) back to the start.
  • Page 178: Disp

    Command Reference :DISP :DISP Syntax :DISPlay[:WINDow][:STATe] {ON|OFF|1|0} :DISPlay[:WINDow][:STATe]? Description Enables/disables the display of the measurement result. If you disables the display, “DISP OFF” is always displayed on the screen. Parameters Description ON or 1 (initial value) Enables the display. OFF or 0 Disables the display.
  • Page 179: Disp:text1:Fmsd

    Command Reference :DISP:TEXT1:FMSD :DISP:TEXT1:FMSD Syntax :DISPlay[:WINDow]:TEXT1[:DATA]:FMSD[:STATe] {ON|OFF|1|0} :DISPlay[:WINDow]:TEXT1[:DATA]:FMSD[:STATe]? Description Determines whether to use the fixed point display when displaying both the primary and secondary parameters. In the following cases, the fixed point display is always used regardless of this setting (the value of the highest digit is also fixed). •...
  • Page 180: Disp:text1:Fmsd:data

    Command Reference :DISP:TEXT1:FMSD:DATA :DISP:TEXT1:FMSD:DATA Syntax :DISPlay[:WINDow]:TEXT1[:DATA]:FMSD:DATA <numeric 1>,<numeric 2> :DISPlay[:WINDow]:TEXT1[:DATA]:FMSD:DATA? Description Sets the value of the highest digit when displaying both the primary and secondary parameters in the fixed point display. The parameter is always fixed to the same value, regardless of this setting, if the following conditions are met: •...
  • Page 181: Disp:text2:Page

    Command Reference :DISP:TEXT2:PAGE :DISP:TEXT2:PAGE Syntax :DISPlay[:WINDow]:TEXT2:PAGE <numeric> :DISPlay[:WINDow]:TEXT2:PAGE? Description Selects the page number of the instrument setup display area located on the right of the display. The correspondence between the page number and the displayed item is as follows: Page Description of displayed item number Measurement frequency and measurement signal level.
  • Page 182 Command Reference :DISP:TEXT2:PAGE Page Description of displayed item number OPEN compensation data (primary parameter) OPEN compensation data (secondary parameter) SHORT compensation data (primary parameter) SHORT compensation data (secondary parameter) LOAD compensation data (primary parameter) LOAD compensation data (secondary parameter) LOAD compensation standard definition value (primary parameter) LOAD compensation standard definition value (secondary parameter) OFFSET compensation data (primary parameter) OFFSET compensation data (secondary parameter)
  • Page 183: Fetc

    Syntax :FETCh? Description Reads out the measurement result. The target measurement to read out depends on the state of the 4288A. • During measurement: Waits for end of the measurement and then reads out its result. • Other states: Reads out the result of the immediately preceding measurement.
  • Page 184: Form

    Command Reference :FORM :FORM Syntax :FORMat[:DATA] {ASCii|REAL[,64]} :FORMat[:DATA]? Description Sets the transfer format of data read out using the following commands: :FETC? on page 181 • • :READ? on page 186 *TRG on page 128 • :DATA on page 168 •...
  • Page 185: Init

    Command Reference :INIT :INIT Syntax :INITiate[:IMMediate] Description Starts the trigger system once. If the trigger system is in the idle state, executing this command starts the trigger system and, after measurement is executed once, returns the instrument to the idle state. If the trigger system is not in the idle state or successive startup of the trigger system is enabled (set to ON with the :INIT:CONT command), executing this command causes an error and the command is ignored.
  • Page 186: Rang

    Command Reference :RANG :RANG Syntax [:SENSe][:FIMPedance]:RANGe[:UPPer] <numeric>[PF|P|NF|N|UF|U|MF|M|F] [:SENSe][:FIMPedance]:RANGe[:UPPer]? Description Sets the measurement range. With the measurement frequency and the measurement range set to 1 MHz and 47E-12 (47p) or less, respectively, changing the measurement frequency to 1 kHz will automatically set the measurement range to 100E-12 (100p). On the other hand, with the measurement frequency and the measurement range set to 1 kHz and 2.2E-9 (2.2n) or more, respectively, changing the measurement frequency to 1 MHz will automatically set the measurement range to 1E-9 (1n).
  • Page 187: Rang:auto

    Command Reference :RANG:AUTO :RANG:AUTO Syntax [:SENSe][:FIMPedance]:RANGe:AUTO {ON|OFF|1|0} [:SENSe][:FIMPedance]:RANGe:AUTO? Description Selects the measurement range mode from the auto range (automatic range switching) or hold range (fixed range). Setting the measurement range (set with the :RANG command) automatically selects the hold range mode. Parameters Description ON or 1 (initial value)
  • Page 188: Read

    Waits for the end of measurement and reads out the measurement result. Executing this command brings the 4288A into the trigger wait state. When the trigger system is in the idle state, this command invokes the trigger system (the :INIT command) once and then brings the instrument into the trigger wait state.
  • Page 189: Sour:freq

    Command Reference :SOUR:FREQ :SOUR:FREQ Syntax :SOURce:FREQuency[:CW] <numeric>[HZ|KHZ|K] :SOURce:FREQuency[:CW]? Description Sets the measurement frequency. Depending on this setting, the available measurement range varies (set with the :RANG command). If changing the measurement frequency results in a conflict with the measurement range setting, an acceptable range is automatically selected. Parameters <numeric>...
  • Page 190: Sour:volt

    Command Reference :SOUR:VOLT :SOUR:VOLT Syntax :SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude] <numeric>[MV|M|V] :SOURce:VOLTage[:LEVel][:IMMediate][:AMPLitude]? Description Sets the measurement signal level. Parameters <numeric> Description Measurement signal level Range 100E-3 to 1 Initial value Unit Resolution If the specified parameter is out of the allowable setup range, the minimum value (if the lower limit of the range is not reached) or the maximum value (if the upper limit of the range is exceeded) is set.
  • Page 191: Stat:oper

    Command Reference :STAT:OPER? :STAT:OPER? Syntax :STATus:OPERation[:EVENt]? Description Reads out the value of the Operation Status Event register. (Query only) Query response {numeric}<newline><^END> Related commands *CLS on page 124 Equivalent key No equivalent key is available on the front panel. sequence :STAT:OPER:COND? Syntax :STATus:OPERation:CONDition?
  • Page 192: Stat:pres

    :STAT:QUES:ENAB Syntax :STATus:QUEStionable:ENABle <numeric> :STATus:QUEStionable:ENABle? Description Sets the value of the Questionable Status Enable register. However, the 4288A does not support the Questionable Status register. Therefore, executing this command has no effect. Query response {numeric}<newline><^END> Equivalent key No equivalent key is available on the front panel.
  • Page 193: Syst:beep

    Command Reference :SYST:BEEP :SYST:BEEP Syntax :SYSTem:BEEPer[:IMMediate] Description Produces a beep sound. If the beep sound is disabled (OFF has been specified with the :SYST:BEEP:STAT command), no beep sound is produced even if you execute this command. (No query) Related commands :SYST:BEEP:STAT on page 191 Equivalent key No equivalent key is available on the front panel.
  • Page 194: Syst:err

    :SYST:ERR? :SYST:ERR? Syntax :SYSTem:ERRor? Description Reads out the oldest error remaining in the 4288A's error queue. The size of the error queue is 10. Executing the *CLS command clears errors stored in the error queue. (Query only) Query response {numeric},{string}<newline><^END>...
  • Page 195: Syst:kloc

    Command Reference :SYST:KLOC :SYST:KLOC Syntax :SYSTem:KLOCk {ON|OFF|1|0} :SYSTem:KLOCk? Description Locks or unlocks the front panel keys. Parameters Description ON or 1 Locks the keys. OFF or 0 (initial value) Unlocks the keys. Query response {1|0}<newline><^END> Equivalent key [Key Lock] [Blue] sequence :SYST:PRES Syntax...
  • Page 196: Syst:test

    H with BNC cables). For more information on the external test, refer to 4288A Service Manual. Query response {numeric 1},{numeric 2},{numeric 3},{numeric 4},{numeric 5}<newline><^END> For a test item that fails, the following information is read out. When all of the test items pass, all read-out values are 0.
  • Page 197: Trig

    Command Reference :TRIG :TRIG Syntax :TRIGger[:SEQuence1][:IMMediate] Description Immediately generates a trigger and executes a measurement regardless of the setup of the trigger mode. If the trigger system is not in the trigger wait state (trigger event detection state), executing this command causes an error and the command is ignored. For details on the trigger system, refer to “Trigger system”...
  • Page 198: Trig:sour

    Command Reference :TRIG:SOUR :TRIG:SOUR Syntax :TRIGger[:SEQuence1]:SOURce {INTernal|MANual|EXTernal|BUS} :TRIGger[:SEQuence1]:SOURce? Description Selects the trigger mode from the following four types. Internal Configures the instrument to use its internal trigger source so that is it automatically and continuously triggered. Manual Configures the instrument to be triggered when you press the [Trig] key on the front panel.
  • Page 199: Gpib Command Table

    Command Reference GPIB Command Table Table 10-2 lists the 4288A GPIB commands sorted according to function Table 10-2 GPIB Command Table Function Item to Be Set Up/Executed GPIB command :SYST:PRES on page 193, *RST on page 126 Measurement Reset condition...
  • Page 200 Command Reference Table 10-2 GPIB Command Table Function Item to Be Set Up/Executed GPIB command Trigger Triggers a measurement :TRIG on page 195, *TRG on page 128 Trigger mode setup :TRIG:SOUR on page 196 Trigger delay time setup :TRIG:DEL on page 195 :ABOR on page 130 Trigger system Resets :INIT on page 183...
  • Page 201 Command Reference Table 10-2 GPIB Command Table Function Item to Be Set Up/Executed GPIB command Measurement Current ON/OFF :CALC3:MATH:STAT on page 153 signal monitor monitor :DATA? {IMON|VMON} on page 171 Monitor value readout :CALC4:MATH:STAT on page 153 Voltage ON/OFF monitor :DATA? {IMON|VMON} on page 171 Monitor value readout Save/Recall...
  • Page 202 Command Reference Table 10-2 GPIB Command Table Function Item to Be Set Up/Executed GPIB command Others 1 MHz frequency shift setup :SYST:FSH on page 192 Executes self-test Internal *TST? on page 129 External :SYST:TEST? on page 194 *IDN? on page 125 Readout of the model name and firmware version *OPT? on page 126...
  • Page 203: Front Panel Key Tree Vs. Gpib Command

    Command Reference Front Panel Key Tree vs. GPIB Command Table 10-3 shows the commands that correspond to operation of the front panel keys. Table 10-3 Front panel key tree vs. GPIB command Key operation GPIB command Nothing [Adrs] :RANG:AUTO on page 185 [Auto/Hold] :AVER on page 131 [Average]...
  • Page 204 Command Reference Table 10-3 Front panel key tree vs. GPIB command Key operation GPIB command :CALC3:MATH:STAT on page 153 [Level Mon] :CALC4:MATH:STAT on page 153 :CORR:LOAD on page 160 [Load] On/Off :CORR:COLL on page 157 LoadMeas :CORR:CKIT:STAN3:FORM on page 156 CorVal PrmSlct :CORR:CKIT:STAN3 on page 155...
  • Page 205: Gpib Command Tree

    Command Reference GPIB Command Tree Table 10-4 shows the 4288A GPIB command tree. Table 10-4 4288A GPIB command tree Command Parameter Note ABORt [No query] CALCulate :COMParator :AUXBin {ON|OFF|1|0} :BEEPer :CONDition {PASS|FAIL} [:STATe] {ON|OFF|1|0} :CLEar [No query] :COUNt :CLEar [No query]...
  • Page 206 Command Reference Table 10-4 4288A GPIB command tree Command Parameter Note CALCulate4 :MATH :STATe {ON|OFF|1|0} CALibration :CABle <numeric> DATA [:DATA] {REF1|REF2},<numeric> [:DATA]? {BUF1|BUF2} [Query only] {IMON|VMON} [Query only] :FEED {BUF1|BUF2},{"CALCulate1"|"CALCulate2"|""} :CONTrol {BUF1|BUF2},{ALWays|NEVer} :POINts {BUF1|BUF2},<numeric> DISPlay [:WINDow] [:STATe] {ON|OFF|1|0} :TEXT1 [:DATA] :DIGit <numeric>...
  • Page 207 Command Reference Table 10-4 4288A GPIB command tree Command Parameter Note [SENSe] :AVErage :COUNt <numeric> [:STATe] {ON|OFF|1|0} [:FIMPedance] :APERture [:MODE] {SHORt|MEDium|LONG} :CREJect :LIMit <numeric> [:STATe] {ON|OFF|1|0} :RANGe :AUTO {ON|OFF|1|0} [:UPPer] <numeric>[PF|P|NF|N|UF|U|MF|M|F] :CORRection :CKIT :STANdard1 :FORMat {GB|CPG} :STANdard2 :FORMat {RX|LSRS} :STANdard3 <numeric>,<numeric>...
  • Page 208 Command Reference Table 10-4 4288A GPIB command tree Command Parameter Note STATus :OPERation :CONDition? [Query only] :ENABle <numeric> [:EVENt]? [Query only] :PRESet [No query] :QUEStionable :CONDition? [Query only] :ENABle <numeric> [:EVENt]? [Query only] SYSTem :BEEPer [:IMMediate] [No query] :STATe {ON|OFF|1|0}...
  • Page 209: Manual Changes

    This appendix contains the information required to adapt this manual to earlier versions or configurations of the Agilent 4288A than that indicated by the current printing date of this manual. The information in this manual applies directly to the 4288A model that has the...
  • Page 210: Manual Changes

    Manual Changes Manual Changes Manual Changes To adapt this manual to your Agilent 4288A, refer to Table A-1 and Table A-2. Table A-1 Manual Changes by Serial Number Serial Prefix or Number Make Manual Changes Table A-2 Manual Changes by Firmware Version...
  • Page 211: Change 1

    Manual Changes Manual Changes Change 1 The firmware revision 1.00 does not support the following function and command. Please delete their descriptions in this manual. • External test :SYST:TEST? command on page 194 • Change 2 The firmware revisions 1.00 and 1.10 do not support the following functions and commands.
  • Page 212 Manual Changes Manual Changes Appendix A...
  • Page 213: Information For Replacing 4278A With 4288A

    This appendix describes information that is applicable when replacing the Agilent 4278A with the Agilent 4288A. See the 4278A Operation Manual for more detailed information on the 4278A. See the 4288A Operation Manual and the other chapters of this manual (Programming Manual) for more detailed information on the 4288A.
  • Page 214: Functional Comparison And Gpib Command Correspondence

    Functional Comparison and GPIB Command Correspondence This section compares the functions of the 4278A and 4288A and shows the correspondence between the instruments’ usage of GPIB commands. Refer to Table B-25 on page 238 and Table B-26 on page 241 for at-a-glance lists showing the correspondences of all GPIB commands.
  • Page 215: Measurement Signal

    *1.The frequency shift of the 4278A is fixed to a constant value, depending on the config- uration options. No command is available to alter the value. High-accuracy measurement (HI-ACC) mode The 4288A does not have a function corresponding to the 4278A’s high-accuracy measurement (HI-ACC) mode at the measurement frequency of 1 MHz. Appendix B...
  • Page 216: Measurement Range

    4278A. The measurement ranges that can be set for the 4278A, except for the 100 µ F range, can also be set for the 4288A. If you select only these measurement ranges, the 4288A provides the same level of accuracy as the 4278A.
  • Page 217 Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence GPIB command correspondence Table B-4 Correspondence of measurement range setup commands Setup GPIB command Measurement range Measurement frequency 4278A 4288A 4278A 4288A Auto Auto :RANG:AUTO ON :RANG 100PF...
  • Page 218: Integration Time (Measurement Time)/Averaging

    1 to 256 Averaging count Only 9 points: Resolution 1,2,4,8,16,32,64,128,256 *1.The SHORT mode of the 4288A corresponds to both the SHORT and MEDIUM modes of the 4278A. Differences in usage of GPIB commands 4278A 4288A The averaging function cannot be turned...
  • Page 219: Trigger/Delay (Trigger Delay) Time

    *1.For the 4278A, no discrimination needs to be made between the EXT mode and the BUS mode. On the other hand, for the 4288A, you must specify the EXT mode when supplying a trigger from an external trigger terminal or handler interface or the BUS mode when supplying a trigger through GPIB.
  • Page 220: Compensation

    Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence Compensation Functional comparison 4278A 4288A Each compensation can be Each compensation can be ON/OFF turned ON/OFF separately. turned ON/OFF separately. OPEN Cp-G G-B, Cp-G Parameter format of SHORT...
  • Page 221 Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence GPIB command correspondence Table B-8 Correspondence of compensation function commands GPIB command Function 4278A 4288A OPEN0 :CORR:OPEN OFF OPEN compensation OPEN1 :CORR:OPEN ON SHOR0 :CORR:SHOR OFF SHORT compensation...
  • Page 222: Multi-Compensation

    Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence Multi-compensation Functional comparison 4278A 4288A Number of channels 256 channels 64 channels GPIB command, scanner interface Front panel, GPIB command, scanner Channel selection (/CH0 to /CH7) interface (/CH0 to /CH5)
  • Page 223: Comparator

    Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence Comparator Functional comparison 4278A 4288A Cp-D, Cp-Q, Cp-G, Cs-D, Cp-D, Cp-Q, Cp-G, Cp-Rp, Sorting target parameter Cs-Q, Cs-Rs Cs-D, Cs-Q, Cs-Rs Reverse parameter function Available Using a deviation from...
  • Page 224 Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence Table B-10 List of instrument’s responses to UNBAL/OVLD and Low C Notification on the display GPIB output Activated handler interface signal(s) Measurement Comparator Measurement Comparator results sorting results...
  • Page 225 *2.The limit is specified as a percentage of the measurement range. Thus, for the same limit (%) value, the 4278A and the 4288A may show different boundary values where Low C is actually detected if the measurement ranges are not identical.
  • Page 226: Display

    4288A’s fixed point display is the same as that of the 4278A. The display (LCD) of the 4288A is smaller than that of the 4278A. This prevents the 4288A from simultaneously displaying all of the items that can be displayed at one time with the 4278A, as shown in Table B-12.
  • Page 227 Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence Table B-12 Displayed item 4278A 4288A Displayed item MEAS LIMIT SORT STATUS PAGE PAGE PAGE PAGE × × ❍ ❍ ❍ Primary parameter Measurement × × ❍ ❍...
  • Page 228 Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence Table B-13 Msd settings needed to make the 4288A’s fixed point display equivalent to that of the 4278A Primary parameter Measurement Secondary parameter Measurement signal range frequency Cp, Cs 100 pF 1 M Ω...
  • Page 229 Display mode TOL display mode (percentage DVAL2 :CALC1:MATH:STAT ON :CALC1:MATH:EXPR:NAME PCNT display of deviation *1.For the 4278A, use the NOM= command to set the reference value. For the 4288A, use the :DATA {REF1|REF2} command to set the reference value. Appendix B...
  • Page 230: Reading Out The Measurement Result

    (*LRN?) use each command for reading out.) The 4288A does not provide a continuous data output function (spew-out mode). However, by executing measurement (executing the :READ? command and then supplying a trigger), you can read out the measurement result upon completion of measurement.
  • Page 231 Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence Figure B-1 Comparison of binary format GPIB command correspondence Table B-15 Correspondence of measurement data readout related commands GPIB command Function 4278A 4288A DFMT1 :FORM ASC ASCII Data output (data transfer)
  • Page 232: Save/Recall And Resume

    Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence Save/recall and resume Functional comparison 4278A 4288A Capacity One setup Ten setups Storage Memory card Built-in EEPROM Save/recall media Contents of the memory card is N/A (Resume function is used Auto recall automatically recalled at power-on.
  • Page 233 Information for Replacing 4278A with 4288A Functional Comparison and GPIB Command Correspondence The following table shows the relationship between each bit of the status byte register of the 4278A and the corresponding bit of the 4288A’s register. 4278A 4288A (Status byte register)
  • Page 234: Example Of Replacing Major Functions (Comparison Of Programs)

    Comparator Sequential mode (absolute mode) Table B-18 compares the programs used by the 4278A and 4288A to set the limit ranges. These ranges are the Cp limit range as shown in the following figure and the D limit range from 0 to 0.1 in the sequential mode (absolute mode).
  • Page 235 Example of Replacing Major Functions (comparison of programs) Tolerance mode Table B-19 compares the programs used by the 4278A and 4288A to set the limit ranges. These ranges are the Cp limit range as shown in the following figure and the D limit range from 0 to 0.1 in the tolerance mode.
  • Page 236: Reading Out The Measurement Result

    Reading out the measurement result Continuous data output (spew-out mode) The 4288A does not provide a continuous data output function (spew-out mode). However, as shown in the following figure, by executing the :READ? command and then supplying a trigger when executing measurement, you can read out a measurement result after completion of measurement that is similar to the as-is data output of the 4278A.
  • Page 237 Information for Replacing 4278A with 4288A Example of Replacing Major Functions (comparison of programs) Reading out the results for any measurement (Data buffer function) Table B-21 compares the programs used by the 4278A and 4288A to read out the results of 100 measurements. Table B-21...
  • Page 238: Compensation

    Information for Replacing 4278A with 4288A Example of Replacing Major Functions (comparison of programs) Compensation Table B-22 compares the programs used by the 4278A and 4288A to perform Open/Short/Standard (Load) compensation. Table B-22 Comparison of programs used to perform Open/Short/Standard (Load)
  • Page 239: Status Register (Status Report System)

    Information for Replacing 4278A with 4288A Example of Replacing Major Functions (comparison of programs) Status register (status report system) Table B-23 compares the programs used by the 4278A and 4288A to detect the completion of measurement. Table B-23 Comparison of programs used to detect completion of measurement...
  • Page 240: At-A-Glance List Of Gpib Command Correspondence

    Table B-25 (alphabetical order of 4278A commands) and Table B-26 (by function of 4278A commands) provide at-a-glance lists of the GPIB command correspondence between the 4278A and the 4288A. For details on the command correspondence, refer to “Functional Comparison and GPIB Command Correspondence” on page 212.
  • Page 241 Information for Replacing 4278A with 4288A At-a-Glance List of GPIB Command Correspondence Table B-25 At-a-glance list of GPIB command correspondence between 4278A and 4288A (alphabetical order) 4278A Function overview 4288A DSTD= Sets the D value of the standard for the standard (LOAD) compensation.
  • Page 242 Information for Replacing 4278A with 4288A At-a-Glance List of GPIB Command Correspondence Table B-25 At-a-glance list of GPIB command correspondence between 4278A and 4288A (alphabetical order) 4278A Function overview 4288A SHM? Reads out the measured SHORT compensation value (data for SHORT :CORR:DATA on page 158 compensation).
  • Page 243 Information for Replacing 4278A with 4288A At-a-Glance List of GPIB Command Correspondence Table B-26 At-a-glance list of GPIB command correspondence between 4278A and 4288A (by function) Item to Be Set Up/Executed 4278A 4288A *RST :SYST:PRES on page 193 Measurement Reset...
  • Page 244 Information for Replacing 4278A with 4288A At-a-Glance List of GPIB Command Correspondence Table B-26 At-a-glance list of GPIB command correspondence between 4278A and 4288A (by function) Item to Be Set Up/Executed 4278A 4288A Scanner (multi ON/OFF MCOM{0|1} :CORR:MULT on page 161...
  • Page 245 Information for Replacing 4278A with 4288A At-a-Glance List of GPIB Command Correspondence Table B-26 At-a-glance list of GPIB command correspondence between 4278A and 4288A (by function) Item to Be Set Up/Executed 4278A 4288A Display Display format setup DPAG{1-4} Setup of the number of display digits for the measurement...
  • Page 246: Comparison Of Interfaces

    Information for Replacing 4278A with 4288A Comparison of Interfaces Comparison of Interfaces Handler interface Figure B-2 Pin Assignment Table B-27 Factory setting 4278A 4288A Selection of judgment output signal External power supply External power supply pull-up power supply (5 V to 24 V)
  • Page 247: Scanner Interface

    Information for Replacing 4278A with 4288A Comparison of Interfaces Scanner interface Figure B-3 Pin Assignment Table B-28 Factory setting 4278A 4288A Voltage range of input signal drive 5 V to 6 V 9 V to 15 V power supply Appendix B...
  • Page 248 Information for Replacing 4278A with 4288A Comparison of Interfaces Appendix B...
  • Page 249: Status Reporting System

    Status Reporting System This appendix describes the status reporting system of the Agilent 4288A.
  • Page 250: General Status Register Model

    By generating an SRQ, you can notify the controller that the 4288A is requesting service. In other words, you can program interruption by using an SRQ. For more information on using SRQ, see “Waiting For Completion Of Measurement (detecting completion of measurement)”...
  • Page 251: Event Register

    The event register reflects the corresponding condition of the 4288A (e.g., occurrence of an event) as a bit status. These bits continuously monitor changes in the 4288A’s state and change the bit status when the condition (e.g., change bit status to “1” if a specific event occurs) for each bit is met.
  • Page 252: Condition Register And Transition Filter

    The 4288A's condition register and transition filter work only with the operation status register. However, the 4288A's transition filter’s setting is fixed so that bits 5, 8, 9, 10 of the event register are set to “1” when the condition register makes a positive transition (i.e., changes from 0 to 1) and bits 1, 2, 3, 4, 7, 12 of the event register are set to “1”...
  • Page 253: Status Register Structure

    Status Reporting System Status Register Structure Status Register Structure The status reporting system has the hierarchical structure shown in Figure C-3. The status byte register is a summary of registers in the lower level. This section describes the status registers in each hierarchy. Each bit of the status register is described in Table C-1 through Table C-3.
  • Page 254 Status Reporting System Status Register Structure Table C-1 Status Bit Definitions of Status Byte (STB) Name Description Position 0 to 2 Not used Always 0 Questionable Status Register Set to “1” when one of the enabled bits in the status event Summary status register is set to “1.”...
  • Page 255 Set to “1” when the 4288A receives a data output request but there is no data to output. Set to “1” when the data of the 4288A's output queue has been cleared because of a new message received before the completion of data output.
  • Page 256 “Trigger system” on page 52. Issuing the *CLS command will clear all bits from the operation status event register. The 4288A does not support events of the questionable status register. Therefore, all of the bits in this register are always 0.
  • Page 257: Using The Status Reporting System

    Status Reporting System Using the Status Reporting System Using the Status Reporting System You can manage the status report system by using the following commands in any combination: • *CLS on page 124 • *SRE on page 127 *STB? on page 128 •...
  • Page 258 Status Reporting System Using the Status Reporting System Appendix C...
  • Page 259: Initial Settings

    Initial Settings This appendix provides initial settings, settings that can be saved/recalled, and settings that can be backed up.
  • Page 260: Initial Settings, Settings That Can Be Saved/Recalled, Settings That Can Be Backed Up

    Initial Settings Initial Settings, Settings that can be Saved/Recalled, Settings that can be Backed Up Initial Settings, Settings that can be Saved/Recalled, Settings that can be Backed Up The columns of Table D-1 show the following items. • Initial settings (factory settings) •...
  • Page 261 Initial Settings Initial Settings, Settings that can be Saved/Recalled, Settings that can be Backed Up Table D-1 Initial settings, settings that can be saved/recalled, settings that can be backed up Reset Initial settings Save/ Setting items Backup Front panel key (factory settings) Recall *RST...
  • Page 262 Initial Settings Initial Settings, Settings that can be Saved/Recalled, Settings that can be Backed Up Table D-1 Initial settings, settings that can be saved/recalled, settings that can be backed up Reset Initial settings Save/ Setting items Backup Front panel key (factory settings) Recall *RST...
  • Page 263: At-A-Glance Table Of Operations When Overload Or Low C Is Detected

    At-a-glance Table of Operations When Overload or Low C is Detected This appendix describes display output, GPIB output, and handler interface output when an overload or Low C is detected.
  • Page 264: Operations When Overload/Low C Is Detected

    At-a-glance Table of Operations When Overload or Low C is Detected Operations when overload/Low C is detected Operations when overload/Low C is detected Table E-1 shows operations of the 4288A when one of the following items is detected: ❏ Overload: •...
  • Page 265: Error Messages

    Error Messages The Agilent 4288A provides error messages to indicate its operating status. This appendix describes the error messages of the 4288A in order of error number. To search for error messages alphabetically, refer to the Operation Manual.
  • Page 266: Error Messages (Order Of Error Number)

    RAM test failed The RAM test at power-on has failed. If this error occurs, the 4288A makes a beep sound and stops. The hardware is at fault and needs repair. Contact an Agilent Technologies sales office or the VAR from which you purchased the instrument.
  • Page 267 A1 board test failed The A1 board test at power-on has failed. If this error occurs, the 4288A makes a beep sound and stops. The hardware is at fault and needs repair. Contact an Agilent Technologies sales office or the VAR from which you purchased the instrument.
  • Page 268 Saving the instrument setup into EEPROM has failed. Although the 4288A will not stop due to this error, the hardware is at fault and needs repair. Contact an Agilent Technologies sales office or the VAR from which you purchased the instrument.
  • Page 269 Program mnemonic too long The length of the header exceeds 12 characters. (Refer to IEEE488.2,7.6.1.4.1.) -113 Undefined header A header not defined for the 4288A has been received. For example, “*XYZ”, which is not defined for the 4288A, is received. Appendix F...
  • Page 270 -128 Numeric data not allowed A numeric value data element (that does not violate the standard) has been received where the 4288A does not accept any numeric value data element. -131 Invalid suffix The suffix does not meet the syntax defined in IEEE488.2,7.7.3.2 or is inappropriate for the 4288A.
  • Page 271 Error number: -158 -158 String data not allowed A string data element has been received where the 4288A does not accept any string data element. For example, a parameter must be enclosed with double quotation marks (“...”) but they are missing.
  • Page 272 -223 Too much data The received block, equation, or string type program data complies with the standard, but the amount of data exceeds the limit that the 4288A can handle due to memory or device-specific conditions related to memory. -230...
  • Page 273 Query but before the response has been completely sent. -420 Query UNTERMINATED This indicates the status that causes an “UNTERMINATED” Query error. (Refer to IEEE488.2,6.3.2.) This error occurs, for example, when the 4288A is specified as a talker and an incomplete program message is received. -430 Query DEADLOCKED This indicates the status that causes a “DEADLOCKED”...
  • Page 274: Warning Messages (Warning)

    Warning Messages (WARNING) Warning messages are displayed to warn users. They are displayed in the lower row of the display of the 4288A. You cannot read them out using the GPIB command. WARNING: Need corr meas When the OPEN compensation, SHORT compensation or LOAD compensation is ON, this is displayed when you change the setup of the cable length or measurement frequency shift (1 MHz).
  • Page 275: 4268A Vs. 4288A Gpib Command Correspondence Table

    4268A vs. 4288A GPIB Command Correspondence Table This appendix gives the correspondence between the Agilent 4268A GPIB commands and those of the Agilent 4288A.
  • Page 276: 4268A Vs. 4288A Gpib Command Correspondence Table

    4268A vs. 4288A GPIB Command Correspondence Table Table G-1 (by function) and Table G-2 (by alphabetical order) provide at-a-glance lists of the GPIB command correspondences between the 4268A and the 4288A. Table G-1 At-a-glance GPIB command correspondence between 4268A and 4288A (by...
  • Page 277 4268A vs. 4288A GPIB Command Correspondence Table 4268A vs. 4288A GPIB Command Correspondence Table Table G-1 At-a-glance GPIB command correspondence between 4268A and 4288A (by function) GPIB command Function Item to Be Set Up/Executed Note 4268A 4288A Compensation Entire compensation set ON/OFF...
  • Page 278 4268A vs. 4288A GPIB Command Correspondence Table 4268A vs. 4288A GPIB Command Correspondence Table Table G-1 At-a-glance GPIB command correspondence between 4268A and 4288A (by function) GPIB command Function Item to Be Set Up/Executed Note 4268A 4288A ← Comparator ON/OFF...
  • Page 279 4268A vs. 4288A GPIB Command Correspondence Table 4268A vs. 4288A GPIB Command Correspondence Table Table G-1 At-a-glance GPIB command correspondence between 4268A and 4288A (by function) GPIB command Function Item to Be Set Up/Executed Note 4268A 4288A ← Display ON/OFF :DISP ←...
  • Page 280 4268A vs. 4288A GPIB Command Correspondence Table 4268A vs. 4288A GPIB Command Correspondence Table Table G-2 At-a-glance GPIB command correspondence between 4268A and 4288A (by alphabetical order) 4268A 4288A [:A] ← :ABORt [:C] ← :CALCulate:COMParator:AUXBin ← :CALCulate:COMParator:BEEPer:CONDition ← :CALCulate:COMParator:BEEPer[:STATe] ←...
  • Page 281 4268A vs. 4288A GPIB Command Correspondence Table 4268A vs. 4288A GPIB Command Correspondence Table Table G-2 At-a-glance GPIB command correspondence between 4268A and 4288A (by alphabetical order) 4268A 4288A ← [:SENSe]:CORRection:MULTiple:[:STATe] [:SENSe]:CORRection:[:STATe] ← [:SENSe][:FIMPedance]:APERture[:MODE] [:SENSe][:FIMPedance]:CONTact:VERify ← [:SENSe][:FIMPedance]:RANGe:AUTO ← [:SENSe][:FIMPedance]:RANGe[:UPPer] ←...
  • Page 282 4268A vs. 4288A GPIB Command Correspondence Table 4268A vs. 4288A GPIB Command Correspondence Table Appendix G...
  • Page 283 D, 24 Absolute mode, 82 Data buffer, 75 Absolute tolerance mode, 82 Data transfer format, 58 Address, 20 Comparison between 4278A and 4288A, 229 Alarm (beep) data_buf.bas, 77 How to make, 29 Delay time, 25 ASCII transfer format, 59 Deviation measurement mode, 27...
  • Page 284 Index :CALCulate1:MATH:EXPRession:CATalog?, 147 :CALCulate1:MATH:EXPRession:NAME, 148 Factory settings, 258 :CALCulate1:MATH:STATe, 149 FAIL, 29 :CALCulate2:FORMat, 150 Feed, 75 :CALCulate2:MATH:EXPRession:CATalog?, 150 fetch_a.bas, 67 :CALCulate2:MATH:EXPRession:NAME, 151 Firmware version, 208 :CALCulate2:MATH:STATe, 152 Firmware(F/W) version, 125 :CALCulate3:MATH:STATe, 153 Fixed point display, 26 :CALCulate4:MATH:STATe, 153 Format, 58 :CALibration:CABLe, 133 Frequency :DATA[:DATA], 168...
  • Page 285 Multi compensation, 46 How to use this manual, 14 multi.bas, 48 Multi-command messages, 22 Idle state, 52 Information for Replacing 4278A with 4288A, 211 Need corr meas, 272 Initial settings, 258 Need load meas, 272 Initialization Need open meas, 272...
  • Page 286 GPIB command, 126 lvl_mon.bas, 80 How to execute, 30 meas_fxt.bas, 103 Settings that can be recalled, 258 meas_scn.bas, 116 Remote mode, 94 meas_sys.bas, 108 Replacing 4278A with 4288A, 211 multi.bas, 48 Reset read_a.bas, 71 4288A read_b.bas, 73 Initial settings, 258 selftest.bas, 99 BIN count value, 88 setup.bas, 33...
  • Page 287 Index trg_b.bas, 65 Example How to load, 15 Error detection, 95 Title Waiting for completion of measurement, 55 Capacitor measurement using the test fixture, 103 srq_err.bas, 97 Detecting the completion of measurement using SRQ, 56 srq_meas.bas, 56 Error occurrence detection using SRQ, 97 Standard Event Status Register Executing the multi compensation, 48 Read out, 125...
  • Page 288 Index Index...
  • Page 289 REGIONAL SALES AND SUPPORT OFFICES For more information about Agilent Technologies test and measurement products, applications, services, and for a current sales office listing, visit our web site: http://www.agilent.com/find/tmdir. You can also contact one of the following centers and ask for a test and measurement sales representative.

Table of Contents