Subscribe to Our Youtube Channel
Related Manuals for National Instruments VXI Series
Summary of Contents for National Instruments VXI Series
- Page 1 ™ Getting Started with Your VXIpc Embedded Controller for VxWorks VXIpc Controller for VxWorks Getting Started with Your VXIpc Embedded Controller for VxWorks June 2002 Edition Part Number 370552B-01...
- Page 2 Switzerland 056 200 51 51, Taiwan 02 2528 7227, United Kingdom 01635 523545 For further support information, see the Technical Support and Professional Services appendix. To comment on the documentation, send email to techpubs@ni.com. © 2002 National Instruments Corporation. All rights reserved.
- Page 3 The reader should consult National Instruments if errors are suspected. In no event shall National Instruments be liable for any damages arising out of or related to this document or the information contained in it.
- Page 4 Classification requirements are the same for the Federal Communications Commission (FCC) and the Canadian Department of Communications (DOC). Changes or modifications not expressly approved by National Instruments could void the user’s authority to operate the equipment under the FCC Rules.
- Page 5 Canadian Department of Communications This Class B digital apparatus meets all requirements of the Canadian Interference-Causing Equipment Regulations. Cet appareil numérique de la classe B respecte toutes les exigences du Règlement sur le matériel brouilleur du Canada. Compliance to EU Directives Readers in the European Union (EU) must refer to the Manufacturer’s Declaration of Conformity (DoC) for information** pertaining to the CE Mark compliance scheme.
-
Page 6: Table Of Contents
Record Configuration to File................3-2 Load Configuration from File .................3-2 Revert to Current Configuration..............3-2 Logical Address Configuration Editor ............3-3 Logical Address ................3-3 Device Type ..................3-3 Address Space ...................3-3 VXI Shared RAM Size ..............3-4 © National Instruments Corporation VXIpc Controller for VxWorks... - Page 7 Contents Shared RAM Pool................3-4 Advanced Shared RAM Settings ............3-4 Resource Manager Delay..............3-5 Device Configuration Editor ................3-5 System IRQ Level ................3-5 Servant Area Size ................3-6 Number of Handlers ................. 3-6 Number of Interrupters ..............3-6 Protocol Register ................
- Page 8 Programming with VXI and GPIB ................4-3 Additional Compiler Information..............4-5 Compiling Your C Program...................4-5 #define Statement Used in NI-VXI ..............4-5 Appendix A Default Settings Appendix B Common Questions Appendix C Technical Support and Professional Services Glossary Index © National Instruments Corporation VXIpc Controller for VxWorks...
-
Page 9: About This Manual
Embedded Controllers Reference and VxWorks Manual GPIB Reference Change Hardware Utilities Settings (Optional) Reference Online Online NI-VXI NI-VISA Use Online User Manual User Manual Utilities: NI-VXI vxitedit, NI-VISA Programmer victext Programmer Reference Reference © National Instruments Corporation VXIpc Controller for VxWorks... -
Page 10: Conventions
About This Manual Begin by reading this manual for basic instructions on setting up the hardware and software. This manual describes how to get started with your kit using the default hardware and software settings, and describes optional settings you can configure using the NI-VXI/NI-VISA software. You received either the VXIpc 800 Series User Manual, the VXIpc 700 Series User Manual, or the VXIpc 770/870B Series User Manual with your kit, depending on the hardware product you purchased. -
Page 11: Related Documentation
VXI-6, VXIbus Mainframe Extender Specification, Rev. 1.0, VXIbus Consortium • VxWorks Programmer’s Guide, 5.3.1 (or later), Wind River Systems, Inc. • VxWorks Reference Manual, 5.3 (or later), Wind River Systems, Inc. © National Instruments Corporation xiii VXIpc Controller for VxWorks... -
Page 12: Introduction
What You Need to Get Started ❑ VXIpc 800 Series or VXIpc 700 Series embedded controller (hereafter described together as the VXIpc controller) ❑ VXIbus mainframe ❑ Keyboard (and included adapter cable) © National Instruments Corporation VXIpc Controller for VxWorks... -
Page 13: Hardware Description
Chapter 1 Introduction ❑ Monitor with VGA connector ❑ National Instruments software media for the VXIpc embedded controller ❑ VxWorks Development System The NI-VXI software is already installed on your VXIpc computer. It is also included on disk in case you need to reinstall your software. - Page 14 VISA is the industry standard for developing instrument drivers. Most current drivers written by National Instruments use NI-VISA and support Windows, Solaris 2, VxWorks, Linux, and Macintosh, as long as the appropriate system-level drivers are available for that platform. NI-VISA for VxWorks currently supports only the VXI and Serial interfaces.
-
Page 15: Software Notes For Vxworks
Chapter 1 Introduction Software Notes for VxWorks The software configuration for NI-VXI for VxWorks offers all the functionality of our NI-VXI drivers for other platforms, within the text-based VxWorks environment. Use vxitedit to reconfigure your VXI hardware and victext to interactively perform NI-VXI operations accessing your VXI devices. -
Page 16: Developing For Vxworks
Software Included with Your VXIpc Controller The software that comes with your VxWorks-based controller falls under two main categories: host based and target based. All National Instruments software that you need to run NI-VXI on your embedded controller—the development target—is already installed on the VXIpc hard drive. The host software is provided separately for you to install on your Windows-based workstation. -
Page 17: Reinstalling The Ni-Vxi Software
Chapter 1 Introduction Reinstalling the NI-VXI Software The NI-VXI software for VxWorks is already installed on your VXIpc hard drive. However, if for some reason you need to reinstall the software, perform the following steps: Be sure you have up to 5 MB of free space available to accommodate the NI-VXI software. -
Page 18: Setup
Caution To protect both yourself and the mainframe from electrical hazards, leave the mainframe off until you finish installing the VXIpc module. Plug in your chassis, but leave the power turned off. © National Instruments Corporation VXIpc Controller for VxWorks... -
Page 19: Step 3. Set Up The Vxipc Controller With Vxworks
Run the installer on the Host-Side Software for VXIpc with VxWorks disk to install the VXIpc board support package (BSP), online help, example files, header files, and other required software from National Instruments into the subdirectory of your Tornado target installation. - Page 20 VxWorks tab of the Tornado graphical project manager and change the selected model (or define the appropriate … macro in the Makefile if you are not using the INCLUDE_VXIPC_ graphical interface). © National Instruments Corporation VXIpc Controller for VxWorks...
- Page 21 Chapter 2 Setup If you make changes to the hardware in your system—for example, if you add a new plug-in card or alter the interrupt used by a device—you may need to change the BSP default settings to reflect your change. Refer to your VxWorks Programmer’s Guide for full details about installation.
- Page 22 ESP API, use other GPIB objects ( nigpib.o esp_pci.o etc.) instead. Refer to the GPIB in the BSP for details. README.TXT Refer to the NI-VISA and GPIB manuals for VxWorks to learn more details about these libraries. © National Instruments Corporation VXIpc Controller for VxWorks...
-
Page 23: Vxi Configuration Utility
For instructions on using the other editors, refer to the NI-VXI Text Utilities Reference Manual. VXIpc Configuration Editor The first three options under the VXIpc Configuration Editor are: • Logical Address Configuration Editor • Device Configuration Editor • Bus Configuration Editor © National Instruments Corporation VXIpc Controller for VxWorks... -
Page 24: Update Current Configuration
Chapter 3 VXI Configuration Utility When making changes to the VXIpc controller through these editors, remember that the changes do not take effect until you commit them by selecting the Update Current Configuration option. Before proceeding to a description of each field in these editors, review the remaining four options of the VXIpc Configuration Editor. -
Page 25: Logical Address Configuration Editor
This field indicates the addressing mode(s) of the device’s operational registers. You can configure the VXIpc controller in one of three ways. The default addressing mode is for A16 space only. Your other options are A16/A24 and A16/A32. © National Instruments Corporation VXIpc Controller for VxWorks... -
Page 26: Vxi Shared Ram Size
Chapter 3 VXI Configuration Utility Notice that options relating to VXI shared memory are disabled when the Address Space option is set to A16. Only if you select A16/A24 or A16/A32 are the following options relevant: • VXI Shared RAM Size •... -
Page 27: Resource Manager Delay
VXIpc through a VXI IRQ line. This field selects which VXI IRQ level the remote controllers should use to report such events. Interrupt Request Levels Default Value 1 to 7 or disabled Disabled © National Instruments Corporation VXIpc Controller for VxWorks... -
Page 28: Servant Area Size
Chapter 3 VXI Configuration Utility When the system IRQ line is disabled, the remote controller functionality is not Note available. Enable the system IRQ line if you are using a multi-mainframe system. The VXI IRQ designated as system IRQ line cannot be disabled using the functions. -
Page 29: Protocol Register
When the Enable Auto Retry protocol option is active, the VXIpc controller can recognize and send the VXIbus retry protocol. If you disable this option, a retry is mapped to a bus error response. By default this option is enabled. © National Instruments Corporation VXIpc Controller for VxWorks... -
Page 30: Automatic Vxi Slave Cycle Retry
Chapter 3 VXI Configuration Utility Automatic VXI Slave Cycle Retry ♦ This option is not available in the VXIpc 700 Series. The VXIpc 800 Series has an automatic retry feature for cycles that map from the VXIbus to the PCI bus on the VXIpc 800. You can use the Automatically retry VXI slave cycles field to enable or disable this option. -
Page 31: Arbiter Type
VXIpc acts as either a fair or unfair requester on the VXIbus. By default the VXIpc controller operates as an unfair requester. For more information on the different types of requesters, refer to the VMEbus specification. © National Instruments Corporation VXIpc Controller for VxWorks... -
Page 32: Arbiter Timeout
Chapter 3 VXI Configuration Utility Arbiter Timeout An arbitration timeout feature is available on the VXIpc controller when it is acting as the VMEbus arbiter. This feature applies only to a VXI Slot 0 VXIpc. By default, this option is disabled. If you enable this feature, the timer begins when the arbiter circuit on the VXIpc drives one of the BGOUT lines on the backplane. -
Page 33: Vxi/Vme-Mxi-2 Configuration Editor
You can set or modify the logical address of the VXI/VME-MXI-2 either within the VXI/VME-MXI-2 Configuration Editor itself or with the onboard 8-position DIP switch. To select the configuration method you prefer, use the Logical Address Source options. © National Instruments Corporation 3-11 VXIpc Controller for VxWorks... -
Page 34: Address Space And Requested Memory
Chapter 3 VXI Configuration Utility The default selection is the Switch option. Notice that the Logical Address is read only. In this option you need to change the hardware switch setting on the VXI/VME-MXI-2 itself if you want to change the logical address. If you select Soft LA for this option, you can then use the Logical Address feature to select a logical address within the range of 1 to 254. -
Page 35: Interlocked Mode
VXI/VME-MXI-2 for interlocked arbitration mode. In this mode, no software provisions for deadlock conditions are required. However, parallel accesses in separate VXI/VMEbus mainframes are no © National Instruments Corporation 3-13 VXIpc Controller for VxWorks... -
Page 36: Vmebus System Controller
Chapter 3 VXI Configuration Utility longer possible, and system performance may be lower than in normal operating mode. In a VXI/VMEbus/MXIbus system, you can configure some VXI/VME-MXI-2 modules for normal operating mode and others for interlocked arbitration mode. The VXI/VMEbus mainframes configured in interlocked arbitration mode will be interlocked with each other and the mainframes configured for normal operating mode can perform transfers in parallel. -
Page 37: Vxi/Vme Auto Retry
MXIbus cycles as much time as possible to complete. The lowest value in the allowable range is 15 µs, and the highest value is 256 ms. The default value is 125 µs. © National Instruments Corporation 3-15 VXIpc Controller for VxWorks... -
Page 38: Vxi/Vme Transfer Limit
Chapter 3 VXI Configuration Utility VXI/VME Transfer Limit You can use this feature to control how many data transfers the VXI/VME-MXI-2 will perform on the VXI/VMEbus before releasing it to another master device that is requesting use of the bus. You can choose 16, 64, or 256 transfers. -
Page 39: Vxi/Vme Fair Requester
VXI/VME cycle that receives a retry response instead of passing a retry response on to the MXIbus. The VXI/VME-MXI-2 automatically continues to retry the VXI/VME cycle until it receives either a DTACK or BERR response, which it then passes to the MXIbus. © National Instruments Corporation 3-17 VXIpc Controller for VxWorks... -
Page 40: Mxi Bus Timeout Value
Chapter 3 VXI Configuration Utility Notice that the VXI/VME-MXI-2 has a limit on the number of automatic retries it will perform on any one cycle. If the limit is exceeded and the VXI/VME-MXI-2 receives another retry, it will pass a retry back to the MXIbus even though VXI Auto Retry is enabled. -
Page 41: Parity Checking
If you enable this option, the VXI/VME-MXI-2 will request the MXIbus only when there are no requests pending from other MXIbus masters. This prevents other MXIbus masters from being starved of bandwidth. © National Instruments Corporation 3-19 VXIpc Controller for VxWorks... -
Page 42: Developing Your Application
Use the VXIpc Configuration Editor or the VXI/VME-MXI-2 Configuration Editor available in vxitedit to view or change the settings for your devices. © National Instruments Corporation VXIpc Controller for VxWorks... -
Page 43: Device Interaction
Chapter 4 Developing Your Application Device Interaction You can interact with your VXI devices by using the victext utility. This utility lets you interactively control your VXI devices. Try the following in victext. In the Command entry field type: help vxiinreg This help file shows you the syntax for this command, which reads VXI device configuration registers. -
Page 44: Programming With Vxi And Gpib
National Instruments provides three different programming interfaces for accessing your instruments: NI-VISA, NI-VXI, and NI-488.2. NI-VISA is the National Instruments implementation of the VISA API as defined by the VXIplug&play standard. It is very useful in situations where you have different types of instruments in your system—such as VXI, VME, GPIB,... - Page 45 Chapter 4 Developing Your Application Controller, usually a computer, and up to 14 additional instruments. The ANSI/IEEE Standard 488.2-1992 extends IEEE-488.1 by defining a bus communication protocol, a common set of data codes and formats, and a generic set of common device commands. The best way to learn how to program with NI-VXI and NI-VISA is by reviewing the example programs included in your software.
-
Page 46: Additional Compiler Information
#define before including the NI-VXI header file . If you use the makefiles nivxi.h to compile the sample program, the makefile already defines the necessary symbol. © National Instruments Corporation VXIpc Controller for VxWorks... - Page 47 Chapter 4 Developing Your Application If you define this symbol in your source code, your source code should look something like the following sample code: #define VXIWVXWORKS #include <nivxi.h> If you define these symbols using the compiler option, you should specify the following when invoking the compiler.
-
Page 48: Appendix A Default Settings
1–2 Disable MITE self-configuration 2–3 MITE user configuration 1–2 MITE factory configuration 1–2 Internal oscillator 2–3 External oscillator * These pins are generally defined in a figure on the hard drive cover. © National Instruments Corporation VXIpc Controller for VxWorks... - Page 49 Appendix A Default Settings Table A-2. VXIpc 870 Series Hardware Default Settings Jumper Default Setting Optional Setting Enable automatic Slot 0 detection Force Slot 0; Force Non-Slot 0 MITE user configuration MITE factory configuration Enable MITE self-configuration Disable MITE self-configuration W1, 3, 5, 7 CPU bus factor Note: For more information, refer to...
- Page 50 0 KB Shared RAM Pool 0 KB Lower Half Window Byte Swapping Disabled (nonswapped) Upper Half Window Byte Swapping Disabled (nonswapped) Map Upper and Lower Halves to Same Address Disabled Resource Manager Delay © National Instruments Corporation VXIpc Controller for VxWorks...
- Page 51 Appendix A Default Settings Table A-6. Device Configuration Editor Default Settings Editor Field Default Setting System IRQ Level Disabled Servant Area Size Number of Handlers Number of Interrupters Protocol Register 0xFF0 Read Protocol Response 0x8448 Table A-7. Bus Configuration Editor Default Settings Editor Field Default Setting Bus Timeout...
-
Page 52: Appendix B Common Questions
Device Configuration Editors to change aspects of the hardware and software. Reboot to initialize your National Instruments hardware. Reload the tools you need and run Resman to initialize the VXIbus. Optionally run vxitedit to configure any extender devices on the VXIbus. - Page 53 • Resman—This utility initializes and configures all the other devices in your VXI system. • vxitedit—This utility configures your National Instruments hardware. • victext—This utility allows you to communicate interactively with VXI devices over the VXIbus using the NI-VXI API.
- Page 54 To test individual devices, you can use the victext program to interactively issue NI-VXI functions. You can use the vxiin() vxiout() functions or the functions to test vxiinReg() vxioutReg() register-based devices by programming their registers. If you have any © National Instruments Corporation VXIpc Controller for VxWorks...
- Page 55 Appendix B Common Questions message-based devices, you can send and receive messages with the functions. Notice that wswrt() wsrd() vxiinReg() are for VXI devices only. vxioutReg() What should I do if I get a Configuration EEPROM is Invalid message? There are several reasons why you could receive this message. If you turn off the computer while the configuration update process is still in progress, the VXIpc functions normally except when using vxitedit.
- Page 56 How do I add RAM to the VXIpc? What is the maximum amount of RAM that I can have? For information about adding RAM to the VXIpc controller, refer to Appendix A, Specifications, in your VXIpc user manual. © National Instruments Corporation VXIpc Controller for VxWorks...
- Page 57 Appendix B Common Questions Which interrupt levels are free to be used by ISA bus boards? Which area of upper memory (adapter space) is free for use by ISA bus boards or expanded memory manager software programs? Refer to the appendix on VXIpc system resources in your VXIpc user manual for information on the available port I/O register space, upper memory area, interrupts, and DMA channels.
- Page 58 Technical Support and Professional Services Visit the following sections of the National Instruments Web site at for technical support and professional services: ni.com • Support—Online technical support resources include the following: – Self-Help Resources—For immediate answers and solutions, visit our extensive library of technical support resources available in English, Japanese, and Spanish at .
- Page 59 Valid numbers for n are 16, 24, and 32. In VME/VXI, because there are six address modifiers, there are 64 possible address spaces. address window a portion of address space that can be accessed from the application program © National Instruments Corporation VXIpc Controller for VxWorks...
- Page 60 Glossary ANSI American National Standards Institute ASIC Application-Specific Integrated Circuit bytes backplane an assembly, typically a printed circuit board, with 96-pin connectors and signal paths that bus the connector pins. A C-size VXIbus system has two sets of bused connectors called J1 and J2. A D-size VXIbus system has three sets of bused connectors called J1, J2, and J3.
- Page 61 CPU (controller) interface plugged directly into the VXI backplane, giving it direct access to the VXIbus. It must have all of its required VXI interface capabilities built in. © National Instruments Corporation VXIpc Controller for VxWorks...
- Page 62 Glossary fair requester a VXIbus device that will not arbitrate for the VXIbus after releasing it until it detects the bus request signal inactive. This ensures that all requesting devices will be granted use of the bus. frame number the frame number is the logical address of the lowest-numbered device in the frame.
- Page 63 These devices are able to use Word Serial Protocol to communicate with one another through communication registers. MITE a National Instruments custom ASIC, a sophisticated dual-channel DMA controller that incorporates the Synchronous MXI and VME64 protocols to achieve high-performance block transfer rates NI-VXI...
- Page 64 Register-based devices are typically controlled by message-based devices via device-dependent register reads and writes. Resman the name of the National Instruments Resource Manager in the NI-VXI bus interface software. See Resource Manager. Resource Manager a message-based Commander located at Logical Address 0 that provides...
- Page 65 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. Versa Module Eurocard or IEEE 1014 © National Instruments Corporation VXIpc Controller for VxWorks...
- Page 66 Glossary VMEbus System a device configured for installation in Slot 0 of a VXIbus mainframe or Slot Controller 1 of a VMEbus chassis. This device is unique in the VMEbus system in that it performs the VMEbus System Controller functions, including clock sourcing and arbitration for data transfers across the backplane.
- Page 67 VXI/VME, 3-15 reconfiguring hardware, 4-1 VXIbus, 3-7 reference manuals, xii byte swapping, Upper/Lower Half Window field, 3-4 resetting of devices by power cycling (note), 4-1 VME support, 4-2 VXIpc Configuration Editor, 4-1 © National Instruments Corporation VXIpc Controller for VxWorks...
- Page 68 3-2 device interaction using victext utility, 4-2 running the vxitedit configuration device type, setting, 3-3 utility, 3-1 diagnostic resources, C-1 VXIpc Configuration Editor, 3-1 directories pre-installed on hard drive, 1-4 contacting National Instruments, C-1 VXIpc Controller for VxWorks ni.com...
- Page 69 B-6 interrupts for ISA bus boards, B-6 getting started, 1-4 introduction, 1-1 hardware description, 1-2 IRQ level (system), selecting, 3-5 software description, 1-2 ISA bus boards, B-6 what you need, 1-1 © National Instruments Corporation VXIpc Controller for VxWorks...
- Page 70 C-1 system integration services, C-1 technical support, C-1 LEDs on front panel, B-4 worldwide offices, C-1 load configuration from file, 3-2 National Instruments software, 1-2, 4-3 logical address configuration NI-488.2 VXI/VME-MXI-2, 3-11 programming with, 4-3 VXIpc, 3-3 software for VxWorks kit, 1-3...
- Page 71 Shared RAM Pool field, VXI Shared Ram, 3-4 VME Data Transfer Bus, 3-16 shared RAM. See VXI Shared RAM options VXIpc, 3-9 slave cycle retry, automatic, 3-8 Requested Memory field, 3-12 © National Instruments Corporation VXIpc Controller for VxWorks...
- Page 72 Index Slot 0 installation considerations testing system, B-3 VMEbus System Controller timeout (caution), 3-15 arbiter timeout setting, 3-10 VXIpc controller, B-6 arbiter timeout, setting software VXI/VME-MXI-2, 3-16 See also NI-VXI software; application BTO (bus timeout), 3-15 development MXI Bus Timeout Value, 3-18 #define statement in NI-VXI, 4-5 VXI bus timeout, 3-7, 3-8 compiling C programs, 4-5...
- Page 73 VXI/VME-MXI-2, 3-12 hardware default settings (table), A-2 A24/A32 write posting VXIpc 870 Series VXI/VME-MXI-2, 3-12 hardware default settings (table), A-2 VXIpc controller, 3-8 VXIpc Bus Configuration Editor, 3-7 default settings (table), A-4 © National Instruments Corporation VXIpc Controller for VxWorks...
Need help?
Do you have a question about the VXI Series and is the answer not in the manual?
Questions and answers