Project

General

Profile

GrOsmoSDR » History » Version 23

horiz0n, 02/19/2016 10:50 PM

1 1 horiz0n
[[PageOutline]]
2
3 20 horiz0n
= OSMOCOM Gnuradio Source =
4 1 horiz0n
5 20 horiz0n
While primarily being developed for the OsmoSDR hardware, this block as well supports:
6 1 horiz0n
7 20 horiz0n
 * [http://tetra.osmocom.org/trac/wiki/Funcube_Dongle FunCube Dongle] through libgnuradio-fcd
8
 * [http://sdr.osmocom.org/trac/ OSMOCOM OsmoSDR] Devices through [http://cgit.osmocom.org/osmo-sdr/ libosmosdr]
9
 * [http://greatscottgadgets.com/hackrf/ Great Scott Gadgets HackRF] through [https://github.com/mossmann/hackrf libhackrf]
10 22 horiz0n
 * [https://www.ettus.com/product Ettus USRP] Devices through [http://files.ettus.com/uhd_docs/manual/html/build.html Ettus UHD library]
11 20 horiz0n
 * RTL2832U based DVB-T dongles through [http://sdr.osmocom.org/trac/wiki/rtl-sdr librtlsdr]
12
 * RTL-TCP spectrum server (see librtlsdr project)
13
 * MSi2500 based DVB-T dongles through [http://cgit.osmocom.org/libmirisdr/ libmirisdr]
14
 * gnuradio .cfile input through libgnuradio-core
15
16
By using the OsmoSDR block you can take advantage of a common software api in your application(s) independent of the underlying radio hardware.
17
18 1 horiz0n
== Build process ==
19
20
'''The gnuradio source requires a recent gnuradio (>= v3.6.4.1) to be installed.'''
21 20 horiz0n
22
Before building the source you have to make sure that all the dependencies (see list of supported devices above) you are intend to work with are properly installed. The build system of gr-osmosdr will recognize them and enable specific source/sink components thereafter.
23 1 horiz0n
24
Please note: prior pulling a new version from git and compiling it, please do a "make uninstall" first to properly remove the previous version.
25
26
Building with cmake:
27
{{{
28
git clone git://git.osmocom.org/gr-osmosdr
29
cd gr-osmosdr/
30
mkdir build
31
cd build/
32 14 horiz0n
cmake ../
33 1 horiz0n
make
34
sudo make install
35
sudo ldconfig
36
}}}
37
38 17 horiz0n
NOTE: The OSMOCOM source block will appear under 'Sources' category in GRC menu.
39 1 horiz0n
40 10 horiz0n
To build the API documentation:
41
{{{
42
cd build/
43 14 horiz0n
cmake ../ -DENABLE_DOXYGEN=1
44 10 horiz0n
make -C docs
45
}}}
46
47 1 horiz0n
== Automated installation ==
48
49
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.
50 7 horiz0n
51 11 horiz0n
== Device specification ==
52
You can specify the source or sink device using a comma separated string of argument=value pairs.
53
54 19 horiz0n
The always-up-to-date block documentation is available [http://cgit.osmocom.org/gr-osmosdr/tree/grc/gen_osmosdr_blocks.py#n100 right here].
55
56 18 horiz0n
=== IQ File Source ===
57 11 horiz0n
||file=<path-to-file-name>||||
58
||freq=<frequency>|| in Hz||
59
||rate=<sampling-rate>|| in samples/s||
60
||repeat=true|false|| Default is false||
61
||throttle=true|false||Throttle flow of samples, default is false||
62 1 horiz0n
63 18 horiz0n
=== FCD Source ===
64
||Argument||Notes||
65
||fcd=<device-index>|| ||
66
67
=== OsmoSDR Source ===
68 11 horiz0n
||osmosdr=<device-index>|| ||
69
||buffers=<number-of-buffers>|| Default is 32||
70
71 18 horiz0n
=== RTL-SDR Source ===
72 11 horiz0n
||rtl=<device-index>|| ||
73
||rtl_xtal=<frequency>|| Frequency in Hz of the crystal oscillator used for the RTL chip||
74 1 horiz0n
||tuner_xtal=<frequency>|| Frequency in Hz of the crystal oscillator used for the tuner chip||
75 11 horiz0n
||buffers=<number-of-buffers>|| Default is 32||
76 13 horiz0n
NOTE: if you don't specify rtl_xtal/tuner_xtal, the underlying driver will use 28.0MHz
77 11 horiz0n
78 18 horiz0n
=== RTL-SDR TCP Source ===
79 11 horiz0n
||rtl_tcp=<hostname>:<port>|| hostname defaults to "localhost", port to "1234"||
80
||psize=<payload-size>|| Default is 16384 bytes||
81 1 horiz0n
82 11 horiz0n
=== UHD Source / Sink ===
83 23 horiz0n
||uhd|| Use this argument without a value ||
84 11 horiz0n
||nchan=<channel-index>|| ||
85
||subdev=<subdev-spec>|| See below||
86
87
Additional argument/value pairs will be passed to the underlying driver, for more information see
88
http://files.ettus.com/uhd_docs/manual/html/general.html#specifying-the-subdevice-to-use and 
89 1 horiz0n
http://files.ettus.com/uhd_docs/manual/html/identification.html#common-device-identifiers
90 11 horiz0n
91 18 horiz0n
=== HackRF Source / Sink ===
92 23 horiz0n
||hackrf|| Use this argument without a value. Only the first device found may be used ATM because of libhackrf limitation. ||
93 18 horiz0n
||buffers=<number-of-buffers>|| Default is 32||
94 11 horiz0n
95 7 horiz0n
== Known Apps ==
96
97
The following 3rd party applications are successfully using gr-osmosdr:
98
99
||'''Name'''||'''Type'''||'''Author'''||'''URL'''||
100
||gr-pocsag||GRC Flowgraph||Marcus Leech||[https://www.cgran.org/browser/projects/gr-pocsag/trunk]||
101
||multimode RX||GRC Flowgraph||Marcus Leech||[https://www.cgran.org/browser/projects/multimode/trunk]||
102
||simple_fm_rvc||GRC Flowgraph||Marcus Leech||[https://www.cgran.org/browser/projects/simple_fm_rcv/trunk]||
103
||Wireless Temp. Sensor RX||Gnuradio App||Kevin Mehall||[https://github.com/kevinmehall/rtlsdr-433m-sensor]||
104 1 horiz0n
||tetra_demod_fft||SDR GUI||osmocom team||[http://cgit.osmocom.org/cgit/osmo-tetra/tree/src/demod/python/osmosdr-tetra_demod_fft.py osmosdr-tetra_demod_fft.py] and the [http://tetra.osmocom.org/trac/wiki/osmo-tetra#Quickexample HOWTO] ||
105 15 horiz0n
||gqrx||SDR GUI||Alexandru Csete||[https://github.com/csete/gqrx]||
106 8 horiz0n
||tetra_demod_fft||Trunking RX||osmocom team||[http://cgit.osmocom.org/cgit/osmo-tetra/tree/src/demod/python/osmosdr-tetra_demod_fft.py osmosdr-tetra_demod_fft.py] and the [http://tetra.osmocom.org/trac/wiki/osmo-tetra#Quickexample HOWTO] ||
107 16 horiz0n
||airprobe||GSM sniffer||osmocom team et al||[http://git.gnumonks.org/cgi-bin/gitweb.cgi?p=airprobe.git]||
108
||gr-smartnet (WIP)||Trunking RX||Nick Foster||[http://www.reddit.com/r/RTLSDR/comments/us3yo/rtlsdr_smartnet/][[br]][http://www.reddit.com/r/RTLSDR/comments/vbxl0/attention_grsmartnet_users_or_attempted_users/ Notes from the author]||
109
||gr-air-modes||ADS-B RX||Nick Foster||[https://www.cgran.org/wiki/gr-air-modes] call with --rtlsdr option||
110 15 horiz0n
||gr-ais (fork)||AIS RX||Nick Foster[[br]]Antoine Sirinelli[[br]]Christian Gagneraud||[https://github.com/chgans/gr-ais]||
111
||GNSS-SDR ||GPS RX (Realtime!)||Centre Tecnològic de[[br]]Telecomunicacions de Catalunya||[http://www.gnss-sdr.org/documentation/gnss-sdr-operation-realtek-rtl2832u-usb-dongle-dvb-t-receiver Documentation] and [http://www.gnss-sdr.org]||
112
||gr-scan ||Scanner||techmeology||[http://www.techmeology.co.uk/gr-scan/]||
113
||pocsag-mrt||Multichannel Realtime[[br]]Decoder||iZsh||[https://github.com/iZsh/pocsag-mrt]||
114
||osmo-gmr-rtl||GMR1 RX||Dimitri Stolnikov||[http://gmr.osmocom.org/trac/wiki/GettingStarted#RTLSDRdongles]||
115
||simple_ra '''(NEW)'''||Radio Astronomy App||Marcus Leech||[https://cgran.org/wiki/simple_ra]||
116
||FS20_decode '''(NEW)'''||FS20 Decoder||Thomas Frisch||[https://github.com/eT0M/rtl_sdr_FS20_decoder]||
117
||OpenLTE '''(NEW)'''||LTE Toolkit||Ben Wojtowicz||[http://sourceforge.net/p/openlte/home/Home/]||
Add picture from clipboard (Maximum size: 48.8 MB)