Project

General

Profile

Sdrangelove » History » Version 13

horiz0n, 02/19/2016 10:51 PM

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