Installation Guide

Orientable AI GNSSLib v3.0 works on various Linux distributions and macOS.

System Requirements

Operating System: Debian/Ubuntu, macOS, or compatible.
Compiler: GNU C compiler (gcc) or Clang with C99 support.
Build System: CMake 3.10 or later.
Tools: pkg-config.

Dependencies

The following development libraries are required:

Required

libusb-1.0
fftw3 (floating-point)
pthread

Optional

librtlsdr: For RTL-SDR front-end support (enabled by default).
libbladerf: For BladeRF front-end support (disabled by default).

Installation Steps

1. Install Dependencies

Debian/Ubuntu:

sudo apt-get update
sudo apt-get install -y \
  build-essential \
  cmake \
  pkg-config \
  libusb-1.0-0-dev \
  libfftw3-dev \
  librtlsdr-dev \
  libgtkmm-4.0-dev \
  qt6-base-dev \
  qt6-charts-dev

For BladeRF support (optional):

sudo apt-get install -y libbladerf-dev

macOS (Homebrew):

brew update
brew install cmake pkg-config libusb fftw librtlsdr gtkmm4 qt@6

For BladeRF support (optional):

brew install bladerf

2. Clone Repository with Submodules

git clone --recursive https://github.com/orientable-ai/Orientable-AI-GNSSLib-3.0.git
cd Orientable-AI-GNSSLib-3.0

3. Build the Project

mkdir build && cd build
cmake ..
make -j$(nproc)

4. Optional: Install to System

sudo make install

Verification

After building, verify the executables were created:

ls -l orientable-gnss-cli orientable-gnss-gnuplot orientable-gnss-gtk4 orientable-gnss-qt6
./orientable-gnss-cli --help