Example 2 Reading back PACKed data HP Basic program | HP E1429A

DIAGnostic:FETCh?

∙Refer to the "Memory Management" section in Chapter 3 for information on where segmented readings are stored in memory.

∙Both channels can be fetched interleaved by specifying DIAG:FETC3?. When both channels are fetched, the channel 1 data is the first data point, and the count specified is the number of readings to be taken on each channel, and is thus limited to 1000 per channel.

∙The start_addr must be divisible by 4. If it is not, then the next lowest memory location divisible by 4 will be the actual start_addr used, i.e. a start_addr of 511 would be rounded down to be 508.

∙Data is sent back in binary block format with a header string preceeding the data. The header is made of the ascii string: #,number_of_digits,number_of_bytes -- where # indicates binary block data, number_of_digits is how many ascii digits make up the following byte count, and number_of_bytes is the byte count. After the header, the stream of data bytes occurs. Example 2 below shows how to accomodate the header string using the HP Rocky Mountain Basic programming language.

∙Related Commands: ABORt, FORMat, INITiate:IMMediate, ARM:STARt:COUNt, TRIGger:STARt:COUNt, SENSe:SWEep:POINts:DELay

∙*RST Condition: none

Example 1 Examining readings in a portion of memory

DIAG:FETC? 5200,300	Get 300 readings from channel 1, beginning
	at address 5200.

Example 2 Reading back PACKed data (HP BASIC program)

DIM Ndig$[1],Count$[9]	Dimension parameters for header
ASSIGN @X TO 70905;FORMAT OFF

Turn format off for array data

OUTPUT 70905;"DIAG:FETC1? 5200,300" Query for channel 1 measurement data

ENTER @X USING "#,X,K,K";Ndig$;Count$[1;VAL(Ndig$)]

Strip the header preceeding the data

ALLOCATE INTEGER Meas_data(1:VAL(Count$)/2)

	Allocate an array to hold the data
ENTER @X;Meas_data(*)	Read in the measurement data
ENTER 70905 USING "B";Junk	Need to strip off left over line feed

DIAGnostic Subsystem

Command Reference 219

Image 219

HP E1429A manual Example 2 Reading back PACKed data HP Basic program, Assign @X to 70905FORMAT OFF

Contents

