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

Command groups

Command Description

HDR on page 96 This command is identical to the HEADer query and is included for

compatibility with other Tektronix instruments.

HEADer on page 96 Sets and queries the Response Header Enable State that causes

the instrument to either include or omit headers on query responses.

ID? on page 108 Returns identifying information about the instrument and its

firmware in Tektronix Codes and Formats notation.

*IDN? on page 108 Returns the instrument identification code in IEEE 488.

LANGuage on page 109 Sets or queries the languages that the instrument uses to display

information on the screen.

LOCk on page 109 Enables and disables all front-panel buttons and knobs.

*LRN? on page 110 This is identical to the query.

MEASUrement:ENABLE on page 115 Allows educators to disable or enable the Measurement functions.

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

*RST on page 138 (Reset) Returns the instrument to a known set of instrument

settings, but does not purge any stored settings.

SET? on page 146 Returns most instrument settings.

TEKSecure on page 149 Equivalent to invoking Teksecure from the Utility->Config-

>TekSecure Erase Memory menu.

TIMe on page 149 Sets or queries the instrument time value.

UNLock on page 163 Unlocks the front panel.

VERBose on page 164 Sets and queries the Verbose state that controls the length of

keywords on query responses.

Save and Recall command group

Save and Recall commands allow you to store and retrieve internal waveforms and settings. When you "save a setting," you save most of the settings of the instrument. When you then "recall a setting," the instrument restores itself to the state it was in when you saved that setting.

To display a saved waveform, use the SELect:<wfm> command.

Table 20: Save and Recall commands

Command Description

FACtory on page 83 Resets the instrument to factory default settings.

*RCL on page 135 Restores the instrument to factory default settings stored in internal

nonvolatile memory.

RECAll:SETUp on page 135

RECAll:WAVEForm on page 136 Recalls a stored waveform from the USB flash drive into a reference

Table continued…

Restores the factory-default instrument settings, user-saved settings from internal nonvolatile memory, or user-saved settings from a file on a USB flash drive.

location.

TBS1000C Series Digital Oscilloscopes Programmer Manual 31

Command groups

Command Description

*SAV on page 140 Saves the state of the instrument into a specified nonvolatile

memory location.

SAVe:ASSIgn:TYPe on page 140 Sets or queries the assignment of the data to be saved.

SAVe:IMAge on page 141 Saves the screen image to a file on the USB flash drive.

SAVe:IMAge:FILEFormat on page 141 Sets the screen image file format used by the SAVe:IMAGE

command and by the SAVE > Action > Save Image and SAVE > Action > Save All front-panel operations.

SAVe:IMAGe:LAYout on page 141 Sets or queries the layout to use for saved screen images.

SAVe:SETUp on page 142 Saves the current state of the instrument into the specified

nonvolatile memory location, or to a file on the USB flash drive.

SAVe:WAVEform on page 142 Stores a waveform in one of the nonvolatile reference memory

locations, or to a file on the USB flash drive.

SAVe:WAVEform:FILEFormat on page 143 Sets or returns the format for saved waveforms.

SETUP<x>:DATE? on page 147 Returns the date when the specified instrument setup was saved.

SETUP<x>:TIME? (Query Only) on page 147 Returns the time when the specified instrument setup was saved.

Status and Error command group

Status and error commands let you determine the status of the instrument and control events.

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

Table 21: Status and Error commands

Command Description

ALLEv? on page 46 Causes the instrument to return all events and their messages, and

removes the returned events from the Event Queue.

BUSY? on page 48 Returns the status of the instrument.

*CLS on page 60 Clears the Event Queue, Standard Event Status Register, and

Status Byte Register (except the MAV bit)..

DESE on page 73 Sets and queries the bits in the Device Event Status Enable

*ESE on page 80 Sets and queries the bits in the Event Status Enable Register

(ESER).

*ESR? on page 81 Returns the contents of the Standard Event Status Register

(SESR).

EVENT? on page 81 Returns from the Event Queue an event code that provides

information about the results of the last *ESR? read.

EVMsg? on page 82 Removes from the Event Queue a single event code associated

with the results of the last *ESR? read, and returns the event code with an explanatory message.

EVQty? on page 82 Return number of events in the event queue.

Table continued…

TBS1000C Series Digital Oscilloscopes Programmer Manual 32

Command groups

Command Description

*OPC on page 133 Generates the operation complete message in the Standard Event

Status Register (SESR) when all pending commands that generate an OPC message are complete.

*PSC on page 134 Sets and queries the power-on status flag that controls the

automatic power-on handling of the DESER, SRER, and ESER registers.

*RST on page 138 Resets the instrument to factory default settings.

*SRE on page 147 (Service Request Enable) sets and queries the bits in the Service

Request Enable Register (SRER).

*STB? on page 148 (Read Status Byte) query returns the contents of the Status Byte

*WAI on page 165 Prevents the instrument from executing further commands or

queries until all pending commands that generate an OPC message are complete.

Trigger command group

Trigger commands control all aspects of instrument triggering.

The three types of triggers are edge, pulse width, and video. Edge triggering is the default type. Edge triggering lets you acquire a waveform when the signal passes through a voltage level of your choosing. Pulse width triggering lets you trigger on normal or aberrant pulses. Video triggering adds the capability of triggering on video fields and lines.

Table 22: Trigger commands

Command Description

TRIGger on page 149 Forces a trigger event to occur.

TRIGger:A on page 150 Sets the instrument trigger level to 50% of the minimum and

maximum values of the signal.

TRIGger:A:EDGE? on page 150 Returns the trigger coupling, source, and slope settings for the edge

trigger.

TRIGger:A:EDGE:COUPling on page 151 Sets or queries the type of coupling for the edge trigger.

TRIGger:A:EDGE:SLOpe on page 151 Selects a rising or falling slope for the edge trigger.

TRIGger:A:EDGE:SOUrce on page 152 Sets or queries the source for the edge trigger.

TRIGger:A:HOLDOff? on page 152 Returns the A trigger holdoff settings.

TRIGger:A:HOLDOff:TIMe on page 153 Sets or queries the instrument trigger holdoff time.

TRIGger:A:LEVel on page 153 Sets or returns the trigger level for the A trigger.

TRIGger:A:LEVel:CH<x> on page 154 Sets or returns the trigger level for the specified channel. Each

channel can have an independent level.

TRIGger:A:LOWerthreshold:CH<x> on page 154 Sets or returns the lower threshold for the channel selected.

TRIGger:A:MODe on page 155 Sets or queries the trigger mode for the Edge (all models) and

Pulse width trigger types.

TRIGger:A:PULse? on page 155 Returns the current Pulse Trigger settings.

TRIGger:A:PULSE:Width? on page 156 Returns the pulse trigger width settings.

Table continued…

TBS1000C Series Digital Oscilloscopes Programmer Manual 33

Command groups

Command Description

TRIGger:A:PULse:WIDth:POLarity on page 156 Sets or queries the polarity for the pulse trigger.

TRIGger:A:PULSEWidth:SOUrce on page 157 Sets or queries the source for the pulse trigger.

TRIGger:A:PULse:WIDth:WHEN on page 157 Sets or queries the trigger conditions for the pulse trigger.

TRIGger:A:PULse:WIDth:WIDth on page 158 Sets or queries the width for the pulse trigger.

TRIGger:A:RUNT? on page 158 Returns the current A runt trigger parameters.

TRIGger:A:RUNT:POLarity on page 159 Sets or returns the polarity for the runt trigger.

TRIGger:A:RUNT:SOUrce on page 159 Sets or returns the source for the A runt trigger.

TRIGger:A:RUNT:WHEn on page 159 Sets or returns the type of pulse width the trigger checks for when it

detects a runt.

TRIGger:A:RUNT:WIDth on page 160 Sets or returns the width for a runt trigger.

TRIGger:A:TYPe on page 161 Sets or queries the type of instrument trigger.

TRIGger:A:UPPerthreshold:CH<x> on page 161 Sets the upper threshold for channel <x>, where x is the channel

number. Each channel can have an independent level. Used only for runt trigger type.

TRIGger:FREQuency? on page 162 Returns the edge or pulse width trigger frequency.

TRIGger:STATE? on page 162 Returns the current state of the triggering system.

Vertical command group

Vertical commands control the attributes of the channels. The SELect:<wfm> command also displays a specified waveform or removes it from the display.

Table 23: Vertical commands

Command Description

CH<x>? on page 51 Returns vertical parameters for the specified channel.

CH<x>:BANdwidth on page 52 Sets or queries the bandwidth setting of the specified instrument

channel.

CH<x>:COUPling on page 53 Sets or queries the input coupling setting of the specified instrument

channel.

CH<x>:DESKew on page 53 Sets or queries the deskew time for the specified channel.

CH<x>:INVert on page 54 Sets or returns the invert function for the specified channel.

CH<x>:LABel on page 54 This commands sets or queries the waveform label for the specified

channel.

CH<x>:OFFSet on page 55 Sets or queries the channel offset.

CH<x>:POSition on page 55 Sets or queries the vertical position of the specified instrument

channel.

CH<x>:PRObe on page 56? Returns the gain, resistance, units, and ID of the probe that is

attached to the specified channel.

CH<x>:PRObe:GAIN on page 56 Sets or queries the gain factor of the probe that is attached to the

specified channel.

CH<x>:PRObe:ID? on page 57 Returns the type and serial number of the probe that is attached to

the specified channel.

Table continued…

TBS1000C Series Digital Oscilloscopes Programmer Manual 34

Command groups

Command Description

CH<x>:PRObe:ID:SERnumber? on page 57 Returns the serial number of the probe that is attached to the

specified channel.

CH<x>:PRObe:ID:TYPE? on page 57 Returns the type of probe that is attached to the specified channel.

CH<x>:PRObe:SIGnal on page 58 Sets or queries the input bypass setting of the TekVPI probe

attached to the specified channel.

CH<x>:PRObe:UNIts? on page 58 Returns the units of measure of the probe that is attached to the

specified channel.

CH<x>:SCAle on page 58 Sets or queries the vertical scale of the specified instrument

channel.

CH<x>:VOLts on page 59 Sets or queries the vertical sensitivity of the specified channel.

CH<x>:YUNit on page 59 Sets or queries the units of the specified channel.

REF<x>? on page 136 Returns reference waveform data for the specified channel.

REF<x>:DATE? on page 136 Returns the date that the reference waveform was stored.

REF<x>:TIMe? on page 137 Returns the time that the reference waveform was stored.

REF<x>:HORizontal:DELay:TIMe? on page 137 Returns the horizontal position of the specified reference waveform

in percent of the waveform that is displayed to the right of the center vertical graticule.

REF<x>:HORizontal:SCAle? on page 137 Returns the horizontal scale for the reference waveform.

REF<x>:POSition? on page 138 Returns the vertical position for channel <x>, where x is the

reference channel number. Query only.

REF<x>:VERTical:POSition? on page 138 Returns the vertical position of the specified reference waveform.

REF<x>:VERTical:SCAle? on page 138 Returns the reference waveform vertical scale in vertical units/div.

SELect:CH<x> on page 144 Turns the display of the channel <x> waveform on or off.

SELect:CONTROl on page 144 Sets or returns the waveform that is selected as the implied

recipient of channel-related commands

SELect:FFT on page 145 Turns on or off the FFT waveform or queries whether the FFT

waveform is on or off.

SELect:MATH on page 145 Turns on or off the math waveform or queries whether the math

waveform is on or off.

SELect:REF<x> on page 146 Turns on or off the specified reference waveform or queries whether

the specified reference waveform is on or off.

Waveform command group

Waveform commands let you transfer waveform data points to and from the instrument. Waveform data points are a collection of values that define a waveform. One data value usually represents one data point in the waveform record. When working with peak-detect waveforms, each data value is either the min or max of a min/max pair. Before you can transfer waveform data, you must specify the data format and waveform locations.

Refer to the text following this table for more information about waveform commands.

TBS1000C Series Digital Oscilloscopes Programmer Manual 35

Command groups

Table 24: Waveform commands

Command Description

CURVe on page 68 Transfers instrument waveform data to and from the instrument in

binary or ASCII format.

DATa on page 70 Sets or queries the format and location of the waveform data that is

transferred with the CURVe command.

DATa:DESTination on page 70 Sets or queries the reference memory location for storing

instrument waveform data that is transferred into the instrument by the CURVe command.

DATa:SOUrce on page 71 Sets or queries which waveform will be transferred from the

instrument by the CURVe, WFMPre, or WAVFrm? queries.

DATa:STARt on page 71 Sets or queries the starting data point for waveform data transfers.

DATa:STOP on page 72 Sets or queries the last data point in the waveform that will be

transferred when executing the CURVe? command.

DATa:WIDth on page 72 Sets the number of bytes per waveform data point to be transferred

when executing the CURVe command.

WAVFrm? on page 165 Returns WFMPre? and CURVe? data for the waveform specified by

the DATa:SOUrce command.

WFMInpre:BIT_Nr on page 166 Sets or queries the number of bits per waveform point for the

waveform to be transferred.

WFMInpre:BYT_Nr on page 166 Sets or queries the data width for the waveform to be transferred.

WFMInpre:ENCdg on page 167 Sets or queries the type of encoding for waveform data transferred

with the CURVe command.

WFMInpre:NR_Pt? on page 167 Returns the number of points that are in the transmitted waveform

record, as specified by DATa:SOUrce.

WFMInpre:XINcr on page 168 The set form of this command specifies the interval (seconds per

point for nonFFT, Hertz per point for FFT) between samples of the reference waveform specified by the DATa:DESTination command.

WFMInpre:XUNit on page 168 Sets the horizontal units ("s" for seconds and "Hz" for Hertz) for the

reference waveform specified by the DATa:DESTination command.

WFMInpre:XZEro on page 168 The set form of this command specifies the position, in XUNits, of

the first sample of the reference waveform specified by the DATa:DESTination command, relative to the trigger.

WFMInpre:YMUlt on page 169 Sets or queries the vertical scale factor of the incoming waveform,

expressed in YUNits per waveform data point level.

WFMInpre:YOFf on page 170 Sets or queries the vertical position of the incoming waveform in

digitizing levels.

WFMInpre:YUNit on page 170 Sets the vertical units for the reference waveform specified by

DATa:DESTination.

WFMInpre:YZEro on page 171 Sets or returns the vertical offset of the incoming waveform in units

