From: Pekka Paalanen <pekka.paala...@collabora.co.uk>
This depends on the rpi-renderer patch series for Weston.
Update the build instructions for the current state of Weston, remove
options that do not exist anymore, add some more troubleshooting issues.
Signed-off-by: Pekka Paalanen <pekka.paala...@collabora.co.uk>
---
raspberrypi.html | 42 ++++++++++++++++++++++++++----------------
1 file changed, 26 insertions(+), 16 deletions(-)
diff --git a/raspberrypi.html b/raspberrypi.html
index 67b7829..d77a9e1 100644
--- a/raspberrypi.html
+++ b/raspberrypi.html
@@ -47,14 +47,6 @@ old firmware may cause rpi-backend to malfunction on
Raspberry Pi.</p>
happen off-line into the buffer.</dd>
</dl>
-<p>By default, the rpi-backend is configured for the
<tt>dispmanx_offline=1</tt>
-case. Without this setting, it would be better to run Weston with
-<tt>--max-planes=10</tt> command line option.</p>
-
-<p>If you want to use Weston with purely GLESv2 compositing, you can pass
-<tt>--max-planes=0</tt> to Weston. In that case it would be preferrable
-to not set <tt>dispmanx_offline=1</tt> to conserve VideoCore memory.</p>
-
<h2>Setting up the environment</h2>
<p>Here we will install to the home directory of the pi user.</p>
@@ -67,9 +59,11 @@ export
PKG_CONFIG_PATH="$WLD/lib/pkgconfig/:$WLD/share/pkgconfig/"
export ACLOCAL="aclocal -I $WLD/share/aclocal"
export XDG_RUNTIME_DIR="/run/shm/wayland"
export XDG_CONFIG_HOME="$WLD/etc"
+export XORGCONFIG="$WLD/etc/xorg.conf"
mkdir -p "$WLD/share/aclocal"
mkdir -p "$XDG_RUNTIME_DIR"
+chmod 0700 "$XDG_RUNTIME_DIR"
</pre>
</blockquote>
@@ -97,11 +91,11 @@ contains similar files for Android, and will not work.</p>
<pre> $ git clone git://anongit.freedesktop.org/wayland/wayland
$ cd wayland
- $ ./autogen.sh --prefix=$WLD
+ $ ./autogen.sh --prefix=$WLD --disable-documentation
$ make
$ make install
</pre>
-
+<p>The <tt>--disable-documentation</tt> makes it not require Doxygen.</p>
<h2>libxkbcommon</h2>
@@ -124,9 +118,10 @@ contains similar files for Android, and will not work.</p>
$ ./autogen.sh --prefix=$WLD \
--disable-setuid-install --with-cairo-glesv2 \
--disable-x11-compositor --disable-drm-compositor \
- --disable-android-compositor --disable-wayland-compositor \
+ --disable-fbdev-compositor --disable-wayland-compositor \
--disable-weston-launch --disable-simple-egl-clients \
- --disable-fbdev-compositor \
+ --disable-egl --disable-libunwind --disable-colord \
+ --disable-resize-optimization --disable-xwayland-test \
WESTON_NATIVE_BACKEND="rpi-backend.so"
$ make
@@ -168,10 +163,25 @@ configure: WARNING: clients will use cairo image,
cairo-egl not used</pre>
<h3>Some or all surfaces (graphics) are corrupted</h3>
-<p>Too old firmware might cause corrupted graphics. If you don't want to
-update the firmware, a workaround is to add <tt>--max-planes=0</tt> to the
-Weston command line. This forces everything to be composited with
-GLESv2.</p>
+<p>Too old firmware might cause corrupted graphics.
+Try upgrading the firmware, and try the <tt>/boot/config.txt</tt>
+options mentioned above.</p>
+
+<h3>Monitor or TV goes blank, loses signal, etc.</h3>
+
+<p>You probably do not have <tt>dispmanx_offline=1</tt> for the firmware.
+When there are too many things on screen for the on-line compositor to
+handle, the output dies or becomes corrupt without the off-line fallback.</p>
+
+<h3>Some windows or the whole image flickers</h3>
+
+<p>There may be so many things on screen, that even the off-line compositor
+in the firmware cannot keep up. Try to close some windows.</p>
+
+<h3>Programs are dying on SIGBUS</h3>
+
+<p>Most likely you are running out of space in <tt>$XDG_RUNTIME_DIR</tt>.
+This is where Wayland programs allocate their pixel buffers.</p>
</body>
</html>
--
1.8.1.5
_______________________________________________
wayland-devel mailing list
wayland-devel@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/wayland-devel
