*BSD News Article 63085


Return to BSD News archive

Path: euryale.cc.adfa.oz.au!newshost.anu.edu.au!harbinger.cc.monash.edu.au!bunyip.cc.uq.oz.au!munnari.OZ.AU!news.hawaii.edu!ames!lll-winken.llnl.gov!venus.sun.com!wnoc-sfc-news!kogwy!hosokawa
From: hosokawa@mt.cs.keio.ac.jp (HOSOKAWA Tatsumi)
Newsgroups: comp.unix.bsd.freebsd.misc,comp.sys.laptops
Subject: [FreeBSD PCMCIA] pccard-test package 960308 now available!
Date: 9 Mar 1996 09:24:01 GMT
Organization: Tokoro Laboratory, Keio University, Yokohama Japan.
Lines: 309
Message-ID: <4hrinh$rjj@kogwy.cc.keio.ac.jp>
NNTP-Posting-Host: beretta.mt.cs.keio.ac.jp
Dnas-Posting-Host: guest1.plaza.hitachi-sk.co.jp
X-Newsreader: gn + gnspool [Version 1.31 OCT.1,1994 (Unix)]
Xref: euryale.cc.adfa.oz.au comp.unix.bsd.freebsd.misc:15089 comp.sys.laptops:56998

We release the new version of our pccard-test package (960308).  You
can get it from:

FTP

ftp://bash.cc.keio.ac.jp/pub/os/FreeBSD/alpha-test/pccard/pccard-test-960308.tar.gz

WWW homepage

http://www.mt.cs.keio.ac.jp/person/hosokawa/freebsd-pcmcia/

README file of this package follows:
-----------------------------------------------------------------------

PCMCIA card package for FreeBSD 2.1.0
Tatsumi Hosokawa <hosokawa@mt.cs.keio.ac.jp>, Yokohama Japan

This package contains the device drivers, the manager daemon, and the 
maintainance utilities for PCMCIA cards under FreeBSD 2.1.0-RELEASE.

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

Important Changes

1. PCMCIA Etherlink III driver is changed from 'ep' to 'nep'.  The new
   'nep' driver is based on NetBSD Etherlink III driver.  We choose
   this driver because it looks easier to be modified.

2. Added PIO mode support for 'ed' and 'sio'

3. Problems related to SIO_QDHACK have been solved.

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

I created a web page for this package.  The URL is,

     http://www.mt.cs.keio.ac.jp/person/hosokawa/freebsd-pcmcia/

If you want to know the "current" status of this page, please check it!

-----------------------------------------------------------------------
       The Current Status of "pccard-test" Package for FreeBSD

		      The cards we're working on
-----------------------------------------------------------------------
Type    Card                                    	Status	Driver
-----------------------------------------------------------------------
Ethernet
	3Com Etherlink III 3C589B			OK	nep
	3Com Etherlink III 3C589C			OK	nep
	Accton? UE2212					SLOW	ed
	Accton EN2212					SLOW	ed
	Farallon EtherMac				OK	nep
	Fujitsu FMV-J181				OK	fe
	IBM Creditcard Ethernet I			OK	ed
	IBM Creditcard Ethernet II			OK	ed
	NextCom J Link NC5310				OK	fe
FAX/Modem
	AIWA PV-JF288					OK	sio
	APEX DATA Mobile Plus V.34			OK	sio
	Fujitsu FMV-JMD712				OK	sio
	GATEWAY2000 MODEM				OK	sio
	Hayes OPTIMA 288 V.34				NG	sio
	IBM Push/Pop Modem				OK	sio
	Megahertz XJ1144				OK	sio
	Megahertz XJ2144				OK	sio
	Megahertz XJ2144J				OK	sio
	Megahertz XJ2288				OK	sio
	Megahertz XJ3288J				OK	sio
	NewMedia FAX/Modem 14.4K			OK	sio
	OMRON ME2814 Fax/Modem				OK	sio
	OMRON MD24XCA Fax/Modem				OK	sio
	PREMAX FM288					OK	sio
	Panasonic TO-CAF288				OK	sio
	TDK DF1414					OK	sio
	TDK DF1414EX					OK	sio
	US Robotics Sportster PCMCIA V.34		OK	sio
	US Robotics COURIER PCMCIA V.34			OK	sio
	Xircom CreditCard Ethernet+Modem (Modem only)	OK	sio *1
