FreeBSD 3.2-RELEASE PC Card Installer Tatsumi Hosokawa BSD-nomads team, Japan Contents -------- 1. What's this floppy? 2. PC Card Basics 3. The PAO distribution 4. How to installation of FreeBSD 4.1 Installation from the DOS partition 4.2 Installation from FTP 4.3 Install FreeBSD from CD-ROM and PAO from DOS or FTP 4.4 Configuration of the WIDE-DHCP client 5. After installation -------- 1. What's this floppy? == =================== The kernel and sysinstall of this floppy includes PAO PC Card package for FreeBSD. You can install FreeBSD with this floppy from various PC Cards (Ethernet, ATAPI CDROM, etc.). This floppy is based on FreeBSD 3.2-RELEASE and PAO-19990605. Therefore, supported cards are same as the cards supported by PAO-19990605. Please read http://www.jp.FreeBSD.org/PAO/index.html#card for details. PAO is a package that supports moble computing on FreeBSD. Part of old PAO packages have been incorporated into original FreeBSD souce tree, and now also the code in this package is waiting for integration. Part of codes in PAO has been less reviewed and it includes some experimental (pre-alpha level) codes that is not suited to be incorported into the original source tree at current status, but PAO is more useful and support more card compared to current FreeBSD PC Card suppot. 2. PC Card Basics == ============== To use this floppy, you have to know at least some basic ideas of PC Card architecture. PC Card uses I/O port, IRQ, and shared memory like many ISA devices, but the address and IRQ level are dynamically allocated by a special hardware called PC Card controller (or PC Card bridge). Each PC Card slot has eight memory windows, two I/O windows and a unnumbered IRQ line. PC Card controller maps these resources onto ISA or PCI space. PC Card can be controlled by CPU like ordinaly ISA devices because this mapping function works transparently. (All memory windows and I/O Window 1 are unused) +---------+ +------------+ / | |--------------------| |-----------/ ISA BUS | Modem | I/O Window 0 | PC Card | 3f8 - 3ff / | PC Card |--------------------| Controller |-----------/ | |<==================>| |<=========>/ +---------+ unnumbered IRQ +------------+ IRQ 3 / fig.1 Modem card is mapped as a serial chip on ISA bus To determine the value of these parameters, operating system uses "CIS (Card Information Structure) tupples" described in EEPROM memory in the cards. Operating system gets this information also via PC Card controller. PC Card controller requires 16 kilobytes of memory address for this purpose (it maps EEPROM memory onto this area). You can read these data by typing "/stand/pccardc dumpcis" from command prompt after the installation. A sample output of "/stand/pccardc dumpcis" follows. ----------------------------------------------------------------------- Tuple #6, code = 0x1b (Configuration entry), length = 16 000: e0 41 99 49 55 26 25 aa 60 f8 03 07 30 ff ff 28 Config index = 0x20(default) Interface byte = 0x41 (I/O) +RDY/-BSY active Vcc pwr: Nominal operating supply voltage: 5 x 1V Continuous supply current: 2 x 100mA Power down supply current: 2 x 10mA Card decodes 10 address lines, 8 Bit I/O only I/O address # 1: block start = 0x3f8 block length = 0x8 IRQ modes: Level IRQs: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Max twin cards = 0 Misc attr: (Audio-BVD2) (Power down supported) Tuple #7, code = 0x1b (Configuration entry), length = 7 000: 21 08 aa 60 f8 02 07 Config index = 0x21 Card decodes 10 address lines, 8 Bit I/O only I/O address # 1: block start = 0x2f8 block length = 0x8 ----------------------------------------------------------------------- fig.2 Sample CIS tupples (part of CIS in Megahertz XJ3288) This floppy uses 0xd0000-0xd3ffff for this scratch area by default, but if your hardware uses this area for other purposes, you can select another addresses (0xd4000, 0xd8000, and 0xdc000) from the first menu of this floppy. If you're uncertain of the detailed spec of your hardware, proceed without selecting optional values, and test other options after it causes any problems :-). 0xd0000 is appropreate value on most laptop hardware. There's another additional menu about PC Card in this floppy. The second menu is used to choose the free IRQ pool for PC Cards. PC Card requires a free IRQ that is not used by other devices. Operating system must manages free IRQ pool for this purpose. You can choose this free IRQ pool from the menu. The default is IRQ 10 and 11. Please note that there are some machines that have sound card which occupies IRQ 10 (and too bad that can't be probed by installation floppy, of course). If you have such machines, you can't use IRQ 10 for this purpose. IRQ 5 and 11 would be good alternative, but use IRQ 11 only if you have another devices which occupies IRQ 5. 3. The PAO distribution == ==================== ftp://daemon.jp.freebsd.org/pub/FreeBSD-jp/PAO/flp/3.2-RELEASE/paodist.tar contains the paobin and paosrc directory as bellow. 3.1 paobin The paobin tarball contains the PAO kernel, userland programs, man pages, and configuration files. drwxr-xr-x root/wheel 0 Jun 5 00:51 1999 paobin/ -rw-r--r-- root/wheel 240640 Jun 5 00:51 1999 paobin/paobin.aa -rw-r--r-- root/wheel 240640 Jun 5 00:51 1999 paobin/paobin.ab -rw-r--r-- root/wheel 240640 Jun 5 00:51 1999 paobin/paobin.ac -rw-r--r-- root/wheel 240640 Jun 5 00:51 1999 paobin/paobin.ad -rw-r--r-- root/wheel 240640 Jun 5 00:51 1999 paobin/paobin.ae -rw-r--r-- root/wheel 119771 Jun 5 00:51 1999 paobin/paobin.af -rw-r--r-- root/wheel 185 Jun 5 00:51 1999 paobin/paobin.inf -rwxr-xr-x toshi/wheel 519 May 21 04:34 1999 paobin/install.sh -rw-r--r-- root/wheel 4117 Jun 5 00:51 1999 paobin/paobin.mtree -rw-r--r-- root/wheel 464 Jun 5 00:51 1999 paobin/CHECKSUM.MD5 3.2 paosrc The paosrc tarball contains the kernel source codes (under sys directory) modified for PAO, and the PAO source kit (under PAO3 directory). PAO source kit contains the documents, such as PAO-FAQ and SUPPORTED.CARDS. Please read through these documents. Note: you need to install FreeBSD kernel source codes before installing paosrc, because paosrc contains only the files different from standard ones. drwxr-xr-x root/wheel 0 Jun 5 00:51 1999 paosrc/ -rw-r--r-- root/wheel 240640 Jun 5 00:51 1999 paosrc/paosrc.aa -rw-r--r-- root/wheel 240640 Jun 5 00:51 1999 paosrc/paosrc.ab -rw-r--r-- root/wheel 240640 Jun 5 00:51 1999 paosrc/paosrc.ac -rw-r--r-- root/wheel 233440 Jun 5 00:51 1999 paosrc/paosrc.ad -rw-r--r-- root/wheel 126 Jun 5 00:51 1999 paosrc/paosrc.inf -rwxr-xr-x toshi/wheel 357 May 13 13:09 1999 paosrc/install.sh -rw-r--r-- root/wheel 25742 Jun 5 00:51 1999 paosrc/paosrc.mtree -rw-r--r-- root/wheel 362 Jun 5 00:51 1999 paosrc/CHECKSUM.MD5 4. How to installation of FreeBSD == ============================== First, prepare the installation floppies. Get and write the floppy images. The pair of 1.44MB version is available at: ftp://daemon.jp.freebsd.org/pub/FreeBSD-jp/PAO/flp/3.2-RELEASE/kern.flp and ftp://daemon.jp.freebsd.org/pub/FreeBSD-jp/PAO/flp/3.2-RELEASE/mfsoot.flp 2.88MB version is available at: ftp://daemon.jp.freebsd.org/pub/FreeBSD-jp/PAO/flp/3.2-RELEASE/boot.flp 4.1 Installation from the DOS partition --- ----------------------------------- It seems that this is the easiest way to install. 4.1.1 Preparation of the stock FreeBSD distribution Get the FreeBSD 3.2-RELEASE distribution and put them under C:\FREEBSD\. 4.1.2 Preparation of the PAO distribution a) Get all the file under ftp://daemon.jp.freebsd.org/pub/FreeBSD-jp/PAO/flp/3.2-RELEASE/paobin/ and ftp://daemon.jp.freebsd.org/pub/FreeBSD-jp/PAO/flp/3.2-RELEASE/paosrc/ in C:\FREEBSD\PAOBIN\ and C:\FREEBSD\PAOSRC\, respectively. b) If you prefer getting one big file to multiple files, get the paodist.tar and extract it under C:\FREEBSD\. 4.1.3 Installation Select Media -> DOS 4.2 Installation from FTP --- --------------------- If you have your own FTP server, put the paobin and paosrc in the same directory as the FreeBSD distribution. 4.2.1 Selection of the distribution Exclude Distributions -> paobin, paosrc FreeBSD FTP site does not usually have the PAO distribution. Therefore, if you use the PAO Installation floppies, you will get an error that there was some distribution that you could not install. If you have your own FTP site and you have put the PAO distribution along with the FreeBSD distribution, you don't have to exclude the PAO distributions. 4.2.2 Installation of the FreeBSD distribution Start installation Media -> FTP -> FTP site If you got an error with the problem of 4.2.1 continue 4.2.4. If you excluded paobin and paosrc, you don't get any error and you will continue 4.2.3. 4.2.3 Select the PAO distribution Select Distributions -> paobin, paosrc 4.2.4 Install the PAO distribution (Option) -> Media -> FTP -> URL -> ftp://daemon.jp.freebsd.org/pub/FreeBSD-jp/PAO/flp Install the paobin and paosrc distribution with "Commit". 4.3 Install FreeBSD from CD-ROM and PAO from DOS or FTP --- --------------------------------------------------- While there is a number of ways to install PAO, you may think it useful if you can use a CD-ROM for installation. Actually, you can use CD-ROM for the PAO installation. 4.3.1 Preparation If you use CD-ROM and DOS partition, you need to prepare the PAO distribution (4.1.2). If you use CD-ROM and FTP, it is better to be able to use FTP and CD-ROM simultaneously. It should be possible to change the PC-CARD theoretically, but no one has tried. 4.3.2 Selection of the distribution Exclude Distributions -> paobin, paosrc The reason are discussed in 4.2.1. 4.3.3 Install the FreeBSD distribution Select Media -> CDROM and install the FreeBSD distribution at first. 4.3.4 Select the PAO distribution Distributions -> paobin, paosrc 4.3.5 Install the PAO distribution Change the media. (Option) -> Media -> DOS or (Option) -> Media -> FTP -> URL -> ftp://daemon.jp.freebsd.org/pub/FreeBSD-jp/PAO/flp Install the rest with "Commit". 4.4 Configuration of the WIDE-DHCP client --- ------------------------------------- You can use DHCP when you are installing with PAO installation floppies. +-----------------------------------------------------+ | Host: Domain: | | +--------------------+ +-----------------+ | | |hoehoe | | | | | +--------------------+ +-----------------+ | | Gateway: Name server: | | +----------------+ +-----------------+ | | | | | | | | +----------------+ +-----------------+ | | +------ Configuration for Interface xx0 ----+ | | | IP Address: Netmask: | | | | +-----------------+ +----------------+ | | | | |DHCP | | | | | | | +-----------------+ +----------------+ | | | | Extra options to ifconfig: | | | | +------------------------------+ | | | | |-r | | | | | +------------------------------+ | | | | | | | | +------+ +--------+ | | | | | OK | | CANCEL | | | | | +------+ +--------+ | | | +-------------------------------------------+ | +-----------------------------------------------------+ Mandatory: Put "DHCP" in the "IP Address" field. Specify dhcpc options instead of ifconfig options in the "Extra options to ifconfig" field. Currently available options are -r : overwrite /etc/resolv.conf -n : reconfigure the hostname Optional: Domain, Name Server. If the -r option to dhcpc is specified, DHCP overrides them. Ignored: Gateway, Netmask. *Notes* Please install wide-dhcp from packages before the installation is ended and reactivates. If you forget it, please use /stand/dhcpc. 5. After installation == ================== If you have selected non-default parameters for PC Card controller scratch memory or untouchable IRQ, please modify the following paramters manually (sorry, this can't be done automatically now). PC Card controller memory --> "pccardmem" in /etc/rc.conf IRQ's that cannot be used by PC Cards --> IRQ 5 "ignirq 5" in /etc/pccard.conf IRQ 10 "ignirq 10" in /etc/pccard.conf IRQ 1-9 "ignirq 1 2 3 4 5 6 7 8 9" in /etc/pccard.conf IRQ 1-10 "ignirq 1 2 3 4 5 6 7 8 9 10" in /etc/pccard.conf The FAQ list of PAO is refer to http://www.jp.FreeBSD.org/PAO/index.html#faq. Please read it before asking us about your problems. Many typical questions are answered in this file. You can found PAO package and information at PAO Webpage (http://www.jp.FreeBSD.org/PAO/) and PAO anonymous FTP server (ftp://daemon.jp.FreeBSD.org/pub/FreeBSD-jp/PAO/). The latest development snapshot version of PAO can be found at ftp://daemon.jp.FreeBSD.org/pub/FreeBSD-jp/PAO/snap/. If you have any problem with this version, please try to use these snapshots. Let's enjoy mobile computing with FreeBSD! # Add section 3 and 4: Toshihiko ARAI $Id: PAO3-install.hlp,v 1.6 1999/07/21 17:18:24 toshi Exp $