Agilent Technologies DP111 User Manual

SER MANUAL

GILENT ACQIRIS

BIT DIGITIZERS

For Use with DP and DC Series Digitizers

Models covered:

DP105 / DP106 / DP110 / DP111 / DP210 / DP211 / DP212

DP214 / DP235 / DP240 / DP1400 / DC110 / DC135 / DC140

DC211 / DC211A / / DC241 / DC241A / DC271 / DC271A / DC271AR

DC240 / DC265 / DC270

U1061A / U1063A / U1064A / U1067A / U1068A / U1069A / U1071A

U1091A

Manual Part Number

U1092-90001

Edition

I-RevE, February 2009

The information in this document is subject to change without notice and may not be construed in any way as a commitment by Agilent Technologies, Inc. While Agilent makes every effort to ensure the accuracy and contents of the document it assumes no responsibility for any errors that may appear.

All software described in the document is furnished under license. The software may only be used and copied in accordance with the terms of license. Instrumentation firmware is thoroughly tested and thought to be functional but it is supplied “as is” with no warranty for specified performance. No responsibility is assumed for the use or the reliability of software, firmware or any equipment that is not supplied by Agilent or its affiliated companies.

You can download the latest version of this manual from http://www.agilent.com/ by clicking on Manuals in the Technical Support section and then entering a model number. You can also visit our web site at

http://www.agilent.com/find/acqiris. At Agilent we appreciate and encourage customer input. If you have a

suggestion related to the content of this manual or the presentation of information, please contact your local Agilent Acqiris product line representative or the dedicated Agilent Acqiris Technical Support

(ACQIRIS_SUPPORT@agilent.com).

Acqiris Product Line Information

USA (800) 829-4444

Asia - Pacific 61 3 9210 2890

Europe 41 (22) 884 32 90

Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.

Windows® is a U.S. registered trademark of Microsoft Corporation.

MATLAB® is a registered trademark of The MathWorks, Inc.

User Manual: Agilent Acqiris 8-bit Digitizers Page 2 of 59

CONTENTS

1. OUT OF THE BOX........................................................................................................................... 6

1.1. Message to the User ..................................................................................................................... 6

1.2. Using this Manual ........................................................................................................................ 6

1.3. Conventions Used in This Manual ............................................................................................... 6

1.4. Model Names ............................................................................................................................... 7

1.5. Disclaimer and Safety .................................................................................................................. 7

1.6. Warning Regarding Medical Use ................................................................................................. 7

1.7. Packaging and Handling............................................................................................................... 8

1.8. Warranty....................................................................................................................................... 8

1.9. Warranty and Repair Return Procedure, Assistance and Support ................................................ 8

1.10. System Requirements................................................................................................................... 9

1.11. Transport & Shipping................................................................................................................... 9

1.12. Maintenance ............................................................................................................................... 10

1.13. Cleaning ..................................................................................................................................... 10

1.14. Disposal and Recycling.............................................................................................................. 10

2. INSTALLATION ............................................................................................................................ 11

2.1. U1091AK02 IC414 Installation ................................................................................................. 11

2.1.1. IC414 Hardware installation hints.................................................................................. 11

2.1.2. IC414 Windows software installation ............................................................................ 11

2.2. Installing the Software under Windows ..................................................................................... 12

2.2.1. Warnings ........................................................................................................................ 12

2.2.2. Multiple Versions........................................................................................................... 12

2.2.3. Installation...................................................................................................................... 12

2.3. Installing the Software for Linux ............................................................................................... 13

2.3.1. Installing with a tar file .................................................................................................. 13

2.3.2. Installing with a distribution specific package ............................................................... 13

2.3.3. Installing the Linux device driver .................................................................................. 14

2.3.4. Loading the kernel module............................................................................................. 15

2.3.5. Creating the device driver node...................................................................................... 15

2.3.6. Firmware files and Environment variables..................................................................... 15

2.4. Installing the Hardware .............................................................................................................. 16

2.5. After Restarting .......................................................................................................................... 16

2.5.1. Windows 2000 ............................................................................................................... 16

2.5.2. Windows XP .................................................................................................................. 17

2.6. LabVIEW RT ............................................................................................................................. 17

2.7. Installing the IVI-COM/C Driver............................................................................................... 18

2.8. Distribution for Windows 2000/XP and Linux .......................................................................... 18

3. PRODUCT DESCRIPTION........................................................................................................... 19

3.1. Overview .................................................................................................................................... 19

3.2. Channel Input ............................................................................................................................. 20

3.2.1. Coupling......................................................................................................................... 20

3.2.2. Impedance ...................................................................................................................... 20

3.2.3. Input Protection.............................................................................................................. 20

3.2.4. Mezzanine Front-end...................................................................................................... 20

3.2.5. Bandwidth and Rise Time.............................................................................................. 20

3.2.6. Input Voltage and Offset ................................................................................................ 23

3.2.7. Vertical Resolution......................................................................................................... 23

3.2.8. DC Accuracy and Linearity............................................................................................ 23

3.2.9. Using Probes .................................................................................................................. 23

3.3. Data Acquisition......................................................................................................................... 23

3.3.1. Sampling Rate ................................................................................................................ 24

3.3.2. Acquisition Memory ...................................................................................................... 25

3.3.3. Single and Sequence Acquisition Modes ....................................................................... 25

3.3.4. U1071A-FAMILY Simultaneous multibuffer Acquisition and Readout (SAR) ............ 25

3.3.5. Timing............................................................................................................................ 26

3.3.6. Timebase Range............................................................................................................. 26

User Manual: Agilent Acqiris 8-bit Digitizers Page 3 of 59

3.3.7. Combining channels....................................................................................................... 26

3.4. Trigger ........................................................................................................................................ 26

