]> Git Repo - J-u-boot.git/blobdiff - README
xpl: Rename spl_phase() to xpl_phase()
[J-u-boot.git] / README
diff --git a/README b/README
index 9cc0c981c43ce0441e0db45b3cb5add3f979f640..c7ee06a21dd5c600f9e9bd8a9e005179df3f7e2d 100644 (file)
--- a/README
+++ b/README
@@ -286,13 +286,6 @@ The following options need to be configured:
                same as CFG_SYS_DDR_SDRAM_BASE for  all Power SoCs. But
                it could be different for ARM SoCs.
 
-- MIPS CPU options:
-               CONFIG_XWAY_SWAP_BYTES
-
-               Enable compilation of tools/xway-swap-bytes needed for Lantiq
-               XWAY SoCs for booting from NOR flash. The U-Boot image needs to
-               be swapped if a flash programmer is used.
-
 - ARM options:
                CFG_SYS_EXCEPTION_VECTORS_HIGH
 
@@ -307,13 +300,6 @@ The following options need to be configured:
                different from COUNTER_FREQUENCY, and can only be determined
                at run time.
 
-- Tegra SoC options:
-               CONFIG_TEGRA_SUPPORT_NON_SECURE
-
-               Support executing U-Boot in non-secure (NS) mode. Certain
-               impossible actions will be skipped if the CPU is in NS mode,
-               such as ARM architectural timer initialization.
-
 - Linux Kernel Interface:
                CONFIG_OF_LIBFDT
 
@@ -785,21 +771,8 @@ The following options need to be configured:
                CFG_SYS_NUM_I2C_BUSES
                Hold the number of i2c buses you want to use.
 
-               CFG_SYS_I2C_DIRECT_BUS
-               define this, if you don't use i2c muxes on your hardware.
-               if CFG_SYS_I2C_MAX_HOPS is not defined or == 0 you can
-               omit this define.
-
-               CFG_SYS_I2C_MAX_HOPS
-               define how many muxes are maximal consecutively connected
-               on one i2c bus. If you not use i2c muxes, omit this
-               define.
-
                CFG_SYS_I2C_BUSES
