background image

Chapter 3

NI-VXI Software Installation and Configuration

© National Instruments Corporation

3-11

VXI-AT2022/NI-VXI SCO UNIX Getting Started

Exiting vxitedit and Reinitializing the Hardware

To exit 

vxitedit

, type the number 

11

 when the main menu is displayed or type 

exit

.  If you

changed any information, the program prompts you to save your changes before exiting the menu.
Saving the configuration information updates the configuration files 

vxila.cfg

 and

vxibus.cfg

.  Do not modify the  

vxidev.cfg

 file, which contains some system-dependent

timer information used by the 

vxiinit

 program.  Run 

vxiinit.exe

 to reinitialize the hardware

according to the new settings.

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.  Be sure to check the 

readme.doc

 file for the latest

application development notes.  Remember that you must run the 

vxiinit

 initialization program

before performing any VXI operations and after each system reset.

Use the VXI Text Interactive Control (

victext

) program to communicate with VXI devices

through commands you enter at the keyboard.  This feature helps you learn how to communicate
with devices, troubleshoot problems, and develop your application.

The 

victext

 command set includes the same capability of NI-VXI function calls in addition to

auxiliary commands that are unique to 

victext

.  You can use this utility to send data and Word

Serial commands to devices from the keyboard and to display data received from devices on the
screen.  After each function executes, 

victext

 displays the device's response and the status.

The 

victext

 utility is designed to help you learn how to use the NI-VXI functions to program

devices.  Once you develop a sequence of steps that works successfully for your system, you can
easily incorporate the sequence into an application program using appropriate language and syntax.

The file 

cvxi

.

c

 interfaces between your C language application program and the operating system

entry points to the VXI driver.  The functions available in 

cvxi

.

c

 are described in detail in the NI-

VXI Software Reference Manual for C.  To use these functions, you must link to 

cvxi

.

o

.  The NI-

VXI C language interface file, 

cvxi.o

, included with your software distribution, is a combined

object file from 

cvxi.c

 and 

IO.c

.  If you need to recompile the language interface, compile

cvxi.c

 to a temporary object file, and link this object file with 

IO.o

, using incremental linker.

Name the resulting object file 

cvxi.o

 to have a linkable object code for interface.  To invoke

incremental linker, type the following statement:

ld -r -o cvxi.o cvxitemp.o IO.o

cvxitemp.o

 is the object file created by compiling 

cvxi.c

, and

 

cvxi.o

 is the resulting object

file.  Include the resulting object file during the link phase of each application compile operation.

The 

/example

 subdirectory contains various example programs along with a makefile that show

how to use various functions in the NI-VXI software and how to develop application programs using
these functions.

Summary of Contents for VXI-AT2022

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

Page 2: ...ices 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...

Page 3: ...tional Instruments be liable for any damages arising out of or related to this document or the information contained in it EXCEPT AS SPECIFIED HEREIN NATIONAL INSTRUMENTS MAKES NO WARRANTIES EXPRESS O...

Page 4: ...or application designer 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 an...

Page 5: ...ference from the equipment to radio reception in commercial areas Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to c...

Page 6: ...ection 2 6 DMA Channel Selection 2 8 Master Mode Versus Slave Mode 2 8 Step 3 Install the AT MXI Hardware 2 11 Step 4 Configure the VXI MXI Hardware 2 13 Front Panel Features 2 15 Removing the Metal E...

Page 7: ...Used by Another Device B 4 Problems with Mouse B 4 Problems with MXIbus Cable B 5 Appendix C Customer Communication C 1 Glossary Glossary 1 Figures Figure 2 1 AT MXI Parts Locator Diagram 2 2 Figure 2...

Page 8: ...Getting Started 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 Configuratio...

Page 9: ...on contains the instructions to configure and install the VXI AT2022 interface kit Chapter 3 NI VXI Software Installation and Configuration lists the programs and files located on the NI VXI distribut...

Page 10: ...otes the messages and responses that the computer automatically prints to the screen Abbreviations acronyms metric prefixes mnemonics symbols and terms are listed in the Glossary How to Use the Docume...

