diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 9a41e43d07..34c00d7239 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -12982,6 +12982,48 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" + SPL_BINARY + + SPL_BINARY[doc] = "The file type of the Secondary Program Loader (SPL)." + + + + + The file type for the Secondary Program Loader (SPL). + Some devices use an SPL from which to boot (e.g. the + BeagleBone development board). + For such cases, you can declare the file type of the + SPL binary in the u-boot.inc include + file, which is used in the U-Boot recipe. + + + + The SPL file type is set to "null" by default in the + u-boot.inc file as follows: + + # Some versions of u-boot build an SPL (Second Program Loader) image that + # should be packaged along with the u-boot binary as well as placed in the + # deploy directory. For those versions they can set the following variables + # to allow packaging the SPL. + SPL_BINARY ?= "" + SPL_BINARYNAME ?= "${@os.path.basename(d.getVar("SPL_BINARY"))}" + SPL_IMAGE ?= "${SPL_BINARYNAME}-${MACHINE}-${PV}-${PR}" + SPL_SYMLINK ?= "${SPL_BINARYNAME}-${MACHINE}" + + The SPL_BINARY variable helps form + various SPL_* variables used by + the OpenEmbedded build system. + + + + See the BeagleBone machine configuration example in the + "Creating a new BSP Layer Using the bitbake-layers Script" + section in the Yocto Project Board Support Package + Developer's Guide for additional information. + + + + SRC_URI SRC_URI[doc] = "The list of source files - local or remote. This variable tells the OpenEmbedded build system what bits to pull in for the build and how to pull them in."