National Instruments VXI Series, Getting Started

Page 1: ...XI 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: ...48 14 24 24 Germany 089 741 31 30 Greece 01 42 96 427 Hong Kong 2645 3186 India 91 80 4190000 Israel 03 6393737 Italy 02 413091 Japan 03 5472 2970 Korea 02 3451 3400 Malaysia 603 9596711 Mexico 001 80...

Page 3: ...installation operation or maintenance instructions owner s modification of the product owner s abuse misuse or negligent acts and power failure or surges fire flood accident actions of third parties o...

Page 4: ...ments could void the user s authority to operate the equipment under the FCC Rules Class A Federal Communications Commission This equipment has been tested and found to comply with the limits for a Cl...

Page 5: ...ought for OEMs if also available from an original manufacturer that also markets in the EU or where compliance is not required as for electrically benign apparatus or cables To obtain the DoC for this...

Page 6: ...4 Developing for VxWorks 1 5 Software Included with Your VXIpc Controller 1 5 Reinstalling the NI VXI Software 1 6 Chapter 2 Setup Step 1 Configure the Hardware 2 1 Step 2 Install the Hardware 2 1 Ste...

Page 7: ...fer Limit 3 8 Arbiter Type 3 9 Request Level 3 9 VXI Fair Requester 3 9 Arbiter Timeout 3 10 User Window and Driver Window 3 10 VXI VME MXI 2 Configuration Editor 3 11 Logical Address 3 11 Address Spa...

Page 8: ...figuration 4 1 Device Interaction 4 2 VME Support 4 2 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...

Page 9: ...ns contain as much information as you need to get started with your VXIpc kit How To Use the Manual Set Getting Started Manual Installation Setup and Configuration VXIpc 800 or 700 Series User Manual...

Page 10: ...erence Manual and the NI VISA Programmer Reference Manual contain detailed explanations of NI VXI and NI VISA functions Study the descriptions of each function to fully understand the purpose and synt...

Page 11: ...ce italic Italic text in this font denotes text that is a placeholder for a word or value that you must supply VXIpc 700 Series The terms VXIpc 700 Series and VXIpc 700 refer to a series of C size sin...

Page 12: ...to turn in this manual for more details on configuring and using the hardware and software What You Need to Get Started VXIpc 800 Series or VXIpc 700 Series embedded controller hereafter described to...

Page 13: ...calls These embedded computers can take advantage of the VXI high performance backplane capabilities and give you direct control of VXI registers memory interrupts and triggers For in depth details on...

Page 14: ...mmand to write an ASCII string to a message based instrument is the same whether the instrument is Serial GPIB or VXI As a result NI VISA gives you interface independence This makes it easier to switc...

Page 15: ...for proper operation The nivxi directory contains several levels of subdirectories that contain help files tables of information for the driver and other necessary files for NI VXI The vxipnp director...

Page 16: ...ograms actually execute on the VXIpc target machine Software Included with Your VXIpc Controller The software that comes with your VxWorks based controller falls under two main categories host based a...

Page 17: ...tted your hard drive set up the VxWorks boot block by using the vxsys command on the drive vxsys is part of your Tornado installation You can find more details on this process in the BSP section in th...

Page 18: ...settings are acceptable for most typical applications Refer to Appendix A Default Settings for a complete listing of the hardware and software default settings The VXIpc 800 Series User Manual the VX...

Page 19: ...o complete your installation attach cables for any devices you want to connect to your system Refer to your VXIpc user manual if you are uncertain about any of these connections 7 Turn on power to the...

Page 20: ...B series for Ethernet host host computer s name on the network file name the location of your VxWorks image inet address site specific host inet site specific When you finish your changes the new sett...

Page 21: ...uses for these files set the environment variable NIVXIPATH as follows putenv NIVXIPATH your_path 7 Run the Resource Manager to set up your VXI system by typing resman at the prompt This program autom...

Page 22: ...nd application Normally this is the PCI based NI 488 2 board level API ld nigpib_p o For older VXIpc controllers with ISA based GPIB interfaces or to use the older ESP API use other GPIB objects nigpi...

Page 23: ...guration editors Select the VXIpc Configuration Editor from the main menu Later in this chapter are instructions for using the VXI VME MXI 2 Configuration Editor in case your system contains a VXI MXI...

Page 24: ...by using the reset button or by turning the power off and on again Record Configuration to File Use this option to save your configuration settings to a file Notice that this option does not write the...

Page 25: ...lue Device Type This field indicates the classification of the VXIpc controller The default value is MBD designating a message based device The following table shows the available options The device t...

