SAVEWAVeformLENGth | Agilent Technologies 5000 Series manual

Commands by Subsystem 3

:SAVE:WAVeform:LENGth

(see page 530)

Command Syntax :SAVE:WAVeform:LENGth <length>

<length> ::= 100 to max. length; an integer in NR1 format

The :SAVE:WAVeform:LENGth command sets the waveform data length (that is, the number of points saved).

Query Syntax :SAVE:WAVeform:LENGth?

The :SAVE:WAVeform:LENGth? query returns the specified waveform data length.

Return Format <length><NL>

<length> ::= 100 to max. length; an integer in NR1 format

See Also • "Introduction to :SAVE Commands" on page 263

•":SAVE:WAVeform[:STARt]" on page 273

•":WAVeform:POINts" on page 413

•":SAVE:WAVeform:FORMat" on page 274

Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference

275

Image 275

Agilent Technologies 5000 Series manual SAVEWAVeformLENGth, Return Format lengthNL

Contents

Agilent InfiniiVision Series Oscilloscopes Manual Part Number InfiniiVision 5000 Series Oscilloscope Models This BookPage Contents RUN 136 EXTernalUNITs Savepwd Sbusmode 364 TRIGgerLINID TRIGgerCANPATTernDATALENGth 327 TRIGgerCANPATTernID 367 Commands A-Z Obsolete and Dis Commands Error Messages Status Reporting Programming Examples Page Whats New Whats New in Version New Commands Obsolete Commands Changed Commands Changed Commands Version 4.00 at Introduction Whats New Command Summary Syntax Elements Commands Quick Reference Common * Commands Summary Command Summary ESB Root Commands Summary Format MERGe pixel memory Pixel memory = PMEMory0 ACQuire Commands Summary CHANneln Commands Summary CALibrate Commands Summary Norm Trip EXTernal Trigger Commands Summary DISPlay Commands Summary FUNCtion Commands Summary Subt Mult None HARDcopy Commands Summary Math MARKer Commands Summary MEASure Commands Summary MEASure Commands Summary None Returnvalue = voltage at RECall Commands Summary Save Commands Summary Sbusuartbase Sbus Commands Summary SYSTem Commands Summary General TRIGger Commands Summary TIMebase Commands Summary TRIGgerMODE mode TRIGgerMODE? see Mode = Edge GLITch TRIGgerCAN Commands Summary TRIGgerDURation Commands Summary TRIGgerGLITch Commands Summary TRIGgerEDGE Commands Summary TRIGgerIIC Commands Summary TRIGgerLIN Commands Summary TRIGgerTV Commands Summary TRIGgerUART Commands Summary WAVeform Commands Summary Aver Hres WAVeformUNSigned WAVeformUNSigned? OFF Syntax Elements Digits Angle BracketsEllipsis Value Ranges Bytes of data is the actual data Commands by Subsystem Command Types Three types of commands are used Common * Commands ESB MSS T E MAV message available bit are cleared Command Syntax *CLSCLS Clear Status See Standard Event Status Enable ESE ESE Standard Event Status Enable Query Syntax *ESE? Standard Event Status Register ESR ESR Standard Event Status RegisterQuery Syntax *ESR? Return Format statusNL Query Syntax *IDN? IDN Identification Number Query Syntax *LRN? Return Format LRN Learn Device Setup See Also Introduction to Common * Commands onOPC Operation Complete Query Syntax Query Syntax *OPT? OPT Option Identification RCL Recall Command Syntax *RCL valueSee Also Introduction to Common * Commands on SAV Save on Command Syntax *RST RST Reset Display Menu See Also Introduction to Common * Commands on SAV Save Command Syntax *SAV valueSee Also Introduction to Common * Commands on RCL Recall on Service Request Enable Register SRE SRE Service Request EnableCommand Syntax *SRE mask Register Status Byte Register STB STB Read Status ByteQuery Syntax *STB? Return Format valueNL MSS Poll TRG Trigger Command Syntax *TRGSee Also Introduction to Common * Commands on DIGitize on TST Self Test WAI Wait To Continue Command Syntax *WAI Root Commands OVLenable mask OVLenable? see Mask = 16-bit integer in NR1 Root Command tree Query Syntax AER? AER Arm Event Register AUToscale Command Syntax AUToscale AUToscaleAMODE on ACQuireTYPE on Introduction to Root Commands onAUToscaleAMODE AUToscale on View on BLANk on AUToscaleCHANnels Example Code Example Code on BLANkOn/off a channel, etc Math is an alias for FUNCtion CDISplay Command Syntax CDISplaySee Also Introduction to Root Commands on DISPlayCLEar on DIGitize See Also Introduction to Root Commands onACQuire Commands on WAVeform Commands on Commands by Subsystem Hardware Event Enable Register HWEenable HWEenable Hardware Event Enable Register Commands by Subsystem Hardware Event Condition Register HWERegisterCONDition Hardware Event Condition Register Commands by Subsystem Hardware Event Event Register HWERegisterEVENt Hardware Event Event Register Commands by Subsystem MERGe Operation Status Enable Register Opee Opee Operation Status Enable RegisterCommand Syntax Opee mask AER Arm Event Register on Operation Status Condition Register OPERegisterCONDition Operation Status Condition Register OVLRegister Overload Event Register on Operation Status Event Register OPERegisterEVENt Operation Status Event Register 110 Overload Event Enable Register OVL OVLenable Overload Event Enable RegisterCommand Syntax Query Syntax OVLenable? Overload Event Register Ovlr OVLRegister Overload Event RegisterQuery Syntax OVLRegister? You can also set external trigger input impedance to 50Ω 114 PRINt RUN Command Syntax RUN Query Syntax SERial? SERial SINGle Command Syntax SINGle CHANnelnDISPlay on FUNCtionDISPlay on STATus Stop Command Syntax Stop Query Syntax TER? TER Trigger Event Register View Command Syntax View source Averaging ACQuire CommandsNormal Peak Detect Real-time ModeEquivalent-time Mode Reporting the Setup ACQuireAALias ACQuireCOMPlete ACQuireCOUNt ACQuireAALias on Introduction to ACQuire Commands onACQuireDAALias ACQuireMODE See Also Introduction to ACQuire Commands on ACQuireTYPE on ACQuirePOINts ACQuireSRATe ACQuireTYPE Commands by Subsystem CALibrate Commands CALibrateDATE Introduction to CALibrate Commands on Return Format stringNL See Also Introduction to CALibrate Commands onCALibrateLABel CALibrateSTARt CALibrateSTATus CALibrateSWITch CALibrateTEMPerature CALibrateTIME CHANneln Commands Obsolete CHANnel subsystem is supported Reporting the Setup 144 CHANnelnBWLimit Introduction to CHANneln Commands on CHANnelnCOUPling See Also Introduction to CHANneln Commands on View on BLANk on STATus on CHANnelnDISPlay CHANnelnIMPedance CHANnelnINVert DISPlayLABList on CHANnelnLABelCharacters are converted to upper case DISPlayLABel on Return Format offsetNL CHANnelnOFFSet CHANnelnPROBe Return Format probe idNL CHANnelnPROBeID CHANnelnPROBeSKEW CHANnelnPROBeSTYPe CHANnelnPROTection Example Code CHANnelnRANGe CHANnelnSCALe Return Format unitsNL CHANnelnUNITs CHANnelnVERNier Commands actions DISPlay Commands Displab 0CONN 1PERS Minsour PMEM9 DISPlayCLEar Command Syntax DISPlayCLEarSee Also Introduction to DISPlay Commands on CDISplay on DISPlayDATA Only valid values for palette are GRAYscale or COLor Palette parameter is MONOchrome CHANnelnLABel on Introduction to DISPlay Commands onDISPlayLABel Added DISPlayLABList DISPlayPERSistence DISPlaySOURce See Also Introduction to DISPlay Commands on DISPlayDATA on DISPlayVECTors EXTernal Trigger Commands 172 TRIGgerHFReject on Introduction to EXTernal Trigger Commands onIntroduction to TRIGger Commands on EXTernalBWLimit EXTernalIMPedance EXTernalPROBe EXTernalPROBeID See Also Introduction to EXTernal Trigger Commands on EXTernalPROBeSTYPe EXTernalPROTection EXTernalRANGe CHANnelnUNITs on EXTernalUNITs FUNCtion Commands Funcoper Subtdisp 0RANG +8.00E+00OFFS +0.00000E+00 Longer track the TIMebaseRANGe value FUNCtionCENTer FUNCtionDISPlay Introduction to FUNCtion Commands on FUNCtionOFFSet FUNCtionOPERation See Also Introduction to FUNCtion Commands on Return Format rangeNL FUNCtionRANGe Return Format levelNL FUNCtionREFerence FUNCtionSCALe FUNCtionOPERation on FUNCtionSOURce Return Format spanNL FUNCtionSPAN FUNCtionWINDow HARDcopy Commands Hardapr Area Scrfact 0FFE 0INKS 0PAL None Return Format areaNL HARDcopyAREA HARDcopyAPRinter Return Format factorsNL HARDcopyFACTors HARDcopyFFEed HARDcopyINKSaver HARDcopyPALette Return Format listNL HARDcopyPRinterLIST HARDcopySTARt Command Syntax HARDcopySTARt MARKer Commands MARKX1Y1 NONEX2Y2 Nonemode OFF Return Format modeNL MARKerMODEQuery Syntax MARKerMODE? MARKerX2Position on Introduction to MARKer Commands onMARKerX1Position MARKerMODE on MARKerX1Y1source MEASureTSTOp on MARKerX2PositionMARKerX1Position on MARKerX2Y2source MARKerXDELta Front-panel Normal mode Return Format positionNL MARKerY1Position MEASureVSTOp on MARKerY2PositionMARKerY1Position on MARKerYDELta MEASure Commands Returnvalue = waveform 216 MEASure Commands Summary Measurement Error Measurement Setup Making Measurements MEASureCLEar Command Syntax MEASureCLEarSee Also Introduction to MEASure Commands on MEASureCOUNter? query This command is not available if the source is MathMEASureCOUNter MEASureDEFine MEASure Command DELay THResholds For threshold mode = PERCent MEASureDELay? query Return Format for measspec = DELay First of the following criteria MEASureDELayMEASureDEFine command 226 Source is FFT Fast Fourier Transform MEASureDUTYcycle MEASureFALLtime Return Format sourceNL MEASureFREQuency MEASureNWIDth MEASureOVERshoot MEASureVTOP on MEASureVBASe on MEASureVMIN on MEASurePERiod MEASurePHASe MEASurePREShoot MEASurePWIDth MEASureFALLtime on MEASureRISetime MEASureSDEViation MEASureSHOW MEASureSOURce Commands by Subsystem MEASureTEDGe MEASureTEDGe Code MEASureTVALue Commands by Subsystem MEASureVAMPlitude MEASureVAVerage MEASureVBASe MEASureVMAX MEASureVMIN MEASureVPP MEASureVRMS MEASureVTIMe MEASureVTOP MEASureXMAX MEASureTMIN on MEASureXMINMEASureXMAX on RECall Commands RECallFILename RECallIMAGeSTARt Query Syntax RECallPWD? See Also Introduction to RECall Commands on Savepwd onRECallPWD RECallSETupSTARt Save Commands Use SAVE? to query setup information for the Save subsystem SAVEFILename Internalloc option is only valid if SAVEIMAGeFORMat is Tiff SAVEIMAGeSTARt SAVEIMAGeAREA Introduction to Save Commands on SAVEIMAGeFACTors SAVEWAVeformFORMat on SAVEIMAGeFORMat SAVEIMAGeINKSaver SAVEIMAGePALette Query Syntax SAVEPWD? Savepwd SAVESETupSTARt SAVEWAVeformSTARt Return Format formatNL SAVEWAVeformFORMat Return Format lengthNL SAVEWAVeformLENGth Sbus Commands Decode option has been licensed Introduction to SBUSCANCOUNtERRor SBUSCANCOUNtOVERload SBUSCANCOUNtRESet SBUSCANCOUNtTOTal 241, Hardware missing on ErrorsSBUSCANCOUNtRESet on SBUSCANCOUNtUTILization SBUSDISPlay SBUSIICASIZe TRIGgerIIC Commands on SBUSLINPARity TRIGgerLIN Commands on TRIGgerMODE on TRIGgerSPI Commands onTRIGgerUART Commands on SBUSSPIWIDTh Sbusuartbase Returns the Uart error frame count SBUSUARTCOUNtERRor Resets the Uart frame counters SBUSUARTCOUNtRESet Returns the Uart Rx frame count SBUSUARTCOUNtRXFRames Returns the Uart Tx frame count SBUSUARTCOUNtTXFRames SBUSUARTFRAMing SYSTem Commands Query Syntax SYSTemDATE? See Also Introduction to SYSTem Commands on SYSTemTIME onSYSTemDATE SYSTemDSP See Also Introduction to SYSTem Commands on SYSTemERRor SYSTemLOCK Introduction to SYSTem Commands on SYSTemSETup 300 Return Format timeNL See Also Introduction to SYSTem Commands on SYSTemDATE onSYSTemTIME TIMebase Commands Timmode Mainref Centmainrang +1.00E-03POS +0.0E+00 TIMebasePOSition on Introduction to TIMebase Commands onRST Reset on TIMebaseMODE Return Format posNL TIMebasePOSition TIMebaseRANGe TIMebaseREFerence TIMebaseSCALe TIMebaseVERNier See Also Introduction to TIMebase Commands on TIMebaseWINDowPOSition TIMebaseWINDowRANGe TIMebaseWINDowSCALe Commands modes TRIGger Commands 314 Return Format General TRIGger Commands TRIGgerHFReject TRIGgerHOLDoff See Also Introduction to TRIGger Commands on TRIGgerMODE TRIGgerNREJect Mask, the edge takes precedence TRIGgerPATTern 322 TRIGgerSWEep This feature is called Mode on the instruments front panel TRIGgerCAN Commands EXTernal for DSO models TRIGgerCANPATTernDATALENGth on TRIGgerCANPATTernDATAIf more bytes are sent for value or mask than specified by AMS has been licensed TRIGgerCANSOURce on TRIGgerCANPATTernDATALENGthTRIGgerCANPATTernDATA on TRIGgerCANPATTernIDMODE on TRIGgerCANPATTernID TRIGgerCANPATTernIDMODE TRIGgerCANSAMPlepoint TRIGgerCANSIGNalBAUDrate TRIGgerCANSOURce Data TRIGgerCANTRIGger Query Syntax TRIGgerCANTRIGger? TRIGgerDURation Commands TRIGgerDURationGREaterthan TRIGgerDURationLESSthan TRIGgerDURationPATTern? query returns the pattern value TRIGgerDURationPATTern TRIGgerDURationQUALifier TRIGgerDURationRANGe TRIGgerEDGE Commands TRIGgerEDGECOUPling TRIGgerEDGESOURce on TRIGgerEDGELEVelIs not affected and the active source is not changed TRIGgerEDGECOUPling on TRIGgerEDGEREJect Example Code TRIGgerEDGESLOPeTRIGgerTVPOLarity on TRIGgerEDGESOURce TRIGgerGLITch Commands TRIGgerGLITchGREaterthan TRIGgerGLITchLESSthan TRIGgerGLITchLEVel Return Format polarityNL TRIGgerGLITchPOLarity TRIGgerGLITchQUALifier TRIGgerGLITchRANGe TRIGgerGLITchRANGe on TRIGgerGLITchSOURceTRIGgerGLITchLEVel on TRIGgerGLITchPOLarity on TRIGgerIIC Commands TRIGgerIICTRIGgerTYPE on TRIGgerIICPATTernADDRessTRIGgerIICPATTernDATA on TRIGgerIICPATTernDATa2 on TRIGgerIICPATTernADDRess on TRIGgerIICPATTernDATA TRIGgerIICPATTernDATa2 TRIGgerIICSOURceDATA on TRIGgerIICSOURceCLOCk TRIGgerIICSOURceCLOCk on TRIGgerIICSOURceDATA TRIGgerIICTRIGgerQUALifier TRIGgerIICTRIGgerTYPE Commands by Subsystem TRIGgerLIN Commands TRIGgerLINSOURce on TRIGgerLINSIGNalDEFinition onTRIGgerLINID TRIGgerLINTRIGger on Sample point values are not limited by the baud rate TRIGgerLINSAMPlepoint Return Format baudrateNL TRIGgerLINSIGNalBAUDrate TRIGgerLINSOURce Return Format stdNL TRIGgerLINSTANdard TRIGgerLINSYNCbreak TRIGgerLINTRIGger TRIGgerSPI Commands Summary TRIGgerSPI Commands Return Format slopeNL TRIGgerSPICLOCkSLOPe TRIGgerSPICLOCkTIMeout TRIGgerSPIFRAMing TRIGgerSPIPATTernDATA Return Format widthNL TRIGgerSPIPATTernWIDTh TRIGgerSPISOURceCLOCk TRIGgerSPISOURceDATA TRIGgerSPISOURceFRAMe TRIGgerTV Commands TV Trigger Line Number Limits TRIGgerTVLINE TRIGgerTVMODE Mode Old Forms Accepted TRIGgerTVSOURce on TRIGgerTVPOLarity TRIGgerTVSOURce Return Format standardNL TRIGgerTVSTANdard TRIGgerUART Commands 388 TRIGgerUARTBAUDrate TRIGgerUARTSOURceTX on TRIGgerUARTBITorderTRIGgerUARTSOURceRX on TRIGgerUARTBURSt TRIGgerUARTDATA TRIGgerUARTIDLE TRIGgerUARTPARity TRIGgerUARTPOLarity TRIGgerUARTQUALifier TRIGgerUARTBITorder on TRIGgerUARTSOURceRX TRIGgerUARTSOURceTX TRIGgerUARTTYPE TRIGgerUARTWIDTh WAVeform Commands WAVeformPREamble? Preambleblock = format Data Acquisition Types WAVeformWaveform Data and Preamble Analog Channel Data Helpful Hints Peak Data Data Format for Transfer Word format Data Format for Transfer ASCii format Data Format for Transfer Byte format WAVeformFORMat on Introduction to WAVeform Commands onWAVeformBYTeorder WAVeformDATA on WAVeformCOUNt WAVeformDATA Commands by Subsystem WAVeformFORMat Return Format # pointsNL WAVeformPOINtsInstead WAVeformPOINtsMODE on Even divisor of it WAVeformPOINtsMODE Return Format pointsmodeNL Pointsmode = NORMal MAXimum RAW WAVeformPREamble Format See Also Example Code Type Is FUNCtion or Math WAVeformSOURce Int16 0 = Byte = WORD, 2 = Ascii 422 Commands by Subsystem WAVeformSOURceSUBSource WAVeformTYPE WAVeformUNSigned Return Format viewNL WAVeformVIEW WAVeformPREamble on Example Code Example Code on WAVeformXINCrement WAVeformXORigin WAVeformXREFerence WAVeformYINCrement WAVeformYORigin WAVeformYREFerence 434 Commands A-Z CHANnelnBWLimit on EXTernalBWLimit on SBUSCANCOUNtERRor onHARDcopyAREA on SAVEIMAGeAREA on BURSt, TRIGgerUARTBURSt on DISPlayCLEar on MEASureCLEar on CALibrateDATE on SYSTemDATE on CHANnelnCOUPling on TRIGgerEDGECOUPling on EDGE, TRIGgerEDGE Commands on MEASureDELay on TIMebaseDELay onDURation, TRIGgerDURation Commands on SBUSUARTFRAMing on TRIGgerSPIFRAMing on HARDcopyFACTors on SAVEIMAGeFACTors onHARDcopyFILename on RECallFILename on SAVEFILename on HARDcopyIGColors on SAVEIMAGeINKSaver on SBUSIICASIZe on TRIGgerIIC Commands on TRIGgerDURationLESSthan on TRIGgerGLITchLESSthan on CHANnelnIMPedance on EXTernalIMPedance onINVert, CHANnelnINVert on SAVEWAVeformLENGth on TRIGgerCANPATTernDATALENGth on Commands A-Z MERGe on Mode Commands ACQuirePOINts on WAVeformPOINts on HARDcopyPALette on SAVEIMAGePALette onSBUSLINPARity on TRIGgerUARTPARity on PMODe, CHANnelnPMODe on CHANnelnPROTection on EXTernalPROTection on TIMebasePOSition on TIMebaseWINDowPOSition onPRINter, HARDcopyPRinterLIST on CHANnelnPROBe on EXTernalPROBe on Root Commands on RST Reset on SBUSCANCOUNtRESet on SBUSUARTCOUNtRESet on RECallSETupSTARt on SAVESETupSTARt on SYSTemSETup on TRIGgerLINSTANdard on TRIGgerTVSTANdard on SBUSSPIWIDTh on TRIGgerSPI Commands onSKEW, CHANnelnPROBeSKEW on TRIGgerEDGESLOPe on TRIGgerSPICLOCkSLOPe on SUBSource, WAVeformSOURceSUBSource on TOTal, SBUSCANCOUNtTOTal on TRG Trigger on 452 Sbusuartbase on SBUSUARTCOUNtERRor on TV, TRIGgerTV Commands on VERNier, CHANnelnVERNier on CHANnelnUNITs on EXTernalUNITs onUTILization, SBUSCANCOUNtUTILization on WAI Wait To Continue on 456 Obsolete and Dis Commands Obsolete and Dis Commands 305 or Dis Command Obsolete and Dis Commands CHANnelLABel CHANnel2SKEW CHANnelnINPut Previous oscilloscopes CHANnelnPMODe DISPlayCONNect ERASe ERASe command erases the screen EXTernalINPut EXTernalPMODe FUNCtionVIEW HARDcopyDESTination Return Format deviceNL HARDcopyDEVice HARDcopyFILename Previous oscilloscopes. Use the SAVEIMAGeFORMat see Commands insteadHARDcopyFORMat HARDcopyGRAYscale HARDcopyIGColors Return Format driverNL HARDcopyPDRiver MEASureLOWer MEASureSCRatch MEASureTDELta See page 222 instead MEASureTHResholds MEASureTMAX MEASureTMIN MEASureTSTArt MEASureTSTOp MEASureTVOLt Obsolete and Dis Commands MEASureUPPer MEASureVDELta MEASureVSTArt MEASureVSTOp PRINt? Print Option PRINt command PRINt? query Query Default PRINt? query is not a core command TIMebaseDELay query returns the current delay value TIMebaseDELay TRIGgerCANACKNowledge TRIGgerCANSIGNalDEFinition TRIGgerLINSIGNalDEFinition TRIGgerTVTVMode Error Messages Error Messages Error Messages 502 Error Messages 504 Error Messages 506 Status Reporting Status Reporting Status Reporting Data Structures 510 Status Reporting Status Byte Register STB Enabled event that occurs to generate a new SRQ interrupt Service Request Enable Register SRE Trigger Event Register TER Output Queue Message Queue Standard Event Status Register ESR Example Standard Event Status Enable Register ESE Error Queue Operation Status Event Register OPERegisterEVENt Operation Status Condition Register OPERegisterCONDition Arm Event Register AER Hardware Event Event Register HWERegisterEVENt Hardware Event Condition Register HWERegisterCONDition Clearing Registers and Queues QRR\RXZDQW WRGRVWDWXV Uhsruwlqj \HV Status Reporting Decision Chart 528 More About Oscilloscope Commands Obsolete Commands Command ClassificationsCore Commands Non-Core Commands Program Message Syntax Valid Command/Query Strings An EOS End Of String and EOT End Of Text terminator Long Form to Short Form Truncation Rules Simple Command Headers Common Command Headers Command Tree 536 More About Oscilloscope Commands 538 Save Uart More About Oscilloscope Commands 542 More About Oscilloscope Commands 488.2 Common Duplicate Mnemonics Tree Traversal Rules and Multiple Commands Multiple Program MessageParser Back to Selecting Infinity Places a Query Interrupted error in the error queueQuery Return Values All Oscilloscope Commands Are Sequential Programming Examples Sicl Example in C Programming Examples 552 Programming Examples 554 Programming Examples Byte Word = Ascii Type Float32 value of the voltage at center screen 558 Visa Example in C 560 Programming Examples 562 Programming Examples 564 Format 566 Programming Examples Main Program Visa Example in Visual Basic Programming Examples 570 Programming Examples 572 Programming Examples 574 Int32 specifies the data point associated with 576 Programming Examples Gpib Visa COM Example in Visual Basic Programming Examples 580 Programming Examples 582 Programming Examples 584 Programming Examples 586 Programming Examples 588 Index Index Enter pattern EOI end or identify HWEenable Markers Measurements, time between trigger and edge Pattern, 321, 326, 328, 338, 356, 357, 358 261 Stop, 96 TV mode, 383 TV trigger commands 598