Keysight 53220A Programmer's Reference Manual

12 Commands by Subsystem 17 ABORt 18 AUToscale 19 FETCh? 20 INITiate[:IMMediate] 22 READ? 24 R? 26 CALCulate Subsystem Introduction 28 CALCulate1:SMOothing:RESPonse 32 CALCulate1:SMOothing:RESPonse 34 CALCulate1:SMOothing:RESPonse 36 CALCulate1:SMOothing:STATe 38 CALCulate1:SCALe:FUNCtion 39 CALCulate1:SCALe:FUNCtion 41 CALCulate1:SCALe:GAIN 43 CALCulate1:SCALe:INVert 45 CALCulate1:SCALe:OFFSet 46 CALCulate1:SCALe:REFerence 48 CALCulate1:SCALe:REFerence:AUTO 50 CALCulate1:SCALe:STATe 51 CALCulate1:SCALe:UNIT 52 CALCulate1:SCALe:UNIT:STATe 54 CALCulate1:LIMit:CLEar 55 CALCulate1:LIMit:CLEar 56 CALCulate1:LIMit:LOWer 57 CALCulate1:LIMit:STATe 59 CALCulate1:LIMit:UPPer 61 CALCulate1:AVERage:ADEViation? 63 CALCulate1:AVERage:ADEViation? 65 CALCulate1:AVERage:ALL? 67 CALCulate1:AVERage:AVERage? 69 CALCulate1:AVERage:CLEar 70 CALCulate1:AVERage:COUNt:CURRent? 71 CALCulate1:AVERage:MAXimum? 72 CALCulate1:AVERage:MINimum? 73 CALCulate1:AVERage:PTPeak? 74 CALCulate1:AVERage:SDEViation? 75 CALCulate1:AVERage:STATe 76 CALCulate1:STATe 77 2 Keysight 53220A/53230A Programmer's Reference

99 CALibration:ALL? 100 CALibration:COUNt? 101 CALibration:LEVel3? 103 CALibration:SECurity:CODE 105 CALibration:SECurity:STATe 106 CALibration:STRing 108 CALibration:VALue 110 CONFigure Subsystem Introduction 112 CONFigure:ARRay:TSTamp 115 CONFigure:FREQuency 117 CONFigure:FREQuency:BURSt 120 CONFigure:FREQuency:PRF 122 CONFigure:FREQuency:PRI 124 CONFigure:FREQuency:RATio 126 CONFigure:FTIMe 129 CONFigure:NDUTycycle 131 CONFigure:NWIDth 133 CONFigure:NWIDth:BURSt 135 CONFigure:PDUTycycle 136 CONFigure:PERiod 138 CONFigure:PHASe 141 CONFigure:PWIDth 143 CONFigure:PWIDth:BURSt 145 CONFigure:RTIMe 146 CONFigure:SPERiod 148 CONFigure:TINTerval 150 CONFigure:TOTalize:CONTinuous 152 CONFigure:TOTalize:TIMed 154 CONFigure? 156 Keysight 53220A/53230A Programmer's Reference 3

157 DATA:LAST? 158 DATA:POINts:EVENt:THReshold 159 DATA:POINts? 161 DATA:REMove? 162 DISPlay Subsystem Introduction 164 DISPlay:DIGit:MASK 165 DISPlay:DIGit:MASK:AUTO 166 DISPlay:MODE 167 DISPlay:STATe 168 DISPlay:TEXT:CLEar 169 DISPlay:TEXT 170 HCOPy Subsystem Introduction 171 HCOPy:SDUMp:DATA? 172 HCOPy:SDUMp:DATA:FORMat 173 FORMat Subsystem Introduction 174 FORMat:BORDer 175 FORMat:DATA 176 FORMat:PHASe 178 IEEE-488 Common Commands Introduction 179 *CAL? 180 *CLS 181 *ESE 182 *ESR? 184 *IDN? 186 *LRN? 187 *OPC 188 *OPC? 189 *OPT? 190 *RCL 192 *RST 193 *SAV 194 *SRE 195 *STB? 198 *TRG 200 *TST? 201 *WAI 202 INPut{1|2} Subsystem Introduction 203 INPut{1|2}:COUPling 204 INPut{1|2}:FILTer 205 INPut{1|2}:IMPedance 206 4 Keysight 53220A/53230A Programmer's Reference

228 LXI Subsystem Introduction 229 LXI:IDENtify:STATe 230 LXI:MDNS:ENABle 231 LXI:MDNS:HNAMe:RESolved? 232 LXI:MDNS:SNAMe:DESired 233 LXI:MDNS:SNAMe:RESolved? 234 LXI:RESet 235 LXI:RESTart 236 MEASure Subsystem Introduction 237 MEASure:ARRay:TSTamp? 240 MEASure:FREQuency? 242 MEASure:FREQuency:BURSt? 245 MEASure:FREQuency:PRF? 247 MEASure:FREQuency:PRI? 249 MEASure:FREQuency:RATio? 251 MEASure:FTIMe? 254 MEASure:NDUTycycle? 256 MEASure:NWIDth? 258 MEASure:NWIDth:BURSt? 260 MEASure:PDUTycycle? 261 MEASure:PERiod? 263 MEASure:PHASe? 266 MEASure:PWIDth? 268 MEASure:PWIDth:BURSt? 270 MEASure:RTIMe? 271 MEASure:SPERiod? 273 Keysight 53220A/53230A Programmer's Reference 5

279 MEMory:NSTates? 280 MEMory:STATe:DELete 281 MEMory:STATe:DELete:ALL 282 MEMory:STATe:RECall:AUTO 283 MEMory:STATe:RECall:SELect 285 MEMory:STATe:VALid? 287 MMEMory Subsystem Introduction 288 MMEMory:CATalog:ALL? 289 MMEMory:CATalog:DATA? 291 MMEMory:CATalog:STATe? 293 MMEMory:CDIRectory 295 MMEMory:COPY 297 MMEMory:DELete 298 MMEMory:DOWNload:DATA 299 MMEMory:DOWNload:FNAMe 300 MMEMory:LOAD:PREFerences 301 MMEMory:LOAD:STATe 303 MMEMory:MDIRectory 304 MMEMory:MOVE 305 MMEMory:RDIRectory 306 MMEMory:STORe:DATA 307 MMEMory:STORe:PREFerences 308 MMEMory:STORe:STATe 310 MMEMory:UPLoad? 311 OUTPut Subsystem Introduction 312 OUTPut:POLarity 313 OUTPut:STATe 314 SAMPle Subsystem Introduction 316 SAMPle:COUNt 317 SENSe Subsystem Introduction 319 SENSe:FUNCtion 322 SENSe:FREQuency:GATE:SOURce 324 SENSe:FREQuency:GATE:TIME 326 SENSe:FREQuency:GATE:POLarity 328 SENSe:FREQuency:MODE 329 SENSe:FREQuency:BURSt:GATE:AUTO 331 SENSe:FREQuency:BURSt:GATE:DELay 333 SENSe:FREQuency:BURSt:GATE:NARRow 335 6 Keysight 53220A/53230A Programmer's Reference

379 STATus:OPERation:CONDition? 382 STATus:OPERation:ENABle 384 STATus:OPERation:EVENt? 387 STATus:PRESet 389 STATus:QUEStionable:CONDition? 390 STATus:QUEStionable:ENABle 392 STATus:QUEStionable:EVENt? 395 SYSTem Subsystem Introduction 397 SYSTem:COMMunicate:ENABle 399 SYSTem:COMMunicate:ENABle 401 SYSTem:COMMunicate:GPIB:ADDRess 403 SYSTem:COMMunicate:LAN:CONTrol? 404 SYSTem:COMMunicate:LAN:DHCP 405 SYSTem:COMMunicate:LAN:DNS 407 SYSTem:COMMunicate:LAN:DOMain? 409 SYSTem:COMMunicate:LAN:GATeway 410 Keysight 53220A/53230A Programmer's Reference 7

462 TRIGger:COUNt 463 TRIGger:DELay 465 8 Keysight 53220A/53230A Programmer's Reference

470 Keysight 53220A/230A Command Quick Reference 479 Power-On and Reset State 491 Agilent 53131A/132A Compatibility Mode 496 Index 499 Keysight 53220A/53230A Programmer's Reference 9

Frequency Counter/Timer over a remote interface using the SCPI programming language. Introduction to the SCPI Language Commands by Subsystem Command Quick Reference SCPI Error Messages Power-On and Reset State Related Information IO Libraries and Instrument Drivers The Keysight IO Libraries Suite software is provided on the Keysight Automation Ready CD-ROM provided with your instrument. Installation instructions are provided on the CD-ROM. You can also download the Keysight IO Libraries Suite software, along with IVI-COM and LABview drivers from the Keysight Developer Network at adn.tm.agilent.com. Keysight 53220A/230A Documentation The Keysight 53220A/230A Programmer's Reference is provided as a Windows® Compiled Help (.chm) file on the Keysight 53220A/230A Product Reference CD-ROM shipped with your instrument. In addition, the following documents are available in Adobe® PDF format on this CD-ROM. (Requires Adobe Reader.) l Keysight 53220A/230A 350MHz Universal Counter/Timer Quick Start Tutorial l Keysight 53220A/230A 350MHz Universal Counter/Timer User’s Guide l Keysight 53210A/53220A/53230A 350 MHz Counter Service Guide You can also download these documents from the Web at www.keysight.com. For information about connecting instruments to USB, LAN, and GPIB interfaces and how to configure and troubleshoot these interfaces, refer to the Keysight USB/LAN/GPIB Interfaces Connectivity Guide. This guide is provided on the Keysight Automation Ready CD-ROM. Or you can download the guide from the Web at www.keysight.com/find/connectivity. Keysight 53220A/230A Web Interface Welcome 10 Keysight 53220A/53230A Programmer's Reference

