sdr-enthusiasts/airspy_adsb

Docker container running Airspy's airspy_adsb receiver. Designed to work in tandem with other sdr-enthusiasts containers. Builds and runs on x86_64, arm64 and arm32v7.

airspy_adsb receives ADS-B data, and provides a BEAST socket for other containers to consume BEAST data.

It will provide BEAST protocol on TCP port 30005.

Environment Variables

Environment Variable	`airspy_adsb` option	Description	Default
`AIRSPY_ADSB_SERIAL`	`-s`	Device serial number (add 0x at the start for hexadecimal serial numbers)	unset
`AIRSPY_ADSB_TIMEOUT`	`-t`	Aircraft timeout in seconds	`60`
`AIRSPY_ADSB_RF_GAIN`	`-g`	RF gain: `0` to `21` or `auto`	`auto`
`AIRSPY_ADSB_FEC_BITS`	`-f`	Forward Error Correction (FEC) bits	`1`
`AIRSPY_ADSB_PREAMBLE_FILTER`	`-e`	Preamble filter: `1` to `60`	`4`
`AIRSPY_ADSB_CPUTIME_TARGET`	`-C`	CPU processing time target (percentage): `5` to `95`	Disabled (adjusts preamble filter while running)
`AIRSPY_ADSB_PREAMBLE_FILTER_MAX`	`-E`	Maximum preamble filter when using CPU target: `1` to `60`	`60`
`AIRSPY_ADSB_PREAMBLE_FILTER_NONCRC`	`-P`	Non-CRC Preamble filter: `1` to `$AIRSPY_ADSB_PREAMBLE_FILTER`	Disabled
`AIRSPY_ADSB_WHITELIST_THRESHOLD`	`-w`	Whitelist threshold: `1` to `20`	`5`
`AIRSPY_ADSB_MLAT_FREQ`	`-m`	MLAT frequency in MHz: `12`, `20` or `24` (Airspy R2 only)	unset
`AIRSPY_ADSB_VERBATIM_MODE`	`-n`	Set to `true` to enable Verbatim mode	unset
`AIRSPY_ADSB_DX_MODE`	`-x`	Set to `true` to enable DX mode	unset
`AIRSPY_ADSB_REDUCE_IF_BW`	`-r`	Set to `true` reduce the IF bandwidth to 4 MHz	unset
`AIRSPY_ADSB_RSSI_MODE`	`-R`	RSSI mode: `snr` (ref = 42 dB), `rms` (default: rms)	`rms`
`AIRSPY_ADSB_IGNORE_DF_TYPES`	`-D`	Ignore these DF types (comma separated list)	`24,25,26,27,28,29,30,31`
`AIRSPY_ADSB_BIAS_TEE`	`-b`	Set to `true` to enable Bias-Tee	unset
`AIRSPY_ADSB_BIT_PACKING`	`-p`	Set to `true` to enable Bit Packing	unset
`AIRSPY_ADSB_VERBOSE`	`-v`	Enable Verbose mode	unset
`AIRSPY_ADSB_STATS`	`-S`	Set to `true` to enable statistics in `/run/airspy_adsb` (this needs to be shared with a `tar1090` instance)	unset
`AIRSPY_ADSB_ARCH`	N/A	Forces a specific architecture binary. Supports `arm64`, `armv7`, `arm`, `nehalem`, `x86_64` or `i386`. If unset, will auto-detect.	unset

Using with `ultrafeeder` container

Note: the airspy_adsb environment variables in the example below follow wiedehopf's recommended Airspy defaults

