From 99151aef7765d8d33d0746fbea131ad2ca1387ec Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 2 Oct 2017 12:59:32 -0700 Subject: kernel-dev: Updates to "Using Kernel Metadata in a Recipe" This section had some old emenlo examples and was a little confusing. I removed the old examples and inserted some new wordings to help smooth it out. (From yocto-docs rev: 365129e0cd37772f404d96a51eb498210e4f1ee9) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/kernel-dev/kernel-dev-advanced.xml | 31 ++++++++---------------- 1 file changed, 10 insertions(+), 21 deletions(-) (limited to 'documentation') diff --git a/documentation/kernel-dev/kernel-dev-advanced.xml b/documentation/kernel-dev/kernel-dev-advanced.xml index 812c77547b..29052de9c1 100644 --- a/documentation/kernel-dev/kernel-dev-advanced.xml +++ b/documentation/kernel-dev/kernel-dev-advanced.xml @@ -44,20 +44,18 @@ Using Kernel Metadata in a Recipe - The kernel sources in the Yocto Project contain kernel Metadata, which - is located in the meta branches of the kernel - source Git repositories. + As mentioned in the introduction, the Yocto Project contains kernel + Metadata, which is located in the + yocto-kernel-cache Git repository. This Metadata defines Board Support Packages (BSPs) that - correspond to definitions in linux-yocto recipes for the same BSPs. + correspond to definitions in linux-yocto recipes for corresponding BSPs. A BSP consists of an aggregation of kernel policy and enabled hardware-specific features. The BSP can be influenced from within the linux-yocto recipe. - Linux kernel source that contains kernel Metadata is said to be - "linux-yocto style" kernel source. - A Linux kernel recipe that inherits from the - linux-yocto.inc include file is said to be a - "linux-yocto style" recipe. + A Linux kernel recipe that contains kernel Metadata (e.g. + inherits from the linux-yocto.inc file) + is said to be a "linux-yocto style" recipe. @@ -92,9 +90,9 @@ You can use the KBRANCH value to define an alternate branch typically with a machine override as shown here - from the meta-emenlow layer: + from the meta-yocto-bsp layer: - KBRANCH_emenlow-noemgd = "standard/base" + KBRANCH_edgerouter = "standard/edgerouter" @@ -133,16 +131,7 @@ recipe. The tools use the first BSP description it finds that match both variables. - If the tools cannot find a match, they issue a warning such as - the following: - - WARNING: Can't find any BSP hardware or required configuration fragments. - WARNING: Looked at meta/cfg/broken/emenlow-broken/hdw_frags.txt and - meta/cfg/broken/emenlow-broken/required_frags.txt in directory: - meta/cfg/broken/emenlow-broken - - In this example, KMACHINE was set to "emenlow-broken" - and LINUX_KERNEL_TYPE was set to "broken". + If the tools cannot find a match, they issue a warning. -- cgit v1.2.3-54-g00ecf