30 KiB
sdr-enthusiasts/docker-adsb-ultrafeeder
adsb-ultrafeeder
is a ADS-B data collector container that can be used to:
- retrieve ADS-B data from your SDR or other device
- display it on a local map, including options to show tracks, heatmaps, and system performance graphs
- forward the data to one or more aggregators using BEAST/BEAST-REDUCE/BEAST-REDUCE-PLUS format
- send MLAT data to these aggregators
- receive and consolidate MLAT results data (built-in
mlathub
) - Interface with external visualization tools such as Grafana using statistics data available in InfluxDB and Prometheus format
In order to accomplish this, the container makes use of the following underlying technologies:
- SDR-Enthusiasts Docker Base-Image
- Wiedehopf's branch of
readsb
- Wiedehopf's tar1090 graphical interface
- Wiedehopf's graphs1090
- MLAT Client
It builds and runs on linux/amd64
, linux/arm/v7 (linux/armhf)
and linux/arm64
architectures.
docker-compose.yml
configuration
Up-and-Running with docker-compose
An example docker-compose.xml
file can be found in this repository. Here are a few basic elements:
version: '3.8'
services:
tar1090:
image: ghcr.io/sdr-enthusiasts/docker-adsb-all-in-one:latest
tty: true
container_name: adsb-all-in-one
restart: always
environment:
- TZ=Australia/Perth
- BEASTHOST=readsb
- LAT=-33.33333
- LONG=111.11111
volumes:
- /opt/adsb/tar1090/globe_history:/var/globe_history
- /opt/adsb/tar1090/timelapse1090:/var/timelapse1090
- /opt/adsb/tar1090/graphs1090:/var/lib/collectd
- /proc/diskstats:/proc/diskstats:ro
# - /run/airspy_adsb:/run/airspy_adsb
devices:
- /dev/usb:/dev/usb
ports:
- 8078:80
tmpfs:
- /run:exec,size=64M
- /var/log
You should now be able to browse to:
- http://dockerhost:8078/ to access the tar1090 web interface.
- http://dockerhost:8078/?replay to see a replay of past data
- http://dockerhost:8078/?heatmap to see the heatmap for the past 24 hours.
- http://dockerhost:8078/?heatmap&realHeat to see a different heatmap for the past 24 hours.
- http://dockerhost:8078/graphs1090/ to see performance graphs
Ports
Some common ports are as follows (which may or may not be in use depending on your configuration):
Port | Details |
---|---|
30001/tcp |
Raw protocol input |
30002/tcp |
Raw protocol output |
30003/tcp |
SBS/Basestation protocol output |
32006/tcp |
SBS/Basestation protocol input |
30004/tcp |
Beast protocol input |
30005/tcp |
Beast protocol output |
30006/tcp |
Beast reduce protocol output |
30047/tcp |
Json position output |
31003/tcp |
MLATHUB SBS/Basestation protocol output |
31004/tcp |
MLATHUB Beast protocol input |
31005/tcp |
MLATHUB Beast protocol output |
The container's web interface is rendered to port 80
in the container. This can me mapped to a port on the host using the docker-compose ports
directive. In the example above, the container's website is made available at port 8078 on the host system.
Json position output:
- outputs an aircraft object for every new position received for an aircraft if the --json-trace-interval has elapsed for that aircraft
- to make it output every received position, set READSB_JSON_TRACE_INTERVAL to 0.1
- each json object will be on a new line
- https://github.com/wiedehopf/readsb/blob/dev/README-json.md
Aircraft.json:
- https://github.com/wiedehopf/readsb/blob/dev/README-json.md
- available on the same port as the web interface, example:
http://192.168.x.yy:8087/data/aircraft.json
Runtime Environment Variables
The sections below describe how to configure each part of the container functionality. Each section describes what's needed to come up with a minimally viable configuration, followed by additional / optional parameters that can also be set.
General Configuration
Basic Ultrafeeder Parameters
Mandatory Parameters
The following parameters must be set (mandatory) for the container to function:
Environment Variable | Purpose | Default |
---|---|---|
LAT or READSB_LAT |
The latitude of your antenna | |
LONG or READSB_LON |
The longitude of your antenna | |
ALT or READSB_ALT |
The altitude of your antenna over ground level. For example, 15m or 45ft |
|
TZ |
Your local timezone in TZ-database-name format |
Optional Parameters
Variable | Description | Controls which readsb option |
Default |
---|---|---|---|
ENABLE_TIMELAPSE1090 |
Optional / Legacy. Set to any value to enable timelapse1090. Once enabled, can be accessed via http://dockerhost:port/timelapse/. | Unset | |
READSB_EXTRA_ARGS |
Optional, allows to specify extra parameters for readsb | Unset | |
READSB_DEBUG |
Optional, used to set debug mode. n : network, P : CPR, S : speed check |
Unset | |
S6_SERVICES_GRACETIME |
Optional, set to 30000 when saving traces / globe_history | 3000 |
|
READSB_MAX_RANGE |
Optional. Maximum range (in nautical miles). | 300 |
|
READSB_ENABLE_BIASTEE |
Set to any value to enable bias tee on supporting interfaces | Unset | |
READSB_RX_LOCATION_ACCURACY |
Accuracy of receiver location in metadata: 0=no location, 1=approximate, 2=exact | --rx-location-accuracy=<n> |
2 |
READSB_HEATMAP_INTERVAL |
Per plane interval for heatmap and replay (if you want to lower this, also lower json-trace-interval to this or a lower value) | --heatmap=<sec> |
15 |
READSB_MAX_RANGE |
Absolute maximum range for position decoding (in nm) | --max-range=<dist> |
300 |
READSB_STATS_EVERY |
Number of seconds between showing and resetting stats. | --stats-every=<sec> |
Unset |
READSB_STATS_RANGE |
Set this to any value to collect range statistics for polar plot. | --stats-range |
Unset |
READSB_RANGE_OUTLINE_HOURS |
Change which past timeframe the range outline is based on | --range-outline-hours |
24 |
READSB_EXTRA_ARGS |
Optional, allows to specify extra parameters for readsb | Unset | |
S6_SERVICES_GRACETIME |
Optional, set to 30000 when saving traces / globe_history | 3000 |
READSB_EXTRA_ARGS
just passes arguments to the commandline, you can check this file for more options for wiedehofp's readsb fork: https://github.com/wiedehopf/readsb/blob/dev/help.h
Getting ADSB data to the Ultrafeeder
There are two ways to provide ADSB data to the Ultrafeeder:
- provide the container with access to a SDR or other hardware device that collects ADSB data
- allow the container to connect to a ADSB data source in Beast, Raw, or SBS format
These methods are not mutually exclusive - you can use both at the same time if you want.
Connecting to a SDR or other hardware device
If you want to connect your SDR to the container, here's how to do that:
Mandatory parameters
Variable | Description | Controls which readsb option |
Default |
---|---|---|---|
READSB_DEVICE_TYPE |
If using an SDR, set this to rtlsdr , modesbeast , gnshulc depending on the model of your SDR. If not using an SDR, leave un-set. |
--device-type=<type> |
Unset |
READSB_RTLSDR_DEVICE |
Select device by serial number. | --device=<serial> |
Unset |
READSB_BEAST_SERIAL |
only when type modesbeast or gnshulc is used: Path to Beast serial device. |
--beast-serial=<path> |
/dev/ttyUSB0 |
Optional/Additional Parameters
Variable | Description | Controls which readsb option |
Default |
---|---|---|---|
READSB_GAIN |
Set gain (in dB). Use autogain to have the container determine an appropriate gain, more on this below. |
--gain=<db> |
Max gain |
READSB_RTLSDR_PPM |
Set oscillator frequency correction in PPM. See Estimating PPM | --ppm=<correction> |
Unset |
Connecting to external ADSB data sources
In addition to (or instead of) connecting to a SDR or hardware device to get ADSB data, the container also supports ingesting data from a TCP port. Here are some parameters that you need to configure if you want to make this happen:
Mandatory parameters
Environment Variable | Purpose | Default |
---|---|---|
BEASTHOST |
IP/Hostname of a Mode-S/Beast provider (dump1090 /readsb ) |
|
BEASTPORT |
TCP port number of Mode-S/Beast provider (dump1090 /readsb ) |
30005 |
MLATHOST |
Legacy parameter. IP/Hostname of an MLAT provider (mlat-client ). Note - using this parameter will not make the MLAT data part of the consolidated mlathub. The preferred way of ingesting MLAT results is using the mlathub functionality of the container, see below for details |
|
MLATPORT |
Legacy parameter used with MLATHOST . TCP port number of an MLAT provider (mlat-client ) |
30105 |
Alternate Configuration Method with READSB_NET_CONNECTOR
Instead of (or in addition to) using BEASTHOST
, you can also define ADSB data ingests using the READSB_NET_CONNECTOR
parameter. This is the preferred way if you have multiple sources or destinations for your ADSB data. This variable allows you to configure outgoing connections. The variable takes a semicolon (;
) separated list of ip,port,protocol
, where:
ip
is an IP address. Specify an IP/hostname/containername for outgoing connections.port
is a TCP port numberprotocol
can be one of the following:beast_out
: Beast-format outputbeast_reduce_out
: Beast-format output using reduced reporting frequenciesbeast_reduce_plus_out
: Likebeast_reduce_out
, but including UUID for use by aggregators like adsb.lol/one/fi, etc.beast_in
: Beast-format inputraw_out
: Raw outputraw_in
: Raw inputsbs_out
: SBS-format outputvrs_out
: SBS-format output
NOTE: If you have a UAT dongle and use dump978
to decode this, you should use READSB_NET_CONNECTOR
to ingest UAT data from dump978
. See example below
environment:
...
- READSB_NET_CONNECTOR=dump978,37981,raw_in;another-data-aggregator.com,30005,beast_reduce_plus_out
...
Optional Networking Parameters
There are many optional parameters relating to the ingestion of data and the general networking functioning of the readsb
program that implements this functionality.
Variable | Description | Controls which readsb option |
Default |
---|---|---|---|
READSB_NET_API_PORT |
https://github.com/wiedehopf/readsb/blob/dev/README-json.md#--net-api-port-query-formats | --net-api-port=<ports> |
30152 |
READSB_NET_BEAST_REDUCE_INTERVAL |
BeastReduce position update interval, longer means less data (valid range: 0.000 - 14.999 ) |
--net-beast-reduce-interval=<seconds> |
0.125 |
READSB_NET_BEAST_REDUCE_FILTER_DIST |
Restrict beast-reduce output to aircraft in a radius of X nmi | --net-beast-reduce-filter-dist=<nmi> |
Unset |
READSB_NET_BEAST_REDUCE_FILTER_ALT |
Restrict beast-reduce output to aircraft below X ft | --net-beast-reduce-filter-alt=<ft> |
Unset |
READSB_NET_BEAST_REDUCE_OUT_PORT |
TCP BeastReduce output listen ports (comma separated) | --net-beast-reduce-out-port=<ports> |
Unset |
READSB_NET_BEAST_INPUT_PORT |
TCP Beast input listen ports | --net-bi-port=<ports> |
30004,30104 |
READSB_NET_BEAST_OUTPUT_PORT |
TCP Beast output listen ports | --net-bo-port=<ports> |
30005 |
READSB_NET_BUFFER |
TCP buffer size 64Kb * (2^n) | --net-buffer=<n> |
2 (256Kb) |
READSB_NET_RAW_OUTPUT_INTERVAL |
TCP output flush interval in seconds (maximum interval between two network writes of accumulated data). | --net-ro-interval=<rate> |
0.05 |
READSB_NET_RAW_OUTPUT_SIZE |
TCP output flush size (maximum amount of internally buffered data before writing to network). | --net-ro-size=<size> |
1200 |
READSB_NET_CONNECTOR_DELAY |
Outbound re-connection delay. | --net-connector-delay=<seconds> |
30 |
READSB_NET_HEARTBEAT |
TCP heartbeat rate in seconds (0 to disable). | --net-heartbeat=<rate> |
60 |
READSB_NET_RAW_INPUT_PORT |
TCP raw input listen ports. | --net-ri-port=<ports> |
30001 |
READSB_NET_RAW_OUTPUT_PORT |
TCP raw output listen ports. | --net-ro-port=<ports> |
30002 |
READSB_NET_SBS_INPUT_PORT |
TCP BaseStation input listen ports. | --net-sbs-in-port=<ports> |
Unset |
READSB_NET_SBS_OUTPUT_PORT |
TCP BaseStation output listen ports. | --net-sbs-port=<ports> |
30003 |
REASSB_NET_VERBATIM |
Set this to any value to forward messages unchanged. | --net-verbatim |
Unset |
READSB_NET_VRS_PORT |
TCP VRS JSON output listen ports. | --net-vrs-port=<ports> |
Unset |
READSB_WRITE_STATE_ONLY_ON_EXIT |
if set to anything, it will only write the status range outlines, etc. upon termination of readsb |
--write-state-only-on-exit |
Unset |
READSB_JSON_INTERVAL |
Update interval for the webinterface in seconds / interval between aircraft.json writes | --write-json-every=<sec> |
1.0 |
READSB_JSON_TRACE_INTERVAL |
Per plane interval for json position output and trace interval for globe history | --json-trace-interval=<sec> |
15 |
Web Gui (tar1090
) Configuration
The Container creates an interactive web interface displaying the aircraft, based on Wiedehopf's widely used tar1090 software.
The web interface is rendered to port 80
in the container. This can me mapped to a port on the host using the docker-compose ports
directive.
All of the variables below are optional.
tar1090
Core Configuration
Environment Variable | Purpose | Default |
---|---|---|
READSB_JSON_INTERVAL |
Update data update interval for the webinterface in seconds | 1.0 |
UPDATE_TAR1090 |
At startup update tar1090 and tar1090db to the latest versions | true |
INTERVAL |
Interval at which the track history is saved | 8 |
HISTORY_SIZE |
How many points in time are stored in the track history | 450 |
ENABLE_978 |
Change to yes to enable UAT/978 display in tar1090 . This will also enable UAT-specific graphs in graphs1090 |
no |
URL_978 |
The URL needs to point at where you would normally find the skyview978 webinterface, for example http://192.168.0.29/skyaware978 . Note -- do not use localhost or `127.0.0.1 |
|
GZIP_LVL |
1 -9 are valid, lower lvl: less CPU usage, higher level: less network bandwidth used when loading the page |
3 |
PTRACKS |
Shows the last $PTRACKS hours of traces you have seen at the ?pTracks URL |
8 |
TAR1090_FLIGHTAWARELINKS |
Set to any value to enable FlightAware links in the web interface | null |
TAR1090_ENABLE_AC_DB |
Set to true to enable extra information, such as aircraft type and registration, to be included in in aircraft.json output. Will use more memory; use caution on older Pis or similar devices. |
false |
HEYWHATSTHAT_PANORAMA_ID |
Your heywhatsthat.com panorama ID. See https://github.com/wiedehopf/tar1090#heywhatsthatcom-range-outline |
|
HEYWHATSTHAT_ALTS |
Comma separated altitudes for multiple outlines. Use no units or ft for feet, m for meters, or km for kilometers. Only integer numbers are accepted, no decimals please |
12192m (=40000 ft) |
HTTP_ACCESS_LOG |
Optional. Set to true to display HTTP server access logs. |
false |
HTTP_ERROR_LOG |
Optional. Set to false to hide HTTP server error logs. |
true |
- For documentation on the aircraft.json format see this page: https://github.com/wiedehopf/readsb/blob/dev/README-json.md
- TAR1090_ENABLE_AC_DB causes readsb to load the tar1090 database as a csv file from this repository: https://github.com/wiedehopf/tar1090-db/tree/csv
tar1090
config.js
Configuration - Title
Environment Variable | Purpose | Default |
---|---|---|
TAR1090_PAGETITLE |
Set the tar1090 web page title | tar1090 |
TAR1090_PLANECOUNTINTITLE |
Show number of aircraft in the page title | false |
TAR1090_MESSAGERATEINTITLE |
Show number of messages per second in the page title | false |
tar1090
config.js
Configuration - Output
Environment Variable | Purpose | Default |
---|---|---|
TAR1090_DISPLAYUNITS |
The DisplayUnits setting controls whether nautical (ft, NM, knots), metric (m, km, km/h) or imperial (ft, mi, mph) units are used in the plane table and in the detailed plane info. Valid values are "nautical ", "metric ", or "imperial ". |
nautical |
tar1090
config.js
Configuration - Map Settings
Environment Variable | Purpose | Default |
---|---|---|
TAR1090_BINGMAPSAPIKEY |
Provide a Bing Maps API key to enable the Bing imagery layer. You can obtain a free key (with usage limits) at https://www.bingmapsportal.com/ (you need a "basic key"). | null |
TAR1090_DEFAULTCENTERLAT |
Default center (latitude) of the map. This setting is overridden by any position information provided by dump1090/readsb. All positions are in decimal degrees. | 45.0 |
TAR1090_DEFAULTCENTERLON |
Default center (longitude) of the map. This setting is overridden by any position information provided by dump1090/readsb. All positions are in decimal degrees. | 9.0 |
TAR1090_DEFAULTZOOMLVL |
The google maps zoom level, 0 - 16 , lower is further out. |
7 |
TAR1090_SITESHOW |
Center marker. If dump1090 provides a receiver location, that location is used and these settings are ignored. Set to true to show a center marker. |
false |
TAR1090_SITELAT |
Center marker. If dump1090 provides a receiver location, that location is used and these settings are ignored. Position of the marker (latitude). | 45.0 |
TAR1090_SITELON |
Center marker. If dump1090 provides a receiver location, that location is used and these settings are ignored. Position of the marker (longitude). | 9.0 |
TAR1090_SITENAME |
The tooltip of the center marker. | My Radar Site |
TAR1090_RANGE_OUTLINE_COLOR |
Colour for the range outline. | #0000DD |
TAR1090_RANGE_OUTLINE_WIDTH |
Width for the range outline. | 1.7 |
TAR1090_RANGE_OUTLINE_COLORED_BY_ALTITUDE |
Range outline is coloured by altitude. | false |
TAR1090_RANGE_OUTLINE_DASH |
Range outline dashing. Syntax [L, S] where L is the pixel length of the line, and S is the pixel length of the space. |
Unset |
TAR1090_ACTUAL_RANGE_OUTLINE_COLOR |
Colour for the actual range outline | #00596b |
TAR1090_ACTUAL_RANGE_OUTLINE_WIDTH |
Width of the actual range outline | 1.7 |
TAR1090_ACTUAL_RANGE_OUTLINE_DASH |
Dashed style for the actual range outline. Unset for solid line. [5,5] for a dashed line with 5 pixel lines and spaces in between |
Unset |
TAR1090_MAPTYPE_TAR1090 |
Which map is displayed to new visitors. Valid values for this setting are osm , esri , carto_light_all , carto_light_nolabels , carto_dark_all , carto_dark_nolabels , gibs , osm_adsbx , chartbundle_sec , chartbundle_tac , chartbundle_hel , chartbundle_enrl , chartbundle_enra , chartbundle_enrh , and only with bing key bing_aerial , bing_roads . |
carto_light_all |
TAR1090_MAPDIM |
Default map dim state, true or false. | true |
TAR1090_MAPDIMPERCENTAGE |
The percentage amount of dimming used if the map is dimmed, 0 -1 |
0.45 |
TAR1090_MAPCONTRASTPERCENTAGE |
The percentage amount of contrast used if the map is dimmed, 0 -1 |
0 |
TAR1090_DWDLAYERS |
Various map layers provided by the DWD geoserver can be added here. Preview and available layers. Multiple layers are also possible. Syntax: dwd:layer1,dwd:layer2,dwd:layer3 |
dwd:RX-Produkt |
TAR1090_LABELZOOM |
Displays aircraft labels only until this zoom level, 1 -15 (values >15 don't really make sense) |
|
TAR1090_LABELZOOMGROUND |
Displays ground traffic labels only until this zoom level, 1 -15 (values >15 don't really make sense) |
tar1090
config.js
Configuration - Range Rings
Environment Variable | Purpose | Default |
---|---|---|
TAR1090_RANGERINGS |
false to hide range rings |
true |
TAR1090_RANGERINGSDISTANCES |
Distances to display range rings, in miles, nautical miles, or km (depending settings value 'TAR1090_DISPLAYUNITS '). Accepts a comma separated list of numbers (no spaces, no quotes). |
100,150,200,250 |
TAR1090_RANGERINGSCOLORS |
Colours for each of the range rings specified in TAR1090_RANGERINGSDISTANCES . Accepts a comma separated list of hex colour values, each enclosed in single quotes (eg TAR1090_RANGERINGSCOLORS='#FFFFF','#00000' ). No spaces. |
Blank |
Configuring graphs1090
graphs1090
Environment Parameters
Variable | Description | Default |
---|---|---|
GRAPHS1090_DARKMODE |
If set to any value, graphs1090 will be rendered in "dark mode". |
Unset |
GRAPHS1090_RRD_STEP |
Interval in seconds to feed data into RRD files. | 60 |
GRAPHS1090_SIZE |
Set graph size, possible values: small , default , large , huge , custom . |
default |
GRAPHS1090_ALL_LARGE |
Make the small graphs as large as the big ones by setting to yes . |
no |
GRAPHS1090_FONT_SIZE |
Font size (relative to graph size). | 10.0 |
GRAPHS1090_MAX_MESSAGES_LINE |
Set to any value to draw a reference line at the maximum message rate. | Unset |
GRAPHS1090_LARGE_WIDTH |
Defines the width of the larger graphs. | 1096 |
GRAPHS1090_LARGE_HEIGHT |
Defines the height of the larger graphs. | 235 |
GRAPHS1090_SMALL_WIDTH |
Defines the width of the smaller graphs. | 619 |
GRAPHS1090_SMALL_HEIGHT |
Defines the height of the smaller graphs. | 324 |
GRAPHS1090_DISK_DEVICE |
Defines which disk device (mmc0 , sda , sdc , etc) is shown. Leave empty for default device |
Unset |
GRAPHS1090_ETHERNET_DEVICE |
Defines which (wired) ethernet device (eth0 , enp0s , etc) is shown. Leave empty for default device |
Unset |
GRAPHS1090_WIFI_DEVICE |
Defines which (wireless) WiFi device (wlan0 , wlp3s0 , etc) is shown. Leave empty for default device |
Unset |
GRAPHS1090_DISABLE |
Set to any value to disable the GRAPHS1090 web page | Unset |
ENABLE_AIRSPY |
Optional, set to any non-empty value if you want to enable the special AirSpy graphs. See below for additional configuration requirements | Unset |
Enabling UAT data
ADS-B over UAT data is transmitted in the 978 MHz band, and this is used in the USA only. To display the corresponding graphs, you should:
- Set the following environment parameters:
- ENABLE_978=yes
- URL_978=http://dump978/skyaware978
- Install the
docker-dump978
container. Note - only containers downloaded/deployed on/after Feb 8, 2023 will work.
Note that you must configure URL_978
to point at a working skyaware978 website with aircraft.json
data feed. This means that the URL http://dump978/skyaware978/data/aircraft.json
must return valid JSON data to this tar1090
container.
Enabling AirSpy graphs
Users of AirSpy devices can enable extra graphs1090
graphs by configuring the following:
- Set the following environment parameter:
- ENABLE_AIRSPY=yes
- To provide the container access to the AirSpy statistics, map a volume in your
docker-compose.yml
file as follows:
volumes:
- /run/airspy_adsb:/run/airspy_adsb
...
Enabling Disk IO and IOPS data
To allow the container access to the Disk IO data, you should map the following volume:
volumes:
- /proc/diskstats:/proc/diskstats:ro
...
Configuring the Core Temperature graphs
By default, the system will use the temperature available at Thermal Zone 0. This generally works well on Raspberry Pi devices, and no additional changes are needed.
On different devices, the Core Temperature is mapped to a different Thermal Zone. To ensure the Core Temperature graph works, follow these steps
First check out which Thermal Zone contains the temperature you want to monitor. On your host system, do this:
for i in /sys/class/thermal/thermal_zone* ; do echo "$i - $(cat ${i}/type) - $(cat ${i}/temp 2>/dev/null)"; done
Something similar to this will be show:
/sys/class/thermal/thermal_zone0 - acpitz - 25000
/sys/class/thermal/thermal_zone1 - INT3400 Thermal - 20000
/sys/class/thermal/thermal_zone2 - TSKN - 43050
/sys/class/thermal/thermal_zone3 - NGFF - 32050
/sys/class/thermal/thermal_zone4 - TMEM - 39050
/sys/class/thermal/thermal_zone5 - pch_skylake - 40500
/sys/class/thermal/thermal_zone6 - B0D4 - 54050
/sys/class/thermal/thermal_zone7 - iwlwifi_1 -
/sys/class/thermal/thermal_zone8 - x86_pkg_temp - 57000
Repeat this a few times to ensure that the temperature varies and isn't hardcoded to a value. In our case, either Thermal Zone 5 (pch_skylake
is the Intel Core name) or Thermal Zone 8 (the temp of the entire SOC package) can be used. Once you have determined which Thermal Zone number you want to use, map it to a volume like this. Make sure that the part to the left of the first :
reflects your Thermal Zone directory; the part to the right of the first :
should always be /sys/class/thermal/thermal_zone0:ro
.
Note that you will have to add - privileged: true
capabilities to the container. This is less than ideal as it will give the container access to all of your system devices and processes. Make sure you feel comfortable with this before you do this.
privileged: true
volumes:
- /sys/class/thermal/thermal_zone8:/sys/class/thermal/thermal_zone0:ro
...
Note - on some systems (DietPi comes to mind), /sys/class/thermal/
may not be available.
timelapse1090
Configuration
Legacy: We recommend AGAINST enabling this feature as it has been replaced with http://dockerhost:port/?replay. timelapse1090
writes a lot of data to disk, which could shorten the lifespan of your Raspiberry Pi SD card. The replacement functionality is better and doesn't cause any additional disk writes.
Environment Variable | Purpose | Default |
---|---|---|
ENABLE_TIMELAPSE1090 |
Optional / Legacy. Set to any value to enable timelapse1090. Once enabled, can be accessed via http://dockerhost:port/timelapse/ | Unset |
TIMELAPSE1090_INTERVAL |
Snapshot interval in seconds | 10 |
TIMELAPSE1090_HISTORY |
Time saved in hours | 24 |
Paths
No paths need to be mapped through to persistent storage. However, if you don't want to lose your range outline and aircraft tracks/history and heatmap / replay data on container restart, you can optionally map these paths:
Path | Purpose |
---|---|
/opt/adsb/ultrafeeder/globe_history:/var/globe_history |
Holds range outline data, heatmap / replay data and traces if enabled. |
Note: this data won't be automatically deleted, you will need to delete it eventually if you map this path. | |
/opt/adsb/ultrafeeder/timelapse1090:/var/timelapse1090 |
Holds timelapse1090 data if enabled. (We recommend against enabling this feature, see above) |
/opt/adsb/ultrafeeder/collectd:/var/lib/collectd |
Holds graphs1090 & performance data |
/proc/diskstats:/proc/diskstats:ro |
Makes disk statistics available to graphs1090 |
/sys/class/thermal/thermal_zone8:/sys/class/thermal/thermal_zone0:ro |
Only needed on some systems to display the CPU temperature in graphs1090 , see here |
Configuring the built-in MLAT Hub
An "MLAT Hub" is an aggregator of MLAT results from several sources. Since the container is capable of sending MLAT data to multiple ADSB aggregators (like adsb.lol/fi/one, etc), we built in a capability to:
- collect the MLAT results from all of these services
- feed them back to the built-in
tar1090
graphical interface - ingest MLAT results from other containers (FlightAware, Radarbox, etc.)
- make the consolidated MLAT results available on a port in Beast or SBS (BaseStation) format
- create outbound connections using any supported format to send your Beast data wherever you want
Generally, there is little to configure, but there are a few parameters that you can set or change:
Variable | Description | Default if omitted |
---|---|---|
MLATHUB_SBS_OUT_PORT |
TCP port where the consolidated MLAT results will be available in SBS (BaseStation) format | 31003 |
MLATHUB_BEAST_IN_PORT |
TCP port you where you can send additional MLAT results to, in Beast format | 31004 |
MLATHUB_BEAST_OUT_PORT |
TCP port where consolidated MLAT results will be available in Beast format | 31005 |
MLATHUB_NET_CONNECTOR |
List of semi-colon separated IP or host, port, and protocols where MLATHUB will connect to ingest or send MLAT data. It follows the same syntax as described in the READSB_NET_CONNECTOR syntax section above. |
Unset |
Message decoding introspection
You can look at individual messages and what information they contain, either for all or for an individual aircraft by hex:
# only for hex 3D3ED0
docker exec -it adsb-superfeeder /usr/local/bin/viewadsb --show-only 3D3ED0
# for all aircraft
docker exec -it adsb-superfeeder /usr/local/bin/viewadsb --no-interactive
# show position / CPR debugging for hex 3D3ED0
docker exec -it adsb-superfeeder /usr/local/bin/viewadsb --cpr-focus 3D3ED0
Logging
All logs are to the container's stdout and can be viewed with docker logs -t [-f] container
.
Getting help
Please feel free to open an issue on the project's GitHub.
We also have a Discord channel, feel free to join and converse.