View source for HOWTO: Setup GST-OpenMAX on Fedora 17

=HOWTO: Setup GST-OpenMAX on Fedora 17=
==Introduction==
This HOWTO will explain how to setup gst-openmax a GStreamer plugin that allows communication with OpenMAX IL components.  As well as OpenMAX IL known as libomxil-bellagio a dependency for gst-openmax.

==Requirements==
===Tested Platforms===
* Fedora 17

===Supported Architectures===
* x86_64
* ARM devices with an OMAP processor

===Tested Codecs===
* omx_mp3dec

===Required Packages===
* gstreamer-0.10
* libomxil-bellagio-0.9.3-7

==Downloads==
===Repositories===
* rlawrence-repo (libomxil-bellagio repo): http://matrix.senecac.on.ca/~rlawrence5/repo/rlawrence-repo-0.1-1.fc17.x86_64.rpm
* amartinenco-repo (gst-openmax repo): http://matrix.senecac.on.ca/~amartinenco/PACKAGES/f17/noarch/gstopenmax-release-0.10.1-1.fc17.noarch.rpm
===RPMS===
====libomxil-bellagio====
* SRPM: http://matrix.senecac.on.ca/~rlawrence5/repo/libomxil-bellagio-0.9.3-7.fc17.src.rpm
* RPM: http://matrix.senecac.on.ca/~rlawrence5/repo/libomxil-bellagio-0.9.3-7.fc17.x86_64.rpm
* RPM-devel: http://matrix.senecac.on.ca/~rlawrence5/repo/libomxil-bellagio-devel-0.9.3-7.fc17.x86_64.rpm
* RPM-test: http://matrix.senecac.on.ca/~rlawrence5/repo/libomxil-bellagio-test-0.9.3-7.fc17.x86_64.rpm
* RPM-mad: http://www.mediafire.com/download.php?2xr1rsoq91c4iyv
* RPM-debuginfo: http://matrix.senecac.on.ca/~rlawrence5/repo/libomxil-bellagio-debuginfo-0.9.3-7.fc17.x86_64.rpm
====gst-openmax====
* SRPM: http://matrix.senecac.on.ca/~amartinenco/PACKAGES/f17/SRPM/gst-openmax-0.10.1-3.fc17.src.rpm
* RPM: http://matrix.senecac.on.ca/~amartinenco/PACKAGES/f17/x86_64/gst-openmax-0.10.1-3.fc17.x86_64.rpm
* RPM-devel: http://matrix.senecac.on.ca/~amartinenco/PACKAGES/f17/x86_64/gst-openmax-devel-0.10.1-3.fc17.x86_64.rpm
* RPM-debuginfo: http://matrix.senecac.on.ca/~amartinenco/PACKAGES/f17/x86_64/gst-openmax-debuginfo-0.10.1-3.fc17.x86_64.rpm
 

==Adding Repositories==
* Add both repositories
<pre>
sudo rpm -Uvh http://matrix.senecac.on.ca/~rlawrence5/repo/rlawrence-repo-0.1-1.fc17.x86_64.rpm
sudo rpm -Uvh http://matrix.senecac.on.ca/~amartinenco/PACKAGES/f17/noarch/gstopenmax-release-0.10.1-1.fc17.noarch.rpm
</pre>

* Install missing libraries
<pre>
sudo yum install libmad libid3tag
</pre>

==Installing OpenMAX IL & GST-OpenMAX==
* Install the RPM with the command below
<pre>
sudo yum install libomxil-bellagio libomxil-bellagio-devel gst-openmax
</pre>

* '''NOTE: Due to a file size restriction on matrix, we need to install libomxil-bellagio-mad manually!'''
* Download the RPM from the download section and install the RPM with the command below
<pre>
sudo rpm -i libomxil-bellagio-mad-0.9.3-7.fc17.x86_64.rpm
</pre>


==Using GST-OpenMAX==
===Loading the components===
* Register the omx libraries
<pre> omxregister-bellagio -v </pre>

* Verify the components have been successfully installed
<pre> gst-inspect | grep omx </pre>

===Playing a mp3 file===
* Playing a mp3 file named "test.mp3" in our current directory
<pre> gst-launch-0.10 filesrc location="test.mp3" ! omx_mp3dec use-timestamps=false ! alsasink </pre>

==Known Issues/Concerns==
* When using gst-launch and a gst-openmax codec you may receive the warning below. It is safe to ignore this message, the upstream developer has been notified of the issue. This does not effect the functional of gst-openmax.  
<pre> OMX-library /usr/lib64/omxloaders/libomxdynamicloader.so dlopen error: /usr/lib64/omxloaders/libomxdynamicloader.so: undefined symbol: RM_Deinit </pre>