ISDN
	BUG Linkboy D64K				OK	sio
Digital Cellular
	NTT DoCoMo DATA/FAX Adapter			OK	sio
IRDA
	IBM PCMCIA Serial IR Adapter Card		NG	sio
SCSI
	Adaptec SlimSCSI APM-1460			OK	aic
	NewMedia BusToaster				OK	aic
	RATOC REX-5535AC				OK	spc
	RATOC REX-5535AMC				OK	spc
	RATOC REX-5535X					OK	spc
Flash ATA
	SunDisk SPD5-5					OK	wdc
	SunDisk SPD5-20					OK	wdc
	SunDisk SPD-40					OK	wdc
	Epson Flash Packer 5MB				OK	wdc
	Epson Flash Packer 20MB				OK	wdc
	Epson Flash Packer 40MB				OK	wdc
	Midori Elec. Fast Flash				OK	wdc
ATA HDD
	Maxtor MobileMax MXL131				OK	wdc
	Mitsubishi M6887-3 170MB			OK	wdc
-----------------------------------------------------------------------

		   The cards we're going to work on
-----------------------------------------------------------------------
Type    Card                                    	Status	Driver
-----------------------------------------------------------------------
Ethernet
	HITACHI HT-4840-11				NG	fe?
	Megahertz X-Jack Ethernet			NG	N/A
	RATOC REX-5585					NG	fe?
FAX/Modem, ISDN, Digital Cellular, IrDA
	All serial PCMCIA cards for PC/AT compatibles	NG	sio
Wireless LAN
	Proxim RangeLAN2				NG	N/A
FM-radio card
	Panasonic FM-text PCMCIA card			NG	sio
SCSI
	IBM PCMCIA SCSI					NG	N/A
	I/O Data PCMCIA SCSI				NG	N/A
	Ratoc REX-5565					NG	N/A
Multi Function Card
	3Com Etherlink III w/FAX Modem 3C562		NG	ep,sio
	Megahertz X-Jack Ethernet w/FAX Modem		NG	N/A,sio
-----------------------------------------------------------------------

*1 We don't want to support any Xircom PCMCIA cards because of their
   harsh policy against free software.  It only means a Xircom card
   works with this driver.

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

To install:

1. Extract this package at /usr/src

	# cd /usr/src
	# tar xvfz "package directory"/pccard-test-960308.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 < pccard-test-960308/sys.patch

4. Modify kernel config file for your environment

   /usr/src/sys/i386/conf/LEINLEIN is sample configuration file for my
   Digital Hinote 433SC

   * 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.

5. Create a symlink for compiling pccard package

	# ln -s /sys/pccard /usr/include

6. Compile your kernel

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

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

	# cd /usr/src/pccard-test-960308
	# cd usr.sbin/pccard/pccardd
	# make
	# make install BINDIR=/usr/sbin
	# cd ../pccardc
	# make install BINDIR=/usr/sbin
	# cp ./pccardc /usr/sbin

8. Create device files for your pccard slots

	# mknod /dev/card0 c 50 0
	# mknod /dev/card1 c 50 1

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

	pccard-test-960308/etc/pccard.conf.sample is sample config
	file currently I'm using on my laptop

	# cp /usr/src/pccard-test-960308/pccard.conf.sample /etc/pccard.conf
	
10. Replace /etc/rc

	# mv /etc/rc /etc/rc.orig
	# cp /usr/src/pccard-test-960308/etc/rc /etc