interface over LAN for remote access and control of the instrument via a Java™-enabled Web browser, such as Microsoft® Internet Explorer. To access and use the 53220A/230A Web Interface: 1. Establish a LAN interface connection from your PC to the instrument (e.g. 53220A/230A). 2. Open your PC's Web browser. 3. Launch the instrument's Web Interface by entering the IP address of the instrument, or its fully-qual- ified host name, in the browser address field. 4. Follow the instructions in the Web Interface's on-line help. Example Programs We have included several example programs on the Keysight 53210A/53220A/53230A Product Refer- ence CD-ROM shipped with your instrument. The examples support the following language environments. l Microsoft® Visual Basic® l Microsoft® C++ l Keysight VEE l National Instruments LabVIEW To install the programming examples, see the Product Reference CD-ROM. Or, you can download the examples from the Web at www.keysight.com. Contact Keysight Technologies You can contact Keysight Technologies at one of the following telephone numbers for warranty, service, or technical support information. In the United States: (800) 829-4444 In Europe: 31 20 547 2111 In Japan: 0120-421-345 Or use our Web link for information on contacting Keysight worldwide. www.keysight.com/find/assist Or contact your Keysight Technologies Representative. Trademarks Microsoft®, Visual Basic®, and Windows® are U.S. registered trademarks of Microsoft Corporation. Adobe® and Acrobat®are trademarks of Adobe Systems Incorporated. Java™ is a U.S. trademark of Sun Microsystems, Inc. © Keysight Technologies, Inc. 2010-2014 Version 2.00 Keysight 53220A/53230A Programmer's Reference 11 Welcome

SCPI (Standard Commands for Programmable Instruments) is an ASCII-based instrument command lan- guage designed for test and measurement instruments. SCPI commands are based on a hierarchical struc- ture, also known as a tree system. In this system, associated commands are grouped together under a common node or root, thus forming subsystems. A portion of the SENSe subsystem is shown below to illustrate the tree system. SENSe: FUNCtion: [:ON] "function" [:ON]?          ROSCillator: EXTernal:FREQuency? SOURce { INTernal|EXTernal|AUTO } SENSe is the root keyword of the command, FUNCtion and ROSCillator are second-level keywords, and ON and SOURce are third-level keywords. A colon ( : ) separates a command keyword from a lower-level keyword. Syntax Conventions The format used to show commands is illustrated below: SAMPle:COUNt { | MINimum | MAXimum | DEFault} The command syntax shows most commands (and some parameters) as a mixture of upper- and lower- case letters. The upper-case letters indicate the abbreviated spelling for the command. For shorter pro- gram lines, you can send the abbreviated form. For better program readability, you can send the long form. For example, in the above syntax statement, SAMP and SAMPLE are both acceptable forms. You can use upper- or lower-case letters. Therefore, SAMPLE, samp, and Samp are all acceptable. Other forms, such as SAM and SAMPL, are not valid and will generate an error. l Braces ( { } ) enclose the parameter choices for a given command string. The braces are not sent with the com- mand string. l A vertical bar ( | ) separates multiple parameter choices for a given command string. For example, { |MINimum | MAXimum | DEFault} in the above command indicates that you can specify a numeric range para- meter, or "MINimum", "MAXimum", or "DEFault". The bar is not sent with the command string. l Triangle brackets ( < > ) indicate that you must specify a value for the enclosed parameter. For example, the above syntax statement shows the parameter enclosed in triangle brackets. The brackets are not sent with the command string. You must specify a value for the parameter (for example "SAMP:COUN 10") unless you select one of the other options shown in the syntax (for example "SAMP:COUN MIN"). l Some parameters are enclosed in square brackets ( [ ] ). This indicates that the parameter is optional and can be omitted. The brackets are not sent with the command string. If you do not specify a value for an optional parameter, the instrument chooses a default value. Introduction to the SCPI Language 12 Keysight 53220A/53230A Programmer's Reference

Certain commands have numeric suffixes appended to the command name. For example: INPut[{1|2}]: RANGe { | MINimum | MAXimum | DEFault} These suffixes distinguish multiple instances of the same subsystem. Note that the numeric suffix is optional; if it is omitted, "1" is assumed. In this example, INPut1 or INPut refers to channel 1; INPut2 refers to channel 2. Command Separators A colon ( : ) is used to separate a command keyword from a lower-level keyword. You must insert a blank space to separate a parameter from a command keyword. If a command requires more than one para- meter, you must separate adjacent parameters using a comma as shown below: CONF:FREQ 10.0E6,0.003 A semicolon ( ; ) is used to separate commands within the same subsystem, and can also minimize typing. For example, sending the following command string: TRIG:SOUR EXT; COUN 10 ... is the same as sending the following two commands: TRIG:SOUR EXT TRIG:COUN 10 Use a colon and a semicolon to link commands from different subsystems. For example, in the following command string, an error is generated if you do not use both the colon and semicolon: TRIG:COUN MIN;:SAMP:COUN MIN Using the MINimum, MAXimum, and DEFault Parameters For most commands, you can substitute "MINimum", "MAXimum" or "DEFault" in place of a parameter. For example, consider the following command: SAMPle:COUNt { | MINimum | MAXimum | DEFault} Instead of selecting a specific value for the parameter, you can substitute MIN to set the count to its minimum value, MAX to set the count to its maximum value, or DEF to set the count to its default value. Querying Parameter Settings You can query the current value of most parameters by adding a question mark ( ? ) to the command. For example, the following command sets the trigger count to 10 measurements: TRIG:COUN 10 Keysight 53220A/53230A Programmer's Reference 13 Introduction to the SCPI Language

TRIG:COUN? You can also query the minimum or maximum count allowed as follows: TRIG:COUN? MIN TRIG:COUN? MAX SCPI Command Terminators A command string sent to the instrument must terminate with a () character. The IEEE- 488 EOI (End-Or-Identify) message is interpreted as a character and can be used to terminate a com- mand string in place of a character. A followed by a is also accepted. Com- mand string termination will always reset the current SCPI command path to the root level. For every SCPI message that includes a query and is sent to the instrument, the instrument terminates the returned response with a or line-feed character (EOI). For example, if R? is sent, the response is terminated with a after the block of data that is returned. If a SCPI message includes multiple queries separated by semicolons (for example "SYST:ERR?;R?"), the returned response is again terminated by a after the response to the last query. In either case, the program must read this in the response before another command is sent to the instrument, or an error will occur. IEEE-488.2 Common Commands The IEEE-488.2 standard defines a set of common commands that perform functions such as reset, self- test, and status operations. Common commands always begin with an asterisk ( * ), are three characters in length, and may include one or more parameters. The command keyword is separated from the first para- meter by a blank space. Use a semicolon ( ; ) to separate multiple commands as shown below: *RST; *CLS; *ESE 32; *OPC? SCPI Parameter Types The SCPI language defines several data formats to be used in program messages and response messages. Numeric Parameters Commands that require numeric parameters will accept all commonly used decimal representations of numbers including optional signs, decimal points, and scientific notation. Special values for numeric para- meters such as MINimum, MAXimum, and DEFault are also accepted. You can also send engineering unit suffixes with numeric parameters (e.g., M, k, m, or u). If a command accepts only certain specific values, the instrument will automatically round the input numeric parameters to the accepted values. The fol- lowing command requires a numeric parameter for the count value: SAMPle:COUNt { | MINimum | MAXimum | DEFault} Introduction to the SCPI Language 14 Keysight 53220A/53230A Programmer's Reference

"m"). For your convenience, the instrument interprets "mS" (or "MS") as milliseconds, but "MHZ" (or "mhz") as megahertz. You can use the prefix "MA" for mega. For example, "MAS" is interpreted as megaseconds. Discrete Parameters Discrete parameters are used to program settings that have a limited number of values (like IMMediate, EXTernal, or BUS). They have a short form and a long form just like command keywords. You can mix upper- and lower-case letters. Query responses will always return the short form in all upper-case letters. The following command requires a discrete parameters for the temperature units: INPut:LEVel:AUTO {OFF | ON | ONCE} Boolean Parameters Boolean parameters represent a single binary condition that is either true or false. For a false condition, the instrument will accept "OFF" or "0". For a true condition, the instrument will accept "ON" or "1". When you query a boolean setting, the instrument will always return "0" or "1". The following command requires a boolean parameter: INPut:NREJect {OFF | 0 | ON | 1} ASCII String Parameters String parameters can contain virtually any set of ASCII characters. A string must begin and end with matching quotes; either with a single quote or a double quote. You can include the quote delimiter as part of the string by typing it twice without any characters in between. The following command uses a string parameter: DISPlay:TEXT For example, the following command displays the message "WAITING..." on the instrument's front panel (the quotes are not displayed). DISP:TEXT "WAITING..." You can also display the same message using the following command with single quotes. DISP:TEXT 'WAITING...' Using Device Clear Device Clear is an IEEE-488 low-level bus message that you can use to return the instrument to a respons- ive state. Different programming languages and IEEE-488 interface cards provide access to this capability through their own unique commands. The status registers, the error queue, and all configuration states are left unchanged when a Device Clear message is received. Keysight 53220A/53230A Programmer's Reference 15 Introduction to the SCPI Language

l If a measurement is in progress, it is aborted. l The instrument returns to the trigger "idle" state. l The instrument's input and output buffers are cleared. l The instrument is prepared to accept a new command string. l An overlapped command, if any, will be terminated with no "Operation Complete" indication (applies to the INIT command). The ABORt command is the recommended method to terminate a measurement. Introduction to the SCPI Language 16 Keysight 53220A/53230A Programmer's Reference

Other Commands CALCulate Subsystem CALibration Subsystem CONFigure Subsystem DATA Subsystem DISPlay Subsystem FORMat Subsystem HCOPy Subsystem IEEE-488.2 Common Commands INPut Subsystem LXI Subsystem MEASure Subsystem MEMory Subsystem MMEMory Subsystem OUTPut Subsystem SAMPle Subsystem SENSe Subsystem STATus Subsystem SYSTem Subsystem TRIGger Subsystem Keysight 53220A/53230A Programmer's Reference 17 Commands by Subsystem

Remarks l This command may be useful to abort a measurement when the instrument is waiting for a trigger, for a long measurement (for example, 1000 sec gate time), or for a long series of timed measurements. l The command will abort a measurement in progress and stop, returning the instrument to the trigger idle state. l The *RST command will abort a measurement and set all measurement parameters to their factory set- tings. The Instrument Preset (SYSTem:PRESet command) does the same. Example The following example aborts the measurement in progress. ABOR See Also *RST SYSTem:PRESet ABORt 18 Keysight 53220A/53230A Programmer's Reference

