Help: ICE_DRIVERS_VMS

VMS ICE-DSP Driver Installation Notes


Load the ICE software tree onto the system.  The logical ICEROOT should be 
defined pointing to root of this tree.  

  $assign/trans=conc DKA100:[ICExxx.] ICEROOT

The higher level driver utilities, located in the ICELIB.C file, operate in 
the user's context.  These functions are shared between VMS, OSF, SUN, Linux, 
and WNT.  The user will be making all calls to the driver through this 
interface.  

The driver is located in the [.DRV.VMS] area of the ICE option tree.
It should be left in this area to insure that it is in sync with the higher 
level driver routines in the ICELIB.C file.  The driver uses IOC$ routines
to access the PCI bus to insure hardware independence and should run on all 
DEC AXP platforms.

The command procedures BUILD.COM, CONFIG.COM, and CONNECT.COM are provided 
to automate the building and installation of the driver.  

To build the driver and utilities, type:

  > set default ICEROOT:[drv.vms]
  > @build

To see if any cards are recognized on this system (without connecting), you 
must enable CMKRNL and PHYS_IO privileges. Then, type:

  > @config

To connect all of the recognized devices, you must enable CMKRNL and PHYS_IO 
privileges. Then, type:

  > @connect

The devices will be installed with the names ICA0, ICB0, ICC0, ...

On clustered systems, it may be desirable to specify unique device names
for each node in the cluster.  If you wish to change the sequence of the 
device names, specify the list as the first argument to the @connect 
procedure.  Only the # in IC#0 may be changed.

  > @connect "ICF0,ICG0,ICE0"

The devices will be installed with the names ICF0, ICG0, ICE0, ...

To exercise the cards, use the mid-level driver libraries in the LIB area of
this software tree.  A small test program in the TEST area may be used to run
a series of tests on the card. To build and run the test routine:

  > set default ICEROOT:[TEST]
  > @build.vms
  > test

An X-Midas macro and primitive are also available to run diagnostic tests on 
each card.

X-Midas users should enter this name in the device name slot in the
hardware config table as shown in the examples below:  

  PIC1==ICEPIC,DEVNO=0,IOM=xxx, 
  PIC2==ICEPIC,DEVNO=1,IOM=xxx, 
  PIC3==ICEPIC,DEVNO=2,IOM=xxx, 
or
  PIC1==ICEPIC,PCI-DEV,ICA0:,,,IOM=xxx, 
  PIC2==ICEPIC,PCI-DEV,ICB0:,,,IOM=xxx, 
  PIC3==ICEPIC,PCI-DEV,ICC0:,,,IOM=xxx, 

See HELP PIC_OPEN for hardware file setup details.

VMS 7.3 ISSUES:  TBD