This guide describes how to program the HP 53131A/132A 225 MHz Universal
Counter. The information in this guide applies to instruments having the number
prefix listed below, unless accompanied by a “Manual Updating Changes”
package indicating otherwise.
SERIAL NUMBER PREFIX:3546 to 3622 (HP 53131A)
3546 to 3646 (HP 53132A)
HP 53131A/132A 225 MHz
Universal Counter
Copyright Hewlett-Packard
Company 1996
All Rights Reserved.
Reproduction, adaptation, or
translations without prior
written permission is
prohibited, except as allowed
under the copyright laws.
Printed: November 1996
Printed in USA
Manual part number
53131-90044
Certification
and Warranty
Certification
Hewlett-Packard Company
certifies that this product met
its published specification at
the time of shipment from the
factory. Hewlett-Packard
further certifies that its
calibration measurements are
traceable to the United States
National Institute of Standards
and Technology (formerly
National Bureau of
Standards), to the extent
allowed by the Institute's
calibration facility, and to the
calibration facilities of other
International Standards
Organization members.
Warranty
This Hewlett-Packard
instrument product is
warranted against defects in
material and workmanship for
a period of three years from
date of shipment. During the
warranty period, HewlettPackard Company will, at its
option, either repair or replace
products which prove to be
defective.
For detailed warranty
information, see back matter.
Safety Considerations
General
This product and related
documentation must be
reviewed for familiarization
with this safety markings and
instructions before operation.
This product is a safety Class I
instrument (provided with a
protective earth terminal).
Before Applying Power
Verify that the product is set to
match the available line
voltage and the correct fuse is
installed. Refer to instructions
in Chapter 1 of the Manual.
Safety Earth Ground
An uninterruptible safety earth
ground must be provided from
the mains power source to the
product input wiring terminals
or supplied power cable.
Warning Symbols That May
Be Used In This Book
Instruction manual symbol;
the product will be marked
with this symbol when it is
necessary for the user to refer
to the instruction manual.
Indicates hazardous voltages.
Safety Considerations
(contd)
Indicates earth (ground)
terminal.
or
Indicated terminal is
connected to chassis when
such connection is not
apparent.
Indicates Alternating
current.
Indicates Direct current.
WARNING
BODILY INJURY OR
DEATH MAY RESULT
FROM FAILURE TO
HEED A WARNING. DO
NOT PROCEED BEYOND
A WARNING SIGN UNTIL
THE INDICATED
CONDITIONS ARE FULLY
UNDERSTOOD AND MET.
CAUTION
Damage to equipment, or
incorrect measurement data,
may result from failure to heed
a caution. Do not proceed
beyond a CAUTION sign until
the indicated conditions are
fully understood and met.
Hewlett-Packard Company
Santa Clara Division
5301 Stevens Creek Boulevard
Santa Clara, California 95052-8059
For additional safety and
acoustic noise information,
see back matter.
Contents
1Before You Start ...
Introduction 1-2
Differences Between Prior and Current Revisions of the HP 53131A/132A
1-3
HP 53131A Containing Firmware Revisions (3317, 3335,
or 3402) 1-3
HP 53132A Time Interval Delay Arming 1-5
Getting Started 1-6
How to Use This Guide 1-6
New Users 1-6
What You Should Understand 1-6
Learning to Program the Counter 1-7
Experienced Programmers 1-7
Applications 1-8
Programming Guide Contents 1-9
Assumptions 1-9
Related Documentation 1-10
2Command Summary
Introduction 2-2
Chapter Summary 2-2
Front Panel to SCPI Command Maps 2-3
Some SCPI Syntax Conventions 2-3
Input Channels Conditioning Keys to SCPI
Command Map 2-4
Instrument Control, Utility, Recall, and Save & Print
Keys to SCPI Command Map 2-6
MEASURE Keys to SCPI Command Map 2-8
Gate & ExtArm Key to SCPI Command Map 2-10
Gate & ExtArm Key to SCPI Command Map — For HP 53131A (and
HP 53132A With S/N Prefix
Below 3646) 2-13
LIMITS and MATH Keys to SCPI Command Map 2-16
Programming Guideiii
Contents
Calibration Menu to SCPI Command Map 2-18
HP 53131A/132A Command Summary 2-20
SCPI Conformance Information 2-20
IEEE 488.2 Common Commands 2-21
HP 53131A/132A SCPI Subsystem Commands 2-24
Std/New Column 2-24
Parameter Form Column 2-24
*RST Response 2-40
3Programming Your Universal Counter for Remote
Operation
Introduction 3-2
Chapter Summary 3-2
Where to Find Some Specific Information 3-2
Where to Find HP BASIC Programming Examples 3-3
Where to Find QuickBASIC Programming Examples 3-3
Where to Find Turbo C Programming Examples 3-3
Configuring the HP-IB 3-4
To Set the HP-IB Mode and Address 3-4
To Connect the Counter to a Computer 3-6
Remote/Local Operation 3-6
Overview of Command Types and Formats 3-7
Common Command Format 3-7
SCPI Command and Query Format 3-7
Status Byte Register and Service Request Enable
Register 3-21
Status Byte Register 3-21
Service Request Enable Register 3-23
Standard Event Status Register Group 3-24
Standard Event Status Register 3-24
Standard Event Status Enable Register 3-26
Operation Status Register Group and Questionable Data/Signal Status
Register Group 3-27
Condition Register 3-28
Transition Filter 3-28
Event Register 3-29
Event Enable Register 3-29
Operation Status Register Group 3-30
Questionable Data/Signal Status Register Group 3-32
Command Settings for Optimizing Throughput 3-35
Commands to Set Counter for Optimal Throughput 3-35
Typical Optimizing Throughput Results for Different Computers 3-37
How to Program the Counter for Status Reporting 3-38
Determining the Condition of the Counter 3-38
Resetting the Counter and Clearing the HP-IB
Interface—Example 1 3-38
Using the Standard Event Status Register to Trap an Incorrect HP-IB
command—Example 2 3-39
Programming Guidev
Contents
Event Status Register 3-39
Using the Questionable Data/Signal Status Register to Alert the Computer
When Automatic Interpolator Calibration is Disabled—Example 3 3-39
Questionable Data Status Register 3-40
Using the Operation Status Register to Alert the Computer When
Measuring has Completed— Example 4 3-40
Operation Status Register 3-40
How to Program the Counter to Display Results 3-43
Configuring the Counter’s Display 3-43
Commands for Displaying Non-Scaled/Offset Results 3-43
Commands for Displaying Scaled/Offset Results 3-44
Commands for Displaying the Limit Graph 3-44
Commands for Displaying Statistics Results 3-44
Commands for Enabling and Disabling the Display 3-45
How to Program the Counter to Synchronize Measurements 3-46
Synchronizing Measurement Completion 3-46
Resetting the Counter and Clearing the HP-IB Interface 3-46
Using the *WAI Command 3-46
Using the *OPC? Command 3-47
Using the *OPC Command to Assert SRQ 3-48
How to Program the Counter for Math/Limit
Operations 3-49
Updating Math and Limit Results Over HP-IB 3-49
Using the Scale and Offset Over HP-IB 3-50
How to Program the Counter to Define Macros 3-52
Writing SCPI Programs 3-55
Programming Examples 3-58
Using HP BASIC 3-58
To Send a Double-Quoted String 3-58
To Send a Single-Quoted String 3-58
Using QuickBASIC 3-59
Using Turbo C 3-59
List of the Programming Examples 3-59
Easiest Way to Make a Measurement (HP BASIC) 3-60
To Make a Frequency Measurement (HP BASIC) 3-62
viProgramming Guide
Contents
To Perform Limit Testing (HP BASIC) 3-63
To Measure the Statistics of 50 Measurements
(HP BASIC) 3-64
To Use Limits to Filter Data Before Measuring Stats
(HP BASIC) 3-66
To Read and Store Calibration Information
(HP BASIC) 3-68
To Perform a Time Interval Calibration (HP BASIC) 3-69
To Optimize Throughput (HP BASIC) 3-73
To Use Macros (HP BASIC) 3-75
To Make a Frequency Measurement (QuickBASIC) 3-77
To Perform Limit Testing (QuickBASIC) 3-78
To Measure the Statistics of 50 Measurements
(QuickBASIC) 3-80
To Use Limits to Filter Data Before Measuring Stats (QuickBASIC) 3-
82
To Read and Store Calibration Data (QuickBASIC) 3-85
To Optimize Throughput (QuickBASIC) 3-86
To Use Macros (QuickBASIC) 3-88
To Make a Frequency Measurement (Turbo C) 3-91
To Use Limits to Filter Data Before Measuring Statistics (Turbo C) 3-
No Error 5-4
Command Error 5-4
Execution Error 5-5
Device- or Counter-Specific Error 5-5
Query Error 5-6
xProgramming Guide
1
1
Before You Start ...
Chapter 1 Before You Start ...
Introduction
Introduction
This programming guide contains programming information for the
HP 53131A/132A Universal Counter.
This guide assumes you are familiar with the front-panel operation of the Counter.
See the HP 53131A/132A Operating Guide for detailed information about front-
panel operation. You should use this programming guide together with the
operating guide. Knowing how to control the Counter from the front panel and
understanding the measurements you wish to perform makes the programming
task much easier. The operating guide provides explanations and task procedures
for all of the Counter’s measurement functions, and contains the specifications for
the Counter.
By sending Standard Commands for Programmable Instruments (SCPI)
commands, all of the Counter’s front-panel functions can be remotely operated via
the Hewlett-Packard Interface Bus (HP-IB),
as well as the additional throughput optimizing function not available from the
front panel.
This Counter programming commands conform to the Standard Commands forProgrammable Instruments (SCPI) Standard Version 1992.0. The SCPI standard
does not completely redefine how to program instruments over the HewlettPackard Interface Bus (HP-IB). However, it does standardize the structure and
content of an instrument’s command set to reflect the best programming practices
developed by people using HP-IB. It also establishes standard command
mnemonics for similar functions in all of the instruments that conform to the SCPI
standard.
If you have programmed any HP instruments that have been released over the last
few years, you will have seen a general trend toward the techniques specified in
the SCPI standard. For example, several instruments are already using a hierarchy
of commands that is similar to the command structure defined by the SCPI
standard.
1-2Programming Guide
Chapter 1 Before You Start ...
Programming Guide Contents
Differences Between Prior and Current Revisions
of the HP 53131A/132A
If you have an HP 53131A containing one of the prior firmware revisions (3317,
3335, or 3402), read the subsection below titled “HP 53131A Containing
Firmware Revisions (3317, 3335, or 3402)” to get an overview of the differences
between the earlier firmware revisions and current firmware revision.
If you have an HP 53132A with a serial number prefix below 3646, read the
subsection titled “HP 53132A Time Interval Delay Arming ” on page 1-5.
NOTE
Note that throughout the guide, differences between the earlier and current
firmware revisions are noted where applicable.
HP 53131A Containing Firmware Revisions (3317, 3335, or 3402)
There are four main areas that differ:
• Calibrations
• Measurements
• Statistics
• HP-IB Commands
Calibrations
If your Counter contains other than the current firmware revision, the following
calibration features are different:
• The calibration functions are in the Utility menu instead of the Calibration
menu, which is accessed by pressing and holding the front-panel Utility
key and then cycling POWER key.
• Calibrations are not protected by a security code.
• A calibration count does not exist to aid in monitoring the number of
calibrations performed.
• A more accurate Time Interval calibration (FINE TI) is not available.
See the section titled “Using the Calibration Menu” in Chapter 2 of the HP53131A/132A Operating Guide for details.
Programming Guide1-3
Chapter 1 Before You Start ...
Differences Between Prior and Current Revisions of the HP
53131A/132A
Measurements
If your Counter contains other than the current firmware revision, the following
measurement capabilities are different:
• Ratio channel selections Ratio 2 to 1 and Ratio 3 to 1
(for those counters equipped with Channel 3) are not available.
• Ratio “AUTO-armed” does not automatically extends gate to capture
sufficient edges.
If Channel 1 input frequency is less than approximately 10 Hz, the Ratio
gate time is not extended to capture sufficient Channel 1 edges to produce
a valid measurement. Default gate time is 100 msec, which is not long
enough to capture two edges on a low-frequency signal. The user is
required to extend the gate by switching to TIME arming, and selecting a
gate time appropriately long.
• Sensitivity for firmware revision below does not have adjusted controls to
LO and MED sensitivity.
In some Counters that contained firmware revision 3317,
LO sensitivity fails to correctly count very high frequency signals.
Statistics
If your Counter contains other than the current firmware revision s, single-shot
statistics are not available using the ON SINGLE: menu item found in the
Statistics menu (use Stats key).
HP-IB Commands
[:SENSe]:EVENt[1|2}:HYSTeresis:RELative
If your Counter contains firmware revisions 3402 and below, the input hysteresis
command and query does not operate in the conventional way. That is,
[:SENSe]:EVENt[1|2]:HYSTeresis:RELative sets high sensitivity when the
parameter is MINimum or 0 percent, and sets low sensitivity when the parameter
is MAXimum or 100 percent.
In the prior firmware revisions (3317, 3335, or 3402), MINimum or 0 percent
corresponded to low sensitivity, and MAXimum or 100 percent corresponded to
high sensitivity.
If your Counter contains firmware revisions 3402 and below, the Totalize
Measurement Instruction commands (shown above) are not available to disable
auto-trigger.
In the firmware revisions 3402 and below, these commands enabled auto-trigger at
the 50% level.
HP 53132A Time Interval Delay Arming
HP 53131A and HP 53132A Counters with a serial number prefix below 3646 are
identical in their TI arming modes. Both only offer Time Interval Delay, where the
STOP trigger of a time interval measurement can be delayed by a user -specified
time.
Programming Guide1-5
Chapter 1 Before You Start ...
Getting Started
Getting Started
Before attempting to program the Counter, take some time to familiarize yourself
with the content of this guide. The remainder of this chapter contains the following
information:
• An explanation of how you should use the programming guide based on
your experience programming instruments and your testing requirements.
• A description of the guide contents.
• A statement of assumptions that are made in the guide.
• A list of related documentation.
How to Use This Guide
How you use this guide depends upon how much you already know about
programming instruments and how complex your measurement requirements are.
Let’s start by establishing your programming background, and then discuss the
type of measurements you want to perform.
New Users
What You Should Understand
As a new user, you should understand that you must have some understanding of a
high-level language such as Pascal, BASIC, C,
or FORTRAN before you can use the command set defined in this guide to control
the Counter. (In Chapter 3, “Programming Your Universal Counter for Remote
Operation,” there are programming examples provided in HP BASIC, Microsoft
QuickBASIC, and Borland Turbo C.) However, whatever language you use,
command strings that control the Counter remain the same.
1-6Programming Guide
Chapter 1 Before You Start ...
Programming Guide Contents
Learning to Program the Counter
To learn how to program the Counter, perform the following:
• Scan the summary tables in Chapter 2, “Command Summary ,”
to get a feeling for the number and structure of commands available to you.
• Read and study map drawings in the section titled “Front Panel to SCPI
Command Maps” in Chapter 2.
• Read Chapter 3, “Programming Your Universal Counter for Remote
Operation,” for an overview of the SCPI concepts as they relate to the HP
53131A/132A Universal Counter. Look at the flowcharts, which illustrate
some of the decisions you must make when programming the Counter.
• Read the section at the end of Chapter 3 titled “Programming Examples for
Making Common Measurements,” which provides programming examples.
• Modify some of the programming examples to select specific measurement
functions. If the programs work, consider yourself an experienced programmer
and use Chapter 4, “Command Reference,” as a reference for detailed
information of all the Counter ’s SCPI commands.
Experienced Programmers
If you have programmed other HP-IB instruments, you will probably be familiar
with many of the concepts and techniques discussed in this guide. Also, you will
find that using the SCPI commands is very similar to using the older HP-IB
commands. The main difference is the hierarchy of the subsystem commands.
(However, this type of structure has been previously used on other instruments.)
Because the SCPI command set and some of the status reporting techniques are
new, you may want to use the following sequence to learn the Counter
programming requirements:
• Look over the steps for a new user and perform any that you think are
applicable to your current level of knowledge. In particular, look at the
measurement techniques and examples provide in Chapter 3, “Programming
Your Universal Counter for Remote Operation.”
• Review the summary tables in Chapter 2, “Command Summary .” If this
chapter contains sufficient information to get you started, write some
programs to explore the Counter’s capabilities. If you need additional
information on any command, refer to the applicable command description in
Chapter 4, “Command Reference.”
Programming Guide1-7
Chapter 1 Before You Start ...
How to Use This Guide
• Review the remaining information in this guide to determine what is applicable
to your programming requirements.
If you need more information than is contained in this guide, see the section in this
chapter titled “Related Documentation.”
Applications
After you have read the appropriate information and written some measurement
programs, you may want to expand the scope of your applications. The following
two techniques are explained in detail:
• If you are going to write interrupt-driven programs (or if you just want to
determine the status of the Counter), read the section titled “Status Reporting”
in Chapter 3.
• If you are going to write programs to transfer data between the Counter and
an external computer, read the sections titled “Overview of Response Message
Formats,” and “Command Settings for Optimizing Throughput” in Chapter 3.
1-8Programming Guide
Chapter 1 Before You Start ...
Programming Guide Contents
Programming Guide Contents
The following information is contained in this guide:
• Table of Contents
• Chapter 1 (this chapter) ,“Before You Start,” is a preface that introduces you
to the programming guide.
• Chapter 2, “Command Summary,” is a quick reference that summarizes the
Counter’s programming commands. It provides you with front-panel to SCPI
command maps, SCPI conformance information, and command summary
tables.
•Chapter 3, “Programming Your Universal Counter for Remote
Operation,” describes how to set up the Counter for remote operation, briefly
explains the SCPI elements and formats, describes status reporting, describes
how to write programs,
and provides programming examples for each of the main tasks that you will
want your Counter to perform.
• Chapter 4, “Command Reference,” is a dictionary that describes the SCPI
subsystems and IEEE 488.2 Common commands.
• Chapter 5, “Errors,” lists all the error messages the Counter can generate and
what caused the error.
• Index
Assumptions
This guide assumes the Counter is correctly installed and interfaced to an external
computer. If it is not, see IEEE HP-IB Interconnection information in Hewlett-
Packard Company, Tutorial Description of the Hewlett-Packard Interface Bus,
1987. (See the following section in this chapter titled “Related Documentation” for
ordering information.)
As previously mentioned, this guide also assumes you are familiar with the frontpanel operation of the Counter. See the HP 53131A/132A Operating Guide for
detailed information about front-panel operation. Knowing how to control the
Counter from the front panel and understanding the measurements you wish to
perform makes the programming task much easier.
Programming Guide1-9
Chapter 1 Before You Start ...
Related Documentation
Related Documentation
This section contains a list of documentation related to the use of the Counter.
Additional information that you may find useful can be found in the following
publications:
1. HP 53131A/132A Operating Guide (HP Part Number 53131-90043)
2. Beginner’s Guide to SCPI (HP Part Number H2325-90002, July 1990
Edition).
3. Beginner’s Guide to SCPI, Barry Eppler (Hewlett-Packard Press,
Addison-Wesley Publishing Co. 1991).
4. Standard Commands for Programmable Instruments (SCPI), Version
1992.0.
This standard is a guide for the selection of messages to be included in
programmable instrumentation . It is primarily intended for instrument
firmware engineers. However, you may find it useful if you are
programming more than one instrument that claims conformance to the
SCPI standard.
You can verify the use of standard SCPI commands in different
instruments.
To obtain a copy of this standard, contact:
SCPI Consortium
8380 Hercules, Suite P3
La Mesa, CA 91942
Phone: (619) 697-8790
FAX: (619) 697-5955
5. The International Institute of Electrical Engineers and Electronic
Engineers, IEEE Standard 488.1-1987, IEEE Standard Digital Interface
for Programmable Instrumentation.
This standard defines the technical details required to design and build an
HP-IB (IEEE 488.1) interface. This standard contains electrical
specification and information on protocol that is beyond the need of most
programmers. However, it can be useful to clarify formal definitions of
certain terms used in related documents.
1-10Programming Guide
Chapter 1 Before You Start ...
Programming Guide Contents
To obtain a copy of this standard, write to:
The Institute of Electrical and Electronic Engineers Inc.
345 East 47th Street
New York, NY 10017 USA
6. The International Institute of Electrical Engineers and Electronic
Engineers, IEEE Standard 488.2-1987, IEEE Standard Codes, Formats,
Protocols, and Common Commands for Use with ANSI/IEEE Std 488.11987 Programmable Instrumentation.
This standard defines the underlying message formats and data types used
in SCPI. It is intended more for firmware engineers than for instrument
users/programmers. However, it can be useful if you need to know the
precise definition of specific message formats, data type, or common
commands.
To obtain a copy of this standard, write to:
The Institute of Electrical and Electronic Engineers Inc.
345 East 47th Street
New York, NY 10017 USA
This HP BASIC manual contains a good non-technical description of the
HP-IB (IEEE 488.1) interface in Chapter 12, “The HP-IB Interface.”
Subsequent revisions of HP BASIC may use a slightly different title for
this manual or chapter.
This manual is the best reference on I/O for HP BASIC programmers.
To obtain a copy of this manual, contact your nearest
Hewlett-Packard Sales office.
8. Hewlett-Packard Company, Tutorial Description of the
Hewlett-Packard Interface Bus, 1987.
To obtain a copy of this manual, contact your nearest
Hewlett-Packard Sales office.
Programming Guide1-11
Chapter 1 Before You Start ...
Related Documentation
1-12Programming Guide
2
2
Command Summary
A Quick Reference
Chapter 2 Command Summary
Introduction
Introduction
This chapter is a quick reference that summarizes the Counter ’s programming
commands.
Chapter Summary
• Front Panel to SCPI Command Maps
1
– Some SCPI Syntax Conventionspg. 2-3
– Input Channels Conditioning Keys to SCPI
Command Mappg. 2-4
– Instrument Control, Utility, Recall, and
Save & Print Keys to SCPI Command Mappg. 2-6
– MEASURE Keys to SCPI Command Mappg. 2-8
– Gate & ExtArm Key to SCPI Command Mappg. 2-10
– Gate & ExtArm Key to SCPI Command Map
and Above) Time Interval Arming Commandspg. 2-14
– LIMITS and MATH Keys to SCPI Command
Mappg. 2-16
– Calibration Menu to SCPI Command Mappg. 2-18
pg. 2-3
• HP 53131A/132A Command Summary
2
pg. 2-20
– SCPI Conformance Informationpg. 2-20
– IEEE 488.2 Common Commandspg. 2-21
– HP 53131A/132A SCPI Subsystem Commandspg. 2-24
• *RST Response
3
pg. 2-40
_______________________________
1
The section titled “Front Panel to SCPI Command Maps,” provides maps that show the front-panel keys
and their corresponding (or related) SCPI commands.
2
The section titled “HP 53131A/132A Command Summary,” lists the IEEE 488.2 Common and the SCPI
Subsystem commands in tables 2-1 and 2-2, respectively.
3
The section titled *RST Response, lists the states of all of the commands that are affected by the *RST
command in Table 2-3. This section also lists commands that are unaffected by *RST in
Table 2-4.
2-2Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Front Panel to SCPI Command Maps
Figures 2-1 through 2-6 provide maps that show the one-to-one relationship of the
front-panel keys and the SCPI commands. These maps should help with
identifying commands if you are already familiar with the front panel.
Some SCPI Syntax Conventions
[ ]An element inside brackets is optional. Note, the brackets
are NOT part of the command and should NOT be sent to
the Counter.
1 | 2Means use either 1 or 2.
<numeric_value>Means enter a number.
SENSe Means you MUST use either all the upper case letters or
the entire word. The lower case letters are optional. For
example, SENS and SENSE are both valid. However,
SEN is not valid. (Note SENSe is used here as an
example, but this convention is true for all SCPI
commands.)
NOTE
When you see quotation marks in the command ’s parameter
(shown in the “Parameter Form” column in Table 2-2), you must send the
quotation marks with the command. Refer to the section titled “Using HP BASIC”
in Chapter 3 (page 3-61) of this guide for details on how to use double quotes or
single quotes to enclose the string parameter of a command.
Programming Guide2-3
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Input Channels Conditioning Keys to SCPI Command Map
_____________________________
*For TI 1 TO 2 (Time Interval measurements) only .
**Channel 3 is optional.
Figure 2-1. Input Channels Conditioning Keys to SCPI Command
Map (Part 1 of 2)
2-4Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Input Channels Conditioning Keys to SCPI Command Map
(Cont.)
Since the primary purpose of these front-panel keys is to change the function, the
corresponding [:SENSe]:FUNCtion[:ON] command is listed in the menu map
above. The front-panel keys, however, invoke couplings which affect other
settings, whereas the [:SENSe]:FUNCtion[:ON] command does not.
Figure 2-3. MEASURE Keys to SCPI Command Map (Part 2 of 2)
Programming Guide2-9
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Gate & ExtArm Key to SCPI Command Map
Freq, Period,
Ratio
(HP 53131A/132A)
Auto Arming:
a. GATE: AUTO
Digits Arming:
b. GATE:DIGITS
c. DIGITS: <digits>
Time Arming:
d. GATE:TIME
e. TIME:<time>
Phase
Totalize
Rise Time, Fall
Time,+/-Width,
Time
Interval
Dutycycle
(HP 53131A/132A)
(HP 53131A/132A)
(HP 53131A/132A)
(HP 53131A and
HP 53132As with S/N
prefix below 3646 )
See page 2-14 for
HP 53132A (with S/N
prefix 3646 and
above).
Auto Arming:
a. ARM: AUTO
Auto Arming:
a. GATE: AUTO
Auto Arming:
a. ARM: AUTO
Auto Arming:
a. ARM:AUTO
b1. DELAY: NONE
b2. DELAY: TIME
c. TIME:<time>
n. [:SENSe]:TINTerval:ARM:ESTOP[:LAYer[1]]:TIMer <numeric_value>
[S]
o. [:SENSe]:TINTerval:ARM:ESTOP[:LAYer[1]]:ECOunt <numeric_value>
Figure 2-4. Gate & ExtArm Key to SCPI Command Map (Part 6 of 6)
Programming Guide2-15
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
LIMITS and MATH Keys to SCPI Command Map
Figure 2-5. LIMITS and MATH Keys to SCPI Command Map
(Part 1 of 2)
2-16Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
LIMITS and MATH Keys to SCPI Command Map (Cont.)
1a.:CALCulate2:LIMit:UPPer[:DATA] <numeric_value> [HZ | S | DEG]
b.:CALCulate2:LIMit:LOWer[:DATA] <numeric_value> [HZ | S | DEG]
2a.:CALCulate2:LIMit:STATe OFF | ON
b1. :INITiate:AUTO OFF
b2. :INITiate:AUTO ON
c.:CALCulate2:LIMit:DISPlay GRAPh | NUMBer
3a.:DISPlay[:WINDow]:TEXT:FEED “CALC3” *
:CALCulate3:AVERage:TYPE MAXimum | MINimum |
SDEViation | MEAN *
OR
:DISPlay[:WINDow]:TEXT:FEED “CALC2” *
b.:CALCulate3:AVERage:COUNt <numeric_value>
c.:CALCulate3:AVERage[:STATe] OFF | ON
d1. :CALCulate3:LFILter:STATe OFF
d2. :CALCulate3:LFILter:STATe ON
e1. :TRIGger:COUNt:AUTO OFF
e2. :TRIGger:COUNt:AUTO ON
4a.:TRACe[:DATA] SCALE,<numeric_value>
b.:TRACe[:DATA] OFFSET,<numeric_value> [HZ | S | DEG]
c.:CALCulate:MATH:STATe OFF | ON
*Use CALC3:AVER:TYPE and :DISP[:WIND]:TEXT:FEED “CALC3” to specify
SHOW: STD DEV, MEAN, MAX, or MIN. Use DISP[:WIND]:TEXT:FEED “CALC2” to
specify SHOW: MEAS.
Figure 2-5. LIMITS and MATH Keys to SCPI Command Map
(Part 2 of 2)
Programming Guide2-17
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Calibration Menu to SCPI Command Map
Figure 2-6. Calibration Menu to SCPI Command Map (Part 1 of 2)
2-18Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Calibration Menu to SCPI Command Map (Cont.)
1a.:CALibration:SECurity:STATe?
b.:DIAGnostic:CALibration:INPut1:OFFSet:AUTO ONCE
:DIAGnostic:CALibration:INPut2:OFFSet:AUTO ONCE
:DIAGnostic:CALibration:INPut1:GAIN:AUTO ONCE
:DIAGnostic:CALibration:INPut2:GAIN:AUTO ONCE
:DIAGnostic:CALibration:TINTerval:QUICk
:DIAGnostic:CALibration:TINTerval:FINE[1 | 2 | 3 | 4]
:DIAGnostic:CALibration:ROSCillator:AUTO ONCE
The Calibration Menu is accessed by holding the Scale & Offset key and cycling
POWER key.
Figure 2-6. Calibration Menu to SCPI Command Map (Part 2 of 2)
Programming Guide2-19
Chapter 2 Command Summary
HP 53131A/132A Command Summary
HP 53131A/132A Command Summary
This section summarizes both the IEEE 488.2 Common and
HP 53131A/132A Standard Commands for Programmable Instruments (SCPI)
commands in tabular format. IEEE 488.2 Common commands are listed first,
followed by SCPI commands.
SCPI Conformance Information
The SCPI commands used in the HP 53131A/132A are in conformance with the
SCPI Standard Version 1992.0. The SCPI command set consists of the following:
• Common commands as defined in IEEE 488.2-1987—listed and summarized
in Table 2-1.
• SCPI Subsystem commands as confirmed (and listed) in the SCPI Standard—
the commands defined in Table 2-2 as “Std.”
• SCPI Subsystem commands designed for the instrument in conformance with
SCPI standards but not yet listed in the SCPI Standard—the commands
defined in Table 2-2 as “New.”
Details of all HP 53131A/132A commands can be found in Chapter 4, “Command
Reference” of this programming guide.
Information on the SCPI commands format, syntax, parameter, and response types
is provided in Chapter 3, “Programming Your Universal Counter for Remote
Operation,” of this programming guide.
2-20Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
IEEE 488.2 Common Commands
The Common Commands are general purpose commands that are common to all
instruments (as defined in IEEE 488.2). Common Commands are easy to
recognize because they all begin with an “*” (for example, *RST, *IDN?, *OPC ).
These commands are generally not related to measurement configuration. They are
used for functions like resetting the instrument, identification, or synchronization.
Table 2-1 lists the Common Commands in alphabetical order by mnemonic, name
and function. More information concerning the operation of IEEE 488.2 status
reporting commands and structure can be found in the “Status Reporting” section
of Chapter 3. Standard explanations of the IEEE 488.2 Common commands can
be found in the ANSI/IEEE Std. 488.2-1987, IEEE Standard Codes, Formats,Protocols, and Common Commands document .
Programming Guide2-21
Chapter 2 Command Summary
HP 53131A/132A Command Summary
Table 2-1. IEEE 488.2 Common Commands
MnemonicCommand NameFunction
*CAL?
*CLS
*DDT <arbitrary block>
*DMC <string>,
<arbitrary block>
*EMC <NRf>
*EMC?
*ESE <NRf>
*ESE?
Calibration
Clear Status
Define Device Trigger Command
Define Macro Command
Enable Macro Command
Enable Macro Query
Standard Event Status Enable
Standard Event Status Enable
Query
Causes the Counter to perform an internal interpolator selfcalibration and returns a response that indicates whether or
not the instrument completed the self-calibration without
error.
Clears Status data structures (Event Registers and Error
Queue).
Defines either INIT, FETC?, READ?, or nothing to be
executed when the Counter receives a GET or *TRG
command.
Assigns a sequence of zero or more commands/queries to a
macro label.
No query form.
Enables and disables expansion of macros.
Non-zero value enables; zero value disables.
Queries whether macros are enabled.
Sets the Standard Event Status Enable Register.
Queries the Standard Event Status Enable Register.
*ESR?
*GMC? <string>
*IDN?
*LMC?
*OPC
*OPC?
Note: Pending operations include measurements in progress.
Event Status Register Query
Get Macro Contents Query
Identification Query
Learn Macro Query
Operation Complete
Operation Complete Query
2-22Programming Guide
Queries the Standard Event Status Register.
Queries the current definition of a currently defined macro
label.
Queries the Counter identification.
Queries the currently defined macro labels.
Causes Counter to set the operation complete bit in the
Standard Event Status Register when all pending
operations (see Note) are finished.
Places an ASCII “1” in the Output Queue when all
pending operations (see Note) are completed.
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Table 2-1. IEEE 488.2 Common Commands (Continued)
MnemonicCommand NameFunction
*OPT?
*PMC
*RCL <NRf>
*RST
*SAV <NRf>
*SRE <NRf>
*SRE?
*STB?
*TRG
Option Identification Query
Purge Macro Command
Recall
Reset
Save
Service Request Enable
Service Request Enable Query
Status Byte Query
Trigger
Identifies the options installed in the Counter.
Deletes all macros previously defined using the
*DMC command.
Restores the state of the Counter from a copy stored
in local non-volatile memory (0 through 20 are valid
memory registers).
Resets the Counter to a known state.
Stores the current state of the Counter in local nonvolatile memory (1 through 20 are valid memory
registers).
Set the Service Request Enable register.
Queries the Service Request Enable register.
Queries the Status Byte and Master Summary Status
bit.
This trigger command is the device-specific analog
of the IEEE 488.1 defined GET.
It initiates measurement, unless *DDT was used to
redefine device trigger.
*TST?
*WAI
Note: Pending operations include measurements in progress.
Self-Test Query
Wait-to-Continue
Programming Guide2-23
Executes an internal self-test and reports the results.
Makes Counter wait until all pending operations (see
Note) are completed before executing commands
following *WAI command.
Chapter 2 Command Summary
HP 53131A/132A Command Summary
HP 53131A/132A SCPI Subsystem Commands
SCPI Subsystem commands include all measurement functions and some general
purpose functions. SCPI Subsystem Commands use a hierarchy relationship
between keywords that is indicated by a “:” (colon). For example, in the
SYST:ERR? query, the “:” between SYST and ERR? indicates ERR? is
subordinate to SYST.
Table 2-2 lists the SCPI Subsystem Commands in alphabetical order by the
command keyword. The table shows the Subsystem commands hierarchical
relationship, related parameters (if any), and any associated information and
comments.
Not all commands have a query form. Unless a command is specified as “No
Query” or “Query Only” in the “Comments” column of Table 2-2, it has both
a command and a query form. Any command in the table that is shown with a
“?” at the end,
is a “Query Only” command.
Std/New Column
The Std/New column in Table 2-2 gives the status of the command with respect to
the SCPI standard. The “Std” commands operate as defined in the SCPI standard
and as defined in this guide.
The category of “New” consists of commands that could be:
• SCPI approved but are not yet in the SCPI manual
• HP approved and submitted for SCPI approval.
• Not approved at all.
The “New” commands operate as defined in this guide.
Parameter Form Column
Refer to the section titled “Parameter Types” on page 3-11 in Chapter 3,
“Programming Your Universal Counter for Remote Operation,” for descriptions of
the different parameter types (such as <Boolean>, <NRf>, <arbitrary block>,
etc.).
2-24Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Table 2-2. HP 53131A/132A SCPI Command Summary
Keyword/SyntaxParameter FormStd/
New
:ABORt
:CALCulate[1]
:DATA?
:FEED
:IMMediate
:AUTO
:MATH
[:EXPRession]
:CATalog?
[:DEFine]?
:NAME | :SELect
:STATe
:CALCulate2
:FEED
:IMMediate
:AUTO
:LIMit
:CLEar
:AUTO
[:IMMediate]
:DISPlay
:FAIL?
“[:]SENSe[1]”
<Boolean>
SCALE_OFFSET
<Boolean>
“[:]CALCulate[1]”
<Boolean>
<Boolean>
GRAPh | NUMBer
StdEvent; no query. Aborts measurement in progress.
Std
Std
Std
Std
Std
Std
Std
New
New
New
Std
Std
Std
Std
Std
Std
Std
Std
Std
New
Std
Comments
Subsystem. Performs post-acquisition math processing
(scale and offset) and data transfer on the data
acquired by a SENSe function.
Query only. Returns scaled/offset measurement result.
Sets the data flow to be fed into the CALCulate block.
Event or query; causes the Counter to recalculate
existing data without re-acquiring.
Enables/disables automatic post-processing.
Subtree.
Subtree.
Returns the name of the defined equation,
SCALE_OFFSET.
Returns the expression (equation) used for
math (scale/offset) processing.
Sets the name of selected math expression (equation).
Enables/disables math (scale/offset) processing.
Note that this setting must be enabled for any of the
other :CALC[1] settings to be used.
Subsystem. Performs post-acquisition LIMit testing and
data transfer.
Sets the data flow to be fed into the CALCulate2 block.
Event; no query. Causes the Counter to recalculate
existing data without re-acquiring.
Enables/disables automatic post-processing.
Subtree. Collects together the commands associated
with controlling and getting reports from a single LIMit
test.
Subtree.
Enables the automatic clearing of limit test results.
Event; no query. Clears the limit test results.
Sets whether the measurement display is numeric or
symbolic (on a graph).
Query only. Returns a 0 or 1 to indicate if the last
tested measurement passed or failed the limit test.
0 = pass; 1 = fail.
Programming Guide2-25
Chapter 2 Command Summary
HP 53131A/132A Command Summary
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
Keyword/SyntaxParameter FormStd/
New
:CALCulate2 (Cont.)
:LIMit (Cont.)
:FCOunt
:LOWer?
:UPPer?
[:TOTal]?
:LOWer
[:DATA]
:STATe
:UPPer
[:DATA]
:PCOunt
[:TOTal]?
:CALCulate3
:AVERage
:ALL?
:CLEar
:COUNt
:CURRent?
[:STATe]
:TYPE
:DATA?
:FEED
<numeric_value> [HZ | S
| DEG]
<Boolean>
<numeric_value> [HZ | S
| DEG]
<numeric_value>
<Boolean>
MAXimum | MINimum |
SDEViation | SCALar or
MEAN
“[:]CALCulate[1]”
Std
New
New
New
Std
Std
Std
Std
Std
New
New
Std
Std
New
Std
Std
New
Std
Std
Std
Std
Comments
Subtree. An abbreviation for Fail COunt.
Query only. Returns the number of limit test
failures at the lower limit.
Query only. Returns the number of limit test
failures at the upper limit.
Query only. Returns the total number of
measurements that failed the limit test.
Subtree.
Sets lower limit used in limit testing.
Sets the limit test enable. Note that this setting
must be enabled for any of the other :CALC2
settings can be used.
Subtree.
Sets upper limit used in limit testing.
Subtree. An abbreviation for Pass COunt.
Query only. Returns the total number of
measurements that passed the limit test.
Subsystem. Performs post-acquisition statistics
computation and data transfer.
Subtree. Collects together the commands
associated with the Statistics capabilities.
Returns all four Statistics results (i.e., mean,
standard deviation, maximum, and minimum).
Event; no query. Clears the statistics results
and statistics count.
Selects number of measurements to combine
for statistics.
Query only. Returns the current number of data
values collected, thus far.
Enables/disables statistics post-processing.
Note that this setting must be enabled for any
of the other :CALC3 settings to be used.
Selects which statistic will be in
:CALC3:DATA?,and on the front-panel display.
Query only. Returns statistic result specified by
:CALC3:AVER:TYPE.
Sets the data flow to be fed into the
CALCulate3 block.
2-26Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
Keyword/SyntaxParameter FormStd/
New
:CALCulate3 (Cont.)
:LFILter
:LOWer
[:DATA]
:STATe
:UPPer
[:DATA]
:PATH?
:CALibration
[:ALL]?
:COUNt?
:DATA
:SECurity
:CODE
:STATe
<numeric_value> [HZ | S |
DEG]
<Boolean>
<numeric_value> [HZ | S |
DEG]
<arbitrary block>
<NRf>
<Boolean>, <NRf>
New
New
New
New
New
New
Std
Std
Std
New
Std
New
New
New
Comments
Subtree. Limit FILter for statistics.
Subtree.
Sets the statistics filter lower limit.
Sets the statistics filter enable.
Subtree.
Sets the statistics filter upper limit.
Query only. Returns LFIL, AVER.
Subsystem.
Query only. Causes an internal interpolator
self-calibration.
Query only. Returns value indicating number
of times the Counter has been calibrated.
Transfers the calibration data (input gain,
input offset, reference oscillator, and time
interval).
No query. Sets the calibration security code.
Enables or prevents calibration of the
Counter. Query returns security status. 0 =
unsecure; calibration allowed. 1 = secure;
calibration disallowed.
:CONFigure
:DIAGnostic
:CALibration
:INPut[1|2]
:GAIN
:AUTO
:OFFSet
:AUTO
:INTerpolator
:AUTO
StdSee Measurement Instructions in this table.
ONCE | OFF
ONCE | OFF
ONCE | OFF | ON
Std
New
New
New
New
New
New
New
New
Subsystem.
Subtree.
Subtree. 1 | 2 specifies channel.
Subtree.
ONCE calibrates input gain.
Subtree.
ONCE calibrates input offset.
Subtree.
ONCE calibrates the interpolators.
Programming Guide2-27
Chapter 2 Command Summary
HP 53131A/132A Command Summary
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
Keyword/SyntaxParameter FormStd/
New
:DIAGnostic (Cont.)
:CALibration (Cont.)
:ROSCillator
:AUTO
:STATus?
:TINTerval
:FINE
:QUICk
:DISPlay
:ENABle
:MENU
[:STATe]
[:WINDow]
:TEXT
:FEED
:RADix
ONCE | OFF
[1 | 2 | 3 | 4]
<Boolean>
OFF
“[:]CALCulate2” |
“[:]CALCulate3”
COMMa | DPOint
New
New
New
New
New
New
Std
Std
Std
Std
Std
Std
Std
New
Comments
Subtree. ROSCillator is an abbreviation for
Reference OSCillator.
ONCE calibrates the timebase. This command is
usable only if the instrument contains the medium or
high stability oscillator option.
Query only. Returns status of last calibration.
0 = pass; 1 = fail.
Subtree.
Event; no query. Four steps which calibrate out
Ch1, 2 electrical path length differences.
Event; no query. Calibrates out Ch1, 2 electrical path
length differences.
Subsystem. Controls the selection and presentation
of textual information on the display.
Controls whether the whole display is visible.
Subtree.
Sets the Counter to switch from the menu display to
the result display.
Subtree.
Subtree. Allows for the display of textual information.
Sets which data flow is fed into the display. “CALC2”
specifies the raw measurement, scaled/offset
measurement, or Limit Graph display. “CALC3”
specifies the statistics result display.
Sets the character used to separate integral and
fractional portions of a number. (USA numerical
convention is Decimal POint.)
:FETCh
:FORMat
[:DATA]
:HCOPy
:CONTinuous
StdSee Measurement Instructions in this table.
ASCii | REAL
<Boolean>
Std
Std
New
NewEnables or disables printing results.
Subsystem. Sets a data format for transferring
numeric information.
Sets the data format.
2-28Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
Keyword/SyntaxParameter FormStd/
New
:INITiate
:AUTO
:CONTinuous
[:IMMediate]
:INPut[1|2]
:ATTenuation
:COUPling
:FILTer
[:LPASs]
[:STATe]
:FREQuency?
:IMPedance
<Boolean>
<Boolean>
1 | 10
AC | DC
<Boolean>
<numeric_value>
[OHM]
Std
New
Std
Std
Std
Std
Std
Std
Std
Std
Std
Std
Comments
Subsystem. Controls the initiation of measurements.
AUTO ON enables the Counter to automatically stop
measuring on a limit test failure. AUTO OFF
disables the automatic stop.
Sets the enable for continuously initiated
measurements.
Event; no query. Causes the instrument to initiate
the number of measurements specified by
:TRIGger:COUNt:AUTO.
Subsystem. Controls the characteristics
of the instrument’s input ports. :INPut1= channel 1
and :INPut2= channel 2
Sets input attenuation.
Sets input coupling.
Subtree. Allows a low pass filter to be inserted in the
path of the measurement signal.
Subtree. Controls the Low PASs filter.
Sets the Low PASs filter enable.
Query only. Returns the cutoff frequency of the low
pass filter. Units are Hertz.
Sets input impedance (50 Ω or 1 MΩ).
:INPut3
:COUPling?
:IMPedance?
:MEASure
Std
Std
Std
StdSee Measurement Instructions in this table.
Subsystem. Queries the characteristics of the
Counter’s input channel 3.
Query only. Returns channel 3 input coupling.
Query only. Returns channel 3 input impedance.
Programming Guide2-29
Chapter 2 Command Summary
HP 53131A/132A Command Summary
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
* The only functions which can be derived (using FETC? or READ?) from the stored data are period
to/from frequency, maximum to/from minimum, maximum to/from peak-to-peak, and minimum
to/from peak-to-peak. All other functions require an acquisition of a new type.
** <source_list> has the same syntax as SCPI <channel _list> syntax. For example, a
single-channel function (e.g., frequency, period, etc.) would use (@1) to specify channel 1,
whereas a two-channel function (e.g., time interval, phase, and frequency ratio) would use (@1),
(@2) to specify a measurement between channel 1 and channel 2.
***For HP 53131A firmware revision s below 3335, only Ratio 1 to 2 and Ratio 1 to 3 were offered.
**** This <function> is only allowed with :CONFigure.
Programming Guide2-31
Std
Std
New
New
New
Chapter 2 Command Summary
HP 53131A/132A Command Summary
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
Keyword/SyntaxParameter FormStd/
New
:MEMory
:DELete
:MACRo
:FREE
:MACRo?
:NSTates?
:READ
[:SENSe]
:DATA?
:EVENt[1|2]
:HYSTeresis
:RELative
:LEVel
[:ABSolute]
:AUTO
:RELative
:SLOPe
:EVENt2
:FEED
<string>
[“[:]SENSe[1]”]
<numeric_value> [PCT]
<numeric_value> [V]
<Boolean>
<numeric_value> [PCT]
POSitive | NEGative
“[:]INPut[1] | [:]INPut2”
Std
Std
New
Std
Std
Std
StdSee Measurement Instructions in this
Std
Std
New
New
New
New
New
New
New
New
New
New
Comments
Subsystem. Manages instrument
memory.
Subtree.
Event; no query. Deletes the macro with
the name specified by the string
parameter.
Subtree.
Query only. Returns memory usage and
availability corresponding to macro data.
Query only. Returns the number of
available *SAV/*RCL states in the
instrument.
table.
Subsystem setup commands.
Query only. Returns the current
measurement result data of the SENSe
subsystem (no scale or offset applied).
Subtree. Defines the “trigger event.”
Subtree.
1
Sets the size of the hysteresis window
as a percentage of allowable hysteresis.
2
Sets the sensitivity of the input channel
as a percentage of allowable sensitivity.
Subtree.
Sets the level at the center of the
hysteresis window.
Sets the “auto-trigger” enable.
Sets the percentage of the peak-to-peak
range of the signal at which the
instrument will auto trigger. 0-100%.
Sets which edge of the input signal will
be considered an event.
Subtree.
Sets the common/separate enable.
INPut2 is separate; INPut1 is common.
(Only applies for Time Interval function.)
______________________________
1
Current firmware revision .
2
Prior firmware revisions 3317, 3335, and 3402.
2-32Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
Subtree. Queries the characteristics of the “trigger
event” for channel 3 input.
Subtree.
Query only. Returns the channel 3 input trigger level.
Query only. Returns the edge of the channel 3 input
that will be considered an event.
Subtree. Controls the frequency, frequency ratio, and
period measuring capabilities of the instrument.
Subtree. Synchronizes the frequency start and stop
arm with events.
Subtree.
Sets the slope of the external start arm signal used in
external arming frequency, frequency ratio, and
period measurements. Only applies when
[:SENS]:FREQ:ARM[:STAR]:SOUR EXT is selected.
Sets the start arm for frequency, frequency ratio, and
period measurements.
Subtree.
Sets the resolution in terms of digits used in arming
frequency, frequency ratio, and period
measurements. Only applies when
[:SENS]:FREQ:ARM:STOP:SOUR DIG is selected.
Sets the slope of the external stop arm signal used in
external arming frequency, frequency ratio, and
period measurements. Only applies when
[:SENS]:FREQ:ARM:STOP:SOUR EXT is selected.
Sets the stop arm for frequency, frequency ratio, and
period measurements.
Sets the gate time used in arming frequency,
frequency ratio, and period measurements. Only
applies when [:SENS]:FREQ:ARM:STOP:SOUR TIM
is selected.
Specifies the approximate frequency of a signal you
expect to measure at channel 1, 2, or 3.
Configures Counter to perform a pre-measurement
step to automatically determine the approximate
frequency of the measurement signal(s).
Programming Guide2-33
Chapter 2 Command Summary
HP 53131A/132A Command Summary
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
Subtree. Selects the <sensor function> to
be sensed by the instrument.
Sets the <sensor function> to be sensed by
the instrument.
(Positive) duty cycle on channel 1.
(Positive) duty cycle on channel 1.
Fall Time on channel 1.
Fall Time on channel 1.
Frequency on channel 1, 2, or 3.
1
Frequency Ratio 1 to 2, 1 to 3, 2 to 1, or 3
to 1.
Negative Pulse Width on channel 1.
Period on channel 1, 2, or 3.
Phase of channel 1 relative to channel 2.
Positive Pulse Width on channel 1.
Rise Time on channel 1.
Rise Time on channel 1.
Time Interval channel 1 to channel 2.
Totalize on channel 1.
Voltage Maximum on channel 1 or 2.
Voltage Minimum on channel 1 or 2.
Voltage Peak to Peak on Channel 1 or 2.
Subtree. Controls the phase measuring
capabilities of the instrument.
Subtree.
Subtree. Synchronizes Phase start arm with
events.
Sets the slope of the external start arm
signal used in external arming phase
measurements. Only applies when
[:SENS]:PHAS:ARM[:STAR]:SOUR EXT is
selected.
Sets the start arm for phase
measurements.
Subtree. Controls the Reference
OSCillator.
Subtree.
Set the enable for checking the validity and
presence of the external reference.
Query only. Returns the frequency value of
the external reference oscillator.
______________________________
1
For HP 53131A firmware revision s below 3335, only Ratio 1 to 2 and Ratio 1 to 3 were offered.
2-34Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
Keyword/SyntaxParameter FormStd/
New
[:SENSe] (Cont.)
:ROSCillator (Cont.)
:SOURce
:AUTO
:TINTerval
:ARM (HP 53131A
and HP 53132A with
S/N prefix below
3646)
[:STARt]
:SLOPe
:SOURce
:STOP
:SOURce
:TIMer
:TOTalize
:ARM
[:STARt]
:SLOPe
:SOURce
INTernal | EXTernal
<Boolean>
See Table 2-2A on
page 2- 38 for HP
53132A (with S/N
3646 and above)
TINTerval
ARM commands)
POSitive | NEGative
IMMediate | EXTernal
IMMediate | TIMer
<numeric_value> [S]
POSitive | NEGative
EXTernal | IMMediate
Std
Std
New
New
New
New
New
New
New
New
New
New
New
New
New
Comments
Sets the selection of a reference timebase.
Sets the enable for automatically selecting a reference
timebase.
Subtree. Controls the time interval (including Time
Interval, Rise Time, Fall Time, Dutycycle, and Pulse
Width functions) measuring capabilities of the
instrument.
Subtree. Synchronizes the time interval start and stop
arm with events.
Subtree.
Sets the slope of the external start arm signal used in
external arming time interval measurements (including
Time Interval, Rise Time, Fall Time, Dutycycle, and
Pulse Width functions). Only applies when
[:SENS]:TINT:ARM[:STAR]:SOUR EXT is selected.
Sets the start arm for time interval (including Time
Interval, Rise Time, Fall Time, Dutycycle, and Pulse
Width) measurements.
Subtree.
Sets the stop arm (i.e., the delay) for Time Interval
measurements.
Sets the time used to delay the stop arm for Time
Interval measurements. Only applies when
[:SENS]:TINT:ARM:STOP:SOUR TIM is selected.
Subtree. Controls the totalize measuring capabilities of
the instrument.
Subtree. Synchronizes totalize start and stop arm with
events.
Subtree.
Sets the slope of the external start arm signal used in
external arming totalize measurements. Only applies
when [:SENS]:TOT:ARM[:STAR]:SOUR EXT is selected.
Sets the start arm for totalize measurements.
Programming Guide2-35
Chapter 2 Command Summary
HP 53131A/132A Command Summary
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
Subtree.
Sets the slope of the external stop arm signal used
in external arming totalize measurements. Only
applies when [:SENS]:TOT:ARM:STOP:SOUR
EXT is selected.
Sets the stop arm for totalize measurements.
Sets the gate time used in totalize measurements.
Only applies when
[:SENS]:TOT:ARM:STOP:SOUR TIM is selected.
Subsystem. Controls the SCPI-defined (Operation
and Questionable) status-reporting structures.
Subtree.
Query only. Queries the Operation Condition
Status Register.
Sets the Operation Event Status Enable Register.
Query only. Queries the Operation Event Status
Register.
Sets the negative transition filter for the Operation
status reporting structure.
Sets the positive transition filter for the Operation
status reporting structure.
Event; No query. Presets the enable registers and
transition filters associated with the Operation and
Questionable status reporting structures.
Subtree.
Query only. Queries the Questionable Data
Condition Status Register.
Sets the Questionable Data Event Status Enable
Register.
Query only. Queries the Questionable Data Event
Status Register.
Sets the positive transition filter for the
Questionable Data status reporting structure.
Sets the negative transition filter for the
Questionable Data status reporting structure.
2-36Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Table 2-2. HP 53131A/132A SCPI Command Summary (Continued)
Keyword/SyntaxParameter FormStd/
New
:SYSTem
:COMMunicate
:SERial
:CONTrolStdSubtree.
:DTRIBFull | ON | LIMitStdSets the usage of the DTR line of the RS-232
:TRANsmitStdSubtree. Affects parameters associated with
:BAUD<numeric_value>StdSets the baud rate.
:PACEXON | NONEStdSets the software pacing scheme.
:PARityStdSubtree. Controls the parity of the channel.
[:TYPE]EVEN | ODD | NONEStdSets the parity scheme.
:ERRor?StdQuery only. Queries the oldest error in the
Std
Std
Std
Comments
Subsystem. Collects the functions that are not
related to instrument performance.
Subtree. Collects together configuration of
control/communication interfaces.
Subtree. Controls the physical configuration of
the RS- 232C port.
port.
transmission.
Error Queue and removes the error from the
queue (first in, first out).
:KEY<numeric_value>StdSimulates the pressing of a front-panel key.
:LOG?NewQuery only. Returns a comma-separated list of
integers representing all of the entries in the
Key Queue.
:VERSion?StdQuery only. Returns the SCPI version number
Subsystem.
Query only. Returns list of intrinsic constants.
Sets the offset value.
Sets the scale value.
Queries the offset value.
Queries the scale value.
Subsystem.
Subtree.
Controls the number of measurements to be
made when :INIT[:IMM] is performed.
Programming Guide2-37
Chapter 2 Command Summary
HP 53131A/132A Command Summary
Table 2-2A. HP 53132A (S/N Prefix 3646 and Above) Time Interval
Arming SCPI Command Summary
Keyword/SyntaxParameter FormStd/
New
[:SENSe] (Cont.)
:TINTerval
:ARM
:ESTART
:LAYer2
:SLOPe
:SOURce
[:LAYer[1]]
:ECOunt
:SOURce
:TIMer
:ESTOP
:LAYer2
:SLOPe
:SOURce
[:LAYer[1]]
:ECOunt
POSitive | NEGative
IMMediate | EXTernal
<numeric_value>
IMMediate | TIMer |
INTernal1
<numeric_value>
POSitive | NEGative
IMMediate | EXTernal
<numeric_value>
New
New
New
New
New
New
New
New
New
New
New
New
New
New
New
New
Comments
Subtree. Controls the time interval (including
Time Interval, Rise Time, Fall Time, Dutycycle,
and Pulse Width functions) measuring
capabilities of the instrument.
Subtree. Synchronizes the time interval start and
stop arm with events.
Sets the slope of the external start arm signal
used in external arming Time Interval
measurements (including Time Interval, Rise
Time, Fall Time, Dutycycle, and Pulse Width).
Sets the start arm for time interval (including
Time Interval, Rise Time, Fall Time, Dutycycle,
and Pulse Width) measurements.
Sets the event count used to delay the start arm
for Time Interval measurements. Only applies
when [:SENS]:TINT:ARM:ESTART:SOUR INT1
is selected.
Sets the start arm delay for Time Interval
measurements.
Sets the time used to delay the start arm for
Time Interval measurements. Only applies when
[:SENS]:TINT:ARM:ESTART:SOUR TIM is
selected.
Sets the slope of the external stop arm signal
used in external arming Time Interval
measurements.
Sets the stop arm for Time Interval
measurements.
Sets the event count used to delay the stop arm
for Time Interval measurements. Only applies
when [:SENS]:TINT:ARM:ESTOP:SOUR INT2 is
selected.
2-38Programming Guide
Chapter 2 Command Summary
Front Panel to SCPI Command Maps
Table 2-2A. HP 53132A (S/N Prefix 3646 and Above) Time Interval
Arming SCPI Command Summary (Continued)
Sets the stop arm delay for Time Interval
measurements.
Sets the time used to delay the stop arm for
Time Interval measurements. Only applies
when [:SENS]:TINT:ARM:ESTOP:SOUR TIM is
selected.
Sets the slope of the external start arm signal
used in external arming Tme Interval
measurements (including Time Interval, Rise
Time, Fall Time, Dutycycle, and Pulse Width).
Only applies when
[:SENS]:TINT:ARM[:STAR]:SOUR EXT is
selected.
Sets the start arm for time interval (including
Time Interval, Rise Time, Fall Time, Dutycycle,
and Pulse Width) measurements.
Subtree.
Sets the stop arm (i.e., the delay) for Time
Interval measurements.
Sets the time used to delay the stop arm for
Time Interval measurements. Only applies
when [:SENS]:TINT:ARM:STOP:SOUR TIM is
selected.
Programming Guide2-39
Chapter 2 Command Summary
*RST Response
*RST Response
The IEEE 488.2 *RST command returns the instrument to a specified state
optimized for remote operation. (Use *CLS to clear the status event registers and
the SCPI error queue.)
The states of commands affected by the *RST command are described in Table 2-
3. Since the HP 53131A and HP 53132A have different arming capabilities for
Time Interval measurements, sub-tables (Table 2-3A and Table 2- 3B) are
provided. Table 2-3A describes the state of the HP 53131A’s [:SENSe]:Interval
commands affected by the *RST command, and Table 2-3B describes the
HP 531312A’s [:SENSe]:Interval commands affected by the *RST command .
Table 2-4 lists commands that are unaffected by *RST.
• To Measure the Statistics of 50 Measurementspg. 3-64
• To Use Limits to Filter Data Before Measuring Stats pg. 3-66
• To Read and Store Calibration Datapg. 3-68
• To To Perform a Time Interval Calibrationpg. 3-69
• To Optimize Throughputpg. 3-73
• To Use Macros pg. 3-75
Where to Find QuickBASIC Programming Examples
• To Make a Frequency Measurementpg. 3-77
• To Perform Limit Testing pg. 3-78
• To Measure the Statistics of 50 Measurementspg. 3-80
• To Use Limits to Filter Data Before Measuring Statspg. 3-82
• To Read and Store Calibration Datapg. 3-85
• To Optimize Throughputpg. 3-86
• To Use Macros pg. 3-88
Where to Find Turbo C Programming Examples
• To Make a Frequency Measurement pg. 3-91
• To Use Limits to Filter Data Before Measuring Statspg. 3-93
• To Optimize Throughputpg. 3-96
Programming Guide3-3
Chapter 3 Programming Your Universal Counter for Remote Operation
Configuring the HP-IB
Configuring the HP-IB
This section gives information on connecting and configuring the
HP-IB to enable remote operation of the Counter .
The Counter has two HP-IB operating modes:
• Addressed (talk/listen)—This mode is for bi-directional communication. The
Counter can receive commands and setups from the computer, and can send
data and measurement results.
To select the talk/listen operating mode, set the Counter ’s HP-IB address
from 0 to 30. Refer to the following section titled “To Set the HP-IB Mode
and Address” for instructions on how to set an HP-IB address from the frontpanel.
• Talk-only—In this mode, the Counter can send data to a printer. It cannot
receive commands or setups from the computer.
To select the talk-only operating mode, set the Counter ’s HP-IB mode to
“TALK”. Refer to the following section titled
“To Set the HP-IB Mode and Address” for instructions on how to set the talkonly mode from the front-panel.
When the Counter is shipped from the factory, it is configured as addressed
(talk/listen) with the address set to “3.”
To Set the HP-IB Mode and Address
1Press and hold Recall (Utility) key, then cycle POWER.
2Press Recall (Utility) key until HP-IB: is displayed.
To best demonstrate how to set the address, let’s assume that
HP-IB: 3 is currently being displayed.
3-4Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
3a To set the address to “15”, perform the following:
a. Press s key.
HP-IB: 03 is displayed. Note that “0” digit appears and is highlighted,
indicating that this digit will change when the
d or f arrow key is pressed.
b. Press d key.
HP-IB: 13 is displayed.
c. Press g key
HP-IB: 13 is displayed, but now the “3” digit is highlighted, indicating
that this digit will change when the d or f arrow key is pressed.
d. Press d key twice or until 15 is displayed.
NOTE
HP-IB: 15 is displayed.
e. Go on to step 4.
3b To set the HP-IB mode to “TALK,” perform the following:
a. Press s key.
HP-IB: 03 is displayed. Note that “0” digit appears and is highlighted,
indicating that this digit will change when the
d or f arrow key is pressed.
b. Press d key until “TALK” is displayed.
HP-IB: TALK is displayed.
c. Go on to step 4.
4Press Enter key.
BE SURE to press the Enter key to complete the entry.
The address/mode is now stored in non-volatile memory, and does not change
when power is cycled or after a remote interface reset.
Programming Guide3-5
Chapter 3 Programming Your Universal Counter for Remote Operation
Configuring the HP-IB
To Connect the Counter to a Computer
Connect the Counter to a computer by simply installing an HP-IB cable (such as
an HP 10833A cable) between the two units as shown in Figure 3-1.
Figure 3-1. HP-IB Interconnection
Remote/Local Operation
At power-up, the Counter is under front-panel (local) control. Once in remote, the
Counter settings cannot be affected by the front-panel controls. The Save & Print
key may be used to manually return to local control (only if local-lockout is off).
3-6Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Overview of Command Types and Formats
There are two types of HP 53131A/132A programming commands: IEEE 488.2
Common Commands and Standard Commands for Programmable Instruments
(SCPI). The IEEE 488.2 Common Commands control and manage
communications between the HP 53131A/132A and the controller or personal
computer. The SCPI commands control instrument functions. The format of each
type of command is described in the following paragraphs. (Refer to
Chapter 2, “Command Summary,” for SCPI conformance information.)
Common Command Format
The IEEE 488.2 Standard defines the Common commands as commands that
perform functions like reset, self-test, status byte query, and identification.
Common commands always begin with the asterisk (*) character, and may include
parameters. The command keyword is separated from the first parameter by a
space character. Some examples of Common commands are as follows:
*RST *IDN? *RCL 1
SCPI Command and Query Format
SCPI commands perform functions like instrument setup. A subsystem command
has a hierarchical structure that usually consists of a top level (or root) keyword,
one or more lower-level keywords, and parameters. The following example shows
a command and its associated query:
:INPut:COUPling AC
:INPut:COUPling?
INPut is root-level keyword with COUPling the second level keyword, and AC is
the command parameter.
Programming Guide3-7
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Elements of SCPI Commands
A program command or query is composed of functional elements that include a
header (or keywords with colon separators), program data, and terminators . These
elements are sent to the Counter over the
HP-IB as a sequence of ASCII data messages. Examples of a typical Common
Command and Subsystem Command are:
Figure 3-2 shows the simplified syntax of a Subsystem Command. You must use a
space (SP) between the last command mnemonic and the first parameter in a
Subsystem Command. Note that if you send more than one parameter with a single
command, you must separate adjacent parameters with a comma.
NOTE: sp = space. ASCII character decimal 32
Figure 3-2. Simplified Program Command Syntax Diagram
Common Command Syntax
Figure 3-3 shows the simplified syntax of a Common Command . You must use a
space (SP) between the command mnemonic and the parameter in a Common
Command.
3-8Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
NOTE: sp = space. ASCII character decimal 32
Figure 3-3. Simplified Common Command Syntax Diagram
Abbreviated Commands
The command syntax shows most keywords as a mixture of upper and lower case
letters. Upper case letters indicate the abbreviated spelling for the command. For
better program readability, you may send the entire keyword. The HP
53131A/132A accepts either command form and is not case sensitive.
For example, if the command syntax shows CALCulate, then CALC and
CALCULATE are both acceptable forms. Other forms of CALCulate, such as
CALCU or CALCULA will generate an error. You may use upper and/or lower
case letters. Therefore, CALCULATE, calculate, and CaLcUlAtE are all
acceptable.
Keyword Separator
A colon (:) always separates one keyword from the next lower-level keyword as
shown below:
:INPut:COUPling?
Optional Keyword
Optional keywords are those which appear in square brackets ([ ]) in the command
syntax. (Note that the brackets are not part of the command and are not sent to the
Counter.)
Suppose you send a second level keyword without the preceding optional keyword.
In this case, the Counter assumes you intend to use the optional keyword and
responds as if you had sent it.
Programming Guide3-9
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Examine the portion of the [:SENSe] subsystem shown below:
[:SENSe]
:FREQuency
:ARM
:STOP
:SOURce EXTernal
The root-level keyword [:SENSe] is an optional keyword. To set the Counter ’s
frequency stop arm to external, you can use either of the following:
:SENS:FREQ:ARM:STOP:SOUR EXT
or
:FREQ:ARM:STOP:SOUR EXT
Implied Channel (Optional Numeric Keyword Suffix)
Some commands allow specifying a channel with an optional numeric keyword
suffix. These commands will show the channel numbers within square brackets.
The brackets are not part of the command and are not sent to the Counter.
For example, :INPut[1|2]:COUPling AC | DC represents coupling commands for
channels 1 and 2:
:INPut[1]:COUPling AC | DC
:INPut2:COUPling AC | DC
If you do not specify the channel number, the implied channel is 1. For example,
you can send either of the following to configure
channel 1’s coupling to AC:
:INPut1:COUPling AC
or
:INPut:COUPling AC
3-10Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Parameter Types
Table 3-1 contains explanations and examples of parameter types. Parameter
types may be numeric value, Boolean, literal, NRf, string, non-decimal numeric ,
or arbitrary block.
Table 3-1. Command and Query Parameter Types
TYPEEXPLANATIONS AND EXAMPLES
<numeric value>
Accepts all commonly used decimal representation of numbers including optional signs, decimal
points, and scientific notation:
123, 123e2, -123, −1.23e2, .123, 1.23e −2, 1.23000E−01.
Special cases include MINimum and MAXimum as follows:
MINimum selects minimum value available.
MAXimum selects maximum value available.
Queries using MINimum or MAXimum return the associated numeric value.
<Boolean>
<literal>
<NRf>
<string>
<non-decimal
numeric>
<arbitrary block>
Represents a single binary condition that is either true or false:
1 or ON, 0 or OFF (Query response returns only 1 or 0.)
An <NRf> is rounded to an integer. A non-zero value is interpreted as 1.
Selects from a finite number of choices. These parameters use mnemonics to represent each valid
setting. An example is the INPut:COUPling AC | DC command parameters (AC | DC).
Flexible numeric representation. Only positive integers are used for NRf parameters in the Counter.
A string parameter is delimited by either single quotes or double quotes. Within the quotes, any
characters in the ASCII 7-bit code may be specified.
The following HP BASIC program statement sends a command containing a <string> parameter:
OUTPUT 703;"FUNC ‘FREQ’"
Format for specifying hexadecimal (#H1F), octal (#Q1077), and binary (#B10101011) numbers
using ASCII characters. May be used in :STATus subsystem commands.
The syntax is a pound sign (#) followed by a non-zero digit representing the number of digits in the
subsequent decimal integer. The decimal integer specifies the number of
8-bit data bytes being sent. This is followed by the actual data. The terminator is a line feed
asserted with EOI. For example, for transmitting 8 bytes of data, the format could be:
The “2” indicates the number of digits that follow and the two digits “08” indicate the number of data
bytes to be transmitted.
A zero-length block has the format: #0<new line>^EOI
<new line> is defined as a single ASCII-encoded byte corresponding to 10 decimal.
Programming Guide3-11
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Parameter Separator
If you send more than one parameter with a single command, you must separate
adjacent parameters with a comma .
Query Parameters
All selectable <numeric value> parameters can be queried to return the minimum
or maximum values they are capable of being set to by sending a MINimum or
MAXimum parameter after the “?.” For example, consider the INPut:IMPedance?
query.
If you send the query without specifying a parameter (INP:IMP?), the present
impedance value is returned. If you send the MIN parameter (using INP:IMP?
MIN), the command returns the minimum level currently available. If you send the
MAX parameter, the command returns the maximum level currently available. Be
sure to place a space between the question mark and the parameter.
Suffixes
A suffix is the combination of suffix elements and multipliers that can be used to
interpret the <numeric value> sent. If a suffix is not specified, the Counter
assumes that <numeric value> is unscaled (that is, Volts, seconds, etc.)
For example, the following two commands are equivalent:
Suffix elements, such as HZ (Hertz), S (seconds), V (volts),
OHM (Ohms), PCT (percent), and DEG (degrees) are allowed within this format.
3-12Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Suffix Multipliers
Table 3-2 lists the suffix multipliers that can be used with suffix elements (except
PCT and DEG).
Table 3-2. Suffix Multipliers
DEFINITIONMNEMONICNAME
1E18EXETA
1E15PEPETA
1E12TTERA
1E9GGIGA
1E6MA ( or M for OHM and HZ)*MEGA
1E3KKILO
1E-3M (except for OHM and HZ)*MILLI
1E-6UMICRO
1E-9NNANO
1E-12PPICO
1E-15FFEMTO
1E-18AATTO
*The suffix units, MHZ and MOHM, are special cases that should not be confused with
<suffix multiplier>HZ and <suffix multiplier>OHM.
Command Terminator
A command may be terminated with a <new line> (ASCII character decimal 10), an
EOI (End-of-Identify) asserted concurrent with last byte, or an EOI asserted
concurrent with a <new line> as the last byte.
Programming Guide3-13
Chapter 3 Programming Your Universal Counter for Remote Operation
Using Multiple Commands
Using Multiple Commands
Program Messages
Program Messages are a combination of one or more properly formatted SCPI
Commands. Program messages always go from a computer to the Counter. They
are sent to the Counter over the Counter’s HP-IB as a sequence of ASCII data
messages.
Program Message Syntax
Figure 3-4 shows the simplified syntax of a program message. You can see
Common Commands and Subsystem Commands in the same program message. If
you send more than one command in one message, you must separate adjacent
commands with a semicolon.
NOTE:
<new line> = ASCII character decimal 10
^END = EOI asserted concurrent with last byte
Figure 3-4. Simplified Program Message Syntax Diagram
When using IEEE 488.2 Common commands with SCPI Subsystem commands on
the same line, use a semicolon between adjacent commands. For example:
*RST;:INP:COUP AC
When multiple subsystem commands are sent in one program message, the first
command is always referenced to the root node. Subsequent commands, separated
by “;”, are referenced to the same level as the preceding command if no “:” is
present immediately after the command separator (the semicolon).
3-14Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
For example, sending :INP:COUP AC;IMP 50 is equivalent to sending:
:INP:COUP AC
:INP:IMP 50
or
:INP:COUP AC;:INP:IMP 50
The “:” must be present to distinguish another root level command. For example:
:INP:COUP AC;:INIT:CONT OFF
is equivalent to sending:
:INP:COUP AC
:INIT:CONT OFF
If the “:”(which is following the “;” and is in front of INIT) is omitted, the Counter
assumes that the second command is “:INP:INIT:CONT OFF” and generates a
syntax error.
Programming Guide3-15
Chapter 3 Programming Your Universal Counter for Remote Operation
Overview of Response Message Formats
Overview of Response Message Formats
Response Messages
Response messages are data sent from the Counter to a computer in response to a
query. (A query is a command followed by a question mark. Queries are used to
find out how the Counter is currently configured and to transfer data from the
Counter to the computer.)
After receiving a query, the Counter interrogates the requested configuration and
places the response in its HP-IB output queue.
The output message remains in the qu eue until it is read or another command is
issued. When read, the message is transmitted across the HP-IB to the computer.
You read the message by using some type of enter statement that includes the
device address and an appropriate variable. Use a print statement to display the
message. The following HP BASIC example illustrates how to query the Counter
and display the message:
10 OUTPUT 703;":INP:COUP?"
20 ENTER 703; A$
30 PRINT A$
40 END
Response Message Syntax
Figure 3-5 shows the simplified syntax of a Response Message. Response
messages may contain both commas and semicolon separators. When a single
query command returns multiple values, a comma is used to separate each item.
When multiple queries are sent in the same program message, the groups of data
corresponding to each query are separated by a semicolon. Note that a <new line>
^END is always sent as a response message terminator.
NOTE:
<new line> = ASCII character decimal 10
^END = EOI asserted concurrent with last byte
; = multiple response separator (ASCII character decimal 59)
, = data separator within a response (ASCII character decimal 44)
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Response Message Data Types
Table 3-3 contains explanations of response data types.
Table 3-3. Response Message Data Types
TypeDescription
<NR1>This numeric representation has an implicit radix point.
The maximum number of characters in <NR1> response data is 17 (maximum
16 digits, 1 sign).
<NR2>This numeric representation has an explicit radix point.
The maximum number of characters in <NR2> response data is 17 (maximum
15 mantissa digits, 1 sign, 1 decimal point).
<NR3>This numeric representation has an explicit radix point and an exponent.
The maximum number of characters in <NR3> response data is 22 (maximum
15 mantissa digits, 2 signs, 1 decimal point , 1 ‘E’ character, 3 exponent digits).
Not a NumberNot a Number is represented by the value 9.91E37 . (Not a Number is defined in
IEEE 754). The Counter responds with this numeric value when queried for a
floating point number it cannot provide. This value will be formatted as an
<NR3>.
Programming Guide3-17
Chapter 3 Programming Your Universal Counter for Remote Operation
Overview of Response Message Formats
Table 3-3. Response Message Data Types (Continued)
TypeDescription
<Boolean>A single ASCII-encoded byte, 0 or 1, is returned for the query of settings that use
<Boolean> parameters.
<literal>ASCII-encoded bytes corresponding to the short form of the literal used as the
command parameter.
For example, if the :CALC3:AVER:TYPE MAXimum command is sent to the
Counter, the :CALC3:AVER:TYPE? response would be MAX.
<string>A string response consists of ASCII characters enclosed by double quotes.
For example, string data is used for the “<error description>” portion of
:SYST:ERR? response and for [:SENS]:FUNC? response.
<definite length
block>
The syntax is a pound sign (#) followed by a non-zero digit representing the
number of digits in the subsequent decimal integer. The decimal integer specifies
the number of 8-bit data bytes being sent. This is followed by the actual data.
The terminator is a line feed asserted with EOI. For example, for transmitting 8
bytes of data, the format might be:
The “2” indicates the number of digits that follow and the two digits “08” indicate
the number of data bytes to be transmitted.
A zero-length block has the format: #0<new line>^EOI
<new line> is defined as a single ASCII-encoded byte corresponding to
10 decimal.
3-18Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Status Reporting
The HP 53131A/132A status registers conform to the SCPI and IEEE 488.2
standards.
Figure 3-6 shows all the status system register groups and queues in the Counter.
This is a high level drawing that does not show all the registers that are contained
in each group. It is intended as a guide to the bits used in each of these register
groups to monitor the Counter ’s status. Note that besides the Operation Status and
the Questionable Data/Signal Register groups, a summary of the Standard Status
Structure Registers (defined by IEEE 488.2-1987) is shown.
Refer to the section in this chapter titled “How to Program the Counter for Status
Reporting” and the flowchart in Figure 3-10 for detailed information on
programming the status reporting system.
Programming Guide3-19
Chapter 3 Programming Your Universal Counter for Remote Operation
Status Reporting
Figure 3-6. HP 53131A/132A SCPI Status Reporting Summary
Functional Diagram
3-20Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Status Byte Register and Service Request Enable Register
Figure 3-7. Status Byte and Service Request Enable
Status Byte Register
The Status Byte Register is the summary-level register in the status reporting
structure. It contains summary bits that monitor activity in the other status
registers and queues as shown in Figure 3-7.
The Status Byte Register is a live register—its summary bits are set TRUE or
FALSE (one or zero) by the presence or absence of the condition which is being
summarized.
The Status Byte Register can be read with either a serial poll or the *STB? query.
The Status Byte Register is altered only when the state of the overlying status data
structures is altered.
The entire Status Byte Register can be cleared by sending the *CLS command, by
itself in a program message, to the Counter.
Table 3-4 lists the Status Byte Register bits and briefly describes each bit.
Programming Guide3-21
Chapter 3 Programming Your Universal Counter for Remote Operation
Status Reporting
Table 3-4. Status Byte Register
BITWEIGHTSYMBOLDESCRIPTION
0Not used
1Not used
2Not used
Questionable Data/Signal Status Register
38QSB
416MAVMessage Available Summary Bit
532ESBStandard Event Status Register Summary Bit
664RQS/MSSRequest Service/Master Status Summary Bit
7128OSBOperation Status Register Summary Bit
Summary Bit
A detailed description of each bit in the Status Byte Register follows:
• Bits 0–2 are not used.
• Bit 3 (QSB) summarizes the Questionable Data/Signal Status Event
Register.
This bit indicates whether or not one or more of the enabled Questionable
Data/Signal events have occurred since the last reading or clearing of the
Questionable Data/Signal Status Event Register.
This bit is set TRUE (one) when an enabled event in the Questionable
Data/Signal Status Event Register is set TRUE. Conversely, this bit is set
FALSE (zero) when no enabled events are set TRUE.
•Bit 4 (MAV) summarizes the Output Queue.
This bit indicates whether or not the Output Queue is empty.
This bit is set TRUE (one) when the Counter is ready to accept a request
by the external computer to output data bytes; that is, the Output Queue is
not empty. This bit is set FALSE (zero) when the Output Queue is empty.
3-22Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
•Bit 5 (ESB) summarizes the Standard Event Status Register.
This bit indicates whether or not one of the enabled Standard Event Status
Register events have occurred since the last reading or clearing of the
Standard Event Status Register.
This bit is set TRUE (one) when an enabled event in the Standard Event
Status Register is set TRUE. Conversely, this bit is set FALSE (zero)
when no enabled events are set TRUE.
•Bit 6 (RQS/MSS) summarizes IEEE 488.1 RQS and Master Summary
Status.
When a serial poll is used to read the Status Byte Register,
the RQS bit indicates if the device was sending SRQ TRUE. The RQS bit
is set FALSE by a serial poll.
When *STB? is used to read the Status Byte Register, the MSS bit
indicates the Master Summary Status. The MSS bit indicates whether or
not the Counter has at least one reason for requesting service.
•Bit 7 (OSB) summarizes the Operation Status Event Register.
This bit indicates whether or not one or more of the enabled Operation
events have occurred since the last reading or clearing of the Operation
Status Event Register.
This bit is set TRUE (one) when an enabled event in the Operation Status
Event Register is set TRUE. Conversely, this bit is set FALSE (zero)
when no enabled events are set TRUE.
Service Request Enable Register
The Service Request Enable Register selects which summary bits in the Status
Byte Register may cause service requests as shown in
Figure 3-7.
Use *SRE to write to this register and *SRE? to read this register.
Use *SRE 0 to clear the register. A cleared register does not allow status
information to generate the service requests. (Power-on also clears this register.)
Programming Guide3-23
Chapter 3 Programming Your Universal Counter for Remote Operation
Status Reporting
Standard Event Status Register Group
Figure 3-8. Standard Event Status Reporting
Standard Event Status Register
The Standard Event Status Register contains bits that monitor specific IEEE
488.2-defined events as shown in Figure 3-8.
Use *ESR? to read this register.
Use *ESR? or *CLS to clear this register.
Table 3-5 lists the Standard Event Status Register bits and briefly describes each
bit.
Table 3-5. Standard Event Status Register
BITWEIGHTSYMBOLDESCRIPTION
01OPCOperation Complete
1(RQC)Not used because this instrument cannot
request permission to become active
IEEE 488.1 controller-in-charge.
24QYEQuery Error
38DDEDevice-Specific Error
416EXEExecution Error
532CMECommand Error
6(URQ)Not used because this instrument does not
define any local controls as “User Request”
controls.
7128PONPower On
3-24Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
A detailed description of each bit in the Standard Event Status Register follows:
•Bit 0 (Operation Complete) is an event bit which is generated in response
to the *OPC command. This bit indicates that the Counter has completed
all pending operations.
If there are no pending operations at the time *OPC executes, this bit sets
immediately.
If there is a pending operation at the time *OPC executes, this event bit sets
when the pending operation condition transistions from TRUE to FALSE.
If
the :TRIGger:COUNt:AUTO is OFF, or
statistics are disabled, or
the function is set to Totalize or Voltage Peaks,
then the pending operation condition is set TRUE when either: 1) a single
measurement is initiated, or 2) a continuous measurement cycle is initiated.
The pending operation condition is set FALSE when the measurement cycle
terminates.
If
the TRIGger:COUNt:AUTO is ON, and
statistics are enabled, and
the function is set to Totalize or Voltage Peaks,
then the pending operation condition is set TRUE when a block of
measurements is initiated. The pending operation condition is set FALSE
when the block of measurements completes; that is, when the last
measurement in the block completes.
Bit 1 is not used.
•Bit 2 (Query Error) is an event bit which indicates that either 1) an
attempt was made to read the Output Queue when it was empty or 2) data
in the Output Queue has been lost.
Errors -400 through -499 are query errors.
Programming Guide3-25
Chapter 3 Programming Your Universal Counter for Remote Operation
Status Reporting
•Bit 3 (Device-Specific Error) is an event bit which indicates an operation
did not properly complete due to some condition of the Counter.
Errors -300 through -399 and all those with positive error numbers
(+2000 through ...) are device-specific errors.
•Bit 4 (Execution Error) is an event bit which indicates that a command
could not be executed 1) because the parameter was out of range or
inconsistent with the Counter’s capabilities, or 2) because of some
condition of the Counter.
Errors -200 through -299 are execution errors.
•Bit 5 (Command Error) is an event bit which indicates one of the
following has occurred: 1) an IEEE 488.2 syntax error, 2) a semantic
error indicating an unrecognized command, or 3) a Group Execute
Trigger was entered into the input buffer inside of a program message.
• Bit 6 is not used.
• Bit 7 (Power On) is an event bit which indicates that an off-to-on
transition has occurred in the Counter ’s power supply.
Standard Event Status Enable Register
The Standard Event Status Enable Register selects which events in the Standard
Event Status Register are reflected in the ESB summary bit (bit 5) of the Status
Byte Register as shown in
Figure 3-8.
Use *ESE to write to this register and *ESE? to read this register.
Use *ESE 0 to clear the register. (Power-on also clears this register.)
3-26Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Operation Status Register Group and Questionable Data/Signal
Status Register Group
The Operation Status Register Group and the Questionable Data/Signal Status
Register Group each have a complete set of registers that consists of the following:
• a condition register
• a positive transition filter register
• a negative transition filter register
• an event register
• an event enable register
Figure 3-9 shows the model that these register groups follow.
Figure 3-9. Operation and Questionable Status Reporting Model
Programming Guide3-27
Chapter 3 Programming Your Universal Counter for Remote Operation
Status Reporting
Condition Register
A condition register continuously monitors the hardware and firmware status of
the Counter. There is no latching or buffering for this register; it is updated in real
time. Reading a condition register does not change its contents.
A transition filter specifies the transition criteria for setting event bits TRUE.
When the transition filter specifies a positive transition, the event becomes TRUE
when its associated condition makes a FALSE to TRUE transition only.
When the transition filter specifies a negative transition, the event becomes TRUE
when its associated condition makes a TRUE to FALSE transition only.
When the transition filter specifies either a positive or a negative transition, the
event becomes TRUE when its associated condition makes either a FALSE to
TRUE or a TRUE to FALSE transition.
A transition filter is defined by a positive and negative transition filter register.
Table 3-6 describes how the transition filter registers define the transition criteria
for setting an event bit TRUE.
Table 3-6. Transition Filter Definition
Positive
Transition
Filter Bit
TRUEFALSEpositive transition
FALSETRUEnegative transition
TRUETRUEeither a positive or negative transition
FALSEFALSEneither transition (event reporting is disabled)
Negative
Transition
Filter Bit
Transition Which Causes the
Event-Bit to be set TRUE
3-28Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
Transition filters are unaffected by *CLS or queries. Transition filters are set to
default values by :STATus:PRESet and power-on.
An event register bit (event bit) shall be set TRUE when an associated event
occurs. These bits, once set, are “sticky.” That is, they cannot be cleared even if
they do not reflect the current status of a related condition, until they are read.
The event enable registers are cleared by :STATus:PRESet and power-on .
Programming Guide3-29
Chapter 3 Programming Your Universal Counter for Remote Operation
Status Reporting
Operation Status Register Group
The Operation Status Register Group monitors conditions which are part of the
Counter’s normal operation.
Table 3-7 lists the Operation Status Register bits and briefly describes each bit.
Table 3-7. Operation Status Register
BITWEIGHTDESCRIPTION
01Calibrating
1Not used
2Not used
3Not used
416Measuring
5Not used
6Not used
7Not used
8256Computing Statistics
9512Using Internal Reference
101024In Limit Event
11–14Not used
15Not used since some controllers may have difficulty
reading a 16-bit unsigned integer. The value of this bit
shall always be 0.
A detailed description of each bit in the Operation Status Register follows:
•Bit 0 (Calibrating) is a condition bit which indicates the Counter is
currently performing a (front-panel invoked or HP-IB invoked)
calibration.
The condition bit is TRUE (one) during a calibration and FALSE (zero)
otherwise.
3-30Programming Guide
Chapter 3 Programming Your Universal Counter for Remote Operation
Elements of SCPI Commands
• Bits 1–3 are not used.
• Bit 4 (Measuring) is a condition bit which indicates the Counter is
actively measuring.
The condition bit is TRUE (one) during a measurement and FALSE (zero)
otherwise.
If the external reference has been explicitly selected and an absent or
invalid signal at the external reference input is detected, then the Counter
will not report Measuring (even though it may perform an auto trigger) in
response to the user initiating a measurement.
• Bits 5–7 are not used.
• Bit 8 (Computing Statistics) is a condition bit which indicates the
Counter has begun collecting measurements for the next statistical
computation.
The condition bit is TRUE (one) once the first of N measurements has
begun, and remains TRUE until the last of N measurements has
completed.
•Bit 9 (Using Internal Reference) is a condition bit which indicates the
Counter is using the internal reference.
The condition bit is TRUE (one) while the Counter is using the internal
reference. The condition bit is FALSE (zero) while the Counter is using
the external reference.
This bit monitors both explicit and automatic reference changes. Explicit
reference changes occur when you select internal or external using the
front-panel Utility menu or the HP-IB command, [:SENS]:ROSC:SOUR.
Automatic reference changes occur when the Counter is configured to
select the reference (automatically) by detecting whether or not an external
reference is being supplied.
•Bit 10 (In Limit Event) is an event bit indicating the last measurement
limit tested was “in limit.”
Each and every time a measurement is limit tested and found to be in
limit, this event will be reported.
Programming Guide3-31
Chapter 3 Programming Your Universal Counter for Remote Operation
Status Reporting
Note that this is the only bit in the Operation Status Register which is not
representing a condition. Therefore, the transition filters have no effect on
this bit.
The Counter does not monitor the condition indicating whether the last
measurement was in or out of limit. Hence, the In Limit Event bit does
NOT represent the transition from an “out of limit measurement” to “in
limit measurement.”
•Bits 11–15 are not used.
Questionable Data/Signal Status Register Group
The Questionable Data/Signal Status Register Group monitors
SCPI-defined conditions.
Table 3-8 lists the Questionable Data/Signal Status Register bits and briefly
describes each bit.
Table 3-8. Questionable Data/Signal Status Register
BITWEIGHTDESCRIPTION
0Not used
1Not used
Time (Time Interval, Rise Time, Fall Time, Pulse Width,
24
3Not used
4Not used
532Frequency (only Frequency; not Frequency Ratio)
664Phase
7Not used
8256Calibration Error
9Not used
101024Out of Limit Event
11–13Not used
1416384Command Warning
Duty Cycle, and Period)
15Not used since some controllers may have difficulty
reading a 16-bit unsigned integer. The value of this bit
shall always be 0.
3-32Programming Guide
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.