docs/3_Developer_Guides/1_AGL_Layers/2_meta-agl.md

   1 ---
   2 edit_link: ''
   3 title: meta-agl
   4 origin_url: >-
   5   https://git.automotivelinux.org/AGL/meta-agl/plain/docs/../meta-agl.md?h=master
   6 ---
   7
   8 <!-- WARNING: This file is generated by fetch_docs.js using /home/boron/Documents/AGL/docs-webtemplate/site/_data/tocs/devguides/master/meta-agl-developer-guides-devguides-book.yml -->
   9
  10 ## Introduction
  11
  12 The `meta-agl` layer provides the minimal set of software
  13 to boot an AGL Distribution system.
  14 You use this layer as the minimal core on which to build AGL profiles.
  15
  16 **NOTE:** The `meta-agl` layer does not include a reference UI.
  17   The reference UI is included as part of the
  18   [`meta-agl-demo`](./meta-agl-demo.html) layer.
  19   Furthermore, `meta-agl` does not include additional components, such
  20   as security, which are part of the
  21   `meta-agl-extra` layer.
  22
  23 ## Sub-Layers
  24
  25 The `meta-agl` layer itself contains many sub-layers and files.
  26 Following is a "tree" look at the layer:
  27
  28 ```
  29 .
  30 ├── docs
  31 ├── meta-agl
  32 ├── meta-agl-bsp
  33 ├── meta-agl-distro
  34 ├── meta-agl-profile-cluster
  35 ├── meta-agl-profile-cluster-qt5
  36 ├── meta-agl-profile-core
  37 ├── meta-agl-profile-graphical
  38 ├── meta-agl-profile-graphical-html5
  39 ├── meta-agl-profile-graphical-qt5
  40 ├── meta-agl-profile-hud
  41 ├── meta-agl-profile-telematics
  42 ├── meta-app-framework
  43 ├── meta-netboot
  44 ├── meta-security
  45 ├── README-AGL.md
  46 ├── README.md
  47 ├── scripts
  48 ├── templates
  49 ```
  50
  51 This list provides some overview information on the files and sub-layers
  52 in `meta-agl`:
  53
  54 * `docs`: Contains files that support AGL documentation.
  55 * `meta-agl`: Contains layer configuration for the `meta-agl` layer.
  56 * `meta-agl-bsp`: Contains adaptations for recipes and required packages
  57   to boot an AGL distribution on targeted hardware and emulation (i.e. QEMU).
  58 * `meta-agl-distro`: Contains distro configuration and supporting scripts.
  59 * `meta-agl-profile-cluster`: The middleware for the AGL cluster profile.
  60   The set of packages required for AGL Cluster Distribution.
  61   Profiles include support for Wayland images.
  62 * `meta-agl-profile-cluster-qt5`: The middleware for the AGL Qt5-based cluster profile.
  63   The set of packages required for AGL Qt5-based Cluster Distribution.
  64   Profiles include support for Wayland images with Qt5.
  65 * `meta-agl-profile-core`: Configuration and recipes for the AGL core profiles.
  66 * `meta-agl-profile-graphical`: Configuration and recipes supporting graphical user
  67   interfaces.
  68 * `meta-agl-profile-graphical-html5`: Configuration and recipes supporting profiles
  69   with HTML user interface support.
  70 * `meta-agl-profile-graphical-qt5`: Configuration and recipes supporting profiles
  71   with Qt5-based user interface support.
  72 * `meta-agl-profile-hud`: Configuration and recipes supporting profiles with
  73   Head-Up-Display (HUD) support.
  74 * `meta-agl-profile-telematics`: Configuration and recipes supporting profiles with
  75   telematics support.
  76 * `meta-app-framework`: Configuration and recipes supporting the AGL Application
  77   Framework.
  78 * `meta-netboot`: Contains recipes and configuration adjustments to allow network
  79   boot through network block device (NBD) since network file system (NFS) does not
  80   support security labels.
  81 * `meta-security`: Configuration and recipes supporting security applications.
  82 * `scripts`: AGL development setup and support scripts.
  83 * `templates`: Base, feature, and machine templates used in the AGL development
  84   environment.
  85
  86 ## Packagegroups
  87
  88 This section describes the AGL
  89 [packagegroup](https://yoctoproject.org/docs/2.4.4/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)
  90 design:
  91
  92 * packagegroup-agl-image-minimal
  93
  94         packagegroup-agl-core-automotive.bb
  95         packagegroup-agl-core-connectivity.bb
  96         packagegroup-agl-core-graphics.bb
  97         packagegroup-agl-core-kernel.bb
  98         packagegroup-agl-core-multimedia.bb
  99         packagegroup-agl-core-navi-lbs.bb
 100         packagegroup-agl-core-os-commonlibs.bb
 101         packagegroup-agl-core-security.bb
 102         packagegroup-agl-core-speech-services.bb
 103
 104   The previous list of Packagegroups are used to create the `agl-image-minimal` image,
 105   which is a small image just capable of allowing a device to boot.
 106
 107   Subsystem should maintain packagegroup-agl-core-[subsystem].bb which should
 108   hold sufficient packages to build `agl-image-minimal`.
 109
 110 * packagegroup-agl-image-ivi
 111
 112         packagegroup-agl-ivi-automotive.bb
 113         packagegroup-agl-ivi-connectivity.bb
 114         packagegroup-agl-ivi-graphics.bb
 115         packagegroup-agl-ivi-kernel.bb
 116         packagegroup-agl-ivi-multimedia.bb
 117         packagegroup-agl-ivi-navi-lbs.bb
 118         packagegroup-agl-ivi-os-commonlibs.bb
 119         packagegroup-agl-ivi-security.bb
 120         packagegroup-agl-ivi-speech-services.bb
 121
 122   The previous list of Packagegroups are used to create the `agl-image-ivi`
 123   image, which is a baseline image (i.e. Service Layer and Operating System
 124   Layer defined in AGL Spec v1.0) for the AGL profiles.
 125
 126 * packagegroup-agl-test.bb
 127
 128   Additional tools used in QA tests (for agl-image*-qa).
 129