GrOsmoSDR » History » Revision 18

« Previous | Revision 18/98 (diff) | Next »
horiz0n, 02/19/2016 10:50 PM


= OsmoSDR Gnuradio Source =

Primarily gr-osmosdr supports the OsmoSDR hardware, but it also offers a wrapper functionality for [ FunCube Dongle], [ Ettus UHD] and [ rtl-sdr] radios. By using gr-osmosdr source 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.'''

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. === IQ File Source ===
freq=<frequency> in Hz
rate=<sampling-rate> in samples/s
repeat=true false Default is false
throttle=true false Throttle flow of samples, default is false
=== FCD Source ===
Argument Notes
=== OsmoSDR Source ===
mcr=<rate> Master clock rate. FIXME: Setting the MCR is not supported
nchan=<channel-number> FIXME: Values of nchan != 1 are not supported
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 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 Only the first device found may be used ATM because of libhackrf limitation.
buffers=<number-of-buffers> Default is 32
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 []
Files (7)
hackrf-siggen.png View hackrf-siggen.png 79.1 KB signal generator app horiz0n, 05/26/2013 11:15 AM
hackrf-dab.jpg View hackrf-dab.jpg 127 KB HackRF transmitting DAB signal generated by crc-mmbTools horiz0n, 05/26/2013 11:18 AM
fft-lte.png View fft-lte.png 55.8 KB osmocom_fft showing LTE signal captured with HackRF Jawbreaker horiz0n, 06/15/2013 08:00 AM
siggen-gsm.png View siggen-gsm.png 26.9 KB osmocom_siggen producing a GSM waveform horiz0n, 06/15/2013 08:01 AM
fosphor.png View fosphor.png 433 KB LTE carrier horiz0n, 10/26/2013 10:09 AM
fosphor2.png View fosphor2.png 480 KB GSM900 band horiz0n, 10/26/2013 10:10 AM
gsm-hackrf-8M.png View gsm-hackrf-8M.png 9.69 KB osmocom_siggen running the GSM waveform on a HackRF horiz0n, 12/30/2013 03:42 PM

Updated by horiz0n over 8 years ago · 18 revisions

Add picture from clipboard (Maximum size: 48.8 MB)