background image

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 backplane.
When a Sysfail condition is detected on the local CPU, an interrupt is
generated, and the current Sysfail interrupt handler is called. The failed
Servant device must be forced offline or brought back online in an
orderly fashion.

  EnableSysreset (controller)

EnableSysreset

 sensitizes the application to Sysreset interrupts from

embedded or extended controller(s) (dependent on the hardware
platform). Notice that if the local CPU is configured to be reset by
Sysreset conditions on the backplane, the interrupt handler will not get
invoked (the CPU will reboot).

  GetACfailHandler ()

GetACfailHandler

 returns the address of the current ACfail interrupt

handler. An ACfail condition detected on the local CPU generates
an interrupt that calls the current ACfail interrupt handler. Your
application can take any appropriate action within the allotted time
period before complete power failure. The 

InitVXIlibrary

 function

automatically installs a default handler, 

DefaultACfailHandler

,

when it initializes the NI-VXI software.

  GetBusErrorHandler ()

GetBusErrorHandler

 returns the address of the current bus error

interrupt handler. During an access to the VXI/VMEbus, the BERR*
signal (bus error) is asserted to end the bus cycle if the address or mode
of access is determined to be invalid. The bus error exception condition
generates an exception on the local CPU, which can be trapped by the
bus error handler. Your application should include a retry mechanism if
it is possible for a particular access to generate bus 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. It increments the global
variable 

BusErrorRecv

. Because bus errors can occur at any time, a

corresponding enable and disable function is not possible.

Summary of Contents for NI-VXI

Page 1: ...NI VXI User Manual July 1996 Edition Part Number 371702A 01 Copyright 1996 National Instruments Corporation All Rights Reserved...

Page 2: ...ack Support 512 418 1111 Telephone Support U S Tel 512 795 8248 Fax 512 794 5678 International Offices Australia 03 9 879 9422 Austria 0662 45 79 90 0 Belgium 02 757 00 20 Canada Ontario 519 622 9310...

Page 3: ...the form of action whether in contract or tort including negligence Any action against National Instruments must be brought within one year after the cause of action accrues National Instruments shal...

Page 4: ...VXI Devices 1 1 Register Based Devices 1 2 Message Based Devices 1 3 Word Serial Protocol 1 3 Commander Servant Hierarchies 1 4 Interrupts and Asynchronous Events 1 4 MXIbus Overview 1 5 MXI 2 Overvie...

Page 5: ...ry Access 2 16 Interrupts and Signals 2 17 Triggers 2 19 Chapter 3 Software Overview System Configuration Functions 3 1 CloseVXIlibrary 3 2 CreateDevInfo 3 2 FindDevLA 3 2 GetDevInfo 3 3 GetDevInfoLon...

Page 6: ...dHandler 3 18 DefaultWSSwrtHandler 3 18 GenProtError 3 18 GetWSScmdHandler 3 18 GetWSSEcmdHandler 3 19 GetWSSLcmdHandler 3 19 GetWSSrdHandler 3 19 GetWSSwrtHandler 3 19 RespProtError 3 19 SetWSScmdHan...

Page 7: ...MapVXIAddress 3 31 MapVXIAddressSize 3 32 SetByteOrder 3 32 SetContext 3 32 SetPrivilege 3 33 UnMapVXIAddress 3 33 VXIpeek 3 33 VXIpoke 3 33 Local Resource Access Functions 3 34 GetMyLA 3 34 ReadMODI...

Page 8: ...uments Triggering Hardware 3 52 External Controller VXI MXI 1 Trigger Capabilities 3 53 Embedded External MXI 2 and Remote Controller Trigger Capabilities 3 54 Acceptor Trigger Functions 3 54 Acknowle...

Page 9: ...3 63 EnableSysfail 3 63 EnableSysreset 3 64 GetACfailHandler 3 64 GetBusErrorHandler 3 64 GetSoftResetHandler 3 65 GetSysfailHandler 3 65 GetSysresetHandler 3 65 SetACfailHandler 3 65 SetBusErrorHandl...

