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