background image

MXI

TM

Getting Started with Your PCI-MXI-2 and the 
NI-VXI

TM

/NI-VISA

TM

 Software for Linux

PCI-MXI-2 for Linux

October 2005

 

370551D-01

Summary of Contents for MXI Series

Page 1: ...MXI TM Getting Started with Your PCI MXI 2 and the NI VXI TM NI VISA TM Software for Linux PCI MXI 2 for Linux October 2005 370551D 01 ...

Page 2: ...ea 82 02 3451 3400 Lebanon 961 0 1 33 28 28 Malaysia 1800 887710 Mexico 01 800 010 0793 Netherlands 31 0 348 433 466 New Zealand 0800 553 322 Norway 47 0 66 90 76 60 Poland 48 22 3390150 Portugal 351 210 311 210 Russia 7 095 783 68 51 Singapore 1800 226 5886 Slovenia 386 3 425 4200 South Africa 27 0 11 805 8197 Spain 34 91 640 0085 Sweden 46 0 8 587 895 00 Switzerland 41 56 200 51 51 Taiwan 886 02...

Page 3: ...lure or surges fire flood accident actions of third parties or other events outside reasonable control Copyright Under the copyright laws this publication may not be reproduced or transmitted in any form electronic or mechanical including photocopying recording storing in an information retrieval system or translating in whole or in part without the prior written consent of National Instruments Co...

Page 4: ...nt of Communications DOC Changes or modifications not expressly approved by NI could void the user s authority to operate the equipment under the FCC Rules Class A Federal Communications Commission This equipment has been tested and found to comply with the limits for a Class A digital device pursuant to part 15 of the FCC Rules These limits are designed to provide reasonable protection against ha...

Page 5: ...al Software 1 6 Quick Start 1 6 Hardware Installation 1 7 Installing and Loading the NI VXI NI VISA Software for Linux 1 8 VME Users 1 8 Device Interaction 1 8 Default Settings 1 9 PCI MXI 2 1 9 VXI VME MXI 2 1 12 Chapter 2 PCI MXI 2 Configuration and Installation Configure the PCI MXI 2 2 1 Configuration EEPROM 2 4 Install the PCI MXI 2 2 4 Chapter 3 VXI MXI 2 Configuration and Installation Confi...

Page 6: ... 4 8 Install the VME MXI 2 4 9 Connect the MXIbus Cable 4 10 Chapter 5 NI VXI NI VISA Software Installation Installing the NI VXI NI VISA Software for Linux 5 1 Removing the NI VXI Driver for Linux 5 2 Using the NI VXI NI VISA Software 5 2 Completing the Software Installation 5 2 Chapter 6 NI VXI Configuration Utility Running the VXIedit Configuration Utility 6 1 PCI MXI 2 Configuration Editor 6 2...

Page 7: ...XI CLK10 6 14 MXI Transfer Limit 6 15 Synchronous MXI 6 15 MXI 2 Auto Retry 6 15 A24 A32 Write Posting 6 16 PCI Bus 6 16 User Window and Driver Window 6 16 Expansion ROM 6 17 VXI VME MXI 2 Configuration Editor 6 17 LA Selection and Logical Address 6 19 Address Space and Requested Memory 6 20 A16 and A24 A32 Write Posting 6 20 Interlocked Mode 6 21 VXI VME Bus Options 6 22 VMEbus System Controller ...

Page 8: ...SA 7 2 Example Programs 7 2 Programming Considerations 7 2 Multiple Applications Using the NI VXI and VISA Libraries 7 2 Low Level Access Functions 7 3 Local Resource Access Functions 7 3 System Configuration Functions 7 4 Compiling Your C Program for NI VXI NI VISA 7 4 Symbols 7 4 Appendix A NI VXI NI VISA Software Overview Appendix B EEPROM Configuration Appendix C Common Questions Appendix D Te...

Page 9: ...o the MXIbus and the NI VXI bus interface software The VXI MXI 2 and VME MXI 2 kits are fully VXIplug play compliant This manual uses the term PCI MXI 2 kit when information applies to either kit and the term VXI VME MXI 2 when information applies to either the VXI MXI 2 or the VME MXI 2 This manual also uses the term PCI MXI 2 when information applies to either the PCI MXI 2 or the PCI MXI 2 Univ...

Page 10: ...e Acrobat Reader program to open this file We recommend the VISA API for new applications Refer to the NI VISA User Manual to learn about VISA and how to use it in your system The NI VISA online help describes the attributes events and operations you can use in NI VISA The user manual is available in the VXIpnp linux NIvisa manuals directory where VXIpnp refers to the actual location where you hav...

Page 11: ...t from the other examples monospace italic Italic text in this font denotes text that is a placeholder for a word or value that you must supply Related Documentation The following documents contain information that you may find helpful as you read this manual ANSI IEEE Standard 1014 1987 IEEE Standard for a Versatile Backplane Bus VMEbus ANSI IEEE Standard 1155 1993 IEEE VMEbus Extensions for Inst...

Page 12: ...nstall the PCI MXI 2 kit with a simple configuration and a Default Settings section which lists the hardware and software default settings for easy reference You may find that these sections contain as much information as you need to get started with your PCI MXI 2 kit This manual uses the term PCI MXI 2 kit when information applies to either the VXI MXI 2 kit which contains a VXI MXI 2 module or ...

Page 13: ...oftware VXI VME Gather What You Need to Get Started Chapter 2 Chapter 6 Chapter 5 Chapter 7 Chapter 4 Software and Utilities Reference Chapter 1 Write Application Program Using VXI or VME Configure and Install the PCI MXI 2 Install the NI VXI VISA Software Review Programming Considerations Run the Software Configuration Utility vxitedit Configure and Install the VME MXI 2 Chapter 3 Configure and I...

