[PATCH wayland-web] raspberrypi: update for the new rpi-backend

[darxus at chaosreigns.com]

Committed, html validated.

On 05/22, ppaalanen at gmail.com wrote:
> From: Pekka Paalanen <pekka.paalanen at 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.paalanen at 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 at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/wayland-devel
> 

-- 
"Every man, woman and child on the face of this earth is at the mercy
of chaos." - a maxwell smart movie
http://www.ChaosReigns.com