summaryrefslogtreecommitdiffstats
path: root/0011-add-README.distro-file.patch
diff options
context:
space:
mode:
authorDennis Gilmore <dennis@ausil.us>2014-04-21 12:43:34 -0500
committerDennis Gilmore <dennis@ausil.us>2014-04-21 12:43:34 -0500
commit07dc9b8284fbe0405e3cf63740a6536e79cbc5db (patch)
tree36bf0e792fdcbd6c05c594e4fd37c10799a6f11f /0011-add-README.distro-file.patch
parentcc319d5762cc708575ec14cfd22cb1f79ce177eb (diff)
downloaduboot-tools-07dc9b8284fbe0405e3cf63740a6536e79cbc5db.tar.gz
uboot-tools-07dc9b8284fbe0405e3cf63740a6536e79cbc5db.tar.xz
uboot-tools-07dc9b8284fbe0405e3cf63740a6536e79cbc5db.zip
update to final 2014.04
- put all images into a single rpm - add udoo image
Diffstat (limited to '0011-add-README.distro-file.patch')
-rw-r--r--0011-add-README.distro-file.patch98
1 files changed, 98 insertions, 0 deletions
diff --git a/0011-add-README.distro-file.patch b/0011-add-README.distro-file.patch
new file mode 100644
index 0000000..a7bdfa0
--- /dev/null
+++ b/0011-add-README.distro-file.patch
@@ -0,0 +1,98 @@
+From 92e9920fc35a3e53ab1fdf3ad934e951c597e7c2 Mon Sep 17 00:00:00 2001
+From: Dennis Gilmore <dennis@ausil.us>
+Date: Mon, 21 Apr 2014 12:29:49 -0500
+Subject: [PATCH 11/14] add README.distro file
+
+Add documentation on how to setup a system to use the generic distro
+configs and boot commands. This spells out what is needed to make a
+system conformant, but does not limit the board to only the defaults.
+---
+ doc/README.distro | 76 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ 1 file changed, 76 insertions(+)
+ create mode 100644 doc/README.distro
+
+diff --git a/doc/README.distro b/doc/README.distro
+new file mode 100644
+index 0000000..435c578
+--- /dev/null
++++ b/doc/README.distro
+@@ -0,0 +1,76 @@
++/*
++ * (C) Copyright 2014 Red Hat Inc.
++ *
++ * SPDX-License-Identifier: GPL-2.0+
++ */
++
++Generic distro configuration
++----------------------------
++
++configuring
++-----------
++To configure a board to run the generic distro setup and enable generic distros
++to easily support your board.
++
++you will need to include a pair of headers to enable the boot environment and
++configuration options needed. It is best to only include when not doing an
++SPL build.
++
++#ifndef CONFIG_SPL_BUILD
++#include <config_distro_defaults.h>
++#include <config_distro_bootcmd.h>
++#endif
++
++There is some memory addresses you will need to define in
++CONFIG_EXTRA_ENV_SETTINGS
++fdt_addr:
++Optional, If specified a dtb to boot the system must be available at the given
++address.
++
++fdt_addr_r:
++Mandatory, This is the location where the sysboot/pxeboot with load the dtb to,
++using the fdtdir/devicetreedir or fdt/devicetree options in the pxe/extlinux
++config file. The location can be anywhere in ram it just needs to not overlap
++with anything, allowing 1 megabyte seems to be a safe option.
++
++ramdisk_addr_r:
++Mandatory, This is the location where the sysboot/pxeboot with load the
++initramfs to, using the initrd option in the pxe/extlinux config file, the
++location of the initramfs does not matter, there needs to be enough room to be
++able to store any image. Making the image the last item stored should allow for
++any initramfs to fit and not overwrite anything else.
++
++kernel_addr_r:
++Mandatory, This is the location where the sysboot/pxeboot with load the kernel
++to,using the kernel option in the pxe/extlinux config file, the location of the
++kernel needs to
++
++pxe_addr_r:
++Mandatory, used by the PXE code to hold the pxelinux config file. The location
++can be anywhere in ram it just needs to not overlap with anything, allowing 1
++megabyte seems to be a safe option.
++
++scriptaddr:
++Mandatory, used to load boot.scr to The location can be anywhere in ram it just
++needs to not overlap with anything, allowing 1 megabyte seems to be a safe
++option.
++
++suggested mapping:
++For suggestions on memory locations for arm systems you must follow the
++guidelines specified in Documentation/arm/Booting in the Linux kernel tree.
++For other architectures you must follow the guidelines for the architecture.
++
++make sure you also include BOOTCMDS_COMMON in CONFIG_EXTRA_ENV_SETTINGS
++
++You should not set initrd_high and fdt_high to 0xffffffff as the user should
++not need to edit the memory locations having the initramfs and dtb being
++relocatable is best to ensure the system will boot in all situations.
++
++booting your system
++-------------------
++in the most simplest form CONFIG_BOOTCOMMAND just needs one line
++
++"for target in ${boot_targets}; do run bootcmd_${target}; done "
++
++you can run any setup before going through the targets for example run a
++command to set "fdtfile" variable for the dtb for your board.
+--
+1.9.0
+