Tektronix TBS1000C Programmer Manual

TBS1000C Series Digital Oscilloscopes

Programmer Manual

077-1691-01

Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries 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 HTTP://www.tek.com to find contacts in your area.

Table of Contents

List of Figures.............................................................................................................................................................................. xii

List of Tables............................................................................................................................................................................... xiii

Getting Started............................................................................................................................................................................ 15

Command Syntax........................................................................................................................................................................16

Command Syntax................................................................................................................................................................ 16

Command and Query Structure........................................................................................................................................... 16

Commands................................................................................................................................................................... 17

Queries......................................................................................................................................................................... 17

Headers in Query Responses.......................................................................................................................................18

Clearing the Output Queue...........................................................................................................................................18

Command Entry................................................................................................................................................................... 18

Abbreviating Commands...............................................................................................................................................18

Concatenating Commands........................................................................................................................................... 18

Message Terminators....................................................................................................................................................19

Constructed Mnemonics...................................................................................................................................................... 19

Reference Waveform Mnemonics.................................................................................................................................20

Waveform Mnemonics.................................................................................................................................................. 20

Cursor Position Mnemonic............................................................................................................................................20

Measurement Specifier Mnemonics..............................................................................................................................20

Argument Types...................................................................................................................................................................20

Numeric Arguments...................................................................................................................................................... 20

Quoted String Arguments............................................................................................................................................. 21

Block Arguments...........................................................................................................................................................22

Command groups........................................................................................................................................................................23

Alias command group.......................................................................................................................................................... 23

Acquisition command group.................................................................................................................................................23

Calibration and Diagnostic command group........................................................................................................................ 24

Cursor command group....................................................................................................................................................... 24

Display command group...................................................................................................................................................... 25

FFT command group........................................................................................................................................................... 25

File system command group................................................................................................................................................26

Help everywhere command group....................................................................................................................................... 27

Horizontal command group..................................................................................................................................................27

Math command group.......................................................................................................................................................... 28

Measurement command group............................................................................................................................................ 28

Miscellaneous command group........................................................................................................................................... 30

Save and Recall command group........................................................................................................................................31

Status and Error command group........................................................................................................................................32

Trigger command group.......................................................................................................................................................33

Vertical command group...................................................................................................................................................... 34

Waveform command group..................................................................................................................................................35

Zoom command group.........................................................................................................................................................39

A commands............................................................................................................................................................................... 40

ACQuire?............................................................................................................................................................................. 40

TBS1000C Series Digital Oscilloscopes Programmer Manual iii

Table of Contents

ACQuire:MAXSamplerate?.................................................................................................................................................. 40

ACQuire:MODe....................................................................................................................................................................40

ACQuire:NUMACq?............................................................................................................................................................. 41

ACQuire:NUMAVg................................................................................................................................................................42

ACQuire:STATE................................................................................................................................................................... 42

ACQuire:STOPAfter............................................................................................................................................................. 43

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

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

ALIas:DEFine.......................................................................................................................................................................44

ALIas:DELEte...................................................................................................................................................................... 45

ALIas:DELEte:ALL............................................................................................................................................................... 45

ALIas:DELEte[:NAMe]......................................................................................................................................................... 45

ALIas[:STATE]......................................................................................................................................................................46

ALLEv?................................................................................................................................................................................ 46

AUTOSet..............................................................................................................................................................................47

AUTOSet:ENABLE...............................................................................................................................................................47

B commands............................................................................................................................................................................... 48

BUSY?................................................................................................................................................................................. 48

C commands............................................................................................................................................................................... 49

*CAL?...................................................................................................................................................................................49

CALibrate:INTERNAL.......................................................................................................................................................... 49

CALibrate:INTERNal:STARt.................................................................................................................................................50

CALibrate:INTERNal:STATus?.............................................................................................................................................50

CALibrate:RESults?............................................................................................................................................................. 50

CALibrate:RESults:SPC? ....................................................................................................................................................51

CH<x>?................................................................................................................................................................................51

CH<x>:AMPSVIAVOLTs:ENABLe........................................................................................................................................52

CH<x>:AMPSVIAVOLTs :Factor.......................................................................................................................................... 52

CH<x>:BANdwidth............................................................................................................................................................... 52

CH<x>:COUPling.................................................................................................................................................................53

CH<x>:DESKew.................................................................................................................................................................. 53

CH<x>:INVert.......................................................................................................................................................................54

CH<x>:LABel....................................................................................................................................................................... 54

CH<x>:OFFSet.................................................................................................................................................................... 55

CH<x>:POSition...................................................................................................................................................................55

CH<x>:PRObe..................................................................................................................................................................... 56

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

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

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

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

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

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

CH<x>:SCAle.......................................................................................................................................................................58

CH<x>:VOLts.......................................................................................................................................................................59

CH<x>:YUNit....................................................................................................................................................................... 59

CLEARMenu........................................................................................................................................................................ 60

*CLS.....................................................................................................................................................................................60

CURSor?..............................................................................................................................................................................61

CURSor:ENABLE................................................................................................................................................................ 61

TBS1000C Series Digital Oscilloscopes Programmer Manual iv

Table of Contents

CURSor:FUNCtion...............................................................................................................................................................62

CURSor:HBArs?.................................................................................................................................................................. 62

CURSor:HBArs:DELTa?.......................................................................................................................................................63

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

CURSor:HBArs:UNIts.......................................................................................................................................................... 64

CURSor:HBArs:USE............................................................................................................................................................64

CURSor:MODe.................................................................................................................................................................... 64

CURSor:VBArs?.................................................................................................................................................................. 65

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

CURSor:VBArs:DELTa?....................................................................................................................................................... 66

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

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

CURSor:VBArs:UNIts.......................................................................................................................................................... 67

CURSor:VBArs:VDELTa?.....................................................................................................................................................67

CURVe.................................................................................................................................................................................68

D commands............................................................................................................................................................................... 70

DATa.....................................................................................................................................................................................70

DATa:DESTination............................................................................................................................................................... 70

DATa:SOUrce.......................................................................................................................................................................71

DATa:STARt.........................................................................................................................................................................71

DATa:STOP..........................................................................................................................................................................72

DATa:WIDth..........................................................................................................................................................................72

DATE....................................................................................................................................................................................73

DESE................................................................................................................................................................................... 73

DIAg:FAN.............................................................................................................................................................................74

DIAg:LOOP:OPTion.............................................................................................................................................................74

DIAg:LOOP:OPTion:NTIMes............................................................................................................................................... 75

DIAg:LOOP:STOP .............................................................................................................................................................. 75

DIAg:RESUlt:FLAg?.............................................................................................................................................................75

DIAg:RESUlt:LOG?..............................................................................................................................................................76

DIAg:SELect........................................................................................................................................................................ 76

DIAg:SELect:<function>.......................................................................................................................................................77

DIAg:STATE......................................................................................................................................................................... 77

DIAg:TEMPVAL....................................................................................................................................................................77

DISplay:GRAticule............................................................................................................................................................... 78

DISplay:INTENSITy:BACKLight...........................................................................................................................................78

DISplay:PERSistence:STATe ..............................................................................................................................................79

DISplay:PERSistence:VALUe .............................................................................................................................................79

E commands............................................................................................................................................................................... 80

ERRLOG:FIRST?................................................................................................................................................................ 80

ERRLOG:NEXT?................................................................................................................................................................. 80

*ESE.................................................................................................................................................................................... 80