adjust the input threshold, input range, and internal measurement hardware settings based on the input signal levels and frequency. Remarks l You should select the measurement function and active input channel(s) prior to sending the AUTo- scale command. Example The following example configures a frequency measurement, performs an autoscale, and makes a meas- urement on channel 1. CONF:FREQ AUT READ? Typical Response: +1.21513398300000E+006 See Also *RST SYSTem:PRESet Keysight 53220A/53230A Programmer's Reference 19 AUToscale

your computer. The measurements are not erased from memory when you read them. You can send the command multiple times to retrieve the same data in reading memory. Remarks l The FETCh? command will wait until all measurements complete to terminate. l If no measurements are available or in progress, error -230,"Data corrupt or stale" will be generated, and no data will be returned. l You can store up to 1,000,000 measurements in the reading memory. If memory overflows, the new measurements will overwrite the first (oldest) measurements stored; the most recent measurements are always preserved. No error is generated, but the Reading Mem Ovfl bit (bit 14) is set in the Questionable Data Register. l You can use the R? command to obtain whatever measurements are present (with no wait), but the measurements will be erased as you read them. l The instrument clears all measurements from memory when the measurement function is changed, when the INITiate:IMMediate, MEASure:? or READ? commands are executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The command transfers all measurements from memory but does not erase them. The format of the meas- urements is controlled by the FORMat Subsystem commands. For timestamp measurements, the command returns the prescaler value followed by a comma, followed by the measurements. The prescaler value is always returned in the format: +100. The format of the measurements is controlled by the FORMat Subsystem commands. Example The following program segment shows how to use the FETCh? command with the CONFigure and INITiate commands. The INITiate command places the instrument in the "wait-for-trigger" state, triggers a meas- urement when the rear-panel Trig In BNC is pulsed (low by default), and then sends the measurements to memory. The FETCh? command transfers the measurements from memory to the instrument's output buf- fer. CONF:FREQ 1200,0.003 TRIG:SOUR EXT FETCh? 20 Keysight 53220A/53230A Programmer's Reference

See Also INITiate[:IMMediate] Keysight 53220A/53230A Programmer's Reference 21 FETCh?

state. Measurements will begin when the specified trigger conditions are satisfied following the receipt of the INITiate command. Note that the INITiate command also clears the previous set of measurements from memory. Remarks l Storing measurements in memory using the INITiate command is faster than sending measurements to the output buffer using the READ? command. The INITiate command is also an "overlapped" com- mand. This means that after executing the INITiate command, you can send other commands that do not affect the measurements. l You can store up to 1,000,000 measurements in the reading memory. If memory overflows, the new measurements will overwrite the first (oldest) measurements stored; the most recent measurements are always preserved. No error is generated, but the Reading Mem Ovfl bit (bit 14) is set in the Questionable Data Register. l To retrieve the measurements from memory, use the FETCh? command. Use DATA:REMove? to remove data points. Or use the R? command to read and remove all of the available data. l The ABORt command may be used to return to idle. Example The following program segment shows how to use the INITiate command with the CONFigure and FETCh? commands. The INITiate command places the instrument in the "wait-for-trigger" state, triggers a meas- urement when the rear-panel Trig In BNC is pulsed (low by default), and then sends the measurements to memory. The FETCh? command transfers the measurements from memory to the instrument's output buf- fer. CONF:FREQ 4000 TRIG:SOUR EXT INIT FETC? Typical Response: +1.21513398300000E+006 See Also FETCh? READ? INITiate[:IMMediate] 22 Keysight 53220A/53230A Programmer's Reference

state. Measurements will begin when the specified trigger conditions are satisfied following the receipt of the READ? command. Measurements are then sent immediately to the reading memory and the instru- ment's output buffer. Remarks l Sending the READ? command is similar to sending the INITiate command followed immediately by the FETCh? command. l You can store up to 1,000,000 measurements in the reading memory. If memory overflows, the new measurements  will overwrite the first (oldest) measurements stored; the most measurements are always preserved. No error is generated, but the Reading Mem Ovfl bit (bit 14) is set in the Questionable Data Register. l The instrument clears all measurements from memory when the measurement function is changed, when the INITiate:IMMediate, MEASure:? or READ? commands are executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The command sends measurements directly to reading memory and the instrument's output buffer. The format of the measurements is affected by the FORMat Subsystem commands. For timestamp measurements, the command returns the prescaler value followed by a comma, followed by the measurements. The prescaler value is always returned in the format: +100. The format of the measurements is controlled by the FORMat Subsystem commands. Examples The following program segment shows how to use the READ? command with the CONFigure command. The READ? command places the instrument in the "wait-for-trigger" state, triggers a measurement when the rear-panel Trig In BNC is pulsed (low by default), sends the measurements to memory, and then trans- fers the measurements to the instrument output buffer. CONF:FREQ 1.0E6,.001 TRIG:SOUR EXT READ? Typical Response: +1.21513398300000E+006 READ? 24 Keysight 53220A/53230A Programmer's Reference

25 READ?