Page 26: ...the Address Space field to use A32 space Shared RAM Pool This field indicates the size of memory in kilobytes that is allocated on NI VXI startup This is physically contiguous memory that can be dual...

Page 27: ...byte order The setting of the Byte Swapping option for each half window determines whether the byte order is Little Endian or Big Endian Resource Manager Delay Note This field is effective only when t...

Page 28: ...s not the Resource Manager in your system The servant area size is an 8 bit value 0 through 255 that indicates the servant area The servant area begins at the logical address following the VXIpc contr...

Page 29: ...ial Trigger Instrument Extended Longword Serial Longword Serial Bus Configuration Editor Use the Bus Configuration Editor to configure VXI bus settings PCI bus settings and bus arbitration settings fo...

Page 30: ...disabled you can lower the value of the VXI Bus Timeout because there is no delay from the inward cycles being retried Note The VXIpc 800 has a limit on the number of automatic retries it will perfor...

Page 31: ...est level Refer to the VMEbus specification for more information on the different types of arbiters Request Level The VXIpc controller uses one of the four VXIbus request levels 0 to 3 to request use...

Page 32: ...ped to PCI base address registers and determine the amount of PCI memory space the VXIpc requests from the PCI system during initialization You can set the window base window size and whether the wind...

Page 33: ...XI 2 Configuration Editor you must run Resman Note Throughout this section the term VXI VME MXI 2 denotes that the information applies equally to the VXI MXI 2 and the VME MXI 2 When you start the VXI...

Page 34: ...ce These options are necessary if you change the amount of DRAM installed on the VXI VME MXI 2 The amount of memory you set with the Requested Memory field should match the amount of DRAM installed on...

Page 35: ...arbitration in the VXI VMEbus MXIbus system By default this option is disabled which puts the VXI VME MXI 2 in normal operating mode In normal operating mode noninterlocked multiple masters can operat...

Page 36: ...lock when a MXIbus master attempts a transfer into the VXI VMEbus mainframe You can configure the VXI VME MXI 2 devices in this mainframe for normal operating mode A VXI VMEbus mainframe in which all...

Page 37: ...nse back to the VXI VMEbus The VXI VME MXI 2 automatically continues to retry the MXI cycle until it receives either a DTACK or BERR response which it then passes to the VXI VMEbus Notice there is a l...

Page 38: ...bin arbitration mode the VXI VME MXI 2 grants the bus to the next highest bus request level after the level of the previous bus owner This effectively gives the same priority to each bus request level...

Page 39: ...he VXI VME MXI 2 acts as the MXI Bus System Controller When the Auto setting the default setting is active the VXI VME MXI 2 automatically can sense from the MXIbus cable whether it should be the cont...

Page 40: ...rent MXIbus cycle maps to the VXI VMEbus through a VXI VME MXI 2 Transfer Limit You can use this feature to control how many data transfers the VXI VME MXI 2 will perform on the MXIbus before releasin...

Page 41: ...y Checking By default MXIbus parity checking is enabled and should not be disabled under normal circumstances MXIbus parity is always generated regardless if checking is enabled or disabled MXI Fair R...

Page 42: ...source Manager functions as described in the VXIbus specification Its most important functions include configuring all devices on the VXI backplane for operation and allocating memory for devices that...

Page 43: ...ufacturer ID from the VXIpc controller s ID register You may now want to read the configuration registers from other VXI devices in your system using the command vxiinreg This command accesses only th...

Page 44: ...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...

Page 45: ...e other examples as you try more advanced techniques Consult the NI VXI User Manual the NI VISA User Manual or the GPIB online help for additional information on these topics Note By default the NI VX...

Page 46: ...e the sample program using the makefile provided to get familiar with how the functions operate The example program is broken into multiple files and each file shows how to use different groups of fun...

Page 47: ...ivxi h If you define these symbols using the D compiler option you should specify the following when invoking the compiler DVXIVXWORKS Refer to the documentation that came with your compiler package f...

Page 48: ...the software default settings for the VXI VME MXI 2 VXIpc Controller This section summarizes the hardware and software default settings for the VXIpc controllers Table A 1 VXIpc 770 870B Series Hardwa...

Page 49: ...on W10 Enable Ethernet Serial EEPROM configuration Disable Ethernet Serial EEPROM configuration uses default power on values W11 12 Enable 16 bit SCSI termination SCSI termination W15 Voltage monitor...

Page 50: ...ing W7 MITE Configuration EEPROM Load values from user section W10 Power On Self Configuration POSC Enabled Do not alter this setting W12 TrigIn SMB Termination Do not terminate Table A 5 Logical Addr...

