Change all '$(...)' variable references into '${...}'
[platform/kernel/u-boot.git] / README
diff --git a/README b/README
index 95e552d..86db61b 100644 (file)
--- a/README
+++ b/README
@@ -1,5 +1,5 @@
 #
 #
-# (C) Copyright 2000 - 2004
+# (C) Copyright 2000 - 2005
 # Wolfgang Denk, DENX Software Engineering, wd@denx.de.
 #
 # See file CREDITS for list of people who contributed to this
 # Wolfgang Denk, DENX Software Engineering, wd@denx.de.
 #
 # See file CREDITS for list of people who contributed to this
@@ -25,9 +25,10 @@ Summary:
 ========
 
 This directory contains the source code for U-Boot, a boot loader for
 ========
 
 This directory contains the source code for U-Boot, a boot loader for
-Embedded boards based on PowerPC and ARM processors, which can be
-installed in a boot ROM and used to initialize and test the hardware
-or to download and run application code.
+Embedded boards based on PowerPC, ARM, MIPS and several other
+processors, which can be installed in a boot ROM and used to
+initialize and test the hardware or to download and run application
+code.
 
 The development of U-Boot is closely related to Linux: some parts of
 the source code originate in the Linux source tree, we have some
 
 The development of U-Boot is closely related to Linux: some parts of
 the source code originate in the Linux source tree, we have some
@@ -122,24 +123,29 @@ Directory Hierarchy:
 - board                Board dependent files
 - common       Misc architecture independent functions
 - cpu          CPU specific files
 - board                Board dependent files
 - common       Misc architecture independent functions
 - cpu          CPU specific files
-  - 74xx_7xx   Files specific to Motorola MPC74xx and 7xx CPUs
+  - 74xx_7xx   Files specific to Freescale MPC74xx and 7xx CPUs
   - arm720t    Files specific to ARM 720 CPUs
   - arm920t    Files specific to ARM 920 CPUs
   - arm720t    Files specific to ARM 720 CPUs
   - arm920t    Files specific to ARM 920 CPUs
+    - at91rm9200 Files specific to Atmel AT91RM9200 CPU
+    - imx      Files specific to Freescale MC9328 i.MX CPUs
+    - s3c24x0  Files specific to Samsung S3C24X0 CPUs
   - arm925t    Files specific to ARM 925 CPUs
   - arm926ejs  Files specific to ARM 926 CPUs
   - arm925t    Files specific to ARM 925 CPUs
   - arm926ejs  Files specific to ARM 926 CPUs
-  - at91rm9200 Files specific to Atmel AT91RM9200 CPUs
+  - arm1136    Files specific to ARM 1136 CPUs
   - i386       Files specific to i386 CPUs
   - ixp                Files specific to Intel XScale IXP CPUs
   - i386       Files specific to i386 CPUs
   - ixp                Files specific to Intel XScale IXP CPUs
-  - mcf52x2    Files specific to Motorola ColdFire MCF52x2 CPUs
+  - mcf52x2    Files specific to Freescale ColdFire MCF52x2 CPUs
   - mips       Files specific to MIPS CPUs
   - mips       Files specific to MIPS CPUs
-  - mpc5xx     Files specific to Motorola MPC5xx  CPUs
-  - mpc5xxx    Files specific to Motorola MPC5xxx CPUs
-  - mpc8xx     Files specific to Motorola MPC8xx  CPUs
-  - mpc824x    Files specific to Motorola MPC824x CPUs
-  - mpc8260    Files specific to Motorola MPC8260 CPUs
-  - mpc85xx    Files specific to Motorola MPC85xx CPUs
+  - mpc5xx     Files specific to Freescale MPC5xx  CPUs
+  - mpc5xxx    Files specific to Freescale MPC5xxx CPUs
+  - mpc8xx     Files specific to Freescale MPC8xx  CPUs
+  - mpc8220    Files specific to Freescale MPC8220 CPUs
+  - mpc824x    Files specific to Freescale MPC824x CPUs
+  - mpc8260    Files specific to Freescale MPC8260 CPUs
+  - mpc85xx    Files specific to Freescale MPC85xx CPUs
   - nios       Files specific to Altera NIOS CPUs
   - nios       Files specific to Altera NIOS CPUs
-  - ppc4xx     Files specific to IBM PowerPC 4xx CPUs
+  - nios2      Files specific to Altera Nios-II CPUs
+  - ppc4xx     Files specific to AMCC PowerPC 4xx CPUs
   - pxa                Files specific to Intel XScale PXA CPUs
   - s3c44b0    Files specific to Samsung S3C44B0 CPUs
   - sa1100     Files specific to Intel StrongARM SA1100 CPUs
   - pxa                Files specific to Intel XScale PXA CPUs
   - s3c44b0    Files specific to Samsung S3C44B0 CPUs
   - sa1100     Files specific to Intel StrongARM SA1100 CPUs
@@ -225,6 +231,7 @@ The following options need to be configured:
                -------------------
                CONFIG_MPC823,  CONFIG_MPC850,  CONFIG_MPC855,  CONFIG_MPC860
        or      CONFIG_MPC5xx
                -------------------
                CONFIG_MPC823,  CONFIG_MPC850,  CONFIG_MPC855,  CONFIG_MPC860
        or      CONFIG_MPC5xx
