ubuntu: some more updates for 15.03ubuntu-qcom-snapdragon-15.03

Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>

1 files changed, 15 insertions, 33 deletions

diff --git a/ubuntu/boards/snapdragon/README.textile.in b/ubuntu/boards/snapdragon/README.textile.in
index 6b12cde..0d31eb0 100644
--- a/ubuntu/boards/snapdragon/README.textile.in
+++ b/ubuntu/boards/snapdragon/README.textile.in
@@ -4,12 +4,10 @@ h4. What's new in this release
 
 * Based on Linux kernel 3.19
 * Upgrade to Mesa master branch as of 03/10/2015 (commit: 5750595c)
-* Hardware accelerated video playback support (using Linux kernel 3.4)
+* Hardware accelerated video playback support (using Linux kernel 3.4), see instructions below
 * Upgrade images build to Docker-based infrastructure
-* Bug fixed:
-** n/a
 
-This is the fifth release of a new series for the Linaro Linux release for Snapdragon 600 processor. Going forward, the Linaro member monthly builds for Snapdragon 600 processor will be providing a kernel based on the current Linux kernel ("www.kernel.org":https://www.kernel.org) available at the time of the release. The goals of the Linaro Linux releases for Snapdragon 600 processor are to align with the latest Linux Kernel, close the gaps in features provided and migrate from the existing 3.4 vendor kernel. One immediate consequence of this migration is that some regressions are expected. Current regressions include: lack of audio support, video hardware acceleration and support for running CPU beyond 1Ghz. Developers can continue to use the "Linaro Linux release 14.10 for Snapdragon 600 processor":http://releases.linaro.org/14.10/ubuntu/ifc6410/, which is based on Linux kernel v3.4 and Ubuntu 14.04 if needed.
+The current Linaro member monthly builds for Snapdragon 600 processor provides a kernel based on the current Linux kernel ("www.kernel.org":https://www.kernel.org) available at the time of the release. The goals of the Linaro Linux releases for Snapdragon 600 processor are to align with the latest Linux Kernel, close the gaps in features provided and migrate from the existing 3.4 vendor kernel. Developers can continue to use the "Linaro Linux release 14.10 for Snapdragon 600 processor":http://releases.linaro.org/14.10/ubuntu/ifc6410/, which is based on Linux kernel v3.4 and Ubuntu 14.04 if needed.
 
 h4. Features
 
@@ -350,27 +348,16 @@ sudo fastboot flash boot boot-qcom-apq8064-ifc6410-qcom-snapdragon-##VERSION##.i
 
 h4. Gstreamer video playback technology preview
 
-An intial version of Gstreamer video decoder plugin is now available. It is not included in the image by default, and this section provides detailed information to build and use the Gstreamer plugin.
+An initial version of Gstreamer video decoder plugin is now available. It is not included in the image by default, and this section provides detailed information to build and use the Gstreamer plugin.
 
-As of this release, this plugin can decode MPEG4 and H264 videos, and it generates raw video using a custom NV12 tiled format. The support for this non standard raw video format has been added to upstream Gstreamer v1.4. This raw video format is depicted in details "here":http://linuxtv.org/downloads/v4l-dvb-apis/re31.html. You can use Gstreamer to generate a raw video frame test pattern using this format and render in a X11 window. To do so, you first need to install the following packages on the board:
+This plugin can decode MPEG4 and H264 videos, and it generates raw video using a custom NV12 tiled format. The support for this non standard raw video format has been added to upstream Gstreamer v1.4. This raw video format is depicted in details "here":http://linuxtv.org/downloads/v4l-dvb-apis/re31.html. To render the video frames when Xorg is used, it is recommended to use the Gstreamer plugin @glimagesink@ which uses the GPU for scaling and color conversion, instead of the CPU.
 
-bc. sudo apt-get update
-sudo apt-get install gstreamer1.0-tools gstreamer1.0-plugins-bad
-
-Then you can run the following commands from the root console prompt, that first initialize a minimal X11 window manager:
-
-bc. export DISPLAY=:0
-X&
-metacity&
-gst-launch-1.0 videotestsrc ! video/x-raw,format=NV12_64Z32,width=1280,height=720 ! videoconvert ! ximagesink
+In order to install all the required Gstreamer dependencies on your board, please run the following commands:
 
-This Gstreamer application will generate raw video frames and render them in an X11 window. The scaling and color conversion are all done using the CPU, as you can see from the CPU load. Gstreamer also provides another video sink that can be used as an alternative: @glimagesink@. This Gstreamer video sink, which is working fine with this release, uses the GPU, through the freedreno driver, to render the raw video frames:
-
-bc. gst-launch-1.0 videotestsrc ! video/x-raw,format=NV12_64Z32,width=1280,height=720 ! videoconvert ! glimagesink
-
-In this case the CPU is used for the conversion from NV12 tiled format to raw un-tiled YUV, and the GPU is used for scaling and color converstion, you can check the CPU load is much less.
+bc. sudo apt-get update
+sudo apt-get install gstreamer1.0-tools gstreamer1.0-plugins-ugly gstreamer1.0-plugins-bad gstreamer1.0-plugins-qcvideo
 
-In order to use video acceleration, a specific kernel must be used. Hence you need to download, install and boot the kernel from the Linaro 14.10 release:
+Also, to use video acceleration, a specific kernel must be used for now. Hence you need to download, install and boot the kernel from the Linaro 14.10 release:
 
 On the board running the current release, you need to run the following commands:
 
@@ -384,16 +371,7 @@ On your PC, download the following file:
 bc. wget http://releases.linaro.org/14.10/ubuntu/ifc6410/boot-ifc6410-20141024-37.img.gz
 gunzip http://releases.linaro.org/14.10/ubuntu/ifc6410/boot-ifc6410-20141024-37.img.gz
 
-To play a video file using the hardware acceleration, you also need to install the following package on the board:
-
-bc. sudo apt-get update
-sudo apt-get install gstreamer1.0-tools gstreamer1.0-plugins-qcvideo gstreamer1.0-plugins-ugly
-
-Finally, you need to reboot the board:
-
-bc. sudo reboot
-
-And boot with the Linaro 14.10 kernel, you just downloaded:
+Finally, you need to reboot the board, and boot with the Linaro 14.10 kernel, you just downloaded, e.g. on your PC:
 
 bc. sudo fastboot boot boot-ifc6410-20141024-37.img
 
@@ -403,7 +381,7 @@ bc. X&
 metacity&
 gst-launch-1.0 playbin uri=http://mirrorblender.top-ix.org/peach/bigbuckbunny_movies/big_buck_bunny_720p_surround.avi
 
-Note that dependeing on your network bandwidth, it is probably better to download the video file locally first, and play a local file.
+Note that depending on your network bandwidth, it is probably better to download the video file and play it locally.
 
 If you are running the Gnome image, you can also login into Gnome shell with the @linaro@ user, and from the terminal console, you can run:
 
@@ -414,9 +392,13 @@ To print the plugin debug messages you can use the standard Gstreamer debug infr
 bc. export GST_DEBUG=qcvideodec:5
 gst-launch-1.0 playbin uri=http://mirrorblender.top-ix.org/peach/bigbuckbunny_movies/big_buck_bunny_720p_surround.avi
 
+If you want to generate a test pattern using the custom NV12 tiled format, and render it, you can run:
+
+bc. gst-launch-1.0 videotestsrc ! video/x-raw,format=NV12_64Z32,width=1280,height=720 ! videoconvert ! glimagesink
+
 Firefox is using Gstreamer as its main media framework, as a consequence, if you try to open a web page with HTML video, such as Video.js:"http://www.videojs.com/", then the video will be decoded using hardware acceleration. If @GST_DEBUG@ is set before you start Firefox, you will be able to see the plugin debug messages in the terminal.
 
-If you want to rebuild the plugin from source, you can use the following instructions:
+Note that if you want to rebuild the plugin from source, you can fetch the source code, and rebuild on your board directly:
 
 bc. sudo apt-get install build-essential git autotools-dev autoconf libtool libgstreamer-plugins-base1.0-dev
 git clone http://git.linaro.org/landing-teams/working/qualcomm/gst-plugin-qcvideo.git