Vmeta

From OLPC
Jump to navigation Jump to search

vMeta is a hardware-accelerated multimedia encoding and decoding engine included in the XO-1.75 and XO-4.

Installation and test

Tested on 12.1.0 on XO-1.75.

  1. Install gstreamer-plugins-marvell and libvmeta-marvell
  2. Download http://techslides.com/demos/sample-videos/small.mp4 and play it in Totem in GNOME

For a beefier test video, try http://archive.org/download/hellmans_mayonnaise_commercial/hellmans_mayonnaise_commercial.mpeg

Note that these packages do include software decoders too (not sure why) so just seeing the video play back doesn't mean that it is being done by the vmeta hardware engine. The best way to be confident that hardware accel is being used is by looking at totem standard output, which should be limited to:

vmetadec istance(0x....) found
At finalizing, Gstvmetadec instance(0x....) DecErroOccured is 0x0
Gstvmetadec instance(0x....) is finalized.

Also look in dmesg, check that there are not any vmeta-related complaints there.

Troubleshooting

Hangs after displaying first frame

Check that regular audio playback is working (e.g. with speaker-test).

gstreamer-plugins-marvell

This RPM package is built from two source tarballs: gst-plugins-marvell and gst-plugins-vmetaxv.

gst-plugins-marvell

This codebase seems to originate from Marvell. It provides several gstreamer plugins that do encoding/decoding using libvmeta (and friends) - apparently making existing gstreamer apps use hardware acceleration (via vmeta) for encoding and decoding purposes.

gstreamer-plugins-marvell-0.10-1

No source was published by the developer. Details unknown.

gstreamer-plugins-marvell-0.10-2

The Cubox package bundle (see their wiki) includes gst-plugins-marvell0.10_0.2.0-0ubuntu1~ppa14.tar.gz. This source tarball has full git history from the developers at Marvell, with the latest change committed in March 2011.

Our RPM was based on this, with this code change applied by OLPC. There is no associated info/changelog for this patch; presumably it is the minimum needed to make it work on MMP2.

gstreamer-plugins-marvell-0.10-3

There were no changes to the gst-plugins-marvell source used to build this version.

gstreamer-plugins-marvell-0.10-4

This version switches to an alternative gst-plugins-marvell codebase found in the private Android code-drops from Marvell (specifically the toughpad-a1 drop). No git history is included. Looking at the files and changes through each code drop, it would appear that this codebase shares an origin with the codebase found in the cubox download, but later diverged, while still merging in some of the changes from the cubox-acquired git tree.

For example, the Android codebase includes a debian/changelog file, with the latest entry from 2009. The cubox codebase comes with the same changelog but with entries going all the way to 2011. However, some of the things described in the post-2009 cubox codebase changelog are implemented in the Android codebase. This suggests a fork of the codebase and some confused history.

Despite the confusion, it does seem clear that this Android codebase is more recent than the Cubox gst-plugins-marvell0.10_0.2.0-0ubuntu1~ppa14.tar.gz (with last commit date March 2011). The gingerbread-beta3 code drop was received in October 2011, and this same codebase was updated in the toughpad-a1 code drop received in November 2012. This new version has some small fixes and other changes.

On top of this, OLPC applies some changes (no changelog/info available):

  • g711dec and g711enc compilation enabled in configure.ac
  • Marvell code compiles mpeg2dec with the FORBID_WMMX_DEINTERLACE flag; we drop that flag.
  • Add missing include to fix compile of gstwmvdec
  • Enable compilation of libgstvmetaenc (looks like the Marvell codebase only compiles the decoders)
  • Update to the latest GMutex API to fix compile warnings/failures

vmetaxv

This source package is a fork of gst-plugins-base. It seems to originate from Marvell, under the name "gst-plugins-bmmxv" (Buffer Management Module), and is shipped in the Cubox package bundle. The source tarball gst-plugins-bmmxv0.10_0.10.25-0ubuntu1~ppa9.tar.gz included there includes git history. Here is a diff of the changes between gst-plugins-base-0.10.26.3 and the bmmxv tarball.