Page 10: ...me Extenders Using MXI 2 2 6 Figure 2 2 An External Controller Connected Using MXI 2 to a Number of Remote Controllers 2 7 Figure 3 1 Preemptive Word Serial Mutual Exclusion Per Logical Address 3 9 Fi...

Page 11: ...ions of the application development environment This chapter concludes with an overview on using the NI VXI application programming interface Chapter 3 Software Overview describes the C C and BASIC us...

Page 12: ...otes the messages and responses that the monospace computer automatically prints to the screen This font also emphasizes lines of example code that are different from the other examples italic Italic...

Page 13: ...s System Specification Revision 1 4 VXIbus Consortium VXI 6 VXIbus Mainframe Extender Specification Revision 1 0 VXIbus Consortium Customer Communication National Instruments wants to receive your com...

Page 14: ...on VXI VME features VME users can skip to the section entitled Interrupts and Asynchronous Events VXIbus Overview Concepts of the VXIbus specification include the VXI device message based devices the...

Page 15: ...w A32 Pointer High A24 Pointer Low A32 Pointer High 16 14 12 10 Shared Memory Protocol Registers Communication Registers Required for VXI Message Based Devices Configuration Registers Required for all...

Page 16: ...er performance communication channels such as shared memory channels to take advantage of the VXIbus bandwidth capabilities Device Specific Protocols Device Specific Protocols Shared Memory Protocol 4...

Page 17: ...er Servant Hierarchies The VXIbus specification defines a Commander Servant communication protocol you can use to construct hierarchical systems using conceptual layers of VXI devices The resulting st...

Page 18: ...ry protocol or simply by writing specific messages directly to the device s Signal register in addition to the VXI VME interrupt lines MXIbus Overview The MXIbus is a high performance communication li...

Page 19: ...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 defining new high performance p...

Page 20: ...ply to VXI but some groups are not applicable to VME VXI VME Function Groups The following NI VXI function groups apply to both VXI and VME System Configuration Functions The system configuration func...

Page 21: ...es VXI Signal Functions VXI signals are a method for VXI bus masters to interrupt another device You can route VXI signals to a handler or queue them on a global signal queue You can use these functio...

Page 22: ...CPU the device on which the NI VXI interface resides using the Word Serial Longword Serial or Extended Longword Serial protocols These capabilities include command query handling and buffer reads wri...

Page 23: ...nctions described in this manual are completely compatible with LabWindows CVI Type Definitions The following data types are used for all parameters in the NI VXI functions and in the actual NI VXI li...

Page 24: ...ision 1 3 or later for more details on multiple mainframe systems If you have a multiple mainframe VXI VME system please continue with the following sections If you have a single mainframe system you...

Page 25: ...ontroller configurations An embedded controller in one frame that is connected to other frames via mainframe extenders using MXI 2 VXI MXI 2 or VME MXI 2 boards in the other frames can also be used as...

Page 26: ...ion concerning what logical addresses should be passed to these functions The extender parameter is the logical address of a mainframe extender on which the function should be performed Usually functi...

Page 27: ...gure whether the default controller is the external controller or the remote controller with the lowest numbered logical address With this behavior if you write a program on an embedded controller ref...

Page 28: ...For example INT16 is defined as a 16 bit signed integer and UINT32 is defined as a 32 bit unsigned integer Using these types benefits you by letting you apply specific type sizes across platforms Usi...

Page 29: ...rpose of this function is to return various information about the system GetDevInfo can return the information either a piece at a time or in one large data structure The header file devinfo h contain...

Page 30: ...ture is destroyed The outcome of all of this is that when exiting a program you should call CloseVXIlibrary the same number of times that you have called InitVXIlibrary Caution In environments where a...

