From 107ab75ea620b0a64e83e19355ecffb3c172e27b Mon Sep 17 00:00:00 2001 From: Alexander von Gluck IV Date: Sun, 28 Apr 2013 12:37:00 -0500 Subject: [PATCH] docs: Clean up RaspberryPi Documentation; move * Convert the RaspberryPi documentation to markdown * Move into the proper arm port docs location --- build/jam/board/raspberry_pi/info.txt | 34 -------------- docs/develop/ports/arm/raspberry_pi.md | 63 ++++++++++++++++++++++++++ 2 files changed, 63 insertions(+), 34 deletions(-) delete mode 100644 build/jam/board/raspberry_pi/info.txt create mode 100644 docs/develop/ports/arm/raspberry_pi.md diff --git a/build/jam/board/raspberry_pi/info.txt b/build/jam/board/raspberry_pi/info.txt deleted file mode 100644 index 5b7ed7a60a..0000000000 --- a/build/jam/board/raspberry_pi/info.txt +++ /dev/null @@ -1,34 +0,0 @@ -Setting up the Haiku boot partition -------------------------------------- -partition 1 -- FAT32, bootable flag, type 'c' -partition 2 -- BeFS, Haiku filesystem, type 'eb' - -The boot partition must contain the following files to boot Haiku: -* bootcode.bin : 2nd stage bootloader -* start.elf: The GPU binary firmware image -* haiku_loader: Haiku Loader -* haiku-floppyboot.tgz: Compressed image with Haiku kernel -* config.txt: A configuration file read by the GPU. - -Optional files: -* vlls directory: Additional GPU code, e.g. extra codecs. - -Building -------------------------------------- -jam -q -sHAIKU_BOOT_BOARD=raspberry_pi -sHAIKU_BOOT_PLATFORM=raspberrypi_arm haiku_loader -jam -q -sHAIKU_BOOT_BOARD=raspberry_pi -sHAIKU_BOOT_PLATFORM=raspberrypi_arm haiku-floppyboot.tgz - -config.txt options -------------------------------------- -kernel=haiku_loader -kernel_address=0x0 -disable_commandline_tags=1 -ramfsfile=haiku-floppyboot.tgz -ramfsaddr=0x04000000 - -Additional information -------------------------------------- -* Latest Raspberry Pi firmware: - http://github.com/raspberrypi/firmware/tree/master/boot -* config.txt options: - http://www.elinux.org/RPiconfig diff --git a/docs/develop/ports/arm/raspberry_pi.md b/docs/develop/ports/arm/raspberry_pi.md new file mode 100644 index 0000000000..c5fef5162d --- /dev/null +++ b/docs/develop/ports/arm/raspberry_pi.md @@ -0,0 +1,63 @@ +# Raspberry Pi +* http://raspberrypi.org + +# Hardware Information + +* ARMv6 Architecture +* Broadcom BCM2835 (SoC) + * Includes ARM1176JZF-S CPU @ 700 MHz + * Includes VideoCore IV GPU +* SD Card Storage +* 256 or 512 MB RAM (depending on revision) +* Video Outputs + * HDMI Video Output + * Composite Video Output +* Ethernet + +# Setting up the Haiku SD card + +The Raspberry Pi SD card generally uses the MBR file system layout below. Partition 1 is all that is required to boot an OS. + +* partition 1 -- FAT32, bootable flag, type 'c' +* partition 2 -- BeFS, Haiku filesystem, type 'eb' + +## Boot Partition + +### Required Files + +* bootcode.bin : 2nd stage bootloader +* start.elf: The GPU binary firmware image +* haiku_loader: Haiku Loader +* haiku-floppyboot.tgz: Compressed image with Haiku kernel +* config.txt: A configuration file read by the GPU. + +### Optional Files + +* vlls directory: Additional GPU code, e.g. extra codecs. + +# Compiling + +* Build an ARM toolchain using `./configure --build-cross-tools-gcc4 arm ../buildtools` +* Build our loader using `jam -q -sHAIKU_BOOT_BOARD=raspberry_pi -sHAIKU_BOOT_PLATFORM=raspberrypi_arm haiku_loader` +* Build our file system using `jam -q -sHAIKU_BOOT_BOARD=raspberry_pi -sHAIKU_BOOT_PLATFORM=raspberrypi_arm haiku-floppyboot.tgz` + +# Booting + +1. SOC finds bootcode.bin +2. bootcode.bin runs start.elf +2. start.elf reads config.txt and cmdline.txt +3. start.elf runs specified binary at specified address + +## config.txt Options + + kernel=haiku_loader + kernel_address=0x0 + disable_commandline_tags=1 + ramfsfile=haiku-floppyboot.tgz + ramfsaddr=0x04000000 + +# Additional Information + +* [Latest Raspberry Pi firmware](http://github.com/raspberrypi/firmware/tree/master/boot) +* [config.txt options](http://www.elinux.org/RPiconfig) +