National Instruments NI-VXI manuel d'utilisation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

Aller à la page of

Un bon manuel d’utilisation

Les règles imposent au revendeur l'obligation de fournir à l'acheteur, avec des marchandises, le manuel d’utilisation National Instruments NI-VXI. Le manque du manuel d’utilisation ou les informations incorrectes fournies au consommateur sont à la base d'une plainte pour non-conformité du dispositif avec le contrat. Conformément à la loi, l’inclusion du manuel d’utilisation sous une forme autre que le papier est autorisée, ce qui est souvent utilisé récemment, en incluant la forme graphique ou électronique du manuel National Instruments NI-VXI ou les vidéos d'instruction pour les utilisateurs. La condition est son caractère lisible et compréhensible.

Qu'est ce que le manuel d’utilisation?

Le mot vient du latin "Instructio", à savoir organiser. Ainsi, le manuel d’utilisation National Instruments NI-VXI décrit les étapes de la procédure. Le but du manuel d’utilisation est d’instruire, de faciliter le démarrage, l'utilisation de l'équipement ou l'exécution des actions spécifiques. Le manuel d’utilisation est une collection d'informations sur l'objet/service, une indice.

Malheureusement, peu d'utilisateurs prennent le temps de lire le manuel d’utilisation, et un bon manuel permet non seulement d’apprendre à connaître un certain nombre de fonctionnalités supplémentaires du dispositif acheté, mais aussi éviter la majorité des défaillances.

Donc, ce qui devrait contenir le manuel parfait?

Tout d'abord, le manuel d’utilisation National Instruments NI-VXI devrait contenir:
- informations sur les caractéristiques techniques du dispositif National Instruments NI-VXI
- nom du fabricant et année de fabrication National Instruments NI-VXI
- instructions d'utilisation, de réglage et d’entretien de l'équipement National Instruments NI-VXI
- signes de sécurité et attestations confirmant la conformité avec les normes pertinentes

Pourquoi nous ne lisons pas les manuels d’utilisation?

Habituellement, cela est dû au manque de temps et de certitude quant à la fonctionnalité spécifique de l'équipement acheté. Malheureusement, la connexion et le démarrage National Instruments NI-VXI ne suffisent pas. Le manuel d’utilisation contient un certain nombre de lignes directrices concernant les fonctionnalités spécifiques, la sécurité, les méthodes d'entretien (même les moyens qui doivent être utilisés), les défauts possibles National Instruments NI-VXI et les moyens de résoudre des problèmes communs lors de l'utilisation. Enfin, le manuel contient les coordonnées du service National Instruments en l'absence de l'efficacité des solutions proposées. Actuellement, les manuels d’utilisation sous la forme d'animations intéressantes et de vidéos pédagogiques qui sont meilleurs que la brochure, sont très populaires. Ce type de manuel permet à l'utilisateur de voir toute la vidéo d'instruction sans sauter les spécifications et les descriptions techniques compliquées National Instruments NI-VXI, comme c’est le cas pour la version papier.

Pourquoi lire le manuel d’utilisation?

Tout d'abord, il contient la réponse sur la structure, les possibilités du dispositif National Instruments NI-VXI, l'utilisation de divers accessoires et une gamme d'informations pour profiter pleinement de toutes les fonctionnalités et commodités.

Après un achat réussi de l’équipement/dispositif, prenez un moment pour vous familiariser avec toutes les parties du manuel d'utilisation National Instruments NI-VXI. À l'heure actuelle, ils sont soigneusement préparés et traduits pour qu'ils soient non seulement compréhensibles pour les utilisateurs, mais pour qu’ils remplissent leur fonction de base de l'information et d’aide.

Table des matières du manuel d’utilisation

  • Page 1

      NI-VXI ™ User Manual July 1996 Edition Part Number 3 71702A-01 © Copyright 1996 National Instruments Corporation. All Rights Reserved.[...]

  • Page 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.natin[...]

  • Page 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 re[...]

  • Page 4

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

  • Page 5

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

  • Page 6

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

  • Page 7

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

  • Page 8

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

  • Page 9

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

  • Page 10

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

  • Page 11

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

  • Page 12

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

  • Page 13

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

  • Page 14

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

  • Page 15

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

  • Page 16

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

  • Page 17

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

  • Page 18

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

  • Page 19

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

  • Page 20

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

  • Page 21

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

  • Page 22

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

  • Page 23

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

  • Page 24

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

  • Page 25

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

  • Page 26

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

  • Page 27

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

  • Page 28

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

  • Page 29

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

  • Page 30

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

  • Page 31

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

  • Page 32

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

  • Page 33

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

  • Page 34

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

  • Page 35

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

  • Page 36

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

  • Page 37

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

  • Page 38

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

  • Page 39

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

  • Page 40

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

  • Page 41

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

  • Page 42

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

  • Page 43

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

  • Page 44

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

  • Page 45

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

  • Page 46

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

  • Page 47

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

  • Page 48

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

  • Page 49

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

  • Page 50

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

  • Page 51

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

  • Page 52

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

  • Page 53

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

  • Page 54

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

  • Page 55

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

  • Page 56

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

  • Page 57

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

  • Page 58

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

  • Page 59

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

  • Page 60

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

  • Page 61

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

  • Page 62

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

  • Page 63

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

  • Page 64

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

  • Page 65

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

  • Page 66

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

  • Page 67

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

  • Page 68

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

  • Page 69

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

  • Page 70

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

  • Page 71

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

  • Page 72

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

  • Page 73

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

  • Page 74

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

  • Page 75

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

  • Page 76

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

  • Page 77

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

  • Page 78

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

  • Page 79

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

  • Page 80

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

  • Page 81

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

  • Page 82

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

  • Page 83

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

  • Page 84

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

  • Page 85

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

  • Page 86

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

  • Page 87

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

  • Page 88

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

  • Page 89

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

  • Page 90

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

  • Page 91

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

  • Page 92

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

  • Page 93

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

  • Page 94

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

  • Page 95

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

  • Page 96

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

  • Page 97

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

  • Page 98

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

  • Page 99

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

  • Page 100

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

  • Page 101

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

  • Page 102

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

  • Page 103

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

  • Page 104

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

  • Page 105

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

  • Page 106

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

  • Page 107

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

  • Page 108

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

  • Page 109

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

  • Page 110

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

  • Page 111

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

  • Page 112

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

  • Page 113

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

  • Page 114

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

  • Page 115

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

  • Page 116

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

  • Page 117

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

  • Page 118

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

  • Page 119

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

  • Page 120

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

  • Page 121

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

  • Page 122

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

  • Page 123

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

  • Page 124

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

  • Page 125

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

  • Page 126

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

  • Page 127

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

  • Page 128

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

  • Page 129

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

  • Page 130

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

  • Page 131

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

  • Page 132

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

  • Page 133

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

  • Page 134

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

  • Page 135

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

  • Page 136

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

  • Page 137

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

  • Page 138

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

  • Page 139

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

  • Page 140

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

  • Page 141

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

  • Page 142

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

  • Page 143

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

  • Page 144

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

  • Page 145

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

  • Page 146

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

  • Page 147

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

  • Page 148

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

  • Page 149

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