Project

General

Profile

Sdrangelove » History » Version 16

laforge, 02/28/2016 06:43 PM

1 15 horiz0n
{{>toc}}
2 1 horiz0n
3 15 horiz0n
h1. Project sdrangelove
4
5
6 1 horiz0n
TODO
7
8 15 horiz0n
{{thumbnail(gsm.jpg, size=600)}}
9
{{thumbnail(lte.jpg, size=600)}}
10 1 horiz0n
11
12 15 horiz0n
h2. Supported Hardware
13 1 horiz0n
14
15 15 horiz0n
While primarily being developed for the [[OsmoSDR]] hardware, sdrangelove as well supports:
16 1 horiz0n
17 15 horiz0n
* "FunCube Dongle":http://tetra.osmocom.org/trac/wiki/Funcube_Dongle through libgnuradio-fcd
18
* "FUNcube Dongle Pro+":http://www.funcubedongle.com/?page_id=1073 through "gr-fcdproplus":https://github.com/dl1ksv/gr-fcdproplus
19
* "sysmocom [[OsmoSDR]]":http://sdr.osmocom.org/trac/ Devices through "libosmosdr":http://cgit.osmocom.org/osmo-sdr/
20
* "Nuand LLC bladeRF":http://nuand.com/ through "libbladeRF library":https://github.com/Nuand/bladeRF
21
* "Great Scott Gadgets [[HackRF]]":http://greatscottgadgets.com/hackrf/ through "libhackrf":https://github.com/mossmann/hackrf
22
* "Ettus USRP":http://www.ettus.com/product Devices through "Ettus UHD library":http://files.ettus.com/uhd_docs/manual/html/build.html
23
* "Fairwaves [[UmTRX]]":http://umtrx.org through "Fairwaves' fork of Ettus' UHD library":https://github.com/fairwaves/UHD-Fairwaves
24
* RFSPACE "SDR-IQ":http://www.rfspace.com/RFSPACE/SDR-IQ.html, "SDR-IP":http://www.rfspace.com/RFSPACE/SDR-IP.html, "NetSDR":http://rfspace.com/RFSPACE/NetSDR.html "(incl. X2 option)":http://www.rfspace.com/RFSPACE/NetSDR-X2.html
25
* RTL2832U based DVB-T dongles through "librtlsdr":http://sdr.osmocom.org/trac/wiki/rtl-sdr
26
* RTL-TCP spectrum server (see librtlsdr project)
27
* MSi2500 based DVB-T dongles through "libmirisdr":http://cgit.osmocom.org/libmirisdr/
28
* gnuradio .cfile input through libgnuradio-blocks
29
30
31
h2. Software
32
33
34 1 horiz0n
The sdrangelove code can be checked out with:
35 15 horiz0n
<pre>
36 1 horiz0n
git clone git://git.osmocom.org/sdrangelove.git
37 15 horiz0n
</pre>
38 1 horiz0n
39
It can also be browsed on http://cgit.osmocom.org/cgit/sdrangelove/
40
41 15 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.
42 1 horiz0n
43
44 15 horiz0n
h3. Mailing List
45
46
47 1 horiz0n
We discuss sdrangelove on the following mailing list: osmocom-sdr at lists.osmocom.org.
48
49 15 horiz0n
You can subscribe and/or unsubscribe via the following link: "h3. Building the software
50 1 horiz0n
51 14 horiz0n
52 1 horiz0n
53 15 horiz0n
h4. prerequisites
54
55
56 1 horiz0n
Download and install Qt5 from http://qt-project.org/downloads
57
58 14 horiz0n
Build and install gr-osmosdr master (gnuradio required) or standalone branch (gnuradio not required), see below for build instructions...
59
60 1 horiz0n
Pulseaudio is requirement.
61
62
63 15 horiz0n
h4. sdrangelove
64 1 horiz0n
65
66 15 horiz0n
*You have to install development packages for libusb1.0* to build the software.
67
68
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).
69
70 1 horiz0n
Building with cmake:
71 15 horiz0n
<pre>
72 1 horiz0n
cd sdrangelove/
73
mkdir build
74 14 horiz0n
cd build
75 1 horiz0n
cmake ../ -DCMAKE_PREFIX_PATH=/path/to/Qt/5.2.0/gcc_64/lib/cmake/
76
make
77 15 horiz0n
</pre>
78 3 horiz0n
79 1 horiz0n
Running it:
80
81 15 horiz0n
<pre>
82 1 horiz0n
cd sdrangelove
83
cd build/
84
./sdrangelove
85 15 horiz0n
</pre>
86 1 horiz0n
87
88 15 horiz0n
h4. Gnuradio Source
89 1 horiz0n
90 15 horiz0n
91
*The Gnu Radio source requires a recent gnuradio (>= v3.7) to be installed.*
92
93 1 horiz0n
The source supports direct device operation as well as a tcp client mode when using the rtl_tcp utility as a spectrum server.
94
95
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.
96
97 15 horiz0n
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.
98 7 horiz0n
99 15 horiz0n
Building with cmake (as described in the [https://sdr.osmocom.org/trac/wiki/GrOsmoSDR gr-osmosdr wiki page":http://lists.osmocom.org/mailman/listinfo/osmocom-sdr]):
100 7 horiz0n
101 15 horiz0n
<pre>
102 1 horiz0n
git clone git://git.osmocom.org/gr-osmosdr
103
cd gr-osmosdr/
104 15 horiz0n
</pre>
105 1 horiz0n
106
You can build a standalone (no gnuradio required) version for gr-osmosdr by doing
107
108 15 horiz0n
<pre>
109 1 horiz0n
git checkout standalone
110 15 horiz0n
</pre>
111 1 horiz0n
112
then continue with
113
114 15 horiz0n
<pre>
115 1 horiz0n
mkdir build
116
cd build/
117
cmake ../
118 15 horiz0n
</pre>
119 1 horiz0n
120
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.
121 15 horiz0n
<pre>
122 1 horiz0n
-- ######################################################
123
-- # gr-osmosdr enabled components                         
124
-- ######################################################
125
--   * Python support
126
--   * Osmocom IQ Imbalance Correction
127 15 horiz0n
--   * sysmocom [[OsmoSDR]]
128 1 horiz0n
--   * FUNcube Dongle
129
--   * FUNcube Dongle Pro+
130
--   * IQ File Source
131
--   * Osmocom RTLSDR
132
--   * RTLSDR TCP Client
133
--   * Ettus USRP Devices
134 15 horiz0n
--   * Osmocom [[MiriSDR]]
135
--   * [[HackRF]] Jawbreaker
136 1 horiz0n
--   * nuand bladeRF
137
--   * RFSPACE Receivers
138
-- 
139
-- ######################################################
140
-- # gr-osmosdr disabled components                        
141
-- ######################################################
142 4 horiz0n
-- 
143 13 horiz0n
-- Building for version: 4c101ea4 / 0.0.1git
144 1 horiz0n
-- Using install prefix: /usr/local
145 15 horiz0n
</pre>
146 1 horiz0n
147
Now build & install
148 15 horiz0n
<pre>
149 1 horiz0n
make
150
sudo make install
151
sudo ldconfig
152 15 horiz0n
</pre>
153 1 horiz0n
154
155 15 horiz0n
h4. Automated installation
156 1 horiz0n
157
158 15 horiz0n
Marcus D. Leech has kindly integrated the forementioned build steps into his gnuradio installation script at "This is the most user-friendly option so far.
159 1 horiz0n
160 15 horiz0n
You also may try the [[PyBOMBS]] developed by gnuradio.org folks.
161
162
163
h2. Plugins
164
165
166 1 horiz0n
The following 3rd party plugins are available:
167
168 15 horiz0n
||*Name*||*Author*||*URL*||
169 1 horiz0n
||pocsag||who's first?||...||
170
||ads-b||who's first?||...||
171
||apco p25||who's first?||...||
172
||tetra||who's first?||...||
173
174 15 horiz0n
[[br":http://www.sbrac.org/files/build-gnuradio].]
175 1 horiz0n
Not using sdrangelove? Tell us why! :)
176
[[br]][[br]][[br]]
177
178
179 15 horiz0n
h2. Credits
180
181
182
sdrangelove is developed by Christian Daniel of "maintech GmbH":http://maintech.de with contributions from Hoernchen and Dimitri Stolnikov.
Add picture from clipboard (Maximum size: 48.8 MB)