Add Debian packaging information

This allows (among others) to build rtl-sdr nightly packages for a variety of distributions as part of the network:osmocom:nightly builds
2024-11-10 04:37:37 +01:00 · 2018-06-03 15:19:53 +02:00 · 2018-06-03 15:19:53 +02:00 · 8a26abaf79
commit 8a26abaf79
parent 9573e68d10
29 changed files with 1507 additions and 0 deletions
--- a/debian/README.Debian
+++ b/debian/README.Debian
@ -0,0 +1,55 @@
+rtl-sdr for Debian
+-------------------
+
+In the beginning Antti Palosaari noticed that some digital video
+receiver tuners can be turned into a cheap software defined radio.
+
+Since there is also support in the Linux kernel to use these devices
+as digital video receivers, by default the hardware will be claimed
+by Linux keernel drivers for that purpose.
+
+Having these rtl-sdr packages installed likely means that these
+devices should be available for the alternate software defined
+radio use.
+
+The librtlsdr0 package in Debian has configuration files to
+help manage the conflicting uses:
+
+1. Blacklists DVB-T kernel modules provided by the Linux kernel
+-------------------------------------------------------------------
+
+Config file:
+/etc/modprobe.d/librtlsdr-blacklist.conf
+
+contains lines to blacklist dvb_usb_rtl28xxu, e4000 and rtl2832
+kernel modules.
+
+Should you wish to use a device via the Linux video receiver software
+while still having the librtlsdr0 package installed you may edit
+this file. (Placing a # at the beginning os a line makes it a comment.)
+
+Then unplug/plug the USB stick.
+
+Not that if rtl-sdr applications are then run, they will complain about
+failing to open the device. In that case, restore the blacklist and
+unplug/plug the USB stick.
+
+If librtlsdr-blacklist.conf does not exist, then rtl-sdr was built
+with the DETACH_KERNEL_DRIVER option.
+
+2. Permissions
+--------------
+
+Devices are available to users in the plugdev group.
+
+The librtlsdr0 package installs these default rules:
+/lib/udev/rules.d/60-librtlsdr0.rules
+
+If you have permissions issues, you may override these values
+with your own rules in /etc:
+
+/etc/udev/rules.d/60-librtlsdr0.rules
+
+After editing udev rules, run as root: 
+ udevadm control --reload-rules
+
--- a/debian/changelog
+++ b/debian/changelog
@ -0,0 +1,159 @@
+rtl-sdr (0.6git) unstable; urgency=medium
+
+  * New upstream release
+
+ -- Harald Welte <laforge@gnumonks.org>  Sun, 06 Jun 2018 15:09:42 +0200
+
+rtl-sdr (0.5.4-1) unstable; urgency=medium
+
+  * New upstream release
+  * update to v0.5.4-3-ga854ae8
+    use USB zero-copy transfers if possible
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Sat, 12 May 2018 16:49:43 -0400
+
+rtl-sdr (0.5.3-14) unstable; urgency=medium
+
+  * update to v0.5.3-20-g4520f00 (Closes: #892974)
+  * minimal ipv6 support (Closes: #870804)
+  * VCS to salsa
+  * AppStream metadata.xml
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Mon, 16 Apr 2018 20:45:53 -0400
+
+rtl-sdr (0.5.3-13) unstable; urgency=medium
+
+  * build with libusb-1.0-0-dev stub on hurd-i386
+  * initial ipv6 support for rtl_tcp...
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Thu, 23 Nov 2017 15:59:40 -0500
+
+rtl-sdr (0.5.3-12) unstable; urgency=medium
+
+  * add new HanfTek dongle
+  * Bias T support (Closes: #854378, #842249)
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Wed, 23 Aug 2017 23:31:27 -0400
+
+rtl-sdr (0.5.3-11) unstable; urgency=medium
+
+  * correct invocation of rm_conffile (Thanks Chris!) (Closes: #838161)
+  * drop uploaders line on advice of MIA team. (Closes: #836590)
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Sat, 08 Oct 2016 11:17:47 -0400
+
+rtl-sdr (0.5.3-10) unstable; urgency=medium
+
+  * remove rtl-sdr-blacklist.conf on upgrade. Thanks Bob! (Closes: #829517)
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Sat, 09 Jul 2016 23:38:24 -0400
+
+rtl-sdr (0.5.3-9) unstable; urgency=medium
+
+  * Edit of debian/librtlsdr0.udev in 0.5.3-8 was a no-op. Real fix
+    done to debian/patches/use-udev-uaccess-rules. (Closes: #825073)
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Wed, 25 May 2016 17:19:57 -0400
+
+rtl-sdr (0.5.3-8) unstable; urgency=high
+
+  * Fix syntax errors for systemd-udevd in udev rules (Closes: #825073)
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Tue, 24 May 2016 21:08:50 -0400
+
+rtl-sdr (0.5.3-7) unstable; urgency=medium
+
+  * better udev rules (more like camera devices in libgphoto2-6)
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Tue, 10 May 2016 19:20:27 -0400
+
+rtl-sdr (0.5.3-6) unstable; urgency=medium
+
+  * Use ENV{ID_SOFTWARE_RADIO}=1 in udev rules (Closes: #823089)
+  * Enable DETACH_KERNEL_DRIVER (Closes: 823022)
+  * Make myself maintainer so I get the bug reports
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Sun, 08 May 2016 12:12:13 -0400
+
+rtl-sdr (0.5.3-5) unstable; urgency=medium
+
+  * Add watch fiule
+  * place rtl-sdr -n comm section (Closes: #758077)
+  * improve-librtlsdr-pc-file (Closes: #784912)
+  * improve-scanning-range-parsing (LP: #1469478)
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Sun, 23 Aug 2015 10:35:42 -0400
+
+rtl-sdr (0.5.3-4) unstable; urgency=low
+
+  * Update to v0.5.3-12-ge3c03f7
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Sat, 08 Aug 2015 23:43:54 -0400
+
+rtl-sdr (0.5.3-3) unstable; urgency=low
+
+  * Update to v0.5.3-5-g6ee5573
+    lib: handle events after canceling transfers
+    lib: change default number of transfers to 15
+    rtl_tcp: make all global variables static
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Sun, 13 Apr 2014 10:48:49 -0400
+
+rtl-sdr (0.5.3-2) unstable; urgency=low
+
+  * Upstream: lib: only print to stderr in tuner_r82xx_set_pll()
+  * Update man pages (New -M (modulation) and -E (option) and ppm setting)
+  * Have librtlsdr0 also install a blacklist for linux video drivers
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Sat, 08 Feb 2014 22:40:06 -0500
+
+rtl-sdr (0.5.3-1) unstable; urgency=low
+
+  * New upstream git tag release
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Thu, 06 Feb 2014 20:45:38 -0500
+
+rtl-sdr (0.5.2.7.3ab6-1~bpo70+1) wheezy-backports; urgency=low
+
+  * Rebuild for wheezy-backports.
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Tue, 21 Jan 2014 19:34:16 -0500
+
+rtl-sdr (0.5.2.7.3ab6-1) unstable; urgency=low
+
+  * New upstream snapshot
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Sun, 29 Dec 2013 21:37:19 -0500
+
+rtl-sdr (0.5.1.14.360d-1~wheezy) stable; urgency=low
+
+  * New upstream snapshot
+  * GNU Radio LiveDVD 2013-1110
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Mon, 11 Nov 2013 12:46:00 -0500
+
+rtl-sdr (0.5.0.4.4914-2) unstable; urgency=low
+
+  * Use kfreebsd libusb
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Fri, 01 Nov 2013 17:16:42 -0400
+
+rtl-sdr (0.5.0.4.4914-1) stable; urgency=low
+
+  * New upstream snapshot (Closes: #701018).
+  * Match GNU Radio live distribution version
+  * Sponsored upload
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Sat, 28 Sep 2013 16:55:08 -0400
+
+rtl-sdr (0.5.0+git20130715-1) unstable; urgency=low
+
+  * Initial release (Closes: #701018).
+
+ -- Adam Cécile (Le_Vert) <gandalf@le-vert.net>  Mon, 15 Jul 2013 15:51:05 +0200
+
+librtlsdr (0.0git3198f14-1) unstable; urgency=low
+
+  * New upstream git
+
+ -- A. Maitland Bottoms <bottoms@debian.org>  Mon, 14 May 2012 20:28:18 -0400
--- a/debian/compat
+++ b/debian/compat
@ -0,0 +1 @@
+9
--- a/debian/control
+++ b/debian/control
@ -0,0 +1,54 @@
+Source: rtl-sdr
+Section: comm
+Priority: optional
+Maintainer: A. Maitland Bottoms <bottoms@debian.org>
+Build-Depends: cmake,
+               debhelper (>= 9.0.0~),
+               libusb-1.0-0-dev [linux-any],
+               libusb-dev [hurd-i386],
+               libusb2-dev [kfreebsd-any]
+Standards-Version: 4.1.4
+Homepage: http://sdr.osmocom.org/trac/wiki/rtl-sdr
+Vcs-Browser: https://salsa.debian.org/bottoms/pkg-rtl-sdr
+Vcs-Git: https://salsa.debian.org/bottoms/pkg-rtl-sdr.git
+
+Package: librtlsdr-dev
+Section: libdevel
+Architecture: any
+Pre-Depends: ${misc:Pre-Depends}
+Depends: librtlsdr0 (= ${binary:Version}),
+         libusb-1.0-0-dev [!kfreebsd-any],
+         libusb2-dev [kfreebsd-any],
+         ${misc:Depends}
+Description: Software defined radio receiver for Realtek RTL2832U (development)
+ rtl-sdr is a software defined radio (SDR) receiver software for certain
+ low-cost DVB-T/DAB(+) USB dongles based on the Realtek RTL2832U chip.
+ .
+ This package contains development files.
+
+Package: librtlsdr0
+Section: libs
+Architecture: any
+Pre-Depends: ${misc:Pre-Depends}
+Depends: ${misc:Depends}, ${shlibs:Depends}
+Multi-Arch: same
+Description: Software defined radio receiver for Realtek RTL2832U (library)
+ rtl-sdr is a software defined radio (SDR) receiver software for certain
+ low-cost DVB-T/DAB(+) USB dongles based on the Realtek RTL2832U chip.
+ .
+ This package contains the shared library.
+
+Package: rtl-sdr
+Architecture: any
+Depends: librtlsdr0 (= ${binary:Version}), ${misc:Depends}, ${shlibs:Depends}
+Description: Software defined radio receiver for Realtek RTL2832U (tools)
+ rtl-sdr is a software defined radio (SDR) receiver software for certain
+ low-cost DVB-T/DAB(+) USB dongles based on the Realtek RTL2832U chip.
+ .
+ This package contains a set of command line utilities:
+  * rtl_adsb: a simple ADS-B decoder for RTL2832 based DVB-T receivers
+  * rtl_eeprom: an EEPROM programming tool for RTL2832 based DVB-T receivers
+  * rtl_fm: a narrow band FM demodulator for RTL2832 based DVB-T receivers
+  * rtl_sdr: an I/Q recorder for RTL2832 based DVB-T receivers
+  * rtl_tcp: an I/Q spectrum server for RTL2832 based DVB-T receivers
+  * rtl_test: a benchmark tool for RTL2832 based DVB-T receivers
--- a/debian/copyright
+++ b/debian/copyright
@ -0,0 +1,230 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: rtl-sdr
+Upstream-Contact: http://sdr.osmocom.org/trac/wiki/rtl-sdr
+Source:
+ git clone git://git.osmocom.org/rtl-sdr.git
+ The upstream package source tarball was generated from the tag:
+ git archive --format=tar --prefix=rtl-sdr-0.5.2.7.3ab6/ 3ab6ff | gzip > ../rtl-sdr_0.5.2.7.3ab6.orig.tar.gz
+Comment:
+ Debian packages sponsored by A. Maitland Bottoms,
+ based upon packaging work by Adam Cécile.
+ .
+ Upstream Authors:
+ Steve Markgraf <steve@steve-m.de>
+ Dimitri Stolnikov <horiz0n@gmx.net>
+ Hoernchen <la@tfc-server.de>
+ Kyle Keen <keenerd@gmail.com>
+Copyright: 2012,2013 OSMOCOM Project
+License: GPL-2.0+
+
+Files: *
+Copyright: 2012, 2013, OSMOCOM Project
+License: GPL-3+
+
+Files: debian/*
+Copyright: 2013 Adam Cécile (Le_Vert) <gandalf@le-vert.net>
+           2012,2013 A. Maitland Bottoms <bottoms@debian.org>
+License: GPL-2.0+
+
+Files: debian/librtlsdr0.udev
+Copyright: 2012, 2013, Osmocom rtl-sdr project
+License: GPL-3+
+
+Files: debian/rtl_adsb.1
+Copyright: Copyright (c) 2013, A. Maitland Bottoms <bottoms@debian.org>
+License: GPL-2.0+
+
+Files: debian/rtl_eeprom.1
+  debian/rtl_test.1
+Copyright: Copyright (c) 2013, A. Maitland Bottoms <bottoms@debian.org>
+License: GPL-2+
+
+Files: git-version-gen
+Copyright: 2007-2010, Free Software Foundation, Inc.
+License: GPL-3+
+
+Files: include/*
+Copyright: 2012, Steve Markgraf <steve@steve-m.de>
+  2012, Hans-Frieder Vogt <hfvogt@gmx.net>
+License: GPL-2+
+
+Files: include/CMakeLists.txt
+Copyright: 2012, 2013, OSMOCOM Project
+License: GPL-3+
+
+Files: include/rtl-sdr.h
+Copyright: 2012, Dimitri Stolnikov <horiz0n@gmx.net>
+  2012, 2013, Steve Markgraf <steve@steve-m.de>
+License: GPL-2+
+
+Files: include/rtl-sdr_export.h
+Copyright: 2012, Hoernchen <la@tfc-server.de>
+License: GPL-2+
+
+Files: include/tuner_e4k.h
+Copyright: 2012, Sylvain Munaut <tnt@246tNt.com>
+  2012, Hoernchen <la@tfc-server.de>
+  2011, 2012, Harald Welte <laforge@gnumonks.org>
+License: GPL-2+
+
+Files: include/tuner_fc2580.h
+Copyright: Steve Markgraf <steve@steve-m.de>
+License: GPL-2.0+
+
+Files: include/tuner_r82xx.h
+Copyright: 2013, Steve Markgraf <steve@steve-m.de>
+  2013, Mauro Carvalho Chehab <mchehab@redhat.com>
+License: GPL-2+
+
+Files: rtl-sdr.rules
+Copyright: 2012, 2013, Osmocom rtl-sdr project
+License: GPL-3+
+
+Files: src/*
+Copyright: 2012, Steve Markgraf <steve@steve-m.de>
+License: GPL-2+
+
+Files: src/CMakeLists.txt
+Copyright: 2012, 2013, OSMOCOM Project
+License: GPL-3+
+
+Files: src/Makefile.am
+Copyright: 2012 Steve Markgraf <steve@steve-m.de>
+           2012 Dimitri Stolnikov <horiz0n@gmx.net>
+License: GPL-2.0+
+
+Files: src/convenience/*
+Copyright: 2014, Kyle Keen <keenerd@gmail.com>
+License: GPL-2+
+
+Files: src/getopt/*
+Copyright: 88-96, 98, 99, 1987, 2000, 2001
+License: LGPL-2.1+
+
+Files: src/getopt/getopt.h
+Copyright: 1989-1994, 1996-1999, 2001, Free Software Foundation, Inc.
+License: LGPL-2.1+
+
+Files: src/librtlsdr.c
+Copyright: 2012-2014, Steve Markgraf <steve@steve-m.de>
+  2012, Dimitri Stolnikov <horiz0n@gmx.net>
+License: GPL-2+
+
+Files: src/rtl_adsb.c
+Copyright: 2012, Youssef Touil <youssef@sdrsharp.com>
+  2012, Steve Markgraf <steve@steve-m.de>
+  2012, Kyle Keen <keenerd@gmail.com>
+  2012, Ian Gilmour <ian@sdrsharp.com>
+  2012, Hoernchen <la@tfc-server.de>
+License: GPL-2+
+
+Files: src/rtl_fm.c
+Copyright: 2013, Elias Oenal <EliasOenal@gmail.com>
+  2012, Steve Markgraf <steve@steve-m.de>
+  2012, Kyle Keen <keenerd@gmail.com>
+  2012, Hoernchen <la@tfc-server.de>
+License: GPL-2+
+
+Files: src/rtl_power.c
+Copyright: 2012, Steve Markgraf <steve@steve-m.de>
+  2012, Kyle Keen <keenerd@gmail.com>
+  2012, Hoernchen <la@tfc-server.de>
+License: GPL-2+
+
+Files: src/rtl_tcp.c
+Copyright: 2012, Steve Markgraf <steve@steve-m.de>
+  2012, 2013, Hoernchen <la@tfc-server.de>
+License: GPL-2+
+
+Files: src/rtl_test.c
+Copyright: 2014, Michael Tatarinov <kukabu@gmail.com>
+  2012-2014, Steve Markgraf <steve@steve-m.de>
+  2012-2014, Kyle Keen <keenerd@gmail.com>
+License: GPL-2+
+
+Files: src/tuner_e4k.c
+Copyright: 2012, Sylvain Munaut <tnt@246tNt.com>
+  2012, Hoernchen <la@tfc-server.de>
+  2011, 2012, Harald Welte <laforge@gnumonks.org>
+License: GPL-2+
+
+Files: src/tuner_fc0012.c
+Copyright: 2012, Steve Markgraf <steve@steve-m.de>
+  2012, Hans-Frieder Vogt <hfvogt@gmx.net>
+License: GPL-2+
+
+Files: src/tuner_fc0013.c
+Copyright: 2012, Steve Markgraf <steve@steve-m.de>
+  2012, Hans-Frieder Vogt <hfvogt@gmx.net>
+  2010, Fitipower Integrated Technology Inc
+License: GPL-2+
+
+Files: src/tuner_fc2580.c
+Copyright: Steve Markgraf <steve@steve-m.de>
+    Dimitri Stolnikov <horiz0n@gmx.net>
+License: GPL-2.0+
+
+Files: src/tuner_r82xx.c
+Copyright: 2013, Steve Markgraf <steve@steve-m.de>
+  2013, Mauro Carvalho Chehab <mchehab@redhat.com>
+License: GPL-2+
+
+License: GPL-2+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; version 2 dated June, 1991, or (at
+ your option) any later version.
+ .
+ On Debian systems, the complete text of version 2 of the GNU General
+ Public License can be found in '/usr/share/common-licenses/GPL-2'.
+
+License: GPL-2.0+
+ This package is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+ .
+ This package is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>
+ .
+ On Debian systems, the complete text of the GNU General
+ Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
+
+License: GPL-3+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+ .
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ .
+ On Debian systems, the complete text of the GNU Lesser General
+ Public License can be found in "/usr/share/common-licenses/GPL-3".
+
+License: LGPL-2.1+
+ This package is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+ .
+ This package is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ Lesser General Public License for more details.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>.
+ .
+ On Debian systems, the complete text of the GNU Lesser General
+ Public License can be found in "/usr/share/common-licenses/LGPL-2".
--- a/debian/copyright-scan-patterns.yml
+++ b/debian/copyright-scan-patterns.yml
@ -0,0 +1,3 @@
+ignore :
+  suffixes :
+   - in
--- a/debian/heatmap.py
+++ b/debian/heatmap.py
@ -0,0 +1,134 @@
+#! /usr/bin/env python2
+
+from PIL import Image, ImageDraw, ImageFont
+import sys, gzip, math, colorsys, datetime
+from collections import defaultdict
+from itertools import *
+
+# todo: matplotlib powered --interactive
+# arbitrary freq marker spacing
+
+path = sys.argv[1]
+output = sys.argv[2]
+
+raw_data = lambda: open(path)
+if path.endswith('.gz'):
+    raw_data = lambda: gzip.open(path, 'rb')
+
+def frange(start, stop, step):
+    i = 0
+    while (i*step + start <= stop):
+        yield i*step + start
+        i += 1
+
+print("loading")
+
+freqs = set()
+f_cache = set()
+times = set()
+labels = set()
+min_z = 0
+max_z = -100
+start, stop = None, None
+for line in raw_data():
+    line = [s.strip() for s in line.strip().split(',')]
+    line = [line[0], line[1]] + [float(s) for s in line[2:] if s]
+
+    low = line[2]
+    high = line[3]
+    step = line[4]
+    f_key = (int(low), int(high), step)
+    if f_key not in f_cache:
+        freqs.update(list(frange(int(low), int(high), step)))
+        freqs.add(high)
+        labels.add(low)
+        f_cache.add(f_key)
+
+    t = line[0] + ' ' + line[1]
+    times.add(t)
+
+    zs = line[6:]
+    min_z = min(min_z, min(z for z in zs if not math.isinf(z)))
+    max_z = max(max_z, max(zs))
+
+    if start is None:
+        start = datetime.datetime.strptime(line[0] + ' ' + line[1], '%Y-%m-%d %H:%M:%S')
+    stop = datetime.datetime.strptime(line[0] + ' ' + line[1], '%Y-%m-%d %H:%M:%S')
+
+freqs = list(sorted(list(freqs)))
+times = list(sorted(list(times)))
+labels = list(sorted(list(labels)))
+
+if len(labels) == 1:
+    delta = (max(freqs) - min(freqs)) / (len(freqs) / 500)
+    delta = round(delta / 10**int(math.log10(delta))) * 10**int(math.log10(delta))
+    delta = int(delta)
+    lower = int(math.ceil(min(freqs) / delta) * delta)
+    labels = list(range(lower, int(max(freqs)), delta))
+
+print("x: %i, y: %i, z: (%f, %f)" % (len(freqs), len(times), min_z, max_z))
+
+def rgb2(z):
+    g = (z - min_z) / (max_z - min_z)
+    return (int(g*255), int(g*255), 50)
+
+def rgb3(z):
+    g = (z - min_z) / (max_z - min_z)
+    c = colorsys.hsv_to_rgb(0.65-(g-0.08), 1, 0.2+g)
+    return (int(c[0]*256),int(c[1]*256),int(c[2]*256))
+
+print("drawing")
+img = Image.new("RGB", (len(freqs), len(times)))
+pix = img.load()
+x_size = img.size[0]
+for line in raw_data():
+    line = [s.strip() for s in line.strip().split(',')]
+    line = [line[0], line[1]] + [float(s) for s in line[2:] if s]
+    t = line[0] + ' ' + line[1]
+    if t not in times:
+        continue  # happens with live files
+    y = times.index(t)
+    low = line[2]
+    high = line[3]
+    step = line[4]
+    x_start = freqs.index(low)
+    for i in range(len(line[6:])):
+        x = x_start + i
+        if x >= x_size:
+            continue
+        z = line[6+i]
+        # fast check for nan/-inf
+        if not z >= min_z:
+            z = min_z
+        pix[x,y] = rgb2(z)
+
+print("labeling")
+draw = ImageDraw.Draw(img)
+font = ImageFont.load_default()
+pixel_width = step
+for label in labels:
+    y = 10
+    #x = freqs.index(label)
+    x = int((label-min(freqs)) / pixel_width)
+    s = '%.3fMHz' % (label/1000000.0)
+    draw.text((x, y), s, font=font, fill='white')
+
+duration = stop - start
+duration = duration.seconds
+pixel_height = duration / len(times)
+hours = int(duration / 3600)
+minutes = int((duration - 3600*hours) / 60)
+draw.text((2, img.size[1] - 45), 'Duration: %i:%02i' % (hours, minutes), font=font, fill='white')
+draw.text((2, img.size[1] - 35), 'Range: %.2fMHz - %.2fMHz' % (min(freqs)/1e6, max(freqs)/1e6), font=font, fill='white')
+draw.text((2, img.size[1] - 25), 'Pixel: %.2fHz x %is' % (pixel_width, int(round(pixel_height))), font=font, fill='white')
+draw.text((2, img.size[1] - 15), 'Started: {0}'.format(start), font=font, fill='white')
+# bin size
+
+print("saving")
+img.save(output)
+
+
+
+
+
+
--- a/debian/librtlsdr-dev.dirs
+++ b/debian/librtlsdr-dev.dirs
@ -0,0 +1,2 @@
+usr/lib
+usr/include
--- a/debian/librtlsdr-dev.install
+++ b/debian/librtlsdr-dev.install
@ -0,0 +1,4 @@
+usr/include/*
+usr/lib/*/lib*.a
+usr/lib/*/lib*.so
+usr/lib/*/pkgconfig/*
--- a/debian/librtlsdr0.dirs
+++ b/debian/librtlsdr0.dirs
@ -0,0 +1,2 @@
+etc/modprobe.d
+usr/lib
--- a/debian/librtlsdr0.install
+++ b/debian/librtlsdr0.install
@ -0,0 +1,2 @@
+usr/lib/*/lib*.so.*
+debian/librtlsdr0.metainfo.xml usr/share/metainfo
--- a/debian/librtlsdr0.maintscript
+++ b/debian/librtlsdr0.maintscript
@ -0,0 +1 @@
+rm_conffile /etc/modprobe.d/rtl-sdr-blacklist.conf 0.5.3-10~
--- a/debian/librtlsdr0.metainfo.xml
+++ b/debian/librtlsdr0.metainfo.xml
@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<component>
+  <id>librtlsdr0</id>
+  <metadata_license>GPL-2+</metadata_license>
+  <name>librtlsdr0</name>
+  <summary>Control of rtl-sdr radio receiver</summary>
+  <description>
+    <p>
+rtl-sdr is a software defined radio (SDR) receiver software for certain
+low-cost DVB-T/DAB(+) USB dongles based on the Realtek RTL2832U chip.
+    </p>
+  </description>
+  <provides>
+    <modalias>usb:v0BDAp2832d*</modalias>
+    <modalias>usb:v0BDAp2838d*</modalias>
+    <modalias>usb:v0413p6680d*</modalias>
+    <modalias>usb:v0413p6F0Fd*</modalias>
+    <modalias>usb:v0458p707Fd*</modalias>
+    <modalias>usb:v0CCDp00A9d*</modalias>
+    <modalias>usb:v0CCDp00B3d*</modalias>
+    <modalias>usb:v0CCDp00B4d*</modalias>
+    <modalias>usb:v0CCDp00B5d*</modalias>
+    <modalias>usb:v0CCDp00B7d*</modalias>
+    <modalias>usb:v0CCDp00B8d*</modalias>
+    <modalias>usb:v0CCDp00B9d*</modalias>
+    <modalias>usb:v0CCDp00C0d*</modalias>
+    <modalias>usb:v0CCDp00C6d*</modalias>
+    <modalias>usb:v0CCDp00D3d*</modalias>
+    <modalias>usb:v0CCDp00D7d*</modalias>
+    <modalias>usb:v0CCDp00E0d*</modalias>
+    <modalias>usb:v1554p5020d*</modalias>
+    <modalias>usb:v15F4p0131d*</modalias>
+    <modalias>usb:v15F4p0133d*</modalias>
+    <modalias>usb:v185Bp0620d*</modalias>
+    <modalias>usb:v185Bp0650d*</modalias>
+    <modalias>usb:v185Bp0680d*</modalias>
+    <modalias>usb:v1B80pD393d*</modalias>
+    <modalias>usb:v1B80pD394d*</modalias>
+    <modalias>usb:v1B80pD395d*</modalias>
+    <modalias>usb:v1B80pD397d*</modalias>
+    <modalias>usb:v1B80pD398d*</modalias>
+    <modalias>usb:v1B80pD39Dd*</modalias>
+    <modalias>usb:v1B80pD3A4d*</modalias>
+    <modalias>usb:v1B80pD3A8d*</modalias>
+    <modalias>usb:v1B80pD3AFd*</modalias>
+    <modalias>usb:v1B80pD3B0d*</modalias>
+    <modalias>usb:v1D19p1101d*</modalias>
+    <modalias>usb:v1D19p1102d*</modalias>
+    <modalias>usb:v1D19p1103d*</modalias>
+    <modalias>usb:v1D19p1104d*</modalias>
+    <modalias>usb:v1F4DpA803d*</modalias>
+    <modalias>usb:v1F4DpB803d*</modalias>
+    <modalias>usb:v1F4DpC803d*</modalias>
+    <modalias>usb:v1F4DpD286d*</modalias>
+    <modalias>usb:v1F4DpD803d*</modalias>
+  </provides>
+</component>
--- a/debian/librtlsdr0.udev
+++ b/debian/librtlsdr0.udev
@ -0,0 +1,142 @@
+#
+# Copyright 2012-2013 Osmocom rtl-sdr project
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+# original RTL2832U vid/pid (hama nano, for example)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="2832", MODE:="0666"
+
+# RTL2832U OEM vid/pid, e.g. ezcap EzTV668 (E4000), Newsky TV28T (E4000/R820T) etc.
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="2838", MODE:="0666"
+
+# DigitalNow Quad DVB-T PCI-E card (4x FC0012?)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0413", ATTRS{idProduct}=="6680", MODE:="0666"
+
+# Leadtek WinFast DTV Dongle mini D (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0413", ATTRS{idProduct}=="6f0f", MODE:="0666"
+
+# Genius TVGo DVB-T03 USB dongle (Ver. B)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0458", ATTRS{idProduct}=="707f", MODE:="0666"
+
+# Terratec Cinergy T Stick Black (rev 1) (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00a9", MODE:="0666"
+
+# Terratec NOXON rev 1 (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00b3", MODE:="0666"
+
+# Terratec Deutschlandradio DAB Stick (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00b4", MODE:="0666"
+
+# Terratec NOXON DAB Stick - Radio Energy (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00b5", MODE:="0666"
+
+# Terratec Media Broadcast DAB Stick (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00b7", MODE:="0666"
+
+# Terratec BR DAB Stick (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00b8", MODE:="0666"
+
+# Terratec WDR DAB Stick (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00b9", MODE:="0666"
+
+# Terratec MuellerVerlag DAB Stick (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00c0", MODE:="0666"
+
+# Terratec Fraunhofer DAB Stick (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00c6", MODE:="0666"
+
+# Terratec Cinergy T Stick RC (Rev.3) (E4000)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00d3", MODE:="0666"
+
+# Terratec T Stick PLUS (E4000)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00d7", MODE:="0666"
+
+# Terratec NOXON rev 2 (E4000)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="0ccd", ATTRS{idProduct}=="00e0", MODE:="0666"
+
+# PixelView PV-DT235U(RN) (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1554", ATTRS{idProduct}=="5020", MODE:="0666"
+
+# Astrometa DVB-T/DVB-T2 (R828D)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="15f4", ATTRS{idProduct}=="0131", MODE:="0666"
+
+# HanfTek DAB+FM+DVB-T
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="15f4", ATTRS{idProduct}=="0133", MODE:="0666"
+
+# Compro Videomate U620F (E4000)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="185b", ATTRS{idProduct}=="0620", MODE:="0666"
+
+# Compro Videomate U650F (E4000)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="185b", ATTRS{idProduct}=="0650", MODE:="0666"
+
+# Compro Videomate U680F (E4000)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="185b", ATTRS{idProduct}=="0680", MODE:="0666"
+
+# GIGABYTE GT-U7300 (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b80", ATTRS{idProduct}=="d393", MODE:="0666"
+
+# DIKOM USB-DVBT HD
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b80", ATTRS{idProduct}=="d394", MODE:="0666"
+
+# Peak 102569AGPK (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b80", ATTRS{idProduct}=="d395", MODE:="0666"
+
+# KWorld KW-UB450-T USB DVB-T Pico TV (TUA9001)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b80", ATTRS{idProduct}=="d397", MODE:="0666"
+
+# Zaapa ZT-MINDVBZP (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b80", ATTRS{idProduct}=="d398", MODE:="0666"
+
+# SVEON STV20 DVB-T USB & FM (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b80", ATTRS{idProduct}=="d39d", MODE:="0666"
+
+# Twintech UT-40 (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b80", ATTRS{idProduct}=="d3a4", MODE:="0666"
+
+# ASUS U3100MINI_PLUS_V2 (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b80", ATTRS{idProduct}=="d3a8", MODE:="0666"
+
+# SVEON STV27 DVB-T USB & FM (FC0013)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b80", ATTRS{idProduct}=="d3af", MODE:="0666"
+
+# SVEON STV21 DVB-T USB & FM
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b80", ATTRS{idProduct}=="d3b0", MODE:="0666"
+
+# Dexatek DK DVB-T Dongle (Logilink VG0002A) (FC2580)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1d19", ATTRS{idProduct}=="1101", MODE:="0666"
+
+# Dexatek DK DVB-T Dongle (MSI DigiVox mini II V3.0)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1d19", ATTRS{idProduct}=="1102", MODE:="0666"
+
+# Dexatek DK 5217 DVB-T Dongle (FC2580)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1d19", ATTRS{idProduct}=="1103", MODE:="0666"
+
+# MSI DigiVox Micro HD (FC2580)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1d19", ATTRS{idProduct}=="1104", MODE:="0666"
+
+# Sweex DVB-T USB (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1f4d", ATTRS{idProduct}=="a803", MODE:="0666"
+
+# GTek T803 (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1f4d", ATTRS{idProduct}=="b803", MODE:="0666"
+
+# Lifeview LV5TDeluxe (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1f4d", ATTRS{idProduct}=="c803", MODE:="0666"
+
+# MyGica TD312 (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1f4d", ATTRS{idProduct}=="d286", MODE:="0666"
+
+# PROlectrix DV107669 (FC0012)
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="1f4d", ATTRS{idProduct}=="d803", MODE:="0666"
--- a/debian/rtl-sdr-blacklist.conf
+++ b/debian/rtl-sdr-blacklist.conf
@ -0,0 +1,6 @@
+# This system has librtlsdr0 installed in order to
+# use digital video broadcast receivers as generic
+# software defined radios.
+blacklist dvb_usb_rtl28xxu
+blacklist e4000
+blacklist rtl2832
--- a/debian/rtl-sdr.dirs
+++ b/debian/rtl-sdr.dirs
@ -0,0 +1 @@
+usr/bin
--- a/debian/rtl-sdr.examples
+++ b/debian/rtl-sdr.examples
@ -0,0 +1 @@
+debian/heatmap.py
--- a/debian/rtl-sdr.install
+++ b/debian/rtl-sdr.install
@ -0,0 +1 @@
+usr/bin/*
--- a/debian/rtl-sdr.manpages
+++ b/debian/rtl-sdr.manpages
@ -0,0 +1,7 @@
+debian/rtl_adsb.1
+debian/rtl_eeprom.1
+debian/rtl_fm.1
+debian/rtl_power.1
+debian/rtl_sdr.1
+debian/rtl_tcp.1
+debian/rtl_test.1
--- a/debian/rtl_adsb.1
+++ b/debian/rtl_adsb.1
@ -0,0 +1,70 @@
+.TH "rtl_adsb" 1 "0.5.0" RTL-SDR "User Commands"
+.SH NAME
+rtl_adsb \- a simple ADS-B decoder
+.SH DESCRIPTION
+Uses a re-purposed DVB-T receiver as a software defined
+radio to receive and decode ADS-B data.	Written by Kyle Keen
+and incorporated in the osmocom rtl-sdr project.
+.LP
+Automatic dependent surveillance-broadcast, ADS-B, consists
+of position and other status data transmitted by aircraft
+in support of air traffic control in order to improve safety
+of flight.
+.LP
+Much software is available for the RTL2832. Most of the user-level
+packages rely on the librtlsdr library which comes as part of the
+rtl-sdr codebase. This codebase contains both the library itself and
+also a number of command line tools such as rtl_test, rtl_sdr,
+rtl_tcp, and rtl_fm. These command line tools use the library to test
+for the existence of RTL2832 devices and to perform basic data
+transfer functions to and from the device.
+.LP
+Because most of the RTL2832 devices are connected using USB, the
+librtlsdr library depends on the libusb library to communicate with
+the device.
+.SH USAGE
+With a suitable antenna for receiving the 1090 MHz signal attached
+to the rtl-sdr supported device, this program will output the
+data decoded from that signal.
+.SH SYNOPSIS
+.B  rtl_adsb [-R] [-g gain] [-p ppm] [output file]
+.SH OPTIONS
+.IP "-d device_index (default: 0)"
+.IP "-V verbove output (default: off)"
+.IP "-S show short frames (default: off)"
+.IP "-Q quality (0: no sanity checks, 0.5: half bit, 1: one bit (default), 2: two bits)"
+.IP "-e allowed_errors (default: 5)"
+.IP "-g tuner_gain (default: automatic)"
+.IP "-p ppm_error (default: 0)"
+.IP tfilename
+ (a '-' dumps samples to stdout)
+ (omitting the filename also uses stdout)
+.SH EXAMPLES
+.IP "Streaming with netcat:"
+  rtl_adsb | netcat -lp 8080
+
+  while true; do rtl_adsb | nc -lp 8080; done
+.IP "Streaming with socat:"
+  rtl_adsb | socat -u - TCP4:sdrsharp.com:47806
+.SH SEE ALSO
+RTL-SDR wiki documentation:
+.B http://sdr.osmocom.org/trac/wiki/rtl-sdr
+.LP
+Other rtl-sdr programs:
+.sp
+rtl_eeprom(1), rtl_fm(1), rtl_sdr(1), rtl_tcp(1), rtl_test(1)
+.SH AUTHOR
+This manual page was written by Maitland Bottoms
+for the Debian project (but may be used by others).
+.SH COPYRIGHT
+Copyright (c) 2013 A. Maitland Bottoms <bottoms@debian.org>
+.LP
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+.LP
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
--- a/debian/rtl_eeprom.1
+++ b/debian/rtl_eeprom.1
@ -0,0 +1,65 @@
+.TH "rtl_eeprom" 1 "0.5.0" RTL-SDR "User Commands"
+.SH NAME
+rtl-eeprom \- EEPROM programming tool for RTL2832 based DVB-T receivers
+.SH DESCRIPTION
+Dumps configuration and also writes EEPROM configuration.
+Written by Steve Markgraf and incorporated in the osmocom rtl-sdr project.
+.LP
+Use at your own risk, especially -w!
+.LP
+Much software is available for the RTL2832. Most of the user-level
+packages rely on the librtlsdr library which comes as part of the
+rtl-sdr codebase. This codebase contains both the library itself and
+also a number of command line tools such as rtl_test, rtl_sdr,
+rtl_tcp, and rtl_fm. These command line tools use the library to test
+for the existence of RTL2832 devices and to perform basic data
+transfer functions to and from the device.
+.LP
+Because most of the RTL2832 devices are connected using USB, the
+librtlsdr library depends on the libusb library to communicate with
+the device.
+.SH USAGE
+Writing bad information to the EEPROM will make your
+device useless. 
+.SH SYNOPSIS
+.B  rtl_eeprom [OPTIONS]
+.SH OPTIONS
+.IP "-d device_index (default: 0)"
+.IP "-m <str> set manufacturer string"
+.IP "-p <str> set product string"
+.IP "-s <str> set serial number string"
+.IP "-i <0,1> disable/enable IR-endpoint"
+.IP "-g <conf> generate default config and write to device"
+   <conf> can be one of:
+   realtek  Realtek default (as without EEPROM)
+   realtek_oem  Realtek default OEM with EEPROM
+   noxon  Terratec NOXON DAB Stick
+   terratec_black  Terratec T Stick Black
+   terratec_plus  Terratec T Stick+ (DVB-T/DAB)
+.IP "-w <filename> write dumped file to device"
+.IP "-r <filename> dump EEPROM to file"
+.IP "-h display this help text"
+.LP
+Use on your own risk, especially -w!
+.SH SEE ALSO
+RTL-SDR wiki documentation:
+.B http://sdr.osmocom.org/trac/wiki/rtl-sdr
+.LP
+Other rtl-sdr programs:
+.sp
+rtl_adsb(1), rtl_fm(1), rtl_sdr(1), rtl_tcp(1), rtl_test(1)
+.SH AUTHOR
+This manual page was written by Maitland Bottoms
+for the Debian project (but may be used by others).
+.SH COPYRIGHT
+Copyright (c) 2013 A. Maitland Bottoms <bottoms@debian.org>
+.LP
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+.LP
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
--- a/debian/rtl_fm.1
+++ b/debian/rtl_fm.1
@ -0,0 +1,103 @@
+.TH "rtl_adsb" 1 "0.5.0" RTL-SDR "User Commands"
+.SH NAME
+rtl_fm \- a simple FM demodulator for RTL2832 based DVB-T receivers
+.SH DESCRIPTION
+Uses a re-purposed DVB-T receiver as a software defined
+radio to receive narrow band FM signals and demodulate
+to audio. Written for and incorporated in the osmocom rtl-sdr project.
+.LP
+Narrowband FM is commonly used by public service agencies and
+commercial dispatch operations in the VHF and UHF bands.
+Also can demodulate Wideband FM, as found in the 88-108 MHz FM
+broadcast band.
+Experimental options include AM, LSB, USB and DSB demodulation.
+.LP
+Much software is available for the RTL2832. Most of the user-level
+packages rely on the librtlsdr library which comes as part of the
+rtl-sdr codebase. This codebase contains both the library itself and
+also a number of command line tools such as rtl_test, rtl_sdr,
+rtl_tcp, and rtl_fm. These command line tools use the library to test
+for the existence of RTL2832 devices and to perform basic data
+transfer functions to and from the device.
+.LP
+Because most of the RTL2832 devices are connected using USB, the
+librtlsdr library depends on the libusb library to communicate with
+the device.
+.SH USAGE
+With a suitable antenna for receiving the signal attached
+to the rtl-sdr supported device, this program will output the
+digital audio data decoded from that signal. The data can be
+listened to by piping to Sox or aplay applications to play the
+stream on the computer sound card.
+.SH SYNOPSIS
+.B  rtl_fm [-f freq] [-options] [filename]
+.SH OPTIONS
+.IP "-f frequency_to_tune_to [Hz]"
+ use multiple -f for scanning, (requires squelch)
+ ranges supported, -f 118M:137M:25k
+.IP "[-M modulation (default: fm)]"
+ fm, wbfm, raw, am, usb, lsb
+ wbfm == -M fm -s 170k -o 4 -A fast -r 32k -l 0 -E deemp
+ raw mode outputs 2x16 bit IQ pairs
+.IP "-s sample_rate (default: 24k)"
+.IP "-d device_index (default: 0)"
+.IP "-g tuner_gain (default: automatic)"
+.IP "-l squelch_level (default: 0/off)"
+.IP "-o oversampling (default: 1, 4 recommended)"
+ for fm squelch is inverted
+.IP "[-o oversampling (default: 1, 4 recommended)]"
+.IP "-p ppm_error (default: 0)"
+.IP "[-E enable_option (default: none)]"
+ use multiple -E to enable multiple options
+    edge:   enable lower edge tuning
+    dc:     enable dc blocking filter
+    deemp:  enable de-emphasis filter
+    direct: enable direct sampling
+    offset: enable offset tuning
+.IP "filename ('-' means stdout)"
+ omitting the filename also uses stdout
+.SH Experimental options
+.IP "[-r resample_rate (default: none / same as -s)]"
+.IP "[-t squelch_delay (default: 10)]"
+  +values will mute/scan, -values will exit
+.IP "[-F fir_size (default: off)]"
+    enables low-leakage downsample filter
+    size can be 0 or 9.  0 has bad roll off
+.IP "-A std/fast/lut choose atan math (default: std)"
+.IP filename
+ (a '-' dumps samples to stdout)
+ (omitting the filename also uses stdout)
+.SH EXAMPLES
+Produces signed 16 bit ints, use Sox or aplay to hear them.
+.IP "rtl_fm ... - | play -t raw -r 24k -es -b 16 -c 1 -V1 -"
+                  | aplay -r 24k -f S16_LE -t raw -c 1
+         -M wbfm  | play -r 32k ...
+.IP "rtl_fm ...  -s 22050 - | multimon -t raw /dev/stdin"
+.SH SEE ALSO
+RTL-SDR wiki documentation:
+.B http://sdr.osmocom.org/trac/wiki/rtl-sdr
+.LP
+Rtl_fm Guide:
+.B http://kmkeen.com/rtl-demod-guide/
+.LP
+.sp
+sox(1), play(1), aplay(1)
+.LP
+Other rtl-sdr programs:
+.sp
+rtl_adsb(1), rtl_eeprom(1), rtl_sdr(1), rtl_tcp(1), rtl_test(1)
+.SH AUTHOR
+This manual page was written by Maitland Bottoms
+for the Debian project (but may be used by others).
+.SH COPYRIGHT
+Copyright (c) 2013 A. Maitland Bottoms <bottoms@debian.org>
+.LP
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+.LP
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
--- a/debian/rtl_power.1
+++ b/debian/rtl_power.1
@ -0,0 +1,176 @@
+.TH rtl_power: "1" "0.5.1" RTL_SDR "User Commands"
+.SH NAME
+rtl_power: \- wideband spectrum monitor utility
+.SH DESCRIPTION
+Uses a re-purposed DVB-T receiver as a software defined
+radio to receive signals in I/Q data form. Written for
+and incorporated in the osmocom rtl-sdr project.
+.SH USAGE
+rtl_power, a simple FFT logger for RTL2832 based DVB\-T receivers
+.PP
+This tool gathers signal data over a very wide area of the frequency spectrum,
+and then that data can be used to find active areas of the spectrum.
+.PP
+Use:    rtl_power \fB\-f\fR freq_range [\-options] [filename]
+.HP
+\fB\-f\fR lower:upper:bin_size [Hz]
+.IP
+(bin size is a maximum, smaller more convenient bins
+.TP
+will be used.
+valid range 1Hz \- 2.8MHz)
+.IP
+[\-i integration_interval (default: 10 seconds)]
+.IP
+(buggy if a full sweep takes longer than the interval)
+.IP
+[\-1 enables single\-shot mode (default: off)]
+[\-e exit_timer (default: off/0)]
+[\-d device_index (default: 0)]
+[\-g tuner_gain (default: automatic)]
+[\-p ppm_error (default: 0)]
+filename (a '\-' dumps samples to stdout)
+.IP
+(omitting the filename also uses stdout)
+.SS "Experimental options:"
+.IP
+[\-w window (default: rectangle)]
+.IP
+(hamming, blackman, blackman\-harris, hann\-poisson, bartlett, youssef)
+.IP
+[\-c crop_percent (default: 0%, recommended: 20%\-50%)]
+.IP
+(discards data at the edges, 100% discards everything)
+(has no effect for bins larger than 1MHz)
+.IP
+[\-F fir_size (default: disabled)]
+.IP
+(enables low\-leakage downsample filter,
+.TP
+fir_size can be 0 or 9.
+0 has bad roll off,
+.IP
+try with '\-c 50%')
+.IP
+[\-P enables peak hold (default: off)]
+[\-D enable direct sampling (default: off)]
+[\-O enable offset tuning (default: off)]
+.SS "CSV FFT output columns:"
+.IP
+date, time, Hz low, Hz high, Hz step, samples, dbm, dbm, ...
+.SH EXAMPLES
+.IP
+rtl_power \fB\-f\fR 88M:108M:125k fm_stations.csv
+.IP
+(creates 160 bins across the FM band,
+.IP
+individual stations should be visible)
+.IP
+rtl_power \fB\-f\fR 100M:1G:1M \fB\-i\fR 5m \fB\-1\fR survey.csv
+.IP
+(a five minute low res scan of nearly everything)
+.IP
+rtl_power \fB\-f\fR ... \fB\-i\fR 15m \fB\-1\fR log.csv
+.IP
+(integrate for 15 minutes and exit afterwards)
+.IP
+rtl_power \fB\-f\fR ... \fB\-e\fR 1h | gzip > log.csv.gz
+.IP
+(collect data for one hour and compress it on the fly)
+.SS "Convert CSV to a waterfall graphic with:"
+.IP
+http://kmkeen.com/tmp/heatmap.py.txt
+.PP
+rtl_power, a simple FFT logger for RTL2832 based DVB\-T receivers
+.PP
+Use:    rtl_power \fB\-f\fR freq_range [\-options] [filename]
+.HP
+\fB\-f\fR lower:upper:bin_size [Hz]
+.IP
+(bin size is a maximum, smaller more convenient bins
+.TP
+will be used.
+valid range 1Hz \- 2.8MHz)
+.IP
+[\-i integration_interval (default: 10 seconds)]
+.IP
+(buggy if a full sweep takes longer than the interval)
+.IP
+[\-1 enables single\-shot mode (default: off)]
+[\-e exit_timer (default: off/0)]
+[\-d device_index (default: 0)]
+[\-g tuner_gain (default: automatic)]
+[\-p ppm_error (default: 0)]
+filename (a '\-' dumps samples to stdout)
+.IP
+(omitting the filename also uses stdout)
+.SS "Experimental options:"
+.IP
+[\-w window (default: rectangle)]
+.IP
+(hamming, blackman, blackman\-harris, hann\-poisson, bartlett, youssef)
+.IP
+[\-c crop_percent (default: 0%, recommended: 20%\-50%)]
+.IP
+(discards data at the edges, 100% discards everything)
+(has no effect for bins larger than 1MHz)
+.IP
+[\-F fir_size (default: disabled)]
+.IP
+(enables low\-leakage downsample filter,
+.TP
+fir_size can be 0 or 9.
+0 has bad roll off,
+.IP
+try with '\-c 50%')
+.IP
+[\-P enables peak hold (default: off)]
+[\-D enable direct sampling (default: off)]
+[\-O enable offset tuning (default: off)]
+.SS "CSV FFT output columns:"
+.IP
+date, time, Hz low, Hz high, Hz step, samples, dbm, dbm, ...
+.IP
+rtl_power \fB\-f\fR 88M:108M:125k fm_stations.csv
+.IP
+(creates 160 bins across the FM band,
+.IP
+individual stations should be visible)
+.IP
+rtl_power \fB\-f\fR 100M:1G:1M \fB\-i\fR 5m \fB\-1\fR survey.csv
+.IP
+(a five minute low res scan of nearly everything)
+.IP
+rtl_power \fB\-f\fR ... \fB\-i\fR 15m \fB\-1\fR log.csv
+.IP
+(integrate for 15 minutes and exit afterwards)
+.IP
+rtl_power \fB\-f\fR ... \fB\-e\fR 1h | gzip > log.csv.gz
+.IP
+(collect data for one hour and compress it on the fly)
+.SS "Convert CSV to a waterfall graphic with:"
+.IP
+http://kmkeen.com/tmp/heatmap.py.txt
+.SH "SEE ALSO"
+.LP
+RTL-SDR wiki documentation:
+.B http://sdr.osmocom.org/trac/wiki/rtl-sdr
+.LP
+Other rtl-sdr programs:
+.sp
+rtl_adsb(1), rtl_eeprom(1), rtl_fm(1), rtl_sdr(1), rtl_tcp(1), rtl_test(1)
+.SH AUTHOR
+This manual page was written by Maitland Bottoms
+for the Debian project (but may be used by others).
+.SH COPYRIGHT
+Copyright (c) 2013 A. Maitland Bottoms <bottoms@debian.org>
+.LP
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+.LP
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
--- a/debian/rtl_sdr.1
+++ b/debian/rtl_sdr.1
@ -0,0 +1,73 @@
+.TH "rtl_sdr" 1 "0.5.0" RTL-SDR "User Commands"
+.SH NAME
+rtl-sdr \- an I/Q recorder for RTL2832 based DVB-T receivers
+.SH DESCRIPTION
+Uses a re-purposed DVB-T receiver as a software defined
+radio to receive signals in I/Q data form. Written for
+and incorporated in the osmocom rtl-sdr project.
+.LP
+In-Phase and Quadrature Phase data can faithfully represent
+all of the information in a band of frequencies centered
+on a carrier signal frequency.
+.LP
+Much software is available for the RTL2832. Most of the user-level
+packages rely on the librtlsdr library which comes as part of the
+rtl-sdr codebase. This codebase contains both the library itself and
+also a number of command line tools such as rtl_test, rtl_sdr,
+rtl_tcp, and rtl_fm. These command line tools use the library to test
+for the existence of RTL2832 devices and to perform basic data
+transfer functions to and from the device.
+.LP
+Because most of the RTL2832 devices are connected using USB, the
+librtlsdr library depends on the libusb library to communicate with
+the device.
+.SH USAGE
+This program captures information from a band of frequencies
+and outputs the data in a form useful to other software radio
+programs.
+.SH SYNOPSIS
+.B  rtl_adsb [-f freq] [OPTIONS] [output file]
+.SH OPTIONS
+.IP "-f frequency_to_tune_to [Hz]"
+.IP "-s samplerate (default: 2048000 Hz)"
+.IP "-d device_index (default: 0)"
+.IP "-g gain (default: 0 for auto)"
+.IP "-p ppm_error (default: 0)"
+.IP "-b output_block_size (default: 16 * 16384)"
+.IP "-n number of samples to read (default: 0, infinite)"
+.IP "-S force sync output (default: async)"
+.IP tfilename
+ (a '-' dumps samples to stdout)
+.SH EXAMPLES
+.IP "Example: To tune to 392.0 MHz, and set the sample-rate to 1.8 MS/s, use:"
+ ./rtl_sdr /tmp/capture.bin -s 1.8e6 -f 392e6
+.LP
+to record samples to a file or to forward the data to a fifo.
+.LP
+If the device can't be opened, make sure you have the appropriate
+rights to access the device (install udev-rules from the repository,
+or run it as root).
+.SH SEE ALSO
+gnuradio(1)
+.LP
+RTL-SDR wiki documentation:
+.B http://sdr.osmocom.org/trac/wiki/rtl-sdr
+.LP
+Other rtl-sdr programs:
+.sp
+rtl_adsb(1), rtl_eeprom(1), rtl_fm(1), rtl_power(1), rtl_tcp(1), rtl_test(1)
+.SH AUTHOR
+This manual page was written by Maitland Bottoms
+for the Debian project (but may be used by others).
+.SH COPYRIGHT
+Copyright (c) 2013 A. Maitland Bottoms <bottoms@debian.org>
+.LP
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+.LP
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
--- a/debian/rtl_tcp.1
+++ b/debian/rtl_tcp.1
@ -0,0 +1,81 @@
+.TH "rtl_tcp" 1 "0.5.0" RTL-SDR "User Commands"
+.SH NAME
+rtl_tcp \- an I/Q spectrum server for RTL2832 based DVB-T receivers
+.SH DESCRIPTION
+Uses a re-purposed DVB-T receiver as a software defined
+radio to receive and send I/Q data via TCP network to another
+demodulation, decoding or logging apllication. Written for
+and incorporated into the osmocom rtl-sdr project.
+.LP
+Much software is available for the RTL2832. Most of the user-level
+packages rely on the librtlsdr library which comes as part of the
+rtl-sdr codebase. This codebase contains both the library itself and
+also a number of command line tools such as rtl_test, rtl_sdr,
+rtl_tcp, and rtl_fm. These command line tools use the library to test
+for the existence of RTL2832 devices and to perform basic data
+transfer functions to and from the device.
+.LP
+Because most of the RTL2832 devices are connected using USB, the
+librtlsdr library depends on the libusb library to communicate with
+the device.
+.SH USAGE
+Run this program on a machine with an rtl-sdr supported
+device connected and it will provide I/Q data to other applications
+via TCP/IP.
+.SH SYNOPSIS
+.B  rtl_tcp [OPTIONS]
+.SH OPTIONS
+.IP "-a listen address"
+.IP "-p listen port (default: 1234)"
+.IP "-f frequency to tune to [Hz]"
+.IP "-g gain (default: 0 for auto)"
+.IP "-s samplerate in Hz (default: 2048000 Hz)"
+.IP "-b number of buffers (default: 32, set by library)"
+.IP "-n max number of linked list buffers to keep (default: 500)"
+.IP "-d device_index (default: 0)"
+.IP "-P ppm_error (default: 0)"
+.SH  Example:
+.IP "rtl_tcp -a 10.0.0.2 [-p listen port (default: 1234)]"
+ Found 1 device(s).
+ Found Elonics E4000 tuner
+ Using Generic RTL2832U (e.g. hama nano)
+ Tuned to 100000000 Hz.
+ listening...
+.LP
+Use the device argument 'rtl_tcp=10.0.0.2:1234' in OsmoSDR (gr-osmosdr) source
+to receive samples in GRC and control rtl_tcp parameters (frequency, gain, ...).
+.LP
+use the rtl_tcp=... device argument in gr-osmosdr source to receive
+the samples in GRC and control the rtl settings remotely.
+.LP
+This application has been successfully crosscompiled for ARM and MIPS
+devices and is providing IQ data in a networked ADS-B setup at a rate
+of 2.4MSps. The gr-osmosdr source is being used together with an
+optimized gr-air-modes version (see Known Apps below). It is also
+available as a package in OpenWRT.
+.LP
+A use case is described https://sites.google.com/site/embrtlsdr/
+.SH SEE ALSO
+gnuradio(1)
+.LP
+RTL-SDR wiki documentation:
+.B http://sdr.osmocom.org/trac/wiki/rtl-sdr
+.LP
+Other rtl-sdr programs:
+.sp
+rtl_adsb(1), rtl_eeprom(1), rtl_fm(1), rtl_sdr(1), rtl_test(1)
+.SH AUTHOR
+This manual page was written by Maitland Bottoms
+for the Debian project (but may be used by others).
+.SH COPYRIGHT
+Copyright (c) 2013 A. Maitland Bottoms <bottoms@debian.org>
+.LP
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+.LP
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
--- a/debian/rtl_test.1
+++ b/debian/rtl_test.1
@ -0,0 +1,60 @@
+.TH "rtl_test" 1 "0.5.0" RTL-SDR "User Commands"
+.SH NAME
+rtl_test \- a benchmark tool for RTL2832 based DVB-T receivers
+.SH DESCRIPTION
+Test tuning range and functional sample rates of your device
+on your system.
+Uses a re-purposed DVB-T receiver as a software defined
+radio. Written for and incorporated into the osmocom rtl-sdr project.
+.LP
+Much software is available for the RTL2832. Most of the user-level
+packages rely on the librtlsdr library which comes as part of the
+rtl-sdr codebase. This codebase contains both the library itself and
+also a number of command line tools such as rtl_test, rtl_sdr,
+rtl_tcp, and rtl_fm. These command line tools use the library to test
+for the existence of RTL2832 devices and to perform basic data
+transfer functions to and from the device.
+.LP
+Because most of the RTL2832 devices are connected using USB, the
+librtlsdr library depends on the libusb library to communicate with
+the device.
+.SH SYNOPSIS
+.B  rtl_test [OPTIONS]
+.SH OPTIONS
+.IP "-s samplerate (default: 2048000 Hz)"
+.IP "-d device_index (default: 0)"
+.IP "-t enable Elonics E4000 tuner benchmark]"
+.IP "-p enable PPM error measurement"
+.IP "-b output_block_size (default: 16 * 16384)"
+.IP "-S force sync output (default: async)"
+.SH EXAMPLES
+.IP "To check the possible tuning range (may heavily vary by some MHz depending on device and temperature), call"
+ rtl_test -t
+.IP "To check the maximum samplerate possible on your machine, type (change the rate down until no sample loss occurs):"
+ rtl_test -s 3.2e6
+.LP
+A samplerate of 2.4e6 is known to work even over tcp connections (see
+rtl_tcp above). A sample rate of 2.88e6 may work without lost samples
+but this may depend on your PC/Laptop's host interface.
+.SH SEE ALSO
+RTL-SDR wiki documentation:
+.B http://sdr.osmocom.org/trac/wiki/rtl-sdr
+.LP
+Other rtl-sdr programs:
+.sp
+rtl_adsb(1), rtl_eeprom(1), rtl_fm(1), rtl_sdr(1), rtl_tcp(1)
+.SH AUTHOR
+This manual page was written by Maitland Bottoms
+for the Debian project (but may be used by others).
+.SH COPYRIGHT
+Copyright (c) 2013 A. Maitland Bottoms <bottoms@debian.org>
+.LP
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+.LP
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
--- a/debian/rules
+++ b/debian/rules
@ -0,0 +1,12 @@
+#!/usr/bin/make -f
+DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)
+export DEB_HOST_MULTIARCH
+
+%:
+	dh $@
+
+override_dh_auto_configure: debian/librtlsdr0.udev
+	dh_auto_configure -- -DLIB_INSTALL_DIR=lib/$(DEB_HOST_MULTIARCH) -DDETACH_KERNEL_DRIVER=ON
+
+debian/librtlsdr0.udev: rtl-sdr.rules
+	cp -p rtl-sdr.rules debian/librtlsdr0.udev
--- a/debian/source/format
+++ b/debian/source/format
@ -0,0 +1 @@
+3.0 (native)
--- a/debian/watch
+++ b/debian/watch
@ -0,0 +1,4 @@
+version=4
+opts="mode=git, gitmode=full, pgpmode=none" \
+ git://git.osmocom.org/rtl-sdr.git \
+ refs/tags/v([\d\.]+) debian uupdate
				`@ -0,0 +1 @@`
				`rm_conffile /etc/modprobe.d/rtl-sdr-blacklist.conf 0.5.3-10~`