The measurements are erased from memory starting with the oldest (not the most recent) measurement first. The purpose of this command is to allow you to periodically remove measurements from memory that would normally cause reading memory to overflow. Parameters Name Type Range of Values Default Value Numeric 1 to 1,000,000 Read and erase all stored measurements Remarks l You can read memory at any time using the R? command, even during a measurement. l If no measurements are available or in progress, error -230,"Data corrupt or stale" will be generated, and no data will be returned. l This command differs from the DATA:REMove? command in that R? will read and erase whatever meas- urements are available in reading memory, up to the specified . DATA:REMove will error if the requested number of measurements are not in reading memory when the command is sent. l You can store up to 1,000,000 measurements in the reading memory. If memory overflows, the new measurements will overwrite the first (oldest) measurements stored; the most recent measurements are always preserved. No error is generated, but the Reading Mem Ovfl bit (bit 14) is set in the Questionable Data Register. l The instrument clears all measurements from memory when the measurement function is changed, when the INITiate:IMMediate, MEASure:? or READ? commands are executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The command returns a series of measurements in Definite-Length Block format. The syntax is a pound sign (#) followed by a non-zero digit representing the number of digits in the decimal integer to follow. This digit is followed by a decimal integer indicating the number of 8-bit data bytes to follow. This is fol- lowed by a block of data containing the specified number of bytes. The return format is determined by the FORMat Subsystem commands. For timestamp measurements, the command returns the prescaler value followed by a comma, followed by the measurements. The prescaler value is always returned in the format: +100. The measurements are returned in the Definite-Length Block format described above. R? 26 Keysight 53220A/53230A Programmer's Reference

FORM:DAT ASC R? 2 Typical Response: #243+1.21513398300000E+006,+1.21513392700000E+006 See Also DATA:REMove? FETCh? FORMat:BORDer FORMat:DATA Keysight 53220A/53230A Programmer's Reference 27 R?

The CALCulate subsystem receives real-time data from the measurement hardware and optionally per- forms scaling and offset, statistics computation and/or limit checking. The data flow is show below: CALCulate Subsystem Introduction 28 Keysight 53220A/53230A Programmer's Reference

late1:STATe OFF is set, no calculations are performed on the measurements, and the measurements will flow directly to the reading memory. If CALCulate1:STATe ON is set, only those calculations enabled by CALCulate1:SCALe:STATe, CALCu- late1:LIMit:STATe, and CALCulate1:AVERage:STATe are performed. If enabled, scaling and offset is per- formed first, with the results of the scaling and offset operation then being passed to the reading memory, limit checking and statistics computations. Histogram computation is enabled or disabled by the CALCulate2:TRANsform:HISTogram:STATe com- mand, independent of the CALCulate1 subsystem. Command Summary Enable Functions CALCulate1:STATe CALCulate1:STATe? CALCulate1:SMOothing:STATe CALCulate1:SMOothing:STATe? CALCulate1:SCALe:STATe CALCulate1:SCALe:STATe? CALCulate1:LIMit:STATe? CALCulate1:LIMit:STATe? CALCulate1:AVERage:STATe CALCulate1:AVERage:STATe? CALCulate2:TRANsform:HISTogram:STATe CALCulate2:TRANsform:HISTogram:STATe? Moving Average Filter Functions CALCulate1:SMOothing:RESPonse CALCulate1:SMOothing:RESPonse? CALCulate1:SMOothing:STATe CALCulate1:SMOothing:STATe? Scaling (Mx-B) Functions CALCulate1:SCALe:FUNCtion CALCulate1:SCALe:FUNCtion? CALCulate1:SCALe:GAIN CALCulate1:SCALe:GAIN? Keysight 53220A/53230A Programmer's Reference 29 CALCulate Subsystem Introduction

30 Keysight 53220A/53230A Programmer's Reference

31 CALCulate Subsystem Introduction

CALCulate[1]:SMOothing:RESPonse? Description This command selects the number of measurements to be averaged by the moving average (boxcar) filter. l SLOW selects 100 measurements. l MEDium selects 50 measurements. l FAST selects 10 measurements. Remarks l The smoothing (moving average) filter produces one result for each measurement made. l The smoothing (moving average) filter is reset when the measurement function or channel changes, by INITiate:IMMediate, READ?, and the MEASure? subsystem commands, or if a measurement is outside a fixed range from the current average. The amount of measurement change required to reset the filter is: Filter Response Time Change required to reset SLOW ±100 ppm MEDium ±300 ppm FAST ±1000 ppm l After the smoothing (moving average) filter is reset, the filter produces results which are the average of all measurements made after the reset, until the required number of measurements are made as selec- ted by CALCulate1:SMOothing:RESPonse. Once the required number measurements are made, the res- ults are the moving average of the last 10, 50, or 100 measurements. Equal weighting is applied to all measurements used in the average. l The instrument sets the response time to FAST after a Factory Reset (*RST command) or after an Instru- ment Preset (SYSTem:PRESet command). Return Format The query returns the response time: SLOW, MED, or FAST. Examples The following example enables a 50-point moving average filter on 1000 frequency measurements. CALCulate1:SMOothing:RESPonse 32 Keysight 53220A/53230A Programmer's Reference

See Also CALCulate1:SMOothing:STATe CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 33 CALCulate1:SMOothing:RESPonse

CALCulate[1]:SMOothing:RESPonse? Description This command selects the number of measurements to be averaged by the moving average (boxcar) filter. l SLOW selects 100 measurements. l MEDium selects 50 measurements. l FAST selects 10 measurements. Remarks l The smoothing (moving average) filter produces one result for each measurement made. l The smoothing (moving average) filter is reset when the measurement function or channel changes, by INITiate:IMMediate, READ?, and the MEASure? subsystem commands, or if a measurement is outside a fixed range from the current average. The amount of measurement change required to reset the filter is: Filter Response Time Change required to reset SLOW ±100 ppm MEDium ±300 ppm FAST ±1000 ppm l After the smoothing (moving average) filter is reset, the filter produces results which are the average of all measurements made after the reset, until the required number of measurements are made as selec- ted by CALCulate1:SMOothing:RESPonse. Once the required number measurements are made, the res- ults are the moving average of the last 10, 50, or 100 measurements. Equal weighting is applied to all measurements used in the average. l The instrument sets the response time to FAST after a Factory Reset (*RST command) or after an Instru- ment Preset (SYSTem:PRESet command). Return Format The query returns the response time: SLOW, MED, or FAST. Examples The following example enables a 50-point moving average filter on 1000 frequency measurements. CALCulate1:SMOothing:RESPonse 34 Keysight 53220A/53230A Programmer's Reference

See Also CALCulate1:SMOothing:STATe CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 35 CALCulate1:SMOothing:RESPonse

CALCulate[1]:SMOothing:RESPonse? Description This command selects the number of measurements to be averaged by the moving average (boxcar) filter. l SLOW selects 100 measurements. l MEDium selects 50 measurements. l FAST selects 10 measurements. Remarks l The smoothing (moving average) filter produces one result for each measurement made. l The smoothing (moving average) filter is reset when the measurement function or channel changes, by INITiate:IMMediate, READ?, and the MEASure? subsystem commands, or if a measurement is outside a fixed range from the current average. The amount of measurement change required to reset the filter is: Filter Response Time Change required to reset SLOW ±100 ppm MEDium ±300 ppm FAST ±1000 ppm l After the smoothing (moving average) filter is reset, the filter produces results which are the average of all measurements made after the reset, until the required number of measurements are made as selec- ted by CALCulate1:SMOothing:RESPonse. Once the required number measurements are made, the res- ults are the moving average of the last 10, 50, or 100 measurements. Equal weighting is applied to all measurements used in the average. l The instrument sets the response time to FAST after a Factory Reset (*RST command) or after an Instru- ment Preset (SYSTem:PRESet command). Return Format The query returns the response time: SLOW, MED, or FAST. Examples The following example enables a 50-point moving average filter on 1000 frequency measurements. CALCulate1:SMOothing:RESPonse 36 Keysight 53220A/53230A Programmer's Reference

See Also CALCulate1:SMOothing:STATe CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 37 CALCulate1:SMOothing:RESPonse

CALCulate[1]:SMOothing[:STATe]? Description This command enables or disables a smoothing (moving average) filter on the measurements. Remarks l The CALCulate1 subsystem must also be enabled by CALCulate1:STATe for smoothing (moving aver- age) to be performed. l The smoothing (moving average) filter is disabled for continuous totalize since this computation requires more than one measurement to be useful. l The CALCulate subystem and the individual calculate functions are disabled for timestamp meas- urements. l The instrument disables the smoothing (moving average) filter after a Factory Reset (*RST command) or an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the current smoothing (moving average) filter state: 0 (OFF) or 1 (ON). Examples The following example enables a 50-point moving average filter on 1000 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 1000 CALC:SMO:RESP MED CALC:SMO:STAT ON CALC:STAT ON READ? Typical Response: +9.99383828200000E+06,+9.99352315400000E+06,... (1000 measurements) See Also CALCulate1:SMOothing:RESPonse CALCulate1:STATe CALCulate1:SMOothing:STATe 38 Keysight 53220A/53230A Programmer's Reference

CALCulate[1]:SCALe:FUNCtion? Description This command selects the operation that will be performed by the scaling function: l NULL performs a simple null operation. The result will be the measurement minus the reference value. l PCT performs a percent change operation. The result will be the percent change of the measurement from the reference value. l PPM performs a parts per million change operation. The result will be the change of the measurement from the reference value expressed in parts per million. l PPB performs a parts per billion (109) change operation. The result will be the change of the meas- urement from the reference value expressed in parts per billion. l SCALe performs a Mx-B operation. The result is the measurement multiplied by the gain value M (CALCulate1:SCALe:GAIN command) minus the offset value B (CALCulate1:SCALe:OFFSet). If CALCu- late1:SCALe:INVert is enabled (set to ON), the measurement will first be inverted (1/x), resulting in a M/x-B operation. Remarks l For the NULL, PCT, PPM, and PPB operations, the reference value is specified by the CALCu- late1:SCALe:REFerence command. If no reference value has been specified, the first measurement will be used as the reference value. l Scaling function results must be in the range of -1.0E+24 to -1.0E-24, 0.0, or +1.0E-24 to 1.0E+24. Results outside these limits will be replaced with -9.9E+37 (negative infinity), 0, or +9.9E+37 (positive infinity), as appropriate. l The instrument resets the function to NULL after a Factory Reset (*RST command) or an Instrument Pre- set (SYSTem:PRESet command). Return Format The query returns the scaling function in the form: NULL, PCT, PPM, PPB or SCAL. Keysight 53220A/53230A Programmer's Reference 39 CALCulate1:SCALe:FUNCtion

taken. CALC:SCAL:FUNC PCT CALC:SCAL:STAT ON CALC:STAT ON See Also CALCulate1:SCALe:GAIN CALCulate1:SCALe:OFFset CALCulate1:SCALe:INVert CALCulate1:SCALe:REFerence CALCulate1:SCALe:REFerence:AUTO CALCulate1:SCALe:STATE CALCulate1:STATe CALCulate1:SCALe:FUNCtion 40 Keysight 53220A/53230A Programmer's Reference

CALCulate[1]:SCALe:FUNCtion? Description This command selects the operation that will be performed by the scaling function: l NULL performs a simple null operation. The result will be the measurement minus the reference value. l PCT performs a percent change operation. The result will be the percent change of the measurement from the reference value. l PPM performs a parts per million change operation. The result will be the change of the measurement from the reference value expressed in parts per million. l PPB performs a parts per billion (109) change operation. The result will be the change of the meas- urement from the reference value expressed in parts per billion. l SCALe performs a Mx-B operation. The result is the measurement multiplied by the gain value M (CALCulate1:SCALe:GAIN command) minus the offset value B (CALCulate1:SCALe:OFFSet). If CALCu- late1:SCALe:INVert is enabled (set to ON), the measurement will first be inverted (1/x), resulting in a M/x-B operation. Remarks l For the NULL, PCT, PPM, and PPB operations, the reference value is specified by the CALCu- late1:SCALe:REFerence command. If no reference value has been specified, the first measurement will be used as the reference value. l Scaling function results must be in the range of -1.0E+24 to -1.0E-24, 0.0, or +1.0E-24 to 1.0E+24. Results outside these limits will be replaced with -9.9E+37 (negative infinity), 0, or +9.9E+37 (positive infinity), as appropriate. l The instrument resets the function to NULL after a Factory Reset (*RST command) or an Instrument Pre- set (SYSTem:PRESet command). Return Format The query returns the scaling function in the form: NULL, PCT, PPM, PPB or SCAL. Keysight 53220A/53230A Programmer's Reference 41 CALCulate1:SCALe:FUNCtion

taken. CALC:SCAL:FUNC PCT CALC:SCAL:STAT ON CALC:STAT ON See Also CALCulate1:SCALe:GAIN CALCulate1:SCALe:OFFset CALCulate1:SCALe:INVert CALCulate1:SCALe:REFerence CALCulate1:SCALe:REFerence:AUTO CALCulate1:SCALe:STATE CALCulate1:STATe CALCulate1:SCALe:FUNCtion 42 Keysight 53220A/53230A Programmer's Reference

CALCulate[1]:SCALe:GAIN? [{MINimum | MAXimum | DEFault}] Description This command sets the gain value M for the Mx-B scaling function. Parameters Name Type Range of Values Default Value Numeric -1.0E+15 to -1.0E-15, 0.0 +1.0E-15 to 1.0E+15 MIN = -1.0E+15 MAX = +1.0E+15 1.0 Remarks l CALCulate1:SCALe:GAIN sets the gain value M. CALCulate1:SCALe:OFFset sets the offset value B. l After setting the gain and offset values, use the CALCulate1:SCALe:STATe command to enable the scal- ing function. l Scaling function results must be in the range of -1.0E+24 to -1.0E-24, 0.0, or +1.0E-24 to 1.0E+24. Results outside these limits will be replaced with -9.9E+37 (negative infinity), 0, or +9.9E+37 (positive infinity), as appropriate. l The instrument resets the gain to 1.0 after a Factory Reset (*RST command) or an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the gain value in the form +1.00000000000000E+000. Examples The following example enables the scaling function using the equation 100x-5. CALC:SCAL:GAIN 100.0 CALC:SCAL:OFFS 5.0 CALC:SCAL:STAT ON CALC:STAT ON Keysight 53220A/53230A Programmer's Reference 43 CALCulate1:SCALe:GAIN

CALCulate[1]:SCALe:INVert? Description This command enables or disables 1/x inversion of the incoming reading. This inversion is done before the Mx-B scaling function; the scaling function thus effectively becomes M/x-B. Remarks l The instrument disables inversion after a Factory Reset (*RST command) or an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the current scale and offset state: 0 (OFF) or 1 (ON). Examples The following example enables the scaling function using the equation 100/x-5. CALC:SCAL:INV ON CALC:SCAL:GAIN 100.0 CALC:SCAL:OFFS 5.0 CALC:SCAL:STAT ON CALC:STAT ON See Also CALCulate1:SCALe:FUNCtion CALCulate1:SCALe:STATE CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 45 CALCulate1:SCALe:INVert

CALCulate[1]:SCALe:OFFSet? [{MINimum | MAXimum | DEFault}] Description This command sets the offset value B for the Mx-B scaling function. Parameters Name Type Range of Values Default Value Numeric -1.0E+15 to -1.0E-15, 0.0 +1.0E-15 to 1.0E+15 MIN = -1.0E+15 MAX = +1.0E+15 0.0 Remarks l Note that the offset value is subtractive, not additive. l CALCulate1:SCALe:GAIN sets the gain value M. CALCulate1:SCALe:OFFset sets the offset value B. l After setting the gain and offset values, use the CALCulate1:SCALe:STATe command to enable the scal- ing function. l Scaling function results must be in the range of -1.0E+24 to -1.0E-24, 0.0, or +1.0E-24 to 1.0E+24. Results outside these limits will be replaced with -9.9E+37 (negative infinity), 0, or +9.9E+37 (positive infinity), as appropriate. l The instrument resets the offset to 0.0 after a Factory Reset (*RST command) or an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the offset value in the form +1.00000000000000E+006. Examples The following example enables the scaling function using the equation 100x-5. CALC:SCAL:GAIN 100.0 CALC:SCAL:OFFS 5.0 CALC:SCAL:STAT ON CALC:STAT ON CALCulate1:SCALe:OFFSet 46 Keysight 53220A/53230A Programmer's Reference

47 CALCulate1:SCALe:OFFSet

CALCulate[1]:SCALe:REFerence? [{MINimum | MAXimum | DEFault}] Description This command sets the reference value for the NULL, PCT, PPM, and PPB operations. Parameters Name Type Range of Values Default Value Numeric -1.0E+15 to -1.0E-15, 0.0 +1.0E-15 to 1.0E+15 MIN = -1.0E+15 MAX = +1.0E+15 0.0 Remarks l Specifying a reference value disables automatic reference selection (CALCu- late1:SCALe:REFerence:AUTO set to OFF). l If automatic reference selection is enabled, the reference value will be set to the first measurement that is made. l Scaling function results must be in the range of -1.0E+24 to -1.0E-24, 0.0, or +1.0E-24 to 1.0E+24. Results outside these limits will be replaced with -9.9E+37 (negative infinity), 0, or +9.9E+37 (positive infinity), as appropriate. l The instrument sets the reference value to 0.0 with automatic reference selection enabled after a Fact- ory Reset (*RST command) or an Instrument Preset (SYSTem:PRESet command)) Return Format The query returns the reference value in the form +0.00000000000000E+000. Examples The following example enables the NULL scaling function. The first measurement will be used as the ref- erence value. CALC:SCAL:FUNC NULL CALC:SCAL:REF:AUTO ON CALC:SCAL:STAT ON CALC:STAT ON READ? CALCulate1:SCALe:REFerence 48 Keysight 53220A/53230A Programmer's Reference

