README.md

   1 **README.md for the 'meta-agl-demo' layer.**
   2
   3 **See README-AGL.md for general information about Automotive Grade Linux.**
   4
   5
   6 meta-agl-demo, the reference UI layer for the DEMO platform of Automotive Grade Linux
   7 =================================================================================
   8
   9 The layer 'meta-agl-demo' provides a reference/demo platform and applications
  10 for the AGL Distribution.
  11
  12 AGL is creating an automotive specific Linux distribution (AGL UCB) that unifies
  13 the software that has been written in a number of places already,
  14 such as GENIVI and Tizen IVI.
  15
  16 The AGL community appreciates feedback, ideas, suggestion, bugs and
  17 documentation just as much as code. Please join the irc conversation
  18 at the #automotive channel on irc.freenode.net and our mailing list.
  19
  20 For infomation for subscribing to the mailing list
  21     [automotive-discussions](http://lists.linuxfoundation.org/mailman/listinfo/automotive-discussions)
  22 For information about AGL Distribution, see the
  23     [AGL Distribution](https://wiki.automotivelinux.org/agl-distro)
  24 For information abount Getting started with AGL
  25     [here](https://wiki.automotivelinux.org/start/getting-started)
  26 For information about contributing to the AGL Distro
  27     [here](https://wiki.automotivelinux.org/agl-distro/contributing)
  28
  29
  30 Quick start guide
  31 -----------------
  32 See README-AGL.md
  33
  34
  35 Layer Dependencies
  36 ------------------
  37
  38 * Base dependencies [agl-demo]:
  39
  40 URI: git://git.yoctoproject.org/poky
  41 > branch         : jethro
  42 > tested revision: 40376446904ae3529be41737fed9a0b650ed167d
  43
  44 URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-agl
  45 > branch:   master
  46
  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
  54  - meta-openembedded/meta-oe
  55  - meta-openembedded/meta-multimedia
  56  -  meta-openembedded/meta-efl
  57  -  meta-openembedded/meta-networking
  58  -  meta-openembedded/meta-python
  59  -  meta-openembedded/meta-ruby
  60
  61 URI: https://github.com/meta-qt5/meta-qt5.git
  62 > branch:   jethro (b/c of qt-5.5.x)
  63 > tested revision: ea37a0bc987aa9484937ad68f762b4657c198617
  64
  65 * Hardware dependencies:
  66
  67 The Renesas R-Car Gen2 (Porter) board depends in addition on:
  68
  69 URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-renesas
  70 > branch:   agl-1.0-bsp-1.8.0
  71 > tested revision: 82611ccadef36ab0b8a6fd6fb1cf055e115f1ef5
  72 > (or later)
  73
  74 * Extra feature dependencies:
  75
  76  * The feature `agl-appfw-smack` has these dependencies
  77                 * `meta-intel-iot-security`
  78                 > URI: https://github.com/01org/meta-intel-iot-security
  79                 > branch            : jethro
  80                 > tested revision: c5906a1553513ef192a58231700357c5f14f4ae4
  81
  82                 * `meta-agl-extra/meta-app-framework`
  83                 > URI: https://gerrit.automotivelinux.org/gerrit/gitweb?p=AGL/meta-agl-extra.git
  84                 > branch            : master
  85
  86  * The feature `agl-sota` has these dependencies:
  87                 * `meta-updater`
  88                 > URI: https://github.com/advancedtelematic/meta-updater/
  89                 > branch            : thud
  90                 > tested revision: e4dd74565f429b576e84972d12cc1ae2048be119
  91
  92                 * `meta-updater-qemux86-64`
  93                 > URI: https://github.com/advancedtelematic/meta-updater-qemux86-64/
  94                 > branch            : thud
  95                 > tested revision: 214e14c4c45625842e542eebd696f903060d488f
  96
  97                 * `meta-openembedded`
  98                 > layer          : meta-openembedded
  99                 > branch         : thud
 100                 > tested revision: 9b3b907f30b0d5b92d58c7e68289184fda733d3e
 101
 102                         * specifically:
 103                                 * `meta-openembedded/meta-filesystems`
 104                                 * `meta-openembedded/meta-oe`
 105                                 * `meta-openembedded/meta-python`
 106
 107         * The feature `agl-netboot` has these dependenies:
 108                 * `meta-agl/meta-netboot`
 109
 110                         > URI: https://gerrit.automotivelinux.org/gerrit/gitweb?p=AGL/meta-agl.git
 111                         > branch            : master
 112
 113
 114 Packagegroups
 115 -------------
 116
 117 AGL Demo Platform's package group design:
 118
 119 * packagegroup-agl-demo-platform
 120
 121 This is for generating the image 'agl-demo-platform' which is a full image
 122 for the IVI profile of the AGL distro.
 123
 124 As meta-agl's design of packagegroups, ``agl-demo-platform.bb`` contains
 125 only ``packagegroup-agl-demo-platform`` and the packages of the DEMO applications.
 126
 127 ``agl-demo-platform`` has 4 packagegroups in it,
 128 ``packagegroup-agl-image-minimal``, ``packagegroup-agl-image-ivi``,
 129 ``packagegroup-ivi-common-core``, and ``packagegroup-agl-demo-platform``.
 130
 131 * packagegroup-agl-appfw*
 132
 133 These packagegroups contains packages for application framework of AGL Distro.
 134 Subsystem should maintain ``packagegroup-agl-appfw-[subsystem].bb`` which
 135 should hold sufficient packages for application framework of AGL Distro.
 136
 137 Subsystems also can maintain their own packagegroups under appropriate
 138 ``recipes-*/``.
 139
 140 For example, Qt5 has 2 packagegroups in ``meta-agl-demo``,
 141 ``packagegroup-agl-appfw-native-qt5`` and ``packagegroup-agl-demo-qt-examples``
 142 which are under ``recipes-qt/``.
 143
 144 The ``packagegroup-agl-appfw-native-qt5`` is included by
 145 ``packagegroup-agl-appfw-native`` because Qt5 belongs to native application
 146 framework of AGL Distro.
 147
 148 The ``packagegroup-agl-demo-qt-examples`` is added to local.conf if needed
 149 because they are not mandatory for AGL application framework and AGL Demo
 150 Platform.
 151
 152 Supported Machines
 153 ------------------
 154
 155 See `README-AGL.md` in meta-agl layer.
 156
 157 Supported Target of bitbake
 158 ------------------------
 159
 160 * `agl-demo-platform` is the full image of the AGL Demo Platform with all applications
 161