Revision as of 18:23, 18 November 2018

Major 2 Related Pages

General notes for new software releases

All new Radarcape firmware packages have been tested thoroughly, but since Radarcape is an open system we never can now all status of devices that run on your side. In case of updating problems, please consider updating your device manually using the debian package or flashing it first back to a fallback image, as described in Radarcape:DebianSupport#Debian_Installation.
Especially when operating your Radarcape remotely from your own location, be aware that the update may crash and you need to have a fallback strategy, a 2nd port for commands, and maybe the watchdog retrigger script running or at hands: Radarcape:Watchdog. It is highly recommended in such situations that you update first some local devices in order to proof it will work remotely, too.

Radarcape Software Features Version radarcaped-AAA-181116.1000.02 (Major Release 2)

New Features:
- Ground Speed, Vertical Rate and True Track are now also displayed for AC without ADS-B, when interrogated from a Mode-S ground radar.
- Aircraft list columns can be configured
  - Enable and disable column
  - Sorting of empty fields to the bottom or top
  - Setting is saved in local browser, so multiple displays are possible
- Clear text name of origin and destination airport with a clickable link
- Receiver performance statistics
  - last 5 minutes, last 24h and last 30 days
- Receiver range display
  - for 3 different altitudes
- synthetic fields "external temperature", "wind speed" and "wind direction" added to aircraft list. Available when a ADS-B aircraft is under EHS ground radar.
- Altitude displayed for all Mode-S aircraft
- GNSS (GPS) status has got a graphic display of visible satellites over the last 24h
- Security features
  - disable remote control of FPGA and GPS via TCP ports (moved to the security configuration)
- IPv6 support for feeders and streams
Improvements and Changes:
- MLAT Key entering procedure has changed: Client ID is part of the key file
- Improved CPU load when retrieving aircraftlist.json
- Improved connection to external Open Glider Net Flarm receiver
Fixes:
- fixed JSON bug when loading aircraftlist.json with parameter select=locs
- fixed clicking on longitude link opens gmap with preselected aircraft
- fixed filtering of the available location sources
- fixed up and then crash when feeding to FR24

Debian Jessie direct download link: www.modesbeast.com/resources/radarcaped-181116.1000.02.deb
This release is not available for Angstrom.

Radarcape Software Features Version 171213.1000.02 (Major Release 2)

Radarcape is now able to displays FLARM located aircraft from two different sources:
- multiple local Raspberry-Pi based OGN receiver data can be read with UDP push interface (instructions provided online).
- connection to OGN server.
2D Map filters provide selective display of ADS-B, Jetvision MLAT, FlightAware MLAT, local FLARM and OGN Server data.
Extended symbols for aircraft and FLARM, unknown type is a triangle, no longer A320.
Ground traffic is displayed with a car symbol.
Improved FPGA decoder for very strong signals (aircraft approximation <200m).
Improved speed when accessing JSON data.
GPS: Disable GPS jamming filter, now just 1 satellite instead of 4 is sufficient for a GPS signal.
Show data of tracked aircraft overall and with different sources in aircraft list and maps.

Radarcape Software Features Version radarcaped-170521.1100.02 (Major Release 2)

Since May 2017 we provide Major Release 2. Currently this page describes the differences to Software Features of Major 1. All features of Major 1 are still included into Major 2, however some, for example the JSON lists and KML output, with some changes or enhancements.

Listed here are a lot of add-ons and enhancements. Please read across Radarcape:Software_Features for a first overview. See more about installations in the bottom.

You can identifiy our Major 2 release with a ".02", ".02D" or ".02A" at the end of the version string while Major 1 is ".01", ".01D", ".01A" or nothing.

How to perform update

It is strongly recommended to update to the latest version of Major 1 before updating to Major 2.

Until now the update has been done on some 50 devices without problems or assistance, most of them even remote. However, if your device is in a barely accessible, remote location or otherwise not easy to handle if something fails, please wait until some more experience was gained. We do not take over guarantee that it works in any strange situation.

If you want to update, simply go to the Settings - Software Maintenance and overwrite the default version given with the string

radarcaped-170521.1100.02

and then press submit. Thats it.

Key Features

This is a brief summary of all new features.

Jetvision MLAT

We now have our own multilateration network operating stable with very good results.

high precision location of Mode-S and ADS-B aircraft
independent from any other sources, one shot position estimation
update rate to clients 1/sec (if raw data is available)
latency app. 1.5 seconds on client side

New features within Radarcape web interface