CALC:SCAL:FUNC NULL CALC:SCAL:REF 100.0 CALC:SCAL:STAT ON CALC:STAT ON READ? See Also CALCulate1:SCALe:FUNCtion CALCulate1:SCALe:REFerence:AUTO CALCulate1:SCALe:STATE CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 49 CALCulate1:SCALe:REFerence

CALCulate[1]:SCALe:REFerence:AUTO? Description This command enables or disables automatic reference selection for the NULL, PCT, PPM, and PPB scal- ing functions. l When automatic reference selection is enabled (ON), the first measurement made will be used as the ref- erence for all subsequent measurements. CALCulate1:SCALe:REFerence will be set to this value, and automatic reference selection will be disabled. l When automatic reference selection is disabled (OFF), CALCulate1:SCALe:REFerence specifies the ref- erence value. Remarks l The instrument enables automatic reference selection after a Factory Reset (*RST command) or an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the current scaling state: 0 (OFF) or 1 (ON). Examples The following example enables the NULL function with automatic reference selection enabled. CALC:SCAL:FUNC NULL CALC:SCAL:REF:AUTO ON CALC:SCAL:STAT ON CALC:STAT ON See Also CALCulate1:SCALe:FUNCtion CALCulate1:SCALe:REFerence CALCulate1:SCALe:STATe CALCulate1:STATe CALCulate1:SCALe:REFerence:AUTO 50 Keysight 53220A/53230A Programmer's Reference

CALCulate[1]:SCALe[:STATe]? Description This command enables or disables the scaling function. Remarks l The CALCulate1 subsystem must also be enabled by CALCulate1:STATe for scaling to be performed. l The CALCulate subystem and the individual calculate functions are disabled for timestamp meas- urements. l The instrument disables the scaling function state after a Factory Reset (*RST command) or an Instru- ment Preset (SYSTem:PRESet command). Return Format The query returns the current scaling state: 0 (OFF) or 1 (ON). Examples The following example enables scaling using the equation 100x-5. CALC:FUNC SCAL CALC:SCAL:GAIN 100.0 CALC:SCAL:OFFS 5.0 CALC:SCAL:INV OFF CALC:SCAL:STAT ON CALC:STAT ON See Also CALCulate1:SCALe:FUNCtion CALCulate1:SCALe:GAIN CALCulate1:SCALe:OFFset CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 51 CALCulate1:SCALe:STATe

ing function is enabled. Parameters Name Type Range of Values Default Value "" string one to four characters "" (null string) Remarks l CALCulate1:SCALe:UNIT:STATe controls whether the unit string is displayed. l The instrument resets the units to the null string after a Factory Reset (*RST command) or an Instru- ment Preset (SYSTem:PRESet command). Return Format The query returns the unit string in double quotes. Examples The following example enables the scaling function using the equation 100x-5 and displays "PSI" with measurements on the front panel. CALC:SCAL:GAIN 100.0 CALC:SCAL:OFFS 5.0 CALC:SCAL:UNIT "PSI" CALC:SCAL:UNIT:STAT ON CALC:SCAL:STAT ON CALC:STAT ON See Also CALCulate1:SCALe:STATE CALCulate1:STATe CALCulate1:SCALe:UNIT 52 Keysight 53220A/53230A Programmer's Reference

CALCulate[1]:SCALe:UNIT:STATe? Description This command enables or disables displaying the unit string with measurements on the front panel when the scaling function is enabled. Remarks l CALCulate1:SCALe:UNIT specifies the unit string to be displayed. l The instrument disables displaying the unit string after a Factory Reset (*RST command) or an Instru- ment Preset (SYSTem:PRESet command). Return Format The query returns the current unit string display state: 0 (OFF) or 1 (ON). Examples The following example enables the scaling function using the equation 100x-5 and displays "PSI" with measurements on the front panel. CALC:SCAL:GAIN 100.0 CALC:SCAL:OFFS 5.0 CALC:SCAL:UNIT "PSI" CALC:SCAL:UNIT:STAT ON CALC:SCAL:STAT ON CALC:STAT ON See Also CALCulate1:SCALe:STATE CALCulate1:STATe CALCulate1:SCALe:UNIT CALCulate1:SCALe:UNIT:STATe 54 Keysight 53220A/53230A Programmer's Reference

12 ("Upper Limit Failed") in the condition register of the Questionable Data Register group. The cor- responding bits in the event register are unaffected. Remarks l This command does not clear measurements in the reading memory. l The instrument turns off the front panel Limit annunciator and clears bits 11 and 12 in the condition register of the Questionable Data Register group when CALCulate1:LIMit:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:LIMit:CLEar command is executed, after a Factory Reset (*RST com- mand) or after an Instrument Preset (SYSTem:PRESet command). Examples The following example clears the limit test results. CALC:LIM:CLE See Also CALCulate1:LIMit:STATe CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 55 CALCulate1:LIMit:CLEar

12 ("Upper Limit Failed") in the condition register of the Questionable Data Register group. The cor- responding bits in the event register are unaffected. Remarks l This command does not clear measurements in the reading memory. l The instrument turns off the front panel Limit annunciator and clears bits 11 and 12 in the condition register of the Questionable Data Register group when CALCulate1:LIMit:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:LIMit:CLEar command is executed, after a Factory Reset (*RST com- mand) or after an Instrument Preset (SYSTem:PRESet command). Examples The following example clears the limit test results. CALC:LIM:CLE See Also CALCulate1:LIMit:STATe CALCulate1:STATe CALCulate1:LIMit:CLEar 56 Keysight 53220A/53230A Programmer's Reference

CALCulate[1]:LIMit:LOWer[:DATA]? [{MINimum | MAXimum | DEFault}] Description This command sets the lower limit for limit testing. Parameters Name Type Range of Values Default Value Numeric -1.0E+15 to -1.0E-15, 0.0 +1.0E-15 to 1.0E+15 MIN = -1.0E+15 MAX = +1.0E+15 0.0 Remarks l Limit crossing: If a measurement is less than the specified lower limit, bit 11 ("Lower Limit Failed") is set in the Questionable Data Register, which results in an SRQ if enabled. You can use the STATus:QUES- tionable:EVENt? command to read the event register. See STATus Subsystem Introduction for further information. l The instrument sets the lower limit to 0.0 after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the lower limit in the form +1.00000000000000E+006. Examples The following example enables limit testing of 100 frequency measurements and returns an indication whether measurements were outside of the range of 9.9MHz to 10.1MHz. Measurements above 10.1MHz will set bit 12 (Upper Limit Failed) of the questionable status register; measurements below 9.9MHz will set bit 11 (Lower Limit Failed). *CLS STAT:PRES CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:LIM:LOW 9.9E6 CALC:LIM:UPP 10.1E6 Keysight 53220A/53230A Programmer's Reference 57 CALCulate1:LIMit:LOWer

See Also CALCulate1:LIMit:UPPer CALCulate1:STATe STATus Subsystem Introduction CALCulate1:LIMit:LOWer 58 Keysight 53220A/53230A Programmer's Reference

