mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-04 10:24:02 +00:00
1fc795577a
Adds a Local ADS-B layer fed by your own receivers: a browser WebUSB RTL-SDR (with FM listening) and local 1090/978 MHz decoder feeds (LOCAL_RECEIVER_FEEDS, local and private addresses only). Local aircraft draw in magenta with class, silhouettes, 3D models, trails and a position sanity filter; the click card names the band and input that heard them. Builds on Sameh Khamis's SDR prototype and the initial GEV port by Mazeyar Moeini Feizabadi (#134); the decoder-feed design follows the notes on #57. Closes #57. Co-authored-by: Sameh Khamis <[email protected]> Co-authored-by: Mazeyar Moeini Feizabadi <[email protected]>
83 lines
3.9 KiB
Markdown
83 lines
3.9 KiB
Markdown
# Local receivers
|
|
|
|
The Local ADS-B layer draws aircraft heard by your own receivers. It has two
|
|
inputs, and it can use both at once.
|
|
|
|
| Input | What it is | Bands |
|
|
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
|
|
| Browser SDR | A USB RTL-SDR opened by the browser through WebUSB (Radio panel, Local RTL-SDR card). Decoding runs in the page. | 1090 MHz |
|
|
| Decoder feed | The `aircraft.json` served by a decoder you run: dump1090-fa, readsb or tar1090 (1090 MHz), or dump978-fa + skyaware978 (978 MHz). | 1090 MHz, 978 MHz UAT |
|
|
|
|
Aircraft from both inputs are merged by ICAO address. The newest position
|
|
wins, and the click card names every band and source that heard the aircraft
|
|
in the last 60 s. Aircraft heard only on 978 MHz UAT draw with a thin ring.
|
|
|
|
Local aircraft usually lead their public twins. The public Flights layer
|
|
renders positions about one poll interval (~30 s) behind so it can interpolate
|
|
smoothly between fixes, while local receiver aircraft are shown as heard. An
|
|
aircraft in both layers therefore draws twice, the magenta local marker ahead
|
|
of the public one; both markers are drawn on purpose.
|
|
|
|
## Which to use
|
|
|
|
- **One plain RTL-SDR dongle, desktop Chrome or Edge:** use the browser SDR.
|
|
Nothing else to install.
|
|
- **A dual-band board, a Raspberry Pi feeder, or a dongle already used by a
|
|
decoder:** use a decoder feed. A USB dongle can be opened by only one program
|
|
at a time, so a dongle that dump1090 or dump978 owns cannot also be opened by
|
|
the browser.
|
|
|
|
## Configuring feeds
|
|
|
|
Feeds are set in the server environment only (`.env`), never in the browser:
|
|
|
|
```sh
|
|
LOCAL_RECEIVER_FEEDS=1090=http://localhost:8080/data/aircraft.json,978=http://localhost:8978/data/aircraft.json
|
|
```
|
|
|
|
Each entry is `band=url`, where `band` is `1090` or `978`. The URL must:
|
|
|
|
- use `http` or `https`;
|
|
- point at loopback, a private (RFC1918) address, `localhost` or a `*.local`
|
|
name. Public addresses, link-local addresses (including `169.254.169.254`),
|
|
IPv6 and other host names are refused;
|
|
- have a path ending in `aircraft.json`, with no credentials, query or
|
|
fragment.
|
|
|
|
An entry that breaks a rule is logged when the server starts, shown as
|
|
`invalid` and never fetched. Restart the server after changing the value.
|
|
|
|
The server reads every feed about once a second while the Local ADS-B layer is
|
|
on. A feed is `live`, `stale` (its own `now` is more than 10 s old, usually a
|
|
stopped decoder), `unreachable` or `invalid`. The Layers panel row and the
|
|
Local RTL-SDR card show these states.
|
|
|
|
## Example: dump1090-fa and dump978-fa on macOS or Linux
|
|
|
|
Write each decoder's JSON to a directory, then serve the directory on
|
|
localhost. Each command keeps running, so start each in its own terminal:
|
|
|
|
```sh
|
|
# 1090 MHz
|
|
dump1090-fa --device-index 0 --write-json /tmp/adsb1090
|
|
python3 -m http.server 8080 --bind 127.0.0.1 --directory /tmp/adsb1090
|
|
|
|
# 978 MHz UAT: dump978-fa decodes, skyaware978 writes aircraft.json
|
|
dump978-fa --sdr driver=rtlsdr,rtl=1 --raw-port 30978
|
|
skyaware978 --connect localhost:30978 --json-dir /tmp/adsb978
|
|
python3 -m http.server 8978 --bind 127.0.0.1 --directory /tmp/adsb978
|
|
```
|
|
|
|
```sh
|
|
LOCAL_RECEIVER_FEEDS=1090=http://localhost:8080/aircraft.json,978=http://localhost:8978/aircraft.json
|
|
```
|
|
|
|
A board with two identical-serial channels, such as the Nooelec FlyCatcher,
|
|
cannot be told apart by serial number. Select each channel by index:
|
|
`--device-index <n>` for dump1090-fa and `--sdr driver=rtlsdr,rtl=<n>` for
|
|
dump978-fa. `rtl_test` lists the indexes.
|
|
|
|
A tar1090 or readsb install on a Raspberry Pi already serves
|
|
`http://<pi-address>/tar1090/data/aircraft.json`. Use the Pi's private address
|
|
or its `.local` name.
|