Manuals / HP / Computer Equipment / Network Router

HP E1429A manual Introduction to Programming, Other subsystems

Models: E1429A

1 420

Download 420 pages 44.04 Kb

Page 33

Introduction to Programming

The SCPI commands used to program the digitizer are separated into two groups: common commands and subsystem commands. Common commands begin with an asterisk, and include commands such as *RST, *CLS, *OPC?. Chapter 4 contains a complete listing of the digitizer’s common commands.

Subsystem commands are those commands which configure the digitizer. Each subsystem is a set of commands that roughly corresponds to a functional block inside the digitizer. Figure 1-4 identifies the SCPI subsystems used with the digitizer.

*Arm source

*Arm count

*Arm delay

*Trigger source

* Trigger count * Sample rate

*Enable input

*Input impedance

*Input filter

other subsystems

CONFigure

MEASure

CALibration

DIAGnostic

OUTPut

STATus

SYSTem

* Digitizer reading format

* Non-volatile memory enable

*Reference oscillator source

*Pre- and post-arm reading count

* Measurement range

*Abort measurements

*Retrieve readings

* Initiate measurements

* VME bus data transfers * Local bus data transfers

Figure 1-4. HP E1429A/B Digitizer Command Subsystems

Chapter 1

Getting Started 33

Image 33

