diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2017-09-20 08:05:07 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2017-09-22 17:53:44 +0100 |
commit | 46d9bd00761854527748ffdcfe6896e88187bbf2 (patch) | |
tree | 877ae9fbb779ad850c0f27858d0e80f2169b9463 /documentation/kernel-dev/kernel-dev-common.xml | |
parent | 4db9f488546fda5eb287a1337bd7213005aed864 (diff) | |
download | poky-46d9bd00761854527748ffdcfe6896e88187bbf2.tar.gz |
kernel-dev: Updated 4.4 to 4.12 for kernel example in layer
(From yocto-docs rev: ba8dd3676e3800b8356b7de948ceeb6e4cba4bbf)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/kernel-dev/kernel-dev-common.xml')
-rw-r--r-- | documentation/kernel-dev/kernel-dev-common.xml | 72 |
1 files changed, 40 insertions, 32 deletions
diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml index c6d1bdaac1..c4396696b8 100644 --- a/documentation/kernel-dev/kernel-dev-common.xml +++ b/documentation/kernel-dev/kernel-dev-common.xml | |||
@@ -563,11 +563,11 @@ | |||
563 | You also name it accordingly based on the linux-yocto recipe | 563 | You also name it accordingly based on the linux-yocto recipe |
564 | you are using. | 564 | you are using. |
565 | For example, if you are modifying the | 565 | For example, if you are modifying the |
566 | <filename>meta/recipes-kernel/linux/linux-yocto_4.4.bb</filename> | 566 | <filename>meta/recipes-kernel/linux/linux-yocto_4.12.bb</filename> |
567 | recipe, the append file will typically be located as follows | 567 | recipe, the append file will typically be located as follows |
568 | within your custom layer: | 568 | within your custom layer: |
569 | <literallayout class='monospaced'> | 569 | <literallayout class='monospaced'> |
570 | <replaceable>your-layer</replaceable>/recipes-kernel/linux/linux-yocto_4.4.bbappend | 570 | <replaceable>your-layer</replaceable>/recipes-kernel/linux/linux-yocto_4.12.bbappend |
571 | </literallayout> | 571 | </literallayout> |
572 | The append file should initially extend the | 572 | The append file should initially extend the |
573 | <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESPATH'><filename>FILESPATH</filename></ulink> | 573 | <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESPATH'><filename>FILESPATH</filename></ulink> |
@@ -598,7 +598,7 @@ | |||
598 | As an example, consider the following append file | 598 | As an example, consider the following append file |
599 | used by the BSPs in <filename>meta-yocto-bsp</filename>: | 599 | used by the BSPs in <filename>meta-yocto-bsp</filename>: |
600 | <literallayout class='monospaced'> | 600 | <literallayout class='monospaced'> |
601 | meta-yocto-bsp/recipes-kernel/linux/linux-yocto_4.4.bbappend | 601 | meta-yocto-bsp/recipes-kernel/linux/linux-yocto_4.12.bbappend |
602 | </literallayout> | 602 | </literallayout> |
603 | The following listing shows the file. | 603 | The following listing shows the file. |
604 | Be aware that the actual commit ID strings in this | 604 | Be aware that the actual commit ID strings in this |
@@ -615,11 +615,12 @@ | |||
615 | KBRANCH_beaglebone = "standard/beaglebone" | 615 | KBRANCH_beaglebone = "standard/beaglebone" |
616 | KBRANCH_mpc8315e-rdb = "standard/fsl-mpc8315e-rdb" | 616 | KBRANCH_mpc8315e-rdb = "standard/fsl-mpc8315e-rdb" |
617 | 617 | ||
618 | SRCREV_machine_genericx86 ?= "ad8b1d659ddd2699ebf7d50ef9de8940b157bfc2" | 618 | SRCREV_machine_genericx86 ?= "d09f2ce584d60ecb7890550c22a80c48b83c2e19" |
619 | SRCREV_machine_genericx86-64 ?= "ad8b1d659ddd2699ebf7d50ef9de8940b157bfc2" | 619 | SRCREV_machine_genericx86-64 ?= "d09f2ce584d60ecb7890550c22a80c48b83c2e19" |
620 | SRCREV_machine_edgerouter ?= "cebe1ad56aebd89e0de29412e19433fb441bf13c" | 620 | SRCREV_machine_edgerouter ?= "b5c8cfda2dfe296410d51e131289fb09c69e1e7d" |
621 | SRCREV_machine_beaglebone ?= "cebe1ad56aebd89e0de29412e19433fb441bf13c" | 621 | SRCREV_machine_beaglebone ?= "b5c8cfda2dfe296410d51e131289fb09c69e1e7d" |
622 | SRCREV_machine_mpc8315e-rdb ?= "06c0dbdcba374ca7f92a53d69292d6bb7bc9b0f3" | 622 | SRCREV_machine_mpc8315e-rdb ?= "2d1d010240846d7bff15d1fcc0cb6eb8a22fc78a" |
623 | |||
623 | 624 | ||
624 | COMPATIBLE_MACHINE_genericx86 = "genericx86" | 625 | COMPATIBLE_MACHINE_genericx86 = "genericx86" |
625 | COMPATIBLE_MACHINE_genericx86-64 = "genericx86-64" | 626 | COMPATIBLE_MACHINE_genericx86-64 = "genericx86-64" |
@@ -627,11 +628,11 @@ | |||
627 | COMPATIBLE_MACHINE_beaglebone = "beaglebone" | 628 | COMPATIBLE_MACHINE_beaglebone = "beaglebone" |
628 | COMPATIBLE_MACHINE_mpc8315e-rdb = "mpc8315e-rdb" | 629 | COMPATIBLE_MACHINE_mpc8315e-rdb = "mpc8315e-rdb" |
629 | 630 | ||
630 | LINUX_VERSION_genericx86 = "4.4.41" | 631 | LINUX_VERSION_genericx86 = "4.12.7" |
631 | LINUX_VERSION_genericx86-64 = "4.4.41" | 632 | LINUX_VERSION_genericx86-64 = "4.12.7" |
632 | LINUX_VERSION_edgerouter = "4.4.53" | 633 | LINUX_VERSION_edgerouter = "4.12.10" |
633 | LINUX_VERSION_beaglebone = "4.4.53" | 634 | LINUX_VERSION_beaglebone = "4.12.10" |
634 | LINUX_VERSION_mpc8315e-rdb = "4.4.53" | 635 | LINUX_VERSION_mpc8315e-rdb = "4.12.10" |
635 | </literallayout> | 636 | </literallayout> |
636 | This append file contains statements used to support | 637 | This append file contains statements used to support |
637 | several BSPs that ship with the Yocto Project. | 638 | several BSPs that ship with the Yocto Project. |
@@ -662,8 +663,8 @@ | |||
662 | 663 | ||
663 | <para> | 664 | <para> |
664 | One thing missing in this particular BSP, which you will | 665 | One thing missing in this particular BSP, which you will |
665 | typically need when developing a BSP, is the kernel configuration | 666 | typically need when developing a BSP, is the kernel |
666 | file (<filename>.config</filename>) for your BSP. | 667 | configuration file (<filename>.config</filename>) for your BSP. |
667 | When developing a BSP, you probably have a kernel configuration | 668 | When developing a BSP, you probably have a kernel configuration |
668 | file or a set of kernel configuration files that, when taken | 669 | file or a set of kernel configuration files that, when taken |
669 | together, define the kernel configuration for your BSP. | 670 | together, define the kernel configuration for your BSP. |
@@ -671,7 +672,8 @@ | |||
671 | in a file or a set of files inside a directory located at the | 672 | in a file or a set of files inside a directory located at the |
672 | same level as your kernel's append file and having the same | 673 | same level as your kernel's append file and having the same |
673 | name as the kernel's main recipe file. | 674 | name as the kernel's main recipe file. |
674 | With all these conditions met, simply reference those files in the | 675 | With all these conditions met, simply reference those files in |
676 | the | ||
675 | <ulink url='&YOCTO_DOCS_REF_URL;#var-SRC_URI'><filename>SRC_URI</filename></ulink> | 677 | <ulink url='&YOCTO_DOCS_REF_URL;#var-SRC_URI'><filename>SRC_URI</filename></ulink> |
676 | statement in the append file. | 678 | statement in the append file. |
677 | </para> | 679 | </para> |
@@ -717,25 +719,31 @@ | |||
717 | 719 | ||
718 | <note> | 720 | <note> |
719 | <para> | 721 | <para> |
720 | Other methods exist to accomplish grouping and defining configuration options. | 722 | Other methods exist to accomplish grouping and defining |
721 | For example, if you are working with a local clone of the kernel repository, | 723 | configuration options. |
722 | you could checkout the kernel's <filename>meta</filename> branch, make your changes, | 724 | For example, if you are working with a local clone of the |
723 | and then push the changes to the local bare clone of the kernel. | 725 | kernel repository, you could checkout the kernel's |
724 | The result is that you directly add configuration options to the | 726 | <filename>meta</filename> branch, make your changes, and |
725 | <filename>meta</filename> branch for your BSP. | 727 | then push the changes to the local bare clone of the |
726 | The configuration options will likely end up in that location anyway if the BSP gets | 728 | kernel. |
727 | added to the Yocto Project. | 729 | The result is that you directly add configuration options |
730 | to the <filename>meta</filename> branch for your BSP. | ||
731 | The configuration options will likely end up in that | ||
732 | location anyway if the BSP gets added to the Yocto Project. | ||
728 | </para> | 733 | </para> |
729 | 734 | ||
730 | <para> | 735 | <para> |
731 | In general, however, the Yocto Project maintainers take care of moving the | 736 | In general, however, the Yocto Project maintainers take |
732 | <filename>SRC_URI</filename>-specified | 737 | care of moving the <filename>SRC_URI</filename>-specified |
733 | configuration options to the kernel's <filename>meta</filename> branch. | 738 | configuration options to the kernel's |
734 | Not only is it easier for BSP developers to not have to worry about putting those | 739 | <filename>meta</filename> branch. |
735 | configurations in the branch, but having the maintainers do it allows them to apply | 740 | Not only is it easier for BSP developers to not have to |
736 | 'global' knowledge about the kinds of common configuration options multiple BSPs in | 741 | worry about putting those configurations in the branch, |
737 | the tree are typically using. | 742 | but having the maintainers do it allows them to apply |
738 | This allows for promotion of common configurations into common features. | 743 | 'global' knowledge about the kinds of common configuration |
744 | options multiple BSPs in the tree are typically using. | ||
745 | This allows for promotion of common configurations into | ||
746 | common features. | ||
739 | </para> | 747 | </para> |
740 | </note> | 748 | </note> |
741 | </section> | 749 | </section> |