[src/trunk]: src/distrib/notes/hpcarm First cut at INSTALL notes for NetBSD/h...

[tsutsui <tsutsui%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/75ef7a1decad
branches:  trunk
changeset: 765189:75ef7a1decad
user:      tsutsui <tsutsui%NetBSD.org@localhost>
date:      Sat May 21 07:09:09 2011 +0000

description:
First cut at INSTALL notes for NetBSD/hpcarm.
Mostly taken from hpcmips and hpcsh. Needs more improvements.

diffstat:

 distrib/notes/hpcarm/Makefile |    5 ++
 distrib/notes/hpcarm/hardware |  104 ++++++++++++++++++++++++++++++++++++++++++
 distrib/notes/hpcarm/install  |   42 ++++++++++++++++
 distrib/notes/hpcarm/legal    |    2 +
 distrib/notes/hpcarm/prep     |   12 ++++
 distrib/notes/hpcarm/upgrade  |    3 +
 distrib/notes/hpcarm/xfer     |    3 +
 7 files changed, 171 insertions(+), 0 deletions(-)

diffs (199 lines):

diff -r 974bc34a50d0 -r 75ef7a1decad distrib/notes/hpcarm/Makefile
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/hpcarm/Makefile     Sat May 21 07:09:09 2011 +0000
@@ -0,0 +1,5 @@
+#      $NetBSD: Makefile,v 1.1 2011/05/21 07:09:09 tsutsui Exp $
+
+MERGED_SRCS+=  ${COMMON}/upgrade ${COMMON}/xfer
+
+.include <bsd.man.mk>
diff -r 974bc34a50d0 -r 75ef7a1decad distrib/notes/hpcarm/hardware
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/hpcarm/hardware     Sat May 21 07:09:09 2011 +0000
@@ -0,0 +1,104 @@
+.\"    $NetBSD: hardware,v 1.1 2011/05/21 07:09:09 tsutsui Exp $
+.
+A H/PC machine contains a keyboard and a touch screen and
+generally has 32 MB or more of RAM.
+The port supports the HPC form factor,
+as well as the H/PC Pro and PsPC (Palmsized PC) form factors.
+More information can also be found at the
+.Nx*M
+homepage:
+.Lk http://www.NetBSD.org/ports/\*M/
+.Pp
+.
+.Ss2 Supported WindowsCE / Windows Mobile machines
+.(bullet -offset indent
+Hewlett-Packard / Compaq
+.(bullet -compact
+Jornada 720
+.It
+Jornada 728
+.It
+Jornada 820
+.It
+iPAQ H3600
+.bullet)
+Sharp / Willcom
+.(bullet -compact
+W-ZERO3 WS003SH
+.It
+W-ZERO3 WS004SH
+.It
+W-ZERO3[es] WS007SH
+.It
+Advanced / W-ZERO3[es] WS011SH
+.It
+WILLCOM 03 WS020SH
+.bullet)
+.bullet)
+.
+.Ss2 Supported WindowsCE devices
+.(bullet -offset indent
+CPUs
+.(bullet -compact
+StrongARM SA-1100
+.It
+StrongARM SA-1110
+.It
+XScale PXA270S
+.bullet)
+.It
+RAM requirements
+.(bullet -compact
+16 MB of RAM is required to run
+.Nx*M .
+32 MB is recommended for modern applications.
+.bullet)
+.It
+Console devices
+.(bullet -compact
+built-in LCD screen
+.It
+built-in keyboard
+.It
+serial port on Jornada (with boot option
+.Sq Li h )
+.bullet)
+.It
+Storage devices
+.(bullet -compact
+Flash ATA card, CF card (wd)
+.It
+Adaptec APA-1460[Slim SCSI](aic)
+.It
+Builtin SD card (including SDHC media) on W-ZERO3 machines (ld)
+.It
+USB mass storage devices on W-ZERO3 machines (umass)
+.bullet)
+.It
+Network interfaces
+.(bullet -compact
+PCMCIA MB8696x based Ethernet (mbe)
+.It
+PCMCIA NE2000-compatible Ethernet (ne)
+.It
+Misc USB network devices on W-ZERO3 (auc, cue, axe, kue etc)
+.It
+Misc USB wireless LAN devices on W-ZERO3 (rum, zyd)
+.It
+Internal wireless LAN on WS003SH and WS004SH (upgt)
+.bullet)
+.It
+Input devices
+.(bullet -compact
+Keyboard.
+.It
+USB keyboard on W-ZERO3 (ukbd)
+.It
+USB mice on W-ZERO3 (ums)
+.bullet)
+.It
+Miscellaneous
+.(bullet -compact
+Battery-backed real-time clock.
+.bullet)
+.bullet)
diff -r 974bc34a50d0 -r 75ef7a1decad distrib/notes/hpcarm/install
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/hpcarm/install      Sat May 21 07:09:09 2011 +0000
@@ -0,0 +1,42 @@
+.\"    $NetBSD: install,v 1.1 2011/05/21 07:09:09 tsutsui Exp $
+.
+To start installation, you have to put
+.Dq Pa netbsd
+kernel prepared in
+.Pa installation
+directory into some folder on
+.Tn Windows CE
+or
+.Tn Windows Mobile
+and boot it using bootloader
+.Pq Pa hpcboot.exe .
+On
+.Pa hpcboot
+window, you have to specify a folder where name your kernel is stored,
+your kernel name, and your machine type.
+You can also specify some options for debug.
+.Pp
+Once the installation kernel is loaded by
+.Pa hpcboot
+properly,
+.Ic sysinst
+will automatically start.
+.Pp
+The
+.Nx*M
+kernel and system install consume about 7 MB of memory.
+Please configure the
+.Tn "Windows CE"
+or
+.Tn "Windows Mobile"
+memory setting to allow this amount of memory to be used.
+If bootloader failed with a
+.Dq cannot allocate heap
+error, configure more RAM for memory and less for disk with the dialog at
+[Setting]-\*[Gt][ControlPanel]-\*[Gt][System]-\*[Gt][Memory] under
+.Tn "Windows CE"
+or
+.Tn "Windows Mobile" .
+.Pp
+.
+.so ../common/sysinst
diff -r 974bc34a50d0 -r 75ef7a1decad distrib/notes/hpcarm/legal
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/hpcarm/legal        Sat May 21 07:09:09 2011 +0000
@@ -0,0 +1,2 @@
+.\"    $NetBSD: legal,v 1.1 2011/05/21 07:09:09 tsutsui Exp $
+.
diff -r 974bc34a50d0 -r 75ef7a1decad distrib/notes/hpcarm/prep
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/hpcarm/prep Sat May 21 07:09:09 2011 +0000
@@ -0,0 +1,12 @@
+.\"    $NetBSD: prep,v 1.1 2011/05/21 07:09:09 tsutsui Exp $
+.
+First and foremost, before beginning the installation process,
+.Em make sure you have a reliable backup
+of any data on your Windows CE or Mobile
+memory and settings that you wish to keep.
+Sadly, there is no freely available program to accomplish this task,
+so you must use
+.Tn ActiveSync
+or another commercially available program to backup your
+Windows CE or Mobile machine before installing
+.Nx*M .
diff -r 974bc34a50d0 -r 75ef7a1decad distrib/notes/hpcarm/upgrade
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/hpcarm/upgrade      Sat May 21 07:09:09 2011 +0000
@@ -0,0 +1,3 @@
+.\"    $NetBSD: upgrade,v 1.1 2011/05/21 07:09:09 tsutsui Exp $
+.
+.so ../common/upgrade
diff -r 974bc34a50d0 -r 75ef7a1decad distrib/notes/hpcarm/xfer
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/hpcarm/xfer Sat May 21 07:09:09 2011 +0000
@@ -0,0 +1,3 @@
+.\"    $NetBSD: xfer,v 1.1 2011/05/21 07:09:09 tsutsui Exp $
+.
+.so ../common/xfer