add a first batch of notes for beagle, still rough and far from complete,

but one should be able to get an xM booting with these instructions.

"throw them in, then we can fix." drahn@

8 files changed, 272 insertions, 0 deletions

diff --git a/distrib/notes/beagle/contents b/distrib/notes/beagle/contents
new file mode 100644
index 00000000000..4680bd5e213
--- /dev/null
+++ b/distrib/notes/beagle/contents
@@ -0,0 +1,22 @@
+dnl	$OpenBSD: contents,v 1.1 2011/03/22 18:33:51 jasper Exp $
+TopPart
+
+OpenBSDdistsets
+
+OpenBSDbsd
+
+OpenBSDrd
+dnl not yet...
+dnl OpenBSDcd
+
+DistributionDescription(eleven)
+
+OpenBSDbase(56389686,167758358)
+
+OpenBSDcomp(88675105,252176109)
+
+OpenBSDetc(525342,1595961)
+
+OpenBSDgame(2668047,5974672)
+
+OpenBSDman(9463622,34570289)
diff --git a/distrib/notes/beagle/features b/distrib/notes/beagle/features
new file mode 100644
index 00000000000..8efdb734f2a
--- /dev/null
+++ b/distrib/notes/beagle/features
@@ -0,0 +1,40 @@
+dnl	$OpenBSD: features,v 1.1 2011/03/22 18:33:51 jasper Exp $
+dnl
+dnl This file lists almost all the conditional features of this port,
+dnl which are used to provide accurate installation notes.
+dnl
+dnl Information about the installer script features should be in sync with
+dnl	src/distrib/beagle/install.md
+dnl and the list files in
+dnl	src/distrib/beagle/ramdisk/list
+dnl
+dnl ====
+dnl
+dnl architecture name (for the packages directory)
+define({:-MACHINE_ARCH-:},arm)dnl
+dnl
+dnl define if /sbin/kbd exists on the media
+define({:-MDKBD-:},)dnl
+dnl
+dnl define if serial consoles needs to be enabled in /etc/ttys
+dnl (i.e. md_consoleinfo is not empty)
+define({:-MDSERCONS-:},)dnl
+dnl
+dnl define if SMP kernels are provided
+define({:-MDSMP-:},)dnl
+dnl
+dnl define if shared libraries are provided
+define({:-MDSO-:},1)dnl
+dnl
+dnl define if some media have timezone information (TZ in their list)
+define({:-MDTZ-:},)dnl
+dnl
+dnl define if glass console is possible
+dnl (XXX does not imply availablity of X servers though)
+define({:-MDX-:},1)dnl
+dnl
+dnl define if the X server can't start until machdep.allow_aperture is set
+define({:-MDXAPERTURE-:},)dnl
+dnl
+dnl define if the X server can start without a configuration file
+define({:-MDXDM-:},)dnl
diff --git a/distrib/notes/beagle/hardware b/distrib/notes/beagle/hardware
new file mode 100644
index 00000000000..58c126ac5d7
--- /dev/null
+++ b/distrib/notes/beagle/hardware
@@ -0,0 +1,10 @@
+dnl	$OpenBSD: hardware,v 1.1 2011/03/22 18:33:51 jasper Exp $
+OpenBSD/MACHINE OSREV runs on the original and xM BeagleBoard systems.
+
+Supported devices:
+
+On-board devices:
+	- standard serial port (com)
+	- USB controller (ehci)
+	- watchdog controller (omdog)
+	- GPIO controller (omgpio)
diff --git a/distrib/notes/beagle/install b/distrib/notes/beagle/install
new file mode 100644
index 00000000000..9430b632f00
--- /dev/null
+++ b/distrib/notes/beagle/install
@@ -0,0 +1,85 @@
+dnl     $OpenBSD: install,v 1.1 2011/03/22 18:33:51 jasper Exp $
+OpenBSDInstallPrelude
+
+Now you are ready to power up the board. It will print some hardware
+information and if your SD card has been properly setup the autoboot
+script will be loaded:
+
+	Hit any key to stop autoboot:  0 
+	mmc1 is available
+	The user button is currently NOT pressed.
+	reading boot.scr
+
+	123 bytes read
+	Running bootscript from mmc ...
+	## Executing script at 80200000
+	reading bsd.umg
+
+	2634332 bytes read
+
+	## Booting kernel from Legacy Image at 82800000 ...
+	   Image Name:   boot
+	   Image Type:   ARM Linux Kernel Image (uncompressed)
+	   Data Size:    2634268 Bytes =  2.5 MB
+	   Load Address: 80300000
+	   Entry Point:  80300000
+	   Verifying Checksum ... OK
+	   Loading Kernel Image ... OK
+	OK
+
+	Starting kernel ...
+
+	OpenBSD/beagle booting ...
+
+Alternatively you can manually boot OpenBSD when you hit any key
+during the time-out and you will be presented with the following
+prompt:
+
+	OMAP3 beagleboard.org #
+
+Now type 'mmc init' to check that the SD card has been found:
+
+	OMAP3 beagleboard.org # mmc init
+	mmc1 is available
+	OMAP3 beagleboard.org # 
+
+When the card has been found you should load the U-Boot image into memory:
+
+	OMAP3 beagleboard.org # fatload mmc 0 0x80800000 bsd.umg
+	reading bsd.umg
+
+	2634332 bytes read
+	OMAP3 beagleboard.org # 
+
+To load that image from memory and thus boot OpenBSD type:
+
+	OMAP3 beagleboard.org # bootm 0x80800000
+
+Note that no ramdisk kernels are provided at this moment, so you won't
+be able to actually install OpenBSD/MACHINE yet..
+
+OpenBSDInstallPart2
+
+OpenBSDInstallPart3(,"sd0")
+
+OpenBSDInstallPart4
+
+OpenBSDInstallMBRPart1
+
+OpenBSDInstallMBRPart2(indeed)
+
+OpenBSDInstallPart5
+
+OpenBSDInstallPart6({:-CD-ROM, -:})
+
+OpenBSDURLInstall
+
+OpenBSDCDROMInstall
+
+OpenBSDDISKInstall(,,{:-, Linux (ext2) or MS-DOS-:})
+
+OpenBSDCommonInstall
+
+OpenBSDInstallWrapup
+
+OpenBSDCongratulations
diff --git a/distrib/notes/beagle/prep b/distrib/notes/beagle/prep
new file mode 100644
index 00000000000..abb22751220
--- /dev/null
+++ b/distrib/notes/beagle/prep
@@ -0,0 +1,94 @@
+dnl	$OpenBSD: prep,v 1.1 2011/03/22 18:33:51 jasper Exp $
+
+Please be aware that OpenBSD support for this platform is far from
+complete and that these instructions may still be rough.
+
+If you are using a BeagleBoard xM you can use the following script to
+create a bootable SD card:
+
+#!/bin/sh
+#
+# Written by Dale Rahn <drahn@openbsd.org>, 2011.
+#
+# Create a bootable partition on ${DRIVE} for use with BeagleBoard xM.
+
+echo $#
+if (( $# < 3 ))
+then
+	echo fail
+	exit 4
+fi
+
+DRIVE=$1
+MLO=$2
+UBOOT=$3
+
+echo DRIVE ${DRIVE}
+echo MLO ${MLO}
+echo UBOOT ${UBOOT}
+
+SIZE=$(fdisk ${DRIVE} | grep Disk | awk '{ print $5 }' | sed -e 's/\[//')
+
+echo size ${SIZE}
+
+CYL=$(echo ${SIZE}/255/63|bc)
+echo cyl ${CYL}
+
+MAXCYL=$(echo  ${CYL} - 1 | bc)
+
+echo MAXCYL ${MAXCYL}
+
+CHS="-c ${CYL} -h 255 -s 63"
+
+echo CHS ${CHS}
+
+dd if=/dev/zero of=/dev/r${DRIVE}c bs=1m count=1 2>/dev/null
+
+fdisk ${CHS} -yi ${DRIVE} >/dev/null
+
+fdisk ${CHS} -e ${DRIVE} >/dev/null << DONE
+e 0
+C
+y
+0
+1
+1
+4
+254
+63
+f 0
+e 3
+A6
+y
+5
+0
+1
+${MAXCYL}
+254
+63
+w
+q
+DONE
+
+disklabel -c ${DRIVE}
+
+# if msdos partition is > 32MB make this FAT32, not FAT16
+newfs_msdos -F 16 -L boot /dev/r${DRIVE}i >/dev/null
+
+mount /dev/${DRIVE}i /mnt
+cp ${MLO} /mnt/MLO
+cp ${UBOOT} /mnt/u-boot.bin
+umount /mnt
+sync
+----------------------------EOF-----------------------------
+
+You can download the signed U-Boot image here: http://humppa.nl/xM/MLO .
+The U-boot binary can be downloaded here: http://humppa.nl/xM/u-boot.bin .
+
+Insert the card into your computer and call the script like:
+
+	# sh beagle_fmt_sd sd1 ./MLO ./u-boot.bin
+
+When you have connected the BeagleBoard to you computer, a command such
+as "tip -115200 tty00" (assuming tty00 is your serial port device) should
+connect you to the board's console.
diff --git a/distrib/notes/beagle/upgrade b/distrib/notes/beagle/upgrade
new file mode 100644
index 00000000000..7f3be703729
--- /dev/null
+++ b/distrib/notes/beagle/upgrade
@@ -0,0 +1,2 @@
+dnl	$OpenBSD: upgrade,v 1.1 2011/03/22 18:33:51 jasper Exp $
+OpenBSDUpgrade({:-your usual boot device-:})
diff --git a/distrib/notes/beagle/whatis b/distrib/notes/beagle/whatis
new file mode 100644
index 00000000000..87cda302646
--- /dev/null
+++ b/distrib/notes/beagle/whatis
@@ -0,0 +1,5 @@
+dnl	$OpenBSD: whatis,v 1.1 2011/03/22 18:33:51 jasper Exp $
+
+OpenBSD/MACHINE runs on a the original BeagleBoard as well as the newer
+xM models. Hardware support is currently very limited, but this port is
+a heavy work in progress.
diff --git a/distrib/notes/beagle/xfer b/distrib/notes/beagle/xfer
new file mode 100644
index 00000000000..9f9f5debc94
--- /dev/null
+++ b/distrib/notes/beagle/xfer
@@ -0,0 +1,14 @@
+dnl	$OpenBSD: xfer,v 1.1 2011/03/22 18:33:51 jasper Exp $
+
+Installation is supported from several media types, including:
+
+	CD-ROM
+	FFS partitions
+	DOS (FAT) partitions
+	EXT2 partitions
+	FTP
+	HTTP
+
+OpenBSDXferShortPrelude
+
+OpenBSDXferFFS