Resumen del contenido incluido en la página 1
™
NI-VXI
User Manual
July 1996 Edition
Part Number 371702A-01
© Copyright 1996 National Instruments Corporation.
All Rights Reserved.
Resumen del contenido incluido en la página 2
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.natinst.com Bulletin Board Support BBS United States: (512) 794-5422 or (800) 327-3077 BBS United Kingdom: 01635 551422 BBS France: 1 48 65 15 59 FaxBack S
Resumen del contenido incluido en la página 3
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 replace software media that do not execute programming instructions if National Instruments receives notice of such defects during the warranty period.
Resumen del contenido incluido en la página 4
Table
of
Contents About This Manual Organization of This Manual.....................................................................................xiii Conventions Used in This Manual ............................................................................xiv Related Documentation .............................................................................................xv Customer Communication.........................................................................................
Resumen del contenido incluido en la página 5
Table of Contents Multiple Mainframe Support.....................................................................................2-5 Controllers...................................................................................................2-5 The extender and controller Parameters......................................................2-7 Using NI-VXI............................................................................................................2-9 Header Files................
Resumen del contenido incluido en la página 6
Table of Contents WSLcmd .....................................................................................................3-11 WSLresp......................................................................................................3-11 WSrd ...........................................................................................................3-12 WSrdf ..........................................................................................................3-12 WSresp .........
Resumen del contenido incluido en la página 7
Table of Contents VXIout.........................................................................................................3-25 VXIoutReg ..................................................................................................3-25 Low-Level VXI/VMEbus Access Functions.............................................................3-26 Programming Considerations......................................................................3-27 Multiple-Pointer Access for a Window........
Resumen del contenido incluido en la página 8
Table of Contents VXI Interrupt Functions ............................................................................................3-43 Programming Considerations......................................................................3-45 ROAK Versus RORA VXI/VME Interrupters............................................3-46 AcknowledgeVXIint ...................................................................................3-46 AssertVXIint ..................................................
Resumen del contenido incluido en la página 9
Table of Contents DefaultSoftResetHandler.............................................................................3-61 DefaultSysfailHandler.................................................................................3-61 DefaultSysresetHandler...............................................................................3-62 DisableACfail..............................................................................................3-62 DisableSoftReset ..............................
Resumen del contenido incluido en la página 10
Table of Contents Figures Figure 1-1. VXI Configuration Registers ................................................................1-2 Figure 1-2. VXI Software Protocols ........................................................................1-3 Figure 2-1. An Embedded Controller Connected to Other Frames via Mainframe Extenders Using MXI-2 .....................................................2-6 Figure 2-2. An External Controller Connected Using MXI-2 to a Number of Remote Controllers ......
Resumen del contenido incluido en la página 11
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, 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 2, Int
Resumen del contenido incluido en la página 12
About This Manual • 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 metric prefixes. • The Index contains an alphabetical list of key terms and topics used in this manual, including the page where each one can be found. Conventions Used in This Manual The following conventions are
Resumen del contenido incluido en la página 13
About This 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 • VXI-1, VXIbus System Specification, Revision 1.4, VXIbus Consortium • VXI-6, VXIbus Mainframe Extender Specification, Revision 1.0, VXIbus Consortium Customer Communication National Instruments wants to receiv
Resumen del contenido incluido en la página 14
Chapter 1 Overview of NI-VXI 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 VXIbus/VMEbus are included with the NI-VXI software. They are available for a variety of controller platforms and operating systems. Among the compatible platforms are the National Instruments line of embedded contr
Resumen del contenido incluido en la página 15
Chapter 1 Overview of NI-VXI Offset 3F Device
Dependent
Registers VXI Configuration
20 Space Reserved IE
Reserved
Reserved 1C
by VXIbus
• Upper 16 KB of A16
Reserved Specification space reserved for
1A
VXI configuration space Reserved 18
16
A32 Pointer Low
Shared Memory
A32 Pointer High
• 64 bytes per device 14
Protocol
A24 Pointer Low 12
Registers
A32 Pointer High • 8-bit logical
10
address specifies
base address for
0E Data Low each device C
Resumen del contenido incluido en la página 16
Chapter 1 Overview of NI-VXI 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 the manufacturer, can communicate at a minimum level using the VXI-specified Word Serial Protocol. In addition, you can establish higher-performance communication channels, such as shared-memory channels,
Resumen del contenido incluido en la página 17
Chapter 1 Overview of NI-VXI 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-based devices and system resources. All VXI message-based devices are required to use the Word Serial Protocol and communicate in a standard way. The protocol is called word serial, because if you want to co
Resumen del contenido incluido en la página 18
Chapter 1 Overview of NI-VXI 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, while some others can receive both signals and interrupts. The VXIbus specification defines Word Serial commands so that a Commander can understand the capabilities of its Servants and configure them to gene
Resumen del contenido incluido en la página 19
Chapter 1 Overview of NI-VXI 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 interface boards such as the PCI-MXI-2 perform as though they were plugged directly into the VXI/VME backplane. In addition, MXI-2 boosts data throughput performance past previous-generation MXIbus products by
Resumen del contenido incluido en la página 20
Chapter Introduction to the 2 NI-VXI Functions 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 overview on using the NI-VXI application programming interface. The NI-VXI functions are a set of C/C++ and BASIC language functions you can use to perform operations with a VXI/VME system. The NI-VXI C/C++ lang