Page 31: ...logical address C C Example main INT16 ret la ret InitVXIlibrary 1 and empty quotes are used for don t cares ret FindDevLA 0xABC 0x123 1 1 1 1 la if ret 0 printf No such device found n else printf The...

Page 32: ...Word Serial Protocol the functions WSwrt and WSrd use the Word Serial commands Byte Available for sending a byte to a servant and Byte Request for retrieving a byte from a Servant repetitively to send...

Page 33: ...accesses You can use the low level VXI VMEbus access functions if you want to access VXI VME memory with as little overhead as possible Although you now have to perform such actions as bus error hand...

Page 34: ...has occurred n else printf Value read was hd n svalue ret UnMapVXIAddress window1 else printf Unable to access window n Close library when done ret CloseVXIlibrary Notice that the return variable for...

Page 35: ...RESMAN and should be read by the program through the GetDevInfo function Keep in mind that when the controller shares its resources it may not allocate them from the local system first For example if...

Page 36: ...w you can look upon it as a FIFO first in first out queue that you can access via the signal queue management functions such as SignalDeq Both the signal queue and the callback handler will provide th...

Page 37: ...allback handlers NIVXI_HVXIINT OldVXIintHandler pointer to save the old handler NIVXI_HVXIINT UserVXIintHandler function declr for new handler main INT16 ret controller Always begin by initializing th...

Page 38: ...rictions and on Macintosh computers regaining access to global variables Triggers The addition of trigger lines to the VMEbus is one improvement the VXIbus has over VME in the field of instrumentation...

Page 39: ...configuration functions at one level or another When the NI VXI RM runs it logs the system configuration information in the RM table file resman tbl The InitVXIlibrary function reads the information...

Page 40: ...for the specified logical address It installs default NULL values into the entry You must use one of the SetDevInfo functions after this point to change any of the device information as needed This op...

Page 41: ...2 bit integers Possible fields include the VXI address base and size allocated to the device by the RM GetDevInfoShort la field shortvalue GetDevInfoShort returns information about the specified devic...

Page 42: ...se size allocated VXI interrupt lines handlers allocated protocols supported and so on A field value of zero 0 specifies to change the specified entry with the supplied structure containing all possib...

Page 43: ...r la field stringvalue SetDevInfoStr changes information about the specified device in the NI VXI RM table The field parameter specifies the attribute of the information to change SetDevInfoStr is a f...

Page 44: ...e sending the Byte Available The lower 8 bits bits 0 to 7 of the 16 bit command contain a single byte of data bit 8 is the END bit Therefore one Byte Available is sent for each data byte in the buffer...

Page 45: ...ion however provides no common command usages for these protocols The commands are either VXI Reserved or User Defined The NI VXI interface gives you the ability to send any one of these commands Prog...

Page 46: ...e operation is complete only one call can be pending for the application level code No Word Serial Protocol functions other than WSabort can be called at interrupt service routine time If a Word Seria...

Page 47: ...or write command query is sent Byte Available for WSwrt WSwrtf or Byte Request for WSrd WSrdf When the command transfer is complete the read or write call will continue exactly from where it was susp...

Page 48: ...ial or Extended Longword Serial command in progress The UnSupCom operation is called when an Unrecognized Command Event is received by DefaultSignalHandler WSclr la WSclr sends the Word Serial Clear c...

Page 49: ...rors occurred during the transfer WSgetTmo actualtimo WSgetTmo retrieves the current timeout period for all of the Commander Word Serial Protocol functions It retrieves the current timeout value in mi...

Page 50: ...st BREQ Word Serial queries and reading the responses Each response contains a data byte in the lower 8 bits and the END bit in bit 8 Before sending the BREQ command WSrd polls both Response register...

Page 51: ...ng a Commander Word Serial Protocol function the function terminates with a corresponding error code WStrg la WStrg sends the Word Serial Trigger command to a message based Servant Before sending the...

Page 52: ...nder probably not the Resource Manager such as in a multiple CPU situation In a multiple CPU situation the local CPU must allow the Resource Manager device to configure the local CPU and can optionall...

