BenutzerhandbuchInhaltsverzeichnisNI-VXI ™User Manual1Important Information3Warranty3Copyright3Trademarks3WARNING REGARDING MEDICAL AND CLINICAL USE OF NATIONAL INSTRUMENTS PRODUCTS3Table of Contents4About This Manual11Organization of This Manual11Conventions Used in This Manual12Related Documentation13Customer Communication13Chapter 1 Overview of NI-VXI14VXIbus Overview14VXI Devices14Register-Based Devices15Message-Based Devices16Word Serial Protocol16Commander/Servant Hierarchies17Interrupts and Asynchronous Events17MXIbus Overview18MXI-2 Overview18Chapter 2 Introduction to the NI-VXI Functions20Function Groups20VXI/VME Function Groups20VXI-Only Function Groups22Calling Syntax22LabWindows/CVI23Type Definitions23Input Versus Output Parameters23Return Values and System Errors24Multiple Mainframe Support24Controllers24The extender and controller Parameters26Using NI-VXI28Header Files28The datasize.h File28The busacc.h File29The devinfo.h File29The Beginning and End of an NI-VXI Program29System Configuration Tools30Word Serial Communication32Master Memory Access33Slave Memory Access35Interrupts and Signals36Triggers38Chapter 3 Software Overview39System Configuration Functions39CloseVXIlibrary ()40CreateDevInfo (la)40FindDevLA (namepat, manid, modelcode, devclass, slot, mainframe, cmdrla, la)40GetDevInfo (la, field, fieldvalue)41GetDevInfoLong (la, field, longvalue)41GetDevInfoShort (la, field, shortvalue)41GetDevInfoStr (la, field, stringvalue)41InitVXIlibrary ()42SetDevInfo (la, field, fieldvalue)42SetDevInfoLong (la, field, longvalue)42SetDevInfoShort (la, field, shortvalue)43SetDevInfoStr (la, field, stringvalue)43Commander Word Serial Protocol Functions43Programming Considerations45Interrupt Service Routine Support45Single-Tasking Operating System Support46Cooperative Multitasking Support46Multitasking Support (Preemptive Operating System)46WSabort (la, abortop)48WSclr (la)48WScmd (la, cmd, respflag, response)48WSEcmd (la, cmdExt, cmd, respflag, response)49WSgetTmo (actualtimo)49WSLcmd (la, cmd, respflag, response)49WSLresp (la, response)49WSrd (la, buf, count, modevalue, retcount)50WSrdf (la, filename, count, modevalue, retcount)50WSresp (la, response)50WSsetTmo (timo, actualtimo)51WStrg (la)51WSwrt (la, buf, count, modevalue, retcount)51WSwrtf (la, filename, count, modevalue, retcount)52Servant Word Serial Protocol Functions52Programming Considerations53DefaultWSScmdHandler (cmd)55DefaultWSSEcmdHandler (cmdExt, cmd)55DefaultWSSLcmdHandler (cmd)55DefaultWSSrdHandler (status, count)56DefaultWSSwrtHandler (status, count)56GenProtError (proterr)56GetWSScmdHandler ()56GetWSSEcmdHandler ()57GetWSSLcmdHandler ()57GetWSSrdHandler ()57GetWSSwrtHandler ()57RespProtError ()57SetWSScmdHandler (func)57SetWSSEcmdHandler (func)58SetWSSLcmdHandler (func)58SetWSSrdHandler (func)58SetWSSwrtHandler (func)58WSSabort (abortop)59WSSdisable ()59WSSenable ()59WSSLnoResp ()59WSSLsendResp (response)59WSSnoResp ()60WSSrd (buf, count, modevalue)60WSSsendResp (response)60WSSwrt (buf, count, modevalue)60High-Level VXI/VMEbus Access Functions61Programming Considerations61VXIin (accessparms, address, width, value)62VXIinReg (la, reg, value)62VXImove (srcparms, srcaddr, destparms, destaddr, length, width)62VXIout (accessparms, address, width, value)63VXIoutReg (la, reg, value)63Low-Level VXI/VMEbus Access Functions64Programming Considerations65Multiple-Pointer Access for a Window66Owner Privilege66Access-Only Privilege66GetByteOrder (window, ordermode)68GetContext (window, context)68GetPrivilege (window, priv)68GetVXIbusStatus (controller, status)68GetVXIbusStatusInd (controller, field, status)69GetWindowRange (window, windowbase, windowend)69MapVXIAddress (accessparms, address, timo, window, ret)69MapVXIAddressSize (size)70SetByteOrder (window, ordermode)70SetContext (window, context)70SetPrivilege (window, priv)71UnMapVXIAddress (window)71VXIpeek (addressptr, width, value)71VXIpoke (addressptr, width, value)71Local Resource Access Functions72GetMyLA72ReadMODID (modid)72SetMODID (enable, modid)72VXIinLR (reg, width, value)73VXImemAlloc (size, useraddr, vxiaddr)73VXImemCopy (useraddr, bufaddr, size, dir)73VXImemFree (useraddr)73VXIoutLR (reg, width, value)74VXI Signal Functions74Programming Considerations76WaitForSignal Considerations77DefaultSignalHandler (signal)78DisableSignalInt ()78EnableSignalInt ()78GetSignalHandler (la)79RouteSignal (la, modemask)79SetSignalHandler (la, func)79SignalDeq (la, signalmask, signal)80SignalEnq (signal)80SignalJam (signal)80WaitForSignal (la, signalmask, timeout, retsignal, retsignalmask)80VXI Interrupt Functions81Programming Considerations83ROAK Versus RORA VXI/VME Interrupters84AcknowledgeVXIint (controller, level, statusId)84AssertVXIint (controller, level, statusId)85DeAssertVXIint (controller, level)85DefaultVXIintHandler (controller, level, statusId)85DisableVXIint (controller, levels)86DisableVXItoSignalInt (controller, levels)86EnableVXIint (controller, levels)86EnableVXItoSignalInt (controller, levels)87GetVXIintHandler (level)87RouteVXIint (controller, Sroute)87SetVXIintHandler (levels, func)88VXIintAcknowledgeMode (controller, modes)88VXI Trigger Functions89Capabilities of the National Instruments Triggering Hardware90External Controller/VXI-MXI-1 Trigger Capabilities91Embedded, External MXI-2, and Remote Controller Trigger Capabilities92Acceptor Trigger Functions92AcknowledgeTrig (controller, line)93DefaultTrigHandler (controller, line, type)93DefaultTrigHandler2 (controller, line, type)93DisableTrigSense (controller, line)93EnableTrigSense (controller, line, prot)93GetTrigHandler (line)94SetTrigHandler (lines, func)94WaitForTrig (controller, line, timeout)94Map Trigger Functions94MapTrigToTrig (controller, srcTrig, destTrig, mode)94UnMapTrigToTrig (controller, srcTrig, destTrig)95Source Trigger Functions95SrcTrig (controller, line, prot, timeout)95Trigger Configuration Functions96TrigAssertConfig (controller, trigline, mode)96TrigCntrConfig (controller, mode, source, count)96TrigExtConfig (controller, extline, mode)96TrigTickConfig (controller, mode, source, tcount1, tcount2)97System Interrupt Handler Functions97AssertSysreset (controller, mode)98DefaultACfailHandler (controller)98DefaultBusErrorHandler ()98DefaultSoftResetHandler ()99DefaultSysfailHandler (controller)99DefaultSysresetHandler (controller)100DisableACfail (controller)100DisableSoftReset ()100DisableSysfail (controller)100DisableSysreset (controller)101EnableACfail (controller)101EnableSoftReset ()101EnableSysfail (controller)101EnableSysreset (controller)102GetACfailHandler ()102GetBusErrorHandler ()102GetSoftResetHandler ()103GetSysfailHandler ()103GetSysresetHandler ()103SetACfailHandler (func)103SetBusErrorHandler (func)103SetSoftResetHandler (func)104SetSysfailHandler (func)104SetSysresetHandler (func)104VXI/VMEbus Extender Functions105MapECLtrig105MapTTLtrig105MapUtilBus (extender, modes)106MapVXIint (extender, levels, directions)106Appendix A Function Classification Reference107Appendix B Customer Communication120Glossary124Index140Figures10Figure 1-1. VXI Configuration Registers15Figure 1-2. VXI Software Protocols16Figure 2-1. An Embedded Controller Connected to Other Frames via Mainframe Extenders Using MXI-225Figure 2-2. An External Controller Connected Using MXI-2 to a Number of Remote Controllers26Figure 3-1. Preemptive Word Serial Mutual Exclusion (Per Logical Address)47Figure 3-2. NI-VXI Servant Word Serial Model54Figure 3-3. NI-VXI Interrupt and Signal Model77Figure 3-4. NI-VXI Interrupt and Signal Model83Tables10Table A-1. Function Listing by Group107Table A-2. Function Listing by Name113Größe: 852 KBSeiten: 149Language: EnglishHandbuch öffnen
BenutzerhandbuchInhaltsverzeichnisGetting Started with Your PCI-MXI-2 and the NI-VXI/NI-VISA Software for Linux1Support2Worldwide Technical Support and Product Information2National Instruments Corporate Headquarters2Worldwide Offices2Important Information3Warranty3Copyright3Trademarks3Patents3WARNING REGARDING USE OF NATIONAL INSTRUMENTS PRODUCTS3Compliance4Determining FCC Class4FCC/DOC Warnings4Class A4Federal Communications Commission4Canadian Department of Communications4Class B4Federal Communications Commission4Canadian Department of Communications5Compliance to EU Directives5Contents6About This Manual10How To Use the Manual Set10Conventions11Related Documentation12Chapter 1 Introduction and Quick Start13How to Use This Manual14PCI-MXI-2 Kit Overview15What You Need to Get Started15MXI-2 Description15Hardware Description16Software Description17Optional Software18Quick Start18Hardware Installation19Installing and Loading the NI-VXI/NI-VISA Software for Linux20VME Users20Device Interaction20Default Settings21PCI-MXI-221Table 1-1. PCI-MXI-2 Hardware Default Settings21Table 1-2. PCI-MXI-2 Logical Address Configuration Editor Default Settings22Table 1-3. PCI-MXI-2 Device Configuration Editor Default Settings23Table 1-4. PCI-MXI-2 Bus Configuration Editor Default Settings23VXI/VME-MXI-224Table 1-5. VXI-MXI-2 Hardware Default Settings24Table 1-6. VME-MXI-2 Hardware Default Settings25Table 1-7. VXI/VME-MXI-2 Configuration Editor Default Settings25Chapter 2 PCI-MXI-2 Configuration and Installation27Configure the PCI-MXI-227Figure 2-1. PCI-MXI-2 Parts Locator Diagram28Configuration EEPROM29Install the PCI-MXI-229Figure 2-2. PCI-MXI-2 Installed in a Computer30Chapter 3 VXI-MXI-2 Configuration and Installation31Configure the VXI-MXI-231Figure 3-1. VXI-MXI-2 Right-Side Cover32Front Panel Features33Removing the Metal Enclosure33VXIbus Logical Address33Figure 3-2. Logical Address Selection35VXIbus Slot 0/Non-Slot 035Figure 3-3. VXIbus Slot Configuration36VXIbus Local Bus37Figure 3-4. VXIbus Local Bus Configuration38VXIbus CLK10 Routing38Figure 3-5. VXIbus CLK10 Routing39Figure 3-6. SMB CLK10 Settings41Figure 3-7. Receiving or Driving MXIbus CLK1042Trigger Input Termination42Figure 3-8. SMB Trigger Input Termination43MXIbus Termination43Figure 3-9. MXIbus Termination44Configuration EEPROM44Figure 3-10. EEPROM Operation46Onboard DRAM47Table 3-1. VXI-MXI-2 DRAM Configurations47Figure 3-11. SIMM Size Configuration48Install the VXI-MXI-248Connect the MXIbus Cable49Figure 3-12. MXI-2 Cable Configuration Using a PCI-MXI-2 and a VXI-MXI-250Chapter 4 VME-MXI-2 Configuration and Installation51Configure the VME-MXI-251Figure 4-1. VME-MXI-2 Parts Locator Diagram52Front Panel Features53VMEbus A16 Base Address53Figure 4-2. Base Address Selection54VME-MXI-2 Intermodule Signaling54Figure 4-3. VME-MXI-2 Intermodule Signaling Settings55MXIbus Termination55Figure 4-4. MXIbus Termination56Configuration EEPROM56Figure 4-5. EEPROM Operation58Onboard DRAM58Figure 4-6. SIMM Size Configuration59Table 4-1. VME-MXI-2 DRAM Configurations59Install the VME-MXI-260Connect the MXIbus Cable61Figure 4-7. MXI-2 Cable Configuration Using a PCI-MXI-2 and a VME-MXI-262Chapter 5 NI-VXI/NI-VISA Software Installation63Installing the NI-VXI/NI-VISA Software for Linux63Removing the NI-VXI Driver for Linux64Using the NI-VXI/NI-VISA Software64Completing the Software Installation65Chapter 6 NI-VXI Configuration Utility66Running the VXIedit Configuration Utility66Figure 6-1. VXIedit Main Screen67PCI-MXI-2 Configuration Editor68Figure 6-2. PCI-MXI-2 Configuration Editor68Update Current Configuration69Record Configuration to File69Load Configuration from File69Revert to Current Configuration69Logical Address Configuration Editor69Figure 6-3. PCI-MXI-2 or PXI-MXI-2B Logical Address Configuration Editor70Device Settings70Logical Address70Device Type71Address Space71VXI/VME Shared Memory71VXI/VME Shared RAM Size72Shared RAM Pool72Advanced Shared RAM Settings73Figure 6-4. Advanced Shared RAM Settings73Resource Manager Delay75Resource Manager Delay75Figure 6-5. PCI-MXI-2 Device Configuration76Default Controller (LA –1)76System IRQ Level77Servant Area Size77Number of Handlers77Number of Interrupters78Protocol Register78Read Protocol Response78Bus Configuration Editor79Figure 6-6. PCI-MXI-2 Bus Configuration Editor79MXI Bus79MXI System Controller79MXI Bus Timeout80MXI CLK1080MXI Transfer Limit81Synchronous MXI81MXI-2 Auto Retry81A24/A32 Write Posting82PCI Bus82User Window and Driver Window82Expansion ROM83VXI/VME-MXI-2 Configuration Editor84Figure 6-7. VXI/VME-MXI-2 Selection Dialog Box84Figure 6-8. VXI/VME-MXI-2 Configuration Editor85LA Selection and Logical Address85Address Space and Requested Memory85A16 and A24/A32 Write Posting86Interlocked Mode87VXI/VME Bus Options88VMEbus System Controller88VXI/VME Bus Timeout Value89Advanced VXI Settings89Figure 6-9. Advanced VXI Settings90VXI/VME Auto Retry90Transfer Limit90Arbiter Type91Request Level91VXI/VME Fair Requester91Arbiter Timeout92MXI Bus Options92MXI Bus System Controller92MXI Bus Timeout Value92Advanced MXI Settings93Figure 6-10. Advanced MXI Settings93MXI Auto Retry93Transfer Limit94Parity Checking94MXI Fair Requester94MXI CLK10 Signal94Chapter 7 Using the NI-VXI/NI-VISA Software95Interactive Control of NI-VXI/NI-VISA96Example Programs96Programming Considerations96Multiple Applications Using the NI-VXI and VISA Libraries96Low-Level Access Functions97Local Resource Access Functions97System Configuration Functions98Compiling Your C Program for NI-VXI/NI-VISA98Symbols98Appendix A Specifications100Appendix B NI-VXI/NI-VISA Software Overview111Appendix C EEPROM Configuration113Figure C-1. EEPROM Operation Default Settings114Figure C-2. Restoring the Factory Configuration114Appendix D Common Questions116Appendix E Technical Support and Professional Services120Glossary121Symbols121A121B122C123D-E124F-I125K-M126N-R127S128T-V129W130Index131A-C131D132E-K133L-O134P135Q-S136T-V137W139Größe: 1,4 MBSeiten: 139Language: EnglishHandbuch öffnen
BenutzerhandbuchInhaltsverzeichnisNI-VXI ™User Manual1Important Information3Warranty3Copyright3Trademarks3WARNING REGARDING MEDICAL AND CLINICAL USE OF NATIONAL INSTRUMENTS PRODUCTS3Table of Contents4About This Manual11Organization of This Manual11Conventions Used in This Manual12Related Documentation13Customer Communication13Chapter 1 Overview of NI-VXI14VXIbus Overview14VXI Devices14Register-Based Devices15Message-Based Devices16Word Serial Protocol16Commander/Servant Hierarchies17Interrupts and Asynchronous Events17MXIbus Overview18MXI-2 Overview18Chapter 2 Introduction to the NI-VXI Functions20Function Groups20VXI/VME Function Groups20VXI-Only Function Groups22Calling Syntax22LabWindows/CVI23Type Definitions23Input Versus Output Parameters23Return Values and System Errors24Multiple Mainframe Support24Controllers24The extender and controller Parameters26Using NI-VXI28Header Files28The datasize.h File28The busacc.h File29The devinfo.h File29The Beginning and End of an NI-VXI Program29System Configuration Tools30Word Serial Communication32Master Memory Access33Slave Memory Access35Interrupts and Signals36Triggers38Chapter 3 Software Overview39System Configuration Functions39CloseVXIlibrary ()40CreateDevInfo (la)40FindDevLA (namepat, manid, modelcode, devclass, slot, mainframe, cmdrla, la)40GetDevInfo (la, field, fieldvalue)41GetDevInfoLong (la, field, longvalue)41GetDevInfoShort (la, field, shortvalue)41GetDevInfoStr (la, field, stringvalue)41InitVXIlibrary ()42SetDevInfo (la, field, fieldvalue)42SetDevInfoLong (la, field, longvalue)42SetDevInfoShort (la, field, shortvalue)43SetDevInfoStr (la, field, stringvalue)43Commander Word Serial Protocol Functions43Programming Considerations45Interrupt Service Routine Support45Single-Tasking Operating System Support46Cooperative Multitasking Support46Multitasking Support (Preemptive Operating System)46WSabort (la, abortop)48WSclr (la)48WScmd (la, cmd, respflag, response)48WSEcmd (la, cmdExt, cmd, respflag, response)49WSgetTmo (actualtimo)49WSLcmd (la, cmd, respflag, response)49WSLresp (la, response)49WSrd (la, buf, count, modevalue, retcount)50WSrdf (la, filename, count, modevalue, retcount)50WSresp (la, response)50WSsetTmo (timo, actualtimo)51WStrg (la)51WSwrt (la, buf, count, modevalue, retcount)51WSwrtf (la, filename, count, modevalue, retcount)52Servant Word Serial Protocol Functions52Programming Considerations53DefaultWSScmdHandler (cmd)55DefaultWSSEcmdHandler (cmdExt, cmd)55DefaultWSSLcmdHandler (cmd)55DefaultWSSrdHandler (status, count)56DefaultWSSwrtHandler (status, count)56GenProtError (proterr)56GetWSScmdHandler ()56GetWSSEcmdHandler ()57GetWSSLcmdHandler ()57GetWSSrdHandler ()57GetWSSwrtHandler ()57RespProtError ()57SetWSScmdHandler (func)57SetWSSEcmdHandler (func)58SetWSSLcmdHandler (func)58SetWSSrdHandler (func)58SetWSSwrtHandler (func)58WSSabort (abortop)59WSSdisable ()59WSSenable ()59WSSLnoResp ()59WSSLsendResp (response)59WSSnoResp ()60WSSrd (buf, count, modevalue)60WSSsendResp (response)60WSSwrt (buf, count, modevalue)60High-Level VXI/VMEbus Access Functions61Programming Considerations61VXIin (accessparms, address, width, value)62VXIinReg (la, reg, value)62VXImove (srcparms, srcaddr, destparms, destaddr, length, width)62VXIout (accessparms, address, width, value)63VXIoutReg (la, reg, value)63Low-Level VXI/VMEbus Access Functions64Programming Considerations65Multiple-Pointer Access for a Window66Owner Privilege66Access-Only Privilege66GetByteOrder (window, ordermode)68GetContext (window, context)68GetPrivilege (window, priv)68GetVXIbusStatus (controller, status)68GetVXIbusStatusInd (controller, field, status)69GetWindowRange (window, windowbase, windowend)69MapVXIAddress (accessparms, address, timo, window, ret)69MapVXIAddressSize (size)70SetByteOrder (window, ordermode)70SetContext (window, context)70SetPrivilege (window, priv)71UnMapVXIAddress (window)71VXIpeek (addressptr, width, value)71VXIpoke (addressptr, width, value)71Local Resource Access Functions72GetMyLA72ReadMODID (modid)72SetMODID (enable, modid)72VXIinLR (reg, width, value)73VXImemAlloc (size, useraddr, vxiaddr)73VXImemCopy (useraddr, bufaddr, size, dir)73VXImemFree (useraddr)73VXIoutLR (reg, width, value)74VXI Signal Functions74Programming Considerations76WaitForSignal Considerations77DefaultSignalHandler (signal)78DisableSignalInt ()78EnableSignalInt ()78GetSignalHandler (la)79RouteSignal (la, modemask)79SetSignalHandler (la, func)79SignalDeq (la, signalmask, signal)80SignalEnq (signal)80SignalJam (signal)80WaitForSignal (la, signalmask, timeout, retsignal, retsignalmask)80VXI Interrupt Functions81Programming Considerations83ROAK Versus RORA VXI/VME Interrupters84AcknowledgeVXIint (controller, level, statusId)84AssertVXIint (controller, level, statusId)85DeAssertVXIint (controller, level)85DefaultVXIintHandler (controller, level, statusId)85DisableVXIint (controller, levels)86DisableVXItoSignalInt (controller, levels)86EnableVXIint (controller, levels)86EnableVXItoSignalInt (controller, levels)87GetVXIintHandler (level)87RouteVXIint (controller, Sroute)87SetVXIintHandler (levels, func)88VXIintAcknowledgeMode (controller, modes)88VXI Trigger Functions89Capabilities of the National Instruments Triggering Hardware90External Controller/VXI-MXI-1 Trigger Capabilities91Embedded, External MXI-2, and Remote Controller Trigger Capabilities92Acceptor Trigger Functions92AcknowledgeTrig (controller, line)93DefaultTrigHandler (controller, line, type)93DefaultTrigHandler2 (controller, line, type)93DisableTrigSense (controller, line)93EnableTrigSense (controller, line, prot)93GetTrigHandler (line)94SetTrigHandler (lines, func)94WaitForTrig (controller, line, timeout)94Map Trigger Functions94MapTrigToTrig (controller, srcTrig, destTrig, mode)94UnMapTrigToTrig (controller, srcTrig, destTrig)95Source Trigger Functions95SrcTrig (controller, line, prot, timeout)95Trigger Configuration Functions96TrigAssertConfig (controller, trigline, mode)96TrigCntrConfig (controller, mode, source, count)96TrigExtConfig (controller, extline, mode)96TrigTickConfig (controller, mode, source, tcount1, tcount2)97System Interrupt Handler Functions97AssertSysreset (controller, mode)98DefaultACfailHandler (controller)98DefaultBusErrorHandler ()98DefaultSoftResetHandler ()99DefaultSysfailHandler (controller)99DefaultSysresetHandler (controller)100DisableACfail (controller)100DisableSoftReset ()100DisableSysfail (controller)100DisableSysreset (controller)101EnableACfail (controller)101EnableSoftReset ()101EnableSysfail (controller)101EnableSysreset (controller)102GetACfailHandler ()102GetBusErrorHandler ()102GetSoftResetHandler ()103GetSysfailHandler ()103GetSysresetHandler ()103SetACfailHandler (func)103SetBusErrorHandler (func)103SetSoftResetHandler (func)104SetSysfailHandler (func)104SetSysresetHandler (func)104VXI/VMEbus Extender Functions105MapECLtrig105MapTTLtrig105MapUtilBus (extender, modes)106MapVXIint (extender, levels, directions)106Appendix A Function Classification Reference107Appendix B Customer Communication120Glossary124Index140Figures10Figure 1-1. VXI Configuration Registers15Figure 1-2. VXI Software Protocols16Figure 2-1. An Embedded Controller Connected to Other Frames via Mainframe Extenders Using MXI-225Figure 2-2. An External Controller Connected Using MXI-2 to a Number of Remote Controllers26Figure 3-1. Preemptive Word Serial Mutual Exclusion (Per Logical Address)47Figure 3-2. NI-VXI Servant Word Serial Model54Figure 3-3. NI-VXI Interrupt and Signal Model77Figure 3-4. NI-VXI Interrupt and Signal Model83Tables10Table A-1. Function Listing by Group107Table A-2. Function Listing by Name113Größe: 852 KBSeiten: 149Language: EnglishHandbuch öffnen