CALCulate[1]:LIMit[:STATe]? Description This command enables or disables limit testing. Remarks l The CALCulate1 subsystem must also be enabled by CALCulate1:STATe for limit testing to be per- formed. l The CALCulate subystem and the individual calculate functions are disabled for timestamp meas- urements. l The instrument clears the front panel Limit annunciator and bits 11 and 12 in the Questionable Data Register when CALCulate1:LIMit:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCu- late1:LIMit:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). l The instrument disables limit testing after a Factory Reset (*RST command) or an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the current limit state: 0 (OFF) or 1 (ON). Examples The following example enables limit testing of 100 frequency measurements and returns an indication whether measurements were outside of the range of 9.9MHz to 10.1MHz. Measurements above 10.1MHz will set bit 12 (Upper Limit Failed) of the questionable status register; measurements below 9.9MHz will set bit 11 (Lower Limit Failed). *CLS STAT:PRES CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:LIM:LOW 9.9E6 CALC:LIM:UPP 10.1E6 CALC:LIM:STAT ON CALC:STAT ON INIT Keysight 53220A/53230A Programmer's Reference 59 CALCulate1:LIMit:STATe

See Also CALCulate1:LIMit:CLEar CALCulate1:STATe CALCulate1:LIMit:STATe 60 Keysight 53220A/53230A Programmer's Reference

CALCulate[1]:LIMit:UPPer[:DATA]? [{MINimum | MAXimum | DEFault}] Description This command sets the upper limit for limit testing. Parameters Name Type Range of Values Default Value Numeric -1.0E+15 to -1.0E-15, 0.0 +1.0E-15 to 1.0E+15 MIN = -1.0E+15 MAX = +1.0E+15 0.0 Remarks l Limit crossing: If a measurement is greater than the specified upper limit, bit 12 ("Upper Limit Failed") is set in the Questionable Data Register, which results in an SRQ if enabled. You can use the STATus:QUES- tionable:EVENt? command to read the event register. See STATus Subsystem Introduction for further information. l The instrument sets the upper limit to 0.0 after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the upper limit in the form +1.00000000000000E+006. Examples The following example enables limit testing of 100 frequency measurements and returns an indication whether measurements were outside of the range of 9.9MHz to 10.1MHz. Measurements above 10.1MHz will set bit 12 (Upper Limit Failed) of the questionable status register; measurements below 9.9MHz will set bit 11 (Lower Limit Failed). *CLS STAT:PRES CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:LIM:LOW 9.9E6 CALC:LIM:UPP 10.1E6 Keysight 53220A/53230A Programmer's Reference 61 CALCulate1:LIMit:UPPer

See Also CALCulate1:LIMit:LOWer CALCulate1:STATe STATus Subsystem Introduction CALCulate1:LIMit:UPPer 62 Keysight 53220A/53230A Programmer's Reference

cleared. Remarks l Allan deviation is only computed when the measurement function is frequency or period. l For a true Allan deviation computation, continuous gap-free measurement mode should be selected (SENSe:FREQuency:MODE CONTinuous set). l You can read the statistical values at any time. l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the Allan deviation of the measurements taken in the form +1.34892723498343E+001. Examples The following example returns the Allan deviation of 100 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:AVER:STAT ON CALC:STAT ON INIT *WAI wait for all reading to complete CALC:AVER:ADEV? Typical Response: +4.13500000E+001 See Also CALCulate1:AVERage:CLEar CALCulate1:AVERage:STATe CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 63 CALCulate1:AVERage:ADEViation?

cleared. Remarks l Allan deviation is only computed when the measurement function is frequency or period. l For a true Allan deviation computation, continuous gap-free measurement mode should be selected (SENSe:FREQuency:MODE CONTinuous set). l You can read the statistical values at any time. l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the Allan deviation of the measurements taken in the form +1.34892723498343E+001. Examples The following example returns the Allan deviation of 100 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:AVER:STAT ON CALC:STAT ON INIT *WAI wait for all reading to complete CALC:AVER:ADEV? Typical Response: +4.13500000E+001 See Also CALCulate1:AVERage:CLEar CALCulate1:AVERage:STATe CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 65 CALCulate1:AVERage:ADEViation?

value of all measurements taken since the last time statistics were cleared. Remarks l You can read the statistical values at any time. l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the mean, standard deviation, minimum value, and maximum value of the meas- urements taken. Examples The following example returns the statistics of 100 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:AVER:STAT ON CALC:STAT ON INIT *WAI wait for all reading to complete CALC:AVER:ALL? Typical Response: +1.00520000E+006,+4.13500000E+001,+1.00512000E+006,+1.005270000E+006 See Also CALCulate1:AVERage:AVERage? CALCulate1:AVERage:CLEar CALCulate1:AVERage:COUNt? CALCulate1:AVERage:MAXimum? CALCulate1:AVERage:MINimum? CALCulate1:AVERage:PTPeak? Keysight 53220A/53230A Programmer's Reference 67 CALCulate1:AVERage:ALL?

istics were cleared. Remarks l You can read the statistical values at any time. l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the mean of the measurements taken in the form +1.34892723498343E+007. Examples The following example returns the mean of 100 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:AVER:STAT ON CALC:STAT ON INIT *WAI wait for all reading to complete CALC:AVER:AVER? Typical Response: +1.00520000E+006 See Also CALCulate1:AVERage:ALL? CALCulate1:AVERage:CLEar CALCulate1:AVERage:COUNt? CALCulate1:AVERage:STATe CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 69 CALCulate1:AVERage:AVERage?

Remarks l This command clears the minimum, maximum, average, count, and deviation values (but no meas- urements are cleared from memory). l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format This command has no query form. Examples The following command clears the stored statistical data. CALC:AVER:CLE See Also CALCulate1:AVERage:COUNt? CALCulate1:AVERage:STATe CALCulate1:STATe CALCulate1:AVERage:CLEar 70 Keysight 53220A/53230A Programmer's Reference

last time statistics were cleared. Remarks l You can read the statistical values at any time. l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the number of measurements used to compute the current statistics values in the form +100. Examples The following example returns the number of measurements used to compute the current statistics val- ues. CALC:AVER:COUN:CURR? Typical Response: +73 See Also CALCulate1:AVERage:CLEar CALCulate1:AVERage:STATe CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 71 CALCulate1:AVERage:COUNt:CURRent?

cleared. Remarks l You can read the statistical values at any time. l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the maximum value found in the form +1.34892723498343E+007. Examples The following example returns the maximum value of 100 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:AVER:STAT ON CALC:STAT ON INIT *WAI wait for all reading to complete CALC:AVER:MAX? Typical Response: +1.005270000E+006 See Also CALCulate1:AVERage:ALL? CALCulate1:AVERage:CLEar CALCulate1:AVERage:COUNt? CALCulate1:AVERage:STATe CALCulate1:STATe CALCulate1:AVERage:MAXimum? 72 Keysight 53220A/53230A Programmer's Reference

cleared. Remarks l You can read the statistical values at any time. l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the minimum value found in the form +1.34892723498343E+007. Examples The following example returns the minimum value of 100 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:AVER:STAT ON CALC:STAT ON INIT *WAI wait for all reading to complete CALC:AVER:MIN? Typical Response: +1.00512000E+006 See Also CALCulate1:AVERage:ALL? CALCulate1:AVERage:CLEar CALCulate1:AVERage:COUNt? CALCulate1:AVERage:STATe CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 73 CALCulate1:AVERage:MINimum?

cleared. Remarks l You can read the statistical values at any time. l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the peak-to-peak value found in the form +1.34892723498343E+007. Examples The following example returns the peak-to-peak value of 100 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:AVER:STAT ON CALC:STAT ON INIT *WAI wait for all reading to complete CALC:AVER:PTP? Typical Response: +1.50000000E+002 See Also CALCulate1:AVERage:CLEar CALCulate1:AVERage:COUNt? CALCulate1:AVERage:STATe CALCulate1:STATe CALCulate1:AVERage:PTPeak? 74 Keysight 53220A/53230A Programmer's Reference

cleared. Remarks l You can read the statistical values at any time. l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the standard deviation of the measurements taken in the form +1.34892723498343E+001. Examples The following example returns the standard deviation of 100 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:AVER:STAT ON CALC:STAT ON INIT *WAI wait for all reading to complete CALC:AVER:SDEV? Typical Response: +4.13500000E+001 See Also CALCulate1:AVERage:ALL? CALCulate1:AVERage:CLEar CALCulate1:AVERage:STATe CALCulate1:STATe Keysight 53220A/53230A Programmer's Reference 75 CALCulate1:AVERage:SDEViation?

CALCulate[1]:AVERage[:STATe]? Description This command enables or disables statistics computation. Remarks l The CALCulate1 subsystem must also be enabled by CALCulate1:STATe for statistics computation to be performed. l Statistics computation is disabled for continuous totalize since this computation requires more than one measurement to be useful. l Statistics computation is disabled for timestamp measurements. l The instrument clears the statistical values when CALCulate1:AVERage:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate1:AVERage:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). l The instrument disables statistics computation after a Factory Reset (*RST command) or an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the current statistics computation state: 0 (OFF) or 1 (ON). Examples The following example returns the statistics of 100 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:AVER:STAT ON CALC:STAT ON INIT *WAI CALC:AVER:ALL? Typical Response: +1.00520000E+06,+1.00512000E+05,+1.005270000E+06,+4.13500000E+01 See Also CALCulate1:STATe CALCulate1:AVERage:STATe 76 Keysight 53220A/53230A Programmer's Reference

CALCulate[1][:STATe]? Description This command enables or disables the entire CALCulate1 subsystem. Remarks l You can individually enable or disable the limit testing, scaling, statistics and histogram computation operations using the CALCulate1:LIMit:STATe, CALCulate1:SCALe:STATe, and CALCu- late1:AVERage:STATe commands. l The CALCulate subystem and the individual calculate functions are disabled for timestamp meas- urements. l The instrument disables the calculation subsystem after a Factory Reset (*RST command), after an Instrument Preset (SYSTem:PRESet command), or when the measurement function is changed. Return Format The query returns the current calculate state: 0 (OFF) or 1 (ON). Examples The following example returns the statistics of 100 frequency measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 100 CALC:AVER:STAT ON CALC:STAT ON INIT *WAI CALC:AVER:ALL? Typical Response: +1.00520000000000E+006,+1.00512000000000E+005,+1.005270000000000E+006,+4.13500000- 000000E+001 See Also CALCulate1:AVERage:STATe CALCulate1:LIMit:STATe Keysight 53220A/53230A Programmer's Reference 77 CALCulate1:STATe

