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