summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/ref-manual/ref-variables.xml42
1 files changed, 42 insertions, 0 deletions
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"
12982 </glossdef> 12982 </glossdef>
12983 </glossentry> 12983 </glossentry>
12984 12984
12985 <glossentry id='var-SPL_BINARY'><glossterm>SPL_BINARY</glossterm>
12986 <info>
12987 SPL_BINARY[doc] = "The file type of the Secondary Program Loader (SPL)."
12988 </info>
12989 <glossdef>
12990 <para role="glossdeffirst">
12991<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
12992 The file type for the Secondary Program Loader (SPL).
12993 Some devices use an SPL from which to boot (e.g. the
12994 BeagleBone development board).
12995 For such cases, you can declare the file type of the
12996 SPL binary in the <filename>u-boot.inc</filename> include
12997 file, which is used in the U-Boot recipe.
12998 </para>
12999
13000 <para>
13001 The SPL file type is set to "null" by default in the
13002 <filename>u-boot.inc</filename> file as follows:
13003 <literallayout class='monospaced'>
13004 # Some versions of u-boot build an SPL (Second Program Loader) image that
13005 # should be packaged along with the u-boot binary as well as placed in the
13006 # deploy directory. For those versions they can set the following variables
13007 # to allow packaging the SPL.
13008 SPL_BINARY ?= ""
13009 SPL_BINARYNAME ?= "${@os.path.basename(d.getVar("SPL_BINARY"))}"
13010 SPL_IMAGE ?= "${SPL_BINARYNAME}-${MACHINE}-${PV}-${PR}"
13011 SPL_SYMLINK ?= "${SPL_BINARYNAME}-${MACHINE}"
13012 </literallayout>
13013 The <filename>SPL_BINARY</filename> variable helps form
13014 various <filename>SPL_*</filename> variables used by
13015 the OpenEmbedded build system.
13016 </para>
13017
13018 <para>
13019 See the BeagleBone machine configuration example in the
13020 "<ulink url='&YOCTO_DOCS_BSP_URL;#creating-a-new-bsp-layer-using-the-bitbake-layers-script'>Creating a new BSP Layer Using the <filename>bitbake-layers</filename> Script</ulink>"
13021 section in the Yocto Project Board Support Package
13022 Developer's Guide for additional information.
13023 </para>
13024 </glossdef>
13025 </glossentry>
13026
12985 <glossentry id='var-SRC_URI'><glossterm>SRC_URI</glossterm> 13027 <glossentry id='var-SRC_URI'><glossterm>SRC_URI</glossterm>
12986 <info> 13028 <info>
12987 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." 13029 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."