Page 14: ...ters What You Need to Get Started A PCI based computer running a supported Linux distribution VXIbus or VMEbus mainframe PCI MXI 2 or PCI MXI 2 Universal interface board VXI MXI 2 or VME MXI 2 interface module MXI 2 cable NI VXI NI VISA software media for the PCI MXI 2 For supported distributions refer to the NI VXI NI VISA for the PCI MXI 2 for Linux Installation Guide MXI 2 Description MXI 2 is ...

Page 15: ...s in your PCI based computer It links your PCI based computer directly to the MXIbus and vice versa Because the PCI MXI 2 uses the same communication register set that other VXIbus message based devices use other MXIbus devices view the PCI MXI 2 as a VXIbus device The PCI MXI 2 can also function as the MXIbus System Controller and can terminate the MXIbus signals directly on the PCI MXI 2 In addi...

Page 16: ...m ASIC a sophisticated dual channel DMA controller with standard interfaces for VXI VME MXI and PCI By using MITE DMA to transfer data and commands to and from devices the MITE frees up a computer s microprocessor to perform other tasks such as data analysis and presentation In addition to DMA the MITE incorporates both the new Synchronous MXI protocol and VME64 MBLT 8 byte block transfers in whic...

Page 17: ...e one PCI MXI 2 interface module which you will install in your PCI based computer as the Resource Manager logical address 0 You have either one C size VXI MXI 2 or one 6U B size VME MXI 2 which you will install in a VXI or VME chassis respectively and connect to the PCI MXI 2 You will be using the NI VXI NI VISA software for initialization configuration and device interaction You will use the def...

Page 18: ... MXI 2 in the first slot of a VXI chassis or install the VME MXI 2 in the first slot of a VME chassis The VXI VME MXI 2 default configuration automatically detects whether it should be the VXI VMEbus system controller The VXI VMEbus system controllers operate certain VXI VMEbus lines as required for VXI VME systems Verify that any other VXI VME devices with system controller capability that are lo...

Page 19: ...ilities Reference Manual For more details about installing the NI VXI software refer to Chapter 5 NI VXI NI VISA Software Installation in this manual Device Interaction After resman has detected and configured all VXI VME devices you can view specific information on each device in your system by using the vxiedit utility or its text mode counterpart vxitedit These utilities include a Resource Mana...

Page 20: ... In and Out operations in vic or the vxiin or vxiout commands in victext Default Settings This section summarizes the hardware and software default settings for the PCI MXI 2 kit If you need more information about a particular setting or if you want to try a different configuration please refer to the appropriate hardware or software chapters in this manual The manual flowchart at the beginning of...

Page 21: ... SW1 Switch 4 CT ON Do not alter this setting DRAM SODIMM Installed Per customer order Table 1 3 PCI MXI 2 Logical Address Configuration Editor Default Settings Editor Field Default Setting Logical Address 0 Device Type MBD Address Space A16 VXI Shared RAM Size 0 KB Shared RAM Pool 0 KB Lower Half Window Byte Swapping Disabled non swapped Lower Half Window Memory Select System Memory Upper Half Wi...

Page 22: ... Area Size 0 Number of Handlers 1 Number of Interrupters 0 Protocol Register 0xFF0 Read Protocol Response 0x8448 Table 1 5 PCI MXI 2 Bus Configuration Editor Default Settings Editor Field Default Setting MXI System Controller Auto MXI Bus Timeout Value 1 ms MXI CLK10 Receive MXI Transfer Limit Unlimited VXImove uses Synchronous MXI Enabled MXI 2 Auto Retry Enabled A24 A32 Write Posting Disabled Us...

Page 23: ...nboard oscillator External Trigger Termination S2 OFF Unterminated SMB CLK10 Direction S3 OUT Drive CLK10 signal SMB CLK10 Termination S4 Ignored effective only when S3 is set to IN Polarity of External SMB CLK10 S5 Inverted MXIbus CLK10 Signal S7 Receive CLK10 from MXIbus MXIbus Termination U35 switches 1 and 2 Automatic MXIbus termination switch 2 set to YES switch 1 ignored Configuration EEPROM...

Page 24: ...rotected both switches OFF DRAM SIMMs Installed Per customer order SIMM Size Configuration S2 OFF if SIMMS are 4 M 32 or larger ON if smaller than 4 M 32 Table 1 8 VXI VME MXI 2 Configuration Editor Default Settings Editor Field Default Setting Logical Address 1 set by hardware switch LA Selection Set by hardware switch Address Space A24 Requested Memory 16 KB A16 Write Posting Disabled A24 A32 Wr...

Page 25: ...isabled MXI Transfer Limit Unlimited MXI Parity Checking Enabled MXI Fair Requester Disabled MXI CLK10 Set by hardware switch VXI MXI 2 only Assumes no DRAM is installed If DRAM is installed the Address Space would be A32 and Requested Memory would match the amount of DRAM Table 1 8 VXI VME MXI 2 Configuration Editor Default Settings Continued Editor Field Default Setting ...

Page 26: ...odule To avoid such damage in handling the module touch the antistatic plastic package to a metal part of your computer chassis before removing the PCI MXI 2 from the package Configure the PCI MXI 2 This section describes how to configure the configuration EEPROM on the PCI MXI 2 and PCI MXI 2 Universal Figure 2 1 shows the PCI MXI 2 The drawing shows the location and factory default settings on t...

Page 27: ...Chapter 2 PCI MXI 2 Configuration and Installation PCI MXI 2 for Linux 2 2 ni com Figure 2 1 PCI MXI 2 Parts Locator Diagram 1 SW1 2 DRAM 2 1 ...

Page 28: ...Chapter 2 PCI MXI 2 Configuration and Installation National Instruments Corporation 2 3 PCI MXI 2 for Linux Figure 2 2 PCI MXI 2 Universal Parts Locator Diagram 1 SW1 2 DRAM 1 2 ...

