Sdrangelove » History » Revision 19
Revision 18 (Hoernchen, 04/08/2020 01:11 PM) → Revision 19/21 (laforge, 02/18/2022 06:07 PM)
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 git://git.osmocom.org/sdrangelove.git </pre> It can also be browsed on https://gitea.osmocom.org/sdr/sdrangelove http://cgit.osmocom.org/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.