-----------------------------------------------------------------------
PAO-960731 for FreeBSD 2.1.5-RELEASE
Tatsumi Hosokawa <hosokawa@mt.cs.keio.ac.jp>, Tokyo Japan
-----------------------------------------------------------------------

This package contains the PC-card device drivers, the manager daemon,
and the maintainance utilities for FreeBSD 2.1.5-RELEASE.

(BTW, have 2.1.5-RELEASE already had PC-card and APM stuff?  Yes.
 Part of OUR package has been incorporated into 2.1.5-RELEASE, but
 this code and /etc files are based on former version of our package,
 and the integration and documentation is still incomplete.  That's
 why we release the new package for latest snapshot release.)

-----------------------------------------------------------------------
			      Attention

This package is alpha-test package.  If you use this package, please
report to <hosokawa@jp.FreeBSD.org> if possible, whether it works or
not, what environment you're using, what problem has happened, how to
avoid this probem, etc.  Patches are more welcome.  Please put "[PAO]"
on the head of the "Subject:" to pick it up easily.  If you can drive
new cards, please send me the patches and pccard.conf.  Thanks!
-----------------------------------------------------------------------

The URL of PAO homepage is,

     http://www.mt.cs.keio.ac.jp/person/hosokawa/PAO/

If you want to know the "current" status of this package, please visit
here.

-----------------------------------------------------------------------

To install:

1. Extract this package at /usr/src

	# cd /usr/src
	# tar xvfz "package directory"/PAO-960731.tar.gz

2. Backup original /sys file if needed

	# cd /usr/src
	# mkdir sys.ORG
	# cd sys.ORG
	# (chdir ../sys ; tar cf - .) | tar xvf -

3. Apply kernel-patch to kernel source tree

	# cd /usr/src
	# patch -p0 < PAO-960731/2.1.5-RELEASE/sys.patch

4. Copy new laptops.h, pccard.h, clock.h to /usr/include/machine

	# cp /usr/src/sys/i386/include/laptops.h /usr/include/machine
	# cp /usr/src/sys/i386/include/pccard.h /usr/include/machine
	# cp /usr/src/sys/i386/include/clock.h /usr/include/machine

5. Copy new pccard/*.h to /usr/include/pccard

	# cp /usr/src/sys/pccard/*.h /usr/include/pccard

6. Modify kernel config file for your environment

   /usr/src/sys/i386/conf/PAO is sample configuration file I'm using
   on Digital Hinote Ultra II.

   * Don't remove "controller crd0" and "device pcic0" !

	# cd /usr/src/sys/i386/conf
	# cp LEINLEIN "your config file name"
	# vi "your config file name"

    For some particular machines such as Digital Hinote, ThinkPad
    230Cs, etc. we prepared specific "options".  If your machine is
    one of them, please uncomment the corresponding line.

7. Compile your kernel

	# config "your config file name"
	# cd ../../compile/"your config file name"
	# make depend
	# make
	# make install

8. Compile the manager daemon and the utility and install them

	# cd /usr/src/PAO-960731
	# cd usr.sbin/pccard/pccardd
	# make
	# make install BINDIR=/usr/sbin
	# cd ../pccardc
	# make
	# make install BINDIR=/usr/sbin

9. Create device files for your pccard slots and APM BIOS

	# cd /dev
	# sh MAKEDEV card0
	# sh MAKEDEV card1
	# sh MAKEDEV card2
	# sh MAKEDEV card3
	# sh MAKEDEV apm

10. Install PC-card configuration file and modify it for your
    environment

	PAO-960731/2.1.5-RELEASE/etc/pccard.conf.sample is
	sample config file currently I'm using on my laptops.

	# cp /usr/src/PAO-960731/2.1.5-RELEASE/etc/pccard.conf.sample /etc/pccard.conf
	
11. Modify /etc/sysconfig (please read FAQ).

	# cd /etc
	# mv sysconfig sysconfig.orig
	# cp /usr/src/PAO-960731/2.1.5-RELEASE/etc/sysconfig /etc

12. Install /etc/rc.pccard, /etc/pccard_ether and /etc/pccard_ether_remove

	# cp /usr/src/PAO-960731/2.1.5-RELEASE/etc/rc.pccard /etc
	# cp /usr/src/PAO-960731/2.1.5-RELEASE/etc/pccard_ether /etc
	# cp /usr/src/PAO-960731/2.1.5-RELEASE/etc/pccard_ether_remove /etc

13. Edit /etc/sysconfig

	# vi /etc/sysconfig

TODO (Please help us!):

1. Qlogic SCSI driver.
2. Future Domain SCSI driver.
3. Multifunction cards.
4. Unstability problems of serial cards on particular machines.
5. Patches to if_ed.c for some quasi-compatible cards (ex. Socket EA 
   Ethernet).
6. Cooperative operation between APM and PC-card driver.

List of Companies that donated their hardware to our project:
* Sumitomo Shouji Co. donated Yamaha Infoshuttle ISDN card.
* Planet Japan Co. donated PCMCIA Ethernet card Smart COM 3500.

List of Companies that gave us information about their products:
* Contec Co. gave us datasheet of Ethernet card C-NET(PC).
* IBM Japan Co. gave us datasheet of IBM King PCIC Chip.
* Yamaha Co. gave us hardware information about Infoshuttle ISDN 
  card.

I'm thankful to these companies for their help and support to our
project.


Thanks to:

Andrew McRae <amcrae@cisco.com> (for the original pccard package)
Nate Williams <nate@sri.MT.net>
Atsuo Ohki <ohki@gssm.otsuka.tsukuba.ac.jp>
Gardner Buchanan <gbuchanan@shl.com> (for sn driver)
Jim Binkley <jrb@cs.pdx.edu> (for wlp driver)
Members of BSD-nomads Mailing List
	Especially,
	Naoki Hamada <nao@tom-yam.or.jp> (for ep driver)
	Hidetoshi Kimura <h-kimura@tokyo.se.fujitsu.co.jp> (for aic driver)
	T. Matsutsuka <matsu@cs.titech.ac.jp> (for spc driver)
	Hidetoshi Kimura <h-kimura@tokyo.se.fujitsu.co.jp> (for fe driver)
	DOTEGUCHI Masahiro <xdote@rp.open.cs.fujitsu.co.jp> (for pccard daemon)
	Akihiro Hirano <hirano@dsp.cl.nec.co.jp>
	Kunikazu Yoda <yoda@ais.kudpc.kyoto-u.ac.jp>
	Toshihisa Eto <eto@ai.cs.fujitsu.co.jp>
	Hajimu UMEMOTO <ume@iabs.hitachi.co.jp>
	KUROSAWA Takahiro <kurosawa@sail.t.u-tokyo.ac.jp>
	ODA, Kazutoshi <okaz@yggdrasil.forus.or.jp>

And many alpha-testers....

Tatsumi Hosokawa