+       or      CONFIG_MPC8220
        or      CONFIG_MPC824X, CONFIG_MPC8260
        or      CONFIG_MPC85xx
        or      CONFIG_IOP480
        or      CONFIG_MPC824X, CONFIG_MPC8260
        or      CONFIG_MPC85xx
        or      CONFIG_IOP480
@@ -242,7 +249,11 @@ The following options need to be configured:
 
                MicroBlaze based CPUs:
                ----------------------
 
                MicroBlaze based CPUs:
                ----------------------
-               CONFIG_MICROBLZE
+               CONFIG_MICROBLAZE
+
+               Nios-2 based CPUs:
+               ----------------------
+               CONFIG_NIOS2
 
 
 - Board Type:  Define exactly one of
 
 
 - Board Type:  Define exactly one of
@@ -250,58 +261,67 @@ The following options need to be configured:
                PowerPC based boards:
                ---------------------
 
                PowerPC based boards:
                ---------------------
 
-               CONFIG_ADCIOP           CONFIG_GEN860T          CONFIG_PCI405
-               CONFIG_ADS860           CONFIG_GENIETV          CONFIG_PCIPPC2
-               CONFIG_AMX860           CONFIG_GTH              CONFIG_PCIPPC6
-               CONFIG_AR405            CONFIG_gw8260           CONFIG_pcu_e
-               CONFIG_BAB7xx           CONFIG_hermes           CONFIG_PIP405
-               CONFIG_c2mon            CONFIG_hymod            CONFIG_PM826
-               CONFIG_CANBT            CONFIG_IAD210           CONFIG_ppmc8260
-               CONFIG_CCM              CONFIG_ICU862           CONFIG_QS823
-               CONFIG_CMI              CONFIG_IP860            CONFIG_QS850
-               CONFIG_cogent_mpc8260   CONFIG_IPHASE4539       CONFIG_QS860T
-               CONFIG_cogent_mpc8xx    CONFIG_IVML24           CONFIG_RBC823
-               CONFIG_CPCI405          CONFIG_IVML24_128       CONFIG_RPXClassic
-               CONFIG_CPCI4052         CONFIG_IVML24_256       CONFIG_RPXlite
-               CONFIG_CPCIISER4        CONFIG_IVMS8            CONFIG_RPXsuper
-               CONFIG_CPU86            CONFIG_IVMS8_128        CONFIG_rsdproto
-               CONFIG_CRAYL1           CONFIG_IVMS8_256        CONFIG_sacsng
-               CONFIG_CSB272           CONFIG_JSE              CONFIG_Sandpoint8240
-               CONFIG_CU824            CONFIG_LANTEC           CONFIG_Sandpoint8245
-               CONFIG_DASA_SIM         CONFIG_lwmon            CONFIG_sbc8260
-               CONFIG_DB64360          CONFIG_MBX              CONFIG_SM850
-               CONFIG_DB64460          CONFIG_MBX860T          CONFIG_SPD823TS
-               CONFIG_DU405            CONFIG_MHPC             CONFIG_STXGP3
-               CONFIG_DUET_ADS         CONFIG_MIP405           CONFIG_SXNI855T
-               CONFIG_EBONY            CONFIG_MOUSSE           CONFIG_TQM823L
-               CONFIG_ELPPC            CONFIG_MPC8260ADS       CONFIG_TQM8260
-               CONFIG_ELPT860          CONFIG_MPC8540ADS       CONFIG_TQM850L
-               CONFIG_ep8260           CONFIG_MPC8560ADS       CONFIG_TQM855L
-               CONFIG_ERIC             CONFIG_MUSENKI          CONFIG_TQM860L
-               CONFIG_ESTEEM192E       CONFIG_MVS1             CONFIG_TTTech
-               CONFIG_ETX094           CONFIG_NETPHONE         CONFIG_UTX8245
-               CONFIG_EVB64260         CONFIG_NETTA            CONFIG_V37
-               CONFIG_FADS823          CONFIG_NETVIA           CONFIG_W7OLMC
-               CONFIG_FADS850SAR       CONFIG_NX823            CONFIG_W7OLMG
-               CONFIG_FADS860T         CONFIG_OCRTC            CONFIG_WALNUT405
-               CONFIG_FLAGADM          CONFIG_ORSG             CONFIG_ZPC1900
-               CONFIG_FPS850L          CONFIG_OXC              CONFIG_ZUMA
-               CONFIG_FPS860L
+               CONFIG_ADCIOP           CONFIG_GEN860T          CONFIG_PCIPPC2
+               CONFIG_ADS860           CONFIG_GENIETV          CONFIG_PCIPPC6
+               CONFIG_AMX860           CONFIG_GTH              CONFIG_pcu_e
+               CONFIG_AP1000           CONFIG_gw8260           CONFIG_PIP405
+               CONFIG_AR405            CONFIG_hermes           CONFIG_PM826
+               CONFIG_BAB7xx           CONFIG_hymod            CONFIG_ppmc8260
+               CONFIG_c2mon            CONFIG_IAD210           CONFIG_QS823
+               CONFIG_CANBT            CONFIG_ICU862           CONFIG_QS850
+               CONFIG_CCM              CONFIG_IP860            CONFIG_QS860T
+               CONFIG_CMI              CONFIG_IPHASE4539       CONFIG_RBC823
+               CONFIG_cogent_mpc8260   CONFIG_IVML24           CONFIG_RPXClassic
+               CONFIG_cogent_mpc8xx    CONFIG_IVML24_128       CONFIG_RPXlite
+               CONFIG_CPCI405          CONFIG_IVML24_256       CONFIG_RPXsuper
+               CONFIG_CPCI4052         CONFIG_IVMS8            CONFIG_rsdproto
+               CONFIG_CPCIISER4        CONFIG_IVMS8_128        CONFIG_sacsng
+               CONFIG_CPU86            CONFIG_IVMS8_256        CONFIG_Sandpoint8240
+               CONFIG_CRAYL1           CONFIG_JSE              CONFIG_Sandpoint8245
+               CONFIG_CSB272           CONFIG_LANTEC           CONFIG_sbc8260
+               CONFIG_CU824            CONFIG_lwmon            CONFIG_sbc8560
+               CONFIG_DASA_SIM         CONFIG_MBX              CONFIG_SM850
+               CONFIG_DB64360          CONFIG_MBX860T          CONFIG_SPD823TS
+               CONFIG_DB64460          CONFIG_MHPC             CONFIG_STXGP3
+               CONFIG_DU405            CONFIG_MIP405           CONFIG_SXNI855T
+               CONFIG_DUET_ADS         CONFIG_MOUSSE           CONFIG_TQM823L
+               CONFIG_EBONY            CONFIG_MPC8260ADS       CONFIG_TQM8260
+               CONFIG_ELPPC            CONFIG_MPC8540ADS       CONFIG_TQM850L
+               CONFIG_ELPT860          CONFIG_MPC8540EVAL      CONFIG_TQM855L
+               CONFIG_ep8260           CONFIG_MPC8560ADS       CONFIG_TQM860L
+               CONFIG_ERIC             CONFIG_MUSENKI          CONFIG_TTTech
+               CONFIG_ESTEEM192E       CONFIG_MVS1             CONFIG_UTX8245
+               CONFIG_ETX094           CONFIG_NETPHONE         CONFIG_V37
+               CONFIG_EVB64260         CONFIG_NETTA            CONFIG_W7OLMC
+               CONFIG_FADS823          CONFIG_NETVIA           CONFIG_W7OLMG
+               CONFIG_FADS850SAR       CONFIG_NX823            CONFIG_WALNUT
+               CONFIG_FADS860T         CONFIG_OCRTC            CONFIG_ZPC1900
+               CONFIG_FLAGADM          CONFIG_ORSG             CONFIG_ZUMA
+               CONFIG_FPS850L          CONFIG_OXC
+               CONFIG_FPS860L          CONFIG_PCI405
 
                ARM based boards:
                -----------------
 
 
                ARM based boards:
                -----------------
 
