manualshive.com logo in svg

HP E4401B, Programmer'S Manual

Share
Download
HP E4401B Programmer'S Manual Download Page 82

3-18

Chapter 3

Programming Examples
Using Marker Delta Mode and Marker Minimum Search

/*Set the analyzer to active delta marker mode*/

viPrintf(viESA,"CALC:MARK:MODE DELT; \n");

/*Trigger a sweep*/

viPrintf(viESA,"INIT:IMM; \n");

/*Check for operation complete*/

viQueryf(viESA, "*OPC?\n", "%d", &lOpc);

if (!lOpc)

{

printf("Program Abort! error ocurred: last command was

not completed!\n");

exit(0);

}

/*Set the marker to minimum amplitude*/

viPrintf(viESA,"CALC:MARK:MIN; \n");

/*Query and read the marker amplitude*/

viPrintf(viESA,"CALC:MARK:Y?; \n");

viScanf(viESA,"%lf",&dMarkerAmplitude);

/*Print the marker amplitude*/

printf("RESULT:Marker Amplitude = %lf

dBm\n",dMarkerAmplitude);

/*Close the session*/

viClose(viESA);

viClose(defaultRM);

}

Summary of Contents for E4401B

Page 1: ... Number E4401 90093 Printed in USA April 1999 Copyright 1999 Hewlett Packard Company This guide provides documentation for the following instruments HP ESA E Series HP ESA L Series and HP E4401B HP E4402B HP E4404B HP E4405B HP E4407B HP E4403B HP E4408B HP E4411B ...

Page 2: ...mbols and their meaning before operating this instrument WARNING Warning denotes a hazard It calls attention to a procedure which if not correctly performed or adhered to could result in injury or loss of life Do not proceed beyond a warning note until the indicated conditions are fully understood and met CAUTION Caution denotes a hazard It calls attention to a procedure that if not correctly perf...

Page 3: ...ING This is a Safety Class 1 Product provided with a protective earthing ground incorporated in the power cord The mains plug shall only be inserted in a socket outlet provided with a protected earth contact Any interruption of the protective conductor inside or outside of the product is likely to make the product dangerous Intentional interruption is prohibited WARNING If this product is not used...

Page 4: ...h an instrument will execute its programming instructions when properly installed on that instrument Hewlett Packard does not warrant that the operation of the instrument or software or firmware will be uninterrupted or error free LIMITATION OF WARRANTY The foregoing warranty shall not apply to defects resulting from improper or inadequate maintenance by Buyer Buyer supplied software or interfacin...

Page 5: ... Information Documentation is updated periodically For the latest information about HP ESA Spectrum Analyzers including firmware upgrades and application information please visit the following Internet URL http www hp com go esa ...

Page 6: ...vi ...

Page 7: ...HP ESA Status Registers Using the Analyzer Status Registers 2 2 Why Would You Use the Status Registers 2 2 Using the Status Registers 2 3 Setting and Querying the Registers 2 4 Using the Service Request SRQ Method 2 4 Overall Status Byte Register System 2 7 3 Programming Examples Types of Examples 3 2 C Programming Examples using VTL 3 3 Typical Example Program Contents 3 3 Linking to VTL Librarie...

Page 8: ...62 Measuring Harmonic Distortion HP IB 3 69 Example 3 70 Measuring Harmonic Distortion RS 232 3 78 Example 3 79 4 Programming Command Cross References Functional Index to SCPI Subsection 4 2 5 Language Reference IEEE Common Commands 5 4 Calibration Query 5 4 Clear Status 5 4 Standard Event Status Enable 5 4 Standard Event Status Register Query 5 5 Identification Query 5 5 Instrument State Query 5 ...

Page 9: ...asurements 5 36 Configure the Emission Bandwidth Measurements 5 36 Set Number of Measured Harmonics 5 36 Configure the OBW and Transmit Frequency Error Measurements 5 36 COUPle Subsystem 5 37 COUPle the Function to Other Settings 5 37 DISPlay Subsystem 5 38 Display Viewing Angle 5 38 Date and Time Display Format 5 38 Date and Time Display 5 38 Display Annotation Title Data 5 39 Turn the Entire Dis...

Page 10: ...system 5 53 Continuous or Single Measurements 5 53 Take New Data Acquisitions 5 54 Restart Measurement 5 54 INPut Subsystem 5 55 Input Port Coupling 5 55 Clear the Input Overload 5 55 MEASurement Subsystem 5 56 Measure Main Lower and Upper Channel Power 5 56 Measure Main Channel Power 5 56 Measure Lower Channel Power 5 56 Measure Upper Channel Power 5 57 Measure Channel Power and Density 5 57 Meas...

Page 11: ...hannel Power Density 5 66 Measure Emission Bandwidth 5 66 Return Total Harmonic Distortion 5 66 Return Harmonic Amplitudes 5 67 Return Harmonic N Amplitude 5 67 Return Harmonic Frequency List 5 67 Return Harmonic N Frequency 5 68 Measure OBW and Transmit Frequency Error 5 68 Measure Occupied Bandwidth 5 68 Measure Transmit Frequency Error 5 68 SENSe Subsystem 5 69 SENSe ACPower Subsection 5 70 SEN...

Page 12: ... 116 Serial Port DTR Setup 5 116 Serial Port RTS Setup 5 117 Serial Port Baud Rate Setup 5 118 Serial Port Receive Pace Setup 5 118 Serial Port Transmit Pace Setup 5 119 Hardware Configuration Query 5 119 Display the Hardware Configuration 5 120 System Configuration Query 5 120 Display System Configuration 5 120 Set Date 5 120 Error Information Query 5 121 Query Instrument Options 5 121 Power On E...

Page 13: ...y 5 129 Rear Panel External Trigger Slope 5 129 Trigger Source 5 130 Video Trigger Level 5 130 UNIT Subsystem 5 131 Select Power Units of Measure 5 131 6 HP 8590 HP ESA Spectrum Analyzers Programming Conversion Guide 7 Error Messages Error Messages 7 2 Status Messages 7 3 Informational Messages 7 7 Error Queues 7 8 Error Message Format 7 9 Error Message Types 7 10 0 No Error 7 11 499 to 400 Query ...

Page 14: ...xiv Contents ...

Page 15: ...s chapter is to serve as a reminder of SCPI Standard Commands for Programmable Instruments fundamentals to those who have previous experience in programming SCPI This chapter is not intended to teach you everything about the SCPI programming language ...

Page 16: ... or to IEEE Standard 488 2 1992 IEEE Standard Codes Formats Protocols and Common Commands for Use with ANSI IEEE Std 488 1 1987 New York NY 1992 Valid HP ESA Spectrum Analyzer SCPI commands are used for examples in this chapter Topics included in this chapter are Creating Valid Commands Command Notation Syntax Special Characters in Commands Putting Multiple Commands on the Same Line Overview of HP...

Page 17: ...ll all cause the same result Sense Band Res 1700 BANDWIDTH RESOLUTION 1 7e3 sens band 1 7KHZ SENS band 1 7E3Hz band 1 7kHz bandwidth RES 1 7e3Hz MEASure HARMonics AMPLitude n The last command below returns different results than the commands above it The number 3 in the command causes this See the command description for more information MEAS HARM AMPL Meas Harm Ampl MEAS HARM AMPL3 SENSe DETector...

Page 18: ...strument does not distinguish between upper and lower case letters In the documentation upper case letters indicate the short form of the key word The upper and lower case letters together indicate the long form of the key word Either form may be used in the command Example Trig Seq Vid Lev 2 5V is the same as trigger sequence video level 2 5V NOTE The command TRIGG Sequence Video Level 2 5V is no...

Page 19: ...and functions the same for either key word Command SENSe ACPower BANDw idth BWIDth ACHannel Two identical commands are SENSe ACPower BANDwid th ACHannel SENSe ACPower BWIDth ACHannel Key words in square brackets are optional when composing the command These implied key words will be executed even if they are omitted Command SENSe ACPower AVERa ge STATe OFF ON 0 1 The following commands are all val...

Page 20: ... command depends on the variable type being used See the following variable descriptions If no units are sent the indicated default units will be used Units can follow the numerical value with or without a space Variable A variable can be entered in exponential format as well as standard numeric format The appropriate variable range and its optional units are defined in the command description In ...

Page 21: ...tional units Acceptable units include V mV µV dBm dBmV dBµV Watts W angle An angle parameter is a rational number followed by optional units The default units are degrees Acceptable units include DEG RAD integer There are no units associated with an integer parameter percent A percent parameter is a rational number between 0 and 100 with no units string A string parameter includes a series of alph...

Page 22: ... is no current SCPI standard for RS 232 Although one intent of SCPI is to be interface independent END is only defined for IEEE 488 operation At the time of this writing the RS 232 terminator issue was in the process of being addressed in IEEE standard 1174 A semicolon is not a SCPI terminator it is a separator The purpose of the separator is to queue multiple commands or queries in order to obtai...

Page 23: ...OW to get to the MIX RANG command FREQ STAR 30MHz POW MIX RANG 20dBm FREQ STAR 30MHz POW MIX RANG 20dBm MIX and RANG are both in the same subsystem SENSE but they are two separate commands and need a semicolon to separate them POW ATT 40dB TRIG FREQ STAR 2 3GHz POW ATT 40dB FREQ STAR 2 3GHz FREQ STAR is in the SENSE subsystem not the TRIGGER subsystem POW ATT FREQ STAR POW ATT FREQ STAR POW and FR...

Page 24: ...n combined with the programming language codes they provide all management and data communication instructions for the system Refer to the your programming language manual and your computers I O programming manual for more information The seven fundamental command functions are as follows An abort function that stops all listener talker activity on the interface bus and prepares all instruments to...

Page 25: ...on of clear is unique for each instrument sometimes called clear reset control send An output function that is used to send function commands and data commands from the controller to the addressed instrument sometimes called output control convert image iobuffer transfer An enter function that is the complement of the output function and is used to transfer data from the addressed instrument to th...

Page 26: ...ommon serial interface configuration settings are Handshake and Baud Rate To determine hardware operating parameters you need to know the answer for each of the following questions about the peripheral device Which of the following signal and control lines are actively used during communication with the peripheral Data Set Ready DSR Clear to Send CTS What baud rate is expected by the peripheral Ch...

Page 27: ...erminal Ready signal Data Transfer Errors The serial interface can generate several types of errors when certain conditions are encountered while receiving data from the peripheral device Errors can be generated by any of the following conditions Parity error The parity bit on an incoming character does not match the parity expected by the receiver This condition is most commonly caused by line no...

Page 28: ...r using an IEEE 1284 compliant parallel printer cable 3 If appropriate configure your printer using configuration menus or switches Refer to your printer s documentation for more specific information on configuring your printer 4 Turn on the analyzer and printer 5 Press Print Setup on the front panel and then press the Printer Type menu key Printer Type accesses the following keys None None disabl...

Page 29: ...er Invalid printer response Define Custom to set up printer This indicates that the analyzer was unable to automatically identify the connected printer and Custom has been selected in the Printer Type menu Press Print Setup Define Custom to select specific printer characteristics such as the printer language PCL3 or PCL5 and color printing capability Once you have set these characteristics to matc...

Page 30: ...t Screen and then press Print on the front panel If the printer is ready and the printer setup was successful a printout of the analyzer display will be printed If the printer is not ready the message Printer Timeout will appear on the analyzer display Printer Timeout will remain on the display until the printer is ready or until you press ESC to cancel the printout request ...

Page 31: ...2 1 2 HP ESA Status Registers This chapter describes what status registers are and how to use them Also provided is a comprehensive description of all bits of the registers in HP ESA analyzers ...

Page 32: ... in status registers The polling method The service request SRQ method In the polling method the analyzer has a passive role It only tells the controller that conditions have changed when the controller asks the right question In the SRQ method the analyzer takes a more active role It tells the controller when there has been a condition change without the controller asking Either method allows you...

Page 33: ...ies the value of the service request enable register STB status byte queries the value of the status byte register without erasing its contents Individual status registers can be set and queried using the commands in the STATus subsystem of the language reference A status register is actually composed of five physical registers a condition register two transition registers an event enable register...

Page 34: ...his number is sent with the command to enable a particular bit If you want to enable more than one bit you would send the sum of all the bits that you are interested in For example to enable bit 0 and bit 6 of standard event status register you would send the command ESE 65 1 64 65 The results of a query are evaluated in a similar way If the STB command returns a decimal value of 140 140 128 8 4 t...

Page 35: ...t causes a summary bit in the status byte to change from 0 to 1 the analyzer can initiate the service request SRQ process However the process is only initiated if both of the following conditions are true The corresponding bit of the service request enable register is also set to 1 The analyzer does not have a service request pending A service request is considered to be pending between the time t...

Page 36: ...QS bit is reset to 0 Other bits in the register are not affected Restarting a measurement INITiate command can cause the measuring bit to pulse low which causes an SRQ if the status register is configured to SRQ on end of measurement To avoid this 1 Set INITiate CONTinuous off 2 Set enable the status registers 3 Restart the measurement send INITiate ...

Page 37: ... Serv Sum RQS Std Event Status Sum Message Available MAV Error Event Queue Summary Unused Unused Questionable Status Summary Condition Register Trans Filter Trans Filter Event Register Event Enable Reg STATus QUEStionable FREQuency 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Synth Unlocked Freq Ref Unlocked Reserved Reserved Source Synth Unlocked Invalid BW Reserved Reserved Reserved Unused Unused Unuse...

Page 38: ... register contains the following bits ck763a Unused Status Byte Register Unused Error Event Queue Summary Bit Questionable Summary Bit Status Message Available MAV Standard Event Summary Bit Request Service Summary RQS Operation Summary Bit Status 0 0 1 1 2 2 3 3 4 4 5 5 6 6 7 Service Request Enable Register 7 ...

Page 39: ...icates that the analyzer has data ready in the output queue There are no lower status groups that provide input to this bit 5 A 1 in this bit position indicates that the standard event status summary bit has been set The standard event status register can then be read to determine the specific event that caused this bit to be set 6 A 1 in this bit position indicates that the analyzer has at least ...

Page 40: ...he operation status summary bit is set to 1 it will trigger a service request Send the command SRE 192 128 64 You must always add 64 the numeric value of RQS bit 6 to your numeric sum when you enable any bits for a service request The command SRE returns the decimal value of the sum of the bits previously enabled with the SRE number command Bit Number D e c i m a l V a l u e 1 2 8 6 4 3 2 1 6 8 4 ...

Page 41: ...ister continuously monitors the hardware and firmware status of the analyzer There is no latching or buffering for a condition register It is updated in real time Negative Transition Register A negative transition register specifies the bits in the condition register that will set corresponding bits in the event register when the condition bit changes from 1 to 0 Positive Transition Register A pos...

Page 42: ...does not have negative and positive transition registers nor a condition register Use the IEEE common commands at the beginning of the Language Reference chapter in this guide to access the register It contains the following bits To Status Byte Register Bit 5 Request Bus Control Operation Complete Query Error Device Dependent Error Execution Error Command Error User Request Event Register Event En...

Page 43: ...vice dependent error has occurred Device dependent errors have SCPI error numbers from 399 to 300 and 1 to 32767 4 A 1 in this bit position indicates that an execution error has occurred Execution errors have SCPI error numbers from 299 to 200 5 A 1 in this bit position indicates that a command error has occurred Command errors have SCPI error numbers from 199 to 100 6 A 1 in this bit position ind...

Page 44: ...e decimal values of the bits you want to enable For example to enable bit 7 and bit 6 so that whenever either of those bits is set to 1 the standard event status summary bit of the Status Byte Register will be set to 1 send the command ESE 192 128 64 The command ESE returns the decimal value of the sum of the bits previously enabled with the ESE number command Bit Number D e c i m a l V a l u e 1 ...

Page 45: ... 12 14 13 15 ck758a CALibrating Unused Unused Unused Unused Unused SWEeping Reserved Reserved Reserved Reserved Reserved Reserved Reserved Always Zero 0 Waiting for TRIGger Operation Status Register Figure 2 2 Status Operation Register The Operation Status Register is used to determine the specific event that sets bit 7 in the Status Byte Register The Operation Status Register consists of the foll...

Page 46: ... the Bit Description 0 A 1 in this bit position indicates that the analyzer is performing a self calibration 1 2 Unused These bits are always set to 0 3 A 1 in this bit position indicates that a sweep is in progress 4 A 1 in this bit position indicates that a measurement1 is in progress 5 A 1 in this bit position indicates that a measurement1 is in a wait for trigger state 6 7 Unused These bits ar...

Page 47: ... choose which bits will set the Operation Status Summary bit bit 7 of the Status Byte Register to 1 Send the command STATus OPERation ENABle num where num is the sum of the decimal values of the bits you want to enable For example to enable bit 9 and bit 3 so that whenever either of those bits is set to 1 the operation status summary bit of the Status Byte Register will be set to 1 send the comman...

Page 48: ...er Status QUEStionable Negative Transition Filter Status QUEStionable Positive Transition Filter Status 0 1 2 3 4 5 6 7 8 9 10 11 12 14 13 15 0 1 2 3 4 5 6 7 8 9 10 11 12 14 13 15 0 1 2 3 4 5 6 7 8 9 10 11 12 14 13 15 0 1 2 3 4 5 6 7 8 9 10 11 12 14 13 15 0 1 2 3 4 5 6 7 8 9 10 11 12 14 13 15 ck759a FREQuency Summary CALibration Summary INTregrity Sum Reserved Reserved Reserved Reserved Reserved R...

Page 49: ...ister 4 These bits are reserved for undocumented use 5 This is the summary bit for the Questionable Frequency Status Register 6 7 Reserved These bits are not used by the analyzer but are for future use with other HP products 8 This is the summary bit for the Questionable Calibration Status Register 9 This is the summary bit for the Questionable Integrity Status Register 10 14 Reserved These bits a...

Page 50: ...nt to enable The Questionable Status event register latches transition events from the condition register as specified by the transition filters Event registers are destructive read only Reading data from an event register will clear the content of that register To query the event register send the command STATus QUEStionable EVENt Figure 2 7 The Questionable Status event enable register lets you ...

Page 51: ...tion register Questionable Status Power positive transition filter Questionable Status Power negative transition filter Questionable Status Power event register To Questionable Register Bit 3 Status Reserved QUEStionable POWer Event Enable Register Status 0 1 2 3 4 5 6 7 8 9 10 11 12 14 13 15 0 1 2 3 4 5 6 7 8 9 10 11 12 14 13 15 0 1 2 3 4 5 6 7 8 9 10 11 12 14 13 15 0 1 2 3 4 5 6 7 8 9 10 11 12 1...

Page 52: ...eference signal is unlevelled 5 Reserved These bits are not used by the analyzer but are for future use with other HP products 6 A 1 in this bit position indicates that the input overload protection HP ESA models E4401B and E4411B only is tripped 7 A 1 in this bit position indicates that the first local osillator LO output is unlevelled 8 14 Unused These bits are always set to 0 15 Always Zero 0 B...

Page 53: ...s are destructive read only Reading data from an event register will clear the content of that register To query the event register send the command STATus QUEStionable POWer EVENt Figure 2 10 The Questionable Status Power event enable Register lets you choose which bits will set the summary bit bit 3 of the Questionable Status Condition Register to 1 Send the command STATus QUEStionable POWer ENA...

Page 54: ...stionable Status Frequency event register Questionable Status Frequency event enable register To Questionable Status Register Bit 5 QUEStionable FREQuency Condition Register Status QUEStionable FREQuency Event Register Status QUEStionable Event Enable Register Status QUEStionable FREQuency Negative Transition Filter Status QUEStionable FREQuency Positive Transition Filter Status 0 1 2 3 4 5 6 7 8 ...

Page 55: ...but are for future use with other HP products 4 A 1 in this bit position indicates that the analyzer synthesizer is unlocked 5 A 1 in this bit position indicates that an invalid bandwidth setting has been requested 6 8 Reserved These bits are not used by the analyzer but are for future use with other HP products 9 14 Unused These bits are always set to 0 15 Always Zero 0 Bit Number 7 8 9 10 11 12 ...

Page 56: ...ry the event register send the command STATus QUEStionable FREQuency EVENt Figure 2 13 The Questionable Status Frequency event enable register lets you choose which bits will set the summary bit bit 5 of the Questionable Status Register to 1 Send the command STATus QUEStionable FREQuency ENABle num where num is the sum of the decimal values of the bits you want to enable For example to enable bit ...

Page 57: ...able register The Questionable Status Calibration condition register contains the following bits To Questionable Register Bit 8 Status Reserved TG Align Failure Reserved RF Align Failure FM Demod Align Failure Qpeak Align Failure Tracking Peak Needed Align RF Skipped Align RF Needed Reserved Unused Align Needed QUEStionable CALibration Condition Register Status QUEStionable CALibration Event Regis...

Page 58: ...8 A 1 in this bit position indicates that a failure has occurred while trying to align the quasi peak detector 9 Unused These bits are always set to 0 10 A 1 in this bit position indicates that a tracking peak needs to be performed for the CAL OUTPUT the tracking generator is in operation 11 A 1 in this bit position indicates that the alignment of the RF section was skipped perhaps due to an exter...

Page 59: ...atus Calibration event register latches transition events from the condition register as specified by the transition filters Event registers are destructive read only Reading data from an event register will clear the content of that register To query the event register send the command STATus QUEStionable CALibration EVENt Figure 2 16 12 A 1 in this bit position indicates that the RF section need...

Page 60: ...he sum of the decimal values of the bits you want to enable For example to enable bit 11 and bit 3 so that whenever either of those bits is set to 1 the Questionable Status Calibration summary bit of the Questionable Status Calibration condition register will be set to 1 send the command STATus QUEStionable CALibration ENABle 2056 2048 8 The command STATus QUEStionable CALIbration ENABle returns t...

Page 61: ...onable Status Integrity event enable register The Questionable Status Integrity Condition Register contains the following bits To Questionable Register Bit 9 Status Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Measurement Uncal Invalid Data Status INTegrity QUEStionable Condition Register Status QUEStionable INTegrity Event Register St...

Page 62: ...yzer is in a state that could lead to uncalibrated measurements Auto coupling may resolve this problem 4 5 11 Reserved These bits are not used by the analyzer but are for future use with other HP products 12 A 1 in this bit position indicates that the present trace data does not reflect the existing analyzer state Trigger a new sweep and or measurement 13 14 Reserved These bits are not used by the...

Page 63: ... the integrity summary bit bit 9 of the Questionable Status Register to 1 Send the command STATus QUEStionable INTegrity ENABle num where num is the sum of the decimal values of the bits you want to enable For example to enable bit 12 and bit 3 so that whenever either of those bits is set to 1 the Questionable Status Integrity summary bit of the Questionable Status condition register will be set t...

Page 64: ...2 34 Chapter2 HP ESA Status Registers Using the Analyzer Status Registers ...

Page 65: ...3 1 3 Programming Examples ...

Page 66: ... examples included in this chapter are Using Marker Peak Search and Peak Excursion Using Marker Delta Mode and Marker Minimum Search Performing Internal Self alignment Reading Trace Data using ASCII Format HP IB Reading Trace Data Using 32 bit Real Format HP IB Reading Trace Data Using ASCII Format RS 232 Reading Trace Data Using 32 bit Real Format RS 232 Creating a Limit Line Measuring Noise Ente...

Page 67: ...e Program Contents The following is a summary of the VTL function calls used in the example programs visa h This file is included at the beginning of the file to provide the function prototypes and constants defined by VTL ViSession The ViSession is a VTL data type Each object that will establish a communication channel must be defined as ViSession viOpenDefaultRM You must first open a session wit...

Page 68: ...mpilers 16 bit Version C VXIPNP WIN LIB MSC VISA LIB for Microsoft compilers C VXIPNP WIN LIB BC VISA LIB for Borland compilers See the following section for information on how to use the VTL run time libraries Compiling and Linking a VTL Program 32 bit Applications The following is a summary of important compiler specific considerations for several C C compiler products when developing WIN32 appl...

Page 69: ...ey are set under the Options Project menu selection Double click on Directories from the Topics list box and add the following C VXIPNP WIN95 INCLUDE C VXIPNP WIN95 LIB BC 16 bit Applications The following is a summary of important compiler specific considerations for the Windows compiler For Microsoft Visual C version 1 5 To set the memory model do the following 1 Select Options Project 2 Click o...

Page 70: ...tring s n buf Close the sessions viClose vi viClose defaultRM Including the VISA Declarations File For C and C programs you must include the visa h header file at the beginning of every file that contains VTL function calls include visa h This header file contains the VISA function prototypes and the definitions for all VISA constants and error codes The visa h header file includes the visatype h ...

Page 71: ...ss Therefore if viOpenDefaultRM is called without devices connected and then called again when devices are connected the devices will not be recognized You must close ALL resource manager sessions and re open with all devices connected and in working condition Device Sessions There are two parts to opening a communications session with a specific device First you must open a session to the default...

Page 72: ...session when using other VTL functions The following is an example of opening sessions with an HP IB multimeter and an HP IB VXI scanner ViSession defaultRM dmm scanner viOpenDefaultRM defaultRM viOpen defaultRM GPIB0 22 INSTR VI_NULL VI_NULL dmm viOpen defaultRM GPIB VXI0 24 INSTR VI_NULL VI_NULL scanner viClose scanner viClose dmm viClose defaultRM The above function first opens a session with t...

Page 73: ... address of the HP IB device secondary address This optional parameter is the secondary address of the HP IB device If no secondary address is specified none is assumed INSTR This is an optional parameter that indicates that you are communicating with a resource that is of type INSTR meaning instrument NOTE If you want to be compatible with future releases of VTL and VISA you must include the INST...

Page 74: ...Closing a Session The viClose function must be used to close each session You can close the specific device session which will free all data structures that had been allocated for the session If you close the default resource manager session all sessions opened using that resource manager will be closed Since system resources are also used when searching for resources viFindRsrc or waiting for eve...

Page 75: ...ser for the peak excursion and set them Set the peak threshold to 90 dB Trigger a sweep Check for operation complete Set the marker to the maximum peak Query and read the marker frequency and amplitude Close the session Example include stdio h include stdlib h include math h include conioh include ctype h include string h include visa h define hpESA_IDN_E4401B Hewlett Packard E4401B define hpESA_I...

Page 76: ...pt the user to connect the amplitude reference output to the RF input printf Connect amplitude reference output to the input n printf Press any key to continue n scanf c cEnter Externally route the 50 MHz signal viPrintf viESA CAL SOUR EXT n viPrintf viESA CAL SOUR STAT ON n void main Program Variables ViStatus viStatus 0 0 double dMarkerFreq 0 0 double dMarkerAmpl 0 0 float fPeakExcursion 0 0 lon...

Page 77: ...d route the 50 MHz signal accordingly Route50MHzSignal Set the analyzer to single sweep mode viPrintf viESA INIT CONT 0 n User enters the peak excursion value printf Enter PEAK EXCURSION in dB scanf f fPeakExcursion Set the peak excursion viPrintf viESA CALC MARK PEAK EXC 1fDB n fPeakExcursion Set the peak threshold viPrintf viESA TRAC MATH PEAK THR STAT ON n viPrintf viESA TRAC MATH PEAK THR 90 n...

Page 78: ...ry and read the marker frequency viPrintf viESA CALC MARK X n viScanf viESA lf dMarkerFreq printf RESULT Marker Frequency is lf MHz n dMarkerFreq 10e5 Query and read the marker amplitude viPrintf viESA CALC MARK Y n viScanf viESA lf dMarkerAmpl printf RESULT Marker Amplitude is lf dBm n dMarkerAmpl Close the session viClose viESA viClose defaultRM ...

Page 79: ...d set them Trigger a sweep Check for operation complete Set the marker to the maximum peak Set the analyzer to active delta marker mode Trigger a sweep Check for operation complete Set the marker to minimum amplitude mode Query read and display the marker amplitude Close the session Example include stdio h include stdlib h include math h include conio h include ctype h include string h include vis...

Page 80: ...R STAT ON n else For analyzers having frequency limits 3 GHz prompt the user to connect the amplitude reference output to the RF input printf Connect amplitude reference output to the input n printf Press any key to continue n scanf c cEnter Externally route the 50 MHz signal viPrintf viESA CAL SOUR STAT ON n void main Program Variables ViStatus viStatus 0 double dStartFreq 0 0 double dStopFreq 0 ...

Page 81: ...ntf viESA INIT CONT 0 n Prompt the user for the start and stop frequencies printf Enter the Start Stop frequencies in MHz The user enters the start and stop frequencies scanf lf lf dStartFreq dStopFreq Set the analyzer to the values given by the user viPrintf viESA SENS FREQ STAR lf MHz n SENS FREQ STOP lf MHz n dStartFreq dStopFreq Trigger a sweep viPrintf viESA INIT IMM n Check for operation com...

Page 82: ...ation complete viQueryf viESA OPC n d lOpc if lOpc printf Program Abort error ocurred last command was not completed n exit 0 Set the marker to minimum amplitude viPrintf viESA CALC MARK MIN n Query and read the marker amplitude viPrintf viESA CALC MARK Y n viScanf viESA lf dMarkerAmplitude Print the marker amplitude printf RESULT Marker Amplitude lf dBm n dMarkerAmplitude Close the session viClos...

Page 83: ...gnment Report the results of the self alignment Close the session Example include stdio h include stdlib h include ctype h include string h include visa h define hpESA_IDN_E4401B Hewlett Packard E4401B define hpESA_IDN_E4411B Hewlett Packard E4411B Visession defaultRM viESA ViStatus errStatus ViChar cIdBuff 256 0 char cEnter 0 int iResult 0 Set the input port to the 50 MHz amplitude reference void...

Page 84: ...nput n printf Press any key to continue n scanf c cEnter Externally route the 50 MHz signal viPrintf viESA CAL SOUR STAT ON n void main Program Variables ViStatus viStatus 0 long lOpc 0L long lResult 0L Open an HP IB session at address 18 viStatus viOpenDefaultRM defaultRM viStatus viOpen defaultRM GPIB0 18 VI_NULL VI_NULL viESA if viStatus printf Could not open a session to HP IB device at addres...

Page 85: ...ration complete viQueryf viESA OPC n d lOpc printf n n t Intial Self Alignment is Over n n if lOpc printf Program Abort error ocurred last command was not completed n exit 0 printf n n t Press any key to continue to next program n scanf c cEnter printf t Performing next self alignment Query for self alignment results viPrintf viESA CAL ALL n viScanf viESA d lResult if lResult printf n n t Self ali...

Page 86: ...3 22 Chapter3 Programming Examples Performing Internal Self alignment Close the session viClose viESA viClose defaultRM ...

Page 87: ...he operation complete query Specify units in dBm Set the analyzer trace data format to ASCII format Trigger a sweep Read the operation complete query Query the trace data using ASCII format Remove the from the ASCII trace data for analyzing data Save trace data to an ASCII file by removing the token Close the session Example include stdio h include stdlib h include math h include conio h include c...

Page 88: ...erence for HP models E4401B or E4411B viPrintf viESA CAL SOUR STAT ON n else For analyzers having frequency limits 3 GHz prompt the user to connect the amplitude reference output to the RF input printf Connect amplitude reference output to the input n printf Press any key to continue n scanf c cEnter Externally route the 50 MHz signal viPrintf viESA CAL SOUR STAT ON n void main Program Variables V...

Page 89: ...g ASCII format HPIB Program n n Check for the analyzer model number and route the 50 MHz signal accordingly Route50MHzSignal Set the analyzer center frequency to 50 MHz viPrintf viESA SENS FREQ CENT 50 MHZ n Set the analyzer to single sweep mode viPrintf viESA INIT CONT 0 n Trigger a sweep viPrintf viESA INIT IMM n Read the operation complete query viQueryf viESA OPC n d lOpc if lOpc printf Progra...

Page 90: ... from the ASCII trace data for analyzing data cToken strtok cResult Save trace data to an ASCII file by removing the token fTraceFile fopen C temp ReadAscHpib txt w fprintf fTraceFile ReadAscHpib exe Output nHewlett Packard 1999 n n fprintf fTraceFile tAmplitude of point d s dBm n lCount 1 cToken while cToken NULL lCount cToken strtok NULL if lCount 401 fprintf fTraceFile tAmplitude of point d s d...

Page 91: ...t analyzer trace data format to 32 bit Real Set the binary byte order to SWAP Trigger a sweep Read the operation complete query Get trace and header data in this case we know its 1701 bytes Extract the number of bytes from the trace header Extract the trace data Save trace data to an ASCII file Close the session Example include stdio h include stdlib h include math h include conio h include ctype ...

Page 92: ... amplitude reference output to the input printf Connect amplitude reference output to the input n printf Press any key to continue n scanf c cEnter Externally route the 50 MHz Signal viPrintf viESA CAL SOUR STAT ON n void main program variable ViStatus viStatus 0 ViChar _VI_FAR cResult 5000 ViReal32 dTraceArray 401 0 char cBufferInfo 6 0 long lNumberBytes 0L long lOpc 0L unsigned long lRetCount 0L...

Page 93: ...ical division and Units viPrintf viESA DISP WIND TRAC Y SCAL PDIV 10dB n viPrintf viESA UNIT POW DBM n Set analyzer trace data format to 32 bit Real viPrintf viESA FORM DATA REAL 32 n Set the binary byte order to SWAP viPrintf viESA FORMat BORDer SWAPped n Trigger a sweep viPrintf viESA INIT IMM n Read the operation complete query viQueryf viESA OPC n d lOpc if lOpc printf Program Abort error ocur...

Page 94: ...s Save trace data to an ASCII file fTraceFile fopen C temp ReadTrace32Hpib txt w fprintf fTraceFile ReadTrace32Hpib exe Output nHewlett Packard 1999 n n fprintf fTraceFile The d trace data points of the spectrum n n lNumberBytes 4 for long i 0 i lNumberBytes 4 i fprintf fTraceFile tAmplitude of point d 2lf dBm n i 1 dTraceArray i fclose fTraceFile Close the session viClose viESA viClose defaultRM ...

Page 95: ...on complete query Specify units in dBm Set the analyzer trace data format to ASCII format Trigger a sweep Read the operation complete query Query the trace data using ASCII format Remove the token from the ASCII trace data for analyzing data Save trace data to an ASCII file by removing the token Close the session Example include stdio h include stdlib h include math h include conio h include ctype...

Page 96: ...411B viPrintf viESA CAL SOUR INT n viPrintf viESA CAL SOUR STAT ON n else For analyzers having frequency limits 3 GHz prompt the user to connect the amplitude reference output to the RF input printf Connect amplitude reference output to the input n printf Press any key to continue n scanf c cEnter Externally route the 50 MHz signal viPrintf viESA CAL SOUR EXT n viPrintf viESA CAL SOUR STAT ON n vo...

Page 97: ... ASCII format RS232 Program n n Check for the analyzer model number and route the 50 MHz signal accordingly Route50MHzSignal Set the analyzer center frequency to 50 MHz viPrintf viESA SENS FREQ CENT 50 MHZ n Set the analyzer to single sweep mode viPrintf viESA INIT CONT 0 n Trigger a sweep viPrintf viESA INIT IMM n Read the operation complete query viQueryf viESA OPC n d lOpc if lOpc printf Progra...

Page 98: ...en from the ASCII trace data for analyzing data cToken strtok cResult Save trace data to an ASCII file by removing the token fTraceFile fopen C temp ReadAscRS232 txt w fprintf fTraceFile ReadAscRS232 exe Output nHewlett Packard 1999 n n fprintf fTraceFile tAmplitude of point d s dBm n lCount 1 cToken while cToken NULL lCount cToken strtok NULL if 1Count 401 fprintf fTraceFile tAmplitude of point d...

Page 99: ...an Specify dB per division of each vertical division and units Set analyzer trace data format to 32 bit Real Set the binary byte order to SWAP Trigger a sweep Read the operation complete query Get trace and header data in this case we know its 1701 bytes Extract the number of bytes from the trace header Extract the trace data Save trace data to an ASCII file Close the session Example include stdio...

Page 100: ..._E4401B strlen hpESA_IDN_E4401B strncmp cIdBuff hpESA_IDN_E4411B strlen hpESA_IDN_E4411B if iRes Set the input port to the 50 MHz amplitude reference for the models E4411B E4401B viPrintf viESA CAL SOUR STAT ON n else For the analyzers having frequency limits 3GHz prompt the user to connect the amplitude reference output to the input printf Connect amplitude reference output to the input n printf ...

Page 101: ...faultRM ASRL1 INSTR VI_NULL VI_NULL viESA VI_SUCCESS printf Could not open a session to ASRL device at COM1 n exit 0 Clear the analyzer viClear viESA Reset the analyzer viPrintf viESA RST n Display the program heading printf n t t Read in Trace Data using ASCII Format using RS 232 Program n n Set the input port to the 50 MHz amplitude reference Route50MHzSignal Set analyzer to single sweep mode vi...

Page 102: ...or ocurred last command was not completed n exit 0 Get trace and header data in this case we know its 1701 bytes viPrintf viESA TRAC DATA TRACE1 n viRead viESA ViBuf cResult 1701 lRetCount Extract the number of bytes from the trace header memcpy cBufferInfo cResult 2 4 lNumberBytes atoi cBufferInfo iSize lNumberBytes 6 1 Get trace header data and trace data viRead viESA ViBuf cResult iSize lRetCou...

Page 103: ...Examples Reading Trace Data Using 32 bit Real Format RS 232 for long i 0 i lNumberBytes 4 i fprintf fTraceFile tAmplitude of point d 2lf dBm n i 1 dTraceArray i fclose fTraceFile Close the session viClose viESA viClose defaultRM ...

Page 104: ...plitude pairs Turn the limit line test function on Set the analyzer to a center frequency of 50 MHz span to 20 MHz and resolution bandwidth to 1 MHz Turn the limit line test function on Set the analyzer reference level to 0 dBm Activate the 50 MHz Alignment signal Check to see if limit line passes or fails It should pass Pause for 5 seconds Deactivate the 50 MHz alignment signal The limit line tes...

Page 105: ...n t cIdBuff iResult strncmp cIdBuff hpESA_IDN_E4401B strlen hpESA_IDN_E4401B strncmp cIdBuff hpESA_IDN_E4411B strlen hpESA_IDN_E4411B if iResult 0 Set the input port to the 50 MHz amplitude reference for the models E4411B E4401B viPrintf viESA CAL SOUR STAT ON n else For the analyzers having frequency limits 3GHz prompt the user to connect the amplitude reference output to the input printf Connect...

Page 106: ... printf n t 1 Limits Line1 Failed n viQueryf viESA CALC LLINE2 FAIL n ld lLimitTest if lLimitTest 0 printf n t 2 Limits Line2 Passed n else printf n t 2 Limits Line2 Failed n else printf n t Limit Test Pass n void main Program Variable ViStatus viStatus 0 long lOpc 0L Open an HP IB session at address 18 viStatus viOpenDefaultRM defaultRM viStatus viOpen defaultRM GPIB0 18 VI_NULL VI_NULL viESA if ...

Page 107: ...s viPrintf viESA CALC LLINE1 TYPE UPP n Turn on display viPrintf viESA CALC LLINE1 DISP ON n Send the upper limit line data viPrintf viESA CALC LLINE1 DATA 40E06 50 1 45E06 20 1 50E06 15 1 55E06 20 1 60E06 50 1 n Turn on display viPrintf viESA CALC LLINE1 DISP ON n Delete any current limit line and define the lower limit line to have the following frequency amplitude pairs viPrintf viESA CALC LLIN...

Page 108: ...ignal accordingly Route50MHzSignal viPrintf viESA INIT IMM n Check for operation complete viQueryf viESA OPC n d lOpc if lOpc printf Program Abort error ocurred last command was not completed n exit 0 Check to see if limit line passes or fails It should pass printf Limit Line status after activating the 50MHZ signal n printResult Pause for 5 seconds YIELD Deactivate the 50 MHz alignment signal viP...

Page 109: ...Examples Creating a Limit Line The limit line test should fail printf Limit Line status after de activating the 50MHZ signal n printResult Reset the analyzer viPrintf viESA RST n Close the session viClose viESA viClose defaultRM ...

Page 110: ...heck for operation complete Set the analyzer to activate delta marker mode Set the marker delta frequency to 2 MHz This places the active marker two divisions to the right of the input signal Activate the noise marker function Trigger a sweep Check for operation complete Report the marker delta amplitude as the carrier to noise ratio in dBc Hz Query and read the marker delta amplitude from the ana...

Page 111: ... to the 50 MHz amplitude reference for HP models E4401B or E4411B viPrintf viESA CAL SOUR STAT ON n else For analyzers having frequency limits 3 GHz prompt the user to connect the amplitude reference output to the RF input printf Connect amplitude reference output to the input n printf Press any key to continue n scanf c cEnter Externally route the 50 MHz signal viPrintf viESA CAL SOUR STAT ON n v...

Page 112: ...MHzSignal Set the analyzer center frequency to 50 MHz viPrintf viESA SENS FREQ CENT 50e6 n Set the analyzer span to 10 MHz viPrintf viESA SENS FREQ SPAN 10e6 n Set the analyzer to single sweep mode viPrintf viESA INIT CONT 0 n Trigger a sweep viPrintf viESA INIT IMM n Check for operation complete viQueryf viESA OPC n d lOpc if lOpc printf Program Abort error ocurred last command was not completed ...

Page 113: ...to the right of the input signal viPrintf viESA CALC MARK X 2E 6 n Activate the noise marker function viPrintf viESA CALC MARK FUNC NOIS n Trigger a sweep viPrintf viESA INIT IMM n Check for operation complete viQueryf viESA OPC n d lOpc if lOpc printf Program Abort error ocurred last command was not completed n exit 0 Query and read the marker delta amplitude from the analyzer viPrintf viESA CALC...

Page 114: ...tion Store the array frequency amplitude value into a two dimensional real array Query the analyzer for the amplitude correction factors Remove the token from the amplitude correction for analyzing data Display the contents of the array Close the session Example include stdio h include stdlib h include math h include conio h include ctype h include string h include visa h define hpESA_IDN_E4401B H...

Page 115: ...to connect the amplitude reference output to the RF input printf Connect amplitude reference output to the input n printf Press any key to continue n scanf d iEnter Externally route the 50 MHz signal viPrintf viESA CAL SOUR STAT ON n void main Program Variables ViChar _VI_FAR cResult 1024 0 ViReal64 _VI_FAR aRealArray 2 100 0 ViStatus viStatus 0 int iNum 0 int iNoOfPoints 0 long lCount 0L long lFr...

Page 116: ...zSignal Purge any currently loaded amplitude correction factors viPrintf viESA SENS CORR CSET1 DEL n Enter amplitude correction frequency amplitude pairs 100 MHz 5 dB 1 GHz 5 dB 1 5MHz 10 dB viPrintf viESA SENS CORR CSET1 DATA viPrintf viESA 100 E6 5 0 viPrintf viESA 1 E9 5 0 viPrintf viESA 1 5E6 10 n Activate amplitude correction Notice that the noise floor slopes up from 0 Hz to 100 MHz then dow...

Page 117: ...al real array aRealArray lAmpltd 1 lCount atof cToken while cToken NULL lCount if lCount iNoOfPoints lCount break Remove the token from the amplitude correction for analyzing data cToken strtok NULL Store the array frequency value into a two dimensional real array aRealArray lFreq lCount atof cToken cToken strtok NULL Store the array amplitude value into a two dimensional real array aRealArray lAm...

Page 118: ...3 54 Chapter3 Programming Examples Entering Amplitude Correction Data Close the session viClose viESA viClose defaultRM ...

Page 119: ...or an error message has occurred Configure the computer to respond to an interrupt open a context install the handler and enable it Send an undefined command to the device Averaging the successive measurements Set video averaging to 20 sweeps Turn Average On Initiate a measurement Wait until SRQ is generated and for the handler to be called Print something while waiting When interrupt occurs it wi...

Page 120: ...ewlett Packard E4401B define hpESA_IDN_E4411B Hewlett Packard E4411B define YIELD Sleep 10 ViSession defaultRM viESA ViStatus errStatus ViChar cIdBuff 256 0 char cEnter 0 int iResult 0 int iSrqOccurred 0 char cBuf 3 0 Wait until SRQ is generated and for the handler to be called Print something while waiting When interrupt occurs it will be handled by interrupt handler void WaitForSRQ long lCount 0...

Page 121: ...strlen hpESA_IDN_E4401B strncmp cIdBuff hpESA_IDN_E4411B strlen hpESA_IDN_E4411B if iResult 0 Set the input port to the 50 MHz amplitude reference for the models E4411B E4401B viPrintf viESA CAL SOUR STAT ON n else For the analyzers having frequency limits 3GHz prompt the user to connect the amplitude reference output to the input printf Connect amplitude reference output to the input n printf Pre...

Page 122: ...he ESA generates the interrupt simply report analyzer at HP IB Address xxx Has Generated an Interrupt printf n n SRQ event occurred n printf n Original Device Session t n viESA Get the HP IB address of the insrument which has interrupted viQueryf viESA SYST COMM GPIB SELF ADDR n t cBuf printf n Instrument at HP IB address s has generated an interrupt n cBuf Get the status byte If the ESA generated...

Page 123: ...L viESA if viStatus printf Could not open a session to HP IB device at address 18 n exit 0 Clear the analyzer viClear viESA Reset the analyzer viPrintf viESA RST n Clear the status byte of the analyzer viPrintf viESA CLS n Display the program heading printf n t t Status Register Program n n Put the analyzer in a single sweep viPrintf viESA INIT CONT 0 n Check for the analyzer model number and rout...

Page 124: ... either a measurement is completed or an error message has occurred viPrintf viESA SRE 32 n viPrintf viESA ESE 35 n Configure the computer to respond to an interrupt install the handler and enable it viInstallHandler viESA VI_EVENT_SERVICE_REQ mySrqHdlr ViAddr 10 viEnableEvent viESA VI_EVENT_SERVICE_REQ VI_HNDLR VI_NULL Send an undefined command to the device viPrintf viESA IDN n Wait for SRQ Wait...

Page 125: ...e and uninstall the interrupt handler viDisableEvent viESA VI_EVENT_SERVICE_REQ VI_HNDLR viUninstallHandler viESA VI_EVENT_SERVICE_REQ mySrqHdlr ViAddr 10 Clear the analyzer status register viPrintf viESA SRE 0 n Clear the status byte of the analyzer viPrintf viESA CLS n Close the session viClose viESA viClose defaultRM ...

Page 126: ...ed state When an interrupt occurs poll all instruments Report the nature of the interrupt on the HP ESA analyzer Clear the analyzer status register Continue monitoring for an interrupt Send an illegal command When an interrupt occurs recognize it Report the nature of the interrupt on the HP ESA analyzer Clear the analyzer status register Continue monitoring for an interrupt Close the session Examp...

Page 127: ...ntil SRQ is generated and for the handler to be called Print something while waiting When interrupt occurs it will be handled by interrupt handler void WaitForSRQ long lCount 0L iSrqOccurred 0 printf t nWaiting for an SRQ to be generated for lCount 0 lCount 10 iSrqOccurred 0 lCount long lCount2 0 printf while lCount2 100 iSrqOccurred 0 YIELD printf n Set the input port to the 50 MHz amplitude refe...

Page 128: ...ompt the user to connect the amplitude reference output to the input printf Connect amplitude reference output to the input n printf Press any key to continue n scanf c cEnter Externally route the 50 MHz Signal viPrintf viESA CAL SOUR STAT ON n Interrupt handler trigger event handler ViStatus _VI_FUNCH sSrqHdlr ViSession viESA ViEventType eventType ViEvent ctx ViAddr userHdlr ViUInt16 iStatusByte ...

Page 129: ...upt n cBuf Get the status byte If the ESA generated the interrupt determine the nature of the interrupt either a measurement is uncalibrated or an error message has occurred viQueryf viESA STAT QUES INT EVEN n d iStatusByte if 0x08 iStatusByte printf n SRQ message t Measurement uncalibrated n If the ESA generated the interrupt determine the nature of the interrupt did the measurement complete or a...

Page 130: ...set the analyzer viPrintf viESA RST n Clear the status byte of the analyzer viPrintf viESA CLS n Display the program heading printf n t t Status register2 Program n n Check for the analyzer model number and route the 50 MHz signal accordingly Route50MHzSignal Put the analyzer in single sweep viPrintf viESA INIT CONT 0 n Set the service request mask to assert SRQ when either a measurement is uncali...

Page 131: ...ep Time viPrintf viESA SENS SWE TIME AUTO 1 n Allow analyzer to sweep several times viPrintf viESA INIT CONT 1 n Manually couple sweeptime to 5ms reduce resolution BW to 30 kHz Meas Uncal should be displayed on the screen and an interrupt should be generated viPrintf viESA SENS SWE TIME 5 ms n viPrintf viESA SENS BAND RES 30 KHZ n Wait for SRQ WaitForSRQ Set the service request mask to assert SRQ ...

Page 132: ...rred Clear the analyzer status register viPrintf viESA SRE 0 n viPrintf viESA ESE 0 n viPrintf viESA STAT QUES ENAB 0 n viPrintf viESA STAT QUES INT ENAB 0 n Clear the status byte of the analyzer viPrintf viESA CLS n Close the session viClose viESA viClose defaultRM ...

Page 133: ...n a single sweep mode Trigger a sweep Check for operation complete Perform the peak search Trigger a sweep Check for operation complete Perform the peak search Perform activates signal track Perform narrow span and wait Check for operation complete De activate the signal track Set units to dBm Take a sweep and wait for the sweep completion Check for operation complete Perform the peak search Take ...

Page 134: ...ack Zoom down to a 100 kHz span Take a sweep and wait for the sweep completion Signal track off Perform a peak search and wait for completion Set marker amplitude in volts Query read the marker amplitude in volts Change the amplitude units to dBm and read the marker amplitude Calculate the relative amplitude of each harmonic relative to the fundamental Calculate the total harmonic distortion Displ...

Page 135: ... n exit 0 Set the input port to the 50 MHz amplitude reference void Route50MHzSignal viQueryf viESA IDN n t cIdBuff iResult strncmp cIdBuff hpESA_IDN_E4401B strlen hpESA_IDN_E4401B strncmp cIdBuff hpESA_IDN_E4411B strlen hpESA_IDN_E4411B if iResult 0 Set the input port to the 50 MHz amplitude reference if the model is E4401B E4411B viPrintf viESA CAL SOUR STAT ON n else For the 3Ghz ask user to co...

Page 136: ...lMaxHarmonic 0L long Num 0L Setting default values lMaxHarmonic 5 dFundamental 50 0 Open an HP IB session at address 18 viStatus viOpenDefaultRM defaultRM viStatus viOpen defaultRM GPIB0 18 VI_NULL VI_NULL viESA if viStatus printf Could not open a session to HP IB device at address 18 n exit 0 Clear the analyzer viClear viESA Reset the analyzer viPrintf viESA RST n Display the program heading prin...

Page 137: ...ueryf viESA OPC n d lOpc if lOpc printf Program Abort Error occurred last command was not completed n exit 0 Perform a peak search viPrintf viESA CALC MARK MAX n Place the signal at the reference level using the marker to reference level command and take sweep viPrintf viESA CALC MARK SET RLEV n Trigger a sweep viPrintf viESA INIT IMM n Check for operation complete viQueryf viESA OPC n d lOpc if l...

Page 138: ...it for the sweep completion TakeSweep Perform a peak search viPrintf viESA CALC MARK MAX n Take a sweep and wait for the sweep completion TakeSweep Read the marker amplitude this is the fundamental amplitude in dBM viQueryf viESA CALC MARK Y n 1f fFundaAmptdDbm Change the amplitude units to volts viPrintf viESA UNIT POW V n Take a sweep and wait for the sweep completion TakeSweep Read the marker a...

Page 139: ... The new center frequency should roughly equal the frequency of the next harmonic viPrintf viESA SENS FREQ CENT UP n Take a sweep and wait for the sweep completion TakeSweep Perform a peak search and wait for completion viPrintf viESA CALC MARK MAX OPC n viScanf viESA d lOpc Activate signal track viPrintf viESA CALC MARK TRCK STAT ON n Zoom down to a 100 kHz span viPrintf viESA SENS FREQ SPAN 10e4...

Page 140: ... each harmonic relative to the fundamental for lNum 2 lNum lMaxHarmonic lNum dSumSquare dSumSquare pow double fHarmV i 2 0 Relative Amplitude fRelAmptd lNum fHarmDbm lNum fFundaAmptdDbm Calculate the total harmonic distortion by dividing the square root of the sum of the squares dSumSquare by the fundamental amplitude in volts dFundaAmptdV Multiply this value by 100 to obtain a result in percent d...

Page 141: ...77 Programming Examples Measuring Harmonic Distortion HP IB n i fRelAmptd i Total harmonic distortion in percent printf Total Harmonic Distortion lf n dPrcntDistort Close the session viClose viESA viClose defaultRM ...

Page 142: ...ation complete Perform the peak search Place the signal at the reference level using the marker to reference level command and take sweep Perform the thepeak search Trigger a sweep Check for operation complete Perform the peak search Perform activates signal track Perform narrow span and wait Check for operation complete De activate the signal track Set units to dBm Take a sweep and wait for the s...

Page 143: ... Perform a peak search and wait for completion Activate signal track Zoom down to a 100 kHz span Take a sweep and wait for the sweep completion Signal track off Perform a peak search and wait for completion Set Marker Amplitude in volts Query and read the marker amplitude in volts Change the amplitude units to dBm and read the marker amplitude Calculate the relative amplitude of each harmonic rela...

Page 144: ...dBuff hpESA_IDN_E4411B strlen hpESA_IDN_E4411B if iResult 0 Set the input port to the 50 MHz amplitude reference for the models E4411B E4401B viPrintf viESA CAL SOUR STAT ON n else For analyzers having frequency limits 3 GHz prompt the user to connect the amplitude reference output to the input printf Connect amplitude reference output to the input n printf Press any key to continue n scanf c cEnt...

Page 145: ...s viStatus 0 double dFundamental 0 0 float fHarmV 10 0 0 float fHarmDbm 10 0 0 float fRelAmptd 10 0 0 float fFundaAmptdDbm 0 0 double dFundaAmptdV 0 0 double dMarkerFreq 0 0 double dPrcntDistort 0 0 double dSumSquare 0 0 long lMaxHarmonic 0L long lNum 0L Setting default values lMaxHarmonic 5 dFundamental 50 0 ...

Page 146: ...e 50 MHz signal accordingly Route50MHzSignal Set the analyzer center frequency to the fundamental frequency viPrintf viESA SENS FREQ CENT lf MHz n dFundamental Set the analyzer to 10 MHz Span viPrintf viESA SENS FREQ SPAN 10 MHZ n Put the analyzer in a single sweep mode viPrintf viESA INIT CONT 0 n Trigger a sweep viPrintf viESA INIT IMM n Check for operation complete viQueryf viESA OPC n d lOpc i...

Page 147: ...t Error occurred last command was not completed n exit 0 De activate the signal track viPrintf viESA CALC MARK TRCK STAT OFF n Set units to DBM viPrintf viESA UNIT POW DBM n Take a sweep and wait for the sweep completion TakeSweep Perform a peak search viPrintf viESA CALC MARK MAX n Take a sweep and wait for the sweep completion TakeSweep Read the marker amplitude this is the fundamental amplitude...

Page 148: ...requency of the next harmonic viPrintf viESA SENS FREQ CENT UP n Take a sweep and wait for the sweep completion TakeSweep Perform a peak search and wait for completion viPrintf viESA CALC MARK MAX OPC n viScanf viESA d lOpc dFundamental dMarkerFreq Change the center frequency step size equal to the marker frequency viPrintf viESA CALC MARK SET STEP n Measure each harmonic amplitude as follows for ...

Page 149: ...er amplitude in volts viPrintf viESA UNIT POW V n Take a sweep and wait for the sweep completion TakeSweep Query and read the marker amplitude in volts Store the result in the fHarmV array viQueryf viESA CALC MARK Y n 1f fHarmV lNum Change the amplitude units to dBm viPrintf viESA UNIT POW DBM n Take a sweep and wait for the sweep completion TakeSweep Read the marker amplitude viQueryf viESA CALC ...

Page 150: ...ort sqrt double dSumSquare dFundaAmptdV 100 Fundamental amplitude in dBm printf Fundamental Amplitude lf dB n fFundaAmptdDbm Fundamental Frequency in MHz printf Fundamental Frequency is lf MHz n dFundamental 10e5 Relative amplitude of each harmonic in dBc for lNum 2 lNum lMaxHarmonic lNum printf Relative amplitude of Harmonic d lf dBc n lNum fRelAmptd lNum Total harmonic distortion in percent prin...

Page 151: ...4 1 4 Programming Command Cross References ...

Page 152: ...tem are documented in Chapter 5 Language Reference in this guide Function Category SCPI Subsection or Subsystem ALIGNMENT CAL TST CALibration STATus QUEStionable ATTENUATOR see function category Internal Attenuation and Source BANDWIDTH CALCulate FETCh INITiate MEASure READ SENSe BANDwidth SENSe EBWidth SENSe OBWidth CONFIGURATION and STATUS RCL register SRE integer STB SYSTem CONTROL ABORt CORREC...

Page 153: ...SENSe POWer SENSe SWEep STATus QUEStionable UNIT INTERNAL ATTENUATION and SOURCE OUTPut SENSe POWer SOURce LIMIT LINES CALCulate CALCulate LLINe MMEMory MARKER CALCulate MARKer MEASURE CONFigure FETCh INITiate MEASure READ SENSe ACPower SENSe AVERage SENSe CHPower SENSe EBWidth SENSe HARMonics SENSe OBWidth SENSe POWer SENSe SWEep PRESET RST STATus SYSTem PRINTING HCOPy SOURCE see function categor...

Page 154: ...ENCY SPAN SPEAKER SYSTem SWEEP SENSe HARMonics SENSe SWEep SOURce SYNCHRONIZATION OPC WAI SYSTem SYSTEM INFORMATION CLS ESE number IDN ESR LRN STATus STATus QUEStionable SYSTem TRACE DISPlay FORMat SENSe EBWidth TRACe TRACE MATH CALCulate NTData DISPlay TRACe TRIGGER TRG ABORt INITiate TRIGger Function Category SCPI Subsection or Subsystem ...

Page 155: ...5 1 5 Language Reference This chapter contains SCPI Standard Commands for Programmable Instruments programming commands for the HP ESA spectrum analyzers ...

Page 156: ...PI commands are listed NOTE Refer to Chapter 2 Status Registers and the status messages in Chapter 7 Error Messages which supplements the information presented in this chapter In addition refer to Chapter 6 Front Panel Key Reference in the HP ESA Spectrum Analyzers User s Guide for additional information about the operation of each analyzer function Use the analyzer HELP key to obtain similar info...

Page 157: ...ference TRIGger UNIT Refer to Chapter 6 HP 8590 HP ESA Spectrum Analyzers Programming Conversion Guide for specific backwards compatibility information between commands for HP 8590 Series spectrum analyzers and HP ESA analyzers ...

Page 158: ...pt for the models indicated that do not require the cable the alignment will fail if the cable is not connected Front Panel Access System Alignments Align All Now Clear Status CLS Clears the status byte It does this by emptying the error queue and clearing all bits in all of the event registers The status byte registers summarize the states of the other registers It is also responsible for generat...

Page 159: ...d E4401B US00000013 A 00 00 Front Panel Access System Show System Instrument State Query LRN Returns current instrument state data in a block of defined length The information is in a machine readable format only Sending the query returns the following format SYST SET NMMM state_data The following example is a response to LRN The actual sizes will vary depending on the instrument state data size E...

Page 160: ...ion is provided in the ESA SCPI language reference in the SYSTem subsystem under SYSTem OPTions Recall RCL register This command recalls the instrument state from the specified instrument memory register Range registers are an integer 2 to 30 Remarks See also commands MMEMory LOAD STATe and MMEMory STORe STATe Front Panel Access File Recall State Reset RST This command presets the instrument to a ...

Page 161: ... service request enable register The query returns the value of the register Range Integer 0 to 255 Read Status Byte Query STB Returns the value of the status byte register without erasing its contents Remarks See CLS Trigger TRG This command triggers the instrument Use the TRIGger SEQuence SOURce command to select the trigger source Remarks See also the INITiate IMMediate command Self Test Query ...

Page 162: ...uage Reference IEEE Common Commands Wait to Continue WAI This command causes the instrument to wait until all pending commands are completed before executing any additional commands There is no query form to the command ...

Page 163: ...o any of the measurements found in the MEASURE menu If INITiate CONTinuous is off single measure then INITiate IMMediate will start a new single measurement If INITiate CONTinuous is on continuous measure a new continuous measurement begins immediately The INITiate and TRIGger subsystems contain additional related commands Front Panel Access Restart for continuous measurement mode ...

Page 164: ...TATe must be ON NOTE To query the result of NdBpoints use the command CALCulate BWIDth BANDwidth RESult Factory Preset and RST 3 dB Range 80 dB to 1 dB Default Unit dB Remarks Refer to CALCulate BWIDth BANDwidth STATe for an explanation of this marker function Front Panel Access Search N dB Points NdBresults CALCulate BWIDth BANDwidth RESult Returns the measured bandwidth at the power level define...

Page 165: ... when this function is turned on all other concurrent marker functions are suspended Front Panel Access Search N dB Points On Off Test Current Trace Data Against all Limit Lines CALCulate CLIMits FAIL Queries the status of the limit line testing Returns a 0 if the trace data passes when compared with all the current limit lines Returns a 1 if the trace data fails any limit line test CALCulate LLIN...

Page 166: ...r relative values In fixed the limit line amplitude values are specified in absolute amplitude and do not depend on the reference level In relative the limit line amplitude values are relative to the current reference level For Fixed Frequency Parameters The frequency values in a limit line table are fixed values and the limit line is positioned accordingly Fixed limit lines are specified in absol...

Page 167: ...lyzer display with respect to the sweep time setting of the analyzer with 0 at the left edge of the display For FREQuency segments are placed according to the frequency that is specified for each segment Front Panel Access Display Limits Properties X Axis Units Freq Time Control Limit Line Frequency Interpolation CALCulate LLINe 1 2 CONTrol INTerpolate TYPE LOGarithmic LINear CALCulate LLINe 1 2 C...

Page 168: ...nected to the previously defined point to define the limit line A 0 means that it is a point of discontinuity and is not connected to the preceding point The connected value is ignored for the first point Example CALC LLIN1 DATA 1000000000 20 0 200000000 30 1 Range x axis 30 Gs to 30 Gs for time limits fx axis 30 GHz to 30 GHz for frequency limits ampl 120 dBm to 100 dBm connected 0 or 1 Remarks I...

Page 169: ...to merge limit line data Up to two amplitude values are allowed for each x value If too much data is merged as many points as possible are merged into the existing limit and then an error is reported Up to 200 points total may be defined for each limit x axis can be frequency or time values as specified by CALCulate LIMit CONTrol DOMain Frequencies are always in Hz Time is always in seconds No uni...

Page 170: ... RST Off Front Panel Access Display Limits Modify Limit On Off Test the Data Against the Limit Line CALCulate LLINe 1 2 FAIL Queries the status of the limit line testing Returns a 0 if the data passes and returns a 1 if there is a failure This query only makes sense if margin or limit display is On Front Panel Access Display Limits Modify Test On Off Set the Margin Size CALCulate LLINe 1 2 MARGin ...

Page 171: ...of limit lines and CALCulate LLINe 1 2 MARGin STATe to turn on the display of margins If margin and limit display are both turned off limit test is automatically turned off Factory Preset and RST Off Front Panel Access Display Limits Modify Limit On Off Select the Type of Limit Line CALCulate LLINe 1 2 TYPE UPPer LOWer CALCulate LLINe 1 2 TYPE Sets a limit line to be either an upper or lower type ...

Page 172: ...Access Search Continuous Pk On Off Frequency Counter Marker Resolution CALCulate MARKer FCOunt RESolution real CALCulate MARKer FCOunt RESolution Sets the resolution of the marker frequency counter AUTO ON couples the marker counter resolution to the frequency span Factory Preset and RST 1 kHz Range 1 Hz to 100 kHz Default Unit Hz Front Panel Access Freq Count Resolution Auto Man Frequency Counter...

Page 173: ...MARKer 1 2 3 4 FUNCtion Selects the marker function for the specified marker To query the value returned by the function use CALCulate MARKer 1 2 3 4 Y BPOWer is the power integrated within the bandwidth NOISe is a noise measurement OFF turns off all functions Remarks When a measurement under the front panel MEASURE key is started this command is turned off If this command is turned on when any of...

Page 174: ...be placed at the highest peak that rises and falls by at least the peak excursion above the peak threshold If no peak meets the excursion and threshold criteria a No Peak Found error 202 is given Front Panel Access Search Next Peak Marker Peak Maximum Right Search CALCulate MARKer 1 2 3 4 MAXimum RIGHt Places the selected marker on the next highest signal peak to the right of the current marked pe...

Page 175: ...independently positioned on the trace The marker readout shows the difference between the two markers Span activates a pair of span markers where the marker positioning is controlled by changing the span and or center frequency between the two markers The marker readout shows the difference between the two markers Front Panel Access Marker Normal Marker Delta Marker Band Pair Start Stop Marker Spa...

Page 176: ...peak threshold If no peak meets the excursion and threshold criteria a No Peak Found error error 202 is issued Next peak next peak right next peak left and peak table are not affected by this command They will always use peak excursion and peak threshold for search criteria Front Panel Access Search Search Param Peak Search Max Define Peak Threshold CALCulate MARKer PEAK THReshold ampl CALCulate M...

Page 177: ...te MARKer 1 2 3 4 SET RLEVel Sets the reference level to the specified marker amplitude In delta marker mode the reference level is set to the amplitude difference between the markers Front Panel Access Marker Mkr Ref Lvl Search Meas Tools Mkr Ref Lvl Set Span to the Marker Value CALCulate MARKer 1 2 3 4 SET SPAN Sets the span to the value of the specified marker frequency The specified marker mus...

Page 178: ...f or in zero span Front Panel Access Marker Mkr CF Step Marker Delta Marker Mkr CF Step Search Meas Tools Mkr CF Set Stop Frequency to the Marker Value CALCulate MARKer 1 2 3 4 SET STOP Sets the stop frequency to the value of the active marker frequency In delta marker mode the stop frequency is set to the marker delta value This command is not available in zero span Front Panel Access Marker Mkr ...

Page 179: ...ccess Marker Marker Trace Auto 1 2 3 Continuous Signal Tracking Function CALCulate MARKer 1 2 3 4 TRCKing STATe OFF ON 0 1 CALCulate MARKer 1 2 3 4 TRCKing STATe Turns on or off marker signal tracking It continuously puts the selected marker on the highest displayed signal peak and moves it to the center frequency This allows you to keep a signal that is drifting in frequency on the display Factor...

Page 180: ...r Position the center frequency of the designated span type marker pair at the specified trace X value The value is in the X axis units which is often frequency or time Use CALCulate MARKer MODE SPAN to select span markers The query returns the current X value center frequency of the designated markers Range Matches the units of the trace on which the markers are positioned Front Panel Access Mark...

Page 181: ...he designated span type marker pair to position the markers at the desired trace X positions A trace is composed of 401 points X positions Use CALCulate MARKer MODE SPAN to select span markers The query returns the current X position frequency span of the designated markers Range 0 to 400 Default Unit X axis units Hz or seconds Front Panel Access Marker active marker Span Band Markers Start Freque...

Page 182: ...ion stop frequency of the designated marker Range 0 to 400 Default Unit X axis units Hz or seconds Front Panel Access Marker active marker Stop Marker X Axis Readout CALCulate MARKer 1 2 3 4 X READout FREQuency TIME ITIMe PERiod CALCulate MARKer 1 2 3 4 X READout Selects the units for the x axis readout of the marker Available units are Frequency Time Inverse of time Period Factory Preset and RST ...

Page 183: ...lue is in the X axis units which is often frequency or time Use CALCulate MARKer MODE BAND to select band markers The query returns the current X value start reference frequency of the designated marker Default Unit Matches the units of the trace on which the markers are positioned Front Panel Access Marker active marker Start Band Markers Stop Frequency X Value CALCulate MARKer 1 2 3 4 X STOP par...

Page 184: ...positioned Remarks This command can be used to read the results of marker functions such as band power and noise that are displayed in the marker value field on the analyzer CALCulate NTData Subsection Normalize the Trace Data CALCulate NTData STATe OFF ON 0 1 CALCulate NTData STATe One sweep of trace data is copied to trace NRML which is used as the reference trace Then for all subsequent trace s...

Page 185: ... Except for the models indicated that do not require the cable the alignment will fail if the cable is not connected Front Panel Access System Alignments Align Now All Set Auto RF Align On or Off CALibration AUTO MODE ALL NRF CALibration AUTO MODE This command determines whether or not to include RF alignment as part of the automatic alignment routines NOTE Before executing this command connect a ...

Page 186: ...Off System Alignments Auto Align All but RF Return to the Default Alignment Data CALibration DATA DEFault Initializes the alignment data to the factory defaults Front Panel Access System Alignments Load Defaults Align FM Demodulation CALibration FMDemod CALibration FMDemod Performs an alignment of the FM Demodulation board if Option BAA FM Demodulation is installed The query form of this command p...

Page 187: ...ation ALL is required after COARse is set Range Integer 0 to 255 Front Panel Access System Alignments Time Base Coarse Fine Adjust the Frequency Reference CALibration FREQuency REFerence FINE setting CALibration FREQuency REFerence FINE Allows fine adjustment of the analyzer internal 10 MHz reference oscillator timebase NOTE CALibration ALL is required after FINE is set Range Integer 0 to 255 Fron...

Page 188: ...ndicated that do not require the cable the alignment will fail if the cable is not connected Front Panel Access System Alignments Align Now RF Select the Source State for Calibration CALibration SOURce STATe OFF ON 0 1 CALibration SOURce STATe Controls the state of the 50 MHz alignment signal NOTE The alignment signal is internally switched to the INPUT for HP models E4401B and E4411B For all othe...

Page 189: ...nd returns a zero if the alignment is successful NOTE Before executing this command connect a cable between rear panel connector AMPTD REF OUT to the front panel INPUT connector for all HP ESA spectrum analyzers except HP models E4401B and E4411B Except for the models indicated that do not require the cable the alignment will fail if the cable is not connected Front Panel Access System Alignments ...

Page 190: ...state The query CONFigure returns the current measurement name in quotes Configure the Channel Power Measurements CONFigure ACPower Configure the Channel Power and Density Measurements CONFigure CHPower Configure the Emission Bandwidth Measurements CONFigure EBWidth Set Number of Measured Harmonics CONFigure HARMonics number Set the number of harmonics to be measured Factory Preset and RST 10 Rang...

Page 191: ...mmand is used to override the coupling for special measurement needs Factory Preset and RST All Remarks The following list of analyzer functions can either be automatically coupled or not coupled manually set Residual bandwidth Video bandwidth Sweep time Center frequency step Attenuation Marker count resolution Source attenuation mode Source amplitude step COUPle NONE causes these functions into t...

Page 192: ...er 1 to 7 Front Panel Access viewing angle keys Date and Time Display Format DISPlay ANNotation CLOCk DATE FORMat MDY DMY DISPlay ANNotation CLOCk DATE FORMat Allows you to set the format for displaying the real time clock To set the date time use SYSTem DATE year month day Factory Preset and RST The factory default is MDY This parameter is persistent which means that it retains the setting previo...

Page 193: ...itle Display Title Clear Title Turn the Entire Display On Off DISPlay ENABle OFF ON 0 1 Turns the display on or off Having the display turned off may increase remote interface speed Factory Preset and RST On Remarks The following key presses will turn display enable back on 1 If in local press any key 2 If in remote press the local system key 3 If in local lockout no key Front Panel Access none Wi...

Page 194: ...set for all frequency readouts such as center frequency except that it does not affect marker count Factory Preset and RST 0 Hz Range 3 GHz to 500 GHz Default Unit Hz Front Panel Access FREQUENCY Channel Freq Offset Set the Display Line DISPlay WINDow TRACe Y DLINe ampl DISPlay WINDow TRACe Y DLINe Defines the level of the display line in the active amplitude units if no units are specified Factor...

Page 195: ...ference level NOTE See command CALCulate NTData STATe OFF ON 0 1 Factory Preset and RST 0 dB Range 327 6 to 327 6 dB Default Unit Current active units Front Panel Access View Trace Normalize Norm Ref Lvl Normalized Reference Level Position DISPlay WINDow TRACe Y SCALe NRPosition rel_ampl DISPlay WINDow TRACe Y SCALe NRPosition Selects the position of the normalized reference level The top and bott...

Page 196: ...EVel Sets the amplitude value of the reference level for the y axis Factory Preset and RST 0 dBm Range 149 9 to 50 dBm with zero reference level offset Default Unit current active units Remarks The input attenuator setting may be affected The minimum displayed value of reference level is 327 6 and the maximum displayed value is 327 6 Front Panel Access Amplitude Y Scale Ref Level Trace Y Axis Refe...

Page 197: ...erence level offset depend on the current reference level Front Panel Access Amplitude Y Scale Ref Level Offst Vertical Axis Scaling DISPlay WINDow TRACe Y SCALe SPACing LINear LOGarithmic DISPlay WINDow TRACe Y SCALe SPACing Specifies the vertical graticule divisions as log or linear units Factory Preset and RST Logarithmic Front Panel Access AMPLITUDE Y Scale Scale Type Log Lin ...

Page 198: ...he following states idle initiated paused Return Main Lower and Upper Channel Power FETCh ACPower This command returns scalar results of main channel power lower channel power relative and upper channel power relative Remarks The main channel power is returned in the current amplitude units and the lower and upper channel results are always returned in dB The results are returned in a comma separa...

Page 199: ...tude units Hz The results are returned in a comma separated list Return Channel Power FETCh CHPower CHPower This command returns the value of the channel power in amplitude units Front Panel Access MEASURE Channel Power Return Channel Power Density FETCh CHPower DENSity This command returns the value of the channel power density in amplitude units Hz Return Emission Bandwidth FETCh EBWidth This co...

Page 200: ...he harmonic amplitude precision for SCPI and the display is two decimal places Front Panel Access MEASURE Harmonic Dist Return Harmonic N Amplitude FETCh HARMonics AMPLitude n Returns the amplitude of harmonic number n measured in dBc from the fundamental or in dBm if n 1 Range 180 dBm to 70 dBm Default Unit dBc from fundamental dBm n 1 Remarks The harmonic amplitude precision for SCPI and the dis...

Page 201: ...precision for SCPI and the display is four significant digits Front Panel Access MEASURE Harmonic Dist Return OBW and Transmit Frequency Error FETCh OBWidth This command returns scalar results of occupied bandwidth and transmit frequency error Remarks The results for both values are returned in Hz and in a comma separated list Return Occupied Bandwidth FETCh OBWidth OBWidth This command returns th...

Page 202: ...he right in the sequence 1 2 3 4 Swapped mode is when the bit sequence begins with the LSB on the left and ends with the MSB on the right in the sequence 4 3 2 1 Factory Preset and RST Normal Numeric Data format FORMat TRACe DATA ASCii INTeger 32 REAL 32 REAL 64 FORMat TRACe DATA Changes the format of the data input and output This command affects only the data format for setting and querying trac...

Page 203: ...ubsystem ASCii Amplitude values are in ASCII in amplitude units separated by commas INTeger 32 Binary 32 bit integer values in internal units mdBm REAL 32 or 64 Binary 32 bit or 64 bit real values in amplitude units Factory Preset and RST ASCii ...

Page 204: ... printer CUSTom allows you to select a custom printer if your printer cannot be auto configured NONE tells the instrument that the hardcopy output device is not a printer Factory Preset and RST The factory default is AUTO This parameter is persistent which means that it retains the setting previously selected even through a power cycle Front Panel Access Print Setup Printer Type Color Hard Copy HC...

Page 205: ...scape PORTrait HCOPy PAGE ORIentation Specifies the orientation of the print NOTE Landscape mode is not presently supported for PCL 3 printers Factory Preset and RST The factory default is Landscape This parameter is persistent which means that it retains the setting previously selected even through a power cycle Front Panel Access Print Setup Orientation Landscape Print Setup Orientation Portrait...

Page 206: ...Subsystem Factory Preset and RST The factory default is 1 This parameter is persistent which means that it retains the setting previously selected even through a power cycle Range Integer 1 or 2 Front Panel Access Print Setup Prints Page 1 2 ...

Page 207: ... immediately initiates another sweep cycle When OFF the sweep system remains in an idle state until CONTinuous is set to ON or an INITiate IMMediate command is received On receiving the INITiate IMMediate command it will go through a single sweep cycle and then return to the idle state The query returns 1 or 0 into the output buffer 1 is returned when there is continuous sweeping 0 is returned whe...

Page 208: ...o the TRG command Use the TRIGer SEQuence SOURce EXTernal command to select the external trigger The instrument must be in the single measurement mode If INIT CONT is ON then the command is ignored Use FETCh to transfer a measurement result from memory to the output buffer Refer to individual commands in the FETCh subsystem for more information Restart Measurement INITiate RESTart This command app...

Page 209: ...coupling is selected Factory Preset and RST AC Remarks This command is available only on HP ESA spectrum analyzer models E4404B or E4405B Front Panel Access Input Coupling AC DC Clear the Input Overload INPut PROTection CLEar Resets the overload protection circuitry for the input connector There is no query form of this command NOTE This command is valid only for HP ESA models E4401B and E4411B Th...

Page 210: ...ettings set up the measurement with the CONFigure command Use the commands in the SENSe subsystem to change the settings Then use the READ command or the INITiate and FETCh commands to initiate the measurement and query the results Measure Main Lower and Upper Channel Power MEASure ACPower This command returns scalar results of main channel power lower channel power relative and upper channel powe...

Page 211: ...plitude units Hz The results are returned in a comma separated list Measure Channel Power MEASure CHPower CHPower This command returns the value of the channel power in amplitude units Front Panel Access MEASURE Channel Power Measure Channel Power Density MEASure CHPower DENSity This command returns the value of the channel power density in amplitude units Hz Measure Emission Bandwidth MEASure EBW...

Page 212: ...sured the value NaN is returned for any harmonic not measured The harmonic amplitude precision for SCPI and the display is two decimal places Front Panel Access MEASURE Harmonic Dist Return Harmonic N Amplitude MEASure HARMonics AMPLitude n Returns the amplitude of harmonic number n measured in dBc from the fundamental or in dBm if n 1 Range 180 dBm to 70 dBm Default Unit dBc from fundamental dBm ...

Page 213: ...alyzer Default Unit Hz Remarks The harmonic frequency precision for SCPI and the display is four significant digits Front Panel Access MEASURE Harmonic Dist Measure OBW and Transmit Frequency Error MEASure OBWidth This command returns scalar results of occupied bandwidth and transmit frequency error Remarks The results for both values are returned in Hz and in a comma separated list Measure Occupi...

Page 214: ... and numbers 0 9 only lower case letters are read as uppercase ext is an optional file extension using the same rules as name but consists of up to three characters total Catalog the Selected Memory Location MMEMory CATalog drive where drive is A or C Lists all files in the specified drive The return data will be of the format mem_used mem_free file_listing Each file listing indicates the name and...

Page 215: ...MEM DATA C source txt 14abcd Front Panel Access none Delete a File MMEMory DELete file_name Delete a file Example MMEM DEL C source txt Front Panel Access File File Manager Delete Load a Corrections Table from a File MMEMory LOAD CORRection ANTenna CABLe OTHer USER file_name Loads the data in the file file_name to the specified correction set 1 Example MMEM LOAD CORR ANT A TEST5 CBL Front Panel Ac...

Page 216: ...s state are loaded The csv extension is for trace files using the CSV comma separated values format The trc extension is for files that include both trace and state data Example MMEM LOAD TRAC TRACE2 C mytrace trc Range Trace labels are TRACE1 TRACE2 TRACE3 Store a Corrections Table to a File MMEMory STORe CORRection ANTenna CABLe OTHer USER file_name Stores the specified correction set to the fil...

Page 217: ...file_name Saves the instrument state to the file in memory Example MMEM STOR STATE 1 C mystate sta Remarks This command will fail if the file_name already exists Store a Trace in a File MMEMory STORe TRACe label file_name Saves the specified trace to a file in memory The file name must have a file extension of trc or csv The file extension determines whether a trace is stored or a trace with its s...

Page 218: ...characteristics of the tracking generator output port Commands for controlling the tracking generator output are found under SOURce POWer Turn Output On Off OUTPut STATe OFF ON 0 1 OUTPut STATe Controls the tracking generator output Factory Preset and RST Off Front Panel Access Source Amplitude On Off ...

Page 219: ...ults Measure Main Lower and Upper Channel Power READ ACPower This command returns scalar results of main channel power lower channel power relative and upper channel power relative Remarks The main channel power is returned in the current amplitude units and the lower and upper channel results are always returned in dB The results are returned in a comma separated list Measure Main Channel Power R...

Page 220: ... channel power in amplitude units Front Panel Access MEASURE Channel Power Measure Channel Power Density READ CHPower DENSity This command returns the value of the channel power density in amplitude units Hz Measure Emission Bandwidth READ EBWidth This command returns the value of emission bandwidth in Hz Front Panel Access MEASURE Emission BW Return Total Harmonic Distortion READ HARMonics DISTor...

Page 221: ...onic N Amplitude READ HARMonics AMPLitude n Returns the amplitude of harmonic number n measured in dBc from the fundamental or in dBm if n 1 Range 180 dBm to 70 dBm Default Unit dBc from fundamental dBm n 1 Remarks The harmonic amplitude precision for SCPI and the display is two decimal places Front Panel Access MEASURE Harmonic Dist Return Harmonic Frequency List READ HARMonics FREQuency ALL Retu...

Page 222: ...Front Panel Access MEASURE Harmonic Dist Measure OBW and Transmit Frequency Error READ OBWidth This command returns scalar results of occupied bandwidth and transmit frequency error Remarks The results for both values are returned in Hz and in a comma separated list Measure Occupied Bandwidth READ OBWidth OBWidth This command returns the value of occupied bandwidth in Hz Front Panel Access MEASURE...

Page 223: ...ements in the MEASURE and Meas Setup menus may only be used to set parameters of a specific measurement when the measurement is active Otherwise an error will occur You must first select the appropriate measurement using the CONFigure measurement command If a SENSe command is used to change a parameter during a measurement while not in its idle state the measurement will be restarted ...

Page 224: ...power measurement averaging Factory Preset and RST Off Remarks This command is used for measurements in the MEASURE menu Front Panel Access Meas Setup Avg Number On Off Set Adjacent Channel Bandwidth SENSe ACPower BANDwidth BWIDth ACHannel freq Set the adjacent channel bandwidth Default Unit Hz Remarks This command is used for measurements in the MEASURE menu Front Panel Access Meas Setup Adj Chan...

Page 225: ...ference SENSe Subsystem Set Adjacent Channel Spacing SENSe ACPower CSPacing freq Set the adjacent channel spacing Remarks This command is used for measurements in the MEASURE menu Front Panel Access Meas Setup Main Chan Spacing ...

Page 226: ... The value of successive measurements can be combined together to average out measurement variations Factory Preset and RST Off Remarks When a measurement under the front panel MEASURE key is started this command is turned off for video averaging SENSe AVERage TYPE LPOWer If this command is turned on for video averaging when any of the MEASURE key measurements are in progress that measurement will...

Page 227: ...s are dBm This command is equivalent to pressing front panel keys BW Avg Average Type Video POWer averages the linear power of successive measurements typical units are watts Factory Preset and RST LPOWer Front Panel Access BW Avg Average Type Video Power ...

Page 228: ...c SENSe BANDwidth BWIDth RESolution AUTO OFF ON 0 1 SENSe BANDwidth BWIDth RESolution AUTO Couples the resolution bandwidth to the frequency span Factory Preset and RST On Video Bandwidth SENSe BANDwidth BWIDth VIDeo freq SENSe BANDwidth BWIDth VIDeo Specifies the video bandwidth Factory Preset and RST 3 MHz Range 1 Hz to 3 MHz This range is dependent upon the setting of SENSe BANDwidth BWIDth RES...

Page 229: ...W Avg Video BW Auto Man Video to Resolution Bandwidth Ratio SENSe BANDwidth BWIDth VIDeo RATio number SENSe BANDwidth BWIDth VIDeo RATio Specifies the ratio of the video bandwidth to the resolution bandwidth Factory Preset and RST 1 0 Range 0 00001 to 3 0e6 Front Panel Access BW Avg VBW RBW Ratio ...

Page 230: ...ory Preset and RST Off Remarks This command is used for measurements in the MEASURE menu Front Panel Access Meas Setup Avg Number On Off Set Channel Power Integration Bandwidth SENSe CHPower BANDwidth BWIDth INTegration freq Set the frequency span bandwidth over which to integrate power Remarks This command is used for measurements in the MEASURE menu Front Panel Access Meas Setup Integration BW S...

Page 231: ...Set Amplitude Correction Data SENSe CORRection CSET 1 2 3 4 DATA freq rel_ampl freq rel_ampl SENSe CORRection CSET 1 2 3 4 DATA Sets the amplitude correction data These frequency amplitude corrections will be applied to the displayed data to correct for system losses gains outside the analyzer Four different sets of correction data can be stored Example CORR CSET1 DATA 900E6 0 3 1 0E9 0 35 1 3E9 0...

Page 232: ...llowing you to merge correction data If too much data is merged as many points as possible are merged into the existing data and then an error is reported freq is the frequency in Hz where the correction should be applied no unit is allowed in this parameter rel_ampl is the amount of relative amplitude correction in dB needed no unit is allowed in this parameter Remarks CSET number equivalents to ...

Page 233: ...n CSET ALL STATe must be on for this command to function Factory Preset and RST Off Remarks CSET number equivalents to front panel access definitions are as follows CSET1 is Antenna CSET2 is Cable CSET3 is Other CSET4 is User Front Panel Access AMPLITUDE Y Scale Corrections Modify Correction On Off Input Impedance Correction SENSe CORRection IMPedance INPut MAGNitude number SENSe CORRection IMPeda...

Page 234: ... OFFSet MAGNitude rel_ampl SENSe CORRection OFFSet MAGNitude A single value of amplitude correction can be applied to the displayed trace data to compensate for signal losses or gains that are due to other devices in the measurement setup rather than the unit under test Factory Preset and RST 0 dB Range 81 9 to 81 9 Default Unit dB Front Panel Access AMPLITUDE Y Scale Ext Amp Gain ...

Page 235: ...eq SENSe DEMod FMDeviation Sets the total FM frequency deviation for full screen demodulation Factory Preset and RST 100 kHz Range 5 kHz to 1 2 MHz Default Unit Hz Front Panel Access Det Demod Demod FM Deviation Demodulation Control SENSe DEMod STATe OFF ON 0 1 SENSe DEMod STATe Turns demodulation on or off Factory Preset and RST Off Front Panel Access Det Demod Demod Off Demod Time SENSe DEMod TI...

Page 236: ...5 82 Chapter5 Language Reference SENSe Subsystem Factory Preset and RST 500 ms Range 2 ms to 100 s Default Unit seconds Front Panel Access Det Demod Demod Demod Time ...

Page 237: ... detection displays the lowest sample taken during the interval being displayed Positive peak detection displays the highest sample taken during the interval being displayed Sample detection displays the first sample taken during the interval being displayed Factory Preset and RST Positive Front Panel Access Det Demod Detector Det Demod Detector Peak Det Demod Detector Sample Det Demod Detector Ne...

Page 238: ...surements in the MEASURE menu Front Panel Access Meas Setup Avg Number On Off Set Emission BW Span SENSe EBWidth FREQuency SPAN freq Set the emission bandwidth span The analyzer span will retain this value throughout the measurement Remarks This command is used for measurements in the MEASURE menu Front Panel Access Meas Setup EBW Span Emission BW Trace Max Hold On Off SENSe EBWidth MAXHold OFF ON...

Page 239: ... SENSe EBWidth XDB rel_ampl This commands allows you to set the dB value X dB below the maximum value on the signal at which to measure the emission bandwidth Range Only negative values are allowed Default Unit dB Remarks This command is used for measurements in the MEASURE menu Front Panel Access Meas Setup Emiss BW X dB ...

Page 240: ...P ESA E4404B 80 MHz to 6 78 GHz HP ESA E4405B 80 MHz to 13 3 GHz HP ESA E4407B E4408B 80 MHz to 27 0 GHz Default Unit Hz Front Panel Access FREQUENCY Channel Center Freq Center Frequency Step Size Automatic SENSe FREQuency CENTer STEP AUTO OFF ON 0 1 SENSe FREQuency CENTer STEP AUTO Specifies whether the step size is set automatically based on the span Factory Preset and RST On Front Panel Access ...

Page 241: ... channel frequency Remarks This command is used for measurements in the MEASURE menu Frequency Span SENSe FREQuency SPAN freq SENSe FREQuency SPAN Set the frequency span Setting the span to 0 Hz puts the analyzer into zero span Factory Preset and RST HP ESA E4401B E4411B 1 5 GHz HP ESA E4402B E4403B 3 0 GHz HP ESA E4404B 6 7 GHz HP ESA E4405B 13 2 GHz HP ESA E4407B E4408B 26 5 GHz Range HP ESA E44...

Page 242: ... Scale Full Span Previous Frequency Span SENSe FREQuency SPAN PREVious Set the frequency span to the previous span setting Front Panel Access SPAN X Scale Last Span Start Frequency SENSe FREQuency STARt freq SENSe FREQuency STARt Set the start frequency Factory Preset and RST 0 Hz Range HP ESA E4401B E4411B 80 MHz to 1 58 GHz HP ESA E4402B E4403B 80 MHz to 3 10 GHz HP ESA E4404B 80 MHz to 6 78 GHz...

Page 243: ...E4411B 1 5 GHz HP ESA E4402B E4403B 3 0 GHz HP ESA E4404B 6 7 GHz HP ESA E4405B 13 2 GHz HP ESA E4407B E4408B 26 5 GHz Range HP ESA E4401B E4411B 80 MHz to 1 58 GHz HP ESA E4402B E4403B 80 MHz to 3 10 GHz HP ESA E4404B 80 MHz to 6 78 GHz HP ESA E4405B 80 MHz to 13 3 GHz HP ESA E4407B E4408B 80 MHz to 27 0 GHz Default Unit Hz Front Panel Access FREQUENCY Channel Stop Freq ...

Page 244: ...cess MEASURE Harmonic Dist Meas Setup Avg Number On Turn On or Off Harmonic Measurement Averaging SENSe HARMonics AVERage STATe OFF ON 0 1 SENSe HARMonics AVERage STATe Turn on or off harmonic measurement averaging Factory Preset and RST Off Front Panel Access MEASURE Harmonic Dist Meas Setup Avg Number Set Harmonic Measurement Sweep Mode SENSe HARMonics SWEeptime STATe AUTO MAN 1 0 SENSe HARMonic...

Page 245: ... will be the sweep time set before the measurement began Front Panel Access MEASURE Harmonic Dist Meas Setup ST Harmonic Turn On or Off Fundamental Zoom SENSe HARMonics ZOOM OFF ON 0 1 SENSe HARMonics ZOOM Turn on or off the fundamental signal zoom before the frequency count occurs Factory Preset and RST On Remarks When counter zoom is On the measurement will zoom in on the fundamental after the o...

Page 246: ...e maximum frequency range of the analyzer Remarks This command sets the number of harmonics to measure before computing the total harmonic distortion The minimum number is two the fundamental and the second harmonic Front Panel Access MEASURE Harmonic Dist Meas Setup Harmonics ...

Page 247: ...Factory Preset and RST Off Remarks This command is used for measurements in the MEASURE menu Front Panel Access Meas Setup Avg Number On Off Set OBW Span SENSe OBWidth FREQuency SPAN freq Set the occupied bandwidth span The analyzer span will retain this value throughout the measurement Remarks This command is used for measurements in the MEASURE menu Front Panel Access Meas Setup OBW Span Set OBW...

Page 248: ... E4408B 0 to 65dB Default Unit dB Front Panel Access AMPLITUDE Y Scale Attenuation Auto Man Input Port Attenuator Auto SENSe POWer RF ATTenuation AUTO OFF ON 0 1 SENSe POWer RF ATTenuation AUTO Select the input port attenuator range to be set either automatically or manually On Input attenuation is automatically set as determined by the Reference Level Setting Off Input attenuation is manually set...

Page 249: ...10 dBm Default Unit dBm Front Panel Access AMPLITUDE Y Scale Max Mixer Lvl Optimize Preselector Frequency SENSe POWer RF PADJust freq SENSe POWer RF PADJust This command allows user defined adjustment of the preselector frequency to optimize its response on the signal of interest Factory Preset and RST 0 Hz Range 250 MHz to 250 MHz Default Unit Hz Remarks This command is available only on HP ESA m...

Page 250: ...cy of the signal at the specified marker Maximum signal amplitude occurs by minimizing the loss through the filter NOTE This command is available only on HP ESA models E4404B E4405B E4407B and E4408B Range 3 GHz to the maximum frequency of the analyzer Remarks A peak search will be done if no marker is on Front Panel Access AMPLITUDE Y Scale Presel Center ...

Page 251: ...tion AYX fast digitized time domain sweeps 20 µs to 2000 seconds with Option AYX in zero span only Default Unit seconds Front Panel Access Sweep Sweep Time Auto Man Automatic Sweep Time SENSe SWEep TIME AUTO OFF ON 0 1 SENSe SWEep TIME AUTO Automatically selects the fastest sweep time for the current settings Factory Preset and RST On Front Panel Access Sweep Sweep Time Auto Man Sweep Time Mode SE...

Page 252: ...Se SWEep TIME GATE LENGth Specifies the gate time length in seconds For EDGE triggering only Factory Preset and RST 1 µs Range 0 3 µs to 429 seconds Default Unit seconds Front Panel Access Sweep Gate Setup Edge Setup Gate Length Time Gate Level SENSe SWEep TIME GATE LEVel HIGH LOW SENSe SWEep TIME GATE LEVel Selects the level of the gate signal This command is for LEVel triggering only Factory Pre...

Page 253: ...igh Control Time Gate SENSe SWEep TIME GATE STATe OFF ON 0 1 SENSe SWEep TIME GATE STATe Turns time gating on or off NOTE Time gate cannot be turned on if external trigger delay is on Factory Preset and RST Off Front Panel Access Sweep Gate On Off Time Gate Trigger Type SENSe SWEep TIME GATE TYPE LEVel EDGE SENSe SWEep TIME GATE TYPE Selects between edge and level mode for time gated spectrum anal...

Page 254: ...5 100 Chapter5 Language Reference SENSe Subsystem Factory Preset and RST Edge Front Panel Access Sweep Gate Setup Trig Type Edge Level ...

Page 255: ...he power out of the source it only changes the display so that it reads out the actual power delivered to the device under test Factory Preset and RST 0 dBm Range 327 6 dBm to 327 6 dBm Default Unit Currently selected source power units Front Panel Access Source Amptd Offset Source Attenuation SOURce POWer ATTenuation ampl SOURce POWer ATTenuation Attenuates the source output level Factory Preset ...

Page 256: ...OURce POWer LEVel IMMediate AMPLitude Specifies the source output power level Use SOURce POWer SWEep to set the change in power level across the sweep See also SOURce POWer STARt Factory Preset and RST 10 dBm Range HP ESA E4401B E4411B 70 dBm to 3 dBm HP ESA E4402B E4403B 66 dBm to 3 dBm HP ESA E4404B 66 dBm to 3 dBm HP ESA E4405B 66 dBm to 3 dBm HP ESA E4407B E4408B 66 dBm to 3 dBm Default Unit d...

Page 257: ...t and RST 0 dBm Range 0 dBm to 20 dBm Default Unit dBm Front Panel Access none Set the Output Power at the Start of the Sweep SOURce POWer STARt ampl SOURce POWer STARt Specifies the source output power level at the start of the power sweep Use SOURce POWer SPAN to set the change in power level across the sweep This command is equivalent to SOURce POWer LEVel IMMediate AMPLitude Set the Output Pow...

Page 258: ...er level at the start of the power sweep See also SOURce POWer SPAN Factory Preset and RST 0 dBm Range HP ESA E4401B E4411B 70 dBm to 3 dBm HP ESA E4402B E4403B 66 dBm to 3 dBm HP ESA E4404B 66 dBm to 3 dBm HP ESA E4405B 66 dBm to 3 dBm HP ESA E4407B E4408B 66 dBm to 3 dBm Default Unit dBm Front Panel Access Source Power Sweep On Off Output Power Tracking SOURce POWer TRCKing number SOURce POWer T...

Page 259: ...URce POWer TRCKing PEAK Automatically adjusts the tracking of the source output with the spectrum analyzer sweep so that the power is maximized for the present resolution bandwidth Factory Preset and RST none Remarks This command is not applicable for the 1 5 GHz tracking generator Front Panel Access Source Tracking Peak ...

Page 260: ...ts in the Operation Event register which also sets the Operation Status Summary bit bit 7 in the Status Byte Register The variable number is the sum of the decimal values of the bits you want to enable NOTE Preset sets all bits in this enable register to 0 To have any Operation Events reported to the Status Byte Register 1 or more bits must be set to 1 Factory Preset and RST 0 Range 0 to 32767 Ope...

Page 261: ...Ration PTRansition This command determines what bits in the Operation Condition register will set the corresponding bit in the Operation Event register when that bit has a positive transition 0 to 1 The variable number is the sum of the decimal values of the bits that you want to enable Factory Preset and RST 32767 all 1 s Range 0 to 32767 Preset the Status Byte STATus PRESet Sets bits in most of ...

Page 262: ...ster The variable number is the sum of the decimal values of the bits you want to enable Factory Preset and RST 32767 all 1 s Range 0 to 32767 Questionable Calibration Event Query STATus QUEStionable CALibration EVENt This query returns the decimal value of the sum of the bits in the Questionable Calibration Event register NOTE The register requires that the equivalent PTR or NTR filters be set be...

Page 263: ...ster NOTE The data in this register is continuously updated and reflects the current conditions Questionable Enable STATus QUEStionable ENABle number STATus QUEStionable ENABle This command determines what bits in the Questionable Condition Register will set bits in the Questionable Event register which also sets the Questionable Status Summary bit bit3 in the Status Byte Register The variable num...

Page 264: ...f the bits in the Questionable Frequency Condition register NOTE The data in this register is continuously updated and reflects the current conditions Questionable Frequency Enable STATus QUEStionable FREQuency ENABle number STATus QUEStionable FREQuency ENABle This command determines what bits in the Questionable Frequency Condition Register will set bits in the Questionable Frequency Event regis...

Page 265: ...of the decimal values of the bits that you want to enable Factory Preset and RST 0 Range 0 to 32767 Questionable Frequency Positive Transition STATus QUEStionable FREQuency PTRansition number STATus QUEStionable FREQuency PTRansition This command determines what bits in the Questionable Frequency Condition register will set the corresponding bit in the Questionable Frequency Event register when th...

Page 266: ... before a condition register bit can set a bit in the event register The data in this register is latched until it is queried Once queried the data is cleared Questionable Integrity Negative Transition STATus QUEStionable INTegrity NTRansition number STATus QUEStionable INTegrity NTRansition This command determines what bits in the Questionable Integrity Condition register will set the correspondi...

Page 267: ...want to enable Factory Preset and RST 0 Range 0 to 32767 Questionable Power Condition STATus QUEStionable POWer CONDition This query returns the decimal value of the sum of the bits in the Questionable Power Condition register NOTE The data in this register is continuously updated and reflects the current conditions Questionable Power Enable STATus QUEStionable POWer ENABle number STATus QUEStiona...

Page 268: ...it has a negative transition 1 to 0 The variable number is the sum of the decimal values of the bits that you want to enable Factory Preset and RST 0 Range 0 to 32767 Questionable Power Positive Transition STATus QUEStionable POWer PTRansition number STATus QUEStionable POWer PTRansition This command determines what bits in the Questionable Power Condition register will set the corresponding bit i...

Page 269: ...Chapter 5 5 115 Language Reference STATus Subsystem number is the sum of the decimal values of the bits that you want to enable Factory Preset and RST 32767 all 1 s Range 0 to 32767 ...

Page 270: ...power cycle Range Integer 0 to 30 Front Panel Access System Remote Port Serial Port DTR Setup SYSTem COMMunicate SERial 1 2 3 4 5 6 7 8 CONTrol DTR OFF ON IBFull SYSTem COMMunicate SERial 1 2 3 4 5 6 7 8 CONTrol DTR Sets the hardware pacing scheme It controls the number of bytes in the input buffer Off holds the DTR line in the unasserted off condition On holds the DTR line in the asserted on cond...

Page 271: ...ndicates that the RTS line should always be asserted On indicates that the RTS line should always be unasserted IBFull selects the input buffer full mode for the RTS line IBFull sets the RTS line to indicate when the device is ready to receive When the number of received bytes in the input buffer of the device reaches the stop threshold the device will unassert the RTS line When the number of byte...

Page 272: ...umbers 5 and 6 Card four uses port numbers 7 and 8 Factory Preset no RST The factory default is 9600 This parameter is persistent which means that it retains the setting previously selected even through a power cycle Range Supported baud rates are 110 300 600 1200 2400 4800 9600 19200 38400 57600 115200 Front Panel Access System Remote Port Serial Port Receive Pace Setup SYSTem COMMunicate SERial ...

Page 273: ... on or none for an instrument with the RS 232 interface installed If no optional serial port number is specified port 1 is assumed There can potentially be four I O cards installed 1 2 3 or 4 Each card may have up to two ports Card one uses port numbers 1 and 2 Card two uses port numbers 3 and 4 Card three uses port numbers 5 and 6 Card four uses port numbers 7 and 8 Factory Preset no RST The fact...

Page 274: ...ation about the configurations of the instrument Front Panel Access System Show System Display System Configuration SYSTem CONFigure SYSTem STATe OFF ON 0 1 SYSTem CONFigure SYSTem STATe Shows the current system configuration of the instrument on the display Factory Preset and RST Off Front Panel Access System Show System Set Date SYSTem DATE year month day SYSTem DATE Sets the date of the real ti...

Page 275: ...mber of seconds that have elapsed since the instrument was turned on for the very first time Remarks Front Panel Access none Power On Time SYSTem PON TIME Returns the elapsed time since the analyzer was last turned on Front Panel Access none Power On Type SYSTem PON TYPE PRESet LAST SYSTem PON TYPE Sets the defined instrument conditions after a power on or Preset PRESet The instrument settings at ...

Page 276: ... Reset SYSTem PRESet PERSistent Sets the persistent state values to their factory defaults The term persistent means that the command retains the setting previously selected even through a power cycle Examples of persistent functions are HP IB address power on type and preset type Front Panel Access System Restore Sys Defaults Preset Type SYSTem PRESet TYPE FACTory USER Selects the preset state to...

Page 277: ...m SPEaker STATe Turns the internal speaker on or off Factory Preset and RST Off Front Panel Access Det Demod Speaker On Off Set Time SYSTem TIME hour minute second SYSTem TIME Sets the time of the real time clock of the instrument Hour must be an integer 0 to 23 Minute must be an integer 0 to 59 Second must be an integer 0 to 59 Front Panel Access System Time Date Set Time SCPI Version Query SYSTe...

Page 278: ...ce data from the controller to the instrument If the data format is ASCII the data needs to be comma separated ASCII data The query returns the current values of the designated trace The data is terminated with NL END for HP IB that is newline or linefeed followed by EOI set true NOTE This command does not allow setting all trace points to the same amplitude value by sending just a single value If...

Page 279: ...tive number is returned for an upper limit and a large negative value for lower limits If too much data is merged as many points as possible are merged into the existing limit and then an error is reported Up to 200 points total may be defined for each limit Exchange Traces TRACe EXCHange trace_1 trace_2 Exchanges 2 traces point by point and leaves both in VIEW mode Trace_1 choices are TRACE 1 2 3...

Page 280: ...its Traces are TRACE 1 2 3 Query the Signal Peaks TRACe MATH PEAK DATA Outputs the signal peaks by frequency or by amplitude The sort mode is determined by the command TRACe MATH PEAK SORT The commands CALCulate MARKer PEAK EXCursion and CALCulate MARKer PEAK THReshold are used to determine what is a signal peak To get the number of signals found meeting the specified limits use the query TRACe MA...

Page 281: ...uency sorts the identified peaks by increasing frequency Smooth Trace Data TRACe MATH SMOoth trace Smooths the trace according to the number of points specified in TRACe MATH SMOoth POINts Traces are TRACE 1 2 3 Number of Points for Smoothing TRACe MATH SMOoth POINts integer TRACe MATH SMOoth POINts Specifies the number of points that will be smoothed in TRACe MATH SMOoth Range Integer 3 to 401 Tr...

Page 282: ...ay Mode TRACe 1 2 3 MODE WRITe MAXHold MINHold VIEW BLANk TRACe 1 2 3 MODE Selects the display mode for the selected trace Write puts the trace in the normal mode updating the data Maximum hold displays the highest measured trace value for all the data that has been measured since the function was turned on Minimum hold displays the lowest measured trace value for all the data that has been measur...

Page 283: ...ST 0 s Range 0 3 µs to 429 seconds Default Unit seconds Front Panel Access Trig Trig Delay On Off Rear Panel External Trigger Delay TRIGger SEQuence 1 DELay STATe OFF ON 0 1 TRIGger SEQuence 1 DELay STATe Turns the trigger delay on off without changing the current delay setting Factory Preset and RST Off Default Unit seconds Rear Panel External Trigger Slope TRIGger SEQuence EXTernal 1 SLOPe POSit...

Page 284: ...er line signal External allows you to connect an external trigger source Factory Preset and RST Immediate Front Panel Access Trig Free Run Trig Video Trig Line Trig External Pos Neg Video Trigger Level TRIGger SEQuence VIDeo LEVel amplitude TRIGger SEQuence VIDeo LEVel Specifies the level at which a video trigger will occur Factory Preset and RST 2 5 divisions below reference level Range 10 displa...

Page 285: ...itude units for the input output and display Factory Preset and RST dBm in log amplitude scale volts in linear amplitude scale Front Panel Access AMPLITUDE Y Scale Amptd Units AMPLITUDE Y Scale Amptd Units dBm AMPLITUDE Y Scale Amptd Units dBmV AMPLITUDE Y Scale Amptd Units dBµV AMPLITUDE Y Scale Amptd Units Volts AMPLITUDE Y Scale Amptd Units Watts ...

Page 286: ...5 132 Chapter5 Language Reference UNIT Subsystem ...

Page 287: ...6 1 6 HP 8590 HP ESA Spectrum Analyzers Programming Conversion Guide ...

Page 288: ...ring Part Number E4401 90094 Printed in USA April 1999 Copyright 1999 Hewlett Packard Company This guide provides documentation for the following instruments HP ESA E Series HP ESA L Series and HP E4401B HP E4402B HP E4404B HP E4405B HP E4407B HP E4403B HP E4408B HP E4411B ...

Page 289: ...mbols and their meaning before operating this instrument WARNING Warning denotes a hazard It calls attention to a procedure which if not correctly performed or adhered to could result in injury or loss of life Do not proceed beyond a warning note until the indicated conditions are fully understood and met CAUTION Caution denotes a hazard It calls attention to a procedure that if not correctly perf...

Page 290: ...ING This is a Safety Class 1 Product provided with a protective earthing ground incorporated in the power cord The mains plug shall only be inserted in a socket outlet provided with a protected earth contact Any interruption of the protective conductor inside or outside of the product is likely to make the product dangerous Intentional interruption is prohibited WARNING If this product is not used...

Page 291: ...h an instrument will execute its programming instructions when properly installed on that instrument Hewlett Packard does not warrant that the operation of the instrument or software or firmware will be uninterrupted or error free LIMITATION OF WARRANTY The foregoing warranty shall not apply to defects resulting from improper or inadequate maintenance by Buyer Buyer supplied software or interfacin...

Page 292: ...1 HP 8590 HP ESA Spectrum Analyzers Conversion Guide ...

Page 293: ... to which it applies There may be more than one SCPI command that applies to any given HP 8590 Series analyzer command In these cases the SCPI commands are listed one after the other in column 2 of the table The next HP 8590 Series command appears on the line following the previous unrelated SCPI command For example for the HP 8590 Series command AMPCOR there is no similar SCPI command and the des...

Page 294: ...an HP 8590 Series analyzer terminators For example note the following differences non block response termination in the HP 8590 Series analyzers is CR LF but in the HP ESA analyzers it is LF EOI boolean queries in HP 8590 Series analyzers return ON or OFF whereas boolean queries in HP ESA analyzers return 1 or 0 OA and EP are valid parameters for many HP 8590 Series spectrum analyzer commands but ...

Page 295: ...ent ACPBW ACPBW Allows you to specify the channel bandwidth used for the adjacent channel power ACP extended adjacent channel power ACPE and channel power CHP measurements ACPCONTM Changes the spectrum analyzer sweep mode to continuous sweep and then performs the previous power measurement occupied bandwidth adjacent channel or channel power at the end of every sweep ACPE Performs the adjacent cha...

Page 296: ...ake sweep TS and then performs the previous power measurement ACPSP Allows you to specify the frequency spacing between channels ACTDEF Creates a user defined active function ACTVF Returns a 0 if the given function is not active a 1 if it is active ADD TRACe MATH ADD destination_trace source_trace1 source_trace2 Adds the sources and sends the sum to the destination Performs the math expression and...

Page 297: ...F ON 0 1 SENSe CORRection CSET 1 2 3 4 STATe OFF ON 0 1 SENSe CORRection CSET 1 2 3 4 DATA Applies amplitude correction at specified frequencies Units and spaces are not allowed in SCPI The separator must be a comma and the terminator must be a semicolon Frequency and amplitude values must be entered in Hz and dB The data format for the command and query is always TDF P The HP 8590 Series analyzer...

Page 298: ...ADD destination_trace source_trace1 source_trace2 Adds trace A to trace B and sends the result to trace A Adds TRACE1 trace A to TRACE2 trace B and sends the result to TRACE1 trace A AT AT numeric_ value AT AUTO AT UP DN AT SENSe POWer RF ATTenuation rel_ampl SENSe POWer RF ATTenuation AUTO ON 1 SENSe POWer RF ATTenuation Specifies RF input attenuation The up down steps are in 5 dB increments The ...

Page 299: ...tive functions automatically The instrument can automatically couple instrument settings together for accurate measurements and optimum range This command is used to override the coupling for special measurement needs The NONE parameter applies only to the SCPI language AVG Averages trace data AXB TRACe EXCHange TRACE1 TRACE2 Exchanges trace A and trace B Exchanges TRACE1 trace A and TRACE2 trace ...

Page 300: ... 1200 The HP ESA analyzers return data in the format 1200 BIT Returns the state of a bit BITF Returns the state of a bit BLANK BLANK TRA BLANK TRB BLANK TRC TRACe 1 2 3 MODE BLANk Blanks trace A trace B or trace C and stops taking new data into the specified trace Selects the blank display mode for the selected trace TRACE1 corresponds to trace A TRACE2 corresponds to trace B and TRACE3 correspond...

Page 301: ...nd trace C Exchanges TRACE2 trace B with TRACE3 trace C point by point CAL CAL ALL CAL AMP CAL ON OFF CAL TG CAL YTF CAL INIT CAL FREQ CALibration ALL CALibration AUTO MODE ALL NRF CALibration AUTO STATe OFF ON 0 1 CALibration TG CALibration RF CALibration DATA DEFault CALibration FREQuency STATe OFF ON 0 1 Initiates self calibration routines HP 8590 Series Analyzers Command s Corresponding SCPI C...

Page 302: ...e file_size CF CF value CF UP DN CF SENSe FREQuency CENTer freq SENSe FREQuency CENTer Specifies center frequency The HP 8590 Series analyzer outputs data in the format 750000000 The HP ESA analyzer outputs data in the format 750000000 CHP Performs the channel power measurement CHPGR Determines if the channel power graph function is enabled or disabled CLRAVG SENSe AVERage CLEar Restarts video ave...

Page 303: ... map exactly CMDERRQ Allows query of error queue CNF CNTLA Sets the control line A of the auxiliary interface high or low HP ESA spectrum analyzers do not have an auxiliary interface CNTLB Sets the control line B of the auxiliary interface high or low HP ESA spectrum analyzers do not have an auxiliary interface CNTLC Sets the interface control line C of the auxiliary interface high or low HP ESA s...

Page 304: ... do not have an auxiliary interface COMB Turns the comb generator on or off This hardware is not present in HP ESA spectrum analyzers COMPRESS Reduces the number of trace elements while retaining the relative frequency and amplitude characteristics of the trace data CONCAT Combines two traces CONTS INITiate CONTinuous ON 1 Sets the spectrum analyzer to the continuous sweep mode CORREK CALibration ...

Page 305: ... The output is AC or DC CRTHPOS Specifies the horizontal position of the text and graticule on the spectrum analyzer display CRTVPOS Specifies the vertical position of the text and graticule on the spectrum analyzer display CTA Converts the source values from measurement units to the current absolute amplitude units and stores the result in the destination CTM Converts the source values to measure...

Page 306: ...E year month day The response output is in the form MDY or DMY DEMOD DEMOD AM FM DEMOD ON OFF DEMOD SENSe DEMod AM FM SENSe DEMod STATe OFF ON 0 1 SENSe DEMod STATe Turns the demodulator on or off and selects between AM FM or quasi peak demodulation Sets the type of demodulation Turns demodulation on or off The HP 8590 Series analyzer returns AM FM or OFF The HP ESA analyzer returns 1 correspondin...

Page 307: ...e taken during the interval being displayed Sample detection displays the first sample taken during the interval being displayed The HP 8590 Series analyzer returns NEG POS or SMP The HP ESA analyzer returns NEG POS or SAMP DISPOSE Deletes user defined functions and frees spectrum analyzer memory that was previously allocated for user defined operands The HP 8590 Series analyzer returns NEG or POS...

Page 308: ... The HP 8590 Series analyzer outputs data in the format 25 00 The HP ESA analyzer outputs data in the format 2 50000000E 001 DN Reduces the active function by the applicable step size Each HP 8590 Series command to which DN can be applied will have step DOWN UP as a parameter in the SCPI command DN as well as UP can only be sent as a parameter in SCPI DONE DONE OPC OPC Allows you to determine when...

Page 309: ...he operator EK Allows data entry with the front panel knob when the spectrum analyzer is under remote control ENTER Allows the spectrum analyzer to receive data from other devices on the HP IB EP Enter parameter from front panel Sends values entered on the spectrum analyzer number keyboard to the present active function value ERASE Clears trace A and trace B disposes of the contents of the user me...

Page 310: ...yzer outputs data in the format 750000000 The HP ESA analyzer outputs data in the format 750000000 FFT Performs a discrete fast Fourier transform on the source trace array and stores the result in the destination array FFTAUTO Performs a fast Fourier transform FFT on the signal on which the marker is placed FFTCLIP Indicates if the FFT results are valid FFTCONTS Performs a fast Fourier transform F...

Page 311: ...surement and FFT settings FFTPCTAM Turns the percent AM function on or off during an FFT measurement FFTPCTAMR Returns the percent of amplitude modulation AM FFTSNGLS Changes the spectrum analyzer sweep mode to single sweep mode if necessary and then performs a fast Fourier transform FFT on trace A FFTSTAT Returns the status of the spectrum analyzer FFT measurement functions FFTSTOP Sets the FFT s...

Page 312: ...fset for all absolute frequency readouts such as center frequency The HP 8590 Series analyzer outputs data in the format 10 The HP ESA analyze outputs data in the format 1 00000000E 001 FORMAT Formats the memory card FS SENSe FREQuency SPAN FULL Sets the frequency span of the spectrum analyzer to full span Set the frequency span to full span FUNCDEF Defines a routine consisting of spectrum analyze...

Page 313: ...is capability Level triggers the gate when the signal surpasses a specific level set to either low or high Edge triggers the gate when the edge of a signal is encountered set to either a negative going edge or a positive going edge The HP 8590 Series analyzer returns EDGE or LEVEL The HP ESA analyzer returns EDGE or LEV GC SENSe SWEep TIME GATE PRESet Presets Option 105 the time gated spectrum ana...

Page 314: ...PAR Clears the pulse parameters pulse width pulse repetition interval and reference edge for a time gate measurement by setting the pulse parameters to 0 GDRVGDEL For the frequency window only GDRVGDEL sets the time delay from when the gate trigger occurs to when the gate is opened GDRVGLEN Adjusts the gate length in both the time and frequency windows GDRVGT Turns the gate on or off in the freque...

Page 315: ...epetition interval GDRVSWAP Makes the window either the time or frequency window that is currently not the active window the active window GDRVSWDE Allows you to specify the delay from the edge of the gate trigger until the sweep is started in the time window GDRVSWP Specifies the sweep time for the time domain window of the gate utility GDRVUTIL Turns the gate utility on or off GDRVVBW Couples or...

Page 316: ...tive POSitive SENSe SWEep TIME GATE POLarity Sets the polarity positive or negative for the gate trigger Returns POS or NEG GR Graphs the given y coordinate while incrementing the x coordinate by 1 GRAT GRAT ON OFF GRAT DISPlay WINDow TRACe GRATicule GRID STATe OFF ON 0 1 DISPlay WINDow TRACe GRATicule GRID STATe Turns the graticule on or off The HP 8590 Series analyzer outputs ON or OFF The HP ES...

Page 317: ...nalyzer to use only the selected harmonic band HNUNLK Unlocks the harmonic band IB Provides a method for putting values into trace B ID ID IDN Returns the spectrum analyzer model number The HP 8590 Series analyzer returns the model number in the format HP8592L The HP ESA analyzer returns the format HP E4411B IF etc IF THEN ELSE ENDIF forms a decision and branching construct INT Places the greatest...

Page 318: ... input impedance The HP 8590 Series analyzer outputs data in the format 50 The HP ESA analyzer outputs data in the format 50 IP SYSTem PRESet Performs an instrument preset KEYCLR Clears softkeys 1 through 6 KEYCMD Allows you to define the function and label of a softkey The softkey label is updated whenever a softkey is pressed KEYDEF Assigns a label and user defined function to a softkey KEYENH A...

Page 319: ...TRACe Y SCALe PDIVision DISPlay WINDow TRACe Y SCALe SPACing Specifies the vertical graticule divisions as logarithmic units without changing the reference level The HP 8590 Series analyzer outputs data in the format 10 00 The HP ESA analyzer outputs data in the format 1 00000000E 001 LIMIDEL CALCulate LLINe 1 2 DELete Deletes all segments in the current limit line table LIMIDISP CALCulate LLINe 1...

Page 320: ...no equivalent SCPI command Edit specify upper or lower limit line only There is no similar function in HP ESA analyzers LIMIHI no equivalent SCPI command Allows you to specify a fixed trace as the upper limit line There is no similar function in HP ESA analyzers LIMILINE CALCulate LLINe 1 2 DATA CALCulate LLINe 1 2 MARGin CALCulate LLINe 1 2 MARGin STATe Outputs the current limit line table defini...

Page 321: ...ed as upper amplitude values lower amplitude values upper and lower amplitude values or mid amplitude and delta values LIMIREL CALCulate LLINe CMODe FIXed RELative Specifies the current limit lines as fixed or relative LIMISEG CALCulate LLINe 1 2 DATA MERGe x axis ampl connected x axis ampl connected Adds new segments to the current frequency limit line in either the upper limit line or the lower ...

Page 322: ...LIMITEST CALCulate LLINe 1 2 STATe OFF ON 0 1 Compares trace A with the current limit line data LINFILL CALCulate LLINe 1 2 AMPLitude INTerpolate TYPE LOGarithmic LINear Fills linear interpolated data into the specified trace data points of a destination trace LN DISPlay WINDow TRACe Y SCALe SPACing LINear Specifies the vertical graticule divisions as linear units without changing the reference le...

Page 323: ...hen stores it in the destination LSPAN SENSe FREQuency SPAN PREVious Changes the spectrum analyzer span to the previous span setting M4 Activates a single marker on the trace and enables the knob to change the position of the marker The active function is then set to span MDS FORMat TRACe DATA ASCii INTeger 32 REAL 32 REAL 64 Specifies measurement data size as byte or word Specifies the measuremen...

Page 324: ...orresponds to trace C MEANTH Returns the mean value of the given trace above the threshold in measurement units MEASOFF Turns off the current measurement erases the display and then displays the menu accessed by MEAS USER MEASURE Determines the type of measurement signal analysis stimulus response or signal normalization MEM Returns the amount of spectrum analyzer memory available MENU Selects and...

Page 325: ...s been measured since the function was turned on MINPOS Returns a value which is the x axis position in display units of the minimum amplitude value in trace A trace B trace C or user defined trace MIRROR Displays the mirror image of a trace MKA MKA CALCulate MARKer 1 2 3 4 Y Specifies amplitude of the active marker Read the current Y value for the designated marker on the assigned trace The value...

Page 326: ...en marker is present MKCF CALCulate MARKer 1 2 3 4 SET CENTer Sets the center frequency equal to the marker frequency and moves the marker to the center of the screen Sets the center frequency equal to the specified marker frequency which moves the marker to the center of the screen MKCONT Resumes the sweep after execution of a MKSTOP command MKD CALCulate MARKer 1 2 3 4 MODE DELTa or CALCulate MA...

Page 327: ...er 1 2 3 4 X Specifies the frequency value of the active marker Positions the designated marker on the assigned trace at the specified X value The value is in the x axis units which is often frequency or time The HP 8590 Series analyzer outputs data in the format 750E6 The HP ESA analyzer outputs data in the format 7 50000000E 008 MKFC CALCulate MARKer 1 2 3 4 FCOunt STATe OFF ON 0 1 Turns the mar...

Page 328: ...nter resolution to the frequency span Sets the resolution of the marker frequency counter so it is automatically coupled to the frequency span generating the fastest accurate count The HP 8590 Series analyzer outputs data in the format 1000 The HP ESA analyzer outputs data in the format 1000 MKMIN CALCulate MARKer 1 2 3 4 MINimum Moves active marker to minimum signal detected Places the selected m...

Page 329: ...utputs data in the format 750E6 The HP ESA analyzer outputs data in the format 7 50000000E 008 MKNOISE MKNOISE CALCulate MARKer 1 2 3 4 FUNCtion NOISe OFF CALCulate MARKer 1 2 3 4 FUNCtion Displays the average noise level at the marker Selects the marker function for the specified marker NOISe is a noise measurement The HP 8590 Series analyzer outputs ON or OFF The HP ESA analyzer outputs 1 or 0 M...

Page 330: ...ate MARKer 1 2 3 4 MAXimum CALCulate MARKer 1 2 3 4 MAXimum LEFT CALCulate MARKer 1 2 3 4 MAXimum NEXT CALCulate MARKer 1 2 3 4 MAXimum RIGHt Positions the active marker on a signal peak Places the selected marker on the highest point on the trace that is assigned to that particular marker number Places the selected marker on the next highest signal peak to the left of the current marked peak Plac...

Page 331: ...ces and all windows The HP 8590 Series analyzer outputs data in the format 6 00 The HP ESA analyzer outputs data in the format 6 00000000E 000 MKREAD MKREAD FRQ MKREAD SWT MKREAD IST MKREAD PER MKREAD FFT MKREAD CALCulate MARKer 1 2 3 4 X READout FREQuency TIME ITIMe PERiod CALCulate MARKer 1 2 3 4 X READout Selects the type of active trace information displayed by the spectrum analyzer marker rea...

Page 332: ... The specified marker must be in delta mode Select the delta marker mode with CALCulate MARKer 1 2 3 4 MODE DELTa MKSS CALCulate MARKer 1 2 3 4 SET STEP Sets the center frequency step size to the marker frequency Sets the center frequency step size equal to the specified marker frequency MKSTOP Stops the sweep at the active marker MKTBL MKTBL CALCulate MARKer TABLe STATe OFF ON 0 1 CALCulate MARKe...

Page 333: ...SA analyzer returns 1 2 or 3 MKTRACK MKTRACK CALCulate MARKer 1 2 3 4 TRCKing STATe OFF ON 0 1 CALCulate MARKer 1 2 3 4 TRCKing STATe Moves the signal with an active marker to the center of the spectrum analyzer display and keeps the signal peak at center screen Turns marker signal tracking on or off It continuously puts the selected marker on the highest displayed signal peak and moves it to the ...

Page 334: ... data in the format 1 00000000E 001 MOD Stores the remainder from the division of source 1 by source 2 in the destination MODE Returns a 0 if the mode of operation is spectrum analysis A number other than 0 is returned if the operating mode also called personality is other than spectrum analysis MOV TRACe COPY source_trace dest_trace Copies the source values into the destination dest_trace num_val...

Page 335: ... CALCulate BWIDth BANDwidth NDB rel_ampl CALCulate BWIDth BANDwidth NDB Specifies the distance in dB from the signal peak for the N dB points measurement NDBPNT The HP 8590 Series analyzer outputs data in the format 3 The HP ESA analyzer outputs data in the format 3 00000000E 000 NDBPNT NDBPNT CALCulate BWIDth BANDwidth STATe OFF ON 0 1 CALCulate BWIDth BANDwidth STATe Turns the N dB points measur...

Page 336: ...90 series analyzer outputs data in the format 10 The HP ESA series analyzer outputs data in the format 1 00000000E 001 OA Returns the value of the active function OBW Performs the occupied bandwidth measurement using the value for occupied bandwidth percent OBWPCT OBWPCT Specifies the percent of total power that is to be used in calculating the occupied bandwidth OBW OL Output current state in lea...

Page 337: ...s the list of analyzer commands whenever a service request occurs ONSWP Executes the list of analyzer commands at the beginning of the sweep ONTIME Executes the list of analyzer commands at the specified time OP Returns the coordinates of the lower left and upper right corners of the spectrum analyzer display P1 P2 OUTPUT Allows the spectrum analyzer to send data to other devices on the HP IB PA M...

Page 338: ...er to plot vectors on the spectrum analyzer screen until a PU command is received PDA Sums the probability distribution of amplitude in the destination trace with the amplitude distribution function of the source trace PDF Increments an element of the destination trace whenever the corresponding element of the source trace exceeds a threshold HP 8590 Series Analyzers Command s Corresponding SCPI C...

Page 339: ...LCulate MARKer PEAK EXCursion and CALCulate MARKer PEAK THReshold are used to determine what is a signal peak To get the number of signals found meeting the specified limits use the query TRACe MATH PEAK POINts Outputs the number of signal peaks identified The amplitude of the peaks can then be queried with TRACe MATH PEAK DATA Determines if the signals in the TRACe MATH PEAK DATA query should be ...

Page 340: ...nly the spectrum analyzer local oscillator feedthrough otherwise a 1 is returned PKZOOM Automatically tunes the spectrum analyzer to the signal with the highest amplitude level while narrowing the frequency span to the specified frequency span PLOT Initiates a plotter output of the screen data to the remote interface PLTPRT Directs the plotter output to HP IB serial or parallel ports POWERON POWER...

Page 341: ...on on the spectrum analyzer screen relative to the current coordinates in display units PREAMPG PREAMPG SENSe CORRection OFFSet MAGNitude rel_ampl SENSe CORRection OFFSet MAGNitude Subtracts a positive or negative preamplifier gain value from the displayed signal The HP 8590 Series analyzer outputs data in the format 10 00 The HP ESA analyzer outputs data in the format 1 00000000E 001 PREFX Specif...

Page 342: ...ecified file from the current mass storage device Replaced by DELETE PWRBW Computes the bandwidth around the trace center which includes signals whose total power is a specified percentage of the total trace signal power PWRUPTIME PWRUPTIME SYSTem PON TIME Returns the number of milliseconds that have elapsed since the spectrum analyzer was turned on The HP 8590 Series analyzer outputs data in the ...

Page 343: ...000000 The HP ESA analyzer outputs data in the format 750000000 RCLS RCL Recalls spectrum analyzer state data from one of nine state registers in spectrum analyzer memory These registers do not appear in a FILE catalog RCLT MMEMory LOAD TRACe label file_name Recalls previously saved trace data amplitude factors or limit line data from the trace registers in spectrum analyzer memory These registers...

Page 344: ...evision number date code in the format 950129 The HP ESA analyzer returns the format Hewlett Packard HP E4401B US00000084 A 00 00 RL RL value RL UP DN RL DISPlay WINDow TRACe Y SCALe RLEVel ampl DISPlay WINDow TRACe Y SCALe RLEVel Specifies the amplitude value of the reference level Sets the amplitude value of the reference level for the y axis The active window is assumed when no window is specif...

Page 345: ...s all amplitude readouts without affecting the trace Sets the amplitude reference level for the y axis When no window is specified the active window is assumed The HP 8590 Series analyzer outputs data in the format 10 00 The HP ESA analyzer outputs data in the format 1 00000000E 001 RQS Sets a bit mask for service requests SAVEMENU Saves menu 1 under the specified menu number HP 8590 Series Analyz...

Page 346: ...MILINE SAVET AMPCOR MMEMory STORe TRACe label file_name MMEMory STORe LIMit LLINe1 LLINe2 file_name Saves the selected trace data and state information amplitude correction factors or limit line tables in spectrum analyzer memory These registers are specially mapped to named files HP ESA analyzers save only state information registers SAV and RCK The only acceptable delimiter is a single quote Onl...

Page 347: ...e mid and delta table for limit lines based on frequency SENTERT Enters the limit line data in either the upper and lower limit line table or the mid and delta table for limit lines based on sweep time SER SER IDN or IDN Returns the serial number suffix of the spectrum analyzer For example serial number 4537450345 will return 0345 The HP 8590 Series analyzer returns the serial number suffix in the...

Page 348: ...rns the instrument date in the format YYMMDD The HP ESA analyzer returns the format YYYY MM DD SETTIME SETTIME SYSTem TIME hour minute second SYSTem TIME Sets the time of the real time clock Hour must be an integer 0 to 23 Minute must be an integer 0 to 59 Second must be an integer 0 to 59 The HP 8590 Series analyzer returns the instrument time in the format HHMMSS The HP ESA analyzer returns the ...

Page 349: ... trace A TRACE2 corresponds to trace B and TRACE3 corresponds to trace C Specifies the number of points that will be smoothed in TRACe MATH SMOoth SNGLS INITiate CONTinuous OFF 0 Selects single sweep mode SP SP value SP UP DN SP SENSe FREQuency SPAN freq SENSe FREQuency SPAN Changes the total displayed frequency range symmetrically about the center frequency Set the frequency span The HP 8590 Seri...

Page 350: ... the signal track function and activates the span function SQLCH SENSe DEMod SQUelch number Sets the squelch level Sets the squelch threshold by setting the squelch level SQR Places the square root of the source into the destination SRCALC Selects internal or external leveling for use with the built in tracking generator SRCAT SOURce POWer ATTenuation ampl SOURce POWer ATTenuation AUTO OFF ON 0 1 ...

Page 351: ...P numeric SRCPSTP AUTO SRCPSTP SOURce POWer STEP INCRement ampl SOURce POWer STEP AUTO ON 1 SOURce POWer STEP INCRement Selects the source power step size Specifies the source power step size to be one vertical scale division The HP 8590 Series analyzer outputs data in the format 10 00 The HP ESA analyzer outputs data in the format 1 00000000E 001 HP 8590 Series Analyzers Command s Corresponding S...

Page 352: ...n the format 10 00 The HP ESA analyzer outputs data in the format 1 00000000E 001 SRCPWR SRCPWR SOURce POWer LEVel IMMediate AMPLitude ampl SOURce POWer MODE FIXed SWEep SOURce POWer LEVel IMMediate AMPLitude Selects the source power level Specifies the source output power level and turns on the source An offset power level can be added to the output power to compensate for system losses between t...

Page 353: ...enerator or 1DQ 75 ohm tracking generator only E4402B E4403B E4404B E4405B E4407B E4408B Adjusts the tracking of the source output with the spectrum analyzer sweep Automatically adjusts the tracking of the source output with the spectrum analyzer sweep The HP 8590 Series analyzer outputs data in the format 2048 The HP ESA analyzer outputs data in the format 2048 SRCTKPK SOURce POWer TRCKing PEAK A...

Page 354: ...ally based on the span The HP 8590 Series analyzer outputs data in the format 750000000 The HP ESA analyzer outputs data in the format 750000000 ST ST value ST AUTO ST UP DN ST SENSe SWEep TIME time SENSe SWEep TIME AUTO OFF ON 0 1 SENSe SWEep TIME Specifies the time in which the spectrum analyzer sweeps the displayed frequency or time range Automatically selects the fastest sweep time for the cur...

Page 355: ...in the destination trace SUM Returns the sum of the amplitudes of the trace elements in measurement units SUMSQR Returns the sum of the squares of the amplitude of each trace element SWPCPL SWPCPL SR SA SWPCPL SENSe SWEep TIME AUTO MODE SRESponse SANalyzer SENSe SWEep TIME AUTO MODE Selects a stimulus response SR or spectrum analyzer SA auto coupled sweep time Specifies the type of automatic coupl...

Page 356: ...e spectrum analyzer to the controller TB TRACe DATA TRACE2 Returns trace B amplitude values from the spectrum analyzer to the controller Returns TRACE2 trace B amplitude values from the spectrum analyzer to the controller TDF TDF A B M I TDF P TDF Formats trace information for return to the controller TDF P is the only supported format The queries TRA TRB and TRC always return in TDF P format TEXT...

Page 357: ... 4 digit integer Month is an integer 1 to 12 Day is an integer 1 to 31 depending on the month The HP 8590 Series analyzer returns the instrument timedate in the format YYMMDDHHMMSS The HP ESA analyzer returns the format YYYY MM DD for the date query and HH MM SS for the time query Both individual SCPI queries need to be sent in order to receive the same amount of information as was given with the ...

Page 358: ... SEQuence SOURce IMMediate VIDeo LINE EXTernal TRIGger SEQuence SOURce Specifies trigger mode Specifies the source or type of triggering used to start a measurement Immediate is free run triggering Video triggers on the video signal Line triggers on the power line signal External allows you to connect an external trigger source The HP 8590 Series analyzer outputs FREE VID LINE or EXT The HP ESA an...

Page 359: ... data in the format 57 71 58 12 56 87 The HP ESA analyzer returns data in the format 5 46380000E 001 5 44410000E 001 5 47590000E 001 This is an example of IEEE NR3 numeric response data TRCMEM Returns a non negative integer that indicates the total number of trace registers available for SAVET and RCLT TRDEF Creates a user defined trace TRDSP Turns the display of trace A B or C on or off It does t...

Page 360: ... HP ESA analyzer returns the format WRIT BLAN BLAN All three traces in the HP ESA analyzer will be queried with an EOI after each response TS INITiate IMMediate OPC Starts and completes one full sweep before the next command is executed Allows you to determine when the spectrum analyzer has started to execute all commands prior to and including TS TVLINE Sets the line number of the horizontal line...

Page 361: ...ep size Each HP 8590 Series command to which DN can be applied will have step DOWN UP as a parameter in the SCPI command UP as well as DN can only be sent as a parameter in SCPI USTATE Transmits information that has been stored in the analyzer by the user VARDEF Creates a user defined variable and assigns it a value VARIANCE Returns the amplitude variance of the specified trace in measurement unit...

Page 362: ...verage out measurement variations The HP 8590 Series analyzer returns the count in the format 100 when VAVG is ON and returns 0 when VAVG is OFF The HP ESA analyzer returns 100 when VAVG is ON and returns 0 when VAVG is OFF VB VB value VB AUTO VB UP DN VB SENSe BANDwidth BWIDth VIDeo freq SENSe BANDwidth BWIDth VIDeo AUTO OFF ON 0 1 SENSe BANDwidth BWIDth VIDeo Specifies the video bandwidth Couple...

Page 363: ...90 Series analyzer outputs data in the format 3000000 The HP ESA analyzer outputs data in the format 3 00000000E 001 VIEW TRACe 1 2 3 MODE VIEW Displays trace A trace B or trace C and stops taking new data into the viewed trace WAIT Suspends all spectrum analyzer operation for the specified time duration WINNEXT Makes the window that is currently not the active window active WINOFF Turns off the w...

Page 364: ...e TRACE 1 2 3 ZMKCNTR Positions the zone marker at the specified frequency ZMKPKNL Places the zone marker at the next signal peak that is left of the current position of the zone marker ZMKPKNR Places the zone marker at the next signal peak that is left of the current position of the zone marker ZMKSPAN Allows you to change the width of the zone marker HP 8590 Series Analyzers Command s Correspond...

Page 365: ... blank traceA CLRW TRA MXMH TRA VIEW TRA BLANK TRA B1 B2 B3 B4 BL Clear write trace B Max hold trace B Store and view trace B Store and blank trace B B DL B CLRW TRB MXMH TRB VIEW TRB BLANK TRB BML C1 C2 CA CR CS CT CV Trace A minus trace B off Trace A minus trace B on Coupled input attenuation Coupled resolution bandwidth Coupled step size Coupled sweep time Coupled video bandwidth AMB OFF AMB ON...

Page 366: ...notation off Annotation on AUNITS DBM AUNITS DBMV AUNITS DBUV AUNITS V TITLE VAVG ON VAVG OFF MKNOISE MKSP ROFFSET APB BXC BTC GRAT OFF GRAT ON ANNOT OFF ANNOT ON L0 Display line off DL OFF M1 M2 M3 MA MC MT0 MT1 Marker off Marker normal Marker delta Marker amplitude Marker count Marker track off Marker track on MKOFF MKN MKD MKA MKFC MKTRACK OFF MKTRACK ON O1 O2 O3 O4 Output format in real number...

Page 367: ...tivates units key pressed illegal command Recall state RQS 32 RQS 36 RQS 40 RQS 34 RCLS S1 S2 SV Sweep continuous Sweep single Save state OONTS SNGLS SAVES T0 T1 T2 T3 T4 T7 T8 Threshold off Trigger mode free run Trigger mode line Trigger mode external Trigger mode video Trigger mode level Trigger mode edge TH OFF TM FREE TM LINE TM EXT TM VID GATECTL LEVEL GATECTL EDGE Alternate Commands Descript...

Page 368: ...7 1 7 Error Messages ...

Page 369: ...the status line User Error Messages appear when an attempt has been made to set a parameter incorrectly or an operation has failed such as saving a file These messages are often generated during remote operation when an invalid programming command has been entered These messages appear in the status line at the bottom of the display in yellow if you have a color display The message will remain unt...

Page 370: ...g System Alignments Align Now All On all HP ESA spectrum analyzer models except HP E4401B and HP E4411B you must connect the AMPTD REF OUT to the INPUT with the appropriate cable to perform this alignment Align Now RF Needed Align Now RF Needed The instrument requires an Align Now RF Restore the alignment by pressing System Alignments Align Now RF EXT Cable On all HP ESA spectrum analyzer models e...

Page 371: ...too far off of 10 MHz This condition may be corrected by cycling power on the analyzer FM Demod Align Failure status bit only no message A failure has occurred during the FM Demod alignment Measurement results may be invalid IF Align Failure status bit only no message A failure has occurred during the IF alignment Measurement results may be invalid IF Overload IF ADC Over Range The IF section has ...

Page 372: ... the phase locked circuitry of the local oscillator LO has become unlocked This condition must be corrected to make valid measurements Meas Uncal Measurement Uncal The measurement is uncalibrated Check the sweep time span and bandwidth settings or press Auto Couple Overload Reduce Signal and press ESC Input Overload Tripped This message applies to the HP E4401B and E4411B only A signal has been ap...

Page 373: ...surements Source LO Unlock Source Synth Unlocked The phase locked circuitry of the local oscillator LO in the tracking generator has become unlocked This condition must be corrected to make valid measurements Source Unlevel Source Unleveled Indicates the source power is set higher or lower than the analyzer can provide the frequency span extends beyond the specified frequency range of the tracking...

Page 374: ... indicated has been successfully deleted filename1 file renamed to filename2 Filename1 has been successfully renamed to filename2 Atten auto set to 15 dB Indicates that an input signal has been detected which is of sufficient level to force the input attenuator to be autocoupled at 15 dB If the signal level is reduced the attenuator will stay at 15 dB This overload protection occurs at an input po...

Page 375: ...r queue depending on the error These two queues are viewed and managed separately Table 7 1 Characteristics of the Error Queues Characteristic Front Panel Display Error Queue SCPI Remote Interface Error Queue Capacity errors 11 30 Overflow Handling Circular rotating Drops oldest error as new error comes in Linear first in first out Replaces newest error with 350 Queue overflow Viewing Entries Pres...

Page 376: ...d 1 of N basis The error messages are listed in alphabetical order within each error message type section In this chapter an explanation is included with each error to further clarify its meaning The last error described in each class for example 400 300 200 100 is a generic error Error messages appear at the bottom of the display ...

Page 377: ... command error bit bit 5 in the event status register IEEE 488 2 section 11 5 1 In this case Either an IEEE 488 2 syntax error has been detected by the parser a control to device message was received that is in violation of the IEEE 488 2 standard Possible violations include a data element which violates device listening formats or whose type is unacceptable to the device or an unrecognized header...

Page 378: ...Chapter 7 7 11 Error Messages 0 No Error 0 No Error 0 No error The queue is empty Every error in the queue has been read or the queue was purposely cleared by power on or CLS ...

Page 379: ... preventing further SCPI command execution and there is no more room left in the corresponding SCPI input queue to accept a query to read from the output queue The system automatically discards output to correct the deadlock 400 Query Error This is a generic query error for devices that cannot detect more specific errors The code indicates only that a query error as defined in IEEE 488 2 11 5 1 1 ...

Page 380: ...sages 499 to 400 Query Errors 440 Query UNTERMINATED after indefinite response Indicates that a query was received in the same program message after a query requesting an indefinite response was executed see IEEE 488 2 6 3 7 5 ...

Page 381: ...ers and incorrect or unimplemented IEEE 488 2 common commands 160 Block data error This error as well as errors 161 through 169 are generated when parsing a block data element This particular error message is used if the device cannot detect a more specific error 168 Block data not allowed A legal block data element was encountered but not allowed by the device at this point in the parsing 140 Cha...

Page 382: ...untered 123 Exponent too large The magnitude of an exponent was greater than 32000 see IEEE 488 2 7 7 2 4 1 170 Expression data error This error as well as errors 171 through 179 are generated when parsing an expression data element This particular error message is used if the device cannot detect a more specific error 178 Expression data not allowed A legal expression data was encountered but was...

Page 383: ...aracter data Either the character data element contains an invalid character or the particular element received is not valid for the header 121 Invalid character in number An invalid character for the data type being parsed was encountered For example an alpha in a decimal numeric or a 9 in octal data 171 Invalid expression The expression data element was invalid see IEEE 488 2 7 7 7 2 For example...

Page 384: ...meric types This particular error message is used if the device cannot detect a more specific error 128 Numeric data not allowed A legal numeric data element was received but the device does not accept one in this position for the header 108 Parameter not allowed More parameters were received than expected for the header For example the ESE common command only accepts one parameter so receiving ES...

Page 385: ...was encountered after a numeric element which does not allow suffixes 134 Suffix too long The suffix contained more than twelve characters see IEEE 488 2 7 7 3 4 102 Syntax error An unrecognized command or data type was encountered For example a string was received when the device does not accept strings 124 Too many digits The mantissa of a decimal numeric data element contained more than 255 dig...

Page 386: ...n not available when using Calibration Defaults The Auto Alignment system cannot be used until an Align Now All is executed by pressing System Alignments Align Now All For HP E4402B E4403B E4404B E4405B E4407B and E4408B only you must connect the AMPTD REF OUT to the INPUT with the appropriate cable to perform this alignment 614 Bad or missing floppy disk The floppy is not inserted or the director...

Page 387: ...s corrupt 610 File access is denied The file is protected or hidden and cannot be accessed 604 File already exists Attempt to save to a file that already exists Delete or rename the old file and try again 607 File Name Error An invalid file name has been specified Use filenames with a maximum of 8 characters letters and digits only and use a 3 character extension Note that lowercase and uppercase ...

Page 388: ...a file with an incorrect extension 762 Incorrect filename allowable extensions are trc or csv Attempt to save a trace to a file with an incorrect extension 751 Instrument state may be corrupt state has been reset to initial values An error in the internal instrument state has been detected The state has been reset to a default value 216 Invalid Baud Rate Attempt to use invalid baud rate Refer to m...

Page 389: ...t installed For example pressing Source with no tracking generator installed in the analyzer will generate this error 209 Preselector centering failed An attempt to center the preselector failed 704 Printer interface error An error occurred while trying to print Make sure the printer is turned on and properly connected 705 Printer Type is None The current printer type is set to None so no print op...

Page 390: ... is less than 9kHz TG uncalibrated below 9 kHz 204 TG Frequency Limit The tracking generator has reached the limit of its allowable frequency range 206 Unable to initialize flatness data A failure occurred in setting the flatness data in the internal EEROM Contact your local Hewlett Packard sales and service office 762 Unable to load file A failure occurred while loading a file the file was not lo...

Page 391: ... interface was unsuccessful 764 Unable to save file A failure occurred while saving a file the file was not saved 756 Unable to save state to register Saving of state to an internal register failed 753 Unable to save state to file Saving of state to a file failed 758 Unable to save user state An attempt to save to the User Preset state failed 761 Unable to set state Attempt to set the state over t...

Page 392: ...yzer Use the Custom printer menu under Print Setup to configure the printer 702 Unsupported printer A printer which is recognized but known to be unsupported was identified This printer cannot be used with the analyzer For example a printer only supported by Microsoft Windows will generate this error 617 Wrong density floppy inserted The floppy disk has the wrong density It should be 1 44 MB ...

Page 393: ...7 26 Chapter7 Error Messages 201 to 799 Device Specific Errors ...

Page 394: ...4 tracking generator 5 35 calibration commands 5 31 calibration condition register 5 108 5 109 calibration condition register data questionable 2 28 2 32 catalog memory disk 5 60 center frequency setting 5 86 center frequency step size 5 86 changing instrument settings 5 69 5 70 5 72 5 74 5 76 5 77 5 81 5 83 5 84 5 86 5 90 5 93 5 94 5 97 clear status IEEE command 5 4 CLS command 2 3 color printing...

Page 395: ...n 2 11 FM demodulation 5 81 form feed printer 5 51 format data 5 48 frequency center 5 86 span 5 87 5 88 start 5 88 step size 5 86 stop 5 89 frequency condition register 5 110 5 111 frequency condition register data questionable 2 25 frequency count marker 5 18 5 19 frequency span full 5 88 markers 5 21 previous 5 88 setting 5 87 front panel error queue characteristics 7 8 G gate on off 5 99 prese...

Page 396: ...tion filter 2 11 noise marker 5 19 normal marker 5 21 normalized reference level 5 41 normalized reference position 5 41 O OPC command 2 3 operation complete IEEE command 5 6 operation condition register 5 106 5 107 operation status 5 106 5 108 options query 5 6 options query 5 121 options IEEE command 5 6 outputs configuration 5 116 outputs configuration commands 5 64 P PACE for serial bus receiv...

Page 397: ...l tracking 5 25 single vs continuous measurement mode 5 44 5 45 5 47 5 53 5 54 5 56 5 57 5 59 5 65 5 66 5 68 smoothing trace 5 127 source internal tracking generator 5 101 See also tracking generator source calibration internal 5 35 source output on off 5 64 span markers 5 21 span markers 5 27 5 28 span setting 5 87 5 88 speaker on off 5 123 SRE command 2 3 SRQ 2 2 5 7 SRQ command 2 4 standard eve...

Page 398: ...nerator attenuation 5 101 5 102 calibration 5 35 commands 5 101 correction offset 5 101 output on off 5 64 power level 5 102 power sweep 5 102 5 103 5 104 power tracking the spectrum analyzer 5 104 5 105 trigger commands 5 129 delay 5 129 delay gate 5 98 external 5 129 gate 5 99 level gate 5 95 5 98 polarity gate 5 98 slope 5 129 source 5 130 video level 5 130 trigger measurement 5 54 trigger IEEE...

Reviews:

No comments

Brands by name

Popular brands

Load more brands