3.4.1. Trigger Source................................................................................................................ 26

3.4.2. Trigger Coupling............................................................................................................ 27

3.4.3. Trigger Level.................................................................................................................. 27

3.4.4. Edge Trigger Slope......................................................................................................... 27

3.4.5. Window Trigger ............................................................................................................. 27

3.4.6. HF Trigger...................................................................................................................... 27

3.4.7. Spike Stretcher ............................................................................................................... 27

3.4.8. U1071A-FAMILY Multi-source Trigger ....................................................................... 27

3.4.9. Pre- and Post-Trigger Delay........................................................................................... 28

3.4.10. Trigger Status................................................................................................................. 28

3.5. External Clock and Reference.................................................................................................... 28

3.6. Internal Calibration .................................................................................................................... 29

3.7. AS bus ........................................................................................................................................ 29

3.8. Special Front Panel Input and Output (U1071A-FAMILY & DC271-FAMILY)...................... 30

3.9. External Trigger Output (U1071A-FAMILY & DC271-FAMILY) .......................................... 30

3.10. Frequency Counter mode ........................................................................................................... 31

3.11. Electrical, Environmental and Physical Specifications .............................................................. 31

3.11.1. Electrical ........................................................................................................................ 31

3.11.2. Environmental and Physical........................................................................................... 32

4. RUNNING THE ACQIRISLIVE APPLICATION...................................................................... 33

4.1. Getting Started with AcqirisLive................................................................................................ 33

4.2. Control Panel and Functions ...................................................................................................... 34

4.2.1. Control Panel Mode ....................................................................................................... 34

4.2.2. Displaying Multiple Traces............................................................................................ 35

4.2.3. Numeric Editor............................................................................................................... 36

4.2.4. Keyboard shortcuts......................................................................................................... 36

4.2.5. Input Voltage Scale, Offset and Coupling...................................................................... 36

4.2.6. Trigger............................................................................................................................ 37

4.2.7. Acquisition Mode........................................................................................................... 38

4.2.8. Timebase and Memory................................................................................................... 38

4.2.9. Using digitizers of different models simultaneously...................................................... 39

4.2.10. Segmented Memory ....................................................................................................... 39

4.2.11. Display Features, Zoom and Persistence........................................................................ 39

4.3. Top Line Menu of AcqirisLive................................................................................................... 40

4.4. Setup........................................................................................................................................... 40

4.5. Store, Autostore and Conversion of Waveforms........................................................................ 40

4.6. Calibrate ..................................................................................................................................... 42

4.7. Combine channels ...................................................................................................................... 42

4.8. External 10 MHz Reference and External Clock ....................................................................... 42

4.9. Very Long Memory Autostore ................................................................................................... 42

4.10. Additional Waveform Information............................................................................................. 42

4.11. Display Features......................................................................................................................... 43

4.12. Command Line Switches............................................................................................................ 43

5. RUNNING THE GEOGRAPHIC MAPPER APPLICATION ................................................... 46

5.1. Who needs a Geographical Map of Modules ............................................................................. 46

5.2. When should the Geographic Mapper Application be used ....................................................... 46

5.3. How to run Geographic Mapper................................................................................................. 46

User Manual: Agilent Acqiris 8-bit Digitizers Page 4 of 59

6. APPENDIX A: U1093A (U1056A) AS BUS FOR COMPACTPCI/PXI DIGITIZERS............ 49

7. APPENDIX B: U1093A-AS6 (U1056A-A06) AS BUS 2 FOR PCI DIGITIZERS..................... 50

8. APPENDIX C: -BB1 BATTERY BACKUP FOR COMPACTPCI DIGITIZERS................... 51

9. APPENDIX D: U1092A-HVB XA100 BNC INPUT OVERVOLTAGE PROTECTION......... 53

10. APPENDIX E: U1091AX01 XP100 FAN UNIT FOR DP1XX/DP2XX UNITS......................... 54

11. APPENDIX F: XP101 FAN UNIT FOR DP DIGITIZERS (OBSOLETE)................................ 55

12. APPENDIX G: U1091AX03 XP103 FAN UNIT FOR THE DPXXX MODULES.....................56

13. APPENDIX H: U1091AX05 XP104 FAN UNIT FOR U1071A-FAMILY.................................. 57

14. APPENDIX I: U1071A-XP5 XP105 FAN UNIT FOR U1071A-FAMILY.................................. 59

User Manual: Agilent Acqiris 8-bit Digitizers Page 5 of 59

1. Out of the Box

1.1. Message to the User

Congratulations on having purchased an Agilent Technologies Acqiris data conversion product. Acqiris digitizers are high-speed data acquisition modules designed for capturing high frequency electronic signals. To get the most out of the products we recommend that you read this manual carefully. We trust the product you have purchased will meet with your expectations and provide you with a high quality solution to your data conversion applications.

1.2. Using this Manual

This guide assumes you are familiar with the operation of a personal computer (PC) running a Windows 2000/XP or other supported operating system. It also assumes you have a basic understanding of the principles of data acquisition using either a waveform digitizer or a digital oscilloscope.

The manual is divided into 5 separate sections. To understand the elements of operation for the module it is essential that you read them all.

Chapter

For information necessary for writing your own software to control Acqiris products you should refer to the

Programmer’s Guide and the Programmer’s Reference Manual.

1 OUT OF THE BOX, describes what to do when you first receive your new Acqiris product.

Special attention should be paid to sections on safety, packaging and product handling. Before installing your product please ensure that your system configuration matches or exceeds the requirements specified.

2 INSTALLATION, covers all elements of installation and performance verification. Before

attempting to use your Acqiris product for actual measurements we strongly recommend that you read all sections of this chapter.

3 PRODUCT DESCRIPTION, provides a full description of all the functional elements of the

