GrOsmoSDR » History » Version 24

« Previous - Version 24/96 (diff) - Next » - Current version
horiz0n, 02/19/2016 10:50 PM


= OSMOCOM Gnuradio Source =

While primarily being developed for the OsmoSDR hardware, this block as well supports:

By using the OsmoSDR block you can take advantage of a common software api in your application(s) independent of the underlying radio hardware.

Build process

'''The gnuradio source requires a recent gnuradio (>= v3.6.4.1) to be installed.'''

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.

Please note: prior pulling a new version from git and compiling it, please do a "make uninstall" first to properly remove the previous version.

Building with cmake: {{{
git clone git://
cd gr-osmosdr/
mkdir build
cd build/
cmake ../
sudo make install
sudo ldconfig

NOTE: The OSMOCOM source block will appear under 'Sources' category in GRC menu.

To build the API documentation: {{{
cd build/
cmake ../ -DENABLE_DOXYGEN=1
make -C docs

Automated installation

Marcus D. Leech has kindly integrated the forementioned build steps into his gnuradio installation script at []. This is the most user-friendly option so far.

Device specification
You can specify the source or sink device using a comma separated string of argument=value pairs.

The always-up-to-date block documentation is available [ right here].

=== FCD Source ===
Argument Notes
=== OsmoSDR Source ===
buffers=<number-of-buffers> Default is 32

=== RTL-SDR Source === ||rtl=<device-index>|| || ||rtl_xtal=<frequency>|| Frequency in Hz of the crystal oscillator used for the RTL chip|| ||tuner_xtal=<frequency>|| Frequency in Hz of the crystal oscillator used for the tuner chip|| ||buffers=<number-of-buffers>|| Default is 32||
NOTE: if you don't specify rtl_xtal/tuner_xtal, the underlying driver will use 28.0MHz

=== RTL-SDR TCP Source ===
rtl_tcp=<hostname>:<port> hostname defaults to "localhost", port to "1234"
psize=<payload-size> Default is 16384 bytes
=== UHD Source / Sink ===
uhd Use this argument without a value
subdev=<subdev-spec> See below

Additional argument/value pairs will be passed to the underlying driver, for more information see and

=== HackRF Source / Sink ===
hackrf Use this argument without a value. Only the first device found may be used ATM because of libhackrf limitation.
buffers=<number-of-buffers> Default is 32
=== IQ File Source ===
freq=<frequency> in Hz
rate=<sampling-rate> in samples/s
repeat=true false Default is true
throttle=true false Throttle flow of samples, default is true
Known Apps

The following 3rd party applications are successfully using gr-osmosdr:

'''Name''' '''Type''' '''Author''' '''URL'''
gr-pocsag GRC Flowgraph Marcus Leech []
multimode RX GRC Flowgraph Marcus Leech []
simple_fm_rvc GRC Flowgraph Marcus Leech []
Wireless Temp. Sensor RX Gnuradio App Kevin Mehall []
tetra_demod_fft SDR GUI osmocom team [] and the [ HOWTO]
gqrx SDR GUI Alexandru Csete []
tetra_demod_fft Trunking RX osmocom team [] and the [ HOWTO]
airprobe GSM sniffer osmocom team et al []
gr-smartnet (WIP) Trunking RX Nick Foster [br[">]br[ Notes from the author]
gr-air-modes ADS-B RX Nick Foster [] call with --rtlsdr option
gr-ais (fork) AIS RX Nick FosterbrAntoine SirinellibrChristian Gagneraud []
GNSS-SDR GPS RX (Realtime!) Centre Tecnològic debrTelecomunicacions de Catalunya [ Documentation] and []
gr-scan Scanner techmeology []
pocsag-mrt Multichannel RealtimebrDecoder iZsh []
osmo-gmr-rtl GMR1 RX Dimitri Stolnikov []
simple_ra '''(NEW)''' Radio Astronomy App Marcus Leech []
FS20_decode '''(NEW)''' FS20 Decoder Thomas Frisch []
OpenLTE '''(NEW)''' LTE Toolkit Ben Wojtowicz []
Add picture from clipboard (Maximum size: 48.8 MB)