Tektronix TBS2000 Series Programmer's Manual

TBS2000 Series

Digital Oscilloscopes

Programmer

*P077114900*

077-1149-00

TBS2000 Series

Digital Oscilloscopes

Programmer

www.tek.com

077-1149-00

Copyright

©

or suppliers, and are protected by national copyright laws and international treaty provisions. Tektronix products

are covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in all

previously published material. Specifications and price change privileges reserved.

TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.

Contacting Tektronix

Tektronix, Inc.

14150 SW Karl Braun Drive

P.O. Box 500

Beaverton, OR 97077

USA

For product information, sales, service, and technical support:

■

In North America, call 1-800-833-9200.

■

Worldwide, visit www.tek.com to find contacts in your area.

Table of Contents

Preface ............................................................................................................................................... 13

Related Documents ....................................................................................................................... 13

TBS2000 Series Manuals ........................................................................................................ 13

Service Manuals (English Only) ............................................................................................. 13

Conventions .................................................................................................................................. 13

Getting Started

Command Syntax

Command Syntax ........................................................................................................................... 3

Command and Query Structure ...................................................................................................... 4

Commands ................................................................................................................................. 5

Queries ....................................................................................................................................... 5

Headers in Query Responses ..................................................................................................... 6

Clearing the Output Queue ........................................................................................................ 6

Command Entry .............................................................................................................................. 6

Abbreviating Commands ........................................................................................................... 7

Concatenating Commands ......................................................................................................... 7

Message Terminators ................................................................................................................ 8

Constructed Mnemonics ................................................................................................................. 9

Reference Waveform Mnemonics ............................................................................................. 9

Waveform Mnemonics .............................................................................................................. 9

Cursor Position Mnemonic ...................................................................................................... 10

Measurement Specifier Mnemonics ........................................................................................ 10

Argument Types ........................................................................................................................... 10

Numeric Arguments ................................................................................................................ 10

Quoted String Arguments ........................................................................................................ 11

Block Arguments ..................................................................................................................... 11

Command groups

Alias command group ................................................................................................................... 13

Acquisition command group ........................................................................................................ 14

Calibration and Diagnostic command group ................................................................................ 14

Cursor command group ................................................................................................................ 15

Ethernet command group .............................................................................................................. 17

TBS2000 Series Programmer i

FFT command group .................................................................................................................... 17

File system command group ......................................................................................................... 18

Help everywhere command group ................................................................................................ 19

Horizontal command group .......................................................................................................... 20

Math command group ................................................................................................................... 21

Measurement command group ..................................................................................................... 21

Miscellaneous command group .................................................................................................... 23

Save and Recall command group ................................................................................................. 24

Status and Error command group ................................................................................................. 25

Trigger command group ............................................................................................................... 27

Vertical command group .............................................................................................................. 28

Waveform command group .......................................................................................................... 30

Zoom command group .................................................................................................................. 35

A commands

ACQuire? ...................................................................................................................................... 37

ACQuire:MAXSamplerate? ......................................................................................................... 38

ACQuire:MODe ........................................................................................................................... 38

ACQuire:NUMACq? .................................................................................................................... 40

ACQuire:NUMAVg ..................................................................................................................... 41

ACQuire:STATE .......................................................................................................................... 41

ACQuire:STOPAfter .................................................................................................................... 42

ALIas ............................................................................................................................................ 43

ALIas:CATalog? .......................................................................................................................... 44

ALIas:DEFine ............................................................................................................................... 45

ALIas:DELEte .............................................................................................................................. 46

ALIas:DELEte:ALL ..................................................................................................................... 46

ALIas:DELEte[:NAMe] ............................................................................................................... 47

ALIas[:STATE] ............................................................................................................................ 47

ALLEv? ........................................................................................................................................ 48

AUTOSet ...................................................................................................................................... 49

AUTOSet:ENABLE ..................................................................................................................... 49

B commands

BUSY? .......................................................................................................................................... 51

C commands

*CAL? .......................................................................................................................................... 53

Table of Contents

ii TBS2000 Series Programmer