Page 53: ...ported Command Multiple Query Error MQE DIR Violation DOR Violation RR Violation or WR Violation The Servant Word Serial Protocol functions let the local CPU generate any of the Word Serial Protocol e...

Page 54: ...cmd is BREQ respond with next byte if done call WSSwrtHandler with status set WR and exit else if read pending and cmd is BAV store byte in buffer if done call WSSrdHandler with status set WR and exi...

Page 55: ...ler cmdExt cmd DefaultWSSEcmdHandler is the default handler for the WSSwrt interrupt which InitVXIlibrary automatically installs when it initializes the NI VXI software The current WSSEcmdHandler is c...

Page 56: ...ally installs when it initializes the NI VXI software When WSSwrt reaches the specified count or an error occurs it calls the WSSwrt interrupt handler with the status of the call The default handler s...

Page 57: ...tatus of the call GetWSSwrtHandler GetWSSwrtHandler returns the address of the current WSSwrt interrupt handler function When WSSwrt reaches the specified count or an error occurs it calls the WSSwrt...

Page 58: ...ource code as an example and is automatically installed when InitVXIlibrary initializes the NI VXI software SetWSSrdHandler func SetWSSrdHandler replaces the current WSSrd interrupt handler with an al...

Page 59: ...rrupts generated when writing a Word Serial command to the Data Low register or reading a response from the Data Low register By default the Servant Word Serial functions are disabled At any time afte...

Page 60: ...the DIR bit before setting the WR on the last byte of transfer WSSsendResp response WSSsendResp responds to a Word Serial Protocol query from a VXI message based Commander device The WSScmd interrupt...

Page 61: ...ot take into account any of the considerations that are required by the low level VXIbus access functions The high level VXI VMEbus access functions have all necessary information for accessing a part...

Page 62: ...VXI registers within the logical address space the upper 16 KB of VXI A16 address space The function sets the VXI access privilege to Nonprivileged Data and the byte order to Motorola If the VXI addre...

Page 63: ...transfers If the VXI VME address selected has no device residing at the address and a bus error occurs VXIout traps the bus error condition and indicates the error through the return status VXIoutReg...

Page 64: ...te or byte order However the two interfaces have different emphases with respect to user protection error checking and access speed Low level VXI VMEbus access is the fastest access method in terms of...

Page 65: ...ded by a particular platform If a mapped pointer is to be incremented or decremented the bounds for accessing within a particular address space must be tested before accessing within the space NI VXI...

Page 66: ...or Access Only Privilege to that window If the call succeeds the function returns a valid pointer and a non negative return value The 32 bit windowId output parameter returned from the MapVXIAddress c...

Page 67: ...sful call returns a valid pointer and a non negative return value The 32 bit window number signifies that the access privileges to the window are Access Only Privilege With Access Only Privilege you c...

Page 68: ...eves the current windowing hardware VXI VMEbus access privileges for the specified window The possible privileges include Nonprivileged Data Supervisory Data Nonprivileged Program Supervisory Program...

Page 69: ...ddress space The windowbase and windowend output parameters are based on VXI VME addresses not local CPU addresses The window parameter value should be the value returned from a MapVXIAddress call The...

Page 70: ...Notice that some hardware platforms do not allow you to change the byte order of a window which is reflected in the return code of the call to SetByteOrder Most Intel processor based hardware platform...

Page 71: ...s free to be remapped If the caller is an Access Only Privilege accessor the window can be remapped only if the caller is the last Access Only accessor After a call is made to UnMapVXIAddress the poin...

Page 72: ...grouped by area of functionality GetMyLA GetMyLA retrieves the logical address of the local VXI VME device The local CPU VXI VME logical address is required for retrieving configuration information w...

Page 73: ...ion uses but also the VXI VME address that a remote device would use to access this RAM This function is very helpful on virtual memory systems which require contiguous locked down blocks of virtual t...

