xref: /openbmc/u-boot/doc/README.multi-dtb-fit (revision 11955590a284ecb75892aad5f1174ca1b94a709b)
1*11955590SJean-Jacques HiblotMULTI DTB FIT
2*11955590SJean-Jacques Hiblot
3*11955590SJean-Jacques HiblotThe purpose of this feature is to enable u-boot to select its DTB from a FIT
4*11955590SJean-Jacques Hiblotappended at the end of the binary.
5*11955590SJean-Jacques Hiblot
6*11955590SJean-Jacques HiblotUsually the DTB is selected by the SPL and passed down to U-Boot. But some
7*11955590SJean-Jacques Hiblotplatforms don't use the SPL. In this case MULTI_DTB_FIT can used to provide
8*11955590SJean-Jacques HiblotU-Boot with a choice of DTBs.
9*11955590SJean-Jacques HiblotThe relevant DTBs are packed into a FIT (list provided by CONFIG__OF_LIST). The
10*11955590SJean-Jacques HiblotFIT is automatically generated at the end of the compilation and appended to
11*11955590SJean-Jacques Hiblotu-boot.bin so that U-Boot can locate it and select the correct DTB from inside
12*11955590SJean-Jacques Hiblotthe FIT.
13*11955590SJean-Jacques HiblotThe selection is done using board_fit_config_name_match() (same as what the SPL
14*11955590SJean-Jacques Hiblotuses to select the DTB for U-Boot). The selection happens during fdtdec_setup()
15*11955590SJean-Jacques Hiblotwhich is called during before relocation by board_init_f().
16