Contents HP E1429A/B Digitizer User’s Manual Contents ARM Data Period Value Table ESR? Contents HP E1429A/B Digitizer User’s Manual HP E1429A/B Digitizer User’s Manual Contents HP E1429A/B 20 MSa/s 2-Channel Digitizer User’s Manual Documentation History According to ISO/IEC Guide 22 and EN March 1 HP E1429A/B 20 MSa/s 2-Channel Digitizer User’s Manual HP E1429A/B Features and VXIbus Configuration Chapter Contents Getting Started Chapter HP E1429A/B VXIbus Configuration HP E1429A/B VXIbus Configuration Assigning the Digitizer to a Commander Preparation for UseDigitizer Logical Address HP E1429A/B Logical Address Switch Location Installing the Digitizer Digitizer Bus Request LevelBus Request Level Guidelines Addressing the Digitizer over HP-IB Addressing the Digitizer using an Embedded Controller Sending the *IDN? Command Introductory ProgramsHEWLETT-PACKARD,E1429A,0,A.02.00 TST? IOOUTPUTSADDR, *IDN? Repeat Output 70905SYSTERR? SLFTST.C IOOUTPUTSADDR, DIAGTEST? Resetting Clearing DigitizerIOOUTPUTSADDR, *TST? IOOUTPUTSADDR, SYSTERR? IOOUTPUTSADDR, *RST*CLS Subend Repeat Querying Digitizer ConfigurationLRN? Integer LRN.C Chapter Getting Started TRIGSTARTIM1 10E-6 Instrument and Programming Languages OUTPEXT1STAT Ontrigsour EXT1OUTPEXT1STAT OFF Language Programs ∙ Turbo C++ Command Line CompilingMicrosoft QuickC clhpib.lib ∙ Microsoft QuickC CLHPIB.LIB Compiling in the Integrated Environment Other subsystems Introduction to Programming Using the MEASure CONFigure Commands Port HP E1429A Programming Sequence Programming Sequence Using MEASure Configuring the ChannelsHow to Make Measurements MEAS.C Can be used to set the desired number of pre-arm readings SENS1SWEOFFSPOIN Taking Readings After Using CONFigure CONF.C IOOUTPUTSADDR, FETC1? Querying Command Settings QUERY.C Enable Intr ERRORCHK.C Abort Digitizer Command Module Deadlock Where to go Next Programming Language Using the Digitizer INPUT.C Configuring the Digitizer Input ARMCNT.C Taking a Burst of Readings ARMLEVEL.C Level Arming Pre- and Post-Arm Readings PREPOST.CARMSOUR1 EXT Trigsour TIM Specifying a Sample RateSAMPLE.C ARMSOUR1 IMM Senssweoffspoin Dual Rate SamplingDUALSAMP.C ARMSLOP1 POS Using Multiple Digitizers MULTAD.C OUTPTTLT0STAT on OUTPTTLT0IMMFETC2? PACKED.C Using the Packed Data Format Diagchanlab Form Pack For i = 0 i 20 i++ IOOUTPUTSADDR, SYSTERR? VMEREAL.C VME Bus Data Transfers Trigstarsour VME Vinsconfvmemode GENVinsconfvmefeed ’CONVCHAN1’ On Next Using the Digitizer Chapter VMESEG1.C Armstarcoun Armstarsour IMM On Next IOOUTPUTSADDR, *RST*CLS IOOUTPUTSADDR, SYSTERR? DOS VME Bus Data Transfers Using an Embedded Controller On Next Using the Digitizer Chapter On Next On Next INST.H #include Files Inst INST.CPP On Next Chapter Using the Digitizer E1429.CPP E1429.H Local Bus Data Transfers Formdata Pack VinslbusresVinslbusmode GEN Vinslbusfeed ’CONVBOTH’ IOOUTPUTSADDR, Init IOOUTPUTSADDRMEM, Init Using the Digitizer Chapter Chapter Using the Digitizer On Next Vinslbusmode APP Vinslbusfeed ’MEMCHAN1’ IOOUTPUTSADDRA, Init IOOUTPUTSADDRG, InitIOOUTPUTSADDRG, *OPC? On Next Using the Digitizer Chapter On Next Vinslbusfeed ’CONVCHAN1’ Armstarsour TTLT0 Vinslbusmode INS OUTPTTLT0FEED ’READY’ IOOUTPUTSADDRG, Init IOOUTPUTSADDRG, *OPC?,5 IOOUTPUTSADDRI, Init Using the Digitizer Chapter Chapter Using the Digitizer Using the Digitizer Chapter STATUS.C Using the Digitizer Status Registers Using the Digitizer Chapter Understanding the Digitizer HP E1429 Digitizer Block Diagram Understanding the HP E1429 Digitizer Chapter Message and Register Interfaces Digitizer Command Paths Digitizer Input Section Scpi Command Control SENSechan VOLTage Range range Setting the Input Impedance Enabling the 10 MHz Input FilterInverting and Non-inverting Differential Input Ports Digitizer Attenuators Setting the Signal Range Sensvoltrang Using the Single-Ended Input 1V Range Arming and Triggering HP E1429 Digitizer State Diagram ARM-TRIG State Diagram HP E1429 Digitizer Arming and Triggering ARM STARtSEQuence1 Set positive or negative transition Arm Window Boundaries Arm Level Range ARM Synchronization Signals OUTPutEXTernal1FEED source Enabling the Synchronization Signal Routing the Signal to a Source Offset Triggering Digitizer TRIGgerSTARtTIMer1 period Chapter Understanding the HP E1429 Digitizer Digitizer Reference Clock SourceSpecifying the External Reference Frequency TRIGgerSTARtCOUNt count SENSechan SWEepPOINts count Trigger Synchronization Signals OUTPutEXTernal1FEED source Routing the Signal to a Source Data Flow, Storage, and Conversions Analog-to-Digital Converter HP E1429 Digitizer Data Flow HP E1429 Digitizer Reading Storage 10. Memory Segments with Pre and Post-arm Readings MEMory Subsystem Digitizer Data Formats Determining the Battery Charge Definite Length Arbitrary Block Header Packed Reading Conversions HP Basic Example Removing the Arbitrary Block Header Language Example 16-bit readings Readings READ? 11. Retrieving Readings from Digitizer Memory FETChing Readings from Memory Retrieving Readings UsingRetrieving Readings Using FETCh? READ? Separating Pre- and Post-Arm Readings Determining Number of Readings FETChed Using DIAGnosticUPLoad SADDress? DIAGnostic Subsystem Memory ManagementLocating Unsegmented Readings Locating Segmented Readings ARMSTARtCOUNtMaximum Readings Ending segment address = segmentnumber * 65536 Therefore, the DIAGnosticFETCh? command would be executed as Locating the Data Register 12. Digitizer Registers in A16 and A24 Address Space Base Address Execute the following HP E1406 Command Module command On Next Data Register Offset VINStrument Subsystem VMEDATA? Setting the VME bus Data Source Segmented Reading Transfers Understanding the HP E1429 Digitizer Chapter Multiple VME Bus Data Transfers Local Bus Description 14. Local Bus Signal Line Definitions 15. HP E1429B Local Bus Data Transfer Protocol How Data is Transferred Understanding the HP E1429 Digitizer Chapter Send Digitizer Local Bus CommandsLocal Bus Transfer Configurations Lbus Multiple Digitizers and Serial Transfers EOF EOB D3 D3 D3EOF EOB D1 D1 D1 Digitizer Configuration Restrictions Setting the Local Bus Transfer Mode Setting the Local Bus Data Source Multiple Local Bus Data Transfers Status Subsystem Commands Digitizer Status RegistersStatus System Registers 16. HP E1429 Status Groups and Associated Registers Questionable Signal Status Group Condition RegisterReading the Condition Register Operation Status Group Enable Register STATusOPERationCONDition? CME EXE DDE QYE Standard Event Status GroupStandard Event Status Register PON ESE? Standard Event Status Enable RegisterReading the Standard Event Status Register ESR? Status Byte Status Group Status Byte RegisterOper RQS ESB MAV Ques STB? Spoll Presetting the Enable Register and Transition FilterService Request Enable Register Reading the Status Byte Register Saving Digitizer Configurations Synchronizing the DigitizerOPC OPC? WAI RST How to Save and Recall a Configuration Understanding the HP E1429 Digitizer Chapter Command Reference Common Command Format Command Types Armlevneg Scpi Command FormatAbbreviated Commands ARM Scpi Command Parameters Implied Optional Keywords Variable Command SyntaxParameter Types Explanations, Examples OUTPECLT0FEED ’EXT’ OUTPECLT0FEED \EXT\ Definite length block Scpi Command ExecutionQuerying Parameter Settings Optional Parameters Executable When Initiated Commands MIN and MAX Parameters in Coupled CommandsArmcoun Trigcoun MAX Scpi Command Reference Linking Ieee 488.2 Common CommandsLinking Multiple Scpi Commands Example Aborting a measurement ∙ Executable when initiated Yes ∙ Coupled Command NoABORt ABORt ARM Subsystem ARMSTARtCOUNtSTARtCOUNt Syntax Parameters Parameter Range Default Name Type Values ARMSTARtCOUNt MINimumMAXimum ARMSTARtDELaySTARtDELay Parameter Range Default Name Type Values ∙ *RST Condition none Example Setting the arming delayARMSTARtIMMediate STARtIMMediate Comments ∙ Executable while initiated No ARMSTARtLEVelchanNEGative voltageSTARtLEVelchanNEGative voltage Example Arming for measurement STARtLEVelchanPOSitive voltage ARMSTARtLEVelchanPOSitive voltage STARtSLOPen ARMSTARtSLOPen Example Setting the arm slope ARMSTARtSOURcen Example Setting two arm start sources ∙ Related Commands ARMSTARtSLOPen , ARMSTARtLEVelchan Numeric None CALibrationchanCOUNt? Subsystem Syntax Data CALibrationchanDATA Assign @X to 70905FORMAT OFF Comments ∙ Executable when initiated No ∙ Coupled Command No DELay CALibrationchanDELay Gain CALibrationchanGAIN Seconds Confarrvolt 100,4.8,DEF,@1 ∙ *RST Condition none Example Performing a gain calibration CALibrationchanSECureCODE CALibrationchanSECureSTATe CALibrationchan SECureSTATe mode ,code enables or disables CALibrationchanSTORe Example Turn automatic storage of calibration values off CALibrationchan STOReAUTO mode selects whether or notCALibrationchanSTOReAUTO VALue ∙ Related commands CALibrationGAIN CALibrationchanVALueNumeric 101.80 to Volts Example Setting the calibration value CALibrationchanZEROZero CAL1ZERO DEF,DEF,ALL CONFigurechan CONFigurechanARRayVOLTageDC size,expectedARRayVOLTageDC CONFigurechanARRayVOLTageDC Range Volts Value Maximum Voltage Resolution CONFARRayVOLT 20,1.5,@3 CALibrationchan CONVerge? DIAGnostic DIAGnosticCALibrationchan GAINSENSitivity? CALibrationchan ZEROSENSitivity?CHANnelchan LABel DIAGnosticFETCh? ∙ Coupled Command No ∙ Related Commands ABORt, FETCh?Example 1 Tagging the data with channel number Example 2 Reading back PACKed data HP Basic program DIAGnosticMEMorychanFILL DIAGnosticMEMorychan Fill numsegments, count sets upMEMorychanADDResses? DIAGnosticPEEK? PEEK?Thru Ffffff None Poke DIAGnosticPOKEExample Examining the setting of the traffic register Example Changing the contents of the traffic register TEST? DIAGnosticSGET?SGET? Sput FETChchan Command Reference FETChchan Subsystem FETChchan Subsystem Command Reference FETC1COUN? FETChchanCOUNt? ∙ *RST Condition none Example Recovering readings in memory FETChchanRECover? Subsystem FORMat FORMat ∙ Related Commands READ?, FETCh? Example 1 Setting the data format to 64 bit realsFORMatDATA IMMediate INITiate Example Placing the HP E1429A in the wait-for-arm state INITiateIMMediate Subsystem INPutport INPutport Example Enabling the 10 MHz low-pass filter INPutportFILTerLPASsSTATe mode enables or disablesINPutportFILTerLPASsSTATe IMPedance Example Setting 75 Ω input impedance INPutportSTATeSTATe Example Disabling input port MEASurechan ARRayVOLTageDC?MEASurechanARRayVOLTageDC size,expected MEASurechanARRayVOLTageDC? Maximum Voltage Resolution MEAS1ARRayVOLT? 20,1.5,@3 ∙ *RST Condition not affected BATTerySTATeExample Enable memory to be non-volatile MEMory ∙ *RST Condition none Example Check the battery charge MEMoryBATTeryCHARge? ECLTrgnFEED OUTPut ∙ *RST Condition Example Setting the ECLTrg0 sync pulse sourceOUTPutECLTrgnSTATe ECLTrgnSTATe Boolean Parameter Range Default Name Type Values UnitsOUTPutEXTernal1FEED EXTernal1FEED TRIGgerSTARtSEQuence1 ARMSTARtSEQuence1 None RFTRigger SENSe12ROSCillator TTLTrgnFEED Example Setting the sync pulse sourceOUTPutEXTernal1STATe EXTernal1STATe Example Enabling sync pulse for READy on TTLTrg5 OUTPutTTLTrgnFEEDNumeric Through None ARMSTARtSEQuence1 None Example Enabling sync pulse output to TTLTRG0* and TTLTRG5 OUTPutTTLTrgnSTATe READchan READchan Subsystem Command Reference Command Reference READchan Subsystem SENSe SENSechanFUNCtion SENSechanFUNCtion Example Selecting the single ended input on channel SENSechanFUNCtion SENSechanFUNCtion EXTernalFREQuency SENSechanROSCillator SOURce SENSechanROSCillatorSOURce Example Setting the Reference Oscillator Source SENSechan SWEep SENSechan SWEepOFFSetPOINts count OFFSetPOINts countNumber Maximum Number Memory Segments Example Setting 50 pre-arm readings on channel 1, input port MINimum selects 1 reading SENSechan SWEepPOINts count Example Setting 500 readings SENSechanVOLTageDC RANGeSENSechan VOLTageDCRANGe range selects the range for Range Measurement Resolution Allowable Setting Volts Ports Comments ∙ Executable when initiated YesSENSechanVOLTageDC RANGe SENSechanVOLTageDC RESolution? RESolution?Example Selecting the 102.35 Volt range on channel Operation Status Register STATus Subsystem Syntax Questionable Signal Status Register STATusOPCINITiateOPCINITiate OPERationQUEStionableENABle STATusOPERationQUEStionableCONDition?OPERationQUEStionableCONDition? Through +32767 None Non-decimal Numeric Example Setting the Operation register enable maskSTATusOPERationQUEStionableEVENt? OPERationQUEStionableEVENt? OPERationQUEStionablePTRansition STATusOPERationQUEStionableNTRansition PRESet STATusPRESet VERSion? ERRor?Example Reading the error queue SYSTem TRIGger Command Reference TRIGger Subsystem TRIGger Subsystem Command Reference TRIGgerSTARtCOUNt Example Taking 20 readings 8 pre-arm and 12 post-arm STARtSOURce TRIGgerSTARtIMMediate Bushold TRIGgerSTARtSOURce Reference period to TRIGgerSTARtTIMer1STARtTIMer1 Example Setting the start trigger source TRIGgerSTARtTIMer1 Multiple Period STARtTIMer2Period Value Table ∙ *RST Condition 5.0E-8 seconds TRIGgerSTARtTIMer2 ∙ *RST Condition 1.0E-7 seconds Local Bus transfers VINStrument Data voltagelist VME VXI data transfer Bus transfers VINStrument CONFigureLBUSFEED CONFigureLBUSMEMoryINITiate VINStrumentCONFigureLBUSMEMoryINITiate CONFigureLBUSMODE VINStrumentCONFigureLBUSMODE APPendGENerate None INSertOFF PIPeline VINStrumentCONFigureLBUSRESetCONFigureLBUSRESet Example Setting the Local Bus operation mode CONFigureLBUSSENDPOINts VINStrumentCONFigureLBUSSENDPOINts VINStrumentCONFigureLBUSSENDPOINtsAUTO CONFigureLBUSSENDPOINtsAUTOBoolean On OFF None VINStrumentCONFigureTESTDATA CONFigureTESTDATAVINStrumentCONFigureTESTDATA voltagelist configures ∙ *RST Condition none Example Testing Local Bus operation VINStrumentCONFigureVMEFEED CONFigureVMEMEMoryINITiate VINStrumentCONFigureVMEMEMoryINITiate CONFigureVMEMODE VINStrumentCONFigureVMEMODE GENerateOFF None VINStrumentCONFigureVMESENDADDRessDATA?CONFigureVMESENDADDRessDATA? Example Setting the VXIbus data transfer bus operation mode HEWLETT-PACKARD Virtual INSTRUMENT,ANY ATOD,0,A.01.00 VINStrumentIDENtity? Category Command Title IEEE-488.2 Common Commands ∙ Executable when initiated Yes CLSDMC EMC and *EMC? ESE and *ESE?Example Define macro to start measurement String Example Enable all error eventsESR? GMC? HEWLETT-PACKARD,E1429,0,A.01.00 IDN?LMC? Example Query macro definition OPC LRN? OPC? PMCPUD and *PUD? Block Through 63 characters None Data String RCL RST RMC SRE and *SRE? SAV TRG STB? WAI TST? Command Quick Reference Chapter Chapter Command Quick Reference Unmask VINStrument Scpi Conformance Information Scpi Confirmed Commands Chapter Scpi Conformance Information Scpi Conformance Information Chapter Appendix Contents Specifications Number of Partitions Read-OutTo VME Bus To Local Bus E1429B only Total Readings per Partition Amplitude Characteristics Signal Conditioning Filtering Signal-to-Noise RatioOutput Formats Gain and Offset 4.3.1, note Integral Nonlinearity 4.4.3, Note Converter Supplemental CharacteristicsSingle-ended inputs Connector BNC Word Error Rate 4.15 qualified error level word error rate Crosstalk between channels Single-ended inputs, supplemental characteristicsAnalog Bandwidth 4.6.1 filter off Effective bits on different ranges Appendix a Specifications Effective bits, relative to 1V single-ended range Differential Inputs, supplemental characteristics Frequency Sample Rate Characteristics Internal Timer Trigger Sample Clock SubsystemCrosstalk Timebase and Trigger additional supplemental characteristics Bus Access and Connectors General Characteristics EMC Specifications Appendix a Useful Tables RSTCLS.C ERRORCHK.CIDN.C HP BASIC, C SLFTST.C STATUS.C LOCALAD.CLBUS2PST.C LBUSAUTO.C CAL1VAL Mode OFFEMC Calstorauto POS DELSour SLOP1 Table B-3. HP E1429A/B Error Messages Code Description Appendix B Useful Tables Useful Tables Appendix B Appendix B Useful Tables Local bus test data size not Register Programming System Configuration Register reads and writes are 8-bits Reading and Writing to the Registers Figure C-1. HP E1429A/B A24 Address Space Addressing the Registers Determining the A24 Base Address Appendix C Register Programming A24READ.C Register Descriptions See A24 Register Table Base + Base +0316 Input Configuration RegistersA/D Status Register A/D Serial Register A/D Parallel Strobe Register A/D Shift RegisterBase +0B16 Bit Name Function Base + Arm and Trigger Configuration RegistersAbort and Arm Immediate Register Arm Status Register Timebase Initiation Registerbase + Arm Source Register Power-on/Reset Settings Arm Internal Bus Registerbase +Arm Source Register Arm Control Register Power-on/Reset Settings Arm Control RegisterBase + 4B16 Trigger Source Register Power-on/Reset Settings Trigger Source RegisterBase + 4D16 Register Programming Appendix C Reference Oscillator Register Power-on/Reset Settings Reference Oscillator RegisterBase + 4F16 Arm delay Register Base + 5116 and base +5316 Arm Count Register Base + 5516 and base +Arm Count Latch Register Base +6116 Trigger Immediate Registerbase + 5D16Decade Division Register Binary Division Register Base + 7316 and base + Pre-Arm Reading Count Register power-On/Reset SettingsPost-Arm Reading Count Register power-On/Reset Settings Pre-Arm Reading Count Registers Base +0216 Traffic Register Power-on/Reset SettingsMemory Control Registers Traffic Register Pulse Register Channel ID RegisterData Register Memory Control Register Power-on/Reset Settings Memory Control RegisterBase +2116 Base +2316 to base +2716 Memory Address Registers Base +2D16 and base +2F16 Terminal Address RegisterBase Address Registers Base +2B16 Figure C-2. Accessing the A/D Shift Register Using the A/D Shift Register Bit Name Setting Enabling the 10 MHz Filter Setting Measurement RangeSetting the Input Impedance Procedure Input Post 14 dB Attenuator Bits Bits 34 Bits 35 37,45 38,46 Checking the Idle State Setting the Arm Sources Setting the Digitizer Configuration Setting the Arm Delay Setting the Arm Count Setting the Reference Source Sending an Arm Immediate Signal Setting the Trigger Source Aborting Measurements Sending a Trigger Immediate Signal Initializing Digitizer Memory Re-initiating the Digitizer Appendix C Register Programming MSB LSB Initializing Initiating Timebase Processor Data source Timebase resetTrigger count Sample rate Count is 1 and the post-arm count is y-3 Midsb LSB Register Programming Appendix C Initializing Digitizer Memory to Retrieve Data Retrieving Data from Memory Register Programming Appendix C MSB LSB Example Program Appendix C Register Programming REGPROG.C IOOUTPUTSADDR, READ? On Next On Next On Next On Next On Next On Next On Next On Next On Next On Next On Next Void checkerrorchar *function Char Into161 Length = Register Programming Appendix C Interleaved Transfers Local Bus Interleaved Transfers Local Bus Interleaved Transfers Appendix D Setting Interleaved Transfer Mode Procedure LBUSINTR.C OUTPECLT0FEED ’TRIG’ Trigstarsour ECLT0Trigstarsour TIM Trigstartim 1E-6 Tracdef SET1 Store readings 80 bytes in SET1 IOOUTPUTSADDRMEM, *OPC? IOOUTPUTSADDRG, AborIOOUTPUTSADDRI, Abor Local Bus Interleaved Transfers Appendix D Appendix D Local Bus Interleaved Transfers Local Bus Interleaved Transfers Appendix D HP E1429A/B User’s Manual Index Index Index HP E1429A/B User’s Manual HP E1429A/B User’s Manual Index Index HP E1429A/B User’s Manual Scpi Index HP E1429A/B User’s Manual