Infiniium DCA and DCA-J and DCA-X Agilent 86100A/B/C/D Wide-Bandwidth Oscilloscope Programmer’s Guide Agilent Technologies Notices © Agilent Technologies, Inc. 2000 - 2013 Warranty (June 1987) or DFAR 252.227-7015 (b)(2) (November 1995), as applicable in any No part of this manual may be reproduced The material contained in this docu- technical data. in any form or by any means (including ment is provided “as is,” and is sub- electronic storage and retrieval or transla- ject to being changed, without notice, Safety Notices tion into a foreign language) without prior in future editions. Further, to the max- agreement and written consent from Agi- imum extent permitted by applicable lent Technologies, Inc. as governed by law, Agilent disclaims all warranties, CAUTION. A CAUTION notice United States and international copyright laws. either express or implied, with regard denotes a hazard. It calls attention to this manual and any information to an operating procedure, practice, Manual Part Number contained herein, including but not or the like that, if not correctly per- limited to the implied warranties of formed or adhered to, could result 86100-90131 merchantability and fitness for a par- in damage to the product or loss of ticular purpose. Agilent shall not be Edition important data. Do not proceed liable for errors or for incidental or beyond a CAUTION notice until the consequential damages in connection Eigth Edition, January 2013 indicated conditions are fully with the furnishing, use, or perfor- Designed in USA understood and met. mance of this document or of any Agilent Technologies, Inc. information contained herein. Should 1400 Fountaingrove Parkway Agilent and the user have a separate Santa Rosa, CA 95403 USA written agreement with warranty WARNING. A WARNING notice Trademark Acknowledgements terms covering the material in this denotes a hazard. It calls attention document that conflict with these to an operating procedure, prac- Microsoft ® is a U.S. registered trademark terms, the warranty terms in the sep- tice, or the like that, if not cor- of Microsoft Corporation. arate agreement shall control. rectly performed or adhered to, Windows ® and MS Windows ® are U.S. could result in personal injury or Technology Licenses registered trademarks of Microsoft Corpo- death. Do not proceed beyond a ration. The hardware and/or software described in WARNING notice until the indi- MATLAB ® is a U.S. registered trademark this document are furnished under a cated conditions are fully under- of The Math Works, Inc. license and may be used or copied only in stood and met. accordance with the terms of such license. Restricted Rights Legend If software is for use in the performance of a U.S. Government prime contract or sub- contract, Software is delivered and licensed as “Commercial computer soft- ware” as defined in DFAR 252.227-7014 (June 1995), or as a “commercial item” as defined in FAR 2.101(a) or as “Restricted computer software” as defined in FAR 52.227-19 (June 1987) or any equivalent agency regulation or contract clause. Use, duplication or disclosure of Software is subject to Agilent Technologies’ standard commercial license terms, and non-DOD Departments and Agencies of the U.S. Gov- ernment will receive no greater than Restricted Rights as defined in FAR 52.227-19(c)(1-2) (June 1987). U.S. Govern- ment users will receive no greater than Limited Rights as defined in FAR 52.227-14 Contents 1 Introduction 17 New and Revised Commands 18 SICL/LAN Support 18 The Command Tree 22 Command Syntax 23 Queries 27 Starting a Program 29 Multiple Databases 31 Files 33 Status Reporting 35 Interface Functions 47 Commands Unavailable in Jitter Mode 49 Error Messages 51 Language Compatibility 59 2 Sample Programs 65 C Programming Examples 65 BASIC Programming Examples 87 3 Common Commands 97 Introduction 97 *CLS (Clear Status) 98 *ESE (Event Status Enable) 98 *ESR? (Event Status Register) 99 *IDN? (Identification Number) 100 *LRN? (Learn) 101 *OPC (Operation Complete) 101 *OPT? (Option) 102 *RCL (Recall) 102 *RST (Reset) 103 *SAV (Save) 107 *SRE (Service Request Enable) 107 *STB? (Status Byte) 108 *TRG (Trigger) 109 *TST? (Test) 109 *WAI (Wait-to-Continue) 109 4 Root Level Commands 111 AEEN 112 ALER? 113 AUToscale 113 BLANk 115 86100-Series Programmer’s Guide 3 CDISplay 115 COMMents 115 CREE 115 CRER? 116 DIGitize 116 JEE 117 JER? 118 LER? 118 LTEE 119 LTER? 119 MODel? 119 MTEE 120 MTER? 120 OPEE 120 OPER? 121 PTEE 121 PTER? 122 PRINt 122 RECall:SETup 122 RUN 122 SERial 123 SINGle 123 STOP 123 STORe:SETup 123 STORe:WAVeform 123 TER? 124 UEE 124 UER? 124 VIEW 124 5 System Commands 127 DATE 127 DSP 127 ERRor? 128 FCONfig 129 HEADer 129 LONGform 130 MODE 130 SETup 131 TIME 131 6 Acquire Commands 133 AVERage 133 BEST 134 COUNt 134 EYELine 134 LTESt 134 POINts 135 REYE 135 4 86100-Series Programmer’s Guide REYE:ASKew 136 REYE:INTerval 136 RUNTil 136 SSCReen 137 SSCReen:AREA 139 SSCReen:IMAGe 139 SWAVeform 139 SWAVeform:RESet 140 7 Calibration Commands 141 CANCel 143 CONTinue 144 ERATio:DLEVel? 144 ERATio:STARt 144 ERATio:STATus? 145 FRAMe:LABel 145 FRAMe:STARt 145 FRAMe:TIME? 145 MODule:LRESistance 146 MODule:OCONversion? 146 MODule:OPOWer 146 MODule:OPTical 146 MODule:OWAVelength 147 MODule:STATus? 147 MODule:TIME? 148 MODule:VERTical 148 OUTPut 149 PROBe 149 RECommend? 149 SAMPlers 150 SDONe? 150 SKEW 150 SKEW:AUTO 151 STATus? 151 8 Channel Commands 153 BANDwidth 153 CONNector 154 DISPlay 154 DSKew 154 DSKew:AUTO 155 DSKew:AUTO:STEP 155 DSKew:LCALibrate 155 FDEScription? 155 FILTer 156 FSELect 156 OFFSet 156 PROBe 157 PROBe:CALibrate 157 86100-Series Programmer’s Guide 5 PROBe:SELect 158 RANGe 159 SCALe 159 TDRSkew 160 UNITs 160 UNITs:ATTenuation 160 UNITs:OFFSet 161 WAVelength 161 9 Clock Recovery Commands 163 ARELock 167 ARELock:CANCel 167 ARELock:STATe? 167 CLBandwidth 167 CRATe 168 CFRequency? 168 INPut 168 LBANdwidth 169 LBWMode 171 LOCKed? 171 LSELect 171 LSELect:AUTomatic 173 ODRatio 173 ODRatio:AUTO 173 PEAKing? 174 RATE 174 RDIVider 176 RELock 176 SPResent? 176 TDENsity? 177 T2TFrequency? 177 10 Disk Commands 179 BFILe? 179 CDIRectory 180 DELete 180 DIRectory? 180 LOAD 181 MDIRectory 182 PWAVeform:LOAD 182 PWAVeform:PPBit 182 PWAVeform:RANGe 183 PWAVeform:RANGe:STARt 183 PWAVeform:RANGe:STOP 183 PWAVeform:SAVE 184 PWD? 184 SIMage 184 SPARameter:SAVE 186 STORe 188 6 86100-Series Programmer’s Guide TFILe? 189 11 Display Commands 191 CGRade:LEVels? 192 CONNect 192 DATA? 192 DCOLor 193 ETUNing 193 GRATicule 193 JITTer:BATHtub:YSCale 194 JITTer:GRAPh 194 JITTer:HISTogram:YSCale 196 JITTer:LAYout 196 JITTer:PJWFrequency 196 JITTer:PJWTracking 196 JITTer:SHADe 197 LABel 197 LABel:DALL 197 PERSistence 197 RRATe 198 SCOLor 198 SINTegrity:BATHtub:YSCale 200 SINTegrity:GRAPh 200 SINTegrity:HISTogram:YSCale 200 SINTegrity:LAYout 201 SINTegrity:LEVel 201 SINTegrity:SHADe 201 SPARameter:GRAPh 201 SPARameter:LAYout 202 SPARameter:SHADe 202 SSAVer 202 12 Function Commands 205 ADD 206 DIFF 206 DISPlay 207 FUNCtion 207 HORizontal 207 HORizontal:POSition 208 HORizontal:RANGe 208 INVert 208 MAGNify 209 MAXimum 209 MINimum 209 MULTiply 209 OFFSet 210 PEELing 210 RANGe 210 SUBTract 211 86100-Series Programmer’s Guide 7 VERSus 211 VERTical 211 VERTical:OFFSet 211 VERTical:RANGe 212 13 Hardcopy Commands 213 AREA 213 DPRinter 213 FACTors 214 IMAGe 214 PRINters? 215 14 Histogram Commands 217 AXIS 218 MODE 218 SCALe:SIZE 219 SOURce 219 WINDow:BORDer 219 WINDow:DEFault 219 WINDow:SOURce 219 WINDow:X1Position 220 WINDow:X2Position 220 WINDow:Y1Position 220 WINDow:Y2Position 220 15 Limit Test Commands 223 FAIL 223 JITTer:SELect 224 LLIMit 224 MNFound 225 RUNTil 225 SINTegrity:SELect 226 SOURce 227 SSCReen 227 SSCReen:AREA 229 SSCReen:IMAGe 229 SSUMmary 229 SWAVeform 230 SWAVeform:RESet 231 TEST 231 ULIMit 232 16 Marker Commands 233 PROPagation 233 REACtance? 234 REFerence 234 RPANnotation 234 STATe 234 8 86100-Series Programmer’s Guide X1Position 235 X1Y1source 235 X2Position 236 X2Y2source 236 XDELta? 236 XUNits 237 Y1Position 237 Y2Position 237 YDELta? 237 YUNits 238 17 Mask Test Commands 239 ALIGn 241 AMARgin:BER 241 AMARgin:CALCulate 241 AMARgin:HRATio 241 AMEThod 242 AOPTimize 242 ARUN 243 COUNt:FAILures? 243 COUNt:FSAMples? 243 COUNt:HITS? 244 COUNt:SAMPles? 244 COUNt:WAVeforms? 244 DELete 245 EXIT 245 LOAD 245 MASK:DELete 245 MMARgin:PERCent 246 MMARgin:STATe 246 RUNTil 246 SAVE 246 SCALe:DEFault 247 SCALe:MODE 247 SCALe:SOURce? 247 SCALe:X1 248 SCALe:XDELta 248 SCALe:Y1 249 SCALe:Y2 249 SOURce 249 SCALe:YTRack 250 SSCReen 250 SSCReen:AREA 251 SSCReen:IMAGe 251 SSUMmary 252 STARt 252 SWAVeform 252 SWAVeform:RESet 253 TEST 253 86100-Series Programmer’s Guide 9 TITLe? 254 YALign 254 18 Measure Commands 255 Introduction 258 Commands 260 AMPLitude:ANALysis 260 AMPLitude:DI? 260 AMPLitude:EOPening? 260 AMPLitude:ISI? 260 AMPLitude:ISIVsbit? 261 AMPLitude:ISIVsbit:BITS? 261 AMPLitude:ISIVsbit:HIGHest? 261 AMPLitude:ISIVsbit:LOWest? 262 AMPLitude:LEVel:CIDigits:LAGGing 262 AMPLitude:LEVel:CIDigits:LEADing 262 AMPLitude:LEVel:DEFine 262 AMPLitude:LOCation 263 AMPLitude:OLEVel? 263 AMPLitude:PI? 263 AMPLitude:PIRMs? 263 AMPLitude:Q? 264 AMPLitude:RINoise? 264 AMPLitude:RINoise:DEF 264 AMPLitude:RINoise:UNITs 264 AMPLitude:RN? 265 AMPLitude:RNSTabilize 265 AMPLitude:RNSValue 265 AMPLitude:SAMPlitude? 265 AMPLitude:TI? 266 AMPLitude:TI:DEFine 266 AMPLitude:UNITs 266 AMPLitude:ZLEVel? 266 ANNotation 267 APOWer 267 APOWer:CORRection 267 CGRade:AMPLitude 267 CGRade:BITRate 268 CGRade:COMPlete 268 CGRade:CRATio 269 CGRade:CROSsing 269 CGRade:DCDistortion 269 CGRade:DCYCle 270 CGRade:EHEight 270 CGRade:ERATio 271 CGRade:ERFactor 271 CGRade:ESN 271 CGRade:EWIDth 272 CGRade:JITTer 272 10 86100-Series Programmer’s Guide
Description: