Home

Agilent Technologies E1439 Network Card User Manual

image

Contents

1. VCXO VCXO Intermodule O l clock Ll VXI CLOCK Intermodule O Clock synt Generation VXI SYNC Ext Clock Ref 5 Ext Trigger gt lt Trigger Detection VXI bus Y Interface Zoom and Analog Anti alias Sampling AD FIFO In o gt Attenuators Filter ADC Decimation Memory mere Filtering Interface gt not present Y Y in the E1439C XMT Fiber Optic E1439B D only FPDP Interface i RCV E1439B D only 20 Using the Agilent E1439 Programming the Agilent E1439 Programming the Agilent E1439 The Agilent E1439 is shipped with software and documentation to support a broad set of choices of controllers I O interfaces programming languages and operating systems By virtue of its compliance to the VXIplug amp play standard the E1439 is most easily controlled in an environment conforming to one of the supported VXIplug amp play frameworks However support is also supplied for other common hardware and software environments The relationship among the various levels of programming is shown in the diagram below Windows amp Visual Basic C Programming WIN C Function Library Hardware Registers Windows framework The primary development environment supported by the E1439 is the VXIplug amp play WINNT framework specifications It requires the following
2. 151 Be eom o rm 154 mea o T PP 155 BIEN meas Status pet Depos 156 Contents aoe 1439 options baked 157 aad ewsakbarkbi4 k ES ERE YE RE eK ES 158 acelga ceed ds se 4458 eA EE ERR 159 o GUI OR R 162 gplq39 reference 165 Soe 1459 relerence ooh paS Kes ed 166 167 545555234 EE 168 os ho 169 5 5 170 172 aoc 457 smb clock TEREA irere reda ER Ys 172 223344455554 EO 174 age 1439 state SEND ti cee ead E eskebukdEEECRERTARESTRAR ERA AA eens 175 JI tom Dm TM 176 agml439 sene GIDOR Lassus ER RARE REX HAE FOR OE 178 oe AS synt BPCO GR ROCCO HR RS 179 Bee Ao syne OUIDHL siia sdb x eR RACER HA 180 agel439 trigger delay actual S6l ios sees RA RESERARRAERES E RRER 181 age 4g trigger phase get Loue quce udo 182 aH SOW 4c Hob Y 183 TC 187 vxi clock A eR SCR P Ed rA E AREE Ser Ft Rd rra 188 Bac PEU
3. SIZE MAX selects the maximum data epoch size 98 Note Note epochSizePtr headerEnable headerEnablePtr header Value Agilent E1439 Programmer s Reference Functions listed alphabetically The units of epochSize are always in bytes and this value must be divisible by 4 with a minimum value of 8 to a maximum value of 4 294 967 292 bytes For maximum compatibility with other fiber optic components values divisible by 8 are recommended When the module is being used in a fiber append chain epochSize must be set equal to blocksize in bytes Since the function AGE1439_DATA_BLOCKSITZE sets the blocksize in samples the following table can be used to compute blocksize in bytes data type resolution bytes per sample real 12 2 complex 12 4 real 24 4 complex 24 8 You may set blocksize and epochSize independently for the other fiberMode settings points to the current value of epochSize controls whether or not epoch headers are generated AGE1439 HEADER ON enables epoch header generation 1439 HEADER OFF disables epoch header is generation The default setting is off Epoch headers are enabled only when epoch generation is enabled Otherwise epoch header settings are silently accepted The epoch header setting must match the configuration of the optical receiver points to the current value of headerEnable sets the value of the first 32 bits of the epoch header AGE1439 HEADER VALUE MIN selects the m
4. ud tv 06 3 408 QS dax tatus VU Kod dx 189 Equivalent numeric values for variables 190 Commands which halt active measurements 198 ee 199 L4S P ERARS RRREREPIA RO PAPAE EA Ps 201 VXIplug amp play Syntax Quick Reference 203 Module Description Front Panel DS DDR og satt S TROC RR Erde d Odd 208 VXI backplane connections lt EAR EA RSTUE 209 Block diagram and dosonpllilb 243393 ux S a EETTRA TR PRES TES 211 Replacing Assemblies Replaceable piis 2216466 rne m s 220 Glossa ye 4 5 4 6 227 45 229 Need 5 5 5 5 5 55 5 8 5 5 235 About tis 236 Contents Installing the Agilent E1439 Installing the Agilent E1439 To inspect the Agilent E1439 To inspect the Agilent E1439 The Agilent E1439 single channel VXI ADC Module was carefully inspected both mechanically and electrically before shipment It should be free of marks or scratches and it should meet its published specifications upon receipt If the module was damaged in transit do the following e Save all packing materials e
5. selects either a phase continuous or phase reset transition when freq 0 128 cmplxDCPtr sync syncPtr Agilent E1439 Programmer s Reference Functions listed alphabetically AGE1439_CMPLXDC_OFF combined with a frequency change to zero causes phase to be reset to zero AGE1439_CMPLXDC_ON combined with a frequency change to zero does not reset the phase thereby generating a complex dc measurement at baseband The state of this parameter does not affect any transition where freq is nonzero Whether the real or complex data is saved and ultimately sent to the output port is determined by the age1439_data_type function points to the current actual value of cmplxDC when set to AGE1439_SYNC_OFF allows an immediate frequency change in single module systems In multiple module systems setting this parameter to AGEI439 SYNC prepares the modules for a frequency change but does not actually bring about the change until the next ADC clock corresponding to the next assertion of the shared Sync signal The Sync transition is generated by calling the age1439 meas control function Note that returning sync to OFF before the Sync signal transition has occurred forces an immediate asynchronous frequency change points to the value of sync Comments Although the freq parameter is a double precision floating point number its effective resolution is 1 2 19 x 5 9 x 19 This allows exact specification of any multiple of 10 mHz when f
6. OK OK OK 1 Default instrument setting on power up and reset 2 Not applicable unless EPOCH _GEN_ON is enabled 100 Agilent E1439 Programmer s Reference Functions listed alphabetically w This is required if this is the first module an append chain 4 This is required unless this is the last module in an append chain 5 CRC_ON or CRC_OFF must correspond to the setting of the module supplying the data to the fiber interface 6 This is required for all modules in an append chain Return Value AGE1439_SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 See Also Default values on page 201 age1439_init on page 132 age1439_error_message on page 102 101 id errorMessage Note statusCode Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_error_message Returns error information obtained from function calls VXIplug amp play Syntax include age1439 h ViStatus age1439 error message ViSession id ViStatus statusCode ViChar errorMessage Description agel439 error message takes an error return value generated by a function and translates it to a readable string This function includes host errors as well as firmware errors Parameters is the VXI instrum
7. age1439_init on page 132 1439 status get on page 176 age1439_error_query on page 103 Error messages on page 199 109 id ledRegPtr Note Agilent E1439 Programmer s Reference Functions listed alphabetically agel1439 fiber LED get Returns a data register indicating the state of the front panel XMT RCV LEDs VXIplug amp play Syntax include age1439 h ViStatus age1439 fiber LED get ViSession id ViPInt16 ledRegPtr Description This function returns a register value that indicates the current state of the front panel XMT and RCV LEDs Parameters is the VXI instrument session pointer returned by the age1439 init function points to the current value of the LED register 1439 LED RX SIGNAL indicates an optical signal has been detected the RCV LED is on or blinking 1439 LED RX DATA indicates data was received in approximately the last 500 ms the RCV LED is blinking 1439 LED TX ENABLED indicates that the transmitter in enabled the XMT LED is on or blinking 1439 LED DATA indicates local data was transmitted in approximately the last 500 ms the XMT LED is blinking The AGE1439 STATUS FIBER ACTIVE bit is set when either of or both the XMT or RCV LEDs are blinking indicating data is being received and or being transmitted Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condi
8. 209 Module Description VXI backplane connections Trigger Lines The VXI specification provides 8 TTL and 2 ECL trigger lines that can be used for module specific signaling When programmed in a multi input configuration the E1439 uses the ECL trigger lines designating ECLTRGO as the SYNC line and as the 10 MHz Reference Clock CLOCK These lines can be extended to other mainframes using the SMB connectors on the front panel The SMB connectors can also be used for intermodule synchronization within a mainframe leaving the ECL trigger lines free for other purposes The CLOCK line is the master reference clock for a synchronous system of multiple E1439 modules Only one E1439 module in each mainframe is allowed to drive this line The SYNC line is used to send timing signals among E1439 modules in a multi input system Any module that drives this line must do so synchronously with CLOCK so that transitions on SYNC do not occur near the rising edge of CLOCK This ensures that all modules with a synchronous state machine clocked on CLOCK interprets SYNC in a consistent manner for each cycle of the state machine SYNC is used for synchronizing arming and triggering signals between E1439 modules The interpretation of the SYNC line is dependent on the states of the module described in The measurement loop on page 23 The E1439 module is also capable of controlling the SYNC line synchronously via the control register Fo
9. ADC_CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION VCXO EXT REF VCXO ON DIVIDE BY 38 PRESCALE BY 4 CLOCK OFF FRONT PANEL CLOCK BNC CLOCK DIVIDED ADC CLOCK DIVIDED ADC CLOCK SYNC OUT SMB FRNT TO REAR Front slave phase locked to master AGE1439 FRNT REAR SLAV EXT REF ADC CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK SMB CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION VCXO EXT REF VCXO ON DIVIDE BY 38 PRESCALE BY 1 CLOCK OFF FRONT PANEL CLOCK SMB CLK CLOCK OFF SMB CLOCK SYNC OUT SMB FRNT TO REAR 81 Agilent E1439 Programmer s Reference Functions listed alphabetically Rear panel master slave setups one master per mainframe 82 Rear master internal reference AGE1439 REAR MSTR INT REF ADC CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK SMB CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION VCXO INTERNAL VCXO ON DIVIDE BY 38 PRESCALE BY 1 DIVIDED ADC CLOCK NIA CLOCK OFF CLOCK OFF DIVIDED ADC CLOCK SYNC_OUT_VXI REAR TO FRNT Rear master phase locked to external reference AGE1439 REAR MSTR EXT REF ADC CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK SMB CLOCK OUTPUT SYNC CLOCK
10. See Also agel439 init on page 132 177 Note id syncClock syncClockPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_sync_clock Selects the source of the sync clock This description also includes the query function age1439_sync_clock_get VXIplug amp play Syntax include age1439 h ViStatus age1439 sync clock ViSession id Vilnt16 syncClock ViStatus age1439 sync clock get ViSession id ViPInt16 syncClockPtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 SMB CLOCK specifies using the front panel clock on the SMB connectors as the sync clock 1439 VXI CLOCK specifies using the VXI rear panel clock as the sync clock 1439 DIVIDED ADC CLOCK specifies using the divided ADC clock as the sync clock Returns a pointer to the current value of syncClock Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also Default values on page 201 age1439 init on page 132 1439 clock setup on page 78 agel439 sync direction on page 179 age1439 sync
11. age1439 data setup on page 90 age1439 clock fs on page 76 age1439 meas control on page 151 Frequency and filtering in chapter 3 Using clock and sync in chapter 3 Managing multiple modules in chapter 3 130 Note id fpClock fpClockPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_front_panel_clock_input Specifies the source for the front panel clock This description also includes the query function age1439_front_panel_clock_input_get VXIplug amp play Syntax include age1439 h ViStatus age1439 front panel clock input ViSession id Vilnt16 fpClock ViStatus age1439 front panel clock input get ViSession id ViPInt16 fpClockPtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup Description This function selects a front panel clock source that is used to drive the analog to digital converter ADC for single module operation or when a module is used as the master ADC clock source for a multi module system Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 CLOCK OFF specifies no front panel source 1439 SMB CLOCK specifies clock input from the front panel Intermodule Clock SMB connectors 1439 BNC CLOCK specifies clock input from the front panel Ext Clock Ref BNC connector returns a pointer to
12. Any command that halts the current measurement See Commands which halt active measurements on page 198 also releases the forced Idle and Sync controls If you want to hold a module in Idle after one of these commands you must call agel439 meas control again after the command that halted the current measurement Comments See The measurement loop in chapter 3 for details on how a measurement progresses through the four states 151 Agilent E1439 Programmer s Reference Functions listed alphabetically This function performs the following sequence 1 Waits for both the AGE1439 STATUS HARDWARE SET and 1439 STATUS _ SYNC COMPLETE bits to be set 2 Returns AGE1439 STATUS WAIT TIMEOUT if more than three seconds elapses in step 1 3 Returns AGE1439 SETUP ERROR if AGE1439 STATUS SETUP ERROR was detected in step 1 4 Writes data to the control register as prescribed by arguments to the function 5 Clears the overload count maintained by the See Comments Overload on page 160 6 Waits for AGE1439 STATUS SYNC COMPLETE 7 Returns 1439 SYNC NOT COMPLETE if more than three seconds elapse in step 6 otherwise it returns AGE1439 SUCCESS Special conditions prevail during the Measure state If programmed for block mode operation in the Measure state the module asserts the Sync signal regardless of the age1439 meas control sync parameter setting until a complete block of data has been collected an
13. Default values on page 201 age1439 init on page 132 1439 clock setup on page 78 agel439 reference clock on page 165 Using clock and sync in chapter 3 166 Note Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_reset Places the module in a known state VXIplug amp play Syntax include age1439 h ViStatus age1439_reset ViSession id Description age1439_reset returns the module s internal data structures to the power up state but does not reset the hardware This function can be called separately by this function or may be selected in conjunction with the age1439_init function Calling this function halts any measurement or fiber transfer Parameters is the VXI instrument session pointer returned by the age1439_init function Comments The reset values are listed in Default values on page 201 This command takes about 100 ms to complete Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 See Also Commands which halt active measurements on page 198 age1439_init on page 132 age1439_reset_hard on page 168 167 Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_reset_hard Resets the module to
14. age1439 fiber flow control get returns the value of flowControlMode age1439 fiber mode is used to select the fiber mode agel439 fiber mode get returns the current value of fiberMode age1439 fiber transfer rate selects the transfer rate for fiber optical data agel1439 fiber transfer rate get returns the current value of transferRate VXIplug amp play Syntax include age1439 h ViStatus age1439 fiber setup Visession id Vilnt16 mode ViInt16 bofEnable Vilnt16 flowControlEnable Vilnt16 crcEnable Vilnt16 transferRate ViStatus age1439 fiber BOF Visession id ViInt16 bofEnable ViStatus age1439 fiber BOF get Visession id ViPInt16 bofEnablePtr ViStatus age1439 fiber crc Visession id Vilnt16 crcEnable ViStatus age1439 fiber crc get Visession id ViPInt16 crcEnablePtr ViStatus age1439 fiber flow control Visession id VilInt16 flowControlMode ViStatus age1439 fiber flow control get Visession id Vilnt16 flowControlModePtr ViStatus age1439 fiber mode Visession id ViInt16 fiberMode ViStatus age1439 fiber mode get Visession id ViPInt16 fiberModePtr ViStatus age1439 fiber transfer rate Visession id ViInt16 transferRate ViStatus age1439 fiber transfer rate get Visession id ViPInt16 transferRatePtr Parameter is the VXI instrument session pointer returned by the age1439 init function configures the automatic generation of BOF events Generally this is only used by modules in an optical append chain AGE1439 BOF O
15. age1439_ status get on page 176 The measurement loop in chapter 3 161 id data wordCount Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 read raw Reads raw unscaled data from the VME backplane register VXIplug amp play Syntax include age1439 h ViStatus age1439 read raw ViSession id ViInt16 ViInt32 wordCount ViPInt16 overloadPtr Description agel439 read raw returns a block of raw unscaled integer data from the FIFO This function can only read data from the VME backplane register The data port of the Agilent E1439 must be set to 1439 by the age1439 data port function for this function to be effective This function performs the following sequence 1 Checks for AGE1439 STATUS READ BLOCK and 1439 STATUS _ OVERLOAD 2 If there is an overload then the overload count maintained by the API is incremented 3 Ifa block of data is NOT ready A the function immediately returns the current measurement state and B the value of the overload argument is set to AGE1439 OFF 4 If a block of date IS ready A data is read from the module B the function returns any errors that were encountered when reading the data C the value of the overload argument is set to AGE1439 ON and D the overload count maintained by the API is set to zero Parameters is the VXI instrument session pointer returned by the age1439 init function is a pointer to
16. plug amp pla Agilent E1439 VXI 70 MHz IF ADC with filters and memory User s Guide Agilent Technologies Agilent Technologies Part Number E1439 90005 Printed in U S A Print Date December 2002 Third Edition Agilent Technologies Inc All rights reserved 8600 Soper Hill Road Everett Washington 98205 1209 U S A Notices The information contained in this manual is subject to change without notice Agilent Technologies makes no warranty of any kind with regard to this manual including but not limited to the implied warranties of merchantability and fitness for a particular purpose Agilent Technologies shall not be liable for errors contained herein or direct indirect special incidental or consequential damages in connection with the furnishing performance or use of the material TRADEMARKS Windows MS Windows Windows NT are U S registered trademarks of Microsoft Corporation WARRANTY A copy of the specific warranty terms applicable to your Agilent Technologies product and replacement parts can be obtained from your local Sales and Service Office This document contains proprietary information which is protected by copyright All rights are reserved No part of this document may be photocopied reproduced or translated to another language without the prior written consent of Agilent Technologies Inc This information contained in this document is subject to change without notice Use of thi
17. 1439 RELEASE reverses a previous AGE1439 ASSERT or ensures that no forced Idle is active selects the state of the sync signal agel439 meas control also changes the state of the Sync signal which is used to arm or trigger an Agilent E1439 module In systems containing multiple Agilent E1439 modules the Sync signal is used to arm or trigger all modules simultaneously and also to synchronize decimation counters and local oscillators among the Agilent E1439 modules 1439 ASSERT causes the module to assert the Sync signal 1439 RELEASE causes the module to release the Sync signal When parameters of the age1439 clock setup function which enable sync output are selected the module shares the sync signal with other Agilent E1439 modules If any one of these modules asserts this shared Sync signal it then becomes asserted for all of them All modules must release it before the shared Sync signal is released Asserting then releasing the Sync line is used to start a measurement load local oscillator values or take a digital filter out of reset These situations require a Sync line transition but do not require that the Sync line be held in a asserted state When the Sync line is asserted it remains asserted for an adequate number of ADC clock cycles to ensure that the signal effect propagates to all the modules in the system You can determine when the command is completed by looking as the Sync Idle Complete bit in the Status Register
18. 191 Agilent E1439 Programmer s Reference Equivalent numeric values for variables 192 Variable Name Numeric Value AGE1439 FIBER SIGNAL PRESENT AGE1439 FIBER VERIFY INTERNAL AGE1439 FIBER VERIFY EXTERNAL AGE1439 FIBER VERIFY MIN AGE1439 FIBER VERIFY MAX AGE1439 FLOW CONTROL OFF AGE1439 FLOW CONTROL NO COPY AGE1439 FLOW CONTROL COPY AGE1439 FRNT MSTR EXT REF AGE1439 FRNT MSTR INT REF AGE1439 FRNT REAR MSTR EXT REF AGE1439 FRNT REAR MSTR INT REF AGE1439 FRNT REAR SLAV EXT REF AGE1439 FRNT SLAV EXT REF AGE1439 FRNT SYNC EXT SAMP AGE1439 FRONT PANEL CLOCK AGE1439 FS MAX AGE1439 FS MIN AGE1439 GENERATE AGE1439 GENERATE OFF AGE1439 GENERATE ON AGE1439 HEADER INCR MIN AGE1439 HEADER INCR MAX AGE1439 HEADER INDEX MASK AGE1439 HEADER AGE1439 HEADER ON AGE1439 HEADER VALUE MIN AGE1439 HEADER VALUE MAX AGE1439 IF PATH AGE1439 IMMEDIATE AGE1439 INSERT AGE1439 10 ADDRESS AGE1439 10 HANDLE AGE1439 LBUS AGE1439 LBUS RESET OFF AGE1439 LBUS RESET AGE1439 LED RX SIGNAL AGE1439 LED RX DATA AGE1439 LED TX ENABLED AGE1439 LED TX DATA 1 0 1 1 1073 c N gt 103e6 10e6 1023 Ox3FF 0 1 0 4294967295 O C A O o A N gt Agilent E1439 Programmer s Reference Equivalent numeric values for variables Variable Name Numeric Value AGE1439 MAG 3 AGE1439 MAGDWELL DEF 1 AGE1439 MAGDWELL MAX 16777215 AGE1439 MAGDWELL MIN 0 AGE1439 MAG LEVEL DEF 128 AGE1439 MAG
19. 3 34 5 46 25 25 12 5 4 1225 383125 12 5 6 5 gt 4 Continue to decimate by factors of two Return Value 1439 SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 See Also Commands which halt active measurements on page 198 Default values on page 201 agel439 init on page 132 age1439_input_setup on page 141 age1439_clock_setup on page 78 age1439 frequency setup on page 128 age1439 filter sync on page 123 agel439 data setup on page 90 Frequency and filtering in chapter 3 122 Note Agilent E1439 Programmer s Reference Functions listed alphabetically age1439 filter sync Synchronizes the decimation counter for multi module systems VXIplug amp play Syntax include age1439 h ViStatus age1439 filter sync ViSession id Description This function causes the digital decimation counter to be reset by the next Sync line rising transition By calling age1439 filter sync for every Agilent E1439 module using a shared ADC clock and then calling age1439 meas control to cause a sync transition the decimation counters are prepared to start at the same time Once this is done the decimation counters stay synchronized as long as the same ADC clock is used You do not need to resynchronize the decimatio
20. 7 Now you may take a measurement Issue an 1439 meas start Retrieve data from the modules when valid In the event that you do not supply a synchronizing signal in a reasonable length of time or you change your mind about it the DSP clock can be restored by issuing age1439 ext sample sync AGE1439 EXT SAMP SYNC CANCEL followed by an age1439 clock recover You should not need to perform the external sample sync operation again unless the external clocks are interrupted or the clock setup changed See also the diagrams earlier in this section that show the physical setup All the functions mentioned above are described in Functions listed alphabetically in chapter 4 41 Using the Agilent E1439 Transferring data Transferring data You can transfer data from the Agilent E1439C or D via the VMEbus With the Agilent E1439D you can also transfer data via the Local Bus and via a fiber optic interface The VMEbus is the universal data bus for VXI architecture It provides flexibility and versatility in transferring data Transfers over the VMEbus are 16 bits or 32 bits wide The Local Bus on the Agilent E1439D supports faster transfer rates than the VMEbus For example if you are transferring data from the Agilent E1439D to the Agilent E9821 the Local Bus provides a direct pipeline to the Agilent E9821 s DSPs Using the Local Bus you can transfer data in the background while processing data in a signal processing m
21. Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 172 Note id smbClock smbClockPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_smb_clock_output Specifies which clock to output from the SMB clock connectors This description also includes the query function age1439_smb_clock_output_get VXIplug amp play Syntax include age1439 h ViStatus age1439 smb clock output ViSession id Vilnt16 smbClock ViStatus age1439 smb clock output get ViSession id ViPInt16 smbclockPtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup Description This function selects the source of the output for the front panel SMB clock connectors Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 BNC CLOCK specifies that the BNC input be output from the SMB clock connectors 1439 CLOCK OFF specifies no output from the SMB clock connectors AGE1439 DIVIDED ADC CLOCK specifies that the divided ADC clock be output from the SMB clock connectors 1439 VXI CLOCK specifies that the VXI clock be
22. SIG ON FPDP control signals enabled AGEI1439 FIBER SIG OFF FPDP control signals disabled This is the default value for all signals The following are FPDP signals that are accommodated in the Serial FPDP protocol For further information on these signals refer to ANSI VITA 17 1998 Front Panel Data Port Specifications sets the dir FPDP control signal sets the nrdy FPDP control signal Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 1439 fiber setup on page 112 1439 fiber rcv signals get on page 111 118 piol pio2 Note dir nrdy Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_fiber_xmt_signals_get Returns the current value of PIO1 2 DIR and NRDY bits present on the fiber transmitter VXIplug amp play Syntax include age1439 h ViStatus age1439 fiber xmt signals get ViSession id ViPInt16 pio ViPInt16 pio2 ViPInt16 dir ViPInt16 NRDY Description These are embedded Serial FPDP signals The use of these bits is optional Serial FPDP does not use these four signals directly but simply transmits them from sender to receiver These functions display the value of recovered
23. To determine the error message pass the return value to age1439 error message on page 102 104 Agilent E1439 Programmer s Reference Functions listed alphabetically See Also Commands which halt active measurements on page 198 age1439_init on page 132 age1439_filter_sync on page 123 age1439_clock_setup on page 78 Managing multiple modules in chapter 3 Using clock and sync in chapter 3 External sample synchronization in multi module systems in chapter 3 105 Agilent E1439 Programmer s Reference Functions listed alphabetically age1439 fiber clear This function clears all data from the fiber interface FIFO buffers VXIplug amp play Syntax include age1439 h ViStatus age1439 fiber clear ViSession id Description age1439 fiber clear clears all data from the fiber interface FIFO buffers and resets other internal transient states such as reset to beginning of epoch and return to copy phase of append Parameter is the VXI instrument session pointer returned by the age1439 init function Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 age1439 status get on page 176 106 Agilent E1439 Programmer s Re
24. To install the Windows VXIplug amp play drivers This procedure assumes that you have already installed a VISA Virtual Instrument Software Architecture library If you attempt to install the Windows VXIplug amp play drivers without having installed a VISA library you will receive a fatal error 1 Insert the CD labeled Agilent E1439 VXI 70MHz IFADC with filters and memory 2 Run the program drive windows setup exe Where drive represents the drive containing the setup CD 3 The setup program asks you to confirm or change the directory path The default directory path is recommended 4 dialog box asks if you want to install startup shortcuts This creates a program group called AGE1439 within the Vxipnp directory that includes e shortcut to run the Agilent E1439 Soft Front Panel e shortcut for the Agilent E1439 web based online help file e shortcut for the PDF version of the Agilent E1439 User s Guide e shortcut for the AGDSP web based online help file e Several shortcuts for example programs e shortcut for a readme file 5 A readme file may be displayed If so be sure to read it and follow the instructions Updating firmware Future updates will be distributed on the Web To check your current revision run the Info Utility or check Help About in the Soft Front Panel program To check for new revisions access the Agilent Technologies Web page http www agilent com and search for E1439 I
25. ViStatus age1439 data resolution get ViSession id ViPInt16 resolutionPtr ViStatus age1439 data scale get ViSession id ViPReal64 scalePtr ViStatus age1439 data setup ViSession id ViInt16 dataType Vilnt16 resolution Vilnt16 mode Vilnt32 blocksize ViInt32 dataDelay Vilnt16 spectralOrder Vilnt16 port ViStatus age1439 data spectral order ViSession id Vilnt16 spectralOrder ViStatus age1439 data spectral order get ViSession id ViPInt16 spectralOrderPtr ViStatus age1439 data type ViSession id Vilnt16 dataType ViStatus age1439 data type get ViSession id ViPInt16 dataTypePtr ViStatus age1439 data xfersize ViSession id ViInt32 xfersize ViStatus age1439 data xfersize get ViSession id ViPInt32 xfersizePtr ViStatus age1439 driver debug level ViSession id Vilnt16 debugLevel ViStatus age1439 driver debug level get ViSession id ViPInt16 debugLevelPtr ViStatus age1439 error message ViSession id ViStatus statusCode ViChar errorMes 1 ViStatus age1439 error query ViSession id ViPint32 errorCode ViChar errorMessage ViStatus age1439_ext_sample_sync ViSession id Vilnt16 syncEnable ViStatus age1439_ext_sample_sync_get ViSession id ViPInt16 syncEnablePtr ViStatus age1439 filter bw ViSession id Vilnt16 sigBw ViStatus age1439 filter bw get ViSession id ViPInt16 sigBwPtr ViStatus age1439 filter decimate ViSession id ViInt16 decimate ViStatus age1439 filter decimate get ViSession id ViPInt16 decimatePtr V
26. agel1439 clock setup is used to select the source and distribution of clocking and synchronization signals used by the Agilent E1439 module The primary clock signal used by the module is the ADC clock for which the rising edges indicate the time for each sample of the analog to digital converter This function changes the settings controlled by the following lower level functions agel439 adc clock agel439 adc divider agel439 front panel clock input agel1439 reference clock agel439 reference prescaler agel439 smb clock output agel439 sync clock agel439 sync direction agel439 sync output agel439 vcxo Setups using the external sample clock require that you use age1439 clock fs to supply the clock frequency Parameters is the VXI instrument session pointer returned by the age1439 init function This parameter provides a quick way to set up most of the timing parameters for several standard clock configurations The following setups are available 78 Simple clock setups for stand alone modules Internal reference Agilent E1439 Programmer s Reference Functions listed alphabetically AGE1439 SIMPLE INT REF ADC_CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK SMB CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION VCXO INTERNAL VCXO ON DIVIDE BY 38 PRESCALE BY 1 CLOCK OFF N A CLOCK OFF CLOCK OFF DIVIDED ADC CLOCK SYNC OUT OFF Phase lock
27. external sample setups 37 83 front panel selecting 131 generation 213 resetting 77 setup 31 sharing 32 78 213 source specifying 72 sync source 178 synchronization 40 78 closing an instrument session 86 complex data output specifying 91 configuring a VXI system 13 continuous mode explained 23 control registers circuit description 217 conversion range 138 copy fiber mode 46 corrections dc offset 134 coupling input 141 CRC 44 229 Index D data on local bus 148 output circuit description 216 port selecting 92 data formatting circuit description 215 specifying 90 data frame 44 data transfer bus 209 dc coupling selecting 141 offset correction 134 decimation counters synchronizing 151 decimation filter and triggering 25 changes 39 circuit description 215 described 30 selecting 120 DEVICE_NPRESENT 13 digital filter See decimation filter DIR 44 drivers installing Windows 12 upgrading 12 DTB arbitration bus 209 E E9821 using with 42 ending an instrument session 86 EOE 44 epoch 44 error messages listed 199 reading 102 reading firmware 103 example external sample clock 41 trigger delay 25 trigger phase 25 example programs C 16 using 16 Visual Basic 16 Windows 15 external clock frequency 76 reference clock 34 sample clock 40 104 sample synchronization 40 trigger described 217 trigger selecting 185 F FEOF 44 230 fiber frame 44 fiber modes 45 fiber optic cables 6 cleaning
28. processor Memory allocation error 199 Agilent E1439 Programmer s Reference Error messages Error Number Parameter Description AGE1439 ERR BASE 0x001b AGE1439_ERR_BASE 0 0019 AGE1439 ERR BASE 0x0001e AGE1439 ERR BASE 0x00067 AGE1439 ERR BASE 0x00068 AGE1439 ERR BASE 0x00069 AGE1439 ERR BASE 0x006c AGE1439 ERR BASE 0x0080 AGE1439 ERR BASE 0 0081 AGE1439 ERR BASE 0x000b AGE1439 ERR BASE 0x0015 AGE1439 ERR BASE 0x0019 AGE1439 INTERFACE HARDWARE INCOMPATIBILE AGE1439 NULL ID AGE1439 STATUS WAIT TIMEOUT AGE1439 AUTOZERO ERROR AGE1439 AUTOZERO CONVERGENCE ERROR AGE1439 AUTOZERO SIGN ERROR AGE1439 AUTORANGE ERROR AGE1439 SETUP ERROR AGE1439 SYNC NOT COMPLETE AGE1439 FIBER ERROR AGE1439 FIBER HARDWARE REQUIRED AGE1439 TTL TRIGGER NOT SUPPORTED Errors required for SICL SPIL when using HP E1485 Error Number AGE1439 ERR BASE 0 0082 AGE1439 ERR BASE 0x0083 AGE1439 ERR BASE 0 0084 AGE1439 ERR BASE 0x0085 200 Parameter AGE1439 UNKNOWN STATUS AGE1439 SHARED MEMORY MAP ERROR AGE1439 SPIL ERROR AGE1439 SICL ERROR Interface hardware incompatible with instrument drivers ID parameter is zero function aborted Time out waiting for desired status Autozero error Possible hardware problem Possible hardware problem Autorange error Hardware setup error Command or Idle assertion did not complete Fi
29. 1 PIO2 DIR and NRDY bits on the fiber transmitter Parameter is the VXI instrument session pointer returned by the age1439 init function returns the current value of piol returns the current value of pio2 The following are FPDP signals that are accommodated in the Serial FPDP protocol For further information on these signals refer to ANSI VITA 17 1998 Front Panel Data Port Specifications returns the current value of dir returns the current value of nrdy Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 1439 fiber setup on page 112 1439 fiber rcv signals get on page 111 119 id decimate decimatePtr sigBw Agilent E1439 Programmer s Reference Functions listed alphabetically age1439 filter setup Sets the digital filter bandwidth and decimation filter parameters This description also includes information on the following functions which set or query the decimation filter parameters individually age1439 filter decimate selects an extra factor of 2 decimation age1439 filter decimate get gets current state of extra decimation age1439 filter bw selects a signal filter bandwidth age1439 filter bw get gets the signal filter
30. 100 mV i e TTL or ECL can be used as an external trigger source Minimum pulse width is 300 ns Since the ECL trigger input is an ac coupled comparator with hysteresis its initial state is unknown Before using it a trigger pulse should be applied to the Ext Trigger connector to initialize it to a known state In TTL trigger mode the external trigger input is dc coupled with an impedance of 1 k ohm and uses normal TTL level thresholds 0 8 V and 2 0 V External TTL trigger is not supported on E1439A modules with serial numbers lower than US41140000 Any E1439 module can trigger other E1439 modules using a shared sync line on the VXI backplane This Sync line can be extended to other mainframes by connecting a Sync SMB connector in one mainframe to a Sync SMB connector on an E1439 in the second mainframe All modules in a synchronous system are triggered on the same ADC sample The E1439 hardware samples the trigger source once every sample clock so the trigger condition must be present for at least one sample clock in order to be recognized Control Registers The E1439 module is controlled by firmware using registers mapped into the 16 bit VXI address space 217 Module Description Block diagram and description 218 Replacing Assemblies Replacing Assemblies Replaceable parts Replaceable parts The Agilent E1439 must be returned to Agilent Technologies for service or calibration Exchange modules are shipped with no mem
31. 164 Note id refClock refClockPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_reference_clock Selects the source of the reference clock This description also includes the query function age1439_reference_clock_get VXIplug amp play Syntax include age1439 h ViStatus age1439 reference clock ViSession id Vilnt16 refClock ViStatus age1439 reference clock get ViSession id ViPInt16 refClockPtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 FRONT PANEL CLOCK specifies the front panel clock be used as the reference clock Use this in conjunction with age1439 front panel clock input 1439 CLOCK specifies that the VXI rear panel clock be used as the reference clock Use this in conjunction with age1439 vxi clock output Returns a pointer to the current value of refClock Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also Default values on page 201 age1439 init on page 132 1439 clock setup on page 78 agel439 front panel clock inp
32. 33 33 3 224 AGE1439 RANGE 32 32 4 12 AGE1439 RANGE 31 31 J 178 AGE1439 RANGE 30 30 4 159 AGE1439 RANGE 29 29 4 141 AGE1439 RANGE 28 28 38 126 AGE1439 RANGE 27 27 4 12 AGE1439 RANGE 26 26 40 Al AGE1439 RANGE 25 25 4 089 AGE1439 RANGE 24 24 42 0794 AGE1439 RANGE 23 23 43 0708 AGE1439 RANGE 22 22 14 0631 142 Note rangePtr signal signalPtr signalPath signalPathPtr Agilent E1439 Programmer s Reference Functions listed alphabetically Variable Range Index i ira aed AGE1439 RANGE 21 21 45 0562 AGE1439 RANGE 20 20 16 0501 AGE1439 RANGE 19 19 47 0447 AGE1439 RANGE 18 18 48 0398 AGE1439 RANGE 17 17 49 0355 AGE1439 RANGE 16 16 20 0316 AGE1439 RANGE 15 15 21 0282 AGE1439 RANGE 14 14 22 0251 AGE1439 RANGE 13 13 23 0224 AGE1439 RANGE 12 12 24 02 AGE1439 RANGE 11 Ti 25 0178 AGE1439 RANGE 10 10 26 0158 AGE1439 RANGE 9 9 27 0141 AGE1439 RANGE 8 8 28 0126 AGE1439 RANGE 7 7 29 0112 AGE1439 RANGE 6 6 30 01 AGE1439 RANGE 5 5 31 0089 AGE1439 RANGE 4 4 32 0079 AGE1439 RANGE 3 3 33 0071 AGE1439 RANGE 2 2 34 0063 AGE1439 RANGE 1 1 35 0056 AGE1439 RANGE 0 0 36 005 AGE1439 RANGE MIN 0 36 005 These values are approximate For more accuracy use age1439_data_scale_get points to the current value of the range parameter for the selected signalPath For the AGE1439_ BB PATH signalPath the returned range is always AGE1439_RANGE_15 determines whether or not the input signal is connected to the input
33. 64 bit float data from FIFO specifically for VEE applications age1439 reference clock on page 165 selects the source of the reference clock agel1439 reference clock get on page 165 gets the source of the reference clock agel1439 reference prescaler on page 166 selects prescaling of the reference clock agel1439 reference prescaler get on page 166 gets prescaling of the reference clock age1439 reset on page 167 places the module in a known state age1439 reset hard on page 168 the module hardware agel1439 revision query on page 169 returns strings that identify the date of the firm ware revision age1439 self test on page 170 performs a self test on the module and returns the result agel1439 serial number on page 157 sets the module s serial number for product repair purposes agel1439 serial number get on page 157 returns the module s serial number agel439 smb clock output on page 173 specifies which clock to output from the SMB clock connectors agel439 smb clock output get on page 173 gets which clock to output from the SMB clock connectors age1439 state save on page 175 saves the current module state 1439 state recall on page 174 recalls a saved module state agel1439 status get on page 176 retrieves module s status register information age1439 sync clock on page 178 selects the source of the sync signal agel1439 sync clock get on page 178 gets
34. AEVE RE RARE 2 To install She Agelem be wed as 2 To clean fiber optic connectors 2 255455 53 2 45 595 6 Ie POOR au bed X CER IE dae do rdi 2 i ae m ope ks 7 2 Getting Started with the Agilent E1439 Getting Started and Introduction 10 2 9D 2 5522459 589444 11 To install the Windows VXIplug amp play 12 To use the Resource Manager iisceduesaacutuseddesk xr Eds 13 To use the program group 14 To use VXIplug amp play Soft Front Panel SFP 15 To use the example programs ood ks one ARRA SARREAd ba vee EASES 16 3 Using the Agilent E1439 Agilent E1439 2222422 Ea ERR bans 20 Programming the Agilent BEI439 aes RA 21 The measurement PoP MT has 23 Delay and phase in triggered measurements 25 Magnitude trigger and magdwell 28 Pregneney and TSN hace cid Ea AA AAA A 30 Di RNG EMITTE 31 Manace mulnple IBOUBISR 222224225408 oU eee Edd 32 Transferring data uduceaesend V eeeshbusaqes hed EES iis arris 42 ee ER E RR 43 4 Agilent E14
35. Agilent E1439 Programmer s Reference Commands which halt active measurements Commands which halt active measurements agel439 adc clock agel439 clock recover age1439 clock setup agel439 combo setup agel439 data blocksize agel439 data delay agel439 data resolution agel439 data spectral order agel1439 data type agel439 data xfersize agel439 ext sample sync age1439 fiber verify 1439 filter bw agel1439 filter decimate age1439 filter setup agel1439 front panel clock input 1439 init agel439 input autozero agel439 input range auto agel439 meas control agel439 meas init agel439 meas start agel1439 reset agel439 reset hard agel1439 self test agel439 state recall agel1439 trigger delay agel1439 trigger setup Commands which void synchronized multi module setups agel1439 clock setup and low level clock setup functions agel439 clock recover agel439 input autozero agel439 input range auto agel1439 self test agel439 state recall 198 Error messages Agilent E1439 Programmer s Reference Error messages Warnings and errors are based on the value VI ERROR Error I Number Parameter Description 0x0000 AGE1439 SUCCESS No error command succeeded 0x80000000 800 AGE1439 ERR BASE 0x0001 AGE1439 ERR BASE 0x0002 AGE1439 ERR BASE 0 0003 AGE1439 ERR BASE 0x0004 AGE1439 ERR BASE 0x0005 AGE1439 ERR BASE 0x0006 AGE1439 ERR BASE 0 0007 AGE1439 ERR BASE 0x
36. Also Commands which halt active measurements on page 198 Default values on page 201 1439 init on page 132 1439 frequency setup on page 128 1439 data setup on page 90 age1439 data scale get on page 89 1439 filter setup on page 120 agel439 meas start on page 155 1439 meas control on page 151 age1439 trigger phase actual get on page 182 1439 trigger delay actual get on page 181 measurement loop in chapter 3 Managing multiple modules in chapter 3 Delay and phase in triggered measurements in chapter 3 Magnitude trigger and magdwell time in chapter 3 186 Note Note id vcxoState vcxoStatePtr Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 vcxo Selects whether the internal clock source in the module is turned on or off This description also includes the query function agel439 vcxo get VXIplug amp play Syntax include age1439 h ViStatus age1439 vcxo ViSession id Vilnt16 vcxoState ViStatus age1439 get ViSession id ViPInt16 vcxoStatePtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup Description This function selects whether the internal clock source is turned on or off This function is ignored in IF path since the Agilent E1439D does not run in IF mode if the VCXO is turned off
37. CD ROM for Windows setup Software CD ROM for installation A Windows setup program that installs Firmware installation program The Agilent E1439 VXIplug amp play libraries and drivers Soft Front Panel program for the Agilent E1439 with source files Web based help for the Agilent E1439 AGDSP function library and online help Example programs and source files Microsoft Visual C C library and source files Microsoft Visual Basic header files Documentation e Agilent E1439 Installation and Service Guide Online documentation available after software installation e Agilent E1439 User s Guide in PDF format this document e Web based help files providing operational information and programmer s reference e WinHelp files for the Agilent E1439 Soft Front Panel In This Book This book documents the Agilent E1439 module It provides hardware installation information software installation information getting started information operational information programmer s reference replaceable parts Other Documentation Installation and Service information is provided as a printed document as well as in this PDF document After running the setup program the following documentation is available Web based help files are available from the Start menu WinHelp for the Soft Front Panel is available from the application Contents 1 Installing the Agilent E1439 Tomer be Amilo BD LLaosbuhsbue P RET ERES RE RA X
38. Description This function selects which clock the module should use to drive it s VXI clock Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 FRONT PANEL CLOCK specifies that the specified front panel clock drive the VXI clock 1439 CLOCK OFF specifies not driving vxi clock on the backplane 1439 DIVIDED ADC CLOCK specifies using the divided ADC clock to drive the vxi clock Returns a pointer to the current value of vxiClock Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also Default values on page 201 age1439 init on page 132 1439 clock setup on page 78 agel439 front panel clock input on page 131 Using clock and sync in chapter 3 188 Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 wait Facilitates the synchronization and control of multi module systems VXIplug amp play Syntax include age1439 h ViStatus age1439 wait ViSession id Description This function assures that all slave modules are completely set up before issuing measurement control commands to the master module Prior to calling age1439 meas control for the master module in multi module systems you should
39. E1439 Programmer s Reference Agilent E1439 Programmer s Reference Introduction Introduction The programmer s reference is presented as a set of VXIplug amp play functions since this is the primary targeted environment However when you performed the setup for the Agilent E1439 drivers were installed to support various programming environments as described in Programming the Agilent E1439 in chapter 3 The function descriptions in the programmer s reference are valid for all environments Be sure to follow the instructions in Getting Started and Introduction in chapter 2 to assure proper installation and to become familiar with the capabilities of your Agilent E1439 software in various programming environments You should find the example programs particularly helpful for programming in various environments Many of the function descriptions in the programming reference include several related functions You may use the primary function to set all related parameters or you may use the other functions within the group to set or query a single parameter Parameter variables are presented as alphanumeric values which are descriptive and easy to remember However for faster programming you may use the numeric equivalents for the parameter variables listed at the end of this section 54 Functions listed by class Component Capability Subclass Agilent E1439 Programmer s Reference Functions listed by class Functi
40. File a claim with the carrier Call your Agilent Technologies sales and service office Caution Note Note Installing the Agilent E1439 To install the Agilent E1439 To install the Agilent E1439 To protect circuits from static discharge observe anti static techniques whenever handling the Agilent E1439 VXI ADC Module 1 Set up your VXI mainframe See the installation guide for your mainframe Select a slot in the VXI mainframe for the E1439 module The Agilent E1439D module s local bus receives ECL level data from the module immediately to its left and outputs ECL level data to the module immediately to its right Every module using the local bus is keyed to prevent two modules from fitting next to each other unless they are compatible If you will be using the local bus select adjacent slots immediately to the left of the data receiving module If the VXI bus is used maximum data rates will be reduced but the module can be placed in any available slot 3 Using a small screwdriver or similar tool set the logical address configura tion switch on the E1439 See the illustration on the next page Each module in the system must have a unique logical address The factory default setting is 1100 0000 192 For optimal phase noise performance in multi module systems it is recommended that the first channel be an Agilent E1439C or Dl The Agilent E1439C does not support local bus or fiber optic transfers Multi module syste
41. If you switch from baseband to IF path the VCXO turns on it remains on if you switch back to baseband Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 VCXO OFF specifies that the internal clock source is turned off 1439 VCXO ON that the internal source is turned on Returns a pointer to the actual state of the VCXO Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Commands which halt active measurements on page 198 Default values on page 201 agel439 init on page 132 1439 clock setup on page 78 Using clock and sync in chapter 3 187 Note id vxiClock vxiClockPtr Agilent E1439 Programmer s Reference Functions listed alphabetically 1439 vxi clock output Selects which clock drives the VXI clock This description also includes the query function agel439 vxi clock output get VXIplug amp play Syntax include age1439 h ViStatus age1439 vxi clock output ViSession id Vilnt16 vxiClock ViStatus age1439 vxi clock output get ViSession id ViPInt16 vxiClockPtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup
42. Mmm Date hh mm ss YYYY where Ddd is the abbreviated day of the week and Date is an integer from 1 to 31 returns the date time and board number of the module s firmware revision in the form mm dd yyyy hh mm 01 xxxx 02Bd xxxx where xxxx is a manufacturer s date code used for service purposes For this parameter you must allocate a character array of at least 256 characters 1439 STR _ LEN MIN including the null byte prior to calling this function in any programming language Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also agel439 init on page 132 169 id testMessage Note testResult Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_self_test Performs a self test and returns the result of that self test VXIplug amp play Syntax include age1439 h ViStatus age1439 self test ViSession id ViPInt16 testResult ViChar testMessage Description The Agilent E1439 self test includes the following tests Digital verifies the integrity of paths from LO chip through the filters to the memory controller e Serial verifies the integrity of serial setup path for each board Memory fills the entire DRAM then verifies that all the data is
43. The following are FPDP signals that are accommodated in the Serial FPDP protocol For further information on these signals refer to ANSI VITA 17 1998 Front Panel Data Port Specifications returns the dir FPDP control signal returns the FPDP control signal Return Value AGEI1439 SUCCESS indicates that a function was successful 1439 FIBER ERROR is returned if there is no optical energy detected on the RCV fiber port Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 1439 fiber setup on page 112 age1439 fiber xmt signals on page 118 111 id bofEnable Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_fiber_setup Sets the fiber interface parameters This description also includes information on the following functions which set up or query the fiber parameters individually age1439_fiber_BOF controls whether or not automatically generated BOF events are transmitted age1439_fiber_BOF_get returns the current status of bofEnable age1439 fiber crc sets up the fiber interface to transmit and receive cycle redundancy checking to the same value age1439 fiber crc get gets the current status of crcEnable age1439 fiber flow control enables or disables transmitter flow control signals
44. VME or the Local Bus data port This data can optionally be scaled and converted to floating point Interrupts on page 64 The Agilent E1439 can be programmed to interrupt via the VXI backplane whenever certain status conditions are present Debugging on page 62 Allows you to identify program and hardware problems Fiber Interface on page 62 These functions are only available on E1439D 60 Agilent E1439 Programmer s Reference Functions listed by functional group Initializing and closing age1439_init on page 132 initializes the I O driver for a module age1439_close on page 86 closes the module s software connection Analog setup age1439_input_setup on page 141 sets all the analog input parameters agel1439 input alias filter on page 141 include bypass the built in analog anti alias filter agel1439 input alias filter get on page 141 gets the anti alias filter state agel1439 input autozero on page 141 nulls out the input dc offset in baseband mode agel1439 input coupling on page 141 selects or dc input coupling agel1439 input coupling get on page 141 get the input coupling type agel1439 input offset on page 135 sets the dc offset settings for the current range agel439 input offset get on page 135 gets the dc offset settings agel439 input offset save on page 136 saves the dc offset settings agel1439 input range on page 141 sets the ful
45. ViChar options Description Returns a list of options separated by commas Parameters is the VXI instrument session pointer returned by the age1439 init function returns a string of up to 256 characters For example 144 indicates option 144 memory is installed For this parameter you must allocate a character array of at least 256 characters 1439 STR LEN MIN including the null byte prior to calling this function in any programming language Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also agel439 init on page 132 157 id productId Note Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_product_id_get Gets the module s product identification string VXIplug amp play Syntax include age1439 h ViStatus age1439 product id get ViSession id ViChar productld Parameters is the VXI instrument session pointer returned by the age1439 init function returns the module ID such as E1439C or E1439D For this parameter you must allocate a character array of at least 256 characters 1439 STR LEN MIN including the null byte prior to calling this function in any programming language Return Value AGEI1439 SUCCESS indicates th
46. amplifier 1439 SIGNAL ON attaches the input signal to the 50 Ohm buffer amplifier 1439 SIGNAL OFF redirects the input signal to a dummy 50 Ohm load and feeds the buffer amplifier from an internally grounded 50 Ohm source resistance The signal OFF setting is useful for making reference measurements without the signal applied When using ac coupling the 0 2 uF capacitor remains between the input connector and its 50 Ohm termination points to the current value of the signal parameter Selects baseband AGE1439 PATH or IF signal path AGE1439 PATH The IF path passes frequencies between 52 and 88 MHz The range values above only apply to the IF signal path points to the current value of signalPath 143 Agilent E1439 Programmer s Reference Functions listed alphabetically Comments To ensure full alias free operation the analog anti alias filter should be ON unless the application inherently bandlimits the input signal to less than 5 2 The analog anti alias filter has a fixed bandwidth and thus is fully effective only when fs 100 MHz If a slower external ADC clock is used an additional analog filter of the appropriate bandwidth may be required for full alias protection When using the analog anti alias filter you may need to set the range parameter higher than the actual range of the input signal The reason for this is that step changes of input voltage cause an overshoot and ringing response at the output of t
47. any other functions Identification on page 64 These functions identify the module serial number and options Analog setup on page 61 These functions determine how the analog input section is configured Data format on page 61 An Agilent E1439 can collect either real or complex data in 12 bit or 24 bit format It can collect data into various blocksizes or in a continuous mode This data can be transferred either on the VXI backplane the Local Bus or over the fiber interface Digital processing on page 62 The decimation filter provides bandpass filtering and decimation capabilities You may also select limited frequency spans away from baseband Measurement control on page 64 These functions initiate or terminate the measurement loop Timing on page 64 The clock signals for the ADC sample clock can be set in a variety of ways One Agilent E1439 can be enabled to drive the sample clock line on the VXI backplane or front panel to enable synchronization of multiple Agilent E1439 modules Trigger on page 65 These functions set all parameters associated with triggering the beginning of data collection Synchronization controlling multiple modules on page 66 These functions support synchronous operation among multiple Agilent E1439s by using shared ADC clock and Sync signals to drive all the modules in a system Reading data on page 65 The Agilent E1439 reads data from either the
48. clock setups can be supplied by age1439 clock setup Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 VCXO INTERNAL selects an internal oscillator within the module age1439 freq determines which oscillator is used age1439 determines whether the internal oscillator is turned on You must use all three of the functions to provide the desired internal clock source 1439 VCXO EXT REF takes an external reference signal on the front panel and uses a phase locked loop to convert it to the ADC clock of the module The ADC clock can be either 100 or 102 4 MHz The external reference used by the phase lock loop to synthesize the ADC clock can be either a 10 MHz or 10 24 MHz signal 1439 EXT SAMPLE CLOCK uses an external sample clock selected by age1439_ reference clock points to the value of the current adcClock Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also Commands which halt active measurements on page 198 Default values on page 201 1439 init on page 132 1439 clock setup on page 78 1439 on page 187 agel439 front panel clock input on page 131 age1439 reference clock on page 1
49. conform to VXI specification 1 4 or later with regard to their attachment to the ECL Trigger lines See the Agilent E1439 Technical Specifications for the clock jitter phase noise specification degradation using backplane distribution e Front panel distribution requires the use of two short equal length cables with SMB connectors between modules In addition unused SMB connectors on modules being used for front panel distribution must be terminated in 50 ohms The following diagrams show typical multi module configurations and the clock setups that apply to each module 33 Note Using the Agilent E1439 Managing multiple modules Managing multi module systems The symbol indicates a 50 ohm terminator which is required on unused SMB connectors in systems using front panel distribution Module 1 Rear master Module 2 Front slave Module 1 Front master Module 2 Front slave internal reference on page phase locked to master on phase locked to external phase locked to master on 82 page 81 reference on page 81 page 81 qe dt dt oe Backplane 10 MHz Backplane _ le frequency ue
50. correct Analog verifies that auto zero adjust is working and that the input is triggering e Clock verifies that the oscillator is working properly Fiber performs five second internal fiber verification Parameters is the VXI instrument session pointer returned by the age1439 init function points to the self test status message string up to 256 characters long For this parameter you must allocate a character array of at least 256 characters 1439 STR LEN MIN including the null byte prior to calling this function in any programming language points to the instrument numeric error code Possible test result values are Error Error Code Self Test Message hex Status Message AGE1439 ST SUCCESS 0x000 self test successful AGE1439 ST HARDWARE FAIL 0x001 hardware failure AGE1439 ST SERIALT FAIL 0x002 serial 1 test failed AGE1439 ST SERIAL2 FAIL 0x004 serial 2 test failed AGE1439 ST CLOCK FAIL 0X008 95 MHz clock test failed AGE1439 ST MEMORY FAIL 0x020 memory test failed AGE1439 ST DIGITALT FAIL 0x040 real data path failed AGE1439 ST DIGITAL2 FAIL 0x080 complex data path failed 170 Note Note Agilent E1439 Programmer s Reference Functions listed alphabetically Error Error Code Self Test Message hex Status Message AGE1439 ST ANALOG FAIL 0x100 analog test failed AGE1439 ST FIBER FAIL 0x200 fiber test failed AGE1439 ST EXECUTION ERR 0x4000 self test execution error The required completion time for
51. data precision can be set to 12 bits or 24 bits Thus each sample occupies from 1 5 to 6 bytes of memory in the SDRAM The memory controller block packs the selected data into 72 bit words which are stored in the SDRAM memory Since the standard SDRAM depth is 2M x 72 bits it is possible to hold up to 12 Msamples in memory at one time 215 Module Description Block diagram and description The memory may be configured either in block mode or in continuous mode In block mode data collection initiated by a trigger proceeds until a specified block length is captured The measurement is then paused so that the data can be read out This mode is useful in capturing single transient events or whenever the output data rate is too high to be read and processed in real time In continuous mode data collection is initiated by a trigger and continues as long as the SDRAM memory does not overflow Data may be read out of the memory while the measurement is in progress If the reading of data is sufficiently fast the SDRAM memory never overflows and the measurement continues indefinitely If the SDRAM memory should ever overflow then the measurement stops and waits for data to be read out the measurement to be re armed and a new trigger to be initiated This mode of operation is useful for real time applications that employ a high speed signal processor to continuously read and operate on each sample of data Data can be read from the SDRAM memory in bur
52. for use with baseband path To use external sample clocks with multiple modules and still perform synced measurements you need to use either 1439 FRNT SYNC EXT SAMP or 1439 REAR SYNC _ EXT SAMP clock setups see age1439 clock setup on page 78 These setups use the signal that you feed into the Ext Clock Ref BNC input of the E1439 as a sample clock for the ADC A counter within the E1439 generates two lower frequency clocks one for the DSP circuitry and one to clock the measurement SYNC signal between multiple modules Since these clocks are generated independently within each module the counters in each module must be synced together with a common externally generated signal in order to make properly synced and triggered measurements involving multiple channels You feed this external sample sync signal into the External Trigger BNC and the module uses the signal to reset the counters to a known phase The external sample sync signal should be generated on the falling edge of the external sample clock and fed into each module in the system by an identical length coax cable Likewise the sample clock should be fed into each Ext Clock Ref BNC by an identical length coax cable from a common driver 40 Using the Agilent E1439 Managing multiple modules Here is the sequence of operations 1 Put all modules into either the AGE1439 REAR SYNC EXT SAMP mode or the 1439 SYNC EXT SAMP mode with the age1439 cl
53. interpolate long ph in freq 1048576 0 ph long fabs freq in long fabs freq double ph 37109375 0 5 if freq lt 0 ph 1 ph if 0 in 37109375 in else ph ph 1 ph 125 Agilent E1439 Programmer s Reference Functions listed alphabetically interpolate in return The equivalent Visual Basic example follows Private Sub rawFreq dblFreq as Double Dim dblFx As Double Dim lngIn As Long Dim lngPh As Long dblFx 1048576 dblFreq lngPh Fix Abs dblFx 0 lngIn Fix Abs dblFx CDbl l1ngPh 37109375 0 5 If dblFx 0 Then lngPh 1 l1ngPh If 1ngIn Then lngIn 37109375 Else lngPh lngPh 1 End If End If Call age1439_frequency_center_raw lngId lngPh l1ngIn End Sub Example An example of this in VB is included in the Front Panel code and can be activated by changing the following declaration in frmMain of E1439 vbp Const constFreqCentRaw False When TRUE set center frequency with agel439_frequency_center_raw instead of agel439 frequency center Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 1439 frequency
54. invalid block size was requested the closest valid block size is used until a change to an interrelated parameter makes the requested block size valid If a data resolution data type filter bandwidth trigger delay or filter decimation parameter was requested which would result in an inability to make a measurement the previous valid parameter is used until a change to an interrelated parameter makes the requested parameter valid Sync ldle Complete This bit is set when the most recent user initiated Sync or Idle change has propagated through to all modules in a system The change is a result of asserting Sync or forcing Idle via the Control Register or issuing a meas control command or function Status Bit Definition Agilent E1439 Programmer s Reference Functions listed alphabetically Description 8 11 12 13 14 15 Return Value AGE1439 STATUS READ VALID AGE1439 STATUS BLOCK READY AGE1439 STATUS ARMED AGE1439 STATUS FIFO OVERFLOW AGE1439 STATUS OVERLOAD AGE1439 STATUS ERROR QUEUE AGE1439 STATUS MODID AGE1439 STATUS HARDWARE SET This flag is set whenever there is at least one valid 16 bit data word available to be read via the VME data register Not valid when using the local bus data port This bit is set in continuous mode whenever the size of the data in the FIFO is equal to or greater than the block size register Check this bit before reading data to insure that a block of data may be
55. machine h is to accommodate I O libraries other than VISA In some cases the library may need merely to be re compiled to target a different processor type for the host computer Porting the E1439 library to a different computer environment is likely to be a fairly straight forward task However some of the higher level tools shipped with the E1439 may not be as easily ported The interactive soft front panel and some example programs include human interfaces that depend on certain display and keyboard support which may be system dependent Although source code is included for these applications porting them to a different environment may present a greater problem than porting the library itself The installation utilities are specifically targeted to operate on the supported development environments and may not be available in other environments 22 Using the Agilent E1439 The measurement loop The measurement loop The measurement loop progresses through four states The transition from one state to the next is tied to the transition of the Sync signal The effect of the Sync signal is summarized in the following diagram representing the four possible states of an Agilent E1439 module No data collected Assert New data collected Old data available Old data cleared Release Block Mode Data collected Data collected and output Assen Pre trigger data cleared In the Idle state the E1439 places no new data into the FIFO
56. on page 135 Component Capability Subclass Agilent E1439 Programmer s Reference Functions listed by class Function Name ROUTE CONFIGURE age1439 input offset save on page 136 age1439 input range on page 141 age1439 input range get on page 141 age1439 input signal on page 141 age1439 input signal get on page 141 age1439 input signal path on page 141 age1439 input signal path get on page 141 age1439 reference clock on page 165 age1439 reference clock get on page 165 age1439 reference prescaler on page 166 age1439 reference prescaler get on page 166 age1439 smb clock output on page 173 age1439 smb clock output get on page 173 age1439 sync clock on page 178 age1439 sync clock get on page 178 age1439 sync direction on page 179 age1439 sync direction get on page 179 age1439 sync output on page 180 age1439 sync output get on page 180 age1439 trigger adclevel on page 183 age1439 trigger adclevel get on page 183 age1439 trigger delay on page 183 age1439 trigger delay get on page 183 age1439 trigger delay actual get on page 181 age1439 trigger gen on page 183 age1439 trigger gen get on page 183 age1439 trigger magdwell on page 183 age1439 trigger magdwell get on page 183 age1439 trigger maglevel on page 183 age1439 trigger maglevel get on page 183 age1439 trigger phase actual get on page 182 age1439 trigger slope on page 183 age1439 trigger slope get
57. on page 183 age1439 trigger type on page 183 age1439 trigger type get on page 183 age1439 vcxo on page 187 age1439 vcxo get on page 187 age1439 vxi clock output on page 188 age1439 vxi clock output get on page 188 age1439 epoch setup on page 98 57 Agilent E1439 Programmer s Reference Functions listed by class Component Capability Subclass Function Name ROUTE ROUTE UTILITY 58 CONFIGURE CONTROL LOW LEVEL age1439 fiber setup on page 112 age1439 lbus mode page 148 age1439 mode get on page 148 age1439 Ibus reset on page 150 age1439 reset get on page 150 age1439 fiber BOF on page 112 age1439 fiber BOF get on page 113 age1439 fiber crc on page 113 age1439 fiber crc get on page 113 age1439 fiber flow control on page 114 age1439 fiber flow control get on page 114 age1439 fiber mode on page 113 age1439 fiber mode get on page 114 age1439 fiber transfer rate on page 114 age1439 fiber transfer rate get on page 114 age1439 epoch generate on page 98 age1439 epoch generate get on page 98 age1439 header on page 99 age1439 epoch header get on page 100 age1439 epoch header enable on page 99 age1439 epoch header enable get on page 99 age1439 epoch size on page 98 age1439 epoch size get on page 99 age1439 fiber clear on page 106 age1439 fiber error clear on page 107 age1439 fiber LED get on page 110 age1439 fiber rcv sign
58. output from the SMB clock connectors Returns a pointer to the current value of smbClock Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Default values on page 201 age1439 init on page 132 age1439 clock setup on page 78 agel439 front panel clock input on page 131 Using clock and sync in chapter 3 173 Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_state_recall Recalls a module s previous instrument state age1439_state_recall VXIplug amp play Syntax include age1439 h ViStatus age1439_state_recall ViSession id Description This function aborts any active measurement and recalls the instrument state previously saved by age1439_state_save This function requires gt 100 ms to complete Parameters is the VXI instrument session pointer returned by the age1439_init function Return Value 1439 SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 See Also Commands which halt active measurements on page 198 age1439 init on page 13
59. page 72 gets the ADC clock source agel1439 adc divider on page 73 determines which divider is applied to the ADC clock source 1439 adc divider get page 73 gets the module s current clock divider state agel439 ext sample sync on page 104 enables and disables external sample sync agel439 ext sample sync get on page 104 gets the state of external sample sync age1439 front panel clock input on page 131 specifies the source for the front panel clock agel1439 front panel clock input get on page 131 gets the front panel clock source age1439 reference clock on page 165 selects the source of the reference clock agel1439 reference clock get on page 165 gets the source of the reference clock age1439 reference prescaler on page 166 selects prescaling of the reference clock agel1439 reference prescaler get on page 166 gets prescaling of the reference clock agel439 smb clock output on page 173 specifies which clock to output from the SMB 64 Agilent E1439 Programmer s Reference Functions listed by functional group clock connectors age1439_smb_clock_output_get on page 173 gets which clock to output from the SMB clock connectors age1439_sync_clock on page 178 selects the source of the sync signal age1439_sync_clock_get on page 178 gets the source of the sync signal agel1439 sync direction on page 179 selects front or rear panel availability of the sync sig na
60. resources prior to the installation of the E1439 Anembedded or a stand alone Pentium class PC e Microsoft Windows 2000 or NT e VISA interface library VISA compatible hardware interface e Microsoft Visual C and or Microsoft Visual Basic development system Additional details on the WIN framework can be found in the VXIplug amp play VPP 2 System Frameworks Specification Revision 2 0 In addition to the C source code files the E1439 includes compiled libraries example programs an interactive soft front panel program online help files and an installation program The interactive soft front panel program allows the E1439 to be turned on verified and used for simple tasks without writing any user programs 21 Using the Agilent E1439 Programming the Agilent E1439 C programming The E1439 is shipped with a source library of C functions that can be called from user programs This elevates the interface above the register level so the programmer does not have to be concerned with such things as register addresses and packing or splitting parameters into 16 bit register lengths The library includes ANSI compliant source code files with all machine dependent code constrained to a single source file By re writing selected portions of the machine h file the programmer can create and compile an E1439 library that is compatible with virtually any development environment using the C language The most common reason for re writing
61. setup on page 128 1439 frequency center raw compute on page 127 126 center phasePtr interpolatePtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_frequency_center_raw_compute Computes the raw center frequency parameters VXIplug amp play Syntax include age1439 h ViStatus age1439 frequency center raw compute ViSession id ViReal64 center ViPInt32 phasePtr ViPInt32 interpolatePtr Description This function quickly computes the parameter values which you may use with age1439 frequency center raw This function also allows you to compute many values in advance to facilitate quick frequency hopping Parameters is the VXI instrument session pointer returned by the age1439 init function provides the center frequency normalized to clock fs points to the computed value of phase points to the computed value of interpolate Example Here is a Visual Basic snippet showing how to use this function Call age1439 frequency center raw compute lngId dblCenterFreq lngPh lngIn Call agel439 frequency center raw lngId lngPh l1ngIn Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also agel439 init on page 132 1439 frequency setup on
62. several modules via front panel distribution Managing multi mainframe systems Module 1 Front slave Module 2 Front master Module 3 Front slave Module 4 Front slave phase locked to master on internal reference on page 80 phase locked to master on phase locked to master on page 81 page 81 page 81 4 9 q ot q Ot g 5 i 8 e e e m 2 2 9 z ge 5 as gt CJ CJ E fi ri A 1 2 LJ 3 4 VXI Mainframe A VXI Mainframe B Clock and SYNC distribution using front panel extender connections within and between mainframes 35 Using the Agilent E1439 Managing multiple modules Module 1 Front slave Module 2 Send sync to Module Receive sync Module 4 Front slave phase locked to master slave on page 84 from master on page 85 phase locked to master on page 81 page 81 d er d Ot d C3 U D Backplane Backplane e 69 e 2 ae 2 5 e 5 5 gt 1 2 3 4 VXI Mainframe A VXI Mainframe B Clock and SYNC distribution using f
63. that library functions dependent on fs operate properly This value has no effect if the module is not set up to use the external sample clock Parameters is the VXI instrument session pointer returned by the age1439 init function provides the module with the frequency of an external sample clock from 10 000 000 to 103 000 000 connected to the Ext Clk TTL connector AGEI1439 FS MIN supplies the minimum external sample clock frequency 1439 FS MAX supplies the maximum external sample clock frequency points to the current value of the external sample clock frequency If the Agilent E1439 is set to the internal ADC clock this query returns the value of that clock frequency If the Agilent E1439 is set to the external clock this query returns the last value entered via the age1439 clock fs function Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Default values on page 201 age1439 init on page 132 1439 clock setup on page 78 agel439 front panel clock input on page 131 1439 ext sample sync on page 104 Using clock and sync in chapter 3 76 Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_clock_recover Allows recovery from an out o
64. the array into which the raw data record is to be placed Be sure to allocate sufficient storage space to hold the full data record as determined by the wordCount parameter wordCount is the total number of data values to read into the data array from the Agilent E1439 output FIFO The maximum wordCount depends on the blocksize data type and data resolution parameter settings 162 overloadPtr Note Agilent E1439 Programmer s Reference Functions listed alphabetically Data type jd Words per sample REAL 12 2 REAL 24 4 COMPLEX 12 4 COMPLEX 24 8 In continuous data collection mode wordCount should be set equal to the maximum possible wordCount to ensure that the entire data block is read out returns an overload indicator See Comments on Overload on page 160 The way to properly use the overload argument for the age1439 read raw function is this 1 Setup the hardware 2 Call age1439 meas start 3 Call age1439 read raw If data is not available the read function returns immediately with one of the following return values and the overload indication is AGE1439 OFF 1439 NO DATA MEASUREMENT IN PROGRESS 1439 NO DATA MEASUREMENT PAUSED 1439 NO DATA WAITING FOR TRIGGER 1439 NO DATA WAITING FOR ARM When data is available 1439 SUCCESS is returned and the overload value reflects whether an overload was encountered for the given data block 4 In continuous mode subsequent data blocks ca
65. the data scale factor VXIplug amp play Syntax include age1439 h ViStatus age1439 data scale get ViSession id ViPReal64 scalePtr Description agel1439 data scale get calculates the correct scale factor for raw data using the current data resolution and input range The factor returned by this function is used to multiply raw data to get data in volts When the module is providing only the real part of complex data the data is doubled to provide consistent spectrum measurements This occurs with either shift decimation or when the real part of a zoomed signal with a non zero center frequency is taken Parameters is the VXI instrument session pointer returned by the age1439 init function points to the calculated scale factor with which to scale raw data to volts Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 1439_ data setup on page 90 age1439 read raw on page 162 1439 input range auto on page 137 age1439 filter setup on page 120 89 Note id blocksize Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 data setup Sets all format and data output flow parameters This description also includes inf
66. transferred without fear of running out of data thereby holding up the Local bus or VME bus This bit is set in block mode whenever the module has successfully taken a block size number of samples since the most recent trigger and is cleared when the block is read out when force to Idle is asserted or when the module is armed for another measurement This bit is set whenever the module is in the Trigger state or is in the Arm state and has satisfied its pre trigger requirements When this bit is set the module releases the VXI Sync line Once all modules release the Sync line then all modules go to the Trigger state FIFO Overflow This bit set when the FIFO buffer overflows in continuous mode This bit is set whenever the ADC converts a sample that exceeds the range of the ADC The bit is cleared when the Status register is read This bit is set whenever there is an error in the error queue It is cleared when the error queue is empty A 1 in this field indicates that the module is not selected via the P2 MODID line A 0 indicates that the module is selected by a high state on the P2 MODID line This bit is set when all commands are complete and the hardware has been set AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102
67. via the VME bus Attempting to set AGEI439 _ 113 Note fibermodePtr flowControlMode flowControlModePtr transferRate transferRatePtr Agilent E1439 Programmer s Reference Functions listed alphabetically FIBER_MODE_RAW and the age1439_data_port to fiber will result in the AGE1439_ STATUS_SETUP_ERROR bit being set This is because the fiber interface cannot send both raw and filtered ADC data at the same time Attempting to use the flow control while in AGE1439_FIBER_MODE_RAW fiber mode will likely result in a TX ERR OVERRUN error The transmit FIFO size is Kbyte AGE1439_FIBER_MODE_GENERATE causes filtered ADC data to be transmitted over the fiber interface when one block is available in the FIFO When flow control is enabled in this mode an external optical receiver can send stop and go commands that cause the module to pause or resume data transmission Received optical data other than data flow control signals are ignored 1439 FIBER MODE APPEND copies data from the fiber optic receiver to the fiber optic transmitter and appends its own filtered ADC data when available points to the current value of fiberMode configures fiber flow control When flow control is on an external optic receiver can pause or resume the fiber data transmission by sending a stop or go command Received optical data other than flow control signals and PIO bits are ignored 1439 FLOW CONTROL NO COPY responds
68. with the age1439 _ frequency setup function For baseband measurements the filter may equivalently be considered as a low pass filter of approximately bandwidth fs 2 56 x 2 sigBw since the negative frequencies are generally of no interest The valid range of sigBw is 0 through 18 When sigBw 0 no digital filtering is applied to the signal and the module relies on the analog anti alias filter to limit the signal bandwidth to 5 2 56 To more accurately calculate the bandwidth use the calculation fs x k 2 sigBw where k 36 for 25 dB bandwidth k 44 for 3 dB bandwidth k 5 for 15 dB bandwidth 120 sigBwPtr Caution Agilent E1439 Programmer s Reference Functions listed alphabetically k 62 for 110 dB bandwidth AGE1439 SIG BW MAX sets sigBw to the maximum value and the filter bandwidth to the minimum 1439 SIG BW MIN sets sigBw to the minimum value and filter bandwidth to the maximum points to the current value of the sigBw parameter Selecting AGE1439 DECIMATE ON when sigBw 0 results in aliasing garbage data due to upper limit of the sampling frequency and therefore causes the SETUP ERROR bit to be set Selecting AGE1439 DECIMATE SHIFT for non zoomed data is not a useful configuration Comments To ensure full alias free operation the analog anti alias filter set by the age1439 input alias filter function should be ON unless the application inherently bandlimits the input signal to less than fs 2 T
69. 0008 AGE1439 ERR BASE 0x0009 AGE1439 ERR BASE 0x000a AGE1439 ERR BASE 0 0011 AGE1439 ERR BASE 0x00102 AGE1439 ERR BASE 0x0013 AGE1439 ERR BASE 0x0014 AGE1439 ERR BASE 0x0016 AGE1439 ERR BASE 0x0017 AGE1439 ERR BASE 0 0018 AGE1439 ERR BASE AGE1439 BAD COMMAND AGE1439 INVALID HW CONFIG AGE1439 PARM ERROR AGE1439 NV SAVE ERROR AGE1439 DOWNLOAD ERROR AGE1439 SERIAL TIMEOUT AGE1439 BYTE SWAP ERROR AGE1439 START ERROR 1439 HARDWARE FAILURE AGE1439 WATCHDOG RESET ERROR AGE1439 NO DATA MEASUREMENT IN PROGRESS AGE1439 NO DATA MEASUREMENT PAUSED AGE1439 NO DATA WAITING FOR TRIGGER AGE1439 NO DATA WAITING FOR ARM AGE1439 NO E1439 FOUND AGE1439 PROC READY TIMEOUT AGE1439 MEMORY ALLOCATION ERROR Base number for error values Invalid command code The hardware configuration is not supported Invalid command parameter Error while saving to non volatile memory Error while downloading new firmware Serial bus time out hardware error Incorrect byte order setting Start error Hardware failure Watchdog timer caused a hard reset possibly due to a hardware problem No data available a measurement is in progress data available the measurement is paused No data available trigger has not occurred No data available acquiring pre trigger data No AGE1439 found at specified logical address Time out is waiting for AGE1439 command
70. 02 0X004 0X000 0x400 0x200 0x2000 0x10 0x20 195 Agilent E1439 Programmer s Reference Equivalent numeric values for variables 196 Variable Name Numeric Value AGE1439 STATUS FIFO OVERFLOW AGE1439 STATUS HARDWARE SET AGE1439 STATUS MEAS ARM WAIT AGE1439 STATUS MEAS IDLE AGE1439 STATUS MEAS IN PROGRESS AGE1439 STATUS MEAS TRIG WAIT AGE1439 STATUS MODID AGE1439 STATUS OVERLOAD AGE1439 STATUS PASSED AGE1439 STATUS READ VALID AGE1439 STATUS READY AGE1439 STATUS SETUP ERROR AGE1439 STATUS SYNC COMPLETE AGE1439 STR LEN MIN AGE1439 SYNC FRNT TO REAR AGE1439 SUCCESS AGE1439 SYNC OFF AGE1439 SYNC ON AGE1439 SYNC OUT BOTH AGE1439 SYNC OUT OFF AGE1439 SYNC OUT SMB AGE1439 SYNC OUT VXI AGE1439 SYNC REAR TO FRNT AGE1439 TRIG DELAY DEF AGE1439 TRIG DELAY MAX AGE1439 TRIG DELAY MIN AGE1439 TRIG PHASE 0 AGE1439 TRIG PHASE 90 AGE1439 TRIG PHASE 180 AGE1439 TRIG PHASE 270 AGE1439 TX ERR OVERRUN AGE1439 USER AGE1439 VCXO EXT REF AGE1439 VCXO INTERNAL AGE1439 VCXO OFF AGE1439 ON AGE1439 VME AGE1439 VXI CLOCK 0x800 0x8000 0 1 0 0 0 2 0x3 0X4000 0x1000 0 4 0x100 0x8 0x40 0x80 256 c c N O C 1 0 2147286000 805108700 0 16384 32768 16384 256 0 oo a c Agilent E1439 Programmer s Reference Equivalent numeric values for variables Variable Name Numeric Value AGE1439 XFERSIZE DEF 1024 AGE1439 XFERSIZE MAX 805306320 AGE1439 XFERSIZE MIN 2 197
71. 1 Apply pure isopropyl alcohol to a clean lint free cotton swab or lens paper Cotton swabs can be used as long as no cotton fibers remain on the fiber end after cleaning 2 Clean the connector while avoiding the ends of the fiber 3 Apply isopropyl alcohol to a new clean lint free cotton swab or lens paper 4 Clean the fiber end with the swab or lens paper Do not scrub during this initial cleaning because grit can be caught in the swab and become a gouging element 5 Immediately dry the fiber end with a clean dry lint free cotton swab or lens paper 6 Blow across the connector end face from a distance of 6 to 8 inches using filtered dry compressed air Aim the compressed air at a shallow angle to the fiber end face Nitrogen gas or compressed dust remover can also be used Do not shake tip or invert compressed air canisters because this releases particles in the can into the air Refer to instructions provided on the compressed air canister 7 Assoon as the connector is dry connect or cover it for later use To order multimode LC fiber optic cables call Stratos Lightwave at 708 867 9600 http www stratoslightwave com or call Fiber Instrument at 800 500 0347 http www fisfiber com Caution Installing the Agilent E1439 To store the module To store the module Store the module in a clean dry and static free environment For other requirements see storage and transport restriction in Technical Specific
72. 10 transfer size determining and specifying 96 transmission mode local bus 148 transporting the module 7 trigger and decimation filtering 25 and phase with multiple modules 40 backplane lines 209 delay and phase 25 delay setting 184 delay actual 181 detection circuit description 217 external 217 generation selecting 184 in multiple modules 181 level setting 184 lines extending 210 phase actual 182 slope selecting 185 state 183 state described 23 type selecting 185 U unscaled data reading 162 upgrades 12 utility bus 209 V variable values 190 verifying operation 15 Visual Basic example program 16 VME bus transfers 42 port selecting 92 reading data on 159 VXI backplane connection 209 bus transfers 42 216 interface configuring 13 Windows example program 15 installing libraries 12 programming overview 21 Z zoom measurements and phase 25 and triggering 25 circuit description 215 overview 30 selecting 128 setting center frequency 128 Index 233 Index 234 Need Assistance If you need assistance contact your nearest Agilent Technologies Service Office You can find a list of local service representatives on the Web at http www agilent com If you do not have access to the internet one of the centers listed below can direct you to your nearest representative If you are contacting Agilent Technologies about a problem with your Agilent E1439 module please provide the follow
73. 1439_Ibus_mode_get ViSession id ViPInt16 busModePtr ViStatus age1439_Ibus_reset ViSession id ViInt16 busReset ViStatus age1439 Ibus reset get ViSession id ViPInt16 busResetPtr ViStatus age1439 meas control ViSession id ViInt16 idle Vilnt16 sync ViStatus age1439 meas init ViSession id ViStatus age1439 meas start ViSession id ViStatus age1439 options get ViSession id ViChar options ViStatus age1439 product id get ViSession id ViChar productId ViStatus age1439 read ViSession id ViReal32 data Vilnt32 sampleCount ViPInt16 overloadPtr ViStatus age1439 read raw ViSession id ViInt16 data Vilnt32 wordCount ViPInt16 overloadPtr ViStatus age1439 read64 ViSession id ViReal64 data Vilnt32 sampleCount ViPInt16 overloadPtr ViStatus age1439 reference clock ViSession id Vilnt16 refClock ViStatus age1439 reference clock get ViSession id ViPInt16 refClockPtr ViStatus age1439 reference prescaler ViSession id Vilnt16 refPrescaler 205 Agilent E1439 Programmer s Reference VXIplug amp play Syntax Quick Reference ViStatus age1439 reference prescaler get ViSession id ViPInt16 refPrescalerPtr ViStatus age1439 reset ViSession id ViStatus age1439 reset hard ViSession id ViStatus age1439 revision query ViSession id ViChar driverRev ViChar instrRev ViStatus age1439 self test ViSession id ViPInt16 testResult ViChar testMessage ViStatus age1439 serial number ViSession id ViChar serialN
74. 16 indicates that the sample corresponding to the actual trigger is number 32 16 24 or the 33rd sample The measured phase of the 33rd complex sample found via the atan2 function is 159 degrees The phase of the LO at this sample is 19697 360 65536 108 degrees Adding these together to get the corrected phase of the input signal results in 267 degrees 93 degrees which is close to the expected phase of a sine wave triggered at its zero crossing which would be 90 degrees 27 Using the Agilent E1439 Magnitude trigger and magdwell time Magnitude trigger and magdwell time The magnitude trigger operates on the magnitude of a possibly filtered signal For a real signal the magnitude is merely the absolute value of the signal For a complex signal the magnitude is the square root of the sum of the squares of the real and imaginary parts of the signal Because the magnitude trigger can operate on the filtered signal the trigger can be more selective regarding what signals will cause a trigger than the ADC trigger Only signals in the filter bandwidth around the center frequency will be considered when determining when a trigger occurs Signals outside the filter s passband will be filtered out before the magnitude trigger circuit and will not cause any triggers to occur The magnitude trigger s behavior can be modified by the magDwell time The magDwell time is the number of samples that a signal s magnitude must be low i e below the
75. 2 agel439 state save on page 175 174 Note Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_state_save Saves the module s current instrument state age1439_state_save VXIplug amp play Syntax include age1439 h ViStatus age1439 state save ViSession id Description This function may be used to save a state to which you want to return later age1439 reset does not change a saved state The state is not saved to non volatile RAM The saved state is lost by issuing the following commands 1439 input range auto age 1439_ input autozero age1439 self test and age1439 reset hard Parameters is the VXI instrument session pointer returned by the age1439 init function Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also agel439 init on page 132 1439 state recall on page 174 175 id statusPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_status_get Reads status register information for the module VXIplug amp play Syntax ftinclude age1439 h ViStatus age1439 status get ViSession id ViPInt16 statusPtr Parameters is the VXI instrument session pointer returned by the age1439 init function p
76. 39 Agilent E1439 Programmer s Reference Functions listed alphabetically See Also age1439_init on page 132 1439 input setup on page 141 age1439_data_scale_get on page 89 140 id antiAlias antiAliasPtr coupling Agilent E1439 Programmer s Reference Functions listed alphabetically agel1439 input setup Sets all the analog input parameters This description also includes information on the following functions which set or query the input parameters individually agel1439 input alias filter selects or bypasses the built in analog anti alias filter agel1439 input alias filter get gets the anti alias filter state agel1439 input coupling selects ac or dc input coupling agel439 input coupling get get the input coupling type 1439 input range sets the full scale range agel439 input range get gets the input range 1439 input signal connect disconnect the input signal to the input amplifier 1439 input signal get gets the input buffer amplifier state agel439 input signal path selects a baseband or IF signal path agel439 input signal path get gets the current signal path VXIplug amp play Syntax include age1439 h ViStatus age1439 input setup ViSession id Vilnt16 signalPath Vilnt16 range Vilnt16 coupling Vilnt16 antiAlias Vilnt16 signal ViStatus age1439 input alias filter ViSession id Vilnt16 antiAlias ViStatus age1439 input alias filter get ViSession id ViPInt16 antiAliasPt
77. 39 ADC LEVEL DEF AGE1439 GENERATE ON AGE1439 MAGDWELL DEF AGE1439 MAG LEVEL DEF AGE1439 POSITIVE AGE1439 TRIG DELAY DEF AGE1439 IMMEDIATE AGE1439 VCXO ON AGE1439 CLOCK OFF Agilent E1439 Programmer s Reference VXI plug amp play Syntax Quick Reference VXIplug amp play Syntax Quick Reference ViStatus age1439 epoch setup Visession id Vilnt16 epochGenerate Vilnt32 epochSize ViInt16 headerEnable ViInt32 initial Value Vilnt32 incrementCount ViStatus age1439 epoch generate Visession id Vilnt16 epochGenterate ViStatus age1439 epoch generate get Visession id ViPInt16 epochGenteratePtr ViStatus age1439 header Visession id Vilnt32 headerValue ViInt32 incrementCount ViStatus age1439 epoch header get Visession id ViPInt32 headerValuePtr ViPInt32 incrementCountPtr ViStatus age1439 epoch header enable Visession id VilInt16 headerEnable ViStatus age1439 epoch header enable get Visession id ViPInt16 headerEnablePtr ViStatus age1439 epoch size Visession id ViInt32 epochSize ViStatus age1439 epoch size get Visession id ViPInt32 epochSizePtr ViStatus age1439_ fiber clear ViSession id ViStatus age1439 fiber error clear ViSession id ViStatus age1439 fiber error get ViSession id Vilnt16 fiberErrorPtr ViStatus age1439 fiber LED get ViSession id ViPInt16 ledRegPtr ViStatus age1439 fiber rcv signals get ViSession id ViPInt16 pio ViPInt16 pio2 ViPInt16 dir ViPInt16 nrdy ViStatus age1439 fiber setup Visessio
78. 39 CRC ON AGE1439 FIBER MODE COPY AGE1439 FLOW CONTROL OFF AGE1439 106MBS AGE1439 FIBER SIG OFF AGE1439 FIBER SIG OFF AGE1439 FIBER SIG OFF AGE1439 FIBER SIG OFF AGE1439 DECIMATE OFF AGE1439 SIG BW MIN AGE1439 CMPLXDC OFF AGE1439 CENT FREQ DEF AGE1439 SYNC OFF AGE1439 CLOCK OFF 201 Agilent E1439 Programmer s Reference Default values Function Parameter Default Value age1439 input setup on page 141 antialias AGE1439 ANTIALIAS ON coupling AGE1439 DC range AGE1439 RANGE signal AGE1439 SIGNAL signalPath AGE1439 IF PATH 1439 interrupt setup on page 146 mask 0 priority 0 age1439 lbus mode on page 148 lbusMode AGE1439 PIPELINE age1439 lbus reset page 150 lbusReset AGE1439 LBUS RESET ON age1439 meas control on page 151 idle AGE1439 RELEASE sync AGE1439 RELEASE age1439 reference clock on page 165 refClock AGE1439 CLOCK age1439 reference prescaler on page 166 refPrescaler AGE1439 PRESCALE BY 4 age1439 smb clock output on page 173 smbClock AGE1439 CLOCK OFF age1439 sync clock on page 178 syncClock AGE1439 DIVIDED ADC CLOCK age1439 sync direction on page 179 age1439 sync output on page 180 age1439 trigger setup on page 183 age1439 vcxo on page 187 age1439 vxi clock output on page 188 202 syncDirection syncOutput adcLevel genTrig magDwell magLevel slope trigDelay trig Type vcxoState vxiClock AGE1439 SYNC FRNT TO REAR AGE1439 SYNC OUT OFF AGE14
79. 39 Programmer s Reference TON OO aoa acie Gd cio dard Gd doe pad E Eod 54 Functions bsted BY DIS Lau ede eek TERR EORI a Functions listed by functional group 60 Functions listed alphabetically 2 s6ccss essence or 67 age clock ETE ERE T4 ade ONIdE ia 73 Contents atib M 22 544 4 54 60 45 ORCA EC ERU dE YS 74 UU uasa enda dar do SaeE d eked danse DRE 75 Ok Ons 76 A 32455539995 PRAG OHIO ORC 7 am l1439 clock ees 78 o TN 86 ro i combo 0 MERCED 87 ageld39 data memsize 52512242552 554956 0494 550 88 BELLES data CERA 89 o cl SE D wm PTT 90 BREL data OPERE quem Ene MR beens 96 driver debna evel quo VeRO 97 SOUS La add ERE RE ACRI 98 areldq39 err r MESSAgE Li cite adi Rena RE d ERECERER E EFAEYERRR E AKA 102 GCF prot 554 e OEC ORI EE OE 103 4261429 ext sample SYNC AA ERE 104 SEMEL Li ced d 4S 106 amlq39 fiber Cleat uua ie ERR CCCII OR E CAE dr 107 oci SUB E cim TT TIT ETE 108 Bep fiber LED Aet e RW eds 110 fiber
80. 39 error message on page 102 See Also 1439 init on page 132 1439 interrupt setup on page 146 145 id intrNum mask priority maskPtr priorityPtr Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 interrupt setup Sets both interrupt parameters This description also includes information on the following functions which query the interrupt parameters individually agel1439 interrupt mask get gets the interrupt event mask agel1439 interrupt priority get gets the VME interrupt line VXIplug amp play Syntax include age1439 h ViStatus age1439 interrupt setup ViSession id Vilnt16 intrNum Vilnt16 priority Vilnt16 mask ViStatus age1439 interrupt mask get ViSession id Vilnt16 intrNum ViPInt16 maskPtr ViStatus age1439 interrupt priority get ViSession id ViInt16 intrNum ViPInt16 priorityPtr Description An Agilent E1439 has two independent interrupt generators each capable of interrupting on one of the seven VME interrupt lines when a status condition specified by a mask occurs agel1439 interrupt setup sets the interrupt mask priority and which of the two interrupt generators on the Agilent E1439 is to be used The remaining age1439 interrupt functions query the mask and priority individually Parameters is the VXI instrument session pointer returned by the age1439 init function is the number of the interrupt generator The only values accepted 0 a
81. 39 front panel clock input get on page 131 gets the front panel clock source age1439 init on page 132 initializes the I O driver for a module 1439 input alias filter on page 141 include bypass the built in analog anti alias filter 1439 input alias filter get on page 141 gets the anti alias filter state agel439 input autozero on page 134 nulls out the input dc offset in baseband mode agel439 input coupling on page 141 selects or dc input coupling agel1439 input coupling get on page 141 get the input coupling type agel1439 input offset on page 135 sets the dc offset settings for the current range agel439 input offset get on page 135 gets the dc offset settings agel439 input offset save on page 136 saves the dc offset settings agel439 input range on page 141 sets the full scale range agel439 input range auto on page 137 performs auto ranging in baseband mode agel439 input range convert on page 138 converts the input range to volts agel439 input range get on page 141 gets the input range 1439 input setup on page 141 sets all the analog input parameters agel1439 input signal on page 141 connect disconnect the input signal to the input amplifiers 1439 input signal get on page 141 gets the input buffer amplifier state agel1439 input signal path on page 141 selects baseband IF signal path agel439 input signal path
82. 39 meas control on page 151 Managing multiple modules in chapter 3 124 id phase interpolate phasePtr interpolatePtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439 frequency center raw Provides a fast way to set the center frequency VXIplug amp play Syntax include age1439 h ViStatus age1439 frequency center raw ViSession id Vilnt32 phase ViInt32 interpolate ViStatus age1439 frequency center raw get ViSession id ViPInt32 phasePtr ViPInt32 interpolatePtr Description agel439 frequency center raw sets the center frequency without relying on the internal Agilent E1439 microprocessor to do floating point computations since the internal microprocessor does not have a floating point co processor The parameters may be easily computed with age1439 frequency center raw compute Parameters is the VXI instrument session pointer returned by the age1439 init function specifies the phase part of the frequency specifies the interpolation part of the frequency points to the current actual value of phase points to the value of interpolate Comments The following examples are provided in case you want to compute your own parameter values rather than use the recommended age1439 frequency center raw compute function The following C code segment shows how to compute these parameters where freq is center frequency sample rate Static void rawFreq double freq long phase long
83. 439 init on page 132 86 id blocksize interpolate phase sigBw Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_combo_setup Combines often used setup commands from various functions age1439_combo_setup sets signal bandwidth blocksize and center frequency VXIplug amp play Syntax include age1439 h ViStatus age1439 combo setup ViSession id Vilnt16 sigBw Vilnt32 blocksize Vilnt32 phase ViInt32 interpolate Description agel439 combo setup provides a faster way to set up parameters from several functions which are often used together Parameters is the VXI instrument session pointer returned by the age1439 init function See age1439 data setup on page 90 for a description of the blocksize parameter See age1439 frequency center raw on page 125 for a description of the interpolate parameter See 1439 frequency center raw on page 125 for a description of the phase parameter See agel439 filter setup on page 120 for a description of the sigBw parameter Comments This command halts the current measurement which also releases the forced Idle state If you use this command in multi module systems to synchronously change the center frequency while the modules are forced to Idle then you should subsquently call age1439 meas control to re assert the forced Idle condition Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS i
84. 50 MBs Rate same as module to left BOF ON BOF ON CRC ON CRC ON Flow Control OFF Epoch Generate ON Epoch Size Divisible by 4 must match blocksize Flow Control OFF Epoch Generate ON Epoch Size Divisible by 4 must match blocksize 1 The final module in an append chain may require BOF to be Off for compat ibility with data receivers that cannot process BOFs 51 Using the Agilent E1439 Fiber Optic Interface The following shows two E1439D modules in an append chain transmitting data to a fiber receiver when flow control is on E1438D E1439D E1438D E1439D Fiber Receiver j 1 7 Fiber Fiber Fiber RX a TX Fiber MB Fiber TX RX TX 1KB 1KB FIFO FIFO DATA sci DIGITAL DIGITAL ADG FILTERS RESET tas gt FILTERS gt FIFO B SN J V VME BUS VME BUS Processing LBUS LBUS P Fiber Interface Setup First E1439D in chain Next E1439D in chain Mode Generate Mode Append Rate 106 or 250 MBs Rate same as module to left BOF ON BOF on CRC ON CRC ON Flow Control Copy Flow Control No Copy2 Epoch Generate ON Epoch Size Divisible by 4 must match blocksize Epoch Generate Epoch Size Divisible by 4 must match blocksize 1 The final module in an append chain may require BOF to be Off for compat ibility with data receivers that cannot process BOFs 2 Set intermediate modules to Copy and the last module to No Copy 22 Agilent
85. 65 Using clock and sync in chapter 3 72 Note id adcDivider adcDividerPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_adc_divider Determines which divider is applied to the ADC clock source This description also includes the query function age1439_adc_divider_get VXIplug amp play Syntax include age1439 h ViStatus age1439 adc divider ViSession id ViInt16 adcDivider ViStatus age1439 adc divider get ViSession id ViPInt16 adcDividerPtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup Description This function should generally be left in the default mode The alternate mode applies to a different model of the module Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 DIVIDE BY 10 divides the ADC clock by 10 1439 DIVIDE BY 38 divides the ADC clock by 38 points to the current value of adcDivider Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 Comments The Agilent E1439 normally runs its sample clock at 95 MHz It divides that clock by 38 to generate 2 5 MHz which be compared against a user supplie
86. 76 gets the external clock frequency age1439 filter sync on page 123 synchronizes the decimation filter counter agel1439 frequency sync and age1439 frequency center on page 128 the mod ules for frequency change 1439 meas control on page 151 synchronizes arming and triggering in multi module systems agel1439 trigger gen on page 183 determines whether a module can generate a trigger agel1439 trigger gen get on page 183 gets the trigger generation status agel1439 wait on page 189 facilitates the synchronization and control of multi module sys tems 66 Agilent E1439 Programmer s Reference Functions listed alphabetically Functions listed alphabetically age1439_adc_clock on page 72 determines the ADC clock source age1439_adc_clock_get on page 72 gets the ADC clock source age1439_adc_divider on page 73 determines which divider is applied to the ADC clock source age1439_adc_divider_get on page 73 gets the module s current clock divider state age1439_attrib_get on page 74 gets low level attributes of current I O library session age1439_cal_get on page 75 gets last calibration date of specified board age1439_clock_fs on page 76 provides the module with the frequency of an external sample clock age1439_clock_fs_get on page 76 gets the current external sample clock frequency 1439 clock recover on page 77 allows recovery from an out of spec exter
87. 80 E1439 00245 009 7121 1893 1 PLT NAME SPARK 06363 7121 7893 010 7121 7965 1 PLT NAME VXI PLUG amp PLAY 06363 7121 7965 1400 45101 1 MOLD TOP 28480 E140045101 MP012 E1400 45102 1 MOLD BOTTOM 28480 E140045102 013 E1400 00610 2 SCR ASM SHLDR 28480 E1400 00610 014 E1400 45011 1 MOLD TOP SPARK 28480 1400 45011 015 1400 45008 1 MOLD BTTM VXI 28480 1400 45008 MP016 0515 0664 2 SCREW MACHINE ASSEMBLY M3 X 0 5 12MM LG 07606 0515 0064 MP017 0515 2733 2 SCREW SPCL M2 5 X 0 45 17MM LG PAN HD 07606 0515 2733 MP018 E1400 40104 2 CAST 28480 E1400 40104 MP019 2190 0068 3 WASHER LK INTL T 1 2 IN 505 IN ID 07606 1924 02NP 020 2950 0154 3 NUT HEX DBL CHAM 1 2 28 THD 078 IN THK 04605 2950 0154 021 2190 0124 4 WASHER LK INTL NO 10 195 IN ID 04637 500222 022 2950 0078 4 NUT HEX DBL CHAN 10 32 THD 067 IN THK 04637 500220 023 0515 0430 1 SCREW MACHINE M3 X 0 5 6MM LG 05610 0515 0430 024 0515 1103 1 SCREW MACHINE M3 X 0 5 10MM LG 05610 0515 1103 223 Replacing Assemblies Replaceable parts To remove the top cover 224 Replacing Assemblies Replaceable parts To remove the M1 M2 assemblies 225 Replacing Assemblies Replaceable parts 226 Glossary anti alias filter baseband block mode block size BOF continuous mode data frames decimation filter EOE epoch fiber frame FIFO FPDP LO zoom An analog low pass filter inserted the signal pa
88. 82 AGE1439 RANGE 34 34 2 251 AGE1439 RANGE 33 33 3 224 AGE1439 RANGE 32 32 4 12 AGE1439 RANGE 31 31 b 178 AGE1439 RANGE 30 30 4 159 AGE1439 RANGE 29 29 4 141 Agilent E1439 Programmer s Reference Functions listed alphabetically Variable Range Index i rg LN AGE1439 RANGE 28 28 38 126 AGE1439 RANGE 27 27 9 112 AGE1439 RANGE 26 26 10 4 AGE1439 RANGE 25 25 41 089 AGE1439 RANGE 24 24 42 0794 AGE1439 RANGE 23 23 43 0708 AGE1439 RANGE 22 22 44 0631 AGE1439 RANGE 21 2 45 0562 AGE1439 RANGE 20 20 16 0501 AGE1439 RANGE 19 19 47 10447 AGE1439 RANGE 18 18 418 0398 AGE1439 RANGE 17 17 49 0355 AGE1439 RANGE 16 16 20 0316 AGE1439 RANGE 15 15 21 10282 AGE1439 RANGE 14 14 22 0251 AGE1439 RANGE 13 13 23 0224 AGE1439 RANGE 12 12 24 02 AGE1439 RANGE 11 1 25 0178 AGE1439 RANGE 10 10 26 0158 AGE1439 RANGE 9 9 27 0141 AGE1439 RANGE 8 8 28 0126 AGE1439 RANGE 7 7 29 0112 AGE1439 RANGE 6 6 30 01 AGE1439 RANGE 5 5 31 0089 AGE1439 RANGE 4 4 32 0079 AGE1439 RANGE 3 3 33 0071 AGE1439 RANGE 2 2 34 0063 AGE1439 RANGE 1 1 35 0056 AGE1439 RANGE 0 0 36 005 AGE1439 RANGE MIN 0 Note These values are approximate For more accuracy use age1439 data scale get Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 1
89. C tab and add INSTR REAL32 to the preprocessor definitions In a makefile or on a command line supply the option D INSTR REAL32 to cl exe See the acvolts exe example programs This function performs the following sequence 1 Checks for AGE1439 STATUS READ BLOCK and 1439 STATUS _ OVERLOAD 2 If a block of data is NOT ready A The function immediately returns the current measurement state 3 Ifa block of data IS ready A Data is read from the module B It is converted to a floating point number and scaled C The function returns any errors that were encountered when reading the data D The value of the overload argument is set to indicate whether any overloads have occurred since the last successful read 159 data sampleCount overloadPtr Agilent E1439 Programmer s Reference Functions listed alphabetically Parameters is the VXI instrument session pointer returned by the age1439_init function is a pointer to the array into which the floating point data is to be placed Be sure to allocate sufficient storage space at this location to hold the full data record as determined by the sampleCount parameter Note that when the module is set to complex data type the output data record contains 2 x sampleCount floating point values For real data the record contains sampleCount floating point values for age1439_read sampleCount is the number of real or complex data values to read Real data is one 32 bit floa
90. DC The ADC generates 12 bit outputs at a sample rate up to 95 MHz This raw unfiltered data can be output via the E1439D s fiber optic interface Zoom and Decimation Filtering This section uses digital circuitry to allow programmable changes in the center frequency and signal bandwidth of the E1439 zoom This is done at high speed for real time operation Bandwidth is controlled by a chain of digital low pass filters see the diagram below Each of the filters reduces the bandwidth by a factor of two decimation With the ADC sample rate fs set to the standard internal 95 0 MHz rate the bandwidth choices are 40 MHz 20 MHz 10 MHz 76 Hz around the programmed local oscillator LO frequency Real and imaginary components of the signal are each computed to 24 bit precision so the complex output of the decimation filtering block contains 48 bits Whether or not all of these bits are stored in memory is programmable Decimate Decimate Local 18 Y Y Y Oscillator 94 Real DATA OUTPUT SELECTION AND MULTIPLEXING 24 2 Imag 90 deg A Shift 16 ES 2x Lan Fs8 1 1111 2x 19 P Decimate Fs 2 Memory Controller and SDRAM Memory The E1439 can be programmed to save the real component of the signal or to save the complete complex signal The
91. E1439 RANGE TIME MIN AGE1439 RATE 106MBS AGE1439 RATE 250MBS AGE1439 REAL AGE1439 REAR MSTR EXT REF AGE1439 REAR MSTR INT REF 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 4 42 43 44 45 46 47 48 48 0 20 Variable Agilent E1439 Programmer s Reference Equivalent numeric values for variables Numeric Value AGE1439 REAR SLAV EXT REF AGE1439 REAR SYNC EXT SAMP AGE1439 RELEASE AGE1439 REVERSED AGE1439 RM HANDLE AGE1439 AGE1439 ERR ALIGNMENT AGE1439 RX ERR BEGIN DISPARITY AGE1439 RX ERR CODE VIOLATION AGE1439 RX ERR CRC AGE1439 RX ERR DISPARITY AGE1439 RX ERR FIFO OVERFLOW AGE1439 RX ERR SIGNAL LOST AGE1439 RX ERR SYNC LOST AGE1439 RX ERR UNLOCKED AGE1439 SIG BW MAX AGE1439 SIG BW MIN AGE1439 SIGNAL OFF AGE1439 SIGNAL ON AGE1439 SIMPLE EXT REF AGE1439 SIMPLE EXT SAMP AGE1439 SIMPLE INT REF AGE1439 SMB CLOCK AGE1439 ST ANALOG FAIL AGE1439 ST CLOCK1 FAIL AGE1439 ST CLOCK2 FAIL AGE1439 ST DIGITALI FAIL AGE1439 ST DIGITAL2 FAIL AGE1439 ST EXECUTION ERR AGE1439 ST FIBER FAIL AGE1439 ST HARDWARE FAIL AGE1439 ST MEMORY FAIL AGE1439 ST SERIAL1 FAIL AGE1439 ST SERIAL2 FAIL AGE1439 ST SUCCESS AGE1439 STATUS ARMED AGE1439 STATUS BLOCK READY AGE1439 STATUS ERROR QUEUE AGE1439 STATUS FIBER ACTIVE AGE1439 STATUS FIBER ERROR 16 22 0 1 128 64 512 18 0 4 0 100 0 008 0 010 0 040 0 080 0 4000 0 200 0 001 0 020 0X0
92. FIFO overflows With the Sync line released it is then possible to change the center frequency for one or multiple modules without interrupting the measurement See Synchronizing changes in multi module systems on page 39 Amodule may be programmed explicitly to inhibit its transition to the Arm state despite Sync transitions e In addition to controlling the progression through the four module states the Sync signal is used to synchronize the decimation counters and local oscillators of multiple E1439 modules 24 Using the Agilent E1439 Delay and phase in triggered measurements Delay and phase in triggered measurements It is important to note that the trigger delay is specified in terms of output samples When using the digital filters within the E1439 to reduce the sample rate there are multiple ADC samples corresponding to each output sample In order to determine the relationship between the first output sample of a block and the actual ADC sample where the trigger occurred you must read the actual delay from the module using age1439_trigger_delay_actual_get This relationship varies from block to block and is a function of the particular value of counters within the digital filters at the time the trigger occurs Thus the actual delay from the trigger event is the delay from age1439_trigger_delay_get multiplied by 25084 from age1439_filter_bw_get if filter decimation is used or 2IsigBw 1 if filter decimation is off From thi
93. Generally cyclic redundancy checking should be enabled but turning CRC off may solve compatibility problems with some fiber optic receivers 1439 enables CRC checking AGE1439_CRC_OFF disables CRC checking points to the current value of crcEnable is used to turn the fiber interface off configure it to copy data from the receiver to the transmitter port without adding data configure the transmission of filtered ADC data or configure appending ADC data to received data AGE1439_ FIBER MODE RAW allows the transmission of unfiltered full bandwidth ADC data at the same time filtered ADC data is available to read on the VME bus or the local bus 1439 FIBER MODE OFF turns off both the fiber transmitter and receiver although 1 PIO2 NRDY and DIR bits are still received Normal data collection and digital processing continues If age1439 data port is set to fiber while the fiber interface is turned off the data FIFO will fill up with filtered ADC data and collection will stop In this case age1439 meas status get will return the error AGEI439 NO DATA MEASUREMENT PAUSED 1439 FIBER MODE COPY is the default fiberMode at power on and reset Data is copied from the fiber interface receiver to the fiber interface transmitter while the module is performing other measurements For instance filtered ADC data can be sent on the LBUS or read from the FIFO over the VME bus in accordance with the current
94. IZE DEF AGE1439 BLOCKSIZE MAX AGE1439 BLOCKSIZE MIN AGE1439 BOF OFF AGE1439 BOF ON AGE1439 BNC CLOCK AGE1439 CENT FREQ DEF AGE1439 CENT FREQ MAX AGE1439 CENT FREQ MIN AGE1439 CLOCK OFF AGE1439 CMPLXDC OFF AGE1439 CMPLXDC ON AGE1439 COMPLEX AGE1439 CRC OFF AGE1439 CRC ON 2047 2048 0 0 1024 805306320 2 0 1 Agilent E1439 Programmer s Reference Equivalent numeric values for variables Variable Name Numeric Value AGE1439 CONTINUOUS 1 AGE1439 CUSTOM CLOCK SETUP 4 AGE1439 DATA DELAY MAX 805306320 AGE1439 DATA DELAY MIN 0 AGE1439 DATA REGISTER 3 AGE1439 DC 0 AGE1439 DEBUG LEVEL 0 0 AGE1439 DEBUG LEVEL_1 1 AGE1439 DEBUG LEVEL 2 2 AGE1439 DEBUG LEVEL 3 3 AGE1439 DEBUG LEVEL 4 4 AGE1439 DEBUG LEVEL 5 5 AGE1439 DECIMATE OFF 0 AGE1439 DECIMATE ON 1 AGE1439 DECIMATE SHIFT 2 AGE1439 DIVIDE BY 10 0 AGE1439 DIVIDE BY 38 1 AGE1439 DIVIDED ADC CLOCK 2 AGE1439 EPOCH GEN OFF 0 AGE1439 EPOCH GEN ON 1 AGE1439 EPOCH SIZE MIN 8 AGE1439 EPOCH SIZE DEF 1024 AGE1439 EPOCH SIZE 4294967292 AGE1439 EXTERNAL 2 AGE1439 ERR BASE 0X80000000 800 AGE1439 EXTERNAL 2 AGE1439 EXTERNAL TTL 5 AGE1439 EXT SAMPLE CLOCK 2 AGE1439 EXT SAMP SYNC ENABLE 1 AGE1439 EXT SAMP SYNC CANCEL 0 AGE1439_Fl_ERR_ UNLOCKED 512 AGE1439 FIBER AGE1439 FIBER MODE APPEND AGE1439 FIBER MODE COPY AGE1439 FIBER MODE GENERATE AGE1439 FIBER MODE OFF AGE1439 FIBER MODE RAW AGE1439 FIBER SIG OFF AGE1439 FIBER SIG ON A N ON O U
95. LEVEL FS 0 AGE1439 MAG LEVEL MAX 40 AGE1439 MAG LEVEL MIN 337 AGE1439 MAG LEVEL SCALE 0 37628749457997662 AGE1439 NEGATIVE 1 AGE1439 NO FIBER SIGNAL 0 AGE1439 NORMAL 0 AGE1439_OFF 0 AGE1439 OFFS DAC MAX 255 AGE1439 OFFS DAC MIN 0 AGE1439 ON 1 AGE1439 OFF 0 AGE1439 PIO ON 1 AGE1439 PIPELINE 0 AGE1439 POSITIVE 0 AGE1439 PRESCALE BY 1 0 AGE1439 PRESCALE BY 4 1 AGE1439 RANGE 0 0 AGE1439 RANGE 1 1 AGE1439 RANGE 2 2 AGE1439 RANGE 3 3 AGE1439 RANGE 4 4 AGE1439 RANGE 5 5 AGE1439 RANGE 6 6 AGE1439 RANGE 7 7 AGE1439 RANGE 8 8 AGE1439 RANGE 9 9 AGE1439 RANGE 10 10 AGE1439 RANGE 11 Ti AGE1439 RANGE 12 12 AGE1439 RANGE 13 13 AGE1439 RANGE 14 14 AGE1439 RANGE 15 15 AGE1439 RANGE 16 16 AGE1439 RANGE 17 17 193 Agilent E1439 Programmer s Reference Equivalent numeric values for variables 194 Variable Name Numeric Value AGE1439 RANGE 18 AGE1439 RANGE 19 AGE1439 RANGE 20 AGE1439 RANGE 21 AGE1439 RANGE 22 AGE1439 RANGE 23 AGE1439 RANGE 24 AGE1439 RANGE 25 AGE1439 RANGE 26 AGE1439 RANGE 27 AGE1439 RANGE 28 AGE1439 RANGE 29 AGE1439 RANGE 30 AGE1439 RANGE 31 AGE1439 RANGE 32 AGE1439 RANGE 33 AGE1439 RANGE 34 AGE1439 RANGE 35 AGE1439 RANGE 36 AGE1439 RANGE 37 AGE1439 RANGE 38 AGE1439 RANGE 39 AGE1439 RANGE 40 AGE1439 RANGE 41 AGE1439 RANGE 42 AGE1439 RANGE 43 AGE1439 RANGE 44 AGE1439 RANGE 45 AGE1439 RANGE 46 AGE1439 RANGE 47 AGE1439 RANGE 48 AGE1439 RANGE MAX AGE1439 RANGE MIN AGE1439 RANGE TIME MAX AG
96. N is used in an optical append chain When used in this manner all but the last module in the append chain should have BOF events enabled The first module in the append chain should also have fiberMode set to AGE1439 FIBER MODE GENERATE This will cause it to generate a BOF event after every EOE event in other words at the end of every data epoch it sends All subsequent modules in an append chain should have fiberMode set to AGE1439 FIBER MODE In this case the module re transmits received data epochs without modification The reception of a BOF event alerts the module to the opportunity to insert a data epoch of its own if available between the reception of EOE and BOF events 1439 BOF ON is only available when epochGenerate is ON and fiberMode is either generate or append otherwise this setting is silently accepted and ignored 112 bofEnablePtr crcEnable crcEnablePtr fiberMode Note Note Agilent E1439 Programmer s Reference Functions listed alphabetically 1439 BOF OFF is the default setting It blocks the transmission of all automatically generated BOF events However programmatically generated BOF events such as age1439_ fiber_xmt_BOF whichareusedinthesynchronizationoffiberinterfaces arenotblocked points to the current value of bofEnable determines whether or not cyclic redundancy checking CRC is performed on the fiber receiver and whether or not that information will be transmitted
97. O HANDLE accesses the I O library handle 1439 IO ADDRESS points to the mapped I O base address of the module 1439 HANDLE accesses the I O library handle of the default resource manager 1439 DATA REGISTER points to the mapped address of the Agilent E1439 data register One or both of these parameters are used when calling I O library functions directly is the value of the requested attribute For the VISA I O library the value of the handle attribute corresponds to the vi parameter used by the majority of the I O functions The address attribute points to the base of the mapped I O address space Example See the interrupt c example program Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also agel439 init on page 132 1439 interrupt setup on page 146 74 board datestampPtr Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 cal get Gets last calibration date of specified board VXIplug amp play Syntax include age1439 h ViStatus age1439 cal get ViSession id Vilnt16 board ViPInt32 datestampPtr Description agel439 cal get is used to read the date stamp of the last calibration Parameters is the VXI instrument session pointe
98. O OW 0 36 MHz Sampling 1 5 Offset DAC P To Digital Filters I DC A The source for a clock signal is the 95 MHz crystal oscillator inside the E1439 This oscillator can free run or be locked to an external reference signal through the front panel BNC Ext Clock Ref This signal can be TTL ECL or sine wave The oscillator can also be locked to a reference routed via the backplane A 2 5 MHz reference signal is available to be routed out the front panel or the backplane to lock additional E1439s 213 Module Description Block diagram and description In a system using more than one E1439 the ADCs can be synchronized by programming them to use acommon SYNC reference available via the front panel or backplane One of the modules can be the master that drives this SYNC line This master SYNC can be extended to other mainframes by connecting an Intermodule Clock SMB connector to an Intermodule Clock SMB connector on an E1439 in the second mainframe Ext Clock Ref zo BNC ys i p VXI Bus BNC Ref Clk 4 95 MHz 9 Sample SMB gt or Phase Clk to ADC i o_o p o Intermodule 1 detector 95 Mhz Clock 2 25 VXI o Local M Y gt o Anti alias Filter Since the ADC sample rate is 95 MHz a complete representation of the input signal can be achieved only for bandwidths u
99. ROL DIGITAL FILTERS VME BUS Processing LBUS Fiber Interface Setup Mode Generate Rate 106 or 250 MBs BOF Optional CRC ON Flow Control No Copy Epoch Generate Optional Epoch Size Divisible by 4 49 Note Using the Agilent E1439 Fiber Optic Interface Append The Append fiber mode copies optical data from its fiber receiver to its fiber transmitter and appends its own filtered ADC data This mode is required in an optical fiber append chain For the first module in an append chain set the fiber mode to Generate BOF to ON and Epoch Generate to ON The module generates data epochs in the standard fashion and a BOF is sent after each epoch For all modules after the first set fiber mode to Append BOF to ON and Epoch Generate to ON Each module copies received data to its transmitter output until a BOF is received The module then sends one epoch of filtered data from its ADC if at least one block is available followed by a BOF In block data mode the data from a single trigger is transmitted Subsequent triggers should not be generated faster than the data can be transmitted In continuous data mode the generated data must not exceed the available fiber bandwidth allowing the data to be merged without data loss from a FIFO overrun Therefore you must reduce the generated sample rate using either an external sample clock operating at a slower rate or data decimation If you use an external sample clo
100. SYNC OUTPUT SYNC DIRECTION VCXO EXT REF VCXO ON DIVIDE BY 38 PRESCALE BY 4 DIVIDED CLOCK FRONT PANEL CLOCK BNC_CLOCK CLOCK OFF DIVIDED ADC CLOCK SYNC OUT VXI REAR TO FRNT Agilent E1439 Programmer s Reference Functions listed alphabetically Rear slave phase locked to master AGE1439 REAR SLAV EXT REF ADC CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION VCXO EXT REF VCXO ON DIVIDE BY 38 PRESCALE BY 1 CLOCK OFF CLOCK CLOCK OFF CLOCK OFF CLOCK SYNC OUT VXI REAR TO FRNT Multi module external sample setups set all modules the same Front sync external sample clock wired OR sync AGE1439 FRNT SYNC EXT SAMP ADC CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION EXT SAMPLE CLOCK VCXO OFF DIVIDE BY 38 PRESCALE BY 1 CLOCK OFF FRONT PANEL CLOCK BNC CLOCK CLOCK OFF DIVIDED ADC CLOCK SYNC OUT SMB FRNT TO REAR 83 Agilent E1439 Programmer s Reference Functions listed alphabetically Rear sync external sample clock wired OR sync AGE1439 REAR SYNC EXT SAMP ADC_CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK SMB CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION Multiple mainfra
101. Session id Vilnt16 mode ViStatus age1439 data mode get ViSession id ViPInt16 modePtr ViStatus age1439 data port ViSession id ViInt16 port ViStatus age1439 data port get ViSession id ViPInt16 portPtr ViStatus age1439 data resolution ViSession id Vilnt16 resolution ViStatus age1439 data resolution get ViSession id ViPInt16 resolutionPtr ViStatus age1439 data spectral order ViSession id Vilnt16 spectralOrder ViStatus age1439 data spectral order get ViSession id ViPInt16 spectralOrderPtr ViStatus age1439 data type ViSession id ViInt16 dataType ViStatus age1439 data type get ViSession id ViPInt16 dataTypePtr Description The functions age1439 data delay age1439 data mode age1439 data resolution and agel1439 data type work the same for the fiber interface as they do for the other interfaces Parameters is the VXI instrument session pointer returned by the age1439 init function determines the number of sample points in each output data block 6 1439 BLOCKSIZE MIN selects the minimum blocksize 90 Note blocksizePtr dataDelay dataDelayPtr dataType Agilent E1439 Programmer s Reference Functions listed alphabetically AGE1439_BLOCKSIZE MAX selects the maximum blocksize AGE1439_BLOCKSIZE_DEF sets the default blocksize The range of available block sizes depends on the number of bytes required for each sample The command accepts any number between 2 and memory size in bytes x 2 3 If the req
102. The problem in such a case is that the trigger threshold level is actually set too low so that few if any signal samples fall below that level A transition from below the magnitude trigger threshold to above may never be detected if a sample is not taken while the signal is below the trigger threshold The solution is to INCREASE the magnitude trigger level to the level at which there are frequent filter samples occurring both above and below the magnitude trigger threshold points to the current value of the magLevel parameter selects the edge of the trigger source on which a trigger occurs for ADC and external triggers 1439 POSITIVE sets triggering on the positive slope and AGE1439 NEGATIVE on the negative slope points to the current value of the of the trigger s ope parameter determines the trigger source 1439 generates a trigger based on the raw data samples from the ADC 1439 MAG generates a trigger based on the log magnitude of the signal after it has been filtered to a selectable bandwidth around the center frequency established by the age1439_ frequency setup function 185 Note Note Note trigTypePtr Agilent E1439 Programmer s Reference Functions listed alphabetically AGE1439_ EXTERNAL uses transitions on the signal applied to the BNC external trigger connector on the front panel 1439 EXTERNAL ECL uses ECL level transitions on the signal applied to the BNC external trigger conne
103. VEL 4 Reserved AGE1439 DEBUG LEVEL 5 Add output of diagnostic function calls Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also agel439 init on page 132 97 id epochGenerate epochGeneratePtr epochSize Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_epoch_setup Sets the parameters relevant to the transmission of data epochs over the fiber interface This description also includes information on the following functions that set up or query the fiber epoch parameters individually age1439_epoch_generate controls whether data epochs are generated or not age1439_epoch_generate_get gets the epoch generation status age1439_epoch_header sets the value of the first 32 bits of the epoch header age1439_epoch_header_get returns the header value age1439_epoch_header_enable controls whether epoch headers are generated or not age1439_epoch_header_enable_get gets the header status age1439_epoch_size sets the size of the data epoch in bytes age1439_epoch_size_get gets the size of the data epoch VXIplug amp play Syntax include age1439 h ViStatus age1439_epoch_setup Visession id Vilnt16 epochGenerate Vilnt32 epochSize Vilnt16 headerEnable ViInt32 initialValue Vilnt32 inc
104. VXIplug amp play Syntax include age1439 h ViStatus age1439 fiber xmt BOF ViSession id Parameter is the VXI instrument session pointer returned by the age1439 init function Return ValueAGE1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 117 piol pio2 Note dir nrdy Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_fiber_xmt_signals Sets the transmitted values of PIO1 PIO2 DIR and NRDY FPDP control signals on the fiber transmitter VXIplug amp play Syntax include age1439 h ViStatus age1439 fiber xmt signals ViSession id ViInt16 pio Vilnt16 pio2 Vilnt16 dir Vilnt16 nrdy Description These are embedded Serial FPDP signals The use of these bits is optional Serial FPDP does not use these four signals directly but simply transmits them from sender to receiver These functions set the value of PIOI PIO2 DIR and NRDY bits on the fiber transmitter The default value of these signals is O Parameter is the VXI instrument session pointer returned by the age1439 init function Programmable I O bit on the fiber transmitter for user defined purposes Programmable I O bit on the fiber transmitter for user defined purposes AGEI1439 FIBER
105. a epochs on the fiber interface age1439 epoch size on page 98 sets the size of data epochs in bytes agel1439 epoch size get on page 98 returns the current size of data epochs agel439 error message on page 102 returns error information obtained from function calls agel1439 error query on page 103 queries the module for the most recent error agel439 ext sample sync on page 104 enables and disables sync to an external sam ple clock agel439 ext sample sync get page 104 gets the state of external sample sync agel1439 fiber on page 112 controls whether or not automatically generated BOF events are transmitted agel1439 fiber get on page 112 returns the current value of bofEnable age1439 fiber clear on page 106 clears all data from the fiber interface FIFO buffers age1439 fiber crc on page 112 sets up the fiber interface to transmit and receive cyclic redundancy checks agel1439 fiber crc get on page 112 returns the current status of the cyclic redundancy check setting agel1439 fiber error clear on page 107 clears fiber errors from the status register agel1439 fiber error get on page 108 returns the value of the fiber interface error reg Ister age1439 fiber flow control on page 112 configures fiber flow control enabling or disabling transmitter flow control signals agel1439 fiber LED get on page 110 returns a data register indicating the state of the front p
106. aft standard However laboratory testing at Agilent Technologies has demonstrated interoperability of the E1439D with fiber optic products from other manufacturers that also intend to support the draft standard These products include Systran Simplex Link Protocol products such as the SL100 and SL240 and Mercury Computer products such as the RINOJ F RACEway I O daughter card The following overview supplies the basic concepts required to use all the supported features For details see the descriptions of the API functions 43 Using the Agilent E1439 Fiber Optic Interface Fiber Frames Data is transmitted over the fiber interface in a series of fiber frames Each fiber frame is composed of a series of 32 bit values which encode to 40 bits Each 32 bit value can either be data or an ordered set Data and ordered sets are strung together to make the three types of fiber frames Data Frame BOF and EOE The Data Frame transmits 0 to 512 32 bit data words The exact amount of data that is sent depends on the amount of data that is available when the fiber interface is ready to send the Data Frame BOF Beginning Of Frame is a synchronizing event that can be sent just prior to the start of data transmission EOE End Of Epoch is a synchronizing event that contains the last 4 data bytes in an epoch An epoch is composed of one or more Data Frames followed by an EOE The following shows the ordered sets and data that make up the three fiber fram
107. age on page 102 See Also Default values on page 201 1439 init on page 132 age1439 sync output on page 180 agel439 sync clock on page 178 Using clock and sync in chapter 3 179 Note id syncOutput syncOutputPtr Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 sync output Selects the output for the sync signal This description also includes the query function agel439 sync output get VXIplug amp play Syntax include age1439 h ViStatus age1439 sync output ViSession id Vilnt16 syncOutput ViStatus age1439 sync output get ViSession id ViPInt16 syncOutputPtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup Description This function selects which output the module should use for it s sync signal Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 SYNC OUT OFF specifies no sync signal output 1439 SYNC OUT BOTH specifies that the sync signal be output to both the front panel SMB sync connectors and the VXI backplane 1439 SYNC OUT SMB specifies that the sync signal be output to the front panel SMB sync connectors 1439 SYNC OUT VXI specifies that the sync signal be output to the VXI backplane Returns a pointer to the current value of syncOutput Return Value AGEI1439 SUCCESS indicates that a
108. age 181 age1439 frequency setup on page 128 Delay and phase in triggered measurements in chapter 3 Trigger and phase in multi module systems in chapter 3 182 Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_trigger_setup Sets all triggering parameters This description also includes information on the following functions which set or query the trigger parameters individually age1439_trigger_adclevel specifies the trigger threshold for an ADC trigger age1439_trigger_adclevel_get gets the ADC trigger threshold age1439_trigger_delay specifies pre or post trigger delay time age1439_trigger_delay_get gets the trigger delay time age1439_trigger_gen determines whether a module can generate a trigger agel439 trigger gen get gets the trigger generation status agel439 trigger magdwell specifies the wait in samples before transition causes trigger 1439 trigger magdwell get gets the number of dwell samples agel439 trigger maglevel specifies the trigger threshold for a magnitude trigger agel439 trigger maglevel get gets magnitude trigger threshold 1439 trigger slope selects a positive or negative trigger agel1439 trigger slope get gets trigger slope 1439 trigger type determines the trigger type agel439 trigger type get gets trigger type VXIplug amp play Syntax include age1439 h ViStatus age1439 trigger setup ViSession id ViInt16 trigType ViInt32 trigDelay Vilnt16 adcLe
109. age 74 133 Note Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_input_autozero Nulls out the input dc offset voltage applies to baseband input configuration only VXIplug amp play Syntax ftinclude age1439 h ViStatus age1439 input autozero ViSession id Description agel1439 input autozero updates a table of dc offset corrections to be used with each signal path The applicable correction from this table is automatically added to the input offset parameter to achieve the correct dc offset value Because of the length of time needed to execute this function it is not automatically called when the module is reset Thus the user program is responsible for explicitly initiating the auto zero This function should be called at least once after the temperature of the module has stabilized The interval between calls after that depends on the importance of dc accuracy in the user application It is not necessary to call the auto zero function for every change of input setup parameters since the correction table maintains values for all setup conditions Calling age1439 input autozero aborts any measurement already in progress and eliminates LO phase coherence and filter synchronization in a synchronous multi module system See the age1439 filter sync and age1439 frequency sync functions for details on how to re establish LO phase coherence and filter synchronization Calling this function deletes any sav
110. age 90 age1439 data delay on page 90 age1439 data delay get on page 90 age1439 data mode on page 90 age1439 data mode get on page 90 age1439 data port on page 90 age1439 data port get on page 90 age1439 data resolution on page 90 age1439 data resolution get on page 90 age1439 data spectral order on page 90 age1439 data spectral order get on page 90 age1439 data type on page 90 age1439 data type get on page 90 age1439 data xfersize on page 96 age1439 data xfersize get on page 96 age1439 filter bw on page 120 age1439 filter bw get on page 120 age1439 filter decimate page 120 1439 filter decimate get on page 120 age1439 filter sync on page 123 age1439 frequency center on page 128 age1439 frequency center get on page 128 age1439 frequency center raw on page 125 age1439 frequency center raw compute on page 127 age1439 frequency center raw get on page 125 age1439 frequency cmplxdc on page 128 age1439 frequency cmplxdc get on page 128 age1439 frequency sync on page 128 age1439 frequency sync get on page 128 age1439 front panel clock input on page 131 age1439 front panel clock input get on page 131 age1439 input alias filter on page 141 age1439 input alias filter get on page 141 age1439 input autozero on page 134 age1439 input coupling on page 141 age1439 input coupling get on page 141 age1439 input offset on page 135 age1439 input offset get
111. als get page 111 age1439 fiber signal get on page 115 age1439 fiber verify on page 116 age1439 fiber xmt page 117 age1439 fiber xmt signals on page 118 age1439 fiber xmt signals get on page 118 age1439 attrib get on page 74 age1439 cal get on page 75 age1439 driver debug level on page 97 age1439 driver debug level get on page 97 age1439 error message on page 102 age1439 error query on page 103 age1439 interrupt mask get on page 146 age1439 interrupt priority get on page 146 Component Capability Subclass Agilent E1439 Programmer s Reference Functions listed by class Function Name age1439 interrupt restore on page 145 age1439 interrupt setup on page 146 age1439 options get on page 157 age1439 product id get on page 158 age1439 reset on page 167 age1439 reset hard on page 168 age1439 revision query on page 169 age1439 self test on page 170 age1439 serial number on page 172 age1439 serial number get on page 172 age1439 state save on page 175 age1439 state recall on page 174 age1439 status get on page 176 59 Agilent E1439 Programmer s Reference Functions listed by functional group Functions listed by functional group This section lists the programing functions in groups of related functions A brief description of each group follows Tnitializing and closing on page 61 You must initialize the I O driver and set up each module before using
112. andwidth precision and whether the combination permits block or continuous measurements Continuous mode is only limited by maximum transfer rate of the selected interface decimate filterBW Mene 0 100 1 50 2 50 2 25 3 25 3 12 5 94 BW s 100 MHz 40 20 12b real 24b real b b d b d b c d b d b c d b d b c d b c d 12b complex 246 complex b b bd b bd b b c d bd spectralOrder Agilent E1439 Programmer s Reference Functions listed alphabetically sample rate BW s 100 decimate filterBW Msamples s MHz 12b real 24b real 12b complex 246 complex 0 4 12 5 2 5 b c d b c d b c d bd 1 4 6 25 2 5 b c d b c d b c d b c d 0 5 6 25 1 25 b c d b c d b c d b c d b block mode continuos mode to fiber at the fiber transfer rate of 250 Mbytes per second c continuous mode to local bus d continuous mode to fiber at the fiber transfer rate of 106 Mbytes per second This parameter is intended for use only with the IF signal path providing efficient and transparent compensation for the effect of down conversion on output data It does not generate an error if it is set in baseband mode though spectralOrder remains AGE1439_NORMAL 1439 NORMAL means that the spectrum of the output data will be in the same spectral order as the input signal That is if the input signal increases in frequency from right to left so does the spectrum of the output data 1439 REVERSED means that the spect
113. anel XMT RCV led s age1439 fiber mode on page 112 selects the fiber interface mode agel1439 fiber mode get on page 112 gets the current mode of the fiber interface age1439 fiber rcv signal get on page 111 displays the current value of PIO2 DIR and NRDY bits on the fiber receiver agel1439 fiber signal get on page 115 returns a value indicating whether or not an optical signal is detected by the optical fiber interface receiver age1439 fiber setup on page 112 sets the parameters associated with the fiber inter face agel1439 fiber transfer rate on page 112 selects the transfer rate for fiber optic data agel1439 fiber transfer rate get on page 112 gets the current selection of transfer rate for fiber optic data age1439 fiber verify on page 116 preforms a verification of the fiber interface using either an internal of external signal path agel1439 fiber xmt on page 117 sends BOF event used for synchronization Agilent E1439 Programmer s Reference Functions listed alphabetically with other fiber interfaces before data acquisition begins age1439_fiber_xmt_signals on page 118 sets the transmitted values of any PIO2 DIR or NRDY FPDP control signals on the fiber transmitter age1439_fiber_xmt_signals_get on page 118 displays the current value of PIO2 DIR and NRDY bits on the fiber transmitter age1439 filter bw on page 120 sel
114. at a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 158 Note Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 read Reads scaled 32 bit floating point data from the VME backplane register This description also includes the following function agel1439 read64 reads scaled 64 bit floating point data implemented specifically for VEE applications VXIplug amp play Syntax include age1439 h ViStatus age1439 read ViSession id ViReal32 data Vilnt32 sampleCount ViPInt16 overloadPtr ViStatus age1439 read64 ViSession id ViReal64 data Vilnt32 sampleCount ViPInt16 overloadPtr Description age1439 read returns a block of floating point data from the Agilent E1439 that has been scaled to be in volts The function waits for a block of data to be ready before attempting to read the block These functions can only read data from the VME backplane register The data port of the Agilent E1439 must be set to AGEI439 by the age1439 data port function for these functions to be effective When using this function INSTR REAL322 should be defined when compiling C C programs To do this in the Microsoft Visual Development environment go to Project Settings select the C
115. ations To transport the module e Package the module using the original factory packaging or packaging identi cal to the factory packaging e If returning the module to Agilent Technologies for service attach a tag describing the following of service required Return address e Model number e Full serial number In any correspondence refer to the module by model number and full serial number Mark the container FRAGILE to ensure careful handling e f necessary to package the module in a container other than original packaging observe the following use of other packaging is not recommended e Wrap the module in heavy paper or anti static plastic Protect the front panel with cardboard e Use double wall carton made of at least 200 pound test 32 ECT material Cushion the module to prevent damage For example several layers of plastic bubble wrap is usually sufficient Do not use styrene pellets in any shape as packing material for the module The pellets do not adequately cushion the module and do not prevent the module from shifting in the carton In addition the pellets create static electricity that can damage electronic components Installing the Agilent E1439 To transport the module Getting Started with the Agilent E1439 Note Getting Started with the Agilent E1439 Getting Started and Introduction Getting Started and Introduction This section helps you get your Agilent E1439 ru
116. bandwidth VXIplug amp play Syntax include age1439 h ViStatus age1439 filter setup ViSession id Vilnt16 sigBw Vilnt16 decimate ViStatus age1439 filter decimate ViSession id Vilnt16 decimate ViStatus age1439 filter decimate get ViSession id ViPInt16 decimatePtr ViStatus age1439 filter bw ViSession id Vilnt16 sigBw ViStatus age1439 filter bw get ViSession id ViPInt16 sigBwPtr Parameters is the VXI instrument session pointer returned by the age1439 init function selects the data output sample rate When this parameter is set to AGEI439 DECIMATE OFF the output sample rate is fs when sigBw 0 or fs 2 sigBw 1 when sigBw gt 0 When decimate is set to 1439 DECIMATE ON the output sample rate is reduced by additional factor of two by discarding alternate samples 1439 DECIMATE SHIFT is like AGE1439 DECIMATE ON but additional processing is performed that shifts the center frequency of zoomed data up by 5 4 and transforms the complex data stream into a real data stream without losing phase information For consistent spectrum measurements the data scale value is doubled when using shift decimate points to the current value of the decimate parameter selects an alias protected signal filter bandwidth that is roughly fs 2 56 x 2 sigBw where fs is the ADC sample frequency In zoom applications where the center frequency is generally not zero the zoom filter bandwidth is centered on the frequency programmed
117. ber interface error Fiber hardware required error Hardware does not support TTL trigger Description Unknown error Conflict in memory mapping Unexpected SPIL error SICL specific error Default values Agilent E1439 Programmer s Reference Default values Function Parameter Default Value age1439 adc clock on page 72 adcClock AGE1439 VCXO INTERNAL age1439 adc divider page 73 adcDivider AGE1439 DIVIDE BY 38 age1439 clock setup on page 78 clockSetup AGE1439 SIMPLE INT REF age1439 data setup on page 90 blocksize AGE1439 BLOCKSIZE DEF dataDelay AGE1439 DATA DELAY MIN dataType AGE1439 REAL mode AGE1439 BLOCK port AGE1439 VME resolution AGE1439 12BIT age1439 data xfersize on page 96 age1439 epoch setup on page 98 age1439 ext sample sync on page 104 age1439 fiber setup on page 112 age1439 fiber xmt signals page 118 1439 filter setup on page 120 age1439 frequency setup on page 128 age1439 front panel clock input on page 131 spectralOrder xfersize epochGenerate epochSize headerEnable incrementCount headerValue syncEnable bofEnable crcEnable fiberMode flowControlEnable transferRate pio1 pio2 dir nrdy decimate sigBw cmplxDC centerFreq sync fpClock AGE1439 NORMAL AGE1439 XFERSIZE DEF AGE1439 EPOCH GEN ON AGE1439 EPOCH SIZE DEF AGE1439 HEADER AGE1439 HEADER INCR MIN AGE1439 HEADER VALUE MIN AGE1439 EXT SAMP SYNC CANCEL AGE1439 BOF OFF AGE14
118. call age1439 wait for each other module within the related synchronous group to which you have previously sent commands This function polls the status register of the indicated module until the AGE1439 STATUS _ HARDWARE SET and AGE1439 STATUS SYNC COMPLETE bits are both true or until approximately three seconds have elapsed The function returns AGE1439 SUCCESS immediately after the status bits are set or if the time out limit is reached AGE1439 STATUS WAIT TIMEOUT is returned Parameters is the VXI instrument session pointer returned by the age1439 init function Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 1439 meas start on page 155 1439 meas control on page 151 189 Agilent E1439 Programmer s Reference Equivalent numeric values for variables Equivalent numeric values for variables 190 Variable Name Numeric Value AGE1439 01 BOARD AGE1439 03 BOARD AGE1439_12BIT 6 1439 24 AGE1439 106MBS AGE1439 250MBS AGE1439 AC AGE1439 ADC AGE1439 ADC LEVEL DEF AGE1439 ADC LEVEL MAX AGE1439 ADC LEVEL MIN AGE1439 ANTIALIAS OFF AGE1439 ANTIALIAS ON AGE1439 APPEND AGE1439 ASSERT AGE1439 BB PATH AGE1439 BLOCK AGE1439 BLOCKS
119. center is non zero k 1 otherwise points to the current value of the adclevel parameter is the time delay in units of output samples between when a trigger is received and the first data point in the output data 1439 DELAY MIN selects the minimum allowable trigger delay 1439 DELAY selects the maximum allowable trigger delay 1439 DELAY DEF sets the default trigger delay Negative values indicate a pre trigger condition where samples prior to the trigger event are included in the output data The amount of pre trigger delay is limited to the number of samples which can be saved in the buffer memory See the age1439 data setup function description for the number of bytes used per sample The delay limits depend on the data type as follows Trigger delay in output samples DRAMsize in bytes 24 hit real 24 hit complex 12 bit complex 12 bit real Post trigger 27314 2 314 2 314 Pre trigger 48 4DRAMsizel6 484DRAMsize 3 484DRAMSizel1 5 If trigDelay is Pre trigger a bad parameter error is set points to the current value of the of delay determines whether a module may generate a trigger 1439 GENERATE ON enables triggering 184 genTrigPtr magDwell magDwellPtr magLevel magLevelPtr slope slopePtr trigType Agilent E1439 Programmer s Reference Functions listed alphabetically AGE1439_GENERATE_OFF disables triggering This is useful in mult
120. ch end of the chain BNC input for ECL or TTL signals that can trigger data acquisition For ECL the input is ac coupled 1k ohm edge sensitive For TTL the input is dc coupled 1 k ohm TTL levels 208 ee XMT RCV Analog In 5Vrms Max Agilent Fiber optic serial FPDP data link Dual LC connector D module only LED lights whenever the input range is exceeded producing an overload in the ADC LED lights when an optical signal is detected LED blinks when data is being received D module only Clock Extenders are used to connect the system reference from one mainframe or module to another It is an SMB connector for ECL levels and must be terminated in 50 ohms at each end of the chain BNC input for TTL ECL or sine wave signals that can be used as the ADC sample clock This input can also be used for the system frequency reference This input is ac coupled and has 1 k ohm impedance This is the main input to the ADC It is a single ended input terminated into 50 ohms Module Description VXI backplane connections VXI backplane connections Power Supplies and Ground The E1439 conforms to the VME and VXI specifications for pin assignment The current drawn from each supply is listed in the Technical Specifications Data Transfer Bus The E1439 conforms to the VME and VXI specifications for pin assignment and pr
121. ck operating at a slower rate epoch size must be 1024 bytes a larger epoch size causes a FIFO overrun resulting in a loss of data and a smaller epoch size increases overhead reducing the available bandwidth The available bandwidth is then about 101 MBytes second or 238 MBytes second If you use data decimation an epoch size of approximately 2048 bytes provides the maximum available bandwidth Epoch size and block size must be equal in bytes Since block size is in samples you can multiply block size by the number of bytes per sample to determine the equivalent epoch size Conversely you can divide the epoch size by the number of bytes per sample to determine the equivalent block size Real 12 bit data contains 2 bytes per sample complex 12 bit data and real 24 bit data contains 4 bytes per sample and complex 24 bit data contains 8 bytes per sample 50 Using the Agilent E1439 Fiber Optic Interface The following shows two E1439D modules in an append chain transmitting data to a fiber receiver when flow control is off E1438D E1439D E1438D E1439D Fiber Receiver 2 1 Fiber Fiber gt Fiber RX Fiber TX Fiber RX 3 Fiber TX RX TX 1KB 1KB FIFO FIFO DATA DIGITAL DIGITAL pee FILTERS FIFO ADC Fitters 77 X VME BUS VME BUS Processing LBUS LBUS X Fiber Interface Setup First E1439D in chain Next E1439D in chain Mode Generate Mode Append Rate 106 or 2
122. connectors 6 fiber overflow 44 FIFO OV 44 filter bandwidth See Also decimation filter setting 120 filter decimation See decimation filter filtering overview 30 See Also anti alias filter See Also decimation filter span See zoom measurements firmware upgrading 12 firmware revision determining 169 floating input selecting 143 flow control 44 formatting data See data formatting frequency center changing 39 center overview 30 center setting 128 external sample clock 76 synchronizing changes 129 front panel clock output 173 connectors 208 hardware 208 signal distribution 33 software 15 G generate fiber mode 48 generating data on local bus 148 interrupts 146 GO STOP 44 grounding 209 H hardware interface 13 hardware reset 168 I id module 132 158 IDLE 44 idle state described 23 forcing 86 151 initializing the I O driver 132 initiating an instrument session 132 measurements 151 155 input analog 212 baseband 212 block diagram 212 circuit description 212 coupling 141 IF 212 setup 141 inserting data on local bus 148 installing hardware 3 memory 225 module 3 software 12 Windows libraries 12 instrument state recalling 174 saving 175 interface hardware 13 interrupt generation 146 managing 74 mask setting 146 priority setting 146 invalid measurement conditions 121 L local bus backplane connections 209 described 209 resetting 150 selecting 92 setting mode 148 transfer
123. continues until all data has been transferred or until the module meets the criteria for returning to the Idle state imposed by block mode or continuous mode operation constraints 23 Using the Agilent E1439 The measurement loop Modules programmed for block mode operation assert the Sync line until a complete block of data including any pre programmed pre or post trigger delay has been collected and is available to the I O port The module then releases the Sync line The module returns to the Idle state when the block of data has been collected In continuous mode a module releases sync immediately but moves to the Idle state only if explicitly programmed to do so or if the FIFO data buffer overflows because data cannot be read from the I O port fast enough The measurement loop in multi module systems The following rules generally apply to transitions between states when multiple modules share a Sync signal Ifany one module asserts the Sync line a synchronous state transition occurs for all modules in a system e All modules in a system must have released the Sync line in order to bring about a synchronous transition to Trigger state block mode each module releases the Sync line after its block of data has been collected Immediately upon entering the Measure state in continuous mode each module releases the Sync line It continues to collect and output data until it is programatically signaled to stop or until the
124. ctor on the front panel AGE1439_EXTERNAL_ECL has the same constant value as the 1439 EXTERNAL constant the E1439C AGE1439_EXTERNAL is retained for backward compatibility AGE1439_EXTERNAL_TTL uses TTL level transitions on the signal applied to the BNC external trigger connector on the front panel AGE1439_EXTERNAL_TTL is supported on all E1439B C and D modules but it is not supported on early E1439A modules A module with a serial number lower than US41140000 will result in the error AGE1439_TTL_TRIGGER_NOT_SUPPORTED AGE1439_USER disables the module from any event driven trigger generation though it is still possible to force the module to trigger a measurement by pulling the Sync line once the module is in the trigger state You may do this by calling the age1439_meas_start function waiting for the module to reach the trigger state then triggering the measurement by using age1439 meas control to pull the Sync line 1439 IMMEDIATE triggers a measurement immediately upon entering the trigger state In multi module systems all modules should be use the same trigger type in order to have the same actual delay points to the current value of trigType Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See
125. d 10Mhz reference that we internally divide by 4 age1439 reference prescaler which also generates a 2 5 MHz clock In the case of a multi module system without an external reference clock the master module sends its 2 5 MHz clock out on the VXI bus or front panel smbs for use by the other module s PLLs See Also Default values on page 201 age1439 init on page 132 age1439 clock setup on page 78 Using clock and sync in chapter 3 73 id attribute value Agilent E1439 Programmer s Reference Functions listed alphabetically age1439 attrib get Gets low level attributes of current I O library session VXIplug amp play Syntax include age1439 h ViStatus age1439 attrib get ViSession id Vilnt16 attribute ViPint32 value Description age1439 attrib get is used primarily to manage the use of interrupts which requires making direct VISA function calls Since interrupts are a shared resource across all modules using the VXI interface it is not possible for the Agilent E1439 library which governs single modules to provide the functions to properly manage interrupts This function is used to access either the I O library handle or the mapped I O base address of the module You should refer to the appropriate VISA documentation for descriptions of the I O library functions Parameters is the VXI instrument session pointer returned by the age1439 init function designates the type of attribute to return AGE1439 I
126. d is available to the I O port When the shared Sync signal is released indicating that all block mode data collection is finished all block mode modules move synchronously to the idle state In continuous mode the module releases the Sync signal immediately after moving into the measure state This allows the agel439 meas control function to manipulate the Sync signal to cause synchronous changes to LO frequency while a continuous measurement is in progress In continuous mode a module moves to the idle state only if explicitly programmed to do so or whenever the FIFO data buffer overflows In addition to controlling the progression through the four module states the Sync signal is used to allow for synchronizing the decimation counters and local oscillators of multiple Agilent E1439 modules and synchronizing the fs 10 clock during external sampling This is done by calling age1439 filter sync and or age1439 frequency sync prior to asserting Sync with agel439 meas control This is normally done with the module in the Idle state however the center frequency can also be changed in the Measure state with age1439 frequency sync if the modules are all programmed for continuous non block mode data collection If all modules in a multi module system are in the Idle state when the age1439 meas control sync parameter is asserted the LO frequency is updated and the next measurement is armed If all modules are in the measurement state in continuous mode
127. e id debugLevel debugLevelPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_driver_debug_level Sets and gets the debug level VXIplug amp play Syntax include age1439 h ViStatus age1439 driver debug level ViSession id Vilnt16 debugLevel ViStatus age1439 driver debug level get ViSession id ViPInt16 debugLevelPtr Description This command allows you to set and get debug levels Debug messages are sent to the application debugger using the Windows kernel function Output Debug String This function only works under Windows This function only works with a debug build of the library Debug messages are received by the Microsoft Visual C debugger or can be received by the dbmon example program that comes with Microsoft Visual C You can compile a DEBUG build by opening age1439 32 dsw the Visual C project for the driver DLL age1439 32 dll and selecting the age1439 32 dl Win32 Debug build configuration Parameters is the VXI instrument session pointer returned by the age1439 init function is the debug level points to the value of debugLevel Debug levels are defined as follows Debug Level Description AGE1439 DEBUG LEVEL 0 Only output errors and algorithmic results AGE1439 DEBUG LEVEL 1 Add output of setup function calls AGE1439 DEBUG LEVEL 2 Add output of measurement function calls AGE1439 DEBUG LEVEL 3 Add output of status query function calls AGE1439 DEBUG LE
128. e Setup Fiber Mode Copy Rate 106 or 250 MBs BOF setting ignored CRC must match incoming signal Flow Control setting ignored Epoch Generate setting ignored Epoch Size setting ignored Note Setting the data port to Fiber while in the Copy fiber mode results in an invalid instrument state 46 Note Using the Agilent E1439 Fiber Optic Interface Raw The Raw fiber mode transmits raw i e unprocessed full bandwidth ADC data over the fiber interface At the same time that the raw data is transmitted over the fiber interface filtered ADC data can be sent over the local bus Agilent E1439D only or read from the FIFO via the VME bus After selecting Raw optical data transmission starts at the trigger event and is not affected by trigger delays or data delays The raw data transmission continues even after the measurement is complete Changing the fiber mode stops data transmission See the following illustration E1438D E1439D Fiber TX DIGITAL FILTERS VME BUS Fiber RX Fiber Interface Setup Fiber Mode Raw Rate 108 or 250 MBs BOF Optional CRC Flow Control Optional Epoch Generate Optional Epoch Size Divisible by 4 1 Only with external sam ple Internal sample gen erates data too fast for this rate 2 Some receivers may require CRC to be off for compatibility Setting the data port to Fiber while in the Raw fiber mode results in an invalid instrument
129. e aliasing of signals in the transition frequency band of the filters In many applications this limited aliasing potential is not important For this reason you may optionally choose to apply a final factor of two decimation See the Technical Specifications for detailed information on the digital filter shapes The decimation process used to reduce the output sample rate is driven from a decimation counter that keeps track of which samples to save and which ones to discard for each of the octave bandwidth reduction filter stages In multi module systems where synchronous sampling is required the decimation counters in all the modules must be synchronous with each other See Synchronizing changes in multi module systems on page 39 30 EXT Clock Ref Using clock and sync Using the Agilent E1439 The following diagram shows the flow of clock and sync signals BNC p Intermodule Clock SMB 71 VXI Clock Output Using clock and sync m gt VXI Clock Font Panel Clock SMB Clock Output 4 ir rn Reference Clock Reference Prescaler ADC Clock VCXO VCXO Freq m gt ADC Clock Intermodule Sync q c ADC Divider SYNC Clock SMB SYNC Output SYNC Direction 4 5 VXISYNC 31 Note Note Using the Agilent E1439 Managing multiple modules Managing mul
130. e in the mainframe is put into a reset state all modules should be placed into the reset state from left to right Then all modules can be take out of reset from left to right Parameters is the VXI instrument session pointer returned by the age1439 init function puts the Agilent E1439 s local bus into reset or takes it out of reset AGE1439 LBUS RESET ON puts the Agilent E1439 s local bus into reset while AGE1439_ LBUS RESET OFF takes the Agilent E1439 out of reset points to the current value of the busReset parameter Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Default values on page 201 age1439 init on page 132 150 idle sync Note Note Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_meas_control Initiates and controls measurements in multi module systems VXIplug amp play Syntax include age1439 h ViStatus age1439 meas control ViSession id ViInt16 idle Vilnt16 sync Description agel439 meas control explicitly controls the measurement state Parameters is the VXI instrument session pointer returned by the age1439 init function selects the condition of the Idle state AGE1439_ASSERT holds the module in the Idle state
131. e magnitude trigger does recognize the signal as being low and a positive trigger may occur on the rising edge at the end of B 28 Using the Agilent E1439 Magnitude trigger and magdwell time C Time C is less than the magDwell time The magnitude trigger does not recognize the signal as being low D Time D is longer than the magDwell time The magnitude trigger does recognize the signal as being low and a negative trigger may occur at the end of D In the example shown the signal is below the threshold at A and C but in both of these cases the signal is low for a time less than the magDwell time Hence the magnitude trigger does not recognize the signal as low and these do not cause any triggers About half way through B the signal has remained low long enough so that the trigger recognizes the signal as low After this a positive trigger would occur on the next rising edge of the signal s magnitude A negative trigger would occur at the end of D a magDwell period of time after the falling edge 29 Using the Agilent E1439 Frequency and filtering Frequency and filtering The Agilent E1439 s center frequency is normally set at zero baseband path and 70 MHz for the IF signal path However you may set the center frequency to a non zero value in order to examine a narrower span away from baseband zoom measurement The frequency band of interest represented by digitized time data samples from the ADC is mixed with the E1439 digi
132. e of the complex output of the decimation filter agel1439 trigger setup is the function that sets all trigger parameters at once An Agilent E1439 generates a trigger only when it is in the Trigger state and the Sync line on the VXI backplane is released When a trigger is generated the Agilent E1439 asserts the Sync line 183 id adcLevel adcLevelPtr trigDelay trigDelayPtr genTrig Agilent E1439 Programmer s Reference Functions listed alphabetically Parameters is the VXI instrument session pointer returned by the age1439_init function is used to set the triggering signal threshold when using the ADC trigger source This threshold is full scale x adclevel 2048 where 2048 lt adclevel 2047 There is hysteresis around the threshold in order to prevent multiple triggers from a single threshold crossing Hysteresis is 20 ADC counts or about 1 full scale Use AGE1439 ADC LEVEL to set the maximum allowable level Use 1439 ADC LEVEL MIN to set the minimum allowable level Use AGE1439 ADC LEVEL to set the default ADC trigger threshold An accurate value of full scale in volts can be found by full scale 1439 data scale get 2 N k where 15 if 1439 data resolution AGE1439 12 29 if 1439 data resolution AGE1439 24 k 2 if 1439 filter decimate AGE1439 DECIMATE SHIFT 2 if agel439 data type AGE1439 REAL and agel439 frequency
133. e systems the actual delay of the triggering module should be used to correct data from other modules in the system Due to the way the data is packed within the module it is possible to get values from this command that represent more than one output sample Parameters is the VXI instrument session pointer returned by the age1439 init function points to the returned actual delay from the most recent trigger event representing the actual time from the desired trigger point to the actual trigger point Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 1439 trigger setup on page 183 1439 trigger phase actual get on page 182 Delay and phase in triggered measurements in chapter 3 Trigger and phase in multi module systems in chapter 3 181 id actualPhasePtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_trigger_phase_actual_get Returns a representation of the phase value of the LO at the most recent trigger point VXIplug amp play Syntax include age1439 h ViStatus age1439 trigger phase actual get ViSession id ViPInt16 actualPhasePtr Parameters is the VXI instrument session pointer retur
134. easurement The center of a frequency band of interest is converted to dc with this function The frequency transition is phase continuous unless the center frequency is set to zero in which case the transition may be selected either to be phase continuous or phase reset This function may also be used to synchronously change frequency in multiple module systems Parameters is the VXI instrument session pointer returned by the age1439 init function supplies the center frequency normalized to the sample frequency It is a number between 0 5 and 40 5 which is interpreted as a fraction of the sample frequency centerFreq is the desired center frequency divided by the ADC sample frequency For example selecting 0 25 with a sample clock frequency of 100 MHz yields a center frequency of 25 MHz When using the IF signal path the normal range is 0 547 to 0 926 corresponding to 52 to 88 MHz Your applications should update this parameter when you change signalPath The ADC sample frequency is returned by the age1439 clock fs get function Negative frequencies select the negative image of the signal which is spectrally inverted from the input signal 1439 CENT FREQ MIN selects the minimum allowable center frequency 1439 CENT FREQ MAX selects the maximum allowable center frequency 1439 CENT FREQ DEF sets the default center frequency points to the current actual value of the center frequency as a fraction of the sample clock frequency
135. ects a signal filter bandwidth age1439 filter bw get on page 120 gets the signal filter bandwidth age1439 filter decimate on page 120 enables disables and extra factor of 2 decima tion age1439 filter decimate get on page 120 gets current state of extra decimation age1439 filter setup on page 120 sets the digital filter bandwidth and decimation fil ter parameters age1439 filter sync on page 123 synchronizes the decimation filter counter agel1439 frequency center on page 128 sets the center frequency agel1439 frequency center get on page 128 gets the current center frequency 1439 frequency center raw on page 125 quickly sets the center frequency agel439 frequency center raw compute on page 127 quickly calculates the values for age1439 frequency center raw 1439 frequency center raw get on page 125 gets the raw center frequency agel439 frequency cmplxdc on page 128 selects a complex baseband measurement agel439 frequency cmplxdc get on page 128 gets the state of the baseband measure ment mode 1439 frequency setup on page 128 sets all the zoom center frequency parameters agel1439 frequency sync on page 128 prepares the module for a synchronous fre quency change agel439 frequency sync get on page 128 gets the state of the synchronous change mode 1439 front panel clock input on page 131 specifies the source of the front panel clock 14
136. ed state and halts any measurement or fiber transfer Parameters is the VXI instrument session pointer returned by the age1439 init function Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Commands which halt active measurements on page 198 1439 init on page 132 agel439 input setup on page 141 age1439 input offset save on page 136 age1439_ filter sync on page 123 age1439 frequency setup on page 128 134 id coarseDac fineDac coarseDacPtr fineDacPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_input_offset Sets the dc offset DAC setting for the current range This description also includes the query age1439_input_offset_get VXIplug amp play Syntax include age1439 h ViStatus age1439 input offset ViSession id Vilnt16 coarseDac ViInt16 fineDac ViStatus age1439 input offset get ViSession id ViPInt16 coarseDacPtr ViPInt16 fineDacPtr Description These values are normally set by age1439 input autozero so you generally would use this command only for special situations The resultant values can be saved to non volatile RAM with agel439 input offset save Each ac coupling range has a unique DAC setting All dc coupling ra
137. ed to external reference AGE1439 SIMPLE EXT REF ADC CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK SMB CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION VCXO EXT REF VCXO ON DIVIDE BY 38 PRESCALE BY 4 CLOCK OFF FRONT PANEL CLOCK BNC CLOCK CLOCK OFF DIVIDED ADC CLOCK SYNC OUT OFF 79 Agilent E1439 Programmer s Reference Functions listed alphabetically External sample clock for use with baseband path only AGE1439 SIMPLE EXT SAMP ADC_CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK SMB CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION EXT SAMPLE CLOCK VCXO OFF DIVIDE BY 38 PRESCALE BY 1 CLOCK OFF FRONT PANEL CLOCK BNC CLOCK CLOCK OFF DIVIDED CLOCK SYNC_OUT_OFF NIA Front panel master slave setups one master per mainframe 80 Front master internal reference AGE1439 FRNT MSTR INT REF ADC CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK SMB CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION VCXO INTERNAL VCXO ON DIVIDE BY 38 PRESCALE BY 1 CLOCK OFF CLOCK OFF DIVIDED CLOCK DIVIDED ADC CLOCK SYNC_OUT SMB FRNT TO REAR Agilent E1439 Programmer s Reference Functions listed alphabetically Front master phase locked to external reference AGE1439 FRNT REAR MSTR EXT REF
138. ei m z e z 9 55 5 6 m E ir G 1 2 1 2 Internal clock and SYNC distribution External reference and SYNC distribution using VXI backplane ECL trigger lines using VXI backplane ECL trigger lines Module 1 Front master Module 2 Front slave Module 1 Front master Module 2 Front slave internal reference on page phase locked to master on phase locked to external phase locked to master on 80 page 81 reference on page 81 page 81 4 8 OF q C9 10 _ le frequency 2 9 reference Se os Q ne i m a 1 2 c 1 2 Internal clock and SYNC distribution using External reference and SYNC distribution using front panel SMB clock and SYNC front panel SMB clock and SYNC extender connections extender connections 34 Using the Agilent E1439 Managing multiple modules Module 1 Front slave Module 2 Front master Module 3 Front slave Module 4 Front slave phase locked to master on internal reference on page phase locked to master phase locked to master on page 81 80 page 81 page 81 qb dol 46 dol 5 9 35 9 e 5 5 CJ CJ CJ CJ Aa A n N 1 2 3 4 Sharing clock and SYNC among
139. el439 frequency center raw agel1439 frequency center raw get on page 125 gets the raw center frequency agel439 frequency cmplxdc on page 128 selects a complex baseband measurement agel1439 frequency cmplxdc get on page 128 gets the state of the baseband measurement mode agel1439 frequency sync on page 128 prepares the module for a synchronous frequency change agel1439 frequency sync get on page 128 gets the state of the synchronous change mode Fiber Interface agel1439 fiber on page 112 controls whether or not automatically generated BOF events are transmitted agel1439 fiber get on page 112 returns the current value of bofEnable age1439 fiber clear on page 106 clears all data from the fiber interface FIFO buffers age1439 fiber crc on page 112 sets up the fiber interface to transmit and receive cyclic 62 Agilent E1439 Programmer s Reference Functions listed by functional group redundancy checks agel1439 fiber crc get on page 112 returns the current status of the cyclic redundancy check setting agel1439 fiber error clear on page 107 clears fiber errors from the status register 1439 fiber error get on page 108 returns the value of the fiber interface error reg ister age1439_fiber_flow_control on page 112 configures fiber flow control enabling or disabling transmitter flow control signals age1439 fiber flow control get on page 112 returns the current statu
140. ent session pointer returned by the age1439 init function represents the error message string up to 256 characters long For this parameter you must allocate a character array of at least 256 characters 1439 STR LEN MIN including the null byte prior to calling this function in any programming language represents the instrument numeric error code Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an unknown error condition or other important status condition and may return VI WARN UNKNOWN STATUS See Also agel439 init on page 132 1439 error query on page 103 Error messages on page 199 102 errorCode errorMessage Note Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_error_query Queries the module for the first error in the queue VXIplug amp play Syntax include age1439 h ViStatus age1439 error query ViSession id ViPint32 errorCode ViChar errorMessage Description agel439 error query queries the module for the oldest error and returns the corresponding error message This function does not report host errors that originate in the C library Parameters is the VXI instrument session pointer returned by the age1439 init function points to the instrument numeric error code points to the error message string up to 80 characters long This message also indicates what function call
141. er 1439 revision query on page 169 returns strings that identify the date of the module s firmware revision Interrupts age1439 attrib get on page 74 gets low level attributes of current I O library session age1439 interrupt setup on page 146 sets all interrupt parameters agel1439 interrupt mask get on page 146 gets the interrupt event mask agel1439 interrupt priority get on page 146 gets the VME interrupt line age1439 interrupt restore on page 145 restores the interrupt masks to the most recent set ting Measurement control 1439 meas control on page 151 initiates and controls measurements in multi module systems agel1439 meas init on page 154 initiates a measurement without first checking for valid hardware setup 1439 meas start on page 155 checks for valid hardware setup and then initiates a mea surement age1439 reset on page 167 places the module in a known state age1439 reset hard on page 168 the module hardware Timing agel1439 clock setup on page 78 sets all timing parameters for commonly used measure ment setups agel1439 clock setup get on page 78 gets the current clock setup age1439 clock fs on page 76 provides the frequency of an external sample clock agel1439 clock fs get on page 76 gets the current external sample clock frequency agel1439 adc clock on page 72 specifies the ADC clock source agel1439 adc clock get on
142. erated external sync pulse signals to each module This command is only specified for baseband path This command requires specialized external hardware External sample synchronization in multi module systems in chapter 3 Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 EXT SAMP SYNC ENABLE is used after calling age1439 clock setup to select a multi module external sample setup A counter within the module is put into its reset state and the two clocks within the module that are derived from the sample clock stop operating this includes the clock used by the DSP circuitry that runs at one half the sample clock and a clock running at one thirty eighth of the sample clock used for multi module sync As soon as a rising edge is applied to the External Trigger input of the Agilent E1439 the counter resumes counting from a known state and the two clocks mentioned above have a known phase Since the clocks may be interrupted for some time it is a good idea to call age1439 clock recover after the counter has resumed counting 1439 EXT SAMP SYNC CANCEL releases the module s counter from its preset state and the clocks resume It is still advisable to call age1439 clock recover points to the value of syncEnable Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition
143. es Data Frame Normal Data Fiber Frame soF 0 to 512 data words rEOF SEOF GOI STOP BOF Sync Without Data Fiber Frame IDLE sor No data CRC MEOF seor 60 5 0 EOE Sync with Data Fiber Frame swov sof Last 4 data bytes in epoch crc meor seor 60 5 0 1 Pad for Data Frame or BOF 2 Start Of Frame framing event that embeds PIO1 PIO2 and DIR 3 32 bit or 4 Byte words maximum 2048 Bytes 4 Cyclic Redundancy Check optional 5 Frame End Of Frame end of Data Frame 6 Status End Of Frame embeds FIFO OV and NRDY 7 Flow controls 8 Mark End Of Frame end of BOF and EOE 9 Sync With Data Valid start of EOE 10 4 bytes exactly Control Signals PIO2 DIR and NRDY are FPDP front panel data port control signals These signals be defined by another product or you can define their meaning and application When an overflow condition in the transmit FIFO occurs the E1439D asserts FIFO OV indicating a loss of data This may occur in Append fiber mode if the available fiber bandwidth capability is exceeded If flow control is enabled the E1439D responds to the STOP and GO signals See Generate on page 48 for details 44 Note Using the Agilent E1439 Fiber Optic Interface Fiber Modes The E1439D s fiber interface can operate in five different modes Off on page 45 Copy on pa
144. f all modules in a system Digital filter changes in multi module systems require that the decimation counters be synchronized Calling the following functions voids synchronized multi module setups age1439_clock_setup and related low level clock setup functions age1439_clock_recover age1439_input_autozero age1439_input_range_auto age1439_self_test age1439_state_recall Special considerations apply to the measurement loop See The measurement loop in multi module systems on page 24 Synchronous digital filter changes In multi module systems where synchronous sampling is required the decimation counters in all the modules must be synchronous with each other This condition can be forced by preparing each module in the system in advance Any measurement in progress is terminated at this time and the module is placed in the Idle state After each module is prepared the next sync line transition causes the digital decimation counter to be reset and started at the same time Once this is done the decimation counters stay synchronized as long as the same ADC clock is used If you also intend to change the center frequency along with the digital filters you should synchronize the digital filters first Otherwise the center frequency phase becomes unsynchronized when the digital filters are changed Synchronous center frequency changes In multi module systems you may prepare each module in advance of a frequency change then per
145. f spec external sample clock VXIplug amp play Syntax include age1439 h ViStatus age1439 clock recover ViSession id Description This command is used to restore proper function if the module has received an out of spec external sample clock An out of spec situation could occur if the external sample clock is removed or changed during operation or if it has glitches which don t meet specs In this case the module would cease functioning and this command must be issued in order to resume proper operation after restoring a valid clock Parameters Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Commands which halt active measurements on page 198 1439 init on page 132 agel439 ext sample sync on page 104 age1439 clock setup on page 78 77 Note id clockSetup Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 clock setup Sets all timing parameters for commonly used measurement setups This description also includes a query agel439 clock setup get VXIplug amp play Syntax include age1439 h ViStatus age1439 clock setup ViSession id ViInt16 clockSetup ViStatus age1439 clock setup get ViSession id ViPInt16 clockSetupPtr Description
146. ference Functions listed alphabetically age1439_fiber_error_clear This function clears the AGE1439_STATUS_FIBER_ERROR bit in the status register VXIplug amp play Syntax include age1439 h ViStatus age1439 fiber error clear ViSession id Description agel439 fiber error clear clears the AGE1439 STATUS FIBER ERROR bit in the status register If the error is continuously present the bit will not be cleared Parameter is the VXI instrument session pointer returned by the age1439 init function Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 107 Agilent E1439 Programmer s Reference Functions listed alphabetically age1439 fiber error get This function returns the value of the fiber interface error register when the AGE1439 STATUS FIBER ERROR bit is set VXIplug amp play Syntax include age1439 h ViStatus age1439_fiber_error_get ViSession id Vilnt16 fiberErrorPtr Description age1439_fiber_error_get returns the fiber interface errors Parameter id is the VXI instrument session pointer returned by the age1439_init function fiberErrorPtr points to the value of the fiber interface error The bits are defined below Status Bit Definition ds Descript
147. form the change synchronously by asserting the Sync line This preserves the phase relationship of the local oscillators for all modules in the system Certain special considerations apply to multi module frequency changes e Ifall modules in a system are in the Idle state when the Sync line transition occurs the LO frequency is updated and the next measurement is armed fall modules are in the measurement state in continuous mode when the Sync line transition occurs the LO frequency is synchronously updated and the measurement continues Incontinuous mode care must be taken to assure that all modules are in the same state either the Idle state or the Measure state before the Sync line transition occurs otherwise some modules re arm while others continue the current measurement e n block mode it is simplest to keep Forced Idle asserted during the Sync line transitions to keep all the modules in the Idle state e Ifyou also intend to change the digital filters along with the center frequency you should synchronize the digital filters first Otherwise the center frequency phase becomes non synchronized when the digital filters are changed 39 Note Using the Agilent E1439 Managing multiple modules Trigger and phase in multi module systems When you use triggering in multiple modules you do not need to measure phase differences between two or more channels if the channels are set up identically in terms of digital filteri
148. function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Default values on page 201 age1439 init on page 132 1439 clock setup on page 78 1439 sync clock on page 178 age1439 sync direction on page 179 Using clock and sync in chapter 3 180 Note id actualDelayPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_trigger_delay_actual_get Returns the actual trigger delay from the most recent trigger event VXIplug amp play Syntax include age1439 h ViStatus age1439 trigger delay actual get ViSession id ViPInt32 actualDelayPtr Description This delay value provides more accuracy than the trigger delay parameter alone since it includes a measurement of the fractional part of the output sample period between the previous output sample and the actual trigger event The trigger delay accuracy improves the delay value to one ADC sample clock period rather than one output sample period This can result in a substantial improvement in accuracy when narrow bandwidth decimation filtering is used agel439 trigger delay actual get must be called for each new trigger event that requires precise delay measurement The actual delay is still expressed in ADC sample periods In multiple modul
149. gdwell get on page 183 gets the magnitude trigger dwell time agel439 trigger maglevel on page 183 specifies the threshold for a magnitude trigger agel439 trigger maglevel get on page 183 gets magnitude trigger threshold agel439 trigger phase actual get on page 182 returns a representation of the phase value of the LO at the most recent trigger point age1439 trigger slope on page 183 selects a positive or negative trigger agel1439 trigger slope get on page 183 gets trigger slope agel1439 trigger type on page 183 specifies the trigger type 1439 trigger type get on page 183 gets trigger type Reading data agel1439 data scale get on page 89 gets data scale factor age1439 read on page 159 reads scaled 32 bit float data from FIFO age1439_read64 on page 159 reads scaled 64 bit float data from FIFO specifically for VEE applications agel439 read raw page 162 reads raw data from FIFO 65 Agilent E1439 Programmer s Reference Functions listed by functional group Synchronization controlling multiple modules age1439_clock_setup on page 78 supplies commonly used clock and sync configurations See Timing on page 64 for low level clock and sync setup commands agel1439 clock setup get on page 78 gets the current clock and sync setup age1439 clock fs on page 76 provides a clock frequency for external sample clock config urations age1439 clock fs get on page
150. ge 176 age1439_attrib_get on page 74 age1439_interrupt_restore on page 145 147 id IbusMode Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 mode Sets the local bus transmission mode Agilent E1439D only This description also includes the query age1439 Ibus mode get gets the current local bus mode VXIplug amp play Syntax include age1439 h ViStatus age1439 Ibus mode ViSession id Vilnt16 busMode ViStatus age1439 Ibus mode get ViSession id ViPInt16 busModePtr Description age1439 Ibus mode sets the local bus to either generate append insert or pipeline data The data port must be set to the local bus with the age1439 data port function See age1439 data setup on page 90 before these modes take effect Parameters is the VXI instrument session pointer returned by the age1439 init function selects the transmission mode of the local bus when it is enabled by the age1439 data port function 1439 GENERATE forces the module at id to generate data only not passing through data from other modules on the local bus 1439 APPEND causes the Agilent E1439 to pass data through from modules on its left and append its data to the end 1439 INSERT causes the Agilent E1439 to place its data on the local bus and then pass data through from modules on its left 1439 PIPELINE causes the Agilent E1439 to pipe data through from modules on its lef
151. ge 46 Raw on page 47 Generate on page 48 Append on page 50 Off The Off fiber mode disables the fiber transmitter but allows the fiber receiver to read control signals Normal data collection and filtering continues and the data port selection determines whether data is sent to the local bus Agilent E1439D only or read from the FIFO via the VME bus See the following illustration E1438D E1439D Fiber RX Fiber TX DIGITAL ABE FILTERS L VME BUS Fiber Interface Setup Fiber Mode Off Rate setting ignored BOF setting ignored CRC setting ignored Flow Control setting ignored Epoch Generate setting ignored Epoch Size setting ignored Setting the data port to Fiber while in the Off fiber mode causes the data FIFO to fill up with filtered ADC data which then causes data collection to stop 45 Using the Agilent E1439 Fiber Optic Interface Copy The Copy fiber mode copies optical data from its fiber receiver to its fiber transmitter without adding any data Normal data collection and filtering continues and the data port selection determines whether data is sent to the local bus Agilent E1439D only or read from the FIFO via the VME bus Copy is the default fiber mode after power on or reset See the following illustration E1438D E1439D 1KB Fiber RX FIFO Fiber TX DIGITAL ADG FILTERS HEO L VME BUS Fiber Interfac
152. ge for baseband mode When 70 MHz IF mode is selected the input signal goes through the upper path on the diagram below Amplifiers and attenuators allow the full scale range to be set with 1 dB resolution The 70 MHz IF input is terminated by either a preamp or a programmable attenuator either of which follows a 52 MHZ high pass filter The combination of the pre amplification and programmable attenuation results in the 0 to 48 ranges setting for the 70 MHz IF mode After this a combination of low pass and high pass filters realizes the 70 MHz IF filter in a 52 to 88 MHz pass band that provides anti alias protection Signals within the pass band are next downconverted by a mixer with a fixed 95 MHz LO frequency The mixer translates the 52 to 88 MHz span to 43 to 7 MHz The mixer output is low pass filtered preserving the 43 to 7 MHz band and amplified before being sampled by the A to D converter at a 95 MHz sample rate 212 Signal Input Signal Module Description Block diagram and description Clock Generation Attenuator 118dB 7 Bandpass 5 Amplifier 2 Filter ro Pr 124B gt e gt O 52 88 MHz L Amplifier 6dB Highpass Attenuator Filter 1 16 dB 52 MHz Sg 7 Baseband Filter IF 0 43 MHz m Lowpass gc s Bypass Filter Baseband
153. ge1439 adc divider ViSession id Vilnt16 adcDivider ViStatus age1439 adc divider get ViSession id ViPInt16 adcDividerPtr 203 Agilent E1439 Programmer s Reference VXIplug amp play Syntax Quick Reference ViStatus age1439 attrib get ViSession id ViInt16 attribute ViPint32 value ViStatus age1439 cal get ViSession id ViInt16 board ViPInt32 datestampPtr ViStatus age1439 clock fs ViSession id ViReal64 fs ViStatus age1439 clock fs get ViSession id ViPReal64 fsPtr ViStatus age1439 clock recover ViSession id ViStatus age1439 clock setup ViSession id ViInt16 clockSetup ViStatus age1439 clock setup get ViSession id ViPInt16 clockSetupPtr ViStatus age1439 close ViSession id ViStatus age1439 combo setup ViSession id Vilnt16 sigBw Vilnt32 blocksize Vilnt32 phase ViInt32 interpolate ViStatus age1439 data blocksize ViSession id ViInt32 blocksize ViStatus age1439 data blocksize get ViSession id ViPint32 blocksizePtr ViStatus age1439 data delay ViSession id Vilnt32 dataDelay ViStatus age1439 data delay get ViSession id ViPInt32 dataDelayPtr ViStatus age1439 data memsize get ViSession id ViPInt16 memSizePtr ViStatus age1439 data mode ViSession id Vilnt16 mode ViStatus age1439 data mode get ViSession id ViPInt16 modePtr ViStatus age1439 data port ViSession id ViInt16 port ViStatus age1439 data port get ViSession id ViPInt16 portPtr ViStatus age1439 data resolution ViSession id Vilnt16 resolution
154. generated the error For this parameter you must allocate a character array of at least 256 characters 1439 STR LEN MIN including the null byte prior to calling this function in any programming language Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also agel439 init on page 132 1439 error message on page 102 103 Note Note id syncEnable syncEnablePtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_ext_sample_sync Enables synchronization of multiple modules This description also includes the query age1439_ext_sample_sync_get VXIplug amp play Syntax include age1439 h ViStatus age1439 ext sample sync ViSession id Vilnt16 syncEnable ViStatus age1439 ext sample sync get ViSession id ViPInt16 syncEnablePtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup Description This command is used to provide precision sampling in multi module systems by synchronizing them to an external sample clock The External Trigger BNC provides the input for a synchronizing signal splitter and identical cables provide external sample clock and user gen
155. get on page 141 gets the signal path state agel1439 interrupt mask get on page 146 gets the interrupt event mask agel439 interrupt priority get on page 146 gets VME interrupt line 69 Agilent E1439 Programmer s Reference Functions listed alphabetically 70 age1439_interrupt_restore on page 145 restores the interrupt masks to the most recent setting age1439_interrupt_setup on page 146 sets both interrupt parameters age1439_Ibus_mode page 148 sets the local bus transmission mode age1439_Ibus_mode_get on page 148 gets the local bus mode age1439 Ibus reset on page 150 resets local bus age1439 Ibus reset get on page 150 gets the local bus mode reset state agel439 meas control on page 151 initiates and controls measurements in multi module systems agel1439 meas init on page 154 initiates a measurement without first checking for valid hardware setup 1439 meas start on page 155 checks for valid hardware setup and then initiates measurement agel439 meas status get on page 156 returns the current measurement status agel1439 options get on page 157 returns the module s options 1439 product id get on page 158 returns the module s product identification string age1439 read on page 159 reads scaled 32 bit float data from FIFO 1439 read raw page 162 reads raw data from FIFO age1439_read64 on page 159 reads scaled
156. gilent Auto Range Autoscale Y lt Peak gt gt gt Start Pause Single Continue 47 5000 MHz 4 75 MH2 div 82 77 kH2 bin 95 0000 MHz 15 Getting Started with the Agilent E1439 To use the example programs To use the example programs Several example programs are included that perform useful tasks and can serve as a basis for your own programs When you installed your Agilent E1439 Windows libraries and drivers using the setup program or utility you also installed executable and source code files for several useful example programs The programs demonstrate programming the module with C Microsoft Visual Basic The executables for these examples require an Agilent E1439 for Windows VXIplug amp play support in other words they will not run in simulation mode like the Agilent E1439 Soft Front Panel program Shortcuts for the executables appear in the age1439 Windows program group if you added it during setup In Windows environments executable files and source code for the Microsoft Visual Basic examples are installed in the drive vxipnp win 95INT age1439 vb directory The C examples are in age1439 msc examples directory The group of programs described here may be supplemented with additional programs later which will be described in the online help or readme file ACVolts_32 exe This is the simplest practical complete program using the Agi
157. he 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 1439 init on page 132 agel439 meas start on page 155 age1439 meas control on page 151 1439 status get on page 176 age1439 read on page 159 154 Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_meas_start Checks for valid hardware setup and then initiates a measurement VXIplug amp play Syntax include age1439 h ViStatus age1439 meas start ViSession id Description 1439 meas start provides an easy way to initiate a measurement a single module system This command waits for a valid hardware setup then if the instrument is in a valid state performs the equivalent of age1439 meas init 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 Waits for AGE1439 STATUS HARDWARE SET bit to be set 2 Returns AGE1439 START ERROR if mo
158. he analog anti alias filter has a fixed bandwidth and thus is fully effective only when fs 2 100 MHz If a slower external ADC clock is used an additional analog filter of the appropriate bandwidth may be required for full alias protection The decimation process used to reduce the output sample rate is driven from a decimation counter which keeps track of which samples to save and which ones to discard for each of the octave bandwidth reduction filter stages In multi module systems where synchronous sampling is required the decimation counters in all the modules must be synchronous with each other This condition can be forced by using the age1439 filter sync function The following table lists parameter combinations see also age1439 data setup on page 90 which result in invalid measurement conditions Invalid parameter combinations ul dataType decimate sigBw 12 or 24 REAL or COMPLEX OFF or SHIFT 1 12 or 24 REAL or COMPLEX ON or SHIFT 0 12 24 COMPLEX any 0 24 REAL or COMPLEX OFF 2 24 REAL or COMPLEX any Oor1 12 or 24 COMPLEX SHIFT any All other combinations are valid Example Here are some bandwidth and sample rate results using the k calculation for bandwidth fs 100 MHz default internal ADC clock all data in MHz 121 Agilent E1439 Programmer s Reference Functions listed alphabetically Signal Bandwidth Sample Rate MHz Msamples sigBw 25dB 15dB Decimate OFF Decimate ON 1 18 425 NIA 50 2 39 112 5 50 25
159. he anti alias filter The peak overshoot actually exceeds the input voltage step by about 20 The range setting must accommodate this overshoot to avoid an ADC overflow Return Value 1439 SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 See Also 1439 init on page 132 1439 input autozero on page 134 age1439_input_range_ auto on page 137 age1439_input_range_convert on page 138 1439 data scale get on page 89 144 Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_interrupt_restore Restores the interrupt masks to the setting last programmed with age1439_interrupt_setup VXIplug amp play Syntax include age1439 h ViStatus age1439 interrupt restore ViSession id Description The interrupt masks set by the age1439 interrupt setup function are cleared during the interrupt acknowledge cycle This function restores the cleared interrupt masks Parameters is the VXI instrument session pointer returned by the age1439 init function Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age14
160. he input directly to the 50 Ohm buffer amplifier Although dc coupling can be selected in both baseband and IF signalPath it has no effect in the IF path because the signal is ac coupled after the input section 141 Agilent E1439 Programmer s Reference Functions listed alphabetically AGE1439_ADC inserts 0 2 uF capacitor between the input connector and the 50 Ohm buffer amplifier couplingPtr points to the current value of the coupling parameter for an Agilent E1439 or group of Agilent E1439s range is a range index number which is transformed to a full scale voltage value This function always sets only the IF signal path range even if signalPath is set to 1439 BB PATH In baseband mode the range is fixed at 21 dBm 1438 RANGE MAX sets the range to the maximum allowable 1439 RANGE MIN sets the range to the minimum allowable Signal inputs with an absolute value larger than full scale generate an ADC overflow error Range values are as follows Variable Range Index peo indue AGE1439 RANGE MAX 48 AGE1439 RANGE 48 48 12 1 26 AGE1439 RANGE 47 47 1 12 AGE1439 RANGE 46 46 10 1 AGE1439 RANGE 45 45 9 891 AGE1439 RANGE 44 44 8 194 AGE1439 RANGE 43 43 7 708 AGE1439 RANGE 42 42 6 631 AGE1439 RANGE 41 4 5 562 AGE1439 RANGE 40 40 4 501 AGE1439 RANGE 39 39 3 447 AGE1439 RANGE 38 38 2 398 AGE1439 RANGE 37 37 1 355 AGE1439 RANGE 36 36 0 316 AGE1439 RANGE 35 35 4 282 AGE1439 RANGE 34 34 2 251 AGE1439 RANGE
161. i module systems with the same trigger type where you want only certain module s to generate a trigger points to the current value of the genTrig parameter represents the number of samples that the signal magnitude must dwell low before begin recognized as a low for the purpose of generating a magnitude trigger 1439 MAGDWELL DEF 1439 MAGDWELL MAX AGE1439 MAGDWELL MIN points to the current value of the magDwell parameter is used to set the triggering to detect when the envelope of a signal crosses the threshold while using the magnitude trigger type 1439 MAG LEVEL sets the maximum allowable level AGE1439 MAG _ LEVEL MIN sets the minimum allowable level 1439 MAG LEVEL FsS sets the full scale magnitude trigger threshold 1439 MAG LEVEL DEF sets the default magnitude trigger threshold The threshold is set to 1439 MAG LEVEL SCALE x magLevel dB relative to full scale signal where 337 SnagLevel 40 Comment Magnitude triggering is performed on the log magnitude of the signal Magnitude triggering occurs when the log magnitude of the signal crosses the specified magnitude trigger threshold Because of these facts magnitude trigger operation will not always be intuitive and there is a case that can be misinterpreted as improper operation Magnitude triggering may not occur when the magnitude trigger threshold level is set below the known maximum amplitude of the input signal
162. iStatus age1439 filter setup ViSession id Vilnt16 sigBw Vilnt16 decimate ViStatus age1439 filter sync ViSession id ViStatus age1439 frequency center ViSession id ViReal64 centerFreq ViStatus age1439 frequency center get ViSession id ViPReal64 centerFreqPtr ViStatus age1439 frequency center raw ViSession id ViInt32 phase Vilnt32 interpolate ViStatus age1439 frequency center raw compute ViSession id ViReal64 center ViPInt32 phasePtr ViPInt32 interpolatePtr ViStatus age1439 frequency center raw get ViSession id ViPInt32 phasePtr ViPInt32 interpolatePtr ViStatus age1439 frequency cmplxdc ViSession id Vilnt16 cmplxDC ViStatus age1439 frequency cmplxdc get ViSession id ViPInt16 cmplxDCPtr 204 Agilent E1439 Programmer s Reference VXI plug amp play Syntax Quick Reference ViStatus age1439_frequency_setup ViSession id Vilnt16 cmplxDC Vilnt16 sync ViReal64 centerFreq ViStatus age1439 frequency sync ViSession id Vilnt16 sync ViStatus age1439 frequency sync get ViSession id ViPInt16 syncPtr ViStatus age1439 front panel clock input ViSession id Vilnt16 fpClock ViStatus age1439 front panel clock input get ViSession id ViPInt16 fpClockPtr ViStatus age1439 init ViRsrc rsrcName ViBoolean idQuery ViBoolean resetInstr ViPSes sion id ViStatus age1439 input alias filter ViSession id Vilnt16 antiAlias ViStatus age1439 input alias filter get ViSession id ViPInt16 antiAliasPtr ViStatus age1439 input autozer
163. ib get to get the VISA id set to 1439 MAG verifies the identity of the instrument by checking the manufacturer ID and model number in the module s VXI register set If set to AGE1439 OFF the function does not verify the module s identity It is helpful to disable the id query if you want to use the driver with a similar module but do not need to modify the driver source code places the module in the reset state when set to 1439 ON If set to 1439 OFF the function disables the reset Disabling the reset is useful for debugging in cases where resetting would take the instrument out of the state you want to test specifies the interface and logical address This descriptor varies depending on your I O library An example of the descriptor form for the VISA I O library is VXI Board VXIlogical address INSTR Comments If you receive a resource descriptor error see your I O library documentation to determine the correct descriptor form Return Value 1439 SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 132 Agilent E1439 Programmer s Reference Functions listed alphabetically See Also Commands which halt active measurements on page 198 age1439_close on page 86 agel439 attrib get on p
164. ilter bw is 4 with decimation on there are 16 input samples for every output sample for a decimation rate of 24 trigger delay actual 0 or 0 16 0 output samples desired trigger trigger level actual trigger 99 trigger delay actual 4 4 16 1 4 output samples desired trigger _ trigger i D level dd E actual trigger i 1 2 3 4 trigger delay actual 8 or 8 16 1 2 output samples desired trigger _ trigger level actual trigger qa 2 3 4 The phase returned is the phase of the LO at the actual trigger point not the desired trigger point The following example illustrates how age1439_phase_actual_get might be used In this example the input signal is a sine wave at a frequency of 4 MHz The module is set up as follows frequency_center 4 5 MHz filter_bw 4 2 4 MHz span filter_decimate 1 on trigger_type 1 ADC trigger trigger_delay 32 a pre trigger delay of 32 trigger_adclevel 0 data_type 1 complex After the measurement is completed call age1439_delay_actual_get and age1439_phase_ actual_get In this example the values returned happened to be delay_actual 16 phase_actual 19697 26 Using the Agilent E1439 Delay and phase in triggered measurements Due to the pretrigger delay of 32 the desired trigger point would have been at the 32nd sample of the time record However the delay_actual value of
165. ing information Model number Software version Serial number Options Date the problem was first encountered Circumstances in which the problem was encountered Can you reproduce the problem What effect does this problem have on you United States 1 800 452 4844 Canada 1 877 894 4414 905 206 4120 FAX Europe 31 20 547 2323 31 20 547 2390 FAX Japan 81 426 56 7832 81 426 56 7840 FAX Latin America 305 269 7500 305 269 7599 FAX Australia 1 800 629 485 613 9272 0749 FAX New Zealand 0800 738 378 64 4 495 8950 FAX Asia Pacific 852 3197 7777 852 2506 9284 FAX 235 About this edition December 2002 This edition documents the transition from the Agilent E1439A to the Agilent E1439C and from the Agilent E1439B to the Agilent E1439D The and models will become obsolete The Agilent E1439C has no local bus capability April 2001 This edition documents the new fiber optic interface on the Agilent E1439B In addition this edition documents the new external TTL trigger on all Agilent E1439B modules and on Agilent E1439A modules with a serial number greater than US41140000 May 2000 First Edition 236
166. inimum value for the epoch header 1439 HEADER VALUE selects the maximum value for the epoch header AGE1439 HEADER INDEX MASK is used for setting the value of the headerIndex field 1439 HEADER MIN selects the minimum value for the incrementCount AGE1439 HEADER MAX selects the maximum value for the incrementCount Epoch headers are 64 bits long Of these the last 32 bits are not used and set to zero The first 32 bits are available and can be set by the user The 10 least significant bits of the 32 non zero bits contain a value that can be used by the optical receiver to direct where to route and or how to process the associated epoch data These 10 bits are called the headerIndex and can be set from a value of 0 to 1023 In addition the headerIndex can be sequentially incremented by 1 each time it is transmitted The number of increments that are applied before returning to the original value is programmable by the user The headerValue sets the value of all 32 non zero bits of epoch header including the 10 least significant bits that comprise the headerIndex bit field The default headerValue is 0 and the maximum value is 2 32 1 99 header ValuePtr incrementCount Note incrementCountPtr Agilent E1439 Programmer s Reference Functions listed alphabetically points to the current value of inital Value specifies the number of automatic increments to the headerIndex bit field The default incre
167. ion 9 UNLOCKED 512 Indicates that the internal receive or transmit clock is not properly locked This could be caused by a poor quality receive signal 8 TX ERR OVERRUN 256 Indicates that data transmission is not sustainable because the raw data bandwidth has exceeded the available fiber capacity 7 ERR OVERFLOW 128 Indicates that data arriving on the fiber receive port has been lost 6 RX ERR SYNC LOST 64 Indicates that the receiver did not detect the synchronization signal 5 RX ERR DISPARITY 32 Indicates an invalid stream of bits was detected in the received data 4 RX ERR CODE VIOLATION 16 Indicates an invalid stream of bits was detected in the received data 3 RX ERR ALIGNMENT 8 Indicates an invalid stream of bits was detected in the received data 2 ERR BEGIN DISPARITY 4 Indicates an invalid stream of bits was detected in the received data 1 RX ERR CRC 2 Indicates a cyclic redundancy check error has occurred on the receiver of the fiber interface 0 RX_ERR_ SIGNAL LOST 1 Indicates the signal is no longer being received on the fiber interface 108 Agilent E1439 Programmer s Reference Functions listed alphabetically Return Value AGE1439_SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 See Also
168. l agel1439 sync direction get on page 179 gets the state of front or rear panel clock avail ability agel1439 sync output on page 180 selects the output for the sync signal agel439 sync output get on page 180 gets the output for the sync signal agel439 on page 187 selects whether the module should use an internal clock source agel439 vcxo get on page 187 gets whether the internal clock source is on or off agel439 vxi clock output on page 188 selects which clock drives the VXI clock agel439 vxi clock output get on page 188 gets which clock drives the VXI clock Trigger agel1439 trigger setup on page 183 sets all parameters associated with triggering the beginning of data collection agel1439 trigger adclevel on page 183 specifies the threshold for the ADC trigger agel1439 trigger adclevel get on page 183 gets the trigger threshold 1439 trigger delay on page 183 specifies a pre or post trigger delay time agel1439 trigger delay get on page 183 gets the trigger delay time agel439 trigger delay actual get on page 181 gets the actual delay time from the most recent trigger event agel1439 trigger gen on page 183 determines whether a module can generate a trigger agel439 trigger gen get on page 183 gets the trigger generation status agel439 trigger magdwell on page 183 specifies the dwell time in samples before magnitude trigger agel439 trigger ma
169. l scale input range agel439 input range auto on page 137 performs auto ranging agel439 input range convert on page 138 converts input range to volts agel1439 input range get on page 141 gets the input range agel1439 input signal path on page 141 selects baseband or IF signal path agel1439 input signal path get on page 141 gets the signal path state agel1439 input signal on page 141 connect disconnect the input signal to the input ampli fier agel1439 input signal get on page 141 gets the input buffer amplifier state agel1439 state save on page 175 saves the current module state agel1439 state recall on page 174 recalls a previous module state Data format agel1439 data setup on page 90 sets all format and data output flow parameters agel1439 data blocksize on page 90 determines the size of the output data block agel1439 data blocksize get on page 90 gets the output data block size agel1439 data delay on page 90 determines FIFO delay in continuous mode agel439 data delay get on page 90 gets FIFO delay agel439 data memsize get page 88 eturns module s memory size agel439 data mode on page 90 selects block mode or continuous mode agel439 data mode get on page 90 gets the data mode agel439 data port on page 90 selects VME bus local bus or fiber interface for output transmission agel1439 data port get on page 90 gets the output port designation age
170. l1439 data resolution on page 90 selects 12 or 24 bits data resolution agel1439 data resolution get on page 90 gets the data resolution agel439 data scale get on page 89 gets the data scale factor used to convert raw data to volts agel1439 data type on page 90 selects real or complex output data agel1439 data type get on page 90 gets output data type agel1439 data spectral order specifies the spectral order of the output data agel439 data spectral order get gets the spectral order of the output data agel439 data xfersize on page 96 allows a specified amount of data to be read before an entire block has been acquired agel439 data xfersize get on page 96 gets the data transfer size 61 Agilent E1439 Programmer s Reference Functions listed by functional group agel439 Ibus mode on page 148 sets the transmission mode of the local bus agel439 Ibus mode get on page 148 gets the local bus transmission mode age1439 Ibus reset on page 150 the local bus age1439 Ibus reset get on page 150 gets the local bus reset state Debugging age1439 cal get on page 75 gets last calibration date of specified board 1439 clock recover on page 77 allows recovery from an out of spec external sample clock agel1439 driver debug level on page 97 sets the debug level agel1439 driver debug level get on page 97 gets the debug level agel1439 error message on page 102 retu
171. lent E1439 and it functions like an AC voltmeter It is written in Visual Basic acvolts exe This is a console version of acvolts_32 exe written in Microsoft Visual C Benchmark_32 exe This performance benchmark program is really more of a utility than an example although source code is provided It allows users to measure data transfer rates and command processing times on their system without having to write new code The utility is written in Visual Basic bench exe This is a console version of Benchmark_32 exe written in Microsoft Visual C Getting Started with the Agilent E1439 To use the example programs multchan_32 exe This example shows how to synchronize two modules to achieve simultaneous sampling filter decimation and matched local oscillator phase It is written in Visual Basic info exe This example shows how to retrieve option and revision information from an Agilent E1439 and it doubles as a handy utility It is written as a console program in Microsoft Visual C interrupt exe This example shows how to set up and trap a VXI interrupt to indicate an error condition in the Agilent E1439 It is written as a console program in Microsoft Visual C 17 Getting Started with the Agilent E1439 To use the example programs Using Agilent E1439 Using the Agilent E1439 Agilent E1439 overview Agilent E1439 overview 100 MHZ 102 4 MHz
172. m the fiber transmitter agel439 epoch generate on page 98 controls whether or not data epochs are gener ated agel439 epoch generate get on page 98 gets the current value of epochGenerate agel439 epoch header on page 98 sets the value of the first 32 bits of the epoch header It can be used by the optical receiver to direct where to route and or how to process associated epoch data agel439 epoch header get on page 98 returns the header value and the value of the increment count for the epoch header agel439 epoch header enable on page 98 controls whether not epoch headers are generated agel439 epoch header enable get on page 98 returns the current value of header enable agel439 epoch setup on page 98 sets the parameters relevant to the transmission of data epochs on the fiber interface agel1439 epoch size on page 98 5 1 the size of data epochs in bytes 1439 epoch size get on page 98 returns the current size of data epochs on the fiber interface 63 Agilent E1439 Programmer s Reference Functions listed by functional group Identification age1439_product_id_get on page 158 returns the module s product identification string age1439 options get on page 157 returns the module s options 1439 serial number on page 157 sets the module s serial number for product repair purposes agel1439 serial number get on page 157 returns the module s serial numb
173. magLevel threshold before the magnitude trigger circuit will recognize the signal as being low This can facilitate triggering off of a burst signal for example a tone burst or a TDMA burst Due to the zero crossings within the tone burst the ADC trigger can not reliably trigger on the leading edge of the burst If you set the magDwell time longer than any potential drop outs within a burst and shorter than the gap between bursts the magnitude trigger can easily catch the leading edge of a tone burst For a magnitude trigger with positive slope the signal must be low for at least a magDwell number of samples After that the module will trigger the next time the signal goes above the magLevel threshold For a negative slope the module will trigger the first time that the signal is low for at least a magDwell number of samples after being high Note that in this case the trigger will occur a magDwell period of time after the end of the tone burst You can use a negative trigger delay to compensate for this and to capture the end of the tone burst A B C D Signal 4 4 lt p gt L Envolnpe peaa neue ositive rigger Level Trigger le Poet Points Poot Time magDwell times 4 lt _ gt Output of magnitude High comparators Low A Time A is less than the magDwell time The magnitude trigger does not recognize the signal as being low B Time B is longer than the magDwell time Th
174. mainframe the front panel Intermodule Clock and Sync connectors can be used to distribute clock and Sync lines from one mainframe to another Since the Sync transition timing relative to the reference input is critical the module driving the Sync line should ideally be the same one identified as the master However when using backplane distribution any E1439 in the same mainframe as the master can drive the Sync line When using the multi sync mode of operation the selection of front panel or backplane distribution of reference and Sync signals involves the following considerations e Backplane distribution requires the use of the ECL Trigger lines on the backplane which are then unavailable to other modules overall time skew between the arrival of ADC clock edges is smaller when using backplane distribution particularly if the master or buffer module is physically located in the center of the group of E1439 modules e Backplane distribution is more susceptible to pickup of jitter on ADC clock from other digital activity on the VXI backplane The extent of this pickup depends on the mainframe and on the other modules in the mainframe One important step in reducing this pickup is to disable whenever possible the 10 MHz VXI clock generated by the slot 0 controller lAs opposed to the older A or B models 32 Using the Agilent E1439 Managing multiple modules e For backplane distribution make sure that all modules
175. me setups 84 Send sync to slave EXT SAMPLE CLOCK VCXO OFF DIVIDE BY 38 PRESCALE BY 1 CLOCK OFF FRONT PANEL CLOCK BNC CLOCK CLOCK OFF DIVIDED ADC CLOCK SYNC OUT VXI REAR TO FRNT AGE1439 FRNT MSTR INT REF ADC CLK VCXO ADC DIVIDER REFERENCE PRESCALER OUTPUT REFERENCE CLOCK FRONT PANEL CLOCK SMB CLOCK OUTPUT SYNC CLOCK SYNC OUTPUT SYNC DIRECTION VCXO INTERNAL VCXO ON DIVIDE BY 38 PRESCALE BY 1 DIVIDED ADC CLOCK NIA CLOCK OFF DIVIDED CLOCK VXI_CLOCK SYNC OUT BOTH REAR TO FRONT clockSetupPtr Agilent E1439 Programmer s Reference Functions listed alphabetically Receive sync from master AGE1439 FRNT REAR SLAV EXT REF ADC_CLK VCXO EXT REF VCXO VCXO ON ADC DIVIDER DIVIDE BY 38 REFERENCE PRESCALER PRESCALE BY 1 OUTPUT FRONT PANEL CLOCK REFERENCE CLOCK FRONT PANEL CLOCK FRONT PANEL CLOCK SMB CLOCK SMB CLOCK OUTPUT CLOCK OFF SYNC CLOCK SMB CLOCK SYNC OUTPUT SYNC OUT BOTH SYNC DIRECTION FRONT TO REAR points to the current value of clockSetup 1439 CUSTOM CLOCK SETUP is returned from age1439 clock setup get when low level clock configuration functions are used to set up clocks to a non standard configuration Example The program multichan exe example program provides an example of how to correctly set up a multi module system with synchronous clocks Return Value AGEI1439 SUCCESS indicates that a function was successful Values othe
176. mentCount is 0 and the maximum value is 2710 1 Example The following is a example of how the increment process works For headerValue 0x12345678 and incrementCount 0x2 the sequence of values for headerValue and headerIndex are Increment headerValue headerlndex 0 0x12345678 0x278 1 0x12345679 0x279 2 0x1234567A 0x27A 0 0x12345678 0x278 1 0x12345679 0x279 2 0x1234567A 0x27A If an incremented header reaches a value where the headerIndex is Ox3FF the next headerIndex will be 0x000 and no carry will be generated to the upper 22 bits of the header If the incrementCount is set to 0 incrementing the headerIndex field is disabled points to the current value of incrementCount The following table is a summary of valid fiber epoch setups Please note that the designation of N A means that this information is not applicable to this condition In this case the setting is accepted but ignored The designation of OK means the setting is accepted and implemented The designation of NO means do not use this setting with this condition Option fiberMode Off Raw Generate Append BOF OFF OK OK OK BOF NIA NIA OK ok CRC_OFF NIA oie OK OK oK OK OK oK FLOW CONTROL OrF OK OK OK FLOW CONTROL COPY OK OK OK FLOW CONTROL NO COPY OK OK OK EPOCH GEN OFF OK OK NO EPOCH GEN ON NIA NIA OK ok ok HEADER OFF OK OK OK HEADER
177. ms may include multiple Agilent E1438s or Agilent E1439s but not a mixture of the two types of modules lAs opposed to the older A or B models Installing the Agilent E1439 To install the Agilent E1439 EET PME Logical Address 4 Set the mainframe s power switch to off 0 Caution Installing or removing the module with power on may damage components in the module 5 Place the module s card edges top and bottom into the module guides in the slot 6 Slide the module into the mainframe until the module connects firmly with the backplane connectors Make sure the module slides in straight and that the insertion extraction levers are pressed parallel to the front panel Installing the Agilent E1439 To install the Agilent E1439 7 Attach the module s front panel to the mainframe chassis using the module s captive mounting screws VXI Mainframe Slotted Captive Screws Power Switch Caution Caution Note Installing the Agilent E1439 To clean fiber optic connectors To clean fiber optic connectors The Agilent E1439D has a fiber optic serial FPDP front panel data port Since the data transmits via light the fiber optic connections must be clean The following procedure describes how to clean fiber optic connectors Do not use any type of foam swab to clean optical fiber ends Foam swabs can leave filmy deposits on fiber ends
178. n be read by calling the agel439 read raw function again age1439 meas start should not be called again 5 When used in this way an overload indication is given for each and every data block read in block mode In continuous mode the overload indicator only means there was an overload sometime after calling age1439 meas start The primary purpose of the age1439 read raw function is to provide the fastest possible way to read blocks of data from the module Since this command does not perform data scaling after reading data it may save 10 2046 of the overall age1439 read time depending on the host computer in use The resulting data ordering is dependent on the data type and resolution The array may be cast as a long before reading the data to provide whole words Example A declaration in the Front Panel example program can be changed to exercise age1439 read raw in frmMain of e1439 vbp Const constFreqCentRaw False when TRUE use agel439 read raw instead of agel439 read Return Value 1439 SUCCESS 1439 NO DATA MEASUREMENT IN PROGRESS 163 Agilent E1439 Programmer s Reference Functions listed alphabetically AGE1439_NO_DATA_MEASUREMENT_PAUSED 1439 NO DATA WAITING FOR TRIGGER AGE1439 NO DATA WAITING FOR ARM See Also 1439 init on page 132 1439 read on page 159 1439 status get on page 176 agel439 data setup on page 90 measurement loop in chapter 3
179. n counters when the digital filter bandwidths are changed Resetting the decimation counter causes a transient in the digital filters The transient takes about 30 decimated output sample periods to decay 100 dB See the step response graphs in the Technical Specifications for more detail Parameters is the VXI instrument session pointer returned by the age1439 init function Comment The correct procedure for using this command is 1 Force all modules to idle using age1439 meas control 2 Call age1439 filter sync for all modules 3 Cause a sync transition with one module using age1439 meas control without releasing force to idle 4 Release force to idle on all modules If you also want to synchronize frequency or phase see age1439 frequency setup This procedure also applies to those commands for multi module systems Example The multichan exe example program provides an example of how to correctly set up a multi module system with synchronous filters Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 123 Agilent E1439 Programmer s Reference Functions listed alphabetically See Also agel439 init on page 132 1439 filter setup on page 120 age1439_frequency_setup on page 128 age14
180. n id Vilnt16 mode Vilnt16 bofEnable Vilnt16 flowControlEnable Vilnt16 crcEnable Vilnt16 transferRate ViStatus age1439 fiber BOF Visession id Vilnt16 bofEnable ViStatus age1439 fiber get Visession id ViPInt16 bofEnablePtr ViStatus age1439 fiber crc Visession id Vilnt16 crcEnable ViStatus age1439 fiber crc get Visession id ViPInt16 crcEnablePtr ViStatus age1439 fiber flow control Visession id ViInt16 flowControlMode ViStatus age1439 fiber flow control Visession id Vilnt16 flowControlModePtr ViStatus age1439 fiber mode Visession id ViInt16 fiberMode ViStatus age1439 fiber mode get Visession id ViPInt16 fiberModePtr ViStatus age1439 fiber signal get ViSession id ViPInt16 fiberSignalPtr ViStatus age1439 fiber transfer rate Visession id ViInt16 transferRate ViStatus age1439 fiber transfer rate get Visession id ViPInt16 transferRatePtr ViStatus age1439 fiber verify ViSession id ViInt16 verifyPath Vilnt16 sec ViStatus age1439 fiber xmt BOF ViSession id ViStatus age1439 fiber xmt signals ViSession id ViInt16 pio Vilnt16 pio2 ViInt16 dir Vilnt16 nrdy ViStatus age1439 fiber xmt signals get ViSession id Vilnt16 1 Vilnt16 pio2 Vilnt16 dir Vilnt16 nrdy ViStatus age1439 meas status get ViSession id ViPInt16 readValid ViPInt16 block Ready ViPInt16 overload ViStatus age1439 adc clock ViSession id Vilnt16 adcClock ViStatus age1439 adc clock get ViSession id ViPInt16 adcClockPtr ViStatus a
181. nal sam ple clock agel1439 clock setup on page 78 sets all timing parameters for commonly used mea surement setups agel1439 clock setup get on page 78 gets the current clock setup age1439 close on page 86 closes the module s software connection age1439_combo_setup on page 87 a quick way to set blocksize center frequency and signal bandwidth with one function age1439_data_blocksize on page 90 determines the size of the output data block age1439_data_blocksize_get on page 90 gets the output data block size age1439_data_delay on page 90 determines FIFO delay in continuous mode age1439_data_delay_get on page 90 gets FIFO delay in continuous mode agel439 data memsize get page 88 eturns module s memory size in megabytes agel439 data mode on page 90 selects block mode or continuous mode agel439 data mode get on page 90 gets the data mode agel439 data port on page 90 selects VME bus local bus or fiber interface for output port transmission agel439 data port get on page 90 gets the output port designation agel1439 data resolution on page 90 selects 12 or 24 bits data resolution agel1439 data resolution get on page 90 gets the data resolution agel1439 data scale get on page 89 gets data scale factor used to convert raw data to volts agel1439 data setup on page 90 sets all format and data output flow parameters agel439 data spectral order on page 90 specifie
182. nd 1 specifies the mask of events on which to interrupt V XIbus specifications only allow the 8 most significant bits in the status register bits 8 to 15 to be set as interrupts Because of this the desired mask value must be right shifted 8 positions In the E1439 bits 14 and 15 of the status register cannot be used to generate interrupts effectively leaving only 6 bits 8 through 13 to generate interrupts specifies which of the seven VME interrupt lines to use The only legal values 0 through 7 Specifying 0 turns the interrupt off while 7 is the highest priority contain the current value of the interrupt mask and priority parameters Comments Interrupt masks are cleared during the interrupt acknowledge cycle Therefore the command must be sent again or restored with age1439 interrupt restore on page 145 in order to generate further interrupts Example The program interrupt exe described in the example programs provides an example of how to use interrupts correctly 146 Agilent E1439 Programmer s Reference Functions listed alphabetically Return Value AGE1439_SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 See Also Default values on page 201 age1439_init on page 132 age1439_status_get on pa
183. ndicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Commands which halt active measurements on page 198 1439 init on page 132 1439 filter setup on page 120 age1439 frequency center raw on page 125 age1439_ data setup on page 90 1439 meas control on page 151 87 id memSizePtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_data_memsize_get Returns the module s memory size in megabytes VXIplug amp play Syntax include age1439 h ViStatus age1439 data memsize get ViSession id ViPInt16 memSizePtr Description This command allows you to determine whether your module contains standard memory of 18 Mbytes or a larger memory option Parameters is the VXI instrument session pointer returned by the age1439 init function points to the memory size in number of Megabytes Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 age1439 data setup on page 90 88 id scalePtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_data_scale_get Gets
184. necting an optical short between the RX and TX fiber ports No fiber optic cables should be connected or disconnected during verification Parameter is the VXI instrument session pointer returned by the age1439 init function indicates which path internal or external is being tested by age1439 fiber verify 1439 FIBER VERIFY INTERNAL verifies the internal fiber interface connections to the rest of the module age1439 self test performs five second internal fiber verification 1439 FIBER VERIFY EXTERNAL verifies the operational condition of the RX and TX fiber ports by connecting an optical short between them sets the number of seconds the verification procedure will last based on this argument 1439 FIBER VERIFY MIN sets minimum fiber verification time in seconds 1439 FIBER VERIFY sets maximum fiber verification time in seconds Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also 1439 init on page 132 age1439 self test on page 170 116 Agilent E1439 Programmer s Reference Functions listed alphabetically agel1439 fiber xmt This function sends a BOF event used for synchronization with other fiber interfaces before data acquisition begins
185. ned by the age1439 init function points to the returned value which is an integer from 32768 to 32767 and should be interpreted as follows AGE1439 TRIG PHASE 0 represents 0 degrees or 0 AGE1439 TRIG PHASE 90 represents 90 degrees or 16384 AGE1439 TRIG PHASE 180 represents 180 degrees 32768 AGE1439 TRIG PHASE 270 represents 270 90 degrees or 16384 In other words each count represents 360 65536 degrees of phase To convert the returned phase value to degrees multiply the returned value by 360 65536 In multiple module systems the actual phase of the triggering module should be used to correct data from other modules in the system The returned phase value represents the digital LO s phase at the time of the actual trigger This time may vary from the time of the desired trigger by the value returned by age1439 trigger delay actual get The LO phase could be used in time domain averaging of blocks or other operations involving zoomed blocks of data so that the varying phase of the LO can be removed from the calculation Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also 1439 init on page 132 1439 trigger setup on page 183 1439 trigger delay actual get on p
186. ng and LO frequency and the digital filters and LOs are correctly synchronized Since the filters and LOs are synced together their actual trigger delays and LO phases are identical and will cancel out of relative phase measurements Any remaining delay should be less than 10ns between two modules in the same mainframe Only the module that generates the trigger has knowledge of the delay between the trigger event and the start of data collection Therefore if you need the actual delay from the trigger you should use the trigger delay correction from the module that generated the trigger Likewise you should obtain the LO phase at the time of the trigger from the module that generated the trigger See Delay and phase in triggered measurements on page 25 External sample synchronization in multi module systems There are two general instances where you might want to use an external sample clock in a system with multiple E1439s e You wish to have the ADC s sample at a rate other than the 95 MHz clock supplied with the E1439 e You wish more precise simultaneous sampling than can be provided by the normal scheme that uses the internal VCXOs within the modules locked together by 2 5 MHz reference that is distributed from module to module By exercising care in matching the skew of the sample clocks fed into each module channel to channel group delays at low frequencies can be well below a nanosecond External sample is specified only
187. nges use the same DAC setting as the highest range setting for ac coupling The scaling between the coarse and fine DACs is approximately 100 to 1 1439 OFFS DAC MIN sets the minimum dc offset DAC setting 1439 OFFS DAC sets the maximum dc offset DAC setting Parameters is the VXI instrument session pointer returned by the age1439 init function sets values of 0 to 255 sets values of 0 to 255 returns a pointer to the current value of coarseDac returns a pointer to the current value of fineDac Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also Default values on page 201 age1439 init on page 132 1439 input autozero page 134 1439 input offset save on page 136 135 Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_input_offset_save Saves all DAC offset settings to non volatile RAM VXIplug amp play Syntax include age1439 h ViStatus age1439 input offset save ViSession id Description Use this command if you want DAC offset settings to persist past power down Parameters is the VXI instrument session pointer returned by the age1439 init function Return Value AGEI1439 SUCCESS indicates that a function was s
188. nning and making simple measurements without programming It shows you how to install the software libraries and how to run the Soft Front Panel program It also introduces you to the example programs The Host Interface Library is available as a Windows Library that communicates with the hardware using VISA Virtual Instrument Software Architecture VISA is the input output standard upon which all the VXIplug amp play software components are based This section assumes you have already installed the module in the VXI mainframe as shown in the previous chapter It also assumes that you have installed a VXI interface according to the manufacturer s instructions Be sure to read the readme file for important up to date software installation information Getting Started with the Agilent E1439 System Requirements System Requirements System Requirements Microsoft Windows A Pentium class personal computer Microsoft Windows 2000 or NT One of the following interfaces e HP Agilent FireWire 8491 IEEE 1394 PC Link to VXI National Instruments PCI MXI 2 e Other VISA compliant VXI interface VISA Virtual Instrument Software Architecture library The computer must have a CD ROM drive for the installation media One of the following Web browsers e Microsoft Internet Explorer 4 0 or greater e Netscape Navigator 4 08 or greater 11 Note Getting Started with the Agilent E1439 To install the Windows VXIplug amp play drivers
189. nstall the updated firmware using the firmware installation program FirmwarelInstall This program s default location is drive vxipnp win 95INT age1439 firmware Start the program then use the Select File button to locate the firmware image you want to install Enter the VXI address of the instrument to be updated and click the Update button The installation will take one or two minutes This program requires VISA to be installed on the host computer Note Getting Started with the Agilent E1439 To use the Resource Manager To use the Resource Manager The Resource Manager is a program from your hardware interface manufacturer It looks at the VXI mainframe to determine what modules are installed You need to run it every time you power up If you get the message VISUCCESS_DEVICE_NPRESENT then run the Resource Manager Before running the Agilent E1439 software make sure that your hardware is configured correctly and that the Resource Manager runs successfully Before using your measurement system you must set up all of its devices including setting their addresses and local bus locations No two devices can have the same address Usually addresses 0 and 1 are taken by the Resource Manager and are not available For more information about the Resource Manager see the documentation with your hardware interface Most Resource Managers will recognize the manufacturer and model number of the Agilent E1439 but if your interface re
190. nstrument session pointer returned by the age1439_init function returns a value indicating whether or not an optical signal has been detected by the fiber interface receiver AGE1439_NO_FIBER_SIGNAL indicates no optical signal has been detected by the fiber interface receiver AGE1439_FIBER_SIGNAL_PRESENT indicates an optical signal has been detected by the fiber interface receiver Return Value AGE1439_SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 See Also agel439 init on page 132 age1439_fiber_LED_get on page 110 age1439_status_get on page 176 115 Note id verifyPath Note sec Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 fiber verify This function verifies the operational condition of the fiber interface VXIplug amp play Syntax include age1439 h ViStatus age1439 fiber verify ViSession id ViInt16 verifyPath Vilnt16 sec Description This function performs a verification of the fiber interface using either an internal or an external signal path The internal signal path cannot test the actual RX TX ports but does test the internal connections of the fiber interface to the rest of the module The external signal path does test the RX TX ports but requires con
191. o ViSession id ViStatus age1439 input coupling ViSession id ViInt16 coupling ViStatus age1439 input coupling get ViSession id ViPInt16 couplingPtr ViStatus age1439 input offset ViSession id Vilnt16 coarseDac Vilnt16 fineDac ViStatus age1439 input offset get ViSession id ViPInt16 coarseDacPtr ViPInt16 fine DacPtr ViStatus age1439_input_offset_save ViSession id ViStatus age1439_input_range ViSession id Vilnt16 range ViStatus age1439_input_range_auto ViSession id ViReal64 sec ViStatus age1439_input_range_convert ViSession id Vilnt16 range ViPReal64 rangeV oltsPtr ViStatus age1439 input range get ViSession id ViPInt16 rangePtr ViStatus age1439 input setup ViSession id ViInt16 signalPath Vilnt16 range Vilnt16 coupling Vilnt16 antiAlias Vilnt16 signal ViStatus age1439 input signal ViSession id Vilnt16 signal ViStatus age1439 input signal get ViSession id ViPInt16 signalPtr ViStatus age1439 input signal path ViSession id ViInt16 signalPath ViStatus age1439 input signal path get ViSession id ViPInt16 signalPathPtr ViStatus age1439 interrupt mask get ViSession id Vilnt16 intrNum ViPInt16 maskPtr ViStatus age1439 interrupt priority get ViSession id Vilnt16 intrNum ViPInt16 priori tyPtr ViStatus age1439_interrupt_restore ViSession id ViStatus age1439_interrupt_setup ViSession id ViInt16 intrNum Vilnt16 priority Vilnt16 mask ViStatus age1439_Ibus_mode ViSession id Vilnt16 busMode ViStatus age
192. ock setup command 2 Issue the age1439 ext sample sync AGE1439 EXT SAMPLE SYNC ENABLE command to reset the counters within all the E1439s 3 Generate the external sample sync pulse simultaneously into all modules One way to do this is to use one of the VXI TTLTRG lines and reclock the signal with the falling edge of the sample clock Note If you are using an E1439A module with a serial number lower than US41140000 you will need some user supplied hardware to convert TTLTRG to ECL because older E1439As do not support TTL trigger 4 Issue the age1439 clock recover command to all modules since the DSP clock was interrupted between the age1439 ext sample sync command and the external sync signal on the Trigger input 5 Sync the digital filters Force all modules to idle age1439 meas control e Send the age1439 filter sync command to all modules e Assert and release the sync line from the master module age1439 meas control e Release all modules from idle age1439 meas control 6 Sync the digital local oscillators e Force all modules idle age1439 meas control Set all module frequencies to zero age1439 frequency center e Assert and release system Sync 1439 meas control Set the LO frequencies to the desired ones age1439 frequency center Toggle system Sync again to synchronously set the LO frequencies 1439 meas control Finally release all modules from idle age1439 meas control
193. odule All Local Bus data transfers originate in the Agilent E1439D and move towards a signal processing module to the right of the Agilent E1439D If other modules generate data to the left of the input module the Agilent E1439D passes the data to its right and inserts or appends its own data at the beginning or end of the frame The fiber optic interface available on the Agilent E1439D provides data rates greater than 200 Mbytes second It can transmit filtered or unfiltered data copy data from its receiver to its transmitter or append data to copied data 42 Using the Agilent E1439 Fiber Optic Interface Fiber Optic Interface The E1439D provides a fiber optic interface that can transmit continuous full bandwidth data from the internal A D converter In addition it can stream data from multiple synchronized modules operating at lower bandwidths onto a single fiber optic channel An optical receiver can then simultaneously analyze data collected at different frequencies and bandwidths The E1439D fiber optic interface uses a serial data stream protocol providing high data throughput and low latency characteristics This protocol is intended to be compatible with the Serial Front Panel Data Port Draft Standard VITA 17 1 draft 0 5 dated February 26 2001 currently under development by the VITA Standards Organization http www vita com VITA 17 1 is not yet approved and manufacturers are not yet permitted to claim conformance to the dr
194. oints to the status word The bits are defined below Status Bit Definition Description 0 1 AGE1439 STATUS MEAS ARM WAIT AGE1439 STATUS MEAS IDLE AGE1439 STATUS MEAS PROGRESS AGE1439 STATUS MEAS TRIG WAIT 2 AGE1439 STATUS PASSED 3 AGE1439 STATUS READY 4 AGE1439 STATUS FIBER ACTIVE 5 AGE1439 STATUS FIBER ERROR 6 AGE1439 STATUS SETUP ERROR 7 AGE1439 STATUS SYNC COMPLETE 176 These two bits indicate the current state of the measurement loop See measurement loop in chapter 3 and age1439 meas status get on page 156 for more information about these states Passed This bit is always set to 1 This bit is set when the module is ready after power on See the VXIbus Specifications for more information This bit is set internally whenever any data has been written to the receive FIFO or read from the transmit FIFO of the fiber interface within the past 500 milliseconds approximately The bit is cleared automatically when activity ceases on the fiber interface This bit is set internally whenever an error condition occurs on the fiber interface Reading the status register does not clear this bit To do this the age1439 fiber error clear function must be used explicitly The function age1439 fiber error get can be used to read the contents of the fiber error register If the error is continuously present the bit will not be cleared Setup error An invalid parameter value was requested If an
195. on Name INITIALIZE amp CLOSE MEASURE MEASURE MEASURE MEASURE READ READ CONFIGURE CONFIGURE INITIATE FETCH LOW LEVEL age1439 init on page 132 age1439 close on page 86 age1439 meas control on page 151 age1439 meas init on page 154 age1439 meas start on page 155 age1439 meas status get page 156 age1439 wait on page 189 age1439 read on page 159 age1439 read64 on page 159 age1439 read raw on page 162 age1439 clock fs on page 76 age1439 clock fs get on page 76 age1439 clock recover on page 77 age1439 clock setup on page 78 age1439 clock setup get on page 78 age1439 combo setup on page 87 age1439 data memsize get on page 88 age1439 data scale get on page 89 age1439 data setup on page 90 age1439 ext sample sync on page 104 age1439 ext sample sync get on page 104 age1439 filter setup on page 120 age1439 frequency setup on page 128 age1439 input autozero on page 134 age1439 input range auto on page 137 age1439 input setup on page 141 age1439 input range convert on page 138 6 age1439 trigger setup on page 183 age1439 adc clock on page 72 age1439 adc clock get on page 72 age1439 adc divider on page 73 age1439 adc divider get on page 73 55 Agilent E1439 Programmer s Reference Functions listed by class Component Capability Subclass Function Name 56 age1439 data blocksize on page 90 age1439 data blocksize get on p
196. ormation on the following functions which set or query the format and flow parameters individually agel1439 data blocksize determines the size of the output data block agel1439 data blocksize get gets the output data block size agel439 data delay determines the FIFO delay in continuous mode agel1439 data delay get gets the FIFO delay in continuous mode agel439 data mode selects block mode or continuous mode agel439 data mode get gets the data mode agel1439 data port selects VME bus or local bus output port agel1439 data port get gets the output port designation agel439 data resolution selects 12 or 24 bits data resolution agel1439 data resolution get gets the data resolution agel1439 data spectral order specifies the spectral order of the output data agel1439 data spectral order get gets the spectral order of the output data agel1439 data type selects real or complex output data agel1439 data type get gets output data type VXIplug amp play Syntax include age1439 h ViStatus age1439 data setup ViSession id Vilnt16 dataType Vilnt16 resolution Vilnt16 mode Vilnt32 blocksize Vilnt32 dataDelay Vilnt16 spectralOrder Vilnt16 port ViStatus age1439 data blocksize ViSession id ViInt32 blocksize ViStatus age1439 data blocksize get ViSession id ViPint32 blocksizePtr ViStatus age1439 data delay ViSession id ViInt32 dataDelay ViStatus age1439 data delay get ViSession id ViPInt32 dataDelayPtr ViStatus age1439 data mode Vi
197. ory so you must move the memory from the original module to the replacement module This section shows you how to add or replace memory modules For information on upgrading your module or replacing parts contact your local Agilent Technologies sales and service office See the Technical Specifications or the Agilent Technologies web site http www agilent com for a list of office locations and addresses Ordering Information To order parts in the U S call Agilent Technologies Parts Direct Ordering at 877 447 or go to https www parts agilent com Outside the U S please contact your local Agilent Technologies parts center 220 Code Numbers Replacing Assemblies Replaceable parts The following table provides the name and location for the manufacturers code numbers Mfr Code listed in the replaceable parts table Mfr No Mfr Name Location 28480 03647 04637 16044 07606 04605 05610 06363 Agilent Technologies Inc Instrument Specialties Co Inc Phelps Dodge Corp Kingston Technology Corp ITW Inc Medalist Fischer Special Mfg Co Textron Inc Oudensha America Inc Palo Alto CA U S A Delaware Water Gap PA U S A New York NY U S A Fountain Valley CA U S A Glenview IL U S A Cincinnati OH U S A Providence RI U S A Elk Grove Village IL U S A 221 Replacing Assemblies Replaceable parts Assemblies Caution The module is static sensitive Use the appropria
198. otocol Only A16 D16 D32 data transfers are supported thus the upper addresses are ignored DTB Arbitration Bus The E1439 is not capable of requesting bus control thus it does not use the Arbitration bus To conform to the VME and VXI specifications it passes the bus lines through Priority Interrupt Bus The E1439 generates interrupts by applying a programmable mask to its status bits The priority of the interrupt is determined by the interrupt priority setting in the control register Utility Bus The VME specification provides a set of lines collectively called the utility bus Of these lines the E1439 only uses the SYSRESET line Pulling SYSRESET line low a hardware reset has the same effect as setting the reset bit in the Control Register a software reset with two exceptions The exceptions are The Control Register is also reset e All logic arrays are reloaded Reloading the logic arrays enables the hardware reset to recover from power dropouts which may invalidate the logic setup Local Bus The VXI specification includes a 12 wire local bus between adjacent module slots Using the local bus Agilent Technologies has defined a standard byte wide ECL protocol that transfers data from left to right at up to 100 Mbyte second The E1439D can be programmed to output its data using this high speed port instead of the VME data output register The Data Port Control register determines which output port is used
199. output on page 180 Using clock and sync in chapter 3 178 Note id syncDirection syncDirectionPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_sync_direction Selects front or rear panel availability of the sync signal This description also includes the query function age1439_sync_direction_get VXIplug amp play Syntax include age1439 h ViStatus age1439 sync direction ViSession id ViInt16 syncDirection ViStatus age1439 sync direction get ViSession id ViPInt16 syncDirectionPtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup Description This function determines whether the front or rear panel sync signal is available to the other panel Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 SYNC FRNT TO REAR specifies that front panel sync signal be available on the VXI backplane rear panel 1439 SYNC REAR TO specifies that the V XI backplane sync signal be available on the front panel SMB sync connectors Returns a pointer to the current value of syncDirection Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error mess
200. output buffer memory although previously measured data is retained in the buffer memory and is available for output via the VME and also local bus or fiber optic transmitter port on the E1439D The module stays in the Idle state until the Sync line is asserted Upon entering the Arm state the E1439 clears old data It remains the Arm state until the Sync signal is released If an E1439 is programmed with a pre trigger delay it collects enough data samples to satisfy this pre trigger delay and then releases the Sync line If no pre trigger delay has been programmed the module releases the Sync line immediately When all E1439s in a system have released the Sync line the module moves to the Trigger state Upon entering the Trigger state an E1439 that is programmed with a pre trigger delay continues collecting data into the FIFO discarding any data prior to the pre trigger delay An E1439 remains in the Trigger state until the Sync line is asserted The Sync line may be asserted by a direct command or by any E1439 that encounters a trigger condition and is programmed to assert the Sync line When the Sync signal is asserted all modules synchronously move to the Measure state In the Measure state the E1439 continues collecting data and sends the data saved in the FIFO memory to the selected I O port starting with the sample indicated by the trigger arrival offset by the number of samples specified by the trigger delay This data transfer
201. p play Syntax include age1439 h ViStatus age1439 data xfersize ViSession id ViInt32 xfersize ViStatus age1439 data xfersize get ViSession id ViPInt32 xfersizePtr Description This command allows you to specify the allowable data transfer size in a situation where you want to read a large block of data in increments before an entire block has been acquired This function has no effect on the fiber output channel Parameters is the VXI instrument session pointer returned by the age1439 init function specifies the data transfer size in samples 1439 XFERSIZE MIN selects the minimum allowable transfer size 1439 XFERSIZE selects the maximum allowable transfer size xfersize must be a sub multiple of blocksize or an error is generated 1439 XFERSIZE DEF sets the default transfer size xfersize is reset by any subsequent change in the blocksize parameter and therefore must be specified after blocksize See 1439 data setup on page 90 points to the data transfer size in number of bytes Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Commands which halt active measurements on page 198 5 1439 init on page 132 agel439 data setup on page 90 96 Not
202. p to 47 5 MHz 47 5 95 MHz for the 70MHz IF and 0 47 5 for baseband Frequency components outside the 47 5 MHz bandwidth can cause ambiguous results aliasing The 70 MHz IF filter attenuates frequency components both below and above 52 88 MHz to reduce aliasing This filter rejects signals from 0 43 MHz and 102 200 MHz to 78 dB Thus the 52 88 MHz frequency range of the sampled signalis 78 dB alias free filter s transition bands from 43 52 MHz and 88 102 MHz affects flatness and allows some aliasing in the sampled signal frequency ranges 47 5 52 MHz and 88 95 MHz The baseband anti alias filter attenuates high frequency components to reduce aliasing This filter is flat to 36 MHz and rejects signals above 59 MHz to 65 dB Thus the 0 36 MHz frequency range of the sampled signal is 65 dB alias free The filter s transition band from 36 to 59 MHz affects flatness and allows some aliasing in the sampled signal frequency range 36 to 47 5 MHz In cases where alias filtering is not necessary the E1439 can be programmed to bypass the anti alias filter To avoid incorrect results the alias filter bypass mode should be used with caution it is not recommended for normal operation 214 Input 1 from ADC 18 SONS CN gt Fs 4 pD 2x Fsl8 ere 2x Fs 2 Module Description Block diagram and description Sampling ADC The heart of the E1439 is a precision analog to digital converter A
203. page 128 1439 frequency center raw on page 125 age1439 combo setup on page 87 127 id centerFreq centerFreqPtr cmplxDC Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_frequency_setup Sets all the zoom center frequency parameters This description also includes information on the following functions which set or query frequency parameters individually age1439_frequency_center sets the center frequency age1439_frequency_center_get gets the current center frequency age1439_frequency_cmplxdc selects a complex baseband measurement age1439_frequency_cmplxdc_get gets the state of the baseband measurement mode age1439_frequency_sync prepares the module for a synchronous frequency change age1439_frequency_sync_get gets the state of the synchronous change mode VXIplug amp play Syntax include age1439 h ViStatus age1439 frequency setup ViSession id Vilnt16 cmplxDC Vilnt16 sync ViReal64 centerFreq ViStatus age1439 frequency center ViSession id ViReal64 centerFreq ViStatus age1439 frequency center get ViSession id ViPReal64 centerFreqPtr ViStatus age1439 frequency cmplxdc ViSession id Vilnt16 cmplxDC ViStatus age1439 frequency cmplxdc get ViSession id ViPInt16 cmplxDCPtr ViStatus age1439 frequency sync ViSession id Vilnt16 sync ViStatus age1439 frequency sync get ViSession id ViPInt16 syncPtr Description agel1439 frequency setup sets the center frequency of a zoomed m
204. place to start to explore the capabilities of the Agilent E1439 The Soft Front Panel is useful for checking your system to make sure that it is installed correctly and that all of its parts are working You can also use it to make actual measurements since it accesses most of the Agilent E1439 s functionality Select the E1439 Front Panel shortcut in your program group to start program This assumes you have already installed all required hardware and drivers including VISA and have run the configurator and Resource Manager required by your hardware interface If prompted for the resource descriptor use the default VXT 192 unless the logical address of the Agilent E1439 has been changed from its default setting of 192 If it has been changed type the appropriate logical address instead of 192 then press OK You can also run the Agilent E1439 Front Panel in a simulation mode without an Agilent E1439 module a hardware interface or VISA libraries by typing sim in place of the resource descriptor The Agilent E1439 Front Panel Help available from the Soft Front Panel Help menu describes the capability of the Soft Front Panel and has links to functions that control and define many of the parameters The source files for this program are provided for you to use as sample code Spectrum Top 10 00 dBm 10 00 dB div Mode Spectrum Averaging Off Average Count 19 Window Gaussian 32 A
205. quires that you enter this information manually use the following Manufacturer number 4095 Hex FFF Model number 699 Hex 2BB 13 Getting Started with the Agilent E1439 To use the program group Windows To use the program group Windows If you installed the program group using the default method during the installation procedure you have a shortcut for a program group similar the one below Access it through the Start button Programs Vxipnp 1439 This program group contains shortcuts that access the Soft Front Panel program the User s Guide online help and example programs The following pages provide an overview of these items If you did not install the program group executable files for each of the items represented by group shortcuts are available in the drive vxipnp directory and its subdirectories 42 Agilent DSP Help 42 Agilent E1439 Help Agilent E1439 Soft Front Panel tj Agilent E1439 Technical Specifications t Agilent E1439 Users Guide 77 C Example AC Voltmeter 77 Example Benchmark C Example Info Utility C Example Interrupt 48 README jf WB Example AC Voltmeter a3 VB Example Benchmark 6 VB Example MultiChannel Note Getting Started with the Agilent E1439 To use the VXIplug amp play Soft Front Panel SFP To use the VXI plug amp play Soft Front Panel SFP In a Windows environment the Soft Front Panel is the best
206. r ViStatus age1439 input coupling ViSession id Vilnt16 coupling ViStatus age1439 input coupling get ViSession id ViPInt16 couplingPtr ViStatus age1439 input range ViSession id Vilnt16 range ViStatus age1439 input range get ViSession id ViPInt16 rangePtr ViStatus age1439 input signal ViSession id Vilnt16 signal ViStatus age1439 input signal get ViSession id ViPInt16 signalPtr ViStatus age1439 input signal path ViSession id ViInt16 signalPath ViStatus age1439 input signal path get ViSession id ViPInt16 signalPathPtr Parameters is the VXI instrument session pointer returned by the age1439 init function determines whether or not to use the built in analog anti alias filter This filter only applies to baseband measurements In IF mode the antialias filter is always turned on The antialias parameters always set the baseband anti alias filter regardless of the signal path 1439 ANTIALIAS ON inserts a sharp cutoff 36 MHzlow pass filter ahead of the analog to digital converter You should leave the filter on at all times to insure band limited anti aliased data 1439 ANTIALIAS OFF bypasses the low pass filter points to the current value of the antiAlias parameter in the current signal path Therefore in IF mode this function always returns AGEI439 ANTIALIAS ON specifies the ac or dc coupling mode of the input This parameter applies to the baseband input configuration only 1439 DC connects t
207. r more information on multi module operation see Managing multiple modules on page 32 210 Block diagram and description Module Description Block diagram and description More detailed descriptions of selected elements in the diagram below appear further on in this section Clock to from In other modules A Intermodule lt gt Clock SMB Out External Clock Clock Reference 9 BNC XMT RCV Control on rol g y Register Fiber Optic Analo 4 Sas Sampling y Interface 19 ADC E1439D only SDRAM Memory lt Local Bus Output ilterin 3 J Controller Send Data 3 9 Register Ext i xternal gt Trigger Trigger Detection Trigger In Intermodule Sync SMB Out Sync to from other modules 211 Module Description Block diagram and description Input When baseband mode is selected the input signal goes through the lower path on the diagram below In this mode there is only one input range and the anti alias filter 36 MHz bandwidth can be switched out The baseband input is terminated by the input amplifier that follows the baseband anti alias filter The bandwidth of the baseband input is 36 MHz There is no variable attenuation for the baseband path This results in a single ran
208. r returned by the age1439 init function 1439 01 BOARD returns calibration information for the 01 digital ADC board 1439 03 BOARD returns calibration information for the 03 input board points to the return location for the timestamp of the most recent saved calibrations Format is YYYYMMDD in base 10 notation Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also agel439 init on page 132 75 fs fsPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439 clock fs Provides the module with the frequency of an external sample clock This description also includes the query agel439 clock fs get VXIplug amp play Syntax include age1439 h ViStatus age1439 clock fs ViSession id ViReal64 5 ViStatus age1439 clock fs get ViSession id ViPReal64 fsPtr Description This command is applicable only when an external sample clock is used It is an order dependent command and must be set after selecting the external sample clock When using an external sample clock or when a module is a non master in a multi module group the frequency of the ADC clock is unknown by the module It is the responsibility of the programmer to provide the correct frequency so
209. r than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 Effect on Active Measurement agel1439 clock setup aborts any measurement in progress See Also Commands which halt active measurements on page 198 Default values on page 201 age1439 init on page 132 age1439 clock fs on page 76 1439 clock recover on page 77 agel439 ext sample sync on page 104 Using clock and sync in chapter 3 Managing multiple modules in chapter 3 85 Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_close Closes the module s software connection VXIplug amp play Syntax include age1439 h ViStatus age1439 close ViSession id Description agel1439 close terminates the software connection to the module deallocates system resources and places the module in the Idle state After this function has been executed the specified id identifier is no longer a valid parameter for function calls Parameters is the VXI instrument session pointer returned by the age1439 init function Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also 1
210. re than three seconds elapses in step 1 3 Returns AGE1439 SETUP ERROR if AGE1439 STATUS SETUP ERROR was detected in step 1 4 Performs age1439 meas init and returns AGE1439 SUCCESS Example The program acvolts exe described in the example programs provides an example of how to initiate a very simple measurement using age1439 meas start Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Commands which halt active measurements on page 198 1439 meas control on page 151 1439 meas init on page 154 1439 status get on page 176 age1439_ read on page 159 measurement loop in chapter 3 155 id read Valid blockReady overload Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_meas_status_get Returns the current measurement status VXIplug amp play Syntax include age1439 h ViStatus age1439_meas_status_get ViSession id ViPInt16 readValid ViPInt16 blockReady ViPInt16 overload Description This function is useful in determining the measurement status of a module when using the fiber interface The advantage of using this function over age1439_status_get is that this function decodes the measurement related s
211. rementCount ViStatus age1439_epoch_generate Visession id Vilnt16 epochGenterate ViStatus age1439_epoch_generate_get Visession id ViPInt16 epochGenteratePtr ViStatus age1439_epoch_header Visession id ViInt32 headerValue ViInt32 incrementCount ViStatus age1439 epoch header get Visession id ViPInt32 headerValuePtr ViPInt32 incrementCountPtr ViStatus age1439 epoch header enable Visession id Vilnt16 headerEnable ViStatus age1439 epoch header enable get Visession id ViPInt16 headerEnablePtr ViStatus age1439 epoch size Visession id ViInt32 epochSize ViStatus age1439 epoch size get Visession id ViPInt32 epochSizePtr Parameters is the VXI instrument session pointer returned by the age1439 init function controls whether or not data epochs are generated 1439 EPOCH GEN ON enables data epoch generation 1439 GEN OFF disables sending end of epoch and epoch headers and disables generating data epochs When epochGenerate is off EOE End of Epoch events and epoch headers are not sent however data still is Generally epochGenerate should be on and should only be disabled for purposes of compatibility This setting is ignored when the fiberMode is AGE1439 FIBER COPY points to the current value of epochGenerate sets the size of data epochs in bytes 1439 SIZE MIN selects the minimum data epoch size 1439 SIZE DEF sets the data epoch size to the default 1439
212. rns error information obtained from function calls agel1439 error query on page 103 queries the module for the most recent error age1439 status get on page 176 retrieves the module s status register information agel439 meas status get on page 156 retrieves the current measurement status register information age1439 self test on page 170 performs a self test on the module and returns the result Digital processing agel439 combo setup on page 87 quick way to set blocksize center frequency and sig nal bandwidth with one function age1439 filter setup on page 120 sets the digital filter bandwidth and decimation filter parameters age1439 filter bw on page 120 selects a signal filter bandwidth age1439 filter bw get on page 120 gets the signal filter bandwidth age1439 filter decimate on page 120 enables disables an extra factor of 2 decimation age1439 filter decimate get on page 120 gets current state of extra decimation age1439 filter sync on page 123 synchronizes the decimation filter counter age1439 frequency setup on page 128 sets all zoom center frequency parameters agel1439 frequency center on page 128 sets the center frequency agel1439 frequency center get on page 128 gets the current center frequency agel1439 frequency center raw on page 125 quickly sets the center frequency agel1439 frequency center raw compute on page 127 quickly calculates the values for ag
213. ront panel extender connections between mainframes and VXI backplane connections within mainframes 36 Using the Agilent E1439 Managing multiple modules Using an external sample clock All modules Front sync external sample clock wired OR sync on page 83 U p U D 102 8C fi n as lat yx Splitter Splitter External sample clock User generated external sync pulse Sharing clock and SYNC among several modules using external sample Front panel distribution 37 Using the Agilent E1439 Managing multiple modules All modules Rear sync external sample clock wired OR sync on page 84 dot dob d l E x e Se as CJ fi Splitter Splitter External sample clock User generated external sync pulse Sharing clock and SYNC among several modules using external sample Rear panel distribution 38 Using the Agilent E1439 Managing multiple modules Synchronizing changes in multi module systems Multi module systems require special treatment with respect to timing of frequency and filter changes Center frequency changes may involve synchronizing the local oscillators o
214. rum of the output data will be in the reverse spectral order from the input spectrum That is if the input signal increases in frequency from right to left the spectrum of the output data decreases in frequency from right to left Changing the spectral order in multiple module systems causes the LO to lose synchronization with the other modules Thus in multi module systems the LO s need to be re synchronized after this parameter is changed See age1439 filter setup for more information on synchronizing the LO spectralOrderPtr points to the current value of the spectralOrder for the current signal path In baseband mode the returned value is always AGE1439 NORMAL Return Value AGE1439_SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 See Also Commands which halt active measurements on page 198 Default values on page 201 agel439 init on page 132 age1439_frequency_setup on page 128 age1439_filter_setup on page 120 age1439 meas control on page 151 age1439 clock setup on page 78 95 Note id xfersize Note xfersizePtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439 data xfersize Allows data to be read before an entire block had been acquired VXIplug am
215. s 42 216 local oscillators phase and triggering 182 synchronizing 151 logical address default 3 selecting 3 M measurement initiating 151 initiating single module 154 155 invalid conditions 121 states described 23 measurement loop 23 memory circuit description 215 installing 225 size determining 88 MEOF 44 Index mode measurement 23 output 90 model number viewing 158 module model number 158 multiple mainframe systems 35 multiple modules managing 24 32 39 83 123 128 151 183 189 210 triggering 181 210 N normal data fiber frame 44 NRDY 44 numeric variable values 190 off fiber mode 45 offset correction dc 134 offset input 135 136 online help Windows 14 options identifying 157 output formatting 90 output mode 92 overflow fiber 44 overview clock and sync 31 data transfer 42 frequency and filtering 30 measurement state sequence 23 programming 21 synchronization 39 P packaging the module 7 parameter variable values 190 parts ordering or replacing 220 phase and delay in triggering 25 and trigger with multiple modules 40 PIO 44 pipelining data on local bus 148 port selection data 92 power supplies 209 power up state forcing 167 prescaling clock reference 166 priority interrupt bus 209 programming overview 21 R range auto 137 conversion 138 input 142 raw data scaling 89 231 Index raw fiber mode 47 reading data 159 162 real data output specifying 91 recalling in
216. s 95 MHz The actual frequency is set to the nearest available value This value is returned by the age1439 frequency center get function In multi module systems this value represents the pending value rather than the current value when a frequency change is incomplete due to a pending Sync signal transition In multiple module systems it is often desirable to force the frequency change to occur synchronously in order to preserve the phase relationship of the LOs You may accomplish this by setting the sync parameter to ON for all the modules which are to be changed In configurations involving synchronous operation of multiple Agilent E1439 modules the agel1439 frequency setup function provides a mechanism to force all LOs to the same phase You can do this by first setting the frequency to zero and then synchronously changing the frequency to the desired value Example The example program multichan exe shows how to correctly perform synchronous frequency changes in a multi module system Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 129 Agilent E1439 Programmer s Reference Functions listed alphabetically See Also Default values on page 201 age1439_init on page 132 age1439 clock setup on page 78
217. s manual and CD ROM supplied for this pack is restricted to this product only Additional copies of the programs can be made for security and back up purposes only RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the U S Government is subject restrictions as set forth in subparagraph c 1 ii of the Rights in Technical Data and Computer Software clause in DFARS 252 227 7013 Agilent Technologies Inc 395 Page Mill Road Palo Alto CA 94303 0870 USA Rights for non DOD U S Government Departments and Agencies set forth in FAR 52 227 19 1 2 Copyright 2000 2002 Agilent Technologies Inc The Agilent E1439 Glance The Agilent E1439 95 MSa s Digitizer with DSP and Memory provides high precision digitizing for time and frequency domain applications along with signal conditioning filtering and memory The module plugs into a single C size slot in VXI mainframe Number of Channels 1 Type of Inputs 50 ohm Input Bandwidth 150 MHz 36 MHz alias protected Sample Rate 95 Msample s Input Range 36 to 12 dBm Raw ADC resolution 12 bits VXI Bus Support VME and Local Bus E1439D only VXI Device Type Register based 1 0 Data Port E1439D only Fiber optic serial FPDP front panel data port Size C sized single slot What You Get With the Agilent E1439 The following items are included with your Agilent E1439 Hardware e Agilent E1439 ADC C size VXI module
218. s of the fiber flow control function agel439 fiber LED get on page 110 returns data register indicating the state of the front panel led s agel1439 fiber mode on page 112 selects the fiber interface mode agel1439 fiber mode get on page 112 gets the current mode of the fiber interface agel1439 fiber rcv signals get on page 111 displays the current value of PIO2 DIR and NRDY bits from the fiber receiver age1439 fiber setup on page 112 sets the parameters associated with the fiber inter face age1439 fiber signal get on page 115 returns a value indicating whether or not an optical signal is detected by the optical fiber interface receiver agel1439 fiber transfer rate on page 112 selects the transfer rate for fiber optic data 1439 fiber transfer rate get on page 112 gets the current selection of transfer rate for fiber optic data 1439 fiber verify on page 116 proforms a verification of the fiber interface using either an internal of external signal path agel439 fiber xmt BOF on page 117 sends BOF event used for synchronization with other fiber interfaces before data acquisition begins 1439 fiber xmt signals on page 118 sets the transmitted values of any PIO2 DIR or NRDY FPDP control signals on the fiber transmitter agel439 fiber xmt signals get on page 118 displays the current value of PIO2 DIR and NRDY bits fro
219. s successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also Commands which halt active measurements on page 198 Default values on page 201 1439 init on page 132 1439 status get on page 176 agel439 data setup on page 90 age1439 filter sync on page 123 1439 frequency setup on page 128 agel439 clock setup on page 78 age1439 wait on page 189 age1439 read on page 159 Managing multiple modules in chapter 3 measurement loop in chapter 3 Using clock and sync in chapter 3 153 Note Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_meas_init Initiates a measurement without first checking for valid hardware setup VXIplug amp play Syntax include age1439 h ViStatus age1439 meas init ViSession id Description agel439 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 t
220. s the spectral order of the output data 1439 data spectral order get on page 90 gets the spectral order of the output data agel439 data type on page 90 selects real or complex output data agel1439 data type get on page 90 gets output data type agel439 data xfersize on page 96 allows a specified amount of data to be read before an entire block has been acquired agel439 data xfersize get on page 96 gets the data transfer size agel1439 driver debug level on page 97 sets the debug level 67 Agilent E1439 Programmer s Reference Functions listed alphabetically 68 age1439_driver_debug_level_get on page 97 gets the debug level age1439_epoch_generate on page 98 controls whether or not data epochs are gener ated 1439 epoch generate get on page 98 gets the current value of epochGenerate agel439 epoch header on page 98 sets the value of the first 32 bits of the epoch header It can be used by the optical receiver to direct where to route and or how to process associated epoch data agel439 epoch header get on page 98 returns the header value and the value of the increment count for the epoch header agel439 epoch header enable on page 98 controls whether or not epoch headers are generated agel439 epoch header enable get on page 98 returns the current value of header enable agel1439 epoch setup on page 98 sets the parameters relevant to the transmission of dat
221. s value subtract the value returned by age1439 trigger delay actual get The result is in periods of the ADC sample clock Special considerations apply in multi module systems See Trigger and phase in multi module systems on page 40 When doing a zoomed measurement it may also be helpful to know the phase of the digital LO at the time the trigger occurred since the LO is also running continuously and it has an arbitrary phase relationship with the trigger event age1439 trigger phase actual get returns the phase of the LO at the trigger point The LO phase could be used in time domain averaging of blocks or other operations involving zoomed blocks of data so that the varying phase of the LO can be removed from the calculation The trigger delay value is the time measured in output samples from the desired trigger point to the start of the time record The trigger delay actual value is the time measured in input samples from the desired trigger point to the actual trigger point Start of Desired Actual time record trigger point trigger point v v signal gt trigger delay trigger delay actual time The following example illustrates how trigger delay and trigger delay actual can be combined In this example filter bw 4 2 4 MHz span filter decimate 1 on 25 Using the Agilent E1439 Delay and phase in triggered measurements trigger delay 2 2 a pre trigger delay of 2 Because the f
222. sed in this way an overload indication is given for each and every data block read in block mode In continuous mode the overload indicator only means there was an overload sometime after calling age1439 meas start Comments on Overload Since reading the status register clears the overload bit overloads are tracked at the API level In block mode you receive the overload indication a block by block basis by calling age1439 _ meas start and age1439 read in sequence In continuous mode depending on the effective sample rate of the instrument and how often data is read an overload indication returned by age1439 read may or may not correspond to the data returned The overload indication only means that an overload has occurred since the most recent 160 Agilent E1439 Programmer s Reference Functions listed alphabetically call to age1439_meas_init age1439_meas_init or age1439_read whichever was issued last You should be aware that it is likely that the reported overload occurred in data which has been acquired in the module is waiting in the FIFO but has not yet been read Return Value AGE1439_SUCCESS AGE1439_NO_DATA_MEASUREMENT_IN_PROGRESS AGE1439_NO_DATA_MEASUREMENT_PAUSED AGE1439 NO DATA WAITING FOR TRIGGER AGE1439 NO DATA WAITING FOR ARM See Also agel439 init on page 132 1439 data setup on page 90 age1439 meas start on page 155 age1439 meas init on page 154 1439 meas control on page 151
223. self test is up to 25 seconds depending on the amount of memory in the module Calling this function halts any measurement or fiber transfer Return Value AGE1439_SUCCESS indicates that a function was successful Values other than AGE1439_SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439_error_message on page 102 See Also Commands which halt active measurements on page 198 age1439_init on page 132 171 Caution id serialNum Note Agilent E1439 Programmer s Reference Functions listed alphabetically 1439 serial number Sets the serial number of the module This description also includes the query function agel439 serial number get VXIplug amp play Syntax include age1439 h ViStatus age1439 serial number ViSession id ViChar serialNum ViStatus age1439 serial number get ViSession id ViChar serialNum This command is to be used for repair purposes only Description This command is used to reassign a serial number after a module has been serviced Parameters is the VXI instrument session pointer returned by the age1439 init function sends or gets a serial number of less than 16 characters For this parameter you must allocate a character array of at least 256 characters 1439 STR LEN MIN including the null byte prior to calling this function in any programming language
224. serial communication link In all three of the data output modes the samples must be read out sequentially offset by the trigger delay Fiber Optic Interface The E1439D s fiber optic interface can transmit filtered or unfiltered data copy data from its receiver to its transmitter or append data to copied data The interface s receiver port is not a data receiver it merely copies data to its transmitter port and detects FPDP control signals e g bits and flow control signals 216 Note Module Description Block diagram and description Trigger Detection The trigger event used to start a measurement can be generated in five different ways Software e External e ADC threshold Log magnitude Immediate External and ADC threshold triggering modes support slope selection In ADC or log magnitude mode the trigger threshold has hysteresis 20 ADC sample counts for the ADC trigger and 1 5 dB for the magnitude trigger to prevent noise generated triggers of the wrong slope Log magnitude triggering is based on the magnitude of the complex signal after zooming and filtering and only supports positive slope trigger detection The external trigger mode is selectable between ECL and TTL The trigger signal must be connected to the Ext Trigger BNC connector on the front panel In ECL trigger mode this input is ac coupled with an impedance of 1 k ohm so any signal with a sharp rising or falling transition greater than
225. setting of the age1439 data port function with this parameter set However selecting fiber as the data port while using this mode will result in setting the AGE1439 STATUS SETUP ERROR bit in the status register This occurs because the fiber interface cannot perform both functions at the same time The E1439D fiber receiver s detect signal is used to activate the fiber transmitter The E1439D fiber interface is not a data receiver The function of the receive port is limited to copying data to the transmit port and to detecting FPDP control signals e g PIO bits and flow control signals Since signal detect works on light energy alone there does not need to be valid data on the fiber receiver for there to be an output from the transmitter If there is valid data present on the fiber receiver it is copied to the fiber transmitter This preserves data transparency but not necessarily protocol transparency The outgoing protocol is always serial FPDP 1439 FIBER MODE RAW transmits unprocessed and unbuffered ADC data over the fiber interface After selection optical data transmission begins when the first measurement is triggered and continues indefinitely after the measurement is complete Transmission will continue until the fiber mode is changed to something other than 1439 FIBER MODE RAW or a fiber error occurs While this raw data is being transmitted filtered ADC data can still be sent over the local bus or read from the FIFO
226. signals sys oe eee Gees eo 111 SUDO ea ce ore hee ie cee Gees 112 ageld 3o fiber sional EEREETTI IIT DO TIT 115 B DS OC VEIY qp d da ar Rud aq xod dc 116 ane 1459 fiber xi 222 44 545 5 554 lt 6 46645 117 agplq30 bor un signals i oe sas ui 118 agel439 Hber xui signals BEL ccs cree ec RR ERR A ERROR GR CA 119 2651439 PUE BOUND Oo mao RE o d 120 Miler SUED 4 sikh ooh wh E DER EAR RO CPC C ORE CR 123 ane 1459 Ir guesncy center PRU o 4 455 445 44455944 0446 50 EAS 125 agel1439_frequency_center_raw_compute rA CREER 127 use DOR ACME uoo Caara dice SUR dci ope ed KC AER Rr Ri icd 128 age 409 panel 2 2224222 0 4 6 4 131 aS equi eT eho reuse ee Ps 132 Las E CERERI HERIAR 134 OD oo ces eee sies ke PARES EAR REPE REIR 135 input DIOE BRAVA 4d eov a ira inos ro PEET ERRE 136 4261439 mpud range 444 545 5554 lt 8 445 137 input oss qui eri CERRO I 138 input self Las eadqesbkttbx xke 141 aiias sse pREC ERE REOR Een 145 gelq39 interrupt self bodes edd deeded EE ARRAY Ra 146 a Iib DOO 55 2225555 6 4 ETa 148 C EXON 150
227. span around a specified center frequency This is also known as band selectable operation 227 228 Index Numerics 70 MHZ IF input 212 9821 using with 42 A ac coupling selecting 141 ADC circuit description 215 address module See logical address Agilent E9821 using with 42 alias filter See anti alias filter alias protection See anti alias filter analog filter See anti alias filter analog input See input 212 anti alias filter circuit description 214 default 30 described 30 selecting 120 141 using 30 append fiber mode 50 appending data on local bus 148 arbitration bus DTB 209 arm state described 23 auto ranging 137 autozero 134 B backplane connections 209 bandwidth control circuit description 215 filter selection 120 baseband range fixed 137 baseband input 212 baseband measurements complex 128 overview 30 block mode explained 23 size determining 91 block diagram analog input 212 circuit description 211 clock and sync 31 functional overview 20 BOF 44 buffer amplifier selecting 143 bus transfers data 42 programming overview 21 source library 22 cables fiber optic 6 calibration data reading 75 center frequency See Also frequency setting 128 circuit description 211 cleaning fiber optic connectors 6 clock ADC source 72 circuit description 213 distribution 32 divider 73 easy setup 78 external reference 34 external sample 40 104 external sample frequency 76
228. state because raw and filtered data cannot both be sent over the fiber interface at the same time 47 Using the Agilent E1439 Fiber Optic Interface Generate If flow control is off Generate fiber mode transmits filtered ADC data over the fiber interface as soon as data is available ADC data is not available via any other data port and received optical data is ignored The following illustration shows an E1439D transmitting data when flow control is turned off E1438D E1439D Fiber RX Fiber TX 1 KB FIFO DIGITAL ADG FILTERS FIPO VME BUS LBUS Fiber Interface Setup Fiber Mode Generate Rate 106 or 250 MBs BOF Optional CRC oN Flow Control OFF Epoch Generate Optional Epoch Size Divisible by 4 1 Some receivers may require CRC to be off for compatibility 48 Using the Agilent E1439 Fiber Optic Interface If flow control is on and the fiber receiver is capable of generating flow control signals Generate fiber mode transmits filtered ADC data after the fiber receiver indicates that it is ready and a complete data block is ready to be transmitted ADC data is not available via any other data port and received optical data other than the flow control signals is ignored The following illustration shows an E1439D transmitting data to a fiber receiver when flow control is on f E1438D E1439D Fiber Receiver ES NC Fiber Fiber S Fiber RX Fiber TX py d DATA FLOW CONT
229. strument state 174 resetting bad clock 77 the local bus 150 the module 132 167 168 resolution selection data 92 resource manager using 13 return values listed 199 revision firmware 169 revisions driver 12 5 sample clock external 40 104 frequency 76 sample output rate selecting 121 sample rate and decimation 120 determining 94 saving instrument state 175 scale factor 89 scaled data reading 159 scaling raw data 89 SDRAM memory 215 self test performing 170 SEOF 44 serial FPDP 43 serial number getting 172 setting the range automatically 137 sharing clock and sync 32 shipping the module 7 smb clock output 173 connectors 208 connectors terminating 33 SOF 44 state recalling 174 saving 175 states measurement 23 status register and interrupts 146 bits defined 176 storing the module 7 SWDV 44 sync and frequency change 129 and measurement state 23 and trigger 183 clock source 178 decimation filter 123 direction 179 output selecting 180 232 setup 31 83 sharing 32 217 signal asserting and releasing 151 with external sample clock 40 104 sync with data fiber frame 44 sync without data fiber frame 44 synchronizing decimation counters 151 filter decimation 123 local oscillators 151 synchronizing measurements 40 40 123 128 151 185 189 system requirements 11 21 terminating an instrument session 86 theory of operation 211 timing See Also clock See Also trigger setup 31 signals 2
230. sts to accommodate pauses for such things as disk access times or block mode computations The effective trigger time may be offset from the actual trigger event by programming a trigger timing offset See the Technical Specifications for the limits of the pre trigger and post trigger offset Data Output You can transfer data from the E1439C or E1439D via the VMEbus With the E1439D you can also transmit data via a fiber optic interface and the Local Bus To use the VXI backplane the E1439 can be programmed so that the output of the memory controller is sent to the Send Data register The 12 or 24 bit sample data is zero padded out to 16 or 32 bits The register can then be read by any controller compatible with the VME standard Maximum data flow is about 2 MB s The local bus allows data transfers over a high speed 8 bit ECL bus to an adjacent module to the right in the VXI mainframe Multiple adjacent E1439D modules can send data to one signal processor module The signal processor must be one that supports the Agilent Technologies ECL local bus protocol such as the Agilent E9821 In addition to higher speed up to 66 MB s the local bus has the advantage that data can be output at the same time that control signals are being sent over the VXI backplane The E1439D s fiber optic interface provides data rates greater than 200 MB s It is implemented as a serial FPDP front panel data port The serial FPDP is a high speed low latency
231. t on page 182 returns a representation of the phase value of the LO at the most recent trigger point 1439 trigger setup on page 183 sets all parameters associated with triggering the beginning of data collection 1439 trigger slope on page 183 selects a positive or negative trigger 1439 trigger slope get on page 183 gets trigger slope agel1439 trigger type on page 183 determines the trigger type 1439 trigger type get on page 183 gets trigger type agel439 on page 187 selects whether the module should use an internal clock source agel439 get on page 187 gets whether the internal clock source is on or off agel439 vxi clock output on page 188 selects which clock drives the VXI clock agel439 vxi clock output get on page 188 gets which clock drives the VXI clock age1439_ wait on page 189 facilitates the synchronization and control of multi module systems 71 Note id adcClock adcClockPtr Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 adc clock Specifies the ADC clock source This description also includes the query function agel439 adc clock get VXIplug amp play Syntax include age1439 h ViStatus age1439 adc clock ViSession id Vilnt16 adcClock ViStatus age1439 adc clock get ViSession id ViPInt16 adcClockPtr This command should be used only for specialized custom clock requirements Most useful
232. t without appending or inserting its own data The state of this parameter is unaffected by switching back and forth between the local bus and the VME backplane with the age1439 data port function Module s to Left E1438 E1439 Module to Right GENERATE 7 INSERT APPEND PIPELINE 148 IbusModePtr Agilent E1439 Programmer s Reference Functions listed alphabetically points to the current value of the JbusMode parameter Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 149 id IbusReset IbusResetPtr Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 lbus reset Resets the local bus Agilent E1439D only This description also includes the query age1439 Ibus reset get gets the current local bus reset state VXIplug amp play Syntax include age1439 h ViStatus age1439 reset ViSession id Vilnt16 busReset ViStatus age1439 Ibus reset get ViSession id ViPInt16 busResetPtr Description In order to avoid glitches in the local bus data the local bus interface has strict requirements as to the order in which modules in a VXI mainframe have their local bus interface reset Upon power up or whenever any single modul
233. t16 magLevel ViStatus age1439 trigger maglevel get ViSession id ViPInt16 magLevelPtr ViStatus age1439 trigger phase actual get ViSession id ViPInt16 actualPhasePtr ViStatus age1439 trigger setup ViSession id ViInt16 trigType Vilnt32 trigDelay Vilnt16 adcLevel Vilnt16 magLevel Vilnt16 slope ViInt16 generate Vilnt32 magDwell ViStatus age1439 trigger slope ViSession id VilInt16 slope ViStatus age1439 trigger slope get ViSession id ViPInt16 slopePtr ViStatus age1439 trigger type ViSession id Vilnt16 trigType ViStatus age1439 trigger type get ViSession id ViPInt16 trigTypePtr ViStatus age1439 vcxo ViSession id Vilnt16 vcxoState ViStatus age1439 get ViSession id ViPInt16 vcxoStatePtr ViStatus age1439 vxi clock output ViSession id Vilnt16 vxiClock ViStatus age1439 vxi clock output get ViSession id ViPInt16 vxiClockPtr ViStatus age1439 wait ViSession id 206 Module Description Module Description Front Panel Description Front Panel Description LED lights when the module is accessed 10 Data XMT RCV Access Overload via the VXI backplane LED lights when the transmitter is enabled LED blinks when data generated by this module is being transmitted D module only Sync extenders are used to extend the sync line from one mainframe or module to another It is an SMB connector for ECL levels and must be terminated in 50 ohms at ea
234. tal LO a complex exponential at the desired center frequency As a result the frequency band of interest in the input signal is shifted to a complex signal centered around dc See Synchronizing changes in multi module systems on page 39 for special considerations with respect to changing the center frequency in multi module systems The default filter for E1439 measurements is an analog anti alias filter However you may further isolate the frequency band of interest for more detailed analysis by using digital filtering A decimating digital filter simultaneously decreases the bandwidth of the signal and decreases the sample rate The built in digital filters conform to the Nyquist sampling criterion which guarantees that the output sample rate may be reduced by the same factor as the signal bandwidth reduction while still maintaining a complete representation of the underlying bandlimited signal For each octave step in bandwidth reduction except for the first octave the E1439 digital filters automatically reduce the data rate by discarding alternate output samples This process called decimation results in an output sample rate that is nominally four times the signal bandwidth whenever sigBw gt 0 This is still double the theoretical rate necessary to fully characterize the band limited signal However because the digital filters do not have a perfectly abrupt cutoff the sample rate cannot be reduced to the theoretical limit without som
235. tatus register bits This function returns the current measurement status which is represented by one of the four following values that are encoded in the bottom two bits of the status register Status Bit Definition Values 0 1 AGE1439 STATUS MEAS ARM WAIT AGE1439 NO DATA WAITING FOR ARM AGE1439 STATUS MEAS IDLE AGE1439 NO DATA MEASUREMENT PAUSED AGE1439 STATUS MEAS IN PROGRESS AGE1439 NO DATA MEASUREMENT IN PROGRESS AGE1439 STATUS MEAS TRIG WAIT AGE1439 NO DATA WAITING FOR TRIGGER Parameters is the VXI instrument session pointer returned by the age1439 init function returns the state of the 1439 STATUS READ VALID status register bit returns the state of the AGEI439 STATUS BLOCK READY status register bit returns the state of the 1439 STATUS OVERLOAD status register bit Return Value The return value of this function is the current measurement status as represented by one of four numeric values that are encoded in the bottom two bits of the status register shown in the table above See Also age1439 meas control on page 151 age1439 meas init on page 154 1439 status get on page 176 age1439 read on page 159 measurement loop in chapter 3 156 id options Note Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 options get Identifies module options VXIplug amp play Syntax include age1439 h ViStatus age1439 options get ViSession id
236. te precautions when removing handling and installing to avoid damage MP015 mpoos ge wea Dns 2 2 gt 7 MP017 2227 2 Mpoo 7 021 Ge if jj MP012 9 2 Mp022 amp 016 013 79 1 017 S dd MP013 222 Agilent Part Replacing Assemblies Replaceable parts Ref Des Number Qty Description MfrCode Part Number E1439 69201 1 E1439A EXCHANGE MODULE 28480 E1439 69201 E1439 69211 1 E1439B EXCHANGE MODULE 28480 E1439 69211 E1439 69202 1 1439 EXCHANGE MODULE 28480 E1439 69202 E1439 69212 1 E1439D EXCHANGE MODULE 28480 E1439 69212 M1 1818 7889 1 SYNC DIMM 16MB 2X72 66MHZ 16 M mem 16044 KTM66X72 16 M2 1818 7901 2 SYNC DIMM 16MX72 PC100 168 DIMM 128Mmem 16044 KGM100X72C3 128 M2 1818 8606 2 SYNC DIMM 16MX72 100 168 DIMM 512Mmem 16044 KVR100X72C3 512 001 1439 00203 1 SHTF BOTTOM COVER 28480 E1439 00203 003 0515 1135 5 SCREW MACH 3 x 0 5 25MM LG 05610 0515 1135 004 E1438 40601 1 GSKT RFI FRT PNL 28480 E1438 40601 005 E1485 40601 2 GSKT RFI BTTM CVR 28480 E1485 40601 006 8160 0686 2 RFI STRIP FINGERS 03647 00786 185 007 8160 0634 0 4 RFI STRIP FINGERS 03647 0097 0611 008 1439 00234 1 FRONT PANEL E1439A 28480 E1439 00234 008 1439 00244 1 FRONT PANEL 1439 28480 E1439 00244 008 E1439 00235 1 FRONT PANEL 1439 28480 E1439 00235 008 1439 00245 1 FRONT PANEL E1439D 284
237. th to eliminate undesirable frequency components which appear under the alias of another baseband frequency For more information see Spectrum and Network Measurements available through your Agilent Technologies Sales Office A band in the frequency spectrum that begins at zero In contrast a zoomed band is centered on a specific center frequency A mode in which the Agilent E1439 stops taking data as soon as a block of data has been collected The number of sample points in a block of data For complex data block size is the number of complex data pairs per data block A fiber frame that acts as a synchronizing event A mode in which the Agilent E1439 collects data continuously It does not stop taking data unless the FIFO overflows A fiber frame that contains 0 to 512 32 bit data words A digital filter that simultaneously decreases the bandwidth of the signal and decreases the sample rate The digital filter provides alias protection and increases frequency resolution For more information see Spectrum and Network Measurements available through your Agilent Technologies Sales Office A fiber frame that contains the last 4 data bytes in an epoch One or more data frame followed by an EOE A series of 32 bit values that can either be data or an ordered set A First In First Out buffer and controller used to transmit data Front panel data port Local oscillator Voltage controlled crystal oscillator Selects a frequency
238. the LO frequency is synchronously updated and the measurement continues In continuous mode you should ensure that all modules in the same state either the Idle state or the Measure state before using age1439 meas control to assert Sync Otherwise some modules re arm while others continue the current measurement In block mode the sync assertion is ignored unless all modules are in the Idle state The age1439 meas control function assures that a single module is in a valid state by checking that the hardware complete and sync valid bits in the status register are both true In synchronous multi module systems you should use the age1439 wait function for each module to assure a valid state in non master modules within a synchronous group In the case of systems made up of multiple mainframes you must be aware that only modules in the mainframe containing the master module as defined by age1439 clock setup may assert sync Any sync asserted in other mainframes is ignored by modules in all mainframes This is true only for rear panel sync Front panel sync is not sensitive to master mainframe designation 152 Agilent E1439 Programmer s Reference Functions listed alphabetically Example The program multichan exe described in the example programs provides an example of how to correctly set up a multi module measurement using age1439 meas control to initiate state transitions Return Value AGEI1439 SUCCESS indicates that a function wa
239. the current value of fp Clock Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Commands which halt active measurements on page 198 Default values on page 201 agel439 init on page 132 1439 clock setup on page 78 Using clock and sync in chapter 3 131 idQuery resetInstr rsrcName Agilent E1439 Programmer s Reference Functions listed alphabetically age1439 init Initializes the I O driver for a module VXIplug amp play Syntax include age1439 h ViStatus age1439 init ViRsrc rsrcName ViBoolean idQuery ViBoolean resetInstr ViPSession id Description 1439 init must be the first routine called when you use the Agilent E1439 library It establishes communication with the module and returns a module identification which is used with all subsequent functions involving this module This function performs whatever initialization the I O driver needs for the environment in which this library is running Parameters is a pointer to the VXI instrument Session identifier returned by this function for the module This identifier is then used with all other functions which address this module This value is not a VISA id and so cannot be used with VISA functions Use age1439 attr
240. the output FIFO The continuous mode is useful for continuous signal processing applications where data gaps are unacceptable points to the current value of the mode parameter determines which output port is used to take data from the Agilent E1439 module Setting port to AGE1439_VME means the data is to be output using standard VME register reads This is the instrument default Setting port to AGE1439_LBUS means the data is to be output as a byte serial data stream via the VXI local bus Agilent E1439D only When using the local bus port the module immediately to the right of the Agilent E1439 must be capable of receiving the local bus byte sequence Setting port to AGE1439_FIBER means the filtered ADC data is to be transmitted as a serial data stream over the fiber interface points to the current value of the port parameter selects data resolution of either 12 or 24 bits by using resolution values of AGE1439_12BIT or AGE1439_24BIT respectively Choosing 12 bit precision allows for more samples in the FIFO memory Choosing 24 bits allows more dynamic range Because of the broadband white noise present on the input of the analog to digital converter it is normally sufficient to use 12 bit resolution whenever the age1439_filter_setup function specifies a signal bandwidth greater than 10 MHz For narrower bandwidths much of the broadband white noise is filtered out resulting in lower noise in the output data To take advantage of this lo
241. the power up state VXIplug amp play Syntax include age1439 h ViStatus age1439 reset hard ViSession id Description agel1439 reset hard resets the module s firmware and hardware including the processor Parameters is the VXI instrument session pointer returned by the age1439 init function Comments The reset values are listed in Default values on page 201 In addition the hardware registers including the save register are reset to the power up state This command takes about 15 seconds to complete Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Commands which halt active measurements on page 198 1439 init on page 132 1439 reset on page 167 168 id driverRev instrRev Note Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_revision_query Returns strings that identify the date of the firmware revision VXIplug amp play Syntax include age1439 h ViStatus age1439 revision query ViSession id ViChar driverRev ViChar instrRev Parameters is the VXI instrument session pointer returned by the age1439 init function returns the date and time of the module s driver revision in the form a dd dd OPERS Ddd
242. the source of the sync signal agel1439 sync direction on page 179 selects front or rear panel availability of the sync signal agel1439 sync direction get on page 179 gets the state of front or rear panel clock availability agel1439 sync output on page 180 selects the output for the sync signal agel1439 sync output get on page 180 gets the output for the sync signal agel1439 trigger adclevel on page 183 specifies the threshold for the ADC trigger age1439 trigger adclevel get on page 183 gets the trigger threshold agel1439 trigger delay on page 183 specifies a pre or post trigger delay time agel1439 trigger delay actual get on page 181 gets the actual delay time from the Agilent E1439 Programmer s Reference Functions listed alphabetically most recent trigger event age1439_trigger_delay_get on page 183 gets the trigger delay time age1439_trigger_gen on page 183 determines whether a module can generate a trigger agel439 trigger gen get on page 183 gets the trigger generation status agel439 trigger magdwell on page 183 specifies the dwell time in samples before magnitude trigger agel439 trigger magdwell get on page 183 gets the magnitude trigger dwell time in samples agel439 trigger maglevel on page 183 specifies the threshold for a magnitude trigger agel439 trigger maglevel get on page 183 gets magnitude trigger threshold agel439 trigger phase actual ge
243. ting point value Complex data is made up of two 32 bit floating point values comprising the real and imaginary values for age1439_read64 sampleCount is the number of real or complex data values to read Real data is one 64 bit floating point value Complex data is made up of two 64 bit floating point values comprising the real and imaginary values This should never be set larger than the blocksize parameter set in the age1439_data_blocksize function In continuous data collection mode sampleCount should be set equal to blocksize to ensure that the entire data block is read out returns an overload indicator The way to properly use the overload argument for the age1439_ read or age1439_read64 function is this 1 Set up the hardware 2 age1439_meas_start 3 Call 1439 or 1439 464 If data is not available the read function returns immediately with one of the following return values and the overload indication is AGE1439_OFF 1439 NO DATA MEASUREMENT IN PROGRESS AGE1439 NO DATA MEASUREMENT PAUSED 1439 NO DATA WAITING FOR TRIGGER 1439 NO DATA WAITING FOR ARM When data is available AGE1439 SUCCESS is returned and the overload value reflects whether an overload was encountered for the given data block 4 In continuous mode subsequent data blocks can be read by calling age1439 read age1439_read64 function again age1439 meas start should not be called again 5 When u
244. tion or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also 1439 init on page 132 1439 fiber signal get on page 115 age1439 status get on page 176 110 Note piol pio2 Note dir nrdy Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_fiber_rcv_signals_get Returns the current value of the PIO1 PIO2 DIR or NRDY bits present on the fiber receiver VXIplug amp play Syntax include age1439 h ViStatus age1439 fiber rcv signals get ViSession id ViPInt16 pio ViPInt16 pio2 ViPInt16 dir ViPInt16 nrdy Description These are embedded Serial FPDP signals The use of these bits is optional Serial FPDP does not use these four signals directly but simply transmits them from sender to receiver This function displays the value of recovered PIO2 DIR and NRDY bits on the fiber receiver This function will return AGE1439 FIBER ERROR when a signal is present but the fiber receiver is not synced to the signal e g when the wrong interface speed has been selected The function will also return this error if it is selected and no signal is present Parameter is the VXI instrument session pointer returned by the age1439 init function Programmable I O bit on the fiber receiver for user defined purposes Programmable I O bit on the fiber receiver for user defined purposes
245. tiple modules Sharing Reference and Sync signals in multi module systems The Agilent E1439 supports synchronous operation among multiple E1439s by using a shared ADC clock and Sync signal to drive all the modules in a system The shared Sync signal is used to synchronize critical operations including arming triggering the beginning of data collection setting a common phase of the local oscillators for zoom operation and forcing concurrent output sample times when decimation is used The Sync line transitions are constrained to not occur during the critical setup and hold regions of the external reference The reference operates at 1 38 of the internal ADC clock typically 95 MHz for a E1439 module The reference can be either generated within the master module or an external reference can be fed into the master module through a front panel BNC For optimal phase noise performance in multi module systems it is recommended that the first channel be an Agilent E1439C or D The Agilent E1439C does not support local bus or fiber optic transfers Multi module systems may include multiple Agilent E1438s or Agilent E1439s but not a mixture of the two types of modules Clock distribution When shared the reference clock and sync lines are distributed among modules either on the VXI backplane using the ECL Trigger lines or on the front panel using the SMB Clock Ref extender connectors When VXI backplane distribution is used with more than one VXI
246. to be returned for each sample 1439 COMPLEX causes the real data followed by the imaginary data to be returned in each sample Normally if the center frequency set with the age1439 frequency setup function is zero the type should be set to AGE1439 REAL since the imaginary component of each sample is zero anyway When non zero center frequencies are used the type should normally be set to AGE1439 COMPLEYX otherwise the imaginary component of the signal is lost 91 dataTypePtr mode modePtr port portPtr resolution resolutionPtr Agilent E1439 Programmer s Reference Functions listed alphabetically when dataType is set to AGE1439_REAL and there is a non zero center frequency the data scale value is doubled for consistent spectrum measurements points to the current value of the dataType parameter selects whether the Agilent E1439 s data collection operates in block mode or continuous mode AGE1439_BLOCK selects block transfer mode in which the measurement is halted after each block of data To start collection of the next data block the module must be armed and triggered again This mode is used whenever each block of data is to be associated with an individual trigger event AGE1439_CONTINUOUS means that a single arm and trigger event starts a measurement which runs continuously with no gaps between output data blocks The measurement continues as long as the data is read out fast enough to prevent overflow in
247. to received flow control signals GO and STOP and transmits GO AGE1439_FLOW_CONTROL_COPY responds to received flow control signals GO and STOP and transmits the received flow control signal values AGE1439_FLOW_CONTROL_OFF disables fiber flow control points to the current value of flowControlMode sets both the transmitter and receiver raw data rates 1439 106MBS transfers data at the legacy data rate of 106 Mbytes per second This is the default setting 1439 250MBS transfers data at 250 Mbytes per second This is fast enough to support continuous transmission of data at the highest sample rates and bit depths points to the current value of transferRate Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Default values on page 201 1439 init on page 132 age1439 error message on page 102 114 id fiberSignalPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_fiber_signal_get Returns a value indicating whether or not an optical signal is detected by the optical fiber interface receiver VXIplug amp play Syntax include age1439 h ViStatus age1439_fiber_signal_get ViSession id ViPInt16 fiberSignalPtr Parameters is the VXI i
248. uccessful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to age1439 error message on page 102 See Also 1439 init on page 132 age1439 input setup on page 141 age1439 input offset on page 135 136 Note Note sec Agilent E1439 Programmer s Reference Functions listed alphabetically agel439 input range auto Performs auto ranging VXIplug amp play Syntax include age1439 h ViStatus age1439 input range auto ViSession id ViReal64 sec Description agel439 input range auto sets the range of a Agilent E1439 to the lowest value that does not cause an ADC overload to occur The algorithm starts at the lowest range and moves up until there is no ADC overload The baseband signalPath cannot be auto ranged because it has only one range 21 dBm Calling this function deletes any saved state and halts any measurement or fiber transfer Parameters is the VXI instrument session pointer returned by the age1439 init function is the time in seconds to take data at each range to insure that an overload is detected Setting this parameter to 0 0 results in the time being set automatically according to an algorithm that depends on block size and filter bandwidth 1439 RANGE TIME MIN selects the minimum autorange time 1439 RANGE TIME selects the maximum autorange time Return Val
249. ue AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also Commands which halt active measurements on page 198 1439 init on page 132 agel439 input setup on page 141 137 range rangeVoltsPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_input_range_convert Converts the input range to volts VXIplug amp p lay Syntax include age1439 h ViStatus age1439 input range convert ViSession id Vilnt16 range ViPReal64 rangeVoltsPtr Description agel439 input range convert converts the range of a Agilent E1439 Parameters is the VXI instrument session pointer returned by the age1439 init function is the input range returned by age1439 input range get is the range in Volts Conversion values are as follows 138 Variable Range Index AGE1439 RANGE 48 AGE1439 RANGE 48 48 12 1 26 AGE1439 RANGE 47 47 Ti 1 12 AGE1439 RANGE 46 46 10 1 AGE1439 RANGE 45 45 9 891 AGE1439 RANGE 44 44 8 194 AGE1439 RANGE 43 43 7 708 AGE1439 RANGE 42 42 6 631 AGE1439 RANGE 41 41 5 562 AGE1439 RANGE 40 40 4 501 AGE1439 RANGE 39 39 3 447 AGE1439 RANGE 38 38 2 398 AGE1439 RANGE 37 37 1 355 AGE1439 RANGE 36 36 0 316 AGE1439 RANGE 35 35 4 2
250. uested block size falls outside the range shown in the table the previous valid value is used and a status register flag bit 6 is set indicating a setup error The blocksize is updated after the setup is changed to be valid For real data blocksize is the number of real data values per data block For complex data blocksize is the number of complex data pairs per data block The following table summarizes the available block sizes for each setting of the dataType and resolution parameters max block size datatype resolution block size in Msamples 2 72 memory real 12 6 12 real 24 3 6 complex 12 3 6 complex 24 2 3 1 Parity memory is used in non parity mode so 2 72 bit memory yields 18 Mbytes of FIFO storage Block size must be an even number Considerably more samples may need to be taken in order to set the block available status bit points to the current value of the blocksize parameter The returned value is the closest valid value to the requested block size is used to specify the minimum FIFO delay in number of samples This parameter applies only in continuous mode 1439 DATA DELAY MAXsets the maximum allowable delay 1439 DATA DELAY MIN sets the minimum allowable delay points to the current value of the delay parameter determines whether the Agilent E1439 collects and returns real or complex data Setting this parameter to AGEI439 REAL causes only the real part of the data
251. um ViStatus age1439 serial number get ViSession id ViChar serialNum ViStatus age1439 smb clock output ViSession id Vilnt16 smbClock ViStatus age1439 smb clock output get ViSession id ViPInt16 smbclockPtr ViStatus age1439 state recall ViSession id ViStatus age1439 state save ViSession id ViStatus age1439 status get ViSession id ViPInt16 statusPtr ViStatus age1439 sync clock ViSession id Vilnt16 syncClock ViStatus age1439 sync clock get ViSession id ViPInt16 syncClockPtr ViStatus age1439 sync direction ViSession id Vilnt16 syncDirection ViStatus age1439 sync direction get ViSession id ViPInt16 syncDirectionPtr ViStatus age1439 sync output ViSession id Vilnt16 syncOutput ViStatus age1439 sync output get ViSession id ViPInt16 syncOutputPtr ViStatus age1439 trigger adclevel ViSession id Vilnt16 adcLevel ViStatus age1439 trigger adclevel get ViSession id ViPInt16 adcLevelPtr ViStatus age1439 trigger delay ViSession id ViInt32 trigDelay ViStatus age1439 trigger delay actual get ViSession id ViPInt32 actualDelayPtr ViStatus age1439 trigger delay get ViSession id ViPint32 trigDelayPtr ViStatus age1439 trigger gen ViSession id Vilnt16 generate ViStatus age1439 trigger gen get ViSession id ViPInt16 generatePtr ViStatus age1439 trigger magdwell ViSession id Vilnt32 magDwell ViStatus age1439 trigger magdwell get ViSession id ViPInt32 magDwellPtr ViStatus age1439 trigger maglevel ViSession id Viln
252. ut on page 131 age1439 vxi clock output on page 188 agel439 reference prescaler on page 166 Using clock and sync in chapter 3 165 Note id refPrescaler refPrescalerPtr Agilent E1439 Programmer s Reference Functions listed alphabetically age1439_reference_prescaler Selects prescaling of the reference clock This description also includes the query function age1439_reference_prescaler_get VXIplug amp play Syntax include age1439 h ViStatus age1439 reference prescaler ViSession id ViInt16 refPrescaler ViStatus age1439 reference prescaler get ViSession id ViPInt16 refPrescalerPtr This command should be used only for specialized custom clock requirements Most useful clock setups can be supplied by age1439 clock setup Description This function should generally be left in the default mode The alternate mode applies to a different model of the module Parameters is the VXI instrument session pointer returned by the age1439 init function 1439 PRESCALE BY 1 divides the reference clock by one 1439 PRESCALE BY 4 divides the reference clock by four Returns a pointer to the current value of refPrescalerPtr Return Value AGEI1439 SUCCESS indicates that a function was successful Values other than AGE1439 SUCCESS indicate an error condition or other important status condition To determine the error message pass the return value to 1439 error message on page 102 See Also
253. vel Vilnt16 magLevel Vilnt16 slope Vilnt16 genTrig ViInt32 magDwell ViStatus age1439 trigger adclevel ViSession id Vilnt16 adcLevel ViStatus age1439 trigger adclevel get ViSession id ViPInt16 adcLevelPtr ViStatus age1439 trigger delay ViSession id ViInt32 trigDelay ViStatus age1439 trigger delay get ViSession id ViPint32 trigDelayPtr ViStatus age1439 trigger gen ViSession id ViInt16 genTrig ViStatus age1439 trigger gen get ViSession id ViPInt16 genTrigPtr ViStatus age1439 trigger magdwell ViSession id Vilnt32 magDwell ViStatus age1439 trigger magdwell get ViSession id ViPInt32 magDwellPtr ViStatus age1439 trigger maglevel ViSession id Vilnt16 magLevel ViStatus age1439 trigger maglevel get ViSession id ViPInt16 magLevelPtr ViStatus age1439 trigger slope ViSession id ViInt16 slope ViStatus age1439 trigger slope get ViSession id ViPInt16 slopePtr ViStatus age1439 trigger type ViSession id Vilnt16 trigType ViStatus age1439 trigger type get ViSession id ViPInt16 trigTypePtr Description An Agilent E1439 can be triggered to collect data in a variety of ways The trigger can be internally generated or can come from an external source Multiple modules can be triggered synchronously A variable pre and post trigger delay can be programmed for data collection The slope and level of the trigger point on a signal can be selected The source of the internal trigger can be either the output of the ADC or the magnitud
254. wer noise you should use the 24 bit data resolution points to the current value of the resolution parameter Comments The following table summarizes the output word or byte sequence for each combination of dataType resolution and port parameters 92 data type real complex real complex real complex real complex data resolution 12 bit 12 bit 24 bit 24 bit 12 bit 12 bit 24 bit 24 bit port VME VME VME VME LBUS LBUS LBUS LBUS Agilent E1439 Programmer s Reference Functions listed alphabetically transfer width 16 bit 16 bit 16 bit 16 bit 8 bit 8 bit 8 bit 8 bit xfers 1 Sequence Ro 11 0 24 2 R1 11 0 24 Ro 11 0 24 05111 0 24 R4 TI 0 24 01111 0 24 Ro23 8 Ro7 0 78 R 23 8 R4 7 0 28 0123 8 Rol7 0 78 00123 8 0017 0 78 R 23 8 R 7 0 78 Rol 1 4 Rol3 0 74 R4 11 4 R4 3 0 24 Rol 11 4 013 0 74 05111 4 0013 0 74 R I3 0 24 Rol23 16 Rol15 8 Rol7 0 78 R 23 16 R 15 8 Rol23 16 0115 8 Ro7 0 28 00 23 16 Q9 15 8 017 0 78 23 16 R 15 8 93 Note n a 1 0 Agilent E1439 Programmer s Reference Functions listed alphabetically data data type resolution real 12 bit complex 12 bit real 24 bit complex 24 bit port Fiber Fiber Fiber Fiber transfer
255. width xfers 32 bit 1 2 32 bit 1 32 bit 1 32 bit 2 sequence Ro11 0 Z4 Ri TI 0 74 Ro 11 0 Z4 120 24 Rol 11 0 24 04111 01 74 R4 11 0 74 04111 01 74 0123 0 78 R23 0 78 Rol23 0 78 00123 0 78 R 23 0 78 1 That is transfers required per measurement A fraction indicates multi ple samples per transfer 2 Sequence Notation R real number transfer Q imaginary number transfer 74 4 zero pad bits Z8 8 zero pad bits in the LSBs Subscript denotes the sample number Bracketed indices show which sample bits are contained in the transfer MSB first A vertical bar denotes bit wise concatenation Exam ple For a 12 bit sample sent to the LBUS R0 11 4 indicates the 8 MSBs of the sample are transferred in the first byte Then R0 3 0 Z4 indicates the 4 LSBs of the sample are padded with 4 zero bits and transferred in the second byte The maximum rate at which data may be transferred to memory is determined by the ADC clock rate MaxBytes s 1 5 x ADC clock rate Divide MaxBytes s by 1 5 to get the 12 bit sample rate and by 3 to get the 24 bit sample rate A limitation also applies to 32 bit complex data transfers Because this type of transfer cannot be made at the full sample rate a level of decimation must be added in order to reduce the sample rate The following table summarizes the relationship between data parameter combinations decimation filter b

Download Pdf Manuals

image

Related Search

Related Contents

Ouvr8es d`8r1 - Direction des structures  ROSA - ROSETTA BII  User Manual  User Manual  Weatherables GKPR-SQLAT-6X44.5 Instructions / Assembly  お手入れ こんなときは 使いかた  LibraPlus 5845  28-178 MANUAL DEL PROPIETARIO – Favor de  Notice horloge à LED  取扱説明書 DW01 DW02  

Copyright © All rights reserved.
Failed to retrieve file