Project

General

Profile

Sdrangelove » History » Version 17

fixeria, 09/06/2018 07:20 PM

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