Sdrangelove » History » Revision 14
Revision 13 (horiz0n, 02/19/2016 10:51 PM) → Revision 14/19 (horiz0n, 02/19/2016 10:51 PM)
[[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.