Page 74: ...value or set of values to be received VXI signals are a basic form of asynchronous communication used by VXI VME bus master devices A VXI signal is a 16 bit value written to the Signal register of a V...

Page 75: ...n be handled either by calling a handler or by queuing on a global signal queue The RouteSignal function specifies which types of signals are handled by the handlers and which are queued onto the glob...

Page 76: ...transfer needs to be retried This guarantees the application that even if the global signal queue becomes full no signals will be lost In addition to DisableSignalInt the DisableVXItoSignalInt functio...

Page 77: ...or block till received else SignalDeq return signal mask SignalDeq u i n t 1 6 s i g n a l SignalEnq SignalDeq SignalJam uint16 statusId WaitForSignal uint16 level uint32 statusId u i n t 1 6 s i g n...

Page 78: ...ignal interrupts are disabled a write to the local CPU VXI Signal register does not cause an interrupt on the local CPU instead the local CPU hardware signal FIFO begins to fill up If the hardware FIF...

Page 79: ...The InitVXIlibrary function automatically installs a default handler DefaultSignalHandler for every VXI logical address If signals are queued the application can use the SignalDeq or WaitForSignal fu...

Page 80: ...ignalJam signal SignalJam places signals at the front of the global signal queue SignalJam can be used to simulate the reception of a signal by placing a value on the global signal queue that was not...

Page 81: ...ponse status IDs are used to report changes in Word Serial communication status between a Servant and its Commander Event status IDs are used to inform another device of other asynchronous changes The...

Page 82: ...rupt handler and not by the signal handler the specified callback handler is invoked The VXI VME interrupt handler for a particular level is called with the VXI interrupt level and the status ID witho...

Page 83: ...nalInt RouteSignal EnableVXIint DisableVXIint EnableVXItoSignalInt DisableVXItoSignalInt SetVXIintHandler GetVXIintHandler DefaultVXIintHandler SignalEnq User ISRs 1 per VXI VME interrupt level 1 per...

Page 84: ...he backplane the local CPU interrupt generation must be inhibited until the device dependent acknowledgment is complete The function VXIintAcknowledgeMode specifies whether a VXI VME interrupt level f...

Page 85: ...sStatus to detect if the interrupt has been serviced Use DeAssertVXIint to unassert a interrupt that had been asserted using AssertVXIint but has not yet been acknowledged DeAssertVXIint controller le...

Page 86: ...EnableVXIint to enable interrupts not routed to signals A 1 negative one or local logical address in the controller parameter specifies the local frame for an embedded CPU or the first extended contr...

Page 87: ...e global signal queue becomes full DisableVXItoSignalInt is automatically called to inhibit these VXI interrupts from being received from the appropriate levels EnableVXItoSignalInt is automatically c...

Page 88: ...upt levels with an alternate callback handler If VXI VME interrupts are enabled via EnableVXIint the VXI VME interrupt handler for a specific logical address is called The RouteVXIint function must fi...

Page 89: ...fication specifies several trigger protocols that can be supported thereby promoting compatibility among the various VXI devices The following is a description of the four basic protocols SYNC SYNC pr...

Page 90: ...s specifications but provide similar functionality You can use these protocols in any way that your application requires You can use them for device synchronization for stepping through tests or for a...

Page 91: ...These configurations do have the National Instruments Trigger Interface Chip TIC on them External Controller VXI MXI 1 Trigger Capabilities All National Instruments external controllers such as the AT...

Page 92: ...anced features of the TIC please contact National Instruments for the technical note Triggering with NI VXI Acceptor Trigger Functions The NI VXI acceptor trigger functions act as a standard interface...

Page 93: ...ameter specifies that an acknowledge interrupt occurred Otherwise DefaultTrigHandler performs no operations DefaultTrigHandler2 controller line type DefaultTrigHandler2 is a sample handler for receivi...