digitizer.

4 RUNNING THE ACQIRISLIVE APPLICATION, describes the operation of AcqirisLive 3.3, an

application that enables basic operation of Acqiris digitizers in a Windows 2000/XP environment.

Note: AcqirisMAQS is an alternate software application offering many interesting possibilities for

the control of acquisition systems in a single or multi-machine environment. Ask your sales representative or Agilent for more information.

5 RUNNING THE GEOGRAPHIC MAPPER APPLICATION, describes the purpose and operation

of the Geographic Mapper application which is needed for some AS bus Multi-instrument systems.

1.3. Conventions Used in This Manual

The following conventions are used in this manual:

This icon to the left of text warns that an important point must be observed.

WARNING Denotes a warning, which advises you of precautions to take to avoid being electrically shocked. CAUTION Denotes a caution, which advises you of precautions to take to avoid electrical, mechanical, or

operational damages.

NOTE Denotes a note, which alerts you to important information. Italic text denotes a warning, caution, or note. Bold Italic text is used to emphasize an important point in the text or a note

mono text is used for sections of code, programming examples and operating system commands.

B,KB,MB,GB is for Byte, KiloByte = 1024 bytes, MegaByte = 1024*1024 bytes, GigaByte = 1024*1024*1024

bytes

Certain features are common to several different modules. For increased readability we have defined the following families:

DC271-FAMILY U1061A/U1064A/U1069A DC135/DC135HZ/DC140/DC140HZ/DC211/

DC211A/DC241/DC241A/DC271/DC271A/ DC271AR/DP214/DP235/DP240

U1071A-FAMILY all U1071A variants, DP1400, U1091AD28

User Manual: Agilent Acqiris 8-bit Digitizers Page 6 of 59

1.4. Model Names

Agilent Technologies Inc. acquired Acqiris SA and its product lines in December 2006. Use the tables below to cross reference new Agilent numbers with options to the legacy model name. The legacy model name is what is used in the Acqiris applications and the API.

Agilent Model Number Acqiris Model Name Agilent Model Number Acqiris Model Name U1061A-001-F50 DC135 U1091A DC110

U1061A-001-FHZ DC13HZ U1061A-001-F50 DC135 U1061A-002-F50 DC140 U1061A-001-FHZ DC135HZ U1061A-002-FHZ DC140HZ U1061A-002-F50 DC140 U1063A-001 DC265 U1061A-002-FHZ DC140HZ U1063A-002 DC270 U1064A-001-F50 DC211 U1064A-001-F50 DC211 U1064A-001-FHZ DC211A U1064A-001-FHZ DC211A U1064A-002-F50 DC241 U1064A-002-F50 DC241 U1064A-002-FHZ DC241A U1064A-002-FHZ DC241A U1063A-001 DC265 U1064A-004-F50 DC271 U1063A-002 DC270 U1064A-004-FHZ DC271A U1064A-004-F50 DC271 U1067A DP110 U1064A-004-FHZ DC271A U1067A DP105 U1067A DP105 U1068A DP210 U1091A DP106 U1068A DP211 U1067A DP110 U1069A DP240 U1068A DP210 U1069A DP235 U1068A DP211 U1069A DP214 U1091A DP212 U1071A-001-F50 DP1400 U1069A DP214 U1071A-001-FHZ U1071AHZ1 U1069A DP235 U1071A-002-F50 U1071A002 U1069A DP240 U1071A-002-FHZ U1071AHZ2 U1071A DP1400 U1071A-004-F50 U1071A004 U1071A-002-F50 U1071A002 U1071A-004-FHZ U1071AHZ4 U1071A-004-F50 U1071A004 U1091A DC110 U1071A-001-FHZ U1071AHZ1 U1091A DP106 U1071A-002-FHZ U1071AHZ2 U1091A DP212 U1071A-004-FHZ U1071AHZ4

1.5. Disclaimer and Safety

The DP Series PCI digitizer cards have been designed to operate in a standard PCI slot found inside most personal computers. The model DC Series CompactPCI/PXI digitizers have been designed to operate inside a CompactPCI/PXI crate. The crate provides the modules with all needed power. Agilent does not recommend operation of the DC Series modules outside of a CompactPCI/PXI crate.

CAUTION: Do not exceed the maximum input voltage rating! The maximum input voltage for 50

impedance is for the DC2x1A/AR models where it is

5 V. The maximum input for 1 MΩ input impedance is ±100 V (dc + ac) except

300 V (dc + ac) .

input

1.6. Warning Regarding Medical Use

The Digitizer cards are not designed with components and testing procedures that would ensure a level of reliability suitable for use in treatment and diagnosis of humans. Applications of these cards involving medical or clinical treatment can create a potential for accidental injury caused by product failure, or by errors on the part of the user.

These cards are not intended to be a substitute for any form of established process or equipment used to monitor or

safeguard human health and safety in medical treatment.

WARNING: The modules discussed in this manual have not been designed for making direct measurements

on the human body. Users who connect an Acqiris module to a human body do so at their own risk.

User Manual: Agilent Acqiris 8-bit Digitizers Page 7 of 59

1.7. Packaging and Handling

Your Digitizer is shipped with the following components:

• A compact disc in an Agilent Technologies paper CD envelope that includes o 10 product User Manuals in electronic form (8-bit Digitizers, 10-bit Digitizers, 12-bit Digitizers,

Averagers, Analyzers, Signal Analyzers, Streamer Analyzers, Time-to-Digital Converters, 3-, 5-, and 8-slot CompactPCI Crates, and the 21-slot CompactPCI Crate),