Page 29: ...r specific instructions and warnings 1 Plug in your PCI based computer before installing the PCI MXI 2 The power cord grounds the computer and protects it from electrical damage while you are installing the module Caution To protect both yourself and the computer from electrical hazards the computer should remain off until you are finished installing the PCI MXI 2 module 2 Remove the top cover or ...

Page 30: ...Configuration and Installation National Instruments Corporation 2 5 PCI MXI 2 for Linux Figure 2 3 shows how to install the PCI MXI 2 Figure 2 3 PCI MXI 2 Installed in a Computer 1 PCI Bus Slot 2 PCI MXI 2 Board 3 PC 1 2 3 ...

Page 31: ...ing the VXI MXI 2 from the package Configure the VXI MXI 2 This section describes how to configure the following options on the VXI MXI 2 VXIbus logical address VXIbus Slot 0 Non Slot 0 VXIbus local bus VXIbus CLK10 routing Trigger input termination MXIbus termination Configuration EEPROM Onboard DRAM Note If you have only one VXI chassis in your system you should leave the VXI MXI 2 at Logical Ad...

Page 32: ... INVERTED SMB CLK10 Direction 50 Termination for External Trigger Input S3 S2 Off Out S4 Off S5 In On On INVERTED VXI MXI 2 Push up for logic 1 Push down for logic 0 Receive CLK10 from MXIbus 3 Shown at default LOGICAL ADDRESS SWITCH Address 1 setting of Logical 2 1 Drive CLK10 out MXIbus 6 5 4 U43 8 7 S7 R o u ti n g M X I C L K 1 0 From MXIbus From SMB S3 must be set to IN From onboard oscillato...

Page 33: ...e The VXI MXI 2 is housed in a metal enclosure to improve EMC performance and to provide easy handling Because the enclosure includes cutouts to facilitate changes to the switch and jumper settings it should not be necessary to remove it under normal circumstances However it is necessary to remove the enclosure if you want to change the amount of DRAM installed on the VXI MXI 2 Switch S6 which is ...

Page 34: ...its mainframe it is itself a statically configured device and is preset at the factory with a VXI logical address of 1 Ensure that no other statically configurable VXIbus devices have a logical address of 1 If they do change the logical address setting of either the VXI MXI 2 or the other device so that every device in the system has a unique associated logical address You can change the logical a...

Page 35: ...l the VXI MXI 2 into any VXIbus slot You can manually configure the VXI MXI 2 for either Slot 0 or Non Slot 0 operation by defeating the automatic detection circuitry Use the three position jumper W2 to select automatic Slot 0 detection Slot 0 or Non Slot 0 operation Figure 3 3 shows these three settings a Switch Set to Logical Address 1 Default Push up for logic 1 Push down for logic 0 LOGICAL AD...

Page 36: ...XI 2 is installed in Slot 0 it becomes the VMEbus System Controller In this role it has VMEbus Data Transfer Bus Arbiter circuitry that accepts bus requests on all four VMEbus request levels prioritizes the requests and grants the bus to the highest priority requester As VMEbus System Controller the VXI MXI 2 also drives the 16 MHz VMEbus system clock by an onboard 16 MHz oscillator a Automatic Sl...

Page 37: ... during cycles that map to the MXIbus Because the local bus is used you need to install all VXI MXI 2 modules for a single mainframe in adjacent slots You will use two switches on the VXI MXI 2 to select its position in relation to any other VXI MXI 2 module in the mainframe Use switch S9 when there is a VXI MXI 2 to the right higher numbered slot Use S8 when there is a VXI MXI 2 to the left lower...

Page 38: ...gnal Use the three position jumper W3 to select these options as shown in Figure 3 5 Notice that Figure 3 5b and Figure 3 5c also show switches S3 and S7 respectively You must configure these switches as shown when using the corresponding CLK10 source setting of W3 a Single VXI MXI 2 in Mainframe Default b Leftmost VXI MXI 2 in Mainframe c VXI MXI 2 between Two Others d Rightmost VXI MXI 2 in Main...

Page 39: ...o drive CLK10 out the external CLK10 SMB connector do not set the W3 jumper to receive the SMB CLK10 signal instead use the settings shown in either Figure 3 5a or Figure 3 5c as appropriate a CLK10 Generated from Onboard Oscillator Default b CLK10 Generated from SMB c CLK10 Generated from MXIbus W3 From Onboard Oscillator From SMB S3 must be set to IN From MXIbus W3 S7 From Onboard Oscillator Fro...

Page 40: ...sed its setting does not matter when S3 is configured to receive the external CLK SMB signal Figure 3 6 shows four configuration settings for the VXI MXI 2 Figure 3 6a shows the default configuration which is for driving the inverted external CLK SMB Use the settings of Figure 3 6b to drive the noninverted external CLK SMB signal Figure 3 6c illustrates the setting for receiving the external CLK S...

Page 41: ...nly when S3 is set to OUT S2 Off On S3 Out In S4 Off On S5 SMB CLK10 Direction 50Ω Termination for SMB CLK10 Effective only when S3 is set to IN SMB CLK10 Output Polarity Effective only when S3 is set to OUT d Receive External CLK SMB with 50Ω Termination 50Ω Termination for External Trigger Input 50Ω Termination for SMB CLK10 Effective only when S3 is set to IN S2 Off On 50Ω Termination for Exter...

Page 42: ...b as appropriate Caution Do not configure more than one MXIbus device to drive the MXIbus CLK10 Having a second device driving MXIbus CLK10 could damage the device Figure 3 7 shows the configuration settings for receiving and driving MXIbus CLK10 respectively Figure 3 7 Receiving or Driving MXIbus CLK10 Trigger Input Termination You can use switch S2 to terminate the external trigger input SMB wit...

