National Instruments NI-VXI manual

  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.com E-mail: info@natinst.com FTP Site: ftp.natinst.com Web Address: http://www.natin[...]

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 will, at its option, repair or re[...]

© National Instruments Corporation v NI-VXI User Manual Table of Contents About This Manual Organization of This Manual ..................................................................................... xiii Conventions Used in This Manual ............................................................................ xiv Related Documentati[...]

Table of Contents NI-VXI User Manual vi © National Instruments Corporation Multiple Mainframe Support ..................................................................................... 2-5 Controllers ................................................................................................... 2-5 The extender and controller Parameters ..[...]

Table of Contents © National Instruments Corporation vii NI-VXI User Manual WSLcmd ..................................................................................................... 3-11 WSLresp ...................................................................................................... 3-11 WSrd ......................................[...]

Table of Contents NI-VXI User Manual viii © National Instruments Corporation VXIout......................................................................................................... 3-25 VXIoutReg .................................................................................................. 3-25 Low-Level VXI/VMEbus Access Functions ...[...]

Table of Contents © National Instruments Corporation ix NI-VXI User Manual VXI Interrupt Functions ............................................................................................ 3-43 Programming Considerations ...................................................................... 3-45 ROAK Versus RORA VXI/VME Interrupters ...........[...]

Table of Contents NI-VXI User Manual x © National Instruments Corporation DefaultSoftResetHandler............................................................................. 3-61 DefaultSysfailHandler ................................................................................. 3-61 DefaultSysresetHandler .....................................[...]

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 ........................................................................ 1-3 Figure 2-1. An Embedded Controller Connected [...]

© 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. Organization of This Manual The NI-VXI User Manual for C/C++ and BASIC is organized as follows: • Chapter 1, Overview of NI-VXI, in[...]

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. • The Glossary contains an alphabetical list and description of terms used in this manual, including abbreviations, acronyms, and m[...]

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.0 ?[...]

© 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). Comprehensive functions for programming the VXIb[...]

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/Control Device T ype ID Register VXI Configuration Space Offset 3F 20 IE  1C  1A  18  0E 0C 0A 08 06 04 02 00 • Upper 16 K[...]

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. All message-based VXIbus devices, regardless of t[...]

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. In addition, the Word Serial Protocol has messages for configuring message-b[...]

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. Some devices can receive only signals, some only interrupts, w[...]

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. Thus, MXI-2 lets CPU int[...]

