Updating AGL Layer documentation
[AGL/documentation.git] / docs / 04_Developer_Guides / 02_AGL_Layers / 02_meta_agl.md
index b8813a1..0f5d57e 100644 (file)
@@ -22,23 +22,21 @@ Following is a "tree" look at the layer:
 
 ```
 .
+├── LICENSE
+├── LICENSE.GPL-2.0-only
+├── LICENSE.MIT
+├── README-AGL.md
+├── README.md -> meta-agl.md
+├── agl-layers-overview.md
 ├── 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-agl-core
+├── meta-agl-core-test
+├── meta-agl-ic
+├── meta-agl-ivi
+├── meta-agl.md
 ├── meta-netboot
-├── meta-security
-├── README-AGL.md
-├── README.md
+├── meta-pipewire
 ├── scripts
 ├── templates
 ```
@@ -46,34 +44,20 @@ Following is a "tree" look at the layer:
 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.
@@ -84,40 +68,46 @@ This section describes the AGL
 [packagegroup](https://docs.yoctoproject.org/dev-manual/common-tasks.html#customizing-images-using-custom-package-groups)
 design:
 
-* packagegroup-agl-image-minimal
+### 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
 
-        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
+### 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
 
-  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.
+### weston-based image for re-use
+* meta-agl-core/recipes-platform/images/agl-image-weston.bb
 
-  Subsystem should maintain packagegroup-agl-core-[subsystem].bb which should
-  hold sufficient packages to build `agl-image-minimal`.
+### image for use in the YP autobuilder
+* meta-agl-core/recipes-platform/images/agl-image-core-autobuilder.bb
 
-* packagegroup-agl-image-ivi
+### image with extra QA tooling (e.g. to run LTP)
+* meta-agl-core-test/images/agl-image-minimal-qa.bb
 
-        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
+**Note:** For update details on this page please refer
 
-  Additional tools used in QA tests (for agl-image*-qa).
+<https://git.automotivelinux.org/AGL/meta-agl/tree/meta-agl.md>