Help: ICE_DRIVERS_OSF
OSF ICE-DSP Driver Installation Notes
Load the ICE software tree onto the system. The environment symbol ICEROOT
should be defined pointing to root of this tree.
The driver source files are in the $ICEROOT/drv/osf directory.
To install the driver, follow these steps:
You should be in the $ICEROOT/drv/osf directory to run the config script.
1. To uninstall a previous driver, type:
./icepic remove
This removes the module from the system startup.
Then REBOOT the system. This is very important.
2. To make and install the new driver, type:
./icepic install
The script adds the path to the driver area to the file
/usr/sys/conf/BINARY.list and then throws it up in a vi editor
for you to delete any old icepic entries. There should only
be one line with the word icepic in it.
If successful, the driver is now installed, started and added to
the system startup for autostarting when the system is rebooted.
3. To start the driver without rebooting, type:
./icepic start
The driver is now installed. At boot time, the system will scan the PCI bus
and start the driver for each ICE-PIC card it finds. They will show up in the
/dev filesystem as /dev/ice/pic0[a-z], /dev/ice/pic1[a-z] ...
The multiple minor devices allow the driver to call a very important cleanup
routine when a process exits without cleaning up in a multi-user environment.
To address a device, the pic_open call needs only the major device number.
The pic_open call finds the next available minor device slot and opens the
appropriate /dev/ice/pic#* device. To specify the major device number,
the syntax DEVNO=# is preferred, but for backwards compatibility reasons,
the standard syntax like /dev/icepic# can also be used. In this case, the
major device number is the trailing character. The /dev/icepic# device will
not really exist.
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. An X-Midas macro and primitive are also
available to run more diagnostic tests on each card. See test/readme.txt.
X-Midas users should enter this name in the device name slot in the
hardware configuration 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,/dev/icepic0,,,IOM=xxx,
PIC2==ICEPIC,PCI-DEV,/dev/icepic1,,,IOM=xxx,
PIC3==ICEPIC,PCI-DEV,/dev/icepic2,,,IOM=xxx,
See HELP PIC_OPEN for hardware file setup details.