I think this isn't needed anymore after https://lore.kernel.org/u-boot/CAC_iWjJ6=NjqwcFzVvV4DzMWy5nY_QAeD=vfqrrsjodlbvq...@mail.gmail.com/
On Wed, 3 Jan 2024 at 00:14, Raymond Mao <[email protected]> wrote: > > Update the document and Kconfig to describe the behavior of board > specific custom functions when CONFIG_OF_BOARD is defined. > > Signed-off-by: Raymond Mao <[email protected]> > --- > Changes in v4 > - Refine the description. > > doc/develop/devicetree/control.rst | 6 +++--- > dts/Kconfig | 7 +++++-- > 2 files changed, 8 insertions(+), 5 deletions(-) > > diff --git a/doc/develop/devicetree/control.rst > b/doc/develop/devicetree/control.rst > index cbb65c9b17..2b968a6b01 100644 > --- a/doc/develop/devicetree/control.rst > +++ b/doc/develop/devicetree/control.rst > @@ -104,9 +104,9 @@ in u-boot.bin so you can still just flash u-boot.bin onto > your board. If you are > using CONFIG_SPL_FRAMEWORK, then u-boot.img will be built to include the > device > tree binary. > > -If CONFIG_OF_BOARD is defined, a board-specific routine will provide the > -devicetree at runtime, for example if an earlier bootloader stage creates > -it and passes it to U-Boot. > +If CONFIG_OF_BOARD is defined, arch-specific routine and board-specific > routine > +will provide the bloblist and devicetree respectively at runtime, for > example if > +an earlier bootloader stage creates it and passes it to U-Boot. > > If CONFIG_SANDBOX is defined, then it will be read from a file on > startup. Use the -d flag to U-Boot to specify the file to read, -D for the > diff --git a/dts/Kconfig b/dts/Kconfig > index 00c0aeff89..ac6e1752bb 100644 > --- a/dts/Kconfig > +++ b/dts/Kconfig > @@ -110,8 +110,11 @@ config OF_BOARD > default y if SANDBOX || OF_HAS_PRIOR_STAGE > help > If this option is enabled, the device tree is provided at runtime by > - a custom function called board_fdt_blob_setup(). The board must > - implement this function if it wishes to provide special behaviour. > + a board custom function called board_fdt_blob_setup(). > + If this option is enabled, bloblist is provided at runtime by an > + arch custom function called xferlist_from_boot_arg(). > + An arch or board must implement these functions if it wishes to > + provide special behaviours. > > With this option, the device tree build by U-Boot may be overridden > or > ignored. See OF_HAS_PRIOR_STAGE. > -- > 2.25.1 >
