Sdrangelove » History » Version 12
Hoernchen, 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 | 1 | horiz0n | * RTL2832U based DVB-T dongles through [http://sdr.osmocom.org/trac/wiki/rtl-sdr librtlsdr] |
21 | * RTL-TCP spectrum server (see librtlsdr project) |
||
22 | * MSi2500 based DVB-T dongles through [http://cgit.osmocom.org/libmirisdr/ libmirisdr] |
||
23 | * gnuradio .cfile input through libgnuradio-blocks |
||
24 | |||
25 | == Software == |
||
26 | |||
27 | The sdrangelove code can be checked out with: |
||
28 | {{{ |
||
29 | 7 | horiz0n | git clone git://git.osmocom.org/sdrangelove.git |
30 | 1 | horiz0n | }}} |
31 | |||
32 | It can also be browsed on http://cgit.osmocom.org/cgit/sdrangelove/ |
||
33 | |||
34 | 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. |
35 | 1 | horiz0n | |
36 | === Mailing List === |
||
37 | |||
38 | 2 | horiz0n | We discuss sdrangelove on the following mailing list: osmocom-sdr at lists.osmocom.org. |
39 | 1 | horiz0n | |
40 | You can subscribe and/or unsubscribe via the following link: [http://lists.osmocom.org/mailman/listinfo/osmocom-sdr] |
||
41 | |||
42 | === Building the software === |
||
43 | |||
44 | ==== sdrangelove ==== |
||
45 | |||
46 | '''You have to install development packages for libusb1.0''' to build the software. |
||
47 | |||
48 | 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). |
||
49 | |||
50 | Building with cmake: |
||
51 | {{{ |
||
52 | cd sdrangelove/ |
||
53 | mkdir build |
||
54 | cd build |
||
55 | cmake ../ |
||
56 | make |
||
57 | }}} |
||
58 | |||
59 | 3 | horiz0n | Running it: |
60 | 1 | horiz0n | |
61 | {{{ |
||
62 | cd sdrangelove |
||
63 | cd build/ |
||
64 | ./sdrangelove |
||
65 | }}} |
||
66 | |||
67 | ==== Gnuradio Source ==== |
||
68 | |||
69 | '''The Gnu Radio source requires a recent gnuradio (>= v3.7) to be installed.''' |
||
70 | |||
71 | The source supports direct device operation as well as a tcp client mode when using the rtl_tcp utility as a spectrum server. |
||
72 | |||
73 | 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. |
||
74 | |||
75 | 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. |
||
76 | |||
77 | Building with cmake (as described in the [https://sdr.osmocom.org/trac/wiki/GrOsmoSDR gr-osmosdr wiki page]): |
||
78 | |||
79 | {{{ |
||
80 | git clone git://git.osmocom.org/gr-osmosdr |
||
81 | cd gr-osmosdr/ |
||
82 | 7 | horiz0n | }}} |
83 | |||
84 | You can build a standalone (no gnuradio required) version for gr-osmosdr by doing |
||
85 | |||
86 | {{{ |
||
87 | git checkout standalone |
||
88 | 1 | horiz0n | }}} |
89 | |||
90 | then continue with |
||
91 | |||
92 | {{{ |
||
93 | mkdir build |
||
94 | cd build/ |
||
95 | cmake ../ |
||
96 | }}} |
||
97 | |||
98 | 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. |
||
99 | {{{ |
||
100 | -- ###################################################### |
||
101 | -- # gr-osmosdr enabled components |
||
102 | -- ###################################################### |
||
103 | -- * Python support |
||
104 | -- * Osmocom IQ Imbalance Correction |
||
105 | -- * sysmocom OsmoSDR |
||
106 | 4 | horiz0n | -- * FUNcube Dongle |
107 | -- * FUNcube Dongle Pro+ |
||
108 | 1 | horiz0n | -- * IQ File Source |
109 | -- * Osmocom RTLSDR |
||
110 | -- * RTLSDR TCP Client |
||
111 | -- * Ettus USRP Devices |
||
112 | -- * Osmocom MiriSDR |
||
113 | -- * HackRF Jawbreaker |
||
114 | 4 | horiz0n | -- * nuand bladeRF |
115 | 1 | horiz0n | -- |
116 | -- ###################################################### |
||
117 | -- # gr-osmosdr disabled components |
||
118 | -- ###################################################### |
||
119 | -- |
||
120 | -- Building for version: 4c101ea4 / 0.0.1git |
||
121 | -- Using install prefix: /usr/local |
||
122 | }}} |
||
123 | |||
124 | Now build & install |
||
125 | {{{ |
||
126 | make |
||
127 | sudo make install |
||
128 | sudo ldconfig |
||
129 | }}} |
||
130 | |||
131 | ==== Automated installation ==== |
||
132 | |||
133 | 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. |
||
134 | |||
135 | 12 | Hoernchen | You also may try the PyBOMBS developed by gnuradio.org folks. |
136 | 1 | horiz0n | |
137 | == Plugins == |
||
138 | |||
139 | The following 3rd party plugins are available: |
||
140 | |||
141 | ||'''Name'''||'''Author'''||'''URL'''|| |
||
142 | ||pocsag||who's first?||...|| |
||
143 | ||ads-b||who's first?||...|| |
||
144 | ||apco p25||who's first?||...|| |
||
145 | ||tetra||who's first?||...|| |
||
146 | |||
147 | [[br]] |
||
148 | Not using sdrangelove? Tell us why! :) |
||
149 | [[br]][[br]][[br]] |
||
150 | |||
151 | == Credits == |
||
152 | |||
153 | 2 | horiz0n | sdrangelove is developed by Christian Daniel of [http://maintech.de maintech GmbH] with contributions from Hoernchen and Dimitri Stolnikov. |