mirror of
https://git.yoctoproject.org/poky
synced 2026-04-29 09:32:11 +02:00
manuals: update linux-yocto append examples
(From yocto-docs rev: b5d385f20d22566e12a7938a9894b86429f1dcfb) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Steve Sakoman <steve@sakoman.com>
This commit is contained in:
committed by
Steve Sakoman
parent
811cf0320c
commit
aaf748b95f
@@ -1449,39 +1449,39 @@ The kernel recipe used to build the kernel image for the BeagleBone
|
||||
device was established in the machine configuration::
|
||||
|
||||
PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto"
|
||||
PREFERRED_VERSION_linux-yocto ?= "5.0%"
|
||||
PREFERRED_VERSION_linux-yocto ?= "5.15%"
|
||||
|
||||
The ``meta-yocto-bsp/recipes-kernel/linux`` directory in the layer contains
|
||||
metadata used to build the kernel. In this case, a kernel append file
|
||||
(i.e. ``linux-yocto_5.0.bbappend``) is used to override an established
|
||||
kernel recipe (i.e. ``linux-yocto_5.0.bb``), which is located in
|
||||
:yocto_git:`/poky/tree/meta/recipes-kernel/linux`.
|
||||
(i.e. ``linux-yocto_5.15.bbappend``) is used to override an established
|
||||
kernel recipe (i.e. ``linux-yocto_5.15.bb``), which is located in
|
||||
:yocto_git:`/poky/tree/meta-yocto-bsp/recipes-kernel/linux`.
|
||||
|
||||
Following is the contents of the append file::
|
||||
|
||||
KBRANCH:genericx86 = "v5.0/standard/base"
|
||||
KBRANCH:genericx86-64 = "v5.0/standard/base"
|
||||
KBRANCH:edgerouter = "v5.0/standard/edgerouter"
|
||||
KBRANCH:beaglebone-yocto = "v5.0/standard/beaglebone"
|
||||
KBRANCH:genericx86 = "v5.15/standard/base"
|
||||
KBRANCH:genericx86-64 = "v5.15/standard/base"
|
||||
KBRANCH:edgerouter = "v5.15/standard/edgerouter"
|
||||
KBRANCH:beaglebone-yocto = "v5.15/standard/beaglebone"
|
||||
|
||||
KMACHINE:genericx86 ?= "common-pc"
|
||||
KMACHINE:genericx86-64 ?= "common-pc-64"
|
||||
KMACHINE:beaglebone-yocto ?= "beaglebone"
|
||||
|
||||
SRCREV_machine:genericx86 ?= "3df4aae6074e94e794e27fe7f17451d9353cdf3d"
|
||||
SRCREV_machine:genericx86-64 ?= "3df4aae6074e94e794e27fe7f17451d9353cdf3d"
|
||||
SRCREV_machine:edgerouter ?= "3df4aae6074e94e794e27fe7f17451d9353cdf3d"
|
||||
SRCREV_machine:beaglebone-yocto ?= "3df4aae6074e94e794e27fe7f17451d9353cdf3d"
|
||||
SRCREV_machine:genericx86 ?= "0b628306d1f9ea28c0e86369ce9bb87a47893c9c"
|
||||
SRCREV_machine:genericx86-64 ?= "0b628306d1f9ea28c0e86369ce9bb87a47893c9c"
|
||||
SRCREV_machine:edgerouter ?= "90f1ee6589264545f548d731c2480b08a007230f"
|
||||
SRCREV_machine:beaglebone-yocto ?= "9aabbaa89fcb21af7028e814c1f5b61171314d5a"
|
||||
|
||||
COMPATIBLE_MACHINE:genericx86 = "genericx86"
|
||||
COMPATIBLE_MACHINE:genericx86-64 = "genericx86-64"
|
||||
COMPATIBLE_MACHINE:edgerouter = "edgerouter"
|
||||
COMPATIBLE_MACHINE:beaglebone-yocto = "beaglebone-yocto"
|
||||
|
||||
LINUX_VERSION:genericx86 = "5.0.3"
|
||||
LINUX_VERSION:genericx86-64 = "5.0.3"
|
||||
LINUX_VERSION:edgerouter = "5.0.3"
|
||||
LINUX_VERSION:beaglebone-yocto = "5.0.3"
|
||||
LINUX_VERSION:genericx86 = "5.15.72"
|
||||
LINUX_VERSION:genericx86-64 = "5.15.72"
|
||||
LINUX_VERSION:edgerouter = "5.15.54"
|
||||
LINUX_VERSION:beaglebone-yocto = "5.15.54"
|
||||
|
||||
This particular append file works for all the machines that are
|
||||
part of the ``meta-yocto-bsp`` layer. The relevant statements are
|
||||
|
||||
@@ -69,8 +69,7 @@ to indicate the branch.
|
||||
You can use the :term:`KBRANCH` value to define an alternate branch typically
|
||||
with a machine override as shown here from the ``meta-yocto-bsp`` layer::
|
||||
|
||||
KBRANCH:edgerouter = "standard/edgerouter"
|
||||
|
||||
KBRANCH:beaglebone-yocto = "standard/beaglebone"
|
||||
|
||||
The linux-yocto style recipes can optionally define the following
|
||||
variables:
|
||||
|
||||
@@ -455,13 +455,13 @@ Creating the Append File
|
||||
|
||||
You create this file in your custom layer. You also name it accordingly
|
||||
based on the linux-yocto recipe you are using. For example, if you are
|
||||
modifying the ``meta/recipes-kernel/linux/linux-yocto_4.12.bb`` recipe,
|
||||
modifying the ``meta/recipes-kernel/linux/linux-yocto_5.15.bb`` recipe,
|
||||
the append file will typically be located as follows within your custom
|
||||
layer:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
your-layer/recipes-kernel/linux/linux-yocto_4.12.bbappend
|
||||
your-layer/recipes-kernel/linux/linux-yocto_5.15.bbappend
|
||||
|
||||
The append file should initially extend the
|
||||
:term:`FILESPATH` search path by
|
||||
@@ -489,36 +489,36 @@ As an example, consider the following append file used by the BSPs in
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
meta-yocto-bsp/recipes-kernel/linux/linux-yocto_4.12.bbappend
|
||||
meta-yocto-bsp/recipes-kernel/linux/linux-yocto_5.15.bbappend
|
||||
|
||||
Here are the contents of this file. Be aware that the actual commit ID
|
||||
strings in this example listing might be different than the actual
|
||||
strings in the file from the ``meta-yocto-bsp`` layer upstream.
|
||||
::
|
||||
|
||||
KBRANCH:genericx86 = "standard/base"
|
||||
KBRANCH:genericx86-64 = "standard/base"
|
||||
KBRANCH:genericx86 = "v5.15/standard/base"
|
||||
KBRANCH:genericx86-64 = "v5.15/standard/base"
|
||||
KBRANCH:edgerouter = "v5.15/standard/edgerouter"
|
||||
KBRANCH:beaglebone-yocto = "v5.15/standard/beaglebone"
|
||||
|
||||
KMACHINE:genericx86 ?= "common-pc"
|
||||
KMACHINE:genericx86-64 ?= "common-pc-64"
|
||||
KBRANCH:edgerouter = "standard/edgerouter"
|
||||
KBRANCH:beaglebone = "standard/beaglebone"
|
||||
|
||||
SRCREV_machine:genericx86 ?= "d09f2ce584d60ecb7890550c22a80c48b83c2e19"
|
||||
SRCREV_machine:genericx86-64 ?= "d09f2ce584d60ecb7890550c22a80c48b83c2e19"
|
||||
SRCREV_machine:edgerouter ?= "b5c8cfda2dfe296410d51e131289fb09c69e1e7d"
|
||||
SRCREV_machine:beaglebone ?= "b5c8cfda2dfe296410d51e131289fb09c69e1e7d"
|
||||
KMACHINE:beaglebone-yocto ?= "beaglebone"
|
||||
|
||||
SRCREV_machine:genericx86 ?= "0b628306d1f9ea28c0e86369ce9bb87a47893c9c"
|
||||
SRCREV_machine:genericx86-64 ?= "0b628306d1f9ea28c0e86369ce9bb87a47893c9c"
|
||||
SRCREV_machine:edgerouter ?= "90f1ee6589264545f548d731c2480b08a007230f"
|
||||
SRCREV_machine:beaglebone-yocto ?= "9aabbaa89fcb21af7028e814c1f5b61171314d5a"
|
||||
|
||||
COMPATIBLE_MACHINE:genericx86 = "genericx86"
|
||||
COMPATIBLE_MACHINE:genericx86-64 = "genericx86-64"
|
||||
COMPATIBLE_MACHINE:edgerouter = "edgerouter"
|
||||
COMPATIBLE_MACHINE:beaglebone = "beaglebone"
|
||||
COMPATIBLE_MACHINE:beaglebone-yocto = "beaglebone-yocto"
|
||||
|
||||
LINUX_VERSION:genericx86 = "4.12.7"
|
||||
LINUX_VERSION:genericx86-64 = "4.12.7"
|
||||
LINUX_VERSION:edgerouter = "4.12.10"
|
||||
LINUX_VERSION:beaglebone = "4.12.10"
|
||||
LINUX_VERSION:genericx86 = "5.15.72"
|
||||
LINUX_VERSION:genericx86-64 = "5.15.72"
|
||||
LINUX_VERSION:edgerouter = "5.15.54"
|
||||
LINUX_VERSION:beaglebone-yocto = "5.15.54"
|
||||
|
||||
This append file
|
||||
contains statements used to support several BSPs that ship with the
|
||||
|
||||
@@ -3943,7 +3943,7 @@ system and gives an overview of their function and contents.
|
||||
|
||||
Values for this variable are set in the kernel's recipe file and the
|
||||
kernel's append file. For example, if you are using the
|
||||
``linux-yocto_4.12`` kernel, the kernel recipe file is the
|
||||
``linux-yocto_5.15`` kernel, the kernel recipe file is the
|
||||
``meta/recipes-kernel/linux/linux-yocto_4.12.bb`` file. :term:`KBRANCH`
|
||||
is set as follows in that kernel recipe file::
|
||||
|
||||
@@ -3956,13 +3956,13 @@ system and gives an overview of their function and contents.
|
||||
BSP layer for a given machine. For example, the append file for the
|
||||
Beaglebone, EdgeRouter, and generic versions of both 32 and 64-bit IA
|
||||
machines (``meta-yocto-bsp``) is named
|
||||
``meta-yocto-bsp/recipes-kernel/linux/linux-yocto_4.12.bbappend``.
|
||||
``meta-yocto-bsp/recipes-kernel/linux/linux-yocto_4.15.bbappend``.
|
||||
Here are the related statements from that append file::
|
||||
|
||||
KBRANCH:genericx86 = "standard/base"
|
||||
KBRANCH:genericx86-64 = "standard/base"
|
||||
KBRANCH:edgerouter = "standard/edgerouter"
|
||||
KBRANCH:beaglebone = "standard/beaglebone"
|
||||
KBRANCH:genericx86 = "v5.15/standard/base"
|
||||
KBRANCH:genericx86-64 = "v5.15/standard/base"
|
||||
KBRANCH:edgerouter = "v5.15/standard/edgerouter"
|
||||
KBRANCH:beaglebone-yocto = "v5.15/standard/beaglebone"
|
||||
|
||||
The :term:`KBRANCH` statements
|
||||
identify the kernel branch to use when building for each supported
|
||||
|
||||
Reference in New Issue
Block a user