mirror of
https://github.com/u-boot/u-boot.git
synced 2025-04-22 12:54:37 +00:00
47e544f576
Simon Glass <sjg@chromium.org> says: When the SPL build-phase was first created it was designed to solve a particular problem (the need to init SDRAM so that U-Boot proper could be loaded). It has since expanded to become an important part of U-Boot, with three phases now present: TPL, VPL and SPL Due to this history, the term 'SPL' is used to mean both a particular phase (the one before U-Boot proper) and all the non-proper phases. This has become confusing. For a similar reason CONFIG_SPL_BUILD is set to 'y' for all 'SPL' phases, not just SPL. So code which can only be compiled for actual SPL, for example, must use something like this: #if defined(CONFIG_SPL_BUILD) && !defined(CONFIG_TPL_BUILD) In Makefiles we have similar issues. SPL_ has been used as a variable which expands to either SPL_ or nothing, to chose between options like CONFIG_BLK and CONFIG_SPL_BLK. When TPL appeared, a new SPL_TPL variable was created which expanded to 'SPL_', 'TPL_' or nothing. Later it was updated to support 'VPL_' as well. This series starts a change in terminology and usage to resolve the above issues: - The word 'xPL' is used instead of 'SPL' to mean a non-proper build - A new CONFIG_XPL_BUILD define indicates that the current build is an 'xPL' build - The existing CONFIG_SPL_BUILD is changed to mean SPL; it is not now defined for TPL and VPL phases - The existing SPL_ Makefile variable is renamed to SPL_ - The existing SPL_TPL Makefile variable is renamed to PHASE_ It should be noted that xpl_phase() can generally be used instead of the above CONFIGs without a code-space or run-time penalty. This series does not attempt to convert all of U-Boot to use this new terminology but it makes a start. In particular, renaming spl.h and common/spl seems like a bridge too far at this point. The series is fully bisectable. It has also been checked to ensure there are no code-size changes on any commit. |
||
|---|---|---|
| .. | ||
| bootstd | ||
| devicetree | ||
| driver-model | ||
| historical | ||
| package | ||
| pics | ||
| statistics | ||
| uefi | ||
| bloblist.rst | ||
| board_best_practices.rst | ||
| cedit.rst | ||
| checkpatch.rst | ||
| ci_testing.rst | ||
| coccinelle.rst | ||
| codingstyle.rst | ||
| commands.rst | ||
| config_binding.rst | ||
| crash_dumps.rst | ||
| cyclic.rst | ||
| designprinciples.rst | ||
| directories.rst | ||
| distro.rst | ||
| docstyle.rst | ||
| environment.rst | ||
| event.rst | ||
| expo.rst | ||
| falcon.rst | ||
| gdb.rst | ||
| global_data.rst | ||
| ide_integration.rst | ||
| index.rst | ||
| init.rst | ||
| logging.rst | ||
| makefiles.rst | ||
| memory.rst | ||
| menus.rst | ||
| patman.rst | ||
| printf.rst | ||
| process.rst | ||
| py_testing.rst | ||
| python_cq.rst | ||
| qconfig.rst | ||
| release_cycle.rst | ||
| security.rst | ||
| sending_patches.rst | ||
| smbios.rst | ||
| spl.rst | ||
| system_configuration.rst | ||
| testing.rst | ||
| tests_sandbox.rst | ||
| tests_writing.rst | ||
| trace.rst | ||
| vbe.rst | ||
| version.rst | ||