Keysight Technologies InfiniiVision DSOX1204A Manuel

Keysight InfiniiVision

DSOX1204A/G Oscilloscopes

Programmer's

Guide

2 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide

Notices

No part of this manual may be reproduced in

any form or by any means (including

electronic storage and retrieval or

translation into a foreign language) without

prior agreement and written consent from

Keysight Technologies, Inc. as governed by

United States and international copyright

laws.

Revision

Version 02.01.0000

Edition

March 2019

Available in electronic format only

Published by:

Keysight Technologies, Inc.

1900 Garden of the Gods Road

Colorado Springs, CO 80907 USA

Warranty

The material contained in this document is

provided "as is," and is subject to being

changed, without notice, in future editions.

Further, to the maximum extent permitted

by applicable law, Keysight disclaims all

warranties, either express or implied, with

regard to this manual and any information

contained herein, including but not limited

to the implied warranties of

merchantability and fitness for a particular

purpose. Keysight shall not be liable for

errors or for incidental or consequential

damages in connection with the furnishing,

use, or performance of this document or of

any information contained herein. Should

Keysight and the user have a separate

written agreement with warranty terms

covering the material in this document that

conflict with these terms, the warranty

terms in the separate agreement shall

control.

Technology License

The hardware and/or software described in

this document are furnished under a license

and may be used or copied only in

accordance with the terms of such license.

U.S. Government Rights

The Software is "commercial computer

software," as defined by Federal Acquisition

Regulation ("FAR") 2.101. Pursuant to FAR

12.212 and 27.405-3 and Department of

Defense FAR Supplement ("DFARS")

227.7202, the U.S. government acquires

commercial computer software under the

same terms by which the software is

customarily provided to the public.

Accordingly, Keysight provides the Software

to U.S. government customers under its

standard commercial license, which is

embodied in its End User License Agreement

(EULA), a copy of which can be found at

www.keysight.com/find/sweula. The

license set forth in the EULA represents the

exclusive authority by which the U.S.

government may use, modify, distribute, or

disclose the Software. The EULA and the

license set forth therein, does not require or

permit, among other things, that Keysight:

(1) Furnish technical information related to

commercial computer software or

commercial computer software

documentation that is not customarily

provided to the public; or (2) Relinquish to,

or otherwise provide, the government rights

in excess of these rights customarily

provided to the public to use, modify,

reproduce, release, perform, display, or

disclose commercial computer software or

commercial computer software

documentation. No additional government

requirements beyond those set forth in the

EULA shall apply, except to the extent that

those terms, rights, or licenses are explicitly

required from all providers of commercial

computer software pursuant to the FAR and

the DFARS and are set forth specifically in

writing elsewhere in the EULA. Keysight

shall be under no obligation to update,

revise or otherwise modify the Software.

With respect to any technical data as

defined by FAR 2.101, pursuant to FAR

12.211 and 27.404.2 and DFARS 227.7102,

the U.S. government acquires no greater

than Limited Rights as defined in FAR 27.401

or DFAR 227.7103-5 (c), as applicable in any

technical data.

Safety Notices

CAUTION

A CAUTION notice denotes a hazard.

It calls attention to an operating

procedure, practice, or the like that,

if not correctly performed or

adhered to, could result in damage

to the product or loss of important

data. Do not proceed beyond a

CAUTION notice until the indicated

conditions are fully understood and

met.

WARNING

A WARNING notice denotes a

hazard. It calls attention to an

operating procedure, practice, or

the like that, if not correctly

performed or adhered to, could

result in personal injury or death.

Do not proceed beyond a WARNING

notice until the indicated

conditions are fully understood and

met.

Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 3

In This Book

This book is your guide to programming the InfiniiVision DSOX1204A/G

oscilloscopes:

The first few chapters describe how to set up and get started:

•Chapter 1, “What's New,” starting on page 25, describes programming

command changes in the latest version of oscilloscope software.

•Chapter 2, “Setting Up,” starting on page 31, describes the steps you must take