Page 43: ...r MXIbus termination is automatic Figure 3 9a on Figure 3 9b or off Figure 3 9c The settings of switches 3 and 4 have no effect on MXIbus termination Use switch 2 of U35 to select whether you want the VXI MXI 2 to automatically control termination of the MXIbus Switch 1 of U35 lets a Non Terminated External Trigger Input SMB Default b Terminated External Trigger Input SMB with 50Ω S2 Off On 50Ω Te...

Page 44: ...half while the factory configured half stores a back up of the default user settings Use switches 3 and 4 of the four position switch at location U35 to control the operation of the EEPROM The Restore Factory Configuration switch switch 4 causes the VXI MXI 2 to boot off the factory configured half instead of the user modified settings This is useful in the event that the a Automatic MXIbus Termin...

Page 45: ...EEPROM operation The settings of switches 1 and 2 have no effect on EEPROM configuration Figure 3 10 EEPROM Operation a Boot from User Configuration Factory Configuration Protected Default Restore Factory Configuration Change Factory Configuration Automatic MXIbus Termination Terminate MXIbus Yes Yes No No No No Yes Yes U35 1 2 3 4 b Boot from Factory Configuration Factory Configuration Protected ...

Page 46: ...tion Switch Setting of S6 0 256 K 32 or 256 K 36 1 MB ON 256 K 32 or 256 K 36 256 K 32 or 256 K 36 2 MB ON 512 K 32 or 512 K 36 2 MB ON 512 K 32 or 512 K 36 512 K 32 or 512 K 36 4 MB ON 1 M 32 or 1 M 36 4 MB YES ON 1 M 32 or 1 M 36 1 M 32 or 1 M 36 8 MB ON 2 M 32 or 2 M 36 8 MB YES ON 2 M 32 or 2 M 36 2 M 32 or 2 M 36 16 MB ON 4 M 32 or 4 M 36 16 MB YES OFF 4 M 32 or 4 M 36 4 M 32 or 4 M 36 32 MB ...

Page 47: ... For SIMMs smaller than 4 M 32 use the ON setting as shown in Figure 3 11b Figure 3 11 SIMM Size Configuration 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 Refer to your VXIbus mainframe u...

Page 48: ... in until it seats in the expansion slot The front panel of the VXI MXI 2 should be even with the front panel of the mainframe 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 Connect the MXIbus Cable There a...

Page 49: ...ble power on the VXIbus mainframe and then the computer Note Always turn on the mainframe first Doing so makes it possible for your external computer to access the VXI boards in the mainframe upon startup 1 VXI Mainframe 2 VXI MXI 2 Slot 0 Module 3 Additional MXI 2 Cable 4 Connection to Other Mainframes 5 Connection to External Computer 6 PCI MXI 2 Interface Module 7 MXI 2 Cable bus NA TI ON AL IN...

Page 50: ...ge to a metal part of your VMEbus chassis before removing the VME MXI 2 from the package Configure the VME MXI 2 This section describes how to configure the following options on the VME MXI 2 VMEbus A16 base address VME MXI 2 intermodule signaling MXIbus termination Configuration EEPROM Onboard DRAM The VME MXI 2 automatically detects if it is located in the first slot of the chassis to perform th...

Page 51: ...Chapter 4 VME MXI 2 Configuration and Installation PCI MXI 2 for Linux 4 2 ni com Figure 4 1 VME MXI 2 Parts Locator Diagram 1 S2 2 U21 3 W2 4 U20 5 DRAM Bank 1 6 DRAM Bank 0 4 5 6 1 2 3 ...

Page 52: ...d 14 high with address lines 13 through 6 matching the logical address of the VME MXI 2 and address lines 5 through 0 low In other words the A16 base address of the VME MXI 2 module s 64 byte register set is as calculated below base address C000 hex logical address 40 hex The factory default logical address for the VME MXI 2 is 1 which locates the registers in the range C040 hex to C07F hex You ca...

Page 53: ...ules cannot monitor this signal they should be permanently disabled If it is not possible to disable a module s bus timeout unit it should be configured to the highest setting to give MXIbus accesses as much time as possible You can choose from three user defined pins on J2 P2 The pin you select must be bused on the VMEbus backplane between all slots that will have a VME MXI 2 installed Use jumper...

Page 54: ...ng the automatic circuitry Use switches 3 and 4 of the four position switch at location U21 to control whether MXIbus termination is automatic Figure 4 4a on Figure 4 4b or off Figure 4 4c The settings of switches 1 and 2 have no effect on MXIbus termination Use switch 3 to select whether you want the VME MXI 2 to automatically control termination of the MXIbus Switch 4 lets you manually control w...

Page 55: ...igurable half while the factory configured half stores a back up of the default user settings Use switches 1 and 2 of the four position switch at location U21 to control the operation of the EEPROM The Restore Factory Configuration switch switch 1 causes the VME MXI 2 to boot off the factory configured half instead of the user modified settings This is useful in the event that the user configured ...

Page 56: ... of the EEPROM is protected so any writes to the factory area will be ignored The factory area is protected regardless of the setting of switch 1 of U21 Figure 4 5 shows the configuration settings for EEPROM operation The settings of switches 3 and 4 have no effect on EEPROM configuration Figure 4 5 EEPROM Operation a Boot from User Configuration Factory Configuration Protected Default b Boot from...

Page 57: ...to select the size of each SIMM If the SIMMs are 4 M 32 or larger S2 should be in the OFF setting as shown in Figure 4 6a For SIMMs smaller than 4 M 32 use the ON setting as shown in Figure 4 6b 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...

Page 58: ...ng the module Caution To protect both yourself and the mainframe from electrical hazards the mainframe should remain off until you are finished installing the VME MXI 2 module 2 Remove or open any doors or covers blocking access to the mainframe slots 1 M 32 or 1 M 36 4 MB YES ON 1 M 32 or 1 M 36 1 M 32 or 1 M 36 8 MB ON 2 M 32 or 2 M 36 8 MB YES ON 2 M 32 or 2 M 36 2 M 32 or 2 M 36 16 MB ON 4 M 3...

