Home

ProDAQ 3020 User Manual

1. um N Compound Device d d N Tier 7 Figure 6 USB Bus Topology USB 2 0 host controllers and hubs provide capabilities so that full speed and low speed data can be transmitted at high speed between the host controller and the hub but transmitted between the hub and the device at full speed or low speed This capability minimizes the impact that full speed and low speed devices have upon the bandwidth available for high speed devices Page 14 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 2 4 Installing the ProDAQ 3020 USB Driver After re starting your computer turn on the VXI mainframe and or connect the ProDAQ 3020 USB 2 0 VXlbus Slot 0 Interface via the USB bus to the PC Because the USB bus is hot plug capable the system will detect the event and will start to look for a driver for the new hardware In the New Hardware Wizard select Search for a suitable driver for my device Install Hardware Device Divers ow A device diver is software program thal enables a hardware device to work wih an operaling system This vazad wal complete the metalation or this dece e ProDAD 3020 USB2 0 VXIbus 514 Intedace device dene ss toltas progiam that makas hardware device work Windows needs diver Mes for your new device To locale diver files end complete the nstalistion click Next Whal do you want the wizard to do
2. Page 34 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM ViStatus function rmw register ViSession instr session ViBusAddress offset ViUIntl6 mod ViStatus status ViChar descr 256 ViUInt16 value D if status viln16 instr session VI A16 SPACE offset amp value VI SUCCESS viStatusDesc instr session status descr if status gt VI SUCCESS printf VISA WARNING vilInl6 returned status 08x s n status descr else printf VISA ERROR vilInl6 returned status 08x s n status descr return status value value mod if status viOut16 instr session VI A16 SPACE offset value VI SUCCESS viStatusDesc instr session status descr if status gt VI SUCCESS printf VISA WARNING viOut16 returned status 08x s n status descr else printf VISA ERROR viOut16 returned status 08x s n status descr return status return VI_SUCCESS Figure 29 Memory based I O The second group of functions is intended to map a register range into the memory of the host and accessing it directly Because this ability is architecture and system dependent the VISA standard foresees an attribute which allows determining whether the range could be physically mapped or the system architecture does not allow it Depending on the value of the attribute VI ATTR WIN ACCESS the rang
3. handle errors or warnings not shown here now move a block of 64 bit data from the instrument to the buffer status viMoveOut32 instr session VI A32 SPACE MEM START 1024 data VI SUCCESS handle errors or warnings not shown here close the sessions as shown in Figure 28 Opening a VISA Session Figure 33 Performing VXlbus Block Transfers Copyright 2003 Bustec Production Ltd Page 39 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual 3 3 Programming Message based Devices Message based VXIbus devices implement the word serial protocol to communicate with the application Programming is done by sending ASCII messages to the device and reading its answer 3 3 1 Writing and Reading Messages The basic functions to write and read messages to from devices are the two functions viRead and viWrite They implement the word serial protocol for message based devices but they do so on a very basic level The user needs to build his message and use viWrite to send it to the device Then he uses viRead to receive the message sent back The message received might consists of strings numbers and formatting characters and he will need to interpret this message To avoid some of these steps a couple of higher level functions were implemented in the VISA The following examples shows how to use the functions viPrintf and viScanf to read the identification of a device include lt v
4. RST n VI SUCCESS error handling as shown in the previous examples ask the device for its identification status viPrintf vi IDN n VI SUCCESS error handling as shown in the previous examples read the identification sent back 4 if status viScanf vi 256t descr VI SUCCESS error handling as shown in the previous examples printf Device Identification s n descr close the sessions to the instrument and the resource manager viClose instr session viClose rm session Figure 37 Reading and writing messages to from a GPIB device As explained in 3 1 Connecting to a Device the first step in a program using the VISA library is always to open a session to the default resource manager It provides connectivity to all VISA resources registered with it and gives applications control and access to individual resources The next step is to open a session to the instrument using a resource name as explained above Once the session is established the standard functions viPrintf and viScanf amp can be used to write messages to the device and read the response As a last step the sessions to the device and to the default resource manager need to be closed G Page 46 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 5 VXIbus Configuration Register Details
5. 5 1 Address Map All addresses are given in hexadecimal notation Offset value is an offset in relation to the base address in A16 address space as defined by the logical address Offset Access Description ID Register Logical Address Register DevType RO Device Type Register Status Status Register Control WO Control Register Not Used MODID RW MODID Register Not Used 5 2 Register Description 5 2 1 ID Register Bt 15 14 13 12 1 wo 9 8 7 6 5 2 3 2 fa 90 SR lc 01 12 BERSSENEN Initial 1 1 1 1 1 1 1 d 1 1 Device Address Class Space Contents ManufacturerlD Device Class This field indicates the module as a Register Based VXlbus device Address Space This field determines the addressing mode of the device s operational registers This board is A16 only Manufacturer ID The manufacturer ID is OXE70 3696 and has been assigned b the VXlbus Consortium This number uniquely identifies the manufacturer of the device as Bustec Production Ltd 5 2 2 Logical Address Register Et 15 1314 nu jS 0 9 8 7 6 5 4 3 2 2 2 Pints x X keete 8 oo 0 Le e Eo E EEEE Not Used LogAddi 7 0 This register is used to assign a logical address to the module If a static logical address is assigned to the module by using the VISA configuration utility it is initialized to this s
6. 3020 INTERFACE 45 4 1 Connecting to a Device s ematnnas hihi 45 4 2 Reading and Writing Messages to from a GPIB Device 46 5 VXIBUS CONFIGURATION REGISTER DETAILS cessere 47 Bal Address MS uio oL I LAN MM Mia pisi 47 5 2 Register Description sso breed cepe reed nn duse cedo ded dapes dmt 47 52 1 AD Register han oo tn 47 5 2 2 Logical Address EE 47 5 2 d e EE e 48 5 24 DIQUS HegISIel iud ER MR ERR AERE adds 48 5 2 5 Control Registef EL 49 Copyright 2003 Bustec Production Ltd Page 3 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual 9 2 0 MODID RegisSt ln nn RA ARA A RA A 49 6 FRONT PANEL CONNECTORS AND SWITCHES esee nennen nnnnnan 51 6 1 ProDAQ 3020 AA Front Panel Connectors and Switches 51 BAT USB E0020 e 51 6 1 2 Clk In Out COnnectors EE 51 6 1 3 Trigger Een 51 Gol Heser SWIICD E 51 6 2 ProDAQ 3020 AB Front Panel Connectors and Switches 52 6 2 1 GPIB Port Connectof EE 52 6 3 ProDAQ 3020 BA Front Panel Connectors and Switches 53 6 3 1 THOger Chain In Out ee 53 6 4 ProDAQ 3020 BB Front Panel Connectors and Switches 54 Gil wel LEE 55 6 5 Interface e E ee 55 fe MEET EE AS AURAS ne A ARR OR OS A te tines 55 Gels Front CB EE 56 6 8 Power Supply LOGG
7. Input Level TTL active low Input Protection OV to 5V Connector Type 9 pin micro D female Trigger Daisy chain Out Input Level TTL active low Maximum Current 32 mA lon 64 mA lot Connector Type 9 pin micro D female GPIB Port Interface Level IEEE488 2 Connector Type 24 pin standard IEEE488 6 8 Power Supply Loading Current Consumption 5 V 0 9 A typ 1 4 A max 5 2 V 0 3 A max 2 V 0 3 A max Total Power Consumption lt 9 2 W Copyright 2003 Bustec Production Ltd Page 57 of 60 3020 XX UM 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual 6 9 Miscellaneous Operating Temperature 0 to 50 C Storage Temperature 40 to 702 C Humidity 0 90 non condensing Cooling 1 l s 0 25mm H20 Weight 950 g Page 58 of 60 Copyright 2003 Bustec Production Ltd Bustec Production Ltd World Aviation Park Shannon Co Clare Ireland Tel 353 0 61 707100 FAX 353 0 61 707106 Bustec Inc 17820 Englewood Dr 14 Middleburg Hts OH 44130 U S A Tel 1 440 826 4156 Fax 1 440 826 4184 bustec
8. P Search lor a salable diver for my device recommended C Display bet ol the known divers loc the device 0 that can che a speolic driver tees Figure 7 Using the Hardware Wizard and select Next If you are installing using the supplied CD ROM choose CD ROM drives as optional search location Found New Hardware Wizard Lacate Drives Files aw where do you werk Windows to search for diver fies Search lor daver files for the fallowang baue device a PioDAQ 3020 USB2 0 VXIbus Skt Irtetiace The wizard searches for sutable devers in ts driver database on your computer and in ary of the folowing optional sesech locations that you specify To sait the teach click Neo If pou ate searching on floppy dtk or CD ROM dive insert the loppy disk of CD before clicking Next Optional search locations Specity a location Figure 8 Select a Search Location Copyright 2003 Bustec Production Ltd Page 15 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual If you have downloaded the VISA library from our WEB site choose Specify a location and specify the location of the directory containing the unpacked installation in the next step Continue through the installation process as directed by the New Hardware Wizard It will show you the location of the driver files found and allow you to select Finish to complete the installation After the driver is installed the
9. ProDAQ 3020 USB 2 0 VXIbus Slot 0 interface will be shown in the device manager under Bustec VXI Devices once it is connected and switched on EE oni Action View le o am VXI Bustec VXI Dev ices Az EBu3020 Slot 0 Controller Computer C3 Disk drives E Display adapters KREE da DVD CD ROM drives amp 3 Floppy disk controllers amp Floppy disk drives IDE ATASATAPI controllers gi Keyboards A Mice and other pointing devices Monitors Bi Network adapters z WE WE WEG Figure 9 Typical Device Manager Display Attention The VISA configuration utility must be run whenever a new ProDAQ 3020 Interface is connected to the host PC Page 16 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 2 5 Configuring the ProDAQ 3020 for the VISA Library The VISA library uses interface names and numbers to access available hardware interfaces In order to enable the VISA library to use a ProDAQ 3020 interface which is connected to a host PC for the first time a valid interface name and number must be assigned to this device The assigned interface name and number will be stored internally in the configuration for this ProDAQ 3020 interface together with its serial number and will be used for this device whenever it is connected to this host To assign an interfa
10. Refresh List button can be used to update the list of configured interfaces Page 18 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 2 6 Configuring the ProDAQ 3020 Interface Characteristics The ProDAQ 3020 USB 2 0 VXIbus Slot 0 interface has a number of characteristics that can be configured with the configuration utility The settings are stored together with the device name number and the serial number on the host system and applied whenever the device is connected to the host system and the resource manager is executed To configure the ProDAQ 3020 select the device you want to configure in the list and select Configure Interface The four tab panels of the configuration dialog allow to configure the different parts of the interface VXIbus Configures various parameters used by the ProDAQ 3020 when accessing the VXIbus Interrupt Configures the assignment and use of the VXIbus interrupt lines Front Panel I O Configures the routing of VXIbus clock and trigger lines to from the front panel connectors Version Allows checking and updating the firmware version of the attached ProDAQ 3020 ProDAQ 3020 P ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface bustec Vxlbus Front Panel 1 0 Interrupt Version Vlbus Timer VXIbus Requester Bus Timeout 1024 us 7 Request Mode Fair gt Request Level 3 sl
11. Setup you prefer then click Next Program will be installed with the most common options Recommended for most users C Compact Program will be installed with minimum required options C Custom You may choose the options you want to install Recommended for advanced user lt Back Cancel Figure 1 Selecting the Type of Installation 7 Ifyou have chosen Custom selecting Next will allow you to select the components to install see Figure 2 VISA Library The core files hardware driver VISA dynamic link library config utility include files of the installation VISA Assistant An interactive graphical user interface for the VISA library It will allow you to use the VISA library without writing your own application Help Files Help files for the VISA library Examples How to program using the VISA library Setup E Select Components Choose the components Setup will install Select the components you want to install and clear the components you do not want to install r Description vj VISA Assistant Bustec VISA Library Files Help Files vj Examples Space Required on C 5288 K Space Available on C 19450800 K InstallShield lt Back Cancel Figure 2 Selecting Components for Installation 8 After selecting Next the wizard will install the files and components for the chosen configuration on your system 9 Re start the computer after the installation is com
12. Shared Memory Operations VXI Specific Operations Not all operations are available for all types of devices so depending on the device type the treeview control might not list all the possibilities discussed here 2 7 2 1 Template Operations The VISA standard implements a template of standard services for a resource The functions in this group provide access to those services The services available include attribute operations asynchronous operation control resource access control and event operations As an example the function viGetAttribute allows to retrieve the values for attributes defined for a resource Selecting the function in the treeview control on the left hand side click on Template Operations then on viGetAttribute allows you to control the parameters for the function in a dialog on the right hand side of the session window VXI0 2 INSTR e Session Information Retrieve the state of an attribute emplate Operations r Input Attribute VI ATTR MANF ID iDiscardE vents Output bw air vent Eo E Basic 1 0 Operations GE x E70 H Memory 1 0 Operations ER Shared Memory Operations Mal Specific Operations Retumed Status ele Operation completed successfully Figure 23 Using a template operation Select one of the attributes to retrieve in the Attribute control in the Input section and press Run The Output section will show the cu
13. Ve lt Ibus Arbiter Arbitration Mode Priority z Release Mode ROR SZ Reset to Default Figure 13 The ProDAQ 3020 Configuration Dialog 66 To store the altered configuration select OK Cancel closes the dialog without altering the stored configuration NOTE To apply changes to the configuration of the 3020 you will need to re run the resource manager or to restart your VXI mainframe to make these changes effective Copyright 2003 Bustec Production Ltd Page 19 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual If the distribution of the Bustec VISA library contains a new firmware version for the ProDAQ 3020 Interface you will see the following after selecting Configure Interface ProDAQ Configuration L Ani Configured Interfaces VISA Name Interface Description g Add Interfaces ProDA 3020 Ger Mo 30201018 ProD4Q 3251 Remove Interface ProDAQ 3020 Ger Mo 30201018 Configure Interface lt ProDAQ Configuration Utility x Newer version of ProDAQ 3020 firmware is available 1 Please run firmware update procedure Figure 14 New firmware available message Please see 2 6 4 Firmware Version Checking and Update for a description how to update the ProDAQ 3020 firmware 2 6 1 Configuring the VXIbus Access To configure the VXlbus access of the ProDAQ 3020 interface selected select the tab VX
14. and trigger clock connectors For all connector descriptions see chapters 6 1 6 2 and 6 3 De e bustec ProDAQ 3020 SYS VXI FAIL Act O cikin Se Cik out O Trigin Trig Out Trig Chain Page 54 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual Specifications 6 5 Interface Characteristics Interface Type USB 1 1 and USB 2 0 Compliant Operating Systems Windows NT Windows 2000 Windows XP Languages C C Visual Basic LabVIEW LabWindows CVI HP Agilent Vee Controllers PC compatible 6 6 VXlbus Characteristics General Device Type Register Based Size C Slots 1 Connectors P1 P2 Slot 0 Functionality Yes auto detected Resource Manager Functionality Yes VXIbus Master Address Space A16 A24 and A32 Data Transfer Capabilities D08 D16 D32 D16BLT D32BLT D64MBLT BLT MBLT Address Increment Software Selectable Bus Timer 16 32 64 128 256 512 and 1024 us VXIbus Slave Address Space A16 Size 64 Bytes Base Address 0xC000 Logical Address 0x40 Data Transfer Capabilities D08 D16 and D32 Copyright 2003 Bustec Production Ltd Page 55 of 60 3020 XX UM 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual VXIbus Requester Request Level B
15. on the VXIbus include visa h buffer used to store data from the instrument ViUInt16 data 1024 main int argc char argv ViStatus status ViSession rm session ViSession instr session ViChar descr 256 ViUIntl6 value open a session to the resource manager and instrument as shown in Figure 28 Opening a VISA Session not shown here now move a block of 16 bit data from the instrument to the buffer if status viMoveInl6 instr session VI A32 SPACE MEM START 1024 data VI SUCCESS viStatusDesc instr session status descr if status VI SUCCESS printf VISA WARNING viMoveIn16 returned status 08x s n status descr else printf VISA ERROR viMoveIn16 returned status 08x s n status descr return status close the sessions as shown in Figure 28 Opening a VISA Session Figure 31 Moving a Block of Data Copyright 2003 Bustec Production Ltd Page 37 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual For each move one or several packets of data are moved over the VXIbus to the ProDAQ 3020 and via the USB bus between the ProDAQ 3020 and the host computer The transfer between the ProDAQ 3020 and the host computer is always done in blocks The size and the speed with which the blocks are transferred via the USB bus depends on the type of USB port used USB 1 1 allows for a maximum block size of 64 Bytes at 1
16. two settings for the assignment can be chosen see Figure 15 Auto This setting will allow the resource manager to use the interrupt line for this level in his allocation mechanism None This setting will prevent the resource manage to use the interrupt line for this level in his allocation mechanism This setting must be used if a instrument in the system does not allow the dynamic allocation of interrupt lines and wants to use one or more lines permanently allocated ProDAQ 3020 ES D NUE PU 5S LOT An Slot 0 eem i bustec Interface plug amp play Vxlbus Front Panel 1 0 fir upt Version Interrupt Assignment Level 1 auo zl Level 2 auo z Level 3 auto zl Level 4 auto zl Level 5 auto gt Level 6 auto Level auo Reset to Default Figure 15 Configuring the Interrupt Lines 2 6 3 Configuring the Front Panel UO The ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface supports the synchronization of multi mainframe systems via shared system clocks CLK10 and trigger lines To configure the front panel input and output signals select the Front Panel I O tab on the right hand side of the configuration utility window see Figure 16 If the ProDAQ 3020 is located in the left most slot slot O of a VXlbus mainframe it can be configured to either receive a CLK10 signal via the Clk In connector or to generate a CLK10 signal internally an
17. with the front Copyright 2003 Bustec Production Ltd Page 43 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual panel input multiple lines can be mapped to the front panel output When calling viMapTrigger multiple times with the same destination line and different source lines the destination line will be asserted when any of the source lines is asserted To select the active level of the front panel output see 2 6 3 Configuring the Front Panel I O include lt visa h gt main int argc char argv ViStatus status ViSession rm session ViSession instr session ViChar descr 256 open session to the resource manager if status viOpenDefaultRM amp rm session VI SUCCESS error handling as shown in the previous examples open a session to the instrument status viOpen rm session VXIO0 0 BACKPLANE VI NULL VI NULL amp instr session VI SUCCESS error handling as shown in the previous examples mapping the front panel input to trigger line TTL1 status viMapTrigger instr session VI TRIG PANEL IN VI TRIG TTL1 VI NULL VI SUCCESS error handling as shown in the previous examples mapping the front panel input also to trigger line ECLO status viMapTrigger instr session VI TRIG PANEL IN VI TRIG ECLO VI NULL VI SUCCESS error handling as shown in the previous examples mapp
18. 0 for the VISA Library The logical address will be zero 0 as you will need to configure the ProDAQ 3020 for logical address zero to allow it to function as a VXlbus slot 0 controller Though the ProDAQ 3020 does not support the mapping of one VXIbus trigger line to another the standard VISA functions viMapTrigger and viUnmapTrigger can be used to map the front panel trigger input to one or many of the VXIbus trigger lines as well as to map one or many VXIbus trigger lines to the front panel trigger output Figure 36 shows an example how to map the trigger lines to from the front panel input and output First a session for the backplane resource is opened Then the function viMapTrigger is used to map the front panel input to the VXIbus trigger line TTL1 and also to the VXIbus trigger lines ECLO This means that whenever an active trigger is detected on the front panel input of the ProDAQ 3020 both lines will be asserted In general when the viMapTrigger function is called multiple times with the same source trigger line and different destination trigger lines an assertion of the source line will cause all of those destination lines to be asserted To select how the ProDAQ 3020 will detect am active trigger on the front panel input see 2 6 3 Configuring the Front Panel I O To map one or multiple of the VXIbus trigger lines to the front panel output the value VI TRIG PANEL OUT must be used for the destination parameter As
19. 2 Mb s while USB 2 0 allows for maximum block size of 512 Bytes at 480 Mb s The type of transfer used on the VXlbus depends on the value of several attributes VI ATTR SRC PRIV for data moved from a VXIbus instrument to the host VI ATTR DEST PRIV for data moved from the host to a VXIbus instrument Only if the value of those attributes are set correctly prior to moving the data via viMoveln or viMoveOut a block transfer on the VXIbus will take place The following table shows the type of transfers performed by the viMoveln viMoveOut and viMove functions for the different values of the attributes Settings Resulting Transfer Attribute Address Space Privilege Data Program Block Transfer AM hex VI DATA PRIV VI A16 SPACE Supervisory 2D VI_A24 SPACE Supervisory Data 3D V A32 SPACE Supervisory Data oD VI DATA NPRIV VI A16 SPACE Non priv 29 VI A24 SPACE Non priv Data 39 VI A32 SPACE Non priv Data 09 VI PROG PRIV VI A16 SPACE Supervisory 2D VI_A24 SPACE Supervisory Program 3E VI_A32_ SPACE Supervisory Program E OE VI PROG NPRIV VI A16 SPACE Non priv 29 VU A24 SPACE Non priv Program 3A V A32 SPACE Non priv Program 0A VI BLCK PRIV VI A16 SPACE Supervisory 2D VI_A24 SPACE Supervisory BLT 3F V A32 SPACE Supervisory BLT OF VI BLCK NPRIV VI A16 SPACE Non priv 29 VI A24 SPACE Non pr
20. A Assistant from the VXIplug amp play program group in the start menu Start gt VXIPNP VISA Assistant The main window of the Visa Assistant shows a list of all VISA resources in the system wi Bustec VISA Assistant x VISA Assistant SSA bustec plug amp play Detected resources Mal Resource Information LVXIO O INSTR MIO 1 1NSTR Manufacturer ID d Oxe70 3595 10 256 INSTR VXID D BACKPLANE Model code MVXID 1 BACKPLANE Oxe30 3120 VXID MEMACC i VXID SERVANT GPIB VXI lt ASRLI INSTR 1 ASRL2 INSTR Figure 21 The VISA Assistant On selecting one by double clicking on its entry the VISA Assistant opens a VISA session for that device in a separate window VXI0 2 INSTR Dr ER Template Operations Sessionidentifier Basic 1 0 Operations Memory 1 0 Operations ge Shared Memory perations EES EN 2 VX Specific Operations 0x49c150 No lock held Event handler Not installed Enabled events Figure 22 VISA Assistant Session Window In the treeview control on the left hand side you have now access to information about the session and the VISA functions possible for the resource Copyright 2003 Bustec Production Ltd Page 27 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual The functions available are divided into five groups Template Operations Basic I O Operations Memory I O Operations
21. AQ 3020 Interface This chapter shows how to use the ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface and the Bustec VISA library to program VXI instruments 3 1 Connecting to a Device An application using the VISA library to communicate with the instrument needs to open a session for the resource it wants to use A resource might be a physical resource as for example a VXI instrument or a virtual resource like the backplane or the resource manager The session will handle all accesses attributes and services for the particular resource The following example shows all necessary steps to connect to a device using VISA functions include lt visa h gt main int argc char argv ViStatus status ViSession rm session ViSession instr session ViChar descr 256 open session to the resource manager if status viOpenDefaultRM amp rm session VI SUCCESS viStatusDesc rm session status descr if status gt VI SUCCESS printf VISA WARNING viOpenDefaultRM returned status 08x s n status descr else printf VISA ERROR viOpenDefaultRM returned status 08x s n status descr return status open a session to the instrument if status viOpen rm session VXIO 2 1INSTR VI NULL VI NULL amp instr session VI SUCCESS viStatusDesc instr session status descr if status gt VI SUCCESS printf VISA WARNING viOpen returned status 08x s n s
22. AQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM You can connect the ProDAQ 3020 directly to your host controller If you want to use multiple 3020 or other USB devices in your system you can use multiple free host ports or if necessary a USB hub DIRECT CONNECTION DIRECT CONNECTION USING MULTIPLE HOST PORTS CONNECTING MULTIPLE INTERFACES USING A USB HUB Figure 5 USB Configurations The USB physical interconnect is a tiered star topology with a hub at the center of each star Therefore new devices can be added either on the same tier as long as ports are available or one of the ports can be used to connect to a new hub providing the center for a new tier The USB standard allows for up to seven tiers per system Copyright 2003 Bustec Production Ltd Page 13 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual The center of the first tier is always the controller hub in the computer This means that up to five levels of USB hubs can be added The last tier tier seven does only allow functions devices in it Host Tier 1 Tier 6
23. ING sise ennemies learn nement 57 E EN TEE ee EE 58 Page 4 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM Table of Figures Figure 1 Selecting the Type of Installation 11 Figure 2 Selecting Components for Installation 11 Figure 3 Installing the ProDAQ 3020 into a C Size Mainframe seseesseeeeeeeeeeeerrerenn 12 Figure 4 A to B Type USB GOable e Dees 12 Figure 5 USB Configurations eee 13 Figure 6 USB BUS Topology its hte taste eh etd bcn Rent et a tet 14 Figure 7 Using the Hardware Wizard 15 Figure 8 Select a Search LOCO iced ct Rd en ica sinon 15 Figure 9 Typical Device Manager Display EEN 16 Figure 10 VISA Library Configuration Utility sese 17 Figure 11 Adding an EE 18 Figure 12 Displaying configured Interfaces n 18 Figure 13 The ProDAQ 3020 Configuration Dialog 19 Figure 14 New firmware available message 20 Figure 15 Configuring the Interrupt Lines EE 21 Figure 16 Configuring the Front Panel 1 0 22 Figure 17 Firmware Version and Update ssseeeeesenennnneeesserrnrnnnrnnserrrnrnnnnnneeeernnnnn nn 23 Figure 18 Firmware Update Progress 24 Figure 19 Running the VXI Resource Manager cccceeeceeeecceceeeeeeeeeeeeeeeeeeeeeeeeeeeeees 25 Figure 20 Resource Manager Configuration 26 Figure 21 The VISA Assistant ennn 27 Figure 22 VISA Assi
24. Ibus in the configuration dialog window see Figure 13 The configurable parameters are Bus Time out Arbitration Mode Request Mode Request Level The time the on board times needs to expire once a VXlbus access by the 3020 is started If it expires a VXIbus slave did not respond correctly and a bus error is generated Possible values are Disabled 16 usec 32 usec 64 usec 128 usec 256 usec 512 usec and 1024 usec Selects the bus arbiter mode Possible values are Priority Single Level Arbitration or Round Robin Remark The arbiter is only enabled if the module is placed in the leftmost slot of a VXI mainframe slot O Sets the request mode of the ProDAQ 3020 Fair or Demand Selects the request level the module is using when accessing the VXlbus Possible values are 3 to 0 with 3 as the highest priority and 0 as the lowest Page 20 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM Release Mode Selects the release mode RWD release when done or ROR release on request 2 6 2 Configuring the Interrupt Lines The configuration tool allows configuring the usage of the VXIbus interrupt lines in the allocation mechanism of the VXI resource manager To configure the lines select the tab Interrupt in the configuration dialog window For each of the VXIbus interrupt lines Level 1 to Level 7 one of
25. ON AND CONFIGURATION cccccssseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeneseeeeeeees 9 2 1 Unpacking and Inspection EE 9 2 2 Installing the VISA Library ss 10 2 9 Installing the ProDAQ 3020 Interface o ct iR ts ori EE Eu LU i de 12 2 4 Installing the ProDAQ 3020 USB Driver 0 ce eeeeeeeeee eect eee e ee eeeeeeeeeeeeeeeeeteeee 15 2 5 Configuring the ProDAQ 3020 for the VISA Library 17 2 6 Configuring the ProDAQ 3020 Interface Characteristics ssssss 19 2 6 1 Configuring the ee 20 2 6 2 Configuring the Interrupt Lines 21 2 6 8 Configuring the Front Panel 1 0 21 2 6 4 Firmware Version Checking and Update 23 2 7 Nentying the Installation EE 25 2 7 1 Running the VXIbUS Resource Manager 25 272 I8 VISAASSIBIBBE eier a es Te nine 27 3 PROGRAMMING VXI DEVICES USING THE PRODAQ 3020 INTERFACE 33 3 1 Connecting DEVICE ee 33 3 2 Programming Register based Devices ccccceeeeeeeeeeeeeeeeeeeeeeeeeeneeeeeeeeeeeeteee 34 22e ACCESSING Ee EE 34 3 2 2 Moving Blocks of Data EE 37 3 3 Programming Message based Devices 40 3 9 1 Writing and Heading Messages iscsi hee isi ack eee 40 3 4 Optimising Programs using the ProDAQ 3020 Interface ssusss 41 3 5 Using VXlbus and Front Panel Trigger Lines 42 3 5 1 Using VXIbus Trigger Biet 42 35 2 Using Front Panel Tigger Lines ermsni tego fro Roa ROCHE ROCHE UY 43 4 PROGRAMMING GPIB DEVICES USING THE PRODAQ
26. RO to BR3 Request Mode Fair or On Demand Release Mode ROR RWD VXIbus Arbiter Arbitration Mode SGL PRI RRS Arbitration Time out 10 us VXIbus Interrupts Interrupt Handler IRQ1 to IRQ7 Interrupter IRQ1 to IRQ7 Interrupter Release Mode ROAK 6 7 Front Panel UO CLK10 In Input Level TTL Input Protection 5V to 10V Connector Type SMB Note When using an external clock to supply the CLK10 signal you must use a VXIbus standard compliant clock signal 10 MHz equal or better than 100 ppm 50 5 duty cycle CLK10 Out Output Level TTL Output Frequency 10 MHz Frequency Stability 100 ppm Duty Cycle 50 5 Connector Type SMB Specification valid for internal clock generator only Page 56 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual Trigger In Input Level TTL Active Edge Software selectable Trigger Detection Routable to VXIbus trigger lines TTLO to TTL7 ECLO 1 Interrupt on trigger detection Input Protection 5V to 10V Connector Type SMB Trigger Out Output Level TTL Active Level Software selectable Trigger Generation From VXIbus trigger lines TTLO to TTL7 ECLO 1 By software command Maximum Current 32 mA lon 64 mA lot Connector Type SMB Trigger Daisy chain In
27. The actual mapping of the Trig In signal to one or many of the VXIbus trigger lines and the mapping of the VXIbus trigger line or lines to the Trig Out signal is done using VISA functions see 3 5 2 Using Front Panel Trigger Lines The ProDAQ 3020 version AB features two additional connectors on the front panel see 6 3 1 Trigger Chain In Out Connectors They allow to daisy chain the VXIbus TTL trigger signals from one mainframe in a multi mainframe system to another The eight controls VXI TTL 0 to VXI TTL 7 allow to selectively enable the VXIbus TTL trigger lines to be received via the front panel Trig Daisy Chain In connector and forwarded by the front panel Trig Daisy Chain Out connector 2 6 4 Firmware Version Checking and Update Selecting the Version tab shows the firmware version of the firmware installed on the ProDAQ 3020 interface as well as the one available with the current distribution of the VISA library and tools ProDAQ 3020 D 200 OR PU USB 2 0 VXlbus Slot 0 P a bustec Interface plug amp play Vxlbus Front Panel 140 Interrupt y r Current Version Firmware Revision No 13 17 06 Available Version Firmware Revision No 13 17 06 Update Firmware T Figure 17 Firmware Version and Update To update the firmware installed on the ProDAQ 3020 selected press the Update Firmware button in the lower right half of the dialog The up
28. USER MANUAL ProDAQ VXI Data Acquisition Systems ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface PUBLICATION NUMBER 3020 XX UM 0201 bustec Copyright 2014 Bustec Production Ltd Bustec Production Ltd Bustec House Shannon Business Park Shannon Co Clare Ireland Tel 353 0 61 707100 FAX 353 0 61 707106 PROPRIETARY NOTICE This document and the technical data herein disclosed are proprietary to Bustec Production Ltd and shall not without express written permission of Bustec Production Ltd be used in whole or in part to solicit quotations from a competitive source or used for manufacture by anyone other than Bustec Production Ltd The information herein has been developed at private expense and may only be used for operation and maintenance reference purposes or for purposes of engineering evaluation and incorporation into technical specifications and other documents which specify procurement of products from Bustec Production Ltd This document is subject to change without further notification Bustec Production Ltd Reserve the right to change both the hardware and software described herein ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM Table of Contents 1 INTRODUCTION WE 7 1 1 Requirements Sat A nn An nn en ne ee debian ede te 7 1 1 1 The ProDAQ 3020 USB 2 0 VXIbus Slot 0 Jntertace 7 LT2 THE OST gel 7 1 1 3 The VXI NANTAIS ee oe 8 NE TRON SEs CAG NIMMT ai loue 8 2 INSTALLATI
29. User Manual 3020 XX UM 6 3 ProDAQ 3020 BA Front Panel Connectors and Switches In addition to the connectors available on the ProDAQ 3020 AA the ProDAQ 3020 AB features two additional micro D style connectors for trigger daisy chaining between mainframes De e bustec ProDAQ 3020 SYS VXI FAIL Act O cikin O Cik Out Trig In Trig Out Trig Chain RESET 6 3 1 Trigger Chain In Out Connectors The trigger chain connectors on the front panel of the 3020 AB can be used to connect the trigger lines of multiple VXIbus mainframes directly A standard 9 pin micro D Connector is used with the following pin out Pin Signal Description 1 TTLO VXlbus TTL Trigger Line 0 2 TTL1 VXlbus TTL Trigger Line 1 3 GND Ground 4 TTL2 VXIbus TTL Trigger Line 2 5 TTL3 VXIbus TTL Trigger Line 3 6 TTL4 VXlbus TTL Trigger Line 4 7 TTL5 VXlbus TTL Trigger Line 5 8 TTL6 VXIbus TTL Trigger Line 6 9 TTL7 VXIbus TTL Trigger Line 7 Shell GND Shield Ground ONGO O0O0O EA EE 0 NUO RO Trigger Chain In Out Female Figure 40 Trigger Chain Connectors Pin out Copyright 2003 Bustec Production Ltd Page 53 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual 6 4 ProDAQ 3020 BB Front Panel Connectors and Switches The ProDAQ 3020 BB features both the trigger chaining micro D connectors and the GPIB port connector in addition to the USB
30. a VXIbus instrument to the host 7 BRK KK KKK KK KK KA RA A A A A RRR A A k k k AR k k k KK set the correct attribute VI ATTR SRC PRIV for moving data IN if status viSetAttribute instr session VI ATTR SRC PRIV VI BLK PRIV VI SUCCESS handle errors or warnings not shown here j now move a block of 16 bit data from the instrument to the buffer if status viMoveInl6 instr session VI A32 SPACE MEM START 1024 data VI SUCCESS handle errors or warnings not shown here IA Perform a 32 bit wide block transfer from the host to a VXIbus instrument A L t set the correct attribute VI ATTR DEST PRIV for moving data OUT if status viSetAttribute instr session VI ATTR DEST PRIV VI BLK PRIV VI SUCCESS handle errors or warnings not shown here now move a block of 32 bit data from the instrument to the buffer if status viMoveOut32 instr session VI A32 SPACE MEM START 1024 data VI SUCCESS handle errors or warnings not shown here J FCKCKCKCKCK EE HRK HR HRK HRK HRK HRK HRK KR HRK KR RH ko kk koe ke EE d Perform a 64 bit wide block transfer from the host to a VXIbus instrument 7 BRK KK KK RK KKK KR AA A A ARR A k k AA k k k k k k k k kk kk k set the correct attribute VI ATTR DEST PRIV for moving data OUT if status viSetAttribute instr session VI ATTR DEST PRIV VI D64 PRIV VI SUCCESS
31. attribute VI ATTR WIN ACCESS is checked to see whether the controller was able to map the address range physically into the memory space of the controller or whether the mapping was done only logically If the mapping was done physically the application is allowed to use the address the register range is mapped to as if it is accessing its own memory So for example C style pointers may be used to change the register value G If the mapping was done only logically the application need to use the functions viPeek and viPoke provided by the VISA library to access the mapped register range 9 The VISA library will use the stored values for the mapped offset and range to calculate the physical address and execute a single access in the same way as internally done for the high level functions The function viUnmapAddress must be used to undo the mapping of the register range G Only one mapping per session is allowed by the VISA standard Please not that the functions viPeek and viPoke will work in both cases VI ATTR WIN ACCESS equal to VI DEREF ADDR or equal to VI USE OPERS but will introduce a slightly higher overhead then using direct access if possible 3 2 2 Moving Blocks of Data To move blocks of data between an instruments memory and the host memory the VISA library implements the functions viMoveln and viMoveOut for different transfer sizes In addition a number of attributes can be used to define the type of transfer performed
32. brary by installing VXlp ug amp play drivers and running the instruments soft front panels or by running your application 2 7 4 Running the VXIbus Resource Manager Before you can use the VISA library to communicate to the instruments you must run the resource manager The resource manager searches for VXI and GPIB instruments connected to your PC and configure them To run the resource manager select VXIbus Resource Manager from the VXIplug amp play program group in the start menu Start gt VXIPNP VXI Resource Manager sa VXIbus Resource Manager BE ini x Waiting 4 seconds for SYSFAIL to be deasserted ni 3x Close Details gt gt Figure 19 Running the VXI Resource Manager After start the resource manager will wait a defined time to allow all devices to complete their initialization and self test if available Then he performs the following functions Identify all VXIbus and GPIB devices in the system Manage the system self test and diagnostic sequence Configure the system s A24 and A32 address maps Configure the system s Commander Servant hierarchies Allocate the VXIbus IRQ lines Initiate normal system operation Se Once finished the information about the VXlbus and GPIB devices found is made available for the VISA library and a readable version of this information is saved to a file Both the initial delay and the location of the resource manager output file are configurable using
33. c will be automatically turned off Note The ProDAQ 3020 USB 2 0 VXlbus Slot 0 Interface does not extend the VXI backplane between mainframes in a multi mainframe system This means that devices sharing the local bus must be installed in the same mainframe To install the ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface and the necessary software on your system use the installation sequence as described in this chapter Step 1 Unpacking and Inspection Step 2 Installing the VISA Library Step 3 Installing the ProDAQ 3020 Interface Step 4 Installing the ProDAQ 3020 USB Driver 2 1 Unpacking and Inspection All ProDAQ modules are shipped in an antistatic package to prevent any damage from electrostatic discharge ESD Proper ESD handling procedures must always be used when packing unpacking or installing any ProDAQ module ProDAQ plug in module or ProDAQ function card Ground yourself via a grounding strap or similar e g by holding to a grounded object Remove the ProDAQ module from its carton preserving the factory packaging as much as possible Discharge the package by touching it to a grounded object e g a metal part of your VXIbus chassis before removing the module from the package Inspect the ProDAQ module for any defect or damage Immediately notify the carrier if any damage is apparent Only remove the module from its antistatic bag if you intend to install it into a VXI mainframe or similar When reshippi
34. ce name number and configure the ProDAQ 3020 connect the USB interface cable between one USB port of the host PC and the USB port on the ProDAQ 3020 front panel and turn on the VXI mainframe From the VXlplug amp play program group created during the installation of the VISA library select VISA Configuration Utility Start gt VXIPNP gt VISA Configuration Utility This will start the configuration tool for the VISA library and attached hardware interfaces ProDAQ Configuration Utility I ell xl Add Interfaces Remove Interface MANS Configured Interfaces VISA Name Interface Description Configure Interface Refresh List Resource Manager h Figure 10 VISA Library Configuration Utility To add a new interface select Add Interfaces A new dialog Available Interfaces is shown with a list of unconfigured devices found in the system ProDAQ 3020 interfaces appear as interfaces of the type VXI together with a description containing the serial number of the device see Figure 11 ProDAQ 3020 Ser No 3201003 If the 3020 detected features the optional on board GPIB interface ProDAQ 3020 AB and ProDAQ 3020 BB only the GPIB interface will appear in the list of available interfaces as a separate interface of the type GPIB again with a description containing the serial number of the device see Figure 11 ProDAQ 3020 Ser No 30201018 Copyright 2003 Bustec Prod
35. compatible host controller either already build in into the motherboard or via expansion cards The drivers and software provided are for Pentium based PC compatible computers Note The host controller need to be already installed into and recognized by your system Bustec Production Inc does not provide drivers for any USB component other then the ProDAQ 3020 Interface itself Please contact the manufacturer of your motherboard or expansion card for suitable USB drivers for your operating system Copyright 2003 Bustec Production Ltd Page 7 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual Note USB 1 0 compatible host controllers are not supported USB 1 1 compatible host controllers are limited to a maximum bus speed of 12 Mb s To achieve full performance with the ProDAQ 3020 Interface a USB 2 0 host controller is required 1 1 3 The VXI Mainframe The ProDAQ 3020 USB 2 0 VXlbus Slot 0 Interface is a single slot wide C size VXI module which can reside in any slot of a C size or D size VXI mainframe It will automatically detect whether it is located in the left most slot of the mainframe slot O and will enable or disable its Slot 0 capabilities accordingly avoiding conflicts with the backplane and other modules Note Being a C size module the ProDAQ 3020 does not provide a P3 connector as used in D size mainframes If used as a slot 0 controller in a D size mainframe it cannot provide
36. d share it with other mainframes via the Clk Out connector on the front panel The CLK10 Source control allows you to configure this Copyright 2003 Bustec Production Ltd Page 21 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual Internal The ProDAQ 3020 uses the internal clock generator to generate the CLK10 clock signal for the VXIbus and additionally makes the clock signal available via the front panel Clk Out connector External The internal clock generator is disabled and the ProDAQ 3020 uses the clock signal from the Clk In connector to generate the VXlbus CLK10 clock signal If the module is located in any other slot in a VXlbus system the CLK10 signal supplied by the VXIbus is used xi ProDAQ 30200 DS PN Ce en 2 Y bustec Interface plug amp play VXibus H Interrupt Version m CLK10 r Trigger Daisy Chain Source internal E VAITTLO T Enable Output To Front Panel vm TF 2 YVRITTIL2 E m Input Trigger V J Active Edge rising gt fe YAITIL4 F r Output Trigger WITTLS E Active Level high si WITTL6 E wmz E Reset to Default ERA Ge Loc Figure 16 Configuring the Front Panel I O The VXlbus trigger lines TTLO to TTL7 and ECLO ECL1 can be mapped to the front panel Trig In and Trig Out connectors see a
37. date process will download and replace the firmware stored in a FLASH memory on the ProDAQ 3020 Interface Please make sure that the process is not interrupted otherwise the ProDAQ 3020 may become unusable and has to be returned to the factory for repair It is recommended to close all other applications before starting the update Copyright 2003 Bustec Production Ltd Page 23 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual During the update a progress bar will show the status of the update process ProDAQ 3020 USB 2 0 VXIbus Slot 0 bustec Interface Loading Firmware Contents Part 1 B BHEEEHH 21 Firmware Revision No 14 17 06 Update Firmware Cancel Figure 18 Firmware Update Progress After finishing the update you need to cold start the ProDAQ 3020 by power cycling the VXlbus mainframe to make the change effective Warning Do not stop the configuration utility or power cycle the VXI mainframe during the firmware update Otherwise the ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface may become unusable Page 24 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 2 7 Verifying the Installation Once you have installed the VISA library and tools the ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface and the ProDAQ 3020 USB driver you can verify the installation by using the tools supplied with the VISA li
38. e designates the CD ROM drive with the driver CD in it 3 Select VISA Library for ProDAQ Controller from the driver section of the CD menu to start the setup wizard Please note If you have downloaded the Bustec VISA Library from our WEB site all files are packed into a single ZIP archive To start the installation unpack the files into a separate directory on your drive and run the executable setup exe from that location 4 Select Next to review the license agreement for the Bustec VISA library You will need to accept the terms of the agreement by selecting Yes to be able to install the Visa library 5 Select the folder where the wizard will install the components of the VISA library Please note that the location chosen will be the top level directory for a VXIplug amp play standard compliant directory tree and not a single location for the library only If you install VXIp ug amp play driver on your PC they will install using the directory tree created by the VISA installation 6 Select Next to choose the type of setup to perform see Figure 1 Typical will install the most common components while Compact will only install the absolute necessary components To choose which components to install choose Custom Page 10 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM Setup Type Select the Setup Type to install Click the type of
39. e mapped can be directly accessed e g by using a C style pointer or the functions viPeek8 viPeek16 viPeek32 viPoke8 viPoke16 and viPoke32 must be used to access registers in the mapped range Figure 30 shows the same function as in Figure 29 this time implemented with memory mapping functions Note The ProDAQ 3020 USB 2 0 VXIbus Slot 0 interface does not support direct memory mapping Any access to the VXIbus is forwarded via packets on the USB bus from the host to the interface executed and the result send back via a second packet from the interface to the host Therefore the functions viPeek8 viPeek16 viPeek32 viPoke8 viPoke16 and viPoke32 must be used when mapping a memory range using viMapAddress Copyright 2003 Bustec Production Ltd Page 35 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual ViStatus function rmw register ViSession instr session ViBusAddress offset ViUIntl6 mod ViStatus status ViChar descr 256 ViAddr address ViUInt16 win access ViUInt16 value Qm if status viMapAddress instr session VI A32 SPACE offset sizeof ViUInt16 VI FALSE ViAddr 0 amp address VI SUCCESS viStatusDesc instr session status descr if status VI SUCCESS printf VISA WARNING viMapAddress returned status 08x s Wn status descr else printf VISA ERROR viMapAddress returned status 08x s n status descr return status status viG
40. e run every time a VXI mainframe is connected or disconnected to from your computer There is also no protocol available to notify applications of the configuration change Running applications must be restarted after re running the resource manager Caution The initial resource manager delay as defined by the VXIbus standard must be in minimum five 5 seconds Configuring the resource manager to use a shorter delay might not allow all devices to finish their initialization and self test preventing the resource manager from identifying and configuring them Note The VISA library is a shared library that initializes itself when it is first loaded by an application Applications started while the VISA library is already loaded just share this configuration Only when all applications using the VISA library are stopped it will be unloaded by the system Therefore all applications using the VISA library must be closed before running the resource manager or using the VISA configuration utility Take special care while using integrated development environments they will keep the VISA library loaded even when the application developed in them was stopped Page 26 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 2 7 2 The VISA Assistant The VISA Assistant is an interactive tool which allows executing VISA commands without programming To run the VISA Assistant select VIS
41. e the functions viMove viMoveln or viMoveOut instead of single read and write commands for devices and register ranges where this is possible Use the attributes VI ATTR SRC PRIV and VI ATTR DEST PRIV to specify block transfer privileges for devices where this is possible Use 32 bit or 64 bit moves whenever possible Align your buffers to 32 bit boundaries Locking this buffer in memory and allocating a contiguous buffer will help to optimize the performance Copyright 2003 Bustec Production Ltd Page 41 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual 3 5 Using VXIbus and Front Panel Trigger Lines One feature that differs the VXlbus from other busses is its ability to use trigger signals to communicate with instruments in real time to share clock signals etc The VISA library implements functions to control those trigger lines from your application 3 5 1 Using VXIbus Trigger Lines The VISA standard implements the function viAssertTrigger together with the attribute VI ATTR TRIG ID to assert and de assert trigger lines on the VXIbus or sending the word serial trigger command to message based devices include lt visa h gt main int argc char argv ViStatus status ViSession rm session ViSession instr session ViChar descr 256 open a session to the resource manager status viOpenDefaultRM amp rm_session VI_SUCCESS error handling as shown in the previous e
42. eps necessary to do so if using the lower level function viWrite and viRead Furthermore the functions implement an extended set of formatting styles specially shaped towards instrument communication In the above example the function viPrintf is used to send two messages to the device first a command to reset the device then a request to send back its identification string Q viPrinf uses the format string together with the other arguments passed to it to build a message string in a local buffer and then it calls viWrite to send this message to the device The example program reads the identification using the function viScanf G ViScanf allocates a local buffer calls the function viRead to receive the message form the device and then it parses the message using the formatting supplied by the format string In the example the format code t together with a size modifier is used telling viScanf to expect a string to be returned in the message and to copy a maximum of 256 characters into the buffer supplied The VISA standard support a wide range of formatted I O services like the viPrintf viScanf functions shown in the example Please refer to the VISA standard document VXlplug amp play Systems Alliance VPP 4 3 The VISA library for a complete list 3 4 Optimising Programs using the ProDAQ 3020 Interface To optimize you programs using the ProDAQ 3020 USB 2 0 VXlbus Slot 0 Interface please keep the following in mind Us
43. er Manual 3020 XX UM depends on the value the attribute VI ATTR TRIG_ID is set to For software triggers the only valid protocol is VI PROT DEFAULT For hardware triggers the protocols VI PROT DEFAULT or VI PROT SYNC will generate a trigger pulse on the specified line while VI PROT ON and VI PROT OFF let you explicitly assert and de assert the trigger line 3 5 2 Using Front Panel Trigger Lines The ProDAQ 3020 supports a front panel trigger input and output which can be mapped to the VXIbus trigger lines For this purpose as for querying and manipulating other VXlbus backplane specific lines the VISA standard implements a special resource It encapsulates the VXI defined operations and properties of the backplane in a VXIbus system It lets a controller query and manipulate specific lines on a specific mainframe in a given VXI system Services are provided to map unmap assert and receive hardware triggers and also to assert various utility and interrupt signals The resource descriptor used for the backplane resource is again a combination of interface type and number logical address of the VXI device and the device type BACKPLANE VXI 0 0 BACKPLANE Interface Type A Device Type Interface Number Logical Address As before the interface type when using the ProDAQ 3020 Interface is always VXI The interface number depends on the assignment you made using the configuration utility see 2 5 Configuring the ProDAQ 302
44. etAttribute instr session VI ATTR WIN ACCESS amp win access VI SUCCESS viStatusDesc instr session status descr if status VI SUCCESS printf VISA WARNING viGetAttribute returned status 08x s n status descr else printf VISA ERROR viGetAttribute returned status 08x s n status descr return status win access VI DEREF ADDR allowed to use pointer or similar value ViUInt16 address G value value mod ViUInt16 address value else if win access VI USE OPERS use functions to access memory viPeek16 instr session address amp value a value value mod viPokel6 instr session address value 5 if status viUnmapAddress instr session VI SUCCESS viStatusDesc instr session status descr if status gt VI SUCCESS printf VISA WARNING viUnmapAddress returned status 08x s n status descr else printf VISA ERROR viUnmapAddress returned status 08x s n status descr return status return VI_SUCCESS Figure 30 Register I O using memory mapping Page 36 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM In the above example the function viMapAddress is used to map a register range starting with offset and extending over the size of the register into the memory of the host If this is successful the
45. fect if the Output Enable bit is set When read each of these bits indicates the actual level of the corresponding MODID line Copyright 2003 Bustec Production Ltd Page 49 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual Page 50 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 6 Front Panel Connectors and Switches The ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface features a USB connector four clock or trigger connectors a reset switch and depending on the options a GPIB connector and two trigger chaining connectors on its front panel 6 1 ProDAQ 3020 AA Front Panel Connectors and Switches ProDAQ 3020 SYS VXI FAIL Act Clk In Clk Out Trig In Trig Out RESET 6 1 1 USB Connector The ProDAQ 3020 uses a standard USB B series receptacle suitable for high full speed devices It mates with a standard B series plug used on a host to peripheral A to B type USB cable see Figure 4 Pin Signal Description 1 VBUS Device Power 2 D Differential Data 3 D Differential Data 4 GND Ground Shell Shield Shielding Figure 38 USB Connector Pin out 6 1 2 Clk In Out Connectors The ProDAQ 3020 features a standard SMB connector for receiving Clk In or distributing Clk Out the CLK10 signal from to the VXIbus 6 1 3 Trigger In Out Connect
46. ing trigger line TTL6 to the front panel output if status viMapTrigger instr session VI TRIG TTL6 VI TRIG PANEL OUT VI NULL VI SUCCESS error handling as shown in the previous examples close the sessions to the instrument and the resource manager viClose instr session viClose rm session Figure 36 Mapping Trigger Lines Page 44 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 4 Programming GPIB Devices using the ProDAQ 3020 Interface The ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface features an optional GPIB port on the front panel ProDAQ 3020 AB and ProDAQ 3020 BB only This chapter shows how to use the ProDAQ 3020 and the Bustec VISA library to program GPIB devices 4 14 Connecting to a Device The GPIB port on the ProDAQ 3020 can be used like any GPIB port installed via an interface card in your computer After using the configuration tool to assign an interface number devices connected to the GPIB port on the ProDAQ 3020 can be addressed by using a standard VISA resource name For GPIB devices this resource name is a combination of interface type interface number GPIB address and device type GPIBO 2 INSTR Interface Type A Device Type Interface Number GPIB Address The interface type for the GPIB port on the ProDAQ 3020 USB2 0 VXIbus Interface is always GPIB The interface number is the
47. isa h gt main int argc char argv ViStatus status ViSession rm session ViSession instr session ViChar descr 256 open session to the resource manager if status viOpenDefaultRM amp rm session VI SUCCESS error handling as shown in the previous examples open a session to the instrument status viOpen rm session VXIO 2 1INSTR VI NULL VI NULL amp instr session VI SUCCESS error handling as shown in the previous examples reset the device status viPrintf vi RST n VI SUCCESS error handling as shown in the previous examples ask the device for its identification status viPrintf vi IDN n VI SUCCESS error handling as shown in the previous examples read the identification sent back if status viScanf vi 256t descr VI SUCCESS error handling as shown in the previous examples printf Device Identification s n descr close the sessions to the instrument and the resource manager viClose instr session viClose rm session Figure 34 Reading the Device Identification Page 40 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM The functions ViPrintf and viScanf use a C style formatting string to format and scan messages send to and read from the device freeing the user from the separate st
48. iv BLT 3B VI A32 SPACE Non priv BLT 0B VI D64 PRIV VI A16 SPACE Supervisory 2D VI_A24 SPACE Supervisory MBLT 3C VI_A32_SPACE Supervisory MBLT OC VI D64 NPRIV VU A16 SPACE Non priv 29 VI A24 SPACE Non priv MBLT 38 VI A32 SPACE Non priv MBLT 08 Figure 32 VXIbus transfer types Block transfers are performed on the VXlbus only if the correct attribute VI ATTR SRC PRIV or VI ATTR DEST PRIV depending on the direction is set to one of the types VI BLCK PRIV VI BLCK NPRIV VI D64 PRIV or VI D64 NPRIV The data width of the performed transfer depends on the viMoveXX function used except for the case that the attribute is set to VI D64 PRIV or VI D64 NPRIV in which case a D64 MBLT transfer is performed viMoveln32 and viMoveOut32 only Page 38 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM include lt visa h gt ViUInt16 data 1024 buffer used to store data main int argc char argv ViStatus status ViSession rm session ViSession instr session ViChar descr 256 ViUInt16 value open a session to the resource manager and instrument as shown in Figure 28 Opening a VISA Session not shown here J E K K K K K k A k K k k A k K A k A k A A k k k A k k k k A k k k k k k k k k k k k k k k k k k k k k k K k k k k k k k k k k k kk k k k k k k kk kk kk k f Perform a 16 bit wide block transfer from
49. lso 3 5 2 Using Front Panel Trigger Lines The ProDAQ 3020 AB supports in addition to build a daisy chain to forward all or some TTL trigger lines from one mainframe to another The Active Edge control in the Input Trigger area can be used to select the active edge for the trigger detection on the Trig In connector Rising A rising edge detected on the front panel Trig In connector will assert the VXIbus trigger lines mapped to the input a subsequent falling edge will de assert the trigger lines Falling A falling edge detected on the front panel Trig In connector will assert the VXIbus trigger lines mapped to the input a subsequent rising edge will de assert the trigger lines The Active Level control in the Output Trigger area can be used to select the level mapping of the VXIbus trigger lines to the level of the Trig Out signal Page 22 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM Low The output signal is active low Asserting one of the mapped trigger lines on the VXIbus will cause the signal on the Trig Out connector to change its state from the default high level 1 to the low level 0 High The output signal is active high Asserting one of the mapped trigger lines on the VXIbus will cause the signal on the Trig Out connector to change its state from the default low level 0 to the high level 1
50. ng the module use the original packing material whenever possible The original shipping carton and the instrument s plastic foam will provide the necessary support for safe reshipment If the original anti static packing material is unavailable wrap the ProDAQ module in anti static plastic sheeting and use plastic spray foam to surround and protect the instrument Copyright 2003 Bustec Production Ltd Page 9 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual 2 2 Installing the VISA Library The VISA library provided by Bustec Production Ltd is used to communicate to the VXI instruments in mainframes connected via the ProDAQ 3020 USB 2 0 VXlbus Slot 0 Interface to the host PC Note On Microsoft Windows 20008 or Microsoft Windows XP systems it is recommended to install the VISA library and the USB driver from an account having administrator privileges To install it on your PC do the following 1 Apply power to your PC and boot your operating system Close all open applications to allow for a safe installation of the new components Do not apply power to the VXI mainframe at this point in time or do not connect the ProDAQ 3020 Interface via the USB bus to your PC 2 Insert the driver CD provided with the module into your PC CD ROM drive If the autorun feature is turned on the CD menu will start automatically If not select Run from your Start menu and type lt drive gt autorun exe where driv
51. number which was assigned to the particular 3020 by using the VISA configuration utility see 2 5Configuring the ProDAQ 3020 for the VISA Library The GPIB address is the address configured on the GPIB device For some GPIB devices a secondary address is necessary to select for example a special function on the device In this case the resource name can be extended to contain also a secondary GPIB address GPIBO 2 1 INSTR Interface Type Device Type Interface Number Primary Address Secondary Address The device type for GPIB instruments is always INSTR Copyright 2003 Bustec Production Ltd Page 45 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual 4 2 Reading and Writing Messages to from a GPIB Device The following example shows how to connect to a GPIB device and how to write and read messages to from the device include lt visa h gt main int argc char argv ViStatus status ViSession rm session ViSession instr session ViChar descr 256 open session to the resource manager if status viOpenDefaultRM amp rm session VI SUCCESS error handling as shown in the previous examples open a session to the instrument if status viOpen rm session VXIO 2 1INSTR VI NULL VI NULL amp instr session VI SUCCESS error handling as shown in the previous examples reset the device status viPrintf vi
52. ors Two SMB connectors allow to receive Trig In or to generate Trig Out a TTL Trigger signal 6 1 4 Reset Switch A push button reset switch can be used to reset the device Copyright 2003 Bustec Production Ltd Page 51 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual 6 2 ProDAQ 3020 AB Front Panel Connectors and Switches In addition to the connectors found on the ProDAQ 3020 AA the ProDAQ 3020 AB features an additional GPIB connector on its front panel 6 2 1 GPIB Port Connector me The ProDAQ 3020 AB features a standard 24 pin IEEE488 connector her for the GPIB port ustec ProDAQ 3020 Pin Signal Description 1 DIO1 Data I O 1 2 DIO2 Data I O 2 FAIL Act 3 DIO3 Data UO 3 4 DIO4 Data 1 O 4 5 EOI End of Information 6 DAV Data Valid 7 NRFD Not Ready For Data 8 NDAC No Data Accepted 9 IFC Interface Clear Mud 10 SRQ Service Request 11 ATN Attention O Cik out 12 SHIELD Shield 13 DIO5 Data 1 0 5 O Trig In 14 DIO6 Data I O 6 15 DIO7 Data I O 7 BD trig out 16 DIO8 Data I O 8 17 REN Remote Enable 18 GND Ground 19 GND Ground 20 GND Ground 21 GND Ground 22 GND Ground 23 GND Ground 24 GND Ground RESET Figure 39 GPIB Port Connector Pin out 3 e ar bus Page 52 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface
53. plete Copyright 2003 Bustec Production Ltd Page 11 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual 2 3 Installing the ProDAQ 3020 Interface To prevent damage to the ProDAQ module being installed it is recommended to remove the power from the mainframe or to switch it off before installing Insert the module into the mainframe using the guiding rails inside the mainframe as shown in Figure 3 Push the module slowly into the slot until the modules backplane connectors seat firmly in the corresponding backplane connectors The top and bottom of the front panel of the module should touch the mounting rails in the mainframe Front panel mounting screws Slide the module into the mainframe using the guiding rails until its connectors plug into the backplane connectors Figure 3 Installing the ProDAQ 3020 into a C Size Mainframe Note To ensure proper grounding of the module tighten the front panel mounting screws after installing the module in the mainframe To connect the ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface to your computer use the USB A to B cable provided The A series plug connects to your host PC or hub while the B series plug plugs into the B series receptacle on the ProDAQ 3020 front panel SUR PT HE SES A Plug Wy B Plug Figure 4 A to B Type USB Cable Page 12 of 60 Copyright 2003 Bustec Production Ltd ProD
54. ress dynamically the actual assignment can be found in the output file of the resource manager see 2 7 1 Running the VXIbus Resource Manager The device type for VXI instruments is always INSTR Note When running the above example please make sure that the logical address used in it matches the logical address setting of the instrument you want to connect to Note Before you can use the above example to connect to your device you must run the VXI Resource Manager see 2 7 1 Running the VXIbus Resource Manager 3 2 Programming Register based Devices Register based devices are devices implementing a set of registers in A16 and often in A24 or A32 Programming register based devices is done by reading and writing these registers to change their contents either by bit in groups of bits or in whole 3 2 1 Accessing Registers To access single registers the VISA library offers two groups of functions The first group viln8 viln16 viln32 viOut8 viOut16 viOut32 provides a standardized single word access to a device register in A16 A24 or A32 space Figure 29 shows an example of a function reading a value from a device register modifying the value read and writing it back Q The driver for the ProDAQ 3020 will automatically take care about byte ordering i e it will swap the words to be read or written between the little endian host byte ordering your PC is using to the big endian byte ordering used on the VXIbus
55. rm the access such as window mapping address translation and error checking The Low Level Access Services are similar in purpose but are implemented without the software overhead of the High Level Services VXI0 2 INSTR Session Information Template Operations H Basic 1 0 Operations Memory 0 Operations r Input ER Address space Vi 16 SPACE zl viQut viMoveln Offset sfo 4 viMoveQut viMoveAsync viMap amp ddress Read in an 8 bit 16 bit or 32 bit value from the specified memory space offset viUnMapAddress viPoke H Shared Memory Operations Output VXI Specific Operations Data read ix pp Returned Status x 0 Operation completed successfully Figure 25 Memory I O Operations Copyright 2003 Bustec Production Ltd Page 29 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual Figure 25 shows an example of the high level access services In the Input section the user can select an address space an offset and a transfer width By pressing Run on of the functions viln8 viln16 or viln32 depending on the access width are executed and the result is shown in the Output section of the dialog along with the returned status The high level functions viMoveln viMoveOut and viMoveAsync will move blocks of data As with the functions viln8 vin16 viln32 viOut8 viOut16 and viOut32 the Input section will allow yo
56. rrent value of the attribute in the control Attribute state if the operation was successful and the returned status of the function 2 7 2 2 Basic I O Operations The basic I O operations will allow the user to send commands to a device and read back its answer to trigger the device or read its status Page 28 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM VXI0 2 INSTR i Session Information H Template Operations E Basic Operations m Input Read data from device a Number of bytes to read a o z Asynchronous viwirite viwriteFromFile vidssertT rigger n viReadSTB viClear m Output E Memory 1 0 Operations Read buffer H Shared Memory Operations Mel Specific Operations Job identifier x Returned Status al Ir Figure 24 Using a basic I O operation As an example you can use the viRead function to read data or a message from the device To do so just specify the maximum number of bytes to read from the device and press Run As before the VISA Assistant will show the message read as well as the returned status of the operation 2 7 2 3 Memory I O Operations The memory I O operations consist of High and Low Level Access services The High Level Access Services allow register level access to devices that support direct memory access They encapsulate most of the code required to perfo
57. s a high speed cable bus that supports data exchange between a host computer and a wide range of simultaneously accessible peripherals The ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface provides a direct link between the USB and the VXI backplane This manual describes the implementation configuration and use of the interface 1 4 Requirements To set up and use the ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface you need the following A PC compatible computer running Windows 20009 or Windows XP9 A USB 1 1 or USB 2 0 compatible host controller A VXI mainframe The ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface USB cable ProDAQ Driver CD 1 1 1 The ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface The ProDAQ 3020 USB 2 0 VXlIbus Slot 0 Interface is a C size register based VXIbus module providing a direct link between the high speed USB 2 0 bus and the VXI backplane Data packages sent and received via the USB bus will be either translated into accesses on the VXlbus or can be used to control the configuration and Slot 0 capabilities of the ProDAQ 3020 The ProDAQ 3020 can automatically detect whether it is installed in the left most slot of a VXI mainframe slot 0 and will enable or disable its Slot 0 capabilities accordingly 1 1 2 The Host Computer The ProDAQ 3020 Interface together with the USB controller allows your host computer to perform as if it is plugged directly into the VXI backplane It needs to be equipped with a USB 1 1 or USB 2 0
58. stant Session Window sssssssseneeenneennnnn 27 Figure 23 Using a template operation 28 Figure 24 Using a basic I O operation BE 29 Figure 25 Memory WO Operatlons x ss tret eee ns ae 29 Figure 26 Shared Memory Operations cccccceeeeeeeeeeeeeeeeeeeeneeeeeeeeeeeeeeeeneeeeeeeeeeeeeeees 30 Figure 27 VXI Specific EES tee eebe 31 Figure 28 Opening a VISA Session ee 33 Figure 29 Memory based TE ee oat c at M ta pA de 35 Figure 30 Register I O using memory mapping eceeeeeee eee eeeeeeeeeeeeeeeeeeeeeeeteeeeeeeeeeeeteees 36 Figure 31 Moving a Block of Dalai EE 37 Figure 32 VXIbus transfer EE 38 Figure 33 Performing VXIbus Block Transiers 39 Figure 34 Reading the Device Identification 40 Figure 35 Sending Trigger Pulse euer nn Ee M ec ERE Nep 42 Figure 36 Mapping Trigger Lines s ira peret eoe ER Fe Feo y cor atre tete reete past 44 Figure 37 Reading and writing messages to from a GPIB device 46 Figure 38 USB Connector Pin out is 51 Figure 39 GPIB Port Connector Pin out ss 52 Figure 40 Trigger Chain Connectors Pin out EEN 53 Copyright 2003 Bustec Production Ltd Page 5 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual Page 6 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 1 Introduction The USB i
59. tatic Copyright 2003 Bustec Production Ltd Page 47 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual value at power up If a logical address of 255 FFnex is assigned to the module it will take part in the dynamic configuration protocol and the resource manager will use this register to assign a logical address to the module 5 2 3 Device Type m su o o CES Operation RO RO RO RO RO RO RO RO RO RO RO RO RO 0x00CC if slot 0 EUN otherwise ModelCode 15 0 ModelCode 15 0 This field contains a device dependent type identifier As defined by the VXIbus standard the module uses two different identifier depending on whether the module is placed in the left most slot of a VXI mainframe slot O and is used as VXI slot 0 controller or not Identifier when used as slot 0 controller 0x00CC Identifier when not used as slot 0 controller Ox0BCC 5 2 4 Status Register Bit 315 14 13 12 0 9 8 7 e 5 2 3 2 3 0 Initial x H H ix H H H H H lHI iHlH H Hl x x Ol D A 2 2 09 Z LE ala B MODID one 1 indicates that the device is not selected via the P2 MODID line A zero 0 indicates that the device is selected b high state on the MODID line ot 0 A one 1 indicates that the module is in the lef
60. tatus descr else printf VISA ERROR viOpen returned status 08x s n status descr return status accessing the instrument close the sessions to the instrument and the resource manager viClose instr session viClose rm session Figure 28 Opening a VISA Session Copyright 2003 Bustec Production Ltd Page 33 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual The first step in a program which uses the VISA library is always to open a session to the default resource manager It provides connectivity to all VISA resources registered with it and gives applications control and access to individual resources The next step is to open a session to the instrument or multiple sessions to multiple instruments The resource name used is a combination of interface type and number logical address of the VXI device and a device type VXI 0 2 INSTR Interface Type td Device Type Interface Number Logical Address The interface type for the ProDAQ 3020 USB2 0 VXIbus Interface is always VXI The interface number is the number which was assigned to the particular 3020 by using the VISA configuration utility see 2 5Configuring the ProDAQ 3020 for the VISA Library The logical address of a VXI device is defined either statically by setting its logical address switch or dynamically during runtime by the resource manager If the resource manager assigned the add
61. the configuration utility To configure these parameters start the configuration utility by selecting the VISA Configuration Utility entry in the VXIp ug amp play program group in the start menu Start gt VXIPNP VISA Configuration Utility In the configuration utility select the Resource Manager button on the right hand side see Figure 10 This will show the configuration dialog for the resource manager which allows configuring the output file destination and initial delay Copyright 2003 Bustec Production Ltd Page 25 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual ua ProDAQ Resource Manager xj This utility allows you to edit the Resource Manager Delay and output Configuration File Dutput File Destination c veipnp WinNT sbuVisaNburesman out Browse 3 Resource Manager Delay secs Reset to Default La Cancel Figure 20 Resource Manager Configuration Note To run the resource manager for a VXI mainframe connected via a ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface to your computer the ProDAQ 3020 must be located in the left most slot slot 0 of the VXI mainframe and must be configured to use the logical address 0 00nex Note Although the ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface is hot plug able via the USB bus the resource manager cannot dynamically add or remove devices from its device list Therefore the resource manager must b
62. the necessary control for instruments using the additional features of the P3 connector CLK100 Star Trigger add Trigger and Local Bus Lines 1 1 4 The USB Cable To connect the ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface to your host computer use the USB A to B high full speed cable provided You can connect the ProDAQ 3020 to any of the USB ports your host computer expansion board provides Alternatively if you are using a USB hub to connect several USB devices to your computer you may connect the ProDAQ 3020 to a port on the hub Note If you are using an additional USB hub to connect the ProDAQ 3020 to your computer the hub must be USB 1 1 or 2 0 compatible To achieve full performance the hub must be able to support the high speed mode as specified by the USB 2 0 standard In general using multiple devices connected to the same host controller port may decrease the performance of your system Page 8 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 2 Installation and Configuration The ProDAQ 3020 USB 2 0 VXlbus Slot 0 Interface is a single slot C size VXlbus instrument and can be installed in any slot of a standard C size VXI mainframe To be Slot 0 controller for the VXlbus system it must be installed in the leftmost slot of the VXI mainframe slot O If it is installed in any other slot of a VXI mainframe all slot 0 capabilities MODID CLK10 et
63. tmost slot of a VXlbus system Logical Address Contains the logical address the module is configured for E Ready A zero 0 means the device is executing its self test Passed After completing the self test signaled by a one 1 in the Read bit the Passed bit indicates the state of the self test A one 1 indicates that the self test has successfully completed A zero 0 means that the device has failed its self test Page 48 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 5 2 5 Control Register ue e unis sir pets papa EM eration ws s Initial Contents Not Used Sysfail Inhibit A one 1 written to this bit disables the device from driving the SYSFAIL line Reset A one written to this field forces the device into a reset state 5 2 6 MODID Register ue pe Le Le ee sr Le Le pa Lee E QERESEIEA A qrarara Initial 5 2 Not Used MODID 12 0 Olu Output Enable Writing a one to this bit enables the Slot 0 MODID driver Writin zero disables the MODID driver This bit is cleared zero b device resets When read this bit indicates the state of the MODID drivers A one means the drivers are enabled a zero indicates that the drivers are disabled MODID 12 0 Writing a one to any of these bits drives the corresponding MODID line high Writing a zero drives the corresponding line low Writin to these bits has only ef
64. u to enter an address space an offset and a transfer width Additionally a length parameter will define the number of elements to transfer The low level access services viMapAddress viUnmapAddress viPeek and viPoke need to be used together First a memory mapping must be established by using the function viMapAddress then viPeek and viPoke can be used to access the mapped register space and viUnmapAddress must be used to undo the memory mapping 2 7 2 4 Shared Memory Operations Shared memory operations allow to allocate memory space on the device to be used exclusively by the session allocating it Figure 26 shows an example of the shared memory operations VX10 2 INSTR Session Information H Template Operations H Basic 1 0 Operations Input e Memory 1 0 Operations Allocation size Iz p 4 ared Memory Operations Allocate memory from a device s memory region f on viMemFree Vl Specific Operations Output Offset x Returned Status m RN Figure 26 Shared Memory Operations Note The ProDAQ 3020 USB 2 0 VXlbus Slot 0 Interface does not have shareable memory 2 7 2 5 VXI Specific Operations VXI Specific Operations are those operations which were implemented to deal with special circumstances you can find only on controller and instruments using the VXIbus to communicate The example shows an operation which can be found only for backplane resources of VXIbus mainframes see Fig
65. uction Ltd Page 17 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual ProDAQ Configuration Utility xj Available Interfaces Interface Number Description ProDAG 3020 Ger No 30201018 ProDAQ 3020 Ser No 30201018 ProDAG 3020 Ger No 30201003 Val e The list to the left shows all available not configured interfaces To add an interface select one of the available interfaces to the left and press lt OK gt H E x Il Figure 11 Adding an Interface To configure and add a ProDAQ 3020 interface select the entry for the device in the list choose an interface number on the right side and select OK The list of configured interfaces in the main dialog will now display the configured interface with its interface name and number ua ProDAQ Configuration Utility zl xd Configured Interfaces Add Interfaces GPIBO ProDAG 3020 Ger No 30201018 ProDAQ 3251 Remove Interface eat ProDAQ 3020 Ser No 30201018 Configure Interface Refresh List Interface Description Resource Manager Figure 12 Displaying configured Interfaces To remove the configuration for a device from the system select the device in the list of configured interfaces and select Remove Interface To configure device dependent parameters of an interface select Configure Interface If you hot plug a device which was already configured on this system the
66. ure 27 Page 30 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM VKI0 0 BACKPLANE Session Information Hl Template Operations tr Basic 1 0 Operations m Input VXI Specific Operations t vi amp ssertnkiSignal Source line VI TRIG ECLO SU Destination be Vi TRIG ECLO z viMapTrigger i wUnmapT rigger Map the specified trigger source line to the specified destination line Output Returned Status x Figure 27 VXI Specific Operations The functions viMapTrigger and viUnmap Trigger enable you to route a trigger signal from a front panel input to one of the VXIbus trigger lines only for VXIbus controller supporting this feature In the Input section you can select a source trigger line which should be mapped to a destination trigger line As in the other examples pressing Run will execute the function and display the result in the Output section Note For more information about the VISA functions and their parameter refer to the VXIplug amp play Systems Alliance document VPP 4 3 The VISA Library Copyright 2003 Bustec Production Ltd Page 31 of 60 3020 XX UM ProDAQ 3020 USB2 0 VXIbus Slot 0 Interface User Manual Page 32 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface User Manual 3020 XX UM 3 Programming VXI Devices using the ProD
67. xamples open a session to the instrument status viOpen rm session VXIO 2 1INSTR VI_NULL VI_NULL amp instr session l VI_SUCCESS error handling as shown in the previous examples defining the trigger line to use status viSetAttribute instr_session VI ATTR TRIG ID VI TRIG TTLO VI SUCCESS error handling as shown in the previous examples send a trigger pulse to the device status viAssertTrigger instr session VI TRIG PROT SYNC VI SUCCESS error handling as shown in the previous examples close the sessions to the instrument and the resource manager viClose instr session viClose rm session Figure 35 Sending a Trigger Pulse Figure 35 shows an example for sending a trigger pulse to a device The function viSetAttribute is used to set the attribute VI ATTR TRIG ID to select the trigger line In general the trigger ID can be set to VI TRIG TTLO to VI TRIG TTL7 VI TRIG ECLO VI TRIG ECL1 or VI TRIG SW For the setting VI TRIG SW the device is sent the word serial trigger command the other settings correspond to the VXIbus trigger lines TTLO TTL7 and ECLO ECL1 To send the trigger the function viAssertTrigger is used in the example 2 with the protocol argument set to VI PROT DEFAULT The interpretation of this argument Page 42 of 60 Copyright 2003 Bustec Production Ltd ProDAQ 3020 USB 2 0 VXIbus Slot 0 Interface Us

ProDAQ 3020 User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents