IO/README - MVME147 System at sysV68 R3V5/R3V6
Kernel/Sysgen Installation Special Instructions
$Revision: 1.0 $


***********************
* Default Assignments *
***********************
 
    VCOM addresses start at 0xC0000000.
    Interrupt vectors start at 170.
    Bus Request interrupt level 5 is used.
    Standard installation will allow for up to 4 boards.
 
**************************
* Changes to the Default *
**************************
 
=>  MAKE ALL THE FOLLOWING CHANGES PRIOR TO RUNNING THE "INSTALL" OPTION
    AND BEFORE COMPILING THE DRIVER. 
 
1. Changing VCOM address.
 
   If a different address is desired, it must be changed in both
   "./mvme147/master.d/misc" and "./mvme147/master.d/vcom".
 
   The "misc" address must encompass the total range of address assignments,
   whereas each boards starting address is individually modified within "vcom".
 
2. Changing interrupt vector assignment.
 
   These are individually modified on a per board basis within
   "./mvme147/master.d/vcom".
 
3. Changing the Bus Request interrupt level.
 
   These are individually modified on a per board basis within
   "./mvme147/master.d/vcom".
 
4. The file "./mvme147/install/misc" must be added by hand to the SYSGEN's
   file contained in "/usr/src/uts/m68k/sysgen/descriptions/misc".  Resolve
   any addressing conflicts between the several Memory Config modules
   contained in this new 'misc' file.  We have occasionally found it necessary
   to turn off the config parameters for several Memory Configuration tables.
   The usual procedure for disabling is via the sysgen program.
 
   Don't forget that the VCOM Memory Config section MUST BE ENABLED! The
   command is 'sysgen -s misc'.
 
5. Change the number of default boards.
 
   We supply four PCB configuration files: vcc0, vcc1, vcc2, vcc3.  These
   are copied into the sysgen area and enabled during driver installation
   when the 'sbe-instal' script is executed.

   If a PCB configuration file is removed from the MODULES string contained
   within "./mvme147/master.d/sbe_instal", then it will not be installed
   in the kernel.

   You must create any additional "vcc" files if more than four PCBs are
   required.

   Each additional configuration file adds less then 64 bytes to the size
   of the kernel, as each additional entry over the first is only an addi-
   tional entry in the "cdevsw" table.  No overhead is added for servicing
   missing boards during execution of the VCOM Communications Package.


***********************
* GENERAL INFORMATION *
***********************

In this directory are some of the files which make up the vcom driver:

vc_hdrs.h - This file contains reference to various system header
    files which are specific to a particular system's Operating
    System.  These will vary according to the hardware platform as
    well as differences of OS release and component selection.

flush.c - If you are using caching on your CPU card, there are
    places in the code when you will need to flush the cache
    and fetch a fresh value from the memory in order for the shared
    memory routines to operate correctly.  The absense of this file
    may be an indication that your Operating System has these
    calls available, or that they are not required by your hardware.

    There are several macros within flush.c which may be called by the
    following macros:
             FLUSH_DATA_CACHE, FLUSH_READ_CACHE,
             FLUSH_WRITE_CACHE, FLUSH_VME_CACHE. 

    The macros are enabled by definition assignment within the file
    "include/sys/board.h".  If your CPU does not do caching, or if
    all the shared memory is offboard to the CPU, the macros may
    be null.

End-of-document.
