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