readme update and some TODO ideas
This commit is contained in:
nzkarit
parent
013589f395
commit
cc2c2d8079
@ -62,6 +62,9 @@ def argParser():
|
||||
parser.add_argument('-r', '--repeats', action='store', dest='repeats', type=int, default=cfg.getint('general', 'repeats'), help='How many repeats of the data to perform. Default: %(default)s')
|
||||
parser.add_argument('--csv', '--csvfile', '--in', '--input', action='store', type=str, default=cfg.get('general', 'csvfile'), dest='csvfile', help='Import a CSV file with the plane data in it. Default: %(default)s')
|
||||
# TODO Make it so it can do a static checksum
|
||||
# TODO Get pause between messages
|
||||
# TODO Get pause between repeats
|
||||
# TODO Do a pause function
|
||||
return parser.parse_args()
|
||||
|
||||
def singlePlane(arguments):
|
||||
|
||||
64
README.md
64
README.md
@ -1,3 +1,5 @@
|
||||
Firstly if you use this code or are doing anything with ADS-B broadcast, I would be interested in hearing what you are up to. Get in touch on @nzkarit on twitter or adsb (AT) karit [dot] nz
|
||||
|
||||
# "ADS-B Out" add-on for SoftRF-Emu, Stratux, etc...
|
||||
|
||||
This repository contains "ADS-B Out" encoder for Tx-capable SDR hardware.
|
||||
@ -11,59 +13,73 @@ The source code is published for academic purpose only.
|
||||
## Instructions
|
||||
1. Execute *ADSB_Encoder.py* all the options have defaults so none are needed to generate with defaults. Running help will show you the optiosn you can change:
|
||||
```
|
||||
$ ADSB_Encoder.py
|
||||
$ ./ADSB_Encoder.py
|
||||
|
||||
$ ADSB_Encoder.py -h
|
||||
Usage: ADSB_Encoder.py [options]
|
||||
$ ./ADSB_Encoder.py -h
|
||||
usage: ADSB_Encoder.py [-h] [-i ICAO] [--lat LATITUDE] [--lon LONGITUDE]
|
||||
[-a ALTITUDE] [--ca CAPABILITY] [--tc TYPECODE]
|
||||
[--ss SURVEILLANCESTATUS] [--nicsb NICSUPPLEMENTB]
|
||||
[--time TIME] [-s SURFACE] [-o OUTPUTFILENAME]
|
||||
[-r REPEATS] [--csv CSVFILE]
|
||||
|
||||
Options:
|
||||
This tool will generate ADS-B data in a form that a hackRF can broadcast. In
|
||||
addition to providing the information at the command the defaults can be
|
||||
changed in the config.cfg file and the the loggin config changed in
|
||||
logging.cfg.
|
||||
|
||||
optional arguments:
|
||||
-h, --help show this help message and exit
|
||||
-i ICAO, --icao=ICAO The ICAO number for the plane in hex. Ensure the ICAO
|
||||
-i ICAO, --icao ICAO The ICAO number for the plane in hex. Ensure the ICAO
|
||||
is prefixed with '0x' to ensure this is parsed as a
|
||||
hex number. Default: 0xABCDEF
|
||||
--lat=LATITUDE, --latitude=LATITUDE
|
||||
--lat LATITUDE, --latitude LATITUDE
|
||||
Latitude for the plane in decminal degrees. Default:
|
||||
12.34
|
||||
--lon=LONGITUDE, --long=LONGITUDE, --longitude=LONGITUDE
|
||||
--lon LONGITUDE, --long LONGITUDE, --longitude LONGITUDE
|
||||
Longitude for the place in decminal degrees. Default:
|
||||
56.78
|
||||
-a ALTITUDE, --alt=ALTITUDE, --altitude=ALTITUDE
|
||||
-a ALTITUDE, --alt ALTITUDE, --altitude ALTITUDE
|
||||
Altitude in decminal feet. Default: 9876.5
|
||||
--ca=CAPABILITY, --capability=CAPABILITY
|
||||
--ca CAPABILITY, --capability CAPABILITY
|
||||
The capability. (Think this is always 5 from ADSB
|
||||
messages. More info would be appreciate). Default: 5
|
||||
--tc=TYPECODE, --typecode=TYPECODE
|
||||
messages. More info would be appreciate). Default: 5
|
||||
--tc TYPECODE, --typecode TYPECODE
|
||||
The type for the ADSB messsage. See https://adsb-
|
||||
decode-guide.readthedocs.io/en/latest/content/introduc
|
||||
tion.html#ads-b-message-types for more information.
|
||||
Default: 11
|
||||
--ss=SURVEILLANCESTATUS, --surveillancestatus=SURVEILLANCESTATUS
|
||||
--ss SURVEILLANCESTATUS, --surveillancestatus SURVEILLANCESTATUS
|
||||
The surveillance status. (Think this is always 0 from
|
||||
ADSB messages. More info would be appreciate).
|
||||
Default: 0
|
||||
--nicsb=NICSUPPLEMENTB, --nicsupplementb=NICSUPPLEMENTB
|
||||
The NIC supplement-B.(Think this is always 0 from
|
||||
ADSB messages. More info would be appreciate).
|
||||
Default: 0
|
||||
--time=TIME The time. (Think this is always 0 from ADSB messages.
|
||||
More info would be appreciate). Default: 0
|
||||
-s SURFACE, --surface=SURFACE
|
||||
--nicsb NICSUPPLEMENTB, --nicsupplementb NICSUPPLEMENTB
|
||||
The NIC supplement-B.(Think this is always 0 from ADSB
|
||||
messages. More info would be appreciate). Default: 0
|
||||
--time TIME The time. (Think this is always 0 from ADSB messages.
|
||||
More info would be appreciate). Default: 0
|
||||
-s SURFACE, --surface SURFACE
|
||||
If the plane is on the ground or not. Default: False
|
||||
-o OUTPUTFILENAME, --out=OUTPUTFILENAME, --output=OUTPUTFILENAME
|
||||
-o OUTPUTFILENAME, --out OUTPUTFILENAME, --output OUTPUTFILENAME
|
||||
The iq8s output filename. This is the file which you
|
||||
will feed into the hackRF. Default: Samples_256K.iq8s
|
||||
-r REPEATS, --repeats REPEATS
|
||||
How many repeats of the data to perform. Default: 1
|
||||
--csv CSVFILE, --csvfile CSVFILE, --in CSVFILE, --input CSVFILE
|
||||
Import a CSV file with the plane data in it. Default:
|
||||
|
||||
```
|
||||
2. Transmit the signal into air:
|
||||
```
|
||||
$ hackrf_transfer -t Samples_256K.iq8s -f 868000000 -s 2000000 -x 10
|
||||
$ hackrf_transfer -t Samples_256K.iq8s -f 915000000 -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)
|
||||
call hackrf_set_freq(915000000 Hz/915.000 MHz)
|
||||
Stop with Ctrl-C
|
||||
3.9 MiB / 1.000 sec = 3.9 MiB/second
|
||||
0.5 MiB / 1.000 sec = 0.5 MiB/second
|
||||
|
||||
User cancel, exiting...
|
||||
Total time: 1.00038 s
|
||||
Total time: 2.00039 s
|
||||
hackrf_stop_tx() done
|
||||
hackrf_close() done
|
||||
hackrf_exit() done
|
||||
@ -77,7 +93,7 @@ $
|
||||
* -x is the gain
|
||||
## Validation
|
||||
```
|
||||
$ sudo dump1090 --net --freq 868000000
|
||||
$ sudo ./dump1090 --net --freq 915000000
|
||||
...
|
||||
```
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user