OLPC has renamed/repackaged this as vmetaxvimagesink based on top of gst-plugins-base-0.10.36.

It looks like the motivation here is that xvimagesink always does a copy of the data it is going to display. vmetaxvimagesink is a modified xvimagesink that, in the case where it detects that the buffer comes from vmeta, it avoids the memcpy. The physical address is sent to the Xv driver and it is handled directly.

gstreamer-plugins-marvell-0.10-2.olpc

This is the first version where vmetaxvimagesink appears. It is based on gst-plugins-base git commit 12ef907f8a3762685da0b96391edc30a78d31805.

gstreamer-plugins-marvell-0.10-3.olpc

This is a minor change upon the previous release, which appears to be more careful when distinguishing between vmeta and non-vmeta image buffers.

gstreamer-plugins-marvell-0.10-4.xo4

Catches any error returned from posix_memalign (previously any failure here was ignored).

libvmeta-marvell

This package contains what is referred to by Marvell as libvmeta and marvell-ipp.

libvmeta

libvmeta is a simple library that provides access to vmeta kernel-level functionality. It provides:

  1. Memory mapping functions, to allocate a region of DMA-capable memory (e.g. via pmem)
  2. Access to the kernel's UIO interface to vmeta

libvmeta source code can be found in the Cubox package bundle. libvmeta_1.0ubuntu2.tar.gz has full git history up to December 2010 and uses bmm-lib for memory allocation. bmm-lib sources can also be found in the Cubox package bundle; it seems to use an unknown /dev/bmm interface to obtain DMA memory allocations, and also has some (not built/used) code that can do the same via Android's pmem.

libvmeta source code can also be found in the private Marvell Android code drops. The initial version used bmm-lib, but this was later updated to use pmem directly (in gingerbread-beta1). In gingerbread-beta3, this code was updated to use libphycontmem. This code drop also includes libphycontmem which appears to be a simple wrapper around pmem.

It appears that OLPC's libvmeta-marvell-005 offering is based on the code found in the gingerbread-beta3 code drop, as we ship and link against libphycontmem, with pmem in place on the kernel side. However OLPC also ships libpmemhelper, presumably originating from inside OLPC, and libvmeta links to this.

libvmeta-marvell-006 continues to ship libvmeta linked against libphycontmem, and both have been recompiled since 005. "strings" shows that this new libphycontmem doesn't refer to pmem, and it does link to a new libionhelper. libionhelper is a 4kb library that provides a simple API to access the kernel's /dev/ion interface (as suggested by 'strings'). This libphycontmem change, and libionhelper itself, would appear to originate from inside OLPC.

marvell-ipp

This package seems to include a number of codecs. I presume they are software codecs, due to the size of the libraries, and the fact that disabling vmeta support (at the kernel level, i.e. disable pmem) will still allow videos to play correctly. It is not clear to me why software codecs are included in a hardware accelerated multimedia encoding/decoding system. Also some of them (ones you'd think are important) are/were softftp and that didn't cause known problems.

libvmeta-marvell-005

In libvmeta-marvell-005 we ship the following armv5tel softfp libraries originating from "marvell-ipp":

  • libcodec{aac,amrnb,amrwb,h263,h264,jpeg,mpeg4,vmeta}{dec,enc}
  • libcodec{g711,gifdec,midi,mp3dec,mpeg2dec,pngdec,wmadev,wmvdec}
  • libipp{cam,deint,ie,sp,vp}
  • libvmetahal

And some hardfp libraries:

  • libmiscgen

The exact origins of these are unknown. The Cubox bundle does include these libraries, but they are different, and all are softfp. The libmiscgen source code can be found inside marvell-ipp_0.2.1-0ubuntu1~ppa10.tar.gz at marvell-ipp/example/misc.

libvmeta-marvell-006

This release adds libcodecg729 (hardfp), and the following previously-softfp libraries are replaced by ARMv7/hardfp versions:

  • libcodec{aacenc,aacdec,amrnb,amrwb,h264dec,mp3dec,mpeg4dec,wmadec,g711}

All of the other libraries have been changed as well (no matching md5sums) even though they are still softfp.