User Manual

ManualsBrandsKeysight ManualsBenchtop OscilloscopesOscilloscope, 2x 100MHz, 2GSPS

201

202

203

204

205

206

207

208

209

210

Table Of Contents

In This Book
Contents
What's New
- What's New in Version 1.10
- Version 1.00 at Introduction
- Command Differences From 2000 X-Series Oscilloscopes
Setting Up
- Step 1. Install Keysight IO Libraries Suite software
- Step 2. Connect and set up the oscilloscope
  - Figure 1 Control Connector on Rear Panel
  - Using the USB (Device) Interface
- Step 3. Verify the oscilloscope connection
Getting Started
- Basic Oscilloscope Program Structure
- Programming the Oscilloscope
Commands Quick Reference
- Command Summary
- Syntax Elements
Common (*) Commands
- *CLS (Clear Status)
- *ESE (Standard Event Status Enable)
- *ESR (Standard Event Status Register)
- *IDN (Identification Number)
- *LRN (Learn Device Setup)
- *OPC (Operation Complete)
- *OPT (Option Identification)
- *RCL (Recall)
- *RST (Reset)
- *SAV (Save)
- *SRE (Service Request Enable)
- *STB (Read Status Byte)
- *TRG (Trigger)
- *TST (Self Test)
- *WAI (Wait To Continue)
Root (:) Commands
- :AER (Arm Event Register)
- :AUToscale
- :AUToscale:AMODE
- :AUToscale:CHANnels
- :AUToscale:FDEBug
- :BLANk
- :DIGitize
- :MTEenable (Mask Test Event Enable Register)
- :MTERegister[:EVENt] (Mask Test Event Event Register)
- :OPEE (Operation Status Enable Register)
- :OPERegister:CONDition (Operation Status Condition Register)
- :OPERegister[:EVENt] (Operation Status Event Register)
- :OVLenable (Overload Event Enable Register)
- :OVLRegister (Overload Event Register)
- :PRINt
- :RUN
- :SERial
- :SINGle
- :STATus
- :STOP
- :TER (Trigger Event Register)
- :VIEW
:ABUS Commands
- :ABUS:BIT
- :ABUS:BITS
- :ABUS:CLEar
- :ABUS:DISPlay
- :ABUS:LABel
- :ABUS:MASK
:ACQuire Commands
- :ACQuire:COMPlete
- :ACQuire:COUNt
- :ACQuire:MODE
- :ACQuire:POINts
- :ACQuire:SEGMented:ANALyze
- :ACQuire:SEGMented:COUNt
- :ACQuire:SEGMented:INDex
- :ACQuire:SRATe
- :ACQuire:TYPE
:CALibrate Commands
- :CALibrate:DATE
- :CALibrate:LABel
- :CALibrate:OUTPut
- :CALibrate:PROTected
- :CALibrate:STARt
- :CALibrate:STATus
- :CALibrate:TEMPerature
- :CALibrate:TIME
:CHANnel Commands
- :CHANnel:BANDwidth
- :CHANnel:BWLimit
- :CHANnel:COUPling
- :CHANnel:DISPlay
- :CHANnel:IMPedance
- :CHANnel:INVert
- :CHANnel:LABel
- :CHANnel:OFFSet
- :CHANnel:PROBe
- :CHANnel:PROBe:HEAD[:TYPE]
- :CHANnel:PROBe:ID
- :CHANnel:PROBe:SKEW
- :CHANnel:PROBe:STYPe
- :CHANnel:PROTection
- :CHANnel:RANGe
- :CHANnel:SCALe
- :CHANnel:UNITs
- :CHANnel:VERNier
:DEMO Commands
- :DEMO:FUNCtion
- :DEMO:OUTPut
:DISPlay Commands
- :DISPlay:ANNotation
- :DISPlay:ANNotation:BACKground
- :DISPlay:ANNotation:COLor
- :DISPlay:ANNotation:TEXT
- :DISPlay:CLEar
- :DISPlay:DATA
- :DISPlay:INTensity:WAVeform
- :DISPlay:LABel
- :DISPlay:LABList
- :DISPlay:MENU:TIMeout
- :DISPlay:PERSistence
- :DISPlay:VECTors
:DVM Commands
- :DVM:ARANge
- :DVM:CURRent
- :DVM:ENABle
- :DVM:FREQuency
- :DVM:MODE
- :DVM:SOURce
:EXTernal Trigger Commands
- :EXTernal:BWLimit
- :EXTernal:DISPlay
- :EXTernal:LABel
- :EXTernal:LEVel
- :EXTernal:POSition
- :EXTernal:PROBe
- :EXTernal:RANGe
- :EXTernal:UNITs
:FFT Commands
- :FFT:CENTer
- :FFT:DISPlay
- :FFT:OFFSet
- :FFT:RANGe
- :FFT:REFerence
- :FFT:SCALe
- :FFT:SOURce1
- :FFT:SPAN
- :FFT:VTYPe
- :FFT:WINDow
:FRANalysis Commands
- :FRANalysis:DATA
- :FRANalysis:ENABle
- :FRANalysis:FREQuency:MODE
- :FRANalysis:FREQuency:SINGle
- :FRANalysis:FREQuency:STARt
- :FRANalysis:FREQuency:STOP
- :FRANalysis:PPDecade
- :FRANalysis:RUN
- :FRANalysis:SOURce:INPut
- :FRANalysis:SOURce:OUTPut
- :FRANalysis:TRACe
- :FRANalysis:WGEN:LOAD
- :FRANalysis:WGEN:VOLTage
:FUNCtion Commands
- :FUNCtion:DISPlay
- :FUNCtion[:FFT]:CENTer
- :FUNCtion[:FFT]:PHASe:REFerence
- :FUNCtion[:FFT]:SPAN
- :FUNCtion[:FFT]:VTYPe
- :FUNCtion[:FFT]:WINDow
- :FUNCtion:FREQuency:LOWPass
- :FUNCtion:GOFT:OPERation
- :FUNCtion:GOFT:SOURce1
- :FUNCtion:GOFT:SOURce2
- :FUNCtion:OFFSet
- :FUNCtion:OPERation
- :FUNCtion:RANGe
- :FUNCtion:REFerence
- :FUNCtion:SCALe
- :FUNCtion:SOURce1
- :FUNCtion:SOURce2
:HARDcopy Commands
- :HARDcopy:AREA
- :HARDcopy:APRinter
- :HARDcopy:FACTors
- :HARDcopy:FFEed
- :HARDcopy:INKSaver
- :HARDcopy:LAYout
- :HARDcopy:PALette
- :HARDcopy:PRINter:LIST
- :HARDcopy:STARt
:MARKer Commands
- :MARKer:MODE
- :MARKer:X1Position
- :MARKer:X1Y1source
- :MARKer:X2Position
- :MARKer:X2Y2source
- :MARKer:XDELta
- :MARKer:XUNits
- :MARKer:XUNits:USE
- :MARKer:Y1Position
- :MARKer:Y2Position
- :MARKer:YDELta
- :MARKer:YUNits
- :MARKer:YUNits:USE
:MEASure Commands
- :MEASure:ALL
- :MEASure:BRATe
- :MEASure:CLEar
- :MEASure:COUNter
- :MEASure:DEFine
- :MEASure:DELay
- :MEASure:DUTYcycle
- :MEASure:FALLtime
- :MEASure:FREQuency
- :MEASure:NDUTy
- :MEASure:NWIDth
- :MEASure:OVERshoot
- :MEASure:PERiod
- :MEASure:PHASe
- :MEASure:PREShoot
- :MEASure:PWIDth
- :MEASure:RESults
- :MEASure:RISetime
- :MEASure:SDEViation
- :MEASure:SHOW
- :MEASure:SOURce
- :MEASure:TEDGe
- :MEASure:TVALue
- :MEASure:VAMPlitude
- :MEASure:VAVerage
- :MEASure:VBASe
- :MEASure:VMAX
- :MEASure:VMIN
- :MEASure:VPP
- :MEASure:VRMS
- :MEASure:VTIMe
- :MEASure:VTOP
- :MEASure:WINDow
- :MEASure:XMAX
- :MEASure:XMIN
:MTESt Commands
- :MTESt:ALL
- :MTESt:AMASk:CREate
- :MTESt:AMASk:SOURce
- :MTESt:AMASk:UNITs
- :MTESt:AMASk:XDELta
- :MTESt:AMASk:YDELta
- :MTESt:COUNt:FWAVeforms
- :MTESt:COUNt:RESet
- :MTESt:COUNt:TIME
- :MTESt:COUNt:WAVeforms
- :MTESt:DATA
- :MTESt:DELete
- :MTESt:ENABle
- :MTESt:LOCK
- :MTESt:RMODe
- :MTESt:RMODe:FACTion:MEASure
- :MTESt:RMODe:FACTion:PRINt
- :MTESt:RMODe:FACTion:SAVE
- :MTESt:RMODe:FACTion:STOP
- :MTESt:RMODe:SIGMa
- :MTESt:RMODe:TIME
- :MTESt:RMODe:WAVeforms
- :MTESt:SCALe:BIND
- :MTESt:SCALe:X1
- :MTESt:SCALe:XDELta
- :MTESt:SCALe:Y1
- :MTESt:SCALe:Y2
- :MTESt:SOURce
- :MTESt:TITLe
:RECall Commands
- :RECall:FILename
- :RECall:MASK[:STARt]
- :RECall:PWD
- :RECall:SETup[:STARt]
- :RECall:WMEMory[:STARt]
:SAVE Commands
- :SAVE:FILename
- :SAVE:IMAGe[:STARt]
- :SAVE:IMAGe:FACTors
- :SAVE:IMAGe:FORMat
- :SAVE:IMAGe:INKSaver
- :SAVE:IMAGe:PALette
- :SAVE:MASK[:STARt]
- :SAVE:MULTi[:STARt]
- :SAVE:PWD
- :SAVE:SETup[:STARt]
- :SAVE:WAVeform[:STARt]
- :SAVE:WAVeform:FORMat
- :SAVE:WAVeform:LENGth
- :SAVE:WAVeform:LENGth:MAX
- :SAVE:WAVeform:SEGMented
- :SAVE:WMEMory:SOURce
- :SAVE:WMEMory[:STARt]
:SBUS Commands
- General :SBUS Commands
  - :SBUS:DISPlay
  - :SBUS:MODE