o 1 Programmer’s Guide and 1 Programmer’s Reference Manual, o device drivers with sample software for different operating systems, environments and languages, o the Analyzer Demo application, a demonstration program for the AC/SC Analyzer products, o the AcqirisLive application, a demonstration program for our digitizer and averager products, o the SSR Demo application, a demonstration program for the Acqiris AP235/AP240 Analyzers, o the APX01 Demo application, a demonstration program for the Acqiris AP101/AP201 Analyzers, o the TC Demo application, a demonstration program for the Acqiris TC840/TC842/TC890 Time-to-

Digital Converters,

o full installation procedures for use with Microsoft Windows, National Instruments LabVIEW RT,

Wind River VxWorks, IVI-COM/C, and Linux software.

• For many products a declaration of conformity is still included. However, in an increasing number of cases

the Declaration can be viewed at

http://www.agilent-pra.com.

• Optional documentation such as a model-dependent document giving Specifications & Characteristics, a

Calibration Certificate, or a Performance Verification

After carefully unpacking all items, inspect each to ensure there are no signs of visible damage. Also check that all the components received match those listed on the enclosed packing list. Agilent cannot accept responsibility for missing items unless we are notified promptly of any discrepancies. If any items are found to be missing or are received in a damaged condition please contact the Agilent service center or your local supplier immediately. Retain the box and packing materials for possible inspection and/or reshipment.

1.8. Warranty

All Agilent Acqiris Digitizer products are warranted to operate within specification, assuming normal use, for a period of at least one year from the date of shipment. Units sold before April 2008 had three year warranties, as do some more recent ones; in case of doubt examine your invoice. It is recommended that yearly calibration be made in order to verify product performance. All repairs, replacement and spare parts are warranted for a period of 3 months. Warranty extensions are available as an option.

Agilent endeavors to provide leading edge technology that includes the latest concepts in hardware and software design. As such software and firmware used with the products is under continual refinement and improvement. All software and instrument firmware is supplied “as is” with no warranty of any kind. Software and firmware is thoroughly tested and thought to be functional at the time of shipment. At Agilent’s discretion software and firmware may be revised if a significant operational malfunction is detected.

In exercising this warranty, Agilent will repair or replace any product returned to the Agilent service center, within the warranty period. The warranty covers all defects that are a result of workmanship or materials. This excludes defects that are caused by accident, misuse, neglect, or abnormal operation.

The purchaser is responsible for returning the goods to the nearest Agilent service center. This includes transportation costs and insurance. Agilent will return all warranty repairs with transportation prepaid.

1.9. Warranty and Repair Return Procedure, Assistance and Support

Agilent acquired Acqiris SA and its product lines in December 2006. Please contact your nearest Agilent Service Center before returning any product for repair.

You can find information about technical and professional services, product support, and equipment repair and service on the Web, see

country click on Contact Us). The service center will ask for your name, company, phone number and address, the

model and serial numbers of the unit to be repaired, and a brief description of the problem.

User Manual: Agilent Acqiris 8-bit Digitizers Page 8 of 59

http://www.agilent.com/find/service (or http://www.agilent.com/ and after selecting your

Before issuing a Service Order the service center may ask you to communicate with us by phone or eMail so that we can learn as much as needed about the problems observed. If a unit returned under guarantee is found to be working normally and this procedure was not followed we reserve the right to charge you for the work done.

For your nearest customer support center please contact Acqiris Technical Support

(ACQIRIS_SUPPORT@agilent.com) or come visit our web site at

Alternatively, contact Acqiris at 1-800-829-4444 in the USA, +41 22 884 32 90 in Europe or +61 3 9210 2890 in the Asia-Pacific region. The Agilent Support Centers can also help redirect you for any questions concerning the installation and operation of your equipment.

1.10. System Requirements

Acqiris products need the following minimum PC System Requirements in order to obtain reasonable performance from your digitizer

Processor: 150 MHz Pentium (higher recommended). Some PowerPC systems running Wind River VxWorks are

supported; please contact us for details.

Memory: 64 MB RAM. The previous number is a very rough estimate. Assuming that you are using AcqirisLive or

an application of your own that operates on the acquired data it seems reasonable to ask for 10 times the total acquisition memory that you will be using at the same time in the application. Performance is likely to be degraded if less memory is available.

Display resolution: At least 800 x 600 pixels and 256 colors for use of AcqirisLive or Demo applications. Operating System: Microsoft Windows 2000/XP including 2003 Server, Wind River VxWorks 5.5.1 and 6.4, and

Linux with kernels 2.4 and 2.6. Support for Windows 95/98 is no longer available. Although this operating system is no longer supported by Microsoft, Windows NT4 users can download AcqirisSoftware 3.1 from the Agilent WEB site.

http://www.agilent.com/find/acqiris.

Hard Drive Space: 20 MB Minimum CD Drive (or any method to copy the software installation files from CD to the hard drive such as LAN, floppy

drive, etc.)

LabVIEW: Full driver implementations are available for National Instruments LabVIEW versions 8.5, 8.2.1, and

8.0. LabVIEW 7.1 is frozen at the level of Acqiris Software 3.2 with support for all instruments.

LabVIEW RT: National Instruments LabVIEW RT is supported for the same versions as shown above. The VISA

driver must be version 3.0 or higher.

MATLAB: The MEX interface can be used with MathWorks MATLAB 7.3 or a newer version. Visual BASIC: The interface files and examples are available for Microsoft Visual Basic .NET and Version 6. Tornado: The example files are useable with Wind River Tornado 2.2.1

1.11. Transport & Shipping

CAUTION: Cards can be safely transported in their original shipping packages. DC cards can be transported

when properly mounted in a CompactPCI crate. The transport of DP cards mounted in a PC is a more delicate issue. Because of their mass the cards can vibrate loose unless they are properly secured and braced. DP cards held only in the front and on the bottom should not be shipped in their PC. However, properly mounted DP cards with XP103 or XP105 fans can be sufficiently well held; the Adjustable retainer must be used so as to hold the card in place.

