weston-ini-conf: (re)move Weston remoting support
[AGL/meta-agl.git] / meta-agl.md
index 59167ad..be43696 100755 (executable)
@@ -7,9 +7,6 @@ You use this layer as the minimal core on which to build AGL profiles.
 **NOTE:** The `meta-agl` layer does not include a reference UI.
   The reference UI is included as part of the
   [`meta-agl-demo`](./meta-agl-demo.html) layer.
-  Furthermore, `meta-agl` does not include additional components, such
-  as security, which are part of the
-  [`meta-agl-extra`](./meta-agl-extra.html) layer.
 
 ## Sub-Layers
 
@@ -17,59 +14,42 @@ The `meta-agl` layer itself contains many sub-layers and files.
 Following is a "tree" look at the layer:
 
 ```
-.
-├── docs
-├── meta-agl
-├── meta-agl-bsp
-├── meta-agl-distro
-├── meta-agl-profile-cluster
-├── meta-agl-profile-cluster-qt5
-├── meta-agl-profile-core
-├── meta-agl-profile-graphical
-├── meta-agl-profile-graphical-html5
-├── meta-agl-profile-graphical-qt5
-├── meta-agl-profile-hud
-├── meta-agl-profile-telematics
-├── meta-app-framework
-├── meta-netboot
-├── meta-security
-├── README-AGL.md
-├── README.md
-├── scripts
-├── templates
+|-- LICENSE
+|-- LICENSE.GPL-2.0-only
+|-- LICENSE.MIT
+|-- README-AGL.md
+|-- README.md -> meta-agl.md
+|-- agl-layers-overview.md
+|-- docs
+|-- meta-agl-bsp
+|-- meta-agl-core
+|-- meta-agl-core-test
+|-- meta-agl-ic
+|-- meta-agl-ivi
+|-- meta-agl.md
+|-- meta-netboot
+|-- meta-pipewire
+|-- scripts
+`-- templates
 ```
 
 This list provides some overview information on the files and sub-layers
 in `meta-agl`:
 
+* LICENSE* : licenses of the various components. 
+* README* : RTFM
+* agl-layers-overview.md: references to the various layers that make up AGL
 * `docs`: Contains files that support AGL documentation.
-* `meta-agl`: Contains layer configuration for the `meta-agl` layer.
 * `meta-agl-bsp`: Contains adaptations for recipes and required packages
   to boot an AGL distribution on targeted hardware and emulation (i.e. QEMU).
-* `meta-agl-distro`: Contains distro configuration and supporting scripts.
-* `meta-agl-profile-cluster`: The middleware for the AGL cluster profile.
-  The set of packages required for AGL Cluster Distribution.
-  Profiles include support for Wayland images.
-* `meta-agl-profile-cluster-qt5`: The middleware for the AGL Qt5-based cluster profile.
-  The set of packages required for AGL Qt5-based Cluster Distribution.
-  Profiles include support for Wayland images with Qt5.
-* `meta-agl-profile-core`: Configuration and recipes for the AGL core profiles.
-* `meta-agl-profile-graphical`: Configuration and recipes supporting graphical user
-  interfaces.
-* `meta-agl-profile-graphical-html5`: Configuration and recipes supporting profiles
-  with HTML user interface support.
-* `meta-agl-profile-graphical-qt5`: Configuration and recipes supporting profiles
-  with Qt5-based user interface support.
-* `meta-agl-profile-hud`: Configuration and recipes supporting profiles with
-  Head-Up-Display (HUD) support.
-* `meta-agl-profile-telematics`: Configuration and recipes supporting profiles with
-  telematics support.
-* `meta-app-framework`: Configuration and recipes supporting the AGL Application
-  Framework.
+* `meta-agl-core`: This is the core layer with essential recipes and the distro.
+* `meta-agl-core-test`: recipes supporting qa images (separate layer due to external dependencies)
+* `meta-agl-ic`: Instrument Cluster platform
+* `meta-agl-ivi`: IVI platform
 * `meta-netboot`: Contains recipes and configuration adjustments to allow network
   boot through network block device (NBD) since network file system (NFS) does not
   support security labels.
-* `meta-security`: Configuration and recipes supporting security applications.
+* `meta-pipewire`: Configuration and recipes supporting pipewire as audio manager
 * `scripts`: AGL development setup and support scripts.
 * `templates`: Base, feature, and machine templates used in the AGL development
   environment.
@@ -80,63 +60,40 @@ This section describes the AGL
 [packagegroup](https://yoctoproject.org/docs/2.4.4/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)
 design:
 
-* packagegroup-agl-image-minimal
-
-        packagegroup-agl-core-automotive.bb
-        packagegroup-agl-core-connectivity.bb
-        packagegroup-agl-core-graphics.bb
-        packagegroup-agl-core-kernel.bb
-        packagegroup-agl-core-multimedia.bb
-        packagegroup-agl-core-navi-lbs.bb
-        packagegroup-agl-core-os-commonlibs.bb
-        packagegroup-agl-core-security.bb
-        packagegroup-agl-core-speech-services.bb
-
-  The previous list of Packagegroups are used to create the `agl-image-minimal` image,
-  which is a small image just capable of allowing a device to boot.
-
-  Subsystem should maintain packagegroup-agl-core-[subsystem].bb which should
-  hold sufficient packages to build `agl-image-minimal`.
-
-* packagegroup-agl-image-ivi
-
-        packagegroup-agl-ivi-automotive.bb
-        packagegroup-agl-ivi-connectivity.bb
-        packagegroup-agl-ivi-graphics.bb
-        packagegroup-agl-ivi-kernel.bb
-        packagegroup-agl-ivi-multimedia.bb
-        packagegroup-agl-ivi-navi-lbs.bb
-        packagegroup-agl-ivi-os-commonlibs.bb
-        packagegroup-agl-ivi-security.bb
-        packagegroup-agl-ivi-speech-services.bb
-
-  The previous list of Packagegroups are used to create the `agl-image-ivi`
-  image, which is a baseline image (i.e. Service Layer and Operating System
-  Layer defined in AGL Spec v1.0) for the AGL profiles.
-
-* packagegroup-agl-test.bb
-
-  Additional tools used in QA tests (for agl-image*-qa).
-
-<!--
-* packagegroup-ivi-common*
-
-        packagegroup-ivi-common-core-automotive.bb
-        packagegroup-ivi-common-core.bb
-        packagegroup-ivi-common-core-connectivity.bb
-        packagegroup-ivi-common-core-graphics.bb
-        packagegroup-ivi-common-core-kernel.bb
-        packagegroup-ivi-common-core-multimedia.bb
-        packagegroup-ivi-common-core-navi-lbs.bb
-        packagegroup-ivi-common-core-os-commonlibs.bb
-        packagegroup-ivi-common-core-security.bb
-        packagegroup-ivi-common-core-speech-services.bb
-        packagegroup-ivi-common-test.bb
-
-The previous Packagegroups pick up some packages from upstream
-locations such as
-[GENIVI Alliance](https://www.genivi.org/) and others.
-The `meta-ivi-common` layer produces no image.
-All the Packagegroups in this layer are aggregated to `packagegroup-ivi-common-core`,
-which is included by the images and the two recipes  `agl-image-ivi.bb` and `agl-demo-platform.bb`.
--->
+### core non-ui packagegroups:
+meta-agl-core/recipes-platform/packagegroups/packagegroup-agl-core-connectivity.bb
+meta-agl-core/recipes-platform/packagegroups/packagegroup-agl-core-devel.bb
+meta-agl-core/recipes-platform/packagegroups/packagegroup-agl-core-security.bb
+meta-agl-core/recipes-platform/packagegroups/packagegroup-agl-core-os-commonlibs.bb
+
+### graphical subsystem
+meta-agl-core/recipes-platform/packagegroups/packagegroup-agl-profile-graphical.bb
+meta-agl-core/recipes-platform/packagegroups/packagegroup-agl-graphical-multimedia.bb
+meta-agl-core/recipes-platform/packagegroups/packagegroup-agl-graphical-weston.bb
+
+### image-related packagegroups
+meta-agl-core/recipes-platform/packagegroups/packagegroup-agl-core-boot.bb
+meta-agl-core/recipes-platform/packagegroups/packagegroup-agl-image-boot.bb
+meta-agl-core/recipes-platform/packagegroups/packagegroup-agl-image-minimal.bb
+
+### QA/Test related packagegroups
+meta-agl-core-test/recipes-test/packagegroups
+meta-agl-core-test/recipes-test/packagegroups/packagegroup-agl-test.bb
+
+## Images
+
+### (Barely) bootable image
+meta-agl-core/recipes-platform/images/agl-image-boot.bb
+
+### minimal image and SDK (console)
+meta-agl-core/recipes-platform/images/agl-image-minimal.bb
+meta-agl-core/recipes-platform/images/agl-image-minimal-crosssdk.bb
+
+### weston-based image for re-use
+meta-agl-core/recipes-platform/images/agl-image-weston.bb
+
+### image for use in the YP autobuilder
+meta-agl-core/recipes-platform/images/agl-image-core-autobuilder.bb
+
+### image with extra QA tooling (e.g. to run LTP)
+meta-agl-core-test/images/agl-image-minimal-qa.bb