*ESR?.................................................................................................................................................................................. 81

EVENT?............................................................................................................................................................................... 81

EVMsg?............................................................................................................................................................................... 82

EVQty?.................................................................................................................................................................................82

F commands............................................................................................................................................................................... 83

FACtory................................................................................................................................................................................83

FEAEN:PASSWORD........................................................................................................................................................... 83

TBS1000C Series Digital Oscilloscopes Programmer Manual v

Table of Contents

FFT?.................................................................................................................................................................................... 84

FFT:HORizontal:POSition.................................................................................................................................................... 84

FFT:HORizontal:SCAle........................................................................................................................................................ 85

FFT:SOURce........................................................................................................................................................................85

FFT:SRCWFM......................................................................................................................................................................85

FFT:VERTical:POSition........................................................................................................................................................86

FFT:VERTical:SCAle............................................................................................................................................................86

FFT:VERTical:UNIts.............................................................................................................................................................87

FFT:VType............................................................................................................................................................................87

FFT:WINdow........................................................................................................................................................................ 87

FILESystem?....................................................................................................................................................................... 88

FILESystem:CWD................................................................................................................................................................88

FILESystem:DELEte............................................................................................................................................................ 89

FILESystem:DIR?................................................................................................................................................................ 89

FILESystem:FORMat...........................................................................................................................................................89

FILESystem:FREESpace?...................................................................................................................................................90

FILESystem:MKDir.............................................................................................................................................................. 90

FILESystem:READFile.........................................................................................................................................................91

FILESystem:REName..........................................................................................................................................................91

FILESystem:RMDir.............................................................................................................................................................. 92

FILESystem:WRITEFile....................................................................................................................................................... 92

FPAnel:PRESS.................................................................................................................................................................... 93

FPAnel:TURN.......................................................................................................................................................................94

FWUpdate:Update............................................................................................................................................................... 95

H commands............................................................................................................................................................................... 96

HDR..................................................................................................................................................................................... 96

HEADer................................................................................................................................................................................96

HELPevery:ACQuire............................................................................................................................................................ 96

HELPevery:ALL................................................................................................................................................................... 97

HELPevery:CURsor............................................................................................................................................................. 97

HELPevery:FFT................................................................................................................................................................... 98

HELPevery:MATH................................................................................................................................................................98

HELPevery:MEASUrement..................................................................................................................................................98

HELPevery:REFerence........................................................................................................................................................99

HELPevery:TRIGger............................................................................................................................................................ 99

HELPevery:UTIlity................................................................................................................................................................99

HELPevery:VERtical.......................................................................................................................................................... 100

HORizontal?.......................................................................................................................................................................100

HORizontal:ACQLENGTH................................................................................................................................................. 101

HORizontal:DIVisions.........................................................................................................................................................101

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

HORizontal:MAIn:DELay:MODe........................................................................................................................................ 102

HORizontal:MAIn:DELay:STATe........................................................................................................................................102

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

HORizontal[:MAIn]:SAMPLERate...................................................................................................................................... 104

HORizontal[:MAIn]:SCAle.................................................................................................................................................. 104

HORizontal[:MAIn]:SECdiv................................................................................................................................................ 104

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

HORizontal:PREViewstate.................................................................................................................................................105

TBS1000C Series Digital Oscilloscopes Programmer Manual vi

Table of Contents

HORizontal:RECOrdlength................................................................................................................................................ 105

HORizontal:RECOrdlength:Auto........................................................................................................................................106

HORizontal:RESOlution.....................................................................................................................................................106

HORizontal:ROLL.............................................................................................................................................................. 107

HORizontal:TRIGger:POSition...........................................................................................................................................107

I commands...............................................................................................................................................................................108

ID?..................................................................................................................................................................................... 108

*IDN?................................................................................................................................................................................. 108

L commands..............................................................................................................................................................................109

LANGuage......................................................................................................................................................................... 109

LOCk..................................................................................................................................................................................109

*LRN?.................................................................................................................................................................................110

M commands............................................................................................................................................................................. 111

MATH?................................................................................................................................................................................111

MATH:DEFINE................................................................................................................................................................... 111

MATH:HORizontal:POSition...............................................................................................................................................112

MATH:HORizontal:SCALe..................................................................................................................................................112

MATH:HORizontal:UNIts....................................................................................................................................................113

MATH:LABel.......................................................................................................................................................................113

MATH:VERtical:POSition................................................................................................................................................... 113

MATH:VERtical:SCAle....................................................................................................................................................... 114

MATH:VERTical:UNIts........................................................................................................................................................114

MEASUrement?................................................................................................................................................................. 114

MEASUrement:CLEARSNapshot.......................................................................................................................................115

MEASUrement:ENABLE.................................................................................................................................................... 115

MEASUrement:GATing...................................................................................................................................................... 116

MEASUrement:IMMed?..................................................................................................................................................... 116

MEASUrement:IMMed:DELay? .........................................................................................................................................117

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

MEASUrement:IMMed:SOUrce1........................................................................................................................................117

MEASUrement:IMMed:SOUrce2........................................................................................................................................118

MEASUrement:IMMed:TYPe............................................................................................................................................. 119

MEASUrement:IMMed:UNIts?........................................................................................................................................... 120

MEASUrement:IMMed:VALue?..........................................................................................................................................121

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

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

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

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

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

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

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

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

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

MEASUrement:REFLevel?................................................................................................................................................ 127

MEASUrement:REFLevel:ABSolute:LOW......................................................................................................................... 127

MEASUrement:REFLevel:ABSolute:MID1.........................................................................................................................128

MEASUrement:REFLevel:ABSolute:MID2.........................................................................................................................128

MEASUrement:REFLevel:METHod................................................................................................................................... 129

MEASUrement:REFLevel:PERCent:HIGH........................................................................................................................ 129

TBS1000C Series Digital Oscilloscopes Programmer Manual vii

Table of Contents

MEASUrement:REFLevel:PERCent:LOW......................................................................................................................... 130

MEASUrement:REFLevel:PERCent:MID1.........................................................................................................................131

MEASUrement:REFLevel:PERCent:MID2.........................................................................................................................131

MEASUrement:SNAPSHOT.............................................................................................................................................. 132

MEASUrement:SOURCESNAPShot..................................................................................................................................132

O commands.............................................................................................................................................................................133

*OPC..................................................................................................................................................................................133

P commands............................................................................................................................................................................. 134

*PSC.................................................................................................................................................................................. 134

R commands............................................................................................................................................................................. 135

*RCL.................................................................................................................................................................................. 135

RECAll:SETUp...................................................................................................................................................................135

RECAll:WAVEForm............................................................................................................................................................136

REF<x>? ...........................................................................................................................................................................136

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

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

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

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

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

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

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

*RST.................................................................................................................................................................................. 138

S commands............................................................................................................................................................................. 140

*SAV...................................................................................................................................................................................140

SAVe:ASSIgn:TYPe........................................................................................................................................................... 140

SAVe:IMAge....................................................................................................................................................................... 141

SAVe:IMAge:FILEFormat................................................................................................................................................... 141

SAVe:IMAGe:LAYout..........................................................................................................................................................141

SAVe:SETUp......................................................................................................................................................................142

SAVe:WAVEform................................................................................................................................................................142

SAVe:WAVEform:FILEFormat............................................................................................................................................143

SELect:CH<x>................................................................................................................................................................... 144

