Age1439measinit | Agilent Technologies E1439 guide

Note

id

Agilent E1439 Programmer's Reference

Functions listed alphabetically

age1439_meas_init

Initiates a measurement without first checking for valid hardware setup.

VXIplug&play Syntax

#include "age1439".h

ViStatus age1439_meas_init(ViSession id);

Description

age1439_meas_init provides an easy way to initiate a measurement in a single module.

This command is slightly faster and slightly less robust than age1439_meas_start.

Parameters

is the VXI instrument session pointer returned by the age1439_init function.

Comments

See “The measurement loop” in chapter 3 for details on how a measurement progresses through the four states.

This function performs the following sequence:

1.Clears the overload count maintained by the API. See “Comments on Overload” on page 160

2.Moves the module to the Idle state.

3.Generates a Sync transition which moves the module to the Arm state.

4.Always returns AGE1439_SUCCESS (no error conditions can be detected by this function).

Return Value

This function always returns AGE1439_SUCCESS and does not return any error conditions.

See Also

“Commands which halt active measurements” on page 198, “age1439_init” on page 132, “age1439_meas_start” on page 155, “age1439_meas_control” on page 151, “age1439_status_ get” on page 176, “age1439_read” on page 159

154

Image 164

Agilent Technologies E1439 manual Age1439measinit, ViStatus age1439measinitViSession id Description

Contents

