SDR (Software Defined Radio)

[[PageOutline]]

= Project sdrangelove =

TODO

[[Image(gsm.jpg, 600px)]]

[[Image(lte.jpg, 600px)]]

== Supported Hardware ==

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

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

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

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

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

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

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

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

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

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

 * RTL-TCP spectrum server (see librtlsdr project)

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

 * gnuradio .cfile input through libgnuradio-blocks

== Software ==

The sdrangelove code can be checked out with:

{{{

git clone git://git.osmocom.org/sdrangelove.git

}}}

It can also be browsed on http://cgit.osmocom.org/cgit/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.

=== 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: [http://lists.osmocom.org/mailman/listinfo/osmocom-sdr]

=== Building the software ===

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

==== 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:

{{{

cd sdrangelove/

mkdir build

cd build

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

make

}}}

Running it:

{{{

cd sdrangelove

cd build/

./sdrangelove

}}}

==== 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]):

{{{

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

cd gr-osmosdr/

}}}

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

{{{

git checkout standalone

}}}

then continue with

{{{

mkdir build

cd build/

cmake ../

}}}

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.

{{{

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

-- # 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

}}}

Now build & install

{{{

make

sudo make install

sudo ldconfig

}}}

==== Automated installation ====

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.

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

== 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]]

Not using sdrangelove? Tell us why! :)

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

== Credits ==

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