specified by WFMInpre:YUNit.

WFMOutpre? on page 171 Returns waveform transmission and formatting settings for the

waveform specified by the DATa:SOUrce command.

Table continued…

TBS1000C Series Digital Oscilloscopes Programmer Manual 36

Command groups

Command Description

WFMOutpre:BIT_Nr on page 172 Sets and queries the number of bits per waveform point that

outgoing waveforms contain, as specified by the DATa:SOUrce command.

WFMOutpre:BYT_Nr on page 173 Sets or queries the data width for the outgoing waveform specified

by the DATa:SOUrce command.

WFMOutpre:ENCdg on page 173 Sets and queries the type of encoding for outgoing waveforms.

WFMOutpre:NR_Pt? on page 174 Returns the number of points for the DATa:SOUrce waveform that

will be transmitted in response to a CURVe? query.

WFMOutpre:RECOrdlength? on page 174 Returns the record length for the source waveform as specified by

the DATa:SOUrce command.

WFMOutpre:WFId? on page 174 Returns a descriptive string from the waveform specified in the

DATa:SOUrce command, if that waveform is active or displayed.

WFMOutpre:XINcr? on page 175 Returns the horizontal point spacing in units of WFMOutpre:XUNit

for the waveform specified by the DATa:SOUrce command.

WFMOutpre:XUNit? on page 175 Returns the horizontal units for the waveform specified by the

DATa:SOUrce command.

WFMOutpre:XUNit? on page 175 Returns the time coordinate of the first point in the outgoing

waveform.

WFMOutpre:YMUlt? on page 176 Returns the vertical scale factor per digitizing level in units specified

by WFMOutpre:YUNit for the waveform specified by the DATa:SOUrce command.

WFMOutpre:YOFf? on page 176 Returns the vertical position in digitizing levels for the waveform

specified by the DATa:SOUrce command.

WFMOutpre:YUNit? on page 177 Returns the vertical units for the waveform specified by the

DATa:SOUrce command.

WFMOutpre:YZEro? on page 177 Returns the vertical offset in units specified by WFMOutpre:YUNit?

for the waveform specified by the DATa:SOUrce command.

Waveform data formats

Internally, the instrument uses one 8-bit data byte to represent each waveform data point, regardless of the acquisition mode.

The DATa:WIDth command lets you specify the number of bytes per data point when transferring data to and from an instrument. This provides compatibility with other digitizing instruments.

When DATa:WIDth is set to two:

• If sending data, the instrument multiplies each point by 256; the most significant byte then has meaningful data and the least significant byte is 0.

• If receiving data, the instrument truncates the data (divides by 256) and saves the most significant byte.

Note: The instrument uses these methods to handle waveforms transmitted in ASCII or binary format.

The instrument can transfer waveform data in either ASCII or binary format. Use the DATa:ENCdg command to specify one of the following formats:

• ASCII data is represented by signed integer values. The range of values depends on the byte width specified. One-byte-wide data ranges from -128 to 127. Two-byte-wide data ranges from -32768 to 32767.

Each data value requires two to seven characters. This includes one character for the minus sign if the value is negative, one to five ASCII characters for the waveform value, and a comma to separate data points.

TBS1000C Series Digital Oscilloscopes Programmer Manual 37

Command groups

An example of an ASCII waveform data string follows:

CURVE<space>-110,-109,-110,-110,-109,-107,-109,-107,

-106,-105,-103,-100,-97,-90,-84,-80

• Binary data can be represented by signed integer or positive integer values. The range of the values depends on the byte width specified.

Table 25: Binary data ranges

Byte width Signed integer range Positive integer range

1 -128 to 127 0 to 255

2 -32,768 to 32,767 0 to 65,535

The defined binary formats also specify the order in which the bytes are transferred giving a total of four binary formats: RIBinary, RPBinary, SRIbinary, and SRPbinary.

RIBinary is signed integer where the most significant byte is transferred first, and RPBinary is positive integer where the most significant byte is transferred first. SRIbinary and SRPbinary correspond to RIBinary and RPBinary respectively but use a swapped byte order where the least significant byte is transferred first. The byte order is ignored when DATa:WIDth is set to 1.

Waveform data record

You can transfer multiple points for each waveform record. You can transfer a part of the waveform or you can transfer the entire record. The DATa:STARt and DATa:STOP commands let you specify the first and last data points of the waveform record.

When transferring data into the instrument you must specify the location of the first data point within the waveform record. For example, when DATa:STARt is set to 1, data points will be stored starting with the first point in the record, and when DATa:STARt is set to 500, data will be stored starting at the 500th point in the record. The instrument ignores DATa:STOP when reading in data as the instrument will stop reading data when there is no more data to read or when it has reached 2500 data points.

You must specify the first and last data points in the waveform record when transferring data from the instrument to an external device. Setting DATa:STARt to 1 and DATa:STOP to 2500 always sends the entire waveform, regardless of the acquisition mode.

Waveform data locations and memory allocation

The DATa:SOUrce command specifies the location of the data when transferring waveforms from the instrument. You can transfer one waveform into the instrument at a time. Each waveform is stored in one of two stored waveform locations. You specify the stored waveform location with the DATa:DESTination command.

Note: The instrument stores waveforms that are ≤2500 data points long. The instrument truncates waveforms longer than 2500 data points.

Waveform preamble

Each waveform that is transferred has an associated waveform preamble that contains information such as the horizontal scale, vertical scale, and other settings in place when the waveform was created. Refer to the WFMPre? commands for more information about the waveform preamble.

Scaling waveform data

Once you transfer the waveform data to the controller, you can convert the data points into voltage values for analysis using information from the waveform preamble.

Transferring waveform data

Data transfer times depend on data format, data width, and the speed of the controller. Programming Examples on page 200

From the instrument. To transfer waveforms from the instrument to an external controller, follow these steps:

1. Use the DATa:SOUrce command to select the waveform source.

2. Use the DATa:ENCdg command to specify the waveform data format.

TBS1000C Series Digital Oscilloscopes Programmer Manual 38

3. Use the DATa:WIDth command to specify the number of bytes per data point.

4. Use the DATa:STARt and DATa:STOP commands to specify the part of the waveform that you want to transfer.

5. Use the WFMPre? command to transfer waveform preamble information.

6. Use the CURVe command to transfer waveform data.

To the instrument. To transfer waveform data to an instrument waveform storage location, follow these steps:

1. Use the DATa:DESTination command to specify the stored waveform location.

2. Use the DATa:ENCdg command to specify the waveform data format.

3. Use the DATa:WIDth command to specify the number of bytes per data point.

4. Use the DATa:STARt command to specify the first data point in the waveform record.

5. Use the WFMPre? command to transfer waveform preamble information.

6. Use the CURVe command to transfer waveform data.

Zoom command group

These commands support the zoom feature.

Table 26: Zoom commands

Command Description

ZOOM? on page 178

Returns the current horizontal positioning and scaling of the display.

Command groups

ZOOm{:MODe|:STATE} on page 178 Sets or queries the zoom on/off state.

ZOOm:ZOOM1? on page 178

ZOOM:ZOOM1:FACtor on page 179 Sets or queries the zoom factor of a particular zoom box.

ZOOM:ZOOM1:HORizontal:POSition on page 179 Sets or queries the horizontal position of a particular zoom box.

ZOOM:ZOOM1:HORizontal:SCAle on page 179

ZOOm:ZOOM1:POSition on page 180 Sets or returns the horizontal zoom position for the specified

ZOOm:ZOOM1:SCAle on page 180 Sets or returns the horizontal zoom scale of the specified waveform

ZOOM:ZOOM1:STATE on page 181 Specifies or returns a trace as zoomed, on or off.

Returns the current horizontal positioning and scaling of the display

Sets or queries the horizontal zoom scale of the specified waveform in the specified zoom.

waveform in the specified zoom

in the specified zoom

TBS1000C Series Digital Oscilloscopes Programmer Manual 39

A commands

This section lists commands and queries that begin with the letter A.

ACQuire?

Returns the current acquisition settings. Query only.

Group

Acquisition

Syntax

ACQuire?

Related Commands

ACQuire:MODe on page 40, ACQuire:NUMACq? on page 41, ACQuire:NUMAVg on page 42, ACQuire:NUMAVg on page 42

Returns

Returns current acquisition settings: Stop after, Acquisition state, Mode, Number of averages.

Examples

A commands

ACQuire? might return the following string for the current acquisition: ACQUIRE:STOPAFTER RUNSTOP;STATE 1; MODE SAMPLE;NUMAVG 16

ACQuire:MAXSamplerate?

Returns the maximum real-time sample rate, which varies from model to model. Query only.

Group

Acquisition

Syntax

ACQuire:MAXSamplerate?

Examples

ACQUIRE:MAXSAMPLERATE? might return 1.0000E+9 indicating the maximum real-time sample rate is 1.0 GS/s.

ACQuire:MODe

Sets or queries the acquisition mode of the instrument for all live waveforms.

Waveforms are the displayed data point values taken from acquisition intervals. Each acquisition interval represents a time duration set by the horizontal scale (time per division).

The instrument sampling system always samples at the maximum rate, so the acquisition interval may include more than one sample. The acquisition mode, which you set using this ACQuire:MODe command, determines how the final value of the acquisition interval is generated from the many data samples.

Group

Acquisition

TBS1000C Series Digital Oscilloscopes Programmer Manual 40

A commands

Syntax

ACQuire:MODe {SAMple|PEAKdetect|HIRes|AVErage}

ACQuire:MODe?

Related commands

ACQuire:NUMAVg on page 42, CURVe on page 68

Arguments

SAMple specifies that the displayed data point value is the first sampled value that was taken during the acquisition interval. The waveform data has 8 bits of precision in all acquisition modes. You can request 16 bit data with a CURVe? query, but the lower-order 8 bits of data will be zero. SAMple is the default mode.

PEAKdetect specifies the display of the high-low range of the samples taken from a single waveform acquisition. The instrument displays the high-low range as a vertical column that extends from the highest to the lowest value sampled during the acquisition interval. PEAKdetect mode can reveal the presence of aliasing or narrow spikes.

HIRes specifies Hi Res mode where the displayed data point value is the average of all the samples taken during the acquisition interval. This is a form of averaging, where the average comes from a single waveform acquisition. The number of samples taken during the acquisition interval determines the number of data values that compose the average.

AVErage specifies averaging mode, in which the resulting waveform shows an average of SAMple data points from several separate waveform acquisitions. The instrument processes the number of waveforms you specify into the acquired waveform, creating a running exponential average of the input signal. The number of waveform acquisitions that go into making up the average waveform is set or queried using the ACQuire:NUMAVg command.

Examples

ACQuire:MODe AVErage sets average acquisition mode so that the resulting waveform is the average of the specified number of waveform acquisitions.

ACQuire:MODe? might return ACQUIRE:MODE AVERAGE indicating that the displayed waveform is the average of the specified number of waveform acquisitions.

ACQuire:NUMACq?

Indicates the number of acquisitions that have taken place since starting instrument acquisition. The acquisition number will continue to increase while acquisitions are running until there is a reset.

Starting and stopping acquisitions do not cause this number to reset. For example, if acquisitions are running, the acquisition count will increase (assuming the instrument is triggering). If you stop the acquisitions, the acquisition number will freeze at a given number (For example: 5000). If you start acquisitions again, it will continue from 5000. The number will reset to 0 only if you change the horizontal scale while acquisitions are running.

Group

Acquisition

Syntax

ACQuire:NUMACq?

Related commands

ACQuire:STATE on page 42

Returns

<NR1>

TBS1000C Series Digital Oscilloscopes Programmer Manual 41

A commands

Examples

ACQuire:NUMACq? might return ACQUIRE:NUMACQ 350 indicating that 350 acquisitions have occurred.

ACQuire:NUMAVg

Sets or queries the number of waveform acquisitions that make up an averaged waveform. Use the ACQuire:MODe command to enable Average mode. Sending this command is equivalent to turning a multipurpose knob to enter the number of waveform acquisitions to average.

Group

Acquisition

Syntax

ACQuire:NUMAVg <NR1>

ACQuire:NUMAVg?

Arguments

<NR1> is the number of waveform acquisitions to average. The range of values is from 2 to 512 in powers of two.

Examples

ACQuire:NUMAVg 16 specifies that 16 waveform averages are performed before exponential averaging starts.

ACQuire:NUMAVg? might return ACQUIRE:NUMAVG 64 indicating that there are 64 acquisitions specified for averaging.

ACQuire:STATE

Starts or stops acquisitions.

When State is set to ON or RUN, a new acquisition is started. If the last acquisition was a single acquisition sequence, a new single sequence acquisition is started. If the last acquisition was continuous, a new continuous acquisition is started.

If RUN is issued in the middle of completing a single sequence acquisition (for example, averaging or enveloping), the acquisition sequence is restarted, and any accumulated data is discarded. Also, the instrument resets the number of acquisitions. If the RUN argument is issued while in continuous mode, acquisition continues.

Group

Acquisition

Syntax

ACQuire:STATE {OFF|ON|RUN|STOP|<NR1>}

ACQuire:STATE?

Related Commands

*OPC on page 133, ACQuire:STOPAfter on page 43

Arguments

OFF|STOP|<NR1> = 0 stops acquisitions; any other value starts acquisitions..

ON|RUN|<NR1> ≠ 0 starts acquisition and display of waveforms.

Examples

ACQuire:STATE RUN starts acquisition of waveform data and resets the number of acquisitions count (NUMACq) to zero.

TBS1000C Series Digital Oscilloscopes Programmer Manual 42

ACQuire:STATE? might return: ACQUIRE:STATE 0 indicating that the acquisition is stopped.

ACQuire:STOPAfter

Sets or returns whether the instrument continually acquires acquisitions or acquires a single sequence.

Group

Acquisition

Syntax

ACQuire:STOPAfter {RUNSTop|SEQuence}

ACQuire:STOPAfter?

Related commands

ACQuire:STATE on page 42

Arguments

RUNSTop specifies that the instrument will continually acquire data, if ACQuire:STATE is turned on.

SEQuence specifies that the next acquisition will be a single-sequence acquisition.

A commands

Examples

