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. |