SELect:CONTROl.............................................................................................................................................................. 144

SELect:FFT........................................................................................................................................................................145

SELect:MATH.....................................................................................................................................................................145

SELect:REF<x>................................................................................................................................................................. 146

SET?.................................................................................................................................................................................. 146

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

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

*SRE.................................................................................................................................................................................. 147

*STB?.................................................................................................................................................................................148

T commands............................................................................................................................................................................. 149

TEKSecure.........................................................................................................................................................................149

TIMe...................................................................................................................................................................................149

TRIGger............................................................................................................................................................................. 149

TRIGger:A..........................................................................................................................................................................150

TRIGger:A:EDGE?.............................................................................................................................................................150

TRIGger:A:EDGE:COUPling..............................................................................................................................................151

TRIGger:A:EDGE:SLOpe.................................................................................................................................................. 151

TBS1000C Series Digital Oscilloscopes Programmer Manual viii

Table of Contents

TRIGger:A:EDGE:SOUrce.................................................................................................................................................152

TRIGger:A:HOLDOff?........................................................................................................................................................ 152

TRIGger:A:HOLDOff:TIMe.................................................................................................................................................153

TRIGger:A:LEVel............................................................................................................................................................... 153

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

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

TRIGger:A:MODe.............................................................................................................................................................. 155

TRIGger:A:PULse?............................................................................................................................................................ 155

TRIGger:A:PULse:CLAss.................................................................................................................................................. 156

TRIGger:A:PULSE:Width?.................................................................................................................................................156

TRIGger:A:PULse:WIDth:POLarity.................................................................................................................................... 156

TRIGger:A:PULSEWidth:SOUrce...................................................................................................................................... 157

TRIGger:A:PULse:WIDth:WHEN....................................................................................................................................... 157

TRIGger:A:PULse:WIDth:WIDth........................................................................................................................................ 158

TRIGger:A:RUNT?.............................................................................................................................................................158

TRIGger:A:RUNT:POLarity................................................................................................................................................ 159

TRIGger:A:RUNT:SOUrce................................................................................................................................................. 159

TRIGger:A:RUNT:WHEn....................................................................................................................................................159

TRIGger:A:RUNT:WIDth.................................................................................................................................................... 160

TRIGger:A:TYPe................................................................................................................................................................161

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

TRIGger:FREQuency?.......................................................................................................................................................162

TRIGger:STATE?............................................................................................................................................................... 162

U commands............................................................................................................................................................................. 163

UNLock.............................................................................................................................................................................. 163

V commands............................................................................................................................................................................. 164

VERBose........................................................................................................................................................................... 164

W commands............................................................................................................................................................................ 165

*WAI...................................................................................................................................................................................165

WAVFrm?...........................................................................................................................................................................165

WFMInpre?........................................................................................................................................................................ 165

WFMInpre:BIT_Nr..............................................................................................................................................................166

WFMInpre:BYT_Nr............................................................................................................................................................ 166

WFMInpre:ENCdg..............................................................................................................................................................167

WFMInpre:NR_Pt?.............................................................................................................................................................167

WFMInpre:XINcr................................................................................................................................................................ 168

WFMInpre:XUNit................................................................................................................................................................168

WFMInpre:XZEro............................................................................................................................................................... 168

WFMInpre:YMUlt............................................................................................................................................................... 169

WFMInpre:YOFf.................................................................................................................................................................170

WFMInpre:YUNit................................................................................................................................................................170

WFMInpre:YZEro............................................................................................................................................................... 171

WFMOutpre?..................................................................................................................................................................... 171

WFMOutpre:BIT_Nr........................................................................................................................................................... 172

WFMOutpre:BN_Fmt......................................................................................................................................................... 172

WFMOutpre:BYT_Nr..........................................................................................................................................................173

WFMOutpre:ENCdg...........................................................................................................................................................173

WFMOutpre:NR_Pt?..........................................................................................................................................................174

WFMOutpre:RECOrdlength?............................................................................................................................................. 174

TBS1000C Series Digital Oscilloscopes Programmer Manual ix

Table of Contents

WFMOutpre:WFId?............................................................................................................................................................174

WFMOutpre:XINcr?........................................................................................................................................................... 175

WFMOutpre:XUNit?........................................................................................................................................................... 175

WFMOutpre:XZEro?.......................................................................................................................................................... 176

WFMOutpre:YMUlt?...........................................................................................................................................................176

WFMOutpre:YOFf?............................................................................................................................................................ 176

WFMOutpre:YUNit?........................................................................................................................................................... 177

WFMOutpre:YZEro?.......................................................................................................................................................... 177

Z commands............................................................................................................................................................................. 178

ZOOM?.............................................................................................................................................................................. 178

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

ZOOm:ZOOM1?................................................................................................................................................................ 178

ZOOM:ZOOM1:FACtor...................................................................................................................................................... 179

ZOOM:ZOOM1:HORizontal:POSition................................................................................................................................179

ZOOM:ZOOM1:HORizontal:SCAle....................................................................................................................................179

ZOOm:ZOOM1:POSition................................................................................................................................................... 180

ZOOm:ZOOM1:SCAle....................................................................................................................................................... 180

ZOOM:ZOOM1:STATE...................................................................................................................................................... 181

Status and Events..................................................................................................................................................................... 182

Registers............................................................................................................................................................................182

Overview.....................................................................................................................................................................182

Status Registers......................................................................................................................................................... 182

Enable Registers........................................................................................................................................................ 183

*PSC Command..........................................................................................................................................................184

Queues.............................................................................................................................................................................. 184

Output Queue............................................................................................................................................................. 185

Event Queue...............................................................................................................................................................185

Event Handling Sequence................................................................................................................................................. 185

Synchronization Methods...................................................................................................................................................186

Overview.....................................................................................................................................................................186

Using the *WAI Command..........................................................................................................................................188

Using the BUSY Query............................................................................................................................................... 189

Using the *OPC Command.........................................................................................................................................189

Using the *OPC? Query..............................................................................................................................................191

Messages................................................................................................................................................................... 191

No Event..................................................................................................................................................................... 192

Command Error.......................................................................................................................................................... 192

Execution Error........................................................................................................................................................... 193

Device Error................................................................................................................................................................197

System Event..............................................................................................................................................................197

Execution Warning......................................................................................................................................................198

Internal Warning..........................................................................................................................................................199

Programming Examples............................................................................................................................................................200

ASCII Code Chart..................................................................................................................................................................... 202

Factory setup............................................................................................................................................................................ 203

TBS1000C Series Oscilloscopes....................................................................................................................................... 203

Reserved words........................................................................................................................................................................ 204

Glossary.................................................................................................................................................................................... 205

Glossary terms...................................................................................................................................................................205

TBS1000C Series Digital Oscilloscopes Programmer Manual x

Table of Contents

....................................................................................................................................................................................0

.................................................................................................................................................................................... 0

Index......................................................................................................................................................................................... 206

TBS1000C Series Digital Oscilloscopes Programmer Manual xi

List of Figures

Figure 1: Command message elements..................................................................................................................................... 17

Figure 2: Block argument example............................................................................................................................................. 22

Figure 3: The Standard Event Status Register (SESR)............................................................................................................ 182

Figure 4: The Status Byte Register (SBR)................................................................................................................................ 183

Figure 5: The Device Event Status Enable Register (DESER)................................................................................................. 184

Figure 6: The Event Status Enable Register (ESER)................................................................................................................184