Page 59: ...Replace or close any doors or covers to the mainframe Connect the MXIbus Cable There are two basic types of MXI 2 cables MXI 2 cables can have either a single connector on each end or a single connector on one end and a double connector on the other end Connect the labeled end of the cable to the MXI 2 device that will be the MXIbus System Controller Connect the other end of the cable to the other...

Page 60: ...nnected the MXI 2 cable power on the VMEbus mainframe and then the computer Note Always turn on the mainframe first Doing so makes it possible for your external computer to access the VME boards in the mainframe upon startup 1 VME Chassis 2 VME MXI 2 Module 3 Additional MXI 2 Cable 4 Connection to Other Mainframes 5 Connection to External Computer 6 PCI MXI 2 Interface Module 7 MXI 2 Cable 6 5 4 3...

Page 61: ...XI NI VISA for the PCI MXI 2 for Linux perform the following steps 1 Insert the NI VXI NI VISA for Linux CD 2 Login to your system as root 3 Mount the CD ROM 4 To change the current directory to the mounted CD ROM type the following command cd media cdrom Note This command may vary depending on your Linux distribution 5 To run the installation script type the following command INSTALL The INSTALL ...

Page 62: ...NINSTALL Using the NI VXI NI VISA Software The NI VXI software is configured to be loaded in the usr local nivxi directory The NI VISA software is configured to be loaded in the usr local vxipnp directory Completing the Software Installation After the software is installed run resman the National Instruments Resource Manager You must run resman every time the computer or chassis power is cycled so...

Page 63: ...aphical vxiedit program the two programs are functionally equivalent For information on vxitedit refer to the NI VXI Text Utilities Reference Manual Running the VXIedit Configuration Utility To run vxiedit type vxiedit at the command prompt You can run vxiedit from any directory but make sure that both the PATH and NIVXIPATH environment variables have the destination directory of the NI VXI softwa...

Page 64: ...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 PCI MXI 2 Configuration Editor Figure 6 2 shows the opening screen of the PCI MXI 2 Configuration Editor Notice that the screen displays the serial number and hardware revision...

Page 65: ...hem by selecting the Update Current Configuration option Before proceeding to a description of each field in these editors review the remaining four options of the PCI MXI 2 Configuration Editor These options directly relate to how you can use the changes you make using the configuration editors which are described after the options Update Current Configuration Use this option to write the configu...

Page 66: ...on settings to the PCI MXI 2 configuration EEPROM To update the configuration use the Update Current Configuration option for the changes to take effect Revert to Current Configuration If you made changes to the configuration settings without committing those changes writing to configuration EEPROM you can revert the configuration settings to the values they had before you made the changes Note Yo...

Page 67: ... Editor Device Settings The Device Settings group contains the controls to set the logical address device type and address space of the PCI MXI 2 Logical Address This parameter sets the MXI logical address of the PCI MXI 2 The following table shows the allowable range of values and the default value Logical Address Range Default Value 0 to 254 0 ...

Page 68: ...f three ways The default addressing mode is for A16 space only Your other options are A16 A24 and A16 A32 Notice that several other controls on the configuration editor panel are disabled when the addressing mode is A16 as shown in Figure 6 3 Only if you select A16 A24 or A16 A32 are the following controls relevant VXI Shared RAM Size Shared RAM Pool Advanced Byte Swapping Memory Select Mapping VX...

Page 69: ...indow when the Memory Select control accessible through the Advanced popup field is set to System memory The following table indicates how the Shared RAM Pool relates to the VXI Shared RAM Size depending on the setting of the Memory Select control for the upper and lower half windows The shared RAM pool is used by VXImemAlloc function calls For information on the VXImemAlloc function refer to the ...

Page 70: ...ced Shared RAM Settings Note When the Address Space field is in the default setting of A16 only these fields are ignored and cannot be accessed The VXI VME shared RAM is divided into two halves or windows You can select the byte order for each half independently You can map each half of the VXI VME shared RAM independently into system memory on the motherboard or into onboard memory on the PCI MXI...

Page 71: ...d to the same destination with the same byte order the windows essentially form one continuous window If the windows are mapped to different destinations the base of each inward window maps to the base of each destination If the windows both map to the shared RAM destination but the byte order is different the base of each inward window maps to the base of the shared RAM destination This results i...

Page 72: ... is at its default logical address of 0 The PCI MXI 2 is the Resource Manager only if its logical address is 0 This field specifies the time in seconds that the Resource Manager RM waits before accessing any other VXI VMEbus device s A16 configuration registers Figure 6 5 shows the Device Configuration Editor The following paragraphs describe the options you can select for each of the fields Figur...

Page 73: ...trollers in this case the VXI VME MXI 2 can report events such as triggers and DMA to the PCI MXI 2 through a VXI IRQ line This field selects which VXI IRQ level the remote controllers should use to report events to the PCI MXI 2 Servant Area Size This field designates the servant area size which is supplied to the Resource Manager in response to the Read Servant Area command if the PCI MXI 2 is n...

Page 74: ...XI 2 is configured as a message based device The default value is 0x0ff0 Commander Signal Register Master Read Protocol Response This field specifies the response value to a Read Protocol command received by the PCI MXI 2 from the Resource Manager if the PCI MXI 2 is not the Resource Manager in your system This field is meaningful only when the PCI MXI 2 is configured as a message based device The...

Page 75: ...System Controller control to determine whether the PCI MXI 2 acts as the MXIbus System Controller The three options are Auto Yes and No When the Auto setting is active the default setting the PCI MXI 2 automatically can sense from the MXIbus cable whether it should be the controller This setting requires that the cable is attached properly before making any NI VXI function calls or attempting to u...

