[src/trunk]: src/distrib/notes/sandpoint Reworked preparation instructions an...

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

details:   https://anonhg.NetBSD.org/src/rev/487466e5ca74
branches:  trunk
changeset: 761638:487466e5ca74
user:      phx <phx%NetBSD.org@localhost>
date:      Thu Feb 03 21:04:52 2011 +0000

description:
Reworked preparation instructions and installation via altboot.

diffstat:

 distrib/notes/sandpoint/hardware |   8 +++--
 distrib/notes/sandpoint/install  |  52 +++++++++++++++++++++++++++++++++++----
 distrib/notes/sandpoint/prep     |  41 ++++--------------------------
 3 files changed, 57 insertions(+), 44 deletions(-)

diffs (144 lines):

diff -r 965d576e1335 -r 487466e5ca74 distrib/notes/sandpoint/hardware
--- a/distrib/notes/sandpoint/hardware  Thu Feb 03 20:37:09 2011 +0000
+++ b/distrib/notes/sandpoint/hardware  Thu Feb 03 21:04:52 2011 +0000
@@ -1,4 +1,4 @@
-.\"$NetBSD: hardware,v 1.10 2011/01/30 21:18:51 phx Exp $
+.\"$NetBSD: hardware,v 1.11 2011/02/03 21:04:52 phx Exp $
 .
 .Nx*M
 is a port based on Motorola's
@@ -73,6 +73,8 @@
 .
 .Ss2 824x NAS supported boot devices and media
 .Nx
-is booted by
+is booted using the
 .Pa altboot
-, which can load the kernel from NFS or from the local disk.
+bootloader, which can load the kernel via TFTP, from NFS or from the
+local disk. You will have to transfer the bootloader into memory by
+any means the firmware offers (serial upload, TFTP, Flash ROM).
diff -r 965d576e1335 -r 487466e5ca74 distrib/notes/sandpoint/install
--- a/distrib/notes/sandpoint/install   Thu Feb 03 20:37:09 2011 +0000
+++ b/distrib/notes/sandpoint/install   Thu Feb 03 21:04:52 2011 +0000
@@ -1,13 +1,34 @@
-.\"    $NetBSD: install,v 1.7 2011/01/30 18:04:41 phx Exp $
+.\"    $NetBSD: install,v 1.8 2011/02/03 21:04:52 phx Exp $
 .
-.Ss2 Prepare the NFS server
+.Ss2 Prepare the NFS or TFTP server
 .
 Set up an NFS server and copy the install kernel renamed into
 .Pa netbsd
-to its root partition.
+to its root partition. Optionally copy the kernel into your TFTP directory
+and make sure the
+.Pa tftpd
+service is running.
+.
+.Ss2 The altboot bootloader
+The
+.Pa altboot.bin
+binary file loads a
+.Nx
+kernel from the root partition of a local disk, from TFTP or from NFS.
+This bootloader binary should be made available by one of the following
+methods (depending on the firmware):
+.(bullet -compact
+TFTP server
+.It
+NFS server
+.It
+Serial line upload
+.It
+Flash ROM
+.bullet)
 .
 .Ss2 Booting the installer
-Depending whether the serial console is attached to the first or the
+Depending on whether the serial console is attached to the first or the
 second UART you will have to boot
 .Pa netbsd-INSTALL
 (1st UART at 0x4500)
@@ -17,8 +38,27 @@
 KuroBox and LinkStation systems are known to have the console on the
 second UART.
 .Pp
-Now boot the kernel by running
-.Pa altboot .
+In most cases your NAS will run
+.Tn "PPCBoot"
+or
+.Tn "U-Boot"
+as firmware. You can access its command line via the serial adapter cable.
+When auto-booting is enabled this will usually require to press a key
+quickly after the system was switched on.
+Then load the
+.Pa altboot.bin
+file into memory at
+.Pa 0x1000000
+and boot the installation kernel with
+.Pp
+.Dl > Ic "go 0x1000000 tftp:"
+.Pp
+for TFTP, or with
+.Pp
+.Dl > Ic "go 0x1000000 nfs:"
+.Pp
+when the kernel resides on NFS.
+.Pp
 The installation kernel will run
 .Pa sysinst
 from an internal memory disk image.
diff -r 965d576e1335 -r 487466e5ca74 distrib/notes/sandpoint/prep
--- a/distrib/notes/sandpoint/prep      Thu Feb 03 20:37:09 2011 +0000
+++ b/distrib/notes/sandpoint/prep      Thu Feb 03 21:04:52 2011 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.6 2011/01/30 18:04:41 phx Exp $
+.\"    $NetBSD: prep,v 1.7 2011/02/03 21:04:52 phx Exp $
 .
 To install
 .Nx \*V
@@ -8,37 +8,8 @@
 .Tn "MAX232"
 based) RS/232 cable to it, which you will
 connect to a terminal.
-The detailed procedure to build such a cable for your NAS system is not
-part of this documentation.
-.
-.Ss2 altboot
-The
-.Pa altboot.bin
-binary loads a
-.Nx
-kernel from the root partition of a local disk or from NFS.
-This file should be made available by one of the following methods
-(depending on the firmware):
-.(bullet -compact
-TFTP server
-.It
-Serial line upload
-.It
-Flash ROM
-.bullet)
-.Pp
-In most cases the Flash ROM of your NAS will contain
-.Tn "PPCBoot"
-or
-.Tn "U-Boot"
-as firmware. You have to find a way to get access to its command line.
-When auto-booting is enabled this will usually require to press a key
-quickly after the system is switched on.
-Then load the
-.Pa altboot.bin
-file into memory at
-.Pa 0x1000000
-and start it with
-.Pp
-.Dl > Ic "go 0x1000000"
-.Pp
+The procedure how to build such a cable for your NAS system is not
+part of this documentation. Please refer to
+.Lk http://www.NetBSD.org/ports/\*M/ttl2rs232.html
+for schematics and detailed instructions, if you wish to solder such an
+adapter cable yourself.