Page 11: ...tender Specification Rev 1 0 VXIbus Consortium available from National Instruments Corporation part number 340258 01 VXI MXI User Manual part number 320222 01 IEEE Standard for a Versatile Backplane B...

Page 12: ...AT MXI Interface Board 180775 01 Standard VXI MXI Interface Module 181045 01 or Enhanced VXI MXI Interface Module with INTX option 181045 02 3 5 in NI VXI Distribution Diskette for the AT MXI and SCO...

Page 13: ...t Angle Daisy Chain Connectors 1 m 180760 01 2 m 180760 02 4 m 180760 04 8 m 180760 08 20 m 180760 20 Type M3 MXIbus Cables Right Angle Point to Right Angle Daisy Chain Connectors 1 m 180761 01 2 m 18...

Page 14: ...ears to have been caused in shipment file a claim with the carrier Retain the packing material for possible inspection and or for reshipment 2 Verify that the pieces contained in the package you recei...

Page 15: ...XI SCO UNIX Getting Started 2 2 National Instruments Corporation Step 2 Configure the AT MXI Hardware Figure 2 1 shows the location of the AT MXI configuration jumpers and switches Figure 2 1 AT MXI P...

Page 16: ...ge the configuration switches and or jumpers on the AT MXI and how to make these changes Base I O Address Selection The base I O address of the AT MXI is the starting address of the AT MXI configurati...

Page 17: ...anged therefore bits A4 through A0 are always zeros when determining the base I O address To change the base I O address of the AT MXI press the side marked OFF to select a binary value of 1 for the c...

Page 18: ...AT motherboard and cannot be used by I O adapter modules Table 2 2 Possible Base I O Address Settings for the AT MXI Switch Setting Base I O Address I O Ports Used A9 A8 A7 A6 A5 hex hex 0 1 0 0 0 100...

Page 19: ...the PC AT interrupt level that will convey board status and error information Remember to enable this level or board interrupt in the system software for the AT MXI to function properly The factory de...

Page 20: ...dge connector to select the board interrupt level and the two rows of pins closer to the card edge connector to select the MXIbus interrupt level Figure 2 3a shows the factory default interrupt jumper...

Page 21: ...apped into a MXIbus cycle intended for some external MXIbus device such as a VXIbus mainframe As a MXIbus slave the AT MXI circuitry determines whether an external device is attempting to access PC AT...

Page 22: ...forth between A16 and A24 space it would be easier to have a slave DMA channel already reserved for the AT MXI and just change the appropriate settings in vxitedit Remember that the hardware and softw...

Page 23: ...d slave mode DMA Channel 3 a Factory Default DMA Channel Jumper Setting Master Mode Channel 6 Slave Mode Channel 3 DACK7 DACK6 DACK5 DACK3 DACK2 DACK1 DACK0 W2 Slave Master DRQ7 DRQ6 DRQ5 DRQ3 DRQ2 DR...

Page 24: ...end slots so that you will only have to contend with the cable connectors of one other board If you cannot configure the AT MXI to co exist in an existing PC AT system by repositioning the boards you...

Page 25: ...y static electricity that might be on your clothes or body 6 Line up the AT MXI with the MXIbus connector near the cut out on the back panel and the other card edge lined up with the respective slot g...

Page 26: ...hout the INTX daughter card option The remainder of this chapter describes only those options that are user configurable Do not change the default settings of other jumpers and switches on the VXI MXI...

Page 27: ...the configuration switches and jumpers for a VXI MXI with the INTX daughter card option The options described in the rest of this chapter apply to VXI MXI modules with or without the INTX option For...

Page 28: ...d not be necessary to remove it under normal circumstances Should you find it necessary to open the enclosure remove the three screws on the top the three screws on the bottom and the three screws on...

Page 29: ...onal Instruments Corporation S8 must match S1 S8 Non Slot 0 Slot 0 S1 must match S8 S1 S l o t 0 N o n S l o t 0 W7 VME BTO Chain Position Drive CLK10 from onboard 10MHz Slot 0 Drive CLK10 from SMB CL...