11. Install /etc/pccardstart and /etc/pccardether

	# cp /usr/src/pccard-test-960308/etc/pccardstart /etc
	# cp /usr/src/pccard-test-960308/etc/pccardether /etc

12. Edit /etc/sysconfig and specify apm_enable, pccard_enable,
    pccard_mem, and pccard_ether (the sample is
    /usr/src/pccard-test-960308/etc/sysconfig.sample)

If you find bug, please e-mail me (hosokawa@mt.cs.keio.ac.jp) about
it.  Patches are more welcome.  Please put "[pccard-test]" on the head
of the "Subject:" to pick it up easily.  Or if you can drive new card,
please send me the patches and pccard.conf.  Thanks!


Troubleshooting:

* This kernel hangs up when it probes APM BIOS.

  -> Some implementations of protected mode APM BIOS has serious bug.
     If you're a hacker, try to solve your problem by adding a new
     entry in /usr/src/sys/i386/include/laptops.h corresponding to
     your machine, and try to solve this problem.  If your problem is
     solved, please send us a report about your solution (and of
     course your environment).  If you're not hacker, boot the kernel
     with "kernel -c" and type simply "disable apm0" :-).

* Failed to probe PCMCIA FAX/Modem cards (or other serial cards) while
  the entries of /etc/pccard.conf seems to be correct.

  -> Case 1: Add a new entry in /usr/src/sys/i386/include/laptops.h
     corresponding to your machine and add SIO_IRQ_BUG or SIO_IRQ_BUG2
     in it (see DHULTRA and TP230 entry in laptops.h)

     Case 2: Specify explicitly the larger value of "reset" in the
     entry of /etc/pccard.conf (default is 100)

	card "OMRON Corp." "MD24XCA"
		config	0x23 "sio2" 16
		reset	10000

     Case 3: Specify the IRQ 16 at the corresponding entry in
     /etc/pccard.conf.  It forces serial driver to be in program I/O
     mode.  It produces less performance (you'll see many "slio
     overflow" message on your console) and higher overhead (polling
     routine is called 200 times per second when you're using
     FAX/Modem) in kernel mode.  I don't recommend this mode.

	card "Panasonic" "CF-JVR101" 
	       config 0x22 "sio3" 16	# IRQ 16 means PIO mode

* Failed to use NE-2000 compatible Ethernet cards while the entries of
  /etc/pccard.conf seems to be correct

  -> Some NE-2000 compatible Ethernet card has weired CIS tupples
     about the description of shared memory address (Accton EN-2212,
     etc.). Adding flags 0x10 at the corresponding entry of
     /etc/pccard.conf.  It diables the use of shared memory and force
     the driver to work in program I/O mode.

        card "ACCTON" "EN2212"
            config  0x1 "ed0" 11 0x10	# flags 0x10 means PIO mode
            ether   0xff0

     Please note that it makes the performance very poor.  Sometimes
     it works slower than the ISDN cards.


TODO (Please help us!):

1. Write documents such as "/etc/pccard.conf writer's guide" and "Plug'n 
   Play hotplug device drivers writer's guide"
2. Support Databook TCIC card controller.
3. Implement all PC-card functionalities (multiple memory window, etc.).
4. Make all drivers more stable.
5. This package is unstable, especially on Digital Hinote Ultra (We
   can't use Flash ATA on this machine, APM is unstable, etc.).


Special Thanks to....:

Andrew McRae <amcrae@cisco.com> (for the original pccard package)
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>
Other code contributors
	Atsuo Ohki <ohki@gssm.otsuka.tsukuba.ac.jp>
And many alpha-testers....

Tatsumi Hosokawa
--
	HOSOKAWA, Tatsumi              E-mail: hosokawa@mt.cs.keio.ac.jp
	  WWW homepage: http://www.mt.cs.keio.ac.jp/person/hosokawa.html
	Department of Computer Science, Keio University, Yokohama, Japan