'''(work in progress)'''
== Overview ==
* OpenGL|ES acceleration
* DSP-accelerated media playback with GStreamer (work in progress)
GeeXboX is currently being developed under the [http://www.openbricks.org OpenBricks] project, an enterprise-grade embedded Linux framework that provides easy creation of custom distributions for industrial embedded devices.
This How-To is meant to be a starting point for people to learn install a GeeXboX image for IGEP v2 devices as quickly and easily as possible.
* The GeeXboX website ( http://www.geexbox.org )
* The OpenBricks website (http://www.openbricks.org )
* The Enna website ( http://enna.geexbox.org )
<span style="color: rgb(255, 0, 0);">'''Note:''' The development branch is where the development work takes place and you should use this if you're after to work with the latest cutting edge developments. It is possible trunk can suffer temporary periods of instability while new features are developed and if this is undesirable we recommend using one of the release branches. '''Use ONLY for development purposes.'''</span>
GeeXbox uses GeeXboX and OpenBricks use Mercurial as a revision control system, so you will install the mercurial package for your host systesystem. On an Ubuntu-based system this will be done with,
$ sudo apt-get install mercurial
Now, the first thing you will do is download the sources from Mercurial OpenBricks repository (which is where bleeding-edge GeeXboX repository. $ hg clone http://hg.geexbox.org/geexbox Next, enter to geexbox directory and edit with your preferred editor the config/options filedevelopment is done). Set
TARGET_ARCH=arm TARGET_CPU=cortex-a8 SERVICES=yes XORG_DRIVERS="omapfb" PULSEAUDIO=no GSTREAMER=yes DEVTOOLS=yes$ hg clone http://hg.openbricks.org/openbricks
Finally Next, configure OpenBrics to build a GeeXboX image for the distribution withOMAP3 platform. Run
$ make flatmenuconfig
The result will be in geexbox-flat-devel-*.arm.eglibc directoryand set
== Make a bootable MMC card with GeeXbox == Flavour -> GeeXboX
First prepare the SD card the following way: General Setup -> Target architecture (arm)* create one boot FAT32 -> Target sub-architecture (type 0BARMv7 / Cortex) partition -> Target platform (OMAP3) -> Target CPU (cortex-a8) -> FPU optimizations (NEON) Settings -> Target Images -> Flat root Features -> Audio -> deselect PulseAudio (recommended, any size, I took 8MB* create one rootfs EXT2 partition.for now PulseAudio has been tested only on x86)
Then copy the uImage and boot.ini files If you want to FAT32 partitionenable OpenGL|ES acceleration set
$ cp geexboxFeatures -flat> Enable non-develfree components Features -> Hardware Accelerators -> EGL -> OpenGL -> OpenGL|ES -*.arm.eglibc/boot/boot.ini /media/boot> OpenVG $ cp geexbox -flat> EGL provider (SGX) -devel> OpenGL|ES provider (SGX) -*.arm.eglibc/boot/uImage /media/boot> OpenVG provider (SGX)
Next, edit the geexbox-flat-devel-*.arm.eglibc/etc/video file and disable the OpenGL supportIf you want to enable OpenMAX acceleration set
OPENGL=noFeatures -> Enable non-free components Features -> Hardware Accelerators -> OpenMAX -> OpenMAX provider (TI OpenMAX IL)
Finally, copy the geexbox-flat-devel-*.arm.eglibc contents If you want to EXT2 partition.enable TI DSP acceleration (lightweigth alternative to OpenMAX for DSP acceleration)
$ fakeroot cp Features -dpfa > Enable non-R geexboxfree components Features -flat> Hardware Accelerators -devel-*.arm.eglibc/* /media/rootfs/> TI C64x DSP
With default environment the IGEP v2 detects the boot.ini script which contains all the necessary instructions for the OS to auto-bootOptionally select other features or packages you may need.
== Annex: Known issues Exit and solutions ==save the configuration, then build with
=== Requested 'dbus-1 >= 1.2.16' but version of dbus is 1.1.20 === $ make
The libnih package fails, libnih is compiled for host and for target so your host system needs at least version 1.2.16 of dbus-1.resulting rootfs will be placed in the binaries directory directory
Distributions affected:== Make a bootable MMC card with GeeXbox ==
First prepare the SD card the following way:* Ubuntu 8.04 LTS create one boot FAT32 (Hardy Herontype 0B)partition, any size, I took 8MB* create one rootfs EXT2 partition.
=== BUILD alsa make: *** [flat] Error 1 ===Then copy the uImage and boot.ini files to FAT32 partition (paths relative to the rootfs location)
Error : $ cp boot/boot.ini /media/boot $ cp boot/uImage /media/boot
+ scripts/build alsa-lib + scripts/build alsa-utils + '[' no = yes ']' make: *** [flat] Error 1Finally, copy the rootfs contents to EXT2 partition (paths relative to the rootfs location)
Append to packages $ fakeroot cp -dpfa -R * /alsamedia/rootfs/build
exit 0With default environment the IGEP v2 detects the boot.ini script which contains all the necessary instructions for the OS to auto-boot.
Should be fixed in [http== Annex://hg.geexbox.org/geexbox/rev/9551cf55a78f r8303].Known issues and solutions ==
=== gzip: stdin: invalid compressed data--crc error ===