National-instruments NI-VXI Uživatelský manuál

NI-VXI™User ManualJuly 1996 EditionPart Number 371702A-01© Copyright 1996 National Instruments Corporation.All Rights Reserved.

Table of Contents© National Instruments Corporation xi NI-VXI User ManualFiguresFigure 1-1. VXI Configuration Registers ...

Chapter 3 Software OverviewNI-VXI User Manual 3-62 © National Instruments Corporation DefaultSysresetHandler (controller)DefaultSysresetHandler

Chapter 3 Software Overview© National Instruments Corporation 3-63 NI-VXI User Manualstate, the failed device clears its PASS bit (in its Status

Chapter 3 Software OverviewNI-VXI User Manual 3-64 © National Instruments Corporationspecification requires that all VXI Commanders monitor the P

Chapter 3 Software Overview© National Instruments Corporation 3-65 NI-VXI User Manual GetSoftResetHandler ()GetSoftResetHandler returns the addr

Chapter 3 Software OverviewNI-VXI User Manual 3-66 © National Instruments Corporationerrors at times and valid results at other times. The InitVX

Chapter 3 Software Overview© National Instruments Corporation 3-67 NI-VXI User Manual VXI/VMEbus Extender FunctionsThe NI-VXI software interface

Chapter 3 Software OverviewNI-VXI User Manual 3-68 © National Instruments Corporationyou can use MapTTLtrig to configure the mainframe-to-mainfra

© National Instruments Corporation1A-1 NI-VXI User ManualFunction ClassificationReferenceAAppendixThis appendix contains two tables you can use as a q

Appendix A Function Classification ReferenceNI-VXI User Manual A-2 © National Instruments CorporationTable A-1. Function Listing by GroupGroup Fu

Appendix A Function Classification Reference© National Instruments Corporation A-3 NI-VXI User ManualTable A-1. Function Listing by GroupGroup Fu

© National Instruments Corporation xiii NI-VXI User ManualAboutThisManualThis manual describes in detail the features of the NI-VXI software andthe

Appendix A Function Classification ReferenceNI-VXI User Manual A-4 © National Instruments CorporationTable A-1. Function Listing by GroupGroup Fu

Appendix A Function Classification Reference© National Instruments Corporation A-5 NI-VXI User ManualTable A-1. Function Listing by GroupGroup Fu

Appendix A Function Classification ReferenceNI-VXI User Manual A-6 © National Instruments CorporationTable A-1. Function Listing by GroupGroup Fu

Appendix A Function Classification Reference© National Instruments Corporation A-7 NI-VXI User ManualTable A-2. Function Listing by NameFunction

Appendix A Function Classification ReferenceNI-VXI User Manual A-8 © National Instruments CorporationTable A-2. Function Listing by NameFunction

Appendix A Function Classification Reference© National Instruments Corporation A-9 NI-VXI User ManualTable A-2. Function Listing by NameFunction

Appendix A Function Classification ReferenceNI-VXI User Manual A-10 © National Instruments CorporationTable A-2. Function Listing by NameFunction

Appendix A Function Classification Reference© National Instruments Corporation A-11 NI-VXI User ManualTable A-2. Function Listing by NameFunction

Appendix A Function Classification ReferenceNI-VXI User Manual A-12 © National Instruments CorporationTable A-2. Function Listing by NameFunction

Appendix A Function Classification Reference© National Instruments Corporation A-13 NI-VXI User ManualTable A-2. Function Listing by NameFunction

About This ManualNI-VXI User Manual xiv © National Instruments Corporation• Appendix B, Customer Communication, contains forms you can useto request h

© National Instruments Corporation B-1 NI-VXI User ManualCustomer CommunicationBAppendixFor your convenience, this appendix contains forms to help you

FaxBack SupportFaxBack is a 24-hour information retrieval system containing a library of documents on a widerange of technical information. You can a

Technical Support FormPhotocopy this form and update it each time you make changes to your software or hardware, anduse the completed copy of this for

Documentation Comment FormNational Instruments encourages you to comment on the documentation supplied with our products.This information helps us pr

© National Instruments Corporation G-1 NI-VXI User ManualGlossaryPrefix Meaning Valuen- nano- 10-9m- milli- 10-3K- kilo- 103M- mega- 106G- giga- 109AA

GlossaryNI-VXI User Manual G-2 © National Instruments Corporationaddress modifier One of six signals in the VMEbus specification used byVMEbus masters

Glossary© National Instruments Corporation G-3 NI-VXI User ManualBAV Word Serial Byte Available command. Used to transfer 8 bits of datafrom a Comman

GlossaryNI-VXI User Manual G-4 © National Instruments CorporationCclearing Replacing the information in a register, storage location, or storage unitw

Glossary© National Instruments Corporation G-5 NI-VXI User ManualDData Transfer Bus One of four buses on the VMEbus backplane. The DTB is used by abu

GlossaryNI-VXI User Manual G-6 © National Instruments CorporationEOS End Of String; a character sent to designate the last byte of a datamessage.ERR P

About This Manual© National Instruments Corporation xv NI-VXI User Manual Related DocumentationThe following documents contain information that you m

Glossary© National Instruments Corporation G-7 NI-VXI User ManualGPIO General-Purpose Input Output, a module within the NationalInstruments TIC chip w

GlossaryNI-VXI User Manual G-8 © National Instruments CorporationIEEE 488.2 A supplemental standard for GPIB. Its full title is Codes, Formats,Protoc

Glossary© National Instruments Corporation G-9 NI-VXI User ManualMMB 1,048,576 or 220mapping Establishing a range of address space for a one-to-one co

GlossaryNI-VXI User Manual G-10 © National Instruments CorporationNNI-VXI The National Instruments bus interface software for VME/VXIbussystems.nonpri

Glossary© National Instruments Corporation G-11 NI-VXI User Manualqueue A group of items waiting to be acted upon by the computer. Thearrangement of

GlossaryNI-VXI User Manual G-12 © National Instruments CorporationROAK Release On Acknowledge; a type of VXI interrupter which alwaysdeasserts its int

Glossary© National Instruments Corporation G-13 NI-VXI User Manualsignal Any communication between message-based devices consisting of awrite to a Sig

GlossaryNI-VXI User Manual G-14 © National Instruments CorporationSystem Controller A functional module that has arbiter, daisy-chain driver, and MXIb

Glossary© National Instruments Corporation G-15 NI-VXI User ManualVVIC VXI Interactive Control program, a part of the NI-VXI bus interfacesoftware pac

GlossaryNI-VXI User Manual G-16 © National Instruments CorporationWRviol Write Ready protocol violation; a type of Word Serial Protocol error.If a Com

© National Instruments Corporation 1-1 NI-VXI User ManualOverview of NI-VXIChapter1This chapter introduces you to the concepts of VXI (VME eXtensionsf

© National Instruments Corporation I-1 NI-VXI User ManualIndexAacceptor trigger functionsAcknowledgeTrig, 3-55DefaultTrigHandler, 3-55DefaultTrigHandl

IndexNI-VXI User Manual I-2 © National Instruments CorporationWScmd, 3-10WSEcmd, 3-11WSgetTmo, 3-11WSLcmd, 3-11WSLresp, 3-11 to 3-12WSrd, 3-12WSrdf, 3

Index© National Instruments Corporation I-3 NI-VXI User Manualexternal controllers, 2-6 to 2-7definition, 2-6embeddded controller connected to otherfr

IndexNI-VXI User Manual I-4 © National Instruments Corporationinterruptsinterrupt service routine support,Commander Word Serial Protocolfunctions, 3-7

Index© National Instruments Corporation I-5 NI-VXI User Manualmultiple-pointer access for window,3-28 to 3-29Access-Only Privilege, 3-28 to 3-29Owner

IndexNI-VXI User Manual I-6 © National Instruments CorporationRequest for Service False (REQF)event, 3-37Request for Service False (REQF)status/ID, 3-

Index© National Instruments Corporation I-7 NI-VXI User ManualSetWSSEcmdHandler function, 3-20SetWSSLcmdHandler function, 3-20SetWSSrdHandler function

IndexNI-VXI User Manual I-8 © National Instruments CorporationSTART/STOP, 3-52SYNC, 3-51triggering hardware capabilities, 3-52 to 3-54embedded, extern

Index© National Instruments Corporation I-9 NI-VXI User Manualmap trigger functionsMapTrigToTrig, 3-56 to 3-57overview, 3-56UnMapTrigToTrig, 3-57overv

IndexNI-VXI User Manual I-10 © National Instruments CorporationWSSLnoResp function, 3-21, 3-22WSSLsendResp function, 3-21WSSrd function, 3-22WSSsendRe

Chapter 1 Overview of NI-VXINI-VXI User Manual 1-2 © National Instruments CorporationReservedReservedReservedReservedData LowData HighResponse/Da

Chapter 1 Overview of NI-VXI© National Instruments Corporation 1-3 NI-VXI User Manual Message-Based DevicesIn addition to register-based devices

Chapter 1 Overview of NI-VXINI-VXI User Manual 1-4 © National Instruments Corporationa fashion very similar to IEEE 488 instruments. In general,m

Chapter 1 Overview of NI-VXI© National Instruments Corporation 1-5 NI-VXI User Manualregister. Devices that do not have bus master capability alw

Chapter 1 Overview of NI-VXINI-VXI User Manual 1-6 © National Instruments CorporationBecause MXI-2 incorporates all of these new signals into a s

Internet SupportGPIB: [email protected]: [email protected]: [email protected]: [email protected]: lw.su

© National Instruments Corporation 2-1 NI-VXI User ManualIntroduction to theNI-VXI FunctionsChapter2This chapter introduces you to the NI-VXI function

Chapter 2 Introduction to the NI-VXI FunctionsNI-VXI User Manual 2-2 © National Instruments Corporation• Low-Level VXIbus Access Functions—Low-le

Chapter 2 Introduction to the NI-VXI Functions© National Instruments Corporation 2-3 NI-VXI User Manualof the VXI/VME interrupt lines, VXI TTL tr

Chapter 2 Introduction to the NI-VXI FunctionsNI-VXI User Manual 2-4 © National Instruments Corporation LabWindows/CVIYou can use the functions

Chapter 2 Introduction to the NI-VXI Functions© National Instruments Corporation 2-5 NI-VXI User ManualBecause value is an output parameter, &

Chapter 2 Introduction to the NI-VXI FunctionsNI-VXI User Manual 2-6 © National Instruments Corporationcable connected towards the root frame) in

Chapter 2 Introduction to the NI-VXI Functions© National Instruments Corporation 2-7 NI-VXI User Manualbus NATIONALINSTRUMENTS®bus NATIONALINST

Chapter 2 Introduction to the NI-VXI FunctionsNI-VXI User Manual 2-8 © National Instruments CorporationMost functions that take a controller para

Chapter 2 Introduction to the NI-VXI Functions© National Instruments Corporation 2-9 NI-VXI User Manual Using NI-VXIThis section presents a gene

Chapter 2 Introduction to the NI-VXI FunctionsNI-VXI User Manual 2-10 © National Instruments Corporation The busacc.h FileThe busacc.h file defi

Important InformationWarrantyThe media on which you receive National Instruments software are warranted not to fail to execute programminginstructions

Chapter 2 Introduction to the NI-VXI Functions© National Instruments Corporation 2-11 NI-VXI User ManualAn important note about these two functio

Chapter 2 Introduction to the NI-VXI FunctionsNI-VXI User Manual 2-12 © National Instruments CorporationFor example, all VXI devices have at leas

Chapter 2 Introduction to the NI-VXI Functions© National Instruments Corporation 2-13 NI-VXI User Manual Word Serial CommunicationWhen communica

Chapter 2 Introduction to the NI-VXI FunctionsNI-VXI User Manual 2-14 © National Instruments Corporation Master Memory AccessYou can access VXIb

Chapter 2 Introduction to the NI-VXI Functions© National Instruments Corporation 2-15 NI-VXI User Manualtimeout = 2000L; /* 2 seconds *//* Notice

Chapter 2 Introduction to the NI-VXI FunctionsNI-VXI User Manual 2-16 © National Instruments CorporationNote:On modern, 32-bit operating systems

Chapter 2 Introduction to the NI-VXI Functions© National Instruments Corporation 2-17 NI-VXI User Manual/* At this point, the remote master can p

Chapter 2 Introduction to the NI-VXI FunctionsNI-VXI User Manual 2-18 © National Instruments CorporationAlternatively, you can choose to handle e

Chapter 2 Introduction to the NI-VXI Functions© National Instruments Corporation 2-19 NI-VXI User ManualNote:Although NI-VXI simplifies the insta

© National Instruments Corporation 3-1 NI-VXI User ManualSoftware OverviewChapter3This chapter describes the C/C++ and BASIC usage of VXI and VMEfunct

© National Instruments Corporation v NI-VXI User ManualTableofContentsAbout This Manual Organization of This Manual...

Chapter 3 Software OverviewNI-VXI User Manual 3-2 © National Instruments Corporation CloseVXIlibrary ()CloseVXIlibrary is the application termin

Chapter 3 Software Overview© National Instruments Corporation 3-3 NI-VXI User Manual GetDevInfo (la, field, fieldvalue)GetDevInfo returns inform

Chapter 3 Software OverviewNI-VXI User Manual 3-4 © National Instruments Corporation InitVXIlibrary ()InitVXIlibrary is the NI-VXI initializatio

Chapter 3 Software Overview© National Instruments Corporation 3-5 NI-VXI User Manual SetDevInfoShort (la, field, shortvalue)SetDevInfoShort chan

Chapter 3 Software OverviewNI-VXI User Manual 3-6 © National Instruments Corporation• Buffer writes• Buffer readsThe Word Serial Protocol is a 16

Chapter 3 Software Overview© National Instruments Corporation 3-7 NI-VXI User ManualIn addition to the four basic types of Word Serial transfers,

Chapter 3 Software OverviewNI-VXI User Manual 3-8 © National Instruments CorporationThe WSabort function is the only exception to this restrictio

Chapter 3 Software Overview© National Instruments Corporation 3-9 NI-VXI User ManualFigure 3-1 gives a precise description of this two-level mutu

Chapter 3 Software OverviewNI-VXI User Manual 3-10 © National Instruments Corporationuntil the transfer is complete or a timeout occurs. This sup

Chapter 3 Software Overview© National Instruments Corporation 3-11 NI-VXI User Manual WSEcmd (la, cmdExt, cmd, respflag, response)WSEcmd sends a

Table of ContentsNI-VXI User Manual vi © National Instruments Corporation Multiple Mainframe Support...

Chapter 3 Software OverviewNI-VXI User Manual 3-12 © National Instruments CorporationNormally, you would use the WSLcmd function to send Longword

Chapter 3 Software Overview© National Instruments Corporation 3-13 NI-VXI User ManualNormally, you would use the WScmd function to send Word Seri

Chapter 3 Software OverviewNI-VXI User Manual 3-14 © National Instruments Corporation WSwrtf (la, filename, count, modevalue, retcount)WSwrtf is

Chapter 3 Software Overview© National Instruments Corporation 3-15 NI-VXI User ManualA buffer write is a series of Byte Available Word Serial com

Chapter 3 Software OverviewNI-VXI User Manual 3-16 © National Instruments Corporation(DIR, DOR, WR, RR, and ERR*) are done automatically within t

Chapter 3 Software Overview© National Instruments Corporation 3-17 NI-VXI User Manual DefaultWSScmdHandler (cmd)DefaultWSScmdHandler is the defa

Chapter 3 Software OverviewNI-VXI User Manual 3-18 © National Instruments CorporationDefaultWSSLcmdHandler calls GenProtError with a protocol err

Chapter 3 Software Overview© National Instruments Corporation 3-19 NI-VXI User Manual GetWSSEcmdHandler ()GetWSSEcmdHandler returns the address

Chapter 3 Software OverviewNI-VXI User Manual 3-20 © National Instruments Corporationdefault handler provides examples of how to parse commands,

Chapter 3 Software Overview© National Instruments Corporation 3-21 NI-VXI User Manual WSSabort (abortop)WSSabort aborts the Servant Word Serial

Table of Contents© National Instruments Corporation vii NI-VXI User Manual WSLcmd ...

Chapter 3 Software OverviewNI-VXI User Manual 3-22 © National Instruments Corporation WSSnoResp ()WSSnoResp sets the WR bit so that it is ready

Chapter 3 Software Overview© National Instruments Corporation 3-23 NI-VXI User Manual High-Level VXI/VMEbus Access FunctionsYou can use both low

Chapter 3 Software OverviewNI-VXI User Manual 3-24 © National Instruments CorporationVXI/VMEbus access functions. You can use both high-level and

Chapter 3 Software Overview© National Instruments Corporation 3-25 NI-VXI User Manualaddress space for the source and destination, respectively.

Chapter 3 Software OverviewNI-VXI User Manual 3-26 © National Instruments Corporation Low-Level VXI/VMEbus Access FunctionsThis section describe

Chapter 3 Software Overview© National Instruments Corporation 3-27 NI-VXI User Manual Programming ConsiderationsAll accesses to the VXI/VMEbus a

Chapter 3 Software OverviewNI-VXI User Manual 3-28 © National Instruments Corporation Multiple-Pointer Access for a WindowApplication programmer

Chapter 3 Software Overview© National Instruments Corporation 3-29 NI-VXI User Manualcan have multiple pointers in the same process or over multi

Chapter 3 Software OverviewNI-VXI User Manual 3-30 © National Instruments Corporation GetByteOrder (window, ordermode)GetByteOrder retrieves the

Chapter 3 Software Overview© National Instruments Corporation 3-31 NI-VXI User Manual GetVXIbusStatusInd (controller, field, status)GetVXIbusSta

Table of ContentsNI-VXI User Manual viii © National Instruments Corporation VXIout...

Chapter 3 Software OverviewNI-VXI User Manual 3-32 © National Instruments Corporation MapVXIAddressSize (size)MapVXIAddressSize sets the size fo

Chapter 3 Software Overview© National Instruments Corporation 3-33 NI-VXI User Manual SetPrivilege (window, priv)SetPrivilege sets the VXI/VMEbu

Chapter 3 Software OverviewNI-VXI User Manual 3-34 © National Instruments Corporation Local Resource Access FunctionsLocal resources are hardwar

Chapter 3 Software Overview© National Instruments Corporation 3-35 NI-VXI User Manual VXIinLR (reg, width, value)VXIinLR reads a single byte, wo

Chapter 3 Software OverviewNI-VXI User Manual 3-36 © National Instruments Corporation VXIoutLR (reg, width, value)VXIoutLR writes a single byte,

Chapter 3 Software Overview© National Instruments Corporation 3-37 NI-VXI User ManualVXI signals from message-based devices can be one of two typ

Chapter 3 Software OverviewNI-VXI User Manual 3-38 © National Instruments Corporation Programming ConsiderationsThe global signal queue used to

Chapter 3 Software Overview© National Instruments Corporation 3-39 NI-VXI User ManualFigure 3-3 provides a graphical overview of the NI-VXI inter

Chapter 3 Software OverviewNI-VXI User Manual 3-40 © National Instruments Corporationreturned immediately to the caller and the process/function

Chapter 3 Software Overview© National Instruments Corporation 3-41 NI-VXI User Manual GetSignalHandler (la)GetSignalHandler returns the address

Table of Contents© National Instruments Corporation ix NI-VXI User Manual VXI Interrupt Functions ...

Chapter 3 Software OverviewNI-VXI User Manual 3-42 © National Instruments Corporation SignalDeq (la, signalmask, signal)SignalDeq retrieves sign

Chapter 3 Software Overview© National Instruments Corporation 3-43 NI-VXI User Manual VXI Interrupt FunctionsVXI/VME interrupts are a basic form

Chapter 3 Software OverviewNI-VXI User Manual 3-44 © National Instruments Corporationspecifies which types of signals are handled by signal handl

Chapter 3 Software Overview© National Instruments Corporation 3-45 NI-VXI User ManualDeAssertVXIint and AcknowledgeVXIint are intended only forde

Chapter 3 Software OverviewNI-VXI User Manual 3-46 © National Instruments Corporation ROAK Versus RORA VXI/VME InterruptersThere are two types o

Chapter 3 Software Overview© National Instruments Corporation 3-47 NI-VXI User ManualNormally, VXI/VME interrupts are automatically acknowledged

Chapter 3 Software OverviewNI-VXI User Manual 3-48 © National Instruments CorporationDefaultVXIintHandler sets the global variablesVXIintControll

Chapter 3 Software Overview© National Instruments Corporation 3-49 NI-VXI User Manualframe (for an embedded CPU) or the first extended controller

Chapter 3 Software OverviewNI-VXI User Manual 3-50 © National Instruments Corporationqueue. The RouteSignal function specifies which types of sig

Chapter 3 Software Overview© National Instruments Corporation 3-51 NI-VXI User Manual VXI Trigger FunctionsVXI triggers are a backplane feature

Table of ContentsNI-VXI User Manual x © National Instruments Corporation DefaultSoftResetHandler...

Chapter 3 Software OverviewNI-VXI User Manual 3-52 © National Instruments Corporationmaximum time from source assertion edge). The acceptingdevic

Chapter 3 Software Overview© National Instruments Corporation 3-53 NI-VXI User Manualgeneral, however, National Instruments hardware has two curr

Chapter 3 Software OverviewNI-VXI User Manual 3-54 © National Instruments Corporation Embedded, External MXI-2, and RemoteController Trigger Cap

Chapter 3 Software Overview© National Instruments Corporation 3-55 NI-VXI User Manual AcknowledgeTrig (controller, line)AcknowledgeTrig performs

Chapter 3 Software OverviewNI-VXI User Manual 3-56 © National Instruments Corporation GetTrigHandler (line)GetTrigHandler returns the address of

Chapter 3 Software Overview© National Instruments Corporation 3-57 NI-VXI User Manualcrosspoint switch configurator (depending on the hardware ca

Chapter 3 Software OverviewNI-VXI User Manual 3-58 © National Instruments Corporation Trigger Configuration FunctionsYou can use the NI-VXI trig

Chapter 3 Software Overview© National Instruments Corporation 3-59 NI-VXI User Manualpanel. GPIO 3 is fed back in as the EXTCLK signal used for s

Chapter 3 Software OverviewNI-VXI User Manual 3-60 © National Instruments CorporationThe following paragraphs describe the system interrupt handl

Chapter 3 Software Overview© National Instruments Corporation 3-61 NI-VXI User Manuallow-level VXI/VMEbus access functions will be reported to th