Project

General

Profile

GettingStarted » History » Version 2

Anonymous, 02/19/2016 10:50 PM

1 1
[[PageOutline]]
2
= Getting Started =
3
4
== Prerequisites ==
5
6
You must first prepare your system by installing the required development packages.
7
8
For debian/ubuntu:
9
10
{{{
11
apt-get install build-essential libtool autoconf git-core pkg-config
12
}}}
13
14
If you want to capture samples off the air, you'll also need gnuradio and uhd. Installing those is outside the scope of this page, refer to the GNURadio / Ettus documentation.
15
16
== Compiling the software ==
17
18
=== libosmocore ===
19
20
You obviously need to install our main utility library:
21
22
{{{
23
git clone git://git.osmocom.org/libosmocore
24
cd libosmocore
25
autoreconf -i -f
26
./configure
27 2
make
28
sudo make install
29 1
cd ..
30
}}}
31
32
=== libosmo-sdr ===
33
34
Then you need to install our new Software Defined Radio helper library:
35
36
{{{
37
git clone git://git.osmocom.org/libosmo-sdr
38
cd libosmo-sdr
39
autoreconf -i -f
40
./configure
41 2
make
42
sudo make install
43 1
cd ..
44
}}}
45
46
=== osmo-gmr ===
47
48
And finally compile the main Osmocom GMR software stack:
49
50
{{{
51
git clone git://git.osmocom.org/osmo-gmr
52
cd osmo-gmr
53
autoreconf -i -f
54
./configure
55
make
56
cd ..
57
}}}
58
59
=== Capture tool ===
60
61
The current version of the capture tool is not integrated with the main autotool process yet and has to be built separately:
62
63
{{{
64
cd osmo-gmr/utils/gmr_multi_rx
65
make TARGET=uhd
66
cd ../../..
67
}}}
68
69
There are several possible targets depending on your hardware:
70
 * uhd: For using any ettus hardware
71
 * usrp: To use the libusrp drivers for the USRP1 hardware
72
 * fcdp: To use the specific Fun Cube Dongle Pro drivers
73
74 2
=== Wireshark ===
75
76
The best way to see the packets is using wireshark. All the required patches are not in mainline yet since the GMR support is far from complete. So you'll need to build wireshark from sources, using the {{{sylvain/gmr}}} branch of our local wireshark git.
77
78
{{{
79
git clone git://git.osmocom.org/wireshark
80
cd wireshark
81
./autogen.sh
82
./configure
83
make
84
sudo make install
85
cd ..
86
}}}
87
88 1
== Running the software ==
89
90 2
=== Capturing samples ===
91
92
You need to capture samples off the air and of course "there's an app for that".
93
For a first try the easier is to lookup a beam that match your geographic area by looking at ThurayaBeams and the associated map.
94
95
Depending on the target hw you selected, options might vary. Example below is for the UHD version. You can lookup the available options using {{{gmr_multi_rx -h}}} .
96
97
This example will capture ARFCN 941 and 942 for 10 second using the 'B' side daughterboard and the RX2 input :
98
99
{{{
100
./gmr_multi_rx --gmr1-dl 941 942 -a RX2 -S B:0 -T 10
101
}}}
102
103
A few notes concerning multi ARFCN capture:
104
 * All the ARFCN need to fit within the bandwidth of your device (so you can't get ARFCN1 and 1007 at once for example)
105
 * It can be pretty CPU intensive depending on the # of ARFCNs and how much they're spaced.
106
107
=== Analyzing them ===
108
109
 * Launch wireshark and listen to the lo interface
110
  * Make sure to use the custom version compiled above
111
  * Also make sure you have the rights to capture on lo
112
 * Run the {{{gmr_rx}}} compiled in the {{{src/}}} directory on the generated files:
113
  * {{{gmr1_rx 4 /tmp/gmr1-dl-977-sps93600.cfile}}}
114
 * View packets in wireshark
Add picture from clipboard (Maximum size: 48.8 MB)