before you can program the oscilloscope.

•Chapter 3, “Getting Started,” starting on page 37, gives a general overview of

oscilloscope program structure and shows how to program the oscilloscope

using a few simple examples.

•Chapter 4, “Commands Quick Reference,” starting on page 49, is a brief listing

of the DSOX1204A/G oscilloscope commands and syntax.

The next chapters provide reference information on common commands, root level

commands, other subsystem commands, and error messages:

•Chapter 5, “Common (*) Commands,” starting on page 107, describes

commands defined by the IEEE 488.2 standard that are common to all

instruments.

•Chapter 6, “Root (:) Commands,” starting on page 133, describes commands

that reside at the root level of the command tree and control many of the basic

functions of the oscilloscope.

•Chapter 7, “:ABUS Commands,” starting on page 167, describes commands

that control all oscilloscope functions associated with the analog channels bus

display.

Table 1 DSOX1204A/G Model Numbers, Bandwidths

Model: DSOX1204A DSOX1204G

Channels: 4

Bandwidth: 70 MHz

Bandwidth upgrades: 70 MHz to 100 MHz with D1200BW1A upgrade

70 MHz to 200 MHz with D1200BW2A upgrade

100 MHz to 200 MHz with D1200BW3A upgrade

Sampling rate: 2 GSa/s (interleaved), 1 GSa/s (non-interleaved)

Memory: 1 Mpts

Segmented memory: Yes

Waveform generator: No Yes (20 MHz)

Mask/limit test: Yes

4 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide

•Chapter 8, “:ACQuire Commands,” starting on page 177, describes commands

for setting the parameters used when acquiring and storing data.

•Chapter 9, “:CALibrate Commands,” starting on page 191, describes utility

commands for determining the state of the calibration factor protection button.

•Chapter 10, “:CHANnel<n> Commands,” starting on page 201, describes

commands that control all oscilloscope functions associated with individual

analog channels or groups of channels.

•Chapter 11, “:DEMO Commands,” starting on page 223, describes commands

that control the education kit (EDK license) demonstration signals that can be

output on the oscilloscope's Demo terminal.

•Chapter 12, “:DISPlay Commands,” starting on page 227, describes commands

that control how waveforms, graticule, and text are displayed and written on

the screen.

•Chapter 13, “:DVM Commands,” starting on page 241, describes commands

that control the optional DSOXDVM digital voltmeter analysis feature.

•Chapter 14, “:EXTernal Trigger Commands,” starting on page 249, describes

commands that control the input characteristics of the external trigger input.

•Chapter 15, “:FFT Commands,” starting on page 259, describes commands that

control the FFT (Fast Fourier Transform) function for displaying the frequence

content of a waveform.

•Chapter 16, “:FRANalysis Commands,” starting on page 273, describes

commands that control oscilloscope functions associated with the Frequency

Response Analysis (FRA) feature, which is available in G-suffix oscilloscope

models (that have a built-in waveform generator).

•Chapter 17, “:FUNCtion Commands,” starting on page 289, describes

commands that control math waveforms.

•Chapter 18, “:HARDcopy Commands,” starting on page 311, describes

commands that set and query the selection of hardcopy device and formatting

options.

•Chapter 19, “:MARKer Commands,” starting on page 325, describes commands

that set and query the settings of X-axis markers (X1 and X2 cursors) and the

Y-axis markers (Y1 and Y2 cursors).

•Chapter 20, “:MEASure Commands,” starting on page 341, describes

commands that select automatic measurements (and control markers).

•Chapter 21, “:MTESt Commands,” starting on page 399, describes commands

that control the mask test features provided with Option LMT.

•Chapter 22, “:RECall Commands,” starting on page 433, describes commands

that recall previously saved oscilloscope setups, reference waveforms, or

masks.

•Chapter 23, “:SAVE Commands,” starting on page 441, describes commands

that save oscilloscope setups, screen images, and data.

Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 5

