OP25j

= Getting and Building OP25 =

This page describes how you can get the latest version of OP25 and build it for your computer.

== Installing the Pre-requisites ==

Before doing anything you'll need to make sure you have all the pre-requisite software installed. At the very minimum this will include:

 * Subversion -- Revision control software to access the source code repository

 * g++ -- The GNU C++ compiler,

 * make -- GNU Make,

 * GNURadio (Release 3.2) -- The free software digital signal processing toolkit and

 * autoconf+automake -- So you can create the configure script and makefiles.

 * The [http://radiorausch.googlepages.com/gr-fsk4-22Apr08.tar.gz Radio Rausch demodulator] - Which produces a dibit stream from the P25 4L-FSK signal.

 * [http://itpp.sourceforge.net IT++] A library of communications-related code.

The details on what you need to obtain and how you do so vary between GNU/Linux distributions. Its easiest on Debian (and derived distributions such as Ubuntu) and can be quite painful on some distributions. Your mileage probably varies so feel free to document the process thoroughly. We get the pre-requisites installed with one command on Ubuntu as follows:

{{{

sudo apt-get -y install swig g++ automake libtool python-dev libfftw3-dev \

libcppunit-dev libboost-all-dev libusb-dev fort77 sdcc sdcc-libraries \

libsdl1.2-dev python-wxgtk2.8 subversion git-core guile-1.8-dev \

libqt4-dev python-numpy ccache python-opengl libgsl0-dev \

python-cheetah python-lxml doxygen qt4-dev-tools \

libqwt5-qt4-dev libqwtplot3d-qt4-dev pyqt4-dev-tools libitpp-dev

}}}

The [[http://radiorausch.googlepages.com/gr-fsk4-22Apr08.tar.gz Radio Rausch demodulator]] will need to be built and installed so you should follow advice given on that website before building OP25.

== Downloading the Source Code ==

Now you should be ready to get the source code. The best way to do this is using Subversion:

{{{

svn co http://svn.sedition.org.au/svn/op25/trunk op25

}}}

This should create a directory named 'op25' containing the latest version of the source files.

== Compiling ==

Compiling and installing OP25 requires you run the following commands:

{{{

cd op25/decoder

./bootstrap && ./configure && make

make check

sudo make install

}}}

Of course, you won't get away with it that easily! There are probably going to be compile errors and such that require you to install missing packages. Please make a careful note of the packages you need to install and problems you encounter. Then you can update this Wiki page to help others following after. For people without a login for the Wiki you can [mailto:banjax-help@sedition.org.au email me] with your notes. Developers can request a Wiki/Subversion login (with your preferred username/password).

== Compiling the imbe_vocoder block ==

For the most part, you can follow the directions in the INSTALL file.  Don't forget to run the bootstrap script prior to running configure.  You may also be able to get some extra speed by enabling some additional gcc optimizations.  Here's one possible build sequence:

{{{

cd op25/imbe_vocoder

sh bootstrap

./configure CXXFLAGS="-O3"

make

sudo make install

}}}

Note: the 'decoder' block (see above) must have previously been installed prior to building this block.

== Build instructions for the Linux novice ==

[BeginnersBuild These directions for beginners] might be of help to those without a background in Linux to get the project up and running, or even those with experience who are running into a wall getting a piece to build.