-               CONFIG_AT91RM9200DK,            CONFIG_DNP1110,         CONFIG_EP7312,
-               CONFIG_H2_OMAP1610,             CONFIG_HHP_CRADLE,      CONFIG_IMPA7,
-               CONFIG_INNOVATOROMAP1510,   CONFIG_INNOVATOROMAP1610,   CONFIG_LART,
-               CONFIG_LUBBOCK,                 CONFIG_SHANNON,         CONFIG_SMDK2400,
-               CONFIG_SMDK2410,                CONFIG_TRAB,            CONFIG_VCMA9,
+               CONFIG_ARMADILLO,       CONFIG_AT91RM9200DK,    CONFIG_CERF250,
+               CONFIG_CSB637,          CONFIG_DNP1110,         CONFIG_EP7312,
+               CONFIG_H2_OMAP1610,     CONFIG_HHP_CRADLE,      CONFIG_IMPA7,
+               CONFIG_INNOVATOROMAP1510, CONFIG_INNOVATOROMAP1610, CONFIG_KB9202,
+               CONFIG_LART,            CONFIG_LPD7A400,        CONFIG_LUBBOCK,
+               CONFIG_OSK_OMAP5912,    CONFIG_OMAP2420H4,      CONFIG_SHANNON,
+               CONFIG_P2_OMAP730,      CONFIG_SMDK2400,        CONFIG_SMDK2410,
+               CONFIG_TRAB,            CONFIG_VCMA9
 
                MicroBlaze based boards:
                ------------------------
 
                CONFIG_SUZAKU
 
 
                MicroBlaze based boards:
                ------------------------
 
                CONFIG_SUZAKU
 
+               Nios-2 based boards:
+               ------------------------
+
+               CONFIG_PCI5441 CONFIG_PK1C20
+
 
 - CPU Module Type: (if CONFIG_COGENT is defined)
                Define exactly one of
 
 - CPU Module Type: (if CONFIG_COGENT is defined)
                Define exactly one of
@@ -337,16 +357,17 @@ The following options need to be configured:
                CONFIG_MPC8240, CONFIG_MPC8245
 
 - 8xx CPU Options: (if using an MPC8xx cpu)
                CONFIG_MPC8240, CONFIG_MPC8245
 
 - 8xx CPU Options: (if using an MPC8xx cpu)
-               Define one or more of
-               CONFIG_8xx_GCLK_FREQ    - if get_gclk_freq() cannot work
+               CONFIG_8xx_GCLK_FREQ    - deprecated: CPU clock if
+                                         get_gclk_freq() cannot work
                                          e.g. if there is no 32KHz
                                          reference PIT/RTC clock
                                          e.g. if there is no 32KHz
                                          reference PIT/RTC clock
+               CONFIG_8xx_OSCLK        - PLL input clock (either EXTCLK
+                                         or XTAL/EXTAL)
 
 
-- 859/866 CPU options: (if using a MPC859 or MPC866 CPU):
-               CFG_866_OSCCLK
-               CFG_866_CPUCLK_MIN
-               CFG_866_CPUCLK_MAX
-               CFG_866_CPUCLK_DEFAULT
+- 859/866/885 CPU options: (if using a MPC859 or MPC866 or MPC885 CPU):
+               CFG_8xx_CPUCLK_MIN
+               CFG_8xx_CPUCLK_MAX
+               CONFIG_8xx_CPUCLK_DEFAULT
                        See doc/README.MPC866
 
                CFG_MEASURE_CPUCLK
                        See doc/README.MPC866
 
                CFG_MEASURE_CPUCLK
@@ -356,7 +377,7 @@ The following options need to be configured:
                values. Mostly useful for board bringup to make sure
                the PLL is locked at the intended frequency. Note
                that this requires a (stable) reference clock (32 kHz
                values. Mostly useful for board bringup to make sure
                the PLL is locked at the intended frequency. Note
                that this requires a (stable) reference clock (32 kHz
-               RTC clock),
+               RTC clock or CFG_8XX_XIN)
 
 - Linux Kernel Interface:
                CONFIG_CLOCKS_IN_MHZ
 
 - Linux Kernel Interface:
                CONFIG_CLOCKS_IN_MHZ
@@ -378,6 +399,41 @@ The following options need to be configured:
                expect it to be in bytes, others in MB.
                Define CONFIG_MEMSIZE_IN_BYTES to make it in bytes.
 
                expect it to be in bytes, others in MB.
                Define CONFIG_MEMSIZE_IN_BYTES to make it in bytes.
 
+               CONFIG_OF_FLAT_TREE
+
+               New kernel versions are expecting firmware settings to be
+               passed using flat open firmware trees.
+               The environment variable "disable_of", when set, disables this
+               functionality.
+
+               CONFIG_OF_FLAT_TREE_MAX_SIZE
+
+               The maximum size of the constructed OF tree.
+
+               OF_CPU - The proper name of the cpus node.
+               OF_TBCLK - The timebase frequency.
+
+- Serial Ports:
+               CFG_PL010_SERIAL
+
+               Define this if you want support for Amba PrimeCell PL010 UARTs.
+
+               CFG_PL011_SERIAL
+
+               Define this if you want support for Amba PrimeCell PL011 UARTs.
+
+               CONFIG_PL011_CLOCK
+
+               If you have Amba PrimeCell PL011 UARTs, set this variable to
+               the clock speed of the UARTs.
+
+               CONFIG_PL01x_PORTS
+
+               If you have Amba PrimeCell PL010 or PL011 UARTs on your board,
+               define this to a list of base addresses for each (supported)
+               port. See e.g. include/configs/versatile.h
+
+
 - Console Interface:
                Depending on board, define exactly one serial port
                (like CONFIG_8xx_CONS_SMC1, CONFIG_8xx_CONS_SMC2,
 - Console Interface:
                Depending on board, define exactly one serial port
                (like CONFIG_8xx_CONS_SMC1, CONFIG_8xx_CONS_SMC2,
@@ -457,7 +513,7 @@ The following options need to be configured:
 - Console UART Number:
                CONFIG_UART1_CONSOLE
 
 - Console UART Number:
                CONFIG_UART1_CONSOLE
 
-               IBM PPC4xx only.
+               AMCC PPC4xx only.
                If defined internal UART1 (and not UART0) is used
                as default U-Boot console.
 
                If defined internal UART1 (and not UART0) is used
                as default U-Boot console.
 
@@ -539,22 +595,23 @@ The following options need to be configured:
                CFG_CMD_ASKENV  * ask for env variable
                CFG_CMD_AUTOSCRIPT Autoscript Support
                CFG_CMD_BDI       bdinfo
                CFG_CMD_ASKENV  * ask for env variable
                CFG_CMD_AUTOSCRIPT Autoscript Support
                CFG_CMD_BDI       bdinfo
-               CFG_CMD_BEDBUG    Include BedBug Debugger
+               CFG_CMD_BEDBUG  * Include BedBug Debugger
                CFG_CMD_BMP     * BMP support
                CFG_CMD_BMP     * BMP support
+               CFG_CMD_BSP     * Board specific commands
                CFG_CMD_BOOTD     bootd
                CFG_CMD_BOOTD     bootd
-               CFG_CMD_CACHE     icache, dcache
+               CFG_CMD_CACHE   * icache, dcache
                CFG_CMD_CONSOLE   coninfo
                CFG_CMD_DATE    * support for RTC, date/time...
                CFG_CMD_CONSOLE   coninfo
                CFG_CMD_DATE    * support for RTC, date/time...
-               CFG_CMD_DHCP      DHCP support
+               CFG_CMD_DHCP    * DHCP support
                CFG_CMD_DIAG    * Diagnostics
                CFG_CMD_DOC     * Disk-On-Chip Support
                CFG_CMD_DIAG    * Diagnostics
                CFG_CMD_DOC     * Disk-On-Chip Support
-               CFG_CMD_DTT       Digital Therm and Thermostat
+               CFG_CMD_DTT     * Digital Therm and Thermostat
                CFG_CMD_ECHO    * echo arguments
                CFG_CMD_EEPROM  * EEPROM read/write support
                CFG_CMD_ECHO    * echo arguments
                CFG_CMD_EEPROM  * EEPROM read/write support
-               CFG_CMD_ELF       bootelf, bootvx
+               CFG_CMD_ELF     * bootelf, bootvx
                CFG_CMD_ENV       saveenv
                CFG_CMD_FDC     * Floppy Disk Support
                CFG_CMD_ENV       saveenv
                CFG_CMD_FDC     * Floppy Disk Support
-               CFG_CMD_FAT       FAT partition support
+               CFG_CMD_FAT     * FAT partition support
                CFG_CMD_FDOS    * Dos diskette Support
                CFG_CMD_FLASH     flinfo, erase, protect
                CFG_CMD_FPGA      FPGA device initialization support
                CFG_CMD_FDOS    * Dos diskette Support
                CFG_CMD_FLASH     flinfo, erase, protect
                CFG_CMD_FPGA      FPGA device initialization support
@@ -565,16 +622,16 @@ The following options need to be configured:
                CFG_CMD_IMLS      List all found images
                CFG_CMD_IMMAP   * IMMR dump support
                CFG_CMD_IRQ     * irqinfo
                CFG_CMD_IMLS      List all found images
                CFG_CMD_IMMAP   * IMMR dump support
                CFG_CMD_IRQ     * irqinfo
-               CFG_CMD_ITEST   * Integer/string test of 2 values
+               CFG_CMD_ITEST     Integer/string test of 2 values
                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,
                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
+                                 loop, loopw, mtest
                CFG_CMD_MISC      Misc functions like sleep etc
                CFG_CMD_MISC      Misc functions like sleep etc
-               CFG_CMD_MMC       MMC memory mapped support
-               CFG_CMD_MII       MII utility commands
+               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_NAND    * NAND support
                CFG_CMD_NET       bootp, tftpboot, rarpboot
                CFG_CMD_PCI     * pciinfo
@@ -583,9 +640,10 @@ The following options need to be configured:
                CFG_CMD_PORTIO  * Port I/O
                CFG_CMD_REGINFO * Register dump
                CFG_CMD_RUN       run command in env variable
                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_SAVES   * save S record dump
                CFG_CMD_SCSI    * SCSI Support
                CFG_CMD_SDRAM   * print SDRAM configuration information
                CFG_CMD_SCSI    * SCSI Support
                CFG_CMD_SDRAM   * print SDRAM configuration information
+                                 (requires CFG_CMD_I2C)
                CFG_CMD_SETGETDCR Support for DCR Register access (4xx only)
                CFG_CMD_SPI     * SPI serial bus support
                CFG_CMD_USB     * USB support
                CFG_CMD_SETGETDCR Support for DCR Register access (4xx only)
                CFG_CMD_SPI     * SPI serial bus support
                CFG_CMD_USB     * USB support
@@ -595,13 +653,13 @@ The following options need to be configured:
                -----------------------------------------------
                CFG_CMD_ALL     all
 
                -----------------------------------------------
                CFG_CMD_ALL     all
 
-               CFG_CMD_DFL     Default configuration; at the moment
+               CONFIG_CMD_DFL  Default configuration; at the moment
                                this is includes all commands, except
                                the ones marked with "*" in the list
                                above.
 
                If you don't define CONFIG_COMMANDS it defaults to
                                this is includes all commands, except
                                the ones marked with "*" in the list
                                above.
 
                If you don't define CONFIG_COMMANDS it defaults to
-               CFG_CMD_DFL in include/cmd_confdefs.h. A board can
+               CONFIG_CMD_DFL in include/cmd_confdefs.h. A board can
                override the default settings in the respective
                include file.
 
                override the default settings in the respective
                include file.
 
@@ -651,6 +709,7 @@ The following options need to be configured:
                CONFIG_RTC_DS1337       - use Maxim, Inc. DS1337 RTC
                CONFIG_RTC_DS1338       - use Maxim, Inc. DS1338 RTC
                CONFIG_RTC_DS164x       - use Dallas DS164x RTC
                CONFIG_RTC_DS1337       - use Maxim, Inc. DS1337 RTC
                CONFIG_RTC_DS1338       - use Maxim, Inc. DS1338 RTC
                CONFIG_RTC_DS164x       - use Dallas DS164x RTC
+               CONFIG_RTC_MAX6900      - use Maxim, Inc. MAX6900 RTC
 
                Note that if the RTC uses I2C, then the I2C interface
                must also be configured. See I2C Support, below.
 
                Note that if the RTC uses I2C, then the I2C interface
                must also be configured. See I2C Support, below.
@@ -740,12 +799,26 @@ The following options need to be configured:
                        CONFIG_LAN91C96_USE_32_BIT
                        Define this to enable 32 bit addressing
 
                        CONFIG_LAN91C96_USE_32_BIT
                        Define this to enable 32 bit addressing
 
+               CONFIG_DRIVER_SMC91111
+               Support for SMSC's LAN91C111 chip
+
+                       CONFIG_SMC91111_BASE
+                       Define this to hold the physical address
+                       of the device (I/O space)
+
+                       CONFIG_SMC_USE_32_BIT
+                       Define this if data bus is 32 bits
+
+                       CONFIG_SMC_USE_IOFUNCS
+                       Define this to use i/o functions instead of macros
+                       (some hardware wont work with macros)
+
 - USB Support:
                At the moment only the UHCI host controller is
                supported (PIP405, MIP405, MPC5200); define
                CONFIG_USB_UHCI to enable it.
                define CONFIG_USB_KEYBOARD to enable the USB Keyboard
 - USB Support:
                At the moment only the UHCI host controller is
                supported (PIP405, MIP405, MPC5200); define
                CONFIG_USB_UHCI to enable it.
                define CONFIG_USB_KEYBOARD to enable the USB Keyboard
-               end define CONFIG_USB_STORAGE to enable the USB
+               and define CONFIG_USB_STORAGE to enable the USB
                storage devices.
                Note:
                Supported are USB Keyboards and USB Floppy drives
                storage devices.
                Note:
                Supported are USB Keyboards and USB Floppy drives
@@ -766,6 +839,24 @@ The following options need to be configured:
                enabled with CFG_CMD_MMC. The MMC driver also works with
                the FAT fs. This is enabled with CFG_CMD_FAT.
 
                enabled with CFG_CMD_MMC. The MMC driver also works with
                the FAT fs. This is enabled with CFG_CMD_FAT.
 
+- Journaling Flash filesystem support:
+               CONFIG_JFFS2_NAND, CONFIG_JFFS2_NAND_OFF, CONFIG_JFFS2_NAND_SIZE,
+               CONFIG_JFFS2_NAND_DEV
+               Define these for a default partition on a NAND device
+
+               CFG_JFFS2_FIRST_SECTOR,
+               CFG_JFFS2_FIRST_BANK, CFG_JFFS2_NUM_BANKS
+               Define these for a default partition on a NOR device
+
+               CFG_JFFS_CUSTOM_PART
+               Define this to create an own partition. You have to provide a
+               function struct part_info* jffs2_part_info(int part_num)
+
+               If you define only one JFFS2 partition you may also want to
+               #define CFG_JFFS_SINGLE_PART    1
+               to disable the command chpart. This is the default when you
+               have not defined a custom partition
+
 - Keyboard Support:
                CONFIG_ISA_KEYBOARD
 
 - Keyboard Support:
                CONFIG_ISA_KEYBOARD
 
@@ -879,12 +970,18 @@ The following options need to be configured:
                If this option is set, the environment is checked for
                a variable "splashimage". If found, the usual display
                of logo, copyright and system information on the LCD
                If this option is set, the environment is checked for
                a variable "splashimage". If found, the usual display
                of logo, copyright and system information on the LCD
-               is supressed and the BMP image at the address
+               is suppressed and the BMP image at the address
                specified in "splashimage" is loaded instead. The
                console is redirected to the "nulldev", too. This
                allows for a "silent" boot where a splash screen is
                loaded very quickly after power-on.
 
                specified in "splashimage" is loaded instead. The
                console is redirected to the "nulldev", too. This
                allows for a "silent" boot where a splash screen is
                loaded very quickly after power-on.
 
+- Gzip compressed BMP image support: CONFIG_VIDEO_BMP_GZIP
+
+               If this option is set, additionally to standard BMP
+               images, gzipped BMP images can be displayed via the
+               splashscreen support or the bmp command.
+
 - Compression support:
                CONFIG_BZIP2
 
 - Compression support:
                CONFIG_BZIP2
 
@@ -1280,7 +1377,7 @@ The following options need to be configured:
                remaining RAM in a form that can be passed as boot
                argument to Linux, for instance like that:
 
                remaining RAM in a form that can be passed as boot
                argument to Linux, for instance like that:
 
-                       setenv bootargs ... mem=\$(mem)
+                       setenv bootargs ... mem=\${mem}
                        saveenv
 
                This way you can tell Linux not to use this memory,
                        saveenv
 
                This way you can tell Linux not to use this memory,
@@ -1406,6 +1503,26 @@ The following options need to be configured:
                When SystemACE support is added, the "ace" device type
                becomes available to the fat commands, i.e. fatls.
 
                When SystemACE support is added, the "ace" device type
                becomes available to the fat commands, i.e. fatls.
 
+- TFTP Fixed UDP Port:
+               CONFIG_TFTP_PORT
+
+               If this is defined, the environment variable tftpsrcp
+               is used to supply the TFTP UDP source port value.
+               If tftpsrcp isn't defined, the normal pseudo-random port
+               number generator is used.
+
+               Also, the environment variable tftpdstp is used to supply
+               the TFTP UDP destination port value.  If tftpdstp isn't
+               defined, the normal port 69 is used.
+
+               The purpose for tftpsrcp is to allow a TFTP server to
+               blindly start the TFTP transfer using the pre-configured
+               target IP address and UDP port. This has the effect of
+               "punching through" the (Windows XP) firewall, allowing
+               the remainder of the TFTP transfer to proceed normally.
+               A better solution is to properly configure the firewall,
+               but sometimes that is not allowed.
+
 - Show boot progress:
                CONFIG_SHOW_BOOT_PROGRESS
 
 - Show boot progress:
                CONFIG_SHOW_BOOT_PROGRESS
 
@@ -1812,6 +1929,16 @@ to save the current settings.
          environment area within the total memory of your DataFlash placed
          at the specified address.
 
          environment area within the total memory of your DataFlash placed
          at the specified address.
 
+- CFG_ENV_IS_IN_NAND:
+
+       Define this if you have a NAND device which you want to use
+       for the environment.
+
+       - CFG_ENV_OFFSET:
+       - CFG_ENV_SIZE:
+
+         These two #defines specify the offset and size of the environment
+         area within the first NAND device.
 
 - CFG_SPI_INIT_OFFSET
 
 
 - CFG_SPI_INIT_OFFSET
 
@@ -1894,9 +2021,9 @@ Low Level (hardware related) configuration options:
                source code. It is used to make hardware dependant
                initializations.
 
                source code. It is used to make hardware dependant
                initializations.
 
-- CFG_IMMR:    Physical address of the Internal Memory Mapped
-               Register; DO NOT CHANGE! (11-4)
-               [MPC8xx systems only]
+- CFG_IMMR:    Physical address of the Internal Memory.
+               DO NOT CHANGE unless you know exactly what you're
+               doing! (11-4) [MPC8xx/82xx systems only]
 
 - CFG_INIT_RAM_ADDR:
 
 
 - CFG_INIT_RAM_ADDR:
 
@@ -2026,6 +2153,37 @@ Low Level (hardware related) configuration options:
                and crc32 is the correct crc32 which the
                area should have.
 
                and crc32 is the correct crc32 which the
                area should have.
 
+- CONFIG_LOOPW
+               Add the "loopw" memory command. This only takes effect if
+               the memory commands are activated globally (CFG_CMD_MEM).
+
+- CONFIG_MX_CYCLIC
+               Add the "mdc" and "mwc" memory commands. These are cyclic
+               "md/mw" commands.
+               Examples:
+
+               => mdc.b 10 4 500
+               This command will print 4 bytes (10,11,12,13) each 500 ms.
+
+               => mwc.l 100 12345678 10
+               This command will write 12345678 to address 100 all 10 ms.
+
+               This only takes effect if the memory commands are activated
+               globally (CFG_CMD_MEM).
+
+- CONFIG_SKIP_LOWLEVEL_INIT
+- CONFIG_SKIP_RELOCATE_UBOOT
+
+               [ARM only] If these variables are defined, then
+               certain low level initializations (like setting up
+               the memory controller) are omitted and/or U-Boot does
+               not relocate itself into RAM.
+               Normally these variables MUST NOT be defined. The
+               only exception is when U-Boot is loaded (to RAM) by
+               some other boot loader or by a debugger which
+               performs these intializations itself.
+
+
 Building the Software:
 ======================
 
 Building the Software:
 ======================
 
@@ -2053,27 +2211,32 @@ is done by typing:
 where "NAME_config" is the name of one of the existing
 configurations; the following names are supported:
 
 where "NAME_config" is the name of one of the existing
 configurations; the following names are supported:
 
-       ADCIOP_config           FPS850L_config          omap1610inn_config
-       ADS860_config           FPS860L_config          pcu_e_config
-       AR405_config            GEN860T_config          PIP405_config
-       at91rm9200dk_config     GENIETV_config          QS823_config
-       CANBT_config            GTH_config              QS850_config
-       cmi_mpc5xx_config       hermes_config           QS860T_config
-       cogent_common_config    hymod_config            RPXlite_config
-       cogent_mpc8260_config   IP860_config            RPXsuper_config
-       cogent_mpc8xx_config    IVML24_config           rsdproto_config
-       CPCI405_config          IVMS8_config            Sandpoint8240_config
-       CPCIISER4_config        JSE_config              sbc8260_config
-       csb272_config           LANTEC_config           SM850_config
-       CU824_config            lwmon_config            SPD823TS_config
-       DUET_ADS_config         MBX860T_config          stxgp3_config
-       EBONY_config            MBX_config              SXNI855T_config
-       ELPT860_config          MPC8260ADS_config       TQM823L_config
-       ESTEEM192E_config       MPC8540ADS_config       TQM850L_config
-       ETX094_config           MPC8560ADS_config       TQM855L_config
-       FADS823_config          NETVIA_config           TQM860L_config
-       FADS850SAR_config       omap1510inn_config      WALNUT405_config
-       FADS860T_config         omap1610h2_config       ZPC1900_config
+       ADCIOP_config           FPS860L_config          omap730p2_config
+       ADS860_config           GEN860T_config          pcu_e_config
+       Alaska8220_config
+       AR405_config            GENIETV_config          PIP405_config
+       at91rm9200dk_config     GTH_config              QS823_config
+       CANBT_config            hermes_config           QS850_config
+       cmi_mpc5xx_config       hymod_config            QS860T_config
+       cogent_common_config    IP860_config            RPXlite_config
+       cogent_mpc8260_config   IVML24_config           RPXlite_DW_config
+       cogent_mpc8xx_config    IVMS8_config            RPXsuper_config
+       CPCI405_config          JSE_config              rsdproto_config
+       CPCIISER4_config        LANTEC_config           Sandpoint8240_config
+       csb272_config           lwmon_config            sbc8260_config
+       CU824_config            MBX860T_config          sbc8560_33_config
+       DUET_ADS_config         MBX_config              sbc8560_66_config
+       EBONY_config            MPC8260ADS_config       SM850_config
+       ELPT860_config          MPC8540ADS_config       SPD823TS_config
+       ESTEEM192E_config       MPC8540EVAL_config      stxgp3_config
+       ETX094_config           MPC8560ADS_config       SXNI855T_config
+       FADS823_config          NETVIA_config           TQM823L_config
+       FADS850SAR_config       omap1510inn_config      TQM850L_config
+       FADS860T_config         omap1610h2_config       TQM855L_config
+       FPS850L_config          omap1610inn_config      TQM860L_config
+                               omap5912osk_config      walnut_config
+                               omap2420h4_config       Yukon8220_config
+                                                       ZPC1900_config
 
 Note: for some board special configuration names may exist; check if
       additional information is available from the board vendor; for
 
 Note: for some board special configuration names may exist; check if
       additional information is available from the board vendor; for
@@ -2195,6 +2358,7 @@ iminfo    - print header information for application image
 coninfo - print console devices and informations
 ide    - IDE sub-system
 loop   - infinite loop on address range
 coninfo - print console devices and informations
 ide    - IDE sub-system
 loop   - infinite loop on address range
+loopw  - infinite write loop on address range
 mtest  - simple RAM test
 icache - enable or disable instruction cache
 dcache - enable or disable data cache
 mtest  - simple RAM test
 icache - enable or disable instruction cache
 dcache - enable or disable data cache
@@ -2324,6 +2488,12 @@ Some configuration options can be set using Environment Variables:
                  Useful on scripts which control the retry operation
                  themselves.
 
                  Useful on scripts which control the retry operation
                  themselves.
 
+  tftpsrcport  - If this is set, the value is used for TFTP's
+                 UDP source port.
+
+  tftpdstport  - If this is set, the value is used for TFTP's UDP
+                 destination port instead of the Well Know Port 69.
+
    vlan                - When set to a value < 4095 the traffic over
                  ethernet is encapsulated/received over 802.1q
                  VLAN tagged frames.
    vlan                - When set to a value < 4095 the traffic over
                  ethernet is encapsulated/received over 802.1q
                  VLAN tagged frames.
@@ -2376,10 +2546,10 @@ Old, simple command line parser:
 
 - supports environment variables (through setenv / saveenv commands)
 - several commands on one line, separated by ';'
 
 - supports environment variables (through setenv / saveenv commands)
 - several commands on one line, separated by ';'
-- variable substitution using "... $(name) ..." syntax
+- variable substitution using "... ${name} ..." syntax
 - special characters ('$', ';') can be escaped by prefixing with '\',
   for example:
 - special characters ('$', ';') can be escaped by prefixing with '\',
   for example:
-       setenv bootcmd bootm \$(address)
+       setenv bootcmd bootm \${address}
 - You can also escape text by enclosing in single apostrophes, for example:
        setenv addip 'setenv bootargs $bootargs ip=$ipaddr:$serverip:$gatewayip:$netmask:$hostname::off'
 
 - You can also escape text by enclosing in single apostrophes, for example:
        setenv addip 'setenv bootargs $bootargs ip=$ipaddr:$serverip:$gatewayip:$netmask:$hostname::off'
 
@@ -2959,8 +3129,7 @@ Booting assumes that (the first part of) the image booted is a
 stage-2 loader which in turn loads and then invokes the kernel
 proper. Loader sources will eventually appear in the NetBSD source
 tree (probably in sys/arc/mpc8xx/stand/u-boot_stage2/); in the
 stage-2 loader which in turn loads and then invokes the kernel
 proper. Loader sources will eventually appear in the NetBSD source
 tree (probably in sys/arc/mpc8xx/stand/u-boot_stage2/); in the
-meantime, send mail to bruno@exet-ag.de and/or wd@denx.de for
-details.
+meantime, see ftp://ftp.denx.de/pub/u-boot/ppcboot_stage2.tar.gz
 
 
 Implementation Internals:
 
 
 Implementation Internals:
@@ -3014,7 +3183,7 @@ locked as (mis-) used as memory, etc.
        CFG_INIT_RAM_ADDR should be somewhere that won't interfere
        with your processor/board/system design. The default value
        you will find in any recent u-boot distribution in
        CFG_INIT_RAM_ADDR should be somewhere that won't interfere
        with your processor/board/system design. The default value
        you will find in any recent u-boot distribution in
-       Walnut405.h should work for you. I'd set it to a value larger
+       walnut.h should work for you. I'd set it to a value larger
        than your SDRAM module. If you have a 64MB SDRAM module, set
        it above 400_0000. Just make sure your board has no resources
        that are supposed to respond to that address! That code in
        than your SDRAM module. If you have a 64MB SDRAM module, set
        it above 400_0000. Just make sure your board has no resources
        that are supposed to respond to that address! That code in
@@ -3260,6 +3429,7 @@ Since the number of patches for U-Boot is growing, we need to
 establish some rules. Submissions which do not conform to these rules
 may be rejected, even when they contain important and valuable stuff.
 
 establish some rules. Submissions which do not conform to these rules
 may be rejected, even when they contain important and valuable stuff.
 
+Patches shall be sent to the u-boot-users mailing list.
 
 When you send a patch, please include the following information with
 it:
 
 When you send a patch, please include the following information with
 it:
@@ -3317,3 +3487,6 @@ Notes:
   (using #ifdef), and the resulting code with the new feature
   disabled must not need more memory than the old code without your
   modification.
   (using #ifdef), and the resulting code with the new feature
   disabled must not need more memory than the old code without your
   modification.
+
+* Remember that there is a size limit of 40 kB per message on the
+  u-boot-users mailing list. Compression may help.