Figure 7: The Service Request Enable Register (SRER)......................................................................................................... 184

Figure 8: Status and Event Handling Process.......................................................................................................................... 186

Figure 9: Command processing without using synchronization................................................................................................ 188

Figure 10: Processing sequence with synchronization............................................................................................................. 188

TBS1000C Series Digital Oscilloscopes Programmer Manual xii

List of Tables

Table 1: Instrument communication protocol...............................................................................................................................16

Table 2: BNF notation..................................................................................................................................................................16

Table 3: Command message elements.......................................................................................................................................17

Table 4: Comparison of Header Off and Header On responses..................................................................................................18

Table 5: Types of numeric arguments......................................................................................................................................... 21

Table 6: Instrument handling of incorrect numeric arguments.................................................................................................... 21

Table 7: Parts of a block argument..............................................................................................................................................22

Table 8: Alias commands............................................................................................................................................................ 23

Table 9: Acquisition commands ..................................................................................................................................................23

Table 10: Calibration and Diagnostic commands ....................................................................................................................... 24

Table 11: Cursor commands .......................................................................................................................................................24

Table 12: Display commands...................................................................................................................................................... 25

Table 13: FFT commands .......................................................................................................................................................... 26

Table 14: File system commands ...............................................................................................................................................26

Table 15: Help everywhere commands ...................................................................................................................................... 27

Table 16: Horizontal commands .................................................................................................................................................27

Table 17: Math commands ......................................................................................................................................................... 28

Table 18: Measurement commands ........................................................................................................................................... 29

Table 19: Miscellaneous commands .......................................................................................................................................... 30

Table 20: Save and Recall commands .......................................................................................................................................31

Table 21: Status and Error commands .......................................................................................................................................32

Table 22: Trigger commands ......................................................................................................................................................33

Table 23: Vertical commands ..................................................................................................................................................... 34

Table 24: Waveform commands .................................................................................................................................................36

Table 25: Binary data ranges...................................................................................................................................................... 38

Table 26: Zoom commands ........................................................................................................................................................39

Table 27: FPAnel:TURN arguments............................................................................................................................................ 94

Table 28: SESR bit functions.....................................................................................................................................................182

Table 29: SBR bit functions....................................................................................................................................................... 183

Table 30: Instrument operations that can generate OPC.......................................................................................................... 187

Table 31: No Event messages.................................................................................................................................................. 192

Table 32: Command error messages (CME bit 5).....................................................................................................................192

TBS1000C Series Digital Oscilloscopes Programmer Manual xiii

List of Tables

Table 33: Execution error messages (EXE bit 4)...................................................................................................................... 193

Table 34: Device error messages (DDE bit 3)...........................................................................................................................197

Table 35: System event messages........................................................................................................................................... 197

Table 36: Execution warning messages (EXE bit 4)................................................................................................................. 198

Table 37: Execution warning messages (EXE bit 4)................................................................................................................. 198

Table 38: Internal warning messages........................................................................................................................................199

TBS1000C Series Digital Oscilloscopes Programmer Manual xiv

Getting Started

This manual contains information on how to remotely control and operate your instrument through communications protocol and commands.

Refer to the instrument user manual for information on how to configure and test your instrument remote connectivity (USB or Ethernet).

Download the latest version of the programmer manual from www.tek.com/downloads for up-to-date command syntax information.

TBS1000C Series Digital Oscilloscopes Programmer Manual 15

Command Syntax

You can control the instrument through the Ethernet or USB interface using a large group of commands and queries.

This section describes the syntax these commands and queries use and the conventions the instrument uses to process them. The commands and queries themselves are listed in the Command Descriptions section.

Command Syntax

Table 1: Instrument communication protocol

Model or option GPIB RS-232 USB

TBS1000C Yes No Yes

You transmit commands to the instrument using the enhanced American Standard Code for Information Interchange (ASCII) character encoding. Appendix A contains a chart of the ASCII character set.

The Backus Naur Form (BNF) notation is used in this manual to describe commands and queries.

Table 2: BNF notation

Symbol Meaning

< > Defined element

::= Is defined as

| Exclusive OR

{ } Group; one element is required

[ ] Optional; can be omitted

. . . Previous element(s) may be repeated

( ) Comment

Command and Query Structure

Commands consist of set commands and query commands (usually simply called commands and queries). Commands change instrument settings or perform a specific action. Queries cause the instrument to return data and information about its status.

Most commands have both a set form and a query form. The query form of the command is the same as the set form except that it ends with a question mark. For example, the set command ACQuire:MODe has a query form ACQuire:MODe. Not all commands have both a set and a query form; some commands are set only and some are query only.

A few commands do both a set and query action. For example, the *CAL? command runs a self-calibration program on the instrument, then returns the result of the calibration.

A command message is a command or query name, followed by any information the instrument needs to execute the command or query. Command messages consist of five different element types.

TBS1000C Series Digital Oscilloscopes Programmer Manual 16

Command Syntax

Table 3: Command message elements

Symbol Meaning

<Header> The basic command name. If the header ends with a question mark, the command is a query. The

header may begin with a colon (:) character; if the command is concatenated with other commands the beginning colon is required. The beginning colon can never be used with command headers beginning with a star (*).

<Mnemonic> A header subfunction. Some command headers have only one mnemonic. If a command header has

multiple mnemonics, they are always separated from each other by a colon (:) character.

<Argument> A quantity, quality, restriction, or limit associated with the header. Not all commands have an

argument, while other commands have multiple arguments. Arguments are separated from the header by a <Space>. Arguments are separated from each other by a <Comma>.

<Comma> A single comma between arguments of multiple-argument commands. It may optionally have white

space characters before and after the comma.

<Space> A white space character between command header and argument. It may optionally consist of multiple

white space characters.

The following figure shows the five command message elements.

Figure 1: Command message elements

Commands

Commands cause the instrument to perform a specific function or change one of its settings. Commands have the structure:

[:]<Header>[<Space><Argument>[<Comma><Argument>]...]

A command header is made up of one or more mnemonics arranged in a hierarchical or tree structure. The first mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off of the previous one. Commands at a higher level in the tree may affect those at a lower level. The leading colon (:) always returns you to the base of the command tree.

Queries

Queries cause the instrument to return information about its status or settings. Queries have the structure:

[:]<Header>

[:]<Header>[<Space><Argument>[<Comma><Argument>]...]

You can specify a query command at any level within the command tree unless otherwise noted. These branch queries return information about all the mnemonics below the specified branch or level.

For example, MEASUrement:MEAS<x>:UNIts? returns the measurement units, while MEASUrement:MEAS<x>:TYPe? returns the measurement type selected for the measurement, and MEASUrement:MEAS<x>? returns all the measurement parameters for the specified measurement.

TBS1000C Series Digital Oscilloscopes Programmer Manual 17

Command Syntax

Headers in Query Responses

You can control whether the instrument returns headers as part of the query response. Use the HEADer command to control this feature. If header is on, the instrument returns command headers as part of the query and formats the query response as a valid set command. When header is off, the instrument sends back only the values in the response. This format can make it easier to parse and extract the information from the response.

Table 4: Comparison of Header Off and Header On responses

Query Header Off response Header On response

ACQuire:NUMAVg 64 ACQUIRE:NUMAVG 64

CHx1:COUPling DC CH1:COUPLING DC

Clearing the Output Queue

