Announcing PiAware 3!
Please see the 3.8.0 release announcement for details of the current release.
The rest of this post is historical information about older versions:
Instructions and Download Links
FlightAware is excited to announce the launch of PiAware 3! PiAware 3 extends the industry leading capabilities of the incredibly popular PiAware software for Raspberry Pi devices. Highlights include mapping and aircraft list enhancements and easy WiFi setup. PiAware 3 is currently only available as a reinstall of the SD card image (if you are upgrading from version 1 or 2). FlightAware recommends that all current users of PiAware upgrade to the PiAware 3 to obtain the new features.
Installing PiAware 3
The SD card image installation is the recommended procedure for users setting up a new Raspberry Pi for the first time or for users that want to update an existing PiAware device. Note that this will result in any existing data on the SD card being erased. To install, you must download the FlightAware PiAware 3 Raspberry Pi image which can be found here: https://flightaware.com/adsb/piaware/build
For discussion of the new features please use our discussion forum or e-mail adsbsupport [at] flightaware.com with questions.
- If you want to keep your existing SD card image and upgrade to version 3, see this post: ads-b-flight-tracking-f21/piaware-version-2-to-version-3-upgrade-t37890.html
- If you want to do a manual installation on your Raspberry Pi, see this post: ads-b-flight-tracking-f21/piaware-3-0-package-based-installation-t37851.html
Quickly, how do I enabled WiFi?
Note: These configuration instructions only apply if you installed from the PiAware 3.0 SD card image. If you need to enable WiFi then continue with the following steps AFTER completing the steps in Section 2 of the Build a PiAware instructions:
- Reinsert the SD card in your computer. It should be automatically recognized as an available disk drive.
- Open the SD card disk drive.
- Open âpiaware-config.txtâ in a text editor (usually you can just double-click the file to open).
- Scroll down to the âwifiâ settings and change the following settings to the values specified here:
wireless-network yes
wireless-ssid MyWifiNetwork (replace "MyWifiNetwork" with the name of your local WiFi network)
wireless-password s3cr3t (replace "s3cr3t" with your local WiFi network password)
- Save and close the file.
- Eject and remove the SD card.
Release Notes
3.0
- Integrated WiFi support â Easy wifi configuration without requiring attached monitor/keyboard/mouse or wired network connectivity â please refer to the instructions on our web site: flightaware.com/adsb/piaware/bu ⌠ional#wifi
- New OpenLayer Maps for local flight mapping.
Avoids requirement for users to obtain Google Maps API keys
Adds local map support for users in China - Range rings and aircraft distance from receiver site
- Country flags
- Aircraft type and registration, when known
- Updates dump1090 to align with the latest dump1090-mutability release which includes a substantially better Mode S decoder than PiAware 2
- Adds support for receiver devices other than RTL-SDR dongles such as Beast, Radarcape and other external receivers (for advanced users)
- Adds a new configuration utility to ease setup and customization (for advanced users)
- Improves the update capabilities so you can easily receive future enhancements
- Adds a new PiAware status web page for easy status review at-a-glance and quick access to the local map view (for advanced users, this is on HTTP port 80 and port 8080 redirects here) â the easiest way to access this local map view continues to be via the âView Live Dataâ link on the My ADS-B stats page at https://flightaware.com
3.0.4
- Auto upgrade from 3.0.3 supported.
- Added support for additional wireless devicesâ firmware.
- Added support for hidden wireless network SSIDs.
3.1.0
- piaware-config.txt now supports configuration values with special characters by enclosing them in quotes. This is primarily to support WiFi configuration. See comments in piaware-config.txt for details.
- Improvements to data decoding to prefer Extended Squitter data over non-ES Mode S data when both are available; this improves accuracy of reported data.
- Improved reliability of air/ground detection.
- Various minor bug fixes and tweaks.
- And the Big News: major improvements to the dump1090 web interface!
- Add NEXRAD weather layer (USA only)
- Aircraft information moves to drag-able pop-up
- Data table (sidebar) is resize-able and expandable/collapsible
- New and improved hyperlinks to flightaware.com aircraft data
- Configurable units of measure display (Imperial, metric, aeronautical)
- Filter aircraft by altitude
- Option to show all aircraft tracks
- Improved aircraft icons on map
- Improved aircraft type/registration database to include more publicly available data
- Computed aircraft registration numbers (from ICAO address) for countries with predictable mappings (e.g., USA)
- Various look and feel improvements for usability
3.3.0
- New config option: mlat-results-anon (default âyesâ). Set to ânoâ to disable sending MLAT results for blocked aircraft.
- New command-line options: -configfile, -cachedir. Can be used to run multiple copies of piaware on a single host by pointing each piaware at a different config file and cachedir.
- Updated Mode A/C support:
New config option: allow-modeac (default âyesâ). If enabled, dump1090-fa will decode Mode A/C if a client requests it via the Beast command protocol. Decoding Mode A/C requires additional CPU; this option may need to be disabled on low power devices. Upgrades on a Pi Zero or Pi 1 will set this to ânoâ during the upgrade. There is no display of Mode A/C data on the dump1090-fa web interface. - Major improvements to the Mode A/C decoder. Greatly reduced dump1090 CPU load when processing Mode A/C data in a busy environment.
- Updated FlightAwareâs aircraft static data export used by dump1090.
- Allow skipping the web map history load on slow connections by appending â#nohistoryâ to the map URL.
- For users running a previous 3.x SD card install or a new 3.3 SD card install:
Support for using external USB wifi on the Pi 3, for cases where the built-in wifi is insufficient. Configure ârfkill yesâ in addition to normal wireless settings. This will disable the internal wifi and use the external USB wifi instead.
Added a splashscreen during boot.
PiAware will remind you to change your password when you log in if ssh is enabled and your password is still the default password. - For users installing a NEW install from the 3.3 SD card image:
Updated the image to be based on the latest upstream Raspbian.
The sdcard image no longer includes a desktop environment; upstream changes in Raspbian made it impractical to maintain. If you need a desktop environment, you can either do a package install of piaware on top of standard Raspbian, or run the following after installing the image:
$ sudo apt-get update
$ sudo apt-get install raspberrypi-ui-mods
$ sudo reboot
- Replacing the desktop login prompt, after booting a simple text-mode status screen will be displayed. It shows (amongst other things) the current status of PiAware and the assigned IP addresses of the Pi. For a login prompt, press Alt+F2.
- The sdcard image no longer enables ssh by default for security reasons. This behaves the same way as upstream Raspbian; see raspberrypi.org/blog/a-secu ⌠ian-pixel/ for more information. Upgrades of existing installs, without writing a new sdcard image, are not affected: if you had ssh enabled before, itâll still be enabled after the upgrade. You can enable ssh by: Connecting a monitor and keyboard, logging in, running âsudo raspi-configâ, and selecting âInterfacing optionsâ then âEnable or disable ssh serverâ; or creating a file named âsshâ (it doesnât matter what it contains) in the first partition of the sdcard. This can be done on a separate system, e.g. on a PC immediately after writing the sdcard image. ssh will be enabled on the next boot. See also raspberrypi.org/documentati ⌠ccess/ssh/
- Various other bug fixes and tweaks.
3.5.0
- SD card image updated new kernel/bootloader packages (this adds support for the Pi Zero W)
- SD card image and package-based install updated to add PiAware Skyview user interface (dump1090 map view)
- Applied FlightAware branding and color scheme
- Improved row colors in data table for usability
- Add altitude color key to the map user interface
- Added color coded aircraft trails by aircraft altitude at each position
- Improved icons on the map view
- Added labels to distance range rings
- Updated aircraft icons to add more icons and make them consistent with flightaware.com
- Added new Settings pane (via gear icon) to consolidate configuration options and added filters for Blocked MLAT flights and ground vehicles.
- Added basic aircraft information pane the displays on hover over an aircraft icon.
- Updated and expanded the aircraft details pane for usability.
- Added current date/time in the header.
- Minor formatting changes for clarity and usability
3.5.1
- PiAware â make connections to FlightAware more robust for scalability/reliability
- Skyview â fix incorrect font in some browsers
- Skyview â fix incorrect âdata sourceâ displaying sometimes
- Skyview â show on-ground aircraft in brown color
- Skyview â speed up initial page load time
- Skyview â fix some incorrect aircraft icon mappings
- Skyview â fix unit selection on Firefox
3.5.3
- dump1090: Update OpenLayers to address SkyView performance issues on some browsers
- piaware: Fix a file descriptor leak when running on some non-Pi hardware
- piaware: Report current feeder ID from piaware-status
- fa-mlat-client: Fix complaints about out of order timestamps when mlat results are looped back
- fa-mlat-client: Fix a minor unit conversion error
- fa-mlat-client: Increase the size of socket listen queues to avoid false synflood detection
- piaware sdcard: Allow arbitrary strings (e.g. serial numbers) in rtlsdr-device-index
- piaware sdcard: Handle prehashed (64-character) wifi passphrases correctly
- piaware sdcard: Depend on a version of wpasupplicant that fixes the KRACK vulnerability
3.6.2
- Adds ability to decode âextended Mode Sâ data; this includes data such as airspeeds and auto pilot settings (when available; they will not always be sent from the aircraft). To see the data in Skvyiew there is a preliminary/experimental mode available: load your Skyview link with â#extendedâ appended to the URL, e.g., http://1.2.3.4/dump1090-fa/#extended). Please note that you may need to do a hard refresh of the page in your browser to get the new functionality loaded.
- SD card image install now supports Raspbian Stretch operating system (so it is installable on the model 3B+ devices) â we recommend all users re-image to this version to get the latest operating system. Be sure to set your âfeeder-idâ after re-installing so that you keep your existing My ADS-B statistics site (see âInstalling PiAware 3â above). However, if you prefer, you may do an in-place upgrade by initiating it via the âMy ADS-Bâ page (âDevice Commandsâ via the gear icon).
- A new data feed option is available for getting data from your device. This option provides JSON data in the same format as FlightAwareâs commercial âFirehoseâ product. This is only for advanced users that want to write custom software that uses the data from their device in this format. See our FAQ for details.
- If you are upgrading a package install that is already on Stretch, repeat all of Step 2, 3 and 4 at https://flightaware.com/adsb/piaware/install
3.6.3
- Updated the Skyview user interface to improve the layout so it better accommodates displaying âextended Mode Sâ data. When a specific aircraft is selected, the full aircraft details are now shown in a resizable pane on the lower right side of the screen. (This also removes the need to use â#extendedâ on the URL to see extended Mode S data.) Please note that you may need to do a hard refresh of the page in your browser to get the new functionality loaded.
- Fixes bug in the port 30003 output format.
3.7.0.1
- SD image supports 978MHz ADS-B via dump978-fa
- Adds a config option âuse-gpsdâ to allow disabling the use of gpsd location info
- dump1090: Fix Rc decoding errors
- dump1090: Compute ADS-B v0 NACp/SIL
- dump1090: When generating aircraft.json, leave space for the final line; otherwise the generated json may have trailing garbage
- dump1090: Donât update the known-address-set from DF18 messages
- dump1090: Bail out if rtlsdr_read_async() returns early; it probably means we lost the USB device. There was a workaround for this (originally implemented min dump1090-mutability) that got lost in the refactoring needed to support different SDRs. librtlsdr can still be flaky under disconnect conditions, so this wonât catch everything.
- dump1090: add ENABLED to /etc/default/dump1090-fa
- dump1090: track FMS and MCP selected altitudes separately
- skyview (1090): use whichever selected altitude is available
- Skyview (1090): use heading data for icon orientation if track data is unavailable
- Skyview (1090): donât spin forever if thereâs no history to load / receiver.json is missing
- Separate Skyview for 978 UAT tracking
- dump978-fa : Fix quotations bug in default config file
3.7.1
- dump1090: Comm-b message decoding updates
- dump1090: Update aircraft DB to 20190502
- dump1090: Fix TSV buffer overflow/increase max TSV packet size
- dump1090: Fix incorrect mode_s bit number usage
- dump1090: Minimal polyfill to support building older bladeRF libs
- dump1090: Require more fields to be populated in BDS5,0/BDS6,0 before accepting
- dump978: Soapysdr error handling enhancements
- dump978: Switch to CS16 converter to a table-based approach
- dump978: Fix atan2 angle normalization
- soapysdr: Error handling improvements, increase soapysdr timeout to 5s due to timeouts, and soapysdr parameter fixes
- Skyview978: Decrease range circles for UAT Skyview map
- Skyview978: Update aircraft DB to 20190502
- Skyview978: Fix bug getting LAT/LON from piaware .env file
- Skyview978: Fix enums in json-format output; emit emitter_category as a string
- Piaware: Separate indicators for 1090 and 978 UAT Radio on PiAware status web page
- PiAware: Fix bug with use-gpsd option
3.7.2
Whatâs New:
- Official renaming of Skyview to SkyAware
- Adds Stratux dongle support to dump978
- TIS-B data no longer forwarded to FlightAware in dump978
- Adds support for raw message timestamps in dump978
- Update SkyAware aircraft DB to 20190816
Bug fixes:
- piaware: Handle misleading âcouldnât open socketâ piaware-status message
- piaware: Remove obsolete piaware-config settings
- piaware: Include receiver-type & uat-receiver-type at adept login
- piaware: piaware-status cleanup
- SkyAware: Fix some display errors for ground vehicles
- SkyAware: Fix aircraft trail handling
- dump1090: Fix reversed sense of Track Angle/Heading bit in surface opstatus messages
- dump1090: Have filter-regs emit a special value â-COMPUTED-â for filtered data values, rather than blanking them out entirely
- dump1090: Fix registration side mappings with a non-zero offset
- dump1090: Reject outright libbladerf thatâs too old
- dump1090: Trigger build after bladeRF build; turn off build durability; turn off concurrent builds
- dump978: Rename CS8 â CS8_ to avoid conflicts with macros in termios.h
- dump978: Fix stdin samples not being processed
- dump978: Donât override CC/CXX if externally provided
- dump978: Work around false-positive warning with g++ 8
- dump978: Split out error handler; prepare to support message sources arenât the demodulator
- soapysdr: Fix compilation problems with new soapysdr
Upgrade methods:
If you are currently on a PiAware SD card image:
- Re-image with 3.7.2 SD Card image (link) - Be sure to set your âfeeder-idâ either in the piaware-config.txt file or via the command line after re-installing so that you keep your existing My ADS-B statistics
Or - Upgrade via your My ADS-B stats page (âUpgrade and restart PiAwareâ Device command in the gear icon menu)
If you are currently on a PiAware package install:
- Upgrade via My ADS-B stats page (âUpgrade and restart PiAwareâ and âUpgrade and restart dump1090â Device commands in the gear icon menu)
Or - Repeat all of steps 2, 3 , 4, and 5 at https://flightaware.com/adsb/piaware/install