New responsive web design optimized for web browsers on desktop, tablets and mobile devices
Aircraft list can be sorted for any column
Openlayers based maps
ATC-Scope professional map style
Filters for the 2D maps and KML output, e.g. altitude, type, flight, ICAO hex id, registration. Some of them with wildcards.

New features within Radarcape software

Aircaft location and flight data are stored and accessible separately for ADS-B, Jetvision MLAT and other location sources
Radarcape is now able to support native piAware from FlightAware in the background as fully featured feeder and can read back MLAT results in order to display them in aircraft list, 2D maps and KML output
Full performance feeder for Opensky Network
PiAware from FlightAware can be loaded into the background as a full performance feeder for their network.
Automatic update of flight route and aircraft type (basestation) database
BDS register data (Extdata) free of extra charges
Signal level available converted to dBm

Sharing groups (to come)

Several Radarcapes can be combined into a sharing network

Support for Planeplotter Mobile

PPm can be used to display single Radarcape or sharing groups data through local connection or connection using our MLAT server

2 Channel Radarcape

Antenna Diversity
Dual Antenna systems

Radarcape Video-Out

for verification purposes, a buffered video out of the demodulated Mode-A/C and Mode-S signal is provided on a back side SMB or SMC connector

Changed License Conditions

With Major 2 firmware, we are introducing 3 classes of software licenses. Major 1 software (versions yymmdd.hhmm.01) are not affected by this change.

Private Users

For private users, there are no changes, they can use the Radarcape in their private environment as always before! With Major 2 release, the license type is shown in the browser title. Default license type is "non commercial".

Commercial License

For business purposes, when using Major 2 release, you need a commercial license key in case you use our Radarcape to generate commercial value (excluding value generated by using the built in feeders). For non profit organisations it is further free without a payable license. Please contact Jetvision support for a feature key.
The feature key key is available also in the shop, please provide your Status - System: Download TXT file with your request.

OEM License

This license is for using the Radarcape with Major 2 software for OEM purposes. This license key allows to customize the browser interface, use own logos and style sheets. Radarcape and all interface data can be used for business purposes in a customized environment.
The feature key is available also in the shop, please provide your Status - System: Download TXT file with your request.

Jetvision Multilateration Server

High precision location estimation for any Mode-S and ADS-B aircraft

Mulitlateration position estimation is possible with at least 3 Radarcape that share a common air space

High precision MLAT results returning location, speed, track and vertical rate
MLAT results are ditributed within a private sharing group
Very low latency: Results are returned once per second with an latency of app. 1.5sec.
No need for ADS-B aircraft as calibration references
High accuracy for even a single position estimation, enhanced with a highly sophisticated, self adapting Kalman filter.
MLAT results can be calculated for ADS-B aircraft, for example to verify their actual position or in case of spoofing
Server/client connection is authorized and encrypted by TLS key pairs
- intrusion avoidance
- allow access control

MLAT server provides JSON, Port 30003 and JSON streaming services in the same way and format as every Radarcape

Any software which reads Radarcape data can read a combination of several on the server

Private sharing groups

Provides services for sharing of data from multiple Radarcape among each other and sharing group data on any web based desktop or mobile device

Web interface to the server (commercial)

Access to flight data of all connected Radarcapes including ADS-B data and BDS registers (commercial)
Client status monitoring provided as JSON files
XML configuration file for sharing groups

MLAT Server operational modes

Public Jetvision Mlat server
Jetvision Dedicated Mlat server, closed network
Licensed operation on a private server provided by operator

Flexible hardware platform

Written in native C++, our MLAT server can operate on any Linux platform on x86, amd64 or even ARM. (on special request and charges only)

Radarcape Software Features

Sharing Groups (planned)

A number of Radarcapes can be combined through our server forming a sharing group, e.g. for wide area supervision or local hot spot precision observation.
Radarcape MLAT results are shared within such a Sharing Group (third party sources are not)

Filters for 2D or KML

Altitude, Type (with wildcard), and more
Fleetwatch Filter:
- Filtering for ICAO HEX ID or registration (wildcards permitted)

FlightAware no compromise feed including multilateration results

FlightAware sharing supported with no compromises
MLAT results from FlightAware feeder can be read back into the Radarcape in addition to MLAT results from Radarcape network. The border of aircraft symbols indicates the source
- black: ADS-B
- red: Jetvision MLAT
- green: FlightAware MLAT

Location and flight paths of different sources are stored and output separately

