Skip to contentSkip to conversation

bsp-guide: replace meta-intel with meta-xilinx as container layer

PATCH In review Robert P. J. Day 4 participants 9 messages May 2, 2019 – May 3, 2019

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 bsp-guide: replace meta-intel with meta-xilinx as container layer

As meta-intel is no longer a container layer, use meta-xilinx as an example instead.

---

documentation/bsp-guide/bsp.xml +7 -10
index 0bb0b68ab..a53ff6bce 100644
@@ -146,18 +146,15 @@
 
     <para>
         Some layers function as a layer to hold other BSP layers.
-        These layers are knows as
+        These layers are known as
         "<ulink url='&YOCTO_DOCS_REF_URL;#term-container-layer'>container layers</ulink>".
         An example of this type of layer is the
-        <filename>meta-intel</filename> layer.
-        This layer contains BSP layers for the Intel-core2-32
-        <trademark class='registered'>Intel</trademark> Common Core
-        (Intel-core2-32) and the Intel-corei7-64
-        <trademark class='registered'>Intel</trademark> Common Core
-        (Intel-corei7-64).
-        the <filename>meta-intel</filename> layer also contains
-        the <filename>common/</filename> directory, which contains
-        common content across those layers.
+        <filename>meta-xilinx</filename> layer.
+        This container layer contains some basic top-level information,
+        as well as three actual Xilinx-related BSP layers,
+        <filename>meta-xilinx-bsp</filename>,
+        <filename>meta-xilinx-contrib</filename>, and
+        <filename>meta-xilinx-standalone</filename>.
     </para>
 
     <para>
Signature · 7 lines
========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                         http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================
#1 lore raw
Quoted 2 lines · Robert P. J. Day

As meta-intel is no longer a container layer, use meta-xilinx as an example instead.

I thought "meta-virtualization" was a container layer?

IMHO, a BSP should only deal with getting a MACHINE booted.

- armin

Quoted 36 lines

---

documentation/bsp-guide/bsp.xml +7 -10
index 0bb0b68ab..a53ff6bce 100644
@@ -146,18 +146,15 @@
 
     <para>
         Some layers function as a layer to hold other BSP layers.
-        These layers are knows as
+        These layers are known as
         "<ulink url='&YOCTO_DOCS_REF_URL;#term-container-layer'>container layers</ulink>".
         An example of this type of layer is the
-        <filename>meta-intel</filename> layer.
-        This layer contains BSP layers for the Intel-core2-32
-        <trademark class='registered'>Intel</trademark> Common Core
-        (Intel-core2-32) and the Intel-corei7-64
-        <trademark class='registered'>Intel</trademark> Common Core
-        (Intel-corei7-64).
-        the <filename>meta-intel</filename> layer also contains
-        the <filename>common/</filename> directory, which contains
-        common content across those layers.
+        <filename>meta-xilinx</filename> layer.
+        This container layer contains some basic top-level information,
+        as well as three actual Xilinx-related BSP layers,
+        <filename>meta-xilinx-bsp</filename>,
+        <filename>meta-xilinx-contrib</filename>, and
+        <filename>meta-xilinx-standalone</filename>.
     </para>
 
     <para>
#2 lore raw

The term "Container Layer" was put in the ref-manual by me to describe a "meta-*" layer that had other "meta-*" layers (see
https://www.yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#term-container-layer
and the term "Container Layer"). Maybe this was never a good term? I don't know. Nobody has said anything about that term for many releases.

The problem Robert points out needs to be fixed in the BSP manual as "meta-intel" is not longer qualifying by my definition. I can fix that.

Is "Container Layer" ok as I have defined it?

Thanks,
Scott

Quoted 56 lines · akuster
Quoted 2 lines · Robert P. J. Day

As meta-intel is no longer a container layer, use meta-xilinx as an example instead.

I thought "meta-virtualization" was a container layer?

IMHO, a BSP should only deal with getting a MACHINE booted.

- armin

Review

Quoted 6 lines

---

(quoted diff) +0 -0