- :SBUS:CAN Commands
- :SBUS:IIC Commands
- :SBUS:LIN Commands
- :SBUS:SPI Commands
- :SBUS:UART Commands
:SYSTem Commands
- :SYSTem:DATE
- :SYSTem:DSP
- :SYSTem:ERRor
- :SYSTem:LOCK
- :SYSTem:MENU
- :SYSTem:PERSona[:MANufacturer]
- :SYSTem:PERSona[:MANufacturer]:DEFault
- :SYSTem:PRESet
- :SYSTem:PROTection:LOCK
- :SYSTem:RLOGger
- :SYSTem:RLOGger:DESTination
- :SYSTem:RLOGger:DISPlay
- :SYSTem:RLOGger:FNAMe
- :SYSTem:RLOGger:STATe
- :SYSTem:RLOGger:TRANsparent
- :SYSTem:RLOGger:WMODe
- :SYSTem:SETup
- :SYSTem:TIME
:TIMebase Commands
- :TIMebase:MODE
- :TIMebase:POSition
- :TIMebase:RANGe
- :TIMebase:REFerence
- :TIMebase:SCALe
- :TIMebase:VERNier
- :TIMebase:WINDow:POSition
- :TIMebase:WINDow:RANGe
- :TIMebase:WINDow:SCALe
:TRIGger Commands
- General :TRIGger Commands
- :TRIGger[:EDGE] Commands
- :TRIGger:GLITch Commands
- :TRIGger:PATTern Commands
- :TRIGger:SHOLd Commands
- :TRIGger:TRANsition Commands
- :TRIGger:TV Commands
:WAVeform Commands
- :WAVeform:BYTeorder
- :WAVeform:COUNt
- :WAVeform:DATA
- :WAVeform:FORMat
- :WAVeform:POINts
- :WAVeform:POINts:MODE
- :WAVeform:PREamble
- :WAVeform:SEGMented:COUNt
- :WAVeform:SEGMented:TTAG
- :WAVeform:SOURce
- :WAVeform:SOURce:SUBSource
- :WAVeform:TYPE
- :WAVeform:UNSigned
- :WAVeform:VIEW
- :WAVeform:XINCrement
- :WAVeform:XORigin
- :WAVeform:XREFerence
- :WAVeform:YINCrement
- :WAVeform:YORigin
- :WAVeform:YREFerence
:WGEN Commands
- :WGEN:FREQuency
- :WGEN:FUNCtion
- :WGEN:FUNCtion:PULSe:WIDTh
- :WGEN:FUNCtion:RAMP:SYMMetry
- :WGEN:FUNCtion:SQUare:DCYCle
- :WGEN:MODulation:AM:DEPTh
- :WGEN:MODulation:AM:FREQuency
- :WGEN:MODulation:FM:DEViation
- :WGEN:MODulation:FM:FREQuency
- :WGEN:MODulation:FSKey:FREQuency
- :WGEN:MODulation:FSKey:RATE
- :WGEN:MODulation:FUNCtion
- :WGEN:MODulation:FUNCtion:RAMP:SYMMetry
- :WGEN:MODulation:NOISe
- :WGEN:MODulation:STATe
- :WGEN:MODulation:TYPE
- :WGEN:OUTPut
- :WGEN:OUTPut:LOAD
- :WGEN:OUTPut:POLarity
- :WGEN:PERiod
- :WGEN:RST
- :WGEN:VOLTage
- :WGEN:VOLTage:HIGH
- :WGEN:VOLTage:LOW
- :WGEN:VOLTage:OFFSet
:WMEMory Commands
- :WMEMory:CLEar
- :WMEMory:DISPlay
- :WMEMory:LABel
- :WMEMory:SAVE
- :WMEMory:SKEW
- :WMEMory:YOFFset
- :WMEMory:YRANge
- :WMEMory:YSCale
Obsolete and Discontinued Commands
- :CHANnel:LABel
- :CHANnel2:SKEW
- :CHANnel:INPut
- :CHANnel:PMODe
- :DISPlay:CONNect
- :ERASe
- :EXTernal:PMODe
- :FUNCtion:SOURce
- :FUNCtion:VIEW
- :HARDcopy:DESTination
- :HARDcopy:FILename
- :HARDcopy:GRAYscale
- :HARDcopy:IGColors
- :HARDcopy:PDRiver
- :MEASure:LOWer
- :MEASure:SCRatch
- :MEASure:TDELta
- :MEASure:THResholds
- :MEASure:TMAX
- :MEASure:TMIN
- :MEASure:TSTArt
- :MEASure:TSTOp
- :MEASure:TVOLt
- :MEASure:UPPer
- :MEASure:VDELta
- :MEASure:VSTArt
- :MEASure:VSTOp
- :MTESt:AMASk:{SAVE | STORe}
- :MTESt:AVERage
- :MTESt:AVERage:COUNt
- :MTESt:LOAD
- :MTESt:RUMode
- :MTESt:RUMode:SOFailure
- :MTESt:{STARt | STOP}
- :MTESt:TRIGger:SOURce
- :PRINt?
- :SAVE:IMAGe:AREA
- :TIMebase:DELay
- :TRIGger:TV:TVMode
Error Messages
Status Reporting
- Status Reporting Data Structures
- Status Byte Register (STB)
- Service Request Enable Register (SRE)
- Trigger Event Register (TER)
- Output Queue
- Message Queue
- (Standard) Event Status Register (ESR)
- (Standard) Event Status Enable Register (ESE)
- Error Queue
- Operation Status Event Register (:OPERegister[:EVENt])
- Operation Status Condition Register (:OPERegister:CONDition)
- Arm Event Register (AER)
- Overload Event Register (:OVLRegister)
- Mask Test Event Event Register (:MTERegister[:EVENt])
- Clearing Registers and Queues
- Status Reporting Decision Chart
Synchronizing Acquisitions
- Synchronization in the Programming Flow
- Blocking Synchronization
- Polling Synchronization With Timeout
- Synchronizing with a Single-Shot Device Under Test (DUT)
- Synchronization with an Averaging Acquisition
More About Oscilloscope Commands
- Command Classifications
- Valid Command/Query Strings
- Query Return Values
- All Oscilloscope Commands Are Sequential
Programming Examples
- VISA COM Examples
- VISA Examples
- VISA.NET Examples
- SICL Examples
  - SICL Example in C
  - SICL Example in Visual Basic