Page 76: ...ded The BTO is also disabled when the current MXIbus cycle maps to the VXI VMEbus through a VXI VME MXI 2 The default timeout value is 1 ms If the Enable MXI 2 Auto Retry checkbox option is enabled you should use a MXI Bus Timeout of 1 ms or greater MXI CLK10 The PCI MXI 2 is capable of either receiving or driving the MXIbus CLK10 signal You can use the Drive or Receive options of the MXI CLK10 fe...

Page 77: ... and prevent bus monitoring devices from accessing the bus at regular intervals By default this option is enabled the VXImove uses Synchronous MXI checkbox is checked You can also disable SYNC MXI programmatically in VXImove However if you have an older NI VXI application that does not disable SYNC MXI programmatically you can deselect the checkbox to force your application to not use SYNC MXI if ...

Page 78: ... is onboard RAM because cycles to onboard RAM will always complete successfully PCI Bus The following sections describe the options for the PCI Bus portion of this editor User Window and Driver Window The PCI MXI 2 driver requires the use of two PCI windows a user window and a driver window Calling the MapVXIAddress function allocates regions of the user window to your application VXIpeek and VXIp...

Page 79: ... the user window requires that you reboot your computer The size of the driver window however is system defined and is not user configurable Note Neither the user window nor the driver window can be placed below 1 MB with the Linux NI VXI driver Therefore the Place below 1 MB option and the Window Base option will always be disabled Expansion ROM Use the Enable expansion ROM control to enable or d...

Page 80: ...d s logical address in the Logical Address field Click OK to enter the editor or Cancel to return to the main menu After finding a VXI VME MXI 2 the VXI VME MXI 2 Configuration Editor displays a panel as shown in Figure 6 8 that you can use to modify its configuration settings The panel displays the current settings of the module Notice that it also shows the hardware revision and serial number of...

Page 81: ...r use the LA Selection controls The default selection is the Switch option Notice that the Logical Address control is inaccessible because it would have no effect In this option you need to change the hardware switch setting on the VXI VME MXI 2 itself if you want to change the logical address If you select Software for this option you can then use the Logical Address control to select a logical a...

Page 82: ... Accessing this region will cause your VXI VME MXI 2 to behave incorrectly If you do not want to lose 4 KB of DRAM you can get around this limitation by setting the Requested Memory control to double the amount that is installed on the VXI VME MXI 2 because the DRAM is aliased throughout the remainder of the requested memory space The DRAM should then be accessed in the upper half of the requested...

Page 83: ...must give up its bus ownership to resolve the conflict The RETRY signal is used to terminate the transfer on the VMEbus however devices in the VXI VMEbus mainframe must be able to detect a RETRY caused by a deadlock condition so that they can retry the operation Any master device that cannot detect the retry protocol will interpret the response as a BERR signal instead The VXI VME MXI 2 is shipped...

Page 84: ...cally retry the operation VXI VME Bus Options Use the options in this group to control features of the VXI VMEbus interface on the VXI VME MXI 2 VMEbus System Controller You can use the System Controller control to override the jumper setting on the VXI MXI 2 The VME MXI 2 does not have an onboard jumper setting for this option When the Auto setting the default setting is active the onboard jumper...

Page 85: ...must provide the VXI VMEbus BTO for proper operation because when a MXIbus cycle is involved the VXI VMEbus timeout must be disabled and the MXIbus BTO enabled You should disable the BTO of any other BTO module residing in the mainframe If this is not possible set its VXI Bus Timeout control to its maximum setting to give the MXIbus cycles as much time as possible to complete The lowest value in t...

Page 86: ...enabled Transfer Limit You can use this feature to control how many data transfers the VXI VME MXI 2 will perform on the VXI VMEbus before releasing it to another master device that is requesting use of the bus The available options you can choose from are 16 64 and 256 transfers If you do not want the VXI VME MXI 2 to hold the VXI VMEbus long enough to perform 256 transfers the default value you ...

Page 87: ... priority of the VXI VME MXI 2 request signal For more information refer to the VMEbus specification VXI VME Fair Requester The VXI VME MXI 2 is always a Release On Request requester However you can configure whether the VXI VME MXI 2 acts as either a fair or unfair requester on the VXI VMEbus By default the Operate as Fair Requester checkbox is enabled signifying a fair requester For more informa...

Page 88: ...be certain to cable the MXIbus system appropriately when you make either of these selections MXI Bus Timeout Value The MXI Bus Timeout BTO is a watchdog timer for transfers on the MXIbus The MXIbus BTO unit operates only when the VXI VME MXI 2 is acting as the MXI Bus System Controller The functionality of this control is similar to that of the VXI Bus Timeout control described in the VXI VME Bus ...

Page 89: ... section By default this option is disabled Normally when a cycle maps from the MXIbus to the VXI VMEbus any retry response received on the VXI VMEbus is passed to the MXIbus If you enable the Auto Retry feature the VXI VME MXI 2 automatically retries any VXI VME cycle that receives a retry response instead of passing a retry response on to the MXIbus The VXI VME MXI 2 automatically continues to r...

Page 90: ...led the VXI VME MXI 2 will request the bus at any time If you enable this option the VXI VME MXI 2 will request the MXIbus only when there are no requests pending from other MXIbus masters This prevents other MXIbus masters from being starved of bandwidth MXI CLK10 Signal The VXI MXI 2 can either receive or drive the MXIbus CLK10 signal In its default setting the VXI MXI 2 uses the switch setting ...

Page 91: ...VXI User Manual and the NI VXI online help for overviews of NI VXI and detailed descriptions of the NI VXI functions The user manual is available in the NIVXI manuals directory where NIVXI refers to the actual location where you have installed the NI VXI software Use the Adobe Acrobat Reader program to open and navigate through this manual Notice that the function descriptions indicate whether the...

Page 92: ...s set correctly as described in Chapter 5 NI VXI NI VISA Software Installation Also refer to your software utilities reference manual for additional examples For NI VISA programming examples look in VXIpnp linux NIvisa Examples Programming Considerations The following sections contain information for you to consider when developing Linux applications that use the NI VXI VISA bus interface software...

