Wayland: Difference between revisions

From Yocto Project
Jump to navigationJump to search
No edit summary
No edit summary
Line 1: Line 1:
== Current Status ==
== Current Status ==


* Wayland protocol
Wayland protocol libraries and the reference Weston compositor are integrated as packages in the core-oe meta/ layer.
The packages can be build against targets that accept mesa-dri. For example, intel-specific emgd drivers that override
mesa-dri cannot be used to build Weston.
 
=== Enable Wayland in a image ===
 
* If "wayland" distro feature, Mesa builds the wayland-egl platform
* If "wayland" distro feature, Mesa builds the wayland-egl platform
* Weston compositor. If wayland disto feature, build with KMS. If x11 distro feature, builds with X11.
* Weston compositor. If wayland disto feature, build with KMS. If x11 distro feature, builds with X11.
To enable in an image, you need to add the following parameters in conf/local.conf:
* CORE_IMAGE_EXTRA_INSTALL += "wayland weston"
By default, the weston will be built with only the X11-backend compositor. To enable the DRI/KMS backend (in order to run weston directly on hardware), you need to also add
* DISTRO_FEATURES_append = " wayland"  # notice the extra space, it's important !
=== Running Weston ===


To run Weston inside X11, simply adding weston to the image will be sufficient.  Under Sato there will be a Weston launcher in the Utility category.   
To run Weston inside X11, simply adding weston to the image will be sufficient.  Under Sato there will be a Weston launcher in the Utility category.   


Adding the "wayland" distribution feature will enable Wayland on bare metal. Currently there are no init scripts or images to do this automatically.
Wayland/Weston work in still developer-oriented. The best way to run them is through CLI. As we fine tune the way to run Weston and setting policies,
scripts to automate this work will be provided.
 
==== Environment setup ====
 
Please do export XDG_RUNTIME_DIR:
 
* mkdir -p /tmp/$USER-weston
* chmod 0700 /tmp/$USER-weston
* export XDG_RUNTIME_DIR=/tmp/$USER=weston
 
==== Launch ====
 
* weston
 
== Current working status ==
 
=== QEMU ===
 
Weston 1.0.3 will not run directly on the emulated QEMU hardware, due to lack of EGL support.
 
Under X, there is a problem displaying the window, https://bugzilla.yoctoproject.org/show_bug.cgi?id=3879
 
=== Physical Machines ===
 
There is no embedded-class physical machine yet verified to run Weston to top of hardware.
Current efforts focus on enabling FRI2.  


== Plan ==
== Plan ==


* Upgrade Weston to a version that can run only on framebuffer (e.g. pixman)
* Image that boots Weston on KMS
* Image that boots Weston on KMS
* Enable GTK+ 3 Wayland support
* Enable GTK+ 3 Wayland support
* Enable Qt Wayland support
* Enable Qt Wayland support
* Enable Clutter Wayland support
* Enable Clutter Wayland support
=== Enable Wayland in a image ===
In order to install westen compositor in a image, the following parameters need to be added as image features in conf/local.conf:
* CORE_IMAGE_EXTRA_INSTALL += "wayland weston"

Revision as of 11:04, 25 February 2013

Current Status

Wayland protocol libraries and the reference Weston compositor are integrated as packages in the core-oe meta/ layer. The packages can be build against targets that accept mesa-dri. For example, intel-specific emgd drivers that override mesa-dri cannot be used to build Weston.

Enable Wayland in a image

  • If "wayland" distro feature, Mesa builds the wayland-egl platform
  • Weston compositor. If wayland disto feature, build with KMS. If x11 distro feature, builds with X11.

To enable in an image, you need to add the following parameters in conf/local.conf:

  • CORE_IMAGE_EXTRA_INSTALL += "wayland weston"

By default, the weston will be built with only the X11-backend compositor. To enable the DRI/KMS backend (in order to run weston directly on hardware), you need to also add

  • DISTRO_FEATURES_append = " wayland" # notice the extra space, it's important !

Running Weston

To run Weston inside X11, simply adding weston to the image will be sufficient. Under Sato there will be a Weston launcher in the Utility category.

Wayland/Weston work in still developer-oriented. The best way to run them is through CLI. As we fine tune the way to run Weston and setting policies, scripts to automate this work will be provided.

Environment setup

Please do export XDG_RUNTIME_DIR:

  • mkdir -p /tmp/$USER-weston
  • chmod 0700 /tmp/$USER-weston
  • export XDG_RUNTIME_DIR=/tmp/$USER=weston

Launch

  • weston

Current working status

QEMU

Weston 1.0.3 will not run directly on the emulated QEMU hardware, due to lack of EGL support.

Under X, there is a problem displaying the window, https://bugzilla.yoctoproject.org/show_bug.cgi?id=3879

Physical Machines

There is no embedded-class physical machine yet verified to run Weston to top of hardware. Current efforts focus on enabling FRI2.

Plan

  • Upgrade Weston to a version that can run only on framebuffer (e.g. pixman)
  • Image that boots Weston on KMS
  • Enable GTK+ 3 Wayland support
  • Enable Qt Wayland support
  • Enable Clutter Wayland support