lected the last time the histogram data was cleared. Remarks l You can read the histogram at any time. l The instrument clears the histogram data when the CALCulate2:TRANsform:HISTogram:POINts, CALCulate2:TRANsform:HISTogram:RANGe:AUTO, CALCu- late2:TRANsform:HISTogram:RANGe:AUTO:COUNt, CALCu- late2:TRANsform:HISTogram:RANGe:LOWer, CALCulate2:TRANsform:HISTogram:RANGe:UPPer commands are sent, when CALCulate2:TRANsform:HISTogram:STATe ON is sent, when the meas- urement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate2:TRANsform:HISTogram:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns a comma-seperated lower range value, upper range value, number of measurements counted, and bin data. Note that the bin data includes, in order: l Number of measurements less than the lower range value l Number of measurements in the each of the CALCulate2:TRANsform:HISTogram:POINts bins, starting at the lower range value bin l Number of measurements greater than the upper range value The range values are returned in the form +1.00000000000000E+006. The number of meas- urements and bin data are returned in the form +100. Examples The following example enables an automatically scaled, 128-bin histogram computation of 1000 fre- quency measurements and returns the computed histogram, including the lower and upper range values, the total measurement count, and the bin data. The automatic scaling is based on the first 100 meas- urements. CONF:FREQ 1.0E6,.001 SAMP:COUN 1000 Keysight 53220A/53230A Programmer's Reference 79 CALCulate2:TRANsform:HISTogram:ALL?

See Also CALCulate2:TRANsform:HISTogram:COUNt? CALCulate2:TRANsform:HISTogram:DATA? CALCulate2:TRANsform:HISTogram:RANGe:LOWer? CALCulate2:TRANsform:HISTogram:RANGe:UPPer CALCulate2:TRANsform:HISTogram:STATe CALCulate2:TRANsform:HISTogram:ALL? 80 Keysight 53220A/53230A Programmer's Reference

lected the last time the histogram data was cleared. Remarks l You can read the histogram at any time. l The instrument clears the histogram data when the CALCulate2:TRANsform:HISTogram:POINts, CALCulate2:TRANsform:HISTogram:RANGe:AUTO, CALCu- late2:TRANsform:HISTogram:RANGe:AUTO:COUNt, CALCu- late2:TRANsform:HISTogram:RANGe:LOWer, CALCulate2:TRANsform:HISTogram:RANGe:UPPer commands are sent, when CALCulate2:TRANsform:HISTogram:STATe ON is sent, when the meas- urement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate2:TRANsform:HISTogram:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns a comma-seperated lower range value, upper range value, number of measurements counted, and bin data. Note that the bin data includes, in order: l Number of measurements less than the lower range value l Number of measurements in the each of the CALCulate2:TRANsform:HISTogram:POINts bins, starting at the lower range value bin l Number of measurements greater than the upper range value The range values are returned in the form +1.00000000000000E+006. The number of meas- urements and bin data are returned in the form +100. Examples The following example enables an automatically scaled, 128-bin histogram computation of 1000 fre- quency measurements and returns the computed histogram, including the lower and upper range values, the total measurement count, and the bin data. The automatic scaling is based on the first 100 meas- urements. CONF:FREQ 1.0E6,.001 SAMP:COUN 1000 Keysight 53220A/53230A Programmer's Reference 81 CALCulate2:TRANsform:HISTogram:ALL?

See Also CALCulate2:TRANsform:HISTogram:COUNt? CALCulate2:TRANsform:HISTogram:DATA? CALCulate2:TRANsform:HISTogram:RANGe:LOWer? CALCulate2:TRANsform:HISTogram:RANGe:UPPer CALCulate2:TRANsform:HISTogram:STATe CALCulate2:TRANsform:HISTogram:ALL? 82 Keysight 53220A/53230A Programmer's Reference

late2:TRANsform:HISTogram:RANGe:AUTO ON set), the automatic scaling will be restarted. Remarks l The instrument clears the histogram data when the CALCulate2:TRANsform:HISTogram:POINts, CALCulate2:TRANsform:HISTogram:RANGe:AUTO, CALCu- late2:TRANsform:HISTogram:RANGe:AUTO:COUNt, CALCu- late2:TRANsform:HISTogram:RANGe:LOWer, CALCulate2:TRANsform:HISTogram:RANGe:UPPer commands are sent, when CALCulate2:TRANsform:HISTogram:STATe ON is sent, when the meas- urement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate2:TRANsform:HISTogram:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Examples The following example clears the histogram data. CALC2:TEAN:HIST:CLE See Also CALCulate2:TRANsform:HISTogram:STATe Keysight 53220A/53230A Programmer's Reference 83 CALCulate2:TRANsform:HISTogram:CLEar

cleared. Remarks l You can read the histogram data at any time. l The instrument clears the histogram data when the CALCulate2:TRANsform:HISTogram:POINts, CALCulate2:TRANsform:HISTogram:RANGe:AUTO, CALCu- late2:TRANsform:HISTogram:RANGe:AUTO:COUNt, CALCu- late2:TRANsform:HISTogram:RANGe:LOWer, CALCulate2:TRANsform:HISTogram:RANGe:UPPer commands are sent, when CALCulate2:TRANsform:HISTogram:STATe ON is sent, when the meas- urement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate2:TRANsform:HISTogram:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the number of measurements counted in the current histogram data in the form +100. Examples The following example returns the number of measurements used to compute the current histogram data. CALC2:TRAN:HIST:COUN? Typical Response: +73 See Also CALCulate2:TRANsform:HISTogram:ALL? CALCulate2:TRANsform:HISTogram:STATe CALCulate2:TRANsform:HISTogram:COUNt? 84 Keysight 53220A/53230A Programmer's Reference

Remarks l You can read the histogram data at any time. l The instrument clears the histogram data when the CALCulate2:TRANsform:HISTogram:POINts, CALCulate2:TRANsform:HISTogram:RANGe:AUTO, CALCu- late2:TRANsform:HISTogram:RANGe:AUTO:COUNt, CALCu- late2:TRANsform:HISTogram:RANGe:LOWer, CALCulate2:TRANsform:HISTogram:RANGe:UPPer commands are sent, when CALCulate2:TRANsform:HISTogram:STATe ON is sent, when the meas- urement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate2:TRANsform:HISTogram:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns a comma-separated list of the bin data. The bin data includes, in order: l Number of measurements less than the lower range value l Number of measurements in the each of the CALCulate2:TRANsform:HISTogram:POINts bins, starting at the lower range value bin l Number of measurements greater than the upper range value The bin data is returned in the form +1,+2,+53,.... Examples The following example enables an automatically scaled, 128-bin histogram computation of 1000 fre- quency measurements and returns the computed bin data. The automatic scaling is based on the first 100 measurements. CONF:FREQ 1.0E6,.001 SAMP:COUN 1000 CALC2:TRAN:HIST:RANG:AUTO ON CALC2:TRAN:HIST:RANG:AUTO:COUN 100 CALC2:TRAN:HIST:POIN 128 CALC2:TRAN:HIST:STAT ON Keysight 53220A/53230A Programmer's Reference 85 CALCulate2:TRANsform:HISTogram:DATA?

See Also CALCulate2:TRANsform:HISTogram:ALL? CALCulate2:TRANsform:HISTogram:STATe CALCulate2:TRANsform:HISTogram:DATA? 86 Keysight 53220A/53230A Programmer's Reference

CALCulate2:TRANsform:HISTogram:POINts? [{MINimum | MAXimum | DEFault}] Description This command sets the number of bins between the lower and upper range values for the histogram. Two additional bins always exist: one for measurements less than the lower range value and one for meas- urements greater than the upper range value. Parameters Name Type Range of Values Default Value Numeric 10 to 1000 MIN = 10 MAX = 1000 100 Remarks l The lower and upper range values can be specified using the CALCu- late2:TRANsform:HISTogram:RANGe:LOWer or CALCulate2:TRANsform:HISTogram:RANGe:UPPer commands. They are computed automatically if CALCulate2:TRANsform:HISTogram:RANGe:AUTO ON is set. l The instrument sets the number of bins to 100 after a Factory Reset (*RST command) or after an Instru- ment Preset (SYSTem:PRESet command). Return Format The query returns the number of bins in the form +100. Examples The following example enables an automatically scaled, 128-bin histogram computation of 1000 fre- quency measurements and returns the computed histogram, including the lower and upper range values, the total measurement count, and the bin data. The automatic scaling is based on the first 100 meas- urements. CONF:FREQ 1.0E6,.001 SAMP:COUN 1000 CALC2:TRAN:HIST:RANG:AUTO ON CALC2:TRAN:HIST:RANG:AUTO:COUN 100 CALC2:TRAN:HIST:POIN 128 Keysight 53220A/53230A Programmer's Reference 87 CALCulate2:TRANsform:HISTogram:POINts

See Also CALCulate2:TRANsform:HISTogram:RANGe:AUTO CALCulate2:TRANsform:HISTogram:RANGe:LOWer CALCulate2:TRANsform:HISTogram:RANGe:UPPer CALCulate2:TRANsform:HISTogram:STATe CALCulate2:TRANsform:HISTogram:POINts 88 Keysight 53220A/53230A Programmer's Reference

CALCulate2:TRANsform:HISTogram:RANGe:AUTO? Description This command enables or disables automatic selection of the lower and upper range values for the his- togram. l When enabled, the minimum and maximum values from the first CALCu- late2:TRANsform:HISTogram:RANGe:AUTO:COUNt measurement will be selected as the lower and upper range values. l When disabled, the lower and upper range values are specified by the CALCu- late2:TRANsform:HISTogram:RANGe:LOWer and CALCulate2:TRANsform:HISTogram:RANGe:UPPer commands. Remarks l Setting the lower or upper range value (CALCulate2:TRANsform:HISTogram:RANGe:LOWer and CALCu- late2:TRANsform:HISTogram:RANGe:UPPer commands) disables automatic selection of the lower and upper range values for the histogram. l The instrument restarts automatic range value selection when the CALCu- late2:TRANsform:HISTogram:POINts, CALCulate2:TRANsform:HISTogram:RANGe:AUTO, CALCu- late2:TRANsform:HISTogram:RANGe:AUTO:COUNt, CALCulate2:TRANsform:HISTogram:RANGe:LOWer, CALCu- late2:TRANsform:HISTogram:RANGe:UPPer commands are sent, when CALCu- late2:TRANsform:HISTogram:STATe ON is sent, when the measurement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCu- late2:TRANsform:HISTogram:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). l The instrument enables automatic selection of the lower and upper range values after a Factory Reset (*RST command) or an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the current automatic selection state: 0 (OFF) or 1 (ON). Examples The following example enables an automatically scaled, 128-bin histogram computation of 1000 fre- quency measurements and returns the computed histogram, including the lower and upper range values, Keysight 53220A/53230A Programmer's Reference 89 CALCulate2:TRANsform:HISTogram:RANGe:AUTO

