Aviateur

OpenIPC FPV ground station for Windows & Linux. Forked from fpv4win.

Note

Adaptive Link support is only for Linux.

Note

Only RTL8812AU Wi-Fi adapter is supported.

Note

No MAVLink support.

Usage

1. (Windows) Download Zadig
2. (Windows) Install the libusb driver for your adapter. Go Options → List All DevicesScreenshot.cpp. Select your adapter. Install the driver. Remember the USB ID, we will need it soon.
3. (Linux) 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.
4. (Linux) Call sudo udevadm control --reload-rules, then reboot (required).
5. Run Aviateur (on Linux, if you skip step 3 & 4, root privileges are needed to access the adapter).
6. Select the adapter of the correct USB ID.
7. Select your drone channel.
8. Select your WFB-NG key.
9. Start & Fly!

Common run issues

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

Latency test

Note

Currently, the glass-to-glass latency on Linux is much higher than that on Windows (~100 ms on Linux while ~70 ms on Windows). This difference may stem from some performance issue in libusb.

TODOs

• GStreamer backend
• 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.

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.