librtlsdr/README.md

2.0 KiB

librtlsdr version Build Status GPLv2 License

Description

Fork of librtlsdr for Open VHF/UHF IP link using Pi and RTL-SDR.

Turns your Realtek RTL2832 based DVB dongle into a FSK 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