To package the instrument for shipping:

Step Notes

1. Place the instrument in its original packaging materials.

2. Surround the instrument with at least 3 to 4 inches (8

to 10 cm) of its original packing material or bubble-pack to prevent the instrument from moving in its shipping container.

User Manual: Agilent Acqiris 8-bit Digitizers Page 9 of 59

• If the original packaging materials are not available,

use a professional packaging service. Contact your

Agilent Service Center for more information.

3. After wrapping it with packing material, place the

instrument in its original shipping container or a strong shipping container that is made of double-walled corrugated cardboard with 159 kg (350 lb) bursting

strength.

4. Seal the shipping container securely with strong nylon adhesive tape.

5. Mark the shipping container “FRAGILE, HANDLE WITH CARE” to help ensure careful handling.

6. Use the address obtained from your Agilent Service Center.

7. Retain copies of all shipping papers.

CAUTION: Damage can result if the original packaging materials are not used. Packaging materials should be

anti-static and cushion the instrument on all sides. NEVER USE STYRENE PELLETS IN ANY SHAPE AS PACKAGING MATERIALS. They do not adequately cushion the instrument or prevent it from moving in the shipping container. Styrene pellets can also cause equipment damage by generating static electricity or by lodging in fan motors.

• The shipping container must be large and strong

enough to accommodate your instrument and allow at least 3 to 4 inches (8 to 10 cm) on all sides for packing

material.

1.12. Maintenance

The cards do not require any maintenance. There are no user serviceable parts inside. A periodic calibration can be obtained on request.

1.13. Cleaning

Cleaning procedures consist only of exterior cleaning.

Clean the exterior surfaces of the module with a dry lint-free cloth or a soft-bristle brush. If any dirt remains, wipe with a cloth moistened in a mild soap solution. Remove any soap residue by wiping with a cloth moistened with clear water. Do not use abrasive compounds on any parts.

1.14. Disposal and Recycling

Electronic equipment should be properly disposed of. Acqiris digitizers and their accessories must not be thrown out as normal waste. Separate collection is appropriate and may be required by law.

User Manual: Agilent Acqiris 8-bit Digitizers Page 10 of 59

2. Installation

This chapter describes how to install the Acqiris hardware and software for Windows 2000/XP, National Instruments LabVIEW RT, Linux, or Wind River VxWorks.

NOTE:

For a first time installation we strongly recommend installing the software before inserting the

hardware into the PC.

2.1. U1091AK02 IC414 Installation

NOTE: If you are going to install an IC414 interface for the first time and are running Windows 2000/XP you should follow the procedure below before installing the Acqiris hardware.

2.1.1. IC414 Hardware installation hints

The PCI-8570/PXI-8570 User's Manual (Rev. 1.00) section 2.5 gives Hardware Installation instructions.

CAUTION: Turn off the power of the PC; the PC may have to be unplugged to ensure that the PCI bus has no

power available. Please ignore the PCI-8570 instruction to leave the power cord plugged in; Ground

the chassis differently!

CAUTION: Touch the antistatic package to a grounded object before removing the card from the package.

Electrostatic discharge can damage the card.

The standard cable pair provided each have a red connector on one end and a black connector on the other. Therefore the correct connection can be made by plugging the Red connector into the L0Rx socket and the Black connector into the L0Tx socket on the PXI module and the other Red connector into the PCI module socket furthest from the PCI card internal base connector and the Black connector into the next socket.

If you intend to use 64-bit 66 MHz transfer to maximize data transfer speed you should cable a “bundled link” using two standard cable pairs and both the L0 and L1 pairs of connectors. You should also make sure that you configure the PXI-8570 M66EN Jumper correctly.

2.1.2. IC414 Windows software installation

Linux users do not need to read any further since there is no special software installation.

Windows users should have the hardware installed as noted above. This software installation should be done before any Acqiris modules are placed in the CompactPCI crates. This may mean that you have to remove the module from

the crate as delivered.

The crate should be turned on first followed by the PC. If the cabling and start-up sequence is done correctly there will be no LED illuminated on the PCI unit connected pair and the LED's of the PXI connected pair will be lit.

For Windows XP installation, Select the Control Panel under Settings in the Start menu. Then, if you are using the

Category View select Printers and Other Hardware. After this, for both Category and Classic views, go to System and then display the Hardware tab to get access to the Driver Signing menu. Since neither the AdLink nor

the Acqiris driver has been submitted for Windows Logo testing you must select either the Ignore or Warn action.

The resulting menu looks as shown:

User Manual: Agilent Acqiris 8-bit Digitizers Page 11 of 59

The PCI-8570/PXI-8570 User's Manual (Rev. 1.00) section 2.4 contains the software installation instructions. These should be executed before allowing the hardware installation process to look for the driver. If you have an AdLink CD Version 2004A4 or later you can use it; if not you should download the latest driver from the WEB site

http://www.adlinktech.com/). You can then continue with the Hardware Installation. A reboot will then be