© 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. This chapter concludes with an [...]

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. You can use these functions to obtain a pointer that is d[...]

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. VXI-Only Fun[...]

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. You can use LabWindo[...]

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. Th[...]

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. • External controller —A desktop computer or workstation conne[...]

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 . An Extern[...]

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. Notice that the default controller is determined by the following factors: • If the progra[...]

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. Additional information summarizes how you can use the functions to perform certain tasks and further describes the general[...]

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). To make the code more rea[...]

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(). Although InitVXIlibrary() needs to be called only once, the structure of your pro[...]

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. Therefore, any program that uses a constant as a logical address of a particular[...]

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 . The term is derived from the fact that all commands are 16 bits in length (word length), and th[...]

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. The main difference between the high-level and low-level access function[...]

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. These can be found in the NI-VXI header files */ addrptr1 = (UINT32) MapVXIAddress(AccessP_Space(A16_SPACE) | AccessP_Priv(NonPriv_DAT[...]

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. For this reason, we[...]

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. In addition, */ /* the program can use the local address to perform */ /* I/O on the same space, such as reading back a block */ /* of data */ bufaddr [...]

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. After you have enabled [...]

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. Some of these guideline[...]

© 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. System Configuration Functions The VXI system configuration functions copy all of the Reso[...]

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. You [...]

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. Possible fields include the device name, Commander’s logical addre[...]

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. This i[...]

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. SetDevInfoShort is a function layered on top of SetDevInfo for[...]

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. The Commander polls specific bits in the Servant’s VXI Response register to determine when it can write a command, when it can read a[...]

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. One of the functions of the Clear command is to clear a pending protocol[...]

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). The most co[...]

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. If the applicati[...]

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. The following paragraphs describe the Commander Word Serial, Longword Serial, and Extended Longword Seri[...]

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. WSEcmd sends the command by writing the Data Extended register first with the up[...]

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 ). In cases when you need to inspect the Longword Serial transfer at a lower level, however, you can break up the query send[...]

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 ). In cases when you need to inspect the Word Serial transfer at a lower level, however, you can break up the query sending and q[...]

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. The process involves calling the[...]

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. The lower 8 bits (bits 0 to 7[...]

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. ERROR Hardware WSScmdHandler NI-VXI base Interrupt Service Routine (ISR) WSSenable() WSSdisable()[...]

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. The current WSScmdHandler is called whenever the local CPU Commander sends any W[...]

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. DefaultWSSrdHandler (status, count) DefaultWSSrdHandler is the default handler for the WSSrd interrupt, which InitVXIlibrary automatically[...]

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. GetWS[...]

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. While Word Serial operations are en[...]

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. This may be necessary if the application ne[...]

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. The WSScmd interrupt handler should call WSSnoResp after processing a Word Serial command (it calls WSSsendResp for a Word Serial query, which requires a respo[...]

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. These are required in many situations, including the following: • Register-based device/instrument drivers ?[...]

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. VXIin (accessparms, address, width, value) VXIin reads a single byt[...]

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. If one of the addresses selected has no device residing at the address and a bus error occurs, VXImove traps the bus error condition[...]

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. Some of the situations tha[...]

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). The are[...]

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. If the hardware context changes due to a subsequen[...]

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. The call succeeds under either of the following condition[...]

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). The appli[...]

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. The information that can be returned includes the state of the Sysfail, ACfail, VXI interrupt, TTL trigger, or ECL trigger lines as[...]

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 . MapVXIAddressSize only provides a preferred size to the MapVXIAddress [...]

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. The possible privileges include Nonprivileged Data, Supervisory Data, Nonprivileged Program, Supervisor[...]

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). You can use these functions to gain access to miscellaneous local resources such as the[...]

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). An[...]

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). A[...]

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. Event [...]

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. If the global signal queue becomes full, Di[...]

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. RouteVXIint() VXI/VME Interrupts 1-7 Hardware NI-VXI Software User Application VXIintHandlers SignalHandlers NI-VXI base Interrupt Service Routines (ISR) Local VXI Signals Ena[...]

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. If signal interrupts are enabled (via EnableSignalInt ), the signal handler for a specific logical address is called if the RouteSigna[...]

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. The RouteSignal function specifie[...]

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. During the VME inte[...]

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. A separate handler can be installed for each VXI logical address present (refer to the description for SetSignalHandl[...]

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. RouteVXIint() VXI/VME Interrupts 1-7 Hardware NI-VXI Software User Application [...]

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. The Release On Acknowledge (ROAK) interrupter is the more common. A ROAK interrupter automatically unasserts the VXI/VME interrupt line it is asserting when an interrupt acknowled[...]

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 . However, if the interrupts are not enabled and the assertion of an interrupt is detected through some method (such as GetVXIbusStatus ), you can use Acknowle[...]

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 . DisableVXIint (controller, levels) DisableVXIint desens[...]

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. After c[...]

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. If the VXI/VME interrupt status/IDs are specified to be handled by a VXI/VM[...]

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. In the past, clumsy cables of specified length had to be connected betwee[...]

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. START/STOP can be sourced only b[...]

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 functionality: • Trigger control used on a VXI-MXI-1 frame extender when used as an extending controller (under direct control of a root-level MXI-1 controll[...]

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). Note: In MXI-2 and th[...]

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. DefaultTrigHandler (controller, line, type) DefaultTrigHandler is th[...]

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. SetTrigHandler (lines, func) SetTrigHandler replaces the current trigger handler for the specified VXI trigger lines with an alternate han[...]

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). UnMapTrigToTrig (controller, srcTrig, destTrig) UnMapTrigToTrig unconfigures triggering hardware that was configured by the MapTrigToTrig function to route specifie[...]

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. TrigAssertConfig (controller, trigline, mode) TrigAsser[...]

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. Regardless of the sources connected to the GPIOs, TrigExtConfig configures several aspects[...]

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. The functions are grouped by area of functionality. AssertSysre[...]

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. See also the descriptions of SetBusErrorHandler and GetBusErrorHandler . DefaultSoftResetHandler () DefaultSoftResetHandler is the sample handler for the Soft Reset interrupt, and is install[...]

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. It increments the global variable SysresetRecv . DisableACfail[...]

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. DisableSysreset (controller) DisableSysreset desensitizes the application to Sysreset interrupts from embedded or extended controller(s[...]

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. When a VXIbus device is in the FAILed state, the failed device clears its PASS bit (in its Status register) and asserts the SYSFAIL* signal on the VXIbus bac[...]

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. Note: The Soft Reset interrup[...]

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. Because bus errors can occur at any time, a corresponding enable and disable[...]

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 . When the National Instruments Resource Manager (RM) completes its configuration, all defaul[...]

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. The MapTTLtrig function can dynamically reconfigure the TTL trigger m[...]

© 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. This arrangement can help you determine easily which functions are available withi[...]

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 ✔✔ ✔ Word Serial WSclr ✔✔ ✔ Protocol WScmd / WSEcmd/ WSLcmd ✔✔ ✔ WSgetTmo ✔✔ ✔ WSrd / WSrdi / WSrdl ✔✔ ✔ WSrdf ✔✔ ✔ WS[...]

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 SetWSSwrtHandler ✔✔ Serial Protocol WSSabort ✔✔ (continued) WSSdisable ✔✔ WSSenable ✔✔ WSSnoResp /WSSLnoResp ✔✔ WSSrd / WSSrdi / WSSrdl ✔?[...]

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 ✔✔ ✔ ✔ Access ReadMODID ✔✔ ✔ SetMODID ✔✔ ✔ VXIinLR ✔✔ ✔ ✔ VXImemAlloc ✔✔ ✔ ✔ VXImemCopy ✔✔ ✔ ✔ VXImemFree[...]

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 ✔✔ ✔ ✔ Interrupt SetVXIintHandler ✔✔ ✔ (continued) VXIintAcknowledgeMode ✔✔ ✔ ✔ Triggers AcknowledgeTrig ✔✔ ✔ DefaultTrigHand[...]

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 DisableSysreset ✔✔ ✔ ✔ Handler EnableACfail ✔✔ ✔ ✔ (continued) EnableSoftReset ✔✔ ✔ EnableSysfail ✔✔ ✔ ✔ EnableSysreset ✔?[...]

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 ✔✔ ✔ AcknowledgeVXIint VXI/VME Interrupt ✔✔ ✔ ✔ AssertSysreset System Interrupt Handler ✔✔ ✔ ✔ AssertVXIint VXI/VME Interrupt ?[...]

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 Interrupt Handler ✔✔ ✔ ✔ DisableSignalInt VXI Signal ✔✔ ✔ DisableSoftReset System Interrupt Handler ✔✔ ✔ DisableSysfail System Inter[...]

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/VMEbus Access ✔✔ ✔ ✔ GetDevInfo System Configuration ✔✔ ✔ GetDevInfoLong System Configuration ✔✔ ✔ ✔ GetDevInfoShort System Con[...]

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 Configuration ✔✔ ✔ ✔ MapECLtrig VXI/VMEbus Extender ✔✔ ✔ MapTrigToTrig Triggers ✔✔ ✔ MapTTLtrig VXI/VMEbus Extender ✔✔ ✔ Map[...]

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 Signal ✔✔ ✔ SetSoftResetHandler System Interrupt Handler ✔✔ SetSysfailHandler System Interrupt Handler ✔✔ ✔ SetSysresetHandler System In[...]

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-Level VXI/VMEbus Access ✔✔ ✔ VXIintAcknowledgeMode VXI/VME Interrupt ✔✔ ✔ ✔ VXImemAlloc Local Resource Access ✔✔ ✔ ✔ VXImemCopy 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 Serial Protocol ✔✔ ✔ WSSabort Servant Word Serial Protocol ✔✔ WSSdisable Servant Word Serial Protocol ✔✔ WSSenable Servant Word Serial Pro[...]

© 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. Filling out a copy of the Technical Su[...]

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. E-Mail Support (currently U.S. only) You can submit technical support questions to the appropriate applications engineering team through e[...]

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. Completing this form accurately before contacting National Instruments for technical support helps our applications engineers answer your questions m[...]

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. In VXI, the upper 16 KB of A16 space is allocated for use by VXI devices configuration regist[...]

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. address space A set of 2 n memory locations differentiated from [...]

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. BERR* Bus error signal. This signal is asserted by either a slave device or the bus time out (BTO) unit when an incorrect transfer is made on the [...]

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. CLK10 A 10 MHz, ± 100 ppm, individually buffered (to each module slot), differential ECL system clock that is sourced from Slot 0 and distributed to Slots 1 through 12 on P[...]

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. Also known as base 10. de-referencing Accessing the contents of the ad[...]

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 written to a message-based device’s Signal register in which the most significant bit (bit 15) is a 1, designating an Event (as opposed to a Response [...]

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. Second, GPIOs are used as part of a cross[...]

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 . INT32 A 32-bit signed integer; may also be called a long or longword . INT8 An 8-bit signed in[...]

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. A transfer ca[...]

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. Each of the defined VMEbus address spaces has a defined nonprivileged access mode. [...]

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. register A high-speed device us[...]

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. ROR Release On Request; a type of VME bus arbitration where the current VMEbus[...]

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. slave [...]

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. Always the first device in the MXIbus daisy-chain. system hierarchy The tree structure of the Commander/Servant relationships of all devices in the system at a give[...]

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. VME Versa Module Eurocard or IEEE 1014 VMEbus Class device Al[...]

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. WSP See Word Serial Pr[...]

© 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. See high-level VXI/VMEbus access functions; l[...]

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. See system configuration functions; trigger configuration functions. controller parameter[...]

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. See NI-VXI f[...]

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, 1-4 to 1-5 L LabWindows/CVI software, 2-4 to 2-5 C/C++ example, 2-4 input versus output parameters, 2-4 to 2-5 return values and system errors, 2-4 to[...]

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, Commander Word Serial Protocol functions cooperative, 3-7 to 3-8 preemptive operating system, 3-8 to 3-10 MXI-2 overview, 1-5 to 1-6 MXIbus overview, 1-5 N [...]

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-37 Request for Service True (REQT) status/ID, 3-37 Response signals, 3-37 Response status/IDs, 3-43 RespProtError function, 3-19 return values and sys[...]

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 Memory events, 3-37, 3-43 signal handling C/C++ example, 2-18 overview, 2-17 to 2-18 signal queuing considerations, 3-38 to 3-39 SignalDeq function, [...]

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 external controller/VXI-MXI-1, 3-53 triggers definition, 3-51 overview, 2-19 U UnMapTrigToTrig function, 3-57 UnMapVXIAddress function, 3-33 Unrecognized Co[...]

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 functions overview, 3-57 ScrTrig, 3-57 trigger configuration functions overview, 3-58 TrigAssertConfig, 3-58 TrigCntrConfig, 3-58 TrigExtConfig, 3-58 to 3-[...]

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 WStrg function, 3-13 WSwrt function, 3-13 WSwrtf, 3-14[...]