wiki:BuildInstructionsPage
Last modified 6 months ago Last modified on 01/23/14 03:20:21

O B S O L E T E

In late 2013/early 2014 OP25 was migrated from svn to git. At the same time two other major changes were made (GNU Radio 3.7 API, which is not backward compatible; and automake was removed and replaced with cmake). This page contains instructions for building the old SVN and GR3.6 version of OP25.

See the new install page

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.6 or later) -- The free software digital signal processing toolkit and
  • autoconf+automake -- So you can create the configure script and makefiles.
  • 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 \
bison flex libgtk2.0-dev libpcap-dev

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://op25.osmocom.org/svn/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/blocks
./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 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.

Compiling the repeater block

First, compile the imbe_vocoder block (see above). Then do

cd op25/repeater
sh bootstrap
./configure
make
sudo make install

Build instructions for the Linux novice

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.