ADS-B, Radarcape-MLAT, FlightAware-MLAT and Sharing Group results may be observed separately
These data are also available within the JSON data outputs
A new field was added to aircraftlist.json which contains the location, altitude, heading, speed and vertical rate for each of the location sources

New feeder for Opensky Network

Opensky network feeder with no compromises
How to install is explained in the Settings - Radarcape Feeder Settings - Opensky Network page

Automatic update of routes and aircraft type database

Flightroutes database and basestation database are updated automatically (internet connection required), however manual update is still possible.
Manual upload service for systems without internet

GPS data is provided to Chrony or NTPD

The Radarcape becomes a stratum 1 time server

Optimized TCP streams

In order to decrease network load, network streams became buffered

Signal level in dBm

The signal level at the antenna connector is indicated in dBm
(note that this is not foreseen for measurement purposes)

Second-of-Day mode selectable

The value range of the second-of-day field in the GPS timestamp is selectable, the current setting is reported in status frame

legacy mode: value range is 1…86400
true UTC mode: value range is 0 … 86399

Status Frame 0x34 contents were extended with GPS and UTC information

Status frames are triggered by 1PPS pulse when GPS timestamps are selected and triggered randomly in case of legacy 12MHz timestamps.
Status frames contain a valid timestamp
The signal level value is zero

Byte #0 of the message part contains a mirror of the FPGA switch settings. These settings have direct effect on the raw data ports 10002-10006 and indirect effect due to eventually missing or differently available data to the high level functions:

FPGA switch settings
		'1'	'0'
Bit 0:	Data output mode (port 10002 only)	Binary	AVR hexdump
Bit 1:	Raw data frame types	DF11, DF17 and DF18 only	no pre-filtering
Bit 2:	Timestamps within AVR format	enabled	disabled
Bit 3:	not used
Bit 4:	Timestamp mode	GPS	Legacy 12MHz
Bit 5:	FPGA/USB handshake	disabled	enabled
Bit 6:	1 bit forward error correction (FEC)	disabled	enabled
Bit 7:	Mode-A/C decoding	enabled	disabled

Byte #1 of the message part in GPS timestamp mode contains the offset of the nanosecond timer at the 1PPS event in units of 15.625ns. Normal value range is -3 … +3.

Byte #2 of the message part contains information about GPS

GPS status information
		'1'	'0'
Bit 0:	Antenna status	good	fail
Bit 1:	Tracking at least 1 satellite	true	false
Bit 2:	Tracking at least 3 satellites	true	false
Bit 3:	Time value base	UTC time	GPS time (8sec offset)
Bit 4:	unused
Bit 5:	unused
Bit 6:	unused
Bit 7:	Daysec value range	0 ... 86399	1 ... 86400

Web Interface

New responsive web design

Optimized for web browsers, mobile devices and tablets

Configuration and filters stored in local browser

Filters are provided for serval properties, like altitude, hex code, registration and type (with wildcards), speed, and more
Views and filters from different browsers and devices can have individual settings, e.g. different map styles and filters

Openlayers Map introduced in parallel to Google Maps

Supports different map styles based on gmap and Openlayers
Border of aircraft symbols and color of tracks shows the source of data
- Black: ADS-B
- Red: Radarcape-MLAT
- Green: FlightAware
Track is colored by source or altitude (partly implemented)
Professional Radar map style
- providing only navigatorial data
- free of unwanted map contents
- Track and vector displayed of each aircraft
  - border color is data source: black=ADS-B, red=Radarcape MLAT green=FlightAware MLAT
  - fill style blue=climbing, yellow: leveling, brown=ascending

KML output for 3D external viewers

KML output has got 3 filter banks within the Radarcapes, which can be selected in a KML browser separately or even in parallel. Unlike the 2D maps, common KML browsers like Google Earth do not permit adding user specific menues, so this way was choosen. However, these filters are updated without the need of reloading in the KML browser, just submit the new filter and it applies at the next reload.

KML output provides aircrafts in different colors:

Outer rim:
- Black: localized by ADS-B
- Red: Jetvision MLAT location
- Green: FlightAware MLAT location
Inner color:
- Yellow: no change in altitude
- Brown: descending
- Blue: Climbing

The color of the track is selected by altitude, and ground tracks are colored in yellow.

Chrony and NTPD Support

Radarcape software provides interfaces for Chrony and NTPD so they can access the GPS data properly. With these, Radarcape becomes a Stratum 1 NTP standard.

Changed Output Formats