Page 93: ... software reference manual for more information on low level VXIbus or VMEbus access functions Local Resource Access Functions By using vxiedit you can set up the PCI MXI 2 to share either the system memory on the motherboard or the onboard memory on the PCI MXI 2 with the VXI VME system Refer to the NI VXI Graphical Utilities Reference Manual for more information on setting these parameters Notic...

Page 94: ...ow to use different groups of functions You can then modify the sample programs to try out different aspects of the NI VXI software The sample programs for the Linux gcc compiler are in the usr local nivxi examples directory for NI VXI and usr local vxipnp linux NIvisa Examples directory for NI VISA The easiest way to compile the sample programs is to use the makefile included with the NI VXI NI V...

Page 95: ...uld look something like the following sample code define VXILINUX include nivxi h Refer to the documentation that came with your compiler package for detailed instructions about using the compiler and the various tools linker debugger and so on Your compiler documentation is an important and useful source of information for writing compiling and debugging C programs ...

Page 96: ...gram This program is described in detail in the NI VXI Graphical Utilities Reference Manual victext is a text based interactive control program with all the power of vic This program is described in detail in the NI VXI Text Utilities Reference Manual vxiedit is a graphical VXI resource editor program This program is described in detail in the NI VXI Graphical Utilities Reference Manual vxitedit i...

Page 97: ... the interrupt and signal functions sysint h contains parameter and return values for the system interrupt functions trig h contains parameter and return values for the trigger functions This file is useful in VXI systems but is not applicable for VME systems ws h contains parameter and return values for the Commander and Servant Word Serial functions This file is useful in VXI systems but is not ...

Page 98: ...XI 2 boots off the user configurable half This switch is useful in the event that the configuration becomes corrupted in such a way that the PCI MXI 2 boots to an unusable state The TST switch switch 2 of U17 on the PCI MXI 2 or SW1 on the PCI MXI 2 Universal lets you change the factory default configuration settings by permitting writes to the factory settings section of the EEPROM This switch se...

Page 99: ...on occurs after changing the configuration on the PCI MXI 2 follow these steps to reconfigure the PCI MXI 2 1 Turn your computer off Caution To protect both yourself and the computer from electrical hazards the computer should remain off while changing the settings on the PCI MXI 2 module 2 Remove the top cover or access port to the PCI bus 3 Change switch 1 FOV on U17 SW1 on the PCI MXI 2 Univers...

Page 100: ...MXI 2 configuration Refer to Chapter 6 NI VXI Configuration Utility for instructions on using this utility 7 After saving the configuration reboot the computer 8 Remove the top cover or access port to the PCI bus 9 Change switch 1 FOV on U17 SW1 on the PCI MXI 2 Universal to the OFF position 10 Replace the computer cover 11 Turn on the computer If the computer does not boot with this configuration...

Page 101: ... VXI and the hardware revision of the PCI MXI 2 that the NI VXI software supports How can I determine the serial number and hardware revision of the PCI MXI 2 board Run the NI VXI utility program vxiedit Choose the PCI MXI 2 Configuration Editor The editor window displays the serial number and hardware revision of the PCI MXI 2 board How can I determine the serial number and hardware revision of t...

Page 102: ...r based devices by programming their registers If you have any message based devices you can send and receive messages with the WSwrt and WSrd functions Notice that VXIinReg and VXIoutReg are for VXI devices only Finally if you are using LabVIEW or LabWindows CVI and you have instrument drivers for the devices in your chassis you can use the interactive features of these programs to quickly test t...

Page 103: ...he VXI MXI 2 and the EXTCLK input from the front panel use TTL Therefore you need to supply a TTL level signal for EXTCLK and our voltage converters will convert the signal to differential ECL CLK10 is not applicable to VME What is the accuracy of the CLK10 signal The CLK10 generated by the VXI MXI 2 is 100 ppm 0 01 as per the VXIbus specification If you need a more accurate CLK10 signal you can u...

Page 104: ... can also receive this error message if you do not have full permissions to some of the NI VXI files and directories Users who will be using NI VXI should have full permissions to the tbl and examples directories They should also have read write permissions for all the files contained in those directories Whenever I try to run resman without the MXI 2 cable plugged into my PCI MXI 2 it hangs This ...

Page 105: ... every question receives an answer For information about other technical support options in your area visit ni com services or contact your local office at ni com contact Training and Certification Visit ni com training for self paced training eLearning virtual classrooms interactive CDs and Certification program information You also can register for instructor led hands on courses at locations ar...

Page 106: ...ent A A Amperes A16 space VXIbus address space equivalent to the VME 64 KB short address space In VXI the upper 16 KB of A16 space is allocated for use by VXI devices configuration registers This 16 KB region is referred to as VXI configuration space A24 space VXIbus address space equivalent to the VME 16 MB standard address space A32 space VXIbus address space equivalent to the VME 4 GB extended ...

Page 107: ...bers for n are 16 24 and 32 In VME VXI because there are six address modifiers there are 64 possible address spaces address window A portion of address space that can be accessed from the application program ANSI American National Standards Institute arbitration A process in which a potential bus master gains control over a particular bus asynchronous Not synchronized not controlled by time signal...

Page 108: ...y long wait for a slave response bus master A device that is capable of requesting the Data Transfer Bus DTB for the purpose of accessing a slave device C C Celsius CLK10 A 10 MHz 100 ppm individually buffered to each module slot differential ECL system clock that is sourced from Slot 0 of a VXIbus mainframe and distributed to Slots 1 through 12 on P2 It is distributed to each slot as a single sou...

Page 109: ... Data Transfer Bus dynamically configured device A device that has its logical address assigned by the Resource Manager A VXI device initially responds at Logical Address 255 when its MODID line is asserted A MXIbus device responds at Logical Address 255 during a priority select cycle The Resource Manager subsequently assigns it a new logical address which the device responds to until powered down...