•Chapter 24, “:SBUS<n> Commands,” starting on page 461, describes

commands that control oscilloscope functions associated with the serial

decode bus and serial triggering.

•Chapter 25, “:SYSTem Commands,” starting on page 545, describes

commands that control basic system functions of the oscilloscope.

•Chapter 26, “:TIMebase Commands,” starting on page 573, describes

commands that control all horizontal sweep functions.

•Chapter 27, “:TRIGger Commands,” starting on page 585, describes commands

that control the trigger modes and parameters for each trigger type.

•Chapter 28, “:WAVeform Commands,” starting on page 633, describes

commands that provide access to waveform data.

•Chapter 29, “:WGEN Commands,” starting on page 669, describes commands

that control waveform generator (Option WGN) functions and parameters.

•Chapter 30, “:WMEMory<r> Commands,” starting on page 701, describes

commands that control reference waveforms.

•Chapter 31, “Obsolete and Discontinued Commands,” starting on page 711,

describes obsolete commands which still work but have been replaced by

newer commands and discontinued commands which are no longer supported.

•Chapter 32, “Error Messages,” starting on page 757, lists the instrument error

messages that can occur while programming the oscilloscope.

The command descriptions in this reference show upper and lowercase characters.

For example, :AUToscale indicates that the entire command name is :AUTOSCALE.

The short form, :AUT, is also accepted by the oscilloscope.

Then, there are chapters that describe programming topics and conceptual

information in more detail:

•Chapter 33, “Status Reporting,” starting on page 765, describes the

oscilloscope's status registers and how to check the status of the instrument.

•Chapter 34, “Synchronizing Acquisitions,” starting on page 787, describes how

to wait for acquisitions to complete before querying measurement results or

performing other operations with the captured data.

•Chapter 35, “More About Oscilloscope Commands,” starting on page 797,

contains additional information about oscilloscope programming commands.

Finally, there is a chapter that contains programming examples:

•Chapter 36, “Programming Examples,” starting on page 807.

See Also • For more information on using the SICL, VISA, and VISA COM libraries in

general, see the documentation that comes with the Keysight IO Libraries

Suite.

• For information on controller PC interface configuration, see the

documentation for the interface card used (for example, the Keysight 82350A

GPIB interface).

• For information on oscilloscope front-panel operation, see the User's Guide.

6 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide

• For detailed connectivity information, refer to the Keysight Technologies

USB/LAN/GPIB Connectivity Guide. For a printable electronic copy of the

Connectivity Guide, direct your Web browser to www.keysight.com and search

for "Connectivity Guide".

• For the latest versions of this and other manuals, see:

http://www.keysight.com/find/1000X-Series-manual

Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 7

Contents

In This Book / 3

1 What's New

What's New in Version 2.01 / 26

Version 2.00 at Introduction / 27

Command Differences From 1000 X-Series Oscilloscopes / 28

2 Setting Up

Step 1. Install Keysight IO Libraries Suite software / 32

Step 2. Connect and set up the oscilloscope / 33

Using the USB (Device) Interface / 33

Using the LAN Interface / 33

Step 3. Verify the oscilloscope connection / 35

3 Getting Started

Basic Oscilloscope Program Structure / 38

Initializing / 38

Capturing Data / 38

Analyzing Captured Data / 39

Programming the Oscilloscope / 40

Referencing the IO Library / 40

Opening the Oscilloscope Connection via the IO Library / 41

Initializing the Interface and the Oscilloscope / 41

Using :AUToscale to Automate Oscilloscope Setup / 42

Using Other Oscilloscope Setup Commands / 42

Capturing Data with the :DIGitize Command / 43

Reading Query Responses from the Oscilloscope / 45

Reading Query Results into String Variables / 46

Reading Query Results into Numeric Variables / 46

Reading Definite-Length Block Query Response Data / 46

Sending Multiple Queries and Reading Results / 47

Checking Instrument Status / 48

8 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide

