Quick Start Guide

Get started with qt-test in minutes.

Prerequisites

  • Operating System: Windows 10/11, macOS 10.15+, or Linux (Ubuntu 20.04+)

  • Qt Framework: Qt 6.5 or later

  • Bluetooth: BLE-capable Bluetooth adapter

  • Internet Connection: Required for NTRIP corrections

Running the Application

Step 1: Launch qt-test

# Windows
qt-test.exe

# Linux/macOS
./qt-test

Step 2: Connect to BLE Device

  1. Click the Bluetooth tab

  2. Click Scan to discover nearby devices

  3. Select your SitePoint GPS receiver from the list

  4. Click Connect

Step 3: Configure NTRIP (Optional)

For RTK corrections:

  1. Click the NTRIP tab

  2. Enter connection details:

    • Host: NTRIP caster hostname (e.g., rtk.example.com)

    • Port: Typically 2101

    • Mountpoint: Your correction stream

    • Username/Password: Your credentials

  3. Click Connect

Step 4: View Position Data

  • Navigate to Map tab to see real-time position

  • Check Device Data window for detailed coordinates and status

Using the Documentation

The project provides documentation in multiple formats:

PDF Documentation (Easiest):

# Open the user manual PDF
docs/_build_latex/qt-test.pdf

HTML Documentation:

# Open in browser
docs/_build/index.html

Qt Help (.qch) in Qt Creator:

  1. Open Qt Creator

  2. Go to Help → Documentation → Add…

  3. Navigate to doxygen_output/docs/qt-test.qch

  4. Click OK

  5. Press F1 on any class for context help

Next Steps