Instruction/ maintenance manual of the product NI-VXI National Instruments
Go to page of 149
NI-VXI ™ User Manual July 1996 Edition Part Number 3 71702A-01 © Copyright 1996 National Instruments Corporation. All Rights Reserved..
Internet Support GPIB: gpib.support@natinst.com DAQ: daq.support@natinst.com VXI: vxi.support@natinst.com LabVIEW: lv.support@natinst.com LabWindows: lw.support@natinst.com HiQ: hiq.support@natinst.com VISA: visa.support@natinst.com Lookout: lookout.support@natinst.
Important Information Warranty The media on which you receive National Instruments software are warranted not to fail to execute programming instructions, due to defects in materials and workmanship, for a period of 90 days from date of shipment, as evidenced by receipts or other documentation.
© National Instruments Corporation v NI-VXI User Manual Table of Contents About This Manual Organization of This Manual ..................................................................................... xiii Conventions Used in This Manual .
Table of Contents NI-VXI User Manual vi © National Instruments Corporation Multiple Mainframe Support ..................................................................................... 2-5 Controllers ..............................................
Table of Contents © National Instruments Corporation vii NI-VXI User Manual WSLcmd ..................................................................................................... 3-11 WSLresp ....................................................
Table of Contents NI-VXI User Manual viii © National Instruments Corporation VXIout......................................................................................................... 3-25 VXIoutReg ..............................................
Table of Contents © National Instruments Corporation ix NI-VXI User Manual VXI Interrupt Functions ............................................................................................ 3-43 Programming Considerations ..........................
Table of Contents NI-VXI User Manual x © National Instruments Corporation DefaultSoftResetHandler............................................................................. 3-61 DefaultSysfailHandler ................................................
Table of Contents © National Instruments Corporation xi NI-VXI User Manual Figures Figure 1-1. VXI Configuration Registers ................................................................ 1-2 Figure 1-2. VXI Software Protocols .......................
© National Instruments Corporation xiii NI-VXI User Manual About This Manual This manual describes in detail the features of the NI-VXI software and the VXI/VME function calls in the C/C++ and BASIC languages.
About This Manual NI-VXI User Manual xiv © National Instruments Corporation • Appendix B, Customer Communication , contains forms you can use to request help from National Instruments or to comment on our manuals.
About This Manual © National Instruments Corporation xv NI-VXI User Manual Related Documentation The following documents contain information that you may find helpful as you read this manual: • IEEE Standard for a Versatile Backplane Bus: VMEbus , ANSI/IEEE Standard 1014-1987 • Multisystem Extension Interface Bus Specification , Version 2.
© National Instruments Corporation 1-1 NI-VXI User Manual Overview of NI-VXI Chapter 1 This chapter introduces you to the concepts of VXI (VME eXtensions for Instrumentation), VME, MXI (Multisystem eXtension Interface), and their relationship to the NI-VXI application programmer’s interface (API).
Chapter 1 Overview of NI-VXI NI-VXI User Manual 1-2 © National Instruments Corporation Reserved Reserved Reserved Reserved Data Low Data High Response/Data Extended Protocol/Signal Offset Status/C.
Chapter 1 Overview of NI-VXI © National Instruments Corporation 1-3 NI-VXI User Manual Message-Based Devices In addition to register-based devices, the VXIbus specification also defines message-based devices, which are required to have communication registers in addition to configuration registers.
Chapter 1 Overview of NI-VXI NI-VXI User Manual 1-4 © National Instruments Corporation a fashion very similar to IEEE 488 instruments. In general, message-based devices typically contain some level of local intelligence that uses or requires a high level of communication.
Chapter 1 Overview of NI-VXI © National Instruments Corporation 1-5 NI-VXI User Manual register. Devices that do not have bus master capability always transmit such information via interrupts, whereas devices that do have bus master capability can either use interrupts or send signals.
Chapter 1 Overview of NI-VXI NI-VXI User Manual 1-6 © National Instruments Corporation Because MXI-2 incorporates all of these new signals into a single connector, the triggers, interrupts, and utility signals can be extended not only to other mainframes but also to the local CPU in all MXI-2 products using a single cable.
© National Instruments Corporation 2-1 NI-VXI User Manual Introduction to the NI-VXI Functions Chapter 2 This chapter introduces you to the NI-VXI functions and their capabilities. Additional discussion is provided for each function’s parameters and includes descriptions of the application development environment.
Chapter 2 Introduction to the NI-VXI Functions NI-VXI User Manual 2-2 © National Instruments Corporation • Low-Level VXIbus Access Functions —Low-level VXI/VMEbus access functions are the fastest access method for directly reading from or writing to any of the VXI/VMEbus address spaces.
Chapter 2 Introduction to the NI-VXI Functions © National Instruments Corporation 2 - 3 NI-VXI User Manual of the VXI/VME interrupt lines, VXI TTL triggers, VXI ECL triggers, and utility bus signals. The National Instruments Resource Manager configures the mainframe extenders with settings based on user-modifiable configuration files.
Chapter 2 Introduction to the NI-VXI Functions NI-VXI User Manual 2-4 © National Instruments Corporation LabWindows/CVI You can use the functions described in this manual with LabWindows/CVI. LabWindows/CVI is an integrated development environment for building instrumentation applications using the ANSI C programming language.
Chapter 2 Introduction to the NI-VXI Functions © National Instruments Corporation 2 - 5 NI-VXI User Manual Because value is an output parameter, &value is used when calling the function instead of value . The input parameters are la and reg . Return Values and System Errors All NI-VXI functions return a status indicating success or failure.
Chapter 2 Introduction to the NI-VXI Functions NI-VXI User Manual 2-6 © National Instruments Corporation cable connected towards the root frame) in the frame acts as a remote controller. An embedded or external controller may use a remote controller to control the remote mainframe.
Chapter 2 Introduction to the NI-VXI Functions © National Instruments Corporation 2 - 7 NI-VXI User Manual bus NATIONAL INSTRUMENTS ® bus NATIONAL INSTRUMENTS ® bus NATIONAL INSTRUMENTS ® NATIONAL INSTRUMENTS ® bus Remote Controller and Extender Remote Controller and Extender External Controller Extender Only Figure 2-2 .
Chapter 2 Introduction to the NI-VXI Functions NI-VXI User Manual 2-8 © National Instruments Corporation Most functions that take a controller parameter will allow you to pass (-1) as the logical address. This selects the default controller for the system.
Chapter 2 Introduction to the NI-VXI Functions © National Instruments Corporation 2 - 9 NI-VXI User Manual Using NI-VXI This section presents a general overview of the more commonly used class of functions available in NI-VXI.
Chapter 2 Introduction to the NI-VXI Functions NI-VXI User Manual 2-10 © National Instruments Corporation The busacc.h File The busacc.h file defines constants and macros for use with the high/low-level and slave memory access functions (see the Master Memory Access and Slave Memory Access sections later in this chapter).
Chapter 2 Introduction to the NI-VXI Functions © National Instruments Corporation 2 - 11 NI-VXI User Manual An important note about these two functions is that the internal structure maintains a record of the number of calls to InitVXIlibrary() and CloseVXIlibrary().
Chapter 2 Introduction to the NI-VXI Functions NI-VXI User Manual 2-12 © National Instruments Corporation For example, all VXI devices have at least one logical address by which they can be accessed. However, it is simple to change the logical address of most devices.
Chapter 2 Introduction to the NI-VXI Functions © National Instruments Corporation 2 - 13 NI-VXI User Manual Word Serial Communication When communicating with a message-based devices (MBD) in VXI, the protocol for string passing is known as Word Serial .
Chapter 2 Introduction to the NI-VXI Functions NI-VXI User Manual 2-14 © National Instruments Corporation Master Memory Access You can access VXIbus memory directly through the NI-VXI high-level and low-level VXIbus access functions, within the capabilities of the controller.
Chapter 2 Introduction to the NI-VXI Functions © National Instruments Corporation 2 - 15 NI-VXI User Manual timeout = 2000L; /* 2 seconds */ /* Notice the use of the macros for defining the access */ /* parameters.
Chapter 2 Introduction to the NI-VXI Functions NI-VXI User Manual 2-16 © National Instruments Corporation Note: On modern, 32-bit operating systems running on high-performance processors (such as Microsoft Windows NT on a Pentium or Solaris 2 on a SPARC), we have found no performance gained by using macros instead of functions.
Chapter 2 Introduction to the NI-VXI Functions © National Instruments Corporation 2 - 17 NI-VXI User Manual /* At this point, the remote master can perform */ /* I/O on the shared, allocated space.
Chapter 2 Introduction to the NI-VXI Functions NI-VXI User Manual 2-18 © National Instruments Corporation Alternatively, you can choose to handle either signals or interrupts with a callback handler. You can use RouteSignal() to specify that the events should be handled by the callback handlers rather than the signal queue.
Chapter 2 Introduction to the NI-VXI Functions © National Instruments Corporation 2 - 19 NI-VXI User Manual Note: Although NI-VXI simplifies the installation and use of callback handlers, it cannot affect how the system handles interrupts. The programmer must follow programming guidelines set by the chosen operating system.
© National Instruments Corporation 3-1 NI-VXI User Manual Software Overview Chapter 3 This chapter describes the C/C++ and BASIC usage of VXI and VME functions and briefly describes each function. Functions are listed alphabetically in each functional group.
Chapter 3 Software Overview NI-VXI User Manual 3-2 © National Instruments Corporation CloseVXIlibrary () CloseVXIlibrary is the application termination routine, which must be included at the end (or abort) of any application. CloseVXIlibrary disables interrupts and frees dynamic memory allocated for the internal RM table and other structures.
Chapter 3 Software Overview © National Instruments Corporation 3-3 NI-VXI User Manual GetDevInfo (la, field, fieldvalue) GetDevInfo returns information about the specified device from the NI-VXI RM table. The field parameter specifies the attribute of the information to retrieve.
Chapter 3 Software Overview NI-VXI User Manual 3-4 © National Instruments Corporation InitVXIlibrary () InitVXIlibrary is the NI-VXI initialization routine. An application must call InitVXIlibrary at application startup. InitVXIlibrary performs all necessary installation and initialization procedures to make the NI-VXI interface functional.
Chapter 3 Software Overview © National Instruments Corporation 3-5 NI-VXI User Manual SetDevInfoShort (la, field, shortvalue) SetDevInfoShort changes information about the specified device in the NI-VXI RM table. The field parameter specifies the attribute of the information to change.
Chapter 3 Software Overview NI-VXI User Manual 3-6 © National Instruments Corporation • Buffer writes • Buffer reads The Word Serial Protocol is a 16-bit transfer protocol between a Commander and its Servants.
Chapter 3 Software Overview © National Instruments Corporation 3-7 NI-VXI User Manual In addition to the four basic types of Word Serial transfers, there are two special cases: the Word Serial Clear and Trigger commands. The Word Serial Clear command must ignore the ERR* bit.
Chapter 3 Software Overview NI-VXI User Manual 3-8 © National Instruments Corporation The WSabort function is the only exception to this restriction. WSabort is used to abort various Word Serial transfers in progress and will usually be called from an interrupt service routine (although it is not limited to interrupt service routines).
Chapter 3 Software Overview © National Instruments Corporation 3-9 NI-VXI User Manual Figure 3-1 gives a precise description of this two-level mutual exclusion algorithm. Notice that this mutual exclusion is on a per logical address basis. Any number of logical addresses can have Word Serial transfers in progress without conflict.
Chapter 3 Software Overview NI-VXI User Manual 3-10 © National Instruments Corporation until the transfer is complete or a timeout occurs. This support also keeps a word serial device which is not responding from “hanging” on the local CPU.
Chapter 3 Software Overview © National Instruments Corporation 3-11 NI-VXI User Manual WSEcmd (la, cmdExt, cmd, respflag, response) WSEcmd sends an Extended Word Serial command or query to a message-based Servant. It polls the WR bit before sending the 48-bit command.
Chapter 3 Software Overview NI-VXI User Manual 3-12 © National Instruments Corporation Normally, you would use the WSLcmd function to send Longword Serial queries with the response automatically read (specified with respflag ).
Chapter 3 Software Overview © National Instruments Corporation 3-13 NI-VXI User Manual Normally, you would use the WScmd function to send Word Serial queries with the response automatically read (specified with respflag ).
Chapter 3 Software Overview NI-VXI User Manual 3-14 © National Instruments Corporation WSwrtf (la, filename, count, modevalue, retcount) WSwrtf is an extension of the WSwrt function. WSwrtf writes a specified number of bytes from the specified file to a message-based Servant using the VXIbus Byte Transfer Protocol.
Chapter 3 Software Overview © National Instruments Corporation 3-15 NI-VXI User Manual A buffer write is a series of Byte Available Word Serial commands sent to the Servant, with the additional constraint that the Data In Ready (DIR) bit as well as the WR bit must be asserted before sending the Byte Available command.
Chapter 3 Software Overview NI-VXI User Manual 3-16 © National Instruments Corporation (DIR, DOR, WR, RR, and ERR*) are done automatically within the functions as required. Figure 3-2 provides a graphical overview of the Servant Word Serial functions.
Chapter 3 Software Overview © National Instruments Corporation 3-17 NI-VXI User Manual DefaultWSScmdHandler (cmd) DefaultWSScmdHandler is the default handler for the WSSwrt interrupt, which InitVXIlibrary automatically installs when it initializes the NI-VXI software.
Chapter 3 Software Overview NI-VXI User Manual 3-18 © National Instruments Corporation DefaultWSSLcmdHandler calls GenProtError with a protocol error code of UnSupCom for every Longword Serial command received.
Chapter 3 Software Overview © National Instruments Corporation 3-19 NI-VXI User Manual GetWSSEcmdHandler () GetWSSEcmdHandler returns the address of the current WSSEcmd interrupt handler function. While Word Serial operations are enabled, the WSSEcmd interrupt handler will be called every time an Extended Longword Serial command is received.
Chapter 3 Software Overview NI-VXI User Manual 3-20 © National Instruments Corporation default handler provides examples of how to parse commands, respond to queries, and generate protocol errors. SetWSSEcmdHandler (func) SetWSSEcmdHandler replaces the current WSSEcmd interrupt handler with an alternate handler.
Chapter 3 Software Overview © National Instruments Corporation 3-21 NI-VXI User Manual WSSabort (abortop) WSSabort aborts the Servant Word Serial operation(s) in progress. It returns an error code of ForcedAbort to the WSSrd or WSSwrt interrupt handlers in response to the corresponding pending functions.
Chapter 3 Software Overview NI-VXI User Manual 3-22 © National Instruments Corporation WSSnoResp () WSSnoResp sets the WR bit so that it is ready to accept any further Word Serial commands.
Chapter 3 Software Overview © National Instruments Corporation 3-23 NI-VXI User Manual High-Level VXI/VMEbus Access Functions You can use both low-level and high-level VXI/VMEbus access functions to read or write to VXI/VMEbus addresses.
Chapter 3 Software Overview NI-VXI User Manual 3-24 © National Instruments Corporation VXI/VMEbus access functions. You can use both high-level and low-level VXI/VMEbus access functions at the same time. The following paragraphs describe the high-level VXI/VMEbus access functions.
Chapter 3 Software Overview © National Instruments Corporation 3-25 NI-VXI User Manual address space for the source and destination, respectively. The width parameter selects either byte, word, or longword transfers.
Chapter 3 Software Overview NI-VXI User Manual 3-26 © National Instruments Corporation Low-Level VXI/VMEbus Access Functions This section describes the use of the low-level VXI/VMEbus access functions. You can use both low-level and high-level VXI/VMEbus access functions to directly read or write to VXI/VMEbus addresses.
Chapter 3 Software Overview © National Instruments Corporation 3-27 NI-VXI User Manual Programming Considerations All accesses to the VXI/VMEbus address spaces are performed by reads and writes to particular offsets within the local CPU address space, which are made to correspond to addresses on the VXI/VMEbus (using a hardware interface).
Chapter 3 Software Overview NI-VXI User Manual 3-28 © National Instruments Corporation Multiple-Pointer Access for a Window Application programmers can encounter a potential problem when the application requires different privilege states, byte orders, and/or base addresses within the same window.
Chapter 3 Software Overview © National Instruments Corporation 3-29 NI-VXI User Manual can have multiple pointers in the same process or over multiple processes to access a particular window simultaneously, while still guaranteeing that the hardware context does not change between accesses.
Chapter 3 Software Overview NI-VXI User Manual 3-30 © National Instruments Corporation GetByteOrder (window, ordermode) GetByteOrder retrieves the byte/word order of data transferred into or out of the specified window. The two possible settings are Motorola (most significant byte/word first) or Intel (least significant byte/word first).
Chapter 3 Software Overview © National Instruments Corporation 3-31 NI-VXI User Manual GetVXIbusStatusInd (controller, field, status) GetVXIbusStatusInd retrieves information about the current state of the VXI/VMEbus.
Chapter 3 Software Overview NI-VXI User Manual 3-32 © National Instruments Corporation MapVXIAddressSize (size) MapVXIAddressSize sets the size for mapping user windows. The subsequent calls to MapVXIAddress will attempt to map a window of the size passed to MapVXIAddressSize .
Chapter 3 Software Overview © National Instruments Corporation 3-33 NI-VXI User Manual SetPrivilege (window, priv) SetPrivilege sets the VXI/VMEbus windowing hardware to access the specified window with the specified VXI/VMEbus access privilege.
Chapter 3 Software Overview NI-VXI User Manual 3-34 © National Instruments Corporation Local Resource Access Functions Local resources are hardware and/or software capabilities that are reserved for the local CPU (the CPU on which the NI-VXI interface resides).
Chapter 3 Software Overview © National Instruments Corporation 3-35 NI-VXI User Manual VXIinLR (reg, width, value) VXIinLR reads a single byte, word, or longword from the local CPU VXI/VME registers. On many CPUs, the local CPU VXI/VME registers cannot be accessed from the local CPU in the A16 address space window (due to hardware limitations).
Chapter 3 Software Overview NI-VXI User Manual 3-36 © National Instruments Corporation VXIoutLR (reg, width, value) VXIoutLR writes a single byte, word, or longword to the local CPU VXI/VME registers. On many CPUs, the local CPU VXI/VME registers cannot be accessed from the local CPU in the A16 address space window (due to hardware limitations).
Chapter 3 Software Overview © National Instruments Corporation 3-37 NI-VXI User Manual VXI signals from message-based devices can be one of two types: Response signals and Event signals (bit 15 distinguishes between the two). Response signals are used to report changes in Word Serial communication status between a Servant and its Commander.
Chapter 3 Software Overview NI-VXI User Manual 3-38 © National Instruments Corporation Programming Considerations The global signal queue used to hold signal values is of a finite length. If the application is not handling signals fast enough, it is theoretically possible to fill the global signal queue.
Chapter 3 Software Overview © National Instruments Corporation 3-39 NI-VXI User Manual Figure 3-3 provides a graphical overview of the NI-VXI interrupt and signal functions.
Chapter 3 Software Overview NI-VXI User Manual 3-40 © National Instruments Corporation returned immediately to the caller and the process/function is not suspended. The following paragraphs describe the VXI signal functions and default handler. The descriptions are presented at a functional level describing the operation of each of the functions.
Chapter 3 Software Overview © National Instruments Corporation 3-41 NI-VXI User Manual GetSignalHandler (la) GetSignalHandler returns the address of the current signal handler for the specified VXI logical address.
Chapter 3 Software Overview NI-VXI User Manual 3-42 © National Instruments Corporation SignalDeq (la, signalmask, signal) SignalDeq retrieves signals from the global signal queue. Two methods are available to handle VXI signals. You can handle the signals either by handlers or by queueing on a global signal queue.
Chapter 3 Software Overview © National Instruments Corporation 3-43 NI-VXI User Manual VXI Interrupt Functions VXI/VME interrupts are a basic form of asynchronous communication used by devices with interrupter support. In VME, a device asserts a VME interrupt line and the VME interrupt handler device acknowledges the interrupt.
Chapter 3 Software Overview NI-VXI User Manual 3-44 © National Instruments Corporation specifies which types of signals are handled by signal handlers, and which are queued onto the global signal queue for each VXI logical address.
Chapter 3 Software Overview © National Instruments Corporation 3-45 NI-VXI User Manual DeAssertVXIint and AcknowledgeVXIint are intended only for debugging purposes. Programming Considerations Figure 3-4 is a graphical overview of the NI-VXI interrupt and signal model.
Chapter 3 Software Overview NI-VXI User Manual 3-46 © National Instruments Corporation ROAK Versus RORA VXI/VME Interrupters There are two types of VXI/VME interrupters.
Chapter 3 Software Overview © National Instruments Corporation 3-47 NI-VXI User Manual Normally, VXI/VME interrupts are automatically acknowledged when enabled via the function EnableVXIint .
Chapter 3 Software Overview NI-VXI User Manual 3-48 © National Instruments Corporation DefaultVXIintHandler sets the global variables VXIintController , VXIintLevel , and VXIintStatusId . You can leave this default handler installed or install a completely new handler using SetVXIintHandler .
Chapter 3 Software Overview © National Instruments Corporation 3-49 NI-VXI User Manual frame (for an embedded CPU) or the first extended controller (in an external CPU situation). EnableVXItoSignalInt (controller, levels) EnableVXItoSignalInt is used to sensitize the application to specified interrupt levels being processed as VXI signals.
Chapter 3 Software Overview NI-VXI User Manual 3-50 © National Instruments Corporation queue. The RouteSignal function specifies which types of signals should be handled by signal handlers, and which should be queued on the global signal queue for each VXI logical address.
Chapter 3 Software Overview © National Instruments Corporation 3-51 NI-VXI User Manual VXI Trigger Functions VXI triggers are a backplane feature that VXI added to the VME standard. Tight timing and signaling is important between many types of controllers and/or instruments.
Chapter 3 Software Overview NI-VXI User Manual 3-52 © National Instruments Corporation maximum time from source assertion edge). The accepting device(s) can later unassert the trigger line (no maximum time is specified) to complete the handshake. • START/STOP —START/STOP is a one-line, multiple-device protocol.
Chapter 3 Software Overview © National Instruments Corporation 3-53 NI-VXI User Manual general, however, National Instruments hardware has two current configurations that provide triggering functiona.
Chapter 3 Software Overview NI-VXI User Manual 3-54 © National Instruments Corporation Embedded, External MXI-2, and Remote Controller Trigger Capabilities National Instruments has developed a highly functional ASIC specifically designed for use within the VXIbus triggering environment called the Trigger Interface Chip (TIC).
Chapter 3 Software Overview © National Instruments Corporation 3-55 NI-VXI User Manual AcknowledgeTrig (controller, line) AcknowledgeTrig performs the required trigger acknowledgments for the ASYNC or SEMI-SYNC VXI-defined protocol, as configured via the EnableTrigSense function.
Chapter 3 Software Overview NI-VXI User Manual 3-56 © National Instruments Corporation GetTrigHandler (line) GetTrigHandler returns the address of the current trigger handler for the specified VXI trigger line.
Chapter 3 Software Overview © National Instruments Corporation 3-57 NI-VXI User Manual crosspoint switch configurator (depending on the hardware capabilities of the applicable device).
Chapter 3 Software Overview NI-VXI User Manual 3-58 © National Instruments Corporation Trigger Configuration Functions You can use the NI-VXI trigger configuration functions to configure not only the general settings of the trigger inputs and outputs, but also the TIC counter and tick timers.
Chapter 3 Software Overview © National Instruments Corporation 3-59 NI-VXI User Manual panel. GPIO 3 is fed back in as the EXTCLK signal used for signal conditioning modes with MapTrigToTrig . The six remaining GPIOs are dependent upon the hardware platform.
Chapter 3 Software Overview NI-VXI User Manual 3-60 © National Instruments Corporation The following paragraphs describe the system interrupt handler functions and default handlers. The descriptions are presented at a functional level describing the operation of each of the functions.
Chapter 3 Software Overview © National Instruments Corporation 3-61 NI-VXI User Manual low-level VXI/VMEbus access functions will be reported to this handler.
Chapter 3 Software Overview NI-VXI User Manual 3-62 © National Instruments Corporation DefaultSysresetHandler (controller) DefaultSysresetHandler is the sample handler for the Sysreset interrupt, and is installed as a default handler when InitVXIlibrary initializes the NI-VXI software.
Chapter 3 Software Overview © National Instruments Corporation 3-63 NI-VXI User Manual state, the failed device clears its PASS bit (in its Status register) and asserts the SYSFAIL* signal on the VXIbus backplane.
Chapter 3 Software Overview NI-VXI User Manual 3-64 © National Instruments Corporation specification requires that all VXI Commanders monitor the PASSed or FAILed state of their VXI Servants.
Chapter 3 Software Overview © National Instruments Corporation 3-65 NI-VXI User Manual GetSoftResetHandler () GetSoftResetHandler returns the address of the current Soft Reset interrupt handler. A default handler, DefaultSoftResetHandler , is automatically installed when InitVXIlibrary initializes the NI-VXI software.
Chapter 3 Software Overview NI-VXI User Manual 3-66 © National Instruments Corporation errors at times and valid results at other times. The InitVXIlibrary function automatically installs a default handler, DefaultBusErrorHandler , when it initializes the NI-VXI software.
Chapter 3 Software Overview © National Instruments Corporation 3-67 NI-VXI User Manual VXI/VMEbus Extender Functions The NI-VXI software interface fully supports the standard VXIbus extension method presented in the VXIbus Mainframe Extender Specification .
Chapter 3 Software Overview NI-VXI User Manual 3-68 © National Instruments Corporation you can use MapTTLtrig to configure the mainframe-to-mainframe mapping. The NI-VXI Resource Manager automatically configures a default mapping based on the user-modifiable configuration files.
© National Instruments Corporation 1 A-1 NI-VXI User Manual Function Classification Reference A Appendix This appendix contains two tables you can use as a quick reference. Table A-1, Function Listing by Group , lists the NI-VXI functions by their group association.
Appendix A Function Classification Reference NI-VXI User Manual A - 2 © National Instruments Corporation Table A-1. Function Listing by Group Group Function VXI VME C/C++ BASIC Commander WSabort ✔.
Appendix A Function Classification Reference © National Instruments Corporation A -3 NI-VXI User Manual Table A-1. Function Listing by Group Group Function VXI VME C/C++ BASIC Servant Word SetWSSwrtH.
Appendix A Function Classification Reference NI-VXI User Manual A - 4 © National Instruments Corporation Table A-1. Function Listing by Group Group Function VXI VME C/C++ BASIC Local Resource GetMyLa.
Appendix A Function Classification Reference © National Instruments Corporation A -5 NI-VXI User Manual Table A-1. Function Listing by Group Group Function VXI VME C/C++ BASIC VXI/VME RouteVXIint ✔.
Appendix A Function Classification Reference NI-VXI User Manual A - 6 © National Instruments Corporation Table A-1. Function Listing by Group Group Function VXI VME C/C++ BASIC System Interrupt Disab.
Appendix A Function Classification Reference © National Instruments Corporation A -7 NI-VXI User Manual Table A-2. Function Listing by Name Function Group VXI VME C/C++ BASIC AcknowledgeTrig Triggers.
Appendix A Function Classification Reference NI-VXI User Manual A - 8 © National Instruments Corporation Table A-2. Function Listing by Name Function Group VXI VME C/C++ BASIC DisableACfail System In.
Appendix A Function Classification Reference © National Instruments Corporation A -9 NI-VXI User Manual Table A-2. Function Listing by Name Function Group VXI VME C/C++ BASIC GetContext Low-Level VXI.
Appendix A Function Classification Reference NI-VXI User Manual A - 10 © National Instruments Corporation Table A-2. Function Listing by Name Function Group VXI VME C/C++ BASIC InitVXIlibrary System .
Appendix A Function Classification Reference © National Instruments Corporation A -11 NI-VXI User Manual Table A-2. Function Listing by Name Function Group VXI VME C/C++ BASIC SetSignalHandler VXI Si.
Appendix A Function Classification Reference NI-VXI User Manual A - 12 © National Instruments Corporation Table A-2. Function Listing by Name Function Group VXI VME C/C++ BASIC Access VXIinReg High-L.
Appendix A Function Classification Reference © National Instruments Corporation A -13 NI-VXI User Manual Table A-2. Function Listing by Name Function Group VXI VME C/C++ BASIC WSrdf Commander Word Se.
© National Instruments Corporation B -1 NI-VXI User Manual Customer Communication B Appendix 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.
FaxBack Support FaxBack is a 24-hour information retrieval system containing a library of documents on a wide range of technical information. You can access FaxBack from a touch-tone telephone at (512) 418-1111.
Technical Support Form Photocopy this form and update it each time you make changes to your software or hardware, and use the completed copy of this form as a reference for your current configuration.
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: NI-VXI™ User Manual Edition Date: July 1996 Part Number : 3 71702 A-01 Please comment on the completeness, clarity, and organization of the manual.
© National Instruments Corporation G-1 NI-VXI User Manual Glossary Prefix Meaning Value n- nano- 10 -9 m- milli- 10 -3 K- kilo- 10 3 M- mega- 10 6 G- giga- 10 9 A A16 space One of the VXIbus address spaces. Equivalent to the VME 64 KB short address space.
Glossary NI-VXI User Manual G- 2 © National Instruments Corporation address modifier One of six signals in the VMEbus specification used by VMEbus masters to indicate the address space and mode (supervisory/nonprivileged, data/program/block) in which a data transfer is to take place.
Glossary © National Instruments Corporation G-3 NI-VXI User Manual BAV Word Serial Byte Available command. Used to transfer 8 bits of data from a Commander to its Servant under the Word Serial Protocol.
Glossary NI-VXI User Manual G- 4 © National Instruments Corporation C clearing Replacing the information in a register, storage location, or storage unit with zeros or blanks.
Glossary © National Instruments Corporation G-5 NI-VXI User Manual D Data Transfer Bus 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. decimal Numbering system based upon the 10 digits 0 to 9.
Glossary NI-VXI User Manual G- 6 © National Instruments Corporation EOS End Of String; a character sent to designate the last byte of a data message. ERR Protocol error Event signal A 16-bit value wr.
Glossary © National Instruments Corporation G-7 NI-VXI User Manual GPIO General-Purpose Input Output, a module within the National Instruments TIC chip which is used for two purposes. First, GPIOs are used for connecting external signals to the TIC chip for routing/conditioning to the VXIbus trigger lines.
Glossary NI-VXI User Manual G- 8 © National Instruments Corporation IEEE 488.2 A supplemental standard for GPIB. Its full title is Codes, Formats, Protocols and Common Commands . INT16 A 16-bit signed integer; may also be called a short integer or word .
Glossary © National Instruments Corporation G-9 NI-VXI User Manual M MB 1,048,576 or 2 20 mapping Establishing a range of address space for a one-to-one correspondence between each address in the window and an address in VXIbus memory. master A functional part of a MXI/VME/VXIbus device that initiates data transfers on the backplane.
Glossary NI-VXI User Manual G-10 © National Instruments Corporation N NI-VXI The National Instruments bus interface software for VME/VXIbus systems. nonprivileged access One of the defined types of VMEbus data transfers; indicated by certain address modifier codes.
Glossary © National Instruments Corporation G-11 NI-VXI User Manual queue A group of items waiting to be acted upon by the computer. The arrangement of the items determines their processing priority. Queues are usually accessed in a FIFO fashion. R read To get information from any input device or file storage media.
Glossary NI-VXI User Manual G-12 © National Instruments Corporation ROAK Release On Acknowledge; a type of VXI interrupter which always deasserts its interrupt line in response to an IACK cycle on the VXIbus. All message-based VXI interrupters must be ROAK interrupters.
Glossary © National Instruments Corporation G-13 NI-VXI User Manual signal Any communication between message-based devices consisting of a write to a Signal register. Sending a signal requires that the sending device have VMEbus master capability. signed integer n bit pattern, interpreted such that the range is from -2 (n-1) to +2 (n-1) -1.
Glossary NI-VXI User Manual G-14 © National Instruments Corporation System Controller A functional module that has arbiter, daisy-chain driver, and MXIbus cycle timeout responsibility.
Glossary © National Instruments Corporation G-15 NI-VXI User Manual V VIC VXI Interactive Control program, a part of the NI-VXI bus interface software package. Used to program VXI devices, and develop and debug VXI application programs. Called VICtext when used on text- based platforms.
Glossary NI-VXI User Manual G-16 © National Instruments Corporation WRviol Write Ready protocol violation; a type of Word Serial Protocol error. If a Commander attempts to write a command or query to a Servant that is not Write Ready (already has a command or query pending), a Write Ready protocol violation may be generated.
© National Instruments Corporation I-1 NI-VXI User Manual Index A acceptor trigger functions AcknowledgeTrig, 3-55 DefaultTrigHandler, 3-55 DefaultTrigHandler2, 3-55 DisableTrigSense, 3-55 EnableTrigSense, 3-55 GetTrigHandler, 3-56 overview, 3-54 SetTrigHandler, 3-56 WaitForTrig, 3-56 access functions.
Index NI-VXI User Manual I-2 © National Instruments Corporation WScmd, 3-10 WSEcmd, 3-11 WSgetTmo, 3-11 WSLcmd, 3-11 WSLresp, 3-11 to 3-12 WSrd, 3-12 WSrdf, 3-12 WSresp, 3-12 to 3-13 WSsetTmo, 3-13 WStrg, 3-13 WSwrt, 3-13 WSwrtf, 3-14 configuration functions.
Index © National Instruments Corporation I-3 NI-VXI User Manual external controllers, 2-6 to 2-7 definition, 2-6 embeddded controller connected to other frames (figure), 2-6 embeddded controller connected using MXI-2 (figure), 2-7 F fax and telephone support, B-2 FaxBack support, B-2 FindDevLA function, 3-2 FTP support, B-1 functions.
Index NI-VXI User Manual I-4 © National Instruments Corporation interrupts interrupt service routine support, Commander Word Serial Protocol functions, 3-7 to 3-8 interrupts and asynchronous events, .
Index © National Instruments Corporation I-5 NI-VXI User Manual multiple-pointer access for window, 3-28 to 3-29 Access-Only Privilege, 3-28 to 3-29 Owner Privilege, 3-28 multitasking support, Comman.
Index NI-VXI User Manual I-6 © National Instruments Corporation Request for Service False (REQF) event, 3-37 Request for Service False (REQF) status/ID, 3-37 Request for Service True (REQT) event, 3-.
Index © National Instruments Corporation I-7 NI-VXI User Manual SetWSSEcmdHandler function, 3-20 SetWSSLcmdHandler function, 3-20 SetWSSrdHandler function, 3-20 SetWSSwrtHandler function, 3-20 Shared.
Index NI-VXI User Manual I-8 © National Instruments Corporation START/STOP, 3-52 SYNC, 3-51 triggering hardware capabilities, 3-52 to 3-54 embedded, external MXI-2, and remote controller, 3-54 extern.
Index © National Instruments Corporation I-9 NI-VXI User Manual map trigger functions MapTrigToTrig, 3-56 to 3-57 overview, 3-56 UnMapTrigToTrig, 3-57 overview, 2-3, 3-51 to 3-52 source trigger funct.
Index NI-VXI User Manual I-10 © National Instruments Corporation WSSLnoResp function, 3-21, 3-22 WSSLsendResp function, 3-21 WSSrd function, 3-22 WSSsendResp function, 3-22 WSSwrt function, 3-22 WStr.
An important point after buying a device National Instruments NI-VXI (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought National Instruments NI-VXI yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data National Instruments NI-VXI - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, National Instruments NI-VXI you will learn all the available features of the product, as well as information on its operation. The information that you get National Instruments NI-VXI will certainly help you make a decision on the purchase.
If you already are a holder of National Instruments NI-VXI, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime National Instruments NI-VXI.
However, one of the most important roles played by the user manual is to help in solving problems with National Instruments NI-VXI. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device National Instruments NI-VXI along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