CALibrate:FACtory ...................................................................................................................... 54

CALibrate:FACtory:STATus? ..................................................................................................... 55

CALibrate:FACtory:STEPSTIMulus? ......................................................................................... 55

CALibrate:INTERNAL ................................................................................................................ 56

CALibrate:INTERNal:STARt ...................................................................................................... 56

CALibrate:INTERNal:STATus? .................................................................................................. 57

CALibrate:RESults? ..................................................................................................................... 58

CALibrate:RESults:FACtory? ...................................................................................................... 58

CALibrate:RESults:SPC? ............................................................................................................ 59

CH<x>? ........................................................................................................................................ 60

CH<x>:BANdwidth ..................................................................................................................... 60

CH<x>:COUPling ........................................................................................................................ 61

CH<x>:DESKew .......................................................................................................................... 62

CH<x>:INVert .............................................................................................................................. 63

CH<x>:OFFSet ............................................................................................................................. 63

CH<x>:POSition .......................................................................................................................... 64

CH<x>:PRObe ............................................................................................................................. 65

CH<x>:PRObe:AUTOZero .......................................................................................................... 66

CH<x>:PRObe:DEGAUss ........................................................................................................... 66

CH<x>:PRObe:DEGAUss:STATE? ............................................................................................ 67

CH<x>:PRObe:FORCEDRange .................................................................................................. 68

CH<x>:PRObe:GAIN ................................................................................................................. 69

CH<x>:PRObe:ID? ...................................................................................................................... 70

CH<x>:PRObe:ID:SERnumber? .................................................................................................. 70

CH<x>:PRObe:ID:TYPE? ........................................................................................................... 71

CH<x>:PRObe:SIGnal ................................................................................................................. 71

CH<x>:PRObe:UNIts? ................................................................................................................. 72

CH<x>:SCAle .............................................................................................................................. 72

CH<x>:VOLts .............................................................................................................................. 73

CH<x>:YUNit .............................................................................................................................. 74

CLEARMenu ................................................................................................................................ 75

*CLS ............................................................................................................................................. 75

CURSor? ....................................................................................................................................... 76

CURSor:FUNCtion ...................................................................................................................... 77

CURSor:HBArs? .......................................................................................................................... 78

CURSor:HBArs:DELTa? ............................................................................................................. 78

CURSor:HBArs:POSITION<x> .................................................................................................. 79

CURSor:HBArs:UNIts ................................................................................................................. 80

CURSor:HBArs:USE ................................................................................................................... 81

Table of Contents

TBS2000 Series Programmer iii

CURSor:MODe ............................................................................................................................ 82

CURSor:VBArs? .......................................................................................................................... 83

CURSor:VBArs:ALTERNATE<x>? ........................................................................................... 83

CURSor:VBArs:DELTa? ............................................................................................................. 84

CURSor:VBArs:HPOS<x>? ........................................................................................................ 84

CURSor:VBArs:POSITION<x> .................................................................................................. 85

CURSor:VBArs:UNIts ................................................................................................................. 86

CURSor:VBArs:VDELTa? .......................................................................................................... 87

CURVe ......................................................................................................................................... 87

D commands

DATa ............................................................................................................................................ 89

DATa:DESTination ...................................................................................................................... 90

DATa:SOUrce .............................................................................................................................. 91

DATa:STARt ................................................................................................................................ 92

DATa:STOP ................................................................................................................................. 93

DATa:WIDth ................................................................................................................................ 94

DATE ............................................................................................................................................ 95

DESE ............................................................................................................................................ 96

DIAg:FAN .................................................................................................................................... 97

DIAg:LOOP:OPTion .................................................................................................................... 97

DIAg:LOOP:OPTion:NTIMes ..................................................................................................... 98

DIAg:LOOP:STOP ...................................................................................................................... 98

DIAg:RESUlt:FLAg? ................................................................................................................... 99

DIAg:RESUlt:LOG? .................................................................................................................... 99

DIAg:SELect .............................................................................................................................. 100

DIAg:SELect:<function> ........................................................................................................... 101

