232cd1d7b5bc3338733ec21a9978b152aac81f0f
[AGL/documentation.git] / docs / 3_Developer_Guides / 1_AGL_Layers / 3_meta-agl-demo.md
1 ---
2 edit_link: ''
3 title: meta-agl-demo
4 origin_url: >-
5   https://git.automotivelinux.org/AGL/meta-agl-demo/plain/docs/../meta-agl-demo.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-demo-guides-devguides-book.yml -->
9
10 ## Introduction
11
12 The `meta-agl-demo` layer is the reference user interface layer for the DEMO
13 platform of Automotive Grade Linux (AGL).
14 The layer provides a reference platform and applications.
15 The BitBake target name for the DEMO platform is `agl-demo-platform`, which is
16 the full DEMO platform image.
17
18 ## Layer Dependencies
19
20 This section describes dependencies for the `meta-agl-demo` layer.
21 Dependencies are grouped into base, hardware, and feature dependencies.
22
23 ### Base Dependencies
24
25 The `meta-agl-demo` layer has the following base dependencies:
26
27 * Yocto Project Release:
28
29   - URI: git://git.yoctoproject.org/poky
30   - Branch: "thud"
31   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
32     manifest file for the `AGL-repo` repository for revision
33     information.<br/><br/>
34
35 * AGL `meta-agl` Layer:
36
37   - URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-agl
38   - Branch: "master"<br/><br/>
39
40 * OpenEmbedded `meta-openembedded` Layer:
41
42   - Branch: "thud"
43   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
44     manifest file for the `AGL-repo` repository for revision
45     information.
46
47     Specifically, out of `meta-openembedded`, these sub-layers are used:
48
49     - `meta-oe`
50     - `meta-multimedia`
51     - `meta-networking`
52     - `meta-python`<br/><br/>
53
54 * Yocto Project `meta-qt5` Layer from the
55   [OpenEmbedded Layer Index](https://layers.openembedded.org/layerindex/branch/master/layers/):
56
57   - URI: https://github.com/meta-qt5/meta-qt5.git
58   - Branch:   "thud"
59   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
60     manifest file for the `AGL-repo` repository for revision
61     information.<br/><br/>
62
63 ### Hardware Dependencies
64
65 Aside from the previously listed base dependencies, if you are using a
66 [supported Renesas board](../getting_started/reference/getting-started/machines/renesas.html)
67 supported Renesas board, these dependencies exist:
68
69 * AGL's `meta-renesas` Layer:
70
71   - URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-renesas
72
73 ### Feature Dependencies
74
75 The `meta-agl-demo` layer has the following AGL
76 [feature](../getting_started/reference/getting-started/image-workflow-initialize-build-environment.html#agl-features)
77 dependencies:
78
79 * Yocto Project `meta-security` Layer:
80
81   - URI: https://git.yoctoproject.org/cgit/cgit.cgi/meta-security
82   - Branch: "master"
83   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
84     manifest file for the `AGL-repo` repository for revision
85     information.<br/><br/>
86
87 * AGL's `meta-app-framework` Layer within the `meta-agl` Layer:
88
89   - URI: https://gerrit.automotivelinux.org/gerrit/gitweb?p=AGL/meta-agl.git
90   - Branch: "master"<br/><br/>
91
92 **The `agl-sota` Feature:**
93
94 * Here Technologies' `meta-updater` Layer:
95
96   - URI: https://github.com/advancedtelematic/meta-updater/
97   - Branch: "thud"<br/><br/>
98
99 * Here Technologies' `meta-updater-qemux86-64` Layer:
100
101   - URI: https://github.com/advancedtelematic/meta-updater-qemux86-64/
102   - Branch: "thud"<br/><br/>
103
104 * OpenEmbedded's `meta-openembedded` Layer:
105
106   - URI: https://github.com/openembedded/meta-openembedded
107   - Branch: "thud"
108   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
109     manifest file for the `AGL-repo` repository for revision
110     information.
111
112     Specifically, out of `meta-openembedded`, these sub-layers are used:
113
114     - `meta-filesystems`
115     - `meta-oe`
116     - `meta-python`<br/><br/>
117
118 **The `agl-netboot` Feature:**
119
120 * AGL's `meta-netboot` Layer within the `meta-agl` Layer:
121
122   - URI: https://gerrit.automotivelinux.org/gerrit/gitweb?p=AGL/meta-agl.git
123   - Branch: "master"
124
125
126 ## Packagegroups
127
128 AGL DEMO Platform's 
129 [packagegroups](https://www.yoctoproject.org/docs/2.4.4/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)
130 consist of the following:
131
132 ### packagegroup-agl-demo-platform
133
134 This packagegroup is used for generating the `agl-demo-platform` image,
135 which is the full image for the AGL distributions IVI profile.
136 You can see the recipe (i.e. `agl-demo-platform.bb`) that installs 
137 the `packagegroup-agl-demo-platform` packagegroup
138 [here](https://git.automotivelinux.org/AGL/meta-agl-demo/tree/recipes-platform/images/agl-demo-platform.bb).
139
140 As meta-agl's design of packagegroups, the `agl-demo-platform.bb` recipe installs
141 only `packagegroup-agl-demo-platform` and the packages of the DEMO applications.
142
143 ``agl-demo-platform`` contains the following three packagegroups:
144
145   * `packagegroup-agl-image-minimal`
146   * `packagegroup-agl-image-ivi`
147   * `packagegroup-agl-demo-platform`
148
149 ### packagegroup-agl-appfw*
150
151 These packagegroups contain packages for the AGL distribution's
152 Application Framework.
153 Subsystem should maintain `packagegroup-agl-appfw-[subsystem].bb`, which
154 should hold sufficient packages for the Application Framework.
155
156 Subsystems also can maintain their own packagegroups using appropriate
157 `recipes-*/`.
158 For example, Qt5 has two packagegroups in `meta-agl-demo`:
159 `packagegroup-agl-appfw-native-qt5` and `packagegroup-agl-demo-qt-examples`,
160 which are under `recipes-qt/`.
161
162 The `packagegroup-agl-appfw-native-qt5` is included by
163 `packagegroup-agl-appfw-native` because Qt5 belongs to native application
164 framework of AGL Distro.
165
166 Because the `packagegroup-agl-demo-qt-examples` is not mandatory for
167 the AGL Application Framework and the AGL DEMO, the packagegroup is added
168 to the layer's `local.conf` file only when needed.
169