Page 3
The reader should consult National Instruments if errors are suspected. In no event shall National Instruments be liable for any damages arising out of or related to this document or the information contained in it.
Page 4
These classes are known as Class A (for use in industrial-commercial locations only) or Class B (for use in residential or commercial locations). All National Instruments (NI) products are FCC Class A products. Depending on where it is operated, this Class A product could be subject to restrictions in the FCC rules. (In Canada, the Department of Communications (DOC), of Industry Canada, regulates wireless interference in much the same way.) Digital...
About This Manual This manual contains instructions for installing and configuring the National Instruments PCI-MXI-2 kits for Linux. The VXI MXI-2 kit includes a VXI-MXI-2 module that plugs into a VXI mainframe and links your PCI-based computer to the VXIbus. The VME MXI-2 kit includes a VME-MXI-2 that plugs into a VME chassis and links your PCI-based computer to the VMEbus.
About This Manual Begin by reading this getting started manual to guide you through the installation and configuration of the hardware and software. You should install and configure the components of the PCI-MXI-2 kit in the order in which this manual describes them. Be sure to review the Quick Start and Default Settings sections in Chapter 1, Introduction and Quick Start.
Chapter 1 Introduction and Quick Start How to Use This Manual The following flowchart shows where to turn in this manual for more information about configuring and using the hardware and software. Gather What You Need Chapter 1 to Get Started Configure and Install the Chapter 2 PCI-MXI-2...
Linux Installation Guide. MXI-2 Description MXI-2 is the second generation of the National Instruments MXIbus product line. The MXIbus is a general-purpose, 32-bit, multimaster system bus on a cable. MXI-2 expands the number of signals on a standard MXI cable by including VXI triggers, all VXI interrupts, CLK10, and all of the utility bus signals (SYSFAIL*, SYSRESET*, and ACFAIL*).
The new synchronous MXI block protocol increases MXI-2 throughput to a maximum of 33 MB/s between two MXI-2 devices. All National Instruments MXI-2 boards can initiate and respond to synchronous MXI block cycles. In the remainder of this manual, the term MXIbus refers to MXI-2.
Optional Software Your PCI-MXI-2 kit includes the NI-VXI/NI-VISA bus interface software. In addition, you can use National Instruments LabVIEW to ease your programming task. This standardized program matches the modular virtual instrument capability of VXI and can reduce your VXI/VMEbus software development time.
Input Parameters and the Id/Logical Address register under Input Parameters. Click Go!. If the CMPL light along the right side of the window is green, and the output value ends in an FF6, you have successfully read the manufacturer ID for National Instruments. PCI-MXI-2 for Linux ni.com...
Chapter 1 Introduction and Quick Start VXI/VME-MXI-2 This section summarizes the hardware and software default settings for the VXI-MXI-2 and VME-MXI-2. Table 1-6. VXI-MXI-2 Hardware Default Settings Hardware Component Default Setting Logical Address (U43) VXIbus Slot 0/Non-Slot 0 (W2) Automatic detection VXIbus Local Bus (S8, S9) Both OFF: Single VXI-MXI-2 VXIbus CLK10 Routing (W3)
Chapter 2 PCI-MXI-2 Configuration and Installation Configuration EEPROM The PCI-MXI-2 has an onboard EEPROM, which stores default register values that are loaded at power-on. The EEPROM is divided into two halves—a factory-configuration half, and a user-configuration half—so you can modify the user-configurable half, while the factory-configured half stores a back-up of the default user settings.
Chapter 3 VXI-MXI-2 Configuration and Installation VXIbus Logical Address Each device in a VXIbus/MXIbus system is assigned a unique number between 0 and 254. This 8-bit number, called the logical address, defines the base address for the VXI configuration registers located on the device. With unique logical addresses, each VXIbus device in the system is assigned 64 bytes of configuration space in the upper 16 KB of A16 space.
Page 36
Chapter 3 VXI-MXI-2 Configuration and Installation Do not install a device configured for Slot 0 into another slot without first Caution reconfiguring it to either Non-Slot 0 or automatic configuration. Neglecting to do this could damage the device, the VXIbus backplane, or both. Slot 0 Auto Nonslot 0...
Chapter 3 VXI-MXI-2 Configuration and Installation VXI-MXI to left VXI-MXI to left VXI-MXI to right VXI-MXI to right b. Leftmost VXI-MXI-2 in Mainframe a. Single VXI-MXI-2 in Mainframe (Default) VXI-MXI to left VXI-MXI to left VXI-MXI to right VXI-MXI to right c.VXI-MXI-2 between Two Others d.
Page 40
Chapter 3 VXI-MXI-2 Configuration and Installation When switch S3 is set so that the VXI-MXI-2 receives the SMB CLK10 signal, you have the option to add a 50Ω termination to the signal by setting switch S4. S4 is unused—its setting does not matter—when S3 is configured to drive the external CLK SMB signal.
Chapter 3 VXI-MXI-2 Configuration and Installation The VXI-MXI-2 can also drive or receive the MXIbus CLK10 signal. Switch S7 controls whether the VXI-MXI-2 drives MXIbus CLK10 from the VXIbus CLK10 or receives MXIbus CLK10. As shown in Figure 3-5c, if W3 is configured to use the MXIbus CLK10 to generate the VXIbus CLK10 signal, switch S7 must be configured to receive MXIbus CLK10.
Chapter 3 VXI-MXI-2 Configuration and Installation you manually control whether to terminate the MXIbus when automatic termination is turned off. Switch 1 has no effect when switch 2 is set for automatic MXIbus termination; you must turn off automatic termination if you want to manually control termination.
Chapter 3 VXI-MXI-2 Configuration and Installation Onboard DRAM The VXI-MXI-2 can accommodate up to two 1.35 in. DRAM SIMMs. Table 3-1 lists the SIMMs you can use. Table 3-1. VXI-MXI-2 DRAM Configurations National Instruments Switch Setting Bank 0 Bank 1 Total DRAM Option of S6...
Refer to Table 3-1 for how to adjust the switch (ON or OFF) for all supported DRAM configurations. Many of the DRAM options are available from National Instruments. Install the VXI-MXI-2 This section contains general installation instructions for the VXI-MXI-2.
Chapter 3 VXI-MXI-2 Configuration and Installation If you are installing the VXI-MXI-2 into a D-size mainframe, install a support designed for installing C-size boards in D-size mainframes. The VXI-MXI-2 has no P3 connector and cannot provide P3 Slot 0 control to VXI devices requiring this capability. If the VXI-MXI-2 is not configured for automatic Slot 0 detection, be certain that Caution the slot you select in your VXIbus mainframe matches the VXI-MXI-2 configuration as...
Page 51
Chapter 4 VME-MXI-2 Configuration and Installation 1 S2 3 W2 5 DRAM Bank 1 2 U21 4 U20 6 DRAM Bank 0 Figure 4-1. VME-MXI-2 Parts Locator Diagram PCI-MXI-2 for Linux ni.com...
Chapter 4 VME-MXI-2 Configuration and Installation Figure 4-2 shows switch settings for A16 base address hex C040 and F000. a. Switch Set to A16 Base Address Hex C040 (Default) b. Switch Set to A16 Base Address Hex F000 Figure 4-2. Base Address Selection VME-MXI-2 Intermodule Signaling If you will be installing more than one VME-MXI-2 in a single VMEbus chassis, you must select a user-defined pin for use by the VME-MXI-2.
Chapter 4 VME-MXI-2 Configuration and Installation a. Automatic MXIbus Termination (Default) b. Terminate MXIbus (On) c. Do Not Terminate MXIbus (Off) Figure 4-4. MXIbus Termination Configuration EEPROM The VME-MXI-2 has an onboard EEPROM, which stores default register values that are loaded at power-on. The EEPROM is divided into two halves—a factory-configuration half, and a user-configuration half.
Figure 4-6. SIMM Size Configuration Refer to Table 4-1 for how to adjust the switch (ON or OFF) for all supported DRAM configurations. Many of the DRAM options are available from National Instruments. Table 4-1. VME-MXI-2 DRAM Configurations National Instruments...
Chapter 4 VME-MXI-2 Configuration and Installation Insert the VME-MXI-2 in the slot you have selected by aligning the top and bottom of the board with the card-edge guides inside the mainframe. Slowly push the VME-MXI-2 straight into the slot until its plug connectors are resting on the backplane receptacle connectors.
The NI-VISA software is configured to be loaded in the directory. /usr/local/vxipnp Completing the Software Installation After the software is installed, run , the National Instruments resman Resource Manager. You must run every time the computer or resman chassis power is cycled so that your application can access devices in the VXI/VME chassis.
Chapter 6 NI-VXI Configuration Utility Figure 6-1 shows the main menu of the resource editor. vxiedit Figure 6-1. VXIedit Main Screen The rest of this chapter describes only the features of the PCI-MXI-2 Configuration Editor and the VXI/VME-MXI-2 Configuration Editor. For instructions on using the other editors, refer to your software utility reference manual—either the NI-VXI Graphical Utilities Reference Manual or the NI-VXI Text Utilities Reference Manual.
Chapter 6 NI-VXI Configuration Utility Record Configuration to File With this option you can save your configuration settings to a file. Notice that this option does not write the configuration settings to the PCI-MXI-2 configuration EEPROM. If you want to update the PCI-MXI-2 configuration settings, use the Update Current Configuration option instead.
Chapter 6 NI-VXI Configuration Utility Device Type This field indicates the classification of the PCI-MXI-2. The default value is MBD, designating a message-based device. The following table shows the available options. Classification Setting Extended Device Message-Based Device Register-Based Device The device type affects only the contents of the Device Class field in the Device Type register.
Chapter 6 NI-VXI Configuration Utility When the Address Space field is in the default setting of A16 only, this field is Note ignored. This field is also ignored if the Memory Select fields for both the lower and upper half windows are set to Onboard memory. Advanced Shared RAM Settings Clicking the Advanced button displays a dialog box to configure the destination of MXIbus cycles that map into the PCI-MXI-2 through the...
Page 71
VXI/VME devices that support retries will not have this problem, because they can handle VXI/VME retry conditions correctly by automatically retrying the access. For example, the National Instruments VXI-DAQ boards handle VXI/VME retry conditions properly, and do not exhibit this problem.
Chapter 6 NI-VXI Configuration Utility Resource Manager Delay The only option under the Resource Manager portion of the Logical Address Configuration Editor is the Resource Manager Delay control. Note This field is effective only when the PCI-MXI-2 is at its default logical address of 0. The PCI-MXI-2 is the Resource Manager only if its logical address is 0.
Chapter 6 NI-VXI Configuration Utility Number of Handlers This field gives the number of interrupt handlers that the PCI-MXI-2 supports. Interrupt Handlers Default Value 0 to 7 Number of Interrupters This field gives the number of interrupters that the PCI-MXI-2 supports. Interrupters Default Value 0 to 7...
Chapter 6 NI-VXI Configuration Utility You can select the Yes or No options to manually determine whether the PCI-MXI-2 should be the MXIbus System Controller. You must still be certain to cable the MXIbus system appropriately when you make either of these selections.
Chapter 6 NI-VXI Configuration Utility disabled, you can lower the MXI Bus Timeout because there will be no delay due to the inward cycles being retried. Note The PCI-MXI-2 has a limit on the number of automatic retries they will perform on any one cycle.
Page 80
Chapter 6 NI-VXI Configuration Utility Upon entering the VXI/VME-MXI-2 Configuration Editor, the program displays a list of VXI/VME-MXI-2 boards that detected in your resman system, as shown in Figure 6-7. Figure 6-7. VXI/VME-MXI-2 Selection Dialog Box Select the device you want to configure from the Detected Boards pull-down list, or you can select User LA and type in the board’s logical address in the Logical Address field.
Chapter 6 NI-VXI Configuration Utility Address Space and Requested Memory The VXI/VME-MXI-2 requires at least 16 KB of address space in A24 space or at least 64 KB in A32 space. Use the Address Space control to select whether you want to use A24 space or A32 space. Use the Requested Memory control to set the amount of memory space that the VXI/VME-MXI-2 will request.
Chapter 6 NI-VXI Configuration Utility This type of system configuration is recommended if you have one of the following situations: • A VXI/VMEbus mainframe with only slave devices and no masters. Without bus masters, there is no chance for deadlock. You can configure the VXI/VME-MXI-2 devices in this mainframe for normal operating mode.
Chapter 6 NI-VXI Configuration Utility VXI/VME Auto Retry The VXI/VME-MXI-2 has an automatic retry feature for cycles that map from the VXI/VMEbus to the MXIbus. By default this option is disabled. Normally, when a cycle maps from the VXI/VMEbus to the MXIbus, any retry response received on the MXIbus is passed to the VXI/VMEbus.
Chapter 6 NI-VXI Configuration Utility MXI Bus Options Use the options in this group to control features of the MXIbus interface on the VXI/VME-MXI-2 module. MXI Bus System Controller You can use the System Controller control to determine whether the VXI/VME-MXI-2 acts as the MXI Bus System Controller.
Chapter 6 NI-VXI Configuration Utility Transfer Limit You can use this feature to control how many data transfers the VXI/VME-MXI-2 will perform on the MXIbus before releasing it to another master device that is requesting use of the bus. The default setting holds the MXIbus for an unlimited period of time.
Chapter 7 Using the NI-VXI/NI-VISA Software Interactive Control of NI-VXI/NI-VISA The easiest way to learn how to communicate with your instruments is by controlling them interactively. Use the VXI/VME interactive control utility or its text mode counterpart, ) to write to and read from your victext instruments.
Chapter 7 Using the NI-VXI/NI-VISA Software System Configuration Functions The System Configuration functions provide the lowest-level initialization of your VXI controller. For NI-VXI, use the function InitVXIlibrary() at the start of each application and the function at CloseVXIlibrary() the end of each application. For NI-VISA, use viOpenDefaultRM() at the start of each application and the function at the end of...
Any executable not listed in this section is used by the driver and should not be Note executed by the user directly. • is the National Instruments multiple-mainframe Resource resman Manager. • is a graphical interactive control program. This program is described in detail in the NI-VXI Graphical Utilities Reference Manual.
Page 97
Appendix A NI-VXI/NI-VISA Software Overview Header Files for NI-VXI directory (where is the actual location where NIVXI /include NIVXI you installed the NI-VXI software package) contains the following files for the C language interface: include • is the main header file containing the C prototypes for the nivxi.h NI-VXI functions.
Page 99
Appendix B EEPROM Configuration U17 or SW1 Figure B-1. EEPROM Operation Default Settings Fixing an Invalid EEPROM Configuration Certain EEPROM configurations can cause your PCI computer to lock up while in its boot process. Generally, only the size and location of the memory windows can cause problems with the PCI-MXI-2 locking up your system.
Page 102
Appendix C Common Questions Which NI-VXI utility program must I use to perform startup Resource Manager operations? Use the program to perform startup Resource Manager operations. resman It is located in the directory ( NIVXI /bin /usr/local/nivxi/bin default). uses the settings in the Configuration Editor of resman .
Page 103
I have a system that requires rugged chassis and bulkhead cables. Can I still use MXIbus? Yes, National Instruments sells MXIbus bulkhead cables. Contact National Instruments for further information. What kind of signal is CLK10 and what kind of signal do I need for an external CLK10? CLK10 is a differential ECL signal on the VXIbus backplane.
Page 104
Appendix C Common Questions NI-VXI library ( by default). Run /usr/local/nivxi/lib ldconfig reread this file. Whenever I try to execute any of the NI-VXI utilities, I receive a message that it could not find a particular file even though the file does exist.
Page 105
Technical Support and Professional Services Visit the following sections of the National Instruments Web site at for technical support and professional services: ni.com • Support—Online technical support resources at ni.com/support include the following: – Self-Help Resources—For answers and solutions, visit the...
Page 107
Glossary ACFAIL A VMEbus backplane signal that is asserted when a power failure has occurred (either AC line source or power supply malfunction), or if it is necessary to disable the power supply (such as for a high temperature condition). address Character code that identifies a specific location (or series of locations) in memory.
Page 109
Glossary daisy-chain A method of propagating signals along a bus, in which the devices are prioritized on the basis of their position on the bus. Data Transfer Bus DTB; one of four buses on the VMEbus backplane. The DTB is used by a bus master to transfer binary data between itself and a slave device.
Page 111
Module Identification lines. MTBF Mean Time Between Failure. MXI-2 The second generation of the National Instruments MXIbus product line. MXI-2 expands the number of signals on a standard MXIbus cable by including VXI triggers, all VXI interrupts, CLK10, SYSFAIL*, SYSRESET*, and ACFAIL*.
Page 112
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 also Resource Manager. Resource Manager A message-based Commander located at Logical Address 0, which...
Page 113
Glossary retry An acknowledge by a destination that signifies that the cycle did not complete and should be repeated. RPM Package Manager, a widely-used software distribution tool that you can use to install, upgrade, or remove software from your system. Seconds.
Page 115
Glossary VXItedit VXI Resource Editor program, a part of the NI-VXI bus interface software package. Used to configure the system, edit the manufacturer name and ID numbers, edit the model names of VXI and non-VXI devices in the system, as well as the system interrupt configuration information, and display the system configuration information generated by the Resource Manager.
Page 119
Index LA selection and logical address option, 6-19 NI support and services, D-1 LabVIEW software, 1-6 NI-VXI/NI-VISA software LEDs on VXI/VME-MXI-2, C-2 common questions, C-1 local bus, VXIbus, 3-7 compiling C programs, 7-4 local resource access functions, 7-3 symbols, 7-4 logical address description, 1-5 configuration...