Project

General

Profile

Installation » History » Version 22

ptrkrysik, 07/27/2018 10:12 AM

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 20 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":http://git.osmocom.org/gr-gsm/tree/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 20 ptrkrysik
The instructions presented here are a version of "dockerfiles":http://git.osmocom.org/gr-gsm/tree/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":http://git.osmocom.org/gr-gsm/tree/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 21 ptrkrysik
git clone https://git.osmocom.org/gr-gsm
23 15 ptrkrysik
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 17 ptrkrysik
Then download the gr-gsm's source and build it with following commands:
65 5 ptrkrysik
<pre>
66 21 ptrkrysik
git clone https://git.osmocom.org/gr-gsm
67 5 ptrkrysik
cd gr-gsm
68
mkdir build
69
cd build
70
cmake ..
71
mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/
72
make
73
sudo make install
74
sudo ldconfig
75
</pre>
76
77
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.
78
79
h2. Fedora 26
80
81 9 ptrkrysik
Install all needed prerequisites with following command invoked with root's rights:
82 5 ptrkrysik
<pre>dnf install -y \
83
    gcc-c++ \
84
    make \
85
    cmake \
86
    pkgconfig \
87
    boost-devel \
88
    gnuradio-devel \
89
    libosmocore-devel \
90
    gr-osmosdr \
91
    swig \
92
    doxygen \
93
    python2-docutils \
94 8 ptrkrysik
    cppunit-devel
95 5 ptrkrysik
</pre>
96 1 ptrkrysik
97
Then download the *gr-gsm*'s source and build it with following commands:
98 3 ptrkrysik
<pre>
99 21 ptrkrysik
git clone https://git.osmocom.org/gr-gsm
100 4 ptrkrysik
cd gr-gsm
101
mkdir build
102
cd build
103
cmake ..
104 1 ptrkrysik
mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/
105
make
106
</pre>
107
108 9 ptrkrysik
and as root:
109
<pre>
110
make install
111
ldconfig
112
</pre>
113
114 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.
115
116
117
h1. Installation from packages on Debian Testing and Ubuntu 18.04+
118 9 ptrkrysik
119
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:
120 16 ptrkrysik
<pre>sudo apt-get install gr-gsm</pre>
121 10 ptrkrysik
122
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":
123
<pre>
124
wget http://git.osmocom.org/gr-gsm/plain/apps/grgsm_livemon.grc
125
grcc -d . grgsm_livemon.grc
126
mv grgsm_livemon.py grgsm_livemon
127
</pre>
128
Then move the grgsm_livemon file into a directory in the search path, i.e. /usr/local/bin.
129 11 ptrkrysik
130
h1. Compilation and installation with use of Pybombs
131
132 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):
133 11 ptrkrysik
* head of *GNU Radio*'s master branch not compiling due to ongoing development,
134
* issues in *pybombs* resulting from intensive changes in the project,
135 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).
136 13 ptrkrysik
137
For installation of pybombs you will need git. On Debian based distributions you can get it with:
138
<pre>
139
sudo apt-get install git python-pip
140
</pre>
141
Then install *pybombs* with following command:
142
<pre>
143
sudo pip install PyBOMBS
144
</pre>
145
146
Then configure installation prefix:
147
<pre>
148
pybombs auto-config
149
pybombs recipes add-defaults
150
sudo pybombs prefix init /usr/local -a default_prx -R gnuradio-default
151
sudo pybombs config default_prefix default_prx
152
</pre>
153
154
**Then build and install *gr-gsm* with following command**:
155
<pre>
156
sudo pybombs install gr-gsm
157
</pre>
158
159
Pybombs will take care of downloading all of required libraries and for installation of *GNU Radio* and building *gr-gsm*.
160
161
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.
162
163
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:
164
<pre>
165
sudo ldconfig
166
</pre>
Add picture from clipboard (Maximum size: 48.8 MB)