0d4f068bbf31c69cece00e543234d054ab407b5d
[oweals/u-boot.git] / doc / README.multi-dtb-fit
1 MULTI DTB FIT
2
3 The purpose of this feature is to enable u-boot to select its DTB from a FIT
4 appended at the end of the binary.
5
6 Usually the DTB is selected by the SPL and passed down to U-Boot. But some
7 platforms don't use the SPL. In this case MULTI_DTB_FIT can used to provide
8 U-Boot with a choice of DTBs.
9 The relevant DTBs are packed into a FIT (list provided by CONFIG__OF_LIST). The
10 FIT is automatically generated at the end of the compilation and appended to
11 u-boot.bin so that U-Boot can locate it and select the correct DTB from inside
12 the FIT.
13 The selection is done using board_fit_config_name_match() (same as what the SPL
14 uses to select the DTB for U-Boot). The selection happens during fdtdec_setup()
15 which is called during before relocation by board_init_f().