User Manual

ManualsBrandsKeysight ManualsBenchtop OscilloscopesOscilloscope, 2x 100MHz, 2GSPS

261

262

263

264

265

266

267

268

269

270

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

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

15 :FFT Commands

:FFT:SPAN

(see page 782)

Command Syntax

:FFT:SPAN <span>

<span> ::= the current frequency span in NR3 format. Legal values are

1 Hz to 100 GHz.

If you set the frequency span to a value outside of the legal range, the

step size is automatically set to the nearest legal value.

The :FFT:SPAN command sets the frequency span of the display (left graticule to

right graticule) when FFT (Fast Fourier Transform) is selected.

Query Syntax

:FFT:SPAN?

The :FFT:SPAN? query returns the current frequency span in Hertz.

Return Format

<span> ::= the current frequency span in NR3 format. Legal values are 1

Hz to 100 GHz.