Agilent E1438 VXI 100 MSa/s ADC with filters and memory User’s Guide Agilent Technologies Part Number E1438-90010 Printed in U.S.A. Print Date: December 2002, Fifth 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 this 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 are set forth in FAR 52.227- 19(c)(1,2). Copyright © 2000-2002 Agilent Technologies, Inc. 2 The Agilent E1438 at a Glance The Agilent E1438 100 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 a VXI mainframe. E1438/ E1439 Number of Channels 1 Type of Inputs 50 ohm Input Bandwidth 150 MHz, 40 MHz alias protected Sample Rate 100/102.4 Msample/second Input Range −21 to +30 dBm Raw ADC resolution 12 bits VXI Bus Support VME (and Local Bus E1438D only) VXI Device Type Register based I/O Data Port (E1438D only) Fiber optic serial FPDP (front panel data port) Size C-sized, single slot 3 What You Get With the Agilent E1438 The following items are included with your Agilent E1438: Hardware • Agilent E1438 ADC, C-size VXI module • CD-ROM for Windows setup Software • CD-ROM for installation A Windows setup program that installs: • Firmware installation program • The Agilent E1438 VXIplug&play libraries and drivers • Soft Front Panel program for the Agilent E1438 with source files • Web-based help for the Agilent E1438 • 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 • Agilent E1438 Installation and Service Guide • Online documentation available after software installation: • Agilent E1438 User’s Guide in PDF format (this document) • Web-based help files providing operational information and programmer’s reference • WinHelp files for the Agilent E1438 Soft Front Panel 4 In This Book This book documents the Agilent E1438 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. 5 6 Contents 1 Installing the Agilent E1438 ToinspecttheAgilentE1438...................................2 To install the Agilent E1438....................................3 To clean fiber optic connectors .................................6 Tostorethemodule..........................................7 Totransportthemodule.......................................7 2 Getting Started with the Agilent E1438 Getting Started and Introduction ...............................10 SystemRequirements........................................11 To install the Windows VXIplug&play drivers....................12 TousetheResourceManager.................................13 To use the program group (Windows) ...........................14 To use the VXIplug&play SoftFrontPanel(SFP)..................15 Tousetheexampleprograms..................................16 3 Using the Agilent E1438 Agilent E1438 overview......................................20 Programming the Agilent E1438 ...............................21 Themeasurementloop.......................................23 Delayandphaseintriggeredmeasurements......................25 Magnitude trigger and magdwell time ...........................28 Frequencyandfiltering.......................................30 Usingclockandsync........................................31 Managing multiple modules...................................32 Transferringdata...........................................42 FiberOpticInterface.........................................43 4 Agilent E1438 Programmer's Reference Introduction ...............................................54 Functionslistedbyclass......................................55 Functionslistedbyfunctionalgroup............................60 Functionslistedalphabetically.................................67 age1438_adc_clock . .......................................72 age1438_adc_divider . .......................................73 age1438_attrib_get . .......................................74 Contents age1438_cal_get ............................................75 age1438_clock_fs ...........................................76 age1438_clock_recover . ...................................77 age1438_clock_setup ........................................78 age1438_close .............................................86 age1438_combo_setup .......................................87 age1438_data_memsize_get...................................88 age1438_data_scale_get . ...................................89 age1438_data_setup .........................................90 age1438_data_xfersize .......................................96 age1438_driver_debug_level ..................................97 age1438_epoch_setup........................................98 age1438_error_message . ..................................102 age1438_error_query .......................................103 age1438_ext_sample_sync . ..................................104 age1438_fiber_clear ........................................106 age1438_fiber_error_clear . ..................................107 age1438_fiber_error_get . ..................................108 age1438_fiber_LED_get . ..................................110 age1438_fiber_rcv_signals_get ...............................111 age1438_fiber_setup........................................112 age1438_fiber_signal_get. ..................................115 age1438_fiber_verify .......................................116 age1438_fiber_xmt_BOF . ..................................117 age1438_fiber_xmt_signals ..................................118 age1438_fiber_xmt_signals_get...............................119 age1438_filter_setup .......................................120 age1438_filter_sync ........................................123 age1438_frequency_center_raw...............................125 age1438_frequency_center_raw_compute .......................127 age1438_frequency_setup . ..................................128 age1438_front_panel_clock_input .............................131 age1438_init ..............................................132 age1438_input_autozero. ..................................134 age1438_input_offset .......................................135 age1438_input_offset_save ..................................136 age1438_input_range_auto. ..................................137 age1438_input_range_convert ................................138 age1438_input_setup .......................................141 age1438_interrupt_restore . ..................................144 age1438_interrupt_setup . ..................................145 age1438_lbus_mode ........................................147 age1438_lbus_reset ........................................149 age1438_meas_control ......................................150 age1438_meas_init .........................................153 age1438_meas_start ........................................154 age1438_meas_status_get . ..................................155 age1438_options_get .......................................156 8 Contents age1438_product_id_get ....................................157 age1438_read .............................................158 age1438_read_raw . ......................................161 age1438_reference_clock ....................................164 age1438_reference_prescaler .................................165 age1438_reset .............................................166 age1438_reset_hard