DIAg:STATE .............................................................................................................................. 101

DIAg:TEMPVAL ....................................................................................................................... 102

DISplay:GRAticule .................................................................................................................... 102

DISplay:INTENSITy:BACKLight ............................................................................................. 103

E commands

ERRLOG:FIRST? ...................................................................................................................... 105

ERRLOG:NEXT? ....................................................................................................................... 105

*ESE ........................................................................................................................................... 106

*ESR? ......................................................................................................................................... 107

ETHERnet:DHCPbootp .............................................................................................................. 108

Table of Contents

iv TBS2000 Series Programmer

ETHERnet:DNS:IPADDress ...................................................................................................... 109

ETHERnet:DOMAINname ........................................................................................................ 109

ETHERnet:ENET:ADDress? ..................................................................................................... 110

ETHERnet:GATEWay:IPADDress ............................................................................................ 110

ETHERnet:HTTPPort ................................................................................................................. 111

ETHERnet:IPADDress ............................................................................................................... 112

ETHERnet:NAME ...................................................................................................................... 112

ETHERnet:PASSWord ............................................................................................................... 113

ETHERnet:PING ........................................................................................................................ 113

ETHERnet:PING:STATUS? ...................................................................................................... 114

ETHERnet:SUBNETMask ......................................................................................................... 114

EVENT? ..................................................................................................................................... 115

EVMsg? ...................................................................................................................................... 116

EVQty? ....................................................................................................................................... 117

F commands

FACtory ...................................................................................................................................... 119

FFT? ............................................................................................................................................ 120

FFT:HORizontal:POSition ......................................................................................................... 121

FFT:HORizontal:SCAle ............................................................................................................. 121

FFT:SOURce .............................................................................................................................. 122

FFT:SRCWFM ........................................................................................................................... 122

FFT:VERtical:POSition .............................................................................................................. 123

FFT:VERtical:SCAle .................................................................................................................. 123

FFT:VERTical:UNIts ................................................................................................................. 124

FFT:VType ................................................................................................................................. 124

FFT:WINdow ............................................................................................................................. 125

FILESystem? .............................................................................................................................. 125

FILESystem:CWD ...................................................................................................................... 126

FILESystem:DELEte .................................................................................................................. 127

FILESystem:DIR? ...................................................................................................................... 128

FILESystem:FORMat ................................................................................................................. 128

FILESystem:FREESpace? .......................................................................................................... 129

FILESystem:MKDir ................................................................................................................... 130

FILESystem:READFile .............................................................................................................. 131

FILESystem:REName ................................................................................................................ 131

FILESystem:RMDir ................................................................................................................... 132

FILESystem:WRITEFile ............................................................................................................ 133

FILESystem:MOUNT:AVAILable ............................................................................................ 134

Table of Contents

TBS2000 Series Programmer v

FILESystem:MOUNT:DRIve .................................................................................................... 134

FILESystem:MOUNT:LIST ....................................................................................................... 135

FILESystem:MOUNT:UNMOUNT ........................................................................................... 136

FPAnel:PRESS ........................................................................................................................... 136

FPAnel:TURN ............................................................................................................................ 138

FWUpdate:Update ...................................................................................................................... 139

H commands

HDR ............................................................................................................................................ 141

HEADer ...................................................................................................................................... 141

HELPevery:ACQuire .................................................................................................................. 142

HELPevery:ALL ........................................................................................................................ 143

HELPevery:CURsor ................................................................................................................... 143

HELPevery:FFT ......................................................................................................................... 144

HELPevery:MATH .................................................................................................................... 144

HELPevery:MEASUrement ....................................................................................................... 145

HELPevery:REFerence .............................................................................................................. 146

HELPevery:TRIGger .................................................................................................................. 146

HELPevery:UTIlity .................................................................................................................... 147

HELPevery:VERtical ................................................................................................................. 148

HORizontal? ............................................................................................................................... 148

HORizontal:ACQLENGTH ....................................................................................................... 149

HORizontal:DELay:SCAle ........................................................................................................ 150