Page 94: ...pending Map Trigger Functions You can use the NI VXI map trigger functions as configuration tools for multiframe and local support for VXI triggers You can configure the triggering hardware to route s...

Page 95: ...acknowledgment and your application is required to know when the acknowledgment occurs you must use the SetTrigHandler function to install a callback handler for the specified trigger line A default...

Page 96: ...u can use this function to initialize reload or disable the current counter settings If the counter is initialized you must call either SrcTrig or EnableTrigSense to actually start the counter You can...

Page 97: ...range for each tick timer is specified as a power of two from 0 to 31 If you did not select auto reload the timer stops when TICK1 has counted to zero You can use MapTrigToTrig to map the TICK1 output...

Page 98: ...after a power failure condition occurs for the system to remain operational The detection of a power failure in a VXI VME system asserts the backplane signal ACFAIL An ACfail condition detected on the...

Page 99: ...the Reset bit should never be written Writing the Reset bit of any device should be reserved for the Commander of the device EnableSoftReset must be called to enable writes to the Reset bit to generat...

Page 100: ...ableSoftReset DisableSoftReset desensitizes the application to Soft Reset conditions on the local CPU When the Reset bit in the VXI Control register of the local CPU is written the VXI interface if an...

Page 101: ...any appropriate action within the allotted time period before complete power failure EnableSoftReset EnableSoftReset sensitizes the application to Soft Reset conditions on the local CPU When the Reset...

Page 102: ...pt handler An ACfail condition detected on the local CPU generates an interrupt that calls the current ACfail interrupt handler Your application can take any appropriate action within the allotted tim...

Page 103: ...er when it initializes the NI VXI software SetACfailHandler func SetACfailHandler replaces the current ACfail interrupt handler with an alternate handler An ACfail condition detected on the local CPU...

Page 104: ...e local CPU after the InitVXIlibrary call Note The Soft Reset interrupt does not apply to VME SetSysfailHandler func SetSysfailHandler replaces the current Sysfail interrupt handler with an alternate...

Page 105: ...VME chassis and even allows a system consisting of both VXI and VME chassis The following paragraphs describe the VXI VMEbus extender functions The descriptions are presented at a functional level de...

Page 106: ...you can use MapUtilBus to configure the mainframe to mainframe mapping The NI VXI Resource Manager automatically configures a default mapping based on user modifiable configuration files The MapUtilBu...

Page 107: ...ble A 2 Function Listing by Name lists each function alphabetically You can refer to this table if you don t remember the group association of a particular function Both tables use checkmarks to denot...

Page 108: ...WSEcmd WSLcmd WSgetTmo WSrd WSrdi WSrdl WSrdf WSresp WSLresp WSsetTmo WStrg WSwrt WSwrti WSwrtl WSwrtf Servant Word DefaultWSScmdHandler Serial Protocol DefaultWSSEcmdHandler DefaultWSSLcmdHandler De...

Page 109: ...WSSabort continued WSSdisable WSSenable WSSnoResp WSSLnoResp WSSrd WSSrdi WSSrdl WSSsendResp WSSLsendResp WSSwrt WSSwrti WSSwrtl High Level VXIin VXI VMEbus VXIinReg Access VXImove VXIout VXIoutReg L...

Page 110: ...s ReadMODID SetMODID VXIinLR VXImemAlloc VXImemCopy VXImemFree VXIoutLR VXI Signal DefaultSignalHandler DisableSignalInt EnableSignalInt GetSignalHandler RouteSignal SetSignalHandler SignalDeq SignalE...

Page 111: ...eMode Triggers AcknowledgeTrig DefaultTrigHandler DefaultTrigHandler2 DisableTrigSense EnableTrigSense GetTrigHandler MapTrigToTrig SetTrigHandler SrcTrig TrigAssertConfig TrigCntrConfig TrigExtConfig...

Page 112: ...BASIC System Interrupt DisableSysreset Handler EnableACfail continued EnableSoftReset EnableSysfail EnableSysreset GetACfailHandler GetBusErrorHandler GetSoftResetHandler GetSysfailHandler GetSysreset...