b/documentation/bsp-guide/bsp.xml

documentation/bsp-guide/bsp.xml line 150

Quoted 10 lines

index 0bb0b68ab..a53ff6bce 100644

documentation/bsp-guide/bsp.xml +1 -1
@@ -146,18 +146,15 @@
 
     <para>
         Some layers function as a layer to hold other BSP layers.
-        These layers are knows as
+        These layers are known as
         "<ulink

url='&YOCTO_DOCS_REF_URL;#term-container-layer'>container layers</ulink>".

Quoted 10 lines
documentation/bsp-guide/bsp.xml +0 -8
         An example of this type of layer is the
-        <filename>meta-intel</filename> layer.
-        This layer contains BSP layers for the Intel-core2-32
-        <trademark class='registered'>Intel</trademark> Common Core
-        (Intel-core2-32) and the Intel-corei7-64
-        <trademark class='registered'>Intel</trademark> Common Core
-        (Intel-corei7-64).
-        the <filename>meta-intel</filename> layer also contains
-        the <filename>common/</filename> directory, which contains

documentation/bsp-guide/bsp.xml line 160

Quoted 10 lines
documentation/bsp-guide/bsp.xml +6 -1
-        common content across those layers.
+        <filename>meta-xilinx</filename> layer.
+        This container layer contains some basic top-level information,
+        as well as three actual Xilinx-related BSP layers,
+        <filename>meta-xilinx-bsp</filename>,
+        <filename>meta-xilinx-contrib</filename>, and
+        <filename>meta-xilinx-standalone</filename>.
     </para>
 
     <para>

--
_______________________________________________
yocto mailing list
[email protected]
https://lists.yoctoproject.org/listinfo/yocto

#3 lore raw
Quoted 10 lines · Scott Rifenbark

The term "Container Layer" was put in the ref-manual by me to describe a "meta-*" layer that had other "meta-*" layers (see
https://www.yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#term-container-layer
and the term "Container Layer").  Maybe this was never a good term?  I don't know.  Nobody has said anything about that term for many releases.

The problem Robert points out needs to be fixed in the BSP manual as "meta-intel" is not longer qualifying by my definition.  I can fix that.

Is "Container Layer" ok as I have defined it?

in those terms above, yes its fine.

thanks for clarifying.

Armin

Quoted 66 lines

Thanks,
Scott

On Thu, May 2, 2019 at 10:21 AM akuster <[email protected] <mailto:[email protected]>> wrote:

On 5/2/19 6:19 AM, Robert P. J. Day wrote:
> As meta-intel is no longer a container layer, use meta-xilinx as > an example instead.

I thought "meta-virtualization" was a container layer?

IMHO, a BSP should only deal with getting a MACHINE booted.

- armin
>
> Signed-off-by: Robert P. J. Day <[email protected] <mailto:[email protected]>>
>
> ---
>
> diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
> index 0bb0b68ab..a53ff6bce 100644
> --- a/documentation/bsp-guide/bsp.xml
> +++ b/documentation/bsp-guide/bsp.xml
> @@ -146,18 +146,15 @@
>
>      <para>
>          Some layers function as a layer to hold other BSP layers. > -        These layers are knows as
> +        These layers are known as
>          "<ulink url='&YOCTO_DOCS_REF_URL;#term-container-layer'>container layers</ulink>".
>          An example of this type of layer is the
> -        <filename>meta-intel</filename> layer.
> -        This layer contains BSP layers for the Intel-core2-32 > -        <trademark class='registered'>Intel</trademark> Common Core > -        (Intel-core2-32) and the Intel-corei7-64
> -        <trademark class='registered'>Intel</trademark> Common Core > -        (Intel-corei7-64).
> -        the <filename>meta-intel</filename> layer also contains > -        the <filename>common/</filename> directory, which contains > -        common content across those layers.
> +        <filename>meta-xilinx</filename> layer.
> +        This container layer contains some basic top-level information,
> +        as well as three actual Xilinx-related BSP layers, > +        <filename>meta-xilinx-bsp</filename>,
> +        <filename>meta-xilinx-contrib</filename>, and
> +        <filename>meta-xilinx-standalone</filename>.
>      </para>
>
>      <para>
>