-               hold a list of buses you want to use, only used if
-               CFG_SYS_I2C_DIRECT_BUS is not defined, for example
-               a board with CFG_SYS_I2C_MAX_HOPS = 1 and
-               CFG_SYS_NUM_I2C_BUSES = 9:
+               hold a list of buses you want to use
 
                 CFG_SYS_I2C_BUSES      {{0, {I2C_NULL_HOP}}, \
                                        {0, {{I2C_MUX_PCA9547, 0x70, 1}}}, \
@@ -897,13 +870,6 @@ The following options need to be configured:
                You should define these to the GPIO value as given directly to
                the generic GPIO functions.
 
-               CFG_I2C_MULTI_BUS
-
-               This option allows the use of multiple I2C buses, each of which
-               must have a controller.  At any point in time, only one bus is
-               active.  To switch to a different bus, use the 'i2c dev' command.
-               Note that bus numbering is zero-based.
-
                CFG_SYS_I2C_NOPROBES
 
                This option specifies a list of I2C devices that will be skipped
@@ -914,11 +880,6 @@ The following options need to be configured:
 
                will skip addresses 0x50 and 0x68 on a board with one I2C bus
 
-               CFG_SYS_RTC_BUS_NUM
-
-               If defined, then this indicates the I2C bus number for the RTC.
-               If not defined, then U-Boot assumes that RTC is on I2C bus 0.
-
                CONFIG_SOFT_I2C_READ_REPEATED_START
 
                defining this will force the i2c_read() function in
@@ -1198,11 +1159,10 @@ The following options need to be configured:
                Support for a lightweight UBI (fastmap) scanner and
                loader
 
-               CONFIG_SYS_NAND_5_ADDR_CYCLE, CONFIG_SYS_NAND_PAGE_COUNT,
-               CONFIG_SYS_NAND_PAGE_SIZE, CONFIG_SYS_NAND_OOBSIZE,
-               CONFIG_SYS_NAND_BLOCK_SIZE, CONFIG_SYS_NAND_BAD_BLOCK_POS,
-               CFG_SYS_NAND_ECCPOS, CFG_SYS_NAND_ECCSIZE,
-               CFG_SYS_NAND_ECCBYTES
+               CONFIG_SYS_NAND_5_ADDR_CYCLE, CONFIG_SYS_NAND_PAGE_SIZE,
+               CONFIG_SYS_NAND_OOBSIZE, CONFIG_SYS_NAND_BLOCK_SIZE,
+               CONFIG_SYS_NAND_BAD_BLOCK_POS, CFG_SYS_NAND_ECCPOS,
+               CFG_SYS_NAND_ECCSIZE, CFG_SYS_NAND_ECCBYTES
                Defines the size and behavior of the NAND that SPL uses
                to read U-Boot
 
@@ -1255,9 +1215,6 @@ typically in board_init_f() and board_init_r().
 Configuration Settings:
 -----------------------
 
-- MEM_SUPPORT_64BIT_DATA: Defined automatically if compiled as 64-bit.
-               Optionally it can be defined to support 64-bit memory commands.
-
 - CONFIG_SYS_LONGHELP: Defined when you want long help messages included;
                undefine this when you're short of memory.
 
@@ -1288,24 +1245,6 @@ Configuration Settings:
 - CONFIG_SYS_MALLOC_LEN:
                Size of DRAM reserved for malloc() use.
 
-- CONFIG_SYS_MALLOC_F_LEN
-               Size of the malloc() pool for use before relocation. If
-               this is defined, then a very simple malloc() implementation
-               will become available before relocation. The address is just
-               below the global data, and the stack is moved down to make
-               space.
-
-               This feature allocates regions with increasing addresses
-               within the region. calloc() is supported, but realloc()
-               is not available. free() is supported but does nothing.
-               The memory will be freed (or in fact just forgotten) when
-               U-Boot relocates itself.
-
-- CONFIG_SYS_MALLOC_SIMPLE
-               Provides a simple and small malloc() and calloc() for those
-               boards which do not use the full malloc in SPL (which is
-               enabled with CONFIG_SYS_SPL_MALLOC).
-
 - CFG_SYS_BOOTMAPSZ:
                Maximum size of memory mapped by the startup code of
                the Linux kernel; all data that must be processed by
@@ -1570,16 +1509,26 @@ Low Level (hardware related) configuration options:
                globally (CONFIG_CMD_MEMORY).
 
 - CONFIG_SPL_BUILD
-               Set when the currently-running compilation is for an artifact
-               that will end up in the SPL (as opposed to the TPL or U-Boot
-               proper). Code that needs stage-specific behavior should check
-               this.
+               Set when the currently running compilation is for an artifact
+               that will end up in one of the 'xPL' builds, i.e. SPL, TPL or
+               VPL. Code that needs phase-specific behaviour can check this,
+               or (where possible) use xpl_phase() instead.
+
+               Note that CONFIG_SPL_BUILD *is* always defined when either
+               of CONFIG_TPL_BUILD / CONFIG_VPL_BUILD is defined. This can be
+               counter-intuitive and should perhaps be changed.
 
 - CONFIG_TPL_BUILD
-               Set when the currently-running compilation is for an artifact
-               that will end up in the TPL (as opposed to the SPL or U-Boot
-               proper). Code that needs stage-specific behavior should check
-               this.
+               Set when the currently running compilation is for an artifact
+               that will end up in the TPL build (as opposed to SPL, VPL or
+               U-Boot proper). Code that needs phase-specific behaviour can
+               check this, or (where possible) use xpl_phase() instead.
+
+- CONFIG_VPL_BUILD
+               Set when the currently running compilation is for an artifact
+               that will end up in the VPL build (as opposed to the SPL, TPL
+               or U-Boot proper). Code that needs phase-specific behaviour can
+               check this, or (where possible) use xpl_phase() instead.
 
 - CONFIG_ARCH_MAP_SYSMEM
                Generally U-Boot (and in particular the md command) uses
@@ -1710,26 +1659,6 @@ images ready for download to / installation on your system:
 - "u-boot" is an image in ELF binary format
 - "u-boot.srec" is in Motorola S-Record format
 
-By default the build is performed locally and the objects are saved
-in the source directory. One of the two methods can be used to change
-this behavior and build U-Boot to some external directory:
-
-1. Add O= to the make command line invocations:
-
-       make O=/tmp/build distclean
-       make O=/tmp/build NAME_defconfig
-       make O=/tmp/build all
-
-2. Set environment variable KBUILD_OUTPUT to point to the desired location:
-
-       export KBUILD_OUTPUT=/tmp/build
-       make distclean
-       make NAME_defconfig
-       make all
-
-Note that the command line "O=" setting overrides the KBUILD_OUTPUT environment
-variable.
-
 User specific CPPFLAGS, AFLAGS and CFLAGS can be passed to the compiler by
 setting the according environment variables KCPPFLAGS, KAFLAGS and KCFLAGS.
 For example to treat all compiler warnings as errors:
@@ -2437,27 +2366,6 @@ Hit 'q':
        [q, b, e, ?] ## Application terminated, rc = 0x0
 
 
-Minicom warning:
-================
-
-Over time, many people have reported problems when trying to use the
-"minicom" terminal emulation program for serial download. I (wd)
-consider minicom to be broken, and recommend not to use it. Under
-Unix, I recommend to use C-Kermit for general purpose use (and
-especially for kermit binary protocol download ("loadb" command), and
-use "cu" for S-Record download ("loads" command).  See
-https://www.denx.de/wiki/view/DULG/SystemSetup#Section_4.3.
-for help with kermit.
-
-
-Nevertheless, if you absolutely want to use it try adding this
-configuration to your "File transfer protocols" section:
-
-          Name    Program                      Name U/D FullScr IO-Red. Multi
-       X  kermit  /usr/bin/kermit -i -l %l -s   Y    U    Y       N      N
-       Y  kermit  /usr/bin/kermit -i -l %l -r   N    D    Y       N      N
-
-
 Implementation Internals:
 =========================
 
@@ -2696,5 +2604,5 @@ Contributing
 
 The U-Boot projects depends on contributions from the user community.
 If you want to participate, please, have a look at the 'General'
-section of https://u-boot.readthedocs.io/en/latest/develop/index.html
+section of https://docs.u-boot.org/en/latest/develop/index.html
 where we describe coding standards and the patch submission process.
This page took 0.031598 seconds and 4 git commands to generate.