GrOsmoSDR » History » Revision 18

Revision 17 (horiz0n, 02/19/2016 10:50 PM) → Revision 18/98 (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 Local file === 
 ||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 === 
 ||fcd=<device-index>|| || 

 === OsmoSDR Source (source) === 
 ||osmosdr=<device-index>|| || 
 ||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 OsmoSDR (sink) === 
 FIXME: OsmoSDR sink is not yet implemented. 

 === rtl-sdr === 
 ||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 rtl-sdr TCP Source server === 
 ||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 || 
 ||nchan=<channel-index>|| || 
 ||subdev=<subdev-spec>|| See below|| 

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

 === HackRF Source / Sink FCD === 
 ||hackrf|| Only the first device found may be used ATM because of libhackrf limitation.|| ||Argument||Notes|| 
 ||buffers=<number-of-buffers>|| Default is 32|| ||fcd=<device-index>|| || 

 == Known Apps == 

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

 ||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]][ Notes from the author]|| 
 ||gr-air-modes||ADS-B RX||Nick Foster||[] call with --rtlsdr option|| 
 ||gr-ais (fork)||AIS RX||Nick Foster[[br]]Antoine Sirinelli[[br]]Christian Gagneraud||[]|| 
 ||GNSS-SDR ||GPS RX (Realtime!)||Centre Tecnològic de[[br]]Telecomunicacions de Catalunya||[ Documentation] and []|| 
 ||gr-scan ||Scanner||techmeology||[]|| 
 ||pocsag-mrt||Multichannel Realtime[[br]]Decoder||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)