4 Commands Quick Reference

Command Summary / 50

Syntax Elements / 103

Number Format / 103

<NL> (Line Terminator) / 103

[ ] (Optional Syntax Terms) / 103

{ } (Braces) / 103

::= (Defined As) / 103

< > (Angle Brackets) / 104

... (Ellipsis) / 104

n,..,p (Value Ranges) / 104

d (Digits) / 104

Quoted ASCII String / 104

Definite-Length Block Response Data / 104

5 Common (*) Commands

*CLS (Clear Status) / 111

*ESE (Standard Event Status Enable) / 112

*ESR (Standard Event Status Register) / 114

*IDN (Identification Number) / 116

*LRN (Learn Device Setup) / 117

*OPC (Operation Complete) / 118

*OPT (Option Identification) / 119

*RCL (Recall) / 120

*RST (Reset) / 121

*SAV (Save) / 124

*SRE (Service Request Enable) / 125

*STB (Read Status Byte) / 127

*TRG (Trigger) / 129

*TST (Self Test) / 130

*WAI (Wait To Continue) / 131

6 Root (:) Commands

:AER (Arm Event Register) / 136

:AUToscale / 137

:AUToscale:AMODE / 139

:AUToscale:CHANnels / 140

:AUToscale:FDEBug / 141

:BLANk / 142

:DIGitize / 143

:MTEenable (Mask Test Event Enable Register) / 144

Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 9

:MTERegister[:EVENt] (Mask Test Event Event Register) / 146

:OPEE (Operation Status Enable Register) / 148

:OPERegister:CONDition (Operation Status Condition Register) / 150

:OPERegister[:EVENt] (Operation Status Event Register) / 152

:OVLenable (Overload Event Enable Register) / 154

:OVLRegister (Overload Event Register) / 156

:PRINt / 158

:RUN / 159

:SERial / 160

:SINGle / 161

:STATus / 162

:STOP / 163

:TER (Trigger Event Register) / 164

:VIEW / 165

7 :ABUS Commands

:ABUS:BIT<m> / 169

:ABUS:BITS / 170

:ABUS:CLEar / 172

:ABUS:DISPlay / 173

:ABUS:LABel / 174

:ABUS:MASK / 175

8 :ACQuire Commands

:ACQuire:COMPlete / 179

:ACQuire:COUNt / 180

:ACQuire:MODE / 181

:ACQuire:POINts / 182

:ACQuire:SEGMented:ANALyze / 183

:ACQuire:SEGMented:COUNt / 184

:ACQuire:SEGMented:INDex / 185

:ACQuire:SRATe / 188

:ACQuire:TYPE / 189

9 :CALibrate Commands

:CALibrate:DATE / 193

:CALibrate:LABel / 194

:CALibrate:OUTPut / 195

:CALibrate:PROTected / 196

:CALibrate:STARt / 197

:CALibrate:STATus / 198

10 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide

:CALibrate:TEMPerature / 199

:CALibrate:TIME / 200

10 :CHANnel<n> Commands

:CHANnel<n>:BANDwidth / 204

:CHANnel<n>:BWLimit / 205

:CHANnel<n>:COUPling / 206

:CHANnel<n>:DISPlay / 207

:CHANnel<n>:IMPedance / 208

:CHANnel<n>:INVert / 209

:CHANnel<n>:LABel / 210

:CHANnel<n>:OFFSet / 211

:CHANnel<n>:PROBe / 212

:CHANnel<n>:PROBe:HEAD[:TYPE] / 213

:CHANnel<n>:PROBe:ID / 214

:CHANnel<n>:PROBe:SKEW / 215

:CHANnel<n>:PROBe:STYPe / 216

:CHANnel<n>:PROTection / 217

:CHANnel<n>:RANGe / 218

:CHANnel<n>:SCALe / 219

:CHANnel<n>:UNITs / 220

:CHANnel<n>:VERNier / 221

11 :DEMO Commands

:DEMO:FUNCtion / 224

