Infiniium DCA and DCA-J Agilent 86100A/B/C Wide-Bandwidth Oscilloscope Programmer’s Guide Agilent Technologies
Notices Technology Licenses Trademark Acknowledgements © Agilent Technologies, Inc. 2000-2005 The hardware and/or software described in this document are furnished under a license and may be used or copied only in accordance with the terms of such license. Microsoft is a U.S. registered trademark of Microsoft Corporation.
Contents 1 Introduction Introduction 1-2 Starting a Program 1-4 Multiple Databases 1-6 Files 1-8 Status Reporting 1-11 Command Syntax 1-23 Interface Functions 1-34 Language Compatibility 1-36 New and Revised Commands 1-42 Commands Unavailable in Jitter Mode 1-44 Error Messages 1-46 2 Sample Programs Sample C Programs 2-3 Listings of the Sample Programs 2-15 3 Common Commands 4 Root Level Commands 5 System Commands 6 Acquire Commands 7 Calibration Commands 8 Channel Commands 9 Clock Recovery Commands 10 Dis
Contents Contents 13 Hardcopy Commands 14 Histogram Commands 15 Limit Test Commands 16 Marker Commands 17 Mask Test Commands 18 Measure Commands 19 S-Parameter Commands 20 Signal Processing Commands 21 TDR/TDT Commands (Rev. A.05.00 and Below) 22 TDR/TDT Commands (Rev. A.06.
1 Introduction 1-2 Starting a Program 1-4 Multiple Databases 1-6 Files 1-8 Status Reporting 1-11 Command Syntax 1-23 Interface Functions 1-34 Language Compatibility 1-36 New and Revised Commands 1-42 Commands Unavailable in Jitter Mode 1-44 Error Messages 1-46 Introduction
Introduction Introduction Introduction This chapter explains how to program the instrument. The programming syntax conforms to the IEEE 488.2 Standard Digital Interface for Programmable Instrumentation and to the Standard Commands for Programmable Instruments (SCPI). This edition of the manual documents all 86100-series software revisions up through A.04.10. For a listing of commands that are new or revised for software revisions A.04.00 and A.04.10, refer to “New and Revised Commands” on page 1-42.
Introduction Introduction Figure 1-1. Sample Data Processing The sample data is stored in the channel memory for further processing before being displayed. The time it takes for the sample data to be displayed depends on the number of post processes you have selected. Averaging your sampled data helps remove any unwanted noise from your waveform.
Introduction Starting a Program Starting a Program The commands and syntax for initializing the instrument are listed in Chapter 3, “Common Commands”. Refer to your GPIB manual and programming language reference manual for information on initializing the interface. To make sure the bus and all appropriate interfaces are in a known state, begin every program with an initialization statement. For example, BASIC provides a CLEAR command which clears the interface buffer.
Introduction Starting a Program −40 millivolts. • Lines 80 through 90 configure the instrument to trigger at −0.4 volts with normal triggering. • Line 100 turns system headers off. • Line 110 turns the grid off. The DIGITIZE command is a macro that captures data using the acquisition (ACQUIRE) subsystem. When the digitize process is complete, the acquisition is stopped. The captured data can then be measured by the instrument or transferred to the computer for further analysis.
Introduction Multiple Databases Multiple Databases Eye/Mask measurements are based on statistical data that is acquired and stored in the color grade/gray scale database. The color grade/gray scale database consists of all data samples displayed on the display graticule. The measurement algorithms are dependent upon histograms derived from the database. This database is internal to the instrument’s applications. The color grade/gray scale database cannot be imported into an external database application.
Introduction Multiple Databases CHANnel2:DISPlay ON,APPend For a example of using multiple databases, refer to “multidatabase.c Sample Program” on page 2-35. Downloading a Database The general process for downloading a color grade/gray scale database is as follows: 1 Send the command :WAVEFORM:SOURCE CGRADE This will select the color grade/gray scale database as the waveform source. 2 Issue :WAVeform:FORMat WORD. Database downloads only support word formatted data (16-bit integers).
Introduction Files Files When specifying a file name in a remote command, enclose the name in double quotation marks, such as "filename". If you specify a path, the path should be included in the quotation marks. All files stored using remote commands have file name extensions as listed in Table 1-1. You can use the full path name, a relative path name, or no path.
Introduction Files Table 1-1. File Name Extensions File Type File Name Extension Waveform - internal format .wfm “STORe” on page 10-9 Waveform - text format (Verbose, XY Verbose, or Y values) .txt “STORe” on page 10-9 Pattern Waveform .csv “PWAVeform:SAVE” on page 10-6 Setup .set “STORe” on page 10-9 Color grade - Gray Scale .cgs “STORe” on page 10-9 Jitter Memory .jd “STORe” on page 10-9 .bmp, .eps, .gif, .pcx, .ps, .jpg, .tif “SIMage” on page 10-7 Mask .msk, .
Introduction Files Table 1-3.
Introduction Status Reporting Status Reporting Almost every program that you write will need to monitor the instrument for its operating status. This includes querying execution or command errors and determining whether or not measurements have been completed. Several status registers and queues are provided to accomplish these tasks. In this section, you’ll learn how to enable and read these registers. • Refer to Figure 1-4 on page 1-14 for an overall status reporting decision chart.
Introduction Status Reporting bit 6 as the Request Service (RQS) bit and clears the bit which clears the SRQ interrupt. The *STB? query reads bit 6 as the Master Summary Status (MSS) and does not clear the bit or have any affect on the SRQ interrupt. The value returned is the total bit weights of all of the bits that are set at the present time. Figure 1-2.
Introduction Status Reporting The use of bit 6 can be confusing. This bit was defined to cover all possible computer interfaces, including a computer that could not do a serial poll. The important point to remember is that, if you are using an SRQ interrupt to an external computer, the serial poll command clears bit 6. Clearing bit 6 allows the instrument to generate another SRQ interrupt when another enabled event occurs.
Introduction Status Reporting Figure 1-4.
Introduction Status Reporting Status Reporting Data Structures (continued) 1-15
Introduction Status Reporting This BASIC example uses the *STB? query to read the contents of the instrument’s Status Byte Register when none of the register's summary bits are enabled to generate an SRQ interrupt. 10 20 30 40 OUTPUT 707;":SYSTEM:HEADER OFF;*STB?"!Turn headers off ENTER 707;Result!Place result in a numeric variable PRINT Result!Print the result End The next program prints 132 and clears bit 6 (RQS) of the Status Byte Register.
Introduction Status Reporting Table 1-5. Status Reporting Bit Definition (1 of 2) Bit Description Definition ACQ Acquisition Indicates that acquisition test has completed in the Acquisition Register. AREQD Autoscale Required Indicates that a parameter change in Jitter Mode has made an autoscale necessary. CLCK CloCk Indicates that one of the enabled conditions in the Clock Recovery Register has occurred. CME Command Error Indicates if the parser detected an error.
Introduction Status Reporting Table 1-5. Status Reporting Bit Definition (2 of 2) Bit Description Definition PTIME Precision Timebase Indicates that one of the enabled conditions in the Precision Timebase Register has occurred. QYE Query Error Indicates if the protocol for queries has been violated. RQL Request Control Indicates if the device is requesting control. RQS Request Service Indicates that the device is requesting service.
Introduction Status Reporting Standard Event Status Enable Register For any of the Standard Event Status Register (SESR) bits to generate a summary bit, you must first enable the bit. Use the *ESE (Event Status Enable) common command to set the corresponding bit in the Standard Event Status Enable Register. Set bits are read with the *ESE? query. Suppose your application requires an interrupt whenever any type of error occurs.
Introduction Status Reporting Acquisition Event Bit 0 (COMP) of the Acquisition Event Register is set when the acquisition limits complete. Register (AER) The Acquisition completion criteria are set by the ACQuire:RUNtil command. Refer to “RUNTil” on page 6-4. The Acquisition Event Register is read and cleared with the ALER? query. Refer to “ALER?” on page 4-3.
Introduction Status Reporting enabled conditions in the Jitter Event Register has occurred. You can mask the EFAIL, JLOSS, and AREQD bits, thus preventing them from setting the JIT bit, by setting corresponding bits to zero using the JEE command. Refer to “JEE” on page 4-7. Mask Test Event Register (MTER) Bit 0 (COMP) of the Mask Test Event Register is set when the Mask Test completes. The Mask Test completion criteria are set by the MTESt:RUNTil command. Refer to “RUNTil” on page 17-6.
Introduction Status Reporting Output Queue The output queue stores the instrument-to-computer responses that are generated by certain instrument commands and queries. The output queue generates the Message Available summary bit when the output queue contains one or more bytes. This summary bit sets the MAV bit (bit 4) in the Status Byte Register. The output queue may be read with the BASIC ENTER statement.
Introduction Command Syntax Command Syntax In accordance with IEEE 488.2, the instrument’s commands are grouped into “subsystems.” Commands in each subsystem perform similar tasks. Starting with Chapter 5, “System Commands” each chapter covers a separate subsystem. Sending a Command It’s easy to send a command to the instrument. Simply create a command string from the commands listed in this book, and place the string in your program language’s output statement.
Introduction Command Syntax . Table 1-6. Long and Short Command Forms Long Form Short Form How the Rule is Applied RANGE RANG Short form is the first four characters of the keyword. PATTERN PATT Short form is the first four characters of the keyword. DISK DISK Short form is the same as the long form. DELAY DEL Fourth character is a vowel, short form is the first three characters.
Introduction Command Syntax Numbers Some commands require number arguments. All numbers are expected to be strings of ASCII characters. You can use exponential notation or suffix multipliers to indicate the numeric value. The following numbers are all equal: 28 = 0.28E2 = 280E-1 = 28000m = 0.028K = 28E-3K When a syntax definition specifies that a number is an integer, any fractional part is ignored and truncated.
Introduction Command Syntax Definite-Length Block Response Data Definite-length block response data allows any type of device-dependent data to be transmitted over the system interface as a series of 8-bit binary data bytes. This is particularly useful for sending large quantities of data or 8-bit extended ASCII codes. The syntax is a pound sign (#) followed by a non-zero digit representing the number of digits in the decimal integer.
Introduction Command Syntax When you read the result of multiple queries into string variables, each response is separated by a semicolon.
Introduction Command Syntax The colon between CHANNEL1 and RANGE is necessary because CHANNEL1:RANGE specifies a command in a subsystem. The semicolon between the RANGE command and the OFFSET command is required to separate the two commands. The OFFSET command does not need CHANNEL1 preceding it because the CHANNEL1:RANGE command sets the parser to the CHANNEL1 node in the tree.
Introduction Command Syntax Figure 1-5.
Introduction Command Syntax Command Tree (Continued) 1-30
Introduction Command Syntax Command Tree (Continued) 1-31
Introduction Command Syntax Command Tree (Continued) 1-32
Introduction Command Syntax Command Tree (Continued) 1-33
Introduction Interface Functions Interface Functions The interface functions deal with general bus management issues, as well as messages that can be sent over the bus as bus commands. In general, these functions are defined by IEEE 488.1. The instrument is equipped with a GPIB interface connector on the rear panel. This allows direct connection to a GPIB equipped computer. You can connect an external GPIB compatible device to the instrument by installing a GPIB cable between the two units.
Introduction Interface Functions between decimal 0 and 30. This instrument address is used by the computer to direct commands and communications to the proper instrument on an interface. The default is typically “7” for this instrument. You can change the instrument address in the Utilities, Remote Interface dialog box. NOTE Do Not Use Address 21 for an Instrument Address. Address 21 is usually reserved for the Computer interface Talk/Listen address and should not be used as an instrument address.
Introduction Language Compatibility Language Compatibility This section lists Agilent 83480A commands that are not used in the 86100A/B/C.
Introduction Language Compatibility Agilent 83480A/54750A Commands Not Used in the Instrument (2 of 6) :CALibrate:PLUGin:OPTical :CALibrate:MODule:OPTical :CALibrate:PLUGin:OWAVelength :CALibrate:MODule:OWAVelength :CALibrate:PLUGin:TIME? :CALibrate:MODule:TIME? :CALibrate:PLUGin:VERTical :CALibrate:MODule:VERtical :CALibrate:PROBe :CALibrate:PROBe CHANnel Channel Commands :CHANnel :CHANnel:AUTOscale :AUToscale :CHANnel:SKEW :CALibrate:SKEW Disk Commands :DISK :DISK:DATA? No replace
Introduction Language Compatibility Agilent 83480A/54750A Commands Not Used in the Instrument (3 of 6) :FUNCtion:DIVide No replacement :FUNCtion:FFT No replacement, FFT not available :FUNCtion:INTegrate No replacement :FUNCtion:MULTiply No replacement :FUNCtion:ONLY :FUNCtion:MAGNify Hardcopy Commands :HARDcopy :HARDcopy:ADDRess :HARDcopy:DPRinte :HARDcopy:BACKground :HARDcopy:IMAGe INVert :HARDcopy:BACKground? No replacement :HARDcopy:DESTination No replacement :HARDcop
Introduction Language Compatibility Agilent 83480A/54750A Commands Not Used in the Instrument (4 of 6) :LTESt:SSUMmary:MEDia No replacement :LTESt:SSUMmary:PFORmat No replacement :LTESt:SSUMmary:PORT No replacement Marker Commands :MARKer :MARKer:CURSor? No replacement. Use individual queries.
Introduction Language Compatibility Agilent 83480A/54750A Commands Not Used in the Instrument (5 of 6) :MTESt:SSCReen:DPRinter No replacement :MTESt:SSCReen:DPRinter:ADDRess No replacement :MTESt:SSCReen:DPRinter:BACKground No replacement :MTESt:SSCReen:DPRinter:MEDia No replacement :MTESt:SSCReen:DPRinter:PFORmat No replacement :MTESt:SSCReen:DPRinter:PORT No replacement :MTESt:SSUMmary:ADDRess No replacement :MTESt:SSUMmary:BACKground No replacement :MTESt:SSUMmary:MEDia No replacement
Introduction Language Compatibility Agilent 83480A/54750A Commands Not Used in the Instrument (6 of 6) :TIMebase:DELay :TIMebase:POSition :TIMebase:VIEW No replacement :TIMebase:WINDow:DELay No replacement :TIMebase:WINDow:POSition No replacement :TIMebase:WINDow:RANGe No replacement :TIMebase:WINDow:SCALe No replacement :TIMebase:WINDow:SOURce No replacement Trigger Commands :TRIGger :TRIGger:SWEep :TRIGger:SOURce FRUN :TRIGger:SWEep? :TRIGger:SOURce? :TRIGger:BWLimit :TRIGger:BWLimi
Introduction New and Revised Commands New and Revised Commands This section lists all new and revised commands for the 86100C. Some of these commands are new to software revision A.5.00 and some are new to software revision A.6.00. Each command listed is followed by the page number where the command is documented. For revision A.6.00, changes to the TDR subsystem are significant enough to require a separate new chapter.
Introduction New and Revised Commands S-Parameter Commands TDRSparam 19-3 MAGGraph:HORizontal:STARt 19-3 MAGGraph:HORizontal:SPAN 19-3 MAGGraph:VERTical:MAXimum 19-4 MAGGraph:VERTical:MINimum 19-4 MARKer:X1STate 19-4 MARKer:X2STate 19-4 MARKer:X1Source 19-4 MARKer:X2Source 19-5 MARKer:X1Position 19-5 MARKer:X2Position 19-5 MARKer:Y1Position? 19-5 MARKer:Y2Position? 19-6 MARKer:XDELta? 19-6 MARKer:YDELta? 19-6 VWINdow 19-6 TDR/TDT Commands (Revision A.6.
Introduction Commands Unavailable in Jitter Mode RESPonse:TDRTDT RESPonse:TDTDest STIMulus Timebase Commands MPOSition 23-2 Commands Unavailable in Jitter Mode This section describes the commands that can generate errors when controlling the instrument in Jitter mode. This can be due to the command or one of its arguments that are not allowed in Jitter mode. Refer to the individual command reference for detailed information.
Introduction Commands Unavailable in Jitter Mode WAveform Memory Display Waveform memories cannot be turned on in Jitter mode. The following command produces a "Settings conflict" error when executed in Jitter mode. WMEMory:DISPlay 26-2 Waveform and The Waveform and Color Grade/Gray Scale memories cannot be turned on in Jitter mode. The Color Grade-Gray following command produces an "Illegal parameter value" error when executed in Jitter Scale Memory mode.
Introduction Error Messages Error Messages This chapter describes the error messages and how they are generated. The possible causes for the generation of the error messages are also listed in Table 1-10 on page 1-47. Error Queue As errors are detected, they are placed in an error queue. This queue is first in, first out. If the error queue overflows, the last error in the queue is replaced with error –350, “Queue overflow.
Introduction Error Messages specific headers and incorrect or unimplemented IEEE 488.2 common commands. • A Group Execute Trigger (GET) was entered into the input buffer inside of an IEEE 488.2 program message. Events that generate command errors do not generate execution errors, instrument-specific errors, or query errors. Execution Error An error number in the range –200 to –299 indicates that an error was detected by the instrument's execution control block.
Introduction Error Messages Table 1-10. Error Messages Returned by Instrument Parser (2 of 4) -104 Data type error The parser recognized a data element different than one allowed. For example, numeric or string data was expected but block data was received. -105 GET not allowed A Group Execute Trigger was received within a program message. -108 Parameter not allowed More parameters were received than expected for the header.
Introduction Error Messages Table 1-10. Error Messages Returned by Instrument Parser (3 of 4) -200 Execution error This is a generic syntax error which is used if the instrument cannot detect more specific errors. -220 Parameter error Indicates that a program data element related error occurred. -221 Settings conflict Indicates that a legal program data element was parsed but could not be executed due to the current device state.
Introduction Error Messages Table 1-10. Error Messages Returned by Instrument Parser (4 of 4) -310 System error Indicates that a system error occurred. -340 Calibration failed Indicates that a calibration has failed. -350 Queue overflow Indicates that there is no room in the error queue and an error occurred but was not recorded. -400 Query error This is the generic query error.
2 Sample C Programs 2-3 init.c - Initialization 2-3 init.c - Global Definitions and Main Program 2-4 init.c - Initializing the Analyzer 2-4 init.c - Acquiring Data 2-5 init.c - Making Automatic Measurements 2-6 init.c - Error Checking 2-7 init.c - Transferring Data to the PC 2-9 init.c - Converting Waveform Data 2-10 init.c - Storing Waveform Time and Voltage Information 2-11 gen_srq.
Sample Programs Sample Programs Each program in this chapter demonstrates specific sets of instructions. This chapter shows you some of those functions, and describes the commands being executed. The sample program listings are included at the end of this chapter. Both C and BASIC examples are included. The header file is: hpibdecl.h The C examples include: • • • • • • • init.c gen_srq.c srq.c learnstr.c sicl_IO.c natl_IO.c multidatabase.c The BASIC examples include: • init.bas • srq.bas • lrn_str.
Sample Programs Sample C Programs Sample C Programs Segments of the sample programs “init.c” and “gen_srq.c” are shown and described in this chapter. init.c - Initialization /* init. c */ /* Command Order Example. This program demonstrates the order of commands suggested for operation of the analyzer via GPIB.
Sample Programs Sample C Programs init.c - Global Definitions and Main Program /* GLOBALS */ int count; double xorg,xref,xinc; double yorg,yref,yinc; int Acquired_length; char data[MAX_LENGTH]; double time_value[MAX_LENGTH]; double volts[MAX_LENGTH]; /* values necessary for conversion of data */ /* data buffer */ /* time value of data */ /* voltage value of data */ void main( void ) { /* initialize interface and device sessions */ /* note: routine found in sicl_IO.c or natl_IO.
Sample Programs Sample C Programs write_IO ("*CLS"); /* clear status registers and output queue */ write_IO (":SYSTem:HEADer OFF"); /* turn off system headers */ /* initialize time base parameters to center reference, */ /* 2 ms full-scale (200 us/div), and 20 us delay */ write_IO (":TIMebase:REFerence CENTer;RANGe 2e-3;POSition 20e-6"); /* initialize Channel1 1.6V full-scale (200 mv/div); offset -400mv */ write_IO (":CHANnel1:RANGe 1.
Sample Programs Sample C Programs init.c - Making Automatic Measurements /* * Function name: auto_measurements * Parameters: none * Return value: none * Description: This routine performs automatic measurements of volts * peak-to-peak and period on the acquired data. It also demonstrates * two methods of error detection when using automatic measurements.
Sample Programs Sample C Programs period_str [bytes_read-2]); else printf ("Period is %f\n",(float)atof (period_str)); /* * METHOD TWO - perform automated measurements and error checking with * :MEAS:RESULTS OFF */ period = (float) 0; vpp = (float) 0; /* turn off results */ write_IO (":MEASure:SEND OFF"); write_IO (":MEASure:PERiod? CHANnel1"); bytes_read = read_IO (period_str,16L); /*period 1 */ /* read in value and result flag */ period = (float) atof (period_str); if (period > 9.
Sample Programs Sample C Programs * METHOD ONE - turn on results to indicate whether the measurement completed * successfully. Note that this requires transmission of extra data from the scope.
Sample Programs Sample C Programs init.c - Transferring Data to the PC /* * Function name: transfer_data * Parameters: none * Return value: none * Description: This routine transfers the waveform conversion factors and * waveform data to the PC.
Sample Programs Sample C Programs header_length = atoi (header_str); /* read number of points - value in bytes */ bytes_read = read_IO (header_str,(long)header_length); Acquired_length = atoi (header_str); /* number of bytes */ bytes_read = read_IO (data,Acquired_length); bytes_read = read_IO (&term,1L); /* input waveform data */ /* input termination character */ } /* end transfer_data () */ An example header resembles the following when the information is stripped off: #510225 The left-most “5” define
Sample Programs Sample C Programs init.c - Storing Waveform Time and Voltage Information /* * Function name: store_csv * Parameters: none * Return value: none * Description: This routine stores the time and voltage information about * the waveform as time/voltage pairs in a comma-separated variable file * format. */ void store_csv ( ) { FILE *fp; int i; fp = fopen ("pairs.
Sample Programs Sample C Programs * This example program initializes the Agilent 86100 scope, runs an autoscale, * then generates and responds to a Service Request from the scope. The program * assumes an Agilent 86100 at address 7, an interface card at interface select code 7, * and a signal source attached to channel 1. */ #include #include "hpibdecl.
Sample Programs Sample C Programs The *RST command is a common command that resets the analyzer to a known default configuration. Using this command ensures that the analyzer is in a known state before you configure it. *RST ensures very consistent and repeatable results. Without *RST, a program may run one time, but it may give different results in following runs if the analyzer is configured differently. For example, if the trigger mode is normally set to edge, the program may function properly.
Sample Programs Sample C Programs Generating a Service Request The following function is demonstrated in the “gen_srq.c” sample program. /* * Function name: create_SRQ * Parameters: none * Return value: none * Description: This routine sends two illegal commands to the scope which will * generate an SRQ and will place two error strings in the error queue. The scope * ID is requested to allow time for the SRQ to be generated.
Sample Programs Listings of the Sample Programs Listings of the Sample Programs Listings of the C sample programs in this section include: • • • • • • • hpibdecl.h init.c gen_srq.c srq.c learnstr.c sicl_IO.c natl_IO.c Listings of the BASIC sample programs in this section include: • init.bas • srq.bas • lrn_str.bas hpib_decl.h Sample Program /* hpibdecl.
Sample Programs Listings of the Sample Programs #ifdef AGILENT #include #else #ifdef WIN95 #include #include #else #include #endif #endif /* include file for Windows 95 */ /* include file for Windows 3.
Sample Programs Listings of the Sample Programs unsigned char read_status ( ); void close_IO ( ); void hpiberr ( ); void srq_handler ( ); init.c Sample Program /* init. c */ /* * Command Order Example. This program demonstrates the order of commands * suggested for operation of the Agilent 86100 analyzer via GPIB.
Sample Programs Listings of the Sample Programs acquire_data ( ); auto_measurements ( ); transfer_data ( ); convert_data ( ); store_csv ( ); close_IO ( ); /* capture the data */ /* perform automated measurements on acquired data */ /* transfer waveform data to the PC from scope */ /* convert data to time/voltage pairs */ /* store the time/voltage pairs as csv file */ /* close interface and device sessions */ /* note: routine found in sicl_IO.c or natl_IO.
Sample Programs Listings of the Sample Programs * Description: This routine acquires data according to the current instrument settings. */ void acquire_data ( ) { /* * The root level :DIGitize command is recommended for acquisition of new * data. It will initialize data buffers, acquire new data, and ensure that * acquisition criteria are met before acquisition of data is stopped. * The captured data is then available for measurements, storage, or transfer * to a PC.
Sample Programs Listings of the Sample Programs write_IO (":MEASure:VPP? CHANnel1"); bytes_read = read_IO (vpp_str,16L); /* read in value and result flag */ if (vpp_str[bytes_read-2] != '0') printf ("Automated vpp measurement error with result %c\n", vpp_str[bytes_read-2]); else printf ("VPP is %f\n", (float)atof (vpp_str)); write_IO (":MEASure:PERiod? CHANnel1"); bytes_read = read_IO (period_str,16L); /* period channel 1 */ /* read in value and result flag */ if (period_str[bytes_read-2] != '0') print
Sample Programs Listings of the Sample Programs { int header_length; char header_str[8]; char term; char xinc_str[32],xorg_str[32],xref_str[32]; char yinc_str[32],yref_str[32],yorg_str[32]; int bytes_read; /* waveform data source channel 1 */ write_IO (":WAVeform:SOURce CHANnel1"); /* setup transfer format */ write_IO (":WAVeform:FORMat BYTE"); /* request values to allow interpretation of raw data */ write_IO (":WAVeform:XINCrement?"); bytes_read = read_IO (xinc_str,32L); xinc = atof (xinc_str); write_IO (
Sample Programs Listings of the Sample Programs * Parameters: none * Return value: none * Description: This routine converts the waveform data to time/voltage * information using the values that describe the waveform. These values are * stored in global arrays for use by other routines.
Sample Programs Listings of the Sample Programs gen_srq.c Sample Program /* gen_srq.c */ /* * This example programs initializes the Agilent 86100 scope, runs an * autoscale, then generates and responds to a Service Request from the * scope. The program assumes an Agilent 86100 at address 7, an interface card * at interface select code 7, and a signal source attached to channel 1. */ #include #include "hpibdecl.
Sample Programs Listings of the Sample Programs */ void setup_SRQ ( ) { /* Enable Service Request Enable Register - Event Status Bit */ write_IO ("*SRE 32"); /* Enable Standard Event Status Enable Register enable Command Error - bit 4 - value 32 Query Error - bit 1 - value 4 */ write_IO ("*ESE 36"); } /* end setup_SRQ ( ) */ /* * Function name: create_SRQ * Parameters: none * Return value: none * Description: This routine sends two illegal commands to the scope which will generate an * SRQ and will place t
Sample Programs Listings of the Sample Programs srq.c Sample Program /* file: srq.c */ /* This file contains the code to handle Service Requests from an GPIB device */ #include #include "hpibdecl.h" /* location of printf ( ), fopen ( ), and fclose ( ) */ /* * Function name: srq_handler * Parameters: none * Return value: none * Description: This routine services the scope when an SRQ is generated. * An error file is opened to receive error data from the scope.
Sample Programs Listings of the Sample Programs if ( error_str[0] == '0' ) { /* Clear event registers and queues,except output */ write_IO("*CLS"); more_errors = FALSE; if ( fp != NULL) fclose ( fp ); } for (i=0;i<64;i++) error_str[i] = '\0'; /* clear string */ } /* end while (more_errors) */ } else { printf (" SRQ not generated by scope.
Sample Programs Listings of the Sample Programs change_setup ( ); get_learnstring ( ); close_IO ( ); /* request user to change setup */ /* restore learnstring */ /* close device and interface sessions */ /* Note: routine found in sicl_IO.c or natl_IO.c */ } /* end main */ /* * Function name: initialize * Parameters: none * Return value: none * Description: This routine initializes the analyzer for proper acquisition of data. * The instrument is reset to a known state and the interface is cleared.
Sample Programs Listings of the Sample Programs write_IO (":SYSTem:SETup?"); actualcnt = read_IO (setup, MAX_LRNSTR); /* request learnstring */ fp = fopen ( "learn2","wb"); if ( fp != NULL ) { fwrite ( setup,sizeof (unsigned char), (int) actualcnt,fp); printf ("Learn string stored in file Learn2\n"); fclose ( fp ); } else printf ("Error in file open\n"); }/* end store_learnstring */ /* * Function name: change_setup * Parameters: none * Return value: none * Description: This routine places the scope into
Sample Programs Listings of the Sample Programs }/* end get_learnstring */ sicl_IO.c Sample Program /* sicl_IO.c */ #include #include #include "hpibdecl.h" /* location of: printf ( ) */ /* location of: strlen ( ) */ /* This file contains IO and initialization routines for the SICL libraries. */ /* * Function name: init_IO * Parameters: none * Return value: none * Description: This routine initializes the SICL environment.
Sample Programs Listings of the Sample Programs void write_IO ( void *buffer ) { unsigned long actualcnt; unsigned long length; int send_end = 1; length = strlen ( buffer ); iwrite ( scope, buffer, length, send_end, &actualcnt ); } /* end write_IO */ /* * Function name: write_lrnstr * Parameters: char *buffer which is a pointer to the character string to be * output; long length which is the length of the string to be output * Return value: none * Description: This routine outputs a learnstring to the scop
Sample Programs Listings of the Sample Programs int check_SRQ( ) { int srq_asserted; /* check for SRQ line status */ ihpibbusstatus(bus, I_GPIB_BUS_SRQ, &srq_asserted); return ( srq_asserted ); } /* end check_SRQ ( ) */ /* * Function name: read_status * Parameters: none * Return value: unsigned char indicating the value of status byte * Description: This routine reads the scope status byte and returns the status.
Sample Programs Listings of the Sample Programs natl_IO.c Sample Program /* natl_IO.c */ #include /* location of: printf ( ) */ #include /* location of: strlen ( ) */ #include "hpibdecl.h" /* This file contains IO and initialization routines for the NI488.2 commands. */ /* * Function name: hpiberr * Parameters: char* - string describing error * Return value: none * Description: This routine outputs error descriptions to an error file.
Sample Programs Listings of the Sample Programs ibclr ( scope ); /* clear the device( scope ) */ if ( ibsta & ERR) { hpiberr ("ibclr error" ); } } /* end init_IO */ /* * Function name: write_IO * Parameters: void *buffer which is a pointer to the character string to be output * Return value: none * Description: This routine outputs strings to the scope device session.
Sample Programs Listings of the Sample Programs int read_IO (void *buffer,unsigned long length) { ibrd (scope, buffer, ( long ) length ); return ( ibcntl ); } /* end read_IO ( ) */ /* * Function name: check_SRQ * Parameters: none * Return value: integer indicating if bus SRQ line was asserted * Description: This routine checks for the status of SRQ on the bus and * returns a value to indicate the status.
Sample Programs Listings of the Sample Programs * Description: This routine closes device session. */ void close_IO ( ) { ibonl ( scope,0 ); /* close device session */ } /* end close_IO ( ) */ multidatabase.c Sample Program /*multidatabase.c*/ /* * This example program demonstrates the use of the Multidatabase functionality of the * Agilent 86100 DCA. The program sets up an acquitision of 200 waveforms on two * channels, first serially, then in parallel.
Sample Programs Listings of the Sample Programs /* * Function Name: initialize * Paramters: none * Returned value: none * Description: This method sets up the channels and acquisition limits of the * DCA */ void initialize() { write_IO("*RST");//reset the DCA write_IO("*CLS");//clear the status registers write_IO("SYSTem:MODE EYE");//switch to Eye/mask mode write_IO("STOP");//stop acquistion write_IO("CDISplay");//clear the display write_IO("ACQuire:RUNTil WAVeforms,200"); //set the acquistion limit to 200
Sample Programs Listings of the Sample Programs write_IO("MTESt:TEST OFF"); //trun off the maks test write_IO("MEASure:CGRade:CROSsing?");//query the crossing percentage Crss_pct1[read_IO(Crss_pct1,15)]=0;//get the crossing percentage write_IO("MEASure:CGRade:ERATio? DECibel");//query the extinction ratio Ext_rat1[read_IO(Ext_rat1,15)]=0;//get the extinction ratio write_IO("CHANnel3:DISPlay ON");//turn on channel three write_IO("RUN"); //start acquistion write_IO("AUToscale"); //Autoscale write_IO("*OPC?")
Sample Programs Listings of the Sample Programs write_IO("CALibrate:SKEW:AUTO");//auto deskew the two channels write_IO("*OPC?"); //query for completion read_IO(buff,5); //read completion response write_IO("MTESt:LOAD \"STM016_OC48.
Sample Programs Listings of the Sample Programs 70 ! PC as time/voltage pairs in a comma-separated file format useful for spreadsheet 80 ! applications. It assumes an interface card at interface select code 7, an 90 ! Agilent 86100 scope at address 7, and the Agilent 86100 cal signal connected to Channel 1.
Sample Programs Listings of the Sample Programs 630 640 650 660 665 670 680 690 700 710 720 730 740 750 760 770 780 790 800 810 820 830 840 850 860 870 880 890 900 910 920 930 940 950 960 970 980 990 1000 1010 1020 1030 1040 1050 1060 1070 1080 1090 1100 1110 1120 1130 1140 1150 1160 1170 !Initialize Trigger: Edge trigger, channel1 source at -415mv OUTPUT @Scope;":TRIGger:SOURce FPANel;SLOPe POSitive" OUTPUT @Scope;":TRIGger:LEVel-0.
Sample Programs Listings of the Sample Programs 1180 1190 1200 1210 1220 1230 1240 1250 1260 1270 1280 1290 1300 1310 1320 1330 1340 1350 1360 1370 1380 1390 1400 1410 1420 1430 1440 1450 1460 1470 1480 1490 1500 1510 1520 1530 1540 1550 1560 1570 1580 1590 1600 1610 1620 1630 1640 1650 1660 1670 1680 1690 1700 1710 1720 1730 ! ! ! ! ! ! ! ! why the measurement failed. See the Programmer's Manual for descriptions of result indicators.
Sample Programs Listings of the Sample Programs 1740 1750 1760 1770 1780 1790 1800 1810 1820 1830 1840 1850 1860 1870 1880 1890 1900 1910 1920 1930 1940 1950 1960 1970 1980 1990 2000 2010 2020 2030 2040 2050 2060 2070 2080 2090 2100 2110 2120 2130 2140 2150 2160 2170 2180 2190 2200 2210 2220 2230 2240 2250 2260 2270 2280 2290 PRINT "Period is ";Period PRINT ELSE PRINT PRINT "Automated period measurement error";Period PRINT END IF SUBEND ! ! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Sample Programs Listings of the Sample Programs 2300 ! 2310 ! 2320 ! Subprogram name: Convert_data 2330 ! Parameters: none 2340 ! Return value: none 2350 ! Description: This routine converts the waveform data to time/voltage information 2360 ! using the values Xinc, Xref, Xorg, Yinc, Yref, and Yorg used to describe 2370 ! the raw waveform data.
Sample Programs Listings of the Sample Programs 2860 2870 2880 2890 2900 2910 2920 2930 2940 2950 2960 ! Parameters: none ! Return value: none ! Description: This routine closes the IO paths. ! ! SUB Close COM /Io/@Scope,@Path,Interface ! RESET Interface ASSIGN @Path TO * SUBEND srq.bas Sample Program 10 20 30 40 50 60 70 80 90 100 110 120 130 140 150 160 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 360 370 380 !File: srq.
Sample Programs Listings of the Sample Programs 390 400 410 420 430 440 450 460 470 480 490 500 510 520 530 540 550 560 570 580 590 600 610 620 630 640 650 660 670 680 690 700 710 720 730 740 750 760 770 780 790 800 810 820 830 840 850 860 870 880 890 900 910 920 930 940 CLEAR @Scope OUTPUT @Scope;"*RST" OUTPUT @Scope;"*CLS" OUTPUT @Scope;":SYSTem:HEADer OFF" OUTPUT @Scope;":AUToscale" SUBEND ! ! ! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! ! Subprogram name: Setup_s
Sample Programs Listings of the Sample Programs 950 PRINT !which represents the response to the interrupted query above 960 PRINT Buf$ 970 PRINT 980 SUBEND 990 ! 1000 ! 1010 ! 1020 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 1030 ! 1040 ! 1050 ! Subprogram name: Srq_handler 1060 ! Parameters: none 1070 ! Return value: none 1080 ! Description: This routine verifies the status of the SRQ line.
Sample Programs Listings of the Sample Programs 1510 1520 1530 1540 1550 1560 1570 1580 1590 1600 ! ! SUB Close COM /Io/@Scope,Interface RESET Interface SUBEND ! ! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! lrn_str.bas Sample Program 10 20 30 40 50 60 70 80 90 100 110 120 130 140 150 160 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 360 370 !FILE: lrn_str.
Sample Programs Listings of the Sample Programs 380 COM /Variables/Max_length 390 Max_length=14000 400 ASSIGN @Scope TO 707 410 Interface=7 420 RESET Interface 430 CLEAR @Scope 440 OUTPUT @Scope;"*RST" 450 OUTPUT @Scope;"*CLS" 460 OUTPUT @Scope;":SYSTem:HEADer ON" 470 OUTPUT @Scope;":AUToscale" 480 SUBEND 490 ! 500 ! 510 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 520 ! 530 ! 540 ! Subprogram name: Store_lrnstr 550 ! Parameters: none 560 ! Return value: none 570 ! Desc
Sample Programs Listings of the Sample Programs 940 SUBEND 950 ! 960 ! 970 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 980 ! 990 ! Subprogram name: Get_lrnstr 1000 ! Parameters: none 1010 ! Return value: none 1020 ! Description: This subprogram loads a learnstring from the 1030 ! file "Lrn_strg" to the scope.
Sample Programs Listings of the Sample Programs 2-50
3 *CLS (Clear Status) 3-2 *ESE (Event Status Enable) 3-2 *ESR? (Event Status Register) 3-3 *IDN? (Identification Number) 3-4 *LRN? (Learn) 3-5 *OPC (Operation Complete) 3-5 *OPT? (Option) 3-7 *RCL (Recall) 3-7 *RST (Reset) 3-7 *SAV (Save) 3-12 *SRE (Service Request Enable) 3-12 *STB? (Status Byte) 3-13 *TRG (Trigger) 3-13 *TST? (Test) 3-14 *WAI (Wait-to-Continue) 3-14 Common Commands
Common Commands *CLS (Clear Status) Common Commands Common commands are defined by the IEEE 488.2 standard. They control generic device functions that are common to many different types of instruments. Common commands can be received and processed by the analyzer, whether they are sent over the GPIB as separate program messages or within other program messages.
Common Commands *ESR? (Event Status Register) An integer, 0 to 255, representing a mask value for the bits to be enabled in the Standard Event Status Register as shown in Table 3-2 on page 3-3. Example This example enables the User Request (URQ) bit of the Standard Event Status Enable Register. When this bit is enabled and a front-panel key is pressed, the Event Summary bit (ESB) in the Status Byte Register is also set.
Common Commands *IDN? (Identification Number) An integer, 0 to 255, representing the total bit weights of all bits that are high at the time you read the register. Example This example places the current contents of the Standard Event Status Register in the numeric variable, Event. 10 OUTPUT 707;"*ESR?" 20 ENTER 707;Event Table 3-3 lists each bit in the Event Status Register and the corresponding bit weights. Table 3-3.
Common Commands *LRN? (Learn) *LRN? (Learn) Query *LRN? The *LRN? query returns a string that contains the analyzer's current setup. The analyzer's setup can be stored and sent back to the analyzer at a later time. This setup string should be sent to the analyzer just as it is. It works because of its embedded ":SYStem:SETup" header. The *LRN query always returns :SYSTem:SETup as a prefix to the setup block. The SYSTem:HEADer command has no effect on this response.
Common Commands *OPC (Operation Complete) Note Three commands are available for the synchronization between remote command scripts and the instrument: • The *OPC command: This command sets a bit in the Standard Event Status Register when all pending device operations have finished.
Common Commands *OPT? (Option) NOTE If instrument conditions have been set that can not be met, and the *OPC? is sent out, the instrument will not continue remote execution. Under these circumstances, the user must send a device clear or power down to restart the instrument. *OPT? (Option) Query *OPT? The OPT? query returns a string with a list of installed hardware and software options. The query returns a 1 as the first character if option 001 (divided trigger - 12 GHz) is installed.
Common Commands *RST (Reset) Table 3-4. Default Setup (1 of 4) Acquisition Run/Stop 100 ms Grid on 30 Enabled 8 hours Default legend Off Off (until the first marker is placed on the screen) User selectable if more than one source is available. 28 ns Points/Waveform (Record length) Averaging # of Averages 0V Automatic - 1350 points Off 16 Trigger Source Bandwidth Hysteresis Slope Gated Trigger Level Time Base Units Scale Position Reference Front Panel 2.
Common Commands *RST (Reset) Table 3-4. Default Setup (2 of 4) Graticule Intensity Backlight Saver Turn off backlight after Colors Labels Grid on 30 Enabled 8 hours Default legend Off Markers Mode Readout Measure Off (until the first marker is placed on the screen) User selectable if more than one source is available 28 ns 0V User selectable if more than one source is available 24 ns 0V Oscilloscope mode Eye/Mask mode QuickMeas, Meas.1 QuickMeas, Meas. 2 QuickMeas, Meas. 3 QuickMeas, Meas.
Common Commands *RST (Reset) Table 3-4.
Common Commands *RST (Reset) Table 3-4. Default Setup (4 of 4) Utilities Cal Output Calibration Details Self Test Service Extensions Remote Interface Dialog Preferences Allow Multiple Active Dialogs Sound Limit Test Test Measurement Fail when Upper limit Lower limit Run until Run until failures Run until waveforms Store summary Store screen Store waveforms 5.
Common Commands *SAV (Save) *SAV (Save) Command *SAV The *SAV command stores the current state of the analyzer in a save register. is an integer, 0 through 9, specifying which register to save the current analyzer setup. Example See Also 10 OUTPUT 707;"*SAV 3" *RCL (Recall) *SRE (Service Request Enable) Command *SRE The *SRE command sets the Service Request Enable Register bits.
Common Commands *STB? (Status Byte) *STB? (Status Byte) Query *STB? The *STB? query returns the current contents of the Status Byte, including the Master Summary Status (MSS) bit. See Table 3-6 on page 3-13 for Status Byte Register bit definitions. Returned Format is an integer, from 0 to 255. Example This example reads the contents of the Status Byte into the numeric variable, Value.
Common Commands *TST? (Test) The *TRG command has the same effect as the Group Execute Trigger message (GET) or RUN command. It acquires data for the active waveform display, if the trigger conditions are met, according to the current settings. Example 10 OUTPUT 707;"*TRG" *TST? (Test) Query *TST? The *TST? query causes the analyzer to perform a self-test, and places a response in the output queue indicating whether or not the self-test completed without any detected errors.
Common Commands *WAI (Wait-to-Continue) The *WAI command: This command is similar to the *OPC? query as it will also block the execution of the remote script until all pending operations are finished. It is particularly useful if the host computer is connected to two or more instruments. This command will not block the GPIB bus, allowing the computer to continue issuing commands to the instrument not executing the *WAI command.
Common Commands *WAI (Wait-to-Continue) 3-16
4 AEEN 4-2 ALER? 4-3 AUToscale 4-3 BLANk 4-5 CDISplay 4-5 COMMents 4-5 CREE 4-5 CRER? 4-6 DIGitize 4-6 JEE 4-7 JER? 4-8 LER? 4-8 LTEE 4-9 LTER? 4-9 MODel? 4-9 MTEE 4-10 MTER? 4-10 OPEE 4-11 OPER? 4-11 PTEE 4-11 PTER? 4-12 PRINt 4-12 RECall:SETup 4-12 RUN 4-12 SERial 4-13 SINGle 4-13 STOP 4-13 STORe:SETup 4-13 STORe:WAVeform 4-14 TER? 4-14 UEE 4-14 UER? 4-14 VIEW 4-15 Root Level Commands
Root Level Commands AEEN Root Level Commands Root level commands control many of the basic operations of the analyzer that can be selected by pressing the labeled keys on the front panel. These commands are always recognized by the parser if they are prefixed with a colon, regardless of the current tree position. After executing a root level command, the parser is positioned at the root of the command tree.
Root Level Commands ALER? Table 4-1. Enabled Bits for Some Useful Example Mask Values Mask Value Bit 4 CH4 Bit 3 CH3 Bit 2 CH2 Bit 1 CH1 Bit 0 COMP 0 1 • 2 • 3 • 4 • 5 • 6 • • 7 • • 8 16 • • • • • ALER? Query :ALER? This query returns the current value of the Acquisition Limits Event Register as a decimal number and also clears this register. Bit 0 (COMP) of the Acquisition Limits Event Register is set when the acquisition completes.
Root Level Commands AUToscale This command causes the analyzer to evaluate the current input signal and find the optimum conditions for displaying the signal. It adjusts the vertical gain and offset for the channel, and sets the time base on the lowest numbered input channel that has a signal. If signals cannot be found on any vertical input, the analyzer is returned to its former state.
Root Level Commands BLANk Unable to set horizontal scale/delay for channel n Returned Format [:AUToscale] BLANk Command :BLANk {CHANnel | FUNCtion | WMEMory | JDMemory | RESPonse | HISTogram | CGMemory} This command turns off an active channel, function, waveform memory, jitter data memory, TDR response, histogram, or color grade memory. The VIEW command turns them on. is an integer, 1 through 4. Restrictions Software revision A.04.
Root Level Commands CRER? Returned Format [:CREE] Table 4-2. Enabled Bits for Some Useful Example Mask Values Mask Value Bit 5 SPR2 Bit 4 NSPR2 Bit 3 SPR1 Bit 2 NSPR1 Bit 1 LOCK Bit 0 UNLK 0 1 • 2 • 4 • 8 • 16 32 • • CRER? Query :CRER? This query returns the current value of the Clock Recovery Event Register as a decimal number and also clears the register. Refer to “SPResent?” on page 9-9 for more detailed information on receiver one and receiver two.
Root Level Commands JEE NOTE Even though digitized waveforms are not displayed, the full range of measurement and math operators may be performed on them. If you use the DIGitize command with no parameters, the digitize operation is performed on the channels or functions that were acquired with a previous digitize, run, or single operation. In this case, the display state of the acquired waveforms is not changed.
Root Level Commands JER? are used at this time. The following table shows the enabled bits for each useful mask value. Bits that are not marked as enabled for a mask are blocked from affecting the operation status register. Table 4-3. Enabled Bits for Mask Values Mask Value Bit 2 AREQD Bit 1 JLOSS Bit 0 EFAIL 0 1 • 2 • 3 • 4 • 5 • 6 • • 7 • • • • • Query :JEE? The query returns the current decimal value in the Jitter Event Enable Register. Restrictions Jitter mode.
Root Level Commands LTEE This query reads the Local (LCL) Event Register. A “1” is returned if a remote-to-local transition has taken place due to the front-panel Local key being pressed. A “0” is returned if a remote-to-local transition has not taken place. After the LCL Event Register is read, it is cleared. Once this bit is set, it can only be cleared by reading the Status Byte, reading the register with the LER? query, or sending a *CLS common command.
Root Level Commands MTEE A six-character alphanumeric model number in quotation marks. Output is determined by header and longform status as in Table 4-5. Table 4-5. Model? Returned Format HEADER LONGFORM ON OFF ON X OFF X X 86100A X X 86100A X X Example RESPONSE :MOD 86100A X :MODEL 86100A 10 OUTPUT 707;":Model? FRAME" MTEE Command :MTEE This command sets a mask into the Mask Event Enable register.
Root Level Commands OPEE Returned Format [:MTER] OPEE Command :OPEE This command sets a mask in the Operation Status Enable register. Each bit that is set to a “1” enables that bit to set bit 7 in the Status Byte Register, and potentially causes an SRQ to be generated. Bit 5, Wait for Trig, is used. Other bits are reserved. The decimal weight of the enabled bits.
Root Level Commands PTER? Query Returned Format :PTEE? [:PTEE] PTER? Query PTER? This query returns the current value of the Precision Timebase Event Register as a decimal number and also clears this register. Bit 0 (LOSS) of the Precision Timebase Event Register is set when loss of the time reference occurs. Time reference is lost when a change in the amplitude or frequency of the reference clock signal is detected.
Root Level Commands SERial Restrictions In TDR mode (software revision A.06.00 and above), the optional channel argument is not allowed. Example 10 OUTPUT 707;”:RUN” SERial Command :SERial {FRAMe | LMODule | RMODule}, This command sets the serial number for the analyzer frame or module. The serial number is entered by Agilent Technologies. Therefore, setting the serial number is not normally required unless the analyzer is serialized for a different application.
Root Level Commands STORe:WAVeform STORe:WAVeform Command :STORe:WAVeform , This command copies a channel, function, stored waveform, or TDR response to a waveform memory or to color grade memory. The parameter preceding the comma specifies the source and can be any channel, function, response, color grade memory, or waveform memory. The parameter following the comma is the destination, and can be any waveform memory.
Root Level Commands VIEW VIEW Command :VIEW {CHANnel | FUNCtion | WMEMory | JDMemory | RESPonse | HISTogram | CGMemory} This command turns on a channel, function, waveform memory, jitter data memory, TDR response, histogram, or color grade memory. is an integer, 1 through 4. NOTE This command operates on waveform and color grade gray scale data which is not compatible with Jitter Mode. Do not use this command in Jitter Mode with an argument other than JDMemory.
Root Level Commands VIEW 4-16
5 DATE 5-2 DSP 5-2 ERRor? 5-3 HEADer 5-4 LONGform 5-5 MODE 5-6 SETup 5-7 TIME 5-7 System Commands
System Commands DATE System Commands SYSTem subsystem commands control the way in which query responses are formatted, send and receive setup strings, and enable reading and writing to the advisory line of the analyzer. You can also set and read the date and time in the analyzer using the SYSTem subsystem commands. DATE Command :SYSTem:DATE ,, This command sets the date in the analyzer, and is not affected by the *RST common command. Specifies the day in the format <1. . . .
System Commands ERRor? The string is actually read from the message queue. The message queue is cleared when it is read. Therefore, the displayed message can only be read once over the bus. Returned Format Example [:SYSTem:DSP] The following example places the last string written to the advisory line of the analyzer in the string variable, Advisory$.
System Commands HEADer Table 5-1.
System Commands LONGform Example This example examines the header to determine the size of the learn string. Memory is then allocated to hold the learn string before reading it. To output the learn string, the header is sent, then the learn string and the EOF.
System Commands MODE 20 OUTPUT 707;":SYSTEM:LONGFORM?" 30 ENTER 707;Result$ MODE Command :SYSTem:MODE {EYE | OSCilloscope | TDR | JITTer} This command sets the system mode. Specifying Eye/Mask mode, turns off all active channels except the lowest numbered channel. Restrictions Software revision A.04.00 and above (86100C instruments) for Jitter mode argument. Jitter mode is only available on 86100C mainframes with Option 100 or 200.
System Commands SETup :VIEW HISTogram :WAVeform:DATA :WAVeform:DATA? :WMEMory:LOAD :WMEMory:SAVE :WMEMory:DISPlay SETup Command :SYSTem:SETup This command sets up the instrument as defined by the data in the setup string from the controller. read and allocated by the analyzer’s software.
System Commands TIME 5-8
6 AVERage 6-2 BEST 6-2 COUNt 6-2 EYELine 6-3 LTESt 6-3 POINts 6-3 RUNTil 6-4 SSCReen 6-4 SSCReen:AREA 6-5 SSCReen:IMAGe 6-6 SWAVeform 6-6 SWAVeform:RESet 6-7 Acquire Commands
Acquire Commands AVERage Acquire Commands The ACQuire subsystem commands set up conditions for acquiring waveform data, including the DIGitize root level command. The commands in this subsystem select the number of averages and the number of data points. This subsystem also includes commands to set limits on how much data is acquired, and specify actions to execute when acquisition limits are met. AVERage Command :ACQuire:AVERage {{ON | 1} | {OFF | 0}} This command enables or disables averaging.
Acquire Commands EYELine Query Returned Format Example :ACQuire:COUNt? [:ACQuire:COUNt] 10 OUTPUT 707;":ACQUIRE:COUNT 16" EYELine Command :ACQuire:EYELine {{ON | 1} | {OFF | 0}} This command enables or disables eyeline mode. It is only available when pattern lock is turned on in Oscilloscope or Eye/Mask modes. When eyeline is turned on, the relative trigger bit is incremented after each acquisition. When combined with averaging, averaged eyes can be acquired.
Acquire Commands RUNTil Example See Also 10 OUTPUT 707;":ACQUIRE:POINTS 500" :WAVeform:DATA RUNTil Command :ACQuire:RUNTil {OFF | WAVeforms, | SAMples, | PATTerns,}[,CHANnel] This command selects the acquisition run until mode. The acquisition may be set to run until n waveforms, n patterns, or n samples have been acquired, or to run forever (OFF).
Acquire Commands SSCReen:AREA command. If the results of consecutive limit tests must be stored in different files, omit the parameter and use the default filename instead. Each screen image will be saved in a different file named AcqLimitScreenX.bmp, where X is an incremental number assigned by the instrument. The filename field encodes the network path and the directory in which the file will be saved, as well as the file format that will be used. The following is a list of valid filenames.
Acquire Commands SSCReen:IMAGe This command selects which data from the screen is to be saved to disk when the run until condition is met. When you select GRATicule, only the graticule area of the screen is saved (this is the same as choosing Waveforms Only in the Specify Report Action for acquisition limit test dialog box). When you select SCReen, the entire screen is saved. Query :ACQuire:SSCReen:AREA? The query returns the current setting for the area of the screen to be saved.
Acquire Commands SWAVeform:RESet Query :ACQuire:SWAVeform? The query returns the current state of the :ACQuire:SWAVeform command. Returned Format Example [:ACQuire:SWAVeform], [,[,]] 10 OUTPUT 707;”:ACQUIRE:SWAVEFORM CHAN1,OFF” SWAVeform:RESet Command :ACQuire:SWAVeform:RESet This command sets the save destination for all waveforms to OFF. Setting a source to OFF removes any waveform save action from that source.
Acquire Commands SWAVeform:RESet 6-8
7 CANCel 7-4 CONTinue 7-4 ERATio:DLEVel? 7-4 ERATio:STARt 7-4 ERATio:STATus? 7-4 FRAMe:LABel 7-5 FRAMe:STARt 7-5 FRAMe:TIME? 7-5 MODule:LRESistance 7-5 MODule:OCONversion? 7-6 MODule:OPOWer 7-6 MODule:OPTical 7-6 MODule:OWAVelength 7-6 MODule:STATus? 7-7 MODule:TIME? 7-7 MODule:VERTical 7-7 OUTPut 7-7 PROBe 7-8 RECommend? 7-8 SAMPlers 7-8 SDONe? 7-9 SKEW 7-9 SKEW:AUTO 7-10 STATus? 7-10 Calibration Commands
Calibration Commands Calibration Commands This section briefly explains the calibration of the instrument. It is intended to give you and the calibration lab personnel an understanding of the calibration procedure and how the calibration subsystem is intended to be used. Also, this section acquaints you with the terms used in this chapter, help screens, and data sheets. A calibration procedure is included at the end of this chapter.
Calibration Commands You initiate a module calibration from the Modules tab on the All Calibrations dialog box or by sending the :CALibrate:MODule:VERTical command as shown in the following example. DIM Prompt$[64] OUTPUT 707;":CALIBRATE:MODULE:VERTICAL LMODULE” OUTPUT 707;":CALIBRATE:SDONE?” ENTER 707;Prompt$ OUTPUT 707;":CALIBRATE:CONTINUE” OUTPUT 707;":CALIBRATE:SDONE?” ENTER 707;Prompt$ NOTE Let the Module Warm Up First.
Calibration Commands CANCel CAUTION The input circuits can be damaged by electrostatic discharge (ESD). Avoid applying static discharges to the frontpanel input connectors. Momentarily short the center and outer conductors of coaxial cables prior to connecting them to the front-panel inputs. Before touching the front-panel input connectors be sure to first touch the frame of the instrument. Be sure the instrument is properly earth-grounded to prevent buildup of static charge.
Calibration Commands FRAMe:LABel FRAMe:LABel Command :CALibrate:FRAMe:LABel
Calibration Commands MODule:OCONversion? MODule:OCONversion? Query :CALibrate:MODule:OCONversion? {LMODule | RMODule | CHANnel},{WAVelength 1 | WAVelength 2 | USER} This query returns the optical conversion (responsivity) of the specified channel at the specified wavelength. Wavelength 1 and Wavelength 2 are for factory-calibrated wavelengths. USER is the result of a user optical calibration.
Calibration Commands MODule:STATus? MODule:STATus? Query :CALibrate:MODule:STATus?{LMODule | RMODule} This query returns the status of the module calibration (electrical and optical channels) and optical calibration (optical channels) as either CALIBRATED or UNCALIBRATED. It will return UNKNOWN if the module does not have calibration capability. Queries to modules with two electrical channels (including TDR modules) will return the status of module calibration only.
Calibration Commands PROBe This command sets the dc level of the calibrator signal output through the front-panel CAL connector. Example This example puts a dc voltage of 2.0 V on the analyzer Cal connector. 10 OUTPUT 707;":CALIBRATE:OUTPUT 2.0" dc level value in volts, adjustable from –2.0 V to +2.0 Vdc. Query :CALibrate:OUTPut? The query returns the current dc level of the calibrator output.
Calibration Commands SDONe? This command enables or disables the samplers in the module. Example The following example enables sampler calibration for the module. Query 10 OUTPUT 707;":CALIBRATE:SAMPLERS ENABLE" :CALibrate:SAMPlers? The query returns the current calibration enable/disable setting. Returned Format Example [:CALibrate:SAMPlers]{DISable | ENABle} The following example gets the current setting for sampler calibration, stores it in the variable Sampler$.
Calibration Commands SKEW:AUTO SKEW:AUTO Command CALibrate:SKEW:AUTO This command sets the horizontal skew of multiple, active channels with the same bit rate, so that the waveform crossings align with each other. In addition, auto skew optimizes the instrument trigger level. Prior to auto skew, at least one channel must display a complete eye diagram in order to make the initial bit rate measurement. Mode NRZ Eye mode only. NOTE In Jitter Mode, skew adjustments are disabled.
8 BANDwidth 8-2 DISPlay 8-2 FDEScription? 8-3 FILTer 8-3 FSELect 8-3 OFFSet 8-4 PROBe 8-4 PROBe:CALibrate 8-4 PROBe:SELect 8-5 RANGe 8-5 SCALe 8-6 TDRSkew 8-6 UNITs 8-7 UNITs:ATTenuation 8-7 UNITs:OFFSet 8-7 WAVelength 8-8 Channel Commands
Channel Commands BANDwidth Channel Commands The CHANnel subsystem commands control all vertical (Y axis) functions of the analyzer. You may toggle the channel displays on and off with the root level commands VIEW and BLANk, or with DISPlay. BANDwidth Command :CHANnel:BANDwidth {HIGH | MID | LOW} This command controls the channel bandwidth setting. When HIGH, the bandwidth is set to the upper bandwidth limit. When LOW, a lower bandwidth setting is selected in order to minimize broadband noise.
Channel Commands FDEScription? 10 OUTPUT 707;"SYSTEM:HEADER OFF" 20 OUTPUT 707;":CHANNEL1:DISPLAY?" 30 ENTER 707;Display FDEScription? Query :CHANnel:FDEScription? This query returns the number of filters and a brief description of each filter for channels with one or more internal low-pass filters. The filter description is the same as the softkey label for the control used to select the active filter. represents the channel number and is an integer 1 to 4.
Channel Commands OFFSet Example The following example places the current setting of the filter in the string variable, Filter$ See Also 10 DIM Filter$[50] !Dimension variable 20 OUTPUT 707;":CHANNEL1:FSELECT?" 30 ENTER 707;Filter$ CHANnel:FDEScription? OFFSet Command :CHANnel:OFFSet This command sets the voltage that is represented at the center of the display for the selected channel. Offset parameters are probe and vertical scale dependent.
Channel Commands PROBe:SELect This command starts the probe’s calibration for the selected channel. It has the same action as the command :CALibrate:PROBe CHANnel. For more information about probe calibration, refer to “Probe Calibration” on page 7-3. represents the channel number and is an integer 1 to 4. Example The following example starts calibration for Channel 1.
Channel Commands SCALe is set to differential or common mode, or when OHM, REFLect, or GAIN units are selected, the instrument will change scale to magnify scale. This command is used to set the magnify range as well as the range. represents the channel number and is an integer 1 to 4. NOTE In Jitter Mode, channel scale and offset controls are disabled. Do not use this command in Jitter Mode. It generates a “Settings conflict” error. Full-scale voltage of the specified channel number.
Channel Commands UNITs This command sets the TDR skew for the given channel. The TDR skew control moves the TDR step relative to the trigger position. The control may be set from –100 to 100 percent of the allowable range. This command is only applicable to TDR channels. This command is enabled only if a stimulus is currently active and if the module has differential capability.
Channel Commands WAVelength WAVelength Command :CHANnel:WAVelength {WAVelength1 | WAVelength2 | WAVelength3 | USER} This command sets the wavelength selection for optical channels. Modules can support one, two, or three factory-defined wavelengths. The module will have one factory calibration for each factory-defined wavelength. Invoke these calibrations using WAV1, WAV2, or WAV3. One user-defined wavelength may also be defined via the Channel Calibrate menu.
9 CLBandwidth 9-4 CRATe 9-5 INPut 9-5 LBANdwidth 9-5 LBWMode 9-6 LOCKed? 9-6 ODRatio 9-7 ODRatio:AUTO 9-7 RATE 9-7 RDIVider 9-9 RELock 9-9 SPResent? 9-9 TDENsity? 9-10 Clock Recovery Commands
Clock Recovery Commands Clock Recovery Commands The Clock RECovery (CREC) subsystem commands control the clock recovery modules. This includes setting data rates, as well as querying locked status and signal present conditions. Refer to Table 9-1 for a listing of which subsystem commands work with each module. Refer to Table 9-2 on page 9-4 for a listing of available data rates for each module. 83496A Option 300 83496A 83495A 83494A 83493A 83492A Command 83491A Table 9-1.
Clock Recovery Commands fixed. For the external output, the loop bandwidth is 4 to 5 MHz. On 83491/2/3A modules, the internal triggering loop bandwith is 50 to 70 kHz; on 83494A modules, it is 90 kHz. For 83492/ 3/4A modules, use the SPResent to check if an optical signal is detected by the module. 83495A Module Agilent 83495A modules provide both optical and electrical clock recovery for all rates from 9.953 Gb/s to 11.32 Gb/s. Use the INPut command to select the optical or electrical input.
Clock Recovery Commands CLBandwidth 83494 83494 Option 103 83494 Option 106 83494 Option 107 83496 Option 200 83493 83496 83492 Trigger on data • • • • • • • 155.52 • • • • • • 622.08 • • • • • • 1062.50 • • 1250.00 • • 2125.00 • • 2488.32 • • • 2500.00 • • • Rate (Mb/s) 83495 83491 Table 9-2. Module Data Rates • • • • • • • • • • • • • • • • • • • 2666.06 9953.28 • • • • • • • • • • 10312.50 10664.23 10709,225 9.953 Gb/s– 11.
Clock Recovery Commands CRATe CRATe Command (83496A) :CRECovery{1 | 3}:CRATe This 83496A command sets or queries an 83496A module’s data rate setting. Although the command “RATE” on page 9-7 can be used with 83496A modules, use the preferred CRATe command in all new programs controlling an 83496A module. The data rate for standard 83496A modules ranges from 50 Mb/s to 7.10 Gb/s. The data rate for Option 200 modules ranges from 50 Mb/s to 13.50 Gb/s.
Clock Recovery Commands LBWMode Returned Format [:CRECovery{1 | 3}:LBANdwidth] {BW270KHZ | BW300KHZ | BW1500KHZ | BW4MHZ | CONTinuous} Table 9-3. Valid Loop Bandwidth Arguments Versus Modules Arguments a 83495A BW270KHZ ✺b ✺ • ✺ BW1500KHZ c • BW4MHZ CONTinuous 83496A (Not Opt. 300) ✺ BW300KHZ a. b. c. d. 83496A • • d The ✺ symbol indicates the default data rate. Default and only selection for data rates below 1 Gb/s. Default ≥1 Gb/s. Unavailable for data rates below 1 Gb/s.
Clock Recovery Commands ODRatio Example 10 OUTPUT 707;":CRECOVERY1:LOCKED?" ODRatio Command (83496A) :CRECovery{1 | 3}:ODRatio This 83496A command sets or queries the output clock divide ratio. This determines the data rate at the front-panel recovered clock output. The ratio can be set to a value of 1, 2, 4, 8, or 16. Sending this command while the output divider is set to auto (refer to “ODRatio:AUTO” on page 9-7), results in a settings conflict error. Restrictions 83496A.
Clock Recovery Commands RATE Example [:CRECovery{1 | 3}:RATE] {TOData | R155 | R622 | R1062 | R1250 | R2125 | R2488 | R2500 | R2666 | R9953 | R10312 | R10664 | R10709 | RANGE10G | CONTinuous} 20 OUTPUT 707;":CRECOVERY1:RATE?" Table 9-4.
Clock Recovery Commands RDIVider RDIVider Command (83496A Opt. 300) :CRECovery{1 | 3}:RDIVider This 83496A Option 300 command sets or queries the data-rate divide ratio. This value is used to compute loop bandwidth when in the rate-dependent loop bandwidth mode. Refer to the RDIVider argument of the command “LBWMode” on page 9-6. The default value is 5000. Restrictions 83496A Option 300 modules. Software revision A.04.20 and above.
Clock Recovery Commands TDENsity? Table 9-5. Signal Present Return Status vs. Receiver Number Module Model Receiver 1 Short Wavelength Receiver 2 Long Wavelength 83491 0 0 83492 1/0 1/0 83493 0 1/0 83494 0 1/0 83494 Option 103 0 1/0 83494 Option 106 0 1/0 83494 Option 107 0 1/0 a a. Only one receiver at a time can have a signal present.
10 CDIRectory 10-2 DELete 10-2 DIRectory? 10-3 LOAD 10-3 MDIRectory 10-4 PWAVeform:LOAD 10-4 PWAVeform:PPBit 10-5 PWAVeform:RANGe 10-5 PWAVeform:RANGe:STARt 10-5 PWAVeform:RANGe:STOP 10-6 PWAVeform:SAVE 10-6 PWD? 10-6 SIMage 10-7 SPARameter:SAVE 10-8 STORe 10-9 Disk Commands
Disk Commands CDIRectory Disk Commands The DISK subsystem commands allow storage and retrieval of waveforms and setups, remote screen captures, as well as formatting the disk. Some commands in this subsystem operate only on files and directories on “D:\User Files” (C: on 86100A/B) or on any external drive or mapped network drive. These instances are noted in the command section. When specifying a file name, you must enclose it in quotation marks.
Disk Commands DIRectory? The file “D:\User Files” cannot be deleted. NOTE This command operates only on files and directories on “D:\User Files” (C: on 86100A/B) or on any external drive or mapped network drive. Example 10 OUTPUT 707;":DISK:CDIRECTORY SETUPS" 20 OUTPUT 707;":DISK:DELETE ""FILE1.SET""" DIRectory? Query :DISK:DIRectory? [ "" | {CGRade | ROOT | LSUMmaries | SETups | SIMages | SMASks | TDRCal | UMASks | WAVeforms}] This query returns the requested directory listing.
Disk Commands MDIRectory tion is not saved in jitter data or color grade-gray scale memory files. If you plan on loading these files back into the instrument, be sure to also store the instrument setup. You will need to load (restore) the instrument settings when you load the memory file. The filename, with a extension: .wfm, .txt, .cgs, .msk, .pcm, .set, .jd, or .tdr as a suffix after the filename. If no file suffix is specified, the default is .wfm.
Disk Commands PWAVeform:PPBit Loads a pattern waveform file into color gray-scale memory. If the pattern waveform file contains data from several sources, only the data from one of the sources can be loaded from the file. Use the CHANnel or FUNCtion arguments to select the source data to load into memory. Source data from CHANnel1 is selected by default. If you plan on loading a saved pattern waveform back into the instrument, be sure to also save the instrument setup.
Disk Commands PWAVeform:RANGe:STOP Returned Format Example [:DISK:PWAVeform:RANGe:STARt] 10 OUTPUT 707;":DISK:PWAVEFORM:RANGE:START 10" PWAVeform:RANGe:STOP Restrictions Software revision 4.10 and above on an 86100C. Option 201, Advanced Waveform Analysis Software installed. Command :DISK:PWAVeform:RANGe:STOP Sets or queries the stop bit setting for saving a range of pattern waveform bits using the DISK:PWAVeform:SAVE command. is an integer.
Disk Commands SIMage SIMage Command :DISK:SIMage ""[, [,]] This command remotely captures images of the active window on the instrument’s display. On 86100C instruments, if the 86100 application has been minimized, an image of the desktop or another application will be captured. Also, when capturing images from an 86100C, first deactivate the Windows XP screen saver. Otherwise, if the screen saver is active, the captured image may be solid black.
Disk Commands SPARameter:SAVE This parameter specifies which color scheme is to be used during the screen save operation. The default value is INVert; this scheme saves the waveforms over a white background. SPARameter:SAVE Command :DISK:SPARameter:SAVE ,""[,[,]] Saves an S-parameter waveform to ASCII Touchstone files and text files. Before you can save S-parameter data to a file, you must first display the S-parameter graph using the command “TDRSparam” on page 19-3.
Disk Commands STORe Line 3 begins with the # character. The specifies Hz, KHz, MHz, or GHz. The field specifies S. The field specifies DB for magnitude (logarithmic) -angle. The field specifies the reference resistance in ohms, where n is the positive number of ohms of the real impedance to which the parameters are calibrated. Line 4 immediately precedes the data and labels the fields contained in the data lines.
Disk Commands STORe NOTE In Jitter Mode, this command generates a “Settings conflict” error if sources other than SETup and JDSource are specified. With the argument, represents an integer from 1 to 4, which identifies the channel, function, TDR response or waveform memory number. Name of the file, with a maximum of 254 characters (including the path name, if used). The file name assumes the present working directory if a path does not precede the file name.
11 CGRade:LEVels? 11-2 CONNect 11-2 DATA? 11-3 DCOLor (Default COLor) 11-3 GRATicule 11-3 JITTer:BATHtub:YSCale 11-4 JITTer:GRAPh 11-4 JITTer:HISTogram:YSCale 11-4 JITTer:LAYout 11-5 JITTer:PJWFrequency 11-5 JITTer:PJWTracking 11-5 JITTer:SHADe 11-5 LABel 11-6 LABel:DALL 11-6 PERSistence 11-6 RRATe 11-7 SCOLor 11-7 SSAVer 11-9 Display Commands
Display Commands CGRade:LEVels? Display Commands The DISPlay subsystem controls the display of data, markers, text, graticules, and the use of color. You select the display mode using the ACQuire:TYPE command. Select the number of averages using ACQuire:COUNt. CGRade:LEVels? Query :DISPlay:CGRade:LEVels? [CHANnel | FUNCtion | CGMemory] This query returns the range of hits represented by each color for the specified source.
Display Commands DATA? DATA? Query :DISPlay:DATA? [[, [,]]] Returns an image of the current display in the specified file format. If no arguments are specified, the default selections are PCX file type, SCReen mode, and inversion set to INVert. The BMP and JPG file formats are the only formats that are saved with 24 bit color. For the highest quality image, use one of these formats.
Display Commands JITTer:BATHtub:YSCale Example [:DISPlay:GRATicule:INTensity] This example places the current display graticule setting in the string variable, Setting$. 20 OUTPUT 707;":DISPLAY:GRATICULE?" 30 ENTER 707;Setting$ JITTer:BATHtub:YSCale Command :DISPlay:JITTer:BATHtub:YSCale {BER | Q} This command sets the vertical scale of the bathtub display to either BER or Q. Restrictions Jitter mode. Software revision A.04.10 and above (86100C instruments) with 200.
Display Commands JITTer:LAYout JITTer:LAYout Command :DISPlay:JITTer:LAYout {SINGle|SPLit|QUAD} This command sets the number of graphs displayed when in jitter mode. SINGle specified one graph, SPLit specifies two graphs and QUAD specifies four graphs. Restrictions Jitter mode (86100C instruments). Software revision A.04.00 and above with Option 100 or software revision A.04.10 and above with Option 200.
Display Commands LABel Query Returned Format Example :DISPlay:JITTer:SHADe? [:DISPlay:JITTer:SHADe] {{ON | 1}|{OFF | 0}} 10 OUTPUT 707;”:DISPlay:JITTer:SHADe ON” LABel Command :DISPlay:LABel “” [,[,[,[,]]]] This command allows you to place a label on the graticule area of the display. The operator should periodically clear the labels using the LABel:DALL command.
Display Commands RRATe Table 11-2. CGRade and GSCale Arguments Persistence Mode Minimum Infinite Variable Eye/Mask TDR/TDT X X X Oscilloscope X X X Color Grade Gray Scale X X X X Query :DISPlay:PERSistence? The query returns the current persistence value. Returned Format Example [:DISPlay:PERSistence] {MINimum | INFinite | | CGRade | GSCale} This example places the current persistence setting in the string variable, Setting$.
Display Commands SCOLor CHANnel3 | CHANnel4 | GRID | IMEasurement | MARGin | MARKers | MASK | MEASurements | WBACkgrnd | WOVerlap | WMEMories | WINText} Table 11-3.
Display Commands SSAVer The luminosity control sets the color brightness of the chosen display element. A 100% luminosity is the maximum color brightness. A 0% luminosity is pure black. Example This example sets the hue to 50, the saturation to 70, and the luminosity to 90 for the markers. Query Returned Format Example 10 OUTPUT 707;":DISPLAY:SCOLOR MARKERS,50,70,90" :DISPlay:SCOLor? The query returns the hue, saturation, and luminosity for the specified color.
Display Commands SSAVer 11-10
12 ADD 12-3 DIFF 12-3 DISPlay 12-3 FUNCtion? 12-3 HORizontal 12-4 HORizontal:POSition 12-4 HORizontal:RANGe 12-5 INVert 12-5 MAGNify 12-5 MAXimum 12-5 MINimum 12-6 MULTiply 12-6 OFFSet 12-6 PEELing 12-7 RANGe 12-7 SUBTract 12-7 VERSus 12-8 VERTical 12-8 VERTical:OFFSet 12-8 VERTical:RANGe 12-9 Function Commands
Function Commands Function Commands The FUNCtion subsystem defines up to four functions: 1 through 4. The function is indicated in the FUNCtion syntax, for example FUNCtion1. Use the following commands (math operators) to define a funtion: ADD, DIFF, INVert, MAGNify, MAXimum, MINimum, MULTiply, PEELing, SUBTract, and VERSus.
Function Commands ADD ADD Command :FUNCtion:ADD , Defines a function that adds source 1 to source 2, point by point, and places the result in the selected function waveform. When vertical scaling is set to Auto, the instrument automatically sets vertical scale and offset to display the entire function on the display. Any changes to vertical scale or offset to the source waveform are tracked. In Manual mode, you set the function's vertical scale and offset; tracking is disabled.
Function Commands HORizontal The is any active math operation for the selected function. The is any allowable source for the selected FUNCtion, including channels, waveform memories, or functions. If the function is applied to a constant, the source returns the constant. Example 10 OUTPUT 707;":FUNCTION1?" If the headers are off (see :SYSTem:HEADers), the query returns only the operands, not the operator.
Function Commands HORizontal:RANGe 40 ENTER 707;Value HORizontal:RANGe Command :FUNCtion:HORizontal:RANGe This command sets the current time range for the specified function. This automatically selects manual mode. is the width of screen in current X-axis units (usually seconds). Restrictions This command applies only to the Magnify and Versus operators.
Function Commands MINimum This command defines a function that computes the maximum value of the operand waveform in each time bucket. Restrictions Not available in Jitter mode. Example {CHANnel | FUNCtion | WMEMory | } 10 OUTPUT 707;":FUNCTION1:MAXIMUM CHANNEL1" MINimum Command :FUNCtion:MINimum This command defines a function that computes the minimum value of each time bucket for the defined operand’s waveform.
Function Commands PEELing NOTE This query returns the current offset value of the specified function only when the respective function display is ON. Returned Format Example [:FUNCtion:OFFSet] 20 OUTPUT 707;":FUNCTION2:DISPLAY ON" 30 OUTPUT 707;":FUNCTION2:OFFSET?" PEELing Command :FUNCtion:PEELing Defines a function that applies TDR peeling to source 1 and places the result in the selected function waveform.
Function Commands VERSus Example This example defines a function that subtracts waveform memory 1 from channel 1. 10 OUTPUT 707;":FUNCTION1:SUBTRACT CHANNEL1,WMEMORY1" VERSus Command :FUNCtion:VERSus , This command defines a function for an X-versus-Y display. The first operand defines the Y axis and the second defines the X axis. The Y-axis range and offset are initially equal to that of the first operand and can be adjusted with the RANGe and OFFSet commands in this subsystem.
Function Commands VERTical:RANGe VERTical:RANGe Command :FUNCtion:VERTical:RANGe This command defines the full-scale vertical axis of the selected function. This automatically changes the mode from auto to manual, if the scope is not already in manual mode. is the full-scale vertical range. Query :FUNCtion:VERTical:RANGe? This query returns the current range setting of the specified function only when the respective function display is ON.
Function Commands VERTical:RANGe 12-10
13 AREA 13-2 DPRinter 13-2 FACTors 13-3 IMAGe 13-3 PRINters? 13-4 Hardcopy Commands
Hardcopy Commands AREA Hardcopy Commands The HARDcopy subsystem commands set various parameters for printing the screen. The print sequence is activated when the root level :PRINt command is sent. AREA Command :HARDcopy:AREA {GRATicule | SCReen} This command selects which data from the screen is to be printed. When you select GRATicule, only the graticule area of the screen is printed (this is the same as choosing Waveforms Only in the Configure Printer dialog box).
Hardcopy Commands FACTors The query returns the current printer number and string. Returned Format [:HARDcopy:DPRinter?] {,,DEFAULT} Or, if there is no default printer (no printers are installed), only a is returned. Example This example places the current setting for the hardcopy printer in the string variable, Setting$.
Hardcopy Commands PRINters? PRINters? Query :HARDcopy:PRINters? This query returns the currently available printers. Returned Format [:HARDcopy:PRINters][,] Number of printers currently installed. The printer number and the name of an installed printer. The word DEFAULT appears next to the printer that is the currently selected default printer.
14 AXIS 14-2 MODE 14-3 SCALe:SIZE 14-3 SOURce 14-4 WINDow:BORDer 14-4 WINDow:DEFault 14-4 WINDow:SOURce 14-4 WINDow:X1Position 14-5 WINDow:X2Position 14-5 WINDow:Y1Position 14-6 WINDow:Y2Position 14-6 Histogram Commands
Histogram Commands AXIS Histogram Commands The Histogram commands and queries control the histogram features. A histogram is a probability distribution that shows the distribution of acquired data within a user-definable histogram window. You can display the histogram either vertically, for voltage measurements, or horizontally, for timing measurements. The most common use for histograms is measuring and characterizing noise or jitter on displayed waveforms.
Histogram Commands MODE Query Returned Format Example 10 OUTPUT 707;”:HISTOGRAM:AXIS VERTICAL” :HISTogram:AXIS? The query returns the currently selected histogram axis. [:HISTogram:AXIS] {VERTical | HORizontal} 10 DIM Axis$[50] 20 OUTPUT 707;”:HISTOGRAM:AXIS?” 30 ENTER 707;Axis$ MODE Command :HISTogram:MODE {ON | OFF | WAVeform} This command selects the histogram mode. The histogram may be off or set on, to track the waveform database.
Histogram Commands SOURce SOURce Command :HISTogram:SOURce {CHANnel | FUNCtion | RESPonse | CGMemory} This command selects the source of the histogram window. The histogram window will track the source’s vertical and horizontal scale. If the optional append parameter is not used when a .cgs file is loaded, the window source is set to CGMemory. No other source may be selected until the histogram database is cleared. is an integer, 1through 4.
Histogram Commands WINDow:X1Position until the histogram database is cleared. is an integer, 1through 4. The :WINDow:SOURce command serves the same function as the :SOURce command and has been retained for compatibility with the Agilent 83480A/54750A. Example The following example sets the histogram window’s source to Channel 1. Query 10 OUTPUT 707;”:HISTOGRAM:WINDOW:SOURCE CHANNEL1” :HISTogram:WINDow:SOURce? The query returns the currently selected histogram window source.
Histogram Commands WINDow:Y1Position 30 ENTER 707;X2$ WINDow:Y1Position Command :HISTogram:WINDow:Y1Position This command moves the Y1 marker of the histogram window. The histogram window selects a portion of the database to histogram. The histogram window markers will track the scale of the histogram window source. Example The following example sets the position of the Y1 marker to –250 mV.
15 FAIL 15-2 JITTer 15-2 LLIMit 15-3 MNFound 15-3 RUNTil 15-4 SOURce 15-4 SSCReen 15-5 SSCReen:AREA 15-6 SSCReen:IMAGe 15-7 SSUMmary 15-7 SWAVeform 15-8 SWAVeform:RESet 15-9 TEST 15-9 ULIMit 15-9 Limit Test Commands
Limit Test Commands FAIL Limit Test Commands The Limit Test commands and queries control the limit test features of the analyzer. Limit testing automatically compares measurement results with pass or fail limits. The limit test tracks up to four measurements. The action taken when the test fails is also controlled with commands in this subsystem. FAIL Command :LTESt:FAIL {INSide | OUTSide | ALWays | NEVer} This command sets the fail condition for an individual measurement.
Limit Test Commands LLIMit cleared and the new measurement to be added. All measurements may be cleared by executing the :MEASure:CLEar command. Use the :MEASure:RESults? query to get the names of the currently selected measurements. Restrictions Software revision A.04.00 and above. Example The following example selects the total jitter measurement for limit testing.
Limit Test Commands RUNTil Query :LTESt:MNFound? The query returns the current action set by the command. Returned Format Example [:LTESt:MNFound] {FAIL | PASS | IGNore} 10 OUTPUT 707;”:LTEST:MNFOUND PASS” RUNTil Command :LTESt:RUNTil FAILures, This command determines the termination conditions for the test. The keywords RUN or RUMode (Run Until Mode) may also be used. This command is compatible with the Agilent 83480/54750.
Limit Test Commands SSCReen Note As a measurement is activated, the associated measurement limit test is programmed according to default values expressed by the following script: :LTESt:SOURce :LTESt:FAIL OUTSIde :LTESt:LLIMIt -10 :LTESt:ULIMIt 10 :LTESt:MNFound FAIL :LTESt:RUNTil FAILUres, 1 Before a measurement limit test is initiated, you must make the necessary adjustments to the default values otherwise these values will be used during the limit test.
Limit Test Commands SSCReen:AREA command. If the results of consecutive limit tests must be stored in different files, omit the parameter and use the default filename instead. Each screen image will be saved in a different file named MeasLimitScreenX.bmp, where X is an incremental number assigned by the instrument. The filename field encodes the network path and the directory in which the file will be saved, as well as the file format that will be used.
Limit Test Commands SSCReen:IMAGe Example This example selects the graticule for printing. Query 10 OUTPUT 707;":LTESt:SSCReen:AREA GRATICULE" :LTESt:SSCReen:AREA? The query returns the current setting for the area of the screen to be saved. Returned Format Example [:LTESt:SSCReen:AREA] {GRATicule | SCReen} This example places the current selection for the area to be saved in the string variable, Selection$.
Limit Test Commands SWAVeform Query 10 OUTPUT 707;”:LTEST:SSUMMARY DISK,TEST” :LTESt:SSUMmary? The query returns the current specified destination for the summary. Returned Format Example [:LTESt:SSUMmary] {OFF | DISK {,}} The following example returns the current destination for the summary.
Limit Test Commands SWAVeform:RESet SWAVeform:RESet Command :LTESt:SWAVeform:RESet This command sets the save destination for all waveforms to OFF. Setting a source to OFF removes any waveform save action from that source. This is a convenient way to turn off all saved waveforms if it is unknown which are being saved. Example 10 OUTPUT 707;”:LTEST:SWAVeform:RESet” TEST Command :LTESt:TEST {ON | 1 | OFF | 0} This command controls the execution of the limit test function.
Limit Test Commands ULIMit 30 ENTER 707;ULIM$ 15-10
16 PROPagation 16-2 REACtance? 16-2 REFerence 16-2 RPANnotation 16-3 STATe 16-3 X1Position 16-3 X1Y1source 16-4 X2Position 16-4 X2Y2source 16-5 XDELta? 16-5 XUNITs 16-5 Y1Position 16-5 Y2Position 16-6 YDELta? 16-6 YUNITs 16-6 Marker Commands
Marker Commands PROPagation Marker Commands The commands in the MARKer subsystem are used to specify and query the settings of the time markers (X axis) and current measurement unit markers (volts, amps, and watts for the Y axis). The Y-axis measurement units are typically set using the CHANnel:UNITs command. PROPagation Command :MARKer:PROPagation {DIELectric | METer}, This command sets the propagation velocity for TDR and TDT measurements.
Marker Commands RPANnotation Specifies the marker reference for TDR and TDT style markers. If the references is TRIGger, then all horizontal axis marker measurements are made with respect to the trigger point. If the reference is REFPlane, then all horizontal axis marker measurements are made with respect to the reference plane. This feature is available only TDR/TDT mode. Query :MARKer:REFerence? The query returns the status of the marker reference.
Marker Commands X1Y1source This command sets the X1 marker position, and moves the X1 marker to the specified time with respect to the trigger time, if the X1 marker is on. is the time at X1 marker in seconds. Query :MARKer:X1Position? The query returns the time at the X1 marker position. Returned Format Examples [:MARKer:X1Position] This example sets the X1 marker to 90 ns.
Marker Commands X2Y2source X2Y2source Command :MARKer:X2Y2source {CHANnel | FUNCtion | RESPonse | WMEMory} This command sets the source for the X2 and Y2 markers. specifies channels, functions, TDR responses and waveform memories: 1, 2, 3, or 4. The source you specify must be enabled for markers to be displayed. If the channel, function, TDR response or waveform memory that you specify is not on, an error message is issued and the query will return NONE.
Marker Commands Y2Position Returned Format Example [:MARKer:Y1Position] This example sets the Y1 marker to 10 mV. 10 OUTPUT 707;":MARKER:Y1POSITION 10E-3" Y2Position Command :MARKer:Y2Position This command sets the Y2 manual marker position and moves the Y2 manual marker to the specified value on the specified source if the Y2 marker is in manual state. is the current measurement unit value at Y2.
17 ALIGn 17-3 AMEThod 17-3 AOPTimize 17-3 COUNt:FAILures? 17-4 COUNt:FSAMples? 17-4 COUNt:HITS? 17-4 COUNt:SAMPles? 17-5 COUNt:WAVeforms? 17-5 DELete 17-5 EXIT 17-5 LOAD 17-5 MASK:DELete 17-6 MMARgin:PERCent 17-6 MMARgin:STATe 17-6 RUNTil 17-6 SAVE 17-7 SCALe:DEFault 17-7 SCALe:MODE 17-8 SCALe:SOURce? 17-8 SCALe:X1 17-8 SCALe:XDELta 17-9 SCALe:Y1 17-9 SCALe:Y2 17-9 SOURce 17-10 SCALe:YTRack 17-10 SSCReen 17-10 SSCReen:AREA 17-11 SSCReen:IMAGe 17-12 SSUMmary 17-12 STARt 17-12 SWAVeform 17-13 SWAVeform:RESet
Mask Test Commands Mask Test Commands The Mask Test commands and queries control the mask test features. Mask testing automatically compares measurement results with the boundaries of the mask you select. Any waveform or sample that falls within the boundaries of the mask is recorded as a failure. NOTE Compatibility with the Agilent 83480A/54750A. In commands with a REGion parameter, POLYgon may be used in place of REGion for compatibility with the Agilent 83480A/54750A.
Mask Test Commands ALIGn ALIGn Command :MTESt:ALIGn This command automatically aligns and scales the mask to the current waveform. Example 10 OUTPUT 707;”:MTEST:ALIGN” AMEThod Command :MTESt:AMEThod {NRZeye | RZeye | ECMean | NONE} This command sets the mask alignment method. This command should be used in the setup section of a mask file when defining a custom mask. It will ensure that the mask will be properly aligned if more alignment methods become available in the future.
Mask Test Commands COUNt:FAILures? COUNt:FAILures? Query :MTESt:COUNt:FAILures? REGion The query returns the number of failures that occurred within a particular region. By defining regions within regions, then counting the failures for each individual region, you can implement testing at different tolerance levels for a given waveform. The value 9.999E37 is returned if mask testing is not enabled or if you specify a region number that is not used.
Mask Test Commands COUNt:SAMPles? Example 10 OUTPUT 707;”:SYSTEM:HEADER OFF” 20 OUTPUT 707;”:MTEST:COUNT:HITS? MARGin” COUNt:SAMPles? Query :MTESt:COUNt:SAMPles? The query returns the total number of samples captured in the current mask test run. The value 9.999E37 is returned if mask testing is not enabled. Returned Format [:MTESt:COUNt:SAMPles] is the total number of samples for the current test run.
Mask Test Commands MASK:DELete can specify the entire path, or use a relative path such as “.” or “..” If you use a relative path, the present working directory is assumed. Use DISK:CDIRectory to change the present working directory, and DISK:PWD? to query it. If no path is specified, a search path is followed. The directory D:\scope\masks is searched first, then D:\User Files\masks. If no filename extension is specified, an attempt will be made to open a file having the specified filename with a ‘.
Mask Test Commands SAVE This command selects the acquisition run until mode. The acquisition may be set to run until n fsamples have been acquired or to run forever (OFF). If more than one limit test criteria is set, then the instrument will act upon the completion of whichever limit test criteria is achieved first. NOTE Compatibility with the Agilent 83480A/54750A. The :MTESt:RUMode command serves the same function and has been retained for compatibility with the Agilent 83480A/54750A.
Mask Test Commands SCALe:MODE SCALe:MODE Command :MTESt:SCALe:MODE {XANDY| XONLy} This command sets the mask scaling mode. This command should be used in the setup section of a mask file when defining a custom mask. It ensures the mask will be properly loaded and adjusted on the screen. Scale mode needs to be specified for fixed voltage masks. All other masks are loaded as XANDY mode.
Mask Test Commands SCALe:XDELta SCALe:XDELta Command :MTESt:SCALe:XDELta This command defines the position of the X2 marker with respect to the X1 marker. In the mask test coordinate system, the X1 marker defines where X=0; thus, the X2 marker defines where X=1. Because all X vertices of regions defined for mask testing are normalized with respect to X1 and ΔX, redefining ΔX also moves those vertices to stay in the same locations with respect to X1 and ΔX.
Mask Test Commands SOURce Y = (Y × (Y2 – Y1)) + Y1 Thus, if you set Y1 to 100 mV, and Y2 to 1 V, a Y value of .100 in a vertex is at 190 mV. is a voltage value specifying the location of the Y2 marker. Query :MTESt:SCALe:Y2? The query returns the current setting of the Y2 marker. Returned Format Example [:MTESt:SCALe:Y2] 10 OUTPUT 707;”:MTEST:SCALE:Y2 2.5” SOURce Command :MTESt:SOURce {CHANnel | FUNCtion | CGMemory} This command sets the database source for mask tests.
Mask Test Commands SSCReen:AREA command. If the results of consecutive limit tests must be stored in different files, omit the parameter and use the default filename instead. Each screen image will be saved in a different file named MaskLimitScreenX.bmp, where X is an incremental number assigned by the instrument. The filename field encodes the network path and the directory in which the file will be saved, as well as the file format that will be used. The following is a list of valid filenames.
Mask Test Commands SSCReen:IMAGe SSCReen:IMAGe Command :MTESt:SSCReen:IMAGe {NORMal | INVert | MONochrome} This command saves the screen image to disk normally, inverted, or in monochrome. IMAGe INVert is the same as choosing Invert Waveform Background Color in the Specify Report Action for acquisition limit test dialog box. Query :MTESt:SSCReen:IMAGe? The query returns the current image setting.
Mask Test Commands SWAVeform NOTE Compatibility with the Agilent 83480A/54750A. The :MTESt:TEST ON command serves the same function and has been retained for compatibility with the Agilent 83480A/54750A. All new programs should use the :STARt command. SWAVeform Command :MTESt:SWAVeform , [,[, ]] This command saves waveforms from a channel, function, or waveform memory in the event of a failure detected by the limit test.
Mask Test Commands TEST This command sets the save destination for all waveforms to OFF. Setting a source to OFF removes any waveform save action from that source. This is a convenient way to turn off all saved waveforms if it is unknown which are being saved. Example 10 OUTPUT 707;”:MTEST:SWAVeform:RESet” TEST Command :MTESt:TEST {ON | 1 | OFF | 0} This command controls the execution of the Mask Test function. ON behaves as the :MTESt:STARt command on page 17-12.
18 ANNotation 18-3 APOWer 18-4 CGRade:AMPLitude 18-4 CGRade:BITRate 18-4 CGRade:COMPlete 18-5 CGRade:CRATio 18-5 CGRade:CROSsing 18-6 CGRade:DCDistortion 18-6 CGRade:DCYCle 18-6 CGRade:EHEight 18-7 CGRade:ERATio 18-7 CGRade:ERFactor 18-8 CGRade:ESN 18-8 CGRade:EWIDth 18-8 CGRade:JITTer 18-9 CGRade:OFACtor 18-9 CGRade:OLEVel 18-9 CGRade:PEAK? 18-10 CGRade:PWIDth 18-10 CGRade:SOURce 18-10 CGRade:ZLEVel 18-11 CLEar 18-11 DEFine 18-11 DELTatime 18-13 DUTYcycle 18-14 FALLtime 18-14 FREQuency 18-15 HISTogram:HITS
Measure Commands Measure Commands The commands in the MEASure subsystem are used to make parametric measurements on displayed waveforms. The 86100C has four modes: Eye/Mask, Jitter, TDR/TDT, and Oscilloscope. Each mode has a set of measurements. In Eye/Mask mode, all of the measurements are made on the color grade/gray scale data, with the exception of average optical power and histogram measurements.
Measure Commands ANNotation values are used in the rise-time and fall-time measurements when standard measurements are selected. The 50% voltage value is used for measuring frequency, period, pulse width, and duty cycle with standard measurements selected. You can also make measurements using user-defined parameters, instead of the standard measurement values. When the command form of a measurement is used, the analyzer is placed in the continuous measurement mode.
Measure Commands APOWer APOWer Command :MEASure:APOWer [,] Measures the average power. Sources are specified with the MEASure:SOURce command or with the optional parameter following the APOWer command. The average optical power can only be measured on an optical channel input. is {WATT | DECibel} and is {CHANnel}. For channels, this value is dependent on the type of module and its location in the instrument. It will work only on optical channels.
Measure Commands CGRade:COMPlete The bit rate. If SENDvalid is ON, the is returned with the measurement result. Refer to Table 18-3 on page 18-30 for a list of the result states. Example The following example measures the bit rate of the displayed eye. 10 OUTPUT 707;”:MEASURE:CGRADE:BITRATE” CGRade:COMPlete Command :MEASure:CGRade:COMPlete Sets the color grade measurement completion criterion. The data for color grade display is the same as for gray scale display.
Measure Commands CGRade:CROSsing Returned Format [:MEASure:CGRade:CRATio] [,] is the contrast ratio. If SENDvalid is ON, the is returned with the measurement result. Refer to Table 18-3 on page 18-30 for a list of the result states.
Measure Commands CGRade:EHEight Measures the duty cycle of the RZ (Return-to-Zero) eye diagram on the color graded display. If the source is not set, the lowest numbered signal display that is on will be the source of the measurement. is {CHANnel | FUNCtion | CGMemory}. Mode Eye mode only. Ensure that the eye type is set to RZ. See “DEFine” on page 18-11. Query :MEASure:CGRade:DCYCle? [] This query returns the duty cycle of the color graded display.
Measure Commands CGRade:ERFactor CGRade:ERFactor Command :MEASure:CGRade:ERFactor CHANnel,{ON|OFF}[,] Turns on or off the extinction ratio correction and, optionally, to set the correction factor used when correction is turned on. specifies a channel, where is 1, 2, 3 or 4. Each channel has its own setting for on or off and for correction factor. is a percentage value that is used to offset the measured extinction ratio value.
Measure Commands CGRade:JITTer Returned Format [:MEASure:CGRade:EWIDth] [,] is the eye width. If SENDvalid is ON, the is returned with the measurement result. Refer to Table 18-3 on page 18-30 for a list of the result states.
Measure Commands CGRade:PEAK? Mode Eye mode only. Query :MEASure:CGRade:OLEVel? [] The query returns the logic one level of the color grade display. Returned Format [:MEASure:CGRade:OLEVel] [,] is the logic one level. If SENDvalid is ON, the is returned with the measurement result. Refer to Table 18-3 on page 18-30 for a list of the result states.
Measure Commands CGRade:ZLEVel Sets the default source for color grade-gray scale measurements. If this source is not set, the lowest numbered color grade-gray scale signal that is on will be the source of the measurements. This command is similar to the :MEASure:SOURce command, with the exception of specifying a color grade-gray scale signal. is {CHANnel | FUNCtion | CGMemory}. is an integer, from 1 through 4. Mode Eye and Oscilloscope modes.
Measure Commands DEFine {UNITs,,,}} Where , , and are integers ranging from –25 to 125. , , and are real numbers specifying amplitude units. Table 18-1.
Measure Commands DELTatime TOPBase :MEASure:DEFine TOPBase,{{STANdard} |{,}} and are real numbers specifying voltage. EWINdow :MEASure:DEFine EWINdow,, and are an integer, 0 to 100, specifying an eye window as a percentage of the bit period unit interval. If one source is specified, both parameters apply to that signal.
Measure Commands DUTYcycle Measures the time delay between two edges. If no source is specified, then the sources specified using the :MEASure:SOURce command are used. If only one source is specified, then the edges used for computing delta time belong to that source. If two sources are specified, then the first edge used in computing to delta time belongs to the first source and the second edge belongs to the second source.
Measure Commands FREQuency Measures the time at the upper threshold of the falling edge, measures the time at the lower threshold of the falling edge, then calculates the fall time. Sources are specified with the MEASure:SOURce command or with the optional parameter following the FALLtime command. The first displayed falling edge is used for the fall-time measurement.
Measure Commands HISTogram:HITS? is the frequency value, in Hertz, of the first complete cycle on the screen using the mid-threshold levels of the waveform. If SENDvalid is ON, the is returned with the measurement result. Refer to Table 18-3 on page 18-30 for a list of the result states. Example 10 OUTPUT 707;”:MEASURE:FREQUENCY” HISTogram:HITS? Query :MEASure:HISTogram:HITS? [{HISTogram}] Returns the number of hits within the histogram.
Measure Commands HISTogram:M3S? HISTogram:M3S? Query :MEASure:HISTogram:M3S? [{HISTogram}] Returns the percentage of points that are within three standard deviations of the mean of the histogram. The source can be specified with the optional parameter following the M3S query. The HISTogram:M3S? query only applies to the histogram waveform.
Measure Commands HISTogram:PP? is the width of the histogram. If SENDvalid is ON, the is returned with the measurement result. Refer to Table 18-3 on page 18-30 for a list of the result states. Example 10 OUTPUT 707;”:SYSTEM:HEADER OFF” 20 OUTPUT 707;”:MEASURE:HISTOGRAM:PEAK?” HISTogram:PP? Query :MEASure:HISTogram:PP? [{HISTogram}] Returns the width of the histogram.
Measure Commands HISTogram:STDDev? Example 10 OUTPUT 707;”:SYSTEM:HEADER OFF” 20 OUTPUT 707;”:MEASURE:HISTOGRAM:SCALE?” HISTogram:STDDev? Query :MEASURE:HISTogram:STDDev? [{HISTogram}] Returns the standard deviation of the histogram. The source can be specified with the optional parameter following the STDDev query. The HISTogram:STDDev? query only applies to the histogram waveform.
Measure Commands JITTer:DDJVsbit:EARLiest? Returned Format Example [:MEASure:JITTer:DDJVsbit] 10 OUTPUT 707;”:SYSTEM:HEADER OFF” 20 OUTPUT 707;”:MEASure:JITTer:DDJVsbit?” JITTer:DDJVsbit:EARLiest? Query :MEASure:JITTer:DDJVsbit:EARLiest? Returns comma-separated values (string) for the earliest measured edge in the DDJ vs. bit graph. The string includes the bit number followed by the DDJ value. The DDJ value has units of time or unit interval as specified by the :MEASure:JITTer:UNITs command.
Measure Commands JITTer:EDGE list of edges, if all of the data needed to determine the pattern has not yet been acquired. This query produces an error if jitter signal type is set to clock signal. Use the :MEASure:JITTer:DDJVsbit? query to return the DDJ values. Use the :MEASure:JITTer:PATTern? query to return the edge type values. Restrictions Jitter mode. Software revision A.04.00 and above (86100C instruments).
Measure Commands JITTer:FREQuency:MAXNumber Returned Format Example [:MEASure:JITTer:FREQuency:COMPonents] The following is an example of a returned string: 930 fs,78.37 MHz,rate/127,420 fs,622.1 MHz,rate/16,210 fs,1.244 GHz,rate/8, 121 fs, 56.43 MHz,----” 10 OUTPUT 707;”:MEASURE:JITTER:FREQUENCY:COMPONENTS?” JITTer:FREQuency:MAXNumber Command :MEASure:JITTer:FREQuency:MAXNumber Sets the maximum number of asynchronous frequency components that the instrument will detect.
Measure Commands JITTer:LEVel:DEFine Example 10 OUTPUT 707;”:SYSTEM:HEADER OFF” 20 OUTPUT 707;”:MEASure:JITTer:LEVel?” JITTer:LEVel:DEFine Command :MEASure:JITTer:LEVel:DEFine {PERCent, | UNITs, | AVERage} Defines the jitter sampling level. It may be specified as a percentage in the range of 30% to 70%, as an absolute amplitude level, or as the average amplitude of the test signal.
Measure Commands JITTer:PJRMS? JITTer:PJRMS? Query :MEASure:JITTer:PJRMS? Returns the periodic jitter value, RJ (rms), measured on the current source. Restrictions Jitter mode. Software revision A.04.00 and above (86100C instruments). Returned Format Example [:MEASure:JITTer:PJRMS] 10 OUTPUT 707;”:SYSTEM:HEADER OFF” 20 OUTPUT 707;”:MEASure:JITTer:PJRMS?” JITTer:RJ? Query :MEASure:JITTer:RJ? Returns the random jitter value measured on the current source. Restrictions Jitter mode.
Measure Commands JITTer:SIGNal Returned Format Example [:MEASure:JITTer:RJSValue] 10 OUTPUT 707;”:SYSTEM:HEADER OFF” 20 OUTPUT 707;”:MEASURE:JITTER:RJSVALUE 6E-12” JITTer:SIGNal Command :MEASure:JITTer:SIGNal {CLOCk|DATA} Specifies the type of signal being measured. Restrictions Jitter mode. Software revision A.04.00 and above (86100C instruments). Query :MEASure:JITTer:SIGNal? This query returns the current setting for the signal type.
Measure Commands JITTer:UNITs JITTer:UNITs Command :MEASure:JITTer:UNITs {SECond|UINTerval} Sets the units used for jitter mode measurements, seconds or unit interval. Restrictions Jitter mode. Software revision A.04.00 and above (86100C instruments). Query :MEASure:JITTer:UNITs? This query returns the current setting for jitter mode measurement units.
Measure Commands PERiod else overshoot = (Vbase – Local Vmin) / Vamplitude. Mode Oscilloscope mode only {CHANnel | FUNCtion | WMEMory} For channels, functions, and waveform memories: 1, 2, 3, or 4. Query :MEASure:OVERshoot? [] The query returns the measured overshoot of the specified source. Returned Format [:MEASure:OVERshoot] [,] is the ratio of overshoot to amplitude, in percent.
Measure Commands RESults? Measures the width of the first positive pulse on the screen using the mid-threshold levels of the waveform (50% levels with standard measurements selected). The source is specified with the MEASure:SOURce command or with the optional parameter following the PWIDth command.
Measure Commands RESults? A list of the measurement results, as in Table 18-2, separated with commas. Table 18-2.
Measure Commands RESults? Table 18-3.
Measure Commands RISetime RISetime Command :MEASure:RISetime [] Measures the rise time of the first displayed edge by measuring the time at the lower threshold of the rising edge, measuring the time at the upper threshold of the rising edge, then calculating the rise time with the following algorithm: Rise time = time at upper threshold point – time at lower threshold point. Sources are specified with the MEASure:SOURce command or with the optional parameter following the RISetime command.
Measure Commands SOURce See Also Refer to the MEASure:RESults query for information on the results returned and how they are affected by the SENDvalid command. Refer to the individual measurements for information on how the result state is returned. SOURce Command :MEASure:SOURce [,] Selects the source for measurements. You can specify one or two sources with this command. All measurements except MEASure: DEFine:DELTatime are made on the first specified source.
Measure Commands TDR:AVERage Example This example returns the time interval between the trigger event and the 90% threshold on the second rising edge of the source waveform to the numeric variable, Time. 10 OUTPUT 707;":SYSTEM:HEADER OFF" !Response headers off 20 OUTPUT 707;":MEASURE:TEDGE? UPPER,+2" 30 ENTER 707;Time NOTE When receiving numeric data into numeric variables, turn off the headers. Otherwise, the headers may cause misinterpretation of returned data.
Measure Commands TMAX Returns the minimum impedance (Y-axis ) value that is to the right side of the reference plane. Returned Format Example [:MEASure:TDR:MIN {CHANnel | RESPonse}] 10 OUTPUT 707;”:MEASure:TDR:MIN RESPONSE1” TMAX Command :MEASure:TMAX [] Measures the first time at which the first maximum voltage of the source waveform occurred. The source is specified with the MEASure:SOURce command or with the optional parameter following the TMAX command.
Measure Commands TVOLt? NOTE When receiving numeric data into numeric variables, turn off the headers. Otherwise, the headers may cause misinterpretation of returned data. TVOLt? Query :MEASure:TVOLt? ,[,] Returns the time interval between the trigger event and the specified voltage level and transition (oscilloscope mode) or the time interval between the reference plane and the specified voltage level and transition (TDR mode).
Measure Commands VAVerage is the cCalculated difference between the top and base voltage. If SENDvalid is ON, the is returned with the measurement result. Refer to Table 18-3 on page 18-30 for a list of the result states. Example 10 OUTPUT 707;”:SYSTEM:HEADER OFF” 20 OUTPUT 707;":MEASURE:VAMPLITUDE?2" VAVerage Command :MEASure:VAVerage {CYCLe | DISPlay} [,] Calculates the average voltage over the displayed waveform.
Measure Commands VMAX VMAX Command :MEASure:VMAX [] Measures the absolute maximum voltage present on the selected source waveform. The source is specified with the MEASure:SOURce command or with the optional parameter following the VMAX command. is {CHANnel | FUNCtion | RESPonse | WMEMory} where , for channels is dependent on the type of plug-in and its location in the instrument. For functions: 1 or 2. For waveform memories (WMEMORY): 1, 2, 3, or 4.
Measure Commands VRMS Measures the maximum and minimum voltages on the selected source, then calculates the peak-to-peak voltage as the difference between the two voltages. Sources are specified with the MEASure:SOURce command or with the optional parameter following the VPP command. is {CHANnel | FUNCtion | RESPonse | WMEMory} where , is an integer, from 1 through 4.
Measure Commands VTIMe? VTIMe? Query :MEASure:VTIMe?
Measure Commands VTOP 18-40
19 TDRSparam 19-3 MAGGraph:HORizontal:STARt 19-3 MAGGraph:HORizontal:SPAN 19-3 MAGGraph:VERTical:MAXimum 19-4 MAGGraph:VERTical:MINimum 19-4 MARKer:X1STate 19-4 MARKer:X2STate 19-4 MARKer:X1Source 19-4 MARKer:X2Source 19-5 MARKer:X1Position 19-5 MARKer:X2Position 19-5 MARKer:Y1Position? 19-5 MARKer:Y2Position? 19-6 MARKer:XDELta? 19-6 MARKer:YDELta? 19-6 VWINdow 19-6 S-Parameter Commands
S-Parameter Commands S-Parameter Commands This subsystem provides support for the S-parameter features, which are part of Option 202, Enhanced Impedance and S-Parameter software. The S-parameter graph displays the Sparameters that have been transformed from the TDR/TDT time domain data to the frequency domain. To turn S-parameter analysis on and off, use “TDRSparam” on page 19-3. Use the :SPARameter:MAGGraph commands in this chapter to control the scaling of the S-parameters graph.
S-Parameter Commands TDRSparam If you move the reference plane to the second display division to the right of the display's left edge, only data from eight display divisions is used. With the same 10 ns/div time scale and 1024 points-per-waveform setting, the maximum frequency will now be 6.4 GHz. As you can see from the equation, as the time span decreases, the frequency span increases. Frequency Span Between Points The number of points displayed on the screen is a result of the Fast Fourier Transform.
S-Parameter Commands MAGGraph:VERTical:MAXimum Sets the frequency span of the S-parameters graph. Example Query Returned Format 10 OUTPUT 707;":SPAR:MAGG:HOR:SPAN 5.0E+9" :SPARameter:MAGGraph:HORizontal:SPAN? [:SPARameter:MAGGraph:HORizontal:SPAN] MAGGraph:VERTical:MAXimum Command :SPARameter:MAGGraph:VERTical:MAXimum Sets the maximum amplitude (dB) of the S-parameters graph.
S-Parameter Commands MARKer:X2Source Query Returned Format The query returns only the short form of the command. For example CHAN1, RESP1, WMEM1, or FUNC1. The long form is not returned even if :SYSTem:LONGform is on.
S-Parameter Commands MARKer:Y2Position? MARKer:Y2Position? Command :SPARameter:MARKer:Y2Position? Queries the amplitude value (Y2) of the X2 marker. Query Returned Format :SPARameter:MARKer:Y2Position? [:SPARameter:MARKer:Y2Position] MARKer:XDELta? Command :SPARameter:MARKer:XDELta? Queries the frequency difference (Δ) between the X1 and X2 markers.
20 LFEQualizer 20-2 LFEQualizer:BANDwidth 20-3 LFEQualizer:BWMode 20-3 LFEQualizer:FDELay 20-3 LFEQualizer:NTAPs 20-3 LFEQualizer:TAP 20-4 LFEQualizer:TAP:AUTomatic 20-4 LFEQualizer:TAP:NORMalize 20-4 LFEQualizer:TDELay 20-4 LFEQualizer:TDMode 20-4 MATLab 20-5 MATLab:ETENable 20-5 MATLab:ETEXt 20-5 MATLab:SCRipt 20-5 OUTPut 20-5 SOURce: 20-6 SOURce:DISPlay 20-6 Signal Processing Commands
Signal Processing Commands LFEQualizer Signal Processing Commands The Signal Processing subsystem is used to control the signal processing applications. Refer to the instrument’s online help for information on using these applications. NOTE Instrument software revision A.04.10 and above (86100C instruments) with Option 201, Advanced Waveform Analysis Software, is required to run the Linear Feedforward Equalizer and MATLAB Filter applications.
Signal Processing Commands LFEQualizer:BANDwidth Example 10 OUTPUT 707;":SPROCESSING:LFEQUALIZER ON" LFEQualizer:BANDwidth Command :SPRocessing:LFEQualizer:BANDwidth Sets or queries the bandwidth setting of the Linear Feedforward Equalizer application. Before sending this command, set the bandwidth mode to CUSTom using the LFEQualizer:BWMode command.
Signal Processing Commands LFEQualizer:TAP LFEQualizer:TAP Command :SPRocessing:LFEQualizer:TAP , Sets or queries the gain value for each tap for the Linear Feedforward Equalizer application. Use to specify tap. Use to specify the gain for the specified tap. Query Returned Format Example :SPRocessing:LFEQualizer:TAP? [:SPRocessing:LFEQualizer:TAP] , 10 OUTPUT 707;":SPROCESSING:LFEQUALIZER:TAP 3, 0.
Signal Processing Commands MATLab MATLab Command :SPRocessing:MATLab {ON | OFF | 1 | 0} Turns on and off the MATLAB Filter application. If MATLAB is not already running on the instrument, it is automatically started and is minimized.
Signal Processing Commands SOURce: Query Returned Format Example :SPRocessing:OUTPut? [:SPRocessing:OUTPut] {FUNCtion} 10 OUTPUT 707;":SPROCESSING:OUTPUT FUNCTION2" SOURce: Command :SPRocessing:SOURce {CHANnel | FUNCtion} Selects an input channel (CH1 or CH2) or a math function (F1, F2, F3, or F4) for the input to the active signal processing application. is the numeral 1, 2, 3, or 4 representing one of two input channels or one of four math functions.
21 DCALib 21-2 HPOLarity 21-2 NVALid? 21-3 PRESet 21-3 RATE 21-3 RESPonse 21-4 RESPonse:CALibrate 21-4 RESPonse:CALibrate:CANCel 21-5 RESPonse:CALibrate:CONTinue 21-5 RESPonse:HORizontal 21-6 RESPonse:HORizontal:POSition 21-6 RESPonse:HORizontal:RANGe 21-6 RESPonse:RISetime 21-7 RESPonse:TDRDest 21-7 RESPonse:TDRTDT 21-8 RESPonse:TDTDest 21-8 RESPonse:VERTical 21-9 RESPonse:VERTical:OFFSet 21-9 RESPonse:VERTical:RANGe 21-10 STIMulus 21-10 TDR/TDT Commands (Rev. A.05.
TDR/TDT Commands (Rev. A.05.00 and Below) DCALib TDR/TDT Commands The TDR/TDT command subsystem documents the commands used to set up TDR/TDT measurements in instruments with revision A.05.00 and below. If you are programming an instrument with software revision above A.05.00, refer to Chapter 22, “TDR/TDT Commands (Rev. A.06.00 and Above)”. All of the TDR/TDT subsystem commands are of the form :TDR{2 | 4}:.
TDR/TDT Commands (Rev. A.05.00 and Below) NVALid? Query Returned Format :TDR{2 | 4}:HPOLarity? [:TDR{2 | 4}:HPOLarity] {POSitive | NEGative} NVALid? Query :TDR{2 | 4}:NVALid? Queries the specified TDR module to determine if valid normalization data exists. A 1 is returned, if a valid normalization exists. Otherwise, a 0 is returned. Restrictions Software revision A.04.20 and A.05.00. TDR mode.
TDR/TDT Commands (Rev. A.05.00 and Below) RESPonse This command sets the period of the TDR pulse generator. You should usually leave this set to AUTO unless you need to define a specific rate. In AUTO, the instrument will attempt to keep subsequent periods off screen when the timebase is changed. is the period to which you want to set the generator, in Hertz. You can add a suffix to indicate that the rate is in Hertz (HZ, KHZ, and so on). Restrictions Software revision A.05.00 and below. TDR mode.
TDR/TDT Commands (Rev. A.05.00 and Below) RESPonse:CALibrate:CANCel waveform, while the response waveforms are numbered based on the destination channel. For TDR commands, the response waveform numbers and RESPonse refer to the same waveforms. This is not the case for TDT related commands. If the module needs calibration, this command automatically triggers a module calibration before the TDR or TDT normalization and reference plane calibration begins.
TDR/TDT Commands (Rev. A.05.00 and Below) RESPonse:HORizontal RESPonse:HORizontal Command :TDR{2 | 4}:RESPonse:HORizontal {AUTO | MANual} This command specifies whether the TDR/TDT response should automatically track the source channel’s horizontal scale (AUTO), or a user-defined scale specified with the HORizontal:POSItion and HORizontal:RANGe commands (MANual). AUTO is the usual setting. The keyword TSOurce may also be used.
TDR/TDT Commands (Rev. A.05.00 and Below) RESPonse:RISetime Example Query Returned Format 10 OUTPUT 707;":TDR2:RESPONSE1:HORIZONTAL MANUAL" 20 OUTPUT 707;":TDR2:RESPONSE1:HORIZONTAL:RANGE 120 MS" The information reterned from the query is only valid when the horizontal tracking mode is set to manual.
TDR/TDT Commands (Rev. A.05.00 and Below) RESPonse:TDRTDT Query :TDR{2 | 4}:RESPonse{1 | 3}:TDRDest? The query returns the current TDR destination channel for the selected response. Returned Format [:TDR{2 | 4}:RESPonse{1 | 3}:TDRDest] RESPonse:TDRTDT Command :TDR{2 | 4}:RESPonse{1| 2| 3 | 4}:TDRTDT {TDR | TDT} This command controls the behavior of other :TDR{2| 4}:RESPonse commands and queries.
TDR/TDT Commands (Rev. A.05.00 and Below) RESPonse:VERTical NONE Deselects a channel as a TDT destination. This frees the channel to be the TDT destination of another TDR source. For CHANnel, this value is an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. Restrictions Software revision A.05.00 and below. TDR mode.
TDR/TDT Commands (Rev. A.05.00 and Below) RESPonse:VERTical:RANGe Query Returned Format The information reterned from the query is only valid when the vertical tracking mode is set to manual. :TDR{2 | 4}:RESPonse:VERTical:OFFSet? [:TDR{2 | 4}:RESPonse:VERTical:OFFSet] RESPonse:VERTical:RANGe Command :TDR{2 | 4}:RESPonse:VERTical:RANGe This command specifies the vertical range of the TDR/TDT response when the vertical tracking mode is set to MANual.
TDR/TDT Commands (Rev. A.05.00 and Below) STIMulus ended TDR or TDT measurements. DIFFerential turns on the pulse generator for channels 1 and 2 or channels 3 and 4 for differential TDR or TDT measurements. COMMonmode turn on the pulse generator for channels 1 and 2 or channels 3 and 4 for common-mode TDR or TDT measurements. EDIFferential and ECOMmon turn on the pulse generator for channels 1 and 2 (or channels 3 and 4) in either differential or common mode.
TDR/TDT Commands (Rev. A.05.
22 CONNect 22-4 DUT:DIRection 22-4 DUT:TYPE 22-4 RESPonse:CALibrate 22-5 RESPonse:DISPlay 22-6 RESPonse:RISetime 22-6 RESPonse:RPLane? 22-7 RESPonse:TYPE 22-7 RESPonse:VAMPlitude? 22-7 RESPonse:VERTical 22-8 RESPonse:VERTical:OFFSet 22-8 RESPonse:VERTical:RANGe 22-8 RESPonse:VLOad? 22-9 STIMulus:EXTernal 22-9 STIMulus:EXTernal:POLarity 22-9 STIMulus:MODE 22-10 STIMulus:RATE 22-10 STIMulus:STATe 22-10 TDR/TDT Commands (Rev. A.06.
TDR/TDT Commands (Rev. A.06.00 and Above) TDR/TDT Commands With the introduction of software revision A.06.00, extensive changes were made to the TDR/ TDT capability of the instrument. Consequently, changes were required to this command subsystem. Refer to the previous chapter for documentation on the command for software revision A.05.00 and below. If Option 202, Enhanced Impedance and S-Parameter Software, is installed, you can display and save S-parameters. Refer to Chapter 19, “S-Parameter Commands”.
TDR/TDT Commands (Rev. A.06.00 and Above) Module Channel Identification In previous software revisions, each TDR/TDT subsystem command identified the TDR module installation (left or right mainframe slot) with the form :TDR{2:4}:. Starting with software revision A.06.00, the TDR/TDT subsystem no longer uses this identification scheme; the new syntax form is simply :TDR:.
TDR/TDT Commands (Rev. A.06.00 and Above) CONNect CONNect Command :TDR:CONNect CHANnel, {DUTPort | NONE} Enters the measurement setup connections between the instrument channels and the test device ports. Use the NONE argument to delete a previously established connection. For example, to set up a return loss (s11) measurement on a single-ended device, you could send the following command 10 OUTPUT 707;":TDR:CONN CHAN1, DUTP1" to connect channel 1 on the TDR module to port 1 on the test device.
TDR/TDT Commands (Rev. A.06.00 and Above) RESPonse:CALibrate Table 22-2. Device Type Arguments Argument Device Type Description D2PThru Two-port device. Single-ended input, single-ended output. D4Port Four-port single-ended device. Or, two port differential/common mode input. Restrictions Software revision A.06.00 and above. TDR mode. Example Query 10 OUTPUT 707;":TDR:DUT:TYPE D1PORT" The query returns only the short form of the command. For example D1P, D2P, D2PT, or D4P.
TDR/TDT Commands (Rev. A.06.00 and Above) RESPonse:DISPlay Table 22-3.
TDR/TDT Commands (Rev. A.06.00 and Above) RESPonse:RPLane? RESPonse:RPLane? Query :TDR:RESPonse:RPLane? Queries the reference plane position for TDR or TDT responses. The reference plane value is identical for and applies to all responses. A settings conflict error is reported if no stimulus channel is active. If the response is uncalibrated, a default value is returned. The value is an integer, 1 through 4, that identifies the response waveform. Restrictions Software revision A.06.00 and above.
TDR/TDT Commands (Rev. A.06.00 and Above) RESPonse:VERTical where Z0 equals 50 ohms in the 86100C. A settings conflict error is reported if no stimulus channel is active. If the response is uncalibrated, a default value is returned. The value is an integer, 1 through 4, that identifies the response waveform. Restrictions Software revision A.06.00 and above. TDR mode.
TDR/TDT Commands (Rev. A.06.00 and Above) RESPonse:VLOad? This command specifies the vertical range of the TDR/TDT response and changes the vertical tracking setting to MANual if it is in AUTO. Refer to “RESPonse:VERTical” on page 22-8. The value is an integer, 1 through 4, that identifies the response waveform. The argument is in the current UNITs setting and suffix supplied. (The suffix does not set the UNITs; it is ignored.) Restrictions Available in all software revisions. TDR mode.
TDR/TDT Commands (Rev. A.06.00 and Above) STIMulus:MODE Example Query 10 OUTPUT 707;":TDR:STIM:EXT:POL POS, NEG" The query always returns both polarity values regardless of stimulus mode. Returned Format :TDR:STIMulus:EXTernal:POLarity? [:TDR:STIMulus:EXTernal:POLarity] {POSitive | NEGative}, {POSitive | NEGative} STIMulus:MODE Command :TDR:STIMulus:MODE {SINGle | DIFFerential | COMMon} Sets the measurement stimulus to single-ended, differential, or common mode. Restrictions Software revision A.
23 BRATe 23-2 MPOSition 23-2 POSition 23-2 PRECision 23-3 PRECision:RFRequency 23-3 PRECision:TREFerence 23-4 RANGe 23-4 REFerence 23-4 SCALe 23-5 UNITs 23-5 Timebase Commands
Timebase Commands BRATe Timebase Commands The TIMebase subsystem commands control the horizontal (X axis) analyzer functions. BRATe Command :TIMebase:BRATe This command sets the bit rate used when the time base units are bit period. is the bit rate (in bits-per-second). Query :TIMebase:BRATe? The query returns the bit rate setting. Returned Format Examples [:TIMebase:BRATe] The following example sets the bit rate to 155.520 MHz.
Timebase Commands PRECision This command sets the time interval between the trigger event and the delay reference point. The delay reference point is set with the TIMebase:REFerence command. The maximum value depends on the time/division setting. The value can optionally have units of bits or seconds, refer to Table 1-8 on page 1-25 to view the suffix units. If no units are specified, has the units of the current units setting.
Timebase Commands PRECision:TREFerence PRECision:TREFerence NOTE The Precision Timebase feature requires the installation of the Agilent 86107A Precision Timebase Module. Command :TIMebase:PRECision:TREFerence This command sets the time reference. If the time reference fails to set, an error is produced. Query :TIMebase:PRECision:TREFerence? This query returns whether the time reference has been successfully set. It does not indicate whether the time reference is still valid.
Timebase Commands SCALe Query :TIMebase:REFerence? The query returns the current delay reference position. Returned Format Example [:TIMebase:REFerence] {LEFT | CENTer} 10 OUTPUT 707;":TIMEBASE:REFERENCE?" SCALe Command :TIMebase:SCALe This command sets the time base scale. This corresponds to the horizontal scale value displayed as time/div on the analyzer screen. NOTE In Jitter Mode, scale and position controls are disabled. Do not use this command in Jitter Mode.
24 ATTenuation 24-2 BRATe 24-2 BRATe:AUTodetect 24-2 BWLimit 24-3 DCDRatio 24-3 DCDRatio:AUTodetect 24-3 GATed 24-3 HYSTeresis 24-4 LEVel 24-4 PLENgth 24-4 PLENgth:AUTodetect 24-4 PLOCk 24-5 PLOCk:AUTodetect 24-5 RBIT 24-5 SLOPe 24-6 SOURce 24-6 Trigger Commands
Trigger Commands ATTenuation Trigger Commands The scope trigger circuitry helps you locate the waveform you want to view. Edge triggering identifies a trigger condition by looking for the slope (rising or falling) and voltage level (trigger level) on the source you select. Any input channel, auxiliary input trigger (4-channel scopes only), line, or external trigger (2-channel scopes only) inputs can be used as the trigger source. The commands in the TRIGger subsystem define the conditions for triggering.
Trigger Commands BWLimit BWLimit Command :TRIGger:BWLimit {DIVided | HIGH | LOW} This command controls an internal lowpass filter and a divider in the 86100A trigger. The bandwidth of the trigger is limited to approximately 100 MHz. DIVided mode is unaffected by the level, hysteresis, and slope settings. The DIVided parameter is only valid if the mainframe has option 001. Query :TRIGger:BWLimit? The query returns the current setting for the specified trigger input.
Trigger Commands HYSTeresis HYSTeresis Command :TRIGger:HYSTeresis {NORMal | HSENsitivity} This command specifies the trigger hysteresis . NORMal is the typical hysteresis selection. HSENsitivity gives minimum hysteresis and the highest bandwidth. Query :TRIGger:HYSTeresis? The query returns the current hysteresis setting. Returned Format [:TRIGger:HYSTeresis] {NORMal | HSENSitivity} LEVel Command :TRIGger:LEVel This command specifies the trigger level.
Trigger Commands PLOCk PLOCk Command TRIGger:PLOCk {{ON | 1} | {OFF | 0}} This command enables or disables pattern lock. When pattern lock is turned on, the 86100C internally generates a trigger synchronous with the user's pattern. Pattern lock is only available on an 86100C mainframe with Option 001 installed. Restrictions Software revision A.04.00 and above (86100C instruments).
Trigger Commands SLOPe SLOPe Command :TRIGger:SLOPe {POSitive | NEGative} This command specifies the slope of the edge on which to trigger. Query :TRIGger:SLOPe? The query returns the slope for the trigger. Returned Format Example [:TRIGger:SLOPe] {POSitive | NEGative} 10 OUTPUT 707; ":TRIGger:SLOPe POSitive" SOURce Command :TRIGger:SOURce {FPANel | FRUN | LMODule | RMODule} This command selects the trigger input.
25 BANDpass? 25-3 BYTeorder 25-3 COUNt? 25-4 DATA 25-4 FORMat 25-5 POINts? 25-7 PREamble 25-7 SOURce 25-9 SOURce:CGRade 25-10 TYPE? 25-10 XDISplay? 25-11 XINCrement? 25-11 XORigin? 25-11 XRANge? 25-12 XREFerence? 25-12 XUNits? 25-12 YDISplay? 25-12 YINCrement? 25-13 YORigin? 25-13 YRANge? 25-13 YREFerence? 25-13 YUNits? 25-14 Waveform Commands
Waveform Commands Waveform Commands The WAVeform subsystem is used to transfer waveform data between a computer and the analyzer. It contains commands to set up the waveform transfer and to send or receive waveform records to or from the analyzer. Data Acquisition When the data is acquired using the DIGitize command, the data is placed in the channel or function memory of the specified source. After the DIGitize command, the analyzer is stopped.
Waveform Commands BANDpass? Conversion from Data Value to Units To convert the waveform data values (essentially A/D counts) to real-world units, such as volts, use the following scaling formulas: Y-axis Units = (data value – Yreference) × Yincrement + Yorigin X-axis Units = (data index – Xreference) × Xincrement + Xorigin, where the data index starts at zero: 0, 1, 2, . . . ., n-1. The first data point for the time (X-axis units) must be zero so the time of the first data point is the X origin.
Waveform Commands COUNt? 20 OUTPUT 707;":WAVEFORM:BYTEORDER?" 30 ENTER 707;Setting$ COUNt? Query :WAVeform:COUNt? This query returns the fewest number of hits in all of the time buckets for the currently selected waveform. For the AVERAGE waveform type, the count value is the fewest number of hits for all time buckets. This value may be less than or equal to the value specified with the ACQuire:COUNt command.
Waveform Commands FORMat 10 OUTPUT 707 USING "#,K";:WAVEFORM:DATA #800001000" 20 OUTPUT 707 USING "W";Set(*) NOTE BASIC Image Specifiers. # is an BASIC image specifier that suppresses the automatic output of the EOL sequence following the last output item. K is an BASIC image specifier that outputs a number or string in standard form with no leading or trailing blanks. W is an BASIC image specifier that outputs 16-bit words with the most significant byte first.
Waveform Commands FORMat ASCii BYTE ASCII formatted data consists of ASCII digits with each data value separated by a comma. Data values can be converted to real values on the Y axis (for example, volts) and transmitted in floating point engineering notation. In ASCII: • The value “99.999E+36” represents a hole level (a hole in the acquisition data). • The value “99.999E+33” represents a clipped-high level. • The value “99.999E+30” represents a clipped-low level.
Waveform Commands POINts? POINts? Query :WAVeform:POINts? The query returns the points value in the current waveform preamble. The points value is the number of time buckets contained in the waveform selected with the WAVeform:SOURce command. Returned Format [:WAVeform:POINts] An integer. Values range from 1 to 262144. See the ACQuire:POINts command for more information.
Waveform Commands PREamble 0 for UNKNOWN units. 1 for VOLT units. 2 for SECOND units. 3 for CONSTANT units. 4 for AMP units. 5 for DECIBEL units. 6 for HIT units. 7 for PERCENT units. 8 for WATT units. See Table 25-1 on page 25-8 for descriptions of all the waveform preamble elements. BASIC Image Specifiers # is an BASIC image specifier that suppresses the automatic output of the EOL sequence following the last output item.
Waveform Commands SOURce Table 25-1. Waveform Preamble Elements (2 of 2) Element Description Y Increment The Y increment is the duration between Y-axis levels. For voltage waveforms, it is the voltage corresponding to one level. (See WAVeform:YINCrement.) Y Origin The Y origin is the Y-axis value at level zero. For voltage signals, it is the voltage at level zero. (See WAVeform:YORigin.) Y Reference The Y reference is the level associated with the Y origin.
Waveform Commands SOURce:CGRade the settings valid during the TDR normalization procedure. In the case of a mismatch, the TDR response is not displayed and queries such as :WAV:POINTS? will return an error message indicating that the “source is not valid”. Histogram data sources require long format. An integer, 1 through 4. Example This example selects channel 1 as the waveform source.
Waveform Commands XDISplay? NORMAL data consists of the last data point in each time bucket. RAW data consists of one data point in each time bucket with no interpolation. In the INTERPOLATE acquisition type, the last data point in each time bucket is stored, and additional data points are filled in between the acquired data points by interpolation. AVERAGE data consists of the average of the first n hits in a time bucket, where n is the value in the count portion of the preamble.
Waveform Commands XRANge? Returned Format [:WAVeform:XORigin] is a real number representing the X-axis value of the first data point in the data record. Example 10 OUTPUT 707;":SYSTEM:HEADER OFF” 20 OUTPUT 707;":WAVEFORM:XORIGIN?" You can obtain the Xorigin value through the WAVeform:PREamble query. See Also XRANge? Query :WAVeform:XRANge? This query returns the X-axis duration of the displayed waveform. For time domain signals, it is the duration of the time across the display.
Waveform Commands YINCrement? Example 10 OUTPUT 707;":SYSTEM:HEADER OFF” 20 OUTPUT 707;":WAVEFORM:YDISPLAY?" YINCrement? Query :WAVeform:YINCrement? This query returns the duration between the Y-axis levels for the currently specified source. • For BYTE and WORD data, it is the value corresponding to one level increment in terms of waveform units. • For ASCII data format, the YINCrement is the full range covered by the A/D converter.
Waveform Commands YUNits? This query returns the level associated with the Y origin for the currently specified source. It is at this level that the Y origin is defined. In this analyzer, the value is always zero. Returned Format [:WAVeform:YREFerence] Always 0. Example 10 OUTPUT 707;":SYSTEM:HEADER OFF” 20 OUTPUT 707;":WAVEFORM:YREFERENCE?" You can obtain the YReference value through the WAVeform:PREamble query.
26 DISPlay 26-2 LOAD 26-2 SAVE 26-3 XOFFset 26-3 XRANge 26-3 YOFFset 26-3 YRANge 26-4 Waveform Memory Commands
Waveform Memory Commands DISPlay Waveform Memory Commands The Waveform Memory Subsystem commands allow you to save and display waveforms, memories, and functions. In Waveform Memory commands, the in WMEMory represents the waveform memory number (1-4). DISPlay Command :WMEMory:DISPlay {{ON|1}|{OFF|0}} This command enables or disables the viewing of the selected waveform memory. is the memory number is an integer from 1 to 4.
Waveform Memory Commands SAVE SAVE Command :WMEMory:SAVE {CHANnel | WMEMory | FUNCtion | RESPonse} This command stores the specified channel, waveform memory, TDR response, or function to the waveform memory. The channel or function must be displayed (DISPlay set to ON) or an error status is returned. You can save waveforms to waveform memories whether the waveform memory is displayed or not. is the memory number is an integer from 1 to 4.
Waveform Memory Commands YRANge Query :WMEMory:YOFFset? The query returns the current y-axis (vertical) offset for the selected waveform memory. Returned Format Example [:WMEMory:YOFFset] This example sets the y-axis (vertical) offset of waveform memory 2 to 0.2V. 10 OUTPUT 707;":WMEMORY2:YOFFSET 0.2" YRANge Command :WMEMory:YRANge This command sets the y-axis, vertical range for the selected memory. The vertical scale is the vertical range divided by 8.
Index A aborting a digitize operation, 1-5, 1-35 Acquire Commands, 6-2 AVERage, 6-2 BEST, 6-2 COUNt, 6-2 LTESt, 6-3 POINts, 6-3 RUNTil, 6-4 SSCReen, 6-4 SSCReen AREA, 6-5 SSCReen IMAGe, 6-6 SWAVeform, 6-6 SWAVeform RESet, 6-7 acquired data distribution, 14-2 flow, 1-2 acquisition points, 6-3 record length, 6-3 sample program, 2-5 Acquisition Event Register, 1-20 Acquisition Limits Event Enable register, 4-2 Acquisition Limits Event Register, 4-3 adding parameters, 1-24 address, instrument default, 1-35 adv
Index TDRSkew, 8-6 UNITs, 8-7 UNITs ATTenuation, 8-7 UNITs OFFSet, 8-7 WAVelength, 8-8 channel-to-channel skew factor, 7-9 CLEar, 18-11 clearing buffers, 1-35 error queue, 1-21, 1-46 pending commands, 1-35 registers and queues, 1-22 Standard Event Status Register, 1-18, 3-3 status data structures, 3-2 TRG bit, 1-16 clipped signals, and measurement error, 18-3 clock recovery, 9-2 data rate, 9-7 phase locked status, 9-6 signal present status, 9-9 Clock Recovery Commands, 9-2 LOCKed?, 9-6, 9-10 RATE, 9-7 SPRe
Index SIMage, 10-7 SINGle, 4-13 SKEW, 7-9 SOURce, 15-4, 18-32 SOURce CGRade, 25-10 SSAVer, 11-9 SSAVer AAFTer, 11-9 SSCReen, 6-4, 15-5, 17-10 SSCReen AREA, 6-5, 15-6, 17-11 SSCReen IMAGe, 6-6, 15-7, 17-12 SSUMmary, 15-7, 17-12 STARt, 17-12 STATe, 16-3 Status Byte (*STB?), 3-13 STOP, 4-13 STORe, 10-9 STORe SETup, 4-13 STORe WAVEform, 4-14 SWAVeform, 6-6, 15-8, 17-13 SWAVeform RESet, 6-7, 15-9, 17-13 TDRSkew, 8-6 TEST, 15-9, 17-14 TIME, 5-7 TMAX, 18-34 TMIN, 18-34 Trigger (*TRG), 3-13 UEE (User Event Enable
Index DATA?, 11-3 DCOLor, 11-3 FSFRequency, 11-5 GRAPh, 11-4 GRATicule, 11-3 GRATicule INTensity, 11-3 LABel, 11-6 LABel DALL, 11-6 LAYout, 11-5 PERSistence, 11-6 RRATe, 11-7 SCOLor, 11-7 SSAVer, 11-9 SSAVer AAFTer, 11-9 YSCale, 11-4 display persistence, 11-6 DLEVel?, 7-4 Driver Electronics code and capability, 1-35 DSP (display), 5-2 duration between data points and XINCrement, 25-11 DUTYcycle, 18-14 E EHEight, 18-7 Enable Register, 3-2 End Of String (EOS), 1-23 End Of Text (EOT), 1-23 End-Or-Identify (E
Index el, 1-11 IEEE 488.
Index Mask Test Event Enable Register, 4-7, 4-10, 4-11 Mask Test Event Register, 1-21, 4-10, 4-12 mask, Service Request Enable Register, 3-12 Master Summary Status (MSS) and *STB, 3-13 Status Bit, 1-17 MATLAB Filter application, 20-2 MAV (Message Available), 1-17 bit, 3-12–3-13 MAXimum, 12-5 MDIRectory, 10-4 MEAN?, 18-17 MEASure Commands JITTer ISI?, 18-20, 18-21 JITTer RJ?, 18-24, 18-33 JITTer SIGNal?, 18-25 JITTer TJ?, 18-25 Measure Commands, 18-2 ANNotation, 18-3 APOWer, 18-4 CGRade AMPLitude, 18-4 CGRa
Index parametric measurements, 18-2 parser resetting, 1-35 passing values across the bus, 1-26 pattern waveforms, 10-6 PEAK?, 18-10 peak-to-peak voltage, and VPP, 18-38 pending commands, clearing, 1-35 PERCent, 17-6 PERiod, 18-27 period measurement setup, 18-2 PERsistence, 11-6 phase lock status, 9-6 PJ Waveform graph, 11-5 POINts, 6-3 PON bit, 3-4 pound sign (#) and block data, 1-26 Power On (PON) status bit, 1-17, 3-3 power-up condition of GPIB, 1-34 PP?, 18-18 PREamble and DATA, 25-5 Precision Timebase
Index SCALe?, 8-6 SCOLor?, 11-9 SDONe?, 7-9 SERial?, 4-13 SETup?, 5-7 SKEW?, 7-9 SOURce?, 14-5, 15-5, 18-11, 18-32 SPResent?, 9-9 SSAVer AAFTer?, 11-9 SSAVer?, 11-9 SSCReen?, 6-5, 15-6, 17-11 SSUMmary?, 17-12 STATe?, 16-3 Status Byte (*STB?), 3-13 STATus?, 7-7, 7-10 SWAVeform?, 6-7, 15-8, 17-13 TBASe?, 18-36 TDRSkew?, 8-7 TEDGe?, 18-32 TER?, 4-14 Test (*TST?), 3-14 TEST?, 15-9, 17-14 TIME?, 7-5, 7-7 TITLe?, 17-14 TMAX, 18-34 TMIN, 18-34 TVOLt?, 18-35 UEE?, 4-14 UER?, 4-14 ULIMit?, 15-9 UNITs OFFSet, 8-7 UN
Index SOURce?, 17-8 X1, 17-8 XDELta, 17-9 Y1, 17-9 Y2, 17-9 SCALe?, 18-18 SCOLor, 11-7 SCPI (standard commands for programmable instruments) standard, 1-2 screen captures, 10-7 SCReen HARDcopy AREA, 6-5, 15-6, 17-11 SDONe?, 7-9 segments of sample programs, 2-2 selected device clear (SDC), 1-35 self test, 3-14 semicolon, 1-23 SENDvalid, 18-31 sequential and overlapped commands, 1-25 SERial (SERial number), 4-13 serial poll (SPOLL) in example, 1-16 disabling, 1-35 of the Status Byte Register, 1-16 serial pre
Index DCDRatio AUTodetect, 24-3 Trigger Commands, 24-2 BWLimit, 24-3 HYSTeresis, 24-4 LEVel, 24-4 Trigger Event Register (TRG), 1-16 trigger status, 9-6 truncating numbers, 1-25 *TST (Test), 3-14 TVOLt?, 18-35 U UEE (User Event Enable register), 4-14 UER, 1-19 UER? (User Event Register), 4-14 ULIMit, 15-9 unaddressing all listeners, 1-35 unavailable commands, Jitter mode, 1-44 UNITs, 8-7, 23-5 ATTenuation, 8-7 OFFSet, 8-7 uppercase letters, 1-23 URQ bit (User Request), 3-3 User Event Enable register, 4-14
