Aviateur

OpenIPC FPV ground station for Linux/Windows/macOS. Forked from fpv4win.

Note

Adaptive Link support is only available for Linux.

Note

Only RTL8812AU Wi-Fi adapter is supported.

Note

No MAVLink support.

How to run on Windows

1. Install the GStreamer runtime (the development installer is not necessary) from GStreamer.
2. Add C:\Program Files\gstreamer\1.0\msvc_x86_64\bin to your PATH environment variable.
3. Download Zadig.
4. Install the libusb driver for your adapter. Go Options → List All Devices Select your adapter. Install the driver. Remember the USB ID, we will need it soon.
5. Run Aviateur.
6. Select the adapter of the correct USB ID. Select your drone channel. Select your WFB-NG key. Start.

How to run on Linux

1. (Optional) Go to /lib/udev/rules.d, create a new file named 80-my8812au.rules and add SUBSYSTEM=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="8812", MODE="0666" in it.
2. (Optional) Call sudo udevadm control --reload-rules, then reboot (this is definitely required).
3. Run Aviateur (if you skip step 1 & 2, root privileges are needed to access the adapter).
4. Select the adapter of the correct USB ID. Select your drone channel. Select your WFB-NG key. Start.

How to run on macOS (WIP)

Common run issues

• If the application crashes at startup on Windows, install Microsoft Visual C++ Redistributable first.

Latency test

Note

Generally, enabling the GStreamer backend can achieve a lower glass-to-glass latency.

TODOs

• Ground side OSD

How to build on Windows

1. Install vcpkg somewhere else.

   git clone https://github.com/microsoft/vcpkg.git
   cd vcpkg
   .\bootstrap-vcpkg.bat

2. Install dependencies.

   .\vcpkg integrate install
   .\vcpkg install libusb ffmpeg libsodium opencv

3. Add VCPKG_ROOT to environment. (Change the value to your vcpkg path.)

4. Clone third-party library sources.

   git submodule update --init --recursive

5. Open as a CMake project and build.

How to build on Linux (tested on Ubuntu 24.04)

1. Install dependencies.

   git submodule update --init --recursive
   sudo apt install libusb-1.0-0-dev ffmpeg libsodium-dev libopencv-dev xorg-dev libpcap-dev

2. Open as a CMake project and build.

How to build on macOS

1. Install dependencies.

   git submodule update --init --recursive
   brew install libusb ffmpeg libsodium opencv libpcap

2. Add the following content to YOUR_HOME/.zprofile (change the sdk version to your own version).

   VULKAN_SDK="/Users/zzz/VulkanSDK/1.4.321.0/macOS"
   export VULKAN_SDK
   PATH="$PATH:$VULKAN_SDK/bin"
   export PATH
   DYLD_LIBRARY_PATH="$VULKAN_SDK/lib:${DYLD_LIBRARY_PATH:-}"
   export DYLD_LIBRARY_PATH
   echo "This script is now using VK_ADD_LAYER_PATH instead of VK_LAYER_PATH"
   VK_ADD_LAYER_PATH="$VULKAN_SDK/share/vulkan/explicit_layer.d"
   export VK_ADD_LAYER_PATH
   VK_ICD_FILENAMES="$VULKAN_SDK/share/vulkan/icd.d/MoltenVK_icd.json"
   export VK_ICD_FILENAMES
   VK_DRIVER_FILES="$VULKAN_SDK/share/vulkan/icd.d/MoltenVK_icd.json"
   export VK_DRIVER_FILES
   PKG_CONFIG_PATH="$VULKAN_SDK/lib/pkgconfig:$PKG_CONFIG_PATH"
   export PKG_CONFIG_PATH
   

3. Log out and in for the above change to take effect.

4. Open as a CMake project and build.

Common build issues

On Windows

CMake Error at C:/Program Files/Microsoft Visual Studio/2022/Community/Common7/IDE/CommonExtensions/Microsoft/CMake/CMake/share/cmake-3.29/Modules/FindPackageHandleStandardArgs.cmake:230 (message): ...

This is because the pre-installed vcpkg from Visual Studio installer overrides the PKG_ROOT environment variable. To fix this, find set(CMAKE_TOOLCHAIN_FILE "$ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake") in CMakeLists.txt, replace $ENV{VCPKG_ROOT} with the vcpkg you cloned previously.