u-boot/doc/device-tree-bindings
Tom Rini 47e544f576 Merge patch series "Tidy up use of 'SPL' and CONFIG_SPL_BUILD"
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.
2024-10-11 12:23:25 -06:00
..
adc
arm dt-bindings: arm: Add SC5xx Series binding 2024-10-03 09:29:22 -06:00
ata
axi
bus
clock dt-bindings: clock: Add SC5xx clock tree bindings 2024-10-03 09:29:22 -06:00
cpu
exynos dt-bindings: exynos: Update bindings doc for DW MMC controller 2024-08-19 16:09:06 +09:00
firmware dt/bindings: fwu-mdata-mtd: drop changes outside FWU 2023-06-09 13:24:10 -04:00
fpga doc: Add the link for the documentation of the .its 2023-08-09 08:41:52 +02:00
fsp/fsp2/apollolake dm: doc: Update device tree binding docs for new schema 2023-02-14 09:43:27 -07:00
gpio gpio: qcom_pmic: drop gpio-count property 2024-01-16 12:26:53 +00:00
gpu
i2c dt-bindings: i2c: i2c-cdns.txt: Add description for an optional parameter, fifo-depth 2023-02-13 09:58:15 +01:00
input
interrupt-controller
iommu iommu: Add IOMMU uclass 2021-10-31 08:46:44 -04:00
leds led: add TI LP5562 LED driver 2023-12-13 11:35:16 -05:00
mailbox WS cleanup: remove SPACE(s) followed by TAB 2021-09-30 09:08:16 -04:00
memory dt/bindings: memory: Add bindings for TI GPMC driver 2022-10-26 15:21:11 -04:00
memory-controller dm: doc: Update device tree binding docs for new schema 2023-02-14 09:43:27 -07:00
memory-controllers dm: doc: Update device tree binding docs for new schema 2023-02-14 09:43:27 -07:00
mfd k210: use the board vendor name rather than the marketing name 2022-03-15 17:43:11 +08:00
misc drivers: misc: Add socfpga_dtreg driver for Intel SoCFPGA 2024-03-18 11:05:09 +08:00
mmc dt-bindings: drop msm_sdhci binding 2024-03-01 14:44:35 +00:00
mtd dt-bindings: mtd: Add ti, elm DT binding documentation 2023-01-08 10:38:50 +01:00
nand nand: Add sandbox driver 2023-11-16 12:43:49 -05:00
net dm: doc: Update device tree binding docs for new schema 2023-02-14 09:43:27 -07:00
nvmxip sandbox64: add support for NVMXIP QSPI 2023-04-27 17:01:14 -04:00
pci dm: doc: Update device tree binding docs for new schema 2023-02-14 09:43:27 -07:00
pci_endpoint
phy dt-bindings: phy-mtk-tphy: add properties for phy tuning 2024-01-11 21:19:25 -05:00
pinctrl dm: doc: Update device tree binding docs for new schema 2023-02-14 09:43:27 -07:00
pmic pmic: qcom: dont use dev_read_addr to get USID 2024-01-16 12:26:54 +00:00
power
pwm dt-bindings: pwm: pwm-at91: Add PWM bindings for A5D2 2021-10-12 15:18:39 +03:00
ram dm: doc: Update device tree binding docs for new schema 2023-02-14 09:43:27 -07:00
reboot-mode
regulator doc: regulator: Add regulator-force-boot-off binding 2022-06-06 17:47:16 -04:00
remoteproc remoteproc: k3_system_controller: Support optional boot_notification channel 2022-02-08 09:41:26 -05:00
reserved-memory
reset
rtc
serial serial: msm: calculate bit clock divider 2024-04-23 13:29:16 +02:00
soc arm: exynos: Migrate E850-96 board to OF_UPSTREAM 2024-05-28 11:45:09 +09:00
sound
spi spi: soft_spi: Parse cs-gpios only if num-chipselects is not <0> 2024-08-15 11:28:47 -06:00
spmi spmi: msm: fix register range names 2024-01-16 12:26:54 +00:00
sysinfo
thermal
timer dt-bindings: timer: Add SC5xx Timer bindings 2024-10-03 09:29:22 -06:00
tpm2 WS cleanup: remove SPACE(s) followed by TAB 2021-09-30 09:08:16 -04:00
usb board: dragonboard410c: upstream DT compat 2024-03-01 14:44:37 +00:00
video tree-wide: Replace http:// link with https:// link for ti.com 2023-11-10 11:01:50 -05:00
w1 WS cleanup: remove trailing empty lines 2021-09-30 08:08:56 -04:00
w1-eeprom WS cleanup: remove trailing empty lines 2021-09-30 08:08:56 -04:00
watchdog watchdog: introduce a u-boot,autostart property 2022-10-24 11:09:19 +02:00
bootcount-syscon.txt bootcount: Update to point to current documentation 2024-09-12 18:14:49 +02:00
bootdev.txt bootstd: doc: Add documentation 2022-04-25 10:00:04 -04:00
bootmeth.txt bootstd: Rename distro and syslinux to extlinux 2023-05-13 09:52:32 -04:00
bootph.yaml xpl: Rename spl_phase to xpl_phase_t 2024-10-11 11:44:47 -06:00
bootstd.txt bootstd: Rename distro and syslinux to extlinux 2023-05-13 09:52:32 -04:00
chosen.txt dm: doc: Update device tree binding docs for new schema 2023-02-14 09:43:27 -07:00
config.txt env: mmc: statically set the environment partition name 2023-07-14 15:21:07 -04:00
device.txt dm: doc: Update device tree binding docs for new schema 2023-02-14 09:43:27 -07:00
README
root.txt

Device Tree Bindings Staging Area
=================================

This directory contains device tree bindings for U-Boot.

These follow along with Linux kernel bindings, with a few additions. By
adding the files here, U-Boot patches can clearly show thees additions.
This makes it easier for device tree people to review these additions in
patches sent to the U-Boot mailing list.

The intent IS to commit these files to U-Boot. Hopefully at some point
the files will be stored in another repo (shared with Linux) which is
brought in as needed. Changes here are intended to mirror changes in the
Linux Documentation/devicetree/bindings/ directory.

sjg@chromium.org
17-Jan-12