HP E1429A manual Introduction to Programming, Other subsystems

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 1HP E1429A/B 20 MSa/s 2-Channel Digitizer User’s Manual HP E1429A/B Features and VXIbus Configuration Chapter ContentsGetting Started Chapter HP E1429A/B VXIbus Configuration HP E1429A/B VXIbus ConfigurationAssigning 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 ControllerSending the *IDN? Command Introductory ProgramsHEWLETT-PACKARD,E1429A,0,A.02.00 TST? IOOUTPUTSADDR, *IDN?Repeat Output 70905SYSTERR? SLFTST.CIOOUTPUTSADDR, *TST? Resetting Clearing DigitizerIOOUTPUTSADDR, SYSTERR? IOOUTPUTSADDR, DIAGTEST?IOOUTPUTSADDR, *RST*CLS SubendLRN? Querying Digitizer ConfigurationInteger RepeatLRN.C Chapter Getting Started TRIGSTARTIM1 10E-6 Instrument and Programming LanguagesOUTPEXT1STAT Ontrigsour EXT1OUTPEXT1STAT OFF Language Programs Microsoft QuickC clhpib.lib Command Line Compiling∙ Microsoft QuickC ∙ Turbo C++CLHPIB.LIB Compiling in the Integrated EnvironmentOther subsystems Introduction to ProgrammingUsing the MEASure CONFigure Commands Port HP E1429A Programming Sequence Programming SequenceUsing 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 CONFigureCONF.C IOOUTPUTSADDR, FETC1? Querying Command Settings QUERY.C Enable Intr ERRORCHK.C Abort Digitizer Command Module DeadlockWhere to go Next Programming Language Using the DigitizerINPUT.C Configuring the Digitizer InputARMCNT.C Taking a Burst of ReadingsARMLEVEL.C Level ArmingPre- and Post-Arm Readings PREPOST.CARMSOUR1 EXT SAMPLE.C Specifying a Sample RateARMSOUR1 IMM Trigsour TIMDUALSAMP.C Dual Rate SamplingARMSLOP1 POS SenssweoffspoinUsing Multiple Digitizers MULTAD.C OUTPTTLT0STAT on OUTPTTLT0IMMFETC2? PACKED.C Using the Packed Data FormatDiagchanlab Form PackFor i = 0 i 20 i++ IOOUTPUTSADDR, SYSTERR? VMEREAL.C VME Bus Data TransfersTrigstarsour VME Vinsconfvmemode GENVinsconfvmefeed ’CONVCHAN1’ On Next Using the Digitizer Chapter VMESEG1.C Armstarcoun Armstarsour IMMOn Next IOOUTPUTSADDR, *RST*CLS IOOUTPUTSADDR, SYSTERR? DOS VME Bus Data Transfers Using an Embedded ControllerOn Next Using the Digitizer Chapter On Next On Next INST.H #include FilesInst INST.CPP On Next Chapter Using the Digitizer E1429.CPP E1429.HLocal Bus Data Transfers Vinslbusmode GEN VinslbusresVinslbusfeed ’CONVBOTH’ Formdata PackIOOUTPUTSADDR, Init IOOUTPUTSADDRMEM, InitUsing 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 TTLT0Vinslbusmode INS OUTPTTLT0FEED ’READY’IOOUTPUTSADDRG, Init IOOUTPUTSADDRG, *OPC?,5 IOOUTPUTSADDRI, InitUsing the Digitizer Chapter Chapter Using the Digitizer Using the Digitizer Chapter STATUS.C Using the Digitizer Status RegistersUsing the Digitizer Chapter Understanding the Digitizer HP E1429 Digitizer Block DiagramUnderstanding the HP E1429 Digitizer Chapter Message and Register Interfaces Digitizer Command PathsDigitizer Input Section Scpi Command ControlSENSechan VOLTage Range range Setting the Input Impedance Enabling the 10 MHz Input FilterInverting and Non-inverting Differential Input Ports Digitizer Attenuators Setting the Signal RangeSensvoltrang Using the Single-Ended Input 1V RangeArming and Triggering HP E1429 Digitizer State DiagramARM-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 SourceOffset Triggering DigitizerTRIGgerSTARtTIMer1 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 ConverterHP E1429 Digitizer Data Flow HP E1429 Digitizer Reading Storage 10. Memory Segments with Pre and Post-arm Readings MEMory SubsystemDigitizer Data Formats Determining the Battery ChargeDefinite Length Arbitrary Block Header Packed Reading ConversionsHP Basic Example Removing the Arbitrary Block HeaderLanguage Example 16-bit readings ReadingsREAD? 11. Retrieving Readings from Digitizer Memory Retrieving Readings Using FETCh? Retrieving Readings UsingREAD? FETChing Readings from MemorySeparating Pre- and Post-Arm Readings Determining Number of Readings FETChedUsing 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 AddressExecute 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 Definitions15. HP E1429B Local Bus Data Transfer Protocol How Data is TransferredUnderstanding the HP E1429 Digitizer Chapter Local Bus Transfer Configurations Digitizer Local Bus CommandsLbus SendMultiple 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 RegisterSTATusOPERationCONDition? Standard Event Status Register Standard Event Status GroupPON CME EXE DDE QYEReading the Standard Event Status Register Standard Event Status Enable RegisterESR? ESE?Status Byte Status Group Status Byte RegisterOper RQS ESB MAV Ques Service Request Enable Register Presetting the Enable Register and Transition FilterReading the Status Byte Register STB? SpollSaving Digitizer Configurations Synchronizing the DigitizerOPC OPC? WAI RST How to Save and Recall a ConfigurationUnderstanding the HP E1429 Digitizer Chapter Command Reference Common Command Format Command TypesAbbreviated Commands Scpi Command FormatARM ArmlevnegScpi Command Parameters Implied Optional Keywords Variable Command SyntaxParameter Types Explanations, Examples OUTPECLT0FEED ’EXT’ OUTPECLT0FEED \EXT\ Querying Parameter Settings Scpi Command ExecutionOptional Parameters Definite length blockExecutable When Initiated Commands MIN and MAX Parameters in Coupled CommandsArmcoun Trigcoun MAX Scpi Command Reference Linking Ieee 488.2 Common CommandsLinking Multiple Scpi Commands ABORt ∙ Executable when initiated Yes ∙ Coupled Command NoABORt Example Aborting a measurementARM STARtCOUNt ARMSTARtCOUNtSyntax SubsystemParameters Parameter Range Default Name Type ValuesARMSTARtCOUNt STARtDELay ARMSTARtDELayParameter Range Default Name Type Values MINimumMAXimumARMSTARtIMMediate Example Setting the arming delaySTARtIMMediate ∙ *RST Condition noneSTARtLEVelchanNEGative voltage ARMSTARtLEVelchanNEGative voltageExample Arming for measurement Comments ∙ Executable while initiated NoSTARtLEVelchanPOSitive voltage ARMSTARtLEVelchanPOSitive voltageSTARtSLOPen ARMSTARtSLOPenExample Setting the arm slope ARMSTARtSOURcen Example Setting two arm start sources ∙ Related Commands ARMSTARtSLOPen , ARMSTARtLEVelchanCOUNt? CALibrationchanSubsystem Syntax Numeric NoneData CALibrationchanDATAAssign @X to 70905FORMAT OFF Comments ∙ Executable when initiated No ∙ Coupled Command NoDELay CALibrationchanDELayGain CALibrationchanGAINSeconds Confarrvolt 100,4.8,DEF,@1 ∙ *RST Condition none Example Performing a gain calibrationCALibrationchanSECureCODE CALibrationchanSECureSTATe CALibrationchan SECureSTATe mode ,code enables or disablesCALibrationchanSTORe CALibrationchanSTOReAUTO CALibrationchan STOReAUTO mode selects whether or notVALue Example Turn automatic storage of calibration values off∙ 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 ResolutionCONFARRayVOLT 20,1.5,@3 CALibrationchan CONVerge? DIAGnosticDIAGnosticCALibrationchan 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 Example Examining the setting of the traffic register DIAGnosticPOKEExample Changing the contents of the traffic register PokeSGET? DIAGnosticSGET?Sput TEST?FETChchan Command Reference FETChchan SubsystemFETChchan 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 INITiateExample Placing the HP E1429A in the wait-for-arm state INITiateIMMediateSubsystem INPutport INPutportINPutportFILTerLPASsSTATe INPutportFILTerLPASsSTATe mode enables or disablesIMPedance Example Enabling the 10 MHz low-pass filterExample Setting 75 Ω input impedance INPutportSTATeSTATe Example Disabling input port MEASurechan ARRayVOLTageDC?MEASurechanARRayVOLTageDC size,expected MEASurechanARRayVOLTageDC? Maximum Voltage Resolution MEAS1ARRayVOLT? 20,1.5,@3 Example Enable memory to be non-volatile BATTerySTATeMEMory ∙ *RST Condition not affected∙ *RST Condition none Example Check the battery charge MEMoryBATTeryCHARge?ECLTrgnFEED OUTPutOUTPutECLTrgnSTATe Example Setting the ECLTrg0 sync pulse sourceECLTrgnSTATe ∙ *RST ConditionOUTPutEXTernal1FEED Parameter Range Default Name Type Values UnitsEXTernal1FEED BooleanTRIGgerSTARtSEQuence1 ARMSTARtSEQuence1 None RFTRigger SENSe12ROSCillatorOUTPutEXTernal1STATe Example Setting the sync pulse sourceEXTernal1STATe TTLTrgnFEEDNumeric Through None OUTPutTTLTrgnFEEDARMSTARtSEQuence1 None Example Enabling sync pulse for READy on TTLTrg5Example Enabling sync pulse output to TTLTRG0* and TTLTRG5 OUTPutTTLTrgnSTATeREADchan READchan Subsystem Command ReferenceCommand Reference READchan Subsystem SENSe SENSechanFUNCtion SENSechanFUNCtionExample Selecting the single ended input on channel SENSechanFUNCtion SENSechanFUNCtionEXTernalFREQuency SENSechanROSCillatorSOURce SENSechanROSCillatorSOURceExample 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 countExample 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 STATusSubsystem Syntax Questionable Signal Status Register STATusOPCINITiateOPCINITiate OPERationQUEStionableENABle STATusOPERationQUEStionableCONDition?OPERationQUEStionableCONDition? STATusOPERationQUEStionableEVENt? Example Setting the Operation register enable maskOPERationQUEStionableEVENt? Through +32767 None Non-decimal NumericOPERationQUEStionablePTRansition STATusOPERationQUEStionableNTRansitionPRESet STATusPRESetExample Reading the error queue ERRor?SYSTem VERSion?TRIGger Command Reference TRIGger SubsystemTRIGger Subsystem Command Reference TRIGgerSTARtCOUNt Example Taking 20 readings 8 pre-arm and 12 post-arm STARtSOURce TRIGgerSTARtIMMediateBushold TRIGgerSTARtSOURceSTARtTIMer1 TRIGgerSTARtTIMer1Example Setting the start trigger source Reference period toTRIGgerSTARtTIMer1 Period Value Table STARtTIMer2∙ *RST Condition 5.0E-8 seconds Multiple PeriodTRIGgerSTARtTIMer2 ∙ *RST Condition 1.0E-7 seconds Local Bus transfers VINStrumentData voltagelist VME VXI data transfer Bus transfersVINStrument CONFigureLBUSFEED CONFigureLBUSMEMoryINITiate VINStrumentCONFigureLBUSMEMoryINITiateCONFigureLBUSMODE VINStrumentCONFigureLBUSMODECONFigureLBUSRESet VINStrumentCONFigureLBUSRESetExample Setting the Local Bus operation mode APPendGENerate None INSertOFF PIPelineCONFigureLBUSSENDPOINts VINStrumentCONFigureLBUSSENDPOINtsVINStrumentCONFigureLBUSSENDPOINtsAUTO CONFigureLBUSSENDPOINtsAUTOBoolean On OFF None VINStrumentCONFigureTESTDATA CONFigureTESTDATAVINStrumentCONFigureTESTDATA voltagelist configures ∙ *RST Condition none Example Testing Local Bus operation VINStrumentCONFigureVMEFEED CONFigureVMEMEMoryINITiate VINStrumentCONFigureVMEMEMoryINITiateCONFigureVMEMODE VINStrumentCONFigureVMEMODECONFigureVMESENDADDRessDATA? VINStrumentCONFigureVMESENDADDRessDATA?Example Setting the VXIbus data transfer bus operation mode GENerateOFF NoneHEWLETT-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 ESR? Example Enable all error eventsGMC? StringLMC? IDN?Example Query macro definition HEWLETT-PACKARD,E1429,0,A.01.00OPC LRN?OPC? PMCPUD and *PUD? Block Through 63 characters None Data String RCLRST RMCSRE and *SRE? SAVTRG STB?WAI TST?Command Quick Reference Chapter Chapter Command Quick Reference Unmask VINStrument Scpi Conformance Information Scpi Confirmed CommandsChapter Scpi Conformance Information Scpi Conformance Information Chapter Appendix Contents SpecificationsTo VME Bus Read-OutTo Local Bus E1429B only Number of PartitionsTotal Readings per Partition Amplitude Characteristics Signal ConditioningOutput Formats Signal-to-Noise RatioGain and Offset 4.3.1, note FilteringSingle-ended inputs Connector BNC Converter Supplemental CharacteristicsWord Error Rate 4.15 qualified error level word error rate Integral Nonlinearity 4.4.3, NoteAnalog Bandwidth 4.6.1 filter off Single-ended inputs, supplemental characteristicsEffective bits on different ranges Crosstalk between channelsAppendix a Specifications Effective bits, relative to 1V single-ended range Differential Inputs, supplemental characteristicsFrequency 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 IDN.C HP BASIC, C ERRORCHK.CSLFTST.C RSTCLS.CLBUS2PST.C LOCALAD.CLBUSAUTO.C STATUS.CEMC Mode OFFCalstorauto CAL1VALSour DELSLOP1 POSTable 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 ConfigurationRegister reads and writes are 8-bits Reading and Writing to the RegistersFigure C-1. HP E1429A/B A24 Address Space Addressing the RegistersDetermining the A24 Base Address Appendix C Register Programming A24READ.C Register Descriptions See A24 Register TableBase + A/D Status Register Input Configuration RegistersA/D Serial Register Base +0316A/D Parallel Strobe Register A/D Shift RegisterBase +0B16 Bit Name Function Abort and Arm Immediate Register Arm and Trigger Configuration RegistersArm Status Register Base +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 Decade Division Register Trigger Immediate Registerbase + 5D16Binary Division Register Base +6116Post-Arm Reading Count Register power-On/Reset Settings Pre-Arm Reading Count Register power-On/Reset SettingsPre-Arm Reading Count Registers Base + 7316 and base +Memory Control Registers Traffic Register Power-on/Reset SettingsTraffic Register Base +0216Pulse Register Channel ID RegisterData Register Memory Control Register Power-on/Reset Settings Memory Control RegisterBase +2116 Base +2316 to base +2716 Memory Address RegistersBase Address Registers Terminal Address RegisterBase +2B16 Base +2D16 and base +2F16Figure C-2. Accessing the A/D Shift Register Using the A/D Shift RegisterBit Name Setting Setting the Input Impedance Setting Measurement RangeProcedure Enabling the 10 MHz FilterInput Post 14 dB Attenuator Bits Bits 34 Bits 35 37,45 38,46 Checking the Idle State Setting the Arm Sources Setting the Digitizer ConfigurationSetting the Arm Delay Setting the Arm CountSetting the Reference Source Sending an Arm Immediate Signal Setting the Trigger SourceAborting Measurements Sending a Trigger Immediate SignalInitializing Digitizer Memory Re-initiating the DigitizerAppendix C Register Programming MSB LSB Initializing Initiating Timebase ProcessorTrigger count Timebase resetSample rate Data sourceCount 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 MemoryRegister 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 TransfersLocal Bus Interleaved Transfers Appendix D Setting Interleaved Transfer ModeProcedure LBUSINTR.C Trigstarsour TIM Trigstarsour ECLT0Trigstartim 1E-6 OUTPECLT0FEED ’TRIG’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 IndexIndex 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