Page 30: ...I SCO UNIX Getting Started S l o t 0 S8 must match S1 S8 N o n S l o t 0 Non Slot 0 Slot 0 S1 must match S8 S1 W7 VME BTO Chain Position Drive CLK10 from onboard 10MHz Slot 0 Drive CLK10 from SMB CLK1...

Page 31: ...sponded The VXI MXI must provide the VMEbus BTO to function properly because when a MXIbus cycle is involved the VMEbus timeout must be disabled and the MXIbus BTO enabled You should disable the BTO o...

Page 32: ...ddress hex 1 and C0 Shown at Default setting of Logical Address 1 LOGICAL ADDRESS SWITCH Push this side down for logic 0 Push this side down for logic 1 OFF ON 1 2 3 4 5 6 7 8 OFF 1 2 3 4 5 6 7 8 a Sw...

Page 33: ...ng the jumper configuration on the jumper blocks labeled VMEbus Request Level on the front panel You may want to change request levels to change the priority of the VXI MXI request signal For more inf...

Page 34: ...g C size cards in D size mainframes Warning Be certain that the slot you select in your VXIbus mainframe matches the VXI MXI configuration as either a Slot 0 device or a Non Slot 0 device If you insta...

Page 35: ...onnector 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 connect...

Page 36: ...nnect the end with the single connector to the AT MXI and the end of the cable with the double connector to the VXI MXI Be sure to tighten the screw locks to ensure proper pin connection See Figure 2...

Page 37: ...program that executes functions you enter from the keyboard It helps you learn the functions program your VXI device and develop and debug your application program This program is described in detail...

Page 38: ...s the system interrupt configuration information trigcfg tbl contains TTL trigger configuration editor information utilbus tbl contains the utility bus configuration editor information resman tbl is a...

Page 39: ...bes how to install the NI VXI software Step 1 Set Up a Working Directory 1 Log on as root 2 Create a working directory for example usr nivxi and change to that directory cd usr mkdir nivxi cd nivxi 3...

Page 40: ...hout rebuilding the kernel and you can proceed to the following section You can rebuild the kernel at a later time by using the link_unix program in the etc conf cf d directory If you select y the pro...

Page 41: ...environment variable depends on the shell you are using Refer to the manual that came with the shell you are using for instructions on how to set an environment variable For example for the Bourne sh...

Page 42: ...tics of the software will remain in effect Using vxitedit To run the VXI resource editor program type vxitedit Select the Configuration Editor from the main menu The three configuration options availa...

Page 43: ...40 Master Window Base A 64 KB memory mapped I O window which the AT MXI board uses to access the VXIbus Range A000h to E000h in increments of 1000h hex 0xD000 Address Space Indicates the address space...

Page 44: ...A16 space resman does not handle any device requesting memory in A16 space including the AT MXI resman does not give a warning in the event of an address conflict in A16 space Also the opening of A16...

Page 45: ...A24 space or the PC I O in A16 space This value must correspond to jumper settings on the AT MXI board You can select the NONE option with any jumper settings Range 0 1 2 3 5 6 7 0xff NONE Note If you...

Page 46: ...vices equal opportunity to become bus masters and transfer data regardless of their position within the MXIbus daisy chain MXIbus devices that are not fair requesters have a fixed priority scheme char...

Page 47: ...function calls in addition to auxiliary commands that are unique to victext You can use this utility to send data and Word Serial commands to devices from the keyboard and to display data received fro...

Page 48: ...Mode A32 A24 and A16 addressing MBLT Master Mode block transfers SA24 Slave Mode A24 and A16 addressing SBLT Slave Mode block transfers MD16 Master Mode D16 and D08 data sizes SD16 Slave Mode D16 and...

Page 49: ...67 to 302 F storage Emissions FCC Class A Relative Humidity 0 to 95 noncondensing operating 0 to 100 noncondensing storage Safety Not applicable Shock and Vibration Not applicable Physical Board Size...

Page 50: ...Master Mode Slave Mode Transfer Type Transfer Rate Transfer Type Transfer Rate Write 530 nsec Write 840 nsec Read 430 nsec Read 840 nsec Block Write 290 nsec Block Write 590 nsec Block Read 190 nsec B...

