updated installation tips

[Izumi Tsutsui <tsutsui%ceres.dti.ne.jp@localhost>]

Several updates per comments from nonaka@ etc:
- lack of "insmod -f zbsdmod.o" in "To boot the pre-installed image on C700"
- /mnt/card and /mnt/cf are also available normal kernels (via symlinks)
  so consistently use them
- mention new netbsd-INSTALL_C700 kernel
- simply use cp to boot install kernel
- explicit zboot example to boot GENERIC instead
- note about `-1' boot option for serial console

More comments/updates/xml'fy/mdoc'fy etc. are welcomed.
(as draft of install notes and www docs :-)


--- how to use pre-installed image ---

For easy trial of NetBSD/zaurus, I've also built and put
a pre-installed NetBSD/zaurus 1GB SD image:
ftp://ftp.NetBSD.org/pub/NetBSD/misc/tsutsui/zaurus/ 

This pre-installed image includes all necessary files
(bootloaders in FAT, all NetBSD binaries in FFS partition) and
you can write this image to 1GB SD by gunzip(1) + dd(1) on NetBSD
(and other UNIX like OSes), or Rawrite32 utility on Windows:
http://www.NetBSD.org/~martin/rawrite32/index.html

To boot the pre-installed image on C700:
- boot maintenance kernel and login root
 ---
 # cd /mnt/card
 # insmod -f zbsdmod.o
  (note you can ignore version mismatch warning)
 # ./zboot
 (press space to abort autoboot)
 > boot netbsd.c700
 ---

To boot on C750/760/860/1000/3x00:
- boot Zaurus Linux
- exec some terminal
 ---
 $ su
 # cd /mnt/card
 # insmod -f zbsdmod.o
  (note you can ignore version mismatch warnings on C7x0/860)
 # insmod -f zbsdmod.o
 # ./zboot
 ---


--- installation tips ---

For usual installation, there is no INSTALL docs (yet)
but here is an updated installation tips:

Notes on C700:
- C700 requires a special kernel due to zbsdmod.o constraints
 - netbsd-INSTALL_C700 for installation
 - kern-C700.tgz instead of kern-GENERIC.tgz
   (sysinst selects an appropiate kernel set per INSTALL kernel name)
- you have to use maintenance kernel to boot NetBSD/zaurus
  (probably due to memory restriction)

Preparations:
- fetch NetBSD-current snapshot binaries
  http://nyftp.NetBSD.org/pub/NetBSD-daily/HEAD/
- Copy following files to SD or CF
  <releasedir>/zaurus/installation/zboot
  <releasedir>/zaurus/installation/zbsdmod.o
  <releasedir>/zaurus/installation/kernel/netbsd-INSTALL_C700 (for C700)
  <releasedir>/zaurus/installation/kernel/netbsd-INSTALL      (for others)

- Note SD driver on Zaurus Linux has a bug and it can't handle 2GB SD
  (note NetBSD/zaurus -current supports both 2GB SD and >2GB SDHC)
  so you have to use 1GB SD on bootstrap
- To use SDHC and 2GB SD on Zaurus Linux for bootstrap, you can use
  custom Zaurus Linux drivers:
  http://petit-noise.net/download/sdhc-driver
  but there is no way to use >1GB SD on maintenance kernel 

Installation:
- boot Zaurus Linux     (on C750/760/860/1000/3x00)
  or maintenance kernel (on C700)
- install and start some terminal emulater on it
   http://www.users.on.net/~hluc/myZaurus/
   or
   
http://sea-bird.org/pukiwiki/index.php?Zaurus%2F%A5%BF%A1%BC%A5%DF%A5%CA%A5%EB%A5%BD%A5%D5%A5%C8
 (for Japanese users)
   might help  
   (not necessary on maintenance kernel)
- su root on shell prompt (not necessary on maintenance kernel)
   bash-2.05% su
- install zbsdmod.o LKM
   ---
   # cd /mnt/card (for SD) 
   # cd /mnt/cf   (for CF)
   # insmod zbsdmod.o    (on C1000/3x00)
   # insmod -f zbsdmod.o (on C7x0/860)
    (note you can ignore version mismatch warnings on C7x0/860)
   ---

- boot install kernel via zboot device prepared by zbsdmod.o
   ---
   # cp netbsd-INSTALL_C700 /proc/zboot (for C700)
   # cp netbsd-INSTALL /proc/zboot      (for others)
   ---
  then sysinst of NetBSD/zaurus install kernel will start
  as other NetBSD ports
   http://www.netbsd.org/docs/guide/en/index.html
- to fetch installation sets, you can use a CF disk, USB CD/DVD drives,
  or CF NICs

- to boot GENERIC kernel after install, zboot can load NetBSD/zaurus kernel
  from FFS partition by default, i.e. to boot GENERIC kernel as following:
   ---
   bash-2.05% su
   # cd /mnt/card (for SD) 
   # cd /mnt/cf   (for CF)
   # insmod zbsdmod.o    (on C1000/3x00)
   # insmod -f zbsdmod.o (on C7x0/860)
   # ./zboot
   
   >> NetBSD/zaurus Boot, Revision 1.2 (Sun Feb  5 00:40:00 JST 2012)
   
   disks: mmcd0* path*
   Press return to boot now, any other key for boot menu
   booting mmcd0a:netbsd - starting in 5
    :
   ---

Tips:
- as noted above, FAT on CF is mounted on /mnt/cf and SD is on /mnt/card
  on both normal Zaurus Linux and maintenance kernel
- NetBSD/zaurus kernel recognize booted device automatically
  if the kernel is loaded zboot
- on zboot, you can specify kernel on Linux local file system
  by using "path:" as a device name:
   ---
   # ./zboot
    (press space to abort auto boot)
   > boot path:/mnt/card/netbsd.old -s
   ---
- `-1' option flag on boot command makes loaded NetBSD/zaurus kernel boot
  with serial console

Have fun,
---
Izumi Tsutsui