Blackfin: Remove
[people/ms/u-boot.git] / README
1 #
2 # (C) Copyright 2000 - 2013
3 # Wolfgang Denk, DENX Software Engineering, wd@denx.de.
4 #
5 # SPDX-License-Identifier:      GPL-2.0+
6 #
7
8 Summary:
9 ========
10
11 This directory contains the source code for U-Boot, a boot loader for
12 Embedded boards based on PowerPC, ARM, MIPS and several other
13 processors, which can be installed in a boot ROM and used to
14 initialize and test the hardware or to download and run application
15 code.
16
17 The development of U-Boot is closely related to Linux: some parts of
18 the source code originate in the Linux source tree, we have some
19 header files in common, and special provision has been made to
20 support booting of Linux images.
21
22 Some attention has been paid to make this software easily
23 configurable and extendable. For instance, all monitor commands are
24 implemented with the same call interface, so that it's very easy to
25 add new commands. Also, instead of permanently adding rarely used
26 code (for instance hardware test utilities) to the monitor, you can
27 load and run it dynamically.
28
29
30 Status:
31 =======
32
33 In general, all boards for which a configuration option exists in the
34 Makefile have been tested to some extent and can be considered
35 "working". In fact, many of them are used in production systems.
36
37 In case of problems see the CHANGELOG file to find out who contributed
38 the specific port. In addition, there are various MAINTAINERS files
39 scattered throughout the U-Boot source identifying the people or
40 companies responsible for various boards and subsystems.
41
42 Note: As of August, 2010, there is no longer a CHANGELOG file in the
43 actual U-Boot source tree; however, it can be created dynamically
44 from the Git log using:
45
46         make CHANGELOG
47
48
49 Where to get help:
50 ==================
51
52 In case you have questions about, problems with or contributions for
53 U-Boot, you should send a message to the U-Boot mailing list at
54 <u-boot@lists.denx.de>. There is also an archive of previous traffic
55 on the mailing list - please search the archive before asking FAQ's.
56 Please see http://lists.denx.de/pipermail/u-boot and
57 http://dir.gmane.org/gmane.comp.boot-loaders.u-boot
58
59
60 Where to get source code:
61 =========================
62
63 The U-Boot source code is maintained in the Git repository at
64 git://www.denx.de/git/u-boot.git ; you can browse it online at
65 http://www.denx.de/cgi-bin/gitweb.cgi?p=u-boot.git;a=summary
66
67 The "snapshot" links on this page allow you to download tarballs of
68 any version you might be interested in. Official releases are also
69 available for FTP download from the ftp://ftp.denx.de/pub/u-boot/
70 directory.
71
72 Pre-built (and tested) images are available from
73 ftp://ftp.denx.de/pub/u-boot/images/
74
75
76 Where we come from:
77 ===================
78
79 - start from 8xxrom sources
80 - create PPCBoot project (http://sourceforge.net/projects/ppcboot)
81 - clean up code
82 - make it easier to add custom boards
83 - make it possible to add other [PowerPC] CPUs
84 - extend functions, especially:
85   * Provide extended interface to Linux boot loader
86   * S-Record download
87   * network boot
88   * PCMCIA / CompactFlash / ATA disk / SCSI ... boot
89 - create ARMBoot project (http://sourceforge.net/projects/armboot)
90 - add other CPU families (starting with ARM)
91 - create U-Boot project (http://sourceforge.net/projects/u-boot)
92 - current project page: see http://www.denx.de/wiki/U-Boot
93
94
95 Names and Spelling:
96 ===================
97
98 The "official" name of this project is "Das U-Boot". The spelling
99 "U-Boot" shall be used in all written text (documentation, comments
100 in source files etc.). Example:
101
102         This is the README file for the U-Boot project.
103
104 File names etc. shall be based on the string "u-boot". Examples:
105
106         include/asm-ppc/u-boot.h
107
108         #include <asm/u-boot.h>
109
110 Variable names, preprocessor constants etc. shall be either based on
111 the string "u_boot" or on "U_BOOT". Example:
112
113         U_BOOT_VERSION          u_boot_logo
114         IH_OS_U_BOOT            u_boot_hush_start
115
116
117 Versioning:
118 ===========
119
120 Starting with the release in October 2008, the names of the releases
121 were changed from numerical release numbers without deeper meaning
122 into a time stamp based numbering. Regular releases are identified by
123 names consisting of the calendar year and month of the release date.
124 Additional fields (if present) indicate release candidates or bug fix
125 releases in "stable" maintenance trees.
126
127 Examples:
128         U-Boot v2009.11     - Release November 2009
129         U-Boot v2009.11.1   - Release 1 in version November 2009 stable tree
130         U-Boot v2010.09-rc1 - Release candidate 1 for September 2010 release
131
132
133 Directory Hierarchy:
134 ====================
135
136 /arch                   Architecture specific files
137   /arc                  Files generic to ARC architecture
138   /arm                  Files generic to ARM architecture
139   /avr32                Files generic to AVR32 architecture
140   /m68k                 Files generic to m68k architecture
141   /microblaze           Files generic to microblaze architecture
142   /mips                 Files generic to MIPS architecture
143   /nds32                Files generic to NDS32 architecture
144   /nios2                Files generic to Altera NIOS2 architecture
145   /openrisc             Files generic to OpenRISC architecture
146   /powerpc              Files generic to PowerPC architecture
147   /sandbox              Files generic to HW-independent "sandbox"
148   /sh                   Files generic to SH architecture
149   /sparc                Files generic to SPARC architecture
150   /x86                  Files generic to x86 architecture
151 /api                    Machine/arch independent API for external apps
152 /board                  Board dependent files
153 /cmd                    U-Boot commands functions
154 /common                 Misc architecture independent functions
155 /configs                Board default configuration files
156 /disk                   Code for disk drive partition handling
157 /doc                    Documentation (don't expect too much)
158 /drivers                Commonly used device drivers
159 /dts                    Contains Makefile for building internal U-Boot fdt.
160 /examples               Example code for standalone applications, etc.
161 /fs                     Filesystem code (cramfs, ext2, jffs2, etc.)
162 /include                Header Files
163 /lib                    Library routines generic to all architectures
164 /Licenses               Various license files
165 /net                    Networking code
166 /post                   Power On Self Test
167 /scripts                Various build scripts and Makefiles
168 /test                   Various unit test files
169 /tools                  Tools to build S-Record or U-Boot images, etc.
170
171 Software Configuration:
172 =======================
173
174 Configuration is usually done using C preprocessor defines; the
175 rationale behind that is to avoid dead code whenever possible.
176
177 There are two classes of configuration variables:
178
179 * Configuration _OPTIONS_:
180   These are selectable by the user and have names beginning with
181   "CONFIG_".
182
183 * Configuration _SETTINGS_:
184   These depend on the hardware etc. and should not be meddled with if
185   you don't know what you're doing; they have names beginning with
186   "CONFIG_SYS_".
187
188 Previously, all configuration was done by hand, which involved creating
189 symbolic links and editing configuration files manually. More recently,
190 U-Boot has added the Kbuild infrastructure used by the Linux kernel,
191 allowing you to use the "make menuconfig" command to configure your
192 build.
193
194
195 Selection of Processor Architecture and Board Type:
196 ---------------------------------------------------
197
198 For all supported boards there are ready-to-use default
199 configurations available; just type "make <board_name>_defconfig".
200
201 Example: For a TQM823L module type:
202
203         cd u-boot
204         make TQM823L_defconfig
205
206 Note: If you're looking for the default configuration file for a board
207 you're sure used to be there but is now missing, check the file
208 doc/README.scrapyard for a list of no longer supported boards.
209
210 Sandbox Environment:
211 --------------------
212
213 U-Boot can be built natively to run on a Linux host using the 'sandbox'
214 board. This allows feature development which is not board- or architecture-
215 specific to be undertaken on a native platform. The sandbox is also used to
216 run some of U-Boot's tests.
217
218 See board/sandbox/README.sandbox for more details.
219
220
221 Board Initialisation Flow:
222 --------------------------
223
224 This is the intended start-up flow for boards. This should apply for both
225 SPL and U-Boot proper (i.e. they both follow the same rules).
226
227 Note: "SPL" stands for "Secondary Program Loader," which is explained in
228 more detail later in this file.
229
230 At present, SPL mostly uses a separate code path, but the function names
231 and roles of each function are the same. Some boards or architectures
232 may not conform to this.  At least most ARM boards which use
233 CONFIG_SPL_FRAMEWORK conform to this.
234
235 Execution typically starts with an architecture-specific (and possibly
236 CPU-specific) start.S file, such as:
237
238         - arch/arm/cpu/armv7/start.S
239         - arch/powerpc/cpu/mpc83xx/start.S
240         - arch/mips/cpu/start.S
241
242 and so on. From there, three functions are called; the purpose and
243 limitations of each of these functions are described below.
244
245 lowlevel_init():
246         - purpose: essential init to permit execution to reach board_init_f()
247         - no global_data or BSS
248         - there is no stack (ARMv7 may have one but it will soon be removed)
249         - must not set up SDRAM or use console
250         - must only do the bare minimum to allow execution to continue to
251                 board_init_f()
252         - this is almost never needed
253         - return normally from this function
254
255 board_init_f():
256         - purpose: set up the machine ready for running board_init_r():
257                 i.e. SDRAM and serial UART
258         - global_data is available
259         - stack is in SRAM
260         - BSS is not available, so you cannot use global/static variables,
261                 only stack variables and global_data
262
263         Non-SPL-specific notes:
264         - dram_init() is called to set up DRAM. If already done in SPL this
265                 can do nothing
266
267         SPL-specific notes:
268         - you can override the entire board_init_f() function with your own
269                 version as needed.
270         - preloader_console_init() can be called here in extremis
271         - should set up SDRAM, and anything needed to make the UART work
272         - these is no need to clear BSS, it will be done by crt0.S
273         - must return normally from this function (don't call board_init_r()
274                 directly)
275
276 Here the BSS is cleared. For SPL, if CONFIG_SPL_STACK_R is defined, then at
277 this point the stack and global_data are relocated to below
278 CONFIG_SPL_STACK_R_ADDR. For non-SPL, U-Boot is relocated to run at the top of
279 memory.
280
281 board_init_r():
282         - purpose: main execution, common code
283         - global_data is available
284         - SDRAM is available
285         - BSS is available, all static/global variables can be used
286         - execution eventually continues to main_loop()
287
288         Non-SPL-specific notes:
289         - U-Boot is relocated to the top of memory and is now running from
290                 there.
291
292         SPL-specific notes:
293         - stack is optionally in SDRAM, if CONFIG_SPL_STACK_R is defined and
294                 CONFIG_SPL_STACK_R_ADDR points into SDRAM
295         - preloader_console_init() can be called here - typically this is
296                 done by defining CONFIG_SPL_BOARD_INIT and then supplying a
297                 spl_board_init() function containing this call
298         - loads U-Boot or (in falcon mode) Linux
299
300
301
302 Configuration Options:
303 ----------------------
304
305 Configuration depends on the combination of board and CPU type; all
306 such information is kept in a configuration file
307 "include/configs/<board_name>.h".
308
309 Example: For a TQM823L module, all configuration settings are in
310 "include/configs/TQM823L.h".
311
312
313 Many of the options are named exactly as the corresponding Linux
314 kernel configuration options. The intention is to make it easier to
315 build a config tool - later.
316
317
318 The following options need to be configured:
319
320 - CPU Type:     Define exactly one, e.g. CONFIG_MPC85XX.
321
322 - Board Type:   Define exactly one, e.g. CONFIG_MPC8540ADS.
323
324 - CPU Daughterboard Type: (if CONFIG_ATSTK1000 is defined)
325                 Define exactly one, e.g. CONFIG_ATSTK1002
326
327 - Marvell Family Member
328                 CONFIG_SYS_MVFS         - define it if you want to enable
329                                           multiple fs option at one time
330                                           for marvell soc family
331
332 - 8xx CPU Options: (if using an MPC8xx CPU)
333                 CONFIG_8xx_GCLK_FREQ    - deprecated: CPU clock if
334                                           get_gclk_freq() cannot work
335                                           e.g. if there is no 32KHz
336                                           reference PIT/RTC clock
337                 CONFIG_8xx_OSCLK        - PLL input clock (either EXTCLK
338                                           or XTAL/EXTAL)
339
340 - 859/866/885 CPU options: (if using a MPC859 or MPC866 or MPC885 CPU):
341                 CONFIG_SYS_8xx_CPUCLK_MIN
342                 CONFIG_SYS_8xx_CPUCLK_MAX
343                 CONFIG_8xx_CPUCLK_DEFAULT
344                         See doc/README.MPC866
345
346                 CONFIG_SYS_MEASURE_CPUCLK
347
348                 Define this to measure the actual CPU clock instead
349                 of relying on the correctness of the configured
350                 values. Mostly useful for board bringup to make sure
351                 the PLL is locked at the intended frequency. Note
352                 that this requires a (stable) reference clock (32 kHz
353                 RTC clock or CONFIG_SYS_8XX_XIN)
354
355                 CONFIG_SYS_DELAYED_ICACHE
356
357                 Define this option if you want to enable the
358                 ICache only when Code runs from RAM.
359
360 - 85xx CPU Options:
361                 CONFIG_SYS_PPC64
362
363                 Specifies that the core is a 64-bit PowerPC implementation (implements
364                 the "64" category of the Power ISA). This is necessary for ePAPR
365                 compliance, among other possible reasons.
366
367                 CONFIG_SYS_FSL_TBCLK_DIV
368
369                 Defines the core time base clock divider ratio compared to the
370                 system clock.  On most PQ3 devices this is 8, on newer QorIQ
371                 devices it can be 16 or 32.  The ratio varies from SoC to Soc.
372
373                 CONFIG_SYS_FSL_PCIE_COMPAT
374
375                 Defines the string to utilize when trying to match PCIe device
376                 tree nodes for the given platform.
377
378                 CONFIG_SYS_FSL_ERRATUM_A004510
379
380                 Enables a workaround for erratum A004510.  If set,
381                 then CONFIG_SYS_FSL_ERRATUM_A004510_SVR_REV and
382                 CONFIG_SYS_FSL_CORENET_SNOOPVEC_COREONLY must be set.
383
384                 CONFIG_SYS_FSL_ERRATUM_A004510_SVR_REV
385                 CONFIG_SYS_FSL_ERRATUM_A004510_SVR_REV2 (optional)
386
387                 Defines one or two SoC revisions (low 8 bits of SVR)
388                 for which the A004510 workaround should be applied.
389
390                 The rest of SVR is either not relevant to the decision
391                 of whether the erratum is present (e.g. p2040 versus
392                 p2041) or is implied by the build target, which controls
393                 whether CONFIG_SYS_FSL_ERRATUM_A004510 is set.
394
395                 See Freescale App Note 4493 for more information about
396                 this erratum.
397
398                 CONFIG_A003399_NOR_WORKAROUND
399                 Enables a workaround for IFC erratum A003399. It is only
400                 required during NOR boot.
401
402                 CONFIG_A008044_WORKAROUND
403                 Enables a workaround for T1040/T1042 erratum A008044. It is only
404                 required during NAND boot and valid for Rev 1.0 SoC revision
405
406                 CONFIG_SYS_FSL_CORENET_SNOOPVEC_COREONLY
407
408                 This is the value to write into CCSR offset 0x18600
409                 according to the A004510 workaround.
410
411                 CONFIG_SYS_FSL_DSP_DDR_ADDR
412                 This value denotes start offset of DDR memory which is
413                 connected exclusively to the DSP cores.
414
415                 CONFIG_SYS_FSL_DSP_M2_RAM_ADDR
416                 This value denotes start offset of M2 memory
417                 which is directly connected to the DSP core.
418
419                 CONFIG_SYS_FSL_DSP_M3_RAM_ADDR
420                 This value denotes start offset of M3 memory which is directly
421                 connected to the DSP core.
422
423                 CONFIG_SYS_FSL_DSP_CCSRBAR_DEFAULT
424                 This value denotes start offset of DSP CCSR space.
425
426                 CONFIG_SYS_FSL_SINGLE_SOURCE_CLK
427                 Single Source Clock is clocking mode present in some of FSL SoC's.
428                 In this mode, a single differential clock is used to supply
429                 clocks to the sysclock, ddrclock and usbclock.
430
431                 CONFIG_SYS_CPC_REINIT_F
432                 This CONFIG is defined when the CPC is configured as SRAM at the
433                 time of U-Boot entry and is required to be re-initialized.
434
435                 CONFIG_DEEP_SLEEP
436                 Indicates this SoC supports deep sleep feature. If deep sleep is
437                 supported, core will start to execute uboot when wakes up.
438
439 - Generic CPU options:
440                 CONFIG_SYS_GENERIC_GLOBAL_DATA
441                 Defines global data is initialized in generic board board_init_f().
442                 If this macro is defined, global data is created and cleared in
443                 generic board board_init_f(). Without this macro, architecture/board
444                 should initialize global data before calling board_init_f().
445
446                 CONFIG_SYS_BIG_ENDIAN, CONFIG_SYS_LITTLE_ENDIAN
447
448                 Defines the endianess of the CPU. Implementation of those
449                 values is arch specific.
450
451                 CONFIG_SYS_FSL_DDR
452                 Freescale DDR driver in use. This type of DDR controller is
453                 found in mpc83xx, mpc85xx, mpc86xx as well as some ARM core
454                 SoCs.
455
456                 CONFIG_SYS_FSL_DDR_ADDR
457                 Freescale DDR memory-mapped register base.
458
459                 CONFIG_SYS_FSL_DDR_EMU
460                 Specify emulator support for DDR. Some DDR features such as
461                 deskew training are not available.
462
463                 CONFIG_SYS_FSL_DDRC_GEN1
464                 Freescale DDR1 controller.
465
466                 CONFIG_SYS_FSL_DDRC_GEN2
467                 Freescale DDR2 controller.
468
469                 CONFIG_SYS_FSL_DDRC_GEN3
470                 Freescale DDR3 controller.
471
472                 CONFIG_SYS_FSL_DDRC_GEN4
473                 Freescale DDR4 controller.
474
475                 CONFIG_SYS_FSL_DDRC_ARM_GEN3
476                 Freescale DDR3 controller for ARM-based SoCs.
477
478                 CONFIG_SYS_FSL_DDR1
479                 Board config to use DDR1. It can be enabled for SoCs with
480                 Freescale DDR1 or DDR2 controllers, depending on the board
481                 implemetation.
482
483                 CONFIG_SYS_FSL_DDR2
484                 Board config to use DDR2. It can be enabled for SoCs with
485                 Freescale DDR2 or DDR3 controllers, depending on the board
486                 implementation.
487
488                 CONFIG_SYS_FSL_DDR3
489                 Board config to use DDR3. It can be enabled for SoCs with
490                 Freescale DDR3 or DDR3L controllers.
491
492                 CONFIG_SYS_FSL_DDR3L
493                 Board config to use DDR3L. It can be enabled for SoCs with
494                 DDR3L controllers.
495
496                 CONFIG_SYS_FSL_DDR4
497                 Board config to use DDR4. It can be enabled for SoCs with
498                 DDR4 controllers.
499
500                 CONFIG_SYS_FSL_IFC_BE
501                 Defines the IFC controller register space as Big Endian
502
503                 CONFIG_SYS_FSL_IFC_LE
504                 Defines the IFC controller register space as Little Endian
505
506                 CONFIG_SYS_FSL_IFC_CLK_DIV
507                 Defines divider of platform clock(clock input to IFC controller).
508
509                 CONFIG_SYS_FSL_LBC_CLK_DIV
510                 Defines divider of platform clock(clock input to eLBC controller).
511
512                 CONFIG_SYS_FSL_PBL_PBI
513                 It enables addition of RCW (Power on reset configuration) in built image.
514                 Please refer doc/README.pblimage for more details
515
516                 CONFIG_SYS_FSL_PBL_RCW
517                 It adds PBI(pre-boot instructions) commands in u-boot build image.
518                 PBI commands can be used to configure SoC before it starts the execution.
519                 Please refer doc/README.pblimage for more details
520
521                 CONFIG_SPL_FSL_PBL
522                 It adds a target to create boot binary having SPL binary in PBI format
523                 concatenated with u-boot binary.
524
525                 CONFIG_SYS_FSL_DDR_BE
526                 Defines the DDR controller register space as Big Endian
527
528                 CONFIG_SYS_FSL_DDR_LE
529                 Defines the DDR controller register space as Little Endian
530
531                 CONFIG_SYS_FSL_DDR_SDRAM_BASE_PHY
532                 Physical address from the view of DDR controllers. It is the
533                 same as CONFIG_SYS_DDR_SDRAM_BASE for  all Power SoCs. But
534                 it could be different for ARM SoCs.
535
536                 CONFIG_SYS_FSL_DDR_INTLV_256B
537                 DDR controller interleaving on 256-byte. This is a special
538                 interleaving mode, handled by Dickens for Freescale layerscape
539                 SoCs with ARM core.
540
541                 CONFIG_SYS_FSL_DDR_MAIN_NUM_CTRLS
542                 Number of controllers used as main memory.
543
544                 CONFIG_SYS_FSL_OTHER_DDR_NUM_CTRLS
545                 Number of controllers used for other than main memory.
546
547                 CONFIG_SYS_FSL_HAS_DP_DDR
548                 Defines the SoC has DP-DDR used for DPAA.
549
550                 CONFIG_SYS_FSL_SEC_BE
551                 Defines the SEC controller register space as Big Endian
552
553                 CONFIG_SYS_FSL_SEC_LE
554                 Defines the SEC controller register space as Little Endian
555
556 - MIPS CPU options:
557                 CONFIG_SYS_INIT_SP_OFFSET
558
559                 Offset relative to CONFIG_SYS_SDRAM_BASE for initial stack
560                 pointer. This is needed for the temporary stack before
561                 relocation.
562
563                 CONFIG_SYS_MIPS_CACHE_MODE
564
565                 Cache operation mode for the MIPS CPU.
566                 See also arch/mips/include/asm/mipsregs.h.
567                 Possible values are:
568                         CONF_CM_CACHABLE_NO_WA
569                         CONF_CM_CACHABLE_WA
570                         CONF_CM_UNCACHED
571                         CONF_CM_CACHABLE_NONCOHERENT
572                         CONF_CM_CACHABLE_CE
573                         CONF_CM_CACHABLE_COW
574                         CONF_CM_CACHABLE_CUW
575                         CONF_CM_CACHABLE_ACCELERATED
576
577                 CONFIG_SYS_XWAY_EBU_BOOTCFG
578
579                 Special option for Lantiq XWAY SoCs for booting from NOR flash.
580                 See also arch/mips/cpu/mips32/start.S.
581
582                 CONFIG_XWAY_SWAP_BYTES
583
584                 Enable compilation of tools/xway-swap-bytes needed for Lantiq
585                 XWAY SoCs for booting from NOR flash. The U-Boot image needs to
586                 be swapped if a flash programmer is used.
587
588 - ARM options:
589                 CONFIG_SYS_EXCEPTION_VECTORS_HIGH
590
591                 Select high exception vectors of the ARM core, e.g., do not
592                 clear the V bit of the c1 register of CP15.
593
594                 COUNTER_FREQUENCY
595                 Generic timer clock source frequency.
596
597                 COUNTER_FREQUENCY_REAL
598                 Generic timer clock source frequency if the real clock is
599                 different from COUNTER_FREQUENCY, and can only be determined
600                 at run time.
601
602 - Tegra SoC options:
603                 CONFIG_TEGRA_SUPPORT_NON_SECURE
604
605                 Support executing U-Boot in non-secure (NS) mode. Certain
606                 impossible actions will be skipped if the CPU is in NS mode,
607                 such as ARM architectural timer initialization.
608
609 - Linux Kernel Interface:
610                 CONFIG_CLOCKS_IN_MHZ
611
612                 U-Boot stores all clock information in Hz
613                 internally. For binary compatibility with older Linux
614                 kernels (which expect the clocks passed in the
615                 bd_info data to be in MHz) the environment variable
616                 "clocks_in_mhz" can be defined so that U-Boot
617                 converts clock data to MHZ before passing it to the
618                 Linux kernel.
619                 When CONFIG_CLOCKS_IN_MHZ is defined, a definition of
620                 "clocks_in_mhz=1" is automatically included in the
621                 default environment.
622
623                 CONFIG_MEMSIZE_IN_BYTES         [relevant for MIPS only]
624
625                 When transferring memsize parameter to Linux, some versions
626                 expect it to be in bytes, others in MB.
627                 Define CONFIG_MEMSIZE_IN_BYTES to make it in bytes.
628
629                 CONFIG_OF_LIBFDT
630
631                 New kernel versions are expecting firmware settings to be
632                 passed using flattened device trees (based on open firmware
633                 concepts).
634
635                 CONFIG_OF_LIBFDT
636                  * New libfdt-based support
637                  * Adds the "fdt" command
638                  * The bootm command automatically updates the fdt
639
640                 OF_CPU - The proper name of the cpus node (only required for
641                         MPC512X and MPC5xxx based boards).
642                 OF_SOC - The proper name of the soc node (only required for
643                         MPC512X and MPC5xxx based boards).
644                 OF_TBCLK - The timebase frequency.
645                 OF_STDOUT_PATH - The path to the console device
646
647                 boards with QUICC Engines require OF_QE to set UCC MAC
648                 addresses
649
650                 CONFIG_OF_BOARD_SETUP
651
652                 Board code has addition modification that it wants to make
653                 to the flat device tree before handing it off to the kernel
654
655                 CONFIG_OF_SYSTEM_SETUP
656
657                 Other code has addition modification that it wants to make
658                 to the flat device tree before handing it off to the kernel.
659                 This causes ft_system_setup() to be called before booting
660                 the kernel.
661
662                 CONFIG_OF_IDE_FIXUP
663
664                 U-Boot can detect if an IDE device is present or not.
665                 If not, and this new config option is activated, U-Boot
666                 removes the ATA node from the DTS before booting Linux,
667                 so the Linux IDE driver does not probe the device and
668                 crash. This is needed for buggy hardware (uc101) where
669                 no pull down resistor is connected to the signal IDE5V_DD7.
670
671                 CONFIG_MACH_TYPE        [relevant for ARM only][mandatory]
672
673                 This setting is mandatory for all boards that have only one
674                 machine type and must be used to specify the machine type
675                 number as it appears in the ARM machine registry
676                 (see http://www.arm.linux.org.uk/developer/machines/).
677                 Only boards that have multiple machine types supported
678                 in a single configuration file and the machine type is
679                 runtime discoverable, do not have to use this setting.
680
681 - vxWorks boot parameters:
682
683                 bootvx constructs a valid bootline using the following
684                 environments variables: bootdev, bootfile, ipaddr, netmask,
685                 serverip, gatewayip, hostname, othbootargs.
686                 It loads the vxWorks image pointed bootfile.
687
688                 Note: If a "bootargs" environment is defined, it will overwride
689                 the defaults discussed just above.
690
691 - Cache Configuration:
692                 CONFIG_SYS_ICACHE_OFF - Do not enable instruction cache in U-Boot
693                 CONFIG_SYS_DCACHE_OFF - Do not enable data cache in U-Boot
694                 CONFIG_SYS_L2CACHE_OFF- Do not enable L2 cache in U-Boot
695
696 - Cache Configuration for ARM:
697                 CONFIG_SYS_L2_PL310 - Enable support for ARM PL310 L2 cache
698                                       controller
699                 CONFIG_SYS_PL310_BASE - Physical base address of PL310
700                                         controller register space
701
702 - Serial Ports:
703                 CONFIG_PL010_SERIAL
704
705                 Define this if you want support for Amba PrimeCell PL010 UARTs.
706
707                 CONFIG_PL011_SERIAL
708
709                 Define this if you want support for Amba PrimeCell PL011 UARTs.
710
711                 CONFIG_PL011_CLOCK
712
713                 If you have Amba PrimeCell PL011 UARTs, set this variable to
714                 the clock speed of the UARTs.
715
716                 CONFIG_PL01x_PORTS
717
718                 If you have Amba PrimeCell PL010 or PL011 UARTs on your board,
719                 define this to a list of base addresses for each (supported)
720                 port. See e.g. include/configs/versatile.h
721
722                 CONFIG_SERIAL_HW_FLOW_CONTROL
723
724                 Define this variable to enable hw flow control in serial driver.
725                 Current user of this option is drivers/serial/nsl16550.c driver
726
727 - Console Interface:
728                 Depending on board, define exactly one serial port
729                 (like CONFIG_8xx_CONS_SMC1, CONFIG_8xx_CONS_SMC2,
730                 CONFIG_8xx_CONS_SCC1, ...), or switch off the serial
731                 console by defining CONFIG_8xx_CONS_NONE
732
733                 Note: if CONFIG_8xx_CONS_NONE is defined, the serial
734                 port routines must be defined elsewhere
735                 (i.e. serial_init(), serial_getc(), ...)
736
737 - Console Baudrate:
738                 CONFIG_BAUDRATE - in bps
739                 Select one of the baudrates listed in
740                 CONFIG_SYS_BAUDRATE_TABLE, see below.
741                 CONFIG_SYS_BRGCLK_PRESCALE, baudrate prescale
742
743 - Console Rx buffer length
744                 With CONFIG_SYS_SMC_RXBUFLEN it is possible to define
745                 the maximum receive buffer length for the SMC.
746                 This option is actual only for 82xx and 8xx possible.
747                 If using CONFIG_SYS_SMC_RXBUFLEN also CONFIG_SYS_MAXIDLE
748                 must be defined, to setup the maximum idle timeout for
749                 the SMC.
750
751 - Autoboot Command:
752                 CONFIG_BOOTCOMMAND
753                 Only needed when CONFIG_BOOTDELAY is enabled;
754                 define a command string that is automatically executed
755                 when no character is read on the console interface
756                 within "Boot Delay" after reset.
757
758                 CONFIG_BOOTARGS
759                 This can be used to pass arguments to the bootm
760                 command. The value of CONFIG_BOOTARGS goes into the
761                 environment value "bootargs".
762
763                 CONFIG_RAMBOOT and CONFIG_NFSBOOT
764                 The value of these goes into the environment as
765                 "ramboot" and "nfsboot" respectively, and can be used
766                 as a convenience, when switching between booting from
767                 RAM and NFS.
768
769 - Bootcount:
770                 CONFIG_BOOTCOUNT_LIMIT
771                 Implements a mechanism for detecting a repeating reboot
772                 cycle, see:
773                 http://www.denx.de/wiki/view/DULG/UBootBootCountLimit
774
775                 CONFIG_BOOTCOUNT_ENV
776                 If no softreset save registers are found on the hardware
777                 "bootcount" is stored in the environment. To prevent a
778                 saveenv on all reboots, the environment variable
779                 "upgrade_available" is used. If "upgrade_available" is
780                 0, "bootcount" is always 0, if "upgrade_available" is
781                 1 "bootcount" is incremented in the environment.
782                 So the Userspace Applikation must set the "upgrade_available"
783                 and "bootcount" variable to 0, if a boot was successfully.
784
785 - Pre-Boot Commands:
786                 CONFIG_PREBOOT
787
788                 When this option is #defined, the existence of the
789                 environment variable "preboot" will be checked
790                 immediately before starting the CONFIG_BOOTDELAY
791                 countdown and/or running the auto-boot command resp.
792                 entering interactive mode.
793
794                 This feature is especially useful when "preboot" is
795                 automatically generated or modified. For an example
796                 see the LWMON board specific code: here "preboot" is
797                 modified when the user holds down a certain
798                 combination of keys on the (special) keyboard when
799                 booting the systems
800
801 - Serial Download Echo Mode:
802                 CONFIG_LOADS_ECHO
803                 If defined to 1, all characters received during a
804                 serial download (using the "loads" command) are
805                 echoed back. This might be needed by some terminal
806                 emulations (like "cu"), but may as well just take
807                 time on others. This setting #define's the initial
808                 value of the "loads_echo" environment variable.
809
810 - Kgdb Serial Baudrate: (if CONFIG_CMD_KGDB is defined)
811                 CONFIG_KGDB_BAUDRATE
812                 Select one of the baudrates listed in
813                 CONFIG_SYS_BAUDRATE_TABLE, see below.
814
815 - Monitor Functions:
816                 Monitor commands can be included or excluded
817                 from the build by using the #include files
818                 <config_cmd_all.h> and #undef'ing unwanted
819                 commands, or adding #define's for wanted commands.
820
821                 The default command configuration includes all commands
822                 except those marked below with a "*".
823
824                 CONFIG_CMD_AES            AES 128 CBC encrypt/decrypt
825                 CONFIG_CMD_ASKENV       * ask for env variable
826                 CONFIG_CMD_BDI            bdinfo
827                 CONFIG_CMD_BEDBUG       * Include BedBug Debugger
828                 CONFIG_CMD_BMP          * BMP support
829                 CONFIG_CMD_BSP          * Board specific commands
830                 CONFIG_CMD_BOOTD          bootd
831                 CONFIG_CMD_BOOTI        * ARM64 Linux kernel Image support
832                 CONFIG_CMD_CACHE        * icache, dcache
833                 CONFIG_CMD_CLK          * clock command support
834                 CONFIG_CMD_CONSOLE        coninfo
835                 CONFIG_CMD_CRC32        * crc32
836                 CONFIG_CMD_DATE         * support for RTC, date/time...
837                 CONFIG_CMD_DHCP         * DHCP support
838                 CONFIG_CMD_DIAG         * Diagnostics
839                 CONFIG_CMD_DS4510       * ds4510 I2C gpio commands
840                 CONFIG_CMD_DS4510_INFO  * ds4510 I2C info command
841                 CONFIG_CMD_DS4510_MEM   * ds4510 I2C eeprom/sram commansd
842                 CONFIG_CMD_DS4510_RST   * ds4510 I2C rst command
843                 CONFIG_CMD_DTT          * Digital Therm and Thermostat
844                 CONFIG_CMD_ECHO           echo arguments
845                 CONFIG_CMD_EDITENV        edit env variable
846                 CONFIG_CMD_EEPROM       * EEPROM read/write support
847                 CONFIG_CMD_EEPROM_LAYOUT* EEPROM layout aware commands
848                 CONFIG_CMD_ELF          * bootelf, bootvx
849                 CONFIG_CMD_ENV_CALLBACK * display details about env callbacks
850                 CONFIG_CMD_ENV_FLAGS    * display details about env flags
851                 CONFIG_CMD_ENV_EXISTS   * check existence of env variable
852                 CONFIG_CMD_EXPORTENV    * export the environment
853                 CONFIG_CMD_EXT2         * ext2 command support
854                 CONFIG_CMD_EXT4         * ext4 command support
855                 CONFIG_CMD_FS_GENERIC   * filesystem commands (e.g. load, ls)
856                                           that work for multiple fs types
857                 CONFIG_CMD_FS_UUID      * Look up a filesystem UUID
858                 CONFIG_CMD_SAVEENV        saveenv
859                 CONFIG_CMD_FDC          * Floppy Disk Support
860                 CONFIG_CMD_FAT          * FAT command support
861                 CONFIG_CMD_FLASH          flinfo, erase, protect
862                 CONFIG_CMD_FPGA           FPGA device initialization support
863                 CONFIG_CMD_FUSE         * Device fuse support
864                 CONFIG_CMD_GETTIME      * Get time since boot
865                 CONFIG_CMD_GO           * the 'go' command (exec code)
866                 CONFIG_CMD_GREPENV      * search environment
867                 CONFIG_CMD_HASH         * calculate hash / digest
868                 CONFIG_CMD_I2C          * I2C serial bus support
869                 CONFIG_CMD_IDE          * IDE harddisk support
870                 CONFIG_CMD_IMI            iminfo
871                 CONFIG_CMD_IMLS           List all images found in NOR flash
872                 CONFIG_CMD_IMLS_NAND    * List all images found in NAND flash
873                 CONFIG_CMD_IMMAP        * IMMR dump support
874                 CONFIG_CMD_IOTRACE      * I/O tracing for debugging
875                 CONFIG_CMD_IMPORTENV    * import an environment
876                 CONFIG_CMD_INI          * import data from an ini file into the env
877                 CONFIG_CMD_IRQ          * irqinfo
878                 CONFIG_CMD_ITEST          Integer/string test of 2 values
879                 CONFIG_CMD_JFFS2        * JFFS2 Support
880                 CONFIG_CMD_KGDB         * kgdb
881                 CONFIG_CMD_LDRINFO      * ldrinfo (display Blackfin loader)
882                 CONFIG_CMD_LINK_LOCAL   * link-local IP address auto-configuration
883                                           (169.254.*.*)
884                 CONFIG_CMD_LOADB          loadb
885                 CONFIG_CMD_LOADS          loads
886                 CONFIG_CMD_MD5SUM       * print md5 message digest
887                                           (requires CONFIG_CMD_MEMORY and CONFIG_MD5)
888                 CONFIG_CMD_MEMINFO      * Display detailed memory information
889                 CONFIG_CMD_MEMORY         md, mm, nm, mw, cp, cmp, crc, base,
890                                           loop, loopw
891                 CONFIG_CMD_MEMTEST      * mtest
892                 CONFIG_CMD_MISC           Misc functions like sleep etc
893                 CONFIG_CMD_MMC          * MMC memory mapped support
894                 CONFIG_CMD_MII          * MII utility commands
895                 CONFIG_CMD_MTDPARTS     * MTD partition support
896                 CONFIG_CMD_NAND         * NAND support
897                 CONFIG_CMD_NET            bootp, tftpboot, rarpboot
898                 CONFIG_CMD_NFS            NFS support
899                 CONFIG_CMD_PCA953X      * PCA953x I2C gpio commands
900                 CONFIG_CMD_PCA953X_INFO * PCA953x I2C gpio info command
901                 CONFIG_CMD_PCI          * pciinfo
902                 CONFIG_CMD_PCMCIA               * PCMCIA support
903                 CONFIG_CMD_PING         * send ICMP ECHO_REQUEST to network
904                                           host
905                 CONFIG_CMD_PORTIO       * Port I/O
906                 CONFIG_CMD_READ         * Read raw data from partition
907                 CONFIG_CMD_REGINFO      * Register dump
908                 CONFIG_CMD_RUN            run command in env variable
909                 CONFIG_CMD_SANDBOX      * sb command to access sandbox features
910                 CONFIG_CMD_SAVES        * save S record dump
911                 CONFIG_SCSI             * SCSI Support
912                 CONFIG_CMD_SDRAM        * print SDRAM configuration information
913                                           (requires CONFIG_CMD_I2C)
914                 CONFIG_CMD_SETGETDCR      Support for DCR Register access
915                                           (4xx only)
916                 CONFIG_CMD_SF           * Read/write/erase SPI NOR flash
917                 CONFIG_CMD_SHA1SUM      * print sha1 memory digest
918                                           (requires CONFIG_CMD_MEMORY)
919                 CONFIG_CMD_SOFTSWITCH   * Soft switch setting command for BF60x
920                 CONFIG_CMD_SOURCE         "source" command Support
921                 CONFIG_CMD_SPI          * SPI serial bus support
922                 CONFIG_CMD_TFTPSRV      * TFTP transfer in server mode
923                 CONFIG_CMD_TFTPPUT      * TFTP put command (upload)
924                 CONFIG_CMD_TIME         * run command and report execution time (ARM specific)
925                 CONFIG_CMD_TIMER        * access to the system tick timer
926                 CONFIG_CMD_USB          * USB support
927                 CONFIG_CMD_CDP          * Cisco Discover Protocol support
928                 CONFIG_CMD_MFSL         * Microblaze FSL support
929                 CONFIG_CMD_XIMG           Load part of Multi Image
930                 CONFIG_CMD_UUID         * Generate random UUID or GUID string
931
932                 EXAMPLE: If you want all functions except of network
933                 support you can write:
934
935                 #include "config_cmd_all.h"
936                 #undef CONFIG_CMD_NET
937
938         Other Commands:
939                 fdt (flattened device tree) command: CONFIG_OF_LIBFDT
940
941         Note:   Don't enable the "icache" and "dcache" commands
942                 (configuration option CONFIG_CMD_CACHE) unless you know
943                 what you (and your U-Boot users) are doing. Data
944                 cache cannot be enabled on systems like the 8xx or
945                 8260 (where accesses to the IMMR region must be
946                 uncached), and it cannot be disabled on all other
947                 systems where we (mis-) use the data cache to hold an
948                 initial stack and some data.
949
950
951                 XXX - this list needs to get updated!
952
953 - Removal of commands
954                 If no commands are needed to boot, you can disable
955                 CONFIG_CMDLINE to remove them. In this case, the command line
956                 will not be available, and when U-Boot wants to execute the
957                 boot command (on start-up) it will call board_run_command()
958                 instead. This can reduce image size significantly for very
959                 simple boot procedures.
960
961 - Regular expression support:
962                 CONFIG_REGEX
963                 If this variable is defined, U-Boot is linked against
964                 the SLRE (Super Light Regular Expression) library,
965                 which adds regex support to some commands, as for
966                 example "env grep" and "setexpr".
967
968 - Device tree:
969                 CONFIG_OF_CONTROL
970                 If this variable is defined, U-Boot will use a device tree
971                 to configure its devices, instead of relying on statically
972                 compiled #defines in the board file. This option is
973                 experimental and only available on a few boards. The device
974                 tree is available in the global data as gd->fdt_blob.
975
976                 U-Boot needs to get its device tree from somewhere. This can
977                 be done using one of the two options below:
978
979                 CONFIG_OF_EMBED
980                 If this variable is defined, U-Boot will embed a device tree
981                 binary in its image. This device tree file should be in the
982                 board directory and called <soc>-<board>.dts. The binary file
983                 is then picked up in board_init_f() and made available through
984                 the global data structure as gd->blob.
985
986                 CONFIG_OF_SEPARATE
987                 If this variable is defined, U-Boot will build a device tree
988                 binary. It will be called u-boot.dtb. Architecture-specific
989                 code will locate it at run-time. Generally this works by:
990
991                         cat u-boot.bin u-boot.dtb >image.bin
992
993                 and in fact, U-Boot does this for you, creating a file called
994                 u-boot-dtb.bin which is useful in the common case. You can
995                 still use the individual files if you need something more
996                 exotic.
997
998 - Watchdog:
999                 CONFIG_WATCHDOG
1000                 If this variable is defined, it enables watchdog
1001                 support for the SoC. There must be support in the SoC
1002                 specific code for a watchdog. For the 8xx and 8260
1003                 CPUs, the SIU Watchdog feature is enabled in the SYPCR
1004                 register.  When supported for a specific SoC is
1005                 available, then no further board specific code should
1006                 be needed to use it.
1007
1008                 CONFIG_HW_WATCHDOG
1009                 When using a watchdog circuitry external to the used
1010                 SoC, then define this variable and provide board
1011                 specific code for the "hw_watchdog_reset" function.
1012
1013                 CONFIG_AT91_HW_WDT_TIMEOUT
1014                 specify the timeout in seconds. default 2 seconds.
1015
1016 - U-Boot Version:
1017                 CONFIG_VERSION_VARIABLE
1018                 If this variable is defined, an environment variable
1019                 named "ver" is created by U-Boot showing the U-Boot
1020                 version as printed by the "version" command.
1021                 Any change to this variable will be reverted at the
1022                 next reset.
1023
1024 - Real-Time Clock:
1025
1026                 When CONFIG_CMD_DATE is selected, the type of the RTC
1027                 has to be selected, too. Define exactly one of the
1028                 following options:
1029
1030                 CONFIG_RTC_MPC8xx       - use internal RTC of MPC8xx
1031                 CONFIG_RTC_PCF8563      - use Philips PCF8563 RTC
1032                 CONFIG_RTC_MC13XXX      - use MC13783 or MC13892 RTC
1033                 CONFIG_RTC_MC146818     - use MC146818 RTC
1034                 CONFIG_RTC_DS1307       - use Maxim, Inc. DS1307 RTC
1035                 CONFIG_RTC_DS1337       - use Maxim, Inc. DS1337 RTC
1036                 CONFIG_RTC_DS1338       - use Maxim, Inc. DS1338 RTC
1037                 CONFIG_RTC_DS1339       - use Maxim, Inc. DS1339 RTC
1038                 CONFIG_RTC_DS164x       - use Dallas DS164x RTC
1039                 CONFIG_RTC_ISL1208      - use Intersil ISL1208 RTC
1040                 CONFIG_RTC_MAX6900      - use Maxim, Inc. MAX6900 RTC
1041                 CONFIG_SYS_RTC_DS1337_NOOSC     - Turn off the OSC output for DS1337
1042                 CONFIG_SYS_RV3029_TCR   - enable trickle charger on
1043                                           RV3029 RTC.
1044
1045                 Note that if the RTC uses I2C, then the I2C interface
1046                 must also be configured. See I2C Support, below.
1047
1048 - GPIO Support:
1049                 CONFIG_PCA953X          - use NXP's PCA953X series I2C GPIO
1050
1051                 The CONFIG_SYS_I2C_PCA953X_WIDTH option specifies a list of
1052                 chip-ngpio pairs that tell the PCA953X driver the number of
1053                 pins supported by a particular chip.
1054
1055                 Note that if the GPIO device uses I2C, then the I2C interface
1056                 must also be configured. See I2C Support, below.
1057
1058 - I/O tracing:
1059                 When CONFIG_IO_TRACE is selected, U-Boot intercepts all I/O
1060                 accesses and can checksum them or write a list of them out
1061                 to memory. See the 'iotrace' command for details. This is
1062                 useful for testing device drivers since it can confirm that
1063                 the driver behaves the same way before and after a code
1064                 change. Currently this is supported on sandbox and arm. To
1065                 add support for your architecture, add '#include <iotrace.h>'
1066                 to the bottom of arch/<arch>/include/asm/io.h and test.
1067
1068                 Example output from the 'iotrace stats' command is below.
1069                 Note that if the trace buffer is exhausted, the checksum will
1070                 still continue to operate.
1071
1072                         iotrace is enabled
1073                         Start:  10000000        (buffer start address)
1074                         Size:   00010000        (buffer size)
1075                         Offset: 00000120        (current buffer offset)
1076                         Output: 10000120        (start + offset)
1077                         Count:  00000018        (number of trace records)
1078                         CRC32:  9526fb66        (CRC32 of all trace records)
1079
1080 - Timestamp Support:
1081
1082                 When CONFIG_TIMESTAMP is selected, the timestamp
1083                 (date and time) of an image is printed by image
1084                 commands like bootm or iminfo. This option is
1085                 automatically enabled when you select CONFIG_CMD_DATE .
1086
1087 - Partition Labels (disklabels) Supported:
1088                 Zero or more of the following:
1089                 CONFIG_MAC_PARTITION   Apple's MacOS partition table.
1090                 CONFIG_DOS_PARTITION   MS Dos partition table, traditional on the
1091                                        Intel architecture, USB sticks, etc.
1092                 CONFIG_ISO_PARTITION   ISO partition table, used on CDROM etc.
1093                 CONFIG_EFI_PARTITION   GPT partition table, common when EFI is the
1094                                        bootloader.  Note 2TB partition limit; see
1095                                        disk/part_efi.c
1096                 CONFIG_MTD_PARTITIONS  Memory Technology Device partition table.
1097
1098                 If IDE or SCSI support is enabled (CONFIG_CMD_IDE or
1099                 CONFIG_SCSI) you must configure support for at
1100                 least one non-MTD partition type as well.
1101
1102 - IDE Reset method:
1103                 CONFIG_IDE_RESET_ROUTINE - this is defined in several
1104                 board configurations files but used nowhere!
1105
1106                 CONFIG_IDE_RESET - is this is defined, IDE Reset will
1107                 be performed by calling the function
1108                         ide_set_reset(int reset)
1109                 which has to be defined in a board specific file
1110
1111 - ATAPI Support:
1112                 CONFIG_ATAPI
1113
1114                 Set this to enable ATAPI support.
1115
1116 - LBA48 Support
1117                 CONFIG_LBA48
1118
1119                 Set this to enable support for disks larger than 137GB
1120                 Also look at CONFIG_SYS_64BIT_LBA.
1121                 Whithout these , LBA48 support uses 32bit variables and will 'only'
1122                 support disks up to 2.1TB.
1123
1124                 CONFIG_SYS_64BIT_LBA:
1125                         When enabled, makes the IDE subsystem use 64bit sector addresses.
1126                         Default is 32bit.
1127
1128 - SCSI Support:
1129                 At the moment only there is only support for the
1130                 SYM53C8XX SCSI controller; define
1131                 CONFIG_SCSI_SYM53C8XX to enable it.
1132
1133                 CONFIG_SYS_SCSI_MAX_LUN [8], CONFIG_SYS_SCSI_MAX_SCSI_ID [7] and
1134                 CONFIG_SYS_SCSI_MAX_DEVICE [CONFIG_SYS_SCSI_MAX_SCSI_ID *
1135                 CONFIG_SYS_SCSI_MAX_LUN] can be adjusted to define the
1136                 maximum numbers of LUNs, SCSI ID's and target
1137                 devices.
1138                 CONFIG_SYS_SCSI_SYM53C8XX_CCF to fix clock timing (80Mhz)
1139
1140                 The environment variable 'scsidevs' is set to the number of
1141                 SCSI devices found during the last scan.
1142
1143 - NETWORK Support (PCI):
1144                 CONFIG_E1000
1145                 Support for Intel 8254x/8257x gigabit chips.
1146
1147                 CONFIG_E1000_SPI
1148                 Utility code for direct access to the SPI bus on Intel 8257x.
1149                 This does not do anything useful unless you set at least one
1150                 of CONFIG_CMD_E1000 or CONFIG_E1000_SPI_GENERIC.
1151
1152                 CONFIG_E1000_SPI_GENERIC
1153                 Allow generic access to the SPI bus on the Intel 8257x, for
1154                 example with the "sspi" command.
1155
1156                 CONFIG_CMD_E1000
1157                 Management command for E1000 devices.  When used on devices
1158                 with SPI support you can reprogram the EEPROM from U-Boot.
1159
1160                 CONFIG_EEPRO100
1161                 Support for Intel 82557/82559/82559ER chips.
1162                 Optional CONFIG_EEPRO100_SROM_WRITE enables EEPROM
1163                 write routine for first time initialisation.
1164
1165                 CONFIG_TULIP
1166                 Support for Digital 2114x chips.
1167                 Optional CONFIG_TULIP_SELECT_MEDIA for board specific
1168                 modem chip initialisation (KS8761/QS6611).
1169
1170                 CONFIG_NATSEMI
1171                 Support for National dp83815 chips.
1172
1173                 CONFIG_NS8382X
1174                 Support for National dp8382[01] gigabit chips.
1175
1176 - NETWORK Support (other):
1177
1178                 CONFIG_DRIVER_AT91EMAC
1179                 Support for AT91RM9200 EMAC.
1180
1181                         CONFIG_RMII
1182                         Define this to use reduced MII inteface
1183
1184                         CONFIG_DRIVER_AT91EMAC_QUIET
1185                         If this defined, the driver is quiet.
1186                         The driver doen't show link status messages.
1187
1188                 CONFIG_CALXEDA_XGMAC
1189                 Support for the Calxeda XGMAC device
1190
1191                 CONFIG_LAN91C96
1192                 Support for SMSC's LAN91C96 chips.
1193
1194                         CONFIG_LAN91C96_USE_32_BIT
1195                         Define this to enable 32 bit addressing
1196
1197                 CONFIG_SMC91111
1198                 Support for SMSC's LAN91C111 chip
1199
1200                         CONFIG_SMC91111_BASE
1201                         Define this to hold the physical address
1202                         of the device (I/O space)
1203
1204                         CONFIG_SMC_USE_32_BIT
1205                         Define this if data bus is 32 bits
1206
1207                         CONFIG_SMC_USE_IOFUNCS
1208                         Define this to use i/o functions instead of macros
1209                         (some hardware wont work with macros)
1210
1211                 CONFIG_DRIVER_TI_EMAC
1212                 Support for davinci emac
1213
1214                         CONFIG_SYS_DAVINCI_EMAC_PHY_COUNT
1215                         Define this if you have more then 3 PHYs.
1216
1217                 CONFIG_FTGMAC100
1218                 Support for Faraday's FTGMAC100 Gigabit SoC Ethernet
1219
1220                         CONFIG_FTGMAC100_EGIGA
1221                         Define this to use GE link update with gigabit PHY.
1222                         Define this if FTGMAC100 is connected to gigabit PHY.
1223                         If your system has 10/100 PHY only, it might not occur
1224                         wrong behavior. Because PHY usually return timeout or
1225                         useless data when polling gigabit status and gigabit
1226                         control registers. This behavior won't affect the
1227                         correctnessof 10/100 link speed update.
1228
1229                 CONFIG_SMC911X
1230                 Support for SMSC's LAN911x and LAN921x chips
1231
1232                         CONFIG_SMC911X_BASE
1233                         Define this to hold the physical address
1234                         of the device (I/O space)
1235
1236                         CONFIG_SMC911X_32_BIT
1237                         Define this if data bus is 32 bits
1238
1239                         CONFIG_SMC911X_16_BIT
1240                         Define this if data bus is 16 bits. If your processor
1241                         automatically converts one 32 bit word to two 16 bit
1242                         words you may also try CONFIG_SMC911X_32_BIT.
1243
1244                 CONFIG_SH_ETHER
1245                 Support for Renesas on-chip Ethernet controller
1246
1247                         CONFIG_SH_ETHER_USE_PORT
1248                         Define the number of ports to be used
1249
1250                         CONFIG_SH_ETHER_PHY_ADDR
1251                         Define the ETH PHY's address
1252
1253                         CONFIG_SH_ETHER_CACHE_WRITEBACK
1254                         If this option is set, the driver enables cache flush.
1255
1256 - PWM Support:
1257                 CONFIG_PWM_IMX
1258                 Support for PWM module on the imx6.
1259
1260 - TPM Support:
1261                 CONFIG_TPM
1262                 Support TPM devices.
1263
1264                 CONFIG_TPM_TIS_INFINEON
1265                 Support for Infineon i2c bus TPM devices. Only one device
1266                 per system is supported at this time.
1267
1268                         CONFIG_TPM_TIS_I2C_BURST_LIMITATION
1269                         Define the burst count bytes upper limit
1270
1271                 CONFIG_TPM_ST33ZP24
1272                 Support for STMicroelectronics TPM devices. Requires DM_TPM support.
1273
1274                         CONFIG_TPM_ST33ZP24_I2C
1275                         Support for STMicroelectronics ST33ZP24 I2C devices.
1276                         Requires TPM_ST33ZP24 and I2C.
1277
1278                         CONFIG_TPM_ST33ZP24_SPI
1279                         Support for STMicroelectronics ST33ZP24 SPI devices.
1280                         Requires TPM_ST33ZP24 and SPI.
1281
1282                 CONFIG_TPM_ATMEL_TWI
1283                 Support for Atmel TWI TPM device. Requires I2C support.
1284
1285                 CONFIG_TPM_TIS_LPC
1286                 Support for generic parallel port TPM devices. Only one device
1287                 per system is supported at this time.
1288
1289                         CONFIG_TPM_TIS_BASE_ADDRESS
1290                         Base address where the generic TPM device is mapped
1291                         to. Contemporary x86 systems usually map it at
1292                         0xfed40000.
1293
1294                 CONFIG_CMD_TPM
1295                 Add tpm monitor functions.
1296                 Requires CONFIG_TPM. If CONFIG_TPM_AUTH_SESSIONS is set, also
1297                 provides monitor access to authorized functions.
1298
1299                 CONFIG_TPM
1300                 Define this to enable the TPM support library which provides
1301                 functional interfaces to some TPM commands.
1302                 Requires support for a TPM device.
1303
1304                 CONFIG_TPM_AUTH_SESSIONS
1305                 Define this to enable authorized functions in the TPM library.
1306                 Requires CONFIG_TPM and CONFIG_SHA1.
1307
1308 - USB Support:
1309                 At the moment only the UHCI host controller is
1310                 supported (PIP405, MIP405, MPC5200); define
1311                 CONFIG_USB_UHCI to enable it.
1312                 define CONFIG_USB_KEYBOARD to enable the USB Keyboard
1313                 and define CONFIG_USB_STORAGE to enable the USB
1314                 storage devices.
1315                 Note:
1316                 Supported are USB Keyboards and USB Floppy drives
1317                 (TEAC FD-05PUB).
1318                 MPC5200 USB requires additional defines:
1319                         CONFIG_USB_CLOCK
1320                                 for 528 MHz Clock: 0x0001bbbb
1321                         CONFIG_PSC3_USB
1322                                 for USB on PSC3
1323                         CONFIG_USB_CONFIG
1324                                 for differential drivers: 0x00001000
1325                                 for single ended drivers: 0x00005000
1326                                 for differential drivers on PSC3: 0x00000100
1327                                 for single ended drivers on PSC3: 0x00004100
1328                         CONFIG_SYS_USB_EVENT_POLL
1329                                 May be defined to allow interrupt polling
1330                                 instead of using asynchronous interrupts
1331
1332                 CONFIG_USB_EHCI_TXFIFO_THRESH enables setting of the
1333                 txfilltuning field in the EHCI controller on reset.
1334
1335                 CONFIG_USB_DWC2_REG_ADDR the physical CPU address of the DWC2
1336                 HW module registers.
1337
1338 - USB Device:
1339                 Define the below if you wish to use the USB console.
1340                 Once firmware is rebuilt from a serial console issue the
1341                 command "setenv stdin usbtty; setenv stdout usbtty" and
1342                 attach your USB cable. The Unix command "dmesg" should print
1343                 it has found a new device. The environment variable usbtty
1344                 can be set to gserial or cdc_acm to enable your device to
1345                 appear to a USB host as a Linux gserial device or a
1346                 Common Device Class Abstract Control Model serial device.
1347                 If you select usbtty = gserial you should be able to enumerate
1348                 a Linux host by
1349                 # modprobe usbserial vendor=0xVendorID product=0xProductID
1350                 else if using cdc_acm, simply setting the environment
1351                 variable usbtty to be cdc_acm should suffice. The following
1352                 might be defined in YourBoardName.h
1353
1354                         CONFIG_USB_DEVICE
1355                         Define this to build a UDC device
1356
1357                         CONFIG_USB_TTY
1358                         Define this to have a tty type of device available to
1359                         talk to the UDC device
1360
1361                         CONFIG_USBD_HS
1362                         Define this to enable the high speed support for usb
1363                         device and usbtty. If this feature is enabled, a routine
1364                         int is_usbd_high_speed(void)
1365                         also needs to be defined by the driver to dynamically poll
1366                         whether the enumeration has succeded at high speed or full
1367                         speed.
1368
1369                         CONFIG_SYS_CONSOLE_IS_IN_ENV
1370                         Define this if you want stdin, stdout &/or stderr to
1371                         be set to usbtty.
1372
1373                         mpc8xx:
1374                                 CONFIG_SYS_USB_EXTC_CLK 0xBLAH
1375                                 Derive USB clock from external clock "blah"
1376                                 - CONFIG_SYS_USB_EXTC_CLK 0x02
1377
1378                 If you have a USB-IF assigned VendorID then you may wish to
1379                 define your own vendor specific values either in BoardName.h
1380                 or directly in usbd_vendor_info.h. If you don't define
1381                 CONFIG_USBD_MANUFACTURER, CONFIG_USBD_PRODUCT_NAME,
1382                 CONFIG_USBD_VENDORID and CONFIG_USBD_PRODUCTID, then U-Boot
1383                 should pretend to be a Linux device to it's target host.
1384
1385                         CONFIG_USBD_MANUFACTURER
1386                         Define this string as the name of your company for
1387                         - CONFIG_USBD_MANUFACTURER "my company"
1388
1389                         CONFIG_USBD_PRODUCT_NAME
1390                         Define this string as the name of your product
1391                         - CONFIG_USBD_PRODUCT_NAME "acme usb device"
1392
1393                         CONFIG_USBD_VENDORID
1394                         Define this as your assigned Vendor ID from the USB
1395                         Implementors Forum. This *must* be a genuine Vendor ID
1396                         to avoid polluting the USB namespace.
1397                         - CONFIG_USBD_VENDORID 0xFFFF
1398
1399                         CONFIG_USBD_PRODUCTID
1400                         Define this as the unique Product ID
1401                         for your device
1402                         - CONFIG_USBD_PRODUCTID 0xFFFF
1403
1404 - ULPI Layer Support:
1405                 The ULPI (UTMI Low Pin (count) Interface) PHYs are supported via
1406                 the generic ULPI layer. The generic layer accesses the ULPI PHY
1407                 via the platform viewport, so you need both the genric layer and
1408                 the viewport enabled. Currently only Chipidea/ARC based
1409                 viewport is supported.
1410                 To enable the ULPI layer support, define CONFIG_USB_ULPI and
1411                 CONFIG_USB_ULPI_VIEWPORT in your board configuration file.
1412                 If your ULPI phy needs a different reference clock than the
1413                 standard 24 MHz then you have to define CONFIG_ULPI_REF_CLK to
1414                 the appropriate value in Hz.
1415
1416 - MMC Support:
1417                 The MMC controller on the Intel PXA is supported. To
1418                 enable this define CONFIG_MMC. The MMC can be
1419                 accessed from the boot prompt by mapping the device
1420                 to physical memory similar to flash. Command line is
1421                 enabled with CONFIG_CMD_MMC. The MMC driver also works with
1422                 the FAT fs. This is enabled with CONFIG_CMD_FAT.
1423
1424                 CONFIG_SH_MMCIF
1425                 Support for Renesas on-chip MMCIF controller
1426
1427                         CONFIG_SH_MMCIF_ADDR
1428                         Define the base address of MMCIF registers
1429
1430                         CONFIG_SH_MMCIF_CLK
1431                         Define the clock frequency for MMCIF
1432
1433                 CONFIG_SUPPORT_EMMC_BOOT
1434                 Enable some additional features of the eMMC boot partitions.
1435
1436                 CONFIG_SUPPORT_EMMC_RPMB
1437                 Enable the commands for reading, writing and programming the
1438                 key for the Replay Protection Memory Block partition in eMMC.
1439
1440 - USB Device Firmware Update (DFU) class support:
1441                 CONFIG_USB_FUNCTION_DFU
1442                 This enables the USB portion of the DFU USB class
1443
1444                 CONFIG_CMD_DFU
1445                 This enables the command "dfu" which is used to have
1446                 U-Boot create a DFU class device via USB.  This command
1447                 requires that the "dfu_alt_info" environment variable be
1448                 set and define the alt settings to expose to the host.
1449
1450                 CONFIG_DFU_MMC
1451                 This enables support for exposing (e)MMC devices via DFU.
1452
1453                 CONFIG_DFU_NAND
1454                 This enables support for exposing NAND devices via DFU.
1455
1456                 CONFIG_DFU_RAM
1457                 This enables support for exposing RAM via DFU.
1458                 Note: DFU spec refer to non-volatile memory usage, but
1459                 allow usages beyond the scope of spec - here RAM usage,
1460                 one that would help mostly the developer.
1461
1462                 CONFIG_SYS_DFU_DATA_BUF_SIZE
1463                 Dfu transfer uses a buffer before writing data to the
1464                 raw storage device. Make the size (in bytes) of this buffer
1465                 configurable. The size of this buffer is also configurable
1466                 through the "dfu_bufsiz" environment variable.
1467
1468                 CONFIG_SYS_DFU_MAX_FILE_SIZE
1469                 When updating files rather than the raw storage device,
1470                 we use a static buffer to copy the file into and then write
1471                 the buffer once we've been given the whole file.  Define
1472                 this to the maximum filesize (in bytes) for the buffer.
1473                 Default is 4 MiB if undefined.
1474
1475                 DFU_DEFAULT_POLL_TIMEOUT
1476                 Poll timeout [ms], is the timeout a device can send to the
1477                 host. The host must wait for this timeout before sending
1478                 a subsequent DFU_GET_STATUS request to the device.
1479
1480                 DFU_MANIFEST_POLL_TIMEOUT
1481                 Poll timeout [ms], which the device sends to the host when
1482                 entering dfuMANIFEST state. Host waits this timeout, before
1483                 sending again an USB request to the device.
1484
1485 - USB Device Android Fastboot support:
1486                 CONFIG_USB_FUNCTION_FASTBOOT
1487                 This enables the USB part of the fastboot gadget
1488
1489                 CONFIG_CMD_FASTBOOT
1490                 This enables the command "fastboot" which enables the Android
1491                 fastboot mode for the platform's USB device. Fastboot is a USB
1492                 protocol for downloading images, flashing and device control
1493                 used on Android devices.
1494                 See doc/README.android-fastboot for more information.
1495
1496                 CONFIG_ANDROID_BOOT_IMAGE
1497                 This enables support for booting images which use the Android
1498                 image format header.
1499
1500                 CONFIG_FASTBOOT_BUF_ADDR
1501                 The fastboot protocol requires a large memory buffer for
1502                 downloads. Define this to the starting RAM address to use for
1503                 downloaded images.
1504
1505                 CONFIG_FASTBOOT_BUF_SIZE
1506                 The fastboot protocol requires a large memory buffer for
1507                 downloads. This buffer should be as large as possible for a
1508                 platform. Define this to the size available RAM for fastboot.
1509
1510                 CONFIG_FASTBOOT_FLASH
1511                 The fastboot protocol includes a "flash" command for writing
1512                 the downloaded image to a non-volatile storage device. Define
1513                 this to enable the "fastboot flash" command.
1514
1515                 CONFIG_FASTBOOT_FLASH_MMC_DEV
1516                 The fastboot "flash" command requires additional information
1517                 regarding the non-volatile storage device. Define this to
1518                 the eMMC device that fastboot should use to store the image.
1519
1520                 CONFIG_FASTBOOT_GPT_NAME
1521                 The fastboot "flash" command supports writing the downloaded
1522                 image to the Protective MBR and the Primary GUID Partition
1523                 Table. (Additionally, this downloaded image is post-processed
1524                 to generate and write the Backup GUID Partition Table.)
1525                 This occurs when the specified "partition name" on the
1526                 "fastboot flash" command line matches this value.
1527                 The default is "gpt" if undefined.
1528
1529                 CONFIG_FASTBOOT_MBR_NAME
1530                 The fastboot "flash" command supports writing the downloaded
1531                 image to DOS MBR.
1532                 This occurs when the "partition name" specified on the
1533                 "fastboot flash" command line matches this value.
1534                 If not defined the default value "mbr" is used.
1535
1536 - Journaling Flash filesystem support:
1537                 CONFIG_JFFS2_NAND
1538                 Define these for a default partition on a NAND device
1539
1540                 CONFIG_SYS_JFFS2_FIRST_SECTOR,
1541                 CONFIG_SYS_JFFS2_FIRST_BANK, CONFIG_SYS_JFFS2_NUM_BANKS
1542                 Define these for a default partition on a NOR device
1543
1544 - FAT(File Allocation Table) filesystem write function support:
1545                 CONFIG_FAT_WRITE
1546
1547                 Define this to enable support for saving memory data as a
1548                 file in FAT formatted partition.
1549
1550                 This will also enable the command "fatwrite" enabling the
1551                 user to write files to FAT.
1552
1553 - CBFS (Coreboot Filesystem) support:
1554                 CONFIG_CMD_CBFS
1555
1556                 Define this to enable support for reading from a Coreboot
1557                 filesystem. Available commands are cbfsinit, cbfsinfo, cbfsls
1558                 and cbfsload.
1559
1560 - FAT(File Allocation Table) filesystem cluster size:
1561                 CONFIG_FS_FAT_MAX_CLUSTSIZE
1562
1563                 Define the max cluster size for fat operations else
1564                 a default value of 65536 will be defined.
1565
1566 - Keyboard Support:
1567                 See Kconfig help for available keyboard drivers.
1568
1569                 CONFIG_KEYBOARD
1570
1571                 Define this to enable a custom keyboard support.
1572                 This simply calls drv_keyboard_init() which must be
1573                 defined in your board-specific files. This option is deprecated
1574                 and is only used by novena. For new boards, use driver model
1575                 instead.
1576
1577 - Video support:
1578                 CONFIG_FSL_DIU_FB
1579                 Enable the Freescale DIU video driver.  Reference boards for
1580                 SOCs that have a DIU should define this macro to enable DIU
1581                 support, and should also define these other macros:
1582
1583                         CONFIG_SYS_DIU_ADDR
1584                         CONFIG_VIDEO
1585                         CONFIG_CMD_BMP
1586                         CONFIG_CFB_CONSOLE
1587                         CONFIG_VIDEO_SW_CURSOR
1588                         CONFIG_VGA_AS_SINGLE_DEVICE
1589                         CONFIG_VIDEO_LOGO
1590                         CONFIG_VIDEO_BMP_LOGO
1591
1592                 The DIU driver will look for the 'video-mode' environment
1593                 variable, and if defined, enable the DIU as a console during
1594                 boot.  See the documentation file doc/README.video for a
1595                 description of this variable.
1596
1597 - LCD Support:  CONFIG_LCD
1598
1599                 Define this to enable LCD support (for output to LCD
1600                 display); also select one of the supported displays
1601                 by defining one of these:
1602
1603                 CONFIG_ATMEL_LCD:
1604
1605                         HITACHI TX09D70VM1CCA, 3.5", 240x320.
1606
1607                 CONFIG_NEC_NL6448AC33:
1608
1609                         NEC NL6448AC33-18. Active, color, single scan.
1610
1611                 CONFIG_NEC_NL6448BC20
1612
1613                         NEC NL6448BC20-08. 6.5", 640x480.
1614                         Active, color, single scan.
1615
1616                 CONFIG_NEC_NL6448BC33_54
1617
1618                         NEC NL6448BC33-54. 10.4", 640x480.
1619                         Active, color, single scan.
1620
1621                 CONFIG_SHARP_16x9
1622
1623                         Sharp 320x240. Active, color, single scan.
1624                         It isn't 16x9, and I am not sure what it is.
1625
1626                 CONFIG_SHARP_LQ64D341
1627
1628                         Sharp LQ64D341 display, 640x480.
1629                         Active, color, single scan.
1630
1631                 CONFIG_HLD1045
1632
1633                         HLD1045 display, 640x480.
1634                         Active, color, single scan.
1635
1636                 CONFIG_OPTREX_BW
1637
1638                         Optrex   CBL50840-2 NF-FW 99 22 M5
1639                         or
1640                         Hitachi  LMG6912RPFC-00T
1641                         or
1642                         Hitachi  SP14Q002
1643
1644                         320x240. Black & white.
1645
1646                 Normally display is black on white background; define
1647                 CONFIG_SYS_WHITE_ON_BLACK to get it inverted.
1648
1649                 CONFIG_LCD_ALIGNMENT
1650
1651                 Normally the LCD is page-aligned (typically 4KB). If this is
1652                 defined then the LCD will be aligned to this value instead.
1653                 For ARM it is sometimes useful to use MMU_SECTION_SIZE
1654                 here, since it is cheaper to change data cache settings on
1655                 a per-section basis.
1656
1657
1658                 CONFIG_LCD_ROTATION
1659
1660                 Sometimes, for example if the display is mounted in portrait
1661                 mode or even if it's mounted landscape but rotated by 180degree,
1662                 we need to rotate our content of the display relative to the
1663                 framebuffer, so that user can read the messages which are
1664                 printed out.
1665                 Once CONFIG_LCD_ROTATION is defined, the lcd_console will be
1666                 initialized with a given rotation from "vl_rot" out of
1667                 "vidinfo_t" which is provided by the board specific code.
1668                 The value for vl_rot is coded as following (matching to
1669                 fbcon=rotate:<n> linux-kernel commandline):
1670                 0 = no rotation respectively 0 degree
1671                 1 = 90 degree rotation
1672                 2 = 180 degree rotation
1673                 3 = 270 degree rotation
1674
1675                 If CONFIG_LCD_ROTATION is not defined, the console will be
1676                 initialized with 0degree rotation.
1677
1678                 CONFIG_LCD_BMP_RLE8
1679
1680                 Support drawing of RLE8-compressed bitmaps on the LCD.
1681
1682                 CONFIG_I2C_EDID
1683
1684                 Enables an 'i2c edid' command which can read EDID
1685                 information over I2C from an attached LCD display.
1686
1687 - Splash Screen Support: CONFIG_SPLASH_SCREEN
1688
1689                 If this option is set, the environment is checked for
1690                 a variable "splashimage". If found, the usual display
1691                 of logo, copyright and system information on the LCD
1692                 is suppressed and the BMP image at the address
1693                 specified in "splashimage" is loaded instead. The
1694                 console is redirected to the "nulldev", too. This
1695                 allows for a "silent" boot where a splash screen is
1696                 loaded very quickly after power-on.
1697
1698                 CONFIG_SPLASHIMAGE_GUARD
1699
1700                 If this option is set, then U-Boot will prevent the environment
1701                 variable "splashimage" from being set to a problematic address
1702                 (see doc/README.displaying-bmps).
1703                 This option is useful for targets where, due to alignment
1704                 restrictions, an improperly aligned BMP image will cause a data
1705                 abort. If you think you will not have problems with unaligned
1706                 accesses (for example because your toolchain prevents them)
1707                 there is no need to set this option.
1708
1709                 CONFIG_SPLASH_SCREEN_ALIGN
1710
1711                 If this option is set the splash image can be freely positioned
1712                 on the screen. Environment variable "splashpos" specifies the
1713                 position as "x,y". If a positive number is given it is used as
1714                 number of pixel from left/top. If a negative number is given it
1715                 is used as number of pixel from right/bottom. You can also
1716                 specify 'm' for centering the image.
1717
1718                 Example:
1719                 setenv splashpos m,m
1720                         => image at center of screen
1721
1722                 setenv splashpos 30,20
1723                         => image at x = 30 and y = 20
1724
1725                 setenv splashpos -10,m
1726                         => vertically centered image
1727                            at x = dspWidth - bmpWidth - 9
1728
1729 - Gzip compressed BMP image support: CONFIG_VIDEO_BMP_GZIP
1730
1731                 If this option is set, additionally to standard BMP
1732                 images, gzipped BMP images can be displayed via the
1733                 splashscreen support or the bmp command.
1734
1735 - Run length encoded BMP image (RLE8) support: CONFIG_VIDEO_BMP_RLE8
1736
1737                 If this option is set, 8-bit RLE compressed BMP images
1738                 can be displayed via the splashscreen support or the
1739                 bmp command.
1740
1741 - Compression support:
1742                 CONFIG_GZIP
1743
1744                 Enabled by default to support gzip compressed images.
1745
1746                 CONFIG_BZIP2
1747
1748                 If this option is set, support for bzip2 compressed
1749                 images is included. If not, only uncompressed and gzip
1750                 compressed images are supported.
1751
1752                 NOTE: the bzip2 algorithm requires a lot of RAM, so
1753                 the malloc area (as defined by CONFIG_SYS_MALLOC_LEN) should
1754                 be at least 4MB.
1755
1756                 CONFIG_LZMA
1757
1758                 If this option is set, support for lzma compressed
1759                 images is included.
1760
1761                 Note: The LZMA algorithm adds between 2 and 4KB of code and it
1762                 requires an amount of dynamic memory that is given by the
1763                 formula:
1764
1765                         (1846 + 768 << (lc + lp)) * sizeof(uint16)
1766
1767                 Where lc and lp stand for, respectively, Literal context bits
1768                 and Literal pos bits.
1769
1770                 This value is upper-bounded by 14MB in the worst case. Anyway,
1771                 for a ~4MB large kernel image, we have lc=3 and lp=0 for a
1772                 total amount of (1846 + 768 << (3 + 0)) * 2 = ~41KB... that is
1773                 a very small buffer.
1774
1775                 Use the lzmainfo tool to determinate the lc and lp values and
1776                 then calculate the amount of needed dynamic memory (ensuring
1777                 the appropriate CONFIG_SYS_MALLOC_LEN value).
1778
1779                 CONFIG_LZO
1780
1781                 If this option is set, support for LZO compressed images
1782                 is included.
1783
1784 - MII/PHY support:
1785                 CONFIG_PHY_ADDR
1786
1787                 The address of PHY on MII bus.
1788
1789                 CONFIG_PHY_CLOCK_FREQ (ppc4xx)
1790
1791                 The clock frequency of the MII bus
1792
1793                 CONFIG_PHY_GIGE
1794
1795                 If this option is set, support for speed/duplex
1796                 detection of gigabit PHY is included.
1797
1798                 CONFIG_PHY_RESET_DELAY
1799
1800                 Some PHY like Intel LXT971A need extra delay after
1801                 reset before any MII register access is possible.
1802                 For such PHY, set this option to the usec delay
1803                 required. (minimum 300usec for LXT971A)
1804
1805                 CONFIG_PHY_CMD_DELAY (ppc4xx)
1806
1807                 Some PHY like Intel LXT971A need extra delay after
1808                 command issued before MII status register can be read
1809
1810 - IP address:
1811                 CONFIG_IPADDR
1812
1813                 Define a default value for the IP address to use for
1814                 the default Ethernet interface, in case this is not
1815                 determined through e.g. bootp.
1816                 (Environment variable "ipaddr")
1817
1818 - Server IP address:
1819                 CONFIG_SERVERIP
1820
1821                 Defines a default value for the IP address of a TFTP
1822                 server to contact when using the "tftboot" command.
1823                 (Environment variable "serverip")
1824
1825                 CONFIG_KEEP_SERVERADDR
1826
1827                 Keeps the server's MAC address, in the env 'serveraddr'
1828                 for passing to bootargs (like Linux's netconsole option)
1829
1830 - Gateway IP address:
1831                 CONFIG_GATEWAYIP
1832
1833                 Defines a default value for the IP address of the
1834                 default router where packets to other networks are
1835                 sent to.
1836                 (Environment variable "gatewayip")
1837
1838 - Subnet mask:
1839                 CONFIG_NETMASK
1840
1841                 Defines a default value for the subnet mask (or
1842                 routing prefix) which is used to determine if an IP
1843                 address belongs to the local subnet or needs to be
1844                 forwarded through a router.
1845                 (Environment variable "netmask")
1846
1847 - Multicast TFTP Mode:
1848                 CONFIG_MCAST_TFTP
1849
1850                 Defines whether you want to support multicast TFTP as per
1851                 rfc-2090; for example to work with atftp.  Lets lots of targets
1852                 tftp down the same boot image concurrently.  Note: the Ethernet
1853                 driver in use must provide a function: mcast() to join/leave a
1854                 multicast group.
1855
1856 - BOOTP Recovery Mode:
1857                 CONFIG_BOOTP_RANDOM_DELAY
1858
1859                 If you have many targets in a network that try to
1860                 boot using BOOTP, you may want to avoid that all
1861                 systems send out BOOTP requests at precisely the same
1862                 moment (which would happen for instance at recovery
1863                 from a power failure, when all systems will try to
1864                 boot, thus flooding the BOOTP server. Defining
1865                 CONFIG_BOOTP_RANDOM_DELAY causes a random delay to be
1866                 inserted before sending out BOOTP requests. The
1867                 following delays are inserted then:
1868
1869                 1st BOOTP request:      delay 0 ... 1 sec
1870                 2nd BOOTP request:      delay 0 ... 2 sec
1871                 3rd BOOTP request:      delay 0 ... 4 sec
1872                 4th and following
1873                 BOOTP requests:         delay 0 ... 8 sec
1874
1875                 CONFIG_BOOTP_ID_CACHE_SIZE
1876
1877                 BOOTP packets are uniquely identified using a 32-bit ID. The
1878                 server will copy the ID from client requests to responses and
1879                 U-Boot will use this to determine if it is the destination of
1880                 an incoming response. Some servers will check that addresses
1881                 aren't in use before handing them out (usually using an ARP
1882                 ping) and therefore take up to a few hundred milliseconds to
1883                 respond. Network congestion may also influence the time it
1884                 takes for a response to make it back to the client. If that
1885                 time is too long, U-Boot will retransmit requests. In order
1886                 to allow earlier responses to still be accepted after these
1887                 retransmissions, U-Boot's BOOTP client keeps a small cache of
1888                 IDs. The CONFIG_BOOTP_ID_CACHE_SIZE controls the size of this
1889                 cache. The default is to keep IDs for up to four outstanding
1890                 requests. Increasing this will allow U-Boot to accept offers
1891                 from a BOOTP client in networks with unusually high latency.
1892
1893 - DHCP Advanced Options:
1894                 You can fine tune the DHCP functionality by defining
1895                 CONFIG_BOOTP_* symbols:
1896
1897                 CONFIG_BOOTP_SUBNETMASK
1898                 CONFIG_BOOTP_GATEWAY
1899                 CONFIG_BOOTP_HOSTNAME
1900                 CONFIG_BOOTP_NISDOMAIN
1901                 CONFIG_BOOTP_BOOTPATH
1902                 CONFIG_BOOTP_BOOTFILESIZE
1903                 CONFIG_BOOTP_DNS
1904                 CONFIG_BOOTP_DNS2
1905                 CONFIG_BOOTP_SEND_HOSTNAME
1906                 CONFIG_BOOTP_NTPSERVER
1907                 CONFIG_BOOTP_TIMEOFFSET
1908                 CONFIG_BOOTP_VENDOREX
1909                 CONFIG_BOOTP_MAY_FAIL
1910
1911                 CONFIG_BOOTP_SERVERIP - TFTP server will be the serverip
1912                 environment variable, not the BOOTP server.
1913
1914                 CONFIG_BOOTP_MAY_FAIL - If the DHCP server is not found
1915                 after the configured retry count, the call will fail
1916                 instead of starting over.  This can be used to fail over
1917                 to Link-local IP address configuration if the DHCP server
1918                 is not available.
1919
1920                 CONFIG_BOOTP_DNS2 - If a DHCP client requests the DNS
1921                 serverip from a DHCP server, it is possible that more
1922                 than one DNS serverip is offered to the client.
1923                 If CONFIG_BOOTP_DNS2 is enabled, the secondary DNS
1924                 serverip will be stored in the additional environment
1925                 variable "dnsip2". The first DNS serverip is always
1926                 stored in the variable "dnsip", when CONFIG_BOOTP_DNS
1927                 is defined.
1928
1929                 CONFIG_BOOTP_SEND_HOSTNAME - Some DHCP servers are capable
1930                 to do a dynamic update of a DNS server. To do this, they
1931                 need the hostname of the DHCP requester.
1932                 If CONFIG_BOOTP_SEND_HOSTNAME is defined, the content
1933                 of the "hostname" environment variable is passed as
1934                 option 12 to the DHCP server.
1935
1936                 CONFIG_BOOTP_DHCP_REQUEST_DELAY
1937
1938                 A 32bit value in microseconds for a delay between
1939                 receiving a "DHCP Offer" and sending the "DHCP Request".
1940                 This fixes a problem with certain DHCP servers that don't
1941                 respond 100% of the time to a "DHCP request". E.g. On an
1942                 AT91RM9200 processor running at 180MHz, this delay needed
1943                 to be *at least* 15,000 usec before a Windows Server 2003
1944                 DHCP server would reply 100% of the time. I recommend at
1945                 least 50,000 usec to be safe. The alternative is to hope
1946                 that one of the retries will be successful but note that
1947                 the DHCP timeout and retry process takes a longer than
1948                 this delay.
1949
1950  - Link-local IP address negotiation:
1951                 Negotiate with other link-local clients on the local network
1952                 for an address that doesn't require explicit configuration.
1953                 This is especially useful if a DHCP server cannot be guaranteed
1954                 to exist in all environments that the device must operate.
1955
1956                 See doc/README.link-local for more information.
1957
1958  - CDP Options:
1959                 CONFIG_CDP_DEVICE_ID
1960
1961                 The device id used in CDP trigger frames.
1962
1963                 CONFIG_CDP_DEVICE_ID_PREFIX
1964
1965                 A two character string which is prefixed to the MAC address
1966                 of the device.
1967
1968                 CONFIG_CDP_PORT_ID
1969
1970                 A printf format string which contains the ascii name of
1971                 the port. Normally is set to "eth%d" which sets
1972                 eth0 for the first Ethernet, eth1 for the second etc.
1973
1974                 CONFIG_CDP_CAPABILITIES
1975
1976                 A 32bit integer which indicates the device capabilities;
1977                 0x00000010 for a normal host which does not forwards.
1978
1979                 CONFIG_CDP_VERSION
1980
1981                 An ascii string containing the version of the software.
1982
1983                 CONFIG_CDP_PLATFORM
1984
1985                 An ascii string containing the name of the platform.
1986
1987                 CONFIG_CDP_TRIGGER
1988
1989                 A 32bit integer sent on the trigger.
1990
1991                 CONFIG_CDP_POWER_CONSUMPTION
1992
1993                 A 16bit integer containing the power consumption of the
1994                 device in .1 of milliwatts.
1995
1996                 CONFIG_CDP_APPLIANCE_VLAN_TYPE
1997
1998                 A byte containing the id of the VLAN.
1999
2000 - Status LED:   CONFIG_LED_STATUS
2001
2002                 Several configurations allow to display the current
2003                 status using a LED. For instance, the LED will blink
2004                 fast while running U-Boot code, stop blinking as
2005                 soon as a reply to a BOOTP request was received, and
2006                 start blinking slow once the Linux kernel is running
2007                 (supported by a status LED driver in the Linux
2008                 kernel). Defining CONFIG_LED_STATUS enables this
2009                 feature in U-Boot.
2010
2011                 Additional options:
2012
2013                 CONFIG_LED_STATUS_GPIO
2014                 The status LED can be connected to a GPIO pin.
2015                 In such cases, the gpio_led driver can be used as a
2016                 status LED backend implementation. Define CONFIG_LED_STATUS_GPIO
2017                 to include the gpio_led driver in the U-Boot binary.
2018
2019                 CONFIG_GPIO_LED_INVERTED_TABLE
2020                 Some GPIO connected LEDs may have inverted polarity in which
2021                 case the GPIO high value corresponds to LED off state and
2022                 GPIO low value corresponds to LED on state.
2023                 In such cases CONFIG_GPIO_LED_INVERTED_TABLE may be defined
2024                 with a list of GPIO LEDs that have inverted polarity.
2025
2026 - CAN Support:  CONFIG_CAN_DRIVER
2027
2028                 Defining CONFIG_CAN_DRIVER enables CAN driver support
2029                 on those systems that support this (optional)
2030                 feature, like the TQM8xxL modules.
2031
2032 - I2C Support:  CONFIG_SYS_I2C
2033
2034                 This enable the NEW i2c subsystem, and will allow you to use
2035                 i2c commands at the u-boot command line (as long as you set
2036                 CONFIG_CMD_I2C in CONFIG_COMMANDS) and communicate with i2c
2037                 based realtime clock chips or other i2c devices. See
2038                 common/cmd_i2c.c for a description of the command line
2039                 interface.
2040
2041                 ported i2c driver to the new framework:
2042                 - drivers/i2c/soft_i2c.c:
2043                   - activate first bus with CONFIG_SYS_I2C_SOFT define
2044                     CONFIG_SYS_I2C_SOFT_SPEED and CONFIG_SYS_I2C_SOFT_SLAVE
2045                     for defining speed and slave address
2046                   - activate second bus with I2C_SOFT_DECLARATIONS2 define
2047                     CONFIG_SYS_I2C_SOFT_SPEED_2 and CONFIG_SYS_I2C_SOFT_SLAVE_2
2048                     for defining speed and slave address
2049                   - activate third bus with I2C_SOFT_DECLARATIONS3 define
2050                     CONFIG_SYS_I2C_SOFT_SPEED_3 and CONFIG_SYS_I2C_SOFT_SLAVE_3
2051                     for defining speed and slave address
2052                   - activate fourth bus with I2C_SOFT_DECLARATIONS4 define
2053                     CONFIG_SYS_I2C_SOFT_SPEED_4 and CONFIG_SYS_I2C_SOFT_SLAVE_4
2054                     for defining speed and slave address
2055
2056                 - drivers/i2c/fsl_i2c.c:
2057                   - activate i2c driver with CONFIG_SYS_I2C_FSL
2058                     define CONFIG_SYS_FSL_I2C_OFFSET for setting the register
2059                     offset CONFIG_SYS_FSL_I2C_SPEED for the i2c speed and
2060                     CONFIG_SYS_FSL_I2C_SLAVE for the slave addr of the first
2061                     bus.
2062                   - If your board supports a second fsl i2c bus, define
2063                     CONFIG_SYS_FSL_I2C2_OFFSET for the register offset
2064                     CONFIG_SYS_FSL_I2C2_SPEED for the speed and
2065                     CONFIG_SYS_FSL_I2C2_SLAVE for the slave address of the
2066                     second bus.
2067
2068                 - drivers/i2c/tegra_i2c.c:
2069                   - activate this driver with CONFIG_SYS_I2C_TEGRA
2070                   - This driver adds 4 i2c buses with a fix speed from
2071                     100000 and the slave addr 0!
2072
2073                 - drivers/i2c/ppc4xx_i2c.c
2074                   - activate this driver with CONFIG_SYS_I2C_PPC4XX
2075                   - CONFIG_SYS_I2C_PPC4XX_CH0 activate hardware channel 0
2076                   - CONFIG_SYS_I2C_PPC4XX_CH1 activate hardware channel 1
2077
2078                 - drivers/i2c/i2c_mxc.c
2079                   - activate this driver with CONFIG_SYS_I2C_MXC
2080                   - enable bus 1 with CONFIG_SYS_I2C_MXC_I2C1
2081                   - enable bus 2 with CONFIG_SYS_I2C_MXC_I2C2
2082                   - enable bus 3 with CONFIG_SYS_I2C_MXC_I2C3
2083                   - enable bus 4 with CONFIG_SYS_I2C_MXC_I2C4
2084                   - define speed for bus 1 with CONFIG_SYS_MXC_I2C1_SPEED
2085                   - define slave for bus 1 with CONFIG_SYS_MXC_I2C1_SLAVE
2086                   - define speed for bus 2 with CONFIG_SYS_MXC_I2C2_SPEED
2087                   - define slave for bus 2 with CONFIG_SYS_MXC_I2C2_SLAVE
2088                   - define speed for bus 3 with CONFIG_SYS_MXC_I2C3_SPEED
2089                   - define slave for bus 3 with CONFIG_SYS_MXC_I2C3_SLAVE
2090                   - define speed for bus 4 with CONFIG_SYS_MXC_I2C4_SPEED
2091                   - define slave for bus 4 with CONFIG_SYS_MXC_I2C4_SLAVE
2092                 If those defines are not set, default value is 100000
2093                 for speed, and 0 for slave.
2094
2095                 - drivers/i2c/rcar_i2c.c:
2096                   - activate this driver with CONFIG_SYS_I2C_RCAR
2097                   - This driver adds 4 i2c buses
2098
2099                   - CONFIG_SYS_RCAR_I2C0_BASE for setting the register channel 0
2100                   - CONFIG_SYS_RCAR_I2C0_SPEED for for the speed channel 0
2101                   - CONFIG_SYS_RCAR_I2C1_BASE for setting the register channel 1
2102                   - CONFIG_SYS_RCAR_I2C1_SPEED for for the speed channel 1
2103                   - CONFIG_SYS_RCAR_I2C2_BASE for setting the register channel 2
2104                   - CONFIG_SYS_RCAR_I2C2_SPEED for for the speed channel 2
2105                   - CONFIG_SYS_RCAR_I2C3_BASE for setting the register channel 3
2106                   - CONFIG_SYS_RCAR_I2C3_SPEED for for the speed channel 3
2107                   - CONFIF_SYS_RCAR_I2C_NUM_CONTROLLERS for number of i2c buses
2108
2109                 - drivers/i2c/sh_i2c.c:
2110                   - activate this driver with CONFIG_SYS_I2C_SH
2111                   - This driver adds from 2 to 5 i2c buses
2112
2113                   - CONFIG_SYS_I2C_SH_BASE0 for setting the register channel 0
2114                   - CONFIG_SYS_I2C_SH_SPEED0 for for the speed channel 0
2115                   - CONFIG_SYS_I2C_SH_BASE1 for setting the register channel 1
2116                   - CONFIG_SYS_I2C_SH_SPEED1 for for the speed channel 1
2117                   - CONFIG_SYS_I2C_SH_BASE2 for setting the register channel 2
2118                   - CONFIG_SYS_I2C_SH_SPEED2 for for the speed channel 2
2119                   - CONFIG_SYS_I2C_SH_BASE3 for setting the register channel 3
2120                   - CONFIG_SYS_I2C_SH_SPEED3 for for the speed channel 3
2121                   - CONFIG_SYS_I2C_SH_BASE4 for setting the register channel 4
2122                   - CONFIG_SYS_I2C_SH_SPEED4 for for the speed channel 4
2123                   - CONFIG_SYS_I2C_SH_NUM_CONTROLLERS for number of i2c buses
2124
2125                 - drivers/i2c/omap24xx_i2c.c
2126                   - activate this driver with CONFIG_SYS_I2C_OMAP24XX
2127                   - CONFIG_SYS_OMAP24_I2C_SPEED speed channel 0
2128                   - CONFIG_SYS_OMAP24_I2C_SLAVE slave addr channel 0
2129                   - CONFIG_SYS_OMAP24_I2C_SPEED1 speed channel 1
2130                   - CONFIG_SYS_OMAP24_I2C_SLAVE1 slave addr channel 1
2131                   - CONFIG_SYS_OMAP24_I2C_SPEED2 speed channel 2
2132                   - CONFIG_SYS_OMAP24_I2C_SLAVE2 slave addr channel 2
2133                   - CONFIG_SYS_OMAP24_I2C_SPEED3 speed channel 3
2134                   - CONFIG_SYS_OMAP24_I2C_SLAVE3 slave addr channel 3
2135                   - CONFIG_SYS_OMAP24_I2C_SPEED4 speed channel 4
2136                   - CONFIG_SYS_OMAP24_I2C_SLAVE4 slave addr channel 4
2137
2138                 - drivers/i2c/zynq_i2c.c
2139                   - activate this driver with CONFIG_SYS_I2C_ZYNQ
2140                   - set CONFIG_SYS_I2C_ZYNQ_SPEED for speed setting
2141                   - set CONFIG_SYS_I2C_ZYNQ_SLAVE for slave addr
2142
2143                 - drivers/i2c/s3c24x0_i2c.c:
2144                   - activate this driver with CONFIG_SYS_I2C_S3C24X0
2145                   - This driver adds i2c buses (11 for Exynos5250, Exynos5420
2146                     9 i2c buses for Exynos4 and 1 for S3C24X0 SoCs from Samsung)
2147                     with a fix speed from 100000 and the slave addr 0!
2148
2149                 - drivers/i2c/ihs_i2c.c
2150                   - activate this driver with CONFIG_SYS_I2C_IHS
2151                   - CONFIG_SYS_I2C_IHS_CH0 activate hardware channel 0
2152                   - CONFIG_SYS_I2C_IHS_SPEED_0 speed channel 0
2153                   - CONFIG_SYS_I2C_IHS_SLAVE_0 slave addr channel 0
2154                   - CONFIG_SYS_I2C_IHS_CH1 activate hardware channel 1
2155                   - CONFIG_SYS_I2C_IHS_SPEED_1 speed channel 1
2156                   - CONFIG_SYS_I2C_IHS_SLAVE_1 slave addr channel 1
2157                   - CONFIG_SYS_I2C_IHS_CH2 activate hardware channel 2
2158                   - CONFIG_SYS_I2C_IHS_SPEED_2 speed channel 2
2159                   - CONFIG_SYS_I2C_IHS_SLAVE_2 slave addr channel 2
2160                   - CONFIG_SYS_I2C_IHS_CH3 activate hardware channel 3
2161                   - CONFIG_SYS_I2C_IHS_SPEED_3 speed channel 3
2162                   - CONFIG_SYS_I2C_IHS_SLAVE_3 slave addr channel 3
2163                   - activate dual channel with CONFIG_SYS_I2C_IHS_DUAL
2164                   - CONFIG_SYS_I2C_IHS_SPEED_0_1 speed channel 0_1
2165                   - CONFIG_SYS_I2C_IHS_SLAVE_0_1 slave addr channel 0_1
2166                   - CONFIG_SYS_I2C_IHS_SPEED_1_1 speed channel 1_1
2167                   - CONFIG_SYS_I2C_IHS_SLAVE_1_1 slave addr channel 1_1
2168                   - CONFIG_SYS_I2C_IHS_SPEED_2_1 speed channel 2_1
2169                   - CONFIG_SYS_I2C_IHS_SLAVE_2_1 slave addr channel 2_1
2170                   - CONFIG_SYS_I2C_IHS_SPEED_3_1 speed channel 3_1
2171                   - CONFIG_SYS_I2C_IHS_SLAVE_3_1 slave addr channel 3_1
2172
2173                 additional defines:
2174
2175                 CONFIG_SYS_NUM_I2C_BUSES
2176                 Hold the number of i2c buses you want to use.
2177
2178                 CONFIG_SYS_I2C_DIRECT_BUS
2179                 define this, if you don't use i2c muxes on your hardware.
2180                 if CONFIG_SYS_I2C_MAX_HOPS is not defined or == 0 you can
2181                 omit this define.
2182
2183                 CONFIG_SYS_I2C_MAX_HOPS
2184                 define how many muxes are maximal consecutively connected
2185                 on one i2c bus. If you not use i2c muxes, omit this
2186                 define.
2187
2188                 CONFIG_SYS_I2C_BUSES
2189                 hold a list of buses you want to use, only used if
2190                 CONFIG_SYS_I2C_DIRECT_BUS is not defined, for example
2191                 a board with CONFIG_SYS_I2C_MAX_HOPS = 1 and
2192                 CONFIG_SYS_NUM_I2C_BUSES = 9:
2193
2194                  CONFIG_SYS_I2C_BUSES   {{0, {I2C_NULL_HOP}}, \
2195                                         {0, {{I2C_MUX_PCA9547, 0x70, 1}}}, \
2196                                         {0, {{I2C_MUX_PCA9547, 0x70, 2}}}, \
2197                                         {0, {{I2C_MUX_PCA9547, 0x70, 3}}}, \
2198                                         {0, {{I2C_MUX_PCA9547, 0x70, 4}}}, \
2199                                         {0, {{I2C_MUX_PCA9547, 0x70, 5}}}, \
2200                                         {1, {I2C_NULL_HOP}}, \
2201                                         {1, {{I2C_MUX_PCA9544, 0x72, 1}}}, \
2202                                         {1, {{I2C_MUX_PCA9544, 0x72, 2}}}, \
2203                                         }
2204
2205                 which defines
2206                         bus 0 on adapter 0 without a mux
2207                         bus 1 on adapter 0 with a PCA9547 on address 0x70 port 1
2208                         bus 2 on adapter 0 with a PCA9547 on address 0x70 port 2
2209                         bus 3 on adapter 0 with a PCA9547 on address 0x70 port 3
2210                         bus 4 on adapter 0 with a PCA9547 on address 0x70 port 4
2211                         bus 5 on adapter 0 with a PCA9547 on address 0x70 port 5
2212                         bus 6 on adapter 1 without a mux
2213                         bus 7 on adapter 1 with a PCA9544 on address 0x72 port 1
2214                         bus 8 on adapter 1 with a PCA9544 on address 0x72 port 2
2215
2216                 If you do not have i2c muxes on your board, omit this define.
2217
2218 - Legacy I2C Support:   CONFIG_HARD_I2C
2219
2220                 NOTE: It is intended to move drivers to CONFIG_SYS_I2C which
2221                 provides the following compelling advantages:
2222
2223                 - more than one i2c adapter is usable
2224                 - approved multibus support
2225                 - better i2c mux support
2226
2227                 ** Please consider updating your I2C driver now. **
2228
2229                 These enable legacy I2C serial bus commands. Defining
2230                 CONFIG_HARD_I2C will include the appropriate I2C driver
2231                 for the selected CPU.
2232
2233                 This will allow you to use i2c commands at the u-boot
2234                 command line (as long as you set CONFIG_CMD_I2C in
2235                 CONFIG_COMMANDS) and communicate with i2c based realtime
2236                 clock chips. See common/cmd_i2c.c for a description of the
2237                 command line interface.
2238
2239                 CONFIG_HARD_I2C selects a hardware I2C controller.
2240
2241                 There are several other quantities that must also be
2242                 defined when you define CONFIG_HARD_I2C.
2243
2244                 In both cases you will need to define CONFIG_SYS_I2C_SPEED
2245                 to be the frequency (in Hz) at which you wish your i2c bus
2246                 to run and CONFIG_SYS_I2C_SLAVE to be the address of this node (ie
2247                 the CPU's i2c node address).
2248
2249                 Now, the u-boot i2c code for the mpc8xx
2250                 (arch/powerpc/cpu/mpc8xx/i2c.c) sets the CPU up as a master node
2251                 and so its address should therefore be cleared to 0 (See,
2252                 eg, MPC823e User's Manual p.16-473). So, set
2253                 CONFIG_SYS_I2C_SLAVE to 0.
2254
2255                 CONFIG_SYS_I2C_INIT_MPC5XXX
2256
2257                 When a board is reset during an i2c bus transfer
2258                 chips might think that the current transfer is still
2259                 in progress.  Reset the slave devices by sending start
2260                 commands until the slave device responds.
2261
2262                 That's all that's required for CONFIG_HARD_I2C.
2263
2264                 If you use the software i2c interface (CONFIG_SYS_I2C_SOFT)
2265                 then the following macros need to be defined (examples are
2266                 from include/configs/lwmon.h):
2267
2268                 I2C_INIT
2269
2270                 (Optional). Any commands necessary to enable the I2C
2271                 controller or configure ports.
2272
2273                 eg: #define I2C_INIT (immr->im_cpm.cp_pbdir |=  PB_SCL)
2274
2275                 I2C_PORT
2276
2277                 (Only for MPC8260 CPU). The I/O port to use (the code
2278                 assumes both bits are on the same port). Valid values
2279                 are 0..3 for ports A..D.
2280
2281                 I2C_ACTIVE
2282
2283                 The code necessary to make the I2C data line active
2284                 (driven).  If the data line is open collector, this
2285                 define can be null.
2286
2287                 eg: #define I2C_ACTIVE (immr->im_cpm.cp_pbdir |=  PB_SDA)
2288
2289                 I2C_TRISTATE
2290
2291                 The code necessary to make the I2C data line tri-stated
2292                 (inactive).  If the data line is open collector, this
2293                 define can be null.
2294
2295                 eg: #define I2C_TRISTATE (immr->im_cpm.cp_pbdir &= ~PB_SDA)
2296
2297                 I2C_READ
2298
2299                 Code that returns true if the I2C data line is high,
2300                 false if it is low.
2301
2302                 eg: #define I2C_READ ((immr->im_cpm.cp_pbdat & PB_SDA) != 0)
2303
2304                 I2C_SDA(bit)
2305
2306                 If <bit> is true, sets the I2C data line high. If it
2307                 is false, it clears it (low).
2308
2309                 eg: #define I2C_SDA(bit) \
2310                         if(bit) immr->im_cpm.cp_pbdat |=  PB_SDA; \
2311                         else    immr->im_cpm.cp_pbdat &= ~PB_SDA
2312
2313                 I2C_SCL(bit)
2314
2315                 If <bit> is true, sets the I2C clock line high. If it
2316                 is false, it clears it (low).
2317
2318                 eg: #define I2C_SCL(bit) \
2319                         if(bit) immr->im_cpm.cp_pbdat |=  PB_SCL; \
2320                         else    immr->im_cpm.cp_pbdat &= ~PB_SCL
2321
2322                 I2C_DELAY
2323
2324                 This delay is invoked four times per clock cycle so this
2325                 controls the rate of data transfer.  The data rate thus
2326                 is 1 / (I2C_DELAY * 4). Often defined to be something
2327                 like:
2328
2329                 #define I2C_DELAY  udelay(2)
2330
2331                 CONFIG_SOFT_I2C_GPIO_SCL / CONFIG_SOFT_I2C_GPIO_SDA
2332
2333                 If your arch supports the generic GPIO framework (asm/gpio.h),
2334                 then you may alternatively define the two GPIOs that are to be
2335                 used as SCL / SDA.  Any of the previous I2C_xxx macros will
2336                 have GPIO-based defaults assigned to them as appropriate.
2337
2338                 You should define these to the GPIO value as given directly to
2339                 the generic GPIO functions.
2340
2341                 CONFIG_SYS_I2C_INIT_BOARD
2342
2343                 When a board is reset during an i2c bus transfer
2344                 chips might think that the current transfer is still
2345                 in progress. On some boards it is possible to access
2346                 the i2c SCLK line directly, either by using the
2347                 processor pin as a GPIO or by having a second pin
2348                 connected to the bus. If this option is defined a
2349                 custom i2c_init_board() routine in boards/xxx/board.c
2350                 is run early in the boot sequence.
2351
2352                 CONFIG_SYS_I2C_BOARD_LATE_INIT
2353
2354                 An alternative to CONFIG_SYS_I2C_INIT_BOARD. If this option is
2355                 defined a custom i2c_board_late_init() routine in
2356                 boards/xxx/board.c is run AFTER the operations in i2c_init()
2357                 is completed. This callpoint can be used to unreset i2c bus
2358                 using CPU i2c controller register accesses for CPUs whose i2c
2359                 controller provide such a method. It is called at the end of
2360                 i2c_init() to allow i2c_init operations to setup the i2c bus
2361                 controller on the CPU (e.g. setting bus speed & slave address).
2362
2363                 CONFIG_I2CFAST (PPC405GP|PPC405EP only)
2364
2365                 This option enables configuration of bi_iic_fast[] flags
2366                 in u-boot bd_info structure based on u-boot environment
2367                 variable "i2cfast". (see also i2cfast)
2368
2369                 CONFIG_I2C_MULTI_BUS
2370
2371                 This option allows the use of multiple I2C buses, each of which
2372                 must have a controller.  At any point in time, only one bus is
2373                 active.  To switch to a different bus, use the 'i2c dev' command.
2374                 Note that bus numbering is zero-based.
2375
2376                 CONFIG_SYS_I2C_NOPROBES
2377
2378                 This option specifies a list of I2C devices that will be skipped
2379                 when the 'i2c probe' command is issued.  If CONFIG_I2C_MULTI_BUS
2380                 is set, specify a list of bus-device pairs.  Otherwise, specify
2381                 a 1D array of device addresses
2382
2383                 e.g.
2384                         #undef  CONFIG_I2C_MULTI_BUS
2385                         #define CONFIG_SYS_I2C_NOPROBES {0x50,0x68}
2386
2387                 will skip addresses 0x50 and 0x68 on a board with one I2C bus
2388
2389                         #define CONFIG_I2C_MULTI_BUS
2390                         #define CONFIG_SYS_I2C_NOPROBES {{0,0x50},{0,0x68},{1,0x54}}
2391
2392                 will skip addresses 0x50 and 0x68 on bus 0 and address 0x54 on bus 1
2393
2394                 CONFIG_SYS_SPD_BUS_NUM
2395
2396                 If defined, then this indicates the I2C bus number for DDR SPD.
2397                 If not defined, then U-Boot assumes that SPD is on I2C bus 0.
2398
2399                 CONFIG_SYS_RTC_BUS_NUM
2400
2401                 If defined, then this indicates the I2C bus number for the RTC.
2402                 If not defined, then U-Boot assumes that RTC is on I2C bus 0.
2403
2404                 CONFIG_SYS_DTT_BUS_NUM
2405
2406                 If defined, then this indicates the I2C bus number for the DTT.
2407                 If not defined, then U-Boot assumes that DTT is on I2C bus 0.
2408
2409                 CONFIG_SYS_I2C_DTT_ADDR:
2410
2411                 If defined, specifies the I2C address of the DTT device.
2412                 If not defined, then U-Boot uses predefined value for
2413                 specified DTT device.
2414
2415                 CONFIG_SOFT_I2C_READ_REPEATED_START
2416
2417                 defining this will force the i2c_read() function in
2418                 the soft_i2c driver to perform an I2C repeated start
2419                 between writing the address pointer and reading the
2420                 data.  If this define is omitted the default behaviour
2421                 of doing a stop-start sequence will be used.  Most I2C
2422                 devices can use either method, but some require one or
2423                 the other.
2424
2425 - SPI Support:  CONFIG_SPI
2426
2427                 Enables SPI driver (so far only tested with
2428                 SPI EEPROM, also an instance works with Crystal A/D and
2429                 D/As on the SACSng board)
2430
2431                 CONFIG_SH_SPI
2432
2433                 Enables the driver for SPI controller on SuperH. Currently
2434                 only SH7757 is supported.
2435
2436                 CONFIG_SOFT_SPI
2437
2438                 Enables a software (bit-bang) SPI driver rather than
2439                 using hardware support. This is a general purpose
2440                 driver that only requires three general I/O port pins
2441                 (two outputs, one input) to function. If this is
2442                 defined, the board configuration must define several
2443                 SPI configuration items (port pins to use, etc). For
2444                 an example, see include/configs/sacsng.h.
2445
2446                 CONFIG_HARD_SPI
2447
2448                 Enables a hardware SPI driver for general-purpose reads
2449                 and writes.  As with CONFIG_SOFT_SPI, the board configuration
2450                 must define a list of chip-select function pointers.
2451                 Currently supported on some MPC8xxx processors.  For an
2452                 example, see include/configs/mpc8349emds.h.
2453
2454                 CONFIG_MXC_SPI
2455
2456                 Enables the driver for the SPI controllers on i.MX and MXC
2457                 SoCs. Currently i.MX31/35/51 are supported.
2458
2459                 CONFIG_SYS_SPI_MXC_WAIT
2460                 Timeout for waiting until spi transfer completed.
2461                 default: (CONFIG_SYS_HZ/100)     /* 10 ms */
2462
2463 - FPGA Support: CONFIG_FPGA
2464
2465                 Enables FPGA subsystem.
2466
2467                 CONFIG_FPGA_<vendor>
2468
2469                 Enables support for specific chip vendors.
2470                 (ALTERA, XILINX)
2471
2472                 CONFIG_FPGA_<family>
2473
2474                 Enables support for FPGA family.
2475                 (SPARTAN2, SPARTAN3, VIRTEX2, CYCLONE2, ACEX1K, ACEX)
2476
2477                 CONFIG_FPGA_COUNT
2478
2479                 Specify the number of FPGA devices to support.
2480
2481                 CONFIG_CMD_FPGA_LOADMK
2482
2483                 Enable support for fpga loadmk command
2484
2485                 CONFIG_CMD_FPGA_LOADP
2486
2487                 Enable support for fpga loadp command - load partial bitstream
2488
2489                 CONFIG_CMD_FPGA_LOADBP
2490
2491                 Enable support for fpga loadbp command - load partial bitstream
2492                 (Xilinx only)
2493
2494                 CONFIG_SYS_FPGA_PROG_FEEDBACK
2495
2496                 Enable printing of hash marks during FPGA configuration.
2497
2498                 CONFIG_SYS_FPGA_CHECK_BUSY
2499
2500                 Enable checks on FPGA configuration interface busy
2501                 status by the configuration function. This option
2502                 will require a board or device specific function to
2503                 be written.
2504
2505                 CONFIG_FPGA_DELAY
2506
2507                 If defined, a function that provides delays in the FPGA
2508                 configuration driver.
2509
2510                 CONFIG_SYS_FPGA_CHECK_CTRLC
2511                 Allow Control-C to interrupt FPGA configuration
2512
2513                 CONFIG_SYS_FPGA_CHECK_ERROR
2514
2515                 Check for configuration errors during FPGA bitfile
2516                 loading. For example, abort during Virtex II
2517                 configuration if the INIT_B line goes low (which
2518                 indicated a CRC error).
2519
2520                 CONFIG_SYS_FPGA_WAIT_INIT
2521
2522                 Maximum time to wait for the INIT_B line to de-assert
2523                 after PROB_B has been de-asserted during a Virtex II
2524                 FPGA configuration sequence. The default time is 500
2525                 ms.
2526
2527                 CONFIG_SYS_FPGA_WAIT_BUSY
2528
2529                 Maximum time to wait for BUSY to de-assert during
2530                 Virtex II FPGA configuration. The default is 5 ms.
2531
2532                 CONFIG_SYS_FPGA_WAIT_CONFIG
2533
2534                 Time to wait after FPGA configuration. The default is
2535                 200 ms.
2536
2537 - Configuration Management:
2538                 CONFIG_BUILD_TARGET
2539
2540                 Some SoCs need special image types (e.g. U-Boot binary
2541                 with a special header) as build targets. By defining
2542                 CONFIG_BUILD_TARGET in the SoC / board header, this
2543                 special image will be automatically built upon calling
2544                 make / buildman.
2545
2546                 CONFIG_IDENT_STRING
2547
2548                 If defined, this string will be added to the U-Boot
2549                 version information (U_BOOT_VERSION)
2550
2551 - Vendor Parameter Protection:
2552
2553                 U-Boot considers the values of the environment
2554                 variables "serial#" (Board Serial Number) and
2555                 "ethaddr" (Ethernet Address) to be parameters that
2556                 are set once by the board vendor / manufacturer, and
2557                 protects these variables from casual modification by
2558                 the user. Once set, these variables are read-only,
2559                 and write or delete attempts are rejected. You can
2560                 change this behaviour:
2561
2562                 If CONFIG_ENV_OVERWRITE is #defined in your config
2563                 file, the write protection for vendor parameters is
2564                 completely disabled. Anybody can change or delete
2565                 these parameters.
2566
2567                 Alternatively, if you define _both_ an ethaddr in the
2568                 default env _and_ CONFIG_OVERWRITE_ETHADDR_ONCE, a default
2569                 Ethernet address is installed in the environment,
2570                 which can be changed exactly ONCE by the user. [The
2571                 serial# is unaffected by this, i. e. it remains
2572                 read-only.]
2573
2574                 The same can be accomplished in a more flexible way
2575                 for any variable by configuring the type of access
2576                 to allow for those variables in the ".flags" variable
2577                 or define CONFIG_ENV_FLAGS_LIST_STATIC.
2578
2579 - Protected RAM:
2580                 CONFIG_PRAM
2581
2582                 Define this variable to enable the reservation of
2583                 "protected RAM", i. e. RAM which is not overwritten
2584                 by U-Boot. Define CONFIG_PRAM to hold the number of
2585                 kB you want to reserve for pRAM. You can overwrite
2586                 this default value by defining an environment
2587                 variable "pram" to the number of kB you want to
2588                 reserve. Note that the board info structure will
2589                 still show the full amount of RAM. If pRAM is
2590                 reserved, a new environment variable "mem" will
2591                 automatically be defined to hold the amount of
2592                 remaining RAM in a form that can be passed as boot
2593                 argument to Linux, for instance like that:
2594
2595                         setenv bootargs ... mem=\${mem}
2596                         saveenv
2597
2598                 This way you can tell Linux not to use this memory,
2599                 either, which results in a memory region that will
2600                 not be affected by reboots.
2601
2602                 *WARNING* If your board configuration uses automatic
2603                 detection of the RAM size, you must make sure that
2604                 this memory test is non-destructive. So far, the
2605                 following board configurations are known to be
2606                 "pRAM-clean":
2607
2608                         IVMS8, IVML24, SPD8xx, TQM8xxL,
2609                         HERMES, IP860, RPXlite, LWMON,
2610                         FLAGADM, TQM8260
2611
2612 - Access to physical memory region (> 4GB)
2613                 Some basic support is provided for operations on memory not
2614                 normally accessible to U-Boot - e.g. some architectures
2615                 support access to more than 4GB of memory on 32-bit
2616                 machines using physical address extension or similar.
2617                 Define CONFIG_PHYSMEM to access this basic support, which
2618                 currently only supports clearing the memory.
2619
2620 - Error Recovery:
2621                 CONFIG_PANIC_HANG
2622
2623                 Define this variable to stop the system in case of a
2624                 fatal error, so that you have to reset it manually.
2625                 This is probably NOT a good idea for an embedded
2626                 system where you want the system to reboot
2627                 automatically as fast as possible, but it may be
2628                 useful during development since you can try to debug
2629                 the conditions that lead to the situation.
2630
2631                 CONFIG_NET_RETRY_COUNT
2632
2633                 This variable defines the number of retries for
2634                 network operations like ARP, RARP, TFTP, or BOOTP
2635                 before giving up the operation. If not defined, a
2636                 default value of 5 is used.
2637
2638                 CONFIG_ARP_TIMEOUT
2639
2640                 Timeout waiting for an ARP reply in milliseconds.
2641
2642                 CONFIG_NFS_TIMEOUT
2643
2644                 Timeout in milliseconds used in NFS protocol.
2645                 If you encounter "ERROR: Cannot umount" in nfs command,
2646                 try longer timeout such as
2647                 #define CONFIG_NFS_TIMEOUT 10000UL
2648
2649 - Command Interpreter:
2650                 CONFIG_AUTO_COMPLETE
2651
2652                 Enable auto completion of commands using TAB.
2653
2654                 CONFIG_SYS_PROMPT_HUSH_PS2
2655
2656                 This defines the secondary prompt string, which is
2657                 printed when the command interpreter needs more input
2658                 to complete a command. Usually "> ".
2659
2660         Note:
2661
2662                 In the current implementation, the local variables
2663                 space and global environment variables space are
2664                 separated. Local variables are those you define by
2665                 simply typing `name=value'. To access a local
2666                 variable later on, you have write `$name' or
2667                 `${name}'; to execute the contents of a variable
2668                 directly type `$name' at the command prompt.
2669
2670                 Global environment variables are those you use
2671                 setenv/printenv to work with. To run a command stored
2672                 in such a variable, you need to use the run command,
2673                 and you must not use the '$' sign to access them.
2674
2675                 To store commands and special characters in a
2676                 variable, please use double quotation marks
2677                 surrounding the whole text of the variable, instead
2678                 of the backslashes before semicolons and special
2679                 symbols.
2680
2681 - Command Line Editing and History:
2682                 CONFIG_CMDLINE_EDITING
2683
2684                 Enable editing and History functions for interactive
2685                 command line input operations
2686
2687 - Command Line PS1/PS2 support:
2688                 CONFIG_CMDLINE_PS_SUPPORT
2689
2690                 Enable support for changing the command prompt string
2691                 at run-time. Only static string is supported so far.
2692                 The string is obtained from environment variables PS1
2693                 and PS2.
2694
2695 - Default Environment:
2696                 CONFIG_EXTRA_ENV_SETTINGS
2697
2698                 Define this to contain any number of null terminated
2699                 strings (variable = value pairs) that will be part of
2700                 the default environment compiled into the boot image.
2701
2702                 For example, place something like this in your
2703                 board's config file:
2704
2705                 #define CONFIG_EXTRA_ENV_SETTINGS \
2706                         "myvar1=value1\0" \
2707                         "myvar2=value2\0"
2708
2709                 Warning: This method is based on knowledge about the
2710                 internal format how the environment is stored by the
2711                 U-Boot code. This is NOT an official, exported
2712                 interface! Although it is unlikely that this format
2713                 will change soon, there is no guarantee either.
2714                 You better know what you are doing here.
2715
2716                 Note: overly (ab)use of the default environment is
2717                 discouraged. Make sure to check other ways to preset
2718                 the environment like the "source" command or the
2719                 boot command first.
2720
2721                 CONFIG_ENV_VARS_UBOOT_CONFIG
2722
2723                 Define this in order to add variables describing the
2724                 U-Boot build configuration to the default environment.
2725                 These will be named arch, cpu, board, vendor, and soc.
2726
2727                 Enabling this option will cause the following to be defined:
2728
2729                 - CONFIG_SYS_ARCH
2730                 - CONFIG_SYS_CPU
2731                 - CONFIG_SYS_BOARD
2732                 - CONFIG_SYS_VENDOR
2733                 - CONFIG_SYS_SOC
2734
2735                 CONFIG_ENV_VARS_UBOOT_RUNTIME_CONFIG
2736
2737                 Define this in order to add variables describing certain
2738                 run-time determined information about the hardware to the
2739                 environment.  These will be named board_name, board_rev.
2740
2741                 CONFIG_DELAY_ENVIRONMENT
2742
2743                 Normally the environment is loaded when the board is
2744                 initialised so that it is available to U-Boot. This inhibits
2745                 that so that the environment is not available until
2746                 explicitly loaded later by U-Boot code. With CONFIG_OF_CONTROL
2747                 this is instead controlled by the value of
2748                 /config/load-environment.
2749
2750 - DataFlash Support:
2751                 CONFIG_HAS_DATAFLASH
2752
2753                 Defining this option enables DataFlash features and
2754                 allows to read/write in Dataflash via the standard
2755                 commands cp, md...
2756
2757 - Serial Flash support
2758                 CONFIG_CMD_SF
2759
2760                 Defining this option enables SPI flash commands
2761                 'sf probe/read/write/erase/update'.
2762
2763                 Usage requires an initial 'probe' to define the serial
2764                 flash parameters, followed by read/write/erase/update
2765                 commands.
2766
2767                 The following defaults may be provided by the platform
2768                 to handle the common case when only a single serial
2769                 flash is present on the system.
2770
2771                 CONFIG_SF_DEFAULT_BUS           Bus identifier
2772                 CONFIG_SF_DEFAULT_CS            Chip-select
2773                 CONFIG_SF_DEFAULT_MODE          (see include/spi.h)
2774                 CONFIG_SF_DEFAULT_SPEED         in Hz
2775
2776                 CONFIG_CMD_SF_TEST
2777
2778                 Define this option to include a destructive SPI flash
2779                 test ('sf test').
2780
2781                 CONFIG_SF_DUAL_FLASH            Dual flash memories
2782
2783                 Define this option to use dual flash support where two flash
2784                 memories can be connected with a given cs line.
2785                 Currently Xilinx Zynq qspi supports these type of connections.
2786
2787 - SystemACE Support:
2788                 CONFIG_SYSTEMACE
2789
2790                 Adding this option adds support for Xilinx SystemACE
2791                 chips attached via some sort of local bus. The address
2792                 of the chip must also be defined in the
2793                 CONFIG_SYS_SYSTEMACE_BASE macro. For example:
2794
2795                 #define CONFIG_SYSTEMACE
2796                 #define CONFIG_SYS_SYSTEMACE_BASE 0xf0000000
2797
2798                 When SystemACE support is added, the "ace" device type
2799                 becomes available to the fat commands, i.e. fatls.
2800
2801 - TFTP Fixed UDP Port:
2802                 CONFIG_TFTP_PORT
2803
2804                 If this is defined, the environment variable tftpsrcp
2805                 is used to supply the TFTP UDP source port value.
2806                 If tftpsrcp isn't defined, the normal pseudo-random port
2807                 number generator is used.
2808
2809                 Also, the environment variable tftpdstp is used to supply
2810                 the TFTP UDP destination port value.  If tftpdstp isn't
2811                 defined, the normal port 69 is used.
2812
2813                 The purpose for tftpsrcp is to allow a TFTP server to
2814                 blindly start the TFTP transfer using the pre-configured
2815                 target IP address and UDP port. This has the effect of
2816                 "punching through" the (Windows XP) firewall, allowing
2817                 the remainder of the TFTP transfer to proceed normally.
2818                 A better solution is to properly configure the firewall,
2819                 but sometimes that is not allowed.
2820
2821 - Hashing support:
2822                 CONFIG_CMD_HASH
2823
2824                 This enables a generic 'hash' command which can produce
2825                 hashes / digests from a few algorithms (e.g. SHA1, SHA256).
2826
2827                 CONFIG_HASH_VERIFY
2828
2829                 Enable the hash verify command (hash -v). This adds to code
2830                 size a little.
2831
2832                 CONFIG_SHA1 - This option enables support of hashing using SHA1
2833                 algorithm. The hash is calculated in software.
2834                 CONFIG_SHA256 - This option enables support of hashing using
2835                 SHA256 algorithm. The hash is calculated in software.
2836                 CONFIG_SHA_HW_ACCEL - This option enables hardware acceleration
2837                 for SHA1/SHA256 hashing.
2838                 This affects the 'hash' command and also the
2839                 hash_lookup_algo() function.
2840                 CONFIG_SHA_PROG_HW_ACCEL - This option enables
2841                 hardware-acceleration for SHA1/SHA256 progressive hashing.
2842                 Data can be streamed in a block at a time and the hashing
2843                 is performed in hardware.
2844
2845                 Note: There is also a sha1sum command, which should perhaps
2846                 be deprecated in favour of 'hash sha1'.
2847
2848 - Freescale i.MX specific commands:
2849                 CONFIG_CMD_HDMIDETECT
2850                 This enables 'hdmidet' command which returns true if an
2851                 HDMI monitor is detected.  This command is i.MX 6 specific.
2852
2853                 CONFIG_CMD_BMODE
2854                 This enables the 'bmode' (bootmode) command for forcing
2855                 a boot from specific media.
2856
2857                 This is useful for forcing the ROM's usb downloader to
2858                 activate upon a watchdog reset which is nice when iterating
2859                 on U-Boot.  Using the reset button or running bmode normal
2860                 will set it back to normal.  This command currently
2861                 supports i.MX53 and i.MX6.
2862
2863 - bootcount support:
2864                 CONFIG_BOOTCOUNT_LIMIT
2865
2866                 This enables the bootcounter support, see:
2867                 http://www.denx.de/wiki/DULG/UBootBootCountLimit
2868
2869                 CONFIG_AT91SAM9XE
2870                 enable special bootcounter support on at91sam9xe based boards.
2871                 CONFIG_SOC_DA8XX
2872                 enable special bootcounter support on da850 based boards.
2873                 CONFIG_BOOTCOUNT_RAM
2874                 enable support for the bootcounter in RAM
2875                 CONFIG_BOOTCOUNT_I2C
2876                 enable support for the bootcounter on an i2c (like RTC) device.
2877                         CONFIG_SYS_I2C_RTC_ADDR = i2c chip address
2878                         CONFIG_SYS_BOOTCOUNT_ADDR = i2c addr which is used for
2879                                                     the bootcounter.
2880                         CONFIG_BOOTCOUNT_ALEN = address len
2881
2882 - Show boot progress:
2883                 CONFIG_SHOW_BOOT_PROGRESS
2884
2885                 Defining this option allows to add some board-
2886                 specific code (calling a user-provided function
2887                 "show_boot_progress(int)") that enables you to show
2888                 the system's boot progress on some display (for
2889                 example, some LED's) on your board. At the moment,
2890                 the following checkpoints are implemented:
2891
2892
2893 Legacy uImage format:
2894
2895   Arg   Where                   When
2896     1   common/cmd_bootm.c      before attempting to boot an image
2897    -1   common/cmd_bootm.c      Image header has bad     magic number
2898     2   common/cmd_bootm.c      Image header has correct magic number
2899    -2   common/cmd_bootm.c      Image header has bad     checksum
2900     3   common/cmd_bootm.c      Image header has correct checksum
2901    -3   common/cmd_bootm.c      Image data   has bad     checksum
2902     4   common/cmd_bootm.c      Image data   has correct checksum
2903    -4   common/cmd_bootm.c      Image is for unsupported architecture
2904     5   common/cmd_bootm.c      Architecture check OK
2905    -5   common/cmd_bootm.c      Wrong Image Type (not kernel, multi)
2906     6   common/cmd_bootm.c      Image Type check OK
2907    -6   common/cmd_bootm.c      gunzip uncompression error
2908    -7   common/cmd_bootm.c      Unimplemented compression type
2909     7   common/cmd_bootm.c      Uncompression OK
2910     8   common/cmd_bootm.c      No uncompress/copy overwrite error
2911    -9   common/cmd_bootm.c      Unsupported OS (not Linux, BSD, VxWorks, QNX)
2912
2913     9   common/image.c          Start initial ramdisk verification
2914   -10   common/image.c          Ramdisk header has bad     magic number
2915   -11   common/image.c          Ramdisk header has bad     checksum
2916    10   common/image.c          Ramdisk header is OK
2917   -12   common/image.c          Ramdisk data   has bad     checksum
2918    11   common/image.c          Ramdisk data   has correct checksum
2919    12   common/image.c          Ramdisk verification complete, start loading
2920   -13   common/image.c          Wrong Image Type (not PPC Linux ramdisk)
2921    13   common/image.c          Start multifile image verification
2922    14   common/image.c          No initial ramdisk, no multifile, continue.
2923
2924    15   arch/<arch>/lib/bootm.c All preparation done, transferring control to OS
2925
2926   -30   arch/powerpc/lib/board.c        Fatal error, hang the system
2927   -31   post/post.c             POST test failed, detected by post_output_backlog()
2928   -32   post/post.c             POST test failed, detected by post_run_single()
2929
2930    34   common/cmd_doc.c        before loading a Image from a DOC device
2931   -35   common/cmd_doc.c        Bad usage of "doc" command
2932    35   common/cmd_doc.c        correct usage of "doc" command
2933   -36   common/cmd_doc.c        No boot device
2934    36   common/cmd_doc.c        correct boot device
2935   -37   common/cmd_doc.c        Unknown Chip ID on boot device
2936    37   common/cmd_doc.c        correct chip ID found, device available
2937   -38   common/cmd_doc.c        Read Error on boot device
2938    38   common/cmd_doc.c        reading Image header from DOC device OK
2939   -39   common/cmd_doc.c        Image header has bad magic number
2940    39   common/cmd_doc.c        Image header has correct magic number
2941   -40   common/cmd_doc.c        Error reading Image from DOC device
2942    40   common/cmd_doc.c        Image header has correct magic number
2943    41   common/cmd_ide.c        before loading a Image from a IDE device
2944   -42   common/cmd_ide.c        Bad usage of "ide" command
2945    42   common/cmd_ide.c        correct usage of "ide" command
2946   -43   common/cmd_ide.c        No boot device
2947    43   common/cmd_ide.c        boot device found
2948   -44   common/cmd_ide.c        Device not available
2949    44   common/cmd_ide.c        Device available
2950   -45   common/cmd_ide.c        wrong partition selected
2951    45   common/cmd_ide.c        partition selected
2952   -46   common/cmd_ide.c        Unknown partition table
2953    46   common/cmd_ide.c        valid partition table found
2954   -47   common/cmd_ide.c        Invalid partition type
2955    47   common/cmd_ide.c        correct partition type
2956   -48   common/cmd_ide.c        Error reading Image Header on boot device
2957    48   common/cmd_ide.c        reading Image Header from IDE device OK
2958   -49   common/cmd_ide.c        Image header has bad magic number
2959    49   common/cmd_ide.c        Image header has correct magic number
2960   -50   common/cmd_ide.c        Image header has bad     checksum
2961    50   common/cmd_ide.c        Image header has correct checksum
2962   -51   common/cmd_ide.c        Error reading Image from IDE device
2963    51   common/cmd_ide.c        reading Image from IDE device OK
2964    52   common/cmd_nand.c       before loading a Image from a NAND device
2965   -53   common/cmd_nand.c       Bad usage of "nand" command
2966    53   common/cmd_nand.c       correct usage of "nand" command
2967   -54   common/cmd_nand.c       No boot device
2968    54   common/cmd_nand.c       boot device found
2969   -55   common/cmd_nand.c       Unknown Chip ID on boot device
2970    55   common/cmd_nand.c       correct chip ID found, device available
2971   -56   common/cmd_nand.c       Error reading Image Header on boot device
2972    56   common/cmd_nand.c       reading Image Header from NAND device OK
2973   -57   common/cmd_nand.c       Image header has bad magic number
2974    57   common/cmd_nand.c       Image header has correct magic number
2975   -58   common/cmd_nand.c       Error reading Image from NAND device
2976    58   common/cmd_nand.c       reading Image from NAND device OK
2977
2978   -60   common/env_common.c     Environment has a bad CRC, using default
2979
2980    64   net/eth.c               starting with Ethernet configuration.
2981   -64   net/eth.c               no Ethernet found.
2982    65   net/eth.c               Ethernet found.
2983
2984   -80   common/cmd_net.c        usage wrong
2985    80   common/cmd_net.c        before calling net_loop()
2986   -81   common/cmd_net.c        some error in net_loop() occurred
2987    81   common/cmd_net.c        net_loop() back without error
2988   -82   common/cmd_net.c        size == 0 (File with size 0 loaded)
2989    82   common/cmd_net.c        trying automatic boot
2990    83   common/cmd_net.c        running "source" command
2991   -83   common/cmd_net.c        some error in automatic boot or "source" command
2992    84   common/cmd_net.c        end without errors
2993
2994 FIT uImage format:
2995
2996   Arg   Where                   When
2997   100   common/cmd_bootm.c      Kernel FIT Image has correct format
2998  -100   common/cmd_bootm.c      Kernel FIT Image has incorrect format
2999   101   common/cmd_bootm.c      No Kernel subimage unit name, using configuration
3000  -101   common/cmd_bootm.c      Can't get configuration for kernel subimage
3001   102   common/cmd_bootm.c      Kernel unit name specified
3002  -103   common/cmd_bootm.c      Can't get kernel subimage node offset
3003   103   common/cmd_bootm.c      Found configuration node
3004   104   common/cmd_bootm.c      Got kernel subimage node offset
3005  -104   common/cmd_bootm.c      Kernel subimage hash verification failed
3006   105   common/cmd_bootm.c      Kernel subimage hash verification OK
3007  -105   common/cmd_bootm.c      Kernel subimage is for unsupported architecture
3008   106   common/cmd_bootm.c      Architecture check OK
3009  -106   common/cmd_bootm.c      Kernel subimage has wrong type
3010   107   common/cmd_bootm.c      Kernel subimage type OK
3011  -107   common/cmd_bootm.c      Can't get kernel subimage data/size
3012   108   common/cmd_bootm.c      Got kernel subimage data/size
3013  -108   common/cmd_bootm.c      Wrong image type (not legacy, FIT)
3014  -109   common/cmd_bootm.c      Can't get kernel subimage type
3015  -110   common/cmd_bootm.c      Can't get kernel subimage comp
3016  -111   common/cmd_bootm.c      Can't get kernel subimage os
3017  -112   common/cmd_bootm.c      Can't get kernel subimage load address
3018  -113   common/cmd_bootm.c      Image uncompress/copy overwrite error
3019
3020   120   common/image.c          Start initial ramdisk verification
3021  -120   common/image.c          Ramdisk FIT image has incorrect format
3022   121   common/image.c          Ramdisk FIT image has correct format
3023   122   common/image.c          No ramdisk subimage unit name, using configuration
3024  -122   common/image.c          Can't get configuration for ramdisk subimage
3025   123   common/image.c          Ramdisk unit name specified
3026  -124   common/image.c          Can't get ramdisk subimage node offset
3027   125   common/image.c          Got ramdisk subimage node offset
3028  -125   common/image.c          Ramdisk subimage hash verification failed
3029   126   common/image.c          Ramdisk subimage hash verification OK
3030  -126   common/image.c          Ramdisk subimage for unsupported architecture
3031   127   common/image.c          Architecture check OK
3032  -127   common/image.c          Can't get ramdisk subimage data/size
3033   128   common/image.c          Got ramdisk subimage data/size
3034   129   common/image.c          Can't get ramdisk load address
3035  -129   common/image.c          Got ramdisk load address
3036
3037  -130   common/cmd_doc.c        Incorrect FIT image format
3038   131   common/cmd_doc.c        FIT image format OK
3039
3040  -140   common/cmd_ide.c        Incorrect FIT image format
3041   141   common/cmd_ide.c        FIT image format OK
3042
3043  -150   common/cmd_nand.c       Incorrect FIT image format
3044   151   common/cmd_nand.c       FIT image format OK
3045
3046 - legacy image format:
3047                 CONFIG_IMAGE_FORMAT_LEGACY
3048                 enables the legacy image format support in U-Boot.
3049
3050                 Default:
3051                 enabled if CONFIG_FIT_SIGNATURE is not defined.
3052
3053                 CONFIG_DISABLE_IMAGE_LEGACY
3054                 disable the legacy image format
3055
3056                 This define is introduced, as the legacy image format is
3057                 enabled per default for backward compatibility.
3058
3059 - FIT image support:
3060                 CONFIG_FIT_DISABLE_SHA256
3061                 Supporting SHA256 hashes has quite an impact on binary size.
3062                 For constrained systems sha256 hash support can be disabled
3063                 with this option.
3064
3065                 TODO(sjg@chromium.org): Adjust this option to be positive,
3066                 and move it to Kconfig
3067
3068 - Standalone program support:
3069                 CONFIG_STANDALONE_LOAD_ADDR
3070
3071                 This option defines a board specific value for the
3072                 address where standalone program gets loaded, thus
3073                 overwriting the architecture dependent default
3074                 settings.
3075
3076 - Frame Buffer Address:
3077                 CONFIG_FB_ADDR
3078
3079                 Define CONFIG_FB_ADDR if you want to use specific
3080                 address for frame buffer.  This is typically the case
3081                 when using a graphics controller has separate video
3082                 memory.  U-Boot will then place the frame buffer at
3083                 the given address instead of dynamically reserving it
3084                 in system RAM by calling lcd_setmem(), which grabs
3085                 the memory for the frame buffer depending on the
3086                 configured panel size.
3087
3088                 Please see board_init_f function.
3089
3090 - Automatic software updates via TFTP server
3091                 CONFIG_UPDATE_TFTP
3092                 CONFIG_UPDATE_TFTP_CNT_MAX
3093                 CONFIG_UPDATE_TFTP_MSEC_MAX
3094
3095                 These options enable and control the auto-update feature;
3096                 for a more detailed description refer to doc/README.update.
3097
3098 - MTD Support (mtdparts command, UBI support)
3099                 CONFIG_MTD_DEVICE
3100
3101                 Adds the MTD device infrastructure from the Linux kernel.
3102                 Needed for mtdparts command support.
3103
3104                 CONFIG_MTD_PARTITIONS
3105
3106                 Adds the MTD partitioning infrastructure from the Linux
3107                 kernel. Needed for UBI support.
3108
3109 - UBI support
3110                 CONFIG_CMD_UBI
3111
3112                 Adds commands for interacting with MTD partitions formatted
3113                 with the UBI flash translation layer
3114
3115                 Requires also defining CONFIG_RBTREE
3116
3117                 CONFIG_UBI_SILENCE_MSG
3118
3119                 Make the verbose messages from UBI stop printing.  This leaves
3120                 warnings and errors enabled.
3121
3122
3123                 CONFIG_MTD_UBI_WL_THRESHOLD
3124                 This parameter defines the maximum difference between the highest
3125                 erase counter value and the lowest erase counter value of eraseblocks
3126                 of UBI devices. When this threshold is exceeded, UBI starts performing
3127                 wear leveling by means of moving data from eraseblock with low erase
3128                 counter to eraseblocks with high erase counter.
3129
3130                 The default value should be OK for SLC NAND flashes, NOR flashes and
3131                 other flashes which have eraseblock life-cycle 100000 or more.
3132                 However, in case of MLC NAND flashes which typically have eraseblock
3133                 life-cycle less than 10000, the threshold should be lessened (e.g.,
3134                 to 128 or 256, although it does not have to be power of 2).
3135
3136                 default: 4096
3137
3138                 CONFIG_MTD_UBI_BEB_LIMIT
3139                 This option specifies the maximum bad physical eraseblocks UBI
3140                 expects on the MTD device (per 1024 eraseblocks). If the
3141                 underlying flash does not admit of bad eraseblocks (e.g. NOR
3142                 flash), this value is ignored.
3143
3144                 NAND datasheets often specify the minimum and maximum NVM
3145                 (Number of Valid Blocks) for the flashes' endurance lifetime.
3146                 The maximum expected bad eraseblocks per 1024 eraseblocks
3147                 then can be calculated as "1024 * (1 - MinNVB / MaxNVB)",
3148                 which gives 20 for most NANDs (MaxNVB is basically the total
3149                 count of eraseblocks on the chip).
3150
3151                 To put it differently, if this value is 20, UBI will try to
3152                 reserve about 1.9% of physical eraseblocks for bad blocks
3153                 handling. And that will be 1.9% of eraseblocks on the entire
3154                 NAND chip, not just the MTD partition UBI attaches. This means
3155                 that if you have, say, a NAND flash chip admits maximum 40 bad
3156                 eraseblocks, and it is split on two MTD partitions of the same
3157                 size, UBI will reserve 40 eraseblocks when attaching a
3158                 partition.
3159
3160                 default: 20
3161
3162                 CONFIG_MTD_UBI_FASTMAP
3163                 Fastmap is a mechanism which allows attaching an UBI device
3164                 in nearly constant time. Instead of scanning the whole MTD device it
3165                 only has to locate a checkpoint (called fastmap) on the device.
3166                 The on-flash fastmap contains all information needed to attach
3167                 the device. Using fastmap makes only sense on large devices where
3168                 attaching by scanning takes long. UBI will not automatically install
3169                 a fastmap on old images, but you can set the UBI parameter
3170                 CONFIG_MTD_UBI_FASTMAP_AUTOCONVERT to 1 if you want so. Please note
3171                 that fastmap-enabled images are still usable with UBI implementations
3172                 without fastmap support. On typical flash devices the whole fastmap
3173                 fits into one PEB. UBI will reserve PEBs to hold two fastmaps.
3174
3175                 CONFIG_MTD_UBI_FASTMAP_AUTOCONVERT
3176                 Set this parameter to enable fastmap automatically on images
3177                 without a fastmap.
3178                 default: 0
3179
3180                 CONFIG_MTD_UBI_FM_DEBUG
3181                 Enable UBI fastmap debug
3182                 default: 0
3183
3184 - UBIFS support
3185                 CONFIG_CMD_UBIFS
3186
3187                 Adds commands for interacting with UBI volumes formatted as
3188                 UBIFS.  UBIFS is read-only in u-boot.
3189
3190                 Requires UBI support as well as CONFIG_LZO
3191
3192                 CONFIG_UBIFS_SILENCE_MSG
3193
3194                 Make the verbose messages from UBIFS stop printing.  This leaves
3195                 warnings and errors enabled.
3196
3197 - SPL framework
3198                 CONFIG_SPL
3199                 Enable building of SPL globally.
3200
3201                 CONFIG_SPL_LDSCRIPT
3202                 LDSCRIPT for linking the SPL binary.
3203
3204                 CONFIG_SPL_MAX_FOOTPRINT
3205                 Maximum size in memory allocated to the SPL, BSS included.
3206                 When defined, the linker checks that the actual memory
3207                 used by SPL from _start to __bss_end does not exceed it.
3208                 CONFIG_SPL_MAX_FOOTPRINT and CONFIG_SPL_BSS_MAX_SIZE
3209                 must not be both defined at the same time.
3210
3211                 CONFIG_SPL_MAX_SIZE
3212                 Maximum size of the SPL image (text, data, rodata, and
3213                 linker lists sections), BSS excluded.
3214                 When defined, the linker checks that the actual size does
3215                 not exceed it.
3216
3217                 CONFIG_SPL_TEXT_BASE
3218                 TEXT_BASE for linking the SPL binary.
3219
3220                 CONFIG_SPL_RELOC_TEXT_BASE
3221                 Address to relocate to.  If unspecified, this is equal to
3222                 CONFIG_SPL_TEXT_BASE (i.e. no relocation is done).
3223
3224                 CONFIG_SPL_BSS_START_ADDR
3225                 Link address for the BSS within the SPL binary.
3226
3227                 CONFIG_SPL_BSS_MAX_SIZE
3228                 Maximum size in memory allocated to the SPL BSS.
3229                 When defined, the linker checks that the actual memory used
3230                 by SPL from __bss_start to __bss_end does not exceed it.
3231                 CONFIG_SPL_MAX_FOOTPRINT and CONFIG_SPL_BSS_MAX_SIZE
3232                 must not be both defined at the same time.
3233
3234                 CONFIG_SPL_STACK
3235                 Adress of the start of the stack SPL will use
3236
3237                 CONFIG_SPL_PANIC_ON_RAW_IMAGE
3238                 When defined, SPL will panic() if the image it has
3239                 loaded does not have a signature.
3240                 Defining this is useful when code which loads images
3241                 in SPL cannot guarantee that absolutely all read errors
3242                 will be caught.
3243                 An example is the LPC32XX MLC NAND driver, which will
3244                 consider that a completely unreadable NAND block is bad,
3245                 and thus should be skipped silently.
3246
3247                 CONFIG_SPL_RELOC_STACK
3248                 Adress of the start of the stack SPL will use after
3249                 relocation.  If unspecified, this is equal to
3250                 CONFIG_SPL_STACK.
3251
3252                 CONFIG_SYS_SPL_MALLOC_START
3253                 Starting address of the malloc pool used in SPL.
3254                 When this option is set the full malloc is used in SPL and
3255                 it is set up by spl_init() and before that, the simple malloc()
3256                 can be used if CONFIG_SYS_MALLOC_F is defined.
3257
3258                 CONFIG_SYS_SPL_MALLOC_SIZE
3259                 The size of the malloc pool used in SPL.
3260
3261                 CONFIG_SPL_FRAMEWORK
3262                 Enable the SPL framework under common/.  This framework
3263                 supports MMC, NAND and YMODEM loading of U-Boot and NAND
3264                 NAND loading of the Linux Kernel.
3265
3266                 CONFIG_SPL_OS_BOOT
3267                 Enable booting directly to an OS from SPL.
3268                 See also: doc/README.falcon
3269
3270                 CONFIG_SPL_DISPLAY_PRINT
3271                 For ARM, enable an optional function to print more information
3272                 about the running system.
3273
3274                 CONFIG_SPL_INIT_MINIMAL
3275                 Arch init code should be built for a very small image
3276
3277                 CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION
3278                 Partition on the MMC to load U-Boot from when the MMC is being
3279                 used in raw mode
3280
3281                 CONFIG_SYS_MMCSD_RAW_MODE_KERNEL_SECTOR
3282                 Sector to load kernel uImage from when MMC is being
3283                 used in raw mode (for Falcon mode)
3284
3285                 CONFIG_SYS_MMCSD_RAW_MODE_ARGS_SECTOR,
3286                 CONFIG_SYS_MMCSD_RAW_MODE_ARGS_SECTORS
3287                 Sector and number of sectors to load kernel argument
3288                 parameters from when MMC is being used in raw mode
3289                 (for falcon mode)
3290
3291                 CONFIG_SYS_MMCSD_FS_BOOT_PARTITION
3292                 Partition on the MMC to load U-Boot from when the MMC is being
3293                 used in fs mode
3294
3295                 CONFIG_SPL_FS_LOAD_PAYLOAD_NAME
3296                 Filename to read to load U-Boot when reading from filesystem
3297
3298                 CONFIG_SPL_FS_LOAD_KERNEL_NAME
3299                 Filename to read to load kernel uImage when reading
3300                 from filesystem (for Falcon mode)
3301
3302                 CONFIG_SPL_FS_LOAD_ARGS_NAME
3303                 Filename to read to load kernel argument parameters
3304                 when reading from filesystem (for Falcon mode)
3305
3306                 CONFIG_SPL_MPC83XX_WAIT_FOR_NAND
3307                 Set this for NAND SPL on PPC mpc83xx targets, so that
3308                 start.S waits for the rest of the SPL to load before
3309                 continuing (the hardware starts execution after just
3310                 loading the first page rather than the full 4K).
3311
3312                 CONFIG_SPL_SKIP_RELOCATE
3313                 Avoid SPL relocation
3314
3315                 CONFIG_SPL_NAND_BASE
3316                 Include nand_base.c in the SPL.  Requires
3317                 CONFIG_SPL_NAND_DRIVERS.
3318
3319                 CONFIG_SPL_NAND_DRIVERS
3320                 SPL uses normal NAND drivers, not minimal drivers.
3321
3322                 CONFIG_SPL_NAND_ECC
3323                 Include standard software ECC in the SPL
3324
3325                 CONFIG_SPL_NAND_SIMPLE
3326                 Support for NAND boot using simple NAND drivers that
3327                 expose the cmd_ctrl() interface.
3328
3329                 CONFIG_SPL_UBI
3330                 Support for a lightweight UBI (fastmap) scanner and
3331                 loader
3332
3333                 CONFIG_SPL_NAND_RAW_ONLY
3334                 Support to boot only raw u-boot.bin images. Use this only
3335                 if you need to save space.
3336
3337                 CONFIG_SPL_COMMON_INIT_DDR
3338                 Set for common ddr init with serial presence detect in
3339                 SPL binary.
3340
3341                 CONFIG_SYS_NAND_5_ADDR_CYCLE, CONFIG_SYS_NAND_PAGE_COUNT,
3342                 CONFIG_SYS_NAND_PAGE_SIZE, CONFIG_SYS_NAND_OOBSIZE,
3343                 CONFIG_SYS_NAND_BLOCK_SIZE, CONFIG_SYS_NAND_BAD_BLOCK_POS,
3344                 CONFIG_SYS_NAND_ECCPOS, CONFIG_SYS_NAND_ECCSIZE,
3345                 CONFIG_SYS_NAND_ECCBYTES
3346                 Defines the size and behavior of the NAND that SPL uses
3347                 to read U-Boot
3348
3349                 CONFIG_SPL_NAND_BOOT
3350                 Add support NAND boot
3351
3352                 CONFIG_SYS_NAND_U_BOOT_OFFS
3353                 Location in NAND to read U-Boot from
3354
3355                 CONFIG_SYS_NAND_U_BOOT_DST
3356                 Location in memory to load U-Boot to
3357
3358                 CONFIG_SYS_NAND_U_BOOT_SIZE
3359                 Size of image to load
3360
3361                 CONFIG_SYS_NAND_U_BOOT_START
3362                 Entry point in loaded image to jump to
3363
3364                 CONFIG_SYS_NAND_HW_ECC_OOBFIRST
3365                 Define this if you need to first read the OOB and then the
3366                 data. This is used, for example, on davinci platforms.
3367
3368                 CONFIG_SPL_OMAP3_ID_NAND
3369                 Support for an OMAP3-specific set of functions to return the
3370                 ID and MFR of the first attached NAND chip, if present.
3371
3372                 CONFIG_SPL_RAM_DEVICE
3373                 Support for running image already present in ram, in SPL binary
3374
3375                 CONFIG_SPL_PAD_TO
3376                 Image offset to which the SPL should be padded before appending
3377                 the SPL payload. By default, this is defined as
3378                 CONFIG_SPL_MAX_SIZE, or 0 if CONFIG_SPL_MAX_SIZE is undefined.
3379                 CONFIG_SPL_PAD_TO must be either 0, meaning to append the SPL
3380                 payload without any padding, or >= CONFIG_SPL_MAX_SIZE.
3381
3382                 CONFIG_SPL_TARGET
3383                 Final target image containing SPL and payload.  Some SPLs
3384                 use an arch-specific makefile fragment instead, for
3385                 example if more than one image needs to be produced.
3386
3387                 CONFIG_FIT_SPL_PRINT
3388                 Printing information about a FIT image adds quite a bit of
3389                 code to SPL. So this is normally disabled in SPL. Use this
3390                 option to re-enable it. This will affect the output of the
3391                 bootm command when booting a FIT image.
3392
3393 - TPL framework
3394                 CONFIG_TPL
3395                 Enable building of TPL globally.
3396
3397                 CONFIG_TPL_PAD_TO
3398                 Image offset to which the TPL should be padded before appending
3399                 the TPL payload. By default, this is defined as
3400                 CONFIG_SPL_MAX_SIZE, or 0 if CONFIG_SPL_MAX_SIZE is undefined.
3401                 CONFIG_SPL_PAD_TO must be either 0, meaning to append the SPL
3402                 payload without any padding, or >= CONFIG_SPL_MAX_SIZE.
3403
3404 - Interrupt support (PPC):
3405
3406                 There are common interrupt_init() and timer_interrupt()
3407                 for all PPC archs. interrupt_init() calls interrupt_init_cpu()
3408                 for CPU specific initialization. interrupt_init_cpu()
3409                 should set decrementer_count to appropriate value. If
3410                 CPU resets decrementer automatically after interrupt
3411                 (ppc4xx) it should set decrementer_count to zero.
3412                 timer_interrupt() calls timer_interrupt_cpu() for CPU
3413                 specific handling. If board has watchdog / status_led
3414                 / other_activity_monitor it works automatically from
3415                 general timer_interrupt().
3416
3417
3418 Board initialization settings:
3419 ------------------------------
3420
3421 During Initialization u-boot calls a number of board specific functions
3422 to allow the preparation of board specific prerequisites, e.g. pin setup
3423 before drivers are initialized. To enable these callbacks the
3424 following configuration macros have to be defined. Currently this is
3425 architecture specific, so please check arch/your_architecture/lib/board.c
3426 typically in board_init_f() and board_init_r().
3427
3428 - CONFIG_BOARD_EARLY_INIT_F: Call board_early_init_f()
3429 - CONFIG_BOARD_EARLY_INIT_R: Call board_early_init_r()
3430 - CONFIG_BOARD_LATE_INIT: Call board_late_init()
3431 - CONFIG_BOARD_POSTCLK_INIT: Call board_postclk_init()
3432
3433 Configuration Settings:
3434 -----------------------
3435
3436 - CONFIG_SYS_SUPPORT_64BIT_DATA: Defined automatically if compiled as 64-bit.
3437                 Optionally it can be defined to support 64-bit memory commands.
3438
3439 - CONFIG_SYS_LONGHELP: Defined when you want long help messages included;
3440                 undefine this when you're short of memory.
3441
3442 - CONFIG_SYS_HELP_CMD_WIDTH: Defined when you want to override the default
3443                 width of the commands listed in the 'help' command output.
3444
3445 - CONFIG_SYS_PROMPT:    This is what U-Boot prints on the console to
3446                 prompt for user input.
3447
3448 - CONFIG_SYS_CBSIZE:    Buffer size for input from the Console
3449
3450 - CONFIG_SYS_PBSIZE:    Buffer size for Console output
3451
3452 - CONFIG_SYS_MAXARGS:   max. Number of arguments accepted for monitor commands
3453
3454 - CONFIG_SYS_BARGSIZE: Buffer size for Boot Arguments which are passed to
3455                 the application (usually a Linux kernel) when it is
3456                 booted
3457
3458 - CONFIG_SYS_BAUDRATE_TABLE:
3459                 List of legal baudrate settings for this board.
3460
3461 - CONFIG_SYS_MEMTEST_START, CONFIG_SYS_MEMTEST_END:
3462                 Begin and End addresses of the area used by the
3463                 simple memory test.
3464
3465 - CONFIG_SYS_ALT_MEMTEST:
3466                 Enable an alternate, more extensive memory test.
3467
3468 - CONFIG_SYS_MEMTEST_SCRATCH:
3469                 Scratch address used by the alternate memory test
3470                 You only need to set this if address zero isn't writeable
3471
3472 - CONFIG_SYS_MEM_RESERVE_SECURE
3473                 Only implemented for ARMv8 for now.
3474                 If defined, the size of CONFIG_SYS_MEM_RESERVE_SECURE memory
3475                 is substracted from total RAM and won't be reported to OS.
3476                 This memory can be used as secure memory. A variable
3477                 gd->arch.secure_ram is used to track the location. In systems
3478                 the RAM base is not zero, or RAM is divided into banks,
3479                 this variable needs to be recalcuated to get the address.
3480
3481 - CONFIG_SYS_MEM_TOP_HIDE:
3482                 If CONFIG_SYS_MEM_TOP_HIDE is defined in the board config header,
3483                 this specified memory area will get subtracted from the top
3484                 (end) of RAM and won't get "touched" at all by U-Boot. By
3485                 fixing up gd->ram_size the Linux kernel should gets passed
3486                 the now "corrected" memory size and won't touch it either.
3487                 This should work for arch/ppc and arch/powerpc. Only Linux
3488                 board ports in arch/powerpc with bootwrapper support that
3489                 recalculate the memory size from the SDRAM controller setup
3490                 will have to get fixed in Linux additionally.
3491
3492                 This option can be used as a workaround for the 440EPx/GRx
3493                 CHIP 11 errata where the last 256 bytes in SDRAM shouldn't
3494                 be touched.
3495
3496                 WARNING: Please make sure that this value is a multiple of
3497                 the Linux page size (normally 4k). If this is not the case,
3498                 then the end address of the Linux memory will be located at a
3499                 non page size aligned address and this could cause major
3500                 problems.
3501
3502 - CONFIG_SYS_LOADS_BAUD_CHANGE:
3503                 Enable temporary baudrate change while serial download
3504
3505 - CONFIG_SYS_SDRAM_BASE:
3506                 Physical start address of SDRAM. _Must_ be 0 here.
3507
3508 - CONFIG_SYS_FLASH_BASE:
3509                 Physical start address of Flash memory.
3510
3511 - CONFIG_SYS_MONITOR_BASE:
3512                 Physical start address of boot monitor code (set by
3513                 make config files to be same as the text base address
3514                 (CONFIG_SYS_TEXT_BASE) used when linking) - same as
3515                 CONFIG_SYS_FLASH_BASE when booting from flash.
3516
3517 - CONFIG_SYS_MONITOR_LEN:
3518                 Size of memory reserved for monitor code, used to
3519                 determine _at_compile_time_ (!) if the environment is
3520                 embedded within the U-Boot image, or in a separate
3521                 flash sector.
3522
3523 - CONFIG_SYS_MALLOC_LEN:
3524                 Size of DRAM reserved for malloc() use.
3525
3526 - CONFIG_SYS_MALLOC_F_LEN
3527                 Size of the malloc() pool for use before relocation. If
3528                 this is defined, then a very simple malloc() implementation
3529                 will become available before relocation. The address is just
3530                 below the global data, and the stack is moved down to make
3531                 space.
3532
3533                 This feature allocates regions with increasing addresses
3534                 within the region. calloc() is supported, but realloc()
3535                 is not available. free() is supported but does nothing.
3536                 The memory will be freed (or in fact just forgotten) when
3537                 U-Boot relocates itself.
3538
3539 - CONFIG_SYS_MALLOC_SIMPLE
3540                 Provides a simple and small malloc() and calloc() for those
3541                 boards which do not use the full malloc in SPL (which is
3542                 enabled with CONFIG_SYS_SPL_MALLOC_START).
3543
3544 - CONFIG_SYS_NONCACHED_MEMORY:
3545                 Size of non-cached memory area. This area of memory will be
3546                 typically located right below the malloc() area and mapped
3547                 uncached in the MMU. This is useful for drivers that would
3548                 otherwise require a lot of explicit cache maintenance. For
3549                 some drivers it's also impossible to properly maintain the
3550                 cache. For example if the regions that need to be flushed
3551                 are not a multiple of the cache-line size, *and* padding
3552                 cannot be allocated between the regions to align them (i.e.
3553                 if the HW requires a contiguous array of regions, and the
3554                 size of each region is not cache-aligned), then a flush of
3555                 one region may result in overwriting data that hardware has
3556                 written to another region in the same cache-line. This can
3557                 happen for example in network drivers where descriptors for
3558                 buffers are typically smaller than the CPU cache-line (e.g.
3559                 16 bytes vs. 32 or 64 bytes).
3560
3561                 Non-cached memory is only supported on 32-bit ARM at present.
3562
3563 - CONFIG_SYS_BOOTM_LEN:
3564                 Normally compressed uImages are limited to an
3565                 uncompressed size of 8 MBytes. If this is not enough,
3566                 you can define CONFIG_SYS_BOOTM_LEN in your board config file
3567                 to adjust this setting to your needs.
3568
3569 - CONFIG_SYS_BOOTMAPSZ:
3570                 Maximum size of memory mapped by the startup code of
3571                 the Linux kernel; all data that must be processed by
3572                 the Linux kernel (bd_info, boot arguments, FDT blob if
3573                 used) must be put below this limit, unless "bootm_low"
3574                 environment variable is defined and non-zero. In such case
3575                 all data for the Linux kernel must be between "bootm_low"
3576                 and "bootm_low" + CONFIG_SYS_BOOTMAPSZ.  The environment
3577                 variable "bootm_mapsize" will override the value of
3578                 CONFIG_SYS_BOOTMAPSZ.  If CONFIG_SYS_BOOTMAPSZ is undefined,
3579                 then the value in "bootm_size" will be used instead.
3580
3581 - CONFIG_SYS_BOOT_RAMDISK_HIGH:
3582                 Enable initrd_high functionality.  If defined then the
3583                 initrd_high feature is enabled and the bootm ramdisk subcommand
3584                 is enabled.
3585
3586 - CONFIG_SYS_BOOT_GET_CMDLINE:
3587                 Enables allocating and saving kernel cmdline in space between
3588                 "bootm_low" and "bootm_low" + BOOTMAPSZ.
3589
3590 - CONFIG_SYS_BOOT_GET_KBD:
3591                 Enables allocating and saving a kernel copy of the bd_info in
3592                 space between "bootm_low" and "bootm_low" + BOOTMAPSZ.
3593
3594 - CONFIG_SYS_MAX_FLASH_BANKS:
3595                 Max number of Flash memory banks
3596
3597 - CONFIG_SYS_MAX_FLASH_SECT:
3598                 Max number of sectors on a Flash chip
3599
3600 - CONFIG_SYS_FLASH_ERASE_TOUT:
3601                 Timeout for Flash erase operations (in ms)
3602
3603 - CONFIG_SYS_FLASH_WRITE_TOUT:
3604                 Timeout for Flash write operations (in ms)
3605
3606 - CONFIG_SYS_FLASH_LOCK_TOUT
3607                 Timeout for Flash set sector lock bit operation (in ms)
3608
3609 - CONFIG_SYS_FLASH_UNLOCK_TOUT
3610                 Timeout for Flash clear lock bits operation (in ms)
3611
3612 - CONFIG_SYS_FLASH_PROTECTION
3613                 If defined, hardware flash sectors protection is used
3614                 instead of U-Boot software protection.
3615
3616 - CONFIG_SYS_DIRECT_FLASH_TFTP:
3617
3618                 Enable TFTP transfers directly to flash memory;
3619                 without this option such a download has to be
3620                 performed in two steps: (1) download to RAM, and (2)
3621                 copy from RAM to flash.
3622
3623                 The two-step approach is usually more reliable, since
3624                 you can check if the download worked before you erase
3625                 the flash, but in some situations (when system RAM is
3626                 too limited to allow for a temporary copy of the
3627                 downloaded image) this option may be very useful.
3628
3629 - CONFIG_SYS_FLASH_CFI:
3630                 Define if the flash driver uses extra elements in the
3631                 common flash structure for storing flash geometry.
3632
3633 - CONFIG_FLASH_CFI_DRIVER
3634                 This option also enables the building of the cfi_flash driver
3635                 in the drivers directory
3636
3637 - CONFIG_FLASH_CFI_MTD
3638                 This option enables the building of the cfi_mtd driver
3639                 in the drivers directory. The driver exports CFI flash
3640                 to the MTD layer.
3641
3642 - CONFIG_SYS_FLASH_USE_BUFFER_WRITE
3643                 Use buffered writes to flash.
3644
3645 - CONFIG_FLASH_SPANSION_S29WS_N
3646                 s29ws-n MirrorBit flash has non-standard addresses for buffered
3647                 write commands.
3648
3649 - CONFIG_SYS_FLASH_QUIET_TEST
3650                 If this option is defined, the common CFI flash doesn't
3651                 print it's warning upon not recognized FLASH banks. This
3652                 is useful, if some of the configured banks are only
3653                 optionally available.
3654
3655 - CONFIG_FLASH_SHOW_PROGRESS
3656                 If defined (must be an integer), print out countdown
3657                 digits and dots.  Recommended value: 45 (9..1) for 80
3658                 column displays, 15 (3..1) for 40 column displays.
3659
3660 - CONFIG_FLASH_VERIFY
3661                 If defined, the content of the flash (destination) is compared
3662                 against the source after the write operation. An error message
3663                 will be printed when the contents are not identical.
3664                 Please note that this option is useless in nearly all cases,
3665                 since such flash programming errors usually are detected earlier
3666                 while unprotecting/erasing/programming. Please only enable
3667                 this option if you really know what you are doing.
3668
3669 - CONFIG_SYS_RX_ETH_BUFFER:
3670                 Defines the number of Ethernet receive buffers. On some
3671                 Ethernet controllers it is recommended to set this value
3672                 to 8 or even higher (EEPRO100 or 405 EMAC), since all
3673                 buffers can be full shortly after enabling the interface
3674                 on high Ethernet traffic.
3675                 Defaults to 4 if not defined.
3676
3677 - CONFIG_ENV_MAX_ENTRIES
3678
3679         Maximum number of entries in the hash table that is used
3680         internally to store the environment settings. The default
3681         setting is supposed to be generous and should work in most
3682         cases. This setting can be used to tune behaviour; see
3683         lib/hashtable.c for details.
3684
3685 - CONFIG_ENV_FLAGS_LIST_DEFAULT
3686 - CONFIG_ENV_FLAGS_LIST_STATIC
3687         Enable validation of the values given to environment variables when
3688         calling env set.  Variables can be restricted to only decimal,
3689         hexadecimal, or boolean.  If CONFIG_CMD_NET is also defined,
3690         the variables can also be restricted to IP address or MAC address.
3691
3692         The format of the list is:
3693                 type_attribute = [s|d|x|b|i|m]
3694                 access_attribute = [a|r|o|c]
3695                 attributes = type_attribute[access_attribute]