mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-16 08:13:17 +00:00
ea4299a213
Now that Linux has accepted these tags, move U-Boot over to use them. Tidy up the comments and formatting, making sure that VPL is mentioned too. Signed-off-by: Simon Glass <sjg@chromium.org>
49 lines
1.7 KiB
Smarty
49 lines
1.7 KiB
Smarty
Generic TPL framework
|
|
=====================
|
|
|
|
Overview
|
|
--------
|
|
|
|
TPL---Third Program Loader.
|
|
|
|
Due to the SPL on some boards(powerpc mpc85xx) has a size limit and cannot
|
|
be compatible with all the external device(e.g. DDR). So add a tertiary
|
|
program loader (TPL) to enable a loader stub loaded by the code from the
|
|
SPL. It loads the final uboot image into DDR, then jump to it to begin
|
|
execution. Now, only the powerpc mpc85xx has this requirement and will
|
|
implemente it.
|
|
|
|
Keep consistent with SPL, with this framework almost all source files for a
|
|
board can be reused. No code duplication or symlinking is necessary anymore.
|
|
|
|
How it works
|
|
------------
|
|
|
|
There has been a directory $(srctree)/spl which contains only a Makefile. The
|
|
Makefile is shared by SPL and TPL.
|
|
|
|
The object files are built separately for SPL/TPL and placed in the
|
|
directory spl/tpl. The final binaries which are generated are
|
|
u-boot-{spl|tpl}, u-boot-{spl|tpl}.bin and u-boot-{spl|tpl}.map.
|
|
|
|
During the TPL build a variable named CONFIG_TPL_BUILD is exported in the
|
|
make environment and also appended to CPPFLAGS with -DCONFIG_TPL_BUILD.
|
|
|
|
The SPL options are shared by SPL and TPL, the board config file should
|
|
determine which SPL options to choose based on whether CONFIG_TPL_BUILD
|
|
is set. Source files can be compiled for TPL with options chosen in the
|
|
board config file.
|
|
|
|
TPL use a small device tree (u-boot-tpl.dtb), containing only the nodes with
|
|
the pre-relocation properties: 'bootph-all' and 'bootph-pre-sram'
|
|
(see doc/develop/spl.rst for details).
|
|
|
|
For example:
|
|
|
|
spl/Makefile:
|
|
LIBS-$(CONFIG_SPL_LIBCOMMON_SUPPORT) += common/libcommon.o
|
|
|
|
CONFIG_SPL_LIBCOMMON_SUPPORT is defined in board config file:
|
|
#ifdef CONFIG_TPL_BUILD
|
|
#define CONFIG_SPL_LIBCOMMON_SUPPORT
|
|
#endif
|