	ISA PnP utilities Installation
	==============================

Note that the --config option of pnpdump requires lspci.  This is a
program to dump the PCI resources used, and is suitable for 2.1.x
kernels on. You may obtain it as part of the pciutils package, from
sunsite, or atrey.karlin.mff.cuni.cz.

1) Edit the makefile to suit local conditions.
---------------------------------------------
Note that these will depend on your library versions. The
Makefile as supplied is for libc-5.4.44. If you have a newer
library, then some of the syscalls may already be provided
in the library, so remove the appropriate -D.
For example: If you get an error message such as

pnpdump.c:29: conflicting types for 'nanosleep'
usr/include/time.h:122: previous declaration of 'nanosleep'
make: *** [pnpdump.o] Error 1

then you need to remove the -DNEEDSNANOSLEEP from the PNPFLAGS
line in the Makefile. (This has already been done now, but
a similar comment applies to the other system calls added).

2) As anyone,
------------
make

to make the programs isapnp and pnpdump.

3) As root,
-----------
make install

or if you prefer, just make install.man or install.bin

4) Read the manual pages, particularly isapnp.conf.5.
-----------------------------------------------------

5) Run pnpdump to generate an isapnp.conf file:
-----------------------------------------------
pnpdump > /etc/isapnp.conf

pnpdump can optionally take up to two command line parameters,
see the manual page for details.

It can also take the option --autoconfig which makes it
attempt to produce a preconfigured configuration file,
see the manual page for details.

6) Edit the isapnp.conf file to place the device(s)
---------------------------------------------------
where your driver(s) expect. This is where step 4 would have
been useful.

The purpose of this step is to insert/correct the resource assignments
in the isapnp.conf file so that the ISA PnP devices are all configured
without their resource allocations conflicting with any other devices.

The comments below assume you ran pnpdump without the --autoconfig
flag. If you did, then you will need to check the allocations
don't conflict with existing hardware which wasn't in use at the
time you ran pnpdump.

a) All configuration information is commented out, so uncomment
the lines beginning with '# (' that you want to use.

b) If the resource data specified a range of values, then only
the first will be put in the config entry. This should be editted
to suit.

c) DON'T FORGET to uncomment the (ACT Y) at the end of the logical
device entry if you want the device enabled !

If you have a working Win95 setup, you might like to edit the
resource allocation while running Win95, so you can check the
resource allocation under My Computer -> Properties -> Device
Manager -> etc etc. See README.DOS.

To see what resources are already in use by the kernel, try
the following commands:

dmesg  | grep -i irq
cat /proc/interrupts

If you want to see what has been configured, without the noise
of the comments, grep out the comments etc thus:

cat isapnp.conf | grep -v '^#' | grep '[^ 	]' | less

where there is a tab and a space in the square brackets above.

7) Run isapnp
-------------
on the isapnp.conf file to check it has no errors.

8) Do whatever is necessary to initialise the device drivers:
-------------------------------------------------------------
run setserial, or insmod the drivers. Check they work.
Refer to the README, README.modules and README.ide for more details.

9) Edit the system bootup scripts
---------------------------------
to run isapnp and install the drivers etc as above.

10) Problems
------------
If you have any problems, please look at the isapnptools home
page at

http://www.roestock.demon.co.uk/isapnptools/

and read the FAQ available at

http://www.roestock.demon.co.uk/isapnptools/isapnpfaq.html

first. This has additional examples to the various READMEs
contained in the distribution, and pointers to other help
available.

11) How you can help others
---------------------------
If you have an example configuration file, or new hardware
drivers etc, which would be of assistance to others, don't keep
them to youselves, please send them, or pointers to them, to

isapnp@roestock.demon.co.uk

so that I can include them in the FAQ, thanks.

Peter Fox
25-May-98
