From 7fa2c8f6f7f6d358646edf8264d259d9f017aeae Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 23 Sep 2013 13:23:00 -0700 Subject: bsp-guide, dev-manual: Updated for 3.10 default kernel YP 1.5 default kernel is 3.10. This is a change from 3.8 in the previous release. This change affected several areas of the documentation. 1. The BSP Guide had a crownbay BSP structure that did not account for the new default. 2. The yocto-bsp tool output still asked for the 3.8 kernel as the default. 3. The recipes-bsp section had 3.8 used and had some bad listings that had to be changed. 4. The recipes-graphics section had 3.8 used and also had some stuff supporting two versions of the graphics (emgd and noemgd). I had to pull the emgd stuff. 5. There were miscellaneous spots in the dev-manual that were referencing 3.8 as the default kernel. Particularly the list that shows what kernel repositories we have. That needed updating. (From yocto-docs rev: 9826ce760884f2ce5a4eb72c6a731a85cd6f2b2b) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/bsp-guide/bsp.xml | 136 +++++++++++++--------------------------- 1 file changed, 45 insertions(+), 91 deletions(-) (limited to 'documentation/bsp-guide') diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml index cfca34473b..e11eb4f663 100644 --- a/documentation/bsp-guide/bsp.xml +++ b/documentation/bsp-guide/bsp.xml @@ -183,17 +183,15 @@ meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-config/ meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-config/crownbay/ meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-config/crownbay/xorg.conf - meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-config/crownbay-noemgd/ - meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-config/crownbay-noemgd/xorg.conf meta-crownbay/recipes-kernel/ meta-crownbay/recipes-kernel/linux/ - meta-crownbay/recipes-kernel/linux/linux-yocto_3.2.bbappend meta-crownbay/recipes-kernel/linux/linux-yocto_3.4.bbappend meta-crownbay/recipes-kernel/linux/linux-yocto_3.8.bbappend + meta-crownbay/recipes-kernel/linux/linux-yocto_3.10.bbappend meta-crownbay/recipes-kernel/linux/linux-yocto-dev.bbappend - meta-crownbay/recipes-kernel/linux/linux-yocto-rt_3.2.bbappend meta-crownbay/recipes-kernel/linux/linux-yocto-rt_3.4.bbappend meta-crownbay/recipes-kernel/linux/linux-yocto-rt_3.8.bbappend + meta-crownbay/recipes-kernel/linux/linux-yocto-rt_3.10.bbappend @@ -376,15 +374,6 @@ Each BSP Layer requires at least one machine file. However, you can supply more than one file. - For example, in the Crown Bay BSP shown earlier in this section, the - conf/machine directory contains two configuration files: - crownbay.conf and crownbay-noemgd.conf. - The crownbay.conf file is used for the Crown Bay BSP - that supports the Intel Embedded - Media and Graphics Driver (Intel - EMGD), while the crownbay-noemgd file is used for the - Crown Bay BSP that supports Video Electronics Standards Association (VESA) - graphics only. @@ -428,15 +417,13 @@ This optional directory contains miscellaneous recipe files for the BSP. Most notably would be the formfactor files. For example, in the Crown Bay BSP there is the - formfactor_0.0.bbappend file, which is an append file used - to augment the recipe that starts the build. - Furthermore, there are machine-specific settings used during the build that are - defined by the machconfig files. - In the Crown Bay example, two machconfig files exist: - one that supports the - Intel Embedded - Media and Graphics Driver (Intel - EMGD) and one that does not: + formfactor_0.0.bbappend file, which is an + append file used to augment the recipe that starts the build. + Furthermore, there are machine-specific settings used during the + build that are defined by the machconfig. + In the Crown Bay example, two machconfig files + exist: one that supports the Intel® Embedded Media and Graphics + Driver (Intel® EMGD) and one that does not: meta-crownbay/recipes-bsp/formfactor/formfactor/crownbay/machconfig meta-crownbay/recipes-bsp/formfactor/formfactor/crownbay-noemgd/machconfig @@ -467,15 +454,12 @@ This optional directory contains recipes for the BSP if it has special requirements for graphics support. All files that are needed for the BSP to support a display are kept here. - For example, the Crown Bay BSP contains two versions of the - xorg.conf file. - The version in crownbay builds a BSP that supports the - Intel Embedded Media Graphics Driver (EMGD), - while the version in crownbay-noemgd builds - a BSP that supports Video Electronics Standards Association (VESA) graphics only: + For example, the Crown Bay BSP's xorg.conf file + detects the graphics support needed (i.e. the Intel® Embedded Media + Graphics Driver (EMGD) or the Video Electronics Standards Association + (VESA) graphics): meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-config_0.1.bbappend - meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-config/crownbay/xorg.conf meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-config/crownbay-noemgd/xorg.conf @@ -502,28 +486,28 @@ the meta-<bsp_name>/recipes-kernel/linux directory). - Suppose you are using the linux-yocto_3.8.bb recipe to build + Suppose you are using the linux-yocto_3.10.bb recipe to build the kernel. In other words, you have selected the kernel in your <bsp_name>.conf file by adding these types of statements: PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto" - PREFERRED_VERSION_linux-yocto ?= "3.8%" + PREFERRED_VERSION_linux-yocto ?= "3.10%" When the preferred provider is assumed by default, the PREFERRED_PROVIDER statement does not appear in the <bsp_name>.conf file. - You would use the linux-yocto_3.8.bbappend file to append + You would use the linux-yocto_3.10.bbappend file to append specific BSP settings to the kernel, thus configuring the kernel for your particular BSP. As an example, look at the existing Crown Bay BSP. The append file used is: - meta-crownbay/recipes-kernel/linux/linux-yocto_3.8.bbappend + meta-crownbay/recipes-kernel/linux/linux-yocto_3.10.bbappend The following listing shows the file. Be aware that the actual commit ID strings in this example listing might be different @@ -532,46 +516,18 @@ FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" - COMPATIBLE_MACHINE_crownbay = "crownbay" - KMACHINE_crownbay = "crownbay" - KBRANCH_crownbay = "standard/crownbay" - KERNEL_FEATURES_crownbay_append = " features/drm-emgd/drm-emgd-1.16 cfg/vesafb" - COMPATIBLE_MACHINE_crownbay-noemgd = "crownbay-noemgd" KMACHINE_crownbay-noemgd = "crownbay" KBRANCH_crownbay-noemgd = "standard/crownbay" - KERNEL_FEATURES_crownbay-noemgd_append = " cfg/vesafb" - - LINUX_VERSION = "3.8.4" - - SRCREV_meta_crownbay = "2a6d36e75ca0a121570a389d7bab76ec240cbfda" - SRCREV_machine_crownbay = "47aed0c17c1c55988198ad39f86ae88894c8e0a4" - SRCREV_emgd_crownbay = "c780732f175ff0ec866fac2130175876b519b576" - - SRCREV_meta_crownbay-noemgd = "2a6d36e75ca0a121570a389d7bab76ec240cbfda" - SRCREV_machine_crownbay-noemgd = "47aed0c17c1c55988198ad39f86ae88894c8e0a4" + KERNEL_FEATURES_append_crownbay-noemgd = " cfg/vesafb" - SRC_URI_crownbay = "git://git.yoctoproject.org/linux-yocto-3.8.git;protocol=git;nocheckout=1;branch=${KBRANCH},${KMETA},emgd-1.16;name=machine,meta,emgd" - - This append file contains statements used to support the Crown Bay BSP for both - Intel EMGD and the VESA graphics. - The build process, in this case, recognizes and uses only the statements that - apply to the defined machine name - crownbay in this case. - So, the applicable statements in the linux-yocto_3.8.bbappend - file are follows: - - FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" - - COMPATIBLE_MACHINE_crownbay = "crownbay" - KMACHINE_crownbay = "crownbay" - KBRANCH_crownbay = "standard/crownbay" - KERNEL_FEATURES_crownbay_append = " features/drm-emgd/drm-emgd-1.16 cfg/vesafb" + LINUX_VERSION = "3.10.11" - SRCREV_meta_crownbay = "2a6d36e75ca0a121570a389d7bab76ec240cbfda" - SRCREV_machine_crownbay = "47aed0c17c1c55988198ad39f86ae88894c8e0a4" - SRCREV_emgd_crownbay = "c780732f175ff0ec866fac2130175876b519b576" + SRCREV_meta_crownbay-noemgd = "285f93bf942e8f6fa678ffc6cc53696ed5400718" + SRCREV_machine_crownbay-noemgd = "702040ac7c7ec66a29b4d147665ccdd0ff015577" - The append file defines crownbay as the + This append file contains statements used to support the Crown Bay BSP. + The file defines crownbay as the COMPATIBLE_MACHINE and uses the KMACHINE variable to @@ -588,12 +544,6 @@ Source Directory Git repository and the meta Git repository branches to identify the exact kernel needed to build the Crown Bay BSP. - - For crownbay, a specific commit is also needed to point - to the branch that supports EMGD graphics. - At a minimum, every BSP points to the - machine and meta commits. - @@ -1281,31 +1231,35 @@ Following is the complete example: $ yocto-bsp create myarm qemu + Checking basic git connectivity... + Done. + Which qemu architecture would you like to use? [default: i386] - 1) i386 (32-bit) + 1) i386 (32-bit) 2) x86_64 (64-bit) 3) ARM (32-bit) 4) PowerPC (32-bit) 5) MIPS (32-bit) 3 - Would you like to use the default (3.8) kernel? (y/n) [default: y] + Would you like to use the default (3.10) kernel? (y/n) [default: y] y Do you need a new machine branch for this BSP (the alternative is to re-use an existing branch)? [y/n] [default: y] - Getting branches from remote repo git://git.yoctoproject.org/linux-yocto-3.8.git... + Getting branches from remote repo git://git.yoctoproject.org/linux-yocto-3.10.git... Please choose a machine branch to base your new BSP branch on: [default: standard/base] - 1) standard/arm-versatile-926ejs - 2) standard/base - 3) standard/beagleboard - 4) standard/ck - 5) standard/crownbay - 6) standard/edf - 7) standard/emenlow - 8) standard/fri2 - 9) standard/fsl-mpc8315e-rdb - 10) standard/mti-malta32 - 11) standard/mti-malta64 - 12) standard/qemuppc - 13) standard/routerstationpro - 14) standard/sys940x + 1) standard/arm-versatile-926ejs + 2) standard/base + 3) standard/beagleboard + 4) standard/ck + 5) standard/crownbay + 6) standard/edf + 7) standard/emenlow + 8) standard/fri2 + 9) standard/fsl-mpc8315e-rdb + 10) standard/minnow + 11) standard/mti-malta32 + 12) standard/mti-malta64 + 13) standard/qemuppc + 14) standard/routerstationpro + 15) standard/sys940x 1 Would you like SMP support? (y/n) [default: y] Does your BSP have a touchscreen? (y/n) [default: n] @@ -1320,7 +1274,7 @@ In the example, we use the ARM architecture. The script then prompts you for the kernel. - The default 3.8 kernel is acceptable. + The default 3.10 kernel is acceptable. So, the example accepts the default. If you enter 'n', the script prompts you to further enter the kernel you do want to use (e.g. 3.2, 3.2_preempt-rt, and so forth.). -- cgit 1.2.3-korg