To clear the output queue and reset the instrument to accept a new command or query, send a Device Clear (DCL) from a GPIB host.

From an RS-232 host, send a break signal. The RS-232 interface responds by returning the ASCII string "DCL."

From a USB host, send an INITIATE_CLEAR followed by a CHECK_CLEAR_STATUS. The USB interface responds to CHECK_CLEAR_STATUS with STATUS_SUCCESS when it is finished clearing the output queue.

Command Entry

Follow these general rules when entering commands:

• Enter commands in upper or lower case.

• You can precede any command with white space characters. White space characters include any combination of the ASCII control characters 00 through 09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal).

• The instrument ignores commands that consists of just a combination of white space characters and line feeds.

Abbreviating Commands

You can abbreviate many instrument commands. These abbreviations are shown in capital letters in the command listing in the Command Groups section and Command Descriptions section. For example, the command ACQuire:NUMAvg can be entered simply as ACQ:NUMA

or acq:numa.

If you use the HEADer command to have command headers included as part of query responses, you can also control whether the returned headers are abbreviated or are full-length using the VERBose command.

Concatenating Commands

You can concatenate any combination of set commands and queries using a semicolon (;). The instrument executes concatenated commands in the order received. When concatenating commands and queries you must follow these rules:

• Completely different headers must be separated by both a semicolon and by the beginning colon on all commands but the first. For example, the commands TRIGger:MODe NORMal and ACQuire:NUMAVg 16 can be concatenated into a single command:

TRIGger:MODe NORMal;:ACQuire:NUMAVg 16

• If concatenated commands have headers that differ by only the last mnemonic, you can abbreviate the second command and eliminate the beginning colon. For example, the commands ACQuire:MODe AVErage and ACQuire:NUMAVg 16 could be concatenated into a single command:

ACQuire:MODe AVErage; NUMAVg 16

The longer version works equally well:

TBS1000C Series Digital Oscilloscopes Programmer Manual 18

Command Syntax

ACQuire:MODe AVErage;:ACQuire:NUMAVg 16

• Never precede a star (*) command with a colon or semicolon:

ACQuire:MODe AVErage;*TRG

The instrument processes commands that follow the star command as if the star command was not there, so:

ACQuire:MODe AVErage;*TRG;NUMAVg 16

sets the acquisition mode to average and sets acquisition averaging to 16. The *TRG command is ignored.

• When you concatenate queries, the responses to all queries are combined into a single response message. For example, if channel 1 coupling is set to DC and the bandwidth is set to 20 MHz, the concatenated query:

CH1:COUPling;BANdwidth

returns CH1:COUPLING DC;:CH1:BANDWIDTH ON if header is on, or DC;ON if header is off.

• You can concatenate set commands and queries in the same message. For example:

ACQuire:MODe AVErage;NUMAVg;STATE

is a valid message that sets the acquisition mode to average, queries the number of acquisitions for averaging, and then queries the acquisition state. The instrument executes concatenated commands and queries in the order it receives them.

• Any query that returns arbitrary data, such as ID, must be the last query when part of a concatenated command. If the query is not last, the instrument generates event message 440.

Here are some INVALID concatenation examples:

• CH1:COUPling DC;ACQuire:NUMAVg 16 (missing colon before ACQuire)

• CH1:COUPling DC;:BANDwidth ON (invalid colon before BANDwidth)

• CH1:COUPling DC;:*TRG (invalid colon before a star (*) command)

• HORizontal:MAIn:POSition 0;MAIn:SCAle 1E-13 (levels of mnemonics are different; either remove the second occurrence of MAIn:, or put HORizontal: in front of MAIN:SCAle)

Message Terminators

This manual uses the term <EOM> (End of message) to represent a message terminator.

GPIB End of Message (EOM) Terminators

GPIB EOM terminators can be the END message (EOI asserted concurrently with the last data byte), the ASCII code for line feed (LF) sent as the last data byte, or both. The instrument always terminates messages with LF and EOI. White space is allowed before the terminator; for example, CR LF is acceptable.

USB End of Message (EOM) Terminators

The EOM bit must be set in the USB header of the last transfer of a command message

See the USB Test and Measurement Class Specification (USBTMC) section 3.2.1 for details. The instrument terminates messages by setting the EOM bit in the USB header of the last transfer of a message to the host (USBTMC Specification section 3.3.1), and by terminating messages with a LF. White space is allowed before the terminator; for example, CR LF is acceptable.

Constructed Mnemonics

Some header mnemonics specify one of a range of mnemonics. For example, a channel mnemonic could be CH2. You can use these mnemonics in the command just as you do any other mnemonic. For example, there is a CH1:VOLts command and there is also a CH2:VOLts command. In the command descriptions, this list of choices is abbreviated CH<x>.

Channel mnemonics

Commands specify the channel to use as a mnemonic in the header.

TBS1000C Series Digital Oscilloscopes Programmer Manual 19

Command Syntax

Symbol Meaning

CH<x> A channel specifier; <x> is 1 or 2.

Reference Waveform Mnemonics

Commands can specify the reference waveform to use as a mnemonic in the header.

Symbol Meaning

REF<x> A reference waveform specifier; <x> is 1 or 2.

Waveform Mnemonics

In some commands you can specify a waveform without regard to its type: channel waveform, math waveform, or reference waveform. The "y" is the same as "x" in Reference Waveform Mnemonics.

Symbol Meaning

Cursor Position Mnemonic

When the instrument displays cursors, commands may specify which cursor of the pair to use.

Symbol Meaning

POSITION<x> A cursor selector;<x> is 1 or 2.

Measurement Specifier Mnemonics

Commands can specify which measurement to set or query as a mnemonic in the header. The instrument can display up to six automated measurements.

Symbol Meaning

MEAS<x> A measurement specifier; <x> is 1-6.

Argument Types

A command argument can be in one of several forms. The individual descriptions of each command tell which argument types to use with that command.

Numeric Arguments

Many instrument commands require numeric arguments.

TBS1000C Series Digital Oscilloscopes Programmer Manual 20

Command Syntax

Table 5: Types of numeric arguments

Symbol Meaning

<NR1> Signed integer value

<NR2> Floating point value without an exponent

<NR3> Floating point value with an exponent

The syntax shown is the data format that the instrument returns in response to a query. This format is also the preferred format when sending a command to the instrument.

When you enter an incorrect numeric argument, the instrument automatically forces the numeric argument to a correct value.

Table 6: Instrument handling of incorrect numeric arguments

Argument value Instrument response

Numeric argument is less than lowest correct value for that command

Numeric argument is greater than the highest correct value for that command

Numeric value is between two correct values Rounds the entered value to the nearest correct value and executes

Sets the specified command to the lowest correct value and executes the command

Sets the specified command to the highest correct value and executes the command

the command

Quoted String Arguments