Agilent Technologies Part Number E1439-90005 Trademarks Agilent E1439 at a Glance E1438 E1439 What You Get With the Agilent E1439 HardwareSoftware Documentation This Book Other DocumentationPage Contents Contents Replacing Assemblies Contents Installing the Agilent E1439 To inspect the Agilent E1439 To inspect the Agilent E1439 To install the Agilent E1439 To install the Agilent E1439 Logical Address VXI Mainframe To clean fiber optic connectors To clean fiber optic connectors To store the module To store the moduleTo transport the module To transport the module Getting Started with the Agilent E1439 Getting Started and Introduction Getting Started and Introduction System Requirements Microsoft Windows System RequirementsSystem Requirements Updating firmware To install the Windows VXIplug&play driversTo install the Windows VXIplug&play drivers To use the Resource Manager To use the Resource Manager To use the program group Windows To use the program group Windows To use the VXIplug&play Soft Front Panel SFP To use the VXIplug&play Soft Front Panel SFP To use the example programs To use the example programs Interrupt.exe Multchan32.exeInfo.exe Getting Started with the Agilent E1439 Using the Agilent E1439 Agilent E1439 overview Agilent E1439 overview Windows framework Programming the Agilent E1439Programming the Agilent E1439 Programming Measurement loop Measurement loop Measurement loop in multi-module systems Delay and phase in triggered measurements Delay and phase in triggered measurements Triggerdelayactual=0 or 0/16=0 output samples Using the Agilent E1439 Magnitude trigger and magdwell time Magnitude trigger and magdwell time Using the Agilent E1439 Frequency and filtering Frequency and filtering Using clock and sync Using clock and sync Sharing Reference and Sync signals in multi-module systems Managing multiple modulesManaging multiple modules Clock distribution Using the Agilent E1439 Systems using front panel distribution Managing multi-module systems Slot0 Controller Managing multi-mainframe systems Slave on Using an external sample clock Splitter External sample clock Synchronous center frequency changes Synchronizing changes in multi-module systemsSynchronous digital filter changes Trigger and phase in multi-module systems External sample synchronization in multi-module systems Now you may take a measurement Issue an age1439measstart Sync the digital local oscillators Transferring data Transferring data Fiber Optic Interface Fiber Optic Interface Fiber Frames Data Frame Normal Data Fiber FrameBOF Sync Without Data Fiber Frame EOE Sync with Data Fiber Frame Off Fiber Interface SetupFiber Modes Copy Raw Generate Fiber Receiver Append Fiber Receiver Flow Control Copy No Copy2 Agilent E1439 Programmers Reference Introduction Introduction Component Capability Subclass Function Name Functions listed by classFunctions listed by class Component Capability Subclass Function Name Route Configure Route Configure LOW Level Age1439interruptrestore on Functions listed by functional group Functions listed by functional group Initializing and closing Debugging Agilent E1439 Programmers Reference Identification Trigger Synchronization controlling multiple modules Functions listed alphabetically Functions listed alphabetically Age1439driverdebuglevelget on page 97 −gets the debug level Agilent E1439 Programmers Reference Agilent E1439 Programmers Reference Agilent E1439 Programmers Reference Age1439adcclock Age1439adcdivider AdcDivider AdcDividerPtrAge1439adcdividerget Description Age1439attribget Description DatestampPtr Age1439calgetBoard Age1439clockfs Age1439clockfsgetViStatus age1439clockfsViSession id, ViReal64 fs ViStatus age1439clockfsgetViSession id, ViPReal64 fsPtr Age1439clockrecover Age1439clocksetupget Age1439clocksetupClockSetup Internal reference Simple clock setups for stand-alone modulesPhase locked to external reference Front panel master-slave setups, one master per mainframe Front master, internal reference Front slave, phase locked to master AGE1439FRNTREARMSTREXTREF Rear master, internal reference Rear panel master-slave setups, one master per mainframeRear master, phase locked to external reference Front sync, external sample clock, wired-OR sync AGE1439REARSLAVEXTREF Multiple mainframe setups Send sync to slave ClockSetupPtr Functions listed alphabetically Receive sync from masterExample Effect on Active Measurement AGE1439SUCCESS indicates that a function was successful Age1439closeViStatus age1439closeViSession id Age1439combosetup PhaseBlocksize Interpolate Age1439datamemsizeget Age1439datascaleget Age1439datasetup DataDelay DataDelayPtrData type BlocksizePtr Resolution ResolutionPtrDataTypePtr Mode Port Xfers Sequence FilterBW Age1439dataxfersize Xfersize XfersizePtr Age1439driverdebuglevel DebugLevel DebugLevelPtr Age1439epochsetup EpochGenerate HeaderEnable HeaderEnablePtrEpochSizePtr HeaderValue Option/fiberMode Off Append 101 Age1439errormessage ErrorMessage Age1439errorquery ErrorCode ErrorMessage Age1439extsamplesyncget SyncEnable SyncEnablePtrAge1439extsamplesync 105 Parameter Age1439fiberclearViStatus age1439fiberclearViSession id Description Age1439fibererrorclear ViStatus age1439fibererrorclearViSession id Age1439fibererrorget Definition Numeric Description Value 109 Age1439fiberLEDget LedRegPtr Age1439fiberrcvsignalsget Pio1 Pio2 Dir Nrdy Age1439fibersetup BofEnable BofEnablePtr crcEnable CrcEnablePtr fiberMode FibermodePtr FlowControlModeTransferRate TransferRatePtr Age1439fibersignalget FiberSignalPtr Age1439fiberverify VerifyPath Sec Age1439fiberxmtBOF ViStatus age1439fiberxmtBOFViSession id Age1439fiberxmtsignals Age1439fiberxmtsignalsget DecimatePtr Age1439filtersetupDecimate Invalid parameter combinations SigBwPtrBe set 25 dB 15 dB Comment Age1439filtersyncViStatus age1439filtersyncViSession id Description 124 Age1439frequencycenterraw Comments 126 Age1439frequencycenterrawcompute Age1439frequencysetup Age1439frequencycenter sets the center frequencyCenterFreq CenterFreqPtr SyncPtr CmplxDCPtrSync 130 Age1439frontpanelclockinputget Age1439frontpanelclockinputFpClock FpClockPtr Age1439init IdQuery 133 Age1439inputautozero ViStatus age1439inputautozeroViSession id Description Age1439inputoffset Age1439inputoffsetsave ViStatus age1439inputoffsetsaveViSession id Age1439inputrangeauto Full Scale Voltage Vp Age1439inputrangeconvertVariable Range Index Full Scale DBm 140 Age1439inputsetup AntiAlias CouplingPtr Range Signal SignalPtrSignalPath SignalPathPtr 144 Age1439interruptrestore ViStatus age1439interruptrestoreViSession id Age1439interruptsetup Mask 147 Age1439lbusmode Pipeline LbusModePtr Age1439lbusreset ViStatus age1439lbusresetViSession id, ViInt16 lbusResetLbusReset LbusResetPtr Age1439meascontrol Idle Sync This function performs the following sequence 153 Age1439measinit ViStatus age1439measinitViSession id Description Age1439measstart Age1439measstatusget DefinitionReadValid BlockReady Age1439optionsget Options Age1439productidget ProductId Age1439read Checks for AGE1439STATUSREADBLOCK and AGE1439STATUS Data SampleCountOverloadPtr Read or age1439read64 function is this 161 Age1439readraw WordCount Call age1439measstart Call age1439readraw 164 Age1439referenceclockget Age1439referenceclockRefClock RefClockPtr Age1439referenceprescalerget Age1439referenceprescalerRefPrescaler RefPrescalerPtr Age1439reset ViStatus age1439resetViSession id Description Age1439resethard ViStatus age1439resethardViSession id Age1439revisionquery DriverRev InstrRev Error Age1439selftestTestMessage TestResult Message 171 Age1439serialnumberget Age1439serialnumberSerialNum Age1439smbclockoutputget Age1439smbclockoutputSmbClock SmbClockPtr Age1439staterecall Age1439staterecall#include age1439.h ViStatus age1439staterecallViSession id ViStatus age1439statesaveViSession id Description Age1439statesaveAge1439statesave Age1439statusget Status Bit Definition Status Bit Definition Description AGE1439STATUSREADVALID Age1439syncclockget Age1439syncclockSyncClock SyncClockPtr Age1439syncdirectionget Age1439syncdirectionSyncDirection SyncDirectionPtr Age1439syncoutputget Age1439syncoutputSyncOutput SyncOutputPtr Age1439triggerdelayactualget ActualDelayPtr Age1439triggerphaseactualget ActualPhasePtr Age1439triggersetup Pre-trigger Bit realPost trigger Frequencysetup function GenTrigPtrMagDwell MagDwellPtr TrigTypePtr Age1439vcxoget Age1439vcxoVcxoState VcxoStatePtr Age1439vxiclockoutputget Age1439vxiclockoutputVxiClock VxiClockPtr Age1439wait Variable Name Numeric Value Equivalent numeric values for variablesEquivalent numeric values for variables 191 192 193 194 195 196 197 Age1439selftest age1439staterecall Commands which halt active measurementsCommands which halt active measurements Parameter Description Error messagesError messages 200 Default values Default values Function VXIplug&play Syntax Quick Reference VXIplug&play Syntax Quick Reference Sage DacPtr 206 Module Description Front Panel Description Front Panel Description VXI backplane connections VXI backplane connections Trigger Lines Block diagram and description Block diagram and description Input DAC AC DC Clock Generation Anti-alias Filter Memory Controller and Sdram Memory Sampling ADCZoom and Decimation Filtering Data Output Fiber Optic Interface Trigger Detection Control Registers 218 Replacing Assemblies Ordering Information Replaceable partsReplaceable parts Code Numbers Mfr. No Mfr. Name Location Installing to avoid damage Assemblies Number Replaceable parts Ref Des Agilent Part Qty DescriptionPart Number To remove the top cover To remove the M1, M2 assemblies 226 Agilent Technologies Sales Office Fiber frame that acts as a synchronizing eventFiber frame that contains the last 4 data bytes in an epoch Front panel data port 228 Index Index Raw data, scaling 231 VME VXI 234 Need Assistance? About this edition