5c42f7fbfc8913c3f8387a58576cb4447c623fa3
[AGL/meta-agl-demo.git] / 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     [agl-dev-community](https://lists.automotivelinux.org/g/agl-dev-community)
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