:DEMO:OUTPut / 226

12 :DISPlay Commands

:DISPlay:ANNotation / 229

:DISPlay:ANNotation:BACKground / 230

:DISPlay:ANNotation:COLor / 231

:DISPlay:ANNotation:TEXT / 232

:DISPlay:CLEar / 233

:DISPlay:DATA / 234

:DISPlay:INTensity:WAVeform / 235

:DISPlay:LABel / 236

:DISPlay:LABList / 237

:DISPlay:MENU:TIMeout / 238

:DISPlay:PERSistence / 239

:DISPlay:VECTors / 240

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Keysight Technologies Équipement de test

Keysight Technologies

Keysight Technologies 16192A Manuel d'utilisation

Keysight Technologies

Keysight Technologies M8085A Manuel utilisateur

Keysight Technologies

Keysight Technologies U1610/20A Manuel utilisateur

Keysight Technologies

Keysight Technologies InfiniiVision 1000 X-Series Manuel utilisateur

Keysight Technologies

Keysight Technologies 85052B Manuel

Keysight Technologies

Keysight Technologies 16047A Manuel d'utilisation

Keysight Technologies

Keysight Technologies N5990A Manuel utilisateur

Keysight Technologies

Keysight Technologies X Series Manuel utilisateur

Keysight Technologies

Keysight Technologies U3042AM20 Manuel

Keysight Technologies

Keysight Technologies M9703A Guide de l'utilisateur

Keysight Technologies

Keysight Technologies P9241A Guide de l'utilisateur

Keysight Technologies

Keysight Technologies InfiniVision 6000L Series Manuel utilisateur

Keysight Technologies

Keysight Technologies N4891A Manuel utilisateur

Keysight Technologies

Keysight Technologies 8490D Manuel de service

Keysight Technologies

Keysight Technologies U3020AS16 Manuel

Keysight Technologies

Keysight Technologies 16453A Manuel utilisateur

Keysight Technologies

Keysight Technologies U3022AM42 Manuel

Keysight Technologies

Keysight Technologies InfiniiVision 4000 X Series Manuel

Keysight Technologies

Keysight Technologies E7515B UXM 5G Manuel utilisateur

Keysight Technologies

Keysight Technologies 85051B Manuel

Keysight Technologies

Keysight Technologies Infiniium 90000A Series Manuel utilisateur

Keysight Technologies

Keysight Technologies U3020AS62 Manuel

Keysight Technologies

Keysight Technologies Infiniium 90000A Series Manuel utilisateur

Keysight Technologies

Keysight Technologies M8000 Series Manuel utilisateur

Manuels Équipement de test populaires d'autres marques

SMART

SMART KANAAD SBT XTREME 3G Series Manuel utilisateur

Agilent Technologies

Agilent Technologies BERT Serial Manuel utilisateur

Agilent Technologies

Agilent Technologies N3280A Manuel utilisateur

Vernier

Vernier Go Direct Voltage Manuel utilisateur

Lifeloc

Lifeloc R.A.D.A.R. Manuel utilisateur

Fluke

Fluke T5-600 Instructions d'utilisation et d'installation

Mercury

Mercury TSL01 Manuel utilisateur

MAHA

MAHA MBT Series Manuel utilisateur

Fuji Electric

Fuji Electric P-61 Manuel utilisateur

ETC

ETC SealerAtor Manuel utilisateur

Skyfine

Skyfine ETHYWAY V2 Manuel utilisateur

Appion

Appion G5 Twin Manuel utilisateur

PCB Piezotronics

PCB Piezotronics 8159-0112A Manuel utilisateur

BW Technologies

BW Technologies MicroDock II Manuel utilisateur

Sun Nuclear

Sun Nuclear 1027 Manuel utilisateur

Biomark

Biomark HPR LITE READER Manuel utilisateur

Hioki

Hioki 3169-20 Manuel utilisateur

Ashcroft

Ashcroft ATE-100 Manuel utilisateur