HORizontal:DELay:SECdiv ....................................................................................................... 150

HORizontal:DIVisions ............................................................................................................... 151

HORizontal[:MAIn][:DELay]:POSition .................................................................................... 151

HORizontal[:MAIn]:DELay:MODe .......................................................................................... 152

HORizontal[:MAIn]:DELay:STATe .......................................................................................... 153

HORizontal[:MAIn]:DELay:TIMe ............................................................................................ 154

HORizontal[:MAIn]:SAMPLERate ........................................................................................... 154

HORizontal[:MAIn]:SCAle ........................................................................................................ 155

HORizontal[:MAIn]:SECdiv ...................................................................................................... 156

HORizontal:MAIn:UNIts[:STRing] ........................................................................................... 156

HORizontal:PREViewstate ........................................................................................................ 157

HORizontal:RECOrdlength ........................................................................................................ 157

HORizontal:RECOrdlength:Auto ............................................................................................... 158

HORizontal:RESOlution ............................................................................................................ 158

HORizontal:ROLL ..................................................................................................................... 159

HORizontal:TRIGger:POSition .................................................................................................. 159

Table of Contents

vi TBS2000 Series Programmer

I commands

ID? .............................................................................................................................................. 161

*IDN? ......................................................................................................................................... 162

L commands

LANGuage .................................................................................................................................. 163

LOCk .......................................................................................................................................... 164

*LRN? ........................................................................................................................................ 164

M commands

MATH? ....................................................................................................................................... 165

MATH:DEFINE ......................................................................................................................... 166

MATH:HORizontal:POSition .................................................................................................... 167

MATH:HORizontal:SCALe ....................................................................................................... 167

MATH:HORizontal:UNIts ......................................................................................................... 168

MATH:VERtical:POSition ......................................................................................................... 169

MATH:VERtical:SCAle ............................................................................................................. 169

MATH:VERTical:UNIts ............................................................................................................ 170

MEASUrement? ......................................................................................................................... 171

MEASUrement:CLEARSNapshot ............................................................................................. 172

MEASUrement:GATing ............................................................................................................. 172

MEASUrement:IMMed? ............................................................................................................ 173

MEASUrement:IMMed:DELay? .............................................................................................. 174

MEASUrement:IMMed:DELay:EDGE<x> ............................................................................... 174

MEASUrement:IMMed:SOUrce1 .............................................................................................. 175

MEASUrement:IMMed:SOUrce2 .............................................................................................. 176

MEASUrement:IMMed:SOUrce<x> ......................................................................................... 177

MEASUrement:IMMed:TYPe ................................................................................................... 177

MEASUrement:IMMed:UNIts? ................................................................................................. 180

MEASUrement:IMMed:VALue? ............................................................................................... 180

MEASUrement:MEAS<x>? ....................................................................................................... 181

MEASUrement:MEAS<x>:DELay? .......................................................................................... 182

MEASUrement:MEAS<x>:DELay:EDGE<x> ......................................................................... 182

MEASUrement:MEAS<x>:SOUrce1 ........................................................................................ 183

MEASUrement:MEAS<x>:SOUrce2 ........................................................................................ 184

MEASUrement:MEAS<x>:SOUrce<x> .................................................................................... 185

MEASUrement:MEAS<x>:STATE ........................................................................................... 185

Table of Contents

TBS2000 Series Programmer vii

MEASUrement:MEAS<x>:TYPe .............................................................................................. 186

MEASUrement:MEAS<x>:UNIts? ............................................................................................ 189

MEASUrement:MEAS<x>:VALue? .......................................................................................... 190

MEASUrement:SNAPSHOT ..................................................................................................... 191

MEASUrement:SOURCESNAPShot ......................................................................................... 191

O commands

*OPC .......................................................................................................................................... 193

P commands

*PSC ........................................................................................................................................... 195

R commands

*RCL .......................................................................................................................................... 197

RECAll:SETUp .......................................................................................................................... 198

RECAll:WAVEForm .................................................................................................................. 199

REF<x>? .................................................................................................................................... 200

