README.md

   1 # 'meta-agl' layer
   2
   3 See README-AGL.md for general information about Automotive Grade Linux.
   4
   5 ## meta-agl, the core layer for Automotive Grade Linux Distribution
   6
   7 AGL is creating an automotive specific Linux distribution that unifies
   8 the software that has been written in a number of places already,
   9 such as GENIVI and Tizen IVI.
  10
  11 The layer 'meta-agl' provides a minimal set of software
  12 to boot system of AGL Distribution. 'meta-agl' is the minimal
  13 core which is used build AGL profiles on top of it.
  14
  15 Especially there is no reference UI included which is part of 'meta-agl-demo'.
  16
  17 Additional components like the security framework are part of 'meta-agl-extra'.
  18
  19 The AGL community appreciates feedback, ideas, suggestion, bugs and
  20 documentation just as much as code. Please join the irc conversation
  21 at the #automotive channel on irc.freenode.net and our mailing list.
  22
  23 For infomation for subscribing to the mailing list
  24     [automotive-discussions](http://lists.linuxfoundation.org/mailman/listinfo/automotive-discussions)
  25 For information about AGL Distribution, see the
  26     [AGL Distribution](https://wiki.automotivelinux.org/agl-distro)
  27 For information abount Getting started with AGL
  28     [here](https://wiki.automotivelinux.org/start/getting-started)
  29 For information about contributing to the AGL Distro
  30     [here](https://wiki.automotivelinux.org/agl-distro/contributing)
  31
  32 ## Quick start guide
  33
  34 See README-AGL.md
  35
  36 ## 'meta-agl' Layer Dependencies
  37
  38 * poky
  39   > URI: git://git.yoctoproject.org/poky
  40   > branch         : jethro
  41   > tested revision: 40376446904ae3529be41737fed9a0b650ed167d
  42
  43 * meta-openembedded
  44   > URI: git://git.openembedded.org/meta-openembedded
  45   > layer          : meta-openembedded
  46   > branch         : jethro
  47   > tested revision: 8ab04afbffb4bc5184cfe0655049de6f44269990
  48
  49 Specifically out of meta-openembedded these sub-layers are used:
  50
  51 * meta-openembedded/meta-oe
  52 * meta-openembedded/meta-multimedia
  53 * meta-openembedded/meta-networking
  54 * meta-openembedded/meta-python
  55
  56 ## Layers
  57
  58 There are 5 layers in top-level `meta-agl`.
  59
  60 * `meta-agl/meta-ivi-common`\
  61   `meta-ivi-common` is a layer which contains common packages to AGL
  62   Distribution and other platforms for In-Vehicle Infotainment system.
  63 * `meta-agl/meta-agl`\
  64   `meta-agl` is a layer which contains AGL common and middleware packages.
  65 * `meta-agl/meta-agl-bsp`\
  66   `meta-agl-bsp` is a layer which contains required packages to boot AGL
  67   distribution on an emulated machine(QEMU).
  68 * `meta-agl/meta-netboot`\
  69   `meta-netboot` contains the netboot initrd support recipes. This is needed
  70   in case of booting over the network as NFS does not support the securitylabels.
  71
  72 ## Packagegroups
  73
  74 AGL package group design:
  75
  76 * packagegroup-agl-image-minimal
  77
  78         packagegroup-agl-core-automotive.bb
  79         packagegroup-agl-core-connectivity.bb
  80         packagegroup-agl-core-graphics.bb
  81         packagegroup-agl-core-kernel.bb
  82         packagegroup-agl-core-multimedia.bb
  83         packagegroup-agl-core-navi-lbs.bb
  84         packagegroup-agl-core-os-commonlibs.bb
  85         packagegroup-agl-core-security.bb
  86         packagegroup-agl-core-speech-services.bb
  87
  88 These are for making image ``agl-image-minimal`` which is small image just
  89 capable of allowing a device to boot.
  90
  91 Subsystem should maintain packagegroup-agl-core-[subsystem].bb which should
  92 hold sufficient packages to build ``agl-image-minimal``.
  93
  94 * packagegroup-agl-image-ivi
  95
  96         packagegroup-agl-ivi-automotive.bb
  97         packagegroup-agl-ivi-connectivity.bb
  98         packagegroup-agl-ivi-graphics.bb
  99         packagegroup-agl-ivi-kernel.bb
 100         packagegroup-agl-ivi-multimedia.bb
 101         packagegroup-agl-ivi-navi-lbs.bb
 102         packagegroup-agl-ivi-os-commonlibs.bb
 103         packagegroup-agl-ivi-security.bb
 104         packagegroup-agl-ivi-speech-services.bb
 105
 106 These are for making image ``agl-image-ivi`` which is baseline for the profiles
 107 of AGL distro. 'Baseline' means Service Layer and Operating System Layer defined
 108 in AGL Spec v1.0.
 109
 110 * packagegroup-agl-test.bb
 111
 112 Additional tools used in QA tests (for agl-image*-qa).
 113
 114 * packagegroup-ivi-common*
 115
 116         packagegroup-ivi-common-core-automotive.bb
 117         packagegroup-ivi-common-core.bb
 118         packagegroup-ivi-common-core-connectivity.bb
 119         packagegroup-ivi-common-core-graphics.bb
 120         packagegroup-ivi-common-core-kernel.bb
 121         packagegroup-ivi-common-core-multimedia.bb
 122         packagegroup-ivi-common-core-navi-lbs.bb
 123         packagegroup-ivi-common-core-os-commonlibs.bb
 124         packagegroup-ivi-common-core-security.bb
 125         packagegroup-ivi-common-core-speech-services.bb
 126         packagegroup-ivi-common-test.bb
 127
 128 These are for picking up some packages from upstreams like GENIVI/Tizen/Others.
 129 The layer of ``meta-ivi-common`` has no image to build, all packagegroups are
 130 aggregated to ``packagegroup-ivi-common-core' and it is included by images,
 131 ``agl-image-ivi.bb`` and ``agl-demo-platform.bb``.
 132
 133 ## Supported Machines
 134
 135 See [docs.automotivelinux.org](http://docs.automotivelinux.org)