README.md

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