Some commands accept or return data in the form of a quoted string, which is simply a group of ASCII characters enclosed by single quotes (') or double quotes ("). For example:

"this is a quoted string"

Symbol Meaning

<QString> Quoted string of ASCII text

Follow these rules when you use quoted strings:

1. A quoted string can include any character defined in the 7-bit ASCII character set. ASCII Code Chart on page 202.

2. Use the same type of quote character to open and close the string:

"this is a valid string"

3. You can mix quotation marks within a string if you follow the previous rule:

"this is an 'acceptable' string"

4. You can include a quote character within a string simply by repeating the quote. For example,

"here is a "" mark"

5. Strings can have upper or lower case characters.

6. If you use a GPIB network, you cannot terminate a quoted string with the END message before the closing delimiter.

7. A carriage return or line feed embedded in a quoted string does not terminate the string, but is treated as just another character in the

string.

8. The maximum length of a quoted string returned from a query is 1000 characters.

TBS1000C Series Digital Oscilloscopes Programmer Manual 21

Command Syntax

Here are some examples of invalid strings:

"Invalid string argument' (quotes are not of the same type)

"test<EOI>" (termination character is embedded in the string)

Block Arguments

Several instrument commands use a block argument form.

Table 7: Parts of a block argument

Symbol Meaning

<NZDig> A nonzero digit character, in the range 1-9 Specifies the number of <Dig> elements that follow

<Dig> A digit character, in the range 0-9

<DChar> A character with the hex equivalent of 00 through FF hexadecimal (0 through 255 decimal)

<Block> A block of data bytes, defined as:

<Block> := { #<NZDig><Dig>[<Dig>...][<DChar>...] | #0[<DChar>...]<terminator> }

The following figure shows an example of a block argument.

Figure 2: Block argument example

<NZDig> specifies the number of <Dig> elements that follow. Taken together, the <Dig> elements form a decimal integer that specifies how many <DChar> elements follow.

#0 means that the <Block> is an indefinite length block. The <terminator> ends the block. You should not use indefinite length blocks with RS-232, because there is no way to include a <terminator> character as a <DChar> character.

The first occurrence of a <terminator> character signals the end of the block and any subsequent <DChar> characters will be interpreted as a syntax error. With the GPIB, the EOI line signals the last byte. With the USB, the EOM bit signals the last byte.

TBS1000C Series Digital Oscilloscopes Programmer Manual 22

Command groups

This section lists the commands organized by functional group. The following sections lists all commands alphabetically.

The instrument GPIB and USB interfaces conform to Tektronix standard codes and formats except where noted. The GPIB interface also conforms to IEEE Std 488.2–1987 except where noted. The USB interface also conforms to USB Test and Measurement Class, Subclass USB488 Specification, except where noted.

Alias command group

Use the Alias commands to define new commands as a sequence of standard commands. You may find this useful when repeatedly using the same commands to perform certain tasks like setting up measurements.

Aliases are similar to macros but do not include the capability to substitute parameters into alias bodies. The alias mechanism obeys the following rules:

• The alias name must consist of a valid IEEE488.2 message unit, which may not appear in a message preceded by a colon, comma, or a command or query program header.

• The alias name may not appear in a message followed by a colon, comma, or question mark.

• An alias name must be distinct from any keyword or keyword short form.

• An alias name cannot be redefined without first being deleted using one of the alias deletion functions.

• Alias names do not appear in response messages.

Table 8: Alias commands

Command Command

ALIas on page 43 Sets or returns the alias state.

ALIas:CATalog? on page 44 Returns a list of the currently defined alias.

ALIas:DEFine on page 44 Assigns a sequence of program messages.

ALIas:DELEte on page 45 Removes a specified alias.

ALIas:DELEte:ALL on page 45 Deletes all existing aliases.

ALIas:DELEte[:NAMe] on page 45 Removes a specified alias.

ALIas[:STATE] on page 46 Sets or returns the alias state.

Acquisition command group

Acquisition commands affect the acquisition of waveforms. These commands control mode, averaging, and single-waveform acquisition.

Table 9: Acquisition commands

Command Command

ACQuire? on page 40 Returns current acquisition settings.

ACQuire:MAXSamplerate? on page 40 Returns the maximum real-time sample rate.

ACQuire:MODe on page 40 Sets or queries the instrument acquisition mode.

ACQuire:NUMACq? on page 41 Indicates the number of acquisitions that have taken place since

starting instrument acquisition.

ACQuire:NUMAVg on page 42 Sets the number of instrument waveform acquisitions that make up

an averaged waveform.

ACQuire:STATE on page 42 Starts or stops instrument acquisitions.

ACQuire:STOPAfter on page 43 Tells the instrument when to stop taking acquisitions.

TBS1000C Series Digital Oscilloscopes Programmer Manual 23

Command groups

Calibration and Diagnostic command group

Calibration and Diagnostic commands let you initiate the instrument self-calibration routines and examine the results of diagnostic tests.

Table 10: Calibration and Diagnostic commands

Command Description

*CAL? on page 49 Performs an internal self-calibration and returns its status.

CALibrate:INTERNAL on page 49 Performs an internal self-calibration but does not return any status.

CALibrate:INTERNal:STARt on page 50 Starts the internal signal path calibration.

CALibrate:INTERNal:STATus? on page 50 Returns the current status of the internal signal path calibration.

CALibrate:RESults? on page 50 Returns the status of all calibration subsystems without performing

an SPC operation.

CALibrate:RESults:SPC? on page 51 Returns the results of the last SPC operation

DIAg:LOOP:OPTion on page 74 Sets the self-test loop option

DIAg:LOOP:OPTion:NTIMes on page 75 Sets the self-test loop option to run N times

DIAg:LOOP:STOP on page 75 Stops the self-test at the end of the current loop

DIAg:RESUlt:FLAg? on page 75 Returns the Pass/Fail status from the last diagnostic test sequence

execution (those run automatically at power on, or those requested through the Service Menu).

DIAg:RESUlt:LOG? on page 76 Returns the internal results log from the last diagnostic test

sequence execution (those run automatically at power on, or those requested through the Service Menu).

DIAg:SELect on page 76 Sets the type of diagnostics grouping.

DIAg:SELect:<function> on page 77 Runs self-tests on the specified system subsystem.

DIAg:STATE on page 77 Starts or stops the instrument self-test.

DIAg:FAN on page 74 Read out the currently set PWM fan value

DIAg:TEMPVAL on page 77 Read out the currently FPGA chip and ambient temperature

Cursor command group

Cursor commands provide control over the instrument cursor display and readout.

Use the commands in the cursor command subsystem to control the cursor display and readout. You can use these commands to control the setups for cursor 1 and cursor 2, such as cursor position. You can also use the commands to select one of the following cursor functions:

Off. Turns off the display of all cursors.

Waveform Cursors. Consists of two cursors. Waveform cursors enable you to conveniently measure waveform amplitude and time.

Screen Cursors. Consists of two pairs of independent horizontal and vertical cursors.

You can use these cursors to indicate an arbitrary position within the waveform display area.

Table 11: Cursor commands

Command Description

CURSor? on page 61 Returns current cursor settings.

Table continued…

TBS1000C Series Digital Oscilloscopes Programmer Manual 24

Command groups

Command Description

CURSor:ENABLE on page 61 Allows educators to disable or enable the Cursor functions. The

function can be manually set from the Utility menu. To access the menu, refer to the product user manual.

CURSor:FUNCtion on page 62 Selects and displays the instrument cursor type.

CURSor:HBArs? on page 62 Returns the settings for the instrument horizontal bar cursors.

CURSor:HBArs:DELTa? on page 63 Returns the difference (in vertical units) between the two horizontal

bar cursors in the instrument display.

CURSor:HBArs:POSITION<x> on page 63 Positions a horizontal bar cursor.

CURSor:HBArs:UNIts on page 64 Returns the vertical scale units for the selected cursor source

waveform.

CURSor:HBArs:USE on page 64 Sets the horizontal bar cursor measurement scale.

CURSor:MODe on page 64 Sets or returns whether cursors move in unison or separately.

CURSor:VBArs? on page 65 Returns the current vertical bar cursor horizontal position and units

settings.

CURSor:VBArs:ALTERNATE<x>? on page 65 Returns the alternate readout for the waveform (Vbar) cursors.

CURSor:VBArs:DELTa? on page 66 Returns the time or frequency difference between the two vertical

bar cursors.

CURSor:VBArs:HPOS<x>? on page 66 Returns the horizontal value of the specified vertical bar ticks for

cursor <x>

CURSor:VBArs:POSITION<x> on page 66 Sets or returns the vbar cursor<x> horizontal position

CURSor:VBArs:UNIts on page 67 Sets or queries the units for the vertical bar cursors.

CURSor:VBArs:VDELTa? on page 67 Returns the vertical (amplitude) difference between the two vertical

bar cursors.

Display command group

These commands provide control of the Display feature.

Table 12: Display commands

Command Description

DISplay:GRAticule on page 78 Sets or queries the Graticule state.

DISplay:INTENSITy:BACKLight on page 78 Sets or queries the display Backlight.

DISplay:PERSistence:STATe on page 79 Sets or returns the display persistence to ON or OFF. The query

form returns the persistence state. This affects the display only.

DISplay:PERSistence:VALUe on page 79 Sets the value of persistence if the persistence state is set to on.

This affects the display only.

FFT command group

These commands provide control over the instrument FFT feature.

TBS1000C Series Digital Oscilloscopes Programmer Manual 25

Command groups

Table 13: FFT commands

Command Description

FFT? on page 84 Returns all FFT parameters.

FFT:HORizontal:POSition on page 84 Sets or queries the FFT horizontal display position.

FFT:HORizontal:SCAle on page 85 Sets or queries the FFT zoom factor.

FFT:SOURce on page 85 Sets or queries the FFT source.

FFT:SRCWFM on page 85 Sets or queries the FFT source waveform display state.

FFT:VERTical:POSition on page 86 Sets or queries the FFT vertical display position.

FFT:VERTical:SCAle on page 86 Sets or queries the FFT vertical zoom factor.

FFT:VERTical:UNIts on page 87 Sets or returns the FFT vertical measurement units label.

FFT:VType on page 87 Sets or queries the FFT waveform vertical units.

FFT:WINdow on page 87 Sets or queries the FFT window state.

SELect:FFT on page 145 Sets or queries the FFT display state.

File system command group

File system commands perform file management tasks.

Table 14: File system commands

Command Description

FILESystem? on page 88

FILESystem:CWD on page 88 Sets or queries returns the current working directory (CWD) for

FILESystem:DELEte on page 89 Deletes the specified file name.

FILESystem:DIR? on page 89 Returns a list of strings.

FILESystem:FORMat on page 89 Formats a mass storage device.

FILESystem:FREESpace? on page 90 Returns the number of bytes of free space on the current drive.

FILESystem:MKDir on page 90 Creates a folder at the specified location.

FILESystem:READFile on page 91 Writes the contents of the specified file to the specified interface

FILESystem:REName on page 91 Assigns a new name to a file or folder.

FILESystem:RMDir on page 92 Deletes a folder at the specified location.

FILESystem:WRITEFile on page 92 Writes the specified block data to the instrument current working

Returns the directory listing of the current working directory and the number of bytes of free space available.

FILESystem commands.

Help everywhere command group

Help everywhere commands provide helpful user information.

Table 15: Help everywhere commands

Command Description

HELPevery:ACQuire on page 96 Enables or disables the display of help everywhere information for

the acquire module.

HELPevery:ALL on page 97 Enables or disables the display of help everywhere.

HELPevery:FFT on page 98 Enables or disables the display of help everywhere information for

the fft module.

HELPevery:CURsor on page 97 Enables or disables the display of help everywhere information for

the cursor module.

HELPevery:MATH on page 98 Enables or disables the display of help everywhere information for

the math module.

HELPevery:MEASUrement on page 98 Enables or disables the display of help everywhere information for

the measurement module.

HELPevery:REFerence on page 99 Enables or disables the display of help everywhere information for

the reference module.

HELPevery:TRIGger on page 99 Enables or disables the display of help everywhere information for

the trigger module.

HELPevery:UTIlity on page 99 Enables or disables the display of help everywhere information for

the utility module.

HELPevery:VERtical on page 100 Enables or disables the display of help everywhere information for

the vertical module.

Horizontal command group

Horizontal commands control the time bases of the instrument. You can set the position and time per division of both the main and window time bases. You can substitute SECdiv for SCAle in all appropriate horizontal commands. This provides program compatibility with previous Tektronix digitizing instruments.

Table 16: Horizontal commands

Command Description

HORizontal? on page 100 Returns all settings for the horizontal commands.

HORizontal[:MAIn]:SCAle on page 104 Sets or queries the time base horizontal scale.

HORizontal[:MAIn]:SECdiv on page 104 Specifies the horizontal time/div.

HORizontal:TRIGger:POSition on page 107

HORizontal:TRIGger:POSition on page 107 Set or queries the trigger position.

HORizontal[:MAIn][:DELay]:POSition on page 101 Sets or returns the horizontal position, as percent of record, that is

HORizontal:MAIn:DELay:MODe on page 102 The boolean argument type sets delay mode to on or off.

HORizontal:MAIn:DELay:STATe on page 102

Table continued…

Same as :HORizontal:POSition.

used when HORizontal:DELay:MODe is set to OFF.

Same as HORizontal:DELay:MODe.

TBS1000C Series Digital Oscilloscopes Programmer Manual 27

Command Description

HORizontal[:MAIn]:DELay:TIMe on page 103 Specifies the delay time in time units.

HORizontal:RESOlution on page 106

HORizontal:RECOrdlength on page 105 Sets or queries the horizontal record length.

HORizontal:RECOrdlength:Auto on page 106 Sets or queries the record length mode.

HORizontal:ACQLENGTH on page 101 Queries the record length.

HORizontal:PREViewstate on page 105

HORizontal[:MAIn]:SAMPLERate on page 104 Returns the sample rate

HORizontal:MAIn:UNIts[:STRing] on page 105 Queries the horizontal units.

HORizontal:DIVisions on page 101 Queries the number of horizontal divisions.

HORizontal:ROLL on page 107 Query the state of roll mode.

Same as HORizontal:RECOrdlength.

Returns a boolean to indicate whether the acquisition system is in the preview state

Math command group

Math commands provide math function definition.

Command groups

Table 17: Math commands

Command Description

MATH? on page 111 Returns the definition for the math waveform.

MATH:DEFINE on page 111 Performs the specified mathematical operation on the input signal

or signals.

MATH:HORizontal:POSition on page 112 Sets or returns the horizontal position of the math waveform.

MATH:HORizontal:SCALe on page 112 Sets or returns the horizontal scale of the math waveform.

MATH:HORizontal:UNIts on page 113 Sets or returns the math horizontal measurement units label.

MATH:LABel on page 113 Sets or queries the waveform label for the math waveform.

MATH:VERtical:POSition on page 113 Sets or returns the math waveform display position.

MATH:VERtical:SCAle on page 114 Sets or returns the math waveform display scale in units per

division.

MATH:VERTical:UNIts on page 114 Sets or returns the math vertical measurement units label.

Measurement command group

Measurement commands control the automated measurement system. The instrument can display up to six automated measurements. In the commands, these measurement readouts are named MEAS<x>, where <x> can be 1, 2, 3, 4, 5, or 6.

The best method for taking measurements over the computer interface is to use the MEASUREMENT:IMMED commands and queries. The immediate measurement has no front-panel equivalent, and the instrument never displays immediate measurements.

Because they are computed only when they are requested, immediate measurements slow the waveform update rate less than displayed measurements.

Use the VALue? query to obtain measurement results of either displayed or immediate measurements.

Several measurement commands set and query measurement parameters. You can assign some parameters, such as waveform sources, differently for each measurement readout.

TBS1000C Series Digital Oscilloscopes Programmer Manual 28

Command groups

Table 18: Measurement commands

Command Description

MEASUrement? on page 114 Returns the current MEASUrement settings.

MEASUrement:CLEARSNapshot on page 115 Clears the existing snapshop results and removes the snapshot

window.

MEASUrement:GATing on page 116 Sets or returns the measurement gating.

MEASUrement:IMMed? on page 116 Returns all immediate measurement setup parameters.

MEASUrement:IMMed:DELay? on page 117 Returns information about the immediate delay measurement.

MEASUrement:IMMed:DELay:EDGE<x> on page 117 Sets or returns the slope of the edge used for immediate delay from

and to waveform measurements

MEASUrement:IMMed:SOUrce1 on page 117 Sets or queries the source for all single source immediate

measurements and specifies the source to measure from when taking an immediate delay or phase measurement.

MEASUrement:IMMed:SOUrce2 on page 118 Sets or queries the secondary source for dual-source immediate

measurements.

MEASUrement:IMMed:TYPe on page 119 Sets or queries the immediate measurement type.

MEASUrement:IMMed:UNIts? on page 120 Returns the units for the immediate instrument measurement.

MEASUrement:IMMed:VALue? on page 121 Executes the immediate instrument measurement specified by the

MEASUrement:IMMed:TYPe command.

MEASUrement:MEAS<x>? on page 121 Returns all measurement parameters for the displayed instrument

periodic measurement specified by <x>.

MEASUrement:MEAS<x>:DELay? on page 122 Returns the delay measurement parameters for the specified

measurement.

MEASUrement:MEAS<x>:DELay:EDGE<x> on page 122 Sets or returns the slope of the edge to use for delay “from” and “to”

waveform measurements.

MEASUrement:MEAS<x>:SOUrce1 on page 122 Sets or queries the source for all single source measurements and

specifies the source to measure from when taking a delay measurement or phase measurement.

MEASUrement:MEAS<x>:SOUrce2 on page 123 Sets or queries the reference source to measure to when taking a

delay or phase measurement.

MEASUrement:MEAS<x>:STATE on page 123 Sets or returns whether the specified measurement slot is

computed and displayed.

MEASUrement:MEAS<x>:TYPe on page 124 Sets or queries the on-screen periodic instrument measurement

type for the measurement specified by <x>.

MEASUrement:MEAS<x>:UNIts? on page 126 Returns the units for the instrument measurement specified by

MEASUrement:MEAS<x>:TYPe.

MEASUrement:MEAS<x>:VALue? on page 126 Returns the value that was calculated for the instrument on-screen

periodic measurement specified by <x>.

MEASUrement:REFLevel? on page 127 Returns the current reference level parameters. Query only.

MEASUrement:REFLevel:ABSolute:LOW on page 127 Sets or returns the low reference level, and is the lower reference

level when MEASUrement:REFLevel:METHod is set to Absolute.

MEASUrement:REFLevel:ABSolute:MID1 on page 128 Sets or returns the mid reference level, and is the 50% reference

level when MEASUrement:REFLevel:METHod is set to Absolute.

Table continued…

TBS1000C Series Digital Oscilloscopes Programmer Manual 29

Command groups

Command Description

MEASUrement:REFLevel:ABSolute:MID2 on page 128 Sets or returns the mid reference level for the ""to"" waveform when

taking a delay measurement, and is the 50% reference level when MEASUrement:REFLevel:METHod is set to Absolute.

MEASUrement:REFLevel:METHod on page 129 Specifies or returns the reference level units used for measurement

calculations.

MEASUrement:REFLevel:PERCent:HIGH on page 129 Sets or returns the percent (where 100% is equal to HIGH) used to

calculate the high reference level when MEASUrement:REFLevel:METHod is set to Percent.

MEASUrement:REFLevel:PERCent:LOW on page 130 Sets or returns the percent (where 100% is equal to HIGH) used to

calculate the low reference level when MEASUrement:REFLevel:METHod is set to Percent.

MEASUrement:REFLevel:PERCent:MID1 on page 131 Sets or returns the percent (where 100% is equal to HIGH) that is

used to calculate the mid reference level when MEASUrement:REFLevel:METHod is set to Percent.

MEASUrement:REFLevel:PERCent:MID2 on page 131 Sets or returns the percent (where 100% is equal to HIGH) that is

used to calculate the mid reference level for the second waveform specified when MEASUrement:REFLevel:METHod is set to Percent.

MEASUrement:SNAPSHOT on page 132 Sets the measurement snapshot feature.

MEASUrement:SOURCESNAPShot on page 132 Sets or returns the snapshot source.

Miscellaneous command group

Miscellaneous commands are a group of commands that do not fit into any other category.

Several commands and queries are common to all 488.2-1987 devices on the GPIB or USB bus. These commands and queries are defined by IEEE Std. 488.2-1987 and Tektronix Standard Codes and Formats 1989 and begin with an asterisk (*) character.

Table 19: Miscellaneous commands

Command Description

AUTOSet on page 47 Causes the instrument to adjust its vertical, horizontal, and trigger

controls to display a stable waveform.

AUTOSet:ENABLE on page 47 Allows educators to disable or enable the Autorange and Autoset

functions. The function can be manually set from the Utility menu. To access the menu, refer to the product user manual.

CLEARMenu on page 60 Clears the current menu from the display

DATE on page 73 Sets or queries the instrument date value.

FEAEN:PASSWORD on page 83 Checks if the password entered is equal to the preset password for

Feature Enable which allows the educators to enable or disable features such as Autoset, Cursors or Measurements. The same can be set manually from the Utility menu when we try to change the settings of Autoset Enable, Cursors Enable or Measurement Enable from Feature Enable.

FPAnel:PRESS on page 93 Simulates the action of pressing a specified front-panel button.

FPAnel:TURN on page 94 Simulates the action of turning a specified front-panel control knob.

FWUpdate:Update on page 95 Update firmware from u-disk.

Table continued…

TBS1000C Series Digital Oscilloscopes Programmer Manual 30

+ 179 hidden pages

Tektronix TBS1000C Programmer Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Table of Contents

List of Figures

List of Tables

Getting Started

Command Syntax

Command Syntax

Command and Query Structure

Commands

Queries

Headers in Query Responses

Clearing the Output Queue

Command Entry

Abbreviating Commands

Concatenating Commands

Message Terminators

Constructed Mnemonics

Reference Waveform Mnemonics

Waveform Mnemonics

Cursor Position Mnemonic

Measurement Specifier Mnemonics

Argument Types

Numeric Arguments

Quoted String Arguments

Block Arguments

Command groups

Alias command group

Acquisition command group

Calibration and Diagnostic command group

Cursor command group

Display command group

FFT command group

File system command group

Help everywhere command group

Horizontal command group

Math command group

Measurement command group

Miscellaneous command group