In case that the changed output formats are causing impacts with any 3rd level software that we were not aware of, please contact us in order to find the best suitable solution.

Output Filtering

JSON files can be controlled by a number of parameters

Token	Type	Description	aircraftlist.json	flightpath.json	deltadb.txt
vpn	float	View point north limit	X	-	-
vps	float	View point south limit	X	-	-
vpw	float	View point west limit	X	-	-
vpe	float	View point east limit	X	-	-
select	avail locs bds	avail: only list of available ICAO locs: output all available location sources as array bds: output some selected BDS registers	X	-	-
knownposonly	0 .or. 1	Output only aircraft with known position	X	-	-
since	unix-time	Output since of those which got updates since <unix-time>	X	-	X
tracklength	integer	Track length in seconds	-	X	-
src	a .or. m .or. f	Override automatich location selection: a: ADS-B, m: Jetvision MLAT, f: FlightAware MLAT	X	-	-
lookback	integer	deltadb.txt: Time in seconds from now to history which data is output flightpath.json: track length	-	X	X
altitude.from	integer	Minimum altitude in ft	X	-	-
altitude.to	integer	Maximum altitude in ft	X	-	-
icao	integer	Element of the ICAO Hex ID or registration filter multiple of it can be provided automatically detects if HEX or Registration CSV input capable	X	-	-
type	string	Element of the aircraft type filter multiple elements are accumulated CSV input capable	X	-	-
flight	string	Element of the flight ID filter multiple elements are accumulated CSV input cabpable	X	-	-

Examples:

http://radarcape/aircraftlist.json?knownposonly=1&vpn=48.38&vpe=12.08&vps=48.19&vpw=10.97&altitude.from=1&altitude.to=25000

http://radarcape/flightpath.json?icao=3C4D63&icao=3C5443&icao=300558&icao=3D41A3&icao=4B1A1D&icao=49130E&lookback=180

http://radarcape/aircraftlist.json?select=avail

http://radarcape/aircraftlist.json?knownposonly=1&vpn=49.19&vpe=16.09&vps=47.46&vpw=7.51&type=b74*,a38*

http://radarcape/aircraftlist.json?icao=3f*,d-e*&altitude.from=1&altitude.to=25000

http://radarcape/flightpath.json?icao=3D2515&lookback=600

aircraftlist.json

The location, altitude, track, vrate and speed given for the aircraft in the base level follows a priority: ADS-B -> Radarcape-MLAT -> FlightAware MLAT, whichever has provided more results during the last 5 seconds
The values of the currently three location sources (ADS-B, Radarcape-MLAT, FlightAware-MLAT) can be requested in a separate array with an additional URL parameter &select=loc. Each of them contains a field "tsz" for its track length. Base level elements "tsa" and "tsz" were removed
Value "dbm" was added, which contains the signal level at the antenna connector in dBm. Note: This is not for measurement purposes
The values itself are formatted as their native data type (integer, string, float). No longer for example floats as a string. Unknown values are marked as JSON 'null'

sorted_aircraftlist.json

removed without replacement

fligthpath.json

now outputs a JSON array with the capability to request several flight paths in one call
used with parameter "&icao=<hex>" will return the flight path by default priority ranking ADS-B -> Jetvision MLAT -> FlightAware MLAT, an additional parameter "&src=<char>" with char either 'a', 'm' or 'f' will select the flight path from selected location source
parameter "&icao=<hex>" may be either repeated or either be filled with a comma separated list (e.g. <hex1, hex2>) to request several flight paths
instead of <hex> it may also contain registratioin, this can be mixed, so for example these are valid requests: &icao=3f1234,D-AQUI or &icao=3f1234&icoa=d-aqui. Using registration requires a loaded aircraft type database and the presence of the aircraft in this database.

mapinfo.json

contains information about own location and some more

deltadb.csv / deltadb.txt

parameter "&loc=" was removed, own location can be read within mapinfo.json

UDP Output and Formats

The configuration of all UDP ports was separated from General settings into a streaming output configuration page
A new UDP format which contains a periodic output of changed data in the same format as aircraftlist.json is now provided.
The time interval between each output can be configured.

@@ Line 27: / Line 27: @@
 ***Sorting of empty fields to the bottom or top
 ***Setting is saved in local browser, so multiple displays are possible
+** Clear text name of origin and destination airport with a clickable link
 ** Receiver performance statistics
 *** last 5 minutes, last 24h and last 30 days

Radarcape:Software Features Major2: Difference between revisions