services:
  airspy_adsb:
    image: ghcr.io/sdr-enthusiasts/airspy_adsb:latest
    container_name: airspy_adsb
    hostname: airspy_adsb
    restart: always
    device_cgroup_rules:
      - 'c 189:* rwm'
    environment:
      - AIRSPY_ADSB_VERBOSE=true
      - AIRSPY_ADSB_TIMEOUT=90
      - AIRSPY_ADSB_FEC_BITS=1
      - AIRSPY_ADSB_WHITELIST_THRESHOLD=5
      - AIRSPY_ADSB_PREAMBLE_FILTER_NONCRC=8
      - AIRSPY_ADSB_CPUTIME_TARGET=60
      - AIRSPY_ADSB_PREAMBLE_FILTER_MAX=20
      - AIRSPY_ADSB_MLAT_FREQ=12
      - AIRSPY_ADSB_RF_GAIN=auto
      - AIRSPY_ADSB_STATS=true
    volumes:
      - /dev/bus/usb:/dev/bus/usb:ro
    tmpfs:
      - /run:exec,size=256M
      - /tmp:size=128M
      - /var/log:size=32M

  ultrafeeder:
    image: ghcr.io/sdr-enthusiasts/docker-adsb-ultrafeeder
    # Note - if you want to enable telegraf for use with InfluxDB/Prometheus and Grafana,
    # use the following image instead:
    # image: ghcr.io/sdr-enthusiasts/docker-adsb-ultrafeeder:telegraf
    container_name: ultrafeeder
    hostname: ultrafeeder
    restart: unless-stopped
    device_cgroup_rules:
      - "c 189:* rwm"
    ports:
      - 8080:80 # to expose the web interface
      # - 9273-9274:9273-9274 # to expose the statistics interface to Prometheus
    environment:
      # --------------------------------------------------
      # general parameters:
      - LOGLEVEL=error
      - TZ=${FEEDER_TZ}
      # --------------------------------------------------
      # SDR related parameters:
      ### Set readsb to net-only mode, since we're getting SDR data via BEAST from airspy_adsb
      - READSB_NET_ONLY=true
      # - READSB_DEVICE_TYPE=rtlsdr
      # - READSB_RTLSDR_DEVICE=${ADSB_SDR_SERIAL}
      # - READSB_RTLSDR_PPM=${ADSB_SDR_PPM}
      #
      # --------------------------------------------------
      # readsb/decoder parameters:
      - READSB_LAT=${FEEDER_LAT}
      - READSB_LON=${FEEDER_LONG}
      - READSB_ALT=${FEEDER_ALT_M}m
      ### Disable readsb gain, since airspy_adsb is handling that
      # - READSB_GAIN=${ADSB_SDR_GAIN}
      - READSB_RX_LOCATION_ACCURACY=2
      - READSB_STATS_RANGE=true
      #
      # --------------------------------------------------
      # Sources and Aggregator connections:
      # Notes - remove the ones you are not using / feeding
      ###     - "adsb,airspy_adsb,30005,beast_in;" is how ultrafeeder gets the BEAST feed out of airspy_adsb
      #       - remove "adsb,dump978,30978,uat_in;" if you don't have dump978 and a UAT dongle connected to your station
      #       - !!! make sure that each line ends with a semicolon ";",  with the exception of the last line which shouldn't have a ";" !!!
      - ULTRAFEEDER_CONFIG=
        adsb,airspy_adsb,30005,beast_in;
        adsb,dump978,30978,uat_in;
        adsb,feed.adsb.fi,30004,beast_reduce_plus_out;
        adsb,in.adsb.lol,30004,beast_reduce_plus_out;
        adsb,feed.airplanes.live,30004,beast_reduce_plus_out;
        adsb,feed.planespotters.net,30004,beast_reduce_plus_out;
        adsb,feed.theairtraffic.com,30004,beast_reduce_plus_out;
        adsb,data.avdelphi.com,24999,beast_reduce_plus_out;
        adsb,skyfeed.hpradar.com,30004,beast_reduce_plus_out;
        adsb,feed.radarplane.com,30001,beast_reduce_plus_out;
        adsb,dati.flyitalyadsb.com,4905,beast_reduce_plus_out;
        mlat,feed.adsb.fi,31090,39000;
        mlat,in.adsb.lol,31090,39001;
        mlat,feed.airplanes.live,31090,39002;
        mlat,mlat.planespotters.net,31090,39003;
        mlat,feed.theairtraffic.com,31090,39004;
        mlat,skyfeed.hpradar.com,31090,39005;
        mlat,feed.radarplane.com,31090,39006;
        mlat,dati.flyitalyadsb.com,30100,39007;
        mlathub,piaware,30105,beast_in;
        mlathub,rbfeeder,30105,beast_in;
        mlathub,radarvirtuel,30105,beast_in;
        mlathub,planewatch,30105,beast_in
      # If you really want to feed ADSBExchange, you can do so by adding this above:
      #        adsb,feed1.adsbexchange.com,30004,beast_reduce_plus_out,uuid=${ADSBX_UUID};
      #        mlat,feed.adsbexchange.com,31090,39008,uuid=${ADSBX_UUID}
      #
      # --------------------------------------------------
      - UUID=${MULTIFEEDER_UUID}
      - MLAT_USER=${FEEDER_NAME}
      #
      # --------------------------------------------------
      # TAR1090 (Map Web Page) parameters:
      - UPDATE_TAR1090=true
      - TAR1090_DEFAULTCENTERLAT=${FEEDER_LAT}
      - TAR1090_DEFAULTCENTERLON=${FEEDER_LONG}
      - TAR1090_MESSAGERATEINTITLE=true
      - TAR1090_PAGETITLE=${FEEDER_NAME}
      - TAR1090_PLANECOUNTINTITLE=true
      - TAR1090_ENABLE_AC_DB=true
      - TAR1090_FLIGHTAWARELINKS=true
      - HEYWHATSTHAT_PANORAMA_ID=${FEEDER_HEYWHATSTHAT_ID}
      - HEYWHATSTHAT_ALTS=${FEEDER_HEYWHATSTHAT_ALTS}
      - TAR1090_SITESHOW=true
      - TAR1090_RANGE_OUTLINE_COLORED_BY_ALTITUDE=true
      - TAR1090_RANGE_OUTLINE_WIDTH=2.0
      - TAR1090_RANGERINGSDISTANCES=50,100,150,200
      - TAR1090_RANGERINGSCOLORS='#1A237E','#0D47A1','#42A5F5','#64B5F6'
      - TAR1090_USEROUTEAPI=true
      #
      # --------------------------------------------------
      # GRAPHS1090 (Decoder and System Status Web Page) parameters:
      # The two 978 related parameters should only be included if you are running dump978 for UAT reception (USA only)
      - GRAPHS1090_DARKMODE=true
      # - ENABLE_978=yes
      # - URL_978=http://dump978/skyaware978
      ### Enable Airspy graphs and grab the data via http://airspy_adsb/stats.json
      - ENABLE_AIRSPY=true
      - URL_AIRSPY=http://airspy_adsb
      #
      # --------------------------------------------------
      # Prometheus and InfluxDB connection parameters:
      # (See above for the correct image tag you must use to enable this)
      # - INFLUXDBV2_URL=${INFLUX_URL}
      # - INFLUXDBV2_TOKEN=${INFLUX_TOKEN}
      # - INFLUXDBV2_BUCKET=${INFLUX_BUCKET}
      # - PROMETHEUS_ENABLE=true
    volumes:
      - /opt/adsb/ultrafeeder/globe_history:/var/globe_history
      - /opt/adsb/ultrafeeder/graphs1090:/var/lib/collectd
      - /proc/diskstats:/proc/diskstats:ro
    tmpfs:
      - /run:exec,size=256M
      - /tmp:size=128M
      - /var/log:size=32M

Name		Name	Last commit message	Last commit date
Latest commit History 86 Commits
.github		.github
rootfs		rootfs
.dictionary.txt		.dictionary.txt
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
Dockerfile		Dockerfile
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

sdr-enthusiasts/airspy_adsb

Environment Variables

Using with `ultrafeeder` container

About

Packages

Contributors 9

Languages

sdr-enthusiasts/airspy_adsb

Folders and files

Latest commit

History

Repository files navigation

sdr-enthusiasts/airspy_adsb

Environment Variables

Using with ultrafeeder container

About

Resources

Stars

Watchers

Forks

Packages 0

Contributors 9

Languages

Using with `ultrafeeder` container

Packages