ACQuire:STOPAfter `RUNSTOP sets the instrument to continually acquire data.

ACQuire:STOPAfter? might return: ACQUIRE:STOPAFTER SEQUENCE indicating that the next acquisition the instrument makes

will be of the single-sequence type.

ALIas

Sets or queries the state of alias functionality.

Use 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.

To use Alias commands, first define the alias, then turn on the alias state.

Group

Alias

Syntax

ALIas {OFF|ON|<NR1>}

ALIas?

Related commands

ALIas:DEFine on page 44, ALIas[:STATE] on page 46

Arguments

OFF turns alias expansion off. If a defined alias is sent when ALIas is off, a command error (110) will be generated.

ON turns alias expansion on. When a defined alias is received, the specified command sequence is substituted for the alias and executed.

<NR1> = 0 disables alias mode; any other value enables alias mode.

TBS1000C Series Digital Oscilloscopes Programmer Manual 43

A commands

Examples

ALIAS ON turns the alias feature on. When a defined alias is received, the specified command sequence is substituted for the alias and executed.

ALIAS? might return :ALIAS 1 indicating that the alias feature is on.

ALIas:CATalog?

Returns a list of the currently defined alias labels, separated by commas. If no aliases are defined, the query returns the string "". Query only.

Group

Alias

Syntax

ALIas:CATalog?

Examples

ALIAS:CATALOG? might return the string :ALIAS:CATALOG "SETUP1","TESTMENU1","DEFAULT" showing that there are three aliases named SETUP1, TESTMENU1, and DEFAULT.

ALIas:DEFine

Assigns a sequence of program messages to an alias label. These messages are then substituted for the alias whenever it is received as a command or query, provided that ALIas:STATE has been turned on. The query form of this command returns the definitions of a selected alias.

Note: Attempting to give two aliases the same name causes an error. To give a new alias the name of an existing alias, the existing alias must first be deleted.

Group

Alias

Syntax

ALIas:DEFine <QString><,>{<QString>|<Block>}

ALIas:DEFine? <QString>

Related commands

ALIas[:STATE] on page 46

Arguments

The first <QString> is the alias label. This label cannot be a command name. Labels must start with a letter and can contain only letters, numbers, and underscores; other characters are not allowed. The label must be less than or equal to 12 characters. The second<QString> or <Block> is a complete sequence of program messages. The messages can contain only valid commands that must be separated by semicolons and must follow all rules for concatenating commands. The sequence must be less than or equal to 256 characters.

Examples

ALIAS:DEFINE "ST1",":RECALL:SETUP 5;:AUTOSET EXECUTE;:SELECT:CH1 ON" defines an alias named "ST1" that sets up the instrument.

ALIAS:DEFINE? "ST1" returns :ALIAS:DEFINE "ST1",#246 :RECALL:SETUP 5;:AUTOSET EXECUTE;:SELECT:CH1 ON.

TBS1000C Series Digital Oscilloscopes Programmer Manual 44

A commands

ALIas:DELEte

Removes a specified alias and is identical to ALIas:DELEte:NAMe. An error message is generated if the named alias does not exist. (No query form.

Group

Alias

Syntax

ALIas:DELEte <QString>

Related commands

*ESR? on page 81, ALIas:DELEte:ALL on page 45

Arguments

<QString> is the name of the alias to be removed. Using ALIas:DELEte without specifying an alias causes an execution error. <QString> must be a previously defined value.

Examples

ALIAS:DELETE "SETUP1" deletes the alias named SETUP1.

ALIas:DELEte:ALL

Deletes all existing aliases. No query form.

Group

Alias

Syntax

ALIas:DELEte:ALL

Related commands

ALIas:DELEte on page 45, ALIas:DELEte[:NAMe] on page 45

Examples

ALIAS:DELETE:ALL deletes all existing aliases.

ALIas:DELEte[:NAMe]

Removes a specified alias. This command is identical to ALIas:DELEte. No query form.

Group

Alias

Syntax

ALIas:DELEte[:NAMe] <QString>

Arguments

<QString> is the name of the alias to remove. Using ALIas:DELEte[:NAMe] without specifying an alias causes an execution error. <QString> must be an existing alias.

TBS1000C Series Digital Oscilloscopes Programmer Manual 45

A commands

Examples

ALIAS:DELETE:NAME “STARTUP” deletes the alias named STARTUP.

ALIas[:STATE]

Turns aliases on or off. This command is identical to the ALIas command.

Group

Alias

Syntax

ALIas[:STATE] {<NR1>|OFF|ON}

ALIas[:STATE]?

Arguments

OFF or <NR1> = 0 turns alias expansion off. If a defined alias is sent when ALIas:STATE is OFF, a command error (102) is generated.

ON or <NR1> ≠ 0 turns alias expansion on. When a defined alias is received, the specified command sequence is substituted for the alias and executed.

Examples

ALIAS:STATE OFF turns the command alias feature off.

ALIAS[:STATE]? returns 0 when the alias feature is off.

ALLEv?

Causes the instrument to return all events and their messages, and removes the returned events from the Event Queue. The messages are separated by commas. Use the *ESR? query to enable the events to be returned. Refer to the Status and Events section for a complete description of how to use these registers. This command is similar to repeatedly sending *EVMsg? queries to the instrument. Query only.

Group

Status and Error

Syntax

ALLEv?

Related Commands

*CLS on page 60, DESE on page 73, *ESE on page 80, *ESR? on page 81, EVENT? on page 81, EVMsg? on page 82, EVQty?

on page 82, *SRE on page 147, *STB? on page 148

Returns

The event code and message in the following format:

<Event Code><Comma><QString>[<Comma><Event Code><Comma><QString>...]

<QString>::= <Message>;[<Command>]

<Command> is the command that caused the error and may be returned when a command error is detected by the instrument. As much of the command is returned as possible without exceeding the 60 character limit of the <Message> and <Command> strings combined. The command string is right-justified.

TBS1000C Series Digital Oscilloscopes Programmer Manual 46

A commands

Examples

ALLEv? might return the following string: ALLEV 2225,"MEASUREMENT ERROR, NO WAVEFORM TO MEASURE; ",420,"QUERY UNTERMINATED; "

AUTOSet

Causes the instrument to adjust its vertical, horizontal, and trigger controls to display a stable waveform. This command is equivalent to pushing the front-panel AUTOSET button. For a detailed description of the Autoset function, refer to the user manual for your instrument. Command only, no query form.

Group

Miscellaneous

Syntax

AUTOSet {EXECute | UNDo}

Arguments

EXECute runs Autoset on the selected waveform.

UNDo restores the oscilloscope settings to those prior to running Autoset.

AUTOSet:ENABLE

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.

Group

Miscellaneous

Syntax

AUTOSet:ENABLE {ON | OFF}

AUTOSet:ENABLE?

Related commands

AUTOSet on page 47

FEAEN:PASSWORD on page 83

Arguments

ON enables the autoset feature.

OFF disables the autoset feature.

Examples

AUTOSET:ENABLE OFF disables autoset.

AUTOSET:ENABLE? might return 1 indicating that autoset is enabled.

TBS1000C Series Digital Oscilloscopes Programmer Manual 47

B commands

This section lists commands and queries that begin with the letter B.

BUSY?

Returns the status of the instrument. This command allows you to synchronize the operation of the instrument with your application program. Query only.

Certain instrument operations can affect the BUSY? response. Table 30: Instrument operations that can generate OPC on page 187

Group

Status and Error

Syntax

BUSY?

Related Commands

*OPC on page 133, *WAI on page 165

Returns

<NR1> = 0 means the instrument is not busy processing a command whose execution time is extensive.

<NR1> = 1 means the instrument is busy processing a command whose execution time is extensive. Table 30: Instrument operations that

can generate OPC on page 187

Examples

BUSY? might return :BUSY 1 indicating that the instrument is now busy. See Using the BUSY Query on page 189 for an example of how to use this query.

TBS1000C Series Digital Oscilloscopes Programmer Manual 48

C commands

This section lists commands and queries that begin with the letter C.

*CAL?

Performs an internal self-calibration and returns its status. This is equivalent to selecting the Do Self Cal option in the Utility menu. Although *CAL? is a query command, it does perform an action. Query only.

Note: The self-calibration can take several minutes to complete. During this time, the instrument does not execute any commands.

Disconnect all signals from the instrument before performing an internal self-calibration.

Group

Calibration and Diagnostic

Syntax

*CAL?

Related Commands

CALibrate:INTERNAL on page 49

Returns

0 indicates that the self-calibration completed without any errors detected.

Any value other than zero indicates that the self-calibration did not complete successfully or completed with errors.

Examples

*CAL? performs a self-calibration and might return 0 to indicate that it completed successfully.

CALibrate:INTERNAL

This command starts a signal path compensation. Command only, no query form.

Note: The self-calibration can take several minutes to complete. During this time, the instrument does not execute any commands.

Disconnect all signals from the instrument before performing an internal self-calibration.

Group

Calibration and Diagnostic

Syntax

CALibrate:INTERNAL

Examples

CALibrate:INTERNAL starts a signal path compensation cycle.

TBS1000C Series Digital Oscilloscopes Programmer Manual 49

C commands

CALibrate:INTERNal:STARt

Starts the internal signal path calibration (SPC) of the instrument. You can use the CALibrate:INTERNal:STATus? query to return the current status of the internal signal path calibration of the instrument. No query form.

Group

Calibration and Diagnostic

Syntax

CALibrate:INTERNal:STARt

Related commands

CALibrate:RESults:SPC? on page 51

Examples

CALIBRATE:INTERNAL:START initiates the internal signal path compensation of the instrument.

CALibrate:INTERNal:STATus?

Returns the current status of the instrument internal signal path compensation for the last SPC operation. Query only.

Group

Calibration and Diagnostic

Syntax

CALibrate:INTERNal:STATus?

Related commands

*CAL? on page 49

Returns

INIT indicates the instrument has not had internal signal path calibration run.

PASS indicates the signal path calibration completed successfully.

FAIL indicates the signal path calibration did not complete successfully.

RUNNING indicates the signal path calibration is currently running.

Examples

CALibrate:INTERNal:STATus? might return :CALIBRATE:INTERNAL:STATUS INIT indicating that the current status of the internal signal path compensation is that it has not been run.

CALibrate:RESults?

Returns the status of internal and factory calibrations, without performing any calibration operations. Query only.

The results returned do not include the calibration status of attached probes. The CALibrate:RESults? query is intended to support GO/NoGO testing of the instrument calibration readiness: all returned results should indicate PASS status if the instrument is fit for duty. It is quite common, however, to use uncalibrated probes (particularly when the instrument inputs are connected into a test system with coaxial cables).

TBS1000C Series Digital Oscilloscopes Programmer Manual 50

C commands

Group

Calibration and Diagnostic

Syntax

CALibrate:RESults?

Related commands

*CAL? on page 49

Examples

CALibrate:RESults? might return :CALibrate:RESults INIT indicating the instrument has not be calibrated.

CALibrate:RESults:SPC?

Returns the status of the SPC operation. This query does not initiate a SPC. Query only.

Group

Calibration and Diagnostic

Syntax

CALibrate:RESults:SPC?

Related commands

*CAL? on page 49

Returns

INIT indicates that SPC has never successfully completed.

PASS indicates that the last SPC operation passed.

FAIL indicates that the last SPC operation failed.

RUNNING indicates that the SPC operation is running.

Examples

CALibrate:RESults:SPC? might return :CALibrate:RESults:SPC INIT indicating SPC has not be run successfully.

CH<x>?

Returns the vertical parameters for the specified channel. The value of <x> can vary from 1 through 4 depending on instrument model. Query only.

Because CH<x>:SCAle and CH<x>:VOLts are identical, only CH<x>:SCAle is returned.

Group

Vertical

Syntax

CH<x>?

Related Commands

SELect:REF<x> on page 146

TBS1000C Series Digital Oscilloscopes Programmer Manual 51

C commands

Returns

instrument vertical settings for the specified channel.

Examples

CH1? might return :CH1:SCALE 1.0E0;POSITION 0.0E0; COUPLING DC;BANDWIDTH FULL;PROBE 1.0E0.

CH<x>:AMPSVIAVOLTs:ENABLe

Sets or queries measure current status as ON or Off. The value <x> can vary from 1 through 2 depending upon the channel.

Group

Vertical

Syntax

CH<x>:AMPSVIAVOLTs:ENABLe {ON|OFF|<NR>}

CH<x>:AMPSVIAVOLTs:ENABLe?

Arguments

OFF turns current status off.

ON turns current status on.

<NR1> = 0 turns current status off; any other value turns current status on.

Examples

Ch1:AMPSVIAVOLTS:ENABLE ON will change the Ch1 measure current status as Yes.

CH<x>:AMPSVIAVOLTs :Factor

Sets or queries current factor . The value <x> can vary from 1 through 2 depending upon the channel .

Group

Vertical

Syntax

CH<x>:AMPSVIAVOLTs:FACTOR <NR3>

CH<x>:AMPSVIAVOLTs:FACTOR?

Arguments

<NR3> is the factor value.

Examples

CH<x>:AMPSVIAVOLTs:FACTOR 1 will set it as 1 A per volt measurement.

Ch1:AMPSVIAVOLTS:ENABLE ON will change the Ch1 measure current status as Yes.

CH<x>:BANdwidth

Sets or queries the selectable low-pass bandwidth limit filter setting of the specified instrument channel. The value of <x> can vary from 1 through 2 depending on instrument model.

This command is equivalent to setting the BW Limit option in the Vertical menu.

TBS1000C Series Digital Oscilloscopes Programmer Manual 52

C commands

Group

Vertical

Syntax

CH<x>:BANdwidth {TWEnty|FULl|<NR3>}

CH<x>:BANdwidth?

Arguments

TWEnty sets the upper bandwidth limit of channel <x> to 20 MHz.

FULl disables any optional bandwidth limiting. The specified channel operates at its maximum attainable bandwidth.

<NR3> is a double-precision ASCII string. The instrument rounds this value to an available bandwidth using geometric rounding, and then

uses this value to set the upper bandwidth limit.

NOTE. Other values may be possible depending on the attached probes.

Examples

CH1:BANDWIDTH TWENTY sets the bandwidth of channel 1 to 20 MHz.

CH1:BANDWIDTH? might return FULl. This indicates there is no bandwidth limiting on channel 1.

CH<x>:COUPling

Sets or queries the input attenuator coupling setting of the specified instrument channel. The value of <x> can vary from 1 through 2 depending on the instrument model.

This command is equivalent to setting the Coupling option in the Vertical menu.

Group

Vertical

Syntax

CH<x>:COUPling {AC | DC}

CH<x>:COUPling?

Arguments

AC sets the specified instrument channel to AC coupling.

DC sets the specified instrument channel to DC coupling.

Examples

CH1:COUPLING AC establishes AC coupling on channel 1.

CH2:COUPLING? might return :CH2:COUPling DC indicating that channel 2 is set to DC coupling.

CH<x>:DESKew

Sets or queries the deskew time for channel <x>, where x is the channel number. You can adjust the deskew time to add an independent, channel-based delay time to the delay (set by the horizontal position control and common to all channels) from the common trigger point to first sample taken for each channel. This lets you compensate individual channels for different delays introduced by their individual input hook ups.

TBS1000C Series Digital Oscilloscopes Programmer Manual 53

C commands

Group

Vertical

Syntax

CH<x>:DESKew <NR3>

CH<x>:DESKew?

Arguments

<NR3> is the deskew time for channel <x>, ranging from -100 ns to +100 ns with a resolution of 1 ns.

Examples

CH1 :DESKew 5.0E-9 sets the deskew time for channel 1 to 5 ns.

CH2:DESKew? might return :CH2:DESKEW 2.0000E-09 indicating that the deskew time for channel 2 is set to 2 ns.

CH<x>:INVert

Sets or queries the inversion state of the specified instrument channel. The value of <x> can vary from 1 through 2 depending on the instrument model.

This command is equivalent to setting the Invert option in the Vertical channel menus.

Group

Vertical

Syntax

CH<x>:INVert {ON|OFF}

CH<x>:INVert?

Arguments

ON inverts the specified instrument channel.

OFF sets the specified instrument channel to noninverted.

Examples

CH1:INVERT ON inverts the signal on channel 1.

CH2:INVERT? might return :CH2:INVERT 0, indicating that channel 2 is not inverted.

CH<x>:LABel

This command sets or queries the waveform label for channel<x>, where x is the channel number (1- 2).

Group

Vertical

Syntax

CH<x>:LABel <Qstring>

CH<x>:LABel?

TBS1000C Series Digital Oscilloscopes Programmer Manual 54

C commands

Arguments

<Qstring> is an alphanumeric string of text, enclosed in quotes, that contains the text level information for the channel<x>waveform. The text string is limited to 30 characters.

Examples

CH1:LABEL "ICCDATA" sets the label name of Channel 1 waveform output to ICCDATA.

CH1:LABEL? might return "ICCDATA", if the channel label was already set, else would return "" if not set.

CH<x>:OFFSet

Sets or queries the vertical offset for channel <x>, where x is the channel number.

This command offsets the vertical acquisition window (moves the level at the vertical center of the acquisition window) for the specified channel. Visualize offset as scrolling the acquisition window towards the top of a large signal for increased offset values, and scrolling towards the bottom for decreased offset values. The resolution of the vertical window sets the offset increment for this control.

Offset adjusts only the vertical center of the acquisition window for channel waveforms to help determine what data is acquired. The instrument always displays the input signal minus the offset value.

The channel offset range depends on the vertical scale factor. The valid ranges for the instrument are (when the probe and external attenuation factor is X1):

For V/Div settings from 2 mV/div to 200 mV/div, the offset range is +/- 0.8 V

For V/Div settings from 202 mV/div to 5 V/div, the offset range is +/- 20 V

Group

Vertical

Syntax

CH<x>:OFFSet <NR3>

CH<x>:OFFSet?

Related commands

CH<x>:POSition on page 55

Arguments

<NR3> is the offset value for the specified channel <x>.

Examples

CH1:OFFSet 2.0E-3 sets the offset for channel 1 to 2 mV.

CH2:OFFSet? might return : CH2:OFFSET 1.0000E-03 indicating that the offset for channel 2 is set to 1 mV.

CH<x>:POSition

Sets or queries the vertical position of the specified instrument channel. The value of <x> can vary from 1 through 2 depending on the instrument model.

The position voltage value is applied to the signal before digitization. Increasing the position value of a waveform causes the waveform to move up. Decreasing the position value causes the waveform to move down. The position value determines the vertical graticule coordinate at which input signal values, minus the present offset setting for that channel, are displayed. For example, if the position for Channel 1 is set to 2.0 and the offset is set to 3.0, then input signals equal to 3.0 units are displayed 2.0 divisions above the center of the screen (at 1 V/div).

TBS1000C Series Digital Oscilloscopes Programmer Manual 55

C commands

This command is equivalent to adjusting the front-panel VERTICAL POSITION knob.

Group

Vertical

Syntax

CH<x>:POSition <NR3>

CH<x>:POSition?

Related commands

CH<x>:OFFSet on page 55, REF<x>:VERTical:POSition? on page 138, MATH:VERtical:POSition on page 113

Arguments

<NR3> is the position in divisions from the center graticule for the specified channel. The range is 5 to -5 divisions.

Examples

CH2:POSITION 1.3E0 positions the channel 2 input signal 1.3 divisions above the center of the display.

CH1:POSITION? might return :CH1:POSITION -1.3000 indicating that the vertical position of Channel 1 is 1.3 divisions

below the center graticule.

CH<x>:PRObe

Returns all information concerning the probe attached to channel <x>, where x is the channel number. The value of <x> can vary from 1 through 2 depending on the instrument model.

Group

Vertical

Syntax

CH<x>:PRObe?

Examples

CH1:PROBE? might return No probe.

CH<x>:PRObe:GAIN

Sets or queries the gain factor for the probe attached to the channel specified by <x>, where x is the channel number. The gain of a probe is the output divided by the input transfer ratio. For example, a common 10x probe has a gain of 0.1.

Group

Vertical

Syntax

CH<x>:PRObe:GAIN <NR3>

CH<x>:PRObe:GAIN?

Related commands

CH<x>:SCAle on page 58

TBS1000C Series Digital Oscilloscopes Programmer Manual 56

C commands

Arguments

<NR3> is the probe gain. Allowed values depend on the specific probe.

Examples

CH1:PRObe:GAIN 0.1 sets the channel 1 probe gain to 0.1.

CH2:PROBE:GAIN? might return :CH2:PROBE:GAIN 0.1000E+00 indicating that the attached 10x probe delivers 1 V to the

channel 2 BNC for every 10 V applied to the probe input.

CH<x>:PRObe:ID?

Returns the type and serial number of the probe attached to channel <x>, where x is the channel number. Query only.

Group

Vertical

Syntax

CH<x>:PRObe:ID?

Examples

CH2:PROBE:ID? might return :CH2:PROBE:ID:TYPE "10X";SERNUMBER "N/A" indicating that a passive 10x probe of unknown serial number is attached to channel 2.

CH<x>:PRObe:ID:SERnumber?

Returns the serial number of the probe attached to channel <x>, where x is the channel number. Query Only.

Note: For Level 0 and 1 probes, the serial number will be "".

Group

Vertical

Syntax

CH<x>:PRObe:ID:SERnumber?

Examples

CH1:PROBE:ID:SERNUMBER? might return :CH1:PROBE:ID:SERNUMBER "B010289" indicating that the serial number of the probe attached to channel 1 is B010289.

CH<x>:PRObe:ID:TYPE?

Returns the type of probe attached to the channel specified by <x>, where x is the channel number. Level 2 (or higher) probes supply their exact product nomenclature; for Level 0 or 1 probes, a generic “No Probe Detected message is returned. Query Only.

Group

Vertical

Syntax

CH<x>:PRObe:ID:TYPE?

TBS1000C Series Digital Oscilloscopes Programmer Manual 57

C commands

Examples

CH1:PROBE:ID:TYPE? might return :CH1:PROBE:ID:TYPE "P6203" indicating that a P6203-type probe is attached to channel 1.

CH<x>:PRObe:SIGnal

Sets or queries the input bypass setting of a TekVPI probe attached to channel <x>, where x is the channel number. The probe must support input bypass, for example TCP0001. This command is ignored if sent to an unsupported probe.

Group

Vertical

Syntax

CH<x>:PRObe:SIGnal {BYPass|PASS}

CH<x>:PRObe:SIGnal?

Arguments

BYPass sets the probe to Bypass mode.

PASS sets the probe to Pass mode.

Examples

CH1:PRObe:SIGnal PASS set the probe attached to channel 1 to Pass mode.

CH1:PRObe:SIGnal? might return :CH1:PRObe:SIGnal PASS indicating that the probe attached to channel 1 is in Pass

mode

CH<x>:PRObe:UNIts?

Returns a string describing the units of measure for the probe attached to channel <x>, where x is the channel number. Query Only.

Group

Vertical

Syntax

CH<x>:PRObe:UNIts?

Examples

CH2:PROBE:UNITS? might return :CH4:PROBE:UNITS "V" indicating that the units of measure for the probe attached to channel 2 are volts.

CH<x>:SCAle

Sets or queries the vertical scale of the specified instrument channel. The value of <x> can vary from 1 through 2 depending on the instrument model.

Each waveform has a vertical scale parameter. For a signal with constant amplitude, increasing the Scale causes the waveform to be displayed smaller. Decreasing the scale causes the waveform to be displayed larger.

Scale affects all waveforms, but affects channel waveforms differently from other waveforms:

For channel waveforms, this setting controls the vertical size of the acquisition window as well as the display scale. The range and resolution of scale values depends on the probe attached and any other external factors you have specified.

TBS1000C Series Digital Oscilloscopes Programmer Manual 58

C commands

For reference and math waveforms, this setting controls the display only, graphically scaling these waveforms and having no affect on the acquisition hardware.

This command is equivalent to adjusting the front-panel VOLTS/DIV knob.

Group

Vertical

Syntax

CH<x>:SCAle <NR3>

CH<x>:SCAle?

Related Commands

CH<x>:OFFSet on page 55, CH<x>:POSition on page 55, REF<x>:VERTical:SCAle? on page 138, MATH:VERtical:SCAle on page 114

Arguments

<NR3> is the scale, in units-per-division. The value entered here is truncated to three significant digits.

Examples

CH1:SCALE 100E-3 sets the channel 1 gain to 100 mV/div.

CH2:SCALE? might return :CH2:SCALE 1.0000, indicating that the current V/div setting of channel 2 is 1 V/div.

CH<x>:VOLts

Sets or queries the vertical sensitivity of the specified channel. The value of <x> can vary from 1 through 2 depending on the instrument model.

This command is identical to the CH<x>:SCAle command and is included for compatibility purposes. Only CH<x>:SCAle is returned in response to a CH<x>? query.

Group

Vertical

Syntax

CH<x>:VOLts <NR3>

CH<x>:VOLts?

Arguments

<NR3> is the vertical sensitivity, in volts.

Examples

CH1:VOLts 1.0 sets channel 1 to 1 Volt per division.

CH1:VOLts? Might return CH1:VOLts 1.0 indication that the ch1 volts per division is 1 Volt per division.

CH<x>:YUNit

Sets or queries the units of the specified channel.

String arguments are case insensitive and any unsupported units will generate an error. Supported units are:

TBS1000C Series Digital Oscilloscopes Programmer Manual 59

C commands

%, /Hz, A, A/A, A/V, A/W, A/dB, A/s, AA, AW, AdB, As, B, Hz, IRE, S/s, V, V/A, V/V, V/W, V/dB, V/s, VV, VW, VdB, Volts, Vs, W, W/A, W/V, W/W, W/dB, W/s,WA, WV,WW, WdB, Ws, dB, dB/A, dB/V, dB/W, dB/dB, dBA, dBV, dBW, dBdB, day, degrees, div, hr, min, ohms, percent, s.

Group

Vertical

Syntax

CH<x>:YUNit <QString>

CH<x>:YUNit?

Arguments

<QString> is a string of text surrounded by quotes, specifying the supported units. This command is case insensitive.

Examples

CH2:YUNit "V" sets the units for channel 2 to Volts.

CH2:YUNIT might return CH2:YUNIT "V", indicating that the channel 2 units are volts.

CLEARMenu

Clears the current menu from the display. This command is equivalent to pressing the front panel Menu off. No query form.

Group

Miscellaneous

Syntax

CLEARMenu

Examples

CLEARMenu clears the current menu from the display.

*CLS

Command only, no query form. The *CLS command clears the following instrument status data structures:

• The Event Queue

• The Standard Event Status Register (SESR)

• The Status Byte Register (except the MAV bit)

If the *CLS command immediately follows an <EOI>, the Output Queue and MAV bit (Status Byte Register bit 4) are also cleared. MAV indicates information is in the output queue. The device clear (DCL) GPIB control message and the USBTMC INITIATE_CLEAR control message will clear the output queue and also MAV.

*CLS does not clear the output queue or MAV. *CLS can suppress a service request that is to be generated by an *OPC command. This will happen if a hard copy output or single sequence acquisition operation is still being processed when the *CLS command is executed. See Registers on page 182

Group

Status and Error

Syntax

*CLS

TBS1000C Series Digital Oscilloscopes Programmer Manual 60

C commands

Related Commands

DESE on page 73, *ESE on page 80, *ESR? on page 81, EVENT? on page 81, EVMsg? on page 82, *SRE on page 147, *STB?

on page 148

Examples

*CLS clears the instrument status data structures.

CURSor?

Returns current cursor settings. Query only.

Group

Cursor

Syntax

CURSor?

Returns

instrument cursor settings.

Examples

CURSor? might return the following string as the current cursor settings: :CURSOR:FUNCTION SCREEN;HBARS:POSITION1 0.0000;POSITION2 0.0000;UNITS BASE;:CURSOR:MODE INDEPENDENT;VBARS:POSITION1 -19.0006E-6;POSITION2 -18.9994E-6;UNITS SECONDS.

CURSor:ENABLE

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.

Group

Miscellaneous

Syntax

CURSor:ENABLE {ON | OFF}

CURSor:ENABLE?

Related commands

CURSor

FEAEN:PASSWORD on page 83

Arguments

ON enables the cursor feature.

OFF disables the cursor feature.

Examples

CURSOR:ENABLE OFF disables cursor.

CURSOR:ENABLE? might return 1 indicating that cursor is enabled.

TBS1000C Series Digital Oscilloscopes Programmer Manual 61

C commands

CURSor:FUNCtion

Sets or queries the instrument cursor type. Cursors are attached to the selected waveform in Waveform mode and are attached to the display area in Screen mode.

Group

Cursor

Syntax

CURSor:FUNCtion{OFF|SCREEN|WAVEform|VBArs|HBArs}

CURSor:FUNCtion?

Arguments

OFF removes the cursors from the display but does not change the cursor type.

SCREEN specifies both horizontal and vertical bar cursors, which measure the selected waveform in horizontal and vertical units. Use

these cursors to measure anywhere in the waveform display area.

WAVEform specifies paired cursors in YT display format for measuring waveform amplitude and time. In XY and XYZ format, these cursors indicate the amplitude positions of an XY pair (Ch1 vs Ch2 voltage, where Ch1 is the X axis and Ch2 is the Y axis) relative to the trigger.

VBArs specifies the vertical bar cursor to measure the selected waveform in vertical units.

HBArs specifies the horizontal bar cursor to measure the selected waveform in horizontal units.

Examples

CURSOR:FUNCTION WAVEFORM selects the paired cursors for measuring waveform amplitude and time.

CURSOR:FUNCTION? might return :CURSor:FUNCtion SCREEN indicating that the screen cursors are currently selected.

CURSor:HBArs?

Returns the settings for the instrument horizontal bar cursors. Query only.

Group

Cursor

Syntax

CURSor:HBArs?

Returns

Current horizontal bar cursor settings.

Examples

CURSor:HBArs? might return the horizontal bar setting as return the horizontal bar setting as CURSOR:HBARS:DELTA 0.0E +0;POSITION1 320.0000E+0;POSITION2 320.0000E+0;UNITS BASE.

TBS1000C Series Digital Oscilloscopes Programmer Manual 62

C commands

CURSor:HBArs:DELTa?

Returns the difference (in vertical units) between the two horizontal bar cursors in the instrument display. Query only.

Group

Cursor

Syntax

CURSor:HBArs:DELTa?

Related commands

CURSor:HBArs:UNIts on page 64

Returns

<NR3> is the difference between the horizontal bar cursors.

Examples

CURSOR:HBARS:DELTA? might return :CURSOR:HBARS:DELTA 5.0800E+00 indicating that the difference between the two cursors is 5.08.

CURSor:HBArs:POSITION<x>

Sets or returns the horizontal bar cursor position relative to ground, which is expressed in vertical units (usually volts). The cursor is specified by x, which can be 1 or 2.

Group

Cursor

Syntax

CURSor:HBArs:POSITION<x> <NR3>

CURSor:HBArs:POSITION<x>?

Related commands

CURSor:FUNCtion on page 62

Arguments

<NR3> specifies the horizontal bar cursor position, relative to ground (in volts when the units are volts and amps when the units are amps), relative to the center of the screen (in divs when units are divisions), or relative to 1 V RMS (in decibels when the source is an FFT math waveform), for the waveform specified by the CURSor:SELect:SOUrce command.

The cursor position is limited to the graticule whenever an attempt is made to move it outside the graticule.

Note: The source determines the measurement units.

Examples

CURSOR:HBARS:POSITION1 25.0E-3 positions Cursor 1 of the horizontal cursors at 25 mV.

CURSOR:HBARS:POSITION2? might return :CURSOR:HBARS:POSITION2 -64.0000E-03 indicating that Cursor 2 of

the horizontal bar cursors is at -64 mV.

TBS1000C Series Digital Oscilloscopes Programmer Manual 63

C commands

CURSor:HBArs:UNIts

Sets or queries the vertical scale units for the selected cursor source waveform.

Group

Cursor

Syntax

CURSor:HBArs:UNIts {BASe|PERcent}

CURSor:HBArs:UNIts?

Arguments

BASe selects the vertical units for the selected waveform.

PERcent selects ratio cursors.

Examples

CURSor:HBArs:UNIts? might return :CURSOR:HBARS:UNITS BASE indicating that the units for the horizontal bar cursors are base.

CURSor:HBArs:USE

Sets the horizontal bar cursor measurement scale. This command is only applicable when ratio cursors are on. No query form.

Group

Cursor

Syntax

CURSor:HBArs:USE {CURrent | HALFgrat | FIVEdivs}

Related commands

CURSor:HBArs:UNIts on page 64

Arguments

CURrent sets the H Bar measurement scale so that 0% is the current position of the lowest H Bar cursor and 100% is the current position of the highest H Bar cursor.

HALFgrat resets the H bar measurement scale to half the number of divisions (five for some models and four for others) so that 25% is the current position of the lowest H Bar cursor and 75% is the current position of the highest H Bar.

FIVEdivs sets H Bar measurement scale so that five screen major divisions is 100%, where 0% is –2.5 divisions and 100% is +2.5 divisions from the center horizontal graticule.

Examples

CURSOR:HBARS:USE FIVEDIVS sets the H Bar measurement scale so that 5 screen major divisions equals 100%.

CURSor:MODe

Sets or returns whether the two cursors move linked together in unison or separately. This applies to the Waveform cursors display mode.

Conditions

This command is only applicable when waveform cursors are displayed.

TBS1000C Series Digital Oscilloscopes Programmer Manual 64

C commands

Group

Cursor

Syntax

CURSor:MODe {TRACk|INDependent}

CURSor:MODe?

Arguments

TRACk ties the navigational functionality of the two cursors together. For cursor 1 adjustments, this ties the movement of the two cursors together; however, cursor 2 continues to move independently of cursor 1.

INDependent allows independent adjustment of the two cursors.

Examples

CURSOR:MODE TRACK specifies that the cursor positions move in unison.

CURSOR:MODE? might return :CURSOR:MODE TRACK indicating that the two cursors move in unison.

CURSor:VBArs?

Returns the current vertical bar cursor horizontal position and units settings. Query only.

Group

Cursor

Syntax

CURSor:VBArs?

Examples

CURSor:VBArs? might return CURSOR:VBARS:POSITION1 -7.680E-6;POSITION2 7.680E-6;DELTA

15.3600E-6;HPOS1 0.0E+0;HPOS2 0.0E+0;UNITS SECONDS;VDELTA 0.0E+0.

CURSor:VBArs:ALTERNATE<x>?

Returns the alternate readout for the waveform (Vbar) cursors specified by <x>. This alternate readout is in effect for a bus waveform. Query only.

Group

Cursor

Syntax

CURSor:VBArs:ALTERNATE<x>?

Arguments

X = 1 specifies vertical bar cursor 1.

X = 2 specifies vertical bar cursor 2.

Examples

CURSor:VBArs:ALTERNATE1? might return 1.001 indicating the vertical bar cursor 1 readout is 1.001.

TBS1000C Series Digital Oscilloscopes Programmer Manual 65

C commands

CURSor:VBArs:DELTa?

Returns the time or frequency difference between the two vertical bar cursors. The units (seconds or Hertz) are specified by the CURSor:VBArs:UNIts command. If the cursor source is an FFT math waveform, CURSor:VBArs:DELTa is always in Hertz, regardless of the value set by CURSor:VBArs:UNIts. Query only.

Note: If Trigger View is active, this query returns 9.9E37 and generates event 221 (Settings conflict).

Group

Cursor

Syntax

CURSor:VBArs:DELTa?

Returns

<NR3>

Examples

CURSor:VBArs:DELTa? might return 8.92E-1, indicating that the time difference between the vertical bar cursors is

0.892 seconds.

CURSor:VBArs:HPOS<x>?

Returns the horizontal value of the specified vertical bar ticks for cursor <x>. The units are specified by the CURSor:HBArs:UNIts query. <x> specifies the cursor. Valid values are 1 and 2. Query only.

Group

Cursor

Syntax

CURSor:VBArs:HPOS<x>?

Related Commands

CURSor:HBArs:UNIts on page 64

Returns

<x> indicates the cursor. Valid values are 1 and 2.

Examples

CURSOR:VBARS:HPOS1? might return CURSOR:VBARS:HPOS2 100E-3, indicating the value of one vertical bar tick.

CURSor:VBArs:POSITION<x>

Positions a vertical bar cursor. The unit is specified by the CURSor:VBArs:UNIts command, and can be in units of seconds or frequency (Hertz). If the cursor source is an FFT math waveform, CURSor:VBArs:POSITION is always in Hertz, regardless of the value set by CURSor:VBArs:UNIts.

Note: If Trigger View is active, the query form returns 9.9E37 and generates event 221 (Settings conflict).

TBS1000C Series Digital Oscilloscopes Programmer Manual 66

C commands

Group

Cursor

Syntax

CURSor:VBArs:POSITION<x>

CURSor:VBArs:POSITION<x>?

Arguments

<x> specifies which cursor to position. Correct values are 1 and 2.

<NR3> specifies the cursor position in the units specified by the CURSor:VBArs:UNIts command. The position is relative to the trigger

except when the cursor source is a math FFT waveform. The cursor position is limited to the graticule whenever an attempt is made to move it outside the graticule.

Examples

CURSOR:VBARS:POSITION2 9.00E-6 positions the second vertical bar cursor at 9ms.

CURSOR:VBARS:POSITION1? might return 1.00E-6, indicating the first vertical bar cursor is at 1 μs.

CURSor:VBArs:UNIts

Sets or queries the units for the vertical bar cursors.

Note: When Trigger View is active, CURSor:VBArs:UNIts? generates event 221(Settings conflict).

Group

Cursor

Syntax

CURSor:VBArs:UNIts

CURSor:VBArs:UNIts?

Arguments

SECOnds specifies units of time.

HERtz specifies units of frequency (reciprocal of time).

Examples

CURSor:VBArs:UNIts SECONDS sets the units for the vertical bar cursors to seconds.

CURSor:VBArs:UNIts? returns HERTZ when the vertical bar cursor units are Hertz.

CURSor:VBArs:VDELTa?

Returns the vertical (amplitude) difference between the two vertical bar cursors. The units are specified by the CURSor:HBArs:UNits query. Query only.

Group

Cursor

TBS1000C Series Digital Oscilloscopes Programmer Manual 67

C commands

Syntax

CURSor:VBArs:VDELTa?

Related commands

CURSor:HBArs:UNIts on page 64

Returns

<NR3> indicates the vertical difference between the two vertical bar cursors.

Examples

CURSor:VBArs:VDELTa? might return :CURSOR:VBARS:VDELTA 1.064E+0, indicating that the vertical difference between the vertical bar cursors is 1.064 units.

CURVe

Transfers instrument waveform data to and from the instrument in binary or ASCII format. Each waveform that is transferred has an associated waveform preamble that contains information such as data format, scale, and associated information.

For analog waveforms, the CURVe? query sends data from the instrument to an external device. The data source is specified by the DATa:SOUrce command. The first and last data points that are transferred are specified by the DATa:STARt and DATa:STOP commands.

Note: If the waveform specified by the DATa:SOUrce command is not displayed, the CURVe? query returns nothing, and generates events 2244 (Waveform requested is not activated) and 420 (Query UNTERMINATED).

The instrument returns data from the last acquisition if the source is a channel waveform that is being previewed. The data does not reflect the acquisition preview parameters. Your should always follow acquisition parameter changes with a single sequence OPC command prior to CURVe? to ensure the return data reflects the new acquisition parameters.

The CURVe command transfers waveform data from an external device to the instrument. The data is stored in the waveform location specified by DATa:DESTination, starting with the data point specified by DATa:STARt. Only one waveform can be transferred at a time. The waveform will only be displayed if the reference waveform is displayed.

Refer to Waveform Commands for a description of the waveform transfer process. Waveform command group on page 35

Group

Waveform

Syntax

CURVe {<Block>|<asc curve>}

CURVe?

Related Commands

DATa on page 70, DATa:STARt on page 71, DATa:STOP on page 72, WFMInpre? on page 165, WFMInpre:BYT_Nr on page 166, WFMOutpre? on page 171, HEADer on page 96

Arguments

<Block> is the waveform data in binary format. The waveform is formatted as:

#<x><yyy><data><newline>, where:

<x> is the number of y bytes. For example, if <yyy>=500, then <x>=3.

TBS1000C Series Digital Oscilloscopes Programmer Manual 68

C commands

<yyy> is the number of bytes to transfer if samples are one or two bytes wide. Use the WFMInpre:BYT_Nr command to set the width for waveforms transferred into the instrument. Use WFMOutpre:BYT_Nr to set the width for waveforms transferred out from the instrument.

<data> is the curve data.

<newline> is a single byte new line character at the end of the data.

<asc curve> is the waveform data in ASCII format. The format for ASCII data is <NR1>[,<NR1>...] where each <NR1>

represents a data point.

Examples

CURVe? with ASCII encoding, start and stop of 1 and 10 respectively, and a width set to 1 might return the following ASCII data:

:CURVE 61,62,61,60,60,-59,-59,-58,-58,-59.

TBS1000C Series Digital Oscilloscopes Programmer Manual 69

D commands

This section lists commands and queries that begin with the letter D.

DATa

Sets or queries the format and location of the waveform data that is transferred with the CURVe command.

Group

Waveform

Syntax

DATa {INIT|SNAp}

DATa?

Related Commands

CURVe on page 68, DATa:STARt on page 71, DATa:STOP on page 72, WFMInpre:NR_Pt? on page 167, WFMOutpre:NR_Pt?

on page 174

Arguments

D commands

INIT reinitializes the waveform data settings to their factory defaults except for DATa:STOP, which is set to the current acquisition record length.

SNAp sets DATa:STARt and DATa:STOP to match the current waveform cursor positions.

Examples

DATa INIT initializes the waveform data settings to their factory defaults.

DATa? might return :DATA:DESTINATION REF1:ENCDG RIBINARY;SOURCE CH1;START 1;STOP 500;WIDTH

DATa:DESTination

Sets or queries the reference memory location for storing waveform data that is transferred into the instrument by the CURVe command.

Group

Waveform

Syntax

DATa:DESTination REF<x>

DATa:DESTination?

Related Commands

CURVe on page 68

Arguments

REF<x> is the reference memory location where the waveform will be stored.

Examples

DATa:DESTination REF1 stores incoming waveform data into reference memory 1.

TBS1000C Series Digital Oscilloscopes Programmer Manual 70

D commands

DATa:DESTination? might return :DATA:DESTINATION REF2 indicating that reference 2 is the currently selected reference memory location for incoming waveform data.

DATa:SOUrce

Sets or queries which waveform will be transferred from the instrument by the CURVe? query. You can transfer only one waveform at a time.

Group

Waveform

Syntax

DATa:SOUrce{CH1|CH2| MATH|REF1|REF2}

DATa:SOUrce?

Related Commands

CURVe on page 68

Arguments

CH1– CH2 specifies which analog channel data will be transferred from the instrument to the controller, channels 1 through 2.

MATH specifies that the math waveform data will be transferred from the instrument to the controller.

REF1–REF2 specifies which reference waveform data will be transferred from the instrument to the controller, waveforms, 1 or 2.

Examples

DATA:SOURCE CH1 specifies that the channel 1 waveform will be transferred in the next CURVe? query.

DATa:SOUrce REF1 specifies that reference waveform REF1 will be transferred in the next CURVe? query.

DATa:SOUrce? might return :DATA:SOURCE REF2 indicating that the source for the waveform data which is transferred using a CURVe? query is reference 2.

DATa:STARt

Sets or queries the starting data point for incoming or outgoing waveform transfer. This command lets you transfer partial waveforms to and from the instrument.

Group

Waveform

Syntax

DATa:STARt <NR1>

DATa:STARt?

Related Commands

CURVe on page 68, DATa on page 70, DATa:STOP on page 72, WFMInpre:NR_Pt? on page 167, WFMOutpre:NR_Pt? on page 174

Arguments

<NR1> is the first data point that will be transferred, which ranges from 1 to the record length. Data will be transferred from <NR1> to DATa:STOP or the record length, whichever is less. If <NR1> is greater than the record length, the last data point in the record is

TBS1000C Series Digital Oscilloscopes Programmer Manual 71

D commands

transferred. DATa:STARt and DATa:STOP are order independent. When DATa:STOP is greater than DATa:STARt, the values will be swapped internally for the CURVE? query.

Examples

DATa:STARt 10 specifies that the waveform transfer will begin with data point 10.

DATa:STARt? might return :DATA:START 214 indicating that data point 214 is the first waveform data point that will be

transferred.

DATa:STOP

Sets or queries the last data point in the waveform that will be transferred when using the CURVe? query. This lets you transfer partial waveforms from the instrument

Changes to the record length value are not automatically reflected in the DATa:STOP value. As record length is varied, the DATa:STOP value must be explicitly changed to ensure the entire record is transmitted. In other words, curve results will not automatically and correctly reflect increases in record length if the distance from DATa:STARt to DATa:STOP stays smaller than the increased record length.

When using the CURVe command, the instrument stops reading data when there is no more data to read.

Group

Waveform

Syntax

DATa:STOP <NR1>

DATa:STOP?

Related Commands

CURVe on page 68, DATa on page 70, DATa:STOP on page 72, WFMInpre:NR_Pt? on page 167, WFMOutpre:NR_Pt? on page 174

Arguments

<NR1> is the last data point that will be transferred, which ranges from 1 to the record length. If <NR1> is greater than the record length, then data will be transferred up to the record length. If both DATa:STARt and DATa:STOP are greater than the record length, the last data point in the record is returned.

DATa:STARt and DATa:STOP are order independent. When DATa:STOP is less than DATa:STARt, the values will be swapped internally for the CURVE? query.

If you always want to transfer complete waveforms, set DATa:STARt to 1 and DATa:STOP to the maximum record length, or larger.

Examples

DATa:STOP 15000 specifies that the waveform transfer will stop at data point 15000.

DATa:STOP? might return :DATA:STOP 14900 indicating that 14900 is the last waveform data point that will be transferred.

DATa:WIDth

Sets or queries the number of bytes per data point in the waveform transferred using the CURVe command.

TBS1000C Series Digital Oscilloscopes Programmer Manual 72

D commands

Group

Waveform

Syntax

DATa:WIDth <NR1>

DATa:WIDth?

Related Commands

CURVe on page 68

Arguments

<NR1> = 1 sets the number of bytes per waveform data point to 1 byte (8 bits).

<NR1> = 2 sets the number of bytes per waveform data point to 2 bytes (16 bits). If DATa:WIDth is set to 2, the least significant byte

is always zero. This format is useful for AVErage waveforms.

Examples

DATa:WIDth 1 sets the data width to 1 byte per data point for CURVe data.

DATE

Sets or queries the instrument date value. The instrument uses these values to time stamp files saved to the USB flash drive, as well as show the time and date on the instrument display.

Group

Miscellaneous

Syntax

DATE

DATE?

Related Commands

TIMe on page 149

Arguments

<QString> is a date in the form "yyyy-mm-dd".

Examples

DATE "2010-05-06" sets the date to May 6th, 2010.

DATE? might return :DATE 2015-10-29 indicating that the current date is set to Oct. 29, 2015.

DESE

Sets or queries the bits in the Device Event Status Enable Register (DESER). The DESER is the mask that determines whether events are reported to the Standard Event Status Register (SESR), and entered into the Event Queue. For a detailed discussion of the use of these registers, see Registers.

Group

Status and Error

TBS1000C Series Digital Oscilloscopes Programmer Manual 73

D commands

Syntax

DESE <NR1>

DESE?

Related Commands

*CLS on page 60, *ESE on page 80, *ESR? on page 81, EVENT? on page 81, EVMsg? on page 82, *SRE on page 147, *STB?

on page 148

Arguments

<NR1> is an integer value in the range from 0 to 255. The binary bits of DESER are set according to this value. For example, DESE 209 sets the DESER to the binary value 11010001 (that is, the most significant bit in the register is set to 1, the next most significant bit to 1, the next bit to 0, and so on).

The power-on default for DESER is all bits set to 1 if *PSC is 1. If *PSC is 0, the DESER maintains its value through a power cycle.

Note: Setting DESER and ESER to the same value allows only those codes to be entered into the Event Queue and summarized on the ESB bit (bit 5) of the Status Byte Register. Use the *ESE command to set ESER. For more information on event handling, refer to the Status and Events section.

Examples

DESE 209 sets the DESER to binary 11010001, which enables the PON, URQ, EXE, and OPC bits.

DESE? might return the following string :DESE 186 , showing that DESER contains the binary value 10111010.

DIAg:FAN

Returns the currently set PWM fan value. Only query.

Group

Calibration and diagnostic

Syntax

DIAg:FAN?

Examples

DIAG:FAN? might return PWM=10, VOL=7.4V.

DIAg:LOOP:OPTion

Sets the self-test loop option.

Group

Calibration and diagnostic

Syntax

DIAg:LOOP:OPTion {ALWAYS|FAIL|ONFAIL|ONCE|NTIMES}

Arguments

ALWAYS continues looping until the self tests (diagnostics) are stopped via the front panel or by an instrument command.

FAIL causes looping until the first self test (diagnostic) failure or until self tests (diagnostics) are stopped.

ONFAIL causes looping on a specific test group as long as a FAIL status is returned from the test.

TBS1000C Series Digital Oscilloscopes Programmer Manual 74

ONCE executes self test (diagnostics test) sequence once.

NTIMES runs “n” number of loops.

Examples

DIAg:LOOP:OPTion ONCE sets diagnostics to run one loop of self tests.

DIAg:LOOP:OPTion:NTIMes

Sets the self-test loop option to run N times.

Group

Calibration and diagnostic

Syntax

DIAg:LOOP:OPTion:NTIMes <NR1>

DIAg:LOOP:OPTion:NTIMes?

Arguments

<NR1> is the number of self-test loops.

D commands

Examples

DIAG:LOOP:OPTION:NTIMES 3 sets the self-test loop to run three times.

DIAG:LOOP:OPTION:NTIMES? might return :DIAG:LOOP:OPTION:NTIMES 5, indicating that the self-test loop is set to

run five times.

DIAg:LOOP:STOP

Stops the self-test at the end of the current loop. No query form.

Group

Calibration and diagnostic

Syntax

DIAg:LOOP:STOP

Examples

DIAG:LOOP:STOP stops the self test at the end of the current loop.

DIAg:RESUlt:FLAg?

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). Use the DIAg:RESUlt:LOG? query to determine which test(s) has failed. Query only.

Group

Calibration and Diagnostic

Syntax

DIAg:RESUlt:FLAg?

TBS1000C Series Digital Oscilloscopes Programmer Manual 75

D commands

Returns

PASS means that the instrument passes all selected diagnostic tests.

FAIL means that the instrument has failed at least one of the diagnostic tests.

Examples

DIAg:RESUlt:FLAG

Returns either PASS or FAIL.

DIAg:RESUlt:LOG?

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). The list contains all modules and module interfaces that were tested with the pass or fail status of each. Query only.

Group

Calibration and Diagnostic

Syntax

DIAg:RESUlt:LOG?

Returns

<QString> in the following format:

<Status>,<Module name>[,<Status>,<Module name>...]

Examples

DIAg:RESUlt:LOG? might return :DIAG:RESULT:LOG "NOT RUN--CPU,NOT RUN--DISPLAY,NOT RUN-FPANEL,NOT RUN--IO,NOT RUN--ACQ,NOT RUN--RO M,NOT RUN--APPKEY" for power-up diagnostics.

DIAg:SELect

Sets the type of diagnostics grouping. No query form.

Group

Calibration and diagnostic

Syntax

DIAg:SELect {ALL|APPKey|CPU|DISplay|FPAnel|IO|ROM|ACQ}

Arguments

ALL runs all diagnostic groups.

CPU runs just the CPU diagnostic group.

DISplay runs just the display circuit diagnostic group.

FPAnel runs just the front panel diagnostic group.

IO runs just the IO board diagnostic group.

ROM runs just the IO board diagnostic group.

ACQ runs just the acquisition system diagnostic group.

TBS1000C Series Digital Oscilloscopes Programmer Manual 76

Examples

DIAg:SELect ALL runs all diagnostic groups.

DIAg:SELect:<function>

Runs self-tests on the specified system subsystem. No query form.

Group

Calibration and diagnostic

Syntax

DIAg:SELect:<function>

Arguments

<function> specifies a single instrument subsystem on which to run self tests (diagnostics). Valid values are:

• ACQ tests the acquisition system.

• CPU tests the CPU.

• DISplay tests the display.

• FPAnel tests the front panel controls.

• IO tests the IO ports.

• ROM tests the system read only memory.

D commands

Examples

DIAg:SELect:ACQ specifies to run self tests on the acquisition system.

DIAg:STATE

This command starts or stops the instrument self-test. Depending on the argument, self-test capabilities are either turned on or off. No query form.

Group

Calibration and diagnostic

Syntax

DIAg:STATE {EXECute|ABORt}

Arguments

EXECute starts diagnostics.

ABORt stops diagnostics at the end of the current loop.

Examples

DIAG:STATE EXECute starts diagnostics.

DIAg:TEMPVAL

Read out the currently FPGA chip and ambient temperature. Only query.

Group

Calibration and diagnostic

TBS1000C Series Digital Oscilloscopes Programmer Manual 77

Syntax

DIAg:TEMPVAL?

Examples

DIAG:TEMPVAL? might return: VDC Temp=-256, Ambient Temp=32

DISplay:GRAticule

Sets and returns the display graticule intensity settings.

Group

Miscellaneous

Syntax

DISplay:GRAticule {<NR1>|ON|OFF}

DISplay:GRAticule?

Arguments

ON or <NR1> ≠ 0 turns on the graticule in the screen display.

D commands

OFF or <NR1> = 0 turns off the graticule in the screen display.

Examples

DISPLAY:GRATICULE 0 sets NO graticule to display.

DISPLAY:GRATICULE? might return :DISPLAY:GRATICULE 1 indicating that the graticule is on.

DISplay:INTENSITy:BACKLight

Sets and returns the waveform backlight intensity settings.

Group

Miscellaneous

Syntax

DISplay:INTENSITy:BACKLight <NR1>

DISplay:INTENSITy:BACKLight ? <NR1>

Arguments

<NR1> specifies the range from 10 to 100 .

Examples

DISplay:INTENSITy:BACKLight <NR1>

DISPLAY:INTENSITY:BACKLIGHT? might return :DISPLAY:INTEnsITY:BACKLIGHT 60

TBS1000C Series Digital Oscilloscopes Programmer Manual 78

D commands

DISplay:PERSistence:STATe

Sets or returns the display persistence to ON or OFF. The query form returns the persistence state. This affects the display only.

Group

Display

Syntax

DISplay:PERSistence:STATe {ON | OFF | <NR1>}

DISplay:PERSistence:STATe?

Arguments

ON turns on the persistence on for the display.

OFF turns the persistence off for the display.

<NR1>=0 turns off the persistence for the display; any other value turns on the persistence for the display.

Examples

DISplay:PERSistence:STATe ON turns on the persistence on the display for all waveforms.

DISplay:PERSistence:STATe? might return 1 indicating that the persistence is ON for the display.

DISplay:PERSistence:VALUe

Sets the value of persistence if the persistence state is set to on. This affects the display only.

Group

Display

Syntax

DISplay:PERSistence:VALUe {<NR3> | AUTO | INFInite}

DISplay:PERSistence:VALUe?

Arguments

<NR3> specifies the time of the persistence.

INFInite displays waveform points until a control change resets the acquisition system. When persistence is set to infinite, it does not mean that the brightness of any pixel should never decrease. The brightness of a pixel is proportionally dependent on the ratio between the intensity, which does NOT decrease at infinite persistence, and the maximum value of intensity of any pixel on the screen. Thus, if a particular pixel gets hit less often than others, its brightness will decrease over time. It will become less bright relative to the pixels that get hit often. AUTO specifies that the oscilloscope automatically determines the best waveform persistence based on the value of waveform intensity (DISPLAY:INTENSITY:WAVEFORM)

Examples

DISplay:PERSistence:VALUe 3 specifies that the waveform points are displayed fading for 3 seconds before they completely disappear.

TBS1000C Series Digital Oscilloscopes Programmer Manual 79

E commands

This section lists commands and queries that begin with the letter E.

ERRLOG:FIRST?

Returns the first entry in the error log, or an empty string if the error log is empty. Use this command with ERRLOG:NEXT? to retrieve error log messages. Query only.

Group

Calibration and Diagnostic

Syntax

ERRLOG:FIRST?

Returns

Refer to the service manual for your instrument for information about error log message format.

ERRLOG:NEXT?

Returns the next entry in the error log, or an empty string if the error log is empty or you have reached the end of the log. To start at the top of the error log, run the ERRLOG:FIRST? query to return the first error log message. Then use the ERRLOG:NEXT? query to step through the error log. Query only.

Group

Calibration and Diagnostic

Syntax

ERRLOG:NEXT?

Returns

Refer to the service manual for your instrument for information about error log message format.

*ESE

Sets and queries the bits in the Event Status Enable Register (ESER). The ESER prevents events from being reported to the Status Byte Register (STB). For a detailed discussion on how to use registers, see Registers. Command only, no query form.

Group

Status and Error

Syntax

*ESE <NR1>

*ESE?

Related Commands

*CLS on page 60, DESE on page 73, *ESR? on page 81, EVENT? on page 81, EVMsg? on page 82, *SRE on page 147, *STB?

on page 148

Arguments

<NR1> is a value in the range from 0 through 255. The binary bits of the ESER are set according to this value.

TBS1000C Series Digital Oscilloscopes Programmer Manual 80

E commands

The power-on default for ESER is 0 if *PSC is 1. If *PSC is 0, the ESER maintains its value through a power cycle.

Note: Setting the DESER and the ESER to the same value allows only those codes to be entered into the Event Queue and summarized on the ESB bit (bit 5) of the Status Byte Register. Use the DESE command to set the DESER. SeeEvent Handling

Sequence on page 185.

Examples

*ESE 209 sets the ESER to binary 11010001, which enables the PON, URQ, EXE, and OPC bits.

*ESE? might return the string *ESE 186, showing that the ESER contains the binary value 10111010.

*ESR?

Returns the contents of the Standard Event Status Register (SESR). *ESR? also clears the SESR (since reading the SESR clears it). For a detailed discussion on how to use registers, see Registers. Query only.

Group

Status and Error

Syntax

*ESR?

Related Commands

ALLEv? on page 46, *CLS on page 60, DESE on page 73, *ESE on page 80, EVENT? on page 81, EVMsg? on page 82, *OPC

on page 133, *SRE on page 147, *STB? on page 148

Returns

Contents of the Standard Event Status Register.

Examples

*ESR? might return the value 213, showing that the SESR contains binary 11010101.

EVENT?

Returns from the Event Queue an event code that provides information about the results of the last *ESR? read. EVENT? also removes the returned value from the Event Queue. Query only.

Group

Status and Error

Syntax

EVENT?

Related Commands

ALLEv? on page 46, *CLS on page 60, DESE on page 73, *ESE on page 80, *ESR? on page 81, EVMsg? on page 82, *SRE

on page 147, *STB? on page 148

Returns

<NR1> the last *ESR.

Examples

EVENT? might return EVENT 110, indicating there was an error in a command header.

TBS1000C Series Digital Oscilloscopes Programmer Manual 81

E commands

EVMsg?

Removes from the Event Queue a single event code associated with the results of the last *ESR? read, and returns the event code with an explanatory message. Query only.

Group

Status and Error

Syntax

EVMsg?

Related Commands

ALLEv? on page 46, *CLS on page 60, DESE on page 73, *ESE on page 80, *ESR? on page 81, EVENT? on page 81, *SRE on page 147, *STB? on page 148

Returns

The event code and message in the following format:

<Event Code><Comma><QString>[<Event Code><Comma> <QString>...]

<QString>::= <Message>;[<Command>]

where <Command> is the command that caused the error and may be returned when a command error is detected by the instrument. As much of the command as possible is returned without exceeding the 60 character limit of the <Message> and <Command> strings combined. The command string is right-justified.

Examples

EVMsg? might return the message EVMSG 110, "Command header error"

EVQty?

Returns the number of event codes that are in the Event Queue. This is useful when using ALLEv? since it lets you know exactly how many events will be returned. Query only.

Group

Status and Error

Syntax

EVQty?

Related Commands

ALLEv? on page 46, EVENT? on page 81, EVMsg? on page 82

Returns

<NR1> is the number of event codes in the Event Queue.

Examples

EVQty? might return :EVQTY 3 indicating the number of event codes in the Event Queue is 3.

TBS1000C Series Digital Oscilloscopes Programmer Manual 82

F commands

This section lists commands and queries that begin with the letter F.

FACtory

Resets the instrument to its factory default settings. Refer to Appendix B: Factory Setup for a list of the factory default settings. No query.

This command does the following:

• Clears the Event Status Enable Register

• Clears the Service Request Enable Register

• Sets the Device Event Status Enable Register to 255

• Purges all defined aliases

• Enables all Command Headers

• Sets the macro defined by *DDT to a "zero-length field

• Clears the pending operation flag and associated operations

This command does not reset the following:

• Communication settings

• Sate of the VXI-11 (Ethernet IEEE Std 488.2) interface

• Calibration data that affects device specifications

• Protected user data

• Stored settings

• Power On Status Clear Flag

• instrument password

Group

Save and Recall

Syntax

FACtory

Related Commands

*PSC on page 134, *RCL on page 135, RECAll:SETUp on page 135, *RST on page 138, *SAV on page 140, SAVe:SETUp on page 142, SAVe:IMAge:FILEFormat on page 141

Examples

FACTORY resets the instrument to its factory default settings. Refer to Factory Setup.

FEAEN:PASSWORD

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. No query form. To access the menu, refer product user manual.

Group

Miscellaneous

TBS1000C Series Digital Oscilloscopes Programmer Manual 83

F commands

Syntax

FEAEN:PASSWORD <password>

Related Commands

AUTOSet:ENABLE on page 47

CURSor:ENABLE on page 61

MEASUrement:ENABLE

Arguments

<password> is the feature enable password, enclosed in quotes.

Examples

FEAEN:PASSWORD "111111" allows the user to change the settings of Feature Enable if the feature enable password matches the string "111111".

FFT?

Returns all FFT parameters. Query only.

Group

FFT

Syntax

FFT?

Related commands

FFT:VERTical:SCAle on page 86, FFT:VERTical:POSition on page 86, FFT:VERTical:UNIts on page 87, FFT:HORizontal:SCAle

on page 85, FFT:HORizontal:POSition on page 84 , FFT:SOURce on page 85, FFT:SRCWFM on page 85, FFT:WINdow on page 87,

SELect:FFT on page 145

Examples

FFT? might return 1; CH1; 20; 0.000; "dB"; 250.000E+3; 750.000E+3; "Hz";1;HANNING;X1;DB

FFT:HORizontal:POSition

Sets or queries the FFT horizontal display position.

Group

FFT

Syntax

FFT:HORizontal:POSition <NR3>

FFT:HORizontal:POSition?

Arguments

<NR3> is the FFT horizontal display position.

Examples

FFT:HORizontal:POSition 750.0E+3 sets the FFT horizontal position to 750.0E+3.

TBS1000C Series Digital Oscilloscopes Programmer Manual 84

FFT:HORizontal:POSition? might return 750.000E+3.

FFT:HORizontal:SCAle

Sets or queries the horizontal scale of the FFT waveform.

Group

FFT

Syntax

FFT:HORizontal:SCAle <NR3>

FFT:HORizontal:SCAle?

Arguments

<NR3> is the FFT horizontal scale.

Examples

FFT:HORizontal:SCALe 500.00E+6 sets the FFT horizontal scale to 500 MHz.

FFT:HORizontal:SCALe? might return 500.00E+6 indicating the FFT horizontal scale is set to 500 MHz.

F commands

FFT:SOURce

Sets or queries the source of the FFT waveform.

Group

FFT

Syntax

FFT:SOURce {CH1|CH2}

FFT:SOURce?

Arguments

{CH1|CH2} the FFT source channel.

Examples

FFT:SOURce ch2 sets the FFT source waveform to CH2.

FFT:SOURce? might return "CH2" if CH2 is the FFT source waveform.

FFT:SRCWFM

Sets or queries the FFT source waveform display state.

Group

FFT

Syntax

FFT:SRCWFM <ON|OFF|NR1>

FFT:SRCWFM?

TBS1000C Series Digital Oscilloscopes Programmer Manual 85

Arguments

<NR1> = 0 does not display the FFT source waveform, any other value displays the FFT source waveform.

Examples

FFT:SRCWFM 0 turns off the display of the FFT source waveform.

FFT:SRCWFM? might return 1 indicating the FFT source waveform is displayled.

FFT:VERTical:POSition

Sets or queries the FFT vertical display position.

Group

FFT

Syntax

FFT:VERTical:POSition <NR2>

FFT:VERTical:POSition?

Arguments

F commands

<NR2> is the FFT vertical position.

Examples

FFT:VERTical:POSition 2 sets the FFT vertical position to 2 divisions above center screen.

FFT:VERTical:POSition? might return 2.000.

FFT:VERTical:SCAle

Sets or queries the FFT vertical zoom factor.

Group

FFT

Syntax

FFT:VERTical:SCAle <NR2>

FFT:VERTical:SCAle?

Arguments

<NR2> is the FFT vertical scale.

Examples

FFT:VERTical:SCAle 20 sets the FFT waveform vertical scale to 20.

FFT:VERTical:SCAle? might return 20.00 indicating the FFT waveform vertical scale is 20 dB.

TBS1000C Series Digital Oscilloscopes Programmer Manual 86

FFT:VERTical:UNIts

Queries the FFT vertical measurement units label.

Group

FFT

Syntax

FFT:VERTical:UNIts?

Examples

FFT:VERTical:UNIts? might return dB indicating the FFT vertical units are set to dB.

FFT:VType

Sets or queries the FFT waveform vertical units.

Group

FFT

Syntax

F commands

FFT:VType {DB|LINEAr}

FFT:VType?

Examples

FFT:VType DB sets the FFT waveform vertical units to dB.

FFT:VType? might return DB.

FFT:WINdow

Sets or queries the FFT window type.

Group

FFT

Syntax

FFT:WINdow {HAMming|HANning|RECTangular|BLAckmanharris}

FFT:WINdow?

Arguments

RECTangular window function is equivalent to multiplying all gate data by one.

HAMming window function is based on a cosine series.

HANning window function is based on a cosine series.

BLAckmanharris window function is based on a cosine series.

Examples

FFT:WINdow HAMMING sets the FFT window to Hamming.

FFT:WINdow? might return HAMMING.

TBS1000C Series Digital Oscilloscopes Programmer Manual 87

F commands

FILESystem?

Returns the current working directory and amount of free space. This query is the same as the FILESystem:DIR? query and the FILESystem:FREESpace? query. Query only.

Group

File system

Syntax

FILESystem

FILESystem?

Related commands

FILESystem:CWD on page 88, FILESystem:DELEte on page 89, FILESystem:DIR? on page 89, FILESystem:REName on page 91

Examples

FILESYSTEM? might return :FILESYSTEM:DIR "TEK00000.BMP","GLITCH1.PNG","TEMP.TMP", "FILE1.WFM","FILE2.WFM", "MATH1.WFM"," REF1.WFM","REF2.WFM".

FILESystem:CWD

Sets or queries the current working directory (CWD) for FILESystem commands.

The default working directory is USB0. Anytime you use this command to change the directory, the directory that you specify is retained as the current working directory until you either change the directory or you delete the directory. If you delete the current working directory, the instrument resets current working directory to the default directory (USB0) the next time the instrument is powered on or the next time you execute a file system command.

This command supports the permutations of file and directory names supported by Microsoft Windows:

Relative path names; for example, "./temp"

Absolute path names; for example, " USB0/Wfms"

Implied relative path names; for example "NEWFILE.TXT" becomes " USB0/TEKSCOPE/NEWFILE.TXT" if the current working directory is " USB0/TEKSCOPE"

Group

File system

Syntax

FILESystem:CWD {<new working directory path>}

FILESystem:CWD?

Arguments

<new working directory path> is a quoted string that defines the current working; a directory name can have up to 8 characters with an extension of up to 3 characters.

Examples

FILESYSTEM:CWD " USB0/TEKSCOPE/IMAGES" sets the current working directory to images.

TBS1000C Series Digital Oscilloscopes Programmer Manual 88

F commands

FILESYSTEM:CWD? might return :FILESYSTEM:CWD " USB0/TEKSCOPE/WAVEFORMS" indicating that the current working directory is set to waveforms.

FILESystem:DELEte

This command deletes a named file. If you specify a directory name, it will delete the directory and all of its contents, the same as the RMDir command. You can also specify the filename as *.* to delete all of the files in the current or specified directory. Command only, no query form.

Group

File system

Syntax

FILESystem:DELEte <file path>

Related commands

FILESystem:CWD on page 88, FILESystem:RMDir on page 92

Arguments

<file path> is a quoted string that defines the folder path and file name of the file to delete. If the file path is within the current working directory, you need only specify the file name. The argument *.* will delete all files and subdirectories within the current working directory.

Examples

FILESYSTEM:DELETE "NOT_MINE.SET" deletes the file named NOT_MINE.SET from the current working directory.

FILESystem:DIR?

Returns a list of quoted strings. Each string contains the name of a file or directory in the current working directory. Query only.

Group

File system

Syntax

FILESystem:DIR?

Related commands

FILESystem:CWD on page 88, FILESystem:RMDir on page 92

Returns

FILESystem:DIR? returns a list of files and directories in the current working directory.

Examples

FILESystem:DIR? might return :FILESYSTEM:DIR "TEK00000.PNG","CANSETUP.SET","WFM1.ISF","MYIMAGES".

FILESystem:FORMat

Formats a mass storage device. This command should be used with extreme caution as it causes all data on the specified mass storage device to be lost. Drive letters (such as USB0) are case sensitive and must be upper case. For all other FILESYSTEM commands, drives

TBS1000C Series Digital Oscilloscopes Programmer Manual 89

F commands

letters are not case sensitive. Example: FILES:FORMAT " USB0/" Formats the USB flash drive installed in the instrument's front panel USB port. Command only, no query form.

Group

File system

Syntax

FILESystem:FORMat <drive>

Arguments

<drive> is a quoted string that sets the drive to format.

Examples

FILESystem:FORMat "/usb0/" formats the USB flash drive installed in the instrument front panel USB port.

FILESystem:FREESpace?

Returns a numeric value, in bytes, of the memory space available on the current drive. Query only.

Group

File system

Syntax

FILESystem:FREESpace?

Related commands

FILESystem:CWD on page 88

Examples

FILESystem:FREESpace? might return 6242501.

FILESystem:MKDir

Creates a folder at the specified location. Command only, no query form.

Group

File system

Syntax

FILESystem:MKDir <directory path>

Related commands

FILESystem:CWD on page 88, FILESystem:DIR? on page 89

Arguments

<directory path> is a quoted string that defines the location and name of the directory to create. If you do not specify a path to the directory, the instrument creates the directory in the current working directory. The current directory refers to the name of a directory as returned by the FILESystem:CWD query.

Directory names must follow the same rules as file names. File System Conventions on page 26

TBS1000C Series Digital Oscilloscopes Programmer Manual 90

F commands

Examples

FILESYSTEM:MKDIR " USB0/NewDirectory" creates the directory named NEWDIRECTORY at the root of the E drive.

The following two commands create the directory MYNEWSUBDIRECTORY within the existing directory mydirectory at the root of the USB0 drive: FILESYSTEM:CWD " USB0/MyDirectory";:FILESYSTEM:MKDIR "MyNewSubDirectory" This assumes that USB0/MYDIRECTORY already existed and was not a read-only directory.

FILESystem:READFile

Writes the contents of the specified file to the specified interface. If the file does not exist or is not readable, an appropriate error event is posted. No query form.

Group

File System

Syntax

FILESystem:READFile <QString>

Related commands

FILESystem:CWD on page 88

Arguments

<QString> is a quoted string that defines the file name and path. If the file path is within the current working directory, specify only the file name.

Examples

FILESYSTEM:READFILE “USB0/TEST_DATA/TEK00016CH1.CSV” reads the content of the specified file, if the file exists and is readable, and sends the content of the file to the current interface.

FILESystem:REName

Assigns a new name to an existing file or folder. You can also move a file or folder by specifying the new name in a different folder. Command only, no query form.

For file and folder name rules, see File System Conventions. File System Conventions on page 26

Group

File system

Syntax

FILESystem:REName <old file path>,<new file path>

Related commands

FILESystem:CWD on page 88

Arguments

<old filepath> is a quoted string that defines the path and name of the file to rename. If you do not specify a path to the file, the instrument looks for the file in the current working folder. The current directory refers to the name of a folder as returned by the

FILESystem:CWD query.

<new filepath> is a quoted string that defines the path and new name of the file. If you do not specify a path to a folder, the

instrument places the renamed file into the current working folder. File System Conventions on page 26

TBS1000C Series Digital Oscilloscopes Programmer Manual 91

F commands

Examples

FILESYSTEM:RENAME " USB0/TEK00000.SET","D:/MYSETTING.SET" gives the file named TEK00000.SET the new name of MYSETTING.SET. The file remains in the root directory on the D drive.

FILESystem:RMDir

Deletes a named directory. This command deletes the specified directory and all of its contents. The directory must not be a read-only directory. Command only, no query form.

Group

File system

Syntax

FILESystem:RMDir <directory path>

Arguments

<directory path> is a quoted string that defines the location and name of the directory to delete. If you do not specify a path to the folder, the instrument deletes the specified folder in the current working folder. The current folder refers to the name of a folder as returned by the FILESystem:CWD query.

Note: A folder must be empty before you can delete it.

Examples

FILESYSTEM:RMDIR " USB0/OldDirectory" removes the directory named olddirectory from the root of the E drive.

FILESystem:WRITEFile

Writes the specified block data to a file in the instrument current working directory. If the specified file does not exist or is not readable, an appropriate error event is posted. The maximum length of the block data is 262144 bytes. No query form.

Group

File System

Syntax

FILESystem:WRITEFile <file path>, <data>

Related commands

FILESystem:CWD on page 88

Arguments

<file path> is the quoted string that defines the file name and path. If the path is within the current working directory, specify the file name only.

<data> can be either DEFINITE LENGTH encoding or INDEFINITE LENGTH ARBITRARY BLOCK PROGRAM DATA encoding as described in IEEE488.2.

TBS1000C Series Digital Oscilloscopes Programmer Manual 92

F commands

FPAnel:PRESS

Simulates the action of pressing a specified front-panel button. No query form.

When the front panel is locked, the front-panel buttons and multipurpose knob operations are suspended. The FPAnel:PRESS and the FPAnel:TURN commands will also not work. You can work around this by using the appropriate programmatic interface commands, instead of the front-panel commands.

Group

Miscellaneous

Syntax

FPAnel:PRESS <button>

Arguments

<button> is the name of a front-panel button. Most of the argument names associate directly with their front panel buttons. For example, AUTOSet is for the Autoset button. The <button> enumeration arguments and their associations with the front panel buttons are listed below.

Argument Button

ACQuire Acquire button

SAVE Recall Save/Recall Menu button

MEASurement Measure button

UTILity Utility button

MATh M button

REF R button

FFT F button

TRIGger Trigger Menu button

FORCetrig Force Trig button

CH1 Channel1 select button

CH2 Channel2 select button

DEFaultsetup Default Setup button

FUNCtion Function button

Help Help button

ZOOM Zoom button

FINe Fine button

CURsor Cursors button

RUnstop Run/Stop button

SINGleseq Single button

AUTOset Autoset button

SETTO50 Trigger level knob can be pressed to Set Trigger to 50%

Save Save button

RMENU1 Screen top-most side menu button

Table continued…

TBS1000C Series Digital Oscilloscopes Programmer Manual 93

F commands

Argument Button

RMENU2 Screen side menu button

RMENU3 Screen side menu button

RMENU4 Screen side menu button

RMENU5 Screen bottom-most side menu button

MENUOff Menu On/Off button

GPKNOB Multipurpose knob can be pressed for selection.

HORZPos Horizontal Position knob can be pressed to set horizontal position to

center.

Examples

FPANEL:PRESS AUTOSET executes the instrument Autoset function.

FPAnel:TURN

Simulates the action of turning a specified front-panel control knob. No query form.

When the front panel is locked, the front-panel button and multipurpose knob operations are suspended. The FPAnel:PRESS and FPAnel:TURN commands will also not work, and they will not generate an error. You can work around this by using the appropriate programmatic interface commands, instead of the front-panel commands. For example, to set the trigger level to 50%, you could use TRIGger:A SETLevel. To force a trigger, you could use TRIGger FORCe.

Group

Miscellaneous

Syntax

FPAnel:TURN <knob>,[<n>]

Arguments

<knob> is the name of a rotating control. A comma (,) separates the control knob argument from the numeric optional rotation value argument. In the absence of the numeric rotation value argument, the default is 1 (clockwise). You do not need a white space between the arguments and the comma. <n> represents the rotation direction and magnitude of rotation. Negative values represent a counterclockwise knob rotation, and positive values represent a clockwise rotation. The magnitude of <n> specifies the amount of the turn, where <n> = 1 represents turning the knob one unit, <n> = 2 represents turning the knob two units, <n> = 4 represents turning the knob four units, and so on. The range of units depends on which front panel knob is specified.

Table 27: FPAnel:TURN arguments

Argument Knob

GPKNOB Multipurpose knob

HORZPos Horizontal Position knob

HORZScale Horizontal Scale knob

TRIGLevel Trigger Level knob

VERTPOS<n> Vertical Position knob

VERTSCALE<n> Vertical Scale knob

Examples

FPANEL:TURN TRIGLEVEL,10 duplicates turning the front panel Trigger Level knob clockwise by 10 units.

TBS1000C Series Digital Oscilloscopes Programmer Manual 94

F commands

FWUpdate:Update

Updates the oscilloscope firmware from a file on a USB flash drive. Before executing this command, make sure the USB flash drive is plugged into the instrument, and contains the firmware update file TBS1000C.TEK at the root (top) directory. If the update file is not in the root directory, the oscilloscope shows a warning message and the firmware is not updated.

Group

Miscellaneous

Syntax

FWUpdate:Update

TBS1000C Series Digital Oscilloscopes Programmer Manual 95

H commands

This section lists commands and queries that begin with the letter H.

HDR

This command is identical to the HEADer query and is included for compatibility with other Tektronix scopes.

Group

Miscellaneous

Syntax

HDR

HDR?

HEADer

Sets and queries the Response Header Enable State that causes the to either include or omit headers on query responses. This command does not affect IEEE Std 488.2-1987 Common Commands (those starting with an asterisk); they never return headers.

Group

Miscellaneous

Syntax

HEADer

HEADer?

Arguments

ON or <NR1> ≠ 0 sets the Response Header Enable State to true. This causes the instrument to include header on applicable query responses. You can then use the query response as a command.

OFF or <NR1> = 0 sets the Response Header Enable State to false. This causes the instrument to omit headers on query responses so that only the argument is returned.

Examples

HEADer OFF causes the instrument to omit headers from query responses.

HEADer? might return 1, showing that the Response Header Enable State is true. Query only.

HELPevery:ACQuire

Enables or disables the display of Help Everywhere information for the acquire measurements.

Group

Help everywhere

Syntax

HELPevery:ACQuire {ON|OFF}

HELPevery:ACQuire?

TBS1000C Series Digital Oscilloscopes Programmer Manual 96

H commands

Arguments

ON enables displaying Help Everywhere for the acquire measurements.

OFF disables displaying Help Everywhere for the acquire measurements.

Examples

HELPevery:ACQuire ON enables Help Everywhere for the acquire settings.

HELPevery:ALL

Enables or disables the display of Help Everywhere information for all measurement settings (acquire, trigger, vertical, math, fft ,cursor, reference, measurement, and utility modules).

Group

Help everywhere

Syntax

HELPevery:ALL {ON|OFF}

Arguments

ON enables Help Everywhere.

OFF disables Help Everywhere.

Examples

HELPevery:ALL ON enables Help Everywhere.

HELPevery:CURsor

Enables or disables the display of Help Everywhere information for the cursor module.

Group

Help everywhere

Syntax

HELPevery:CURsor {ON|OFF}

HELPevery:CURsor?

Arguments

ON enables Help Everywhere for the cursor settings.

OFF disables Help Everywhere for the cursor settings.

Examples

HELPevery:CURsor ON enables Help Everywhere for the cursor settings.

TBS1000C Series Digital Oscilloscopes Programmer Manual 97

HELPevery:FFT

Enables or disables the display of Help Everywhere information for the fft settings.

Group

Help everywhere

Syntax

HELPevery:FFT {ON|OFF}

HELPevery:FFT?

Arguments

ON enables Help Everywhere for the FFT module.

OFF disables Help Everywhere for the FFT module.

Examples

HELPevery:FFT ON enables Help Everywhere for the FFT module.

HELPevery:MATH

H commands

Enables or disables the display of Help Everywhere information for the math module.

Group

Help everywhere

Syntax

HELPevery:MATH {ON|OFF}

HELPevery:MATH?

Arguments

ON enables Help Everywhere for the math module.

OFF disables Help Everywhere for the math module..

Examples

HELPevery:MATH ON enables Help Everywhere for the math module.

HELPevery:MEASUrement

Enables or disables the display of Help Everywhere information for the measurement module.

Group

Help everywhere

Syntax

HELPevery:MEASUrement {ON|OFF}

HELPevery:MEASUrement?

Arguments

ON enables Help Everywhere for the measurement module.

TBS1000C Series Digital Oscilloscopes Programmer Manual 98

OFF disables Help Everywhere for the measurement module..

Examples

HELPevery:MEASUrement ON enables Help Everywhere for the measurement module.

HELPevery:REFerence

Enables or disables the display of Help Everywhere information for the reference module.

Group

Help everywhere

Syntax

HELPevery:REFerence {ON|OFF}

HELPevery:REFerence?

Arguments

ON enables Help Everywhere for the reference module.

OFF disables Help Everywhere for the reference module.

H commands

Examples

HELPevery:REFerence ON enables Help Everywhere for the reference module.

HELPevery:TRIGger

Enables or disables the display of Help Everywhere information for the trigger module.

Group

Help everywhere

Syntax

HELPevery:TRIGger {ON | OFF}

HELPevery:TRIGger?

Arguments

ON enables Help Everywhere for the trigger module.

OFF disables Help Everywhere for the trigger module.

Examples

HELPevery:TRIGger ON enables Help Everywhere for the trigger module.

HELPevery:UTIlity

Enables or disables the display of Help Everywhere information for the utility module.

Group

Help everywhere

TBS1000C Series Digital Oscilloscopes Programmer Manual 99

Syntax

HELPevery:UTIlity {ON|OFF}

HELPevery:UTIlity?

Arguments

ON enables Help Everywhere for the utility module.

OFF disables Help Everywhere for the utility module.

Examples

HELPevery:UTIlity ON enables Help Everywhere for the utility module.

HELPevery:VERtical

Enables or disables the display of Help Everywhere information for the vertical module.

Group

Help everywhere

Syntax

H commands

HELPevery:VERtical {ON|OFF}

HELPevery:VERtical?

Arguments

ON enables Help Everywhere for the vertical module.

OFF disables Help Everywhere for the vertical module.

Examples

HELPevery:VERtical ON enables Help Everywhere for the vertical module.

HORizontal?

Returns all settings for the horizontal commands. Query only.

The commands HORizontal:MAIn:SCAle, HORizontal:MAIn:SECdiv, HORizontal:SCAle, and HORizontal:SECdiv are equivalent, so HORizontal:MAIn:SCAle is the value that is returned. The commands HORizontal:MAIn:POSition and HORizontal:POSition are equivalent, so HORizontal:MAIn:POSition is the value that is returned.

Group

Horizontal

Syntax

HORizontal?

Returns

Returns all horizontal settings.

TBS1000C Series Digital Oscilloscopes Programmer Manual 100

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

Save and Recall command group

Status and Error command group

Trigger command group

Vertical command group

Waveform command group

Zoom command group

A commands

ACQuire?

ACQuire:MAXSamplerate?

ALIas

ALIas:CATalog?

ALIas:DEFine

ALIas:DELEte

ALIas:DELEte:ALL

ALIas:DELEte[:NAMe]

ALIas[:STATE]

ALLEv?

AUTOSet

B commands

BUSY?

C commands

*CAL?

CALibrate:INTERNal:STARt

CALibrate:INTERNal:STATus?

CALibrate:RESults?

CALibrate:RESults:SPC?

CH<x>?

CH<x>:AMPSVIAVOLTs:ENABLe

CH<x>:AMPSVIAVOLTs :Factor

CH<x>:DESKew

CH<x>:OFFSet

CH<x>:PRObe:GAIN

CH<x>:PRObe:ID?

CH<x>:PRObe:ID:SERnumber?

CH<x>:PRObe:ID:TYPE?

CH<x>:PRObe:SIGnal

CH<x>:PRObe:UNIts?

CLEARMenu

*CLS