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