Ilya: /* Kernel modules */

2011-07-10T13:05:10Z

‎Kernel modules

Mike: /* Videos not playing. */

2010-07-19T13:08:09Z

‎Videos not playing.

New page

== Introduction ==
The OMAP3530 includes a built-in TMS320C64X+ DSP Core that provides advanced hardware acceleration support for media encoding / decoding. 
For further details, refer to the [http://focus.ti.com/general/docs/litabsmultiplefilelist.tsp?literatureNumber=spruf98d OMAP35x Technical Reference Manual].

== GStreamer TI Plugin ==

[http://en.wikipedia.org/wiki/GStreamer GStreamer] is a pipeline-based multimedia framework that allows to create a variety of media-handling software components. [https://gstreamer.ti.com/gf/project/gstreamer_ti/ GStreamer TI Plugin] for OMAP3 platform enables DSP hardware utilisation for accelerating streaming audio and video processing and image manipulation by using TI DSP codecs. The plugin contains
[http://processors.wiki.ti.com/index.php?title=GstTIPlugin_Elements GstTIPlugin Elements] for decoding/encoding audio, video and image and for displaying the video using fbdev.

=== Video formats. ===

Gstreamer TI and TI OMAP35x codecs currently support playback of VGA videos of quality up to [http://en.wikipedia.org/wiki/480p 480p] @ 30 fps of the following formats:

* VGA .AVI VGA file with MPEG-2 or MPEG-4 Video and MP1L2 or MP3 Audio. 
* VGA .AVI VGA file with H.264 Video and AAC Audio. 
* VGA .MP4 file with MPEG-2/MPEG-4/H.264 Video and MP1L2/MP3/AAC Audio. 
* VGA .TS file with H.264 Video and MP1L2 or MP3 Audio.

'''Only baseline profile of H.264 and simple profile of MPEG4 formats are supported.''' Please refer to the TI [http://software-dl.ti.com/dsps/dsps_public_sw/codecs/OMAP35xx/index_FDS.html H.264] and [http://software-dl.ti.com/dsps/dsps_public_sw/codecs/C64XPlus_Video/index_FDS.html MPEG-4] codecs Data Sheets.

=== Kernel parameters ===
In order to make the GStreamer-TI package work, please ensure that the framebuffer plains 1 and 2 are enabled in your kernel command line:

<pre>vram=18M omapfb.vram=0:6M,1:6M,2:6M</pre>

Additionally, cmemk kernel module requires a "window" in the kernel memory. It allocates a heap buffer at 0xc9000000 of size 0x53d000. You can leave this memory free by adding for example the following option to the kernel command line:

<pre>mem=99M@0x80000000</pre>

=== Playback pipeline examples ===

Below examples illustrate how to play video samples using GStreamer-TI. For more info please refer to [http://processors.wiki.ti.com/index.php/Example_GStreamer_Pipelines#OMAP35x GStreamer Pipelines Examples for OMAP35x].

* VGA .AVI file with MPEG-2 or MPEG-4 Video and MP1L2 or MP3 Audio. 
gst-launch -v filesrc location=sample.avi ! avidemux name=demux demux.audio_00 ! \
queue max-size-buffers=1200 max-size-time=0 max-size-bytes=0 ! mad ! alsasink demux.video_00 ! \
queue ! TIViddec2 ! queue max-size-buffers=2 max-size-time=0 max-size-bytes=0 ! omapdmaifbsink max-lateness=50000

* VGA .AVI file with H.264 Video and AAC Audio.
gst-launch -v filesrc location=sample.avi ! avidemux name=demux demux.audio_00 ! \
queue max-size-buffers=8000 max-size-time=0 max-size-bytes=0 ! TIAuddec1 ! alsasink demux.video_00 ! \
queue ! TIViddec2 ! omapdmaifbsink max-lateness=50000

* VGA .MP4 file with H.264 Video and MP1L2 or MP3 Audio:
gst-launch -v filesrc location=sample.mp4 ! qtdemux name=demux demux.audio_00 ! \
queue max-size-buffers=8000 max-size-time=0 max-size-bytes=0 ! mad ! alsasink demux.video_00 ! \
queue ! TIViddec2 ! omapdmaifbsink max-lateness=50000

* VGA .MP4 file with H.264 Video and AAC Audio:
gst-launch -v filesrc location=sample.mp4 ! qtdemux name=demux demux.audio_00 ! \
queue max-size-buffers=8000 max-size-time=0 max-size-bytes=0 ! TIAuddec1 ! alsasink demux.video_00 ! \
queue ! TIViddec2 ! omapdmaifbsink max-lateness=50000

* VGA .TS file with H.264 Video and MP1L2 or MP3 Audio:
gst-launch filesrc location=sample.ts ! typefind ! mpegtsdemux name=demux demux. ! \
queue max-size-buffers=1200 max-size-time=0 max-size-bytes=0 ! typefind ! mad ! alsasink demux. ! \
typefind ! TIViddec2 ! queue max-size-buffers=2 max-size-time=0 max-size-bytes=0 ! omapdmaifbsink max-lateness=50000

== Creating Videos ==

Example video clips can be downloaded from [http://www.apple.com/trailers Apple trailers]. Use Quicktime Pro to download and save the trailer videos. Use the [http://www.ffmpeg.org ffmpeg] application to convert the videos to the GStreamer TI compatible formats. Refer to [http://ubuntuforums.org/showthread.php?t=1117283 enabling MP3, MPEG4, AAC, in FFmpeg on Ubuntu].

* Encoding to .AVI file H.264 Video and AAC Audio:
ffmpeg -i test.mov -f avi -r 30 -b 1200kb -s 720x480 -vcodec libx264 -vpre hq -vpre baseline \
-me_range 8 -crf 22 -acodec aac -ar 22050 -ac 2 -threads 0 test.avi
Creates a video file with size 720x480, 30 fps, bitrate 1200 kbps, 2 channels audio with 22050 Hz frequency.
* Encoding to .MP4 file with MPEG-4 Video and MP3 Audio:
ffmpeg -i test.mov -r 30 -f mp4 -b 1200kb -s 720x480 -vcodec mpeg4 -flags +aic+cbp+mv0+mv4 \
-profile 0 -level 2 -trellis 2 -mbd 2 -cmp 2 -subcmp 2 -g 250 -maxrate 2.5M -bufsize 2M \
-acodec libmp3lame -ar 22050 -ac 2 -threads 0 test.mp4

=== Parameters explanation ===

; '''-f''' : container format
; '''-b''' : video bitrate
; '''-s''' : video size
; '''-r''' : frames per second
; '''-ar''' : audio frequency
; '''-ac''' : audio channels
; '''-threads 0''' : indicates that the algorithm should choose the number of threads to be used.

'''H264 specific options''' - please refer for more info to the [http://rob.opendot.cl/index.php/useful-stuff/ffmpeg-x264-encoding-guide/ x264 encoding guide] and [http://rob.opendot.cl/index.php/useful-stuff/x264-to-ffmpeg-option-mapping/ ffmpeg to libx264 options mapping].

<pre>
-vpre libx264 presets
-me_range
-crf
</pre>

'''MPEG-4 specific options''' - please refer for some explanations [http://rob.opendot.cl/index.php/useful-stuff/ipod-video-guide/ here].

<pre>
-profile -level :
- Simple Profile level 0, corresponds to "-profile 0 - level 8"
- Simple Profile level 1, corresponds to "-profile 0 - level 1"
- Simple Profile level 2, corresponds to "-profile 0 - level 2"

-flags

-trellis

-mbd

-cmp

-subcmp

-g

-maxrate

-bufsize
</pre>

== Troubleshooting ==

=== Videos not playing ===

Try to add to your gstreamer command line the debugging option that will display all warnings regarding the TI elements.
<pre>-v --gst-debug=TI*:2</pre>

If there are no errors shown, but the player still doesn't show up, check if the video is of a compatible format and size (should be up to 480p).

[[Category:Linux|Video Playback]]
[[Category:CM-T3530|Linux: Video Playback]]

← Older revision		Revision as of 13:05, 10 July 2011
Line 18:		Line 18:

	'''Only baseline profile of H.264 and simple profile of MPEG4 formats are supported.''' Please refer to the TI [http://software-dl.ti.com/dsps/dsps_public_sw/codecs/OMAP35xx/index_FDS.html H.264] and [http://software-dl.ti.com/dsps/dsps_public_sw/codecs/C64XPlus_Video/index_FDS.html MPEG-4] codecs Data Sheets.		'''Only baseline profile of H.264 and simple profile of MPEG4 formats are supported.''' Please refer to the TI [http://software-dl.ti.com/dsps/dsps_public_sw/codecs/OMAP35xx/index_FDS.html H.264] and [http://software-dl.ti.com/dsps/dsps_public_sw/codecs/C64XPlus_Video/index_FDS.html MPEG-4] codecs Data Sheets.
		+
		+	=== Kernel modules ===
		+	OMAP3530 SoC requires the following modules for video playback:
		+	* digital signal processor (DSP) core driver modules
		+	* 2D/3D graphics accelerator (SGX) driver modules
		+	The run-time demo Angstrom Linux filesystem including the video modules was created using OpenEmbedded framework.
		+	If the CM-T3530 Linux kernel image is built outside the OpenEmbedded framework, the pre-built DSP and SGX modules
		+	must be installed onto the filesystem separately:
		+	# Build Linux kernel as described in [[CM-T3530:_Linux:_Kernel#Building_the_kernel\|CM-T3530: Linux: Kernel]] article.
		+	# Copy the pre-built DSP and SGX video modules from the CM-T3530 Linux package to the kernel modules directory (e.g. {{filename\|/home/development/cm-t35/rootfs/lib/modules/<kernel version>/}}).
		+	# Put the {{filename\|depmod.sh}} script from the CM-T3530 Linux package into the {{filename\|/etc/init.d/}} directory on the root file system.
		+	# Install the {{filename\|depmod.sh}} to the required runlevel using {{filename\|update-rc.d}} utility. Note, that the Angstrom Linux filesystem provided in CM-T3530 Linux package has the script already installed.

	=== Kernel parameters ===		=== Kernel parameters ===

CM-T3530: Linux: Video playback - Revision history

Ilya: /* Kernel modules */

Mike: /* Videos not playing. */