View source for How To Packaging and support for OpenMAX

=Building GStreamer with GST-OpenMax=
==Introduction==
This how-to will describe how to setup [[http://gstreamer.freedesktop.org/ GStreamer]] a library for constructing graphs of media-handling components on the Pandaboard. Using [[http://freedesktop.org/wiki/GstOpenMAX gst-openmax]] a GStreamer plug-in that allows communication with OpenMAX IL components and [[https://github.com/robclark/gst-ducati gst-ducati]] a plugin for using the HW accellerated codecs on IVA-HD via the codec-engine API.


==Configuring your environment==

*These instructions have been tested on the Pandaboard Rev A1 running Fedora 17 ARM.
*Startup the Pandaboard and make sure you have internet connectivity.


*Install the Fedora 17 development tools
<pre>
yum update
yum groupinstall "Development Tools" "Development Libraries"
</pre>

*Add the RPM repositories containing the GStreamer plugins
<pre>
rpm -Uvh http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-stable.noarch.rpm
rpm -Uvh http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-stable.noarch.rpm
</pre>

*Install GStreamer plugins
<pre>
yum install gstreamer-{ffmpeg,plugins-{good,ugly,bad{,-free,-nonfree}}} ffmpeg
yum install gstreamer-devel gstreamer-plugins-base-devel
</pre>

==Building OpenMAX IL==
*Download the source code to a temporary directory
<pre>
mkdir -p /tmp/omx
cd /tmp/omx
wget http://downloads.sourceforge.net/omxil/libomxil-bellagio-0.9.0.tar.gz
</pre>

*Extract the tarball and configure the source code
<pre>
tar -xvf libomxil-bellagio-0.9.0.tar.gz
cd liboxmil-bellagio-0.9.0
./configure --prefix=$HOME/omx
</pre>

*Build and install
<pre>
make
make install
</pre>

==Building GST-OpenMax==
*Clone the git repository into a temporary directory
<pre>
mkdir -p /tmp/omx
cd /tmp/omx
git clone git://anongit.freedesktop.org/gstreamer/gst-openmax
</pre>

*Build and install
<pre>
cd gst-openmax
./autogen.sh
./configure --prefix=$HOME/omx
make
make install
</pre>

==Testing OpenMax==
*Check if the codecs have been sucessfully loaded
<pre>
gst-inspect | grep omx
</pre>

*Export environment variables for library and plugin directories
<pre>
export GST_PLUGIN_PATH="/usr/local/lib/gstreamer-0.10:$HOME/omx/lib/gstreamer-0.10"
export LD_LIBRARY_PATH="/$HOME/omx/lib"
</pre>

*Testing audio output using mp3 "test.mp3"
<pre>
gst-launch-0.10 filesrc location="test.mp3" ! omx_mp3dec use-timestamps=false ! audioconvert ! alsasink
</pre>