SDR (Software Defined Radio)

h1. Project sdrangelove

{{>toc}}

TODO

{{thumbnail(gsm.jpg, size=600)}}

{{thumbnail(lte.jpg, size=600)}}

h2. Supported Hardware

While primarily being developed for the [[OsmoSDR]] hardware, sdrangelove as well supports:

* "FunCube Dongle":http://tetra.osmocom.org/trac/wiki/Funcube_Dongle through libgnuradio-fcd

* "FUNcube Dongle Pro+":http://www.funcubedongle.com/?page_id=1073 through "gr-fcdproplus":https://github.com/dl1ksv/gr-fcdproplus

* "sysmocom [[OsmoSDR]]":http://sdr.osmocom.org/trac/ Devices through "libosmosdr":http://cgit.osmocom.org/osmo-sdr/

* "Nuand LLC bladeRF":http://nuand.com/ through "libbladeRF library":https://github.com/Nuand/bladeRF

* "Great Scott Gadgets [[HackRF]]":http://greatscottgadgets.com/hackrf/ through "libhackrf":https://github.com/mossmann/hackrf

* "Ettus USRP":http://www.ettus.com/product Devices through "Ettus UHD library":http://files.ettus.com/uhd_docs/manual/html/build.html

* "Fairwaves [[UmTRX]]":http://umtrx.org through "Fairwaves' fork of Ettus' UHD library":https://github.com/fairwaves/UHD-Fairwaves

* RFSPACE "SDR-IQ":http://www.rfspace.com/RFSPACE/SDR-IQ.html, "SDR-IP":http://www.rfspace.com/RFSPACE/SDR-IP.html, "NetSDR":http://rfspace.com/RFSPACE/NetSDR.html "(incl. X2 option)":http://www.rfspace.com/RFSPACE/NetSDR-X2.html

* RTL2832U based DVB-T dongles through "librtlsdr":http://sdr.osmocom.org/trac/wiki/rtl-sdr

* RTL-TCP spectrum server (see librtlsdr project)

* MSi2500 based DVB-T dongles through "libmirisdr":http://cgit.osmocom.org/libmirisdr/

* gnuradio .cfile input through libgnuradio-blocks

h2. Software

The sdrangelove code can be checked out with:

<pre>

git clone https://gitea.osmocom.org/sdr/sdrangelove.git

</pre>

It can also be browsed on https://gitea.osmocom.org/sdr/sdrangelove

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.

Alternatively, you can also contribute by creating a fork + pull request on https://gitea.sysmocom.de/

h3. Mailing List

We discuss sdrangelove on the following mailing list: osmocom-sdr at lists.osmocom.org.

You can subscribe and/or unsubscribe via the following link: "h3. Building the software

h4. prerequisites

Download and install Qt5 from http://qt-project.org/downloads

Build and install gr-osmosdr master (gnuradio required) or standalone branch (gnuradio not required), see below for build instructions...

Pulseaudio is requirement.

h4. sdrangelove

*You have to install development packages for libusb1.0* to build the software.

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).

Building with cmake:

<pre>

cd sdrangelove/

mkdir build

cd build

cmake ../ -DCMAKE_PREFIX_PATH=/path/to/Qt/5.2.0/gcc_64/lib/cmake/

make

</pre>

Running it:

<pre>

cd sdrangelove

cd build/

./sdrangelove

</pre>

h4. Gnuradio Source

*The Gnu Radio source requires a recent gnuradio (>= v3.7) to be installed.*

The source supports direct device operation as well as a tcp client mode when using the rtl_tcp utility as a spectrum server.

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.

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.

Building with cmake (as described in the [https://sdr.osmocom.org/trac/wiki/GrOsmoSDR gr-osmosdr wiki page":http://lists.osmocom.org/mailman/listinfo/osmocom-sdr]):

<pre>

git clone git://git.osmocom.org/gr-osmosdr

cd gr-osmosdr/

</pre>

You can build a standalone (no gnuradio required) version for gr-osmosdr by doing

<pre>

git checkout standalone

</pre>

then continue with

<pre>

mkdir build

cd build/

cmake ../

</pre>

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.

<pre>

-- ######################################################

-- # gr-osmosdr enabled components                         

-- ######################################################

--   * Python support

--   * Osmocom IQ Imbalance Correction

--   * sysmocom [[OsmoSDR]]

--   * FUNcube Dongle

--   * FUNcube Dongle Pro+

--   * IQ File Source

--   * Osmocom RTLSDR

--   * RTLSDR TCP Client

--   * Ettus USRP Devices

--   * Osmocom [[MiriSDR]]

--   * [[HackRF]] Jawbreaker

--   * nuand bladeRF

--   * RFSPACE Receivers

-- 

-- ######################################################

-- # gr-osmosdr disabled components                        

-- ######################################################

-- 

-- Building for version: 4c101ea4 / 0.0.1git

-- Using install prefix: /usr/local

</pre>

Now build & install

<pre>

make

sudo make install

sudo ldconfig

</pre>

h4. 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.

You also may try the [[PyBOMBS]] developed by gnuradio.org folks.

h2. Plugins

The following 3rd party plugins are available:

||*Name*||*Author*||*URL*||

||pocsag||who's first?||...||

||ads-b||who's first?||...||

||apco p25||who's first?||...||

||tetra||who's first?||...||

[[br":http://www.sbrac.org/files/build-gnuradio].]

Not using sdrangelove? Tell us why! :)

[[br]][[br]][[br]]

h2. Credits

sdrangelove is developed by Christian Daniel of "maintech GmbH":http://maintech.de with contributions from Hoernchen and Dimitri Stolnikov.