( necessary. At this point the Stargen Fabric PCI Adapter and the Stargen Aruba Fabric-to-PCI Bridge should appear correctly installed under System Devices in the Device Manager.

NOTE: If you have an AdLink CD Version 2005A3 or later you can find 8570install.exe in the folder X:\Driver

Installation\PXI Platform\PXI Extension\PCI_PXI-8570\Wnt2kxp and the starfab1.inf file in the folder X:\Driver Installation\PXI Platform\PXI Extension\PCI_PXI-8570\Win98.

2.2. Installing the Software under Windows

2.2.1. Warnings

If Setup detects a previous installation of Acqiris software on your system, a warning screen will be displayed. It is recommended to exit Setup and uninstall older versions.

The installer from software releases prior to Acqiris Software 2.0 installed the Digitizer Driver DLL files into the

System directory. These will be removed by Setup. If you wish to keep the old installation on your system, you should exit Setup, and move all Acqiris driver files (acqiris*, acqrs* and acqir*) to some archive directory.

The DLL files will be installed into the bin subdirectory of the Acqiris software root, and the corresponding path will be added to the PATH environment variable.

2.2.2. Multiple Versions

With the software installation from Acqiris Software 2.0 (or above), it is possible to keep multiple versions on the

same system, but you must specify a different root directory (i.e. Install Folder). If you keep the same directory, Setup will overwrite your previous installation.

To go back to a previous version, you must change the PATH environment variable and reinstall the Kernel driver. Under Windows 2000/XP:

1. Copy the SYS file from <old_AcqirisSoftware_root>\bin\kernel to the

Windows\System32\drivers directory.

2. Change the AcqirisDxRoot, AcqirisDxDir and PATH environment variables to the old root.

3. Reboot the computer.

2.2.3. Installation

Before installing the Acqiris hardware, you should complete the following steps to install the software for Windows 2000/XP.

NOTE: You will need administrator privileges to complete the software installation under Windows 2000/XP.

1. Insert the Acqiris Software CD into the CD-ROM drive of your computer. If the Autorun program does not start

automatically (Autoplay disabled), you can start it manually, or navigate to the AcqirisSoftware\Windows folder

in order to display the files included.

2. Choose Install AcqirisSoftware for Windows 2000/XP/2003 Server (or run Setup.exe from the

AcqirisSoftware\Windows folder). After several seconds for initialization the first of many screens will appear.

Please note the following points:

 It is good practice to remove any previously installed version of Acqiris software. If the program finds that

there is still Acqiris software installed on your machine a warning panel will appear.

 In the Select Install Ty pe window selecting Custom installation will let you select individual packages for

loading. The space indicated for LabVIEW, Firmware and UserManual packages is incorrect. The correct values are 7 MB, 40 MB, and 30 MB respectively. A full installation requires just under 150 MB of disk.

User Manual: Agilent Acqiris 8-bit Digitizers Page 12 of 59

 If MATLAB is installed on your machine, you will be asked to point the installer to the MATLAB root

directory. You should do this if you want the installer to modify the standard startup.m file to add the paths for the MEX interface.

 In the Installation Folder window you will give the name of the root directory of the Acqiris software

installation. If User Manuals (30 MB) and Firmware (40 MB) are loaded more space than indicated here will be required on the drive. For the case of a Tornado 2.2 installation the folder name should not contain any spaces.

 AcqirisLive needs the LabWindows/CVI 8.0 Run-Time Engine to run. If Setup has detected that a

LabWindows/CVI Run-Time Engine is already installed on your system, it will ask you if you would like to install it locally for AcqirisLive anyway. If you are not sure about the version of the CVI Run-Time Engine on your system, it is recommended to install it locally.

 The Installation Summary window will be shown to allow you to check what you have asked for. At this

point it is not too late to go back and make changes. The actual installation will only be started after clicking on “Install” in the next window.

 Please read the IMPORTANT Information window text. It could help you avoid serious problems.  Registration of your installation will help Agilent provide you with better support. You will also be notified

of updates and upgrades. All information submitted will be treated in accordance with Agilent’s privacy policy. Setup will prepare a registration e-mail in your e-mail client application upon termination of the setup procedure. You can then decide whether or not you wish to send it. You may also add comments. Uncheck the box if you do not want to register your installation.

 After the software installation is complete you can either accept the suggestion to restart the computer or

you should shutdown your computer and proceed with the hardware installation.

2.3. Installing the Software for Linux

The Acqiris software is ready to install on Linux systems running kernels 2.4 and 2.6; package files are now available for some popular distributions. If you are using Debian, Ubuntu, Fedora, CentOS, or openSUSE, you can install the software using a standard package: see section

2.3.2 Installing with a distribution specific package.

2.3.1. Installing with a tar file

The following archives all contain the driver and library compiled with the gcc version shown:

AcqirisLinux-3.3a-gcc-3.4.tar.gz - compiled under CentOS 4.7 with GNU gcc 3.4. AcqirisLinux-3.3a-gcc-4.1.tar.gz - compiled under Debian ‘etch’ 4.0 with GNU gcc 4.1.

The appropriate tar file should be copied to a local directory (e.g. your home directory) and then unpacked by using the following command

tar xzf AcqirisLinux-3.3a-gcc-X.x.tar.gz

The resulting directory AcqirisLinux contains an install script drv-install and a graphical Demo program demo/AcqirisDemo. Before running the software you have to install the acqrsPCI device driver into the running

kernel

2.3.2. Installing with a distribution specific package

The distribution specific package files are located in directories named after the distribution name and version. Packages are available for the following variants:

 Debian, 4.0, 5.0 - the distribution used for the development of Acqiris software.

Debian-4.0/agilent-acqirisdriver_3.3a-1_i386.deb

Debian-5.0/agilent-acqirisdriver_3.3a-1_i386.deb

 Ubuntu, 8.04, 8.10 - this is the most popular and easy-to-use distribution, based on Debian.

Ubuntu-8.04/agilent-acqirisdriver_3.3a-1_i386.deb

Ubuntu-8.10/agilent-acqirisdriver_3.3a-1_i386.deb

 Fedora, 10 - another popular innovative distribution, test bed for RedHat Linux.

Fedora-10/agilent-acqirisdriver-3.3a-1.i386.rpm

User Manual: Agilent Acqiris 8-bit Digitizers Page 13 of 59

 CentOS, 4.7, 5.2 - this distribution is a rebranded build of RedHat Enterprise Linux.

CentOS-4.7/agilent-acqirisdriver-3.3a-1.i386.rpm

CentOS-5.2/agilent-acqirisdriver-3.3a-1.i386.rpm

 openSUSE, 11 - this distribution is the base system for Novell SUSE Linux.

openSUSE-11/agilent-acqirisdriver-3.3a-1.i586.rpm

More information on these distributions is available on the following web-site:

All these packages contain a version of the software Acqiris 3.3a release for Linux with full support of recent Acqiris products.

A deb package should be installed by the root user with the following command: dpkg -i agilent-acqirisdriver_3.3a-1_i386.deb

An rpm package should be installed by the root user with the following command: rpm -ivh agilent-acqirisdriver-3.3a-1.i386.rpm

Before being able the run the software, you have to install the acqrsPCI device driver into your running kernel as described in the next section.

http://distrowatch.com/dwres.php?resource=major

2.3.3. Installing the Linux device driver

The acqrsPCI device driver is a loadable kernel module. It is provided as source files.

Compiling the kernel module

All files needed to compile a new kernel mode driver are in src/agilent/acqiris/kernel26module/ for Linux kernels 2.6, or src/agilent/acqiris/kernel24module/ for Linux kernels 2.4.

To compile the driver, the header files of the Linux kernel need to be installed. Furthermore, depending on the Linux distribution, the kernel source files may need to be installed too.

For Debian users, in order to compile the kernel module on a system, the kernel packages that match the current kernel-image must be installed. For instance, on a Debian ‘etch’ 4.0 system 686 the required packages are:

linux-image-2.6-686 linux-image-2.6.18-4-686 linux-headers-2.6-686 linux-headers-2.6.18-4 linux-headers-2.6.18-4-686 linux-kbuild-2.6.18

The makefile will try to guess where the kernel headers are located. If it fails, see instructions inside the makefile itself to specify manually where these kernel header files are located.

To compile a new kernel module, use the following commands:

cd kernel26module (or kernel24module) make clean all to generate a new kernel module from scratch make install to copy the kernel module where it should reside (this last command requires super user privileges).

In the end, the loadable kernel module should be present in the system's loadable kernel modules directory. You can verify it is present by running:

ls -l /lib/modules/$(uname -r)/extra/acqrsPCI.ko

Note that this version of the loadable kernel module had been tested on Linux kernel versions up to 2.6.27. However, starting with kernel 2.6.17, a few kernel functions relating to the device classes are no longer available to proprietary

User Manual: Agilent Acqiris 8-bit Digitizers Page 14 of 59

modules (such as this one). As such, automatic creation of the /dev/acqrsPCI node has to be done manually in the

/etc/rc.local file (see Creating the device driver node in

2.3.4. Loading the kernel module

Once the device driver is installed into its kernel module directory, it has to be loaded into the kernel. First update the kernel modules dependencies:

/sbin/depmod -a

Then load the kernel module: /sbin/modprobe -v acqrsPCI

You can add the command above to your /etc/rc.local file. It is run at system startup and will load the acqrsPCI kernel module automatically when your computer is restarted.

You can check that the device driver is loaded properly with lsmod. /sbin/lsmod | grep acqrsPCI

If lsmod does not report a module named acqrsPCI, then the kernel module is not loaded into the kernel. Check any error messages that may have been issued by the commands you have run, and contact Agilent Acqiris technical support.

2.3.5. Creating the device driver node

Check that a device node has been created.

ls -l /dev/acqrsPCI

If the device node /dev/acqrsPCI is present on your system, the Acqiris Software is ready to be used. Otherwise, continue reading this section.

For systems using udev (the dynamic /dev/ hierarchy) or running kernels above 2.6.17, the device driver node may not be created automatically. You can do it with mknod by running the following command:

/sbin/mknod -m 666 /dev/acqrsPCI c 124 0

You can check that the device node has been created with ls:

ls -l /dev/acqrsPCI

You can add the mknod command to your /etc/rc.local file. It is run at system startup and will create the /dev/acqrsPCI device node automatically when your computer is restarted.

Note that the permissions that are set in this example (-m 666) give access to the Acqiris instruments to all users. This may not be what you expect and these permissions can be adjusted to fit your requirements. The base rule is that any user that wants to use the Acqiris instruments have to get read and write access to /dev/acqrsPCI.

2.3.4 Loading the kernel module).

2.3.6. Firmware files and Environment variables

If you intend to use Averagers, Analyzers, Time to Digital converters, or 12-bit digitizers you must install the Firmware .bit files. You can either copy them from the Firmware directory of the CD-ROM or download them from our WEB site. They should be placed in the Firmware subdirectory of AcqirisLinux. In the case of the CD-ROM, this can be done by continuing the above command sequence with the following:

cp /mnt/CDRom/Firmware/*.bit Firmware/

If you need to keep multiple versions of the Firmware, please continue reading this section.

Automatic loading of the firmware needed by some modules relies on the environment variable AcqirisDxDir pointing to the directory containing the file AqDrv4.ini which in turn points to the directory containing the Firmware .bit files. Therefore, assuming that your Firmware is in /usr/local/AcqirisLinux/Firmware and that AqDrv4.ini is in /usr/local/AcqirisLinux/demo then you must edit AqDrv4.ini so that it contains the line

fpgaPath=/usr/local/AcqirisLinux/Firmware

Then, if your shell is csh or tcsh modify the .login file to contain the line

User Manual: Agilent Acqiris 8-bit Digitizers Page 15 of 59

setenv AcqirisDxDir /usr/local/AcqirisLinux/demo

or, if your shell is bash, ksh, zsh or sh, modify the .profile file to contain the lines

AcqirisDxDir=/usr/local/AcqirisLinux/demo export AcqirisDxDir

2.4. Installing the Hardware

1. Turn off the power of the PC and the crate in the case of a CompactPCI module.

CAUTION: For PCI modules the PC m ay have to be unplugged to ensure that the PCI bus has no power

available. However, CompactPCI crates can be left plugged in since this ensures proper grounding.

CAUTION: Touch the a ntistatic package to a grounded object before removing the card from the package.

Electrostatic discharge can damage the card.

Module in a PC: open the PC, identify a free PCI slot and carefully insert the DP Series card into it. Be sure to ground yourself by touching the grounded PC frame and avoid touching any components on the DP Series card. Make sure that the grounding of the card’s mounting bracket to the back panel rail of the computer is done correctly. If present make sure that the fan's adjustable retainer is correctly positioned and tightened for mechanical support. Close the PC.

Module in a CompactPCI crate: Follow the instructions of the crate manufacturer to insert the DC Series card into a free CompactPCI peripheral slot. Be sure to ground yourself by touching the grounded crate and avoid touching any components on the DC Series card. Be sure to tighten both front panel mounting screws to lock the module into place and insure proper grounding of the frame.

NOTE: To ensure the best possible performance, users of Acqiris CC121 Crates with AS bus systems should respect the module placement rules to be found in the Agilent Acqiris 21-slot Co mpactPCI Crate User Manual.

PCI Bus extension module in a PC: Consult the manufacturer's documentation for any special instructions. Open the PC, identify a free PCI slot and carefully insert the card into it. Be sure to ground yourself by touching the grounded PC frame and avoid touching any components on the card. Make sure that the grounding of the card’s mounting bracket to the back panel rail of the computer is done correctly. Close the PC. Connect the module to the CompactPCI crate controller.

3. Turn on the power of the crate(s), if present, and then the PC and start the operating system.

NOTE: Acqiris digitizers are equipped with a LED. If this LED is not glowing orange or red when the p ower is applied there is a severe problem. Either the module is broken or the necessary voltages for its use are not available.

NOTE: For proper system operation when using the IC200, IC414, or other PCI extension in terface to connect a CC10X crate to a remote PC, the crate must be powered on before the PC in order for the PC BIOS to recognize the presence of the CompactPCI crate.

4. If devices were installed using a previous version of Acqiris software the instruments in these logical

positions may still appear as Unknown Devices. This can be changed to the new Acqiris type category with the Grey Diamond icon by Uninstalling the device and then Installing again. Instructions on this procedure can be found in the ReadMe.txt file in the manuals folder of your Acqiris software installation.

2.5. After Restarting

2.5.1. Windows 2000

Under Windows 2000, you must login with administrator privileges after the first boot following the hardware

installation; the Plug&Play system must have the appropriate privileges to be able to complete your hardware installation successfully. After a successful hardware installation, you will be able to use your Acqiris digitizer(s) with normal privileges.

At the first boot following the hardware installation, Windows will detect the new hardware and will install the devices automatically. The following image will appear.

User Manual: Agilent Acqiris 8-bit Digitizers Page 16 of 59

NOTE: In some systems an application program (such as AcqirisLive) will not yet work correctly at this point. One additional boot cycle may be needed if this is the first time that a hardware board is being installed.

2.5.2. Windows XP

Under Windows XP, you must login with administrator privileges after the first boot following the hardware

If you login with administrator privileges after the first boot following the hardware installation, Windows will detect the new hardware and start the “Found New Hardware Wizard” after a few seconds. There is no need to use Windows Update to search for the software. You can “Install the software automatically”. The final screen should appear as shown here:

2.6. LabVIEW RT

During program development you can choose whether you use LabVIEW or LabVIEW RT compatible libraries by

switching the version present in National Instruments\LabVIEW m.n\instr.lib\. This swap can be facilitated by using the Install VI library for LabVIEW or LabVIEW Real-Time shortcut available in the Shortcut folder under Start →

There is only one Acqiris Driver. It supports all Acqiris Instruments. The instructions below concern LabVIEW RT as used in NI PXI processors.

The Aq_RT.inf and AqRT_4.ini files must be uploaded to the target. To do this,

For Acqiris modules which need FPGA files you should,

Programs.

• start the MAX application,

• right click on the target

• select file transfer

• select the Aq_RT.inf file on your host machine and upload ('To Remote') to the LabVIEW RT working

directory (/NI-RT/system) on the target

• select the Aq_RT.ini file on your host machine and upload ('To Remote') to the LabVIEW RT working

directory (/NI-RT/system) giving it the name AqDrv4.ini

• create the folder \firmware in the /NI-RT/system directory using the file transfer application

• select the FPGA files (from <AcqirisDxRoot>\Firmware) you want to copy to the target and upload

them into the firmware directory

Restart the target after finishing the file transfers.

User Manual: Agilent Acqiris 8-bit Digitizers Page 17 of 59

Restart the MAX Explorer and you should have Acqiris digitizers detected in your PXI system.

2.7. Installing the IVI-COM/C Driver

Please install Acqiris software for Windows first. Then the Acqiris Software CD Autorun program gives access to

two installers:

 IVI Shared Components 1.4  IVI-COM/C IviAqD1 driver

These must be installed in the order shown above. For more information you can then consult the Readme.txt file in the IVI\Drivers\IviAqD1 folder or the documentation through the program shortcut present under Ivi/IviAqD1.

2.8. Distribution for Windows 2000/XP and Linux

The manuals/ReadMe.txt file contains a list of files to be found after a complete installation of Acqiris software on Windows systems. Similarly the ReadMeLinux file gives the list of files corresponding to that installation.

User Manual: Agilent Acqiris 8-bit Digitizers Page 18 of 59

+ 41 hidden pages