REF<x>:DATE? ........................................................................................................................ 200

REF<x>:TIMe? ......................................................................................................................... 201

REF<x>:HORizontal:DELay:TIMe? ......................................................................................... 201

REF<x>:HORizontal:SCAle? ................................................................................................... 202

REF<x>:POSition? .................................................................................................................... 202

REF<x>:VERTical:POSition? .................................................................................................... 203

REF<x>:VERTical:SCAle? ........................................................................................................ 203

*RST ........................................................................................................................................... 204

S commands

*SAV .......................................................................................................................................... 205

SAVe:ASSIgn:TYPe .................................................................................................................. 206

SAVe:IMAge .............................................................................................................................. 206

SAVe:IMAge:FILEFormat ......................................................................................................... 207

SAVe:IMAGe:LAYout .............................................................................................................. 208

SAVe:SETUp ............................................................................................................................. 209

SAVe:WAVEform ...................................................................................................................... 210

SAVe:WAVEform:FILEFormat ................................................................................................ 211

SELect:CH<x> ........................................................................................................................... 212

SELect:CONTROl ...................................................................................................................... 213

Table of Contents

viii TBS2000 Series Programmer

SELect:FFT ................................................................................................................................ 214

SELect:MATH ............................................................................................................................ 215

SELect:REF<x> .......................................................................................................................... 216

SET? ........................................................................................................................................... 217

SETUP<x>:DATE? .................................................................................................................... 218

SETUP<x>:TIME? (Query Only) .............................................................................................. 218

*SRE ........................................................................................................................................... 219

*STB? ......................................................................................................................................... 220

T commands

TEKSecure .................................................................................................................................. 221

TIMe ........................................................................................................................................... 221

TRIGger ...................................................................................................................................... 222

TRIGger:A .................................................................................................................................. 223

TRIGger:A:EDGE? .................................................................................................................... 224

TRIGger:A:EDGE:COUPling .................................................................................................... 224

TRIGger:A:EDGE:SLOpe .......................................................................................................... 225

TRIGger:A:EDGE:SOUrce ........................................................................................................ 226

TRIGger:A:HOLDOff? .............................................................................................................. 227

TRIGger:A:HOLDOff:TIMe ...................................................................................................... 227

TRIGger:A:LEVel ...................................................................................................................... 228

TRIGger:A:LEVel:CH<x> ......................................................................................................... 229

TRIGger:A:LOWerthreshold:CH<x> ........................................................................................ 229

TRIGger:A:MODe ...................................................................................................................... 230

TRIGger:A:PULse? .................................................................................................................... 231

TRIGger:A:PULse:CLAss .......................................................................................................... 232

TRIGger:A:PULSE:Width? ........................................................................................................ 233

TRIGger:A:PULse:WIDth:POLarity .......................................................................................... 233

TRIGger:A:PULSEWidth:SOUrce ............................................................................................ 234

TRIGger:A:PULse:WIDth:WHEN ............................................................................................ 234

TRIGger:A:PULse:WIDth:WIDth ............................................................................................. 235

TRIGger:A:RUNT? .................................................................................................................... 236

TRIGger:A:RUNT:POLarity ...................................................................................................... 237

TRIGger:A:RUNT:SOUrce ........................................................................................................ 238

TRIGger:A:RUNT:WHEn .......................................................................................................... 238

TRIGger:A:RUNT:WIDth .......................................................................................................... 239

TRIGger:A:TYPe ....................................................................................................................... 240

TRIGger:A:UPPerthreshold:CH<x> .......................................................................................... 241

TRIGger:FREQuency? ............................................................................................................... 242

Table of Contents

TBS2000 Series Programmer ix

TRIGger:STATE? ...................................................................................................................... 242

U commands

UNLock ...................................................................................................................................... 243

V commands

VERBose .................................................................................................................................... 245

W commands

*WAI .......................................................................................................................................... 247

WAVFrm? .................................................................................................................................. 248

WFMInpre? ................................................................................................................................ 248

WFMInpre:BIT_Nr .................................................................................................................... 249