- SCPI.NET Examples
Index

208 Keysight InfiniiVision 1000 X-Series Oscilloscopes Programmer's Guide

10 :CHANnel<n> Commands

:CHANnel<n>:LABel

(see page 782)

Command Syntax

:CHANnel<n>:LABel <string>

<string> ::= quoted ASCII string

<n> ::= 1 to (# analog channels) in NR1 format

The :CHANnel<n>:LABel command sets the analog channel label to the string that

follows. Setting a label for a channel also adds the name to the label list in

non-volatile memory (replacing the oldest label in the list).

Query Syntax

:CHANnel<n>:LABel?

The :CHANnel<n>:LABel? query returns the label associated with a particular

analog channel.

Return Format

<string> ::= quoted ASCII string

See Also • "Introduction to :CHANnel<n> Commands" on page 201

• ":DISPlay:LABel" on page 234

• ":DISPlay:LABList" on page 235

Example Code

' LABEL - This command allows you to write a name (10 characters

' maximum) next to the channel number. It is not necessary, but

' can be useful for organizing the display.

myScope.WriteString ":CHANnel1:LABel ""CAL 1""" ' Label ch1 "CAL 1".

myScope.WriteString ":CHANnel2:LABel ""CAL2""" ' Label ch1 "CAL2".

See complete example programs at: Chapter 36, “Programming Examples,”

starting on page 791

NOTE

Label strings are 10 characters or less, and may contain any commonly used ASCII characters.

Labels with more than 10 characters are truncated to 10 characters. Lower case characters

are converted to upper case.