Page 51: ...8 EO Slave Mode D32 D16 and D08 data sizes MBLOCK Master Mode block transfers SBLOCK Slave Mode block transfers MRMW Master Mode Read Modify Write SRMW Slave Mode Read Modify Write PRI Prioritized arb...

Page 52: ...er Mode D32 D16 and D08 data sizes SD32 SD16 SD08 EO Slave Mode D32 D16 and D08 data sizes MBLOCK Master Mode block transfers SBLOCK Slave Mode block transfers SC Optional MXIbus System Controller FAI...

Page 53: ...ssions FCC Class A Safety Not applicable Shock and Vibration Not applicable Physical Board size Fully shielded VXI C size board 233 35 mm by 340 mm 9 187 in by 13 386 in Connectors Single fully implem...

Page 54: ...ster Mode Slave Mode Transfer Type Transfer Rate Transfer Type Transfer Rate Write 675 5 nsec Write 381 nsec Read 625 5 nsec Read 381 nsec Block Write 320 nsec Block Write 238 nsec Block Read 270 nsec...

Page 55: ...ble s For proper operation the AT MXI requires the allocation of the following system resources 32 bytes of I O register space At least one interrupt level that cannot be shared with another device A...

Page 56: ...e settings correspond to the hardware setting try the following methods to deal with this problem 1 Ensure that you are using the proper vxiinit program for your system For example the vxiinit program...

Page 57: ...your system and set the AT MXI to use this level Refer to the DMA Channel Selection section of Chapter 2 for instructions on making this hardware change 3 After you change the AT MXI slave DMA channel...

Page 58: ...Ethernet networking cards be aware that many of them occupy upper memory Many Ethernet cards have an upper memory base address of D000h or E000h Problems with Mouse If you notice your mouse behaving...

Page 59: ...the proper electrical connection 2 Make sure the each end of the MXIbus cable is plugged into the proper connector Certain MXIbus cables have a single point connector on one end and a daisy chain con...

Page 60: ...are available Monday through Friday from 8 00 a m to 6 00 p m central time In other countries contact the nearest branch office You may fax questions to us at any time Corporate Headquarters 512 795 8...

Page 61: ...g any National Instruments hardware or software products related to this problem include the configuration forms from their user manuals Use additional pages if necessary Name Company Address Fax Phon...

Page 62: ...Master DMA Channel __________________________________________________ AT MXI Board Interrupt Level __________________________________________________ AT MXI Slave I O Window Base _____________________...

Page 63: ...Programming Language Version __________________________________________________ Other Boards in System __________________________________________________ Base I O Address of Other Boards _____________...

Page 64: ...Edition Date August 1993 Part Number 320262 01 Please comment on the completeness clarity and organization of the manual If you find errors in the manual please record the page numbers and describe t...

Page 65: ...equivalent to the VME 16 MB standard address space A32 space VXIbus address space equivalent to the VME 4 GB extended address space address Character code that identifies a specific location or series...

Page 66: ...the address on subsequent transfers so that the next element is transferred to or from the proper storage location In VME the data transfer may have no more than 256 elements MXI does not have this re...

Page 67: ...artup or other configuration times dynamically A device that has its logical address assigned by the Resource Manager configured device A VXI device initially responds at Logical Address 255 when its...

Page 68: ...with base 16 using the digits 0 to 9 and letters A to F Hz hertz cycles per second I IC Integrated Circuit IEEE Institute of Electrical and Electronics Engineers in inches I O input output the techniq...

Page 69: ...e defined VXIbus registers and device communication protocols These devices are able to use Word Serial Protocol to communicate with one another through communication registers MODID Module Identifica...

Page 70: ...controlled by a Commander there are Message Based and Register Based Servants Shared Memory A communication protocol that uses a block of memory that is accessible Protocol to both a client and a serv...

Page 71: ...0 Device Controller VXIbus VMEbus Extensions for Instrumentation vxiinit A program in the NI VXI bus interface software package that initializes the board interrupts shared RAM VXI register configura...

Reviews: