Technical data

ManualsBrandsAgilent Technologies ManualsPower ToolsInfiniiVision 3000 DSO-X 3054A

171

172

173

174

175

176

177

178

179

180

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 7000B Series Oscilloscopes
Setting Up
- Step 1. Install Agilent IO Libraries Suite software
- Step 2. Connect and set up the oscilloscope
- Step 3. Verify the oscilloscope connection
Getting Started
- Basic Oscilloscope Program Structure
- Programming the Oscilloscope
- Other Ways of Sending Commands
  - Telnet Sockets
  - Sending SCPI Commands Using Browser Web Control
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
- :ACTivity
- :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
:ACQuire Commands
- :ACQuire:COMPlete
- :ACQuire:COUNt
- :ACQuire:MODE
- :ACQuire:POINts
- :ACQuire:SEGMented:ANALyze
- :ACQuire:SEGMented:COUNt
- :ACQuire:SEGMented:INDex
- :ACQuire:SRATe
- :ACQuire:TYPE
:BUS Commands
- :BUS:BIT
- :BUS:BITS
- :BUS:CLEar
- :BUS:DISPlay
- :BUS:LABel
- :BUS:MASK
:CALibrate Commands
- :CALibrate:DATE
- :CALibrate:LABel
- :CALibrate:OUTPut
- :CALibrate:PROTected
- :CALibrate:STARt
- :CALibrate:STATus
- :CALibrate:TEMPerature
- :CALibrate:TIME
:CHANnel Commands
- :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:FUNCtion:PHASe:PHASe
- :DEMO:OUTPut
:DIGital Commands
- :DIGital:DISPlay
- :DIGital:LABel
- :DIGital:POSition
- :DIGital:SIZE
- :DIGital:THReshold
:DISPlay Commands
- :DISPlay:CLEar
- :DISPlay:DATA
- :DISPlay:LABel
- :DISPlay:LABList
- :DISPlay:PERSistence
- :DISPlay:VECTors
:EXTernal Trigger Commands
- :EXTernal:BWLimit
- :EXTernal:PROBe
- :EXTernal:RANGe
- :EXTernal:UNITs
:FUNCtion Commands
- :FUNCtion:CENTer
- :FUNCtion:DISPlay
- :FUNCtion:GOFT:OPERation
- :FUNCtion:GOFT:SOURce1
- :FUNCtion:GOFT:SOURce2
- :FUNCtion:OFFSet
- :FUNCtion:OPERation
- :FUNCtion:RANGe
- :FUNCtion:REFerence
- :FUNCtion:SCALe
- :FUNCtion:SOURce1
- :FUNCtion:SOURce2
- :FUNCtion:SPAN
- :FUNCtion:WINDow
:HARDcopy Commands
- :HARDcopy:AREA
- :HARDcopy:APRinter
- :HARDcopy:FACTors
- :HARDcopy:FFEed
- :HARDcopy:INKSaver
- :HARDcopy:LAYout
- :HARDcopy:NETWork:ADDRess
- :HARDcopy:NETWork:APPLy
- :HARDcopy:NETWork:DOMain
- :HARDcopy:NETWork:PASSword
- :HARDcopy:NETWork:SLOT
- :HARDcopy:NETWork:USERname
- :HARDcopy:PALette
- :HARDcopy:PRINter:LIST
- :HARDcopy:STARt
:LISTer Commands
- :LISTer:DATA
- :LISTer:DISPlay
- :LISTer:REFerence
:MARKer Commands
- :MARKer:MODE
- :MARKer:X1Position
- :MARKer:X1Y1source
- :MARKer:X2Position
- :MARKer:X2Y2source
- :MARKer:XDELta
- :MARKer:Y1Position
- :MARKer:Y2Position
- :MARKer:YDELta
:MEASure Commands
- :MEASure:ALL
- :MEASure:AREa
- :MEASure:BWIDth
- :MEASure:CLEar
- :MEASure:COUNter
- :MEASure:DEFine
- :MEASure:DELay
- :MEASure:DUTYcycle
- :MEASure:FALLtime
- :MEASure:FREQuency
- :MEASure:NEDGes
- :MEASure:NPULses
- :MEASure:NWIDth
- :MEASure:OVERshoot
- :MEASure:PEDGes
- :MEASure:PERiod
- :MEASure:PHASe
- :MEASure:PPULses
- :MEASure:PREShoot
- :MEASure:PWIDth
- :MEASure:RESults
- :MEASure:RISetime
- :MEASure:SDEViation
- :MEASure:SHOW
- :MEASure:SOURce
- :MEASure:STATistics
- :MEASure:STATistics:INCRement
- :MEASure:STATistics:RESet
- :MEASure:TEDGe
- :MEASure:TVALue
- :MEASure:VAMPlitude
- :MEASure:VAVerage
- :MEASure:VBASe
- :MEASure:VMAX
- :MEASure:VMIN
- :MEASure:VPP
- :MEASure:VRATio
- :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
:POD Commands
- :POD:DISPlay
- :POD:SIZE
- :POD:THReshold
: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:LISTer[:STARt]
- :SAVE:MASK[:STARt]
- :SAVE:PWD
- :SAVE:SETup[:STARt]
- :SAVE:WAVeform[:STARt]
- :SAVE:WAVeform:FORMat
- :SAVE:WAVeform:LENGth
- :SAVE:WAVeform:SEGMented
- :SAVE:WMEMory:SOURce
- :SAVE:WMEMory[:STARt]
:SBUS Commands
- General :SBUS Commands
  - :SBUS:DISPlay
  - :SBUS:MODE
