AFV Native is a portable-(ish) implementation of the Audio for VATSIM client protocol, written by Chris Collins.
For additional information, please see the original repository.
To build AFV-native, you will require an up-to-date copy of cmake and vcpkg.
$ git submodule update --recursive --init
$ vcpkg/bootstrap-vcpkg.sh (or .bat if Win32)
$ cmake -S . -B build/
$ cmake --build .Then build the project appropriately.
You can vary your conan and cmake lines as necessary to select alternate target profiles, provide options to cmake, etc.
AFV-native was written with the following assumptions:
- Everybody is LittleEndian.
It explictly is written to work with:
- Win32 x86_64 compiled using MSVC
- amd64 Linux compiled using gcc
- macOs compiled using apple-clang.
Previously, AFV-Native assumed x86/x64, but the rise of compiler autovectorisation means that we don't need to explicitly optimise for those cases to get ideal mixing code as long as we ensure certain conditions can't exist - the compiler should be able to work that out on it's own. The code should no longer contain any x86-specific code when compiled with gcc/clang and should be usable on LittleEndian ARM as a result.
You do need an optimised bit-search function (GnuC calls this "count leading/trailing zeros"). Almost all CPUs have a native instruction to do this faster than the most well written, tightly rolled loop can, and gcc (and clang by virtue of it's gcc compatibility) and MSVC both expose the instruction via a compiler builtin or intrinsic respectively. If you're not using gcc, clang or MSVC, you'll likely need to fix the CryptoDTO sequence test to use the correct function for your compiler.
For the most part, it should be OS independent. Library dependencies have been selected due to their portability and common availability.
BigEndian will require significant attention in the CryptoDto code paths as the serialisation code currently takes the easy-way-out of just direct copying from the variable memory into the buffer as CryptoDto itself uses LE representations. Given there are little to no BigEndian flight simulators supported by VATSIM, this is probably not an issue.
AFV-Native 1.0 only implements as much as required for pilot clients. It doesn't understand the inter-controller direct voice controls, nor does it include support for cross-coupling or multi-transmitter voice (although all the groundwork is there and when those systems are standardised, they can be incorporated fairly easily)
AFV-Native is made available under the 3-Clause BSD License. See COPYING.md for the precise licensing text.
More information about this is in the docs directory.