h1. RaspberryPiSourceInstall

This page explains how to install the libavg developer version from github on a Raspberry Pi by cross-compiling. The process involves compiling libavg on a separate Linux machine. The benefit of this is that compiling on the Pi 2 takes around an hour, while cross-compiling takes a few minutes (The original Pi would finish in 4-6 hours or fail with an out of memory condition). The downside is that it's a bit harder to set up.

Alternatively, you can compile directly on the Pi by following the [[UbuntuSourceInstall]] directions.

h2. Install dependencies on the Pi

*_On the Pi_*, install the needed packages:

<pre>
<code>$ sudo apt-get install git automake autoconf libtool libxml2-dev \
libpango1.0-dev librsvg2-dev libgdk-pixbuf2.0-dev libavcodec-dev libavformat-dev \
libswscale-dev libavresample-dev python-dev libboost-python-dev libboost-thread-dev g++ libSDL-dev \
libxxf86vm-dev libdc1394-22-dev linux-libc-dev
</code>
</pre>

h2. Set up the Cross-compile Toolchain

This is the directory structure on the Linux machine:

<pre>rpi <pre>
rpi
libavg - the libavg source tree
root - copy of the PI filesystem
rpi-tools - the toolchain (compiler, linker, etc.) used to cross-compile
staging - the compiled version of libavg that will be copied to the PI
</pre>

*_On the Linux machine_*, download the crosscompile tools to rpi-tools:

<pre>
<code>$ <code>
$ cd rpi
$ git clone git://github.com/raspberrypi/tools.git
</code>
</pre>

Copy /usr, /lib, and /opt/vc directory trees from the Pi (replace $PI with the IP address of the Pi):

<pre>
<code>$ <code>
$ mkdir root
$ cd root
$ rsync -rl --delete-after --safe-links pi@$PI:/{lib,usr} .
$ rsync -rl --delete-after --safe-links pi@192.168.2.PI:/opt/vc opt
</code>
</pre>

Then, fix some system libraries so they don't contain references to absolute directories. Open the files in a text editor and change them. They are:

_root/usr/lib/arm-linux-gnueabihf/libpthread.so_:

<pre>
<code>OUTPUT_FORMAT(elf32-littlearm) <code>
OUTPUT_FORMAT(elf32-littlearm)
GROUP ( libpthread.so.0 libpthread_nonshared.a )
</code>
</pre>

_root/usr/lib/arm-linux-gnueabihf/libc.so_:

<pre>
<code>OUTPUT_FORMAT(elf32-littlearm) <code>
OUTPUT_FORMAT(elf32-littlearm)
GROUP ( libc.so.6 libc_nonshared.a AS_NEEDED ( ld-linux-armhf.so.3 ) )
</code>
</pre>

Fix some symlinks:

<pre>
<code>$ <code>
$ cd root/usr/lib/arm-linux-gnueabihf/
$ ln -s ../../../lib/arm-linux-gnueabihf/libm.so.6 libm.so
$ ln -s ../../../lib/arm-linux-gnueabihf/libdl.so.2 libdl.so
</code>
</pre>

Put the toolchain into the path ($RPI is the absolute path to your rpi directory):

<pre>
<code>$ $ export PATH=$PATH:$RPI/rpi-tools/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64/bin
</code>
</pre>

h2. Build libavg

<pre>
<code>$ <code>
$ ./rpi-configure
$ DESTDIR=$RPI/staging make -j6
$ DESTDIR=$RPI/staging make install
</code>
</pre>

h2. Install on the Pi

Copy the compiled libavg to the Pi:

<pre>
<code>$ <code>
$ cd staging
$ rsync -au usr pi@$IP:/home/pi/Desktop
</code>
</pre>

*_On the Pi_*, copy libavg from the desktop to its final destination:

<pre>
<code>$ <code>
$ sudo cp -R ~/Desktop/usr/* /usr
</code>
</pre>

h2. Run the tests

<pre>
<code>$ <code>
$ cd /usr/local/share/python-libavg/test/
$ python Test.py
</code>
</pre>

That's it! libavg should now be running on your Pi.