- :SBUS:CAN Commands
- :SBUS:I2S Commands
- :SBUS:IIC Commands
- :SBUS:LIN Commands
- :SBUS:SPI Commands
- :SBUS:UART Commands
:SEARch Commands
- General :SEARch Commands
- :SEARch:EDGE Commands
  - :SEARch:EDGE:SLOPe
  - :SEARch:EDGE:SOURce
- :SEARch:GLITch Commands
- :SEARch:RUNT Commands
- :SEARch:TRANsition Commands
- :SEARch:SERial:CAN Commands
- :SEARch:SERial:I2S Commands
- :SEARch:SERial:IIC Commands
- :SEARch:SERial:LIN Commands
- :SEARch:SERial:SPI Commands
- :SEARch:SERial:UART Commands
:SYSTem Commands
- :SYSTem:DATE
- :SYSTem:DSP
- :SYSTem:ERRor
- :SYSTem:LOCK
- :SYSTem:PRESet
- :SYSTem:PROTection:LOCK
- :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:EBURst Commands
- :TRIGger[:EDGE] Commands
- :TRIGger:GLITch Commands
- :TRIGger:PATTern Commands
- :TRIGger:RUNT Commands
- :TRIGger:SHOLd Commands
- :TRIGger:TRANsition Commands
- :TRIGger:TV Commands
- :TRIGger:USB 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:OUTPut
- :WGEN:OUTPut:LOAD
- :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:ACTivity
- :CHANnel:LABel
- :CHANnel:THReshold
- :CHANnel2:SKEW
- :CHANnel:INPut
- :CHANnel:PMODe
- :DISPlay:CONNect
- :DISPlay:ORDer
- :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
- :SBUS:LIN:SIGNal:DEFinition
- :TIMebase:DELay
- :TRIGger:THReshold
- :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
- SICL Examples
  - SICL Example in C
  - SICL Example in Visual Basic
Index

Root (:) Commands 6

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 179

:PRINt

(see page 860)

Command Syntax

:PRINt [<options>]

<options> ::= [<print option>][,..,<print option>]

<print option> ::= {COLor | GRAYscale | PRINter0 | BMP8bit | BMP | PNG

| NOFactors | FACTors}

The <print option> parameter may be repeated up to 5 times.

The PRINt command formats the output according to the currently

selected format (device). If an option is not specified, the value selected in

the Print Config menu is used.

See Also • "Introduction to Root (:) Commands" on page 154

• "Introduction to :HARDcopy Commands" on page 288

• ":HARDcopy:FACTors" on page 291

• ":HARDcopy:GRAYscale" on page 788

• ":DISPlay:DATA" on page 258