Page 113: ...ltACfailHandler System Interrupt Handler DefaultBusErrorHandler System Interrupt Handler DefaultSignalHandler VXI Signal DefaultSoftResetHandler System Interrupt Handler DefaultSysfailHandler System I...

Page 114: ...igSense Triggers DisableVXIint VXI VME Interrupt DisableVXItoSignalInt VXI VME Interrupt EnableACfail System Interrupt Handler EnableSignalInt VXI Signal EnableSoftReset System Interrupt Handler Enabl...

Page 115: ...VXI VMEbus Access GetSignalHandler VXI Signal GetSoftResetHandler System Interrupt Handler GetSysfailHandler System Interrupt Handler GetSysresetHandler System Interrupt Handler GetTrigHandler Trigger...

Page 116: ...ressSize Low Level VXI VMEbus Access MapVXIint VXI VMEbus Extender ReadMODID Local Resource Access RespProtError Servant Word Serial Protocol RouteSignal VXI Signal RouteVXIint VXI VME Interrupt SetAC...

Page 117: ...tHandler VXI VME Interrupt SetWSScmdHandler Servant Word Serial Protocol SetWSSEcmdHandler Servant Word Serial Protocol SetWSSLcmdHandler Servant Word Serial Protocol SetWSSrdHandler Servant Word Seri...

Page 118: ...Resource Access VXImove High Level VXI VMEbus Access VXIout High Level VXI VMEbus Access VXIoutLR Local Resource Access VXIoutReg High Level VXI VMEbus Access VXIpeek Low Level VXI VMEbus Access VXIp...

Page 119: ...ol WSSdisable Servant Word Serial Protocol WSSenable Servant Word Serial Protocol WSsetTmo Word Serial Protocol WSSnoResp WSSLnoResp Servant Word Serial Protocol WSSrd WSSrdi WSSrdl Servant Word Seria...

Page 120: ...nic Services Bulletin Board Support National Instruments has BBS and FTP sites dedicated for 24 hour support with a collection of files and documents to answer most common customer questions From thes...

Page 121: ...has branch offices all over the world Use the list below to find the technical support number for your country If there is no National Instruments office in your country contact the source from which...

Page 122: ...________________________________ Mouse ____ yes _____ no Other adapters installed _____________________________ Hard disk capacity ________ MB Brand ____________________________________________ Instru...

Page 123: ..._______________________________________________ ________________________________________________________________________________ _______________________________________________________________________...

Page 124: ...on is referred to as VXI configuration space A24 space One of the VXIbus address spaces Equivalent to the VME 16 MB standard address space A32 space One of the VXIbus address spaces Equivalent to the...

Page 125: ...ta among various types of data processing and data communications equipment ASIC Application Specific Integrated Circuit a custom chip asserted A signal in its active true state asynchronous Not synch...

Page 126: ...d to transfer 8 bits of data from a Servant to its Commander under the Word Serial Protocol BTO See bus timeout unit buffer Temporary memory storage location for holding data before it can be transmit...

Page 127: ...l register In Instrument devices an ASCII coded multi byte directive Commander A message based device which is also a bus master and can control one or more Servants communications In message based de...

Page 128: ...e is ready to accept data from its Commander DIRviol Data In Ready violation A type of word serial protocol error that occurs when the Commander attempts to write data to the device when the device is...

Page 129: ...rnal controller plus all of the extending controllers to which it is directly connected An example is an AT MXI connected to a VXI MXI Extended Longword A form of Word Serial communication in which Co...

Page 130: ...tions in a notation more familiar to the user than machine code Each high level statement corresponds to several low level machine code instructions and is machine independent meaning that it is porta...

Page 131: ...an interrupt acknowledge cycle INTX Interrupt and Timing Extension a daughter card option for MXI mainframe extenders that extends interrupt lines and reset signals on VME boards On VXI boards it also...

