1. Manuals
  2. Brands
  3. VXI Manuals
  4. Recording Equipment
  5. GPIB-VXI
  6. User manual

VXI GPIB- User Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
GPIB-VXI
User Manual
bus
April 1990 Edition
Part Number 320151-01
© Copyright 1983, 1991 National Instruments Corporation.
All Rights Reserved.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the GPIB-VXI and is the answer not in the manual?

Questions and answers

Summary of Contents for VXI GPIB-VXI

  • Page 1 GPIB-VXI User Manual April 1990 Edition Part Number 320151-01 © Copyright 1983, 1991 National Instruments Corporation. All Rights Reserved.
  • Page 2 National Instruments Corporation 6504 Bridge Point Parkway Austin, TX 78730-5039 (512) 794-0100 (800) IEEE-488 Fax: (512) 794-8411...
  • Page 3 Limited Warranty The GPIB-VXI is warranted against defects in materials and workmanship for a period of one year from the date of shipment, as evidenced by receipts or other documentation. National Instruments will, at its option, repair or replace equipment that proves to be defective during the warranty period. This warranty includes parts and labor.
  • Page 4 FCC/DOC Radio Frequency Interference Compliance This equipment generates and uses radio frequency energy and, if not installed and used in strict accordance with the instructions in this manual, may cause interference to radio and television reception. This equipment has been tested and found to comply with (1) the limits for a Class A computing device, in accordance with the specifications in Subpart J of Part 15 of U.S.
  • Page 5 Preface This manual contains information you will need to use the GPIB-VXI in your VXIbus system. It describes the function and behavior of GPIB-VXI units configured with the standard firmware option. Organization of the GPIB-VXI User Manual The GPIB-VXI User Manual is organized as follows: •...
  • Page 6 This font is also used for the names of all commands and queries used in the GPIB-VXI local command set. <CR> Angle brackets enclosing a term in Times font denote a key on the keyboard, or the equivalent ASCII character.
  • Page 7 (800) 433-3488 (toll-free U.S. and Canada) For your documentation comments, we have included a User Comment Form at the back of the manual. Please mail it to the address printed at the bottom of the form. © National Instruments Corporation GPIB-VXI User Manual...

  • Page 9: Table Of Contents

    Setting the Installed RAM Size................2-5 Setting the Dual-Ported Memory Size ...............2-7 Setting the Front Panel Reset Operation............2-7 Setting the VMEbus Requester Level..............2-8 Setting the VXI Interrupt Handler Levels............2-8 GPIB-VXI Startup Mode Configuration............2-9 488-VXI System Mode ................2-9 Diagnostics Mode ..................2-10 Nonvolatile Configuration Mode............2-10 VXI pROBE Mode.................2-10...
  • Page 10 RmEntry? ......................3-15 Srvnts?........................3-17 StatusState? ......................3-17 Dynamic Configuration Commands and Queries ............3-18 DCBNOSend......................3-19 DCGrantDev ......................3-19 DCSystem?......................3-19 Dynamic Reconfiguration Queries ................3-20 Broadcast?......................3-21 GrantDev? ......................3-23 RelSrvnt?......................3-24 VXI-Defined Common ASCII System Commands ............3-25 DCON?.......................3-25 DINF?.........................3-27 DLAD?.......................3-28 DNUM?......................3-29 DRES?........................3-29 GPIB-VXI User Manual © National Instruments Corporation...
  • Page 11 SYSRESET ......................3-45 TTL Trigger Access Commands..................3-46 SetTrigOutFP .....................3-46 SetTrigSrc ......................3-47 SourceTrig......................3-47 Word Serial Communication Commands and Queries..........3-48 ProtErr? ......................3-49 RespReg? ......................3-49 WScmd.......................3-50 WScmd? ......................3-50 WSresp? ......................3-50 WSstr........................3-52 WSstr?........................3-53 CI Configuration Commands and Queries..............3-53 © National Instruments Corporation GPIB-VXI User Manual...
  • Page 12 DCIDownLdPI ....................3-59 DCIDownLoad....................3-60 DCISetup?......................3-61 DCISetupPI? ......................3-62 Chapter 4 Nonvolatile Configuration ....................4-1 The GPIB-VXI Nonvolatile Configuration Main Menu..........4-2 Read in Nonvolatile Configuration..............4-2 Print Configuration Information ................4-2 Change Configuration Information..............4-4 Set Configuration to Factory Settings..............4-5 Write Back (Save) Changes ................4-5 Quit Configuration .....................4-5...
  • Page 13 ..........................Index-1 Figures Figure 1-1. The GPIB-VXI Interface Module................1-1 Figure 2-1. GPIB-VXI Parts Locator Diagram ..............2-3 Figure 2-2. Example Logical Address Switch Setting ............2-4 Figure 2-3. Example GPIB Primary Address Switch Setting ..........2-4 Figure 2-4. Example Servant Area Size Switch Setting............2-5 Figure 2-5.
  • Page 14 Contents Figure 4-1. The GPIB-VXI Nonvolatile Configuration Main Menu ........4-2 Figure 4-2. The Nonvolatile Configuration Information Display ..........4-3 Figure 4-3. The GPIB-VXI Nonvolatile Configuration Changer...........4-4 Figure 5-1. The Diagnostics Mode Menu ................5-3 Figure 5-2. The Diagnostic Test Selection Menu..............5-5 Figure C-1. GPIB-VXI Operation Without Code Instruments ..........C-3 Figure C-2.

  • Page 15: General Description

    Chapter 1 General Description This chapter contains a brief overview of the GPIB-VXI and its VXIbus, VMEbus and GPIB capabilities. This chapter also contains a description of the local command set, an introduction to Code Instruments (CIs), and a description of the GPIB-VXI front panel indicators, switches and connectors.

  • Page 16: What Your Kit Should Contain

    VXIbus startup configuration, self-test, and initialization functions, as well as VXIbus Slot 0/ VMEbus Slot 1-related services. The RM and Slot 0 functions can be defeated individually, so that the GPIB-VXI can coexist with another RM and/or be located in any slot.

  • Page 17: Optional Equipment

    1. Verify that the pieces contained in the package you received match the kit parts list. Do not remove the module from its plastic bag at this point. 2. Your GPIB-VXI module is shipped packaged in an antistatic plastic bag to prevent electrostatic damage to the module. Several components on the module can be damaged by electrostatic discharge.

  • Page 18: Gpib Characteristics

    IEEE 488.2-compatible 488-VXIbus translation The IEEE 488.1 capabilities are supported for all VXIbus devices associated with GPIB secondary addresses. The IEEE 488.2 compatibility applies to 488.2-compatible VXIbus devices associated with GPIB secondary addresses through the GPIB-VXI. GPIB-VXI User Manual © National Instruments Corporation...

  • Page 19: Command Set

    Protocol communication. You can also use separate programmable local command response modes for interactive and control program operation. Code Instruments The GPIB-VXI can run software modules called Code Instruments or CIs that perform special functions in the VXIbus environment. Typical applications of CIs include: •...

  • Page 20: Front Panel Indicators, Switches And Connectors

    Trigger input and output (2 BNCs) External CLK10 I/O (BNC) • System reset switch Power Consumption and Temperature Rating Current requirements and the temperature rating of the GPIB-VXI are printed on a label affixed to its shield casing. GPIB-VXI User Manual © National Instruments Corporation...

  • Page 21: Configuration And Startup Procedures

    Warning: Do not make connections to pins 1 and 6. This could damage your GPIB-VXI. Cables for connecting the GPIB-VXI serial port to an RS-232 terminal or COM1 port on an IBM PC-compatible computer are available from National Instruments (see Optional Equipment in Chapter 1).

  • Page 22: Gpib-Vxi Configuration

    System startup messages Disabled You do not have to change the GPIB-VXI factory configuration to use it as a Slot 0 Resource Manager. This section is a guide to alternate configurations. The location of the GPIB-VXI switches and jumpers is illustrated in Figure 2-1. The figures in this section are illustrated according to the orientation of the GPIB-VXI as depicted in Figure 2-1.

  • Page 23: Figure 2-1. Gpib-Vxi Parts Locator Diagram

    Mode RAM SIMM pair 1 12345678 RAM SIMM pair 2 GPIB Primary Address Turbo488 Serial Port Startup Message EPROM Printout Expansion Board Enable RS-232 GPIB Connector Connector Figure 2-1. GPIB-VXI Parts Locator Diagram © National Instruments Corporation GPIB-VXI User Manual...

  • Page 24: Setting The Logical Address

    0, respectively. The ON position corresponds to a bit value of 0, and OFF corresponds to a value of 1. For example, to set the logical address of the GPIB-VXI to 25 (19h), set the switches as shown in Figure 2-2. Notice that setting the logical address to any setting but 0 will disable the GPIB-VXI RM.

  • Page 25: Setting The Servant Area Size

    Configuration. Setting the Installed RAM Size You can install up to 4M of local RAM on the GPIB-VXI. The minimum amount of memory is 512K. You can install additional memory by inserting 256K by 8-bit (Texas Instruments part number TMS41256GU8 or equivalent) or 1M by 8-bit (Texas Instruments part number TMS024EAD9 or equivalent) DRAM SIMM modules into the SIMM sockets as illustrated in Figure 2-1.

  • Page 26: Table 2-3. Installed Ram Switch Settings

    1M by 8-bit The relationship between the amount of installed memory, the local address range occupied by the memory, and range of VME A24 addresses accessible by the GPIB-VXI CPU is listed in Table 2-4. Table 2-4. GPIB-VXI CPU Local and A24 Memory Ranges...

  • Page 27: Setting The Dual-Ported Memory Size

    The Reset button on the front panel can be configured to reset the GPIB-VXI and drive SYSRESET on the VXIbus backplane or just reset the GPIB-VXI. If jumper W23 is installed, the GPIB-VXI is reset and SYSRESET is driven. If jumper W23 is not installed, only the GPIB- VXI is reset.

  • Page 28: Setting The Vmebus Requester Level

    Configuration and Startup Procedures Chapter 2 Setting the VMEbus Requester Level The VMEbus requester level of the GPIB-VXI is jumper-configurable as shown in Figure 2-5. • • • • • • a. Level 3 Requester • • • • •...

  • Page 29: Gpib-Vxi Startup Mode Configuration

    Figure 2-6. Startup Mode Switch Settings 488-VXI System Mode VXI system mode is the startup mode for normal operation in a VXI system. The GPIB-VXI comes up as described in the 488-VXI System Operation section later in this chapter. © National Instruments Corporation...

  • Page 30: Diagnostics Mode

    Warning: Installation of a Non-Slot 0-configured GPIB-VXI in Slot 0 or a Slot 0-configured GPIB-VXI in any slot other than Slot 0 is not allowed, and may result in damage to the GPIB-VXI, the mainframe, or other modules.

  • Page 31: System Startup Message Printing

    Figure 2-7. VXI System Startup Message Switch Settings Slot 0 Resource Manager Configuration You can configure the GPIB-VXI for Slot 0 Resource Manager operation by enabling the VXIbus Slot 0 functions, setting the model code to 0FFh, and setting the logical address to 0, as shown in Table 2-6.

  • Page 32: Figure 2-8. Clk10 Jumper Settings For Slot 0 Resource Manager Operation

    CLK10 jumpers See Figure 2-8 a. CLK10 sourcing for backplane is enabled from onboard clock source. If S24 is OFF, the GPIB-VXI will also source CLK10 at the front panel BNC. See Figure 2-8 b. CLK10 sourcing is enabled from external source via front panel BNC (S24 must be ON).

  • Page 33: Slot 0 Resource Manager Operation

    C bus, RS-232 port, DMA channels, GPIB port, interrupt logic, timer, and VXIbus registers. The five-second limitation imposed by the VXIbus specification does not allow exhaustive tests to be executed at system startup. Full tests of the GPIB-VXI can be executed in diagnostics mode, as described in Chapter 5, Diagnostic Tests.

  • Page 34: Rm Operation

    DC device logical addresses are assigned, they are never granted to an SC commander. DC commander/servant hierarchy creation is done through the use of the GPIB-VXI Local Command Set, as described in the DC Commands and Queries section of Chapter 3, Local Command Set.

  • Page 35: Static Configuration Operation

    Message-Based servants. Dynamic Configuration Operation If the system is a DC system (at least one DC device was found), the GPIB-VXI RM does not send Identify Commander or Begin Normal Operation to any devices. The outside controller (or embedded CI) can then create the DC commander/servant hierarchy without having to dynamically reconfigure the system.

  • Page 36: System Configuration Table

    ID number, model code, memory space requirement, memory base address, and memory size. The GPIB-VXI retains this table after the RM and general configuration operations are complete.

  • Page 37: Non-Slot 0 Resource Manager Configuration

    Non-Slot 0 Resource Manager Operation The startup sequence for a GPIB-VXI configured for Non-Slot 0 Resource Manager operation is identical to the Slot 0 Resource Manager operation, except that the GPIB-VXI controls the Slot 0 resources remotely. A VXIbus Slot 0 device must be in the system. It must be either a Register-Based device that implements the MODID Register, or a Message-Based device that supports the Word Serial commands Read MODID, Set Lower MODID, and Set Upper MODID.

  • Page 38: Non-Slot 0 Message-Based Device Configuration

    Figure 2-10. CLK10 Jumper Settings for Non-Slot 0 Message-Based Device Operation Non-Slot 0 Message-Based Device Operation Setting the logical address to FFh causes the GPIB-VXI to participate in dynamic configuration. At startup, a GPIB-VXI configured as a Non-Slot 0 Message-Based device performs its self- tests, then waits until it receives its Device Grant and Begin Normal Operation Word Serial commands.

  • Page 39: Front Panel Led Indications For Message-Based Device Operation

    Configuration and Startup Procedures Front Panel LED Indications for Message-Based Device Operation The GPIB-VXI indicates the progress of its self-test with the FAILED, TEST, and ONLINE LEDs. The LED indications are shown in Table 2-11. A successful system startup sequences through the first five states.

  • Page 40: Figure 2-11. Clk10 Jumper Settings For Slot 0 Resource Manager Operation

    CLK10 jumpers See Figure 2-11 a. CLK10 sourcing for backplane is enabled from onboard clock source. If S24 is OFF, the GPIB-VXI will also source CLK10 at the front panel BNC. See Figure 2-11 b. CLK10 sourcing is enabled from external clock source via front panel BNC (S24 must be ON).

  • Page 41: Slot 0 Message-Based Device Operation

    When the GPIB-VXI responds to the Begin Normal Operation command, it enters the normal mode of operation. After the GPIB-VXI Passed bit is set, the RM can manipulate or read the MODID lines by sending the Word Serial queries Read MODID, Set Lower MODID, or Set Upper MODID to the GPIB-VXI.

  • Page 43: Chapter 3 Local Command Set

    The GPIB-VXI command set consists of commands and queries. Commands cause the GPIB- VXI to take some action. A query may also cause the GPIB-VXI to take some action, but it also returns a response containing data or other information.

  • Page 44: Command Set Access

    • VXI Word Serial communication The three ports are active when the GPIB-VXI is in the Normal Operation sub-state and operate independently of one another. The GPIB-VXI returns query responses only to the port originating the query. The GPIB-VXI also maintains a separate status state for each port. You can use local commands to disable and re-enable each port's access to the local command set.

  • Page 45: Command Line Termination

    <LF> (ASCII 0Ah), it is ignored. The GPIB termination is EOI. Commands issued to the GPIB-VXI via VXI Word Serial Protocol are terminated by setting the END bit in the last Byte Available command. Responses are terminated by setting the END bit in response to the last Byte Request query.

  • Page 46: Command Response Format

    ASCII 0Dh followed by 0Ah. Error Reporting Command syntax and execution errors are reported to the port where the command originated. If the program response mode is enabled, the GPIB-VXI returns an error message in the following format: $ <error code><CRLF>...

  • Page 47: The Help Query

    Chapter 3 Local Command Set The Help Query The Help? query is a quick online reference to the syntax and functionality of the GPIB-VXI local command set. Help? Purpose: List syntax and descriptions of local command set. Query Syntax: Help? [<type>[,<type>,..]]...

  • Page 48: General Configuration Commands And Queries

    The ConsoleEna and WordSerEna commands control access to the local command set from the RS-232 and VXI Word Serial ports. The OBRAM? query can be used to determine the amount of GPIB-VXI installed RAM, and the DPRAM? query returns the amount of the installed RAM that is dual-ported to VME A24 space.

  • Page 49: Consmode

    Response: Program response: <A24 starting address>, <dual-ported RAM size><CRLF> Console response: This GPIB-VXI has <dual-ported RAM size>K bytes Dual-Ported to A24 Address <A24 hex starting address><CRLF> where <A24 starting address> is the dual-ported RAM base address in decimal integer format.

  • Page 50: Nvconf

    Region 1 Size : 0x70000 Number Procs : 32 Number Exchgs : 32 Number Msgs : 384 VXI Interrupt Level to Handler Logical Address (0xFF = free to assign): 1:0xFF 2:0xFF 3:0xFF 4:0xFF 5:0xFF 6:0xFF 7:0xFF DC Starting LA : 0x01...

  • Page 51: Obram

    Chapter 3 Local Command Set OBram? Purpose: Get the amount of RAM installed onboard the GPIB-VXI. Query Syntax: OBram? Response: Program response: <memsize><CRLF> where <memsize> is the amount of installed RAM, in K. Console response: This GPIB-VXI has <expression> of RAM installed onboard.<CRLF>...

  • Page 52: Wordserena

    Action: Control of the physical Word Serial registers is passed to <logical address>. The default control of the physical registers is given to the GPIB-VXI local command set parser. Examples: Pass control of the physical registers to code instrument at logical address 5.

  • Page 53: A24Memmap

    The system information commands (NumLaddrs?, Laddrs?, CmdrTable?, A24MemMap?, and A32MemMap?) return information about the known system. If the GPIB-VXI is the system RM, it can access information about the entire system. If it is not the RM, it has information only about itself and its immediate servants.

  • Page 54: A32Memmap

    Get A32 address map for the system. A32MemMap? Cmdr? Purpose: Get the logical address of a device's commander. Query Syntax: Cmdr? <logical address> where <logical address> is the logical address of the device. GPIB-VXI User Manual 3-12 © National Instruments Corporation...

  • Page 55: Cmdrtable

    <la X > is a valid logical address with servant addresses <sa X ,1> through <sa1,M>. The <comment> field indicates any relevant information about the status and/or capabilities of the device at logical address <la X >. © National Instruments Corporation 3-13 GPIB-VXI User Manual...

  • Page 56: Laddrs

    Get the number of known logical addresses. Query Syntax: NumLaddrs? Response: Program response: <num las><CRLF> where <num las> is the number of known logical addresses. Console response: There are <num las> known Logical Addresses<CRLF> GPIB-VXI User Manual 3-14 © National Instruments Corporation...

  • Page 57: Rmentry

    The mnemonics have the following meanings: device's logical address commander's logical address device's secondary address (255 if not assigned secondary address) slot number slot (255 if unknown, such as if the device does not have MODID capability) © National Instruments Corporation 3-15 GPIB-VXI User Manual...
  • Page 58 For example, memory base address and memory size lines are not returned for A16-only memory space devices. Example: Get RM information for a device at logical address 78. RmEntry? 78 GPIB-VXI User Manual 3-16 © National Instruments Corporation...

  • Page 59: Srvnts

    Get a list of logical address 15's servants. Srvnts? 15 StatusState? Purpose: Get a device's current self-test status. Query Syntax: StatusState? <logical address> <logical address> is the logical address for the device. © National Instruments Corporation 3-17 GPIB-VXI User Manual...

  • Page 60: Dynamic Configuration Commands And Queries

    • DCBNOSend • DCGrantDev • DCSystem? The DC commands are used to configure the VXI system when all of these conditions are present: • The GPIB-VXI is the RM. • At least one DC device is present in the system.

  • Page 61: Dcbnosend

    Grant servant at logical address 7 to commander at logical address 5. DCGrantDev 5,7 DCSystem? Purpose: Determine if the system is a DC system. A system is DC if it has at least one DC device. Query Syntax: DCSystem? © National Instruments Corporation 3-19 GPIB-VXI User Manual...

  • Page 62: Dynamic Reconfiguration Queries

    RelSrvnt? The dynamic reconfiguration commands are used to reconfigure the GPIB-VXI's servant subtree after the system has entered the Normal Operation sub-state. If the GPIB-VXI is RM, these commands can be used to reconfigure the entire system. The Broadcast? query can be used to make the system or subtree enter the Configure sub- state by broadcasting the End Normal Operation Word Serial query, or the Clear Word Serial command followed by the Abort Normal Operation Word Serial query.

  • Page 63: Broadcast

    Query Syntax: Broadcast? <boolean>,<ws cmd> If <boolean> is 1, the GPIB-VXI broadcasts <ws cmd> to all top-level commanders. If <boolean> is 0, it broadcasts <ws cmd> to its Message-Based servants. Notice that the GPIB-VXI should only broadcast to top-level commanders when it is RM.
  • Page 64 For Word Serial queries, <ws response> is the Word Serial response of the device at logical address <la>. For Word Serial commands <ws response> is 0. <Word Serial command name> is the name of the command name as shown in the previous table. GPIB-VXI User Manual 3-22 © National Instruments Corporation...

  • Page 65: Grantdev

    1,IDN GrantDev? Purpose: Grant a servant to a commander. Query Syntax: GrantDev? <commander's logical address>, <servant's logical address> Action: Grants the device at <servant's logical address> to device at <commander's logical address>. © National Instruments Corporation 3-23 GPIB-VXI User Manual...

  • Page 66: Relsrvnt

    Chapter 3 The GPIB-VXI must own the device at <servant's logical address>. The GPIB-VXI can get ownership of any device with the RelSrvnt? command. Notice that before the GrantDev? query is used, the Word Serial End Normal Operation query, or a Clear command followed by the Abort Normal Operation query should have been broadcast with the Broadcast? query.

  • Page 67: Vxi-Defined Common Ascii System Commands

    The DINF? query returns static information about a device. The DCON? query returns configuration information about a device. The DRES? query is used to perform a soft-reset sequence on a device. The RREG? query and WREG command are used to peek and poke registers on a VXI device. DCON? Purpose: Return system configuration information about a device or all devices.
  • Page 68 Interrupt Handler present Interrupter levels used by this device where INTS is a 7-digit INTS binary representing the seven VXI interrupt levels and a one in each position, meaning Interrupter present. the status state of the device: status...

  • Page 69: Dinf

    REG = Register-Based device MSG = Message-Based device EXT = Extended-Class device MEM = Memory-Based device memory space requirement memspace A16/A24 A16/A32 memory-based address for A16, A24, A32 membase © National Instruments Corporation 3-27 GPIB-VXI User Manual...

  • Page 70: Dlad

    Known logical addresses are <la1>,<la2>,..., <la N ><CRLF> CI logical addresses are terminated with an asterisk (*) in the console mode response. Example: Get a list of the known logical addresses. DLAD? GPIB-VXI User Manual 3-28 © National Instruments Corporation...

  • Page 71: Dnum

    <sysfail flag> determines whether or not the device is kept sysfail-inhibited. Response: Program response: <status><CRLF> Console response: Logical Address <logical address> is <status>. SYSFAIL Inhibit is <state>.<CRLF> where <status> is one of the following: PASS FAIL © National Instruments Corporation 3-29 GPIB-VXI User Manual...

  • Page 72: Rreg

    Syntax: RREG? <logical address>, <reg offset> where <logical address> is the device to read from and <reg offset> is the number of bytes to offset from the base of the VXI registers for that device. Response: Program response: <hex word value><CRLF>...

  • Page 73: Wreg

    These commands and queries configure and report the relationships between VXI logical addresses and GPIB addresses. The GPIB-VXI's primary address can be determined by using the Primary? query from the serial port. The relationships between GPIB secondary addresses and VXI logical addresses can be determined by using the Saddrs? query followed by SaddrLa? queries, or by using the RM information query Laddrs? followed by LaSaddr? queries.

  • Page 74: Lasaddr

    Program response: <secondary address> <CRLF> where <secondary address> is the secondary address attached to the logical address. A value of 255 indicates that no secondary address is attached to the logical address. GPIB-VXI User Manual 3-32 © National Instruments Corporation...

  • Page 75: Primary

    Query Syntax: Primary? Response: Program response: <primary address> <CRLF> where <primary address> is the GPIB primary address of GPIB-VXI. Console response: The GPIB primary address of the GPIB-VXI is <primary address> <CRLF> SaddrLa? Purpose: Get the logical address that a secondary address is attached to.

  • Page 76: Saddrs

    Current Secondary Addresses used: Secondary Address <sa1>: connected to Logical Address <la1>. Secondary Address <sa2>: connected to Logical Address <la2>. • • Secondary Address <sa N >: connected to Logical Address <la N ><CRLF> GPIB-VXI User Manual 3-34 © National Instruments Corporation...

  • Page 77: Sadiscon

    The GPIB-VXI has three programmable interrupter handlers. An application program can confirm this with the RdHandlers? query. The AllHandlers? and HandlerLine? queries return the current VXI interrupt level assignments for the handlers. The AssgnHndlr command can be used to change the level assignments.

  • Page 78: Assgnhndlr

    If <level> is 0, then the current VXIbus interrupt line held by interrupt handler <handler> is released. Examples: Assign the interrupt level 6 to the GPIB-VXI interrupt handler 2. AssgnHndlr 2,6 Release the interrupt level currently held by the GPIB-VXI interrupt handler 1. AssgnHndlr 1,0 GPIB-VXI User Manual 3-36 © National Instruments Corporation...

  • Page 79: Handlerline

    Chapter 3 Local Command Set HandlerLine? Purpose: Get the level assigned to a GPIB-VXI interrupt handler. Query Syntax: HandlerLine? <handler> Response: Program response: <level><CRLF> Console response: VXI interrupt handler <handler> assigned to interrupt level <level><CRLF> <level> is the interrupt level assigned to handler <handler>. If <level>...

  • Page 80: Ieee-488.2 Common Commands And Queries

    • *TST? • *WAI These commands provide minimal conformance to the 488.2 requirements for a DT1 device. Many of these 488.2 commands have limited meaning in the VXI environment, but are included for compatibility. *CLS 488.2 Intent: Clear the device status data structures, and force it to the Operation Complete Query Idle state.

  • Page 81: Ese

    Chapter 3 Local Command Set *ESE 488.2 Intent: Set the GPIB-VXI's Standard Event Status Enable (ESE) Register bits. Command Syntax: *ESE <byte value> where <byte value> is the new value of the ESE register. Action: Sets ESE to <byte value>.

  • Page 82: Idn

    Notice that since the GPIB-VXI only parses and routes commands, there are never any pending commands on the GPIB-VXI. *OPC? 488.2 Intent: Cause the GPIB-VXI to place an ASCII 1 in its output queue when all pending operations have completed. Query Syntax: *OPC? Response: 1 <CRLF>...

  • Page 83: Rst

    Return a device to a known initial state. Command Syntax: *RST Action: None. Other than the response mode configuration, the GPIB-VXI does not depart from its initial state. *SRE 488.2 Intent: Set the device's Service Request Enable (SRE) Register bits.

  • Page 84: Stb

    Get the contents of a device's Status Byte. Query Syntax: *STB? Response: <STB value><CRLF> where <STB value> is the current status of the path to the GPIB-VXI local command parser. *TRG 488.2 Intent: Cause a device to execute a stored trigger sequence.

  • Page 85: Wai

    The A16? and A24? queries can be used to peek, or read, locations in VME A16 and A24 memory space. The SYSRESET command can be used to remotely reset the system. Purpose: Write a 16-bit value into VXI A16 space. Command Syntax: <A16 address>, <word value>...

  • Page 86: A24

    Notice that <A24 address> has a valid range of 2097152 to 14680062 (#h200000 to #hDFFFFE). Action: Write <word value> to <A24 address>. Example: Write the value A502h to VXI A24 address 504305h. #h504305, #hA502 GPIB-VXI User Manual 3-44 © National Instruments Corporation...

  • Page 87: Sysreset

    Chapter 3 Local Command Set A24? Purpose: Read a word value from VXI A24 address space. Query Syntax: A24? <A24 address> Response: Program response: <word value><CRLF> Console response: Value <hex word value> (<word value>) read from A24 address <A42 hex address (<A24 address>)<CRLF>...

  • Page 88: Ttl Trigger Access Commands

    SetTrigSrc • SourceTrig These commands can be used to directly manipulate the VXI TTL Trigger lines and the front panel Trigger connectors of the GPIB-VXI. The SetTrigSrc command is used to set up the trigger line and protocol to use.

  • Page 89: Settrigsrc

    0: External In from front panel 1: Start/Stop 2: Sync 3: Semi-Sync 4: Asynch Action: GPIB-VXI is set up to source on TTL Trigger line <line> using protocol <protocol>. Example: Set up to source Sync protocol on TTL line 3. SetTrigSrc 1, 3, 2 SourceTrig Purpose: Source a TTL trigger.

  • Page 90: Word Serial Communication Commands And Queries

    • WSstr? These commands can be used to directly generate Word Serial communication operations with any Message-Based device, including the GPIB-VXI itself, regardless of whether or not it is the GPIB-VXI's servant. Note: The Word Serial communication commands and queries are intended for debugging purposes.

  • Page 91: Proterr

    Example: ProtErr? RespReg? Purpose: Get the Response Register contents of a Message-Based device. Query Syntax: RespReg? <log addr> Action: Returns the contents of the device's Response Register at logical address <log addr>. © National Instruments Corporation 3-49 GPIB-VXI User Manual...

  • Page 92: Wscmd

    Sends the Word Serial command <WS cmd> to the device at <log addr>. Example: Write the Begin Normal Operation Word Serial query (FCFFh) to a device at logical address 3. WScmd 3, #hFCFF GPIB-VXI User Manual 3-50 © National Instruments Corporation...

  • Page 93: Wsresp

    <log addr> Action: Reads and returns the response of the device at <log addr>. Response: Program response: <hex value><CRLF> where <hex value> is the hexadecimal value of the Data Low Register response. © National Instruments Corporation 3-51 GPIB-VXI User Manual...

  • Page 94: Wsstr

    Writes the string <string> to the device at <log addr> as a series of Byte Available commands. Example: Write the string "start" to a device at logical address 8. WSstr 8, "start" GPIB-VXI User Manual 3-52 © National Instruments Corporation...

  • Page 95: Ci Configuration Commands And Queries

    CI Configuration Commands and Queries The CI configuration commands and queries are described on the following pages. • CIAddr? • CIArea • CIArea? • CIBlocks? • CIDelete? • CIList? • DCIDownLdPI • DCIDownLoad © National Instruments Corporation 3-53 GPIB-VXI User Manual...

  • Page 96: Ciaddr

    StatusState?) can be used to retrieve the equivalent information for a CI. The CIDelete query deletes a CI. The amount of RAM reserved for all CIs is set by the GPIB-VXI, depending upon its nonvolatile configuration, the amount of RAM installed, and the use of the command CIArea. The CI RAM area is partitioned into blocks of 4K.

  • Page 97: Ciarea

    (<RAM size> - <Base Address>) / 1000h For example, if the GPIB-VXI is configured with 512K (80000h) of RAM, and <New Base Address> is 70000h, the maximum allowed value for <Number of blocks> is given by the following formula: (80000h - 70000h)/ 1000h = 10h = 16 If <Number of blocks>...

  • Page 98: Ciblocks

    <r0start> - <r0stop>, <r1start> - <r1stop>, . . .,<r N -1start> - <r N -1stop><CRLF> where <rMstart> and <rMstop> are the start and stop block numbers for the Mth occupied memory region. GPIB-VXI User Manual 3-56 © National Instruments Corporation...

  • Page 99: Cidelete

    <error code> and <hex error code> can be interpreted by converting them to a binary bit pattern. A value of 1 in any bit position indicates that the error shown in the following table occurred during the attempt to delete the CI: © National Instruments Corporation 3-57 GPIB-VXI User Manual...

  • Page 100: Cilist

    Any error encountered is unrecoverable in the sense that the CI is not restored. Any further attempts to communicate with it will have undetermined results, and may adversely affect the behavior of the GPIB-VXI. CIList? Purpose: Get a list of logical addresses for CIs running on the GPIB-VXI. Query Syntax: CIList? Response: Program response: <ci la1>,<ci la2>, .

  • Page 101: Dcidownldpi

    The DCIDownLdPI command should always be immediately preceded by a DCISetupPI? command that configures the download parameters. Executing intermediate GPIB-VXI commands between DCISetupPI? and DCIDownLdPI may invalidate the download setup. Example: Download and initialize a PI DCI, generating debug statements.

  • Page 102: Dcidownload

    The DCIDownLoad command should always be immediately preceded by a DCISetup? command that configures the download parameters. Executing intermediate GPIB-VXI commands between DCISetup? and DCIDownLoad may invalidate the download setup. Example: Download and initialize a DCI, generating debug statements.

  • Page 103: Dcisetup

    <start block>, <number of blocks>, <stack size>, [, <servant1>, [<servant2>,..., <servant N >]] The DCISetup? query provides the GPIB-VXI with the information it needs to prepare for executing a DCIDownLoad command. This command is provided as a separate operation from the DCIDownLoad command so that the download parameters can be validated before the object code download is initiated.

  • Page 104: Dcisetuppi

    <dynamic RAM size>, <stack size>, [, <servant1>, [<servant2>,..., <servant N >]] The DCISetupPI? query provides the GPIB-VXI with the information it needs to prepare for executing a DCIDownLdPI command. This command is provided as a separate operation from the DCIDownLdPI command so that the download parameters can be validated before the object code download is initiated.
  • Page 105 2 and commander of device at logical address 50. Set up to download up to 10000 bytes of code and data to a pSOS dynamic memory segment, and allocate a 2048-word stack. DCISetupPI? #hC0,0,10000,#h800,50 © National Instruments Corporation 3-63 GPIB-VXI User Manual...

  • Page 107: Nonvolatile Configuration

    The EEPROM is connected to the microprocessor via a serial bus. Because it takes from five to ten seconds to write the contents of the memory, the GPIB-VXI creates a copy of the contents of the EEPROM in RAM, which can be quickly edited. When the editing is complete, the entire contents of the RAM copy can be written back at once to the EEPROM.

  • Page 108: The Gpib-Vxi Nonvolatile Configuration Main Menu

    This can be accomplished by the pROBE commands IN or BO, by resetting the system, or by cycling the system power. The GPIB-VXI Nonvolatile Configuration Main Menu When you enter the NV configuration mode, the GPIB-VXI displays the menu shown in Figure 4-1. GPIB-VXI Nonvolatile Configuration Main Menu (C) 1989...
  • Page 109 Region 1 Size : 0x060000 Number Procs : 0x20 Number Exchgs : 0x20 Number Msgs : 0x180 VXI Interrupt Level to Handler Logical Address (0xFF = free to assign) 1:0xFF 2:0xFF 3:0xFF 4:0xFF 5:0xFF 6:0xFF 7:0xFF A24 Assign Base: 0x200000...

  • Page 110: Change Configuration Information

    For the pSOS configuration parameters, the GPIB-VXI prints a formula for calculating an appropriate value for each parameter if you type in 0 in response to the prompt requesting the value.

  • Page 111: Set Configuration To Factory Settings

    NV memory to the default (original) factory settings. Notice that only the RAM copy is affected. The NV memory must be written back using the Write Back (Save) Changes command in the main menu to retain the changes after the GPIB-VXI has been reset or powered-down.

  • Page 113: Diagnostic Tests

    Diag command. Diagnostic execution is controlled through a terminal connected to the serial port. Configuration for Diagnostic Testing The diagnostic tests require the GPIB-VXI to be disconnected from all other GPIB devices to prevent interference with the GPIB tests. Diagnostic Test Structure A total of 126 diagnostic routines, or steps, are organized as nine tests, as shown in Table 5-1.

  • Page 114: Diagnostic Test Description

    Diagnostic Tests Chapter 5 Each test is designed to verify that a specific part of the GPIB-VXI circuitry is functioning correctly. The diagnostic steps can be invoked individually or as test groups. Diagnostic Test Description The EPROM Test The EPROM test performs a checksum on the EPROM to verify that it is not corrupted.

  • Page 115: The Dma Test

    The 68881 Coprocessor Test The 68881 Coprocessor test tests the numeric coprocessor operation. If the 68881 is not installed, the GPIB-VXI skips this test. Diagnostics Mode Selection Three hierarchical levels of menus control execution of the diagnostic tests. The highest-level menu is the Diagnostics Mode menu, which you can use to select whether to execute a test group or step group, and the mode in which to run them.

  • Page 116: Table 5-2. Diagnostics Mode Menu Option Descriptions

    You can recall the last error at any time (before the module is powered-down or restarted) with the r selection. The last detected error is retained even if the diagnostics mode is exited and re- entered. This is a convenient feature that you can use under these conditions: GPIB-VXI User Manual © National Instruments Corporation...

  • Page 117: Diagnostic Test Selection

    Enter Your Selection Figure 5-2. The Diagnostic Test Selection Menu If you specify the Selection option, the GPIB-VXI prompts you to select which tests or steps to execute with the lowest level menu. When you select the tests or steps, the GPIB-VXI begins executing the selected diagnostics. The diagnostics run until an error is encountered when abort-on-error is enabled;...

  • Page 119: Appendix A Specifications

    One 9-pin DSUB connector for RS-232 Operating Environment Component temperature 0° to 70° C Relative humidity 0% to 95% noncondensing Emissions FCC Class A Storage Environment Temperature -40° to 85° C Relative humidity 0% to 100% noncondensing © National Instruments Corporation GPIB-VXI User Manual...

  • Page 121: Appendix B Error Codes

    No device is at that logical address Device GPIB secondary address is out of range 0 through 30 Device VXI interrupt handler number is out of range 1 through 3 Device VXI interrupt level is out of range 0 through 7 Device...
  • Page 122 Logical address is out of range Block(s) requested are used Block(s) requested do not exist Servant(s) requested do not exist Servant(s) requested are not servants of the GPIB-VXI or another DCI Commander requested does not exist Servant(s) requested do not have the same commander...
  • Page 123 Type Description Memory requested for DCI Word Serial structures is unavailable Logical address referenced is not the GPIB-VXI or local DCI Logical address referenced is not GPIB-VXI's or CI's servant Stack size requested for worker process exceeds FFFFh words © National Instruments Corporation...

  • Page 125: Appendix C Code Instrument Overview

    • Creating a Message-Based interface for Register-Based or non-VXI devices A CI is more than a CPU process that replaces another VXI device's communication path; it has all of the capabilities of a physical Message-Based commander. These capabilities include the following: •...

  • Page 126: Gpib-Vxi Operation Without Cis

    Message-Based devices. Although the GPIB and serial controllers are not commanders of the command parser in the VXI sense, they are its master in the sense that it will respond to their commands as if they were its commander. The GPIB-VXI maintains independent control paths to the local command set parser from the GPIB, the serial controller, and the GPIB-VXI's commander.
  • Page 127 VXIbus Peek Word Serial and Poke Functions Commander Port VXIbus VXIbus Message Message Register Non-VXI Based Based Based Device Instrument Instrument Instrument Message Based Commander Servant Instrument Figure C-1. GPIB-VXI Operation Without Code Instruments © National Instruments Corporation GPIB-VXI User Manual...

  • Page 128: Ci Operation

    Figure C-2. Code Instrument Operation CI Operation A CI is a set of software routines that can perform the functions of a physical VXI Message- Based device. These CI capabilities are illustrated in Figure C-2. CIs coexist with the IEEE-488...

  • Page 129: Ci Characteristics

    Source or accept a trigger on any one TTL trigger line As with physical devices, a CI must be an immediate servant of the GPIB-VXI in order to have a GPIB secondary address assigned to it. In addition to these VXIbus device capabilities, CIs can also communicate directly with the local command set parser and the serial port.

  • Page 130: Downloaded Cis And Epromed Cis

    CDS 73A-852 adapter module Downloaded CIs and EPROMed CIs You can download CIs in the form of binary code into the GPIB-VXI's RAM. The downloaded modules are called Downloaded CIs, or DCIs. The CI Configuration local commands download and initialize CIs. You can use the DCI form to develop CIs without programming EPROMs, or to create disk-loadable CI applications.

  • Page 131: Using The Cds-852 Adapter Code Instrument

    852 requires special adapter software. The GPIB-VXI performs the Message-Based-to-852 communication translation with a CI. The GPIB-VXI B.1 firmware includes one 852 Position Independent CI. This CI implements the configuration and translation functions required to communicate with up to twelve 852 adapter modules via the GPIB.
  • Page 132 If fewer than six CIs are installed and no other secondary address links exist, the default value of 32 (0x20) is adequate. Increasing the number of processes affects the throughput of the GPIB- VXI. Enter the number of processes in hexadecimal. The next prompt is then displayed:...
  • Page 133 Number of message buffers = 100h + (25* # CI's) If fewer than six CIs are installed, the default value of 384 (180h) is adequate. Increasing the number of message buffers affects the throughput of the GPIB-VXI. Enter the number of message buffers in hexadecimal.

  • Page 134: Deleting A Ci

    CI mode to be compatible with the ASCII response format. If the expected response format is binary, the !!B command must be used to set the CI to the binary read mode. GPIB-VXI User Manual © National Instruments Corporation...
  • Page 135 Set the adapter CI read mode to binary. Command Syntax: Action: Sets the adapter CI read mode to binary. Read size is limited to 512 bytes, or as configured by the !!S command. © National Instruments Corporation GPIB-VXI User Manual...
  • Page 136 Enables read termination on an EOS with a value of <hex number>. If <hex number> is greater than FFh, the EOS termination condition is disabled. Examples: Set the EOS character to <CR> !!E 0D Disable EOS read termination. !!E 100 GPIB-VXI User Manual © National Instruments Corporation...
  • Page 137 Set the maximum size of a binary read. Command Syntax: !!S <size> !!s <size> <size> is a decimal value. Action: Sets the maximum binary read size to <size> bytes. The default value of the read size is 512 bytes. © National Instruments Corporation GPIB-VXI User Manual...
  • Page 138 Syntax: Action: Enables read termination when the END bit (bit 8) is set. Purpose: Disable read termination on the END bit. Command Syntax: Action: Disables read termination on the END bit (bit 8). GPIB-VXI User Manual © National Instruments Corporation...

  • Page 139: Gpib-Vxi Hardware And Software Configuration Form

    Appendix E GPIB-VXI Hardware and Software Configuration Form In the event that you have a technical problem, complete the following form and then call National Instruments for technical support. To complete the form, record the settings and revisions of your hardware and software on the line located to the right of each item. If you complete this form accurately, our applications engineers will be able to answer your questions efficiently.
  • Page 140 GPIB-VXI Hardware and Software Configuration Form Appendix E Other VXIbus Products Slot Manufacturer Model No. Function (such as A/D or DMM) Logical Address GPIB-VXI User Manual © National Instruments Corporation...

  • Page 141: Glossary

    Mode in which you can perform extensive offline diagnostic tests of the GPIB-VXI. Downloaded CI DCI; a form of CI that is downloaded into the GPIB-VXI's RAM memory. Dynamic configuration device DC device; a device that initially has a logical address of 255.
  • Page 142 GPIB-VXI. It is commercially available from Software Components Group, Inc. Query Similar to a command in that it also causes the GPIB-VXI to take some action, but it always returns a response containing data or other information. GPIB-VXI User Manual Glossary-2 ©...
  • Page 143 ID number, model code, memory space requirement, memory base address, and memory size. This table remains after the RM and general configuration operations are complete.

  • Page 145: Index

    Index Numbers 488-VXI system mode, 2-9 488-VXI system operation damage caused by Non-Slot 0-configured GPIB-VXI, 2-10 dynamic configuration operation description of, 2-15 to 2-16 GPIB secondary address assignment, 2-15 to 2-16 front panel LED indications for RM operation, 2-13 Non-Slot 0 message-based device...
  • Page 146 2-4 logical address and A24 address assignment for 852 adapter CI, D-4 primary address, setting, 2-4 AllHandlers? query, 3-35 ASCII system commands. VXI-defined common ASCII system commands AssgnHndlr command, 3-36 !!B command, D-5 Broadcast? query, 3-21 to 3-23 CDS-852 adapter CI.
  • Page 147 Cmdr? query, 3-12 CmdrTable? query, 3-13 code instruments. See CIs. commands. See 852 adapter CI; local command set. configuration. See 488-VXI system operation; GPIB-VXI configuration; local command set; nonvolatile configuration mode; system configuration. ConsMode command, 3-7 ConsoleEna command, 3-6 customer support, vii...
  • Page 148 Local Interrupt test, 5-2 overview, 5-1 RAM test, 5-2 self-test operation, 2-13 test structure, 5-1 VXI Configuration Register test, 5-2 DINF? command, 3-27 to 3-28 DIP Switch and Trigger test, 5-2 DLAD? command, 3-28 DMA test, 5-2 DNUM? command, 3-29...
  • Page 149 1-6 unpacking, 1-3 VXIbus and VMEbus capabilities, 1-3 GPIB-VXI configuration dual-ported memory size, setting description of, 2-7 switch settings (table), 2-7 factory configuration, 2-2 front panel reset operation, setting, 2-7 GPIB-VXI User Manual Index-5 © National Instruments Corporation...
  • Page 150 Index installed RAM size, setting description of, 2-5 GPIB-VXI CPU local and A24 memory ranges, 2-6 table of, 2-6 interrupt handler levels, setting, 2-8 logical address, setting, 2-4 parts locator diagram, 2-3 primary address, setting, 2-4 servant area size, setting, 2-5...
  • Page 151 CIDelete?, 3-57 to 3-58 CIList?, 3-58 DCIDownLdPI, 3-59 DCIDownLoad, 3-60 DCISetup?, 3-61 DCISetupPI?, 3-62 command and query responses, 3-3 command response format, 3-3 dynamic configuration commands and queries overview, 3-18 DCBNOSend, 3-19 DCGrantDev, 3-19 GPIB-VXI User Manual Index-7 © National Instruments Corporation...
  • Page 152 *RST, 3-41 *SRE, 3-41 *SRE?, 3-41 *STB?, 3-42 *TRG, 3-42 *TST?, 3-42 *WAI, 3-43 overview, 1-5, 3-1 query response format, 3-4 RM information queries overview, 3-10 A24MemMap?, 3-11 A32MemMap?, 3-12 Cmdr?, 3-12 © National Instruments Corporation Index-8 GPIB-VXI User Manual...
  • Page 153 A24?, 3-45 SYSRESET, 3-45 VXIbus interrupt handler configuration commands and queries overview, 3-35 AllHandlers?, 3-35 AssgnHndlr, 3-36 HandlerLine?, 3-37 RdHandlers?, 3-37 VXI-defined common ASCII system commands overview, 3-25 DCON?, 3-25 DINF?, 3-28 DLAD?, 3-28 DNUM?, 3-29 DRES?, 3-29 RREG?, 3-30...
  • Page 154 2-7 switch settings (table), 2-7 installed RAM size, setting description of, 2-5 GPIB-VXI CPU local and A24 memory ranges, 2-6 table of, 2-6 Non-Slot 0 message-based device configuration, 2-18 front panel LED indications for, 2-19...
  • Page 155 A32MemMap?, 3-12 Cmdr?, 3-12 CmdrTable?, 3-13 Laddrs?, 3-14 NumLaddrs?, 3-14 RMEntry?, 3-15 to 3-16 Srvnts?, 3-17 StatusState?, 3-17 RM operation, 2-14 RMEntry? query, 3-15 to 3-16 RREG? command, 3-30 *RST command, 3-41 GPIB-VXI User Manual Index-11 © National Instruments Corporation...
  • Page 156 2-19 to 2-20 operation, 2-21 switch and jumper settings, 2-20 Slot 0 Resource Manager configuration, 2-11 damage caused by Non-Slot 0-configured GPIB-VXI, 2-10 dynamic configuration operation, 2-15 to 2-16 GPIB secondary address assignment, 2-15 to 2-16 RM operation, 2-14 startup operation, 2-13...
  • Page 157 2-5 Slot 0 message-based device, 2-20 Slot 0 Resource Manager, 2-12 startup mode switch settings, 2-9 VXI system startup message settings, 2-11 See also jumper settings. SYSFAIL front panel LED, 2-13 SYSRESET command, 3-45 system configuration, 2-1...
  • Page 158 VXIbus capabilities, 1-3 VXIbus interrupt handler configuration commands and queries overview, 3-35 AllHandlers?, 3-35 AssgnHndlr, 3-36 HandlerLine?, 3-37 RdHandlers?, 3-37 VXI-defined common ASCII system commands overview, 3-25 DCON?, 3-25 DINF?, 3-27 to 3-28 DLAD?, 3-28 DNUM?, 3-29 DRES?, 3-29 RREG?, 3-30...
  • Page 159 User Comment Form National Instruments encourages you to comment on the documentation supplied with our products. This information helps us provide quality products to meet your needs. Title: GPIB-VXI User Manual Edition Date April 1990 Part Number: 320151-01 Please comment on the completeness, clarity, and organization of the manual.

Table of Contents