-----------------------------------------------------------------------
PAO-970331 for FreeBSD 2.2.1-RELEASE
Tatsumi Hosokawa <hosokawa@jp.FreeBSD.org>, Tokyo Japan
-----------------------------------------------------------------------

This package contains the PC-card device drivers, the manager daemon,
and the maintainance utilities for FreeBSD 2.2.1-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.jp.FreeBSD.org/PAO/

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

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

    *Note* If you want to install PAO package on a new laptop machine,
    or if you want to upgrade FreeBSD on your laptop machine, you can
    use PAO boot.flp to install FreeBSD and PAO package.  Installing
    PAO package by using PAO boot.flp is very easier compared to the
    way I described below.  Please read PAO webpage
    (http://www.jp.FreeBSD.org/PAO/) for details.

To install:

1. Extract this package at /usr/src

	# cd /usr/src
	# tar xvfz "package directory"/PAO-970331.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-970331/2.2.1-RELEASE/sys.patch

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

	# cd /usr/src/sys/i386/include
	# cp apm_bios.h clock.h scc.h 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 Toshiba Libretto 30.

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

	# cd /usr/src/PAO-970331/usr.sbin
	# make
	# make install
	# cd /usr/src/PAO-970331/sbin
	# make
	# make install

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-970331/2.2.1-RELEASE/etc/pccard.conf.sample is sample
	config file currently I'm using on my laptops.

	# cp /usr/src/PAO-970331/2.2.1-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-970331/2.2.1-RELEASE/etc/sysconfig /etc

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

	# cp /usr/src/PAO-970331/2.2.1-RELEASE/etc/rc.pccard /etc
	# cp /usr/src/PAO-970331/2.2.1-RELEASE/etc/pccard_ether /etc
	# cp /usr/src/PAO-970331/2.2.1-RELEASE/etc/pccard_ether_remove /etc

13. Edit /etc/sysconfig

	# vi /etc/sysconfig

TODO (Please help us!):

1. Multifunction cards.
2. 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> (for scc driver)
Yoshihisa NAKAGAWA <y-nakaga@ccs.mt.nec.co.jp> (for scc driver)
NetBSD/pc98 porting staff (for ncv/stg drivers)
Koichi Matsuda (for ncv/stg drivers)
Naofumi Honda (for ncv/stg drivers)
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>
	Atsushi Furuta <furuta@sra.co.jp> (for ncv/stg drivers)

And many alpha-testers....

Tatsumi Hosokawa