Page 132: ...e devices are able to use Word Serial Protocol to communicate with one another through communication registers MODID A set of 13 signal lines on the VXI backplane that VXI systems use to identify whic...

Page 133: ...m with base 8 using numerals 0 to 7 P parse The act of interpreting a string of data elements as a command to perform a device specific action peek To read the contents pointer A data structure that c...

Page 134: ...that has the capability to control the VXIbus but has no intelligent CPU installed An example is the VXI MXI 2 REQF Request False a VXI Event condition transferred using either VXI signals or VXI inte...

Page 135: ...nse to a previously sent query is pending RRviol Read Ready protocol violation a type of Word Serial Protocol error If a Commander attempts to read a response from the Data Low register when the devic...

Page 136: ...reason for interrupting STST START STOP trigger protocol a one line multiple device protocol that can be sourced only by the VXI Slot 0 device and sensed by any other device on the VXI backplane supe...

Page 137: ...crosspoint switch tick The smallest unit of time as measured by an operating system trigger Either TTL or ECL lines used for intermodule communication tristated Defines logic that can have one of thr...

Page 138: ...ackage Used to configure the system edit the manufacturer name and ID numbers edit the model names of VXI and non VXI devices in the system as well as the system interrupt configuration information an...

Page 139: ...rite 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 Wri...

Page 140: ...Byte Available BAV Word Serial commands 3 6 3 15 Byte Request BREQ Word Serial queries 3 6 3 15 C callback handlers handling signals or interrupts 2 18 system dependent behavior note 2 19 CloseVXIlibr...

Page 141: ...TrigHandler function 3 55 DefaultTrigHandler2 function 3 55 DefaultVXIntHandler function 3 47 to 3 48 DefaultWSScmdHandler function 3 17 DefaultWSSEcmdHandler function 3 17 DefaultWSSLcmdHandler funct...

Page 142: ...resetHandler function 3 65 GetTrigHandler function 3 56 GetVXIbusStatus function 3 30 GetVXIbusStatusInd function 3 31 GetVXIintHandler function 3 49 GetWindowRange function 3 31 GetWSScmdHandler func...

Page 143: ...sSize 3 32 multiple pointer access for window 3 28 to 3 29 Access Only Privilege 3 28 to 3 29 Owner Privilege 3 28 overview 2 2 3 26 to 3 27 programming considerations 3 27 SetByteOrder 3 32 SetContex...

Page 144: ...tions See also specific groups of functions alphabetical list A 9 to A 14 calling syntax 2 3 classification reference A 1 to A 7 multiple mainframe support 2 5 to 2 8 controllers 2 5 to 2 7 extender a...

Page 145: ...habetical list table A 2 to A 3 DefaultWSScmdHandler 3 17 DefaultWSSEcmdHandler 3 17 DefaultWSSLcmdHandler 3 17 to 3 18 DefaultWSSrdHandler 3 18 DefaultWSSwrtHandler 3 18 GenProtError 3 18 GetWSScmdHa...

Page 146: ...Ilibrary 3 4 obtaining system information 2 11 to 2 12 C C example 2 12 overview 2 1 3 1 SetDevInfo 3 4 SetDevInfoLong 3 4 SetDevInfoShort 3 5 SetDevInfoStr 3 5 system interrupt handler functions alph...

Page 147: ...derations 3 45 ROAK versus RORA VXI VME interrupts 3 46 RouteVXIint 3 43 3 44 3 49 to 3 50 SetVXIintHandler 3 50 VXIintAcknowledgeMode 3 46 3 50 VXI only function groups 2 3 VXI signal functions alpha...

Page 148: ...3 35 VXImove function 3 24 to 3 25 VXIout function 3 25 VXIoutLR function 3 36 VXIoutReg function 3 25 VXIpeek function de referencing pointers 3 28 description 3 33 VXIpoke function de referencing po...

Page 149: ...anual 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 functi...

Reviews: