Agilent Technologies 86100-90086

2-50

Sample Programs

Listings of the Sample Programs

Contents

Main 2 Notices Manual Part Number Edition Warranty Contents Page Page Introduction Figure 1-1. Sample Data Processing Starting a Program Page Multiple Databases 1 2 3 4 5 6 7 Files Table 1-1. File Name Extensions Table 1-2. Rules for Loading Files Table 1-3. Default File Locations Table 1-4. File Locations (Loading Files) Status Reporting Page Figure 1-3. Status Reporting Overview Page Page Page Table 1-5. Status Reporting Bit Definition (1 of 2) Table 1-5. Status Reporting Bit Definition (2 of 2) Page Page Page Page Command Syntax Table 1-6. Long and Short Command Forms Table 1-7. <suffix mult> Table 1-8. <suffix unit> Page Page Page Page Page Page Page Page Interface Functions Table 1-9. Interface Capabilities Language Compatibility Agilent 83480A/54750A Commands Not Used in the Instrument (1 of 6) Agilent 83480A/54750A Commands Not Used in the Instrument (2 of 6) Agilent 83480A/54750A Commands Not Used in the Instrument (3 of 6) Agilent 83480A/54750A Commands Not Used in the Instrument (4 of 6) Agilent 83480A/54750A Commands Not Used in the Instrument (5 of 6) Agilent 83480A/54750A Commands Not Used in the Instrument (6 of 6) New and Revised Commands Page Commands Unavailable in Jitter Mode Page Error Messages Table 1-10. Error Messages Returned by Instrument Parser (1 of 4) Table 1-10. Error Messages Returned by Instrument Parser (2 of 4) Table 1-10. Error Messages Returned by Instrument Parser (3 of 4) Table 1-10. Error Messages Returned by Instrument Parser (4 of 4) 2 Sample Programs Sample Programs Sample C Programs init.c - Initialization init.c - Global Definitions and Main Program init.c - Initializing the Analyzer init.c - Acquiring Data init.c - Making Automatic Measurements init.c - Error Checking Page init.c - Transferring Data to the PC init.c - Converting Waveform Data init.c - Storing Waveform Time and Voltage Information gen_srq.c - Generating a Service Request and analyzer, and generate a service request. Initializing the Analyzer Setting Up a Service Request Generating a Service Request Listings of the Sample Programs hpib_decl.h Sample Program Page init.c Sample Program Page Page Page Page Page gen_srq.c Sample Program Page srq.c Sample Program learnstr.c Sample Program Page Page sicl_IO.c Sample Program Page Page natl_IO.c Sample Program Page Page multidatabase.c Sample Program Page Page init.bas Sample Program Page Page Page Page Page srq.bas Sample Program Page Page lrn_str.bas Sample Program Page Page Page 3 Common Commands Common Commands *CLS (Clear Status) *ESE (Event Status Enable) Table 3-1. Status Registers *ESR? (Event Status Register) Table 3-2. Standard Event Status Enable Register Bits *IDN? (Identification Number) Table 3-3. Standard Event Status Register Bits *LRN? (Learn) *OPC (Operation Complete) Page *OPT? (Option) *RCL (Recall) *RST (Reset) Table 3-4. Default Setup (1 of 4) Table 3-4. Default Setup (2 of 4) Table 3-4. Default Setup (3 of 4) Table 3-4. Default Setup (4 of 4) *SAV (Save) *SRE (Service Request Enable) Table 3-5. Service Request Enable Register Bits *STB? (Status Byte) *TRG (Trigger) Table 3-6. Status Byte Register Bits *TST? (Test) *WAI (Wait-to-Continue) Page Page 4 Root Level Commands Root Level Commands AEEN ALER? AUToscale Table 4-1. Enabled Bits for Some Useful Example Mask Values Page Unable to set horizontal scale/delay for channel n BLANk CDISplay COMMents CREE CRER? DIGitize Table 4-2. Enabled Bits for Some Useful Example Mask Values JEE JER? LER? Table 4-3. Enabled Bits for Mask Values LTEE LTER? MODel? Table 4-4. Enabled Bits for Mask Values MTEE MTER? Table 4-5. Model? Returned Format Table 4-6. Enabled Bits for Mask Values OPEE OPER? PTEE Table 4-7. Enabled Bits for Mask Values PTER? PRINt RECall:SETup RUN SERial SINGle STOP STORe:SETup STORe:WAVeform TER? UEE UER? VIEW Page Page System Commands DATE DSP ERRor? HEADer Table 5-1. Error Messages LONGform MODE SETup TIME Page Page Acquire Commands AVERage BEST COUNt EYELine LTESt POINts Page D:\User Files\screen images Page Page Page 7 Calibration Commands Calibration Commands All Calibrations Page CANCel CONTinue ERATio:DLEVel? ERATio:STARt ERATio:STATus? FRAMe:LABel FRAMe:STARt FRAMe:TIME? MODule:LRESistance MODule:OCONversion? MODule:OPOWer MODule:OPTical MODule:OWAVelength MODule:STATus? MODule:TIME? MODule:VERTical OUTPut PROBe RECommend? SAMPlers SDONe? SKEW SKEW:AUTO STATus? 8 Channel Commands Channel Commands BANDwidth FDEScription? FILTer FSELect OFFSet PROBe PROBe:CALibrate PROBe:SELect SCALe TDRSkew UNITs UNITs:ATTenuation UNITs:OFFSet WAVelength 9 Clock Recovery Commands Clock Recovery Commands Page CLBandwidth CRATe INPut LBANdwidth LBWMode LOCKed? Table 9-3. Valid Loop Bandwidth Arguments Versus Modules ODRatio ODRatio:AUTO RATE Page RDIVider RELock SPResent? TDENsity? Table 9-5. Signal Present Return Status vs. Receiver Number 10 Disk Commands Disk Commands CDIRectory DELete DIRectory? MDIRectory PWAVeform:LOAD PWAVeform:PPBit PWAVeform:RANGe PWAVeform:RANGe:STARt PWAVeform:RANGe:STOP PWAVeform:SAVE PWD? SIMage SPARameter:SAVE Table 10-1. S-Parameters and Corresponding <field> Argument for s2p Files STORe Page 11 Display Commands Display Commands CGRade:LEVels? CONNect DATA? DCOLor (Default COLor) GRATicule JITTer:BATHtub:YSCale JITTer:GRAPh JITTer:HISTogram:YSCale JITTer:LAYout JITTer:PJWFrequency JITTer:PJWTracking JITTer:SHADe LABel LABel:DALL PERSistence Table 11-1. Persistence Values and Resolution RRATe SCOLor Table 11-2. CGRade and GSCale Arguments Page SSAVer Page 12 Function Commands Function Commands ADD DIFF FUNCtion<N>? HORizontal HORizontal:POSition HORizontal:RANGe INVert MAGNify MAXimum MINimum MULTiply OFFSet PEELing SUBTract VERSus VERTical VERTical:OFFSet VERTical:RANGe Page Page Hardcopy Commands AREA DPRinter FACTors IMAGe PRINters? Page Histogram Commands AXIS MODE SCALe:SIZE WINDow:BORDer WINDow:DEFault WINDow:SOURce WINDow:X1Position WINDow:X2Position WINDow:Y1Position WINDow:Y2Position 15 Limit Test Commands Limit Test Commands FAIL JITTer LLIMit MNFound Page Page D:\User Files\screen images SSUMmary files\limit summaries Page TEST ULIMit Page 16 Marker Commands Marker Commands PROPagation REACtance? REFerence RPANnotation STATe X1Position X1Y1source X2Position X2Y2source XDELta? XUNITs Y1Position Y2Position YDELta? YUNITs 17 Mask Test Commands Mask Test Commands ALIGn AMEThod AOPTimize COUNt:FAILures? COUNt:FSAMples? COUNt:HITS? COUNt:SAMPles? COUNt:WAVeforms? DELete EXIT MASK:DELete MMARgin:PERCent MMARgin:STATe SAVE SCALe:DEFault SCALe:MODE SCALe:SOURce? SCALe:X1 X = (X XDELta) + X1 SCALe:XDELta SCALe:Y1 SCALe:Y2 Y = (Y (Y2 Y1)) + Y1 SCALe:YTRack Page SSUMmary D:\User Files\limit summaries STARt Page TEST TITLe? YALign 18 Measure Commands Measure Commands ANNotation APOWer CGRade:AMPLitude CGRade:BITRate CGRade:COMPlete CGRade:CRATio CGRade:CROSsing CGRade:DCDistortion CGRade:DCYCle CGRade:EHEight CGRade:ERATio CGRade:ERFactor CGRade:ESN CGRade:EWIDth CGRade:JITTer CGRade:OFACtor CGRade:OLEVel CGRade:PEAK? CGRade:PWIDth CGRade:SOURce CGRade:ZLEVel CLEar DEFine Table 18-1. :MEASure:DEFine Interactions DELTatime DUTYcycle FALLtime Fall time = time at lower threshold point time at upper threshold point. FREQuency frequency = 1/(time at second rising edge time at first rising edge) frequency = 1/(time at second falling edge time at first falling edge). HISTogram:HITS? HISTogram:M1S? HISTogram:M2S? HISTogram:M3S? HISTogram:MEAN? HISTogram:MEDian? HISTogram:PEAK? HISTogram:PP? HISTogram:PPOSition? HISTogram:SCALe? HISTogram:STDDev? JITTer:DCD? JITTer:DDJ? JITTer:DDJVsbit? JITTer:DDJVsbit:EARLiest? JITTer:DDJVsbit:LATest? JITTer:DJ? JITTer:EBITs? JITTer:EDGE JITTer:FREQuency:ANALysis JITTer:FREQuency:COMPonents? JITTer:FREQuency:MAXNumber JITTer:FREQuency:SCAN JITTer:ISI? JITTer:LEVel? JITTer:LEVel:DEFine JITTer:PATTern? JITTer:PJ? JITTer:PJRMS? JITTer:RJ? JITTer:RJSTabilize JITTer:RJSValue JITTer:SIGNal JITTer:SIGNal:AUTodetect JITTer:TJ? JITTer:TJ:DEFine JITTer:UNITs NWIDth nwidth = time at the second rising edge time at the first falling edge nwidth = time at the first rising edge time at the first falling edge. OVERshoot PERiod PWIDth pwidth = time at the first falling edge time at the first rising edge pwidth = time at the second falling edge time at the first rising edge RESults? Table 18-2. Results Values Table 18-3. Result States RISetime SCRatch SENDvalid TEDGe? TDR:AVERage TDR:MAX TDR:MIN TMAX TMIN TVOLt? VAMPlitude VAVerage VBASe VMAX VMIN VPP VRMS VTIMe? VTOP Page 19 S-Parameter Commands S-Parameter F points-per-waveform 2time/division()display divisions() --------------------------------------------------------------------------------------------------= TDRSparam F MAGGraph:HORizontal:STARt MAGGraph:HORizontal:SPAN 1 time/division()display divisions() MAGGraph:VERTical:MAXimum MAGGraph:VERTical:MINimum MARKer:X1STate MARKer:X2STate MARKer:X1Source MARKer:X2Source MARKer:X1Position MARKer:X2Position MARKer:Y1Position? MARKer:Y2Position? MARKer:XDELta? MARKer:YDELta? VWINdow 20 Signal Processing Commands Signal Processing Commands LFEQualizer LFEQualizer:BANDwidth LFEQualizer:BWMode LFEQualizer:FDELay LFEQualizer:NTAPs LFEQualizer:TAP LFEQualizer:TAP:AUTomatic LFEQualizer:TAP:NORMalize LFEQualizer:TDELay LFEQualizer:TDMode MATLab MATLab:ETENable MATLab:ETEXt MATLab:SCRipt OUTPut SOURce: SOURce:DISPlay 21 PRESet 21-3 TDR/TDT Commands (Rev. A.05.00 and Below) TDR/TDT Commands DCALib HPOLarity NVALid? PRESet RATE RESPonse RESPonse:CALibrate RESPonse:CALibrate:CANCel RESPonse:CALibrate:CONTinue RESPonse:HORizontal RESPonse:HORizontal:POSition RESPonse:HORizontal:RANGe RESPonse:RISetime RESPonse:TDRDest RESPonse:TDRTDT RESPonse:TDTDest RESPonse:VERTical RESPonse:VERTical:OFFSet RESPonse:VERTical:RANGe STIMulus Page Page 22 TDR/TDT Commands (Rev. A.06.00 and Above) TDR/TDT Commands Table 22-1. TDR/TDT Commands Page CONNect DUT:DIRection DUT:TYPE Table 22-2. Device Type Arguments RESPonse:CALibrate Table 22-2. Device Type Arguments RESPonse:DISPlay RESPonse:RISetime Table 22-3. Examples of Command with Channel Identification RESPonse:RPLane? RESPonse:TYPE --------------------------------------------------------------= +()V() Impedance (V) Z 0 V ampl V RESPonse:VERTical RESPonse:VERTical:OFFSet RESPonse:VERTical:RANGe RESPonse:VLOad? STIMulus:EXTernal STIMulus:EXTernal:POLarity STIMulus:MODE STIMulus:RATE STIMulus:STATe Page Timebase Commands BRATe MPOSition POSition PRECision PRECision:RFRequency PRECision:TREFerence REFerence SCALe UNITs Page 24 Trigger Commands Trigger Commands ATTenuation BRATe BRATe:AUTodetect BWLimit DCDRatio DCDRatio:AUTodetect GATed HYSTeresis LEVel PLENgth PLENgth:AUTodetect PLOCk PLOCk:AUTodetect RBIT SLOPe 25 Waveform Commands Waveform Commands BANDpass? BYTeorder COUNt? DATA FORMat Page POINts? PREamble Table 25-1. Waveform Preamble Elements (1 of 2) Table 25-1. Waveform Preamble Elements (2 of 2) SOURce:CGRade TYPE? XDISplay? XINCrement? XORigin? XRANge? XREFerence? XUNits? YDISplay? YINCrement? YORigin? YRANge? YREFerence? YUNits? Page Waveform Memory Commands SAVE XOFFset XRANge YOFFset YRANge Index Index-1 A B C Index-2 Index-3 D Index-4 E F G H I J K L M Index-6 N O P Index-7 Q Index-8 R S Index-9 T Index-10 U V W X Y