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 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.