--
_______________________________________________
yocto mailing list
[email protected] <mailto:[email protected]>
https://lists.yoctoproject.org/listinfo/yocto

#4 lore raw

Great, thanks!

Quoted 85 lines · akuster

On 5/2/19 10:45 AM, Scott Rifenbark wrote:

The term "Container Layer" was put in the ref-manual by me to describe a "meta-*" layer that had other "meta-*" layers (see
https://www.yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#term-container-layer
and the term "Container Layer"). Maybe this was never a good term? I don't know. Nobody has said anything about that term for many releases.

The problem Robert points out needs to be fixed in the BSP manual as "meta-intel" is not longer qualifying by my definition. I can fix that.

Is "Container Layer" ok as I have defined it?

in those terms above, yes its fine.

thanks for clarifying.

Armin

Thanks,
Scott

Quoted 56 lines · akuster
Quoted 2 lines · Robert P. J. Day

As meta-intel is no longer a container layer, use meta-xilinx as an example instead.

I thought "meta-virtualization" was a container layer?

IMHO, a BSP should only deal with getting a MACHINE booted.

- armin

Review

Quoted 6 lines

---

(quoted diff) +0 -0

b/documentation/bsp-guide/bsp.xml

documentation/bsp-guide/bsp.xml line 150

Quoted 10 lines

index 0bb0b68ab..a53ff6bce 100644

documentation/bsp-guide/bsp.xml +1 -1
@@ -146,18 +146,15 @@
 
     <para>
         Some layers function as a layer to hold other BSP layers.
-        These layers are knows as
+        These layers are known as
         "<ulink

url='&YOCTO_DOCS_REF_URL;#term-container-layer'>container layers</ulink>".

Quoted 10 lines
documentation/bsp-guide/bsp.xml +0 -8
         An example of this type of layer is the
-        <filename>meta-intel</filename> layer.
-        This layer contains BSP layers for the Intel-core2-32
-        <trademark class='registered'>Intel</trademark> Common Core
-        (Intel-core2-32) and the Intel-corei7-64
-        <trademark class='registered'>Intel</trademark> Common Core
-        (Intel-corei7-64).
-        the <filename>meta-intel</filename> layer also contains
-        the <filename>common/</filename> directory, which contains

documentation/bsp-guide/bsp.xml line 160

Quoted 10 lines
documentation/bsp-guide/bsp.xml +6 -1
-        common content across those layers.
+        <filename>meta-xilinx</filename> layer.
+        This container layer contains some basic top-level information,
+        as well as three actual Xilinx-related BSP layers,
+        <filename>meta-xilinx-bsp</filename>,
+        <filename>meta-xilinx-contrib</filename>, and
+        <filename>meta-xilinx-standalone</filename>.
     </para>
 
     <para>

--
_______________________________________________
yocto mailing list
[email protected]
https://lists.yoctoproject.org/listinfo/yocto

#5 lore raw

much snipping ...

Quoted 8 lines · Scott Rifenbark

On Thu, May 2, 2019 at 10:21 AM akuster <[email protected]> wrote:

On 5/2/19 6:19 AM, Robert P. J. Day wrote:
> As meta-intel is no longer a container layer, use meta-xilinx as > an example instead.

I thought "meta-virtualization" was a container layer?

uh, i'm looking at meta-virtualization right now:

https://git.yoctoproject.org/cgit/cgit.cgi/meta-virtualization/tree/

and that looks like a regular BSP layer, not a container layer. am i misunderstanding some fundamental point here?

rday

Signature · 7 lines
========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                         http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================
#6 lore raw
In reply to Scott Rifenbark
Quoted 9 lines · Scott Rifenbark

Great, thanks!

On Thu, May 2, 2019 at 11:21 AM akuster <[email protected]> wrote:

