summaryrefslogtreecommitdiffstats
path: root/documentation/overview-manual
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-05-14 14:33:45 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-05-24 17:16:34 +0100
commit88c6050ad28229231965017b64de40b086e6b4d1 (patch)
treec1994306c27fd5e344eea136fef99127d4d593b1 /documentation/overview-manual
parentc72b126bc0dc8377998988905b4311a10f0d3a8b (diff)
downloadpoky-88c6050ad28229231965017b64de40b086e6b4d1.tar.gz
overview-manual, dev-manual: Moved Wayland and Weston
The Wayland and Weston topic moved from the overview-manual to the dev-manual. The topic was really a "how-to" topic and not a concepts topic. (From yocto-docs rev: b0f20a67c99590c48d595f4e572339bb5b6b83b3) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/overview-manual')
-rw-r--r--documentation/overview-manual/overview-manual-concepts.xml135
1 files changed, 0 insertions, 135 deletions
diff --git a/documentation/overview-manual/overview-manual-concepts.xml b/documentation/overview-manual/overview-manual-concepts.xml
index af34b970aa..9f0f9d1d9f 100644
--- a/documentation/overview-manual/overview-manual-concepts.xml
+++ b/documentation/overview-manual/overview-manual-concepts.xml
@@ -3227,141 +3227,6 @@
3227 </para> 3227 </para>
3228 </section> 3228 </section>
3229 3229
3230 <section id="wayland">
3231 <title>Wayland</title>
3232
3233 <para>
3234 <ulink url='http://en.wikipedia.org/wiki/Wayland_(display_server_protocol)'>Wayland</ulink>
3235 is a computer display server protocol that
3236 provides a method for compositing window managers to communicate
3237 directly with applications and video hardware and expects them to
3238 communicate with input hardware using other libraries.
3239 Using Wayland with supporting targets can result in better control
3240 over graphics frame rendering than an application might otherwise
3241 achieve.
3242 </para>
3243
3244 <para>
3245 The Yocto Project provides the Wayland protocol libraries and the
3246 reference
3247 <ulink url='http://en.wikipedia.org/wiki/Wayland_(display_server_protocol)#Weston'>Weston</ulink>
3248 compositor as part of its release.
3249 This section describes what you need to do to implement Wayland and
3250 use the compositor when building an image for a supporting target.
3251 </para>
3252
3253 <section id="wayland-support">
3254 <title>Support</title>
3255
3256 <para>
3257 The Wayland protocol libraries and the reference Weston
3258 compositor ship as integrated packages in the
3259 <filename>meta</filename> layer of the
3260 <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>.
3261 Specifically, you can find the recipes that build both Wayland
3262 and Weston at
3263 <filename>meta/recipes-graphics/wayland</filename>.
3264 </para>
3265
3266 <para>
3267 You can build both the Wayland and Weston packages for use only
3268 with targets that accept the
3269 <ulink url='https://en.wikipedia.org/wiki/Mesa_(computer_graphics)'>Mesa 3D and Direct Rendering Infrastructure</ulink>,
3270 which is also known as Mesa DRI.
3271 This implies that you cannot build and use the packages if your
3272 target uses, for example, the
3273 <trademark class='registered'>Intel</trademark> Embedded Media
3274 and Graphics Driver
3275 (<trademark class='registered'>Intel</trademark> EMGD) that
3276 overrides Mesa DRI.
3277 <note>
3278 Due to lack of EGL support, Weston 1.0.3 will not run
3279 directly on the emulated QEMU hardware.
3280 However, this version of Weston will run under X emulation
3281 without issues.
3282 </note>
3283 </para>
3284 </section>
3285
3286 <section id="enabling-wayland-in-an-image">
3287 <title>Enabling Wayland in an Image</title>
3288
3289 <para>
3290 To enable Wayland, you need to enable it to be built and enable
3291 it to be included in the image.
3292 </para>
3293
3294 <section id="enable-building">
3295 <title>Building</title>
3296
3297 <para>
3298 To cause Mesa to build the <filename>wayland-egl</filename>
3299 platform and Weston to build Wayland with Kernel Mode
3300 Setting
3301 (<ulink url='https://wiki.archlinux.org/index.php/Kernel_Mode_Setting'>KMS</ulink>)
3302 support, include the "wayland" flag in the
3303 <ulink url="&YOCTO_DOCS_REF_URL;#var-DISTRO_FEATURES"><filename>DISTRO_FEATURES</filename></ulink>
3304 statement in your <filename>local.conf</filename> file:
3305 <literallayout class='monospaced'>
3306 DISTRO_FEATURES_append = " wayland"
3307 </literallayout>
3308 <note>
3309 If X11 has been enabled elsewhere, Weston will build
3310 Wayland with X11 support
3311 </note>
3312 </para>
3313 </section>
3314
3315 <section id="enable-installation-in-an-image">
3316 <title>Installing</title>
3317
3318 <para>
3319 To install the Wayland feature into an image, you must
3320 include the following
3321 <ulink url='&YOCTO_DOCS_REF_URL;#var-CORE_IMAGE_EXTRA_INSTALL'><filename>CORE_IMAGE_EXTRA_INSTALL</filename></ulink>
3322 statement in your <filename>local.conf</filename> file:
3323 <literallayout class='monospaced'>
3324 CORE_IMAGE_EXTRA_INSTALL += "wayland weston"
3325 </literallayout>
3326 </para>
3327 </section>
3328 </section>
3329
3330 <section id="running-weston">
3331 <title>Running Weston</title>
3332
3333 <para>
3334 To run Weston inside X11, enabling it as described earlier and
3335 building a Sato image is sufficient.
3336 If you are running your image under Sato, a Weston Launcher
3337 appears in the "Utility" category.
3338 </para>
3339
3340 <para>
3341 Alternatively, you can run Weston through the command-line
3342 interpretor (CLI), which is better suited for development work.
3343 To run Weston under the CLI, you need to do the following after
3344 your image is built:
3345 <orderedlist>
3346 <listitem><para>
3347 Run these commands to export
3348 <filename>XDG_RUNTIME_DIR</filename>:
3349 <literallayout class='monospaced'>
3350 mkdir -p /tmp/$USER-weston
3351 chmod 0700 /tmp/$USER-weston
3352 export XDG_RUNTIME_DIR=/tmp/$USER-weston
3353 </literallayout>
3354 </para></listitem>
3355 <listitem><para>
3356 Launch Weston in the shell:
3357 <literallayout class='monospaced'>
3358 weston
3359 </literallayout></para></listitem>
3360 </orderedlist>
3361 </para>
3362 </section>
3363 </section>
3364
3365 <section id="overview-licenses"> 3230 <section id="overview-licenses">
3366 <title>Licenses</title> 3231 <title>Licenses</title>
3367 3232