-----------------------------------------------------------------------
PAO-961020 for FreeBSD 2.2-961014-SNAP
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.2-961014-SNAP.

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

This package is alpha-test package.  If you use this package, please
report to <hosokawa@mt.cs.keio.ac.jp> 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-961020.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-961020/2.2-961014-SNAP/sys.patch

4. Copy new apm_bios.h, clock.h, and scc.h to /usr/include/machine

	# cd /usr/src/sys/i386/include
	# cp apm_bios.h clock.h scc.h /usr/include/machine

   If you want to use WaveLAN, please copy wavelan.h also.

	# cp wavelan.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 PAO "your config file name"
	# vi "your config file name"

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 (and
   replace apm(8) and shutdown(8) with new version)

	# cd /usr/src/PAO-961020
	# cd usr.sbin/pccard
	# make
	# make install
	# cd ../apm
	# make
	# make install
	# cd ../../sbin
	# cd shutdown
	# make
	# make install

   If you want to use WaveLAN, add -DWAVELAN option as the argument of
   cc when you compile pccardd.  Read Makefile of pccardd for details

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-961020/2.2-961014-SNAP/etc/pccard.conf.sample is
	sample config file currently I'm using on my laptops.

	# cp /usr/src/PAO-961020/2.2-961014-SNAP/etc/pccard.conf.sample /etc/pccard.conf
	
11. Modify /etc/sysconfig (please read FAQ).

	# cd /etc
	# mv sysconfig sysconfig.orig
	# cp /usr/src/PAO-961020/2.2-961014-SNAP/etc/sysconfig /etc

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

	# cp /usr/src/PAO-961020/2.2-961014-SNAP/etc/rc.pccard /etc
	# cp /usr/src/PAO-961020/2.2-961014-SNAP/etc/pccard_ether /etc
	# cp /usr/src/PAO-961020/2.2-961014-SNAP/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. Patches to if_ed.c for some quasi-compatible cards (ex. Socket EA 
   Ethernet).

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)
Takeshi OHASHI <ohashi@mickey.ai.kyutech.ac.jp> (scc driver)
Yoshihisa NAKAGAWA <y-nakaga@ccs.mt.nec.co.jp> (scc 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