Page 51: ...s Configuration Editor Default Settings Editor Field Default Setting Bus Timeout 500 Automatic Retry Protocol Enabled Automatic VXI Slave Cycle Retry Enabled on the VXIpc 800 Series Disabled on the VX...

Page 52: ...to initialize the VXIbus 7 Optionally run vxitedit to configure any extender devices on the VXIbus 8 Run victext to verify device operation 9 Load and run your NI VXI NI VISA and or NI 488 2 GPIB appl...

Page 53: ...ical address and is a message based device you need to start Resman before running it on the Logical Address 0 computer When do you need to run Resman Run Resman whenever you need to configure your VX...

Page 54: ...the nivxi directory You can access this information using the NI VXI system configuration functions described in detail in Chapter 2 Function Reference of the NI VXI Programmer Reference Manual Resma...

Page 55: ...ddress assigned for the driver window or the memory for the MITE s configuration EEPROM may not be mapped correctly If a mapping error is the cause follow the instructions in the Step 3 Set up the VXI...

Page 56: ...ts this specification Enabling the Super VGA option on a monitor that does not meet this specification will damage your monitor What should I do if my keyboard connector does not fit into the keyboard...

Page 57: ...ler automatically detects whether it is in Slot 0 of a VXIbus mainframe You do not need to change jumper settings to install the VXIpc in a slot other than Slot 0 unless you have defeated the first sl...

Page 58: ...on Assisted Support Options Contact NI engineers and other measurement and automation professionals by visiting ni com ask Our online system helps you define your question and connects you to the expe...

Page 59: ...standard address space A32 space VXIbus address space equivalent to the VME 4 GB extended address space address character code that identifies a specific location or series of locations in memory add...

Page 60: ...e is created for a given target BTO See Bus Timeout Unit Bus Timeout Unit a functional module that times the duration of each data transfer and terminates the cycle if the duration is excessive Withou...

Page 61: ...s on the VMEbus backplane The DTB is used by a bus master to transfer binary data between itself and a slave device DMA Direct Memory Access a method by which data is transferred between devices and i...

Page 62: ...ystem with base 16 using the digits 0 to 9 and letters A to F host the computer where development of your real time application takes place In the VxWorks environment this is where you install Tornado...

Page 63: ...MB megabytes of memory MBD Message Based Device message based device an intelligent device that implements the defined VXIbus registers and communication protocols These devices are able to use Word S...

Page 64: ...ocated at Logical Address 0 that provides configuration management services such as address map configuration Commander and Servant mappings and self test and diagnostic management retry an acknowledg...

Page 65: ...de runs Code is compiled on a host machine and transferred to the target for example a VXIpc controller running VxWorks Tornado an integrated development environment for VxWorks provided by Wind River...

Page 66: ...bus configurations vxitedit VXI Resource Editor program a part of the NI VXI bus interface software package Used to configure the system edit the manufacturer name and ID numbers edit the model names...

Page 67: ...A 1 3 NI VXI and NI VISA example programs 4 4 programming with VXI and GPIB 4 3 reconfiguring hardware 4 1 reference manuals xii resetting of devices by power cycling note 4 1 VME support 4 2 VXIpc Co...

Page 68: ...3 2 revert to current configuration 3 2 running the vxitedit configuration utility 3 1 VXIpc Configuration Editor 3 1 contacting National Instruments C 1 controllers See System Controller VXIpc contro...

Page 69: ...3 G getting started 1 4 hardware description 1 2 software description 1 2 what you need 1 1 GPIB programming with 4 3 reference manual xii software 1 3 H handlers for interrupts selecting number of 3...

Page 70: ...Value setting 3 18 MXI CLK10 signal 3 18 MXI fair requester 3 19 N National Instruments customer education C 1 professional services C 1 system integration services C 1 technical support C 1 worldwid...

Page 71: ...xiii request level setting VME Data Transfer Bus 3 16 VXIpc 3 9 Requested Memory field 3 12 requirements for getting started 1 1 resetting of devices by power cycling note 4 1 Resman 2 4 4 1 4 2 defin...

Page 72: ...4 System Controller MXI bus 3 17 Slot 0 considerations caution 3 15 VMEbus 3 14 system integration services C 1 system IRQ level selecting 3 5 system testing B 3 T technical support C 1 telephone tech...

Page 73: ...XIpc 770 870B Series hardware default settings table A 1 VXIpc 800 Series audio capability B 5 hardware default settings table A 2 VXIpc 870 Series hardware default settings table A 2 VXIpc Bus Config...