On 5/2/19 6:19 AM, Robert P. J. Day wrote:
> As meta-intel is no longer a container layer, use meta-xilinx as > an example instead.

I thought "meta-virtualization" was a container layer?

as a followup, i would think that "meta-openembedded" is the
canonical example of a container layer, no?

rday

Signature · 7 lines
========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                         http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================
#7 lore raw
In reply to Scott Rifenbark
Quoted 12 lines · Scott Rifenbark

Great, thanks!

On Thu, May 2, 2019 at 11:21 AM akuster <[email protected]> wrote:

On 5/2/19 10:45 AM, Scott Rifenbark wrote:
The term "Container Layer" was put in the ref-manual by me to describe a "meta-*" layer that had other "meta-*" layers (see
https://www.yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#term-container-layer
and the term "Container Layer").  Maybe this was never a good term?  I don't know.  Nobody has said anything about that term for many releases.

Quoted 6 lines

The problem Robert points out needs to be fixed in the BSP manual as "meta-intel" is not longer qualifying by my definition.  I can fix that.

Is "Container Layer" ok as I have defined it?

in those terms above, yes its fine.

the more i think about it, the more i'm nervous about the phrase
"container layer", as it suggests a "layer" of some kind in the context of OE. the one distinction i think worth making is that a "BSP layer" is a layer expressly designed to support identified target systems (eg., meta-xilinx-bsp), while a non-BSP layer simply packages functionality (recipes, classes) -- a good example is meta-virtualization.

in either case, the trivial property of an OE layer is something
that can be specified in a bblayers.conf file. so i'm not sure *how* you would describe, for example, meta-openembedded.

i'm sure i'm overthinking this.

rday

Signature · 7 lines
========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                         http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================
#8 lore raw
Quoted 30 lines · Robert P. J. Day
Quoted 12 lines · Scott Rifenbark

Great, thanks!

On Thu, May 2, 2019 at 11:21 AM akuster <[email protected]> wrote:

On 5/2/19 10:45 AM, Scott Rifenbark wrote:
The term "Container Layer" was put in the ref-manual by me to describe a "meta-*" layer that had other "meta-*" layers (see
https://www.yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#term-container-layer
and the term "Container Layer"). Maybe this was never a good term? I don't know. Nobody has said anything about that term for many releases.

Quoted 6 lines

The problem Robert points out needs to be fixed in the BSP manual as "meta-intel" is not longer qualifying by my definition. I can fix that.

Is "Container Layer" ok as I have defined it?

in those terms above, yes its fine.

the more i think about it, the more i'm nervous about the phrase
"container layer", as it suggests a "layer" of some kind in the context of OE. the one distinction i think worth making is that a "BSP layer" is a layer expressly designed to support identified target systems (eg., meta-xilinx-bsp), while a non-BSP layer simply packages functionality (recipes, classes) -- a good example is meta-virtualization.

Quoted 3 lines

in either case, the trivial property of an OE layer is something
that can be specified in a bblayers.conf file. so i'm not sure *how* you would describe, for example, meta-openembedded.

Maybe just as a "metadata collection repo"? IMHO from a OE perspective, a "layer" is a metadata set which provides its own layer.conf file (which, as you say, means you can add it to your project's bblayers.conf). Bundling more than one layer within the same git repository (or whatever archive format use to distribute them) does not qualify this metadata collection as anything otherwise meaningful for bitbake. That said, meta-openembedded is definitely the most evident example of such a "concept". I agree the term "container layer" can be either confused with a OE layer, which technically is not, or something having to do with containers (as I suspect from Armin's reply), which is completely unrelated to. Maybe rewording a little bit the manual here could reduce potential confusion to new users. Moreover whatever term we choose to explain this concept, we should make clear that it is orthogonal to any other layer classification by content (i.e. BSP, distro, ...).

Quoted 17 lines

i'm sure i'm overthinking this.

rday

--

========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday

========================================================================--
_______________________________________________
yocto mailing list
[email protected]
https://lists.yoctoproject.org/listinfo/yocto