National Instruments VXI-AT2022 Getting Started
National Instruments VXI-AT2022 Getting Started

National Instruments VXI-AT2022 Getting Started

Ni-vxi software for sco unix
Table of Contents

Advertisement

Quick Links

Getting Started with Your
VXI-AT2022 and the NI-VXI
Software for SCO UNIX
bus
August 1993 Edition
Part Number 320262-01
© Copyright 1990, 1994 National Instruments Corporation.
All Rights Reserved.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the VXI-AT2022 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for National Instruments VXI-AT2022

  • Page 1 Getting Started with Your ™ VXI-AT2022 and the NI-VXI Software for SCO UNIX August 1993 Edition Part Number 320262-01 © Copyright 1990, 1994 National Instruments Corporation. All Rights Reserved.
  • Page 2 National Instruments Corporate Headquarters 6504 Bridge Point Parkway Austin, TX 78730-5039 (512) 794-0100 Technical support fax: (800) 328-2203 (512) 794-5678 Branch Offices: Australia (03) 879 9422, Austria (0662) 435986, Belgium 02/757.00.20, Canada (Ontario) (519) 622-9310, Canada (Québec) (514) 694-8521, Denmark 45 76 26 00, Finland (90) 527 2321, France (1) 48 14 24 24, Germany 089/741 31 30, Italy 02/48301892, Japan (03) 3788-1921, Netherlands 03480-33466, Norway 32-848400, Spain (91) 640 0085, Sweden 08-730 49 70, Switzerland 056/20 51 51, U.K.
  • Page 3 Any action against National Instruments must be brought within one year after the cause of action accrues. National Instruments shall not be liable for any delay in performance due to causes beyond its reasonable control. The warranty provided herein does not cover damages, defects, malfunctions, or service failures caused by owner's failure to follow the National Instruments installation, operation, or maintenance instructions;...
  • Page 4 Any use or application of National Instruments products for or involving medical or clinical treatment must be performed by properly trained and qualified medical personnel, and all traditional medical safeguards, equipment, and procedures that are appropriate in the particular situation to prevent serious injury or death should always continue to be used when National Instruments products are being used.
  • Page 5 Be sure that the equipment is plugged into a grounded outlet and that the grounding has not been defeated with a cheater plug. Notice to user: Changes or modifications not expressly approved by National Instruments could void the user’s authority to operate the equipment under the FCC Rules.
  • Page 6: Table Of Contents

    Installing the Software ....................3-3 Step 1. Set Up a Working Directory ..............3-3 Step 2. Install the Driver into the System ............3-4 Step 3. Change the Path for the Utility Files (Optional)........3-5 © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 7 VXIbus Non-Slot 0 Configuration..............2-17 Figure 2-10. Logical Address Selection ................2-19 Figure 2-11. VXI-MXI VMEbus Requester Jumper Settings..........2-20 Figure 2-12. MXIbus Single-Ended Cable Configuration ............2-22 Figure 2-13. MXIbus Dual-Ended Cable Configuration............2-23 VXI-AT2022/NI-VXI SCO UNIX Getting Started viii © National Instruments Corporation...
  • Page 8 Tables Table 2-1. AT-MXI Factory Default Settings and Optional Configurations.....2-3 Table 2-2. Possible Base I/O Address Settings for the AT-MXI........2-5 Table 3-1. Logical Address Configuration Characteristics..........3-7 Table 3-2. Bus Configuration Characteristics..............3-10 © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 9: About This Manual

    NI-VXI Software Reference Manual for C (part number 320307-01) and the NI-VXI Text Utilities Reference Manual (part number 320321-01). Organization of This Manual Getting Started with Your VXI-AT2022 and the NI-VXI Software for SCO UNIX is organized as follows: •...
  • Page 10: Conventions Used In This Manual

    NI-VXI functions. Study the descriptions of each function given in Chapters 3 through 13 to fully understand the purpose and syntax of each function. Refer to the NI-VXI Text Utilities Reference Manual to learn more about the victext and vxitedit programs. VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 11: Related Documentation

    IEEE Standard for a Versatile Backplane Bus: VMEbus, ANSI/IEEE Standard 1014-1987 Customer Communication National Instruments wants to receive your comments on our products and manuals. We are interested in the applications you develop using our products, and we want to help if you have problems with them.
  • Page 12: Introduction

    MXIbus cable. Refer to the Optional Equipment section on the following page. Make sure each of these items is in your kit. If any item is missing, contact National Instruments. © National Instruments Corporation...
  • Page 13: Optional Equipment

    MXIbus Terminating Pac (External) 180780-01 VXI-MXI Standard VXIbus Mainframe Extender Kit 776310-01 VXI-MXI Enhanced VXIbus Mainframe Extender Kit 776310-02 VME-MXI Standard VMEbus Chassis Extender Kit 776434-01 VME-MXI Enhanced VMEbus Chassis Extender Kit 776434-02 VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 14: Hardware Configuration And Installation

    Chapter 2 Hardware Configuration and Installation This chapter contains the instructions to configure and install the VXI-AT2022 interface kit. The instructions are given in the order that you should perform them. A summary of the steps is as follows: 1. Unpack the AT-MXI and VXI-MXI hardware.
  • Page 15: Step 2. Configure The At-Mxi Hardware

    Step 2. Configure the AT-MXI Hardware Figure 2-1 shows the location of the AT-MXI configuration jumpers and switches. Art not available in PDF version of document. Figure 2-1. AT-MXI Parts Locator Diagram VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 16: Switch And Jumper Settings

    I/O address space. If you change the base I/O address of the AT-MXI, you must make a corresponding change to the AT-MXI configuration software as described in the Configuring the NI-VXI Software section of Chapter 3 of this manual. © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 17: Figure 2-2. Base I/O Address Switch Settings

    Switch Set to Base I/O Address hex 100 Binary Hex ON=0 OFF=1 ON=0 OFF=1 OFF=1 b. Switch Set to Default Setting (Base I/O Address hex 340) Figure 2-2. Base I/O Address Switch Settings VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 18: Table 2-2. Possible Base I/O Address Settings For The At-Mxi

    1 0 1 1 1 2E0 - 2FF 1 1 0 0 0 300 - 31F 1 1 0 0 1 320 - 33F 1 1 0 1 0 340 (default) 340 - 35F (continues) © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 19: Interrupt Level Selection

    AT-MXI or the other devices. If you change an AT-MXI interrupt level, make a corresponding change to the AT-MXI configuration software as described in the Configuring the NI-VXI Software section of Chapter 3. VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 20: Figure 2-3. Board And Mxibus Interrupt Jumper Settings

    To change to another interrupt level, remove the appropriate jumper from its current position and place it on the new posts. Figure 2-3b shows the board interrupt level changed to IRQ5. © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 21: Dma Channel Selection

    DMA channel. As a result, DMA channel 3 can be used by other devices if you do not need to use slave-mode DMA with your AT-MXI. VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 22 PC AT bus for an alternate PC AT bus master cycle. It can use any available 8-bit or 16-bit channel regardless of the intended data width of the transfers. © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 23: Figure 2-4. Dma Channel Settings

    Remember to make a corresponding change in the system software to enable the new DMA channels. Figure 2-4b displays the jumper position for selecting master-mode DMA Channel 7 and slave-mode DMA Channel 0. VXI-AT2022/NI-VXI SCO UNIX Getting Started 2-10 © National Instruments Corporation...
  • Page 24: Step 3. Install The At-Mxi Hardware

    To protect both yourself and the computer from electrical hazards, the computer should remain off until you are finished installing the board. 2. Remove the top cover or access port to the PC AT I/O bus. © National Instruments Corporation 2-11 VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 25: Figure 2-5. At-Mxi Installed In A Computer

    Figure 2-5 shows an AT-MXI installed in a PC AT with a MXIbus cable attached. Art not available in PDF version of document. Figure 2-5. AT-MXI Installed in a Computer VXI-AT2022/NI-VXI SCO UNIX Getting Started 2-12 © National Instruments Corporation...
  • Page 26: Step 4. Configure The Vxi-Mxi Hardware

    VXI-MXI in the same mainframe. If this is the case, refer to the VXI-MXI User Manual that came with your additional VXI-MXI interface for more information. Art not available in PDF version of document. Figure 2-6. VXI-MXI Parts Locator Diagram © National Instruments Corporation 2-13 VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 27: Figure 2-7. Vxi-Mxi With Intx Parts Locator Diagram

    INTX option, refer to the VXI-MXI User Manual. Art not available in PDF version of document. Figure 2-7. VXI-MXI with INTX Parts Locator Diagram VXI-AT2022/NI-VXI SCO UNIX Getting Started 2-14 © National Instruments Corporation...
  • Page 28: Front Panel Features

    To configure the VXI-MXI as a Non-Slot 0 device, change slide switches S1 and S8 and jumper blocks W7 (labeled VME BTO Chain Position on the front panel), and W9 and W10 (labeled CLK10 Source Select on the front panel) as shown in Figure 2-9. © National Instruments Corporation 2-15 VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 29: Figure 2-8. Vxibus Slot 0 Configuration

    Chain Position -------------------------------------------------------------------------------------------------------------------- CLK10 Source Select Drive CLK10 from onboard 10MHz, Slot 0 Drive CLK10 from SMB CLK10, Slot 0 Receive CLK10, Non-Slot 0 Figure 2-8. VXIbus Slot 0 Configuration VXI-AT2022/NI-VXI SCO UNIX Getting Started 2-16 © National Instruments Corporation...
  • Page 30: Figure 2-9. Vxibus Non-Slot 0 Configuration

    Chain Position -------------------------------------------------------------------------------------------------------------------- CLK10 Source Select Drive CLK10 from onboard 10MHz, Slot 0 Drive CLK10 from SMB CLK10, Slot 0 Receive CLK10, Non-Slot 0 Figure 2-9. VXIbus Non-Slot 0 Configuration © National Instruments Corporation 2-17 VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 31: Vmebus Bto

    VXI-MXIs to the MXIbus. In this case, refer to the VXI-MXI User Manual that came with your additional VXI-MXIs for more information. You can change the logical address of the VXI-AT2022/NI-VXI SCO UNIX Getting Started 2-18 © National Instruments Corporation...
  • Page 32: Vmebus Request Level Selection

    Transfer Bus (DTB). The VXI-MXI requests use of the DTB whenever an external MXIbus device, such as a PC AT computer with an AT-MXI interface, attempts a transfer that maps into the VXIbus mainframe. © National Instruments Corporation 2-19 VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 33: Figure 2-11. Vxi-Mxi Vmebus Requester Jumper Settings

    • • • • • • • • • VMEbus Request Level VMEbus Request Level c. Level 1 Requester d. Level 0 Requester Figure 2-11. VXI-MXI VMEbus Requester Jumper Settings VXI-AT2022/NI-VXI SCO UNIX Getting Started 2-20 © National Instruments Corporation...
  • Page 34: Step 5. Install The Vxi-Mxi Hardware

    5. Tighten the retaining screws on the top and bottom edges of the front panel. 6. Check the installation. 7. Connect the cables as described in the following section before restoring power. 8. Replace or close any doors or covers to the mainframe. © National Instruments Corporation 2-21 VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 35: Step 6. Connect The Mxibus Cable

    There are two basic types of MXIbus cables. MXIbus cables can have either a single connector on each end, or a single connector on one cable end and a double connector on the other end. Your VXI-AT2022 kit comes standard with a cable with single connectors on each end. Nonpolarized Cables The cable with a single connector on each cable end is nonpolarized and may be installed with either end connected to either device.
  • Page 36: Polarized Cables

    Always turn on the mainframe first. Doing so makes it possible for the PC AT to access the VXI cards in the mainframe as soon as the PC AT starts up. © National Instruments Corporation 2-23 VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 37: Ni-Vxi Software Installation And Configuration

    MXIbus initialization program. This program initializes the AT-MXI board for operation. Run this program before using the NI-VXI software. • resman is the National Instruments multimainframe Resource Manager. Run this program after vxiinit. • victext is the text-based interactive control program that executes functions you enter from the keyboard.
  • Page 38: Additional Programs And Files

    • devinfo.h contains parameter and return values for the device information and system configuration functions. • vxiint.h contains parameter and return values for the interrupt and signal functions. VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 39: Installing The Software

    4. The script program prompts you to verify that you have logged on with super user privileges. If this is not the case, quit the program and restart after logging in as root. © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 40 11. You can reboot now to activate the new kernel immediately, or you can reboot at a later time. However, you cannot access the NI-VXI driver loaded in the kernel until you reboot. VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 41: Step 3. Change The Path For The Utility Files (Optional)

    If you set the NIVXIPATH environment variable in this manner, the NI-VXI utilities can access table, configuration and help files from the /usr/nivxi/tbl and /usr/nivxi/hlp directories. You can also add this directory to your default search path by modifying the PATH environment variable. © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 42: Configuring The Ni-Vxi Software

    For further instructions on the use of the vxitedit program, refer to the NI-VXI Text Utilities Reference Manual. The following sections describe the various configuration options available under the Logical Address and Bus Configuration Editors. VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 43: Logical Address Configuration

    This value must correspond to the jumper settings on the AT-MXI board. Range = 3, 4, 5, 6, 7, 9, 10, 11, 12, 14, or 15 (continues) © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 44 Indicates the offset in the local RAM above which the RAM is shared over the VXIbus in A24 space. Range = 0 to 15, in increments of 1 MB 0 MB (continues) VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 45 Resource Manager Time in seconds that the Resource Manager Delay waits before accessing the configuration registers of any other device in the system. Range = 0 sec to 65535 sec 5 sec © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 46: Bus Configuration

    NONE option, the same interrupt level as used for AT-MXI board interrupts is used for this interrupt. Range = 3, 4, 5, 6, 7, 9, 10, 11, 12, 14, 15, or 0xff (NONE) 0xff VXI-AT2022/NI-VXI SCO UNIX Getting Started 3-10 © National Instruments Corporation...
  • Page 47: Exiting Vxitedit And Reinitializing The Hardware

    If you changed any of the software configuration settings from the default settings, record the new settings on the VXI-AT2022 Hardware and Software Configuration Form in Appendix C. Developing Your Application Program After you have verified that the driver software has been installed successfully, you can begin to develop your VXI application software.
  • Page 48: Appendix A Specifications

    Description Can function as an AT Alternate Master LOCK Can lock the AT bus for indivisible transfers DMA16 Supports D08 or D16 DMA transfers Can interrupt on the PC AT bus © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 49 Standard full-length AT-height board (13.36 in. by 4.8 in.) Connectors Single fully implemented MXIbus connector Slot Requirements Single AT (ISA) slot Reliability MTBF Contact Factory Requirements Memory space required 64 KB I/O space required 32 bytes VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 50 Block Write 290 nsec Block Write 590 nsec Block Read 190 nsec Block Read 590 nsec Other Daisy-Chain Delay 120 nsec (Passing GIN to GOUT or GOUT generation from System Controller) © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 51 IACK daisy-chain driver VXIbus Capability Code Description TRIG+1 Supports TTLTRIG0:7 and ECLTRIG0:1 trigger lines and full protocol operations for each. The VXI-MXI may participate in only one protocol operation at a time. VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 52 DC Current Ratings Source Typical Maximum Dynamic Current +5 VDC 5.25 A 6.7 A 0.67 A -5.2 VDC 300 mA 400 mA 50 mA -2 VDC 100 mA 125 mA 20 mA © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 53 INTX daughter card) Slot Requirements Single VXI C-size slot VXI Keying Class Class 1 TTL Fully compatible with VXI specification Fully enclosed and shielded Reliability MTBF Contact Factory Requirements A16 Space 64 bytes VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 54 Block Write 320 nsec Block Write 238 nsec Block Read 270 nsec Block Read 238 nsec Other Daisy-Chain Delay 120 nsec (Passing GIN to GOUT or GOUT generation from System Controller) © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 55: Appendix B Troubleshooting

    MXI cable. If you are unable to resolve your problem, please fill out the appropriate forms in Appendix C, Customer Communication, and contact National Instruments. Problems with vxiinit This section discusses what to do if running the vxiinit initialization program results in an error message or causes the system to hang.
  • Page 56: Vxiinit Could Not Find The At-Mxi

    .cshrc or .profile files, depending on the shell type you are using (Refer to the Installing the Software section of Chapter 3). Set the correct path for the NIVXIPATH variable, for example, /usr/nivxi. VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 57: Vxiinit Causes System To Hang

    D000h to DFFFh. You can change the Master Window base address by running the VXI resource editor program, vxitedit, and using the Logical Address Configuration Editor to make the change. © National Instruments Corporation VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 58: Memory Area Used By Another Device

    Also, you will have to reinstall the NI-VXI driver and specify the new interrupt level in the installation procedure to match the hardware setting. Reboot the system to make the changes take effect. Refer to the Installing the Software section in Chapter 3 for more details. VXI-AT2022/NI-VXI SCO UNIX Getting Started © National Instruments Corporation...
  • Page 59: Problems With Mxibus Cable

    AT-MXI and the VXI-MXI are set accordingly. 3. If the cabling problem is not apparent, try another MXIbus cable if you have one available. If this solves the problem, contact National Instruments for repair information. © National Instruments Corporation...
  • Page 60: Appendix C Customer Communication

    For your convenience, this appendix contains forms to help you gather the information necessary to help us solve technical problems you might have as well as a form you can use to comment on the product documentation. Filling out a copy of the Technical Support Form before contacting National Instruments helps us help you better and faster.
  • Page 61 National Instruments for technical support helps our applications engineers answer your questions more efficiently. If you are using any National Instruments hardware or software products related to this problem, include the configuration forms from their user manuals. Use additional pages if necessary.
  • Page 62 Completing this form accurately before contacting National Instruments for technical support helps our applications engineers answer your questions more efficiently.
  • Page 63 Other Products • Computer Make and Model __________________________________________________ • Microprocessor __________________________________________________ • Clock Frequency (Bus and Microprocessor) __________________________________________________ • Total Memory in System __________________________________________________ • Type of Video Board Installed __________________________________________________ • UNIX Version __________________________________________________ • Programming Language Version __________________________________________________ •...
  • Page 64 Documentation Comment Form National Instruments encourages you to comment on the documentation supplied with our products. This information helps us provide quality products to meet your needs. ™ Title: Getting Started with Your VXI-AT2022 and the NI-VXI Software for SCO UNIX...
  • Page 65: Glossary

    Valid numbers for n are 16, 24, and 32. In VME/VXI, because there are six address modifiers, there are 64 possible address spaces. © National Instruments Corporation Glossary-1 VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 66 8 nsec. CMOS Complementary Metal Oxide Semiconductor; a process used in making chips. Commander A Message-Based device which is also a bus master and can control one or more Servants. VXI-AT2022/NI-VXI SCO UNIX Getting Started Glossary-2 © National Instruments Corporation...
  • Page 67 In this configuration, a plug-in interface board in a computer is connected to the VXI mainframe via one or more VXIbus extended controllers. The computer then exerts overall control over VXIbus system operations. Fahrenheit © National Instruments Corporation Glossary-3 VXI-AT2022/NI-VXI SCO UNIX Getting Started...
  • Page 68 Interrupters and responds to those requests by requesting status and identify information. interrupt level The relative priority at which a device can interrupt. INTX Interrupt Timing and Extension IRQ* Interrupt signal Industry Standard Architecture 1,024; kilobytes of memory VXI-AT2022/NI-VXI SCO UNIX Getting Started Glossary-4 © National Instruments Corporation...
  • Page 69 Controller cycle timeout responsibility. Always the first device in the MXIbus daisy- chain. NI-VXI The National Instruments bus interface software for VME/VXIbus systems. Non-Slot 0 device A device configured for installation in any slot in a VXIbus mainframe other than Slot 0. Installing such a device into Slot 0 can damage the device, the VXIbus backplane, or both.
  • Page 70 Register-Based devices are typically controlled by Message-Based devices via device-dependent register reads and writes. resman The name of the National Instruments Resource Manager in NI-VXI bus interface software. See Resource Manager. Resource Manager A Message-Based Commander located at Logical Address 0, which...
  • Page 71 The simplest required communication protocol supported by Message- Protocol Based devices in the VXIbus system. It utilizes the A16 communication registers to transfer data using a simple polling handshake method. © National Instruments Corporation Glossary-7 VXI-AT2022/NI-VXI SCO UNIX Getting Started...

Table of Contents