Manual compilation and installation¶

Currently manual method of installation is considered to be the easiest way to get newest version of gr-gsm up and running. The gr-gsm repository contains automatic tests of manual installation in form of dockerfiles that are built and executed by Travis CI continuous integration service. Travis CI informs if particular revision of gr-gsm builds and passes tests on a set of GNU/Linux distributions. History of the results can be checked on the gr-gsm's Travis CI page.

The instructions presented here are a version of dockerfiles:https://github.com/ptrkrysik/gr-gsm/tree/development/tests/dockerfiles with stripped instructions specific to docker and without running unit tests. This wiki might at some moment be behind installation procedures contained in the dockerfiles:https://github.com/ptrkrysik/gr-gsm/tree/development/tests/dockerfiles so in case of installation problems it is a good idea to look in there.

Debbian-based distributions (Debian Testing, Ubuntu 16.04+, Kali Rolling Edition)¶

Install all needed prerequisites with following command:

apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y \
    cmake \
    autoconf \
    libtool \
    pkg-config \
    build-essential \
    python-docutils \
    libcppunit-dev \
    swig \
    doxygen \
    liblog4cpp5-dev \
    python-scipy \
    gnuradio-dev \
    gr-osmosdr \
    libosmocore-dev

Currently on Debian Testing and Kali Rolling execution of following command is needed:

 sudo ln -sf /usr/lib/x86_64-linux-gnu/libvolk.so.1.3.1 /usr/lib/x86_64-linux-gnu/libvolk.so.1.3 

It is a workaround due to an issue with faulty libvolk installation on these systems at the moment.

git clone https://git.osmocom.org/gr-gsm
cd gr-gsm
mkdir build
cd build
cmake ..
mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/
make
sudo make install
sudo ldconfig

To speedup compilation instead of "make" you can use parallel build

make -j $nproc

where "$nproc" is number of CPU cores. The "mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/" line is there because without it parallel build sometimes fails.

Fedora 26¶

Install all needed prerequisites with following command:

dnf install -y \
    gcc-c++ \
    make \
    cmake \
    pkgconfig \
    boost-devel \
    gnuradio-devel \
    libosmocore-devel \
    gr-osmosdr \
    swig \
    doxygen \
    python2-docutils \
     cppunit-devel

Then download the gr-gsm's source and build it with following commands:

git clone https://git.osmocom.org/gr-gsm
cd gr-gsm
mkdir build
cd build
cmake ..
mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/
make
sudo make install
sudo ldconfig

To speedup compilation instead of "make" you can use parallel build

make -j $nproc

where "$nproc" is number of CPU cores. The "mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/" line is there because without it parallel build sometimes fails.

Installation from packages on Debian Testing and Ubuntu 18.04+¶