WFMInpre:BYT_Nr ................................................................................................................... 250

WFMInpre:ENCdg ..................................................................................................................... 250

WFMInpre:NR_Pt? .................................................................................................................... 251

WFMInpre:XINcr ....................................................................................................................... 252

WFMInpre:XUNit ...................................................................................................................... 252

WFMInpre:XZEro ...................................................................................................................... 253

WFMInpre:YMUlt ...................................................................................................................... 254

WFMInpre:YOFf ........................................................................................................................ 255

WFMInpre:YUNit ...................................................................................................................... 255

WFMInpre:YZEro ...................................................................................................................... 256

WFMOutpre? .............................................................................................................................. 257

WFMOutpre:BIT_Nr .................................................................................................................. 258

WFMOutpre:BYT_Nr ................................................................................................................ 259

WFMOutpre:ENCdg .................................................................................................................. 260

WFMOutpre:NR_Pt? .................................................................................................................. 261

WFMOutpre:RECOrdlength? ..................................................................................................... 261

WFMOutpre:WFId? ................................................................................................................... 262

WFMOutpre:XINcr? .................................................................................................................. 263

WFMOutpre:XUNit? .................................................................................................................. 263

WFMOutpre:XZEro? .................................................................................................................. 264

WFMOutpre:YMUlt? ................................................................................................................. 265

WFMOutpre:YOFf? ................................................................................................................... 265

WFMOutpre:YUNit? .................................................................................................................. 266

WFMOutpre:YZEro? .................................................................................................................. 267

Table of Contents

x TBS2000 Series Programmer

Z commands

ZOOM? ....................................................................................................................................... 269

ZOOm{:MODe|:STATE} .......................................................................................................... 269

ZOOm:ZOOM1? ........................................................................................................................ 270

ZOOM:ZOOM1:FACtor ............................................................................................................ 271

ZOOM:ZOOM1:HORizontal:POSition ..................................................................................... 271

ZOOM:ZOOM1:HORizontal:SCAle ......................................................................................... 272

ZOOm:ZOOM1:POSition .......................................................................................................... 273

ZOOm:ZOOM1:SCAle .............................................................................................................. 273

ZOOM:ZOOM1:STATE ............................................................................................................ 274

Status and Events

Registers ..................................................................................................................................... 275

Overview ............................................................................................................................... 275

Status Registers ..................................................................................................................... 275

Enable Registers .................................................................................................................... 278

*PSC Command .................................................................................................................... 279

Queues ........................................................................................................................................ 279

Output Queue ........................................................................................................................ 279

Event Queue .......................................................................................................................... 280

Event Handling Sequence ........................................................................................................... 280

Synchronization Methods ........................................................................................................... 282

Overview ............................................................................................................................... 282

Using the *WAI Command ................................................................................................... 284

Using the BUSY Query ......................................................................................................... 284

Using the *OPC Command ................................................................................................... 285

Using the *OPC? Query ........................................................................................................ 287

Messages ............................................................................................................................... 288

No Event ................................................................................................................................ 288

Command Error ..................................................................................................................... 288

Execution Error ..................................................................................................................... 289

Device Error .......................................................................................................................... 292

System Event ......................................................................................................................... 292

Execution Warning ................................................................................................................ 293

Internal Warning .................................................................................................................... 293

Programming Examples

Table of Contents

TBS2000 Series Programmer xi

ASCII Code Chart

Factory setup

TBS2000 Series Oscilloscopes ................................................................................................... 299

Reserved words

Glossary

Glossary terms ............................................................................................................................ 303

Table of Contents

xii TBS2000 Series Programmer

Preface

This programmer manual provides information on how to remotely operate your

instrument. You can use communication ports and protocols, such as for the

General Purpose Interface Bus (GPIB) or Universal Serial Bus (USB) standards,

to remotely control and operate your instrument.

This document supports the following products:

■

TBS2000 Series Digital Storage Oscilloscopes, any version

Tektronix TBS2000 Series Programmer's Manual

Tektronix TBS2000 Series Programmer's Manual

Related papers

Other documents