Software to turn the RTL2832U into an SDR
 
 
 
 
 
Go to file
Thomas Petazzoni 7396271f26 cmake/Modules/Version.cmake: don't use Git version if not in a Git repo
If the librtlsdr code comes from a tarball, it doesn't have any .git/
metadata, and therefore even if Git (as a tool) is found, the logic in
cmake/Modules/Version.cmake fails finding a version through Git:

-- Extracting version information from git describe...
fatal: Not a git repository (or any of the parent directories): .git

As a consequence, the VERSION variable is empty, which later causes
cmake to bail out with:

CMake Error at /home/test/autobuild/run/instance-1/output-1/host/share/cmake-3.15/Modules/WriteBasicConfigVersionFile.cmake:43 (message):
  No VERSION specified for WRITE_BASIC_CONFIG_VERSION_FILE()
Call Stack (most recent call first):
  /home/test/autobuild/run/instance-1/output-1/host/share/cmake-3.15/Modules/CMakePackageConfigHelpers.cmake:225 (write_basic_config_version_file)
  CMakeLists.txt:173 (write_basic_package_version_file)

To avoid this, we only use Git to determine the version if the cmake
project top-level source directory has a .git/ folder.

Signed-off-by: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
(cherry picked from commit feb5d9c6b7bcec788f9b01781c205e31fff260e7)
2020-08-19 22:29:34 -07:00
cmake cmake/Modules/Version.cmake: don't use Git version if not in a Git repo 2020-08-19 22:29:34 -07:00
contrib add contrib/jenkins.sh for build testing 2018-04-18 23:59:17 +02:00
debian debian: update version to match librtlsdr 2018-10-03 20:34:27 +00:00
include rtl_biast: Add rtl_biast 2020-08-19 18:29:47 -07:00
m4 add autotools based build system 2012-03-27 20:53:49 +02:00
src rtl_biast: Add rtl_biast 2020-08-19 18:29:47 -07:00
win32-qtcreator extracted wavewrite from convenience, improved rtl_fm 2019-07-18 23:25:32 +00:00
.gitignore Moved include rtl_tcp.h from rtl-sdr.h to rtl_tcp.c (where it should be) 2016-11-27 22:22:25 -02:00
.travis.yml add configuration file for Travis CI 2014-02-05 18:07:15 +01:00
AUTHORS update authors 2012-12-16 16:25:40 +01:00
CMakeLists.txt cmake option WITH_RPC - defaulting to OFF 2019-07-20 04:12:28 +02:00
COPYING add autotools based build system 2012-03-27 20:53:49 +02:00
Doxyfile.in add autotools based build system 2012-03-27 20:53:49 +02:00
Makefile.am Fix "make uninstall" for documentation 2018-06-03 13:24:42 +02:00
README.md fixes issue #39 2020-08-01 16:57:47 +00:00
README.rtlfm_cmdfile updated README.rtlfm_cmdfile: added keywords adcmax and adcrms 2016-11-27 22:22:25 -02:00
README.rtlsdr_rpc added support for rtlsdr_rpc_set_and_get_tuner_bandwidth in rtl_rpc 2020-04-05 19:35:23 +00:00
README_improvements.md added README_improvements.md 2020-08-19 22:15:41 -07:00
configure.ac configure.ac: Add --enable-sanitize and --enable-werror 2018-04-18 23:59:17 +02:00
git-version-gen add autotools based build system 2012-03-27 20:53:49 +02:00
install-blacklist.sh added helper script and smalle note in README for blacklisting 2020-03-01 18:48:37 +00:00
librtlsdr.pc.in install pkg-config file when building with cmake 2012-05-12 12:34:21 +02:00
protocol_rtl_tcp.txt replaced all 'R820T' by 'R820T/2' 2020-08-18 12:27:55 -07:00
rtl-sdr.rules added USB vendor/device ID for use with and without dvb drivers 2018-11-06 19:36:17 +00:00
rtlsdr-blacklist.conf added helper script and smalle note in README for blacklisting 2020-03-01 18:48:37 +00:00

README.md

librtlsdr version Build Status GPLv2 License

Description

rtl-sdr turns your Realtek RTL2832 based DVB dongle into a SDR receiver

For more information see:

https://osmocom.org/projects/rtl-sdr/wiki/Rtl-sdr

Setup for SDR only use - without DVB compatibility:

  • a special USB vendor/product id got reserved at http://pid.codes/ : 0x1209/0x2832
  • for such devices the linux kernel's DVB modules are not loaded automatically, thus can be used without blacklisting dvb_usb_rtl28xxu below /etc/modprobe.d/
  • this allows to use a second RTL dongle for use with DVB in parallel
  • the IDs can be programmed with 'rtl_eeprom -n' or 'rtl_eeprom -g realtek_sdr'
  • for permanent blacklisting you might check/call following from the clone git directory
    • ./install-blacklist.sh

Contributing

Pull requests are always welcome but please make changes to, and pull request from, the development branch.

Initial setup:

  • fork the main librtlsdr repo via github
  • clone your fork locally and cd to the cloned repo's folder
  • add the upstream development repo:
    • git remote add upstream git@github.com:librtlsdr/librtlsdr.git
  • track the development branch:
    • git branch --track development origin/development

Normal workflow:

  • checkout the development branch and make your changes
  • commit your changes
  • sync your local development branch with the upstream development branch:
    • git fetch upstream
    • git merge upstream/development
  • push your commit/s to your forked repo
  • do a pull request via github