]> git.ipfire.org Git - people/ms/u-boot.git/blobdiff - README
Accelerate booting on TRAB board: read and check autoupdate image
[people/ms/u-boot.git] / README
diff --git a/README b/README
index 668c4e0bfd4ab0a3ffa740f26dd95ff13575216a..a1c6a96ba3c8e6171b47a34a88cca9ee0f2e4e64 100644 (file)
--- a/README
+++ b/README
@@ -119,12 +119,12 @@ U-Boot will always have a patchlevel of "0".
 Directory Hierarchy:
 ====================
 
-- board                Board dependend files
-- common       Misc architecture independend functions
+- board                Board dependent files
+- common       Misc architecture independent functions
 - cpu          CPU specific files
 - disk         Code for disk drive partition handling
 - doc          Documentation (don't expect too much)
-- drivers      Common used device drivers
+- drivers      Commonly used device drivers
 - dtt          Digital Thermometer and Thermostat drivers
 - examples     Example code for standalone applications, etc.
 - include      Header Files
@@ -140,12 +140,16 @@ Directory Hierarchy:
 - tools                Tools to build S-Record or U-Boot images, etc.
 
 - cpu/74xx_7xx Files specific to Motorola MPC74xx and 7xx CPUs
+- cpu/arm925t  Files specific to ARM      925     CPUs
+- cpu/arm926ejs        Files specific to ARM   926     CPUs
 - cpu/mpc5xx   Files specific to Motorola MPC5xx  CPUs
 - cpu/mpc8xx   Files specific to Motorola MPC8xx  CPUs
 - cpu/mpc824x  Files specific to Motorola MPC824x CPUs
 - cpu/mpc8260  Files specific to Motorola MPC8260 CPU
+- cpu/mpc85xx  Files specific to Motorola MPC85xx CPUs
 - cpu/ppc4xx   Files specific to IBM      4xx     CPUs
 
+
 - board/LEOX/   Files specific to boards manufactured by The LEOX team
 - board/LEOX/elpt860   Files specific to ELPT860 boards
 - board/RPXClassic
@@ -195,15 +199,24 @@ Directory Hierarchy:
 - board/lwmon  Files specific to LWMON      boards
 - board/mbx8xx Files specific to MBX        boards
 - board/mpc8260ads
-               Files specific to MMPC8260ADS boards
+               Files specific to MPC8260ADS and PQ2FADS-ZU boards
+- board/mpc8540ads
+               Files specific to MPC8540ADS boards
+- board/mpc8560ads
+               Files specific to MPC8560ADS boards
 - board/mpl/   Files specific to boards manufactured by MPL
 - board/mpl/common     Common files for MPL boards
 - board/mpl/pip405     Files specific to PIP405     boards
 - board/mpl/mip405     Files specific to MIP405     boards
+- board/mpl/vcma9      Files specific to VCMA9      boards
 - board/musenki        Files specific to MUSEKNI    boards
 - board/mvs1   Files specific to MVS1       boards
 - board/nx823   Files specific to NX823      boards
 - board/oxc    Files specific to OXC        boards
+- board/omap1510inn
+               Files specific to OMAP 1510 Innovator boards
+- board/omap1610inn
+               Files specific to OMAP 1610 Innovator boards
 - board/pcippc2        Files specific to PCIPPC2/PCIPPC6 boards
 - board/pm826  Files specific to PM826      boards
 - board/ppmc8260
@@ -231,6 +244,7 @@ Directory Hierarchy:
 - board/westel/        Files specific to boards manufactured by Westel Wireless
 - board/westel/amx860  Files specific to AMX860     boards
 - board/utx8245        Files specific to UTX8245   boards
+- board/zpc1900        Files specific to Zephyr Engineering ZPC.1900 board
 
 Software Configuration:
 =======================
@@ -297,8 +311,10 @@ The following options need to be configured:
                CONFIG_MPC823,  CONFIG_MPC850,  CONFIG_MPC855,  CONFIG_MPC860
        or      CONFIG_MPC5xx
        or      CONFIG_MPC824X, CONFIG_MPC8260
+       or      CONFIG_MPC85xx
        or      CONFIG_IOP480
        or      CONFIG_405GP
+       or      CONFIG_405EP
        or      CONFIG_440
        or      CONFIG_MPC74xx
        or      CONFIG_750FX
@@ -346,15 +362,17 @@ The following options need to be configured:
                CONFIG_IAD210,     CONFIG_RPXlite,    CONFIG_sbc8260,
                CONFIG_EBONY,      CONFIG_sacsng,     CONFIG_FPS860L,
                CONFIG_V37,        CONFIG_ELPT860,    CONFIG_CMI,
-               CONFIG_NETVIA,     CONFIG_RBC823
+               CONFIG_NETVIA,     CONFIG_RBC823,     CONFIG_ZPC1900,
+               CONFIG_MPC8540ADS, CONFIG_MPC8560ADS
 
                ARM based boards:
                -----------------
 
                CONFIG_HHP_CRADLE,  CONFIG_DNP1110,    CONFIG_EP7312,
                CONFIG_IMPA7,       CONFIG_LART,       CONFIG_LUBBOCK,
+               CONFIG_INNOVATOROMAP1510,       CONFIG_INNOVATOROMAP1610
                CONFIG_SHANNON,     CONFIG_SMDK2400,   CONFIG_SMDK2410,
-               CONFIG_TRAB,        CONFIG_AT91RM9200DK
+               CONFIG_TRAB,        CONFIG_VCMA9,      CONFIG_AT91RM9200DK
 
 
 - CPU Module Type: (if CONFIG_COGENT is defined)
@@ -378,16 +396,25 @@ The following options need to be configured:
                                          the lcd display every second with
                                          a "rotator" |\-/|\-/
 
+- Board flavour: (if CONFIG_MPC8260ADS is defined)
+               CONFIG_ADSTYPE
+               Possible values are:
+                       CFG_8260ADS     - original MPC8260ADS
+                       CFG_8266ADS     - MPC8266ADS (untested)
+                       CFG_PQ2FADS     - PQ2FADS-ZU or PQ2FADS-VR
+
+
 - MPC824X Family Member (if CONFIG_MPC824X is defined)
-       Define exactly one of
-       CONFIG_MPC8240, CONFIG_MPC8245
+               Define exactly one of
+               CONFIG_MPC8240, CONFIG_MPC8245
 
 - 8xx CPU Options: (if using an 8xx cpu)
                Define one or more of
-               CONFIG_8xx_GCLK_FREQ    - if get_gclk_freq() can not work e.g.
-                                         no 32KHz reference PIT/RTC clock
+               CONFIG_8xx_GCLK_FREQ    - if get_gclk_freq() cannot work
+                                         e.g. if there is no 32KHz
+                                         reference PIT/RTC clock
 
-- Clock Interface:
+- Linux Kernel Interface:
                CONFIG_CLOCKS_IN_MHZ
 
                U-Boot stores all clock information in Hz
@@ -397,11 +424,16 @@ The following options need to be configured:
                "clocks_in_mhz" can be defined so that U-Boot
                converts clock data to MHZ before passing it to the
                Linux kernel.
-
                When CONFIG_CLOCKS_IN_MHZ is defined, a definition of
                "clocks_in_mhz=1" is  automatically  included  in  the
                default environment.
 
+               CONFIG_MEMSIZE_IN_BYTES         [relevant for MIPS only]
+
+               When transfering memsize parameter to linux, some versions
+               expect it to be in bytes, others in MB.
+               Define CONFIG_MEMSIZE_IN_BYTES to make it in bytes.
+
 - Console Interface:
                Depending on board, define exactly one serial port
                (like CONFIG_8xx_CONS_SMC1, CONFIG_8xx_CONS_SMC2,
@@ -455,6 +487,11 @@ The following options need to be configured:
                default i/o. Serial console can be forced with
                environment 'console=serial'.
 
+                When CONFIG_SILENT_CONSOLE is defined, all console
+                messages (by U-Boot and Linux!) can be silenced with
+                the "silent" environment variable. See
+                doc/README.silent for more information.
+
 - Console Baudrate:
                CONFIG_BAUDRATE - in bps
                Select one of the baudrates listed in
@@ -555,13 +592,18 @@ The following options need to be configured:
                #define enables commands:
                -------------------------
                CFG_CMD_ASKENV  * ask for env variable
+               CFG_CMD_AUTOSCRIPT Autoscript Support
                CFG_CMD_BDI       bdinfo
                CFG_CMD_BEDBUG    Include BedBug Debugger
+               CFG_CMD_BMP     * BMP support
                CFG_CMD_BOOTD     bootd
                CFG_CMD_CACHE     icache, dcache
                CFG_CMD_CONSOLE   coninfo
                CFG_CMD_DATE    * support for RTC, date/time...
                CFG_CMD_DHCP      DHCP support
+               CFG_CMD_DIAG    * Diagnostics
+               CFG_CMD_DOC     * Disk-On-Chip Support
+               CFG_CMD_DTT       Digital Therm and Thermostat
                CFG_CMD_ECHO    * echo arguments
                CFG_CMD_EEPROM  * EEPROM read/write support
                CFG_CMD_ELF       bootelf, bootvx
@@ -571,27 +613,37 @@ The following options need to be configured:
                CFG_CMD_FDOS    * Dos diskette Support
                CFG_CMD_FLASH     flinfo, erase, protect
                CFG_CMD_FPGA      FPGA device initialization support
+               CFG_CMD_HWFLOW  * RTS/CTS hw flow control
                CFG_CMD_I2C     * I2C serial bus support
                CFG_CMD_IDE     * IDE harddisk support
                CFG_CMD_IMI       iminfo
+               CFG_CMD_IMLS      List all found images
                CFG_CMD_IMMAP   * IMMR dump support
                CFG_CMD_IRQ     * irqinfo
+               CFG_CMD_JFFS2   * JFFS2 Support
                CFG_CMD_KGDB    * kgdb
                CFG_CMD_LOADB     loadb
                CFG_CMD_LOADS     loads
                CFG_CMD_MEMORY    md, mm, nm, mw, cp, cmp, crc, base,
                                  loop, mtest
+               CFG_CMD_MISC      Misc functions like sleep etc
                CFG_CMD_MMC       MMC memory mapped support
                CFG_CMD_MII       MII utility commands
+               CFG_CMD_NAND    * NAND support
                CFG_CMD_NET       bootp, tftpboot, rarpboot
                CFG_CMD_PCI     * pciinfo
                CFG_CMD_PCMCIA  * PCMCIA support
+               CFG_CMD_PING    * send ICMP ECHO_REQUEST to network host
+               CFG_CMD_PORTIO    Port I/O
                CFG_CMD_REGINFO * Register dump
                CFG_CMD_RUN       run command in env variable
+               CFG_CMD_SAVES     save S record dump
                CFG_CMD_SCSI    * SCSI Support
+               CFG_CMD_SDRAM   * print SDRAM configuration information
                CFG_CMD_SETGETDCR Support for DCR Register access (4xx only)
                CFG_CMD_SPI     * SPI serial bus support
                CFG_CMD_USB     * USB support
+               CFG_CMD_VFD     * VFD support (TRAB)
                CFG_CMD_BSP     * Board SPecific functions
                -----------------------------------------------
                CFG_CMD_ALL     all
@@ -627,7 +679,7 @@ The following options need to be configured:
 - Watchdog:
                CONFIG_WATCHDOG
                If this variable is defined, it enables watchdog
-               support. There must support in the platform specific
+               support. There must be support in the platform specific
                code for a watchdog. For the 8xx and 8260 CPUs, the
                SIU Watchdog feature is enabled in the SYPCR
                register.
@@ -653,6 +705,9 @@ The following options need to be configured:
                CONFIG_RTC_DS1338       - use Maxim, Inc. DS1338 RTC
                CONFIG_RTC_DS164x       - use Dallas DS164x RTC
 
+               Note that if the RTC uses I2C, then the I2C interface
+               must also be configured. See I2C Support, below.
+
 - Timestamp Support:
 
                When CONFIG_TIMESTAMP is selected, the timestamp
@@ -795,13 +850,18 @@ The following options need to be configured:
                display); also select one of the supported displays
                by defining one of these:
 
-               CONFIG_NEC_NL6648AC33:
+               CONFIG_NEC_NL6448AC33:
 
-                       NEC NL6648AC33-18. Active, color, single scan.
+                       NEC NL6448AC33-18. Active, color, single scan.
 
-               CONFIG_NEC_NL6648BC20
+               CONFIG_NEC_NL6448BC20
 
-                       NEC NL6648BC20-08. 6.5", 640x480.
+                       NEC NL6448BC20-08. 6.5", 640x480.
+                       Active, color, single scan.
+
+               CONFIG_NEC_NL6448BC33_54
+
+                       NEC NL6448BC33-54. 10.4", 640x480.
                        Active, color, single scan.
 
                CONFIG_SHARP_16x9
@@ -832,7 +892,7 @@ The following options need to be configured:
                Normally display is black on white background; define
                CFG_WHITE_ON_BLACK to get it inverted.
 
-- Spash Screen Support: CONFIG_SPLASH_SCREEN
+- Splash Screen Support: CONFIG_SPLASH_SCREEN
 
                If this option is set, the environment is checked for
                a variable "splashimage". If found, the usual display
@@ -843,6 +903,16 @@ The following options need to be configured:
                allows for a "silent" boot where a splash screen is
                loaded very quickly after power-on.
 
+- Compression support:
+               CONFIG_BZIP2
+
+               If this option is set, support for bzip2 compressed
+               images is included. If not, only uncompressed and gzip
+               compressed images are supported.
+
+               NOTE: the bzip2 algorithm requires a lot of RAM, so
+               the malloc area (as defined by CFG_MALLOC_LEN) should
+               be at least 4MB.
 
 - Ethernet address:
                CONFIG_ETHADDR
@@ -885,6 +955,29 @@ The following options need to be configured:
                4th and following
                BOOTP requests:         delay 0 ... 8 sec
 
+- DHCP Advanced Options:
+               CONFIG_BOOTP_MASK
+
+               You can fine tune the DHCP functionality by adding
+               these flags to the CONFIG_BOOTP_MASK define:
+
+               CONFIG_BOOTP_DNS2 - If a DHCP client requests the DNS
+               serverip from a DHCP server, it is possible that more
+               than one DNS serverip is offered to the client.
+               If CONFIG_BOOTP_DNS2 is enabled, the secondary DNS
+               serverip will be stored in the additional environment
+               variable "dnsip2". The first DNS serverip is always
+               stored in the variable "dnsip", when CONFIG_BOOTP_DNS
+               is added to the CONFIG_BOOTP_MASK.
+
+               CONFIG_BOOTP_SEND_HOSTNAME - Some DHCP servers are capable
+               to do a dynamic update of a DNS server. To do this, they
+               need the hostname of the DHCP requester.
+               If CONFIG_BOOP_SEND_HOSTNAME is added to the
+               CONFIG_BOOTP_MASK, the content of the "hostname"
+               environment variable is passed as option 12 to
+               the DHCP server.
+
 - Status LED:  CONFIG_STATUS_LED
 
                Several configurations allow to display the current
@@ -904,29 +997,48 @@ The following options need to be configured:
 
 - I2C Support: CONFIG_HARD_I2C | CONFIG_SOFT_I2C
 
-               Enables I2C serial bus commands.  If this is selected,
-               either CONFIG_HARD_I2C or CONFIG_SOFT_I2C must be defined
-               to include the appropriate I2C driver.
+               These enable I2C serial bus commands. Defining either of
+               (but not both of) CONFIG_HARD_I2C or CONFIG_SOFT_I2C will
+               include the appropriate I2C driver for the selected cpu.
 
-               See also: common/cmd_i2c.c for a description of the
+               This will allow you to use i2c commands at the u-boot
+               command line (as long as you set CFG_CMD_I2C in
+               CONFIG_COMMANDS) and communicate with i2c based realtime
+               clock chips. See common/cmd_i2c.c for a description of the
                command line interface.
 
+               CONFIG_HARD_I2C selects the CPM hardware driver for I2C.
+
+               CONFIG_SOFT_I2C configures u-boot to use a software (aka
+               bit-banging) driver instead of CPM or similar hardware
+               support for I2C.
+
+               There are several other quantities that must also be
+               defined when you define CONFIG_HARD_I2C or CONFIG_SOFT_I2C.
 
-               CONFIG_HARD_I2C
+               In both cases you will need to define CFG_I2C_SPEED
+               to be the frequency (in Hz) at which you wish your i2c bus
+               to run and CFG_I2C_SLAVE to be the address of this node (ie
+               the cpu's i2c node address).
 
-               Selects the CPM hardware driver for I2C.
+               Now, the u-boot i2c code for the mpc8xx (cpu/mpc8xx/i2c.c)
+               sets the cpu up as a master node and so its address should
+               therefore be cleared to 0 (See, eg, MPC823e User's Manual
+               p.16-473). So, set CFG_I2C_SLAVE to 0.
 
-               CONFIG_SOFT_I2C
+               That's all that's required for CONFIG_HARD_I2C.
 
-               Use software (aka bit-banging) driver instead of CPM
-               or similar hardware support for I2C.  This is configured
-               via the following defines.
+               If you use the software i2c interface (CONFIG_SOFT_I2C)
+               then the following macros need to be defined (examples are
+               from include/configs/lwmon.h):
 
                I2C_INIT
 
-               (Optional). Any commands necessary to enable I2C
+               (Optional). Any commands necessary to enable the I2C
                controller or configure ports.
 
+               eg: #define I2C_INIT (immr->im_cpm.cp_pbdir |=  PB_SCL)
+
                I2C_PORT
 
                (Only for MPC8260 CPU). The I/O port to use (the code
@@ -939,32 +1051,49 @@ The following options need to be configured:
                (driven).  If the data line is open collector, this
                define can be null.
 
+               eg: #define I2C_ACTIVE (immr->im_cpm.cp_pbdir |=  PB_SDA)
+
                I2C_TRISTATE
 
                The code necessary to make the I2C data line tri-stated
                (inactive).  If the data line is open collector, this
                define can be null.
 
+               eg: #define I2C_TRISTATE (immr->im_cpm.cp_pbdir &= ~PB_SDA)
+
                I2C_READ
 
                Code that returns TRUE if the I2C data line is high,
                FALSE if it is low.
 
+               eg: #define I2C_READ ((immr->im_cpm.cp_pbdat & PB_SDA) != 0)
+
                I2C_SDA(bit)
 
                If <bit> is TRUE, sets the I2C data line high. If it
                is FALSE, it clears it (low).
 
+               eg: #define I2C_SDA(bit) \
+                       if(bit) immr->im_cpm.cp_pbdat |=  PB_SDA; \
+                       else    immr->im_cpm.cp_pbdat &= ~PB_SDA
+
                I2C_SCL(bit)
 
                If <bit> is TRUE, sets the I2C clock line high. If it
                is FALSE, it clears it (low).
 
+               eg: #define I2C_SCL(bit) \
+                       if(bit) immr->im_cpm.cp_pbdat |=  PB_SCL; \
+                       else    immr->im_cpm.cp_pbdat &= ~PB_SCL
+
                I2C_DELAY
 
                This delay is invoked four times per clock cycle so this
                controls the rate of data transfer.  The data rate thus
-               is 1 / (I2C_DELAY * 4).
+               is 1 / (I2C_DELAY * 4). Often defined to be something
+               like:
+
+               #define I2C_DELAY  udelay(2)
 
                CFG_I2C_INIT_BOARD
 
@@ -1114,7 +1243,7 @@ The following options need to be configured:
 
                U-Boot considers the values of the environment
                variables "serial#" (Board Serial Number) and
-               "ethaddr" (Ethernet Address) to bb parameters that
+               "ethaddr" (Ethernet Address) to be parameters that
                are set once by the board vendor / manufacturer, and
                protects these variables from casual modification by
                the user. Once set, these variables are read-only,
@@ -1229,7 +1358,7 @@ The following options need to be configured:
 
                Define this to contain any number of null terminated
                strings (variable = value pairs) that will be part of
-               the default enviroment compiled into the boot image.
+               the default environment compiled into the boot image.
 
                For example, place something like this in your
                board's config file:
@@ -1242,7 +1371,7 @@ The following options need to be configured:
                internal format how the environment is stored by the
                U-Boot code. This is NOT an official, exported
                interface! Although it is unlikely that this format
-               will change soon, but there is no guarantee either.
+               will change soon, there is no guarantee either.
                You better know what you are doing here.
 
                Note: overly (ab)use of the default environment is
@@ -1311,7 +1440,13 @@ The following options need to be configured:
    -1  common/cmd_ide.c        Read Error on boot device
    -1  common/cmd_ide.c        Image header has bad magic number
 
-   -1  common/cmd_nvedit.c     Environment not changable, but has bad CRC
+   -1  common/cmd_nand.c       Bad usage of "nand" command
+   -1  common/cmd_nand.c       No boot device
+   -1  common/cmd_nand.c       Unknown Chip ID on boot device
+   -1  common/cmd_nand.c       Read Error on boot device
+   -1  common/cmd_nand.c       Image header has bad magic number
+
+   -1  common/env_common.c     Environment has a bad CRC, using default
 
 
 Modem Support:
@@ -1393,6 +1528,10 @@ Configuration Settings:
 - CFG_ALT_MEMTEST:
                Enable an alternate, more extensive memory test.
 
+- CFG_MEMTEST_SCRATCH:
+               Scratch address used by the alternate memory test
+               You only need to set this if address zero isn't writeable
+
 - CFG_TFTP_LOADADDR:
                Default load address for network file downloads
 
@@ -1442,6 +1581,16 @@ Configuration Settings:
 - CFG_FLASH_WRITE_TOUT:
                Timeout for Flash write operations (in ms)
 
+- CFG_FLASH_LOCK_TOUT
+               Timeout for Flash set sector lock bit operation (in ms)
+
+- CFG_FLASH_UNLOCK_TOUT
+               Timeout for Flash clear lock bits operation (in ms)
+
+- CFG_FLASH_PROTECTION
+               If defined, hardware flash sectors protection is used
+               instead of U-Boot software protection.
+
 - CFG_DIRECT_FLASH_TFTP:
 
                Enable TFTP transfers directly to flash memory;
@@ -1624,6 +1773,14 @@ Note: once the monitor has been relocated, then it will complain if
 the default environment is used; a new CRC is computed as soon as you
 use the "saveenv" command to store a valid environment.
 
+- CFG_FAULT_ECHO_LINK_DOWN:
+               Echo the inverted Ethernet link state to the fault LED.
+
+               Note: If this option is active, then CFG_FAULT_MII_ADDR
+                     also needs to be defined.
+
+- CFG_FAULT_MII_ADDR:
+               MII address of the PHY to check for the Ethernet link state.
 
 Low Level (hardware related) configuration options:
 ---------------------------------------------------
@@ -1633,9 +1790,10 @@ Low Level (hardware related) configuration options:
 
 - CFG_DEFAULT_IMMR:
                Default address of the IMMR after system reset.
-               Needed on some 8260 systems (MPC8260ADS and RPXsuper)
-               to be able to adjust the position of the IMMR
-               register after a reset.
+
+               Needed on some 8260 systems (MPC8260ADS, PQ2FADS-ZU,
+               and RPXsuper) to be able to adjust the position of
+               the IMMR register after a reset.
 
 - Floppy Disk Support:
                CFG_FDC_DRIVE_NUMBER
@@ -1669,7 +1827,7 @@ Low Level (hardware related) configuration options:
 
 - CFG_INIT_RAM_ADDR:
 
-               Start address of memory area tha can be used for
+               Start address of memory area that can be used for
                initial data and stack; please note that this must be
                writable memory that is working WITHOUT special
                initialization, i. e. you CANNOT use normal RAM which
@@ -1808,7 +1966,9 @@ configurations; the following names are supported:
     GENIETV_config       TQM823L_config        PIP405_config
     GEN860T_config       EBONY_config          FPS860L_config
     ELPT860_config       cmi_mpc5xx_config     NETVIA_config
-    at91rm9200dk_config
+    at91rm9200dk_config          omap1510inn_config    MPC8260ADS_config
+    omap1610inn_config   ZPC1900_config        MPC8540ADS_config
+    MPC8560ADS_config
 
 Note: for some board special configuration names may exist; check  if
       additional  information is available from the board vendor; for
@@ -1841,7 +2001,7 @@ Note: for some board special configuration names may exist; check  if
 
 
 Finally, type "make all", and you should get some working U-Boot
-images ready for downlod to / installation on your system:
+images ready for download to / installation on your system:
 
 - "u-boot.bin" is a raw binary image
 - "u-boot" is an image in ELF binary format
@@ -1860,7 +2020,7 @@ steps:
 1.  Add a new configuration option for your board to the toplevel
     "Makefile" and to the "MAKEALL" script, using the existing
     entries as examples. Note that here and at many other places
-    boards and other names are listed alphabetically sorted. Please
+    boards and other names are listed in alphabetical sort order. Please
     keep this order.
 2.  Create a new directory to hold your board specific code. Add any
     files you need. In your board directory, you will need at least
@@ -1890,7 +2050,7 @@ cation    did not break existing code. At least make sure that *ALL* of
 the supported boards compile WITHOUT ANY compiler warnings. To do so,
 just run the "MAKEALL" script, which will configure and build U-Boot
 for ALL supported system. Be warned, this will take a while. You  can
-select which  (cross)  compiler  to use py passing a `CROSS_COMPILE'
+select which  (cross)  compiler  to use by passing a `CROSS_COMPILE'
 environment variable to the script, i. e. to use the cross tools from
 MontaVista's Hard Hat Linux you can type
 
@@ -2017,10 +2177,10 @@ Some configuration options can be set using Environment Variables:
                  does not overwrite the U-Boot stack and data).
 
                  For instance, when you have a system with 16 MB
-                 RAM, and want to reseve 4 MB from use by Linux,
+                 RAM, and want to reserve 4 MB from use by Linux,
                  you can do this by adding "mem=12M" to the value of
                  the "bootargs" variable. However, now you must make
-                 sure, that the initrd image is placed in the first
+                 sure that the initrd image is placed in the first
                  12 MB as well - this can be done with
 
                  setenv initrd_high 00c00000
@@ -2055,6 +2215,7 @@ depending the information provided by your boot server:
 
   bootfile     - see above
   dnsip                - IP address of your Domain Name Server
+  dnsip2       - IP address of your secondary Domain Name Server
   gatewayip    - IP address of the Gateway (Router) to use
   hostname     - Target hostname
   ipaddr       - see above
@@ -2088,8 +2249,8 @@ only effect after the next boot (yes, that's just like Windoze :-).
 Command Line Parsing:
 =====================
 
-There are two different command line parsers available  with  U-Boot:
-the old "simple" one, and the much more pwerful "hush" shell:
+There are two different command line parsers available with U-Boot:
+the old "simple" one, and the much more powerful "hush" shell:
 
 Old, simple command line parser:
 --------------------------------
@@ -2130,9 +2291,9 @@ General rules:
 Note for Redundant Ethernet Interfaces:
 =======================================
 
-Some boards come with redundand ethernet interfaces; U-Boot supports
+Some boards come with redundant ethernet interfaces; U-Boot supports
 such configurations and is capable of automatic selection of a
-"working" interface when needed. MAC assignemnt works as follows:
+"working" interface when needed. MAC assignment works as follows:
 
 Network interfaces are numbered eth0, eth1, eth2, ... Corresponding
 MAC addresses can be stored in the environment as "ethaddr" (=>eth0),
@@ -2172,12 +2333,11 @@ defines the following image properties:
 * Target Operating System (Provisions for OpenBSD, NetBSD, FreeBSD,
   4.4BSD, Linux, SVR4, Esix, Solaris, Irix, SCO, Dell, NCR, VxWorks,
   LynxOS, pSOS, QNX, RTEMS, ARTOS;
-  Currently supported: Linux, NetBSD, VxWorks, QNX, RTEMS, ARTOS).
+  Currently supported: Linux, NetBSD, VxWorks, QNX, RTEMS, ARTOS, LynxOS).
 * Target CPU Architecture (Provisions for Alpha, ARM, Intel x86,
-  IA64, MIPS, MIPS, PowerPC, IBM S390, SuperH, Sparc, Sparc 64 Bit;
-  Currently supported: PowerPC).
-* Compression Type (Provisions for uncompressed, gzip, bzip2;
-  Currently supported: uncompressed, gzip).
+  IA64, MIPS, NIOS, PowerPC, IBM S390, SuperH, Sparc, Sparc 64 Bit;
+  Currently supported: ARM, Intel x86, MIPS, NIOS, PowerPC).
+* Compression Type (uncompressed, gzip, bzip2)
 * Load Address
 * Entry Point
 * Image Name
@@ -2192,21 +2352,21 @@ Linux Support:
 ==============
 
 Although U-Boot should support any OS or standalone application
-easily, Linux has always been in the focus during the design of
+easily, the main focus has always been on Linux during the design of
 U-Boot.
 
 U-Boot includes many features that so far have been part of some
 special "boot loader" code within the Linux kernel. Also, any
 "initrd" images to be used are no longer part of one big Linux image;
 instead, kernel and "initrd" are separate images. This implementation
-serves serveral purposes:
+serves several purposes:
 
 - the same features can be used for other OS or standalone
   applications (for instance: using compressed images to reduce the
   Flash memory footprint)
 
 - it becomes much easier to port new Linux kernel versions because
-  lots of low-level, hardware dependend stuff are done by U-Boot
+  lots of low-level, hardware dependent stuff are done by U-Boot
 
 - the same Linux kernel image can now be used with different "initrd"
   images; of course this also means that different kernel images can
@@ -2458,7 +2618,7 @@ parameters. You can check and modify this variable using the
        ...
 
 If you want to boot a Linux kernel with initial ram disk, you pass
-the memory addreses of both the kernel and the initrd image (PPBCOOT
+the memory addresses of both the kernel and the initrd image (PPBCOOT
 format!) to the "bootm" command:
 
        => imi 40100000 40200000
@@ -2638,7 +2798,7 @@ Hit 'q':
 Minicom warning:
 ================
 
-Over time, many people have reported problems when trying to used the
+Over time, many people have reported problems when trying to use the
 "minicom" terminal emulation program for serial download. I (wd)
 consider minicom to be broken, and recommend not to use it. Under
 Unix, I recommend to use C-Kermit for general purpose use (and
@@ -2706,7 +2866,7 @@ models provide on-chip memory (like the IMMR area on MPC8xx and
 MPC826x processors), on others (parts of) the data cache can be
 locked as (mis-) used as memory, etc.
 
-       Chris Hallinan posted a good summy of  these  issues  to  the
+       Chris Hallinan posted a good summary of  these  issues  to  the
        u-boot-users mailing list:
 
        Subject: RE: [U-Boot-Users] RE: More On Memory Bank x (nothingness)?
@@ -2752,9 +2912,9 @@ code for the initialization procedures:
 
 * Do not use any unitialized global data (or implicitely initialized
   as zero data - BSS segment) at all - this is undefined, initiali-
-  zation is performed later (when relocationg to RAM).
+  zation is performed later (when relocating to RAM).
 
-* Stack space is very limited. Avoid big data buffers or things  like
+* Stack space is very limited. Avoid big data buffers or things like
   that.
 
 Having only the stack as writable memory limits means we cannot use
@@ -2767,7 +2927,7 @@ the GCC compiler (Global Register Variables) to share the data: we
 place a pointer (gd) to the global data into a register which we
 reserve for this purpose.
 
-When chosing a register for such a purpose we are restricted  by  the
+When choosing a register for such a purpose we are restricted by the
 relevant  (E)ABI  specifications for the current architecture, and by
 GCC's implementation.
 
@@ -2857,7 +3017,7 @@ System Initialization:
 In the reset configuration, U-Boot starts at the reset entry point
 (on most PowerPC systens at address 0x00000100). Because of the reset
 configuration for CS0# this is a mirror of the onboard Flash memory.
-To be able to re-map memory U-Boot then jumps to it's link address.
+To be able to re-map memory U-Boot then jumps to its link address.
 To be able to implement the initialization code in C, a (small!)
 initial stack is set up in the internal Dual Ported RAM (in case CPUs
 which provide such a feature like MPC8xx or MPC8260), or in a locked
@@ -2873,7 +3033,7 @@ simple memory test is run that determines the size of the SDRAM
 banks.
 
 When there is more than one SDRAM bank, and the banks are of
-different size, the larger is mapped first. For equal size, the first
+different size, the largest is mapped first. For equal size, the first
 bank (CS2#) is mapped first. The first mapping is always for address
 0x00000000, with any additional banks following immediately to create
 contiguous memory starting from 0.
@@ -2999,6 +3159,11 @@ it:
   version of diff does not support these options, then get the latest
   version of GNU diff.
 
+  The current directory when running this command shall be the top
+  level directory of the U-Boot source tree, or it's parent directory
+  (i. e. please make sure that your patch includes sufficient
+  directory information for the affected files).
+
   We accept patches as plain text, MIME attachments or as uuencoded
   gzipped text.