blob: a0646c36657b3b69b37a9a1816a27fcdb55d8d43 [file] [log] [blame]
wdenkc6097192002-11-03 00:24:07 +00001#
Wolfgang Denkeca3aeb2013-06-21 10:22:36 +02002# (C) Copyright 2000 - 2013
wdenkc6097192002-11-03 00:24:07 +00003# Wolfgang Denk, DENX Software Engineering, wd@denx.de.
4#
Wolfgang Denkeca3aeb2013-06-21 10:22:36 +02005# SPDX-License-Identifier: GPL-2.0+
wdenkc6097192002-11-03 00:24:07 +00006#
7
8Summary:
9========
10
wdenk24ee89b2002-11-03 17:56:27 +000011This directory contains the source code for U-Boot, a boot loader for
wdenke86e5a02004-10-17 21:12:06 +000012Embedded boards based on PowerPC, ARM, MIPS and several other
13processors, which can be installed in a boot ROM and used to
14initialize and test the hardware or to download and run application
15code.
wdenkc6097192002-11-03 00:24:07 +000016
17The development of U-Boot is closely related to Linux: some parts of
wdenk24ee89b2002-11-03 17:56:27 +000018the source code originate in the Linux source tree, we have some
19header files in common, and special provision has been made to
wdenkc6097192002-11-03 00:24:07 +000020support booting of Linux images.
21
22Some attention has been paid to make this software easily
23configurable and extendable. For instance, all monitor commands are
24implemented with the same call interface, so that it's very easy to
25add new commands. Also, instead of permanently adding rarely used
26code (for instance hardware test utilities) to the monitor, you can
27load and run it dynamically.
28
29
30Status:
31=======
32
33In general, all boards for which a configuration option exists in the
wdenk24ee89b2002-11-03 17:56:27 +000034Makefile have been tested to some extent and can be considered
wdenkc6097192002-11-03 00:24:07 +000035"working". In fact, many of them are used in production systems.
36
wdenk24ee89b2002-11-03 17:56:27 +000037In case of problems see the CHANGELOG and CREDITS files to find out
Albert ARIBAUD27af9302013-09-11 15:52:51 +020038who contributed the specific port. The boards.cfg file lists board
Wolfgang Denk218ca722008-03-26 10:40:12 +010039maintainers.
wdenkc6097192002-11-03 00:24:07 +000040
Robert P. J. Dayadb9d852012-11-14 02:03:20 +000041Note: There is no CHANGELOG file in the actual U-Boot source tree;
42it can be created dynamically from the Git log using:
43
44 make CHANGELOG
45
wdenkc6097192002-11-03 00:24:07 +000046
47Where to get help:
48==================
49
wdenk24ee89b2002-11-03 17:56:27 +000050In case you have questions about, problems with or contributions for
51U-Boot you should send a message to the U-Boot mailing list at
Peter Tyser0c325652008-09-10 09:18:34 -050052<u-boot@lists.denx.de>. There is also an archive of previous traffic
53on the mailing list - please search the archive before asking FAQ's.
54Please see http://lists.denx.de/pipermail/u-boot and
55http://dir.gmane.org/gmane.comp.boot-loaders.u-boot
wdenkc6097192002-11-03 00:24:07 +000056
57
Wolfgang Denk218ca722008-03-26 10:40:12 +010058Where to get source code:
59=========================
60
61The U-Boot source code is maintained in the git repository at
62git://www.denx.de/git/u-boot.git ; you can browse it online at
63http://www.denx.de/cgi-bin/gitweb.cgi?p=u-boot.git;a=summary
64
65The "snapshot" links on this page allow you to download tarballs of
Marcel Ziswiler11ccc332008-07-09 08:17:15 +020066any version you might be interested in. Official releases are also
Wolfgang Denk218ca722008-03-26 10:40:12 +010067available for FTP download from the ftp://ftp.denx.de/pub/u-boot/
68directory.
69
Anatolij Gustschind4ee7112008-03-26 18:13:33 +010070Pre-built (and tested) images are available from
Wolfgang Denk218ca722008-03-26 10:40:12 +010071ftp://ftp.denx.de/pub/u-boot/images/
72
73
wdenkc6097192002-11-03 00:24:07 +000074Where we come from:
75===================
76
77- start from 8xxrom sources
wdenk24ee89b2002-11-03 17:56:27 +000078- create PPCBoot project (http://sourceforge.net/projects/ppcboot)
wdenkc6097192002-11-03 00:24:07 +000079- clean up code
80- make it easier to add custom boards
81- make it possible to add other [PowerPC] CPUs
82- extend functions, especially:
83 * Provide extended interface to Linux boot loader
84 * S-Record download
85 * network boot
Marcel Ziswiler11ccc332008-07-09 08:17:15 +020086 * PCMCIA / CompactFlash / ATA disk / SCSI ... boot
wdenk24ee89b2002-11-03 17:56:27 +000087- create ARMBoot project (http://sourceforge.net/projects/armboot)
wdenkc6097192002-11-03 00:24:07 +000088- add other CPU families (starting with ARM)
wdenk24ee89b2002-11-03 17:56:27 +000089- create U-Boot project (http://sourceforge.net/projects/u-boot)
Magnus Lilja0d28f342008-08-06 19:32:33 +020090- current project page: see http://www.denx.de/wiki/U-Boot
wdenk24ee89b2002-11-03 17:56:27 +000091
92
93Names and Spelling:
94===================
95
96The "official" name of this project is "Das U-Boot". The spelling
97"U-Boot" shall be used in all written text (documentation, comments
98in source files etc.). Example:
99
100 This is the README file for the U-Boot project.
101
102File names etc. shall be based on the string "u-boot". Examples:
103
104 include/asm-ppc/u-boot.h
105
106 #include <asm/u-boot.h>
107
108Variable names, preprocessor constants etc. shall be either based on
109the string "u_boot" or on "U_BOOT". Example:
110
111 U_BOOT_VERSION u_boot_logo
112 IH_OS_U_BOOT u_boot_hush_start
wdenkc6097192002-11-03 00:24:07 +0000113
114
wdenk93f19cc2002-12-17 17:55:09 +0000115Versioning:
116===========
117
Thomas Weber360d8832010-09-28 08:06:25 +0200118Starting with the release in October 2008, the names of the releases
119were changed from numerical release numbers without deeper meaning
120into a time stamp based numbering. Regular releases are identified by
121names consisting of the calendar year and month of the release date.
122Additional fields (if present) indicate release candidates or bug fix
123releases in "stable" maintenance trees.
wdenk93f19cc2002-12-17 17:55:09 +0000124
Thomas Weber360d8832010-09-28 08:06:25 +0200125Examples:
Wolfgang Denkc0f40852011-10-26 10:21:21 +0000126 U-Boot v2009.11 - Release November 2009
Thomas Weber360d8832010-09-28 08:06:25 +0200127 U-Boot v2009.11.1 - Release 1 in version November 2009 stable tree
128 U-Boot v2010.09-rc1 - Release candiate 1 for September 2010 release
wdenk93f19cc2002-12-17 17:55:09 +0000129
130
wdenkc6097192002-11-03 00:24:07 +0000131Directory Hierarchy:
132====================
133
Peter Tyser8d321b82010-04-12 22:28:21 -0500134/arch Architecture specific files
135 /arm Files generic to ARM architecture
136 /cpu CPU specific files
137 /arm720t Files specific to ARM 720 CPUs
138 /arm920t Files specific to ARM 920 CPUs
Andreas Bießmann6eb09212011-07-18 09:41:08 +0000139 /at91 Files specific to Atmel AT91RM9200 CPU
Wolfgang Denka9046b92010-06-13 17:48:15 +0200140 /imx Files specific to Freescale MC9328 i.MX CPUs
141 /s3c24x0 Files specific to Samsung S3C24X0 CPUs
Peter Tyser8d321b82010-04-12 22:28:21 -0500142 /arm926ejs Files specific to ARM 926 CPUs
143 /arm1136 Files specific to ARM 1136 CPUs
144 /ixp Files specific to Intel XScale IXP CPUs
145 /pxa Files specific to Intel XScale PXA CPUs
Peter Tyser8d321b82010-04-12 22:28:21 -0500146 /sa1100 Files specific to Intel StrongARM SA1100 CPUs
147 /lib Architecture specific library files
148 /avr32 Files generic to AVR32 architecture
149 /cpu CPU specific files
150 /lib Architecture specific library files
151 /blackfin Files generic to Analog Devices Blackfin architecture
152 /cpu CPU specific files
153 /lib Architecture specific library files
Peter Tyser8d321b82010-04-12 22:28:21 -0500154 /m68k Files generic to m68k architecture
155 /cpu CPU specific files
156 /mcf52x2 Files specific to Freescale ColdFire MCF52x2 CPUs
157 /mcf5227x Files specific to Freescale ColdFire MCF5227x CPUs
158 /mcf532x Files specific to Freescale ColdFire MCF5329 CPUs
159 /mcf5445x Files specific to Freescale ColdFire MCF5445x CPUs
160 /mcf547x_8x Files specific to Freescale ColdFire MCF547x_8x CPUs
161 /lib Architecture specific library files
162 /microblaze Files generic to microblaze architecture
163 /cpu CPU specific files
164 /lib Architecture specific library files
165 /mips Files generic to MIPS architecture
166 /cpu CPU specific files
Daniel Schwierzeck92bbd642011-07-27 13:22:39 +0200167 /mips32 Files specific to MIPS32 CPUs
Xiangfu Liu80421fc2011-10-12 12:24:06 +0800168 /xburst Files specific to Ingenic XBurst CPUs
Peter Tyser8d321b82010-04-12 22:28:21 -0500169 /lib Architecture specific library files
Macpaul Linafc1ce82011-10-19 20:41:11 +0000170 /nds32 Files generic to NDS32 architecture
171 /cpu CPU specific files
172 /n1213 Files specific to Andes Technology N1213 CPUs
173 /lib Architecture specific library files
Peter Tyser8d321b82010-04-12 22:28:21 -0500174 /nios2 Files generic to Altera NIOS2 architecture
175 /cpu CPU specific files
176 /lib Architecture specific library files
Robert P. J. Day33c77312013-09-15 18:34:15 -0400177 /openrisc Files generic to OpenRISC architecture
178 /cpu CPU specific files
179 /lib Architecture specific library files
Stefan Roesea47a12b2010-04-15 16:07:28 +0200180 /powerpc Files generic to PowerPC architecture
Peter Tyser8d321b82010-04-12 22:28:21 -0500181 /cpu CPU specific files
182 /74xx_7xx Files specific to Freescale MPC74xx and 7xx CPUs
183 /mpc5xx Files specific to Freescale MPC5xx CPUs
184 /mpc5xxx Files specific to Freescale MPC5xxx CPUs
185 /mpc8xx Files specific to Freescale MPC8xx CPUs
Peter Tyser8d321b82010-04-12 22:28:21 -0500186 /mpc824x Files specific to Freescale MPC824x CPUs
187 /mpc8260 Files specific to Freescale MPC8260 CPUs
188 /mpc85xx Files specific to Freescale MPC85xx CPUs
189 /ppc4xx Files specific to AMCC PowerPC 4xx CPUs
190 /lib Architecture specific library files
191 /sh Files generic to SH architecture
192 /cpu CPU specific files
193 /sh2 Files specific to sh2 CPUs
194 /sh3 Files specific to sh3 CPUs
195 /sh4 Files specific to sh4 CPUs
196 /lib Architecture specific library files
197 /sparc Files generic to SPARC architecture
198 /cpu CPU specific files
199 /leon2 Files specific to Gaisler LEON2 SPARC CPU
200 /leon3 Files specific to Gaisler LEON3 SPARC CPU
201 /lib Architecture specific library files
Robert P. J. Day33c77312013-09-15 18:34:15 -0400202 /x86 Files generic to x86 architecture
203 /cpu CPU specific files
204 /lib Architecture specific library files
Peter Tyser8d321b82010-04-12 22:28:21 -0500205/api Machine/arch independent API for external apps
206/board Board dependent files
207/common Misc architecture independent functions
208/disk Code for disk drive partition handling
209/doc Documentation (don't expect too much)
210/drivers Commonly used device drivers
Robert P. J. Day33c77312013-09-15 18:34:15 -0400211/dts Contains Makefile for building internal U-Boot fdt.
Peter Tyser8d321b82010-04-12 22:28:21 -0500212/examples Example code for standalone applications, etc.
213/fs Filesystem code (cramfs, ext2, jffs2, etc.)
214/include Header Files
215/lib Files generic to all architectures
216 /libfdt Library files to support flattened device trees
217 /lzma Library files to support LZMA decompression
218 /lzo Library files to support LZO decompression
219/net Networking code
220/post Power On Self Test
Robert P. J. Day33c77312013-09-15 18:34:15 -0400221/spl Secondary Program Loader framework
Peter Tyser8d321b82010-04-12 22:28:21 -0500222/tools Tools to build S-Record or U-Boot images, etc.
wdenkc6097192002-11-03 00:24:07 +0000223
wdenkc6097192002-11-03 00:24:07 +0000224Software Configuration:
225=======================
226
227Configuration is usually done using C preprocessor defines; the
228rationale behind that is to avoid dead code whenever possible.
229
230There are two classes of configuration variables:
231
232* Configuration _OPTIONS_:
233 These are selectable by the user and have names beginning with
234 "CONFIG_".
235
236* Configuration _SETTINGS_:
237 These depend on the hardware etc. and should not be meddled with if
238 you don't know what you're doing; they have names beginning with
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200239 "CONFIG_SYS_".
wdenkc6097192002-11-03 00:24:07 +0000240
241Later we will add a configuration tool - probably similar to or even
242identical to what's used for the Linux kernel. Right now, we have to
243do the configuration by hand, which means creating some symbolic
244links and editing some configuration files. We use the TQM8xxL boards
245as an example here.
246
247
248Selection of Processor Architecture and Board Type:
249---------------------------------------------------
250
251For all supported boards there are ready-to-use default
252configurations available; just type "make <board_name>_config".
253
254Example: For a TQM823L module type:
255
256 cd u-boot
257 make TQM823L_config
258
Marcel Ziswiler11ccc332008-07-09 08:17:15 +0200259For the Cogent platform, you need to specify the CPU type as well;
wdenkc6097192002-11-03 00:24:07 +0000260e.g. "make cogent_mpc8xx_config". And also configure the cogent
261directory according to the instructions in cogent/README.
262
263
264Configuration Options:
265----------------------
266
267Configuration depends on the combination of board and CPU type; all
268such information is kept in a configuration file
269"include/configs/<board_name>.h".
270
271Example: For a TQM823L module, all configuration settings are in
272"include/configs/TQM823L.h".
273
274
wdenk7f6c2cb2002-11-10 22:06:23 +0000275Many of the options are named exactly as the corresponding Linux
276kernel configuration options. The intention is to make it easier to
277build a config tool - later.
278
279
wdenkc6097192002-11-03 00:24:07 +0000280The following options need to be configured:
281
Kim Phillips26281142007-08-10 13:28:25 -0500282- CPU Type: Define exactly one, e.g. CONFIG_MPC85XX.
wdenkc6097192002-11-03 00:24:07 +0000283
Kim Phillips26281142007-08-10 13:28:25 -0500284- Board Type: Define exactly one, e.g. CONFIG_MPC8540ADS.
Wolfgang Denk6ccec442006-10-24 14:42:37 +0200285
286- CPU Daughterboard Type: (if CONFIG_ATSTK1000 is defined)
Haavard Skinnemoen09ea0de2007-11-01 12:44:20 +0100287 Define exactly one, e.g. CONFIG_ATSTK1002
wdenkc6097192002-11-03 00:24:07 +0000288
289- CPU Module Type: (if CONFIG_COGENT is defined)
290 Define exactly one of
291 CONFIG_CMA286_60_OLD
292--- FIXME --- not tested yet:
293 CONFIG_CMA286_60, CONFIG_CMA286_21, CONFIG_CMA286_60P,
294 CONFIG_CMA287_23, CONFIG_CMA287_50
295
296- Motherboard Type: (if CONFIG_COGENT is defined)
297 Define exactly one of
298 CONFIG_CMA101, CONFIG_CMA102
299
300- Motherboard I/O Modules: (if CONFIG_COGENT is defined)
301 Define one or more of
302 CONFIG_CMA302
303
304- Motherboard Options: (if CONFIG_CMA101 or CONFIG_CMA102 are defined)
305 Define one or more of
306 CONFIG_LCD_HEARTBEAT - update a character position on
Marcel Ziswiler11ccc332008-07-09 08:17:15 +0200307 the LCD display every second with
wdenkc6097192002-11-03 00:24:07 +0000308 a "rotator" |\-/|\-/
309
wdenk2535d602003-07-17 23:16:40 +0000310- Board flavour: (if CONFIG_MPC8260ADS is defined)
311 CONFIG_ADSTYPE
312 Possible values are:
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200313 CONFIG_SYS_8260ADS - original MPC8260ADS
314 CONFIG_SYS_8266ADS - MPC8266ADS
315 CONFIG_SYS_PQ2FADS - PQ2FADS-ZU or PQ2FADS-VR
316 CONFIG_SYS_8272ADS - MPC8272ADS
wdenk2535d602003-07-17 23:16:40 +0000317
Lei Wencf946c62011-02-09 18:06:58 +0530318- Marvell Family Member
319 CONFIG_SYS_MVFS - define it if you want to enable
320 multiple fs option at one time
321 for marvell soc family
322
wdenkc6097192002-11-03 00:24:07 +0000323- MPC824X Family Member (if CONFIG_MPC824X is defined)
wdenk5da627a2003-10-09 20:09:04 +0000324 Define exactly one of
325 CONFIG_MPC8240, CONFIG_MPC8245
wdenkc6097192002-11-03 00:24:07 +0000326
Marcel Ziswiler11ccc332008-07-09 08:17:15 +0200327- 8xx CPU Options: (if using an MPC8xx CPU)
wdenk66ca92a2004-09-28 17:59:53 +0000328 CONFIG_8xx_GCLK_FREQ - deprecated: CPU clock if
329 get_gclk_freq() cannot work
wdenk5da627a2003-10-09 20:09:04 +0000330 e.g. if there is no 32KHz
331 reference PIT/RTC clock
wdenk66ca92a2004-09-28 17:59:53 +0000332 CONFIG_8xx_OSCLK - PLL input clock (either EXTCLK
333 or XTAL/EXTAL)
wdenkc6097192002-11-03 00:24:07 +0000334
wdenk66ca92a2004-09-28 17:59:53 +0000335- 859/866/885 CPU options: (if using a MPC859 or MPC866 or MPC885 CPU):
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200336 CONFIG_SYS_8xx_CPUCLK_MIN
337 CONFIG_SYS_8xx_CPUCLK_MAX
wdenk66ca92a2004-09-28 17:59:53 +0000338 CONFIG_8xx_CPUCLK_DEFAULT
wdenk75d1ea72004-01-31 20:06:54 +0000339 See doc/README.MPC866
340
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200341 CONFIG_SYS_MEASURE_CPUCLK
wdenk75d1ea72004-01-31 20:06:54 +0000342
wdenkba56f622004-02-06 23:19:44 +0000343 Define this to measure the actual CPU clock instead
344 of relying on the correctness of the configured
345 values. Mostly useful for board bringup to make sure
346 the PLL is locked at the intended frequency. Note
347 that this requires a (stable) reference clock (32 kHz
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200348 RTC clock or CONFIG_SYS_8XX_XIN)
wdenk75d1ea72004-01-31 20:06:54 +0000349
Heiko Schocher506f3912009-03-12 07:37:15 +0100350 CONFIG_SYS_DELAYED_ICACHE
351
352 Define this option if you want to enable the
353 ICache only when Code runs from RAM.
354
Kumar Gala66412c62011-02-18 05:40:54 -0600355- 85xx CPU Options:
York Sunffd06e02012-10-08 07:44:30 +0000356 CONFIG_SYS_PPC64
357
358 Specifies that the core is a 64-bit PowerPC implementation (implements
359 the "64" category of the Power ISA). This is necessary for ePAPR
360 compliance, among other possible reasons.
361
Kumar Gala66412c62011-02-18 05:40:54 -0600362 CONFIG_SYS_FSL_TBCLK_DIV
363
364 Defines the core time base clock divider ratio compared to the
365 system clock. On most PQ3 devices this is 8, on newer QorIQ
366 devices it can be 16 or 32. The ratio varies from SoC to Soc.
367
Kumar Gala8f290842011-05-20 00:39:21 -0500368 CONFIG_SYS_FSL_PCIE_COMPAT
369
370 Defines the string to utilize when trying to match PCIe device
371 tree nodes for the given platform.
372
Prabhakar Kushwahaafa6b552012-04-29 23:56:13 +0000373 CONFIG_SYS_PPC_E500_DEBUG_TLB
374
375 Enables a temporary TLB entry to be used during boot to work
376 around limitations in e500v1 and e500v2 external debugger
377 support. This reduces the portions of the boot code where
378 breakpoints and single stepping do not work. The value of this
379 symbol should be set to the TLB1 entry to be used for this
380 purpose.
381
Scott Wood33eee332012-08-14 10:14:53 +0000382 CONFIG_SYS_FSL_ERRATUM_A004510
383
384 Enables a workaround for erratum A004510. If set,
385 then CONFIG_SYS_FSL_ERRATUM_A004510_SVR_REV and
386 CONFIG_SYS_FSL_CORENET_SNOOPVEC_COREONLY must be set.
387
388 CONFIG_SYS_FSL_ERRATUM_A004510_SVR_REV
389 CONFIG_SYS_FSL_ERRATUM_A004510_SVR_REV2 (optional)
390
391 Defines one or two SoC revisions (low 8 bits of SVR)
392 for which the A004510 workaround should be applied.
393
394 The rest of SVR is either not relevant to the decision
395 of whether the erratum is present (e.g. p2040 versus
396 p2041) or is implied by the build target, which controls
397 whether CONFIG_SYS_FSL_ERRATUM_A004510 is set.
398
399 See Freescale App Note 4493 for more information about
400 this erratum.
401
Prabhakar Kushwaha74fa22e2013-04-16 13:27:44 +0530402 CONFIG_A003399_NOR_WORKAROUND
403 Enables a workaround for IFC erratum A003399. It is only
404 requred during NOR boot.
405
Scott Wood33eee332012-08-14 10:14:53 +0000406 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
Priyanka Jain64501c62013-07-02 09:21:04 +0530411 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
Priyanka Jain765b0bd2013-04-04 09:31:54 +0530415 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
Priyanka Jain64501c62013-07-02 09:21:04 +0530419 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
Priyanka Jain765b0bd2013-04-04 09:31:54 +0530423 CONFIG_SYS_FSL_DSP_CCSRBAR_DEFAULT
424 This value denotes start offset of DSP CCSR space.
425
Priyanka Jainb1359912013-12-17 14:25:52 +0530426 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
Daniel Schwierzeck6cb461b2012-04-02 02:57:56 +0000431- Generic CPU options:
432 CONFIG_SYS_BIG_ENDIAN, CONFIG_SYS_LITTLE_ENDIAN
433
434 Defines the endianess of the CPU. Implementation of those
435 values is arch specific.
436
York Sun5614e712013-09-30 09:22:09 -0700437 CONFIG_SYS_FSL_DDR
438 Freescale DDR driver in use. This type of DDR controller is
439 found in mpc83xx, mpc85xx, mpc86xx as well as some ARM core
440 SoCs.
441
442 CONFIG_SYS_FSL_DDR_ADDR
443 Freescale DDR memory-mapped register base.
444
445 CONFIG_SYS_FSL_DDR_EMU
446 Specify emulator support for DDR. Some DDR features such as
447 deskew training are not available.
448
449 CONFIG_SYS_FSL_DDRC_GEN1
450 Freescale DDR1 controller.
451
452 CONFIG_SYS_FSL_DDRC_GEN2
453 Freescale DDR2 controller.
454
455 CONFIG_SYS_FSL_DDRC_GEN3
456 Freescale DDR3 controller.
457
York Sun9ac4ffb2013-09-30 14:20:51 -0700458 CONFIG_SYS_FSL_DDRC_ARM_GEN3
459 Freescale DDR3 controller for ARM-based SoCs.
460
York Sun5614e712013-09-30 09:22:09 -0700461 CONFIG_SYS_FSL_DDR1
462 Board config to use DDR1. It can be enabled for SoCs with
463 Freescale DDR1 or DDR2 controllers, depending on the board
464 implemetation.
465
466 CONFIG_SYS_FSL_DDR2
467 Board config to use DDR2. It can be eanbeld for SoCs with
468 Freescale DDR2 or DDR3 controllers, depending on the board
469 implementation.
470
471 CONFIG_SYS_FSL_DDR3
472 Board config to use DDR3. It can be enabled for SoCs with
473 Freescale DDR3 controllers.
474
Markus Klotzbuecher0b953ff2006-03-24 15:28:02 +0100475- Intel Monahans options:
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200476 CONFIG_SYS_MONAHANS_RUN_MODE_OSC_RATIO
Markus Klotzbuecher0b953ff2006-03-24 15:28:02 +0100477
478 Defines the Monahans run mode to oscillator
479 ratio. Valid values are 8, 16, 24, 31. The core
480 frequency is this value multiplied by 13 MHz.
481
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200482 CONFIG_SYS_MONAHANS_TURBO_RUN_MODE_RATIO
Wolfgang Denkcf48eb92006-04-16 10:51:58 +0200483
Markus Klotzbuecher0b953ff2006-03-24 15:28:02 +0100484 Defines the Monahans turbo mode to oscillator
485 ratio. Valid values are 1 (default if undefined) and
Wolfgang Denkcf48eb92006-04-16 10:51:58 +0200486 2. The core frequency as calculated above is multiplied
Markus Klotzbuecher0b953ff2006-03-24 15:28:02 +0100487 by this value.
Wolfgang Denkcf48eb92006-04-16 10:51:58 +0200488
Daniel Schwierzeck92bbd642011-07-27 13:22:39 +0200489- MIPS CPU options:
490 CONFIG_SYS_INIT_SP_OFFSET
491
492 Offset relative to CONFIG_SYS_SDRAM_BASE for initial stack
493 pointer. This is needed for the temporary stack before
494 relocation.
495
496 CONFIG_SYS_MIPS_CACHE_MODE
497
498 Cache operation mode for the MIPS CPU.
499 See also arch/mips/include/asm/mipsregs.h.
500 Possible values are:
501 CONF_CM_CACHABLE_NO_WA
502 CONF_CM_CACHABLE_WA
503 CONF_CM_UNCACHED
504 CONF_CM_CACHABLE_NONCOHERENT
505 CONF_CM_CACHABLE_CE
506 CONF_CM_CACHABLE_COW
507 CONF_CM_CACHABLE_CUW
508 CONF_CM_CACHABLE_ACCELERATED
509
510 CONFIG_SYS_XWAY_EBU_BOOTCFG
511
512 Special option for Lantiq XWAY SoCs for booting from NOR flash.
513 See also arch/mips/cpu/mips32/start.S.
514
515 CONFIG_XWAY_SWAP_BYTES
516
517 Enable compilation of tools/xway-swap-bytes needed for Lantiq
518 XWAY SoCs for booting from NOR flash. The U-Boot image needs to
519 be swapped if a flash programmer is used.
520
Christian Rieschb67d8812012-02-02 00:44:39 +0000521- ARM options:
522 CONFIG_SYS_EXCEPTION_VECTORS_HIGH
523
524 Select high exception vectors of the ARM core, e.g., do not
525 clear the V bit of the c1 register of CP15.
526
Aneesh V5356f542012-03-08 07:20:19 +0000527 CONFIG_SYS_THUMB_BUILD
528
529 Use this flag to build U-Boot using the Thumb instruction
530 set for ARM architectures. Thumb instruction set provides
531 better code density. For ARM architectures that support
532 Thumb2 this flag will result in Thumb2 code generated by
533 GCC.
534
Stephen Warrenc5d47522013-03-04 13:29:40 +0000535 CONFIG_ARM_ERRATA_716044
Stephen Warren06785872013-02-26 12:28:27 +0000536 CONFIG_ARM_ERRATA_742230
537 CONFIG_ARM_ERRATA_743622
538 CONFIG_ARM_ERRATA_751472
539
540 If set, the workarounds for these ARM errata are applied early
541 during U-Boot startup. Note that these options force the
542 workarounds to be applied; no CPU-type/version detection
543 exists, unlike the similar options in the Linux kernel. Do not
544 set these options unless they apply!
545
Stephen Warren795659d2013-03-27 17:06:41 +0000546- CPU timer options:
547 CONFIG_SYS_HZ
548
549 The frequency of the timer returned by get_timer().
550 get_timer() must operate in milliseconds and this CONFIG
551 option must be set to 1000.
552
wdenk5da627a2003-10-09 20:09:04 +0000553- Linux Kernel Interface:
wdenkc6097192002-11-03 00:24:07 +0000554 CONFIG_CLOCKS_IN_MHZ
555
556 U-Boot stores all clock information in Hz
557 internally. For binary compatibility with older Linux
558 kernels (which expect the clocks passed in the
559 bd_info data to be in MHz) the environment variable
560 "clocks_in_mhz" can be defined so that U-Boot
561 converts clock data to MHZ before passing it to the
562 Linux kernel.
wdenkc6097192002-11-03 00:24:07 +0000563 When CONFIG_CLOCKS_IN_MHZ is defined, a definition of
Wolfgang Denk218ca722008-03-26 10:40:12 +0100564 "clocks_in_mhz=1" is automatically included in the
wdenkc6097192002-11-03 00:24:07 +0000565 default environment.
566
wdenk5da627a2003-10-09 20:09:04 +0000567 CONFIG_MEMSIZE_IN_BYTES [relevant for MIPS only]
568
Marcel Ziswiler11ccc332008-07-09 08:17:15 +0200569 When transferring memsize parameter to linux, some versions
wdenk5da627a2003-10-09 20:09:04 +0000570 expect it to be in bytes, others in MB.
571 Define CONFIG_MEMSIZE_IN_BYTES to make it in bytes.
572
Gerald Van Barenfec6d9e2008-06-03 20:34:45 -0400573 CONFIG_OF_LIBFDT
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200574
575 New kernel versions are expecting firmware settings to be
Gerald Van Baren213bf8c2007-03-31 12:23:51 -0400576 passed using flattened device trees (based on open firmware
577 concepts).
578
579 CONFIG_OF_LIBFDT
580 * New libfdt-based support
581 * Adds the "fdt" command
Kim Phillips3bb342f2007-08-10 14:34:14 -0500582 * The bootm command automatically updates the fdt
Gerald Van Baren213bf8c2007-03-31 12:23:51 -0400583
Marcel Ziswilerb55ae402009-09-09 21:18:41 +0200584 OF_CPU - The proper name of the cpus node (only required for
585 MPC512X and MPC5xxx based boards).
586 OF_SOC - The proper name of the soc node (only required for
587 MPC512X and MPC5xxx based boards).
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200588 OF_TBCLK - The timebase frequency.
Kumar Galac2871f02006-01-11 13:59:02 -0600589 OF_STDOUT_PATH - The path to the console device
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200590
Marcel Ziswiler11ccc332008-07-09 08:17:15 +0200591 boards with QUICC Engines require OF_QE to set UCC MAC
592 addresses
Kim Phillips3bb342f2007-08-10 14:34:14 -0500593
Kumar Gala4e253132006-01-11 13:54:17 -0600594 CONFIG_OF_BOARD_SETUP
595
596 Board code has addition modification that it wants to make
597 to the flat device tree before handing it off to the kernel
wdenk6705d812004-08-02 23:22:59 +0000598
Matthew McClintock02677682006-06-28 10:41:37 -0500599 CONFIG_OF_BOOT_CPU
600
Marcel Ziswiler11ccc332008-07-09 08:17:15 +0200601 This define fills in the correct boot CPU in the boot
Matthew McClintock02677682006-06-28 10:41:37 -0500602 param header, the default value is zero if undefined.
603
Heiko Schocher3887c3f2009-09-23 07:56:08 +0200604 CONFIG_OF_IDE_FIXUP
605
606 U-Boot can detect if an IDE device is present or not.
607 If not, and this new config option is activated, U-Boot
608 removes the ATA node from the DTS before booting Linux,
609 so the Linux IDE driver does not probe the device and
610 crash. This is needed for buggy hardware (uc101) where
611 no pull down resistor is connected to the signal IDE5V_DD7.
612
Igor Grinberg7eb29392011-07-14 05:45:07 +0000613 CONFIG_MACH_TYPE [relevant for ARM only][mandatory]
614
615 This setting is mandatory for all boards that have only one
616 machine type and must be used to specify the machine type
617 number as it appears in the ARM machine registry
618 (see http://www.arm.linux.org.uk/developer/machines/).
619 Only boards that have multiple machine types supported
620 in a single configuration file and the machine type is
621 runtime discoverable, do not have to use this setting.
622
Niklaus Giger0b2f4ec2008-11-03 22:13:47 +0100623- vxWorks boot parameters:
624
625 bootvx constructs a valid bootline using the following
626 environments variables: bootfile, ipaddr, serverip, hostname.
627 It loads the vxWorks image pointed bootfile.
628
629 CONFIG_SYS_VXWORKS_BOOT_DEVICE - The vxworks device name
630 CONFIG_SYS_VXWORKS_MAC_PTR - Ethernet 6 byte MA -address
631 CONFIG_SYS_VXWORKS_SERVERNAME - Name of the server
632 CONFIG_SYS_VXWORKS_BOOT_ADDR - Address of boot parameters
633
634 CONFIG_SYS_VXWORKS_ADD_PARAMS
635
636 Add it at the end of the bootline. E.g "u=username pw=secret"
637
638 Note: If a "bootargs" environment is defined, it will overwride
639 the defaults discussed just above.
640
Aneesh V2c451f72011-06-16 23:30:47 +0000641- Cache Configuration:
642 CONFIG_SYS_ICACHE_OFF - Do not enable instruction cache in U-Boot
643 CONFIG_SYS_DCACHE_OFF - Do not enable data cache in U-Boot
644 CONFIG_SYS_L2CACHE_OFF- Do not enable L2 cache in U-Boot
645
Aneesh V93bc2192011-06-16 23:30:51 +0000646- Cache Configuration for ARM:
647 CONFIG_SYS_L2_PL310 - Enable support for ARM PL310 L2 cache
648 controller
649 CONFIG_SYS_PL310_BASE - Physical base address of PL310
650 controller register space
651
wdenk6705d812004-08-02 23:22:59 +0000652- Serial Ports:
Andreas Engel48d01922008-09-08 14:30:53 +0200653 CONFIG_PL010_SERIAL
wdenk6705d812004-08-02 23:22:59 +0000654
655 Define this if you want support for Amba PrimeCell PL010 UARTs.
656
Andreas Engel48d01922008-09-08 14:30:53 +0200657 CONFIG_PL011_SERIAL
wdenk6705d812004-08-02 23:22:59 +0000658
659 Define this if you want support for Amba PrimeCell PL011 UARTs.
660
661 CONFIG_PL011_CLOCK
662
663 If you have Amba PrimeCell PL011 UARTs, set this variable to
664 the clock speed of the UARTs.
665
666 CONFIG_PL01x_PORTS
667
668 If you have Amba PrimeCell PL010 or PL011 UARTs on your board,
669 define this to a list of base addresses for each (supported)
670 port. See e.g. include/configs/versatile.h
671
John Rigby910f1ae2011-04-19 10:42:39 +0000672 CONFIG_PL011_SERIAL_RLCR
673
674 Some vendor versions of PL011 serial ports (e.g. ST-Ericsson U8500)
675 have separate receive and transmit line control registers. Set
676 this variable to initialize the extra register.
677
678 CONFIG_PL011_SERIAL_FLUSH_ON_INIT
679
680 On some platforms (e.g. U8500) U-Boot is loaded by a second stage
681 boot loader that has already initialized the UART. Define this
682 variable to flush the UART at init time.
683
wdenk6705d812004-08-02 23:22:59 +0000684
wdenkc6097192002-11-03 00:24:07 +0000685- Console Interface:
wdenk43d96162003-03-06 00:02:04 +0000686 Depending on board, define exactly one serial port
687 (like CONFIG_8xx_CONS_SMC1, CONFIG_8xx_CONS_SMC2,
688 CONFIG_8xx_CONS_SCC1, ...), or switch off the serial
689 console by defining CONFIG_8xx_CONS_NONE
wdenkc6097192002-11-03 00:24:07 +0000690
691 Note: if CONFIG_8xx_CONS_NONE is defined, the serial
692 port routines must be defined elsewhere
693 (i.e. serial_init(), serial_getc(), ...)
694
695 CONFIG_CFB_CONSOLE
696 Enables console device for a color framebuffer. Needs following
Wolfgang Denkc53043b2011-12-07 12:19:20 +0000697 defines (cf. smiLynxEM, i8042)
wdenkc6097192002-11-03 00:24:07 +0000698 VIDEO_FB_LITTLE_ENDIAN graphic memory organisation
699 (default big endian)
700 VIDEO_HW_RECTFILL graphic chip supports
701 rectangle fill
702 (cf. smiLynxEM)
703 VIDEO_HW_BITBLT graphic chip supports
704 bit-blit (cf. smiLynxEM)
705 VIDEO_VISIBLE_COLS visible pixel columns
706 (cols=pitch)
wdenkba56f622004-02-06 23:19:44 +0000707 VIDEO_VISIBLE_ROWS visible pixel rows
708 VIDEO_PIXEL_SIZE bytes per pixel
wdenkc6097192002-11-03 00:24:07 +0000709 VIDEO_DATA_FORMAT graphic data format
710 (0-5, cf. cfb_console.c)
wdenkba56f622004-02-06 23:19:44 +0000711 VIDEO_FB_ADRS framebuffer address
wdenkc6097192002-11-03 00:24:07 +0000712 VIDEO_KBD_INIT_FCT keyboard int fct
713 (i.e. i8042_kbd_init())
714 VIDEO_TSTC_FCT test char fct
715 (i.e. i8042_tstc)
716 VIDEO_GETC_FCT get char fct
717 (i.e. i8042_getc)
718 CONFIG_CONSOLE_CURSOR cursor drawing on/off
719 (requires blink timer
720 cf. i8042.c)
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200721 CONFIG_SYS_CONSOLE_BLINK_COUNT blink interval (cf. i8042.c)
wdenkc6097192002-11-03 00:24:07 +0000722 CONFIG_CONSOLE_TIME display time/date info in
723 upper right corner
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500724 (requires CONFIG_CMD_DATE)
wdenkc6097192002-11-03 00:24:07 +0000725 CONFIG_VIDEO_LOGO display Linux logo in
726 upper left corner
wdenka6c7ad22002-12-03 21:28:10 +0000727 CONFIG_VIDEO_BMP_LOGO use bmp_logo.h instead of
728 linux_logo.h for logo.
729 Requires CONFIG_VIDEO_LOGO
wdenkc6097192002-11-03 00:24:07 +0000730 CONFIG_CONSOLE_EXTRA_INFO
Marcel Ziswiler11ccc332008-07-09 08:17:15 +0200731 additional board info beside
wdenkc6097192002-11-03 00:24:07 +0000732 the logo
733
Pali Rohár33a35bb2012-10-19 13:30:09 +0000734 When CONFIG_CFB_CONSOLE_ANSI is defined, console will support
735 a limited number of ANSI escape sequences (cursor control,
736 erase functions and limited graphics rendition control).
737
wdenk43d96162003-03-06 00:02:04 +0000738 When CONFIG_CFB_CONSOLE is defined, video console is
739 default i/o. Serial console can be forced with
740 environment 'console=serial'.
wdenkc6097192002-11-03 00:24:07 +0000741
wdenkd4ca31c2004-01-02 14:00:00 +0000742 When CONFIG_SILENT_CONSOLE is defined, all console
743 messages (by U-Boot and Linux!) can be silenced with
744 the "silent" environment variable. See
745 doc/README.silent for more information.
wdenka3ad8e22003-10-19 23:22:11 +0000746
Heiko Schocher45ae2542013-10-22 11:06:06 +0200747 CONFIG_SYS_CONSOLE_BG_COL: define the backgroundcolor, default
748 is 0x00.
749 CONFIG_SYS_CONSOLE_FG_COL: define the foregroundcolor, default
750 is 0xa0.
751
wdenkc6097192002-11-03 00:24:07 +0000752- Console Baudrate:
753 CONFIG_BAUDRATE - in bps
754 Select one of the baudrates listed in
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200755 CONFIG_SYS_BAUDRATE_TABLE, see below.
756 CONFIG_SYS_BRGCLK_PRESCALE, baudrate prescale
wdenkc6097192002-11-03 00:24:07 +0000757
Heiko Schocherc92fac92009-01-30 12:55:38 +0100758- Console Rx buffer length
759 With CONFIG_SYS_SMC_RXBUFLEN it is possible to define
760 the maximum receive buffer length for the SMC.
Heiko Schocher2b3f12c2009-02-10 09:31:47 +0100761 This option is actual only for 82xx and 8xx possible.
Heiko Schocherc92fac92009-01-30 12:55:38 +0100762 If using CONFIG_SYS_SMC_RXBUFLEN also CONFIG_SYS_MAXIDLE
763 must be defined, to setup the maximum idle timeout for
764 the SMC.
765
Graeme Russ9558b482011-09-01 00:48:27 +0000766- Pre-Console Buffer:
Wolfgang Denk4cf26092011-10-07 09:58:21 +0200767 Prior to the console being initialised (i.e. serial UART
768 initialised etc) all console output is silently discarded.
769 Defining CONFIG_PRE_CONSOLE_BUFFER will cause U-Boot to
770 buffer any console messages prior to the console being
771 initialised to a buffer of size CONFIG_PRE_CON_BUF_SZ
772 bytes located at CONFIG_PRE_CON_BUF_ADDR. The buffer is
773 a circular buffer, so if more than CONFIG_PRE_CON_BUF_SZ
Wolfgang Denk6feff892011-10-09 21:06:34 +0200774 bytes are output before the console is initialised, the
Wolfgang Denk4cf26092011-10-07 09:58:21 +0200775 earlier bytes are discarded.
Graeme Russ9558b482011-09-01 00:48:27 +0000776
Wolfgang Denk4cf26092011-10-07 09:58:21 +0200777 'Sane' compilers will generate smaller code if
778 CONFIG_PRE_CON_BUF_SZ is a power of 2
Graeme Russ9558b482011-09-01 00:48:27 +0000779
Sonny Rao046a37b2011-11-02 09:52:08 +0000780- Safe printf() functions
781 Define CONFIG_SYS_VSNPRINTF to compile in safe versions of
782 the printf() functions. These are defined in
783 include/vsprintf.h and include snprintf(), vsnprintf() and
784 so on. Code size increase is approximately 300-500 bytes.
785 If this option is not given then these functions will
786 silently discard their buffer size argument - this means
787 you are not getting any overflow checking in this case.
788
wdenkc6097192002-11-03 00:24:07 +0000789- Boot Delay: CONFIG_BOOTDELAY - in seconds
790 Delay before automatically booting the default image;
791 set to -1 to disable autoboot.
Joe Hershberger93d72122012-08-17 10:53:12 +0000792 set to -2 to autoboot with no delay and not check for abort
793 (even when CONFIG_ZERO_BOOTDELAY_CHECK is defined).
wdenkc6097192002-11-03 00:24:07 +0000794
795 See doc/README.autoboot for these options that
796 work with CONFIG_BOOTDELAY. None are required.
797 CONFIG_BOOT_RETRY_TIME
798 CONFIG_BOOT_RETRY_MIN
799 CONFIG_AUTOBOOT_KEYED
800 CONFIG_AUTOBOOT_PROMPT
801 CONFIG_AUTOBOOT_DELAY_STR
802 CONFIG_AUTOBOOT_STOP_STR
803 CONFIG_AUTOBOOT_DELAY_STR2
804 CONFIG_AUTOBOOT_STOP_STR2
805 CONFIG_ZERO_BOOTDELAY_CHECK
806 CONFIG_RESET_TO_RETRY
807
808- Autoboot Command:
809 CONFIG_BOOTCOMMAND
810 Only needed when CONFIG_BOOTDELAY is enabled;
811 define a command string that is automatically executed
812 when no character is read on the console interface
813 within "Boot Delay" after reset.
814
815 CONFIG_BOOTARGS
wdenk43d96162003-03-06 00:02:04 +0000816 This can be used to pass arguments to the bootm
817 command. The value of CONFIG_BOOTARGS goes into the
818 environment value "bootargs".
wdenkc6097192002-11-03 00:24:07 +0000819
820 CONFIG_RAMBOOT and CONFIG_NFSBOOT
wdenk43d96162003-03-06 00:02:04 +0000821 The value of these goes into the environment as
822 "ramboot" and "nfsboot" respectively, and can be used
823 as a convenience, when switching between booting from
Marcel Ziswiler11ccc332008-07-09 08:17:15 +0200824 RAM and NFS.
wdenkc6097192002-11-03 00:24:07 +0000825
Heiko Schochereda0ba32013-11-04 14:04:59 +0100826- Bootcount:
827 CONFIG_BOOTCOUNT_LIMIT
828 Implements a mechanism for detecting a repeating reboot
829 cycle, see:
830 http://www.denx.de/wiki/view/DULG/UBootBootCountLimit
831
832 CONFIG_BOOTCOUNT_ENV
833 If no softreset save registers are found on the hardware
834 "bootcount" is stored in the environment. To prevent a
835 saveenv on all reboots, the environment variable
836 "upgrade_available" is used. If "upgrade_available" is
837 0, "bootcount" is always 0, if "upgrade_available" is
838 1 "bootcount" is incremented in the environment.
839 So the Userspace Applikation must set the "upgrade_available"
840 and "bootcount" variable to 0, if a boot was successfully.
841
wdenkc6097192002-11-03 00:24:07 +0000842- Pre-Boot Commands:
843 CONFIG_PREBOOT
844
845 When this option is #defined, the existence of the
846 environment variable "preboot" will be checked
847 immediately before starting the CONFIG_BOOTDELAY
848 countdown and/or running the auto-boot command resp.
849 entering interactive mode.
850
851 This feature is especially useful when "preboot" is
852 automatically generated or modified. For an example
853 see the LWMON board specific code: here "preboot" is
854 modified when the user holds down a certain
855 combination of keys on the (special) keyboard when
856 booting the systems
857
858- Serial Download Echo Mode:
859 CONFIG_LOADS_ECHO
860 If defined to 1, all characters received during a
861 serial download (using the "loads" command) are
862 echoed back. This might be needed by some terminal
863 emulations (like "cu"), but may as well just take
864 time on others. This setting #define's the initial
865 value of the "loads_echo" environment variable.
866
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500867- Kgdb Serial Baudrate: (if CONFIG_CMD_KGDB is defined)
wdenkc6097192002-11-03 00:24:07 +0000868 CONFIG_KGDB_BAUDRATE
869 Select one of the baudrates listed in
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200870 CONFIG_SYS_BAUDRATE_TABLE, see below.
wdenkc6097192002-11-03 00:24:07 +0000871
872- Monitor Functions:
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500873 Monitor commands can be included or excluded
874 from the build by using the #include files
Stephen Warrenc6c621b2012-08-05 16:07:19 +0000875 <config_cmd_all.h> and #undef'ing unwanted
876 commands, or using <config_cmd_default.h>
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500877 and augmenting with additional #define's
878 for wanted commands.
wdenkc6097192002-11-03 00:24:07 +0000879
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500880 The default command configuration includes all commands
881 except those marked below with a "*".
wdenkc6097192002-11-03 00:24:07 +0000882
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500883 CONFIG_CMD_ASKENV * ask for env variable
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500884 CONFIG_CMD_BDI bdinfo
885 CONFIG_CMD_BEDBUG * Include BedBug Debugger
886 CONFIG_CMD_BMP * BMP support
887 CONFIG_CMD_BSP * Board specific commands
888 CONFIG_CMD_BOOTD bootd
889 CONFIG_CMD_CACHE * icache, dcache
890 CONFIG_CMD_CONSOLE coninfo
Mike Frysinger710b9932010-12-21 14:19:51 -0500891 CONFIG_CMD_CRC32 * crc32
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500892 CONFIG_CMD_DATE * support for RTC, date/time...
893 CONFIG_CMD_DHCP * DHCP support
894 CONFIG_CMD_DIAG * Diagnostics
Peter Tysera7c93102008-12-17 16:36:22 -0600895 CONFIG_CMD_DS4510 * ds4510 I2C gpio commands
896 CONFIG_CMD_DS4510_INFO * ds4510 I2C info command
897 CONFIG_CMD_DS4510_MEM * ds4510 I2C eeprom/sram commansd
898 CONFIG_CMD_DS4510_RST * ds4510 I2C rst command
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500899 CONFIG_CMD_DTT * Digital Therm and Thermostat
900 CONFIG_CMD_ECHO echo arguments
Peter Tyser246c6922009-10-25 15:12:56 -0500901 CONFIG_CMD_EDITENV edit env variable
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500902 CONFIG_CMD_EEPROM * EEPROM read/write support
903 CONFIG_CMD_ELF * bootelf, bootvx
Joe Hershberger5e2b3e02012-12-11 22:16:25 -0600904 CONFIG_CMD_ENV_CALLBACK * display details about env callbacks
Joe Hershbergerfffad712012-12-11 22:16:33 -0600905 CONFIG_CMD_ENV_FLAGS * display details about env flags
Andrew Ruder88733e22013-10-22 19:07:34 -0500906 CONFIG_CMD_ENV_EXISTS * check existence of env variable
Mike Frysinger0c79cda2010-12-26 23:09:45 -0500907 CONFIG_CMD_EXPORTENV * export the environment
Stephen Warren03e2ecf2012-10-22 06:43:50 +0000908 CONFIG_CMD_EXT2 * ext2 command support
909 CONFIG_CMD_EXT4 * ext4 command support
Mike Frysingerbdab39d2009-01-28 19:08:14 -0500910 CONFIG_CMD_SAVEENV saveenv
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500911 CONFIG_CMD_FDC * Floppy Disk Support
Stephen Warren03e2ecf2012-10-22 06:43:50 +0000912 CONFIG_CMD_FAT * FAT command support
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500913 CONFIG_CMD_FDOS * Dos diskette Support
914 CONFIG_CMD_FLASH flinfo, erase, protect
915 CONFIG_CMD_FPGA FPGA device initialization support
Vincent Stehlé4d98b5c2013-06-20 18:14:22 +0200916 CONFIG_CMD_FUSE * Device fuse support
Anton Staaf53fdc7e2012-12-05 14:46:29 +0000917 CONFIG_CMD_GETTIME * Get time since boot
Mike Frysingera641b972010-12-26 23:32:22 -0500918 CONFIG_CMD_GO * the 'go' command (exec code)
Kim Phillipsa000b792011-04-05 07:15:14 +0000919 CONFIG_CMD_GREPENV * search environment
Simon Glassbf36c5d2012-12-05 14:46:38 +0000920 CONFIG_CMD_HASH * calculate hash / digest
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500921 CONFIG_CMD_HWFLOW * RTS/CTS hw flow control
922 CONFIG_CMD_I2C * I2C serial bus support
923 CONFIG_CMD_IDE * IDE harddisk support
924 CONFIG_CMD_IMI iminfo
Vipin Kumar8fdf1e02012-12-16 22:32:48 +0000925 CONFIG_CMD_IMLS List all images found in NOR flash
Vincent Stehlé4d98b5c2013-06-20 18:14:22 +0200926 CONFIG_CMD_IMLS_NAND * List all images found in NAND flash
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500927 CONFIG_CMD_IMMAP * IMMR dump support
Mike Frysinger0c79cda2010-12-26 23:09:45 -0500928 CONFIG_CMD_IMPORTENV * import an environment
Joe Hershbergerc167cc02012-10-03 11:15:51 +0000929 CONFIG_CMD_INI * import data from an ini file into the env
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500930 CONFIG_CMD_IRQ * irqinfo
931 CONFIG_CMD_ITEST Integer/string test of 2 values
932 CONFIG_CMD_JFFS2 * JFFS2 Support
933 CONFIG_CMD_KGDB * kgdb
Vincent Stehlé4d98b5c2013-06-20 18:14:22 +0200934 CONFIG_CMD_LDRINFO * ldrinfo (display Blackfin loader)
Joe Hershbergerd22c3382012-05-23 08:00:12 +0000935 CONFIG_CMD_LINK_LOCAL * link-local IP address auto-configuration
936 (169.254.*.*)
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500937 CONFIG_CMD_LOADB loadb
938 CONFIG_CMD_LOADS loads
Vincent Stehlé4d98b5c2013-06-20 18:14:22 +0200939 CONFIG_CMD_MD5SUM * print md5 message digest
Robin Getz02c9aa12009-07-27 00:07:59 -0400940 (requires CONFIG_CMD_MEMORY and CONFIG_MD5)
Simon Glass15a33e42012-11-30 13:01:20 +0000941 CONFIG_CMD_MEMINFO * Display detailed memory information
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500942 CONFIG_CMD_MEMORY md, mm, nm, mw, cp, cmp, crc, base,
Wolfgang Denka2681702013-03-08 10:51:32 +0000943 loop, loopw
Vincent Stehlé4d98b5c2013-06-20 18:14:22 +0200944 CONFIG_CMD_MEMTEST * mtest
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500945 CONFIG_CMD_MISC Misc functions like sleep etc
946 CONFIG_CMD_MMC * MMC memory mapped support
947 CONFIG_CMD_MII * MII utility commands
Stefan Roese68d7d652009-03-19 13:30:36 +0100948 CONFIG_CMD_MTDPARTS * MTD partition support
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500949 CONFIG_CMD_NAND * NAND support
950 CONFIG_CMD_NET bootp, tftpboot, rarpboot
Vincent Stehlé4d98b5c2013-06-20 18:14:22 +0200951 CONFIG_CMD_NFS NFS support
Peter Tysere92739d2008-12-17 16:36:21 -0600952 CONFIG_CMD_PCA953X * PCA953x I2C gpio commands
Wolfgang Denkc0f40852011-10-26 10:21:21 +0000953 CONFIG_CMD_PCA953X_INFO * PCA953x I2C gpio info command
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500954 CONFIG_CMD_PCI * pciinfo
955 CONFIG_CMD_PCMCIA * PCMCIA support
956 CONFIG_CMD_PING * send ICMP ECHO_REQUEST to network
957 host
958 CONFIG_CMD_PORTIO * Port I/O
Kenneth Watersff048ea2012-12-05 14:46:30 +0000959 CONFIG_CMD_READ * Read raw data from partition
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500960 CONFIG_CMD_REGINFO * Register dump
961 CONFIG_CMD_RUN run command in env variable
Simon Glassd3049312012-12-26 09:53:36 +0000962 CONFIG_CMD_SANDBOX * sb command to access sandbox features
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500963 CONFIG_CMD_SAVES * save S record dump
964 CONFIG_CMD_SCSI * SCSI Support
965 CONFIG_CMD_SDRAM * print SDRAM configuration information
966 (requires CONFIG_CMD_I2C)
967 CONFIG_CMD_SETGETDCR Support for DCR Register access
968 (4xx only)
Eric Nelsonf61ec452012-01-31 10:52:08 -0700969 CONFIG_CMD_SF * Read/write/erase SPI NOR flash
Vincent Stehlé4d98b5c2013-06-20 18:14:22 +0200970 CONFIG_CMD_SHA1SUM * print sha1 memory digest
Robin Getz02c9aa12009-07-27 00:07:59 -0400971 (requires CONFIG_CMD_MEMORY)
Bob Liu7d861d92013-02-05 19:05:41 +0800972 CONFIG_CMD_SOFTSWITCH * Soft switch setting command for BF60x
Wolfgang Denk74de7ae2009-04-01 23:34:12 +0200973 CONFIG_CMD_SOURCE "source" command Support
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500974 CONFIG_CMD_SPI * SPI serial bus support
Luca Ceresoli7a83af02011-05-17 00:03:40 +0000975 CONFIG_CMD_TFTPSRV * TFTP transfer in server mode
Simon Glass1fb7cd42011-10-24 18:00:07 +0000976 CONFIG_CMD_TFTPPUT * TFTP put command (upload)
Joe Hershbergerda83bcd2012-10-03 12:14:57 +0000977 CONFIG_CMD_TIME * run command and report execution time (ARM specific)
978 CONFIG_CMD_TIMER * access to the system tick timer
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500979 CONFIG_CMD_USB * USB support
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500980 CONFIG_CMD_CDP * Cisco Discover Protocol support
Marek Vasutc8339f52012-03-31 07:47:16 +0000981 CONFIG_CMD_MFSL * Microblaze FSL support
Vincent Stehlé4d98b5c2013-06-20 18:14:22 +0200982 CONFIG_CMD_XIMG Load part of Multi Image
wdenkc6097192002-11-03 00:24:07 +0000983
wdenkc6097192002-11-03 00:24:07 +0000984
985 EXAMPLE: If you want all functions except of network
986 support you can write:
987
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500988 #include "config_cmd_all.h"
989 #undef CONFIG_CMD_NET
wdenkc6097192002-11-03 00:24:07 +0000990
Gerald Van Baren213bf8c2007-03-31 12:23:51 -0400991 Other Commands:
992 fdt (flattened device tree) command: CONFIG_OF_LIBFDT
wdenkc6097192002-11-03 00:24:07 +0000993
994 Note: Don't enable the "icache" and "dcache" commands
Jon Loeliger602ad3b2007-06-11 19:03:39 -0500995 (configuration option CONFIG_CMD_CACHE) unless you know
wdenk43d96162003-03-06 00:02:04 +0000996 what you (and your U-Boot users) are doing. Data
997 cache cannot be enabled on systems like the 8xx or
998 8260 (where accesses to the IMMR region must be
999 uncached), and it cannot be disabled on all other
1000 systems where we (mis-) use the data cache to hold an
1001 initial stack and some data.
wdenkc6097192002-11-03 00:24:07 +00001002
1003
1004 XXX - this list needs to get updated!
1005
Wolfgang Denka5ecbe62013-03-23 23:50:31 +00001006- Regular expression support:
1007 CONFIG_REGEX
Wolfgang Denk93e14592013-10-04 17:43:24 +02001008 If this variable is defined, U-Boot is linked against
1009 the SLRE (Super Light Regular Expression) library,
1010 which adds regex support to some commands, as for
1011 example "env grep" and "setexpr".
Wolfgang Denka5ecbe62013-03-23 23:50:31 +00001012
Simon Glass45ba8072011-10-15 05:48:20 +00001013- Device tree:
1014 CONFIG_OF_CONTROL
1015 If this variable is defined, U-Boot will use a device tree
1016 to configure its devices, instead of relying on statically
1017 compiled #defines in the board file. This option is
1018 experimental and only available on a few boards. The device
1019 tree is available in the global data as gd->fdt_blob.
1020
Simon Glass2c0f79e2011-10-24 19:15:31 +00001021 U-Boot needs to get its device tree from somewhere. This can
1022 be done using one of the two options below:
Simon Glassbbb0b122011-10-15 05:48:21 +00001023
1024 CONFIG_OF_EMBED
1025 If this variable is defined, U-Boot will embed a device tree
1026 binary in its image. This device tree file should be in the
1027 board directory and called <soc>-<board>.dts. The binary file
1028 is then picked up in board_init_f() and made available through
1029 the global data structure as gd->blob.
Simon Glass45ba8072011-10-15 05:48:20 +00001030
Simon Glass2c0f79e2011-10-24 19:15:31 +00001031 CONFIG_OF_SEPARATE
1032 If this variable is defined, U-Boot will build a device tree
1033 binary. It will be called u-boot.dtb. Architecture-specific
1034 code will locate it at run-time. Generally this works by:
1035
1036 cat u-boot.bin u-boot.dtb >image.bin
1037
1038 and in fact, U-Boot does this for you, creating a file called
1039 u-boot-dtb.bin which is useful in the common case. You can
1040 still use the individual files if you need something more
1041 exotic.
1042
wdenkc6097192002-11-03 00:24:07 +00001043- Watchdog:
1044 CONFIG_WATCHDOG
1045 If this variable is defined, it enables watchdog
Detlev Zundel6abe6fb2011-04-27 05:25:59 +00001046 support for the SoC. There must be support in the SoC
1047 specific code for a watchdog. For the 8xx and 8260
1048 CPUs, the SIU Watchdog feature is enabled in the SYPCR
1049 register. When supported for a specific SoC is
1050 available, then no further board specific code should
1051 be needed to use it.
1052
1053 CONFIG_HW_WATCHDOG
1054 When using a watchdog circuitry external to the used
1055 SoC, then define this variable and provide board
1056 specific code for the "hw_watchdog_reset" function.
wdenkc6097192002-11-03 00:24:07 +00001057
stroesec1551ea2003-04-04 15:53:41 +00001058- U-Boot Version:
1059 CONFIG_VERSION_VARIABLE
1060 If this variable is defined, an environment variable
1061 named "ver" is created by U-Boot showing the U-Boot
1062 version as printed by the "version" command.
Benoît Thébaudeaua1ea8e52012-08-13 15:01:14 +02001063 Any change to this variable will be reverted at the
1064 next reset.
stroesec1551ea2003-04-04 15:53:41 +00001065
wdenkc6097192002-11-03 00:24:07 +00001066- Real-Time Clock:
1067
Jon Loeliger602ad3b2007-06-11 19:03:39 -05001068 When CONFIG_CMD_DATE is selected, the type of the RTC
wdenkc6097192002-11-03 00:24:07 +00001069 has to be selected, too. Define exactly one of the
1070 following options:
1071
1072 CONFIG_RTC_MPC8xx - use internal RTC of MPC8xx
1073 CONFIG_RTC_PCF8563 - use Philips PCF8563 RTC
Fabio Estevam4e8b7542011-10-24 06:44:15 +00001074 CONFIG_RTC_MC13XXX - use MC13783 or MC13892 RTC
wdenkc6097192002-11-03 00:24:07 +00001075 CONFIG_RTC_MC146818 - use MC146818 RTC
wdenk1cb8e982003-03-06 21:55:29 +00001076 CONFIG_RTC_DS1307 - use Maxim, Inc. DS1307 RTC
wdenkc6097192002-11-03 00:24:07 +00001077 CONFIG_RTC_DS1337 - use Maxim, Inc. DS1337 RTC
wdenk7f70e852003-05-20 14:25:27 +00001078 CONFIG_RTC_DS1338 - use Maxim, Inc. DS1338 RTC
wdenk3bac3512003-03-12 10:41:04 +00001079 CONFIG_RTC_DS164x - use Dallas DS164x RTC
Tor Krill9536dfc2008-03-15 15:40:26 +01001080 CONFIG_RTC_ISL1208 - use Intersil ISL1208 RTC
wdenk4c0d4c32004-06-09 17:34:58 +00001081 CONFIG_RTC_MAX6900 - use Maxim, Inc. MAX6900 RTC
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001082 CONFIG_SYS_RTC_DS1337_NOOSC - Turn off the OSC output for DS1337
Heiko Schocher71d19f32011-03-28 09:24:22 +02001083 CONFIG_SYS_RV3029_TCR - enable trickle charger on
1084 RV3029 RTC.
wdenkc6097192002-11-03 00:24:07 +00001085
wdenkb37c7e52003-06-30 16:24:52 +00001086 Note that if the RTC uses I2C, then the I2C interface
1087 must also be configured. See I2C Support, below.
1088
Peter Tysere92739d2008-12-17 16:36:21 -06001089- GPIO Support:
1090 CONFIG_PCA953X - use NXP's PCA953X series I2C GPIO
Peter Tysere92739d2008-12-17 16:36:21 -06001091
Chris Packham5dec49c2010-12-19 10:12:13 +00001092 The CONFIG_SYS_I2C_PCA953X_WIDTH option specifies a list of
1093 chip-ngpio pairs that tell the PCA953X driver the number of
1094 pins supported by a particular chip.
1095
Peter Tysere92739d2008-12-17 16:36:21 -06001096 Note that if the GPIO device uses I2C, then the I2C interface
1097 must also be configured. See I2C Support, below.
1098
wdenkc6097192002-11-03 00:24:07 +00001099- Timestamp Support:
1100
wdenk43d96162003-03-06 00:02:04 +00001101 When CONFIG_TIMESTAMP is selected, the timestamp
1102 (date and time) of an image is printed by image
1103 commands like bootm or iminfo. This option is
Jon Loeliger602ad3b2007-06-11 19:03:39 -05001104 automatically enabled when you select CONFIG_CMD_DATE .
wdenkc6097192002-11-03 00:24:07 +00001105
Karl O. Pinc923c46f2012-08-16 06:20:15 +00001106- Partition Labels (disklabels) Supported:
1107 Zero or more of the following:
1108 CONFIG_MAC_PARTITION Apple's MacOS partition table.
1109 CONFIG_DOS_PARTITION MS Dos partition table, traditional on the
1110 Intel architecture, USB sticks, etc.
1111 CONFIG_ISO_PARTITION ISO partition table, used on CDROM etc.
1112 CONFIG_EFI_PARTITION GPT partition table, common when EFI is the
1113 bootloader. Note 2TB partition limit; see
1114 disk/part_efi.c
1115 CONFIG_MTD_PARTITIONS Memory Technology Device partition table.
wdenkc6097192002-11-03 00:24:07 +00001116
Wolfgang Denk218ca722008-03-26 10:40:12 +01001117 If IDE or SCSI support is enabled (CONFIG_CMD_IDE or
1118 CONFIG_CMD_SCSI) you must configure support for at
Karl O. Pinc923c46f2012-08-16 06:20:15 +00001119 least one non-MTD partition type as well.
wdenkc6097192002-11-03 00:24:07 +00001120
1121- IDE Reset method:
wdenk4d13cba2004-03-14 14:09:05 +00001122 CONFIG_IDE_RESET_ROUTINE - this is defined in several
1123 board configurations files but used nowhere!
wdenkc6097192002-11-03 00:24:07 +00001124
wdenk4d13cba2004-03-14 14:09:05 +00001125 CONFIG_IDE_RESET - is this is defined, IDE Reset will
1126 be performed by calling the function
1127 ide_set_reset(int reset)
1128 which has to be defined in a board specific file
wdenkc6097192002-11-03 00:24:07 +00001129
1130- ATAPI Support:
1131 CONFIG_ATAPI
1132
1133 Set this to enable ATAPI support.
1134
wdenkc40b2952004-03-13 23:29:43 +00001135- LBA48 Support
1136 CONFIG_LBA48
1137
1138 Set this to enable support for disks larger than 137GB
Heiko Schocher4b142fe2009-12-03 11:21:21 +01001139 Also look at CONFIG_SYS_64BIT_LBA.
wdenkc40b2952004-03-13 23:29:43 +00001140 Whithout these , LBA48 support uses 32bit variables and will 'only'
1141 support disks up to 2.1TB.
1142
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001143 CONFIG_SYS_64BIT_LBA:
wdenkc40b2952004-03-13 23:29:43 +00001144 When enabled, makes the IDE subsystem use 64bit sector addresses.
1145 Default is 32bit.
1146
wdenkc6097192002-11-03 00:24:07 +00001147- SCSI Support:
1148 At the moment only there is only support for the
1149 SYM53C8XX SCSI controller; define
1150 CONFIG_SCSI_SYM53C8XX to enable it.
1151
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001152 CONFIG_SYS_SCSI_MAX_LUN [8], CONFIG_SYS_SCSI_MAX_SCSI_ID [7] and
1153 CONFIG_SYS_SCSI_MAX_DEVICE [CONFIG_SYS_SCSI_MAX_SCSI_ID *
1154 CONFIG_SYS_SCSI_MAX_LUN] can be adjusted to define the
wdenkc6097192002-11-03 00:24:07 +00001155 maximum numbers of LUNs, SCSI ID's and target
1156 devices.
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001157 CONFIG_SYS_SCSI_SYM53C8XX_CCF to fix clock timing (80Mhz)
wdenkc6097192002-11-03 00:24:07 +00001158
Wolfgang Denk93e14592013-10-04 17:43:24 +02001159 The environment variable 'scsidevs' is set to the number of
1160 SCSI devices found during the last scan.
Stefan Reinauer447c0312012-10-29 05:23:48 +00001161
wdenkc6097192002-11-03 00:24:07 +00001162- NETWORK Support (PCI):
wdenk682011f2003-06-03 23:54:09 +00001163 CONFIG_E1000
Kyle Moffettce5207e2011-10-18 11:05:29 +00001164 Support for Intel 8254x/8257x gigabit chips.
1165
1166 CONFIG_E1000_SPI
1167 Utility code for direct access to the SPI bus on Intel 8257x.
1168 This does not do anything useful unless you set at least one
1169 of CONFIG_CMD_E1000 or CONFIG_E1000_SPI_GENERIC.
1170
1171 CONFIG_E1000_SPI_GENERIC
1172 Allow generic access to the SPI bus on the Intel 8257x, for
1173 example with the "sspi" command.
1174
1175 CONFIG_CMD_E1000
1176 Management command for E1000 devices. When used on devices
1177 with SPI support you can reprogram the EEPROM from U-Boot.
stroese53cf9432003-06-05 15:39:44 +00001178
Andre Schwarzac3315c2008-03-06 16:45:44 +01001179 CONFIG_E1000_FALLBACK_MAC
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02001180 default MAC for empty EEPROM after production.
Andre Schwarzac3315c2008-03-06 16:45:44 +01001181
wdenkc6097192002-11-03 00:24:07 +00001182 CONFIG_EEPRO100
1183 Support for Intel 82557/82559/82559ER chips.
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02001184 Optional CONFIG_EEPRO100_SROM_WRITE enables EEPROM
wdenkc6097192002-11-03 00:24:07 +00001185 write routine for first time initialisation.
1186
1187 CONFIG_TULIP
1188 Support for Digital 2114x chips.
1189 Optional CONFIG_TULIP_SELECT_MEDIA for board specific
1190 modem chip initialisation (KS8761/QS6611).
1191
1192 CONFIG_NATSEMI
1193 Support for National dp83815 chips.
1194
1195 CONFIG_NS8382X
1196 Support for National dp8382[01] gigabit chips.
1197
wdenk45219c42003-05-12 21:50:16 +00001198- NETWORK Support (other):
1199
Jens Scharsigc041e9d2010-01-23 12:03:45 +01001200 CONFIG_DRIVER_AT91EMAC
1201 Support for AT91RM9200 EMAC.
1202
1203 CONFIG_RMII
1204 Define this to use reduced MII inteface
1205
1206 CONFIG_DRIVER_AT91EMAC_QUIET
1207 If this defined, the driver is quiet.
1208 The driver doen't show link status messages.
1209
Rob Herringefdd7312011-12-15 11:15:49 +00001210 CONFIG_CALXEDA_XGMAC
1211 Support for the Calxeda XGMAC device
1212
Ashok3bb46d22012-10-15 06:20:47 +00001213 CONFIG_LAN91C96
wdenk45219c42003-05-12 21:50:16 +00001214 Support for SMSC's LAN91C96 chips.
1215
1216 CONFIG_LAN91C96_BASE
1217 Define this to hold the physical address
1218 of the LAN91C96's I/O space
1219
1220 CONFIG_LAN91C96_USE_32_BIT
1221 Define this to enable 32 bit addressing
1222
Ashok3bb46d22012-10-15 06:20:47 +00001223 CONFIG_SMC91111
wdenkf39748a2004-06-09 13:37:52 +00001224 Support for SMSC's LAN91C111 chip
1225
1226 CONFIG_SMC91111_BASE
1227 Define this to hold the physical address
1228 of the device (I/O space)
1229
1230 CONFIG_SMC_USE_32_BIT
1231 Define this if data bus is 32 bits
1232
1233 CONFIG_SMC_USE_IOFUNCS
1234 Define this to use i/o functions instead of macros
1235 (some hardware wont work with macros)
1236
Heiko Schocherdc02bad2011-11-15 10:00:04 -05001237 CONFIG_DRIVER_TI_EMAC
1238 Support for davinci emac
1239
1240 CONFIG_SYS_DAVINCI_EMAC_PHY_COUNT
1241 Define this if you have more then 3 PHYs.
1242
Macpaul Linb3dbf4a52010-12-21 16:59:46 +08001243 CONFIG_FTGMAC100
1244 Support for Faraday's FTGMAC100 Gigabit SoC Ethernet
1245
1246 CONFIG_FTGMAC100_EGIGA
1247 Define this to use GE link update with gigabit PHY.
1248 Define this if FTGMAC100 is connected to gigabit PHY.
1249 If your system has 10/100 PHY only, it might not occur
1250 wrong behavior. Because PHY usually return timeout or
1251 useless data when polling gigabit status and gigabit
1252 control registers. This behavior won't affect the
1253 correctnessof 10/100 link speed update.
1254
Mike Rapoportc2fff332009-11-11 10:03:03 +02001255 CONFIG_SMC911X
Jens Gehrlein557b3772008-05-05 14:06:11 +02001256 Support for SMSC's LAN911x and LAN921x chips
1257
Mike Rapoportc2fff332009-11-11 10:03:03 +02001258 CONFIG_SMC911X_BASE
Jens Gehrlein557b3772008-05-05 14:06:11 +02001259 Define this to hold the physical address
1260 of the device (I/O space)
1261
Mike Rapoportc2fff332009-11-11 10:03:03 +02001262 CONFIG_SMC911X_32_BIT
Jens Gehrlein557b3772008-05-05 14:06:11 +02001263 Define this if data bus is 32 bits
1264
Mike Rapoportc2fff332009-11-11 10:03:03 +02001265 CONFIG_SMC911X_16_BIT
Jens Gehrlein557b3772008-05-05 14:06:11 +02001266 Define this if data bus is 16 bits. If your processor
1267 automatically converts one 32 bit word to two 16 bit
Mike Rapoportc2fff332009-11-11 10:03:03 +02001268 words you may also try CONFIG_SMC911X_32_BIT.
Jens Gehrlein557b3772008-05-05 14:06:11 +02001269
Yoshihiro Shimoda3d0075f2011-01-27 10:06:03 +09001270 CONFIG_SH_ETHER
1271 Support for Renesas on-chip Ethernet controller
1272
1273 CONFIG_SH_ETHER_USE_PORT
1274 Define the number of ports to be used
1275
1276 CONFIG_SH_ETHER_PHY_ADDR
1277 Define the ETH PHY's address
1278
Yoshihiro Shimoda68260aa2011-01-27 10:06:08 +09001279 CONFIG_SH_ETHER_CACHE_WRITEBACK
1280 If this option is set, the driver enables cache flush.
1281
Vadim Bendebury5e124722011-10-17 08:36:14 +00001282- TPM Support:
Che-liang Chiou90899cc2013-04-12 11:04:34 +00001283 CONFIG_TPM
1284 Support TPM devices.
1285
Tom Wai-Hong Tam1b393db2013-04-12 11:04:37 +00001286 CONFIG_TPM_TIS_I2C
1287 Support for i2c bus TPM devices. Only one device
1288 per system is supported at this time.
1289
1290 CONFIG_TPM_TIS_I2C_BUS_NUMBER
1291 Define the the i2c bus number for the TPM device
1292
1293 CONFIG_TPM_TIS_I2C_SLAVE_ADDRESS
1294 Define the TPM's address on the i2c bus
1295
1296 CONFIG_TPM_TIS_I2C_BURST_LIMITATION
1297 Define the burst count bytes upper limit
1298
Dirk Eibachc01939c2013-06-26 15:55:15 +02001299 CONFIG_TPM_ATMEL_TWI
1300 Support for Atmel TWI TPM device. Requires I2C support.
1301
Che-liang Chiou90899cc2013-04-12 11:04:34 +00001302 CONFIG_TPM_TIS_LPC
Vadim Bendebury5e124722011-10-17 08:36:14 +00001303 Support for generic parallel port TPM devices. Only one device
1304 per system is supported at this time.
1305
1306 CONFIG_TPM_TIS_BASE_ADDRESS
1307 Base address where the generic TPM device is mapped
1308 to. Contemporary x86 systems usually map it at
1309 0xfed40000.
1310
Reinhard Pfaube6c1522013-06-26 15:55:13 +02001311 CONFIG_CMD_TPM
1312 Add tpm monitor functions.
1313 Requires CONFIG_TPM. If CONFIG_TPM_AUTH_SESSIONS is set, also
1314 provides monitor access to authorized functions.
1315
1316 CONFIG_TPM
1317 Define this to enable the TPM support library which provides
1318 functional interfaces to some TPM commands.
1319 Requires support for a TPM device.
1320
1321 CONFIG_TPM_AUTH_SESSIONS
1322 Define this to enable authorized functions in the TPM library.
1323 Requires CONFIG_TPM and CONFIG_SHA1.
1324
wdenkc6097192002-11-03 00:24:07 +00001325- USB Support:
1326 At the moment only the UHCI host controller is
wdenk4d13cba2004-03-14 14:09:05 +00001327 supported (PIP405, MIP405, MPC5200); define
wdenkc6097192002-11-03 00:24:07 +00001328 CONFIG_USB_UHCI to enable it.
1329 define CONFIG_USB_KEYBOARD to enable the USB Keyboard
wdenk30d56fa2004-10-09 22:44:59 +00001330 and define CONFIG_USB_STORAGE to enable the USB
wdenkc6097192002-11-03 00:24:07 +00001331 storage devices.
1332 Note:
1333 Supported are USB Keyboards and USB Floppy drives
1334 (TEAC FD-05PUB).
wdenk4d13cba2004-03-14 14:09:05 +00001335 MPC5200 USB requires additional defines:
1336 CONFIG_USB_CLOCK
1337 for 528 MHz Clock: 0x0001bbbb
Eric Millbrandt307ecb62009-08-13 08:32:37 -05001338 CONFIG_PSC3_USB
1339 for USB on PSC3
wdenk4d13cba2004-03-14 14:09:05 +00001340 CONFIG_USB_CONFIG
1341 for differential drivers: 0x00001000
1342 for single ended drivers: 0x00005000
Eric Millbrandt307ecb62009-08-13 08:32:37 -05001343 for differential drivers on PSC3: 0x00000100
1344 for single ended drivers on PSC3: 0x00004100
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001345 CONFIG_SYS_USB_EVENT_POLL
Zhang Weifdcfaa12007-06-06 10:08:13 +02001346 May be defined to allow interrupt polling
1347 instead of using asynchronous interrupts
wdenk4d13cba2004-03-14 14:09:05 +00001348
Simon Glass9ab4ce22012-02-27 10:52:47 +00001349 CONFIG_USB_EHCI_TXFIFO_THRESH enables setting of the
1350 txfilltuning field in the EHCI controller on reset.
1351
Kuo-Jung Suaa155052013-05-15 15:29:22 +08001352 CONFIG_USB_HUB_MIN_POWER_ON_DELAY defines the minimum
1353 interval for usb hub power-on delay.(minimum 100msec)
1354
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001355- USB Device:
1356 Define the below if you wish to use the USB console.
1357 Once firmware is rebuilt from a serial console issue the
1358 command "setenv stdin usbtty; setenv stdout usbtty" and
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02001359 attach your USB cable. The Unix command "dmesg" should print
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001360 it has found a new device. The environment variable usbtty
1361 can be set to gserial or cdc_acm to enable your device to
Wolfgang Denk386eda02006-06-14 18:14:56 +02001362 appear to a USB host as a Linux gserial device or a
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001363 Common Device Class Abstract Control Model serial device.
1364 If you select usbtty = gserial you should be able to enumerate
1365 a Linux host by
1366 # modprobe usbserial vendor=0xVendorID product=0xProductID
1367 else if using cdc_acm, simply setting the environment
1368 variable usbtty to be cdc_acm should suffice. The following
1369 might be defined in YourBoardName.h
Wolfgang Denk386eda02006-06-14 18:14:56 +02001370
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001371 CONFIG_USB_DEVICE
1372 Define this to build a UDC device
wdenkc6097192002-11-03 00:24:07 +00001373
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001374 CONFIG_USB_TTY
1375 Define this to have a tty type of device available to
1376 talk to the UDC device
Wolfgang Denk386eda02006-06-14 18:14:56 +02001377
Vipin KUMARf9da0f82012-03-26 15:38:06 +05301378 CONFIG_USBD_HS
1379 Define this to enable the high speed support for usb
1380 device and usbtty. If this feature is enabled, a routine
1381 int is_usbd_high_speed(void)
1382 also needs to be defined by the driver to dynamically poll
1383 whether the enumeration has succeded at high speed or full
1384 speed.
1385
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001386 CONFIG_SYS_CONSOLE_IS_IN_ENV
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001387 Define this if you want stdin, stdout &/or stderr to
1388 be set to usbtty.
1389
1390 mpc8xx:
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001391 CONFIG_SYS_USB_EXTC_CLK 0xBLAH
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001392 Derive USB clock from external clock "blah"
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001393 - CONFIG_SYS_USB_EXTC_CLK 0x02
Wolfgang Denk386eda02006-06-14 18:14:56 +02001394
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001395 CONFIG_SYS_USB_BRG_CLK 0xBLAH
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001396 Derive USB clock from brgclk
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001397 - CONFIG_SYS_USB_BRG_CLK 0x04
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001398
Wolfgang Denk386eda02006-06-14 18:14:56 +02001399 If you have a USB-IF assigned VendorID then you may wish to
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001400 define your own vendor specific values either in BoardName.h
Wolfgang Denk386eda02006-06-14 18:14:56 +02001401 or directly in usbd_vendor_info.h. If you don't define
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001402 CONFIG_USBD_MANUFACTURER, CONFIG_USBD_PRODUCT_NAME,
1403 CONFIG_USBD_VENDORID and CONFIG_USBD_PRODUCTID, then U-Boot
1404 should pretend to be a Linux device to it's target host.
1405
1406 CONFIG_USBD_MANUFACTURER
1407 Define this string as the name of your company for
1408 - CONFIG_USBD_MANUFACTURER "my company"
Wolfgang Denk386eda02006-06-14 18:14:56 +02001409
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001410 CONFIG_USBD_PRODUCT_NAME
1411 Define this string as the name of your product
1412 - CONFIG_USBD_PRODUCT_NAME "acme usb device"
1413
1414 CONFIG_USBD_VENDORID
1415 Define this as your assigned Vendor ID from the USB
1416 Implementors Forum. This *must* be a genuine Vendor ID
1417 to avoid polluting the USB namespace.
1418 - CONFIG_USBD_VENDORID 0xFFFF
Wolfgang Denk386eda02006-06-14 18:14:56 +02001419
Wolfgang Denk16c8d5e2006-06-14 17:45:53 +02001420 CONFIG_USBD_PRODUCTID
1421 Define this as the unique Product ID
1422 for your device
1423 - CONFIG_USBD_PRODUCTID 0xFFFF
wdenkc6097192002-11-03 00:24:07 +00001424
Przemyslaw Marczak351e9b22013-10-23 14:30:46 +02001425 Some USB device drivers may need to check USB cable attachment.
1426 In this case you can enable following config in BoardName.h:
1427 CONFIG_USB_CABLE_CHECK
1428 This enables function definition:
1429 - usb_cable_connected() in include/usb.h
1430 Implementation of this function is board-specific.
1431
Igor Grinbergd70a5602011-12-12 12:08:35 +02001432- ULPI Layer Support:
1433 The ULPI (UTMI Low Pin (count) Interface) PHYs are supported via
1434 the generic ULPI layer. The generic layer accesses the ULPI PHY
1435 via the platform viewport, so you need both the genric layer and
1436 the viewport enabled. Currently only Chipidea/ARC based
1437 viewport is supported.
1438 To enable the ULPI layer support, define CONFIG_USB_ULPI and
1439 CONFIG_USB_ULPI_VIEWPORT in your board configuration file.
Lucas Stach6d365ea2012-10-01 00:44:35 +02001440 If your ULPI phy needs a different reference clock than the
1441 standard 24 MHz then you have to define CONFIG_ULPI_REF_CLK to
1442 the appropriate value in Hz.
wdenkc6097192002-11-03 00:24:07 +00001443
1444- MMC Support:
1445 The MMC controller on the Intel PXA is supported. To
1446 enable this define CONFIG_MMC. The MMC can be
1447 accessed from the boot prompt by mapping the device
1448 to physical memory similar to flash. Command line is
Jon Loeliger602ad3b2007-06-11 19:03:39 -05001449 enabled with CONFIG_CMD_MMC. The MMC driver also works with
1450 the FAT fs. This is enabled with CONFIG_CMD_FAT.
wdenkc6097192002-11-03 00:24:07 +00001451
Yoshihiro Shimodaafb35662011-07-04 22:21:22 +00001452 CONFIG_SH_MMCIF
1453 Support for Renesas on-chip MMCIF controller
1454
1455 CONFIG_SH_MMCIF_ADDR
1456 Define the base address of MMCIF registers
1457
1458 CONFIG_SH_MMCIF_CLK
1459 Define the clock frequency for MMCIF
1460
Tom Rinib3ba6e92013-03-14 05:32:47 +00001461- USB Device Firmware Update (DFU) class support:
1462 CONFIG_DFU_FUNCTION
1463 This enables the USB portion of the DFU USB class
1464
1465 CONFIG_CMD_DFU
1466 This enables the command "dfu" which is used to have
1467 U-Boot create a DFU class device via USB. This command
1468 requires that the "dfu_alt_info" environment variable be
1469 set and define the alt settings to expose to the host.
1470
1471 CONFIG_DFU_MMC
1472 This enables support for exposing (e)MMC devices via DFU.
1473
Pantelis Antoniouc6631762013-03-14 05:32:52 +00001474 CONFIG_DFU_NAND
1475 This enables support for exposing NAND devices via DFU.
1476
Afzal Mohammeda9479f02013-09-18 01:15:24 +05301477 CONFIG_DFU_RAM
1478 This enables support for exposing RAM via DFU.
1479 Note: DFU spec refer to non-volatile memory usage, but
1480 allow usages beyond the scope of spec - here RAM usage,
1481 one that would help mostly the developer.
1482
Heiko Schochere7e75c72013-06-12 06:05:51 +02001483 CONFIG_SYS_DFU_DATA_BUF_SIZE
1484 Dfu transfer uses a buffer before writing data to the
1485 raw storage device. Make the size (in bytes) of this buffer
1486 configurable. The size of this buffer is also configurable
1487 through the "dfu_bufsiz" environment variable.
1488
Pantelis Antoniouea2453d2013-03-14 05:32:48 +00001489 CONFIG_SYS_DFU_MAX_FILE_SIZE
1490 When updating files rather than the raw storage device,
1491 we use a static buffer to copy the file into and then write
1492 the buffer once we've been given the whole file. Define
1493 this to the maximum filesize (in bytes) for the buffer.
1494 Default is 4 MiB if undefined.
1495
wdenk6705d812004-08-02 23:22:59 +00001496- Journaling Flash filesystem support:
1497 CONFIG_JFFS2_NAND, CONFIG_JFFS2_NAND_OFF, CONFIG_JFFS2_NAND_SIZE,
1498 CONFIG_JFFS2_NAND_DEV
1499 Define these for a default partition on a NAND device
1500
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001501 CONFIG_SYS_JFFS2_FIRST_SECTOR,
1502 CONFIG_SYS_JFFS2_FIRST_BANK, CONFIG_SYS_JFFS2_NUM_BANKS
wdenk6705d812004-08-02 23:22:59 +00001503 Define these for a default partition on a NOR device
1504
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001505 CONFIG_SYS_JFFS_CUSTOM_PART
wdenk6705d812004-08-02 23:22:59 +00001506 Define this to create an own partition. You have to provide a
1507 function struct part_info* jffs2_part_info(int part_num)
1508
1509 If you define only one JFFS2 partition you may also want to
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001510 #define CONFIG_SYS_JFFS_SINGLE_PART 1
wdenk6705d812004-08-02 23:22:59 +00001511 to disable the command chpart. This is the default when you
1512 have not defined a custom partition
1513
Donggeun Kimc30a15e2011-10-24 21:15:28 +00001514- FAT(File Allocation Table) filesystem write function support:
1515 CONFIG_FAT_WRITE
Donggeun Kim656f4c62012-03-22 04:38:56 +00001516
1517 Define this to enable support for saving memory data as a
1518 file in FAT formatted partition.
1519
1520 This will also enable the command "fatwrite" enabling the
1521 user to write files to FAT.
Donggeun Kimc30a15e2011-10-24 21:15:28 +00001522
Gabe Black84cd9322012-10-12 14:26:11 +00001523CBFS (Coreboot Filesystem) support
1524 CONFIG_CMD_CBFS
1525
1526 Define this to enable support for reading from a Coreboot
1527 filesystem. Available commands are cbfsinit, cbfsinfo, cbfsls
1528 and cbfsload.
1529
wdenkc6097192002-11-03 00:24:07 +00001530- Keyboard Support:
1531 CONFIG_ISA_KEYBOARD
1532
1533 Define this to enable standard (PC-Style) keyboard
1534 support
1535
1536 CONFIG_I8042_KBD
1537 Standard PC keyboard driver with US (is default) and
1538 GERMAN key layout (switch via environment 'keymap=de') support.
1539 Export function i8042_kbd_init, i8042_tstc and i8042_getc
1540 for cfb_console. Supports cursor blinking.
1541
Hung-ying Tyan713cb682013-05-15 18:27:32 +08001542 CONFIG_CROS_EC_KEYB
1543 Enables a Chrome OS keyboard using the CROS_EC interface.
1544 This uses CROS_EC to communicate with a second microcontroller
1545 which provides key scans on request.
1546
wdenkc6097192002-11-03 00:24:07 +00001547- Video support:
1548 CONFIG_VIDEO
1549
1550 Define this to enable video support (for output to
1551 video).
1552
1553 CONFIG_VIDEO_CT69000
1554
1555 Enable Chips & Technologies 69000 Video chip
1556
1557 CONFIG_VIDEO_SMI_LYNXEM
wdenkb79a11c2004-03-25 15:14:43 +00001558 Enable Silicon Motion SMI 712/710/810 Video chip. The
wdenkeeb1b772004-03-23 22:53:55 +00001559 video output is selected via environment 'videoout'
1560 (1 = LCD and 2 = CRT). If videoout is undefined, CRT is
1561 assumed.
wdenkc6097192002-11-03 00:24:07 +00001562
wdenkb79a11c2004-03-25 15:14:43 +00001563 For the CT69000 and SMI_LYNXEM drivers, videomode is
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02001564 selected via environment 'videomode'. Two different ways
wdenkeeb1b772004-03-23 22:53:55 +00001565 are possible:
1566 - "videomode=num" 'num' is a standard LiLo mode numbers.
wdenk6e592382004-04-18 17:39:38 +00001567 Following standard modes are supported (* is default):
wdenkeeb1b772004-03-23 22:53:55 +00001568
1569 Colors 640x480 800x600 1024x768 1152x864 1280x1024
1570 -------------+---------------------------------------------
1571 8 bits | 0x301* 0x303 0x305 0x161 0x307
1572 15 bits | 0x310 0x313 0x316 0x162 0x319
1573 16 bits | 0x311 0x314 0x317 0x163 0x31A
1574 24 bits | 0x312 0x315 0x318 ? 0x31B
1575 -------------+---------------------------------------------
wdenkc6097192002-11-03 00:24:07 +00001576 (i.e. setenv videomode 317; saveenv; reset;)
1577
wdenkb79a11c2004-03-25 15:14:43 +00001578 - "videomode=bootargs" all the video parameters are parsed
Marcel Ziswiler7817cb22007-12-30 03:30:46 +01001579 from the bootargs. (See drivers/video/videomodes.c)
wdenkeeb1b772004-03-23 22:53:55 +00001580
1581
stroesec1551ea2003-04-04 15:53:41 +00001582 CONFIG_VIDEO_SED13806
wdenk43d96162003-03-06 00:02:04 +00001583 Enable Epson SED13806 driver. This driver supports 8bpp
wdenka6c7ad22002-12-03 21:28:10 +00001584 and 16bpp modes defined by CONFIG_VIDEO_SED13806_8BPP
1585 or CONFIG_VIDEO_SED13806_16BPP
1586
Timur Tabi7d3053f2011-02-15 17:09:19 -06001587 CONFIG_FSL_DIU_FB
Wolfgang Denk04e5ae72011-09-11 21:24:09 +02001588 Enable the Freescale DIU video driver. Reference boards for
Timur Tabi7d3053f2011-02-15 17:09:19 -06001589 SOCs that have a DIU should define this macro to enable DIU
1590 support, and should also define these other macros:
1591
1592 CONFIG_SYS_DIU_ADDR
1593 CONFIG_VIDEO
1594 CONFIG_CMD_BMP
1595 CONFIG_CFB_CONSOLE
1596 CONFIG_VIDEO_SW_CURSOR
1597 CONFIG_VGA_AS_SINGLE_DEVICE
1598 CONFIG_VIDEO_LOGO
1599 CONFIG_VIDEO_BMP_LOGO
1600
Timur Tabiba8e76b2011-04-11 14:18:22 -05001601 The DIU driver will look for the 'video-mode' environment
1602 variable, and if defined, enable the DIU as a console during
1603 boot. See the documentation file README.video for a
1604 description of this variable.
Timur Tabi7d3053f2011-02-15 17:09:19 -06001605
Simon Glass058d59b2012-12-03 13:59:47 +00001606 CONFIG_VIDEO_VGA
1607
1608 Enable the VGA video / BIOS for x86. The alternative if you
1609 are using coreboot is to use the coreboot frame buffer
1610 driver.
1611
1612
wdenk682011f2003-06-03 23:54:09 +00001613- Keyboard Support:
wdenk8bde7f72003-06-27 21:31:46 +00001614 CONFIG_KEYBOARD
wdenk682011f2003-06-03 23:54:09 +00001615
wdenk8bde7f72003-06-27 21:31:46 +00001616 Define this to enable a custom keyboard support.
1617 This simply calls drv_keyboard_init() which must be
1618 defined in your board-specific files.
1619 The only board using this so far is RBC823.
wdenka6c7ad22002-12-03 21:28:10 +00001620
wdenkc6097192002-11-03 00:24:07 +00001621- LCD Support: CONFIG_LCD
1622
1623 Define this to enable LCD support (for output to LCD
1624 display); also select one of the supported displays
1625 by defining one of these:
1626
Stelian Pop39cf4802008-05-09 21:57:18 +02001627 CONFIG_ATMEL_LCD:
1628
1629 HITACHI TX09D70VM1CCA, 3.5", 240x320.
1630
wdenkfd3103b2003-11-25 16:55:19 +00001631 CONFIG_NEC_NL6448AC33:
wdenkc6097192002-11-03 00:24:07 +00001632
wdenkfd3103b2003-11-25 16:55:19 +00001633 NEC NL6448AC33-18. Active, color, single scan.
wdenkc6097192002-11-03 00:24:07 +00001634
wdenkfd3103b2003-11-25 16:55:19 +00001635 CONFIG_NEC_NL6448BC20
wdenkc6097192002-11-03 00:24:07 +00001636
wdenkfd3103b2003-11-25 16:55:19 +00001637 NEC NL6448BC20-08. 6.5", 640x480.
1638 Active, color, single scan.
1639
1640 CONFIG_NEC_NL6448BC33_54
1641
1642 NEC NL6448BC33-54. 10.4", 640x480.
wdenkc6097192002-11-03 00:24:07 +00001643 Active, color, single scan.
1644
1645 CONFIG_SHARP_16x9
1646
1647 Sharp 320x240. Active, color, single scan.
1648 It isn't 16x9, and I am not sure what it is.
1649
1650 CONFIG_SHARP_LQ64D341
1651
1652 Sharp LQ64D341 display, 640x480.
1653 Active, color, single scan.
1654
1655 CONFIG_HLD1045
1656
1657 HLD1045 display, 640x480.
1658 Active, color, single scan.
1659
1660 CONFIG_OPTREX_BW
1661
1662 Optrex CBL50840-2 NF-FW 99 22 M5
1663 or
1664 Hitachi LMG6912RPFC-00T
1665 or
1666 Hitachi SP14Q002
1667
1668 320x240. Black & white.
1669
1670 Normally display is black on white background; define
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001671 CONFIG_SYS_WHITE_ON_BLACK to get it inverted.
wdenkc6097192002-11-03 00:24:07 +00001672
Simon Glass676d3192012-10-17 13:24:54 +00001673 CONFIG_LCD_ALIGNMENT
1674
1675 Normally the LCD is page-aligned (tyically 4KB). If this is
1676 defined then the LCD will be aligned to this value instead.
1677 For ARM it is sometimes useful to use MMU_SECTION_SIZE
1678 here, since it is cheaper to change data cache settings on
1679 a per-section basis.
1680
Simon Glass0d89efe2012-10-17 13:24:59 +00001681 CONFIG_CONSOLE_SCROLL_LINES
1682
1683 When the console need to be scrolled, this is the number of
1684 lines to scroll by. It defaults to 1. Increasing this makes
1685 the console jump but can help speed up operation when scrolling
1686 is slow.
Simon Glass676d3192012-10-17 13:24:54 +00001687
Tom Wai-Hong Tam45d7f522012-09-28 15:11:16 +00001688 CONFIG_LCD_BMP_RLE8
1689
1690 Support drawing of RLE8-compressed bitmaps on the LCD.
1691
Tom Wai-Hong Tam735987c2012-12-05 14:46:40 +00001692 CONFIG_I2C_EDID
1693
1694 Enables an 'i2c edid' command which can read EDID
1695 information over I2C from an attached LCD display.
1696
wdenk7152b1d2003-09-05 23:19:14 +00001697- Splash Screen Support: CONFIG_SPLASH_SCREEN
wdenkd791b1d2003-04-20 14:04:18 +00001698
wdenk8bde7f72003-06-27 21:31:46 +00001699 If this option is set, the environment is checked for
1700 a variable "splashimage". If found, the usual display
1701 of logo, copyright and system information on the LCD
wdenke94d2cd2004-06-30 22:59:18 +00001702 is suppressed and the BMP image at the address
wdenk8bde7f72003-06-27 21:31:46 +00001703 specified in "splashimage" is loaded instead. The
1704 console is redirected to the "nulldev", too. This
1705 allows for a "silent" boot where a splash screen is
1706 loaded very quickly after power-on.
wdenkd791b1d2003-04-20 14:04:18 +00001707
Nikita Kiryanovc0880482013-02-24 21:28:43 +00001708 CONFIG_SPLASHIMAGE_GUARD
1709
1710 If this option is set, then U-Boot will prevent the environment
1711 variable "splashimage" from being set to a problematic address
1712 (see README.displaying-bmps and README.arm-unaligned-accesses).
1713 This option is useful for targets where, due to alignment
1714 restrictions, an improperly aligned BMP image will cause a data
1715 abort. If you think you will not have problems with unaligned
1716 accesses (for example because your toolchain prevents them)
1717 there is no need to set this option.
1718
Matthias Weisser1ca298c2009-07-09 16:07:30 +02001719 CONFIG_SPLASH_SCREEN_ALIGN
1720
1721 If this option is set the splash image can be freely positioned
1722 on the screen. Environment variable "splashpos" specifies the
1723 position as "x,y". If a positive number is given it is used as
1724 number of pixel from left/top. If a negative number is given it
1725 is used as number of pixel from right/bottom. You can also
1726 specify 'm' for centering the image.
1727
1728 Example:
1729 setenv splashpos m,m
1730 => image at center of screen
1731
1732 setenv splashpos 30,20
1733 => image at x = 30 and y = 20
1734
1735 setenv splashpos -10,m
1736 => vertically centered image
1737 at x = dspWidth - bmpWidth - 9
1738
Stefan Roese98f4a3d2005-09-22 09:04:17 +02001739- Gzip compressed BMP image support: CONFIG_VIDEO_BMP_GZIP
1740
1741 If this option is set, additionally to standard BMP
1742 images, gzipped BMP images can be displayed via the
1743 splashscreen support or the bmp command.
1744
Anatolij Gustschind5011762010-03-15 14:50:25 +01001745- Run length encoded BMP image (RLE8) support: CONFIG_VIDEO_BMP_RLE8
1746
1747 If this option is set, 8-bit RLE compressed BMP images
1748 can be displayed via the splashscreen support or the
1749 bmp command.
1750
Lei Wenf2b96df2012-09-28 04:26:47 +00001751- Do compresssing for memory range:
1752 CONFIG_CMD_ZIP
1753
1754 If this option is set, it would use zlib deflate method
1755 to compress the specified memory at its best effort.
1756
wdenkc29fdfc2003-08-29 20:57:53 +00001757- Compression support:
Kees Cook8ef70472013-08-16 07:59:12 -07001758 CONFIG_GZIP
1759
1760 Enabled by default to support gzip compressed images.
1761
wdenkc29fdfc2003-08-29 20:57:53 +00001762 CONFIG_BZIP2
1763
1764 If this option is set, support for bzip2 compressed
1765 images is included. If not, only uncompressed and gzip
1766 compressed images are supported.
1767
wdenk42d1f032003-10-15 23:53:47 +00001768 NOTE: the bzip2 algorithm requires a lot of RAM, so
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001769 the malloc area (as defined by CONFIG_SYS_MALLOC_LEN) should
wdenk42d1f032003-10-15 23:53:47 +00001770 be at least 4MB.
wdenkd791b1d2003-04-20 14:04:18 +00001771
Luigi 'Comio' Mantellinifc9c1722008-09-08 02:46:13 +02001772 CONFIG_LZMA
1773
1774 If this option is set, support for lzma compressed
1775 images is included.
1776
1777 Note: The LZMA algorithm adds between 2 and 4KB of code and it
1778 requires an amount of dynamic memory that is given by the
1779 formula:
1780
1781 (1846 + 768 << (lc + lp)) * sizeof(uint16)
1782
1783 Where lc and lp stand for, respectively, Literal context bits
1784 and Literal pos bits.
1785
1786 This value is upper-bounded by 14MB in the worst case. Anyway,
1787 for a ~4MB large kernel image, we have lc=3 and lp=0 for a
1788 total amount of (1846 + 768 << (3 + 0)) * 2 = ~41KB... that is
1789 a very small buffer.
1790
1791 Use the lzmainfo tool to determinate the lc and lp values and
1792 then calculate the amount of needed dynamic memory (ensuring
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02001793 the appropriate CONFIG_SYS_MALLOC_LEN value).
Luigi 'Comio' Mantellinifc9c1722008-09-08 02:46:13 +02001794
Kees Cook8ef70472013-08-16 07:59:12 -07001795 CONFIG_LZO
1796
1797 If this option is set, support for LZO compressed images
1798 is included.
1799
wdenk17ea1172004-06-06 21:51:03 +00001800- MII/PHY support:
1801 CONFIG_PHY_ADDR
1802
1803 The address of PHY on MII bus.
1804
1805 CONFIG_PHY_CLOCK_FREQ (ppc4xx)
1806
1807 The clock frequency of the MII bus
1808
1809 CONFIG_PHY_GIGE
1810
1811 If this option is set, support for speed/duplex
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02001812 detection of gigabit PHY is included.
wdenk17ea1172004-06-06 21:51:03 +00001813
1814 CONFIG_PHY_RESET_DELAY
1815
1816 Some PHY like Intel LXT971A need extra delay after
1817 reset before any MII register access is possible.
1818 For such PHY, set this option to the usec delay
1819 required. (minimum 300usec for LXT971A)
1820
1821 CONFIG_PHY_CMD_DELAY (ppc4xx)
1822
1823 Some PHY like Intel LXT971A need extra delay after
1824 command issued before MII status register can be read
1825
wdenkc6097192002-11-03 00:24:07 +00001826- Ethernet address:
1827 CONFIG_ETHADDR
richardretanubunc68a05f2008-09-29 18:28:23 -04001828 CONFIG_ETH1ADDR
wdenkc6097192002-11-03 00:24:07 +00001829 CONFIG_ETH2ADDR
1830 CONFIG_ETH3ADDR
richardretanubunc68a05f2008-09-29 18:28:23 -04001831 CONFIG_ETH4ADDR
1832 CONFIG_ETH5ADDR
wdenkc6097192002-11-03 00:24:07 +00001833
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02001834 Define a default value for Ethernet address to use
1835 for the respective Ethernet interface, in case this
wdenkc6097192002-11-03 00:24:07 +00001836 is not determined automatically.
1837
1838- IP address:
1839 CONFIG_IPADDR
1840
1841 Define a default value for the IP address to use for
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02001842 the default Ethernet interface, in case this is not
wdenkc6097192002-11-03 00:24:07 +00001843 determined through e.g. bootp.
Wolfgang Denk1ebcd652011-10-26 10:21:22 +00001844 (Environment variable "ipaddr")
wdenkc6097192002-11-03 00:24:07 +00001845
1846- Server IP address:
1847 CONFIG_SERVERIP
1848
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02001849 Defines a default value for the IP address of a TFTP
wdenkc6097192002-11-03 00:24:07 +00001850 server to contact when using the "tftboot" command.
Wolfgang Denk1ebcd652011-10-26 10:21:22 +00001851 (Environment variable "serverip")
wdenkc6097192002-11-03 00:24:07 +00001852
Robin Getz97cfe862009-07-21 12:15:28 -04001853 CONFIG_KEEP_SERVERADDR
1854
1855 Keeps the server's MAC address, in the env 'serveraddr'
1856 for passing to bootargs (like Linux's netconsole option)
1857
Wolfgang Denk1ebcd652011-10-26 10:21:22 +00001858- Gateway IP address:
1859 CONFIG_GATEWAYIP
1860
1861 Defines a default value for the IP address of the
1862 default router where packets to other networks are
1863 sent to.
1864 (Environment variable "gatewayip")
1865
1866- Subnet mask:
1867 CONFIG_NETMASK
1868
1869 Defines a default value for the subnet mask (or
1870 routing prefix) which is used to determine if an IP
1871 address belongs to the local subnet or needs to be
1872 forwarded through a router.
1873 (Environment variable "netmask")
1874
David Updegraff53a5c422007-06-11 10:41:07 -05001875- Multicast TFTP Mode:
1876 CONFIG_MCAST_TFTP
1877
1878 Defines whether you want to support multicast TFTP as per
1879 rfc-2090; for example to work with atftp. Lets lots of targets
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02001880 tftp down the same boot image concurrently. Note: the Ethernet
David Updegraff53a5c422007-06-11 10:41:07 -05001881 driver in use must provide a function: mcast() to join/leave a
1882 multicast group.
1883
wdenkc6097192002-11-03 00:24:07 +00001884- BOOTP Recovery Mode:
1885 CONFIG_BOOTP_RANDOM_DELAY
1886
1887 If you have many targets in a network that try to
1888 boot using BOOTP, you may want to avoid that all
1889 systems send out BOOTP requests at precisely the same
1890 moment (which would happen for instance at recovery
1891 from a power failure, when all systems will try to
1892 boot, thus flooding the BOOTP server. Defining
1893 CONFIG_BOOTP_RANDOM_DELAY causes a random delay to be
1894 inserted before sending out BOOTP requests. The
Wolfgang Denk6c33c782007-08-06 23:21:05 +02001895 following delays are inserted then:
wdenkc6097192002-11-03 00:24:07 +00001896
1897 1st BOOTP request: delay 0 ... 1 sec
1898 2nd BOOTP request: delay 0 ... 2 sec
1899 3rd BOOTP request: delay 0 ... 4 sec
1900 4th and following
1901 BOOTP requests: delay 0 ... 8 sec
1902
stroesefe389a82003-08-28 14:17:32 +00001903- DHCP Advanced Options:
Jon Loeliger1fe80d72007-07-09 22:08:34 -05001904 You can fine tune the DHCP functionality by defining
1905 CONFIG_BOOTP_* symbols:
stroesefe389a82003-08-28 14:17:32 +00001906
Jon Loeliger1fe80d72007-07-09 22:08:34 -05001907 CONFIG_BOOTP_SUBNETMASK
1908 CONFIG_BOOTP_GATEWAY
1909 CONFIG_BOOTP_HOSTNAME
1910 CONFIG_BOOTP_NISDOMAIN
1911 CONFIG_BOOTP_BOOTPATH
1912 CONFIG_BOOTP_BOOTFILESIZE
1913 CONFIG_BOOTP_DNS
1914 CONFIG_BOOTP_DNS2
1915 CONFIG_BOOTP_SEND_HOSTNAME
1916 CONFIG_BOOTP_NTPSERVER
1917 CONFIG_BOOTP_TIMEOFFSET
1918 CONFIG_BOOTP_VENDOREX
Joe Hershberger2c00e092012-05-23 07:59:19 +00001919 CONFIG_BOOTP_MAY_FAIL
stroesefe389a82003-08-28 14:17:32 +00001920
Wilson Callan5d110f02007-07-28 10:56:13 -04001921 CONFIG_BOOTP_SERVERIP - TFTP server will be the serverip
1922 environment variable, not the BOOTP server.
stroesefe389a82003-08-28 14:17:32 +00001923
Joe Hershberger2c00e092012-05-23 07:59:19 +00001924 CONFIG_BOOTP_MAY_FAIL - If the DHCP server is not found
1925 after the configured retry count, the call will fail
1926 instead of starting over. This can be used to fail over
1927 to Link-local IP address configuration if the DHCP server
1928 is not available.
1929
stroesefe389a82003-08-28 14:17:32 +00001930 CONFIG_BOOTP_DNS2 - If a DHCP client requests the DNS
1931 serverip from a DHCP server, it is possible that more
1932 than one DNS serverip is offered to the client.
1933 If CONFIG_BOOTP_DNS2 is enabled, the secondary DNS
1934 serverip will be stored in the additional environment
1935 variable "dnsip2". The first DNS serverip is always
1936 stored in the variable "dnsip", when CONFIG_BOOTP_DNS
Jon Loeliger1fe80d72007-07-09 22:08:34 -05001937 is defined.
stroesefe389a82003-08-28 14:17:32 +00001938
1939 CONFIG_BOOTP_SEND_HOSTNAME - Some DHCP servers are capable
1940 to do a dynamic update of a DNS server. To do this, they
1941 need the hostname of the DHCP requester.
Wilson Callan5d110f02007-07-28 10:56:13 -04001942 If CONFIG_BOOTP_SEND_HOSTNAME is defined, the content
Jon Loeliger1fe80d72007-07-09 22:08:34 -05001943 of the "hostname" environment variable is passed as
1944 option 12 to the DHCP server.
stroesefe389a82003-08-28 14:17:32 +00001945
Aras Vaichasd9a2f412008-03-26 09:43:57 +11001946 CONFIG_BOOTP_DHCP_REQUEST_DELAY
1947
1948 A 32bit value in microseconds for a delay between
1949 receiving a "DHCP Offer" and sending the "DHCP Request".
1950 This fixes a problem with certain DHCP servers that don't
1951 respond 100% of the time to a "DHCP request". E.g. On an
1952 AT91RM9200 processor running at 180MHz, this delay needed
1953 to be *at least* 15,000 usec before a Windows Server 2003
1954 DHCP server would reply 100% of the time. I recommend at
1955 least 50,000 usec to be safe. The alternative is to hope
1956 that one of the retries will be successful but note that
1957 the DHCP timeout and retry process takes a longer than
1958 this delay.
1959
Joe Hershbergerd22c3382012-05-23 08:00:12 +00001960 - Link-local IP address negotiation:
1961 Negotiate with other link-local clients on the local network
1962 for an address that doesn't require explicit configuration.
1963 This is especially useful if a DHCP server cannot be guaranteed
1964 to exist in all environments that the device must operate.
1965
1966 See doc/README.link-local for more information.
1967
wdenka3d991b2004-04-15 21:48:45 +00001968 - CDP Options:
wdenk6e592382004-04-18 17:39:38 +00001969 CONFIG_CDP_DEVICE_ID
wdenka3d991b2004-04-15 21:48:45 +00001970
1971 The device id used in CDP trigger frames.
1972
1973 CONFIG_CDP_DEVICE_ID_PREFIX
1974
1975 A two character string which is prefixed to the MAC address
1976 of the device.
1977
1978 CONFIG_CDP_PORT_ID
1979
1980 A printf format string which contains the ascii name of
1981 the port. Normally is set to "eth%d" which sets
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02001982 eth0 for the first Ethernet, eth1 for the second etc.
wdenka3d991b2004-04-15 21:48:45 +00001983
1984 CONFIG_CDP_CAPABILITIES
1985
1986 A 32bit integer which indicates the device capabilities;
1987 0x00000010 for a normal host which does not forwards.
1988
1989 CONFIG_CDP_VERSION
1990
1991 An ascii string containing the version of the software.
1992
1993 CONFIG_CDP_PLATFORM
1994
1995 An ascii string containing the name of the platform.
1996
1997 CONFIG_CDP_TRIGGER
1998
1999 A 32bit integer sent on the trigger.
2000
2001 CONFIG_CDP_POWER_CONSUMPTION
2002
2003 A 16bit integer containing the power consumption of the
2004 device in .1 of milliwatts.
2005
2006 CONFIG_CDP_APPLIANCE_VLAN_TYPE
2007
2008 A byte containing the id of the VLAN.
2009
wdenkc6097192002-11-03 00:24:07 +00002010- Status LED: CONFIG_STATUS_LED
2011
2012 Several configurations allow to display the current
2013 status using a LED. For instance, the LED will blink
2014 fast while running U-Boot code, stop blinking as
2015 soon as a reply to a BOOTP request was received, and
2016 start blinking slow once the Linux kernel is running
2017 (supported by a status LED driver in the Linux
2018 kernel). Defining CONFIG_STATUS_LED enables this
2019 feature in U-Boot.
2020
Igor Grinberg1df7bbb2013-11-08 01:03:50 +02002021 Additional options:
2022
2023 CONFIG_GPIO_LED
2024 The status LED can be connected to a GPIO pin.
2025 In such cases, the gpio_led driver can be used as a
2026 status LED backend implementation. Define CONFIG_GPIO_LED
2027 to include the gpio_led driver in the U-Boot binary.
2028
Igor Grinberg9dfdcdf2013-11-08 01:03:52 +02002029 CONFIG_GPIO_LED_INVERTED_TABLE
2030 Some GPIO connected LEDs may have inverted polarity in which
2031 case the GPIO high value corresponds to LED off state and
2032 GPIO low value corresponds to LED on state.
2033 In such cases CONFIG_GPIO_LED_INVERTED_TABLE may be defined
2034 with a list of GPIO LEDs that have inverted polarity.
2035
wdenkc6097192002-11-03 00:24:07 +00002036- CAN Support: CONFIG_CAN_DRIVER
2037
2038 Defining CONFIG_CAN_DRIVER enables CAN driver support
2039 on those systems that support this (optional)
2040 feature, like the TQM8xxL modules.
2041
Heiko Schocher3f4978c2012-01-16 21:12:24 +00002042- I2C Support: CONFIG_SYS_I2C
wdenkc6097192002-11-03 00:24:07 +00002043
Heiko Schocher3f4978c2012-01-16 21:12:24 +00002044 This enable the NEW i2c subsystem, and will allow you to use
2045 i2c commands at the u-boot command line (as long as you set
2046 CONFIG_CMD_I2C in CONFIG_COMMANDS) and communicate with i2c
2047 based realtime clock chips or other i2c devices. See
2048 common/cmd_i2c.c for a description of the command line
2049 interface.
2050
2051 ported i2c driver to the new framework:
Heiko Schocherea818db2013-01-29 08:53:15 +01002052 - drivers/i2c/soft_i2c.c:
2053 - activate first bus with CONFIG_SYS_I2C_SOFT define
2054 CONFIG_SYS_I2C_SOFT_SPEED and CONFIG_SYS_I2C_SOFT_SLAVE
2055 for defining speed and slave address
2056 - activate second bus with I2C_SOFT_DECLARATIONS2 define
2057 CONFIG_SYS_I2C_SOFT_SPEED_2 and CONFIG_SYS_I2C_SOFT_SLAVE_2
2058 for defining speed and slave address
2059 - activate third bus with I2C_SOFT_DECLARATIONS3 define
2060 CONFIG_SYS_I2C_SOFT_SPEED_3 and CONFIG_SYS_I2C_SOFT_SLAVE_3
2061 for defining speed and slave address
2062 - activate fourth bus with I2C_SOFT_DECLARATIONS4 define
2063 CONFIG_SYS_I2C_SOFT_SPEED_4 and CONFIG_SYS_I2C_SOFT_SLAVE_4
2064 for defining speed and slave address
Heiko Schocher3f4978c2012-01-16 21:12:24 +00002065
Heiko Schocher00f792e2012-10-24 13:48:22 +02002066 - drivers/i2c/fsl_i2c.c:
2067 - activate i2c driver with CONFIG_SYS_I2C_FSL
2068 define CONFIG_SYS_FSL_I2C_OFFSET for setting the register
2069 offset CONFIG_SYS_FSL_I2C_SPEED for the i2c speed and
2070 CONFIG_SYS_FSL_I2C_SLAVE for the slave addr of the first
2071 bus.
Wolfgang Denk93e14592013-10-04 17:43:24 +02002072 - If your board supports a second fsl i2c bus, define
Heiko Schocher00f792e2012-10-24 13:48:22 +02002073 CONFIG_SYS_FSL_I2C2_OFFSET for the register offset
2074 CONFIG_SYS_FSL_I2C2_SPEED for the speed and
2075 CONFIG_SYS_FSL_I2C2_SLAVE for the slave address of the
2076 second bus.
2077
Simon Glass1f2ba722012-10-30 07:28:53 +00002078 - drivers/i2c/tegra_i2c.c:
Nobuhiro Iwamatsu10cee512013-10-11 16:23:53 +09002079 - activate this driver with CONFIG_SYS_I2C_TEGRA
2080 - This driver adds 4 i2c buses with a fix speed from
2081 100000 and the slave addr 0!
Simon Glass1f2ba722012-10-30 07:28:53 +00002082
Dirk Eibach880540d2013-04-25 02:40:01 +00002083 - drivers/i2c/ppc4xx_i2c.c
2084 - activate this driver with CONFIG_SYS_I2C_PPC4XX
2085 - CONFIG_SYS_I2C_PPC4XX_CH0 activate hardware channel 0
2086 - CONFIG_SYS_I2C_PPC4XX_CH1 activate hardware channel 1
2087
tremfac96402013-09-21 18:13:35 +02002088 - drivers/i2c/i2c_mxc.c
2089 - activate this driver with CONFIG_SYS_I2C_MXC
2090 - define speed for bus 1 with CONFIG_SYS_MXC_I2C1_SPEED
2091 - define slave for bus 1 with CONFIG_SYS_MXC_I2C1_SLAVE
2092 - define speed for bus 2 with CONFIG_SYS_MXC_I2C2_SPEED
2093 - define slave for bus 2 with CONFIG_SYS_MXC_I2C2_SLAVE
2094 - define speed for bus 3 with CONFIG_SYS_MXC_I2C3_SPEED
2095 - define slave for bus 3 with CONFIG_SYS_MXC_I2C3_SLAVE
2096 If thoses defines are not set, default value is 100000
2097 for speed, and 0 for slave.
2098
Nobuhiro Iwamatsu1086bfa2013-09-27 16:58:30 +09002099 - drivers/i2c/rcar_i2c.c:
2100 - activate this driver with CONFIG_SYS_I2C_RCAR
2101 - This driver adds 4 i2c buses
2102
2103 - CONFIG_SYS_RCAR_I2C0_BASE for setting the register channel 0
2104 - CONFIG_SYS_RCAR_I2C0_SPEED for for the speed channel 0
2105 - CONFIG_SYS_RCAR_I2C1_BASE for setting the register channel 1
2106 - CONFIG_SYS_RCAR_I2C1_SPEED for for the speed channel 1
2107 - CONFIG_SYS_RCAR_I2C2_BASE for setting the register channel 2
2108 - CONFIG_SYS_RCAR_I2C2_SPEED for for the speed channel 2
2109 - CONFIG_SYS_RCAR_I2C3_BASE for setting the register channel 3
2110 - CONFIG_SYS_RCAR_I2C3_SPEED for for the speed channel 3
2111 - CONFIF_SYS_RCAR_I2C_NUM_CONTROLLERS for number of i2c buses
2112
Nobuhiro Iwamatsu2035d772013-10-29 13:33:51 +09002113 - drivers/i2c/sh_i2c.c:
2114 - activate this driver with CONFIG_SYS_I2C_SH
2115 - This driver adds from 2 to 5 i2c buses
2116
2117 - CONFIG_SYS_I2C_SH_BASE0 for setting the register channel 0
2118 - CONFIG_SYS_I2C_SH_SPEED0 for for the speed channel 0
2119 - CONFIG_SYS_I2C_SH_BASE1 for setting the register channel 1
2120 - CONFIG_SYS_I2C_SH_SPEED1 for for the speed channel 1
2121 - CONFIG_SYS_I2C_SH_BASE2 for setting the register channel 2
2122 - CONFIG_SYS_I2C_SH_SPEED2 for for the speed channel 2
2123 - CONFIG_SYS_I2C_SH_BASE3 for setting the register channel 3
2124 - CONFIG_SYS_I2C_SH_SPEED3 for for the speed channel 3
2125 - CONFIG_SYS_I2C_SH_BASE4 for setting the register channel 4
2126 - CONFIG_SYS_I2C_SH_SPEED4 for for the speed channel 4
2127 - CONFIG_SYS_I2C_SH_BASE5 for setting the register channel 5
2128 - CONFIG_SYS_I2C_SH_SPEED5 for for the speed channel 5
2129 - CONFIF_SYS_I2C_SH_NUM_CONTROLLERS for nummber of i2c buses
2130
Heiko Schocher6789e842013-10-22 11:03:18 +02002131 - drivers/i2c/omap24xx_i2c.c
2132 - activate this driver with CONFIG_SYS_I2C_OMAP24XX
2133 - CONFIG_SYS_OMAP24_I2C_SPEED speed channel 0
2134 - CONFIG_SYS_OMAP24_I2C_SLAVE slave addr channel 0
2135 - CONFIG_SYS_OMAP24_I2C_SPEED1 speed channel 1
2136 - CONFIG_SYS_OMAP24_I2C_SLAVE1 slave addr channel 1
2137 - CONFIG_SYS_OMAP24_I2C_SPEED2 speed channel 2
2138 - CONFIG_SYS_OMAP24_I2C_SLAVE2 slave addr channel 2
2139 - CONFIG_SYS_OMAP24_I2C_SPEED3 speed channel 3
2140 - CONFIG_SYS_OMAP24_I2C_SLAVE3 slave addr channel 3
2141 - CONFIG_SYS_OMAP24_I2C_SPEED4 speed channel 4
2142 - CONFIG_SYS_OMAP24_I2C_SLAVE4 slave addr channel 4
2143
Heiko Schocher0bdffe72013-11-08 07:30:53 +01002144 - drivers/i2c/zynq_i2c.c
2145 - activate this driver with CONFIG_SYS_I2C_ZYNQ
2146 - set CONFIG_SYS_I2C_ZYNQ_SPEED for speed setting
2147 - set CONFIG_SYS_I2C_ZYNQ_SLAVE for slave addr
2148
Naveen Krishna Che717fc62013-12-06 12:12:38 +05302149 - drivers/i2c/s3c24x0_i2c.c:
2150 - activate this driver with CONFIG_SYS_I2C_S3C24X0
2151 - This driver adds i2c buses (11 for Exynos5250, Exynos5420
2152 9 i2c buses for Exynos4 and 1 for S3C24X0 SoCs from Samsung)
2153 with a fix speed from 100000 and the slave addr 0!
2154
Heiko Schocher3f4978c2012-01-16 21:12:24 +00002155 additional defines:
2156
2157 CONFIG_SYS_NUM_I2C_BUSES
2158 Hold the number of i2c busses you want to use. If you
2159 don't use/have i2c muxes on your i2c bus, this
2160 is equal to CONFIG_SYS_NUM_I2C_ADAPTERS, and you can
2161 omit this define.
2162
2163 CONFIG_SYS_I2C_DIRECT_BUS
2164 define this, if you don't use i2c muxes on your hardware.
2165 if CONFIG_SYS_I2C_MAX_HOPS is not defined or == 0 you can
2166 omit this define.
2167
2168 CONFIG_SYS_I2C_MAX_HOPS
2169 define how many muxes are maximal consecutively connected
2170 on one i2c bus. If you not use i2c muxes, omit this
2171 define.
2172
2173 CONFIG_SYS_I2C_BUSES
2174 hold a list of busses you want to use, only used if
2175 CONFIG_SYS_I2C_DIRECT_BUS is not defined, for example
2176 a board with CONFIG_SYS_I2C_MAX_HOPS = 1 and
2177 CONFIG_SYS_NUM_I2C_BUSES = 9:
2178
2179 CONFIG_SYS_I2C_BUSES {{0, {I2C_NULL_HOP}}, \
2180 {0, {{I2C_MUX_PCA9547, 0x70, 1}}}, \
2181 {0, {{I2C_MUX_PCA9547, 0x70, 2}}}, \
2182 {0, {{I2C_MUX_PCA9547, 0x70, 3}}}, \
2183 {0, {{I2C_MUX_PCA9547, 0x70, 4}}}, \
2184 {0, {{I2C_MUX_PCA9547, 0x70, 5}}}, \
2185 {1, {I2C_NULL_HOP}}, \
2186 {1, {{I2C_MUX_PCA9544, 0x72, 1}}}, \
2187 {1, {{I2C_MUX_PCA9544, 0x72, 2}}}, \
2188 }
2189
2190 which defines
2191 bus 0 on adapter 0 without a mux
Heiko Schocherea818db2013-01-29 08:53:15 +01002192 bus 1 on adapter 0 with a PCA9547 on address 0x70 port 1
2193 bus 2 on adapter 0 with a PCA9547 on address 0x70 port 2
2194 bus 3 on adapter 0 with a PCA9547 on address 0x70 port 3
2195 bus 4 on adapter 0 with a PCA9547 on address 0x70 port 4
2196 bus 5 on adapter 0 with a PCA9547 on address 0x70 port 5
Heiko Schocher3f4978c2012-01-16 21:12:24 +00002197 bus 6 on adapter 1 without a mux
Heiko Schocherea818db2013-01-29 08:53:15 +01002198 bus 7 on adapter 1 with a PCA9544 on address 0x72 port 1
2199 bus 8 on adapter 1 with a PCA9544 on address 0x72 port 2
Heiko Schocher3f4978c2012-01-16 21:12:24 +00002200
2201 If you do not have i2c muxes on your board, omit this define.
2202
Heiko Schocherea818db2013-01-29 08:53:15 +01002203- Legacy I2C Support: CONFIG_HARD_I2C
Heiko Schocher3f4978c2012-01-16 21:12:24 +00002204
2205 NOTE: It is intended to move drivers to CONFIG_SYS_I2C which
2206 provides the following compelling advantages:
2207
2208 - more than one i2c adapter is usable
2209 - approved multibus support
2210 - better i2c mux support
2211
2212 ** Please consider updating your I2C driver now. **
2213
Heiko Schocherea818db2013-01-29 08:53:15 +01002214 These enable legacy I2C serial bus commands. Defining
2215 CONFIG_HARD_I2C will include the appropriate I2C driver
2216 for the selected CPU.
wdenkc6097192002-11-03 00:24:07 +00002217
wdenk945af8d2003-07-16 21:53:01 +00002218 This will allow you to use i2c commands at the u-boot
Jon Loeliger602ad3b2007-06-11 19:03:39 -05002219 command line (as long as you set CONFIG_CMD_I2C in
wdenkb37c7e52003-06-30 16:24:52 +00002220 CONFIG_COMMANDS) and communicate with i2c based realtime
2221 clock chips. See common/cmd_i2c.c for a description of the
wdenk43d96162003-03-06 00:02:04 +00002222 command line interface.
wdenkc6097192002-11-03 00:24:07 +00002223
Ben Warrenbb99ad62006-09-07 16:50:54 -04002224 CONFIG_HARD_I2C selects a hardware I2C controller.
wdenkc6097192002-11-03 00:24:07 +00002225
wdenk945af8d2003-07-16 21:53:01 +00002226 There are several other quantities that must also be
Heiko Schocherea818db2013-01-29 08:53:15 +01002227 defined when you define CONFIG_HARD_I2C.
wdenkc6097192002-11-03 00:24:07 +00002228
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002229 In both cases you will need to define CONFIG_SYS_I2C_SPEED
wdenk945af8d2003-07-16 21:53:01 +00002230 to be the frequency (in Hz) at which you wish your i2c bus
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002231 to run and CONFIG_SYS_I2C_SLAVE to be the address of this node (ie
Marcel Ziswiler11ccc332008-07-09 08:17:15 +02002232 the CPU's i2c node address).
wdenk945af8d2003-07-16 21:53:01 +00002233
Peter Tyser8d321b82010-04-12 22:28:21 -05002234 Now, the u-boot i2c code for the mpc8xx
Stefan Roesea47a12b2010-04-15 16:07:28 +02002235 (arch/powerpc/cpu/mpc8xx/i2c.c) sets the CPU up as a master node
Peter Tyser8d321b82010-04-12 22:28:21 -05002236 and so its address should therefore be cleared to 0 (See,
2237 eg, MPC823e User's Manual p.16-473). So, set
2238 CONFIG_SYS_I2C_SLAVE to 0.
wdenkc6097192002-11-03 00:24:07 +00002239
Eric Millbrandt5da71ef2009-09-03 08:09:44 -05002240 CONFIG_SYS_I2C_INIT_MPC5XXX
2241
2242 When a board is reset during an i2c bus transfer
2243 chips might think that the current transfer is still
2244 in progress. Reset the slave devices by sending start
2245 commands until the slave device responds.
2246
wdenk945af8d2003-07-16 21:53:01 +00002247 That's all that's required for CONFIG_HARD_I2C.
wdenkb37c7e52003-06-30 16:24:52 +00002248
Heiko Schocherea818db2013-01-29 08:53:15 +01002249 If you use the software i2c interface (CONFIG_SYS_I2C_SOFT)
wdenkb37c7e52003-06-30 16:24:52 +00002250 then the following macros need to be defined (examples are
2251 from include/configs/lwmon.h):
wdenkc6097192002-11-03 00:24:07 +00002252
2253 I2C_INIT
2254
wdenkb37c7e52003-06-30 16:24:52 +00002255 (Optional). Any commands necessary to enable the I2C
wdenk43d96162003-03-06 00:02:04 +00002256 controller or configure ports.
wdenkc6097192002-11-03 00:24:07 +00002257
wdenkba56f622004-02-06 23:19:44 +00002258 eg: #define I2C_INIT (immr->im_cpm.cp_pbdir |= PB_SCL)
wdenkb37c7e52003-06-30 16:24:52 +00002259
wdenkc6097192002-11-03 00:24:07 +00002260 I2C_PORT
2261
wdenk43d96162003-03-06 00:02:04 +00002262 (Only for MPC8260 CPU). The I/O port to use (the code
2263 assumes both bits are on the same port). Valid values
2264 are 0..3 for ports A..D.
wdenkc6097192002-11-03 00:24:07 +00002265
2266 I2C_ACTIVE
2267
2268 The code necessary to make the I2C data line active
2269 (driven). If the data line is open collector, this
2270 define can be null.
2271
wdenkb37c7e52003-06-30 16:24:52 +00002272 eg: #define I2C_ACTIVE (immr->im_cpm.cp_pbdir |= PB_SDA)
2273
wdenkc6097192002-11-03 00:24:07 +00002274 I2C_TRISTATE
2275
2276 The code necessary to make the I2C data line tri-stated
2277 (inactive). If the data line is open collector, this
2278 define can be null.
2279
wdenkb37c7e52003-06-30 16:24:52 +00002280 eg: #define I2C_TRISTATE (immr->im_cpm.cp_pbdir &= ~PB_SDA)
2281
wdenkc6097192002-11-03 00:24:07 +00002282 I2C_READ
2283
York Sun472d5462013-04-01 11:29:11 -07002284 Code that returns true if the I2C data line is high,
2285 false if it is low.
wdenkc6097192002-11-03 00:24:07 +00002286
wdenkb37c7e52003-06-30 16:24:52 +00002287 eg: #define I2C_READ ((immr->im_cpm.cp_pbdat & PB_SDA) != 0)
2288
wdenkc6097192002-11-03 00:24:07 +00002289 I2C_SDA(bit)
2290
York Sun472d5462013-04-01 11:29:11 -07002291 If <bit> is true, sets the I2C data line high. If it
2292 is false, it clears it (low).
wdenkc6097192002-11-03 00:24:07 +00002293
wdenkb37c7e52003-06-30 16:24:52 +00002294 eg: #define I2C_SDA(bit) \
wdenk2535d602003-07-17 23:16:40 +00002295 if(bit) immr->im_cpm.cp_pbdat |= PB_SDA; \
wdenkba56f622004-02-06 23:19:44 +00002296 else immr->im_cpm.cp_pbdat &= ~PB_SDA
wdenkb37c7e52003-06-30 16:24:52 +00002297
wdenkc6097192002-11-03 00:24:07 +00002298 I2C_SCL(bit)
2299
York Sun472d5462013-04-01 11:29:11 -07002300 If <bit> is true, sets the I2C clock line high. If it
2301 is false, it clears it (low).
wdenkc6097192002-11-03 00:24:07 +00002302
wdenkb37c7e52003-06-30 16:24:52 +00002303 eg: #define I2C_SCL(bit) \
wdenk2535d602003-07-17 23:16:40 +00002304 if(bit) immr->im_cpm.cp_pbdat |= PB_SCL; \
wdenkba56f622004-02-06 23:19:44 +00002305 else immr->im_cpm.cp_pbdat &= ~PB_SCL
wdenkb37c7e52003-06-30 16:24:52 +00002306
wdenkc6097192002-11-03 00:24:07 +00002307 I2C_DELAY
2308
2309 This delay is invoked four times per clock cycle so this
2310 controls the rate of data transfer. The data rate thus
wdenkb37c7e52003-06-30 16:24:52 +00002311 is 1 / (I2C_DELAY * 4). Often defined to be something
wdenk945af8d2003-07-16 21:53:01 +00002312 like:
2313
wdenkb37c7e52003-06-30 16:24:52 +00002314 #define I2C_DELAY udelay(2)
wdenkc6097192002-11-03 00:24:07 +00002315
Mike Frysinger793b5722010-07-21 13:38:02 -04002316 CONFIG_SOFT_I2C_GPIO_SCL / CONFIG_SOFT_I2C_GPIO_SDA
2317
2318 If your arch supports the generic GPIO framework (asm/gpio.h),
2319 then you may alternatively define the two GPIOs that are to be
2320 used as SCL / SDA. Any of the previous I2C_xxx macros will
2321 have GPIO-based defaults assigned to them as appropriate.
2322
2323 You should define these to the GPIO value as given directly to
2324 the generic GPIO functions.
2325
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002326 CONFIG_SYS_I2C_INIT_BOARD
wdenk47cd00f2003-03-06 13:39:27 +00002327
wdenk8bde7f72003-06-27 21:31:46 +00002328 When a board is reset during an i2c bus transfer
2329 chips might think that the current transfer is still
2330 in progress. On some boards it is possible to access
2331 the i2c SCLK line directly, either by using the
2332 processor pin as a GPIO or by having a second pin
2333 connected to the bus. If this option is defined a
2334 custom i2c_init_board() routine in boards/xxx/board.c
2335 is run early in the boot sequence.
wdenk47cd00f2003-03-06 13:39:27 +00002336
Richard Retanubun26a33502010-04-12 15:08:17 -04002337 CONFIG_SYS_I2C_BOARD_LATE_INIT
2338
2339 An alternative to CONFIG_SYS_I2C_INIT_BOARD. If this option is
2340 defined a custom i2c_board_late_init() routine in
2341 boards/xxx/board.c is run AFTER the operations in i2c_init()
2342 is completed. This callpoint can be used to unreset i2c bus
2343 using CPU i2c controller register accesses for CPUs whose i2c
2344 controller provide such a method. It is called at the end of
2345 i2c_init() to allow i2c_init operations to setup the i2c bus
2346 controller on the CPU (e.g. setting bus speed & slave address).
2347
wdenk17ea1172004-06-06 21:51:03 +00002348 CONFIG_I2CFAST (PPC405GP|PPC405EP only)
2349
2350 This option enables configuration of bi_iic_fast[] flags
2351 in u-boot bd_info structure based on u-boot environment
2352 variable "i2cfast". (see also i2cfast)
2353
Ben Warrenbb99ad62006-09-07 16:50:54 -04002354 CONFIG_I2C_MULTI_BUS
2355
2356 This option allows the use of multiple I2C buses, each of which
Wolfgang Denkc0f40852011-10-26 10:21:21 +00002357 must have a controller. At any point in time, only one bus is
2358 active. To switch to a different bus, use the 'i2c dev' command.
Ben Warrenbb99ad62006-09-07 16:50:54 -04002359 Note that bus numbering is zero-based.
2360
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002361 CONFIG_SYS_I2C_NOPROBES
Ben Warrenbb99ad62006-09-07 16:50:54 -04002362
2363 This option specifies a list of I2C devices that will be skipped
Wolfgang Denkc0f40852011-10-26 10:21:21 +00002364 when the 'i2c probe' command is issued. If CONFIG_I2C_MULTI_BUS
Peter Tyser0f89c542009-04-18 22:34:03 -05002365 is set, specify a list of bus-device pairs. Otherwise, specify
2366 a 1D array of device addresses
Ben Warrenbb99ad62006-09-07 16:50:54 -04002367
2368 e.g.
2369 #undef CONFIG_I2C_MULTI_BUS
Wolfgang Denkc0f40852011-10-26 10:21:21 +00002370 #define CONFIG_SYS_I2C_NOPROBES {0x50,0x68}
Ben Warrenbb99ad62006-09-07 16:50:54 -04002371
2372 will skip addresses 0x50 and 0x68 on a board with one I2C bus
2373
Wolfgang Denkc0f40852011-10-26 10:21:21 +00002374 #define CONFIG_I2C_MULTI_BUS
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002375 #define CONFIG_SYS_I2C_MULTI_NOPROBES {{0,0x50},{0,0x68},{1,0x54}}
Ben Warrenbb99ad62006-09-07 16:50:54 -04002376
2377 will skip addresses 0x50 and 0x68 on bus 0 and address 0x54 on bus 1
2378
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002379 CONFIG_SYS_SPD_BUS_NUM
Timur Tabibe5e6182006-11-03 19:15:00 -06002380
2381 If defined, then this indicates the I2C bus number for DDR SPD.
2382 If not defined, then U-Boot assumes that SPD is on I2C bus 0.
2383
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002384 CONFIG_SYS_RTC_BUS_NUM
Stefan Roese0dc018e2007-02-20 10:51:26 +01002385
2386 If defined, then this indicates the I2C bus number for the RTC.
2387 If not defined, then U-Boot assumes that RTC is on I2C bus 0.
2388
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002389 CONFIG_SYS_DTT_BUS_NUM
Stefan Roese0dc018e2007-02-20 10:51:26 +01002390
2391 If defined, then this indicates the I2C bus number for the DTT.
2392 If not defined, then U-Boot assumes that DTT is on I2C bus 0.
2393
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002394 CONFIG_SYS_I2C_DTT_ADDR:
Victor Gallardo9ebbb542008-09-09 15:13:29 -07002395
2396 If defined, specifies the I2C address of the DTT device.
2397 If not defined, then U-Boot uses predefined value for
2398 specified DTT device.
2399
Andrew Dyer2ac69852008-12-29 17:36:01 -06002400 CONFIG_SOFT_I2C_READ_REPEATED_START
2401
2402 defining this will force the i2c_read() function in
2403 the soft_i2c driver to perform an I2C repeated start
2404 between writing the address pointer and reading the
2405 data. If this define is omitted the default behaviour
2406 of doing a stop-start sequence will be used. Most I2C
2407 devices can use either method, but some require one or
2408 the other.
Timur Tabibe5e6182006-11-03 19:15:00 -06002409
wdenkc6097192002-11-03 00:24:07 +00002410- SPI Support: CONFIG_SPI
2411
2412 Enables SPI driver (so far only tested with
2413 SPI EEPROM, also an instance works with Crystal A/D and
2414 D/As on the SACSng board)
2415
Yoshihiro Shimoda66395622011-01-31 16:50:43 +09002416 CONFIG_SH_SPI
2417
2418 Enables the driver for SPI controller on SuperH. Currently
2419 only SH7757 is supported.
2420
wdenkc6097192002-11-03 00:24:07 +00002421 CONFIG_SPI_X
2422
2423 Enables extended (16-bit) SPI EEPROM addressing.
2424 (symmetrical to CONFIG_I2C_X)
2425
2426 CONFIG_SOFT_SPI
2427
wdenk43d96162003-03-06 00:02:04 +00002428 Enables a software (bit-bang) SPI driver rather than
2429 using hardware support. This is a general purpose
2430 driver that only requires three general I/O port pins
2431 (two outputs, one input) to function. If this is
2432 defined, the board configuration must define several
2433 SPI configuration items (port pins to use, etc). For
2434 an example, see include/configs/sacsng.h.
wdenkc6097192002-11-03 00:24:07 +00002435
Ben Warren04a9e112008-01-16 22:37:35 -05002436 CONFIG_HARD_SPI
2437
2438 Enables a hardware SPI driver for general-purpose reads
2439 and writes. As with CONFIG_SOFT_SPI, the board configuration
2440 must define a list of chip-select function pointers.
Wolfgang Denkc0f40852011-10-26 10:21:21 +00002441 Currently supported on some MPC8xxx processors. For an
Ben Warren04a9e112008-01-16 22:37:35 -05002442 example, see include/configs/mpc8349emds.h.
2443
Guennadi Liakhovetski38254f42008-04-15 14:14:25 +02002444 CONFIG_MXC_SPI
2445
2446 Enables the driver for the SPI controllers on i.MX and MXC
Fabio Estevam2e3cd1c2011-10-28 08:57:46 +00002447 SoCs. Currently i.MX31/35/51 are supported.
Guennadi Liakhovetski38254f42008-04-15 14:14:25 +02002448
Matthias Fuchs01335022007-12-27 17:12:34 +01002449- FPGA Support: CONFIG_FPGA
2450
2451 Enables FPGA subsystem.
2452
2453 CONFIG_FPGA_<vendor>
2454
2455 Enables support for specific chip vendors.
2456 (ALTERA, XILINX)
2457
2458 CONFIG_FPGA_<family>
2459
2460 Enables support for FPGA family.
2461 (SPARTAN2, SPARTAN3, VIRTEX2, CYCLONE2, ACEX1K, ACEX)
2462
2463 CONFIG_FPGA_COUNT
wdenkc6097192002-11-03 00:24:07 +00002464
wdenk43d96162003-03-06 00:02:04 +00002465 Specify the number of FPGA devices to support.
wdenkc6097192002-11-03 00:24:07 +00002466
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002467 CONFIG_SYS_FPGA_PROG_FEEDBACK
wdenkc6097192002-11-03 00:24:07 +00002468
wdenk8bde7f72003-06-27 21:31:46 +00002469 Enable printing of hash marks during FPGA configuration.
wdenkc6097192002-11-03 00:24:07 +00002470
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002471 CONFIG_SYS_FPGA_CHECK_BUSY
wdenkc6097192002-11-03 00:24:07 +00002472
wdenk43d96162003-03-06 00:02:04 +00002473 Enable checks on FPGA configuration interface busy
2474 status by the configuration function. This option
2475 will require a board or device specific function to
2476 be written.
wdenkc6097192002-11-03 00:24:07 +00002477
2478 CONFIG_FPGA_DELAY
2479
2480 If defined, a function that provides delays in the FPGA
2481 configuration driver.
2482
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002483 CONFIG_SYS_FPGA_CHECK_CTRLC
wdenkc6097192002-11-03 00:24:07 +00002484 Allow Control-C to interrupt FPGA configuration
2485
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +02002486 CONFIG_SYS_FPGA_CHECK_ERROR
wdenkc6097192002-11-03 00:24:07 +00002487