SDR (Software Defined Radio) » gr-gsm

h1. 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](https://github.com/ptrkrysik/gr-gsm/tree/development/tests/dockerfiles) that are built and executed by [Travis CI](https://travis-ci.org/ptrkrysik/gr-gsm/builds) 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](https://travis-ci.org/ptrkrysik/gr-gsm/builds).

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.

h2. Debbian-based distributions (Debian Testing, Ubuntu >=16.04, Kali Rolling Edition) 

First 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](https://github.com/ptrkrysik/gr-gsm/pull/378#issuecomment-379587145) with faulty libvolk installation on these systems at the moment.

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

# The parallel build sometimes fails when the .grc_gnuradio

# and .gnuradio directories do not exist

 mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/

 make #to speedup compilation you can use parallel build

      #"make -j $nproc" where $nproc is number of CPU cores

 sudo make install

 sudo ldconfig

```