urements. CONF:FREQ 1.0E6,.001 SAMP:COUN 1000 CALC2:TRAN:HIST:RANG:AUTO ON CALC2:TRAN:HIST:RANG:AUTO:COUN 100 CALC2:TRAN:HIST:POIN 128 CALC2:TRAN:HIST:STAT ON INIT *WAI CALC2:TRAN:HIST:ALL? Typical Response: +9.99383828200000E+006,+1.00513398300000E+006,+1000,<102 bin counts> See Also CALCulate2:TRANsform:HISTogram:RANGe:AUTO:COUNt CALCulate2:TRANsform:HISTogram:RANGe:LOWer CALCulate2:TRANsform:HISTogram:RANGe:UPPer CALCulate2:TRANsform:HISTogram:STATe CALCulate2:TRANsform:HISTogram:RANGe:AUTO 90 Keysight 53220A/53230A Programmer's Reference

CALCulate2:TRANsform:HISTogram:RANGe:AUTO:COUNt? [{MINimum | MAXimum | DEFault}] Description This command sets the number of measurements used for automatic selection of the lower and upper range values for the histogram. Parameters Name Type Range of Values Default Value Numeric 10 to 1000 MIN = 10 MAX = 1000 100 Remarks l The instrument sets the number of measurements used for automatic range value selection to 100 after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the number of measurements used for automatic range value selection in the form +100. Examples The following example enables an automatically scaled, 128-bin histogram computation of 1000 fre- quency measurements and returns the computed histogram, including the lower and upper range values, the total measurement count, and the bin data. The automatic scaling is based on the first 100 meas- urements. CONF:FREQ 1.0E6,.001 SAMP:COUN 1000 CALC2:TRAN:HIST:RANG:AUTO ON CALC2:TRAN:HIST:RANG:AUTO:COUN 100 CALC2:TRAN:HIST:POIN 128 CALC2:TRAN:HIST:STAT ON INIT *WAI CALC2:TRAN:HIST:ALL? Keysight 53220A/53230A Programmer's Reference 91 CALCulate2:TRANsform:HISTogram:RANGe:AUTO:COUNt

See Also CALCulate2:TRANsform:HISTogram:RANGe:AUTO CALCulate2:TRANsform:HISTogram:RANGe:LOWer CALCulate2:TRANsform:HISTogram:RANGe:UPPer CALCulate2:TRANsform:HISTogram:STATe CALCulate2:TRANsform:HISTogram:RANGe:AUTO:COUNt 92 Keysight 53220A/53230A Programmer's Reference

CALCulate2:TRANsform:HISTogram:RANGe:LOWer? [{MINimum | MAXimum | DEFault}] Description This command sets the lower range value for the histogram. Setting the lower range value disables auto- matic selection of the lower and upper range values for the histogram (sets CALCu- late2:TRANsform:HISTogram:RANGe:AUTO to OFF). If automatic range value selection is enabled (CALCulate2:TRANsform:HISTogram:RANGe:AUTO ON set), the query form will return the computed lower range value. If no histogram data exists, 9.91E37 (Not a Number) will be returned. Parameters Name Type Range of Values Default Value Numeric -1.0E+15 to -1.0E-15, 0.0 +1.0E-15 to 1.0E+15 MIN = -1.0E+15 MAX = +1.0E+15 0.0 Remarks l The lower and upper range values are computed automatically if CALCu- late2:TRANsform:HISTogram:RANGe:AUTO ON is set. l The instrument sets the lower range value to 0.0 after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the lower range value in the form +1.00000000000000E+006. Examples The following example enables an manually scaled, 128-bin histogram computation of 1000 frequency measurements and returns the computed histogram, including the lower and upper range values, the total measurement count, and the bin data. CONF:FREQ 1.0E6,.001 SAMP:COUN 1000 CALC2:TRAN:HIST:RANG:AUTO OFF Keysight 53220A/53230A Programmer's Reference 93 CALCulate2:TRANsform:HISTogram:RANGe:LOWer

See Also CALCulate2:TRANsform:HISTogram:RANGe:AUTO CALCulate2:TRANsform:HISTogram:RANGe:UPPer CALCulate2:TRANsform:HISTogram:RANGe:LOWer 94 Keysight 53220A/53230A Programmer's Reference

CALCulate2:TRANsform:HISTogram:RANGe:UPPer? [{MINimum | MAXimum | DEFault}] Description This command sets the upper range value for the histogram. Setting the upper range value disables auto- matic selection of the lower and upper range values for the histogram (sets CALCu- late2:TRANsform:HISTogram:RANGe:AUTO to OFF). If automatic range value selection is enabled (CALCulate2:TRANsform:HISTogram:RANGe:AUTO ON set), the query form will return the computed upper range value. If no histogram data exists, 9.91E37 (Not a Number) will be returned. Parameters Name Type Range of Values Default Value Numeric -1.0E+15 to -1.0E-15, 0.0 +1.0E-15 to 1.0E+15 MIN = -1.0E+15 MAX = +1.0E+15 0.0 Remarks l The lower and upper range values are computed automatically if CALCu- late2:TRANsform:HISTogram:RANGe:AUTO ON is set. l The instrument sets the upper range value to 0.0 after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). Return Format The query returns the upper range value in the form +1.00000000000000E+006. Examples The following example enables an manually scaled, 128-bin histogram computation of 1000 frequency measurements and returns the computed histogram, including the lower and upper range values, the total measurement count, and the bin data. CONF:FREQ 1.0E6,.001 SAMP:COUN 1000 CALC2:TRAN:HIST:RANG:AUTO OFF Keysight 53220A/53230A Programmer's Reference 95 CALCulate2:TRANsform:HISTogram:RANGe:UPPer

See Also CALCulate2:TRANsform:HISTogram:RANGe:LOWer CALCulate2:TRANsform:HISTogram:RANGe:UPPer 96 Keysight 53220A/53230A Programmer's Reference

CALCulate2:TRANsform:HISTogram[:STATe]? Description This command enables or disables histogram computation. Remarks l The instrument clears the histogram data when the CALCulate2:TRANsform:HISTogram:POINts, CALCulate2:TRANsform:HISTogram:RANGe:AUTO, CALCu- late2:TRANsform:HISTogram:RANGe:AUTO:COUNt, CALCu- late2:TRANsform:HISTogram:RANGe:LOWer, CALCulate2:TRANsform:HISTogram:RANGe:UPPer commands are sent, when CALCulate2:TRANsform:HISTogram:STATe ON is sent, when the meas- urement function is changed, when the INITiate:IMMediate, MEASure? or READ? commands are executed, when the CALCulate2:TRANsform:HISTogram:CLEar command is executed, after a Factory Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command). l Histogram computation is disabled for continuous totalize since this computation requires more than one measurement to be useful. l The CALCulate subystem and the individual calculate functions are disabled for timestamp meas- urements. l The instrument disables histogram computation after a Factory Reset (*RST command) or an Instru- ment Preset (SYSTem:PRESet command). Return Format The query returns the current histogram computation state: 0 (OFF) or 1 (ON). Examples The following example enables an automatically scaled, 128-bin histogram computation of 1000 fre- quency measurements and returns the computed histogram, including the lower and upper range values, the total measurement count, and the bin data. The automatic scaling is based on the first 100 meas- urements. CONF:FREQ 1.0E6,.001 SAMP:COUN 1000 CALC2:TRAN:HIST:RANG:AUTO ON CALC2:TRAN:HIST:RANG:AUTO:COUN 100 CALC2:TRAN:HIST:POIN 128 CALC2:TRAN:HIST:STAT ON INIT Keysight 53220A/53230A Programmer's Reference 97 CALCulate2:TRANsform:HISTogram:STATe

See Also CALCulate2:TRANsform:HISTogram:STATe 98 Keysight 53220A/53230A Programmer's Reference

The CALibration commands are used to calibrate the Keysight 53220A/230A. For a more detailed discussion of the calibration procedures, see the Keysight 53210A/53220A/53230A 350 MHz Counter Service Guide. Please refer to the Ser- vice Guide before attempting to calibrate the instrument. Improper use of the CALibration commands can adversely affect the accuracy and reliability of the instru- ment. Command Summary CALibration:ALL? CALibration:COUNt? CALibration:LEVel? CALibration:SECurity:CODE CALibration:SECurity:STATe CALibration:SECurity:STATe? CALibration:STRing CALibration:STRing? CALibration:VALue CALibration:VALue? Related Commands *CAL? Keysight 53220A/53230A Programmer's Reference 99 CALibration Subsystem Introduction

tion:VALue command). Before you can calibrate the instrument, you must unsecure it by entering the cor- rect security code. For a more detailed discussion of the calibration procedures, see the Keysight 53210A/53220A/53230A 350 MHz Counter Service Guide. Please refer to the Ser- vice Guide before attempting to calibrate the instrument. Improper use of the CALibration commands can adversely affect the accuracy and reliability of the instru- ment. Remarks l If a calibration fails, "+1" is returned and an error is stored in the error queue. For a complete listing of the error messages related to calibration failures, see SCPI Error Messages. l This query increments the calibration count on the counter (see CALibration:COUNt? command). Return Format The query returns +0 (calibration passed) or +1 (calibration failed). Examples The following example performs a calibration and returns a pass/fail indication. CAL? Typical Response: +0 See Also CALibration:SECurity:STATe CALibration:VALue CALibration:ALL? 100 Keysight 53220A/53230A Programmer's Reference