adsb-out/README.md

58 lines
2.0 KiB
Markdown
Raw Normal View History

2017-06-15 21:53:42 +08:00
# "ADS-B Out" add-on for SoftRF-Emu, Stratux, etc...
This repository contains "ADS-B Out" encoder for Tx-capable SDR hardware.
2017-06-16 19:59:40 +08:00
It is currently written in architecture independent Python language and can be used as an add-on for existing
2017-06-15 21:53:42 +08:00
open source "ADS-B In" solutions. One known good example is [Stratux](https://github.com/cyoung/stratux).
2017-06-16 18:26:28 +08:00
## Disclaimer
2017-06-15 21:53:42 +08:00
The source code is published for academic purpose only.
2017-06-16 18:26:28 +08:00
## Instructions
1. Execute *ADSB_Encoder.py* script with `<ICAO>` `<Latitude>` `<Longtitude>` `<Altitude>` arguments:
```
$ ADSB_Encoder.py 0xABCDEF 12.34 56.78 9999.0
$ ls Samples.iq8s
Samples.iq8s
$
```
1. Transmit the signal into air:
2017-06-16 18:26:28 +08:00
```
$ hackrf_transfer -t Samples_256K.iq8s -f 868000000 -s 2000000 -x 10
call hackrf_sample_rate_set(2000000 Hz/2.000 MHz)
call hackrf_baseband_filter_bandwidth_set(1750000 Hz/1.750 MHz)
call hackrf_set_freq(868000000 Hz/868.000 MHz)
Stop with Ctrl-C
0.5 MiB / 1.000 sec = 0.5 MiB/second
User cancel, exiting...
Total time: 1.00038 s
hackrf_stop_tx() done
hackrf_close() done
hackrf_exit() done
fclose(fd) done
exit
$
```
2017-09-06 15:30:06 +08:00
* -t is the input file to transmit
* -f is the frequency in hertz. In the real world this would be 1090000000 but do not use that
* -s is the sample rate in hertz
* -x is the gain
2017-06-16 18:26:28 +08:00
## Validation
```
$ sudo dump1090 --net --freq 868000000
2017-06-16 18:26:28 +08:00
...
```
![](https://github.com/lyusupov/ADSB-Out/raw/master/documents/images/dump1090.JPG)
2017-06-16 18:26:28 +08:00
## References
2017-06-16 19:32:05 +08:00
1. "*Gr-Air-Modes*", **Nick Foster**, 2012
2017-06-17 06:31:19 +08:00
2. "*EXPLOITING THE AUTOMATIC DEPENDENT SURVEILLANCE BROADCAST SYSTEM VIA FALSE TARGET INJECTION*", **Domenic Magazu III**, 2012
2017-06-16 19:32:05 +08:00
3. "*ADS-B out by HACKRF and received over the air by rtl-sdr dongle and dump1090*", **Jiao Xianjun**, 2014
4. "*Ghost in the Air(Traffic): On insecurity of ADS-B protocol and practical attacks on ADS-B devices*", **Andrei Costin and Aurelien Francillon**, 2015
5. "*ADS-B Decoding Guide*", **Junzi Sun**, 2017
2017-06-16 19:29:14 +08:00
2017-09-05 17:16:02 +08:00
# History
This is a fork orginally from https://github.com/lyusupov/ADSB-Out in September 2017.