| description |
|---|
The "readsb" container is the heart of our "adsb" application. It receives 1090MHz ADS-B ES RF signals from your SDR, and demodulates ADS-B messages, making them available for all other containers. |
In your favourite text editor, create a file named docker-compose.yml in your application directory (/opt/adsb) if following along verbatim.
sudo nano docker-compose.ymlversion: '3.8'
volumes:
readsbpb_rrd:
readsbpb_autogain:
services:
readsb:
image: mikenye/readsb-protobuf:latest
tty: true
container_name: readsb
hostname: readsb
restart: always
devices:
- /dev/bus/usb
ports:
- 8080:8080
environment:
- TZ=${FEEDER_TZ}
- READSB_DEVICE_TYPE=rtlsdr
- READSB_RTLSDR_DEVICE=1090
- READSB_GAIN=autogain
- READSB_LAT=${FEEDER_LAT}
- READSB_LON=${FEEDER_LONG}
- READSB_RX_LOCATION_ACCURACY=2
- READSB_STATS_RANGE=true
- READSB_NET_ENABLE=true
volumes:
- readsbpb_rrd:/run/collectd
- readsbpb_autogain:/run/autogainThe above will:
- Create two docker volumes,
readsbpb_rrdandreadsb_autogain, which are used to store the RRD files and autogain state files respectively. - Create a service named
readsbthat will run themikenye/readsb-protobufcontainer.- We're presenting the USB bus through to this container (so
readsbcan talk to the USB-attached SDR). - We're mapping TCP port
8080through to the container so we can access the web interface. - We're passing several environment variables through, including our timezone, latitude and longitude from the
.envfile (denoted by${VARIABLE}).
- We're presenting the USB bus through to this container (so
Once this file is created, issue the command sudo docker-compose up -d to bring up the environment.
sudo docker-compose up -dYou should see the following output:
Creating network "adsb_default" with the default driver
Creating readsb ... done
We can view the logs for the environment with the command docker-compose logs, or continually "tail" them with docker-compose logs -f. At this stage, the logs will be fairly unexciting and look like this:
[s6-init] making user provided files available at /var/run/s6/etc...exited 0.
[s6-init] ensuring user provided files have correct perms...exited 0.
[fix-attrs.d] applying ownership & permissions fixes...
[fix-attrs.d] done.
[cont-init.d] executing container initialization scripts...
[cont-init.d] 01-timezone: executing...
[cont-init.d] 01-timezone: exited 0.
[cont-init.d] 02-sanity-check: executing...
[cont-init.d] 02-sanity-check: exited 0.
[cont-init.d] 03-initialise-gain: executing...
[cont-init.d] 03-initialise-gain: exited 0.
[cont-init.d] 04-telegraf: executing...
[cont-init.d] 04-telegraf: exited 0.
[cont-init.d] 05-rtlsdr-biastee: executing...
[cont-init.d] 05-rtlsdr-biastee: exited 0.
[cont-init.d] done.
[services.d] starting services
[services.d] done.
[readsb] 2020/11/09 13:23:47 Mon Nov 9 13:23:47 2020 AWST Mictronics v4.0.1 starting up.
[autogain] 2020/11/09 13:23:47 Entering auto-gain stage: init
[collectd] 2020/11/09 13:23:47 [2020-11-09 13:23:47] plugin_load: plugin "logfile" successfully loaded.
[readsb] 2020/11/09 13:23:47 rtlsdr: using device #0: Generic RTL2832U (Realtek, RTL2832U, SN 00001090)
[lighttpd] 2020/11/09 13:23:47 2020-11-09 13:23:47: (server.c.1464) server started (lighttpd/1.4.53)
[readsb] 2020/11/09 13:23:47 Found Rafael Micro R820T tuner
[readsb] 2020/11/09 13:23:47 rtlsdr: tuner gain set to 49.6 dB
We can see our container running with the command docker ps:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
f936a37dd488 mikenye/readsb-protobuf:latest "/init" 4 hours ago Up 2 hours (healthy) 0.0.0.0:8080->8080/tcp readsb
We can see the adsb_default network with the command docker network ls:
NETWORK ID NAME DRIVER SCOPE
2a4ef415c4d3 adsb_adsbnet bridge local
We can see the adsb_readsbpb_* volumes with the command docker volume ls:
DRIVER VOLUME NAME
local adsb_readsbpb_autogain
local adsb_readsbpb_rrd
To see the data being received and decoded by our new container, run the command docker exec -it readsb viewadsb. This should display a real-time departure-lounge-style screen showing all the aircraft being tracked, for example:
Hex Mode Sqwk Flight Alt Spd Hdg Lat Long RSSI Msgs Ti -
────────────────────────────────────────────────────────────────────────────────
7CF86F S 2061 BFRT22 10025 219 286 -31.871 116.586 -28.6 14 1
7C79CA S 1200 YCC 2975 126 152 -32.490 115.887 -28.2 68 0
7C79CB S 3000 YCD 1525 118 352 -32.221 115.948 -25.6 269 0
7C79D1 S 1200 YCJ 3575 113 185 -32.375 115.837 -29.2 289 1
7C79DB S 3000 YCT 1375 119 358 -32.176 115.940 -25.1 126 0
7C79DC S 1200 YCU 3000 96 229 -32.437 115.929 -28.5 260 5
7CF9E1 S 2055 1250 178 084 -29.8 18 0
7C822A S 3730 ZZW 1500 -23.5 258 0
7C7A3F S 1273 VOZ1485 grnd 0 -25.4 11 3
7C7A6E S 1200 YGW 2575 99 191 -32.296 115.813 -20.3 522 0
7C1ABD S 4265 UTY6071 33125 398 197 -30.535 116.638 -23.6 363 0
7C42D2 S 3664 NWK1663 grnd 59 239 -31.936 115.968 -21.6 258 12
7C1B35 S grnd 9 281 -28.3 4 15
7C1B3C S 4306 VOZ9224 34000 405 192 -30.804 116.239 -22.5 150 0
7C1C68 S 3646 FWA 5000 191 253 -31.803 116.299 -25.4 396 0
7C6CA2 S 3760 NWK1885 7825 239 193 -31.609 116.244 -13.1 509 0
7C6CA4 S 4035 NWK2873 3075 141 239 -31.846 116.143 -20.8 566 0
7C4518 S 1464 QJE1928 13225 437 037 -31.840 116.316 -10.7 516 0
7C0DAB S 3000 CZH 800 71 303 -32.085 115.923 -18.3 273 0
7C6DB5 S 36975 -31.8 11 32
7C3F19 S 4063 MQZ 1325 105 240 -31.898 116.043 -16.8 601 0
7C7F72 S -31.5 7 37
7C7796 S 4310 UTY734 34000 381 181 -30.327 116.639 -25.8 82 0
7CF7C4 S PHRX1A -20.3 22 1
7CF7C5 S PHRX1B -21.6 15 9
7CF7C6 S PHRX2A -21.3 15 1
7CF7C7 S PHRX2B -28.1 3 2
7C2FD6 S 4223 NWK2878 4025 212 176 -32.006 115.948 -2.1 831 0
Press CTRL-C to escape this screen.
You should also be able to point your web browser at http://docker.host.ip.addr:8080/ to view the web interface (change docker.host.ip.addr to the IP address of your docker host). You should see a map showing your currently tracked aircraft, and a link to the "Performance Graphs".