™ XVME Memory Monitor Copyright (c) Xycom Inc 1990-1993, 1997. All rights reserved. XVME CPU 655 Transfer type in bits 8 bits Byte order Little Endian ® Sustain VME bus lock Yes Address Modifier Supervisor XVME-983 MS-DOS Real/Protected mode transfer Real (window) XVME access type (for Real mode) STANDARD ADDRESS Memory address (hex) 2 Exit Enter the type of VME access _ Board Support Package 1 = SHORT I/O 3 = EPROM 2 = STANDARD ADDRESS 4 = EXTENDED ADDRESS � and � Change Selection Makes Selection Xycom Automation’s MS-DOS® Board Support Package is a comprehensive software package that simplifies the process of designing VMEbus application programs for Xycom Automation VME PC hardware in a MS-DOS environment. The package consists of example programs BENEFITS and 16-bit library routines used to Get a Comprehensive Package develop VMEbus programs. With the example programs and 16-bit library routines bundled FEATURES together, Xycom Automation’s MS-DOS Board Support Package is a Example programs � comprehensive solution for your VME board support needs. � 16-bit library routines for � VMEbus read and write routines Simple Configuration with DMA support The example programs, which use many of the library routines, provide � Dual-access memory management users with consolidated options for configuring VME systems. These functions example programs include all source code and make files. � Support for read-modify-write operations Save Development Time � Virtual memory mapping opera- The 16-bit library routines provide a collection of C language tion for VMEbus address space subroutines and header files, which allow users to get their applications � VMEbus interrupt generation up and running quickly by simplifying the design and implementation of routines applications for Xycom Automation VMEbus PC processors. The � Routines for handling VMEbus development time and effort required to handle VMEbus data and interrupts interrupts in applications are significantly reduced. � Supports � Analog I/O A Range of Modules Supported � Digital I/O The MS-DOS Board Support Package supports: XVME processor modules Digital I/O � Counter modules � � XVME-653 � XVME-200/290 Communication modules � XVME-654 � XVME-202 � All Legacy processors � XVME-656 � XVME-212 � XVME-658 � XVME-220 � XVME-659 � XVME-240 Analog I/O � XVME-244 � XVME-500/590 � XVME-260 � XVME-505/595 Counter modules � XVME-530 � XVME-203/293 � XVME-531 � XVME-230 � XVME-540 XVME boards supported with � XVME-542 MS-DOS drivers � XVME-560 � XVME-400/490 � XVME-564 � XVME-401/491 � XVME-566 DS-74983 B EXAMPLE PROGRAMS Example programs demonstrate the use of the library routines. All source code and make files are included. showmem.exe Read and write to or from the VMEbus with options to select different parameters easily. Results are displayed in a convenient window. vintmon.exe The VMEbus has seven levels of interrupts. This program aids in the setup and use of these interrupts with XVME processors. Source code for the program can be used to understand interrupt code. XVME Memory Monitor Copyright (c) Xycom Inc 1990-1993, 1997. All rights reserved. editmem.exe Perform VMEbus reads and writes. The program auto XVME CPU 655 Transfer type in bits 8 bits detects the type of Xycom Automation processor and Byte order Little Endian Sustain VME bus lock Yes configures the VME interface for the type of transfer. Address Modifier Supervisor The program also allows for short I/O (A16), standard Real/Protected mode transfer Real (window) XVME access type (for Real mode) STANDARD ADDRESS space (A24), and extended space (A32) reads and writes. Memory address (hex) 2 Exit Enter the type of VME access _ 1 = SHORT I/O 3 = EPROM 2 = STANDARD ADDRESS 4 = EXTENDED ADDRESS � and � Change Selection Makes Selection analog.exe Analog Boards Example Copyright (c) Xycom Inc 1990-1993, 1997. All rights reserved. Access and setup Xycom Automation I/O boards. This program can also confirm the Digital Boards Example XVME-500/590 correct hardware setup and opera- Copyright (c) Xycom Inc 1990-1993, 1997. All rights reserved. XVME-505/595 XVME-530 tion of analog I/O. Use the source XVME-531 Counter Boards Example XVME-540 code to build new applications. XVME-200/290 Copyright (c) Xycom Inc 1990-1993, 1997. All rights reserved. XVME-542 XVME-201 XVME-545 XVME-202 XVME-560 XVME-210 digital.exe XVME-564 XVME-212 XVME-566 XVME-203/293 XVME-220 Setup and access Xycom Automation EXIT XVME-230 XVME-240 EXIT XVME-244 digital I/O boards (2xx). XVME-260 EXIT � and � Change Selection Makes Selection counter.exe Setup and access Xycom Automation � and � Change Selection Makes Selection counter modules (2xx). � and � Change Selection Makes Selection LIBRARY ROUTINES The 983 software support library is a comprehensive set of 16-bit routines that simplify the development of VMEbus application programs. Simply link in the correct library routine when developing an application. All source code for library routines is provided so that each can be customized if needed. Routine Description AutoInitLib Determines which XVME-CPU module is being used and initializes the XVME SSL InitLib Initializes the XVME SSL for a particular XVME CPU model ReleaseVMEBus Releases the VMEbus from CPU control LockVMEBus Gains access to the VMEbus within the specified time Set_RM_Window* Maps the Real Mode Window to the desired VMEbus address space ReadVMEBusMemoryRM* Reads a block of memory on the VMEbus through the Real Mode Window WriteVMEBusMemoryRM* Writes a block of memory out on the VMEbus through the Real Mode Window ReadVMEBusMemoryPM* Reads a block of memory out on the VMEbus with the CPU in Protected Mode WriteVMEBusMemoryPM* Writes a block of memory out on the VMEbus with the CPU in Protected Mode SetIntVect Sets the desired IRQ (0-15) vector to point to the user defined interrupt handler ReadIntVect Returns the current interrupt vector for the desired IRQ (0-15) level Sends the appropriate mask to the slave 8259 interrupt controller to enable or disable the Mask8259 desired IRQ level Disables the AT Auxiliary Maskable Interrupts used for VME interrupt levels 1-7 and the dual DisableVMEInterrupts port interrupt Enables the AT Auxiliary Maskable Interrupts used for VME interrupt levels 1-7 and the dual port EnableVMEInterrupts interrupt SetNMIVect Sets the NMI vector to point to the user defined interrupt handler ReadNMIVect Returns the current NMI interrupt vector EnableNMIInt Enables the ANMI error conditions DisableNMIInt Disables the ANMI error conditions GenVMEBusInt Generates a VMEbus interrupt on the specified level EnableWDTimer Enables the Watchdog Timer DisableWDTimer Disables the Watchdog Timer StrobeWDTimer Retriggers the Watchdog Timer ResetWDTimer Resets the Watchdog Timer after it has timed out ClearXVMEInt Resets and disables all interrupts to the XVME and disables the INT in the 8259 GetCPUAttributes Returns the Xycom Automation CPU model number FindPCIDevice Reads the PCI bus space for PCI device IDs and vendor ID BIOSReadConfigByte Reads the BIOS PCI space in byte format BIOSReadConfigWord Reads the BIOS PCI space in word format BIOSReadConfigDword Reads the BIOS PCI space in long word format BIOSWriteConfigByte Writes the BIOS PCI space in byte format BIOSWriteConfigWord Writes the BIOS PCI space in word format BIOSWriteConfigDword Writes the BIOS PCI space in long word format UNIVReadConfigByte Reads the Universe chip's setup configuration in byte format UNIVReadConfigWord Reads the Universe chip's setup configuration in word format UNIVReadConfigDword Reads the Universe chip's setup configuration in long word format UNIVWriteConfigByte Writes the Universe chip's setup configuration in byte format UNIVWriteConfigWord Writes the Universe chip's setup configuration in word format UNIVWriteConfigDword Writes the Universe chip's setup configuration in long word format ATirqEOI Send a nonspecific EOI to the appropriate 8259 interrupt controller(s) FindUnivIRQ Returns the ATbus IRQ level to which the Universe's PCI interrupt is currently mapped GetIntMask Returns a bitmask representing the current state of the VMEbus and Auxiliary interrupt sources SetIntMask Sets the VMEbus and Auxiliary interrupt sources per the bitmask provided Enables the specified VMEbus or Auxiliary interrupt source(s) up to, but not including, the 8259 EnableIntSource interrupt controller Disable IntSource Disables the specified VMEbus or Auxiliary interrupt source(s) at the interrupt source ClearIntSource Clears the source(s) of the specified VMEbus or Auxiliary interrupts GetIntStatus Returns a bitmask showing which VMEbus and Auxiliary interrupt sources are currently being asserted AcknowledgeVMEbusInt Acknowledges the highest priority VMEbus interrupt and returns the interrupt level and IACK vector *Does not function on XVME-65X processors Digital I/O, Analog I/O, Counter I/O, Communication Driver, and Interrupt routines also are included. BOARD SUPPORT PACKAGE COMPONENTS Example User Defined Programs Programs Library Serial VMEbus Hardware ORDERING INFORMATION Standard Configurations Order Number Description XVME-983 MS-DOS Board Support Package Xycom Automation, Inc. Canada Sales 905-607-3400 ™ 734-429-4971  Fax: 734-429-1010 Northern Europe Sales +44-1604-790-767 http://www.xycomautomation.com Southern Europe Sales +39-011-770-53-11 © 2000 Xycom Automation, Inc. Specifications may change without notice. Xycom Automation is a trademark of Xycom Automation. Other brand or product names are the property of their respective owners.