107 lines
4.8 KiB
Markdown
107 lines
4.8 KiB
Markdown
# dump1090-mutability Debian/Raspbian packages
|
|
|
|
This is a fork of MalcolmRobb's version of dump1090
|
|
that adds new functionality and is designed to be built as
|
|
a Debian/Raspbian package.
|
|
|
|
# Features
|
|
|
|
* 2.4MHz "oversampling" support
|
|
* doesn't run as root
|
|
* supports FlightAware-TSV-format connections directly (same as the FlightAware version - no faup1090 needed)
|
|
* can start from init.d, with detailed config via debconf or `/etc/default/dump1090-mutability`
|
|
* can serve the virtual radar map via an external webserver (lighttpd integration included by default)
|
|
* map view uses receiver lat/long given to dump1090 automatically
|
|
* somewhat cleaned-up network code
|
|
* tries to do things "the debian way" when it comes to config, package structure, etc
|
|
* probably a bunch of other things I've forgotten..
|
|
|
|
# Simple install via apt-get
|
|
|
|
There is a repository that contains the current releases.
|
|
To install from it:
|
|
|
|
````
|
|
$ sudo bash
|
|
# echo "deb http://repo.mutability.co.uk/raspbian wheezy rpi" >/etc/apt/sources.list.d/mutability.list
|
|
# apt-get update && apt-get install dump1090-mutability
|
|
# dpkg-reconfigure dump1090-mutability # for detailed configuration
|
|
# apt-get install lighttpd && lighty-enable-mod dump1090 # if you want to use the external webserver integration
|
|
````
|
|
|
|
The repository and packages are (currently) unsigned, you will have to confirm installing from an unsigned source.
|
|
|
|
# Manual installation
|
|
|
|
You will need a librtlsdr0 package for Raspbian.
|
|
There is no standard build of this.
|
|
I have built suitable packages that are available from
|
|
[this release page](https://github.com/mutability/librtlsdr/releases)
|
|
|
|
Then you will need the dump1090-mutability package itself from
|
|
[this release page](https://github.com/mutability/dump1090/releases)
|
|
|
|
Install the packages with dpkg.
|
|
|
|
# Configuraion
|
|
|
|
By default it'll only ask you whether to start automatically and assume sensible defaults for everything else.
|
|
Notable defaults that are perhaps not what you'd first expect:
|
|
|
|
* All network ports are bound to the localhost interface only.
|
|
If you need remote access to the ADS-B data ports, you will want to change this to bind to the wildcard address.
|
|
* The internal HTTP server is disabled. I recommend using an external webserver (see below).
|
|
You can reconfigure to enable the internal one if you don't want to use an external one.
|
|
|
|
To reconfigure, either use `dpkg-reconfigure dump1090-mutability` or edit `/etc/default/dump1090-mutability`. Both should be self-explanatory.
|
|
|
|
## External webserver configuration
|
|
|
|
This is the recommended configuration; a dedicated webserver is almost always going to be better and more secure than the collection of hacks that is the dump1090 webserver.
|
|
It works by having dump1090 write json files to a path under `/run` once a second (this is on tmpfs and will not write to the sdcard).
|
|
Then an external webserver is used to serve both the static html/javascript files making up the map view, and the json files that provide the dynamic data.
|
|
|
|
The package includes a config file for lighttpd (which is what I happen to use on my system).
|
|
To use this:
|
|
|
|
````
|
|
# apt-get install lighttpd # if you don't have it already
|
|
# lighty-enable-mod dump1090
|
|
# service lighttpd force-reload
|
|
````
|
|
|
|
This uses a configuration file installed by the package at `/etc/lighttpd/conf-available/89-dump1090.conf`.
|
|
It makes the map view available at http://<pi address>/dump1090/
|
|
|
|
This should also work fine with other webservers, you will need to write a similar config to the lighttpd one (it's basically just a couple of aliases).
|
|
If you do set up a config for something else, please send me a copy so I can integrate it into the package!
|
|
|
|
## Logging
|
|
|
|
The default configuration logs to `/var/log/dump1090-mutability.log` (this can be reconfigured).
|
|
The only real logging other than any startup problems is hourly stats.
|
|
There is a logrotate configuration installed by the package at `/etc/logrotate.d/dump1090-mutability` that will rotate that logfile weekly.
|
|
|
|
# Bug reports, feedback etc
|
|
|
|
Please use the [github issues page](https://github.com/mutability/dump1090/issues) to report any problems.
|
|
Or you can [email me](mailto:oliver@mutability.co.uk).
|
|
|
|
# Future plans
|
|
|
|
Packages following the same model for MalcolmRobb & FlightAware's forks of dump1090 are in the pipeline.
|
|
So is a repackaged version of piaware.
|
|
|
|
# Building from source
|
|
|
|
While there is a Makefile that you can use, the preferred way to build is via the Debian package building system:
|
|
|
|
````
|
|
$ sudo apt-get install librtlsdr-dev libusb-1.0-0-dev pkg-config debhelper
|
|
$ dpkg-buildpackage -b
|
|
````
|
|
|
|
Or you can use debuild, pdebuild, etc.
|
|
I find building via qemubuilder quite effective for building images for Raspbian (it's actually faster to build
|
|
on an emulated ARM running on my PC than to build directly on real hardware)
|