Sdrangelove » History » Version 13
horiz0n, 02/19/2016 10:51 PM
1 | 1 | horiz0n | [[PageOutline]] |
---|---|---|---|
2 | = Project sdrangelove = |
||
3 | |||
4 | TODO |
||
5 | |||
6 | 11 | horiz0n | [[Image(gsm.jpg, 600px)]] |
7 | [[Image(lte.jpg, 600px)]] |
||
8 | 8 | horiz0n | |
9 | 1 | horiz0n | == Supported Hardware == |
10 | |||
11 | While primarily being developed for the OsmoSDR hardware, sdrangelove as well supports: |
||
12 | |||
13 | * [http://tetra.osmocom.org/trac/wiki/Funcube_Dongle FunCube Dongle] through libgnuradio-fcd |
||
14 | * [http://www.funcubedongle.com/?page_id=1073 FUNcube Dongle Pro+] through [https://github.com/dl1ksv/gr-fcdproplus gr-fcdproplus] |
||
15 | * [http://sdr.osmocom.org/trac/ sysmocom OsmoSDR] Devices through [http://cgit.osmocom.org/osmo-sdr/ libosmosdr] |
||
16 | * [http://nuand.com/ Nuand LLC bladeRF] through [https://github.com/Nuand/bladeRF libbladeRF library] |
||
17 | * [http://greatscottgadgets.com/hackrf/ Great Scott Gadgets HackRF] through [https://github.com/mossmann/hackrf libhackrf] |
||
18 | 5 | horiz0n | * [http://www.ettus.com/product Ettus USRP] Devices through [http://files.ettus.com/uhd_docs/manual/html/build.html Ettus UHD library] |
19 | * [http://umtrx.org Fairwaves UmTRX] through [https://github.com/fairwaves/UHD-Fairwaves Fairwaves' fork of Ettus' UHD library] |
||
20 | 13 | horiz0n | * RFSPACE [http://www.rfspace.com/RFSPACE/SDR-IQ.html SDR-IQ], [http://www.rfspace.com/RFSPACE/SDR-IP.html SDR-IP], [http://rfspace.com/RFSPACE/NetSDR.html NetSDR] [http://www.rfspace.com/RFSPACE/NetSDR-X2.html (incl. X2 option)] |
21 | 1 | horiz0n | * RTL2832U based DVB-T dongles through [http://sdr.osmocom.org/trac/wiki/rtl-sdr librtlsdr] |
22 | * RTL-TCP spectrum server (see librtlsdr project) |
||
23 | * MSi2500 based DVB-T dongles through [http://cgit.osmocom.org/libmirisdr/ libmirisdr] |
||
24 | * gnuradio .cfile input through libgnuradio-blocks |
||
25 | |||
26 | == Software == |
||
27 | |||
28 | The sdrangelove code can be checked out with: |
||
29 | {{{ |
||
30 | 7 | horiz0n | git clone git://git.osmocom.org/sdrangelove.git |
31 | 1 | horiz0n | }}} |
32 | |||
33 | It can also be browsed on http://cgit.osmocom.org/cgit/sdrangelove/ |
||
34 | |||
35 | 7 | 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. |
36 | 1 | horiz0n | |
37 | === Mailing List === |
||
38 | |||
39 | 2 | horiz0n | We discuss sdrangelove on the following mailing list: osmocom-sdr at lists.osmocom.org. |
40 | 1 | horiz0n | |
41 | You can subscribe and/or unsubscribe via the following link: [http://lists.osmocom.org/mailman/listinfo/osmocom-sdr] |
||
42 | |||
43 | === Building the software === |
||
44 | |||
45 | ==== sdrangelove ==== |
||
46 | |||
47 | '''You have to install development packages for libusb1.0''' to build the software. |
||
48 | |||
49 | 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). |
||
50 | |||
51 | Building with cmake: |
||
52 | {{{ |
||
53 | cd sdrangelove/ |
||
54 | mkdir build |
||
55 | cd build |
||
56 | cmake ../ |
||
57 | make |
||
58 | }}} |
||
59 | |||
60 | 3 | horiz0n | Running it: |
61 | 1 | horiz0n | |
62 | {{{ |
||
63 | cd sdrangelove |
||
64 | cd build/ |
||
65 | ./sdrangelove |
||
66 | }}} |
||
67 | |||
68 | ==== Gnuradio Source ==== |
||
69 | |||
70 | '''The Gnu Radio source requires a recent gnuradio (>= v3.7) to be installed.''' |
||
71 | |||
72 | The source supports direct device operation as well as a tcp client mode when using the rtl_tcp utility as a spectrum server. |
||
73 | |||
74 | 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. |
||
75 | |||
76 | 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. |
||
77 | |||
78 | Building with cmake (as described in the [https://sdr.osmocom.org/trac/wiki/GrOsmoSDR gr-osmosdr wiki page]): |
||
79 | |||
80 | {{{ |
||
81 | git clone git://git.osmocom.org/gr-osmosdr |
||
82 | cd gr-osmosdr/ |
||
83 | 7 | horiz0n | }}} |
84 | |||
85 | You can build a standalone (no gnuradio required) version for gr-osmosdr by doing |
||
86 | |||
87 | {{{ |
||
88 | git checkout standalone |
||
89 | 1 | horiz0n | }}} |
90 | |||
91 | then continue with |
||
92 | |||
93 | {{{ |
||
94 | mkdir build |
||
95 | cd build/ |
||
96 | cmake ../ |
||
97 | }}} |
||
98 | |||
99 | 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. |
||
100 | {{{ |
||
101 | -- ###################################################### |
||
102 | -- # gr-osmosdr enabled components |
||
103 | -- ###################################################### |
||
104 | -- * Python support |
||
105 | -- * Osmocom IQ Imbalance Correction |
||
106 | -- * sysmocom OsmoSDR |
||
107 | 4 | horiz0n | -- * FUNcube Dongle |
108 | -- * FUNcube Dongle Pro+ |
||
109 | 1 | horiz0n | -- * IQ File Source |
110 | -- * Osmocom RTLSDR |
||
111 | -- * RTLSDR TCP Client |
||
112 | -- * Ettus USRP Devices |
||
113 | -- * Osmocom MiriSDR |
||
114 | -- * HackRF Jawbreaker |
||
115 | 4 | horiz0n | -- * nuand bladeRF |
116 | 13 | horiz0n | -- * RFSPACE Receivers |
117 | 1 | horiz0n | -- |
118 | -- ###################################################### |
||
119 | -- # gr-osmosdr disabled components |
||
120 | -- ###################################################### |
||
121 | -- |
||
122 | -- Building for version: 4c101ea4 / 0.0.1git |
||
123 | -- Using install prefix: /usr/local |
||
124 | }}} |
||
125 | |||
126 | Now build & install |
||
127 | {{{ |
||
128 | make |
||
129 | sudo make install |
||
130 | sudo ldconfig |
||
131 | }}} |
||
132 | |||
133 | ==== Automated installation ==== |
||
134 | |||
135 | Marcus D. Leech has kindly integrated the forementioned build steps into his gnuradio installation script at [http://www.sbrac.org/files/build-gnuradio]. This is the most user-friendly option so far. |
||
136 | |||
137 | 12 | Hoernchen | You also may try the PyBOMBS developed by gnuradio.org folks. |
138 | 1 | horiz0n | |
139 | == Plugins == |
||
140 | |||
141 | The following 3rd party plugins are available: |
||
142 | |||
143 | ||'''Name'''||'''Author'''||'''URL'''|| |
||
144 | ||pocsag||who's first?||...|| |
||
145 | ||ads-b||who's first?||...|| |
||
146 | ||apco p25||who's first?||...|| |
||
147 | ||tetra||who's first?||...|| |
||
148 | |||
149 | [[br]] |
||
150 | Not using sdrangelove? Tell us why! :) |
||
151 | [[br]][[br]][[br]] |
||
152 | |||
153 | == Credits == |
||
154 | |||
155 | 2 | horiz0n | sdrangelove is developed by Christian Daniel of [http://maintech.de maintech GmbH] with contributions from Hoernchen and Dimitri Stolnikov. |