diff --git a/JAERO/LICENSE b/JAERO/LICENSE index 9a1e687..0baadf2 100644 --- a/JAERO/LICENSE +++ b/JAERO/LICENSE @@ -1,6 +1,6 @@ The MIT License (MIT) -Copyright (c) 2019 Jonathan Olds +Copyright (c) 2015-2019 Jonathan Olds Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/README.md b/README.md index 036da8d..1943936 100644 --- a/README.md +++ b/README.md @@ -6,15 +6,17 @@ A SatCom ACARS demodulator and decoder for the Aero standard written in C++ Qt This program demodulates and decodes ACARS messages sent from satellites to Aeroplanes (SatCom ACARS) commonly used when Aeroplanes are beyond VHF range. Demodulation is performed using the soundcard. Such signals are typically around 1.5Ghz and can be received with a simple low gain antenna that can be home brewed in a few hours in conjunction with a cheap [RTL-SDR] dongle. -SatCom ACARS signals are basically MSK like so the demodulator was forked from [JMSK]. The demodulator implements a coherent MSK demodulator type as seen at http://jontio.zapto.org/hda1/msk-demodulation2.html. +The 600 and 1200 bps SatCom ACARS signals are basically MSK like so the demodulator was forked from [JMSK]. The demodulator implements a coherent MSK demodulator type as seen at http://jontio.zapto.org/hda1/msk-demodulation2.html. The 600 and 1200 bps demodulator uses the technique that treats the signal similar to [OQPSK] but with sine wave transitions rather than rectangular transitions. The BER (*Bit Error Rate*) versus EbNo (*Energy per bit to Noise power density*) performance in the presence of AWGN (*Additive White Gaussian Noise*) is the same as coherently demodulated differentially encoded [BPSK]. While designed for MSK it will also demodulate [GMSK] and some types of [BPSK]. The signal is supplied via the audio input of the computer’s soundcard. The software implements differential decoding hence the modulator must use differential encoding. The output of the demodulator can be directed to either a built-in console or to a [UDP] network port. -An OQPSK demodulator supports the faster 10.5k Aero signals. +An OQPSK demodulator was added and supports the faster 8400bps and 10.5k Aero signals. Both 1200 and 10.5k burst C-band signal demodulation (From plane to ground station) are supported. +C-Channel signals at 8400bps that are for voice can be demodulated. + ![](images/screenshot-win-planelog.png) ## Binaries @@ -27,17 +29,19 @@ The [JAERO](JAERO) directory is where the Qt pro file is for the main applicatio ## Compiling JAERO -Compiling JAERO requires the Qt framework which can be obtained from http://www.qt.io/download-open-source/ . Qt Creator can be used to compile JAERO and comes with the Qt framework. At least version 5 of the Qt framework is required. Currently MinGW and GCC work as compilers but VC++ does not. +Compiling JAERO requires the Qt framework which can be obtained from http://www.qt.io/download-open-source/ but I would suggest using [MSYS2] to install the dev environment. Qt Creator can be used to compile JAERO and comes with the Qt framework. At least version 5 of the Qt framework is required. Currently MinGW and GCC work as compilers but VC++ does not. + +After installing Qt download the JAERO zip or the tar.gz source file to your computer. -After installing Qt download the JAERO zip or the tar.gz source file to your computer. Libcorrect may need to be obtained https://github.com/quiet/libcorrect.git and compiled separately (this uses cmake). +Open the [JAERO/JAERO.pro](JAERO/JAERO.pro) file with Qt creator where by Qt should ask you a few simple questions as to how to build JAERO. finally click build then run (make sure the shared or static library of libcorrect is available to the build process and the other growing list of dependencies are available to JAERO). -Open the [JAERO/JAERO.pro](JAERO/JAERO.pro) file with Qt creator where by Qt should ask you a few simple questions as to how to build JAERO. finally click build then run (make sure the shared or static library of libcorrect is available to the build process). +I would suggest going to the [JAERO Wiki] for more up to date detail on how to compile everything. ## Thanks -I'd like to thank everyone who has given their kind support for JAERO over the years. Thanks for Otti for getting the project started, John and Bev for setting up a worldwide large dish network, everyone who has donated, the people who have send feedback, people who use JAERO, and Jeroen who done an excellent job programming new code for JAERO to bring some features that I’m sure will be appreciated by many. +I'd like to thank everyone who has given their kind support for JAERO over the years. Thanks for Otti for getting the project started, John and Bev for setting up a worldwide large dish network, everyone who has donated, the people who have send feedback, people who use JAERO, Jeroen who done an excellent job programming new code for JAERO to bring some features that I’m sure will be appreciated by many, Tomasz for adding more ACARS message support, Corrosive for adding documentation, and the many other people who have written the libraries that JAERO uses. -Jonti 2018 +Jonti 2019 http://jontio.zapto.org [OQPSK]: https://en.wikipedia.org/wiki/Phase-shift_keying#Offset_QPSK_.28OQPSK.29 @@ -51,3 +55,5 @@ http://jontio.zapto.org [JMSK]: https://github.com/jontio/JMSK [RTL-SDR]: http://www.rtl-sdr.com/about-rtl-sdr/ [Releases]: https://github.com/jontio/JAERO/releases +[JAERO Wiki]: https://github.com/jontio/JAERO/wiki +[MSYS2]: https://www.msys2.org/