Project

General

Profile

Sdrangelove » History » Version 11

horiz0n, 02/19/2016 10:51 PM

1 1 horiz0n
[[PageOutline]]
2
= Project sdrangelove =
3
4
TODO
5
6 11 horiz0n
[[Image(gsm.jpg, 600px)]]
7
[[Image(lte.jpg, 600px)]]
8 8 horiz0n
9 1 horiz0n
== Supported Hardware ==
10
11
While primarily being developed for the OsmoSDR hardware, sdrangelove as well supports:
12
13
 * [http://tetra.osmocom.org/trac/wiki/Funcube_Dongle FunCube Dongle] through libgnuradio-fcd
14
 * [http://www.funcubedongle.com/?page_id=1073 FUNcube Dongle Pro+] through [https://github.com/dl1ksv/gr-fcdproplus gr-fcdproplus]
15
 * [http://sdr.osmocom.org/trac/ sysmocom OsmoSDR] Devices through [http://cgit.osmocom.org/osmo-sdr/ libosmosdr]
16
 * [http://nuand.com/ Nuand LLC bladeRF] through [https://github.com/Nuand/bladeRF libbladeRF library]
17
 * [http://greatscottgadgets.com/hackrf/ Great Scott Gadgets HackRF] through [https://github.com/mossmann/hackrf libhackrf]
18 5 horiz0n
 * [http://www.ettus.com/product Ettus USRP] Devices through [http://files.ettus.com/uhd_docs/manual/html/build.html Ettus UHD library]
19
 * [http://umtrx.org Fairwaves UmTRX] through [https://github.com/fairwaves/UHD-Fairwaves Fairwaves' fork of Ettus' UHD library]
20 1 horiz0n
 * RTL2832U based DVB-T dongles through [http://sdr.osmocom.org/trac/wiki/rtl-sdr librtlsdr]
21
 * RTL-TCP spectrum server (see librtlsdr project)
22
 * MSi2500 based DVB-T dongles through [http://cgit.osmocom.org/libmirisdr/ libmirisdr]
23
 * gnuradio .cfile input through libgnuradio-blocks
24
25
== Software ==
26
27
The sdrangelove code can be checked out with:
28
{{{
29 7 horiz0n
git clone git://git.osmocom.org/sdrangelove.git
30 1 horiz0n
}}}
31
32
It can also be browsed on http://cgit.osmocom.org/cgit/sdrangelove/
33
34 7 horiz0n
If you are going to "fork it on github" and enhance it, don't leave it bitrot there - '''contribute back''' and submit your patches to: osmocom-sdr at lists.osmocom.org. The amount (and quality) of contribution from the commmunity '''will have a direct impact''' on the availability of new features.
35 1 horiz0n
36
=== Mailing List ===
37
38 2 horiz0n
We discuss sdrangelove on the following mailing list: osmocom-sdr at lists.osmocom.org.
39 1 horiz0n
40
You can subscribe and/or unsubscribe via the following link: [http://lists.osmocom.org/mailman/listinfo/osmocom-sdr]
41
42
=== Building the software ===
43
44
==== sdrangelove ====
45
46
'''You have to install development packages for libusb1.0''' to build the software.
47
48
Sdrangelove comes with built-in support for OsmoSDR and rtl-sdr. Additional hardware support is available through a gr-osmosdr plugin which will be built automaticaly if gr-osmosdr has been installed (see below for guidance).
49
50
Building with cmake:
51
{{{
52
cd sdrangelove/
53
mkdir build
54
cd build
55
cmake ../
56
make
57
}}}
58
59 3 horiz0n
Running it:
60 1 horiz0n
61
{{{
62
cd sdrangelove
63
cd build/
64
./sdrangelove
65
}}}
66
67
==== Gnuradio Source ====
68
69
'''The Gnu Radio source requires a recent gnuradio (>= v3.7) to be installed.'''
70
71
The source supports direct device operation as well as a tcp client mode when using the rtl_tcp utility as a spectrum server.
72
73
Please note: prior pulling a new version from git and compiling it, please do a "make uninstall" from build directory first to properly remove the previous version.
74
75
Please note: you always should build & '''install the latest version of the dependencies''' before trying to build the gr source. The build system of gr-osmosdr will recognize them and enable specific source/sink components thereafter.
76
77
Building with cmake (as described in the [https://sdr.osmocom.org/trac/wiki/GrOsmoSDR gr-osmosdr wiki page]):
78
79
{{{
80
git clone git://git.osmocom.org/gr-osmosdr
81
cd gr-osmosdr/
82 7 horiz0n
}}}
83
84
You can build a standalone (no gnuradio required) version for gr-osmosdr by doing
85
86
{{{
87
git checkout standalone
88 1 horiz0n
}}}
89
90
then continue with
91
92
{{{
93
mkdir build
94
cd build/
95
cmake ../
96
}}}
97
98
Now cmake should print out a summary of enabled/disabled components. You may disable certain components by following guidelines shown by cmake. Make sure the device of your interest is listed here. Check your dependencies and retry otherwise.
99
{{{
100
-- ######################################################
101
-- # gr-osmosdr enabled components                         
102
-- ######################################################
103
--   * Python support
104
--   * Osmocom IQ Imbalance Correction
105
--   * sysmocom OsmoSDR
106 4 horiz0n
--   * FUNcube Dongle
107
--   * FUNcube Dongle Pro+
108 1 horiz0n
--   * IQ File Source
109
--   * Osmocom RTLSDR
110
--   * RTLSDR TCP Client
111
--   * Ettus USRP Devices
112
--   * Osmocom MiriSDR
113
--   * HackRF Jawbreaker
114 4 horiz0n
--   * nuand bladeRF
115 1 horiz0n
-- 
116
-- ######################################################
117
-- # gr-osmosdr disabled components                        
118
-- ######################################################
119
-- 
120
-- Building for version: 4c101ea4 / 0.0.1git
121
-- Using install prefix: /usr/local
122
}}}
123
124
Now build & install
125
{{{
126
make
127
sudo make install
128
sudo ldconfig
129
}}}
130
131
==== Automated installation ====
132
133
Marcus D. Leech has kindly integrated the forementioned build steps into his gnuradio installation script at [http://www.sbrac.org/files/build-gnuradio]. This is the most user-friendly option so far.
134
135 6 horiz0n
You also may try the ByBOMBS developed by gnuradio.org folks.
136 1 horiz0n
137
== Plugins ==
138
139
The following 3rd party plugins are available:
140
141
||'''Name'''||'''Author'''||'''URL'''||
142
||pocsag||who's first?||...||
143
||ads-b||who's first?||...||
144
||apco p25||who's first?||...||
145
||tetra||who's first?||...||
146
147
[[br]]
148
Not using sdrangelove? Tell us why! :)
149
[[br]][[br]][[br]]
150
151
== Credits ==
152
153 2 horiz0n
sdrangelove is developed by Christian Daniel of [http://maintech.de maintech GmbH] with contributions from Hoernchen and Dimitri Stolnikov.
Add picture from clipboard (Maximum size: 48.8 MB)