Sdrangelove » History » Revision 15
Revision 14 (horiz0n, 02/19/2016 10:51 PM) → Revision 15/21 (horiz0n, 02/19/2016 10:51 PM)
{{>toc}} h1. [[PageOutline]] = Project sdrangelove = TODO {{thumbnail(gsm.jpg, size=600)}} [[Image(gsm.jpg, 600px)]] {{thumbnail(lte.jpg, size=600)}} h2. [[Image(lte.jpg, 600px)]] == Supported Hardware == While primarily being developed for the [[OsmoSDR]] OsmoSDR hardware, sdrangelove as well supports: * "FunCube Dongle":http://tetra.osmocom.org/trac/wiki/Funcube_Dongle [http://tetra.osmocom.org/trac/wiki/Funcube_Dongle FunCube Dongle] through libgnuradio-fcd * "FUNcube [http://www.funcubedongle.com/?page_id=1073 FUNcube Dongle Pro+":http://www.funcubedongle.com/?page_id=1073 Pro+] through "gr-fcdproplus":https://github.com/dl1ksv/gr-fcdproplus [https://github.com/dl1ksv/gr-fcdproplus gr-fcdproplus] * "sysmocom [[OsmoSDR]]":http://sdr.osmocom.org/trac/ [http://sdr.osmocom.org/trac/ sysmocom OsmoSDR] Devices through "libosmosdr":http://cgit.osmocom.org/osmo-sdr/ [http://cgit.osmocom.org/osmo-sdr/ libosmosdr] * "Nuand [http://nuand.com/ Nuand LLC bladeRF":http://nuand.com/ bladeRF] through "libbladeRF library":https://github.com/Nuand/bladeRF [https://github.com/Nuand/bladeRF libbladeRF library] * "Great [http://greatscottgadgets.com/hackrf/ Great Scott Gadgets [[HackRF]]":http://greatscottgadgets.com/hackrf/ HackRF] through "libhackrf":https://github.com/mossmann/hackrf [https://github.com/mossmann/hackrf libhackrf] * "Ettus USRP":http://www.ettus.com/product [http://www.ettus.com/product Ettus USRP] Devices through "Ettus [http://files.ettus.com/uhd_docs/manual/html/build.html Ettus UHD library":http://files.ettus.com/uhd_docs/manual/html/build.html library] * "Fairwaves [[UmTRX]]":http://umtrx.org [http://umtrx.org Fairwaves UmTRX] through "Fairwaves' [https://github.com/fairwaves/UHD-Fairwaves Fairwaves' fork of Ettus' UHD library":https://github.com/fairwaves/UHD-Fairwaves library] * 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. [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)":http://www.rfspace.com/RFSPACE/NetSDR-X2.html option)] * RTL2832U based DVB-T dongles through "librtlsdr":http://sdr.osmocom.org/trac/wiki/rtl-sdr [http://sdr.osmocom.org/trac/wiki/rtl-sdr librtlsdr] * RTL-TCP spectrum server (see librtlsdr project) * MSi2500 based DVB-T dongles through "libmirisdr":http://cgit.osmocom.org/libmirisdr/ [http://cgit.osmocom.org/libmirisdr/ libmirisdr] * gnuradio .cfile input through libgnuradio-blocks h2. == Software == The sdrangelove code can be checked out with: <pre> {{{ git clone git://git.osmocom.org/sdrangelove.git </pre> }}} 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* '''contribute back''' and submit your patches to: osmocom-sdr at lists.osmocom.org. The amount (and quality) of contribution from the commmunity *will '''will have a direct impact* impact''' on the availability of new features. 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. [http://lists.osmocom.org/mailman/listinfo/osmocom-sdr] === 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 ==== '''You have to install development packages for libusb1.0* libusb1.0''' to build the software. Sdrangelove comes with built-in support for [[OsmoSDR]] 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 ==== '''The Gnu Radio source requires a recent gnuradio (>= v3.7) to be installed.* 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 '''install the latest version of the dependencies* 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]): page]): <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]] OsmoSDR -- * FUNcube Dongle -- * FUNcube Dongle Pro+ -- * IQ File Source -- * Osmocom RTLSDR -- * RTLSDR TCP Client -- * Ettus USRP Devices -- * Osmocom [[MiriSDR]] MiriSDR -- * [[HackRF]] 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 [http://www.sbrac.org/files/build-gnuradio]. This is the most user-friendly option so far. You also may try the [[PyBOMBS]] PyBOMBS developed by gnuradio.org folks. h2. == Plugins == The following 3rd party plugins are available: ||*Name*||*Author*||*URL*|| ||'''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].] [[br]] Not using sdrangelove? Tell us why! :) [[br]][[br]][[br]] h2. == Credits == sdrangelove is developed by Christian Daniel of "maintech GmbH":http://maintech.de [http://maintech.de maintech GmbH] with contributions from Hoernchen and Dimitri Stolnikov.