Page 110: ...s request signal inactive This ensures that all requesting devices will be granted use of the bus H hex Hexadecimal the numbering system with base 16 using the digits 0 to 9 and letters A to F Hz Hertz cycles per second I I O Input output the techniques media and devices used to achieve communication between machines and users IC Integrated Circuit IEEE Institute of Electrical and Electronics Engi...

Page 111: ...fers in which both the Address bus and the Data bus are used to transfer data message based device An intelligent device that implements the defined VXIbus registers and communication protocols These devices are able to use Word Serial Protocol to communicate with one another through communication registers MITE A National Instruments custom ASIC a sophisticated dual channel DMA controller that in...

Page 112: ...rd RAM The optional RAM installed into the SIMM slots of the PCI MXI 2 board or VXI VME MXI 2 module P PCI Peripheral Component Interconnect The PCI bus is a high performance 32 bit or 64 bit bus with multiplexed address and data lines propagation The transmission of signal through a computer system R register based device A Servant only device that supports VXIbus configuration registers Register...

Page 113: ...e operation A device is in slave mode it if is responding to a bus cycle Slot 0 device A device configured for installation in Slot 0 of a VXIbus mainframe This device is unique in the VXIbus system in that it performs the VMEbus System Controller functions including clock sourcing and arbitration for data transfers across the backplane Installing such a device into any other slot can damage the d...

Page 114: ...rogram VXI devices and develop and debug VXI application programs VME Versa Module Eurocard or IEEE 1014 VMEbus System Controller A device configured for installation in Slot 0 of a VXIbus mainframe or Slot 1 of a VMEbus chassis This device is unique in the VMEbus system in that it performs the VMEbus System Controller functions including clock sourcing and arbitration for data transfers across th...

Page 115: ...the system configuration information generated by the Resource Manager W Word Serial Protocol The simplest required communication protocol supported by message based devices in a VXIbus system It utilizes the A16 communication registers to transfer data using a simple polling handshake method write posting A mechanism that signifies that a device will immediately give a successful acknowledge to a...

Page 116: ...dule 3 18 CLK10 routing VXIbus 3 8 SMB CLK10 settings figure 3 11 VXIbus CLK10 routing figure 3 9 CLK10 signal MXIbus common questions C 3 controlling direction of 6 14 setting 6 14 Close VXIlibrary function 7 4 common questions about NI VXI NI VISA software C 1 compiling C programs 7 4 symbols 7 4 configuration See also PCI MXI 2 Configuration Editor VXI VME MXI 2 Configuration Editor default set...

Page 117: ...6 11 MXI system controller 6 13 MXIbus system controller 6 26 VMEbus system controller 6 22 conventions used in the manual x D Default Controller LA 1 6 11 default settings 1 9 hardware settings table 1 13 PCI MXI 2 board Bus Configuration Editor table 1 11 Device Configuration Editor table 1 11 hardware settings table 1 9 Logical Address Configuration Editor table 1 10 PCI MXI 2 Universal board h...

Page 118: ... MXI 2 module VXI MXI 2 module default settings table PCI MXI 2 board 1 9 PCI MXI 2 Universal board 1 10 VME MXI 2 module 1 13 VXI MXI 2 module 1 12 description 1 4 quick start installation 1 6 settings table 1 13 header files A 2 help technical support D 1 how to use manual set ix I InitVXIlibrary function 7 4 installation electrostatic discharge caution 2 1 hardware installation 1 7 NI VXI NI VI...

Page 119: ... 3 MXI 2 automatic retry feature 6 15 limit on note 6 16 MXIbus Bus Timeout BTO value setting 6 14 MXIbus cable connections VME MXI 2 module 4 10 VXI MXI 2 module 3 18 N NI support and services D 1 NI VXI NI VISA software common questions C 1 compiling C programs 7 4 symbols 7 4 description 1 5 example programs 7 2 installing 5 1 for Linux 1 8 5 1 interactive control 7 2 overview 7 1 programming c...

Page 120: ...CI MXI 2 Device Configuration Editor default controller LA 1 6 11 default settings table 1 11 figure 6 10 number of handlers 6 12 number of interrupters 6 12 protocol register 6 12 read protocol response 6 12 servant area size 6 11 system IRQ level 6 11 PCI MXI 2 Logical Address Configuration Editor address space 6 6 controls 6 6 default settings table 1 10 device settings group 6 5 device type cl...

Page 121: ... 15 system configuration functions 7 4 system controller MXI system controller 6 13 MXIbus system controller 6 26 VMEbus system controller 6 22 system IRQ level 6 11 T technical support D 1 termination MXIbus termination VME MXI 2 module 4 5 VXI MXI 2 module 3 13 trigger input termination VXI MXI 2 module 3 12 training and certification NI resources D 1 transfer limit setting MXIbus 6 15 6 28 VXI ...

Page 122: ...re 6 24 VXI VME extender kit hardware description 1 4 introduction 1 1 MXI 2 description 1 3 overview 1 3 requirements for getting started 1 3 software description 1 5 VXI VME MXI 2 Configuration Editor A16 write post and A24 A32 write post 6 20 address space and requested memory 6 20 and resman 6 17 default settings table 1 13 figure 6 19 interlocked mode 6 21 LA selection and logical address 6 1...

Page 123: ...al enclosure 3 3 right side cover figure 3 2 trigger input termination 3 12 VXIbus CLK10 routing CLK10 generation figure 3 9 SMB CLK10 settings figure 3 11 VXIbus local bus 3 7 VXIbus logical address 3 4 selection figure 3 5 VXIbus Slot 0 non Slot 0 3 5 connecting MXIbus cable 3 18 default settings Configuration Editor settings table 1 13 hardware settings table 1 12 hardware description 1 4 insta...

Reviews: