Skip to content
Snippets Groups Projects
README 117 KiB
Newer Older
  • Learn to ignore specific revisions
  • Wolfgang Denk's avatar
    Wolfgang Denk committed
    		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 suppressed and the BMP image at the address
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		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
    
    		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.
    
    - MII/PHY support:
    		CONFIG_PHY_ADDR
    
    		The address of PHY on MII bus.
    
    		CONFIG_PHY_CLOCK_FREQ (ppc4xx)
    
    		The clock frequency of the MII bus
    
    		CONFIG_PHY_GIGE
    
    		If this option is set, support for speed/duplex
    		detection of Gigabit PHY is included.
    
    		CONFIG_PHY_RESET_DELAY
    
    		Some PHY like Intel LXT971A need extra delay after
    		reset before any MII register access is possible.
    		For such PHY, set this option to the usec delay
    		required. (minimum 300usec for LXT971A)
    
    		CONFIG_PHY_CMD_DELAY (ppc4xx)
    
    		Some PHY like Intel LXT971A need extra delay after
    		command issued before MII status register can be read
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    - Ethernet address:
    		CONFIG_ETHADDR
    		CONFIG_ETH2ADDR
    		CONFIG_ETH3ADDR
    
    		Define a default value for ethernet address to use
    		for the respective ethernet interface, in case this
    		is not determined automatically.
    
    - IP address:
    		CONFIG_IPADDR
    
    		Define a default value for the IP address to use for
    		the default ethernet interface, in case this is not
    		determined through e.g. bootp.
    
    - Server IP address:
    		CONFIG_SERVERIP
    
    		Defines a default value for theIP address of a TFTP
    		server to contact when using the "tftboot" command.
    
    - BOOTP Recovery Mode:
    		CONFIG_BOOTP_RANDOM_DELAY
    
    		If you have many targets in a network that try to
    		boot using BOOTP, you may want to avoid that all
    		systems send out BOOTP requests at precisely the same
    		moment (which would happen for instance at recovery
    		from a power failure, when all systems will try to
    		boot, thus flooding the BOOTP server. Defining
    		CONFIG_BOOTP_RANDOM_DELAY causes a random delay to be
    		inserted before sending out BOOTP requests. The
    		following delays are insterted then:
    
    		1st BOOTP request:	delay 0 ... 1 sec
    		2nd BOOTP request:	delay 0 ... 2 sec
    		3rd BOOTP request:	delay 0 ... 4 sec
    		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.
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		CONFIG_CDP_DEVICE_ID
    
    
    		The device id used in CDP trigger frames.
    
    		CONFIG_CDP_DEVICE_ID_PREFIX
    
    		A two character string which is prefixed to the MAC address
    		of the device.
    
    		CONFIG_CDP_PORT_ID
    
    		A printf format string which contains the ascii name of
    		the port. Normally is set to "eth%d" which sets
    		eth0 for the first ethernet, eth1 for the second etc.
    
    		CONFIG_CDP_CAPABILITIES
    
    		A 32bit integer which indicates the device capabilities;
    		0x00000010 for a normal host which does not forwards.
    
    		CONFIG_CDP_VERSION
    
    		An ascii string containing the version of the software.
    
    		CONFIG_CDP_PLATFORM
    
    		An ascii string containing the name of the platform.
    
    		CONFIG_CDP_TRIGGER
    
    		A 32bit integer sent on the trigger.
    
    		CONFIG_CDP_POWER_CONSUMPTION
    
    		A 16bit integer containing the power consumption of the
    		device in .1 of milliwatts.
    
    		CONFIG_CDP_APPLIANCE_VLAN_TYPE
    
    		A byte containing the id of the VLAN.
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    - Status LED:	CONFIG_STATUS_LED
    
    		Several configurations allow to display the current
    		status using a LED. For instance, the LED will blink
    		fast while running U-Boot code, stop blinking as
    		soon as a reply to a BOOTP request was received, and
    		start blinking slow once the Linux kernel is running
    		(supported by a status LED driver in the Linux
    		kernel). Defining CONFIG_STATUS_LED enables this
    		feature in U-Boot.
    
    - CAN Support:	CONFIG_CAN_DRIVER
    
    		Defining CONFIG_CAN_DRIVER enables CAN driver support
    		on those systems that support this (optional)
    		feature, like the TQM8xxL modules.
    
    - I2C Support:	CONFIG_HARD_I2C | CONFIG_SOFT_I2C
    
    
    		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.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    		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.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    		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.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    		There are several other quantities that must also be
    
    		defined when you define CONFIG_HARD_I2C or CONFIG_SOFT_I2C.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    		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).
    
    
    		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.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    		That's all that's required for CONFIG_HARD_I2C.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    		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):
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		I2C_INIT
    
    
    		(Optional). Any commands necessary to enable the I2C
    
    		controller or configure ports.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    		eg: #define I2C_INIT (immr->im_cpm.cp_pbdir |=	PB_SCL)
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		I2C_PORT
    
    
    		(Only for MPC8260 CPU). The I/O port to use (the code
    		assumes both bits are on the same port). Valid values
    		are 0..3 for ports A..D.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		I2C_ACTIVE
    
    		The code necessary to make the I2C data line active
    		(driven).  If the data line is open collector, this
    		define can be null.
    
    
    		eg: #define I2C_ACTIVE (immr->im_cpm.cp_pbdir |=  PB_SDA)
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		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)
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		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)
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		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
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		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
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		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). Often defined to be something
    
    		#define I2C_DELAY  udelay(2)
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		When a board is reset during an i2c bus transfer
    		chips might think that the current transfer is still
    		in progress. On some boards it is possible to access
    		the i2c SCLK line directly, either by using the
    		processor pin as a GPIO or by having a second pin
    		connected to the bus. If this option is defined a
    		custom i2c_init_board() routine in boards/xxx/board.c
    		is run early in the boot sequence.
    
    		CONFIG_I2CFAST (PPC405GP|PPC405EP only)
    
    		This option enables configuration of bi_iic_fast[] flags
    		in u-boot bd_info structure based on u-boot environment
    		variable "i2cfast". (see also i2cfast)
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    - SPI Support:	CONFIG_SPI
    
    		Enables SPI driver (so far only tested with
    		SPI EEPROM, also an instance works with Crystal A/D and
    		D/As on the SACSng board)
    
    		CONFIG_SPI_X
    
    		Enables extended (16-bit) SPI EEPROM addressing.
    		(symmetrical to CONFIG_I2C_X)
    
    		CONFIG_SOFT_SPI
    
    
    		Enables a software (bit-bang) SPI driver rather than
    		using hardware support. This is a general purpose
    		driver that only requires three general I/O port pins
    		(two outputs, one input) to function. If this is
    		defined, the board configuration must define several
    		SPI configuration items (port pins to use, etc). For
    		an example, see include/configs/sacsng.h.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    - FPGA Support: CONFIG_FPGA_COUNT
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		Specify the number of FPGA devices to support.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		CONFIG_FPGA
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		Used to specify the types of FPGA devices.  For example,
    		#define CONFIG_FPGA  CFG_XILINX_VIRTEX2
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		CFG_FPGA_PROG_FEEDBACK
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		Enable printing of hash marks during FPGA configuration.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		CFG_FPGA_CHECK_BUSY
    
    
    		Enable checks on FPGA configuration interface busy
    		status by the configuration function. This option
    		will require a board or device specific function to
    		be written.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		CONFIG_FPGA_DELAY
    
    		If defined, a function that provides delays in the FPGA
    		configuration driver.
    
    		CFG_FPGA_CHECK_CTRLC
    		Allow Control-C to interrupt FPGA configuration
    
    		CFG_FPGA_CHECK_ERROR
    
    
    		Check for configuration errors during FPGA bitfile
    		loading. For example, abort during Virtex II
    		configuration if the INIT_B line goes low (which
    		indicated a CRC error).
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		CFG_FPGA_WAIT_INIT
    
    
    		Maximum time to wait for the INIT_B line to deassert
    		after PROB_B has been deasserted during a Virtex II
    		FPGA configuration sequence. The default time is 500
    		mS.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		CFG_FPGA_WAIT_BUSY
    
    
    		Maximum time to wait for BUSY to deassert during
    		Virtex II FPGA configuration. The default is 5 mS.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		CFG_FPGA_WAIT_CONFIG
    
    
    		Time to wait after FPGA configuration. The default is
    		200 mS.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    - Configuration Management:
    		CONFIG_IDENT_STRING
    
    
    		If defined, this string will be added to the U-Boot
    		version information (U_BOOT_VERSION)
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    - Vendor Parameter Protection:
    
    
    		U-Boot considers the values of the environment
    		variables "serial#" (Board Serial Number) and
    
    		"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,
    		and write or delete attempts are rejected. You can
    		change this behviour:
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		If CONFIG_ENV_OVERWRITE is #defined in your config
    		file, the write protection for vendor parameters is
    
    		completely disabled. Anybody can change or delete
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		these parameters.
    
    		Alternatively, if you #define _both_ CONFIG_ETHADDR
    		_and_ CONFIG_OVERWRITE_ETHADDR_ONCE, a default
    		ethernet address is installed in the environment,
    		which can be changed exactly ONCE by the user. [The
    		serial# is unaffected by this, i. e. it remains
    		read-only.]
    
    - Protected RAM:
    		CONFIG_PRAM
    
    		Define this variable to enable the reservation of
    		"protected RAM", i. e. RAM which is not overwritten
    		by U-Boot. Define CONFIG_PRAM to hold the number of
    		kB you want to reserve for pRAM. You can overwrite
    		this default value by defining an environment
    		variable "pram" to the number of kB you want to
    		reserve. Note that the board info structure will
    		still show the full amount of RAM. If pRAM is
    		reserved, a new environment variable "mem" will
    		automatically be defined to hold the amount of
    		remaining RAM in a form that can be passed as boot
    		argument to Linux, for instance like that:
    
    
    			setenv bootargs ... mem=\${mem}
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    			saveenv
    
    		This way you can tell Linux not to use this memory,
    		either, which results in a memory region that will
    		not be affected by reboots.
    
    		*WARNING* If your board configuration uses automatic
    		detection of the RAM size, you must make sure that
    		this memory test is non-destructive. So far, the
    		following board configurations are known to be
    		"pRAM-clean":
    
    			ETX094, IVMS8, IVML24, SPD8xx, TQM8xxL,
    			HERMES, IP860, RPXlite, LWMON, LANTEC,
    			PCU_E, FLAGADM, TQM8260
    
    - Error Recovery:
    		CONFIG_PANIC_HANG
    
    		Define this variable to stop the system in case of a
    		fatal error, so that you have to reset it manually.
    		This is probably NOT a good idea for an embedded
    		system where you want to system to reboot
    		automatically as fast as possible, but it may be
    		useful during development since you can try to debug
    		the conditions that lead to the situation.
    
    		CONFIG_NET_RETRY_COUNT
    
    
    		This variable defines the number of retries for
    		network operations like ARP, RARP, TFTP, or BOOTP
    		before giving up the operation. If not defined, a
    		default value of 5 is used.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    - Command Interpreter:
    
    		CFG_AUTO_COMPLETE
    
    		Enable auto completion of commands using TAB.
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		CFG_HUSH_PARSER
    
    		Define this variable to enable the "hush" shell (from
    		Busybox) as command line interpreter, thus enabling
    		powerful command line syntax like
    		if...then...else...fi conditionals or `&&' and '||'
    		constructs ("shell scripts").
    
    		If undefined, you get the old, much simpler behaviour
    		with a somewhat smaller memory footprint.
    
    
    		CFG_PROMPT_HUSH_PS2
    
    		This defines the secondary prompt string, which is
    		printed when the command interpreter needs more input
    		to complete a command. Usually "> ".
    
    	Note:
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		In the current implementation, the local variables
    		space and global environment variables space are
    		separated. Local variables are those you define by
    		simply typing `name=value'. To access a local
    		variable later on, you have write `$name' or
    		`${name}'; to execute the contents of a variable
    		directly type `$name' at the command prompt.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    		Global environment variables are those you use
    		setenv/printenv to work with. To run a command stored
    		in such a variable, you need to use the run command,
    		and you must not use the '$' sign to access them.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		To store commands and special characters in a
    		variable, please use double quotation marks
    		surrounding the whole text of the variable, instead
    		of the backslashes before semicolons and special
    		symbols.
    
    
    - Default Environment:
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		CONFIG_EXTRA_ENV_SETTINGS
    
    
    		Define this to contain any number of null terminated
    		strings (variable = value pairs) that will be part of
    
    		the default environment compiled into the boot image.
    
    		For example, place something like this in your
    		board's config file:
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		#define CONFIG_EXTRA_ENV_SETTINGS \
    			"myvar1=value1\0" \
    			"myvar2=value2\0"
    
    
    		Warning: This method is based on knowledge about the
    		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, there is no guarantee either.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		You better know what you are doing here.
    
    
    		Note: overly (ab)use of the default environment is
    		discouraged. Make sure to check other ways to preset
    		the environment like the autoscript function or the
    		boot command first.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    - DataFlash Support:
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		Defining this option enables DataFlash features and
    		allows to read/write in Dataflash via the standard
    		commands cp, md...
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    - SystemACE Support:
    		CONFIG_SYSTEMACE
    
    		Adding this option adds support for Xilinx SystemACE
    		chips attached via some sort of local bus. The address
    		of the chip must alsh be defined in the
    		CFG_SYSTEMACE_BASE macro. For example:
    
    		#define CONFIG_SYSTEMACE
    		#define CFG_SYSTEMACE_BASE 0xf0000000
    
    		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:
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		CONFIG_SHOW_BOOT_PROGRESS
    
    
    		Defining this option allows to add some board-
    		specific code (calling a user-provided function
    		"show_boot_progress(int)") that enables you to show
    		the system's boot progress on some display (for
    		example, some LED's) on your board. At the moment,
    		the following checkpoints are implemented:
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
      Arg	Where			When
        1	common/cmd_bootm.c	before attempting to boot an image
    
       -1	common/cmd_bootm.c	Image header has bad	 magic number
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
        2	common/cmd_bootm.c	Image header has correct magic number
    
       -2	common/cmd_bootm.c	Image header has bad	 checksum
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
        3	common/cmd_bootm.c	Image header has correct checksum
    
       -3	common/cmd_bootm.c	Image data   has bad	 checksum
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
        4	common/cmd_bootm.c	Image data   has correct checksum
       -4	common/cmd_bootm.c	Image is for unsupported architecture
        5	common/cmd_bootm.c	Architecture check OK
       -5	common/cmd_bootm.c	Wrong Image Type (not kernel, multi, standalone)
        6	common/cmd_bootm.c	Image Type check OK
       -6	common/cmd_bootm.c	gunzip uncompression error
       -7	common/cmd_bootm.c	Unimplemented compression type
        7	common/cmd_bootm.c	Uncompression OK
       -8	common/cmd_bootm.c	Wrong Image Type (not kernel, multi, standalone)
        8	common/cmd_bootm.c	Image Type check OK
       -9	common/cmd_bootm.c	Unsupported OS (not Linux, BSD, VxWorks, QNX)
        9	common/cmd_bootm.c	Start initial ramdisk verification
    
      -10	common/cmd_bootm.c	Ramdisk header has bad	   magic number
      -11	common/cmd_bootm.c	Ramdisk header has bad	   checksum
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
       10	common/cmd_bootm.c	Ramdisk header is OK
    
      -12	common/cmd_bootm.c	Ramdisk data   has bad	   checksum
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
       11	common/cmd_bootm.c	Ramdisk data   has correct checksum
       12	common/cmd_bootm.c	Ramdisk verification complete, start loading
      -13	common/cmd_bootm.c	Wrong Image Type (not PPC Linux Ramdisk)
       13	common/cmd_bootm.c	Start multifile image verification
       14	common/cmd_bootm.c	No initial ramdisk, no multifile, continue.
       15	common/cmd_bootm.c	All preparation done, transferring control to OS
    
    
      -30	lib_ppc/board.c		Fatal error, hang the system
      -31	post/post.c		POST test failed, detected by post_output_backlog()
      -32	post/post.c		POST test failed, detected by post_run_single()
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
       -1	common/cmd_doc.c	Bad usage of "doc" command
       -1	common/cmd_doc.c	No boot device
       -1	common/cmd_doc.c	Unknown Chip ID on boot device
       -1	common/cmd_doc.c	Read Error on boot device
       -1	common/cmd_doc.c	Image header has bad magic number
    
       -1	common/cmd_ide.c	Bad usage of "ide" command
       -1	common/cmd_ide.c	No boot device
       -1	common/cmd_ide.c	Unknown boot device
       -1	common/cmd_ide.c	Unknown partition table
       -1	common/cmd_ide.c	Invalid partition type
       -1	common/cmd_ide.c	Read Error on boot device
       -1	common/cmd_ide.c	Image header has bad magic number
    
    
       -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
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    Modem Support:
    --------------
    
    
    [so far only for SMDK2400 and TRAB boards]
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    - Modem support endable:
    		CONFIG_MODEM_SUPPORT
    
    - RTS/CTS Flow control enable:
    		CONFIG_HWFLOW
    
    - Modem debug support:
    		CONFIG_MODEM_SUPPORT_DEBUG
    
    
    		Enables debugging stuff (char screen[1024], dbg())
    		for modem support. Useful only with BDI2000.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    - Interrupt support (PPC):
    
    
    		There are common interrupt_init() and timer_interrupt()
    		for all PPC archs. interrupt_init() calls interrupt_init_cpu()
    		for cpu specific initialization. interrupt_init_cpu()
    		should set decrementer_count to appropriate value. If
    		cpu resets decrementer automatically after interrupt
    		(ppc4xx) it should set decrementer_count to zero.
    		timer_interrupt() calls timer_interrupt_cpu() for cpu
    		specific handling. If board has watchdog / status_led
    		/ other_activity_monitor it works automatically from
    		general timer_interrupt().
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    - General:
    
    
    		In the target system modem support is enabled when a
    		specific key (key combination) is pressed during
    		power-on. Otherwise U-Boot will boot normally
    		(autoboot). The key_pressed() fuction is called from
    		board_init(). Currently key_pressed() is a dummy
    		function, returning 1 and thus enabling modem
    		initialization.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    		If there are no modem init strings in the
    		environment, U-Boot proceed to autoboot; the
    		previous output (banner, info printfs) will be
    		supressed, though.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    		See also: doc/README.Modem
    
    
    Configuration Settings:
    -----------------------
    
    - CFG_LONGHELP: Defined when you want long help messages included;
    		undefine this when you're short of memory.
    
    - CFG_PROMPT:	This is what U-Boot prints on the console to
    		prompt for user input.
    
    - CFG_CBSIZE:	Buffer size for input from the Console
    
    - CFG_PBSIZE:	Buffer size for Console output
    
    - CFG_MAXARGS:	max. Number of arguments accepted for monitor commands
    
    - CFG_BARGSIZE: Buffer size for Boot Arguments which are passed to
    		the application (usually a Linux kernel) when it is
    		booted
    
    - CFG_BAUDRATE_TABLE:
    		List of legal baudrate settings for this board.
    
    - CFG_CONSOLE_INFO_QUIET
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		Suppress display of console information at boot.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    - CFG_CONSOLE_IS_IN_ENV
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		If the board specific function
    			extern int overwrite_console (void);
    		returns 1, the stdin, stderr and stdout are switched to the
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		serial port, else the settings in the environment are used.
    
    - CFG_CONSOLE_OVERWRITE_ROUTINE
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		Enable the call to overwrite_console().
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    - CFG_CONSOLE_ENV_OVERWRITE
    		Enable overwrite of previous console environment settings.
    
    - CFG_MEMTEST_START, CFG_MEMTEST_END:
    		Begin and End addresses of the area used by the
    		simple memory test.
    
    - CFG_ALT_MEMTEST:
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		Enable an alternate, more extensive memory test.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    - CFG_MEMTEST_SCRATCH:
    		Scratch address used by the alternate memory test
    		You only need to set this if address zero isn't writeable
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    - CFG_TFTP_LOADADDR:
    		Default load address for network file downloads
    
    - CFG_LOADS_BAUD_CHANGE:
    		Enable temporary baudrate change while serial download
    
    - CFG_SDRAM_BASE:
    		Physical start address of SDRAM. _Must_ be 0 here.
    
    - CFG_MBIO_BASE:
    		Physical start address of Motherboard I/O (if using a
    		Cogent motherboard)
    
    - CFG_FLASH_BASE:
    		Physical start address of Flash memory.
    
    - CFG_MONITOR_BASE:
    		Physical start address of boot monitor code (set by
    		make config files to be same as the text base address
    		(TEXT_BASE) used when linking) - same as
    		CFG_FLASH_BASE when booting from flash.
    
    - CFG_MONITOR_LEN:
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    		Size of memory reserved for monitor code, used to
    		determine _at_compile_time_ (!) if the environment is
    		embedded within the U-Boot image, or in a separate
    		flash sector.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    - CFG_MALLOC_LEN:
    		Size of DRAM reserved for malloc() use.
    
    
    - CFG_BOOTM_LEN:
    		Normally compressed uImages are limited to an
    		uncompressed size of 8 MBytes. If this is not enough,
    		you can define CFG_BOOTM_LEN in your board config file
    		to adjust this setting to your needs.
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    - CFG_BOOTMAPSZ:
    		Maximum size of memory mapped by the startup code of
    		the Linux kernel; all data that must be processed by
    		the Linux kernel (bd_info, boot arguments, eventually
    		initrd image) must be put below this limit.
    
    - CFG_MAX_FLASH_BANKS:
    		Max number of Flash memory banks
    
    - CFG_MAX_FLASH_SECT:
    		Max number of sectors on a Flash chip
    
    - CFG_FLASH_ERASE_TOUT:
    		Timeout for Flash erase operations (in ms)
    
    - 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.
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    - CFG_DIRECT_FLASH_TFTP:
    
    		Enable TFTP transfers directly to flash memory;
    		without this option such a download has to be
    		performed in two steps: (1) download to RAM, and (2)
    		copy from RAM to flash.
    
    		The two-step approach is usually more reliable, since
    		you can check if the download worked before you erase
    		the flash, but in some situations (when sytem RAM is
    		too limited to allow for a tempory copy of the
    		downloaded image) this option may be very useful.
    
    - CFG_FLASH_CFI:
    
    		Define if the flash driver uses extra elements in the
    
    		common flash structure for storing flash geometry.
    
    - CFG_FLASH_CFI_DRIVER
    		This option also enables the building of the cfi_flash driver
    		in the drivers directory
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    
    - CFG_FLASH_QUIET_TEST
    		If this option is defined, the common CFI flash doesn't
    		print it's warning upon not recognized FLASH banks. This
    		is useful, if some of the configured banks are only
    		optionally available.
    
    
    Stefan Roese's avatar
    Stefan Roese committed
    - CFG_RX_ETH_BUFFER:
    		Defines the number of ethernet receive buffers. On some
    		ethernet controllers it is recommended to set this value
    		to 8 or even higher (EEPRO100 or 405 EMAC), since all
    		buffers can be full shortly after enabling the interface
    		on high ethernet traffic.
    		Defaults to 4 if not defined.
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    The following definitions that deal with the placement and management
    of environment data (variable area); in general, we support the
    following configurations:
    
    - CFG_ENV_IS_IN_FLASH:
    
    	Define this if the environment is in flash memory.
    
    	a) The environment occupies one whole flash sector, which is
    	   "embedded" in the text segment with the U-Boot code. This
    	   happens usually with "bottom boot sector" or "top boot
    	   sector" type flash chips, which have several smaller
    	   sectors at the start or the end. For instance, such a
    	   layout can have sector sizes of 8, 2x4, 16, Nx32 kB. In
    	   such a case you would place the environment in one of the
    	   4 kB sectors - with U-Boot code before and after it. With
    	   "top boot sector" type flash chips, you would put the
    	   environment in one of the last sectors, leaving a gap
    	   between U-Boot and the environment.
    
    	- CFG_ENV_OFFSET:
    
    	   Offset of environment data (variable area) to the
    	   beginning of flash memory; for instance, with bottom boot
    	   type flash chips the second sector can be used: the offset
    	   for this sector is given here.
    
    	   CFG_ENV_OFFSET is used relative to CFG_FLASH_BASE.
    
    	- CFG_ENV_ADDR:
    
    	   This is just another way to specify the start address of
    	   the flash sector containing the environment (instead of
    	   CFG_ENV_OFFSET).
    
    	- CFG_ENV_SECT_SIZE:
    
    	   Size of the sector containing the environment.
    
    
    	b) Sometimes flash chips have few, equal sized, BIG sectors.
    	   In such a case you don't want to spend a whole sector for
    	   the environment.
    
    	- CFG_ENV_SIZE:
    
    	   If you use this in combination with CFG_ENV_IS_IN_FLASH
    	   and CFG_ENV_SECT_SIZE, you can specify to use only a part
    	   of this flash sector for the environment. This saves
    	   memory for the RAM copy of the environment.
    
    	   It may also save flash memory if you decide to use this
    	   when your environment is "embedded" within U-Boot code,
    	   since then the remainder of the flash sector could be used
    	   for U-Boot code. It should be pointed out that this is
    	   STRONGLY DISCOURAGED from a robustness point of view:
    	   updating the environment in flash makes it always
    	   necessary to erase the WHOLE sector. If something goes
    	   wrong before the contents has been restored from a copy in
    	   RAM, your target system will be dead.
    
    	- CFG_ENV_ADDR_REDUND
    	  CFG_ENV_SIZE_REDUND
    
    
    	   These settings describe a second storage area used to hold
    	   a redundand copy of the environment data, so that there is
    
    	   a valid backup copy in case there is a power failure during
    
    	   a "saveenv" operation.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    BE CAREFUL! Any changes to the flash layout, and some changes to the
    source code will make it necessary to adapt <board>/u-boot.lds*
    accordingly!
    
    
    - CFG_ENV_IS_IN_NVRAM:
    
    	Define this if you have some non-volatile memory device
    	(NVRAM, battery buffered SRAM) which you want to use for the
    	environment.
    
    	- CFG_ENV_ADDR:
    	- CFG_ENV_SIZE:
    
    	  These two #defines are used to determin the memory area you
    	  want to use for environment. It is assumed that this memory
    	  can just be read and written to, without any special
    	  provision.
    
    BE CAREFUL! The first access to the environment happens quite early
    in U-Boot initalization (when we try to get the setting of for the
    console baudrate). You *MUST* have mappend your NVRAM area then, or
    U-Boot will hang.
    
    Please note that even with NVRAM we still use a copy of the
    environment in RAM: we could work on NVRAM directly, but we want to
    keep settings there always unmodified except somebody uses "saveenv"
    to save the current settings.
    
    
    - CFG_ENV_IS_IN_EEPROM:
    
    	Use this if you have an EEPROM or similar serial access
    	device and a driver for it.
    
    	- CFG_ENV_OFFSET:
    	- CFG_ENV_SIZE:
    
    	  These two #defines specify the offset and size of the
    	  environment area within the total memory of your EEPROM.
    
    	- CFG_I2C_EEPROM_ADDR:
    	  If defined, specified the chip address of the EEPROM device.
    	  The default address is zero.
    
    	- CFG_EEPROM_PAGE_WRITE_BITS:
    	  If defined, the number of bits used to address bytes in a
    	  single page in the EEPROM device.  A 64 byte page, for example
    	  would require six bits.
    
    	- CFG_EEPROM_PAGE_WRITE_DELAY_MS:
    	  If defined, the number of milliseconds to delay between
    
    	  page writes.	The default is zero milliseconds.
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    
    	- CFG_I2C_EEPROM_ADDR_LEN:
    	  The length in bytes of the EEPROM memory array address.  Note
    	  that this is NOT the chip address length!
    
    
    	- CFG_I2C_EEPROM_ADDR_OVERFLOW:
    	  EEPROM chips that implement "address overflow" are ones
    	  like Catalyst 24WC04/08/16 which has 9/10/11 bits of
    	  address and the extra bits end up in the "chip address" bit
    	  slots. This makes a 24WC08 (1Kbyte) chip look like four 256
    	  byte chips.
    
    	  Note that we consider the length of the address field to
    	  still be one byte because the extra address bits are hidden
    	  in the chip address.
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    	- CFG_EEPROM_SIZE:
    	  The size in bytes of the EEPROM device.
    
    
    
    - CFG_ENV_IS_IN_DATAFLASH:
    
    
    	Define this if you have a DataFlash memory device which you
    
    	want to use for the environment.
    
    	- CFG_ENV_OFFSET:
    	- CFG_ENV_ADDR:
    	- CFG_ENV_SIZE:
    
    	  These three #defines specify the offset and size of the
    	  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_ENV_OFFSET_REDUND
    
    	  This setting describes a second storage area of CFG_ENV_SIZE
    	  size used to hold a redundant copy of the environment data,
    	  so that there is a valid backup copy in case there is a
    	  power failure during a "saveenv" operation.
    
    	Note: CFG_ENV_OFFSET and CFG_ENV_OFFSET_REDUND must be aligned
    	to a block boundary, and CFG_ENV_SIZE must be a multiple of
    	the NAND devices block size.
    
    
    Wolfgang Denk's avatar
    Wolfgang Denk committed
    - CFG_SPI_INIT_OFFSET
    
    	Defines offset to the initial SPI buffer area in DPRAM. The