From patchwork Thu Mar 17 19:47:03 2011 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Spang X-Patchwork-Id: 87421 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from theia.denx.de (theia.denx.de [85.214.87.163]) by ozlabs.org (Postfix) with ESMTP id DC97CB6FB3 for ; Fri, 18 Mar 2011 06:56:05 +1100 (EST) Received: from localhost (localhost [127.0.0.1]) by theia.denx.de (Postfix) with ESMTP id 60EAD28122; Thu, 17 Mar 2011 20:55:51 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at theia.denx.de Received: from theia.denx.de ([127.0.0.1]) by localhost (theia.denx.de [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id DT03JJ1fx9AX; Thu, 17 Mar 2011 20:55:51 +0100 (CET) Received: from theia.denx.de (localhost [127.0.0.1]) by theia.denx.de (Postfix) with ESMTP id 0108528123; Thu, 17 Mar 2011 20:55:24 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by theia.denx.de (Postfix) with ESMTP id 4BA89280CA for ; Thu, 17 Mar 2011 20:55:19 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at theia.denx.de Received: from theia.denx.de ([127.0.0.1]) by localhost (theia.denx.de [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id lvjkkr09-NF5 for ; Thu, 17 Mar 2011 20:55:17 +0100 (CET) X-policyd-weight: NOT_IN_SBL_XBL_SPAMHAUS=-1.5 NOT_IN_SPAMCOP=-1.5 NOT_IN_BL_NJABL=-1.5 (only DNSBL check requested) Received: from caffeine.csclub.uwaterloo.ca (caffeine.csclub.uwaterloo.ca [129.97.134.17]) by theia.denx.de (Postfix) with ESMTP id 0C070280FB for ; Thu, 17 Mar 2011 20:55:13 +0100 (CET) Received: from corn-syrup (corn-syrup.csclub.uwaterloo.ca [129.97.134.72]) by caffeine.csclub.uwaterloo.ca (Postfix) with SMTP id 7DFA912DC; Thu, 17 Mar 2011 15:47:14 -0400 (EDT) Received: by corn-syrup (sSMTP sendmail emulation); Thu, 17 Mar 2011 15:47:14 -0400 From: Michael Spang To: u-boot@lists.denx.de Date: Thu, 17 Mar 2011 15:47:03 -0400 Message-Id: <1300391223-11879-10-git-send-email-mspang@csclub.uwaterloo.ca> X-Mailer: git-send-email 1.7.2.3 In-Reply-To: <1300391223-11879-1-git-send-email-mspang@csclub.uwaterloo.ca> References: <1300391223-11879-1-git-send-email-mspang@csclub.uwaterloo.ca> Cc: Michael Spang , Alexander Clouter Subject: [U-Boot] [PATCH 9/9] Add README for TS-7800 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.9 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: u-boot-bounces@lists.denx.de Errors-To: u-boot-bounces@lists.denx.de Signed-off-by: Michael Spang --- doc/README.ts7800 | 84 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 84 insertions(+), 0 deletions(-) create mode 100644 doc/README.ts7800 diff --git a/doc/README.ts7800 b/doc/README.ts7800 new file mode 100644 index 0000000..6a6ab94 --- /dev/null +++ b/doc/README.ts7800 @@ -0,0 +1,84 @@ +Booting +------- + +The TS-7800 boots initially from a proprietary bootloader on the FPGA +called TS-BOOTROM. TS-BOOTROM loads a small image from the MBR of the +onboard NAND or SD card into RAM, and executes it. The default MBR is +intended to boot a Linux kernel. + +The TS-7800 port of U-Boot takes the place of the Linux kernel in this +configuration, and is therefore loaded and executed by the MBR. The +MBR also creates an ATAG structure intended for Linux, but U-Boot +ignores it. + +NAND layout +----------- + +NAND support is not enabled by default because U-Boot will overwrite +part of it with its environment. To enable NAND support, enable +CONFIG_USE_NAND in include/configs/ts7800.h. + +The default NAND partition layout used by Technologic and Linux is: + + 128k(mbr),4m(linux),4m(initrd),-(rootfs) + +For U-Boot, we split the linux partition into a partition for the +U-Boot code and a partition for the U-Boot environment. The initrd +partition is not used, and is renamed to "linux". The new layout is: + + 128k(mbr),3m(uboot),1m(env),4m(linux),-(rootfs) + +When NAND support is enabled, this string is available in the U-Boot +default environment as the "mtdparts" variable. You may wish to use +this layout for Linux as well by adding it to the Linux command line. +For example: + + setenv bootargs console=ttyS0,115200n8 ${mtdparts} + +Installing U-Boot +----------------- + +To install U-Boot to the onboard flash, write u-boot.bin to the kernel +partition on the flash. From Linux this might be done as follows: + + flash_eraseall /dev/mtd1 + nandwrite --pad /dev/mtd1 u-boot.bin + +When running from onboard flash, you may wish to enable NAND support +as described in the previous section. The environment is not preserved +unless you enable NAND support. + +To install U-Boot to an SD card, write u-boot.bin to the kernel +partition on the card. + +Booting Technologic Kernels +--------------------------- + +Technologic's kernels use a different machine type ID than upstream +kernels. U-Boot uses the upstream ID, so Technologic kernels will +not boot from U-Boot without the following workaround: + + setenv machid 0x20e + +The following commands will convert a Technologic kernel image +into U-Boot format: + + mkimage -A arm -O linux -T kernel -C none -a 0x8000 \ + -d kernel-image-latest.dd uImage + + mkimage -A arm -O linux -T ramdisk -C none -a 0x1000000 \ + -d initrd-busybox-rootfs-latest.dd initrd + +Then pass both images to the bootm command to boot. Note that with +U-Boot installed there is only one partition available for the kernel +and initrd. To use both changing the NAND partitioning may be +required. To do so you can use the mtdparts command in U-Boot and pass +${mtdparts} to linux. + +TS-7800 Wiki +------------ + +A useful resource about the TS-7800 is the TS-7800 wiki [1], +maintained by Alexander Clouter. + +[1] http://www.digriz.org.uk/ts78xx