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