Project

General

Profile

Installation » History » Version 19

ptrkrysik, 07/09/2018 07:59 PM

1 14 ptrkrysik
h1. Installation
2
3
There are many ways to install *gr-gsm*:
4
* [[Installation#Manual-compilation-and-installation|Manual compilation and installation]]
5
* [[Installation#Installation-from-packages-on-Debian-Testing-and-Ubuntu-1804|Installation from distribution's packages]]
6 15 ptrkrysik
* [[Installation#Compilation-and-installation-with-use-of-Pybombs|Compilation and installation with use of Pybombs installation manager]]
7 14 ptrkrysik
8 2 ptrkrysik
h1. Manual compilation and installation
9 1 ptrkrysik
10 4 ptrkrysik
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.
11 1 ptrkrysik
12 18 ptrkrysik
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.
13 15 ptrkrysik
14
In general to install *gr-gsm* installation of folowing dependencies is required:
15
* *GNU Radio* with header files
16 19 ptrkrysik
* development tools: git, cmake, autoconf, libtool, pkg-config, g++, gcc, make, libc6 with headers, libcppunit with headers, swig, doxygen, liblog4cpp with headers, python-scipy
17 15 ptrkrysik
* gr-osmosdr
18
* libosmocore with header files
19
20 19 ptrkrysik
After installing them download the *gr-gsm*'s source and build it with following commands:
21 15 ptrkrysik
<pre>
22
git clone https://git.osmocom.org/gr-gsm
23
cd gr-gsm
24
mkdir build
25
cd build
26
cmake ..
27
mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/
28
make
29
</pre>
30
31
and as root:
32
<pre>
33
make install
34
ldconfig
35
</pre>
36
37
To speedup compilation instead of "make" you can use parallel build <pre>make -j $nproc</pre> where "$nproc" is number of CPU cores. The "mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/" line is there because without it parallel build sometimes fails.
38
39
Self-contained installation instructions for particular distributions that are tested with use of Travis CI are presented below.
40
41 1 ptrkrysik
42 6 ptrkrysik
h2. Debbian-based distributions (Debian Testing, Ubuntu 16.04+, Kali Rolling Edition) 
43 1 ptrkrysik
44 5 ptrkrysik
Install all needed prerequisites with following command:
45 1 ptrkrysik
46 3 ptrkrysik
<pre>
47 9 ptrkrysik
sudo apt-get update && sudo apt-get install -y \
48 1 ptrkrysik
    cmake \
49
    autoconf \
50
    libtool \
51
    pkg-config \
52
    build-essential \
53
    python-docutils \
54
    libcppunit-dev \
55
    swig \
56
    doxygen \
57
    liblog4cpp5-dev \
58
    python-scipy \
59
    gnuradio-dev \
60
    gr-osmosdr \
61
    libosmocore-dev
62 3 ptrkrysik
</pre>
63 1 ptrkrysik
64
Currently on Debian Testing and Kali Rolling execution of following command is needed:
65 3 ptrkrysik
<pre> sudo ln -sf /usr/lib/x86_64-linux-gnu/libvolk.so.1.3.1 /usr/lib/x86_64-linux-gnu/libvolk.so.1.3 </pre>
66 1 ptrkrysik
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.
67 5 ptrkrysik
68 17 ptrkrysik
Then download the gr-gsm's source and build it with following commands:
69 5 ptrkrysik
<pre>
70
git clone https://git.osmocom.org/gr-gsm
71
cd gr-gsm
72
mkdir build
73
cd build
74
cmake ..
75
mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/
76
make
77
sudo make install
78
sudo ldconfig
79
</pre>
80
81
To speedup compilation instead of "make" you can use parallel build <pre>make -j $nproc</pre> where "$nproc" is number of CPU cores. The "mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/" line is there because without it parallel build sometimes fails.
82
83
h2. Fedora 26
84
85 9 ptrkrysik
Install all needed prerequisites with following command invoked with root's rights:
86 5 ptrkrysik
<pre>dnf install -y \
87
    gcc-c++ \
88
    make \
89
    cmake \
90
    pkgconfig \
91
    boost-devel \
92
    gnuradio-devel \
93
    libosmocore-devel \
94
    gr-osmosdr \
95
    swig \
96
    doxygen \
97
    python2-docutils \
98 8 ptrkrysik
    cppunit-devel
99 5 ptrkrysik
</pre>
100 1 ptrkrysik
101
Then download the *gr-gsm*'s source and build it with following commands:
102 3 ptrkrysik
<pre>
103 1 ptrkrysik
git clone https://git.osmocom.org/gr-gsm
104 4 ptrkrysik
cd gr-gsm
105
mkdir build
106
cd build
107
cmake ..
108 1 ptrkrysik
mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/
109
make
110
</pre>
111
112 9 ptrkrysik
and as root:
113
<pre>
114
make install
115
ldconfig
116
</pre>
117
118 1 ptrkrysik
To speedup compilation instead of "make" you can use parallel build <pre>make -j $nproc</pre> where "$nproc" is number of CPU cores. The "mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/" line is there because without it parallel build sometimes fails.
119
120
121
h1. Installation from packages on Debian Testing and Ubuntu 18.04+
122 9 ptrkrysik
123
Thanks to work of Petter Reinholdtsen *gr-gsm* has packages for Debian Testing that were subsequently included in Ubuntu starting from 18.04. On these systems *gr-gsm* can be installed by simply doing:
124 16 ptrkrysik
<pre>sudo apt-get install gr-gsm</pre>
125 10 ptrkrysik
126
As of *gr-gsm*'s version 0.41.2 grgsm_livemon application doesn't work because of change of PyQT version in current Debian Testing and Ubuntu 18.04. In order to use this program you can generate new version out of "grgsm_livemon.grc":
127
<pre>
128
wget http://git.osmocom.org/gr-gsm/plain/apps/grgsm_livemon.grc
129
grcc -d . grgsm_livemon.grc
130
mv grgsm_livemon.py grgsm_livemon
131
</pre>
132
Then move the grgsm_livemon file into a directory in the search path, i.e. /usr/local/bin.
133 11 ptrkrysik
134
h1. Compilation and installation with use of Pybombs
135
136 13 ptrkrysik
*Pybombs* is *GNU Radio* project's installation manager that installs *GNU Radio* and related projects, *gr-gsm* included. In times when distributions provided too old *GNU Radio*, *pybombs* offered the most straightforward way of installing *gr-gsm* as it automagically compiles newest *GNU Radio* and all other *gr-gsm*'s prerequisites. *Pybombs* is doing quite complex work of figuring out what too install from packages of distribution and what to compile. Failures to install *gr-gsm* with use of *pybombs* were quite widespread among *gr-gsm* users due to many reasons. Some of them (in addition to general issues of *gr-gsm* installation):
137 11 ptrkrysik
* head of *GNU Radio*'s master branch not compiling due to ongoing development,
138
* issues in *pybombs* resulting from intensive changes in the project,
139 1 ptrkrysik
* small set of distributions on which *pybombs* is regularly tested (i.e. never ending problems on Kali Linux that is distribution of choice for many of *gr-gsm*'s users due to some unknown reason).
140 13 ptrkrysik
141
For installation of pybombs you will need git. On Debian based distributions you can get it with:
142
<pre>
143
sudo apt-get install git python-pip
144
</pre>
145
Then install *pybombs* with following command:
146
<pre>
147
sudo pip install PyBOMBS
148
</pre>
149
150
Then configure installation prefix:
151
<pre>
152
pybombs auto-config
153
pybombs recipes add-defaults
154
sudo pybombs prefix init /usr/local -a default_prx -R gnuradio-default
155
sudo pybombs config default_prefix default_prx
156
</pre>
157
158
**Then build and install *gr-gsm* with following command**:
159
<pre>
160
sudo pybombs install gr-gsm
161
</pre>
162
163
Pybombs will take care of downloading all of required libraries and for installation of *GNU Radio* and building *gr-gsm*.
164
165
It is required to have approximately 3.5GB of free space in /usr/local/src directory as everything will be built in there. If there is no enough space you can configure pybombs to use other directory as installation prefix.
166
167
At this moment many operating systems might not know where to look for new libgrgsm library. In order to update cache of links to new libraries run:
168
<pre>
169
sudo ldconfig
170
</pre>
Add picture from clipboard (Maximum size: 48.8 MB)