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