Ground station software for the UBC AeroDesign electric propulsion test stand.
AeroThrust V3 replaces the old PyQt5 test stand app. It shows live thrust, current, and voltage data, runs automated throttle sweeps, lets you calibrate each of the 4 strain gauge channels, and saves every test to a local database that can be exported as a CSV file.
It is built with Tauri, React, TypeScript, and FastAPI.
You do not need Python, Node, or Rust installed to run the app.
- Go to the Releases page.
- Under the latest version, download the file for your computer:
- Windows:
AeroThrust V3_1.0.x_x64-setup.exe - Mac:
AeroThrust V3_1.0.x_aarch64.dmg
- Windows:
- Double-click the
.exefile you downloaded. - Windows may show a warning screen saying it "protected your PC" because the app is not from a well-known publisher. The app is safe, and you can get past this:
- Click More info.
- Click Run anyway.
- Follow the installer steps, then open AeroThrust V3 from the Start menu.
If your browser blocks the download itself (for example, "not commonly downloaded"), open the browser's downloads list, click the three dots next to the file, and choose Keep.
-
Open the
.dmgfile and drag AeroThrust V3 into your Applications folder. -
Open Terminal (press
Cmd + Space, type "Terminal", press Enter). -
Paste this command and press Enter:
xattr -cr "/Applications/AeroThrust V3.app"This removes the "downloaded from the internet" flag that makes macOS block the app. It will not print anything if it works.
-
Open AeroThrust V3 from Applications.
If macOS still says the app can't be opened, go to System Settings > Privacy & Security, scroll down, and click Open Anyway next to the AeroThrust message.
- Connect: Choose Virtual Simulator to practice without hardware, or Physical USB Serial for the real test stand. Select your COM port and click CONNECT.
- Tare: Make sure the motor is off, then click TARE ALL. To zero one load cell at a time, click CHANNELS... instead.
- Start logging: Click NEW TEST RUN, enter your motor, propeller, and battery details, then click Start Recording.
- Run the motor in one of two ways:
- Automated sweep: Pick a recipe in the Auto Test Sequence bar (for example, 10% to 100% Stepped Sweep) and click RUN AUTOMATED SWEEP.
- Manual control: Check ARM MOTOR, then use the slider or the quick buttons (
+5%,25%,50%).
- Finish: Click STOP & EXPORT, then click DOWNLOAD CSV to save your data.
Emergency stop: Press Spacebar (or Escape) or click the red E-STOP button at any time. The motor goes to 0% throttle immediately.
- Watchdog: If the USB connection drops or the app freezes for more than 250 ms, the stand controller cuts throttle to 0% on its own.
- Over-current protection: Motor output is cut if current goes above the safe limit for the ESC.
- Low-voltage warning: Warns you before the LiPo battery is drained far enough to be damaged.
- Global E-Stop: Spacebar and Escape work anywhere in the app.
- Python 3.10 or newer
- Node.js 18 or newer, with npm
- Rust toolchain (rustup.rs)
# Create and activate a Python virtual environment
python -m venv .venv
# Windows:
.venv\Scripts\Activate.ps1
# macOS/Linux:
source .venv/bin/activate
# Install backend dependencies
pip install -r backend/requirements.txt
# Install frontend dependencies
cd frontend
npm install
cd ..Open three terminals in the repository root and run one command in each:
- Terminal 1, physics simulator:
python sim/virtual_stand.py
- Terminal 2, backend:
python backend/run.py
- Terminal 3, desktop app:
cd frontend npm run tauri dev
Pushing a version tag to GitHub starts an automated build (defined in .github/workflows/release.yml). It creates the Windows .exe and Mac .dmg installers and attaches them to a new GitHub Release.
git tag v1.0.x
git push origin v1.0.xWatch progress in the Actions tab on GitHub.
thrust-stand-v3/
├── backend/ # FastAPI server, SQLite storage, binary serial protocol (COBS/CRC16)
│ ├── app/
│ │ ├── hal/ # Hardware layer (serial and simulator connections)
│ │ ├── routers/ # API endpoints: control, session, telemetry, sequences
│ │ └── services/ # Connection manager, safety watchdog, sequences, storage
│ └── run.py # Backend entry point
│
├── frontend/ # Desktop app (Tauri) and user interface (React/TypeScript)
│ ├── src/
│ │ ├── components/ # Gauges, plots, throttle sliders, safety banners
│ │ ├── hooks/ # useTelemetryStream (50 Hz buffer), useKeyboardEStop
│ │ └── styles/ # theme.css (UBC AeroDesign 2023 branding)
│ └── src-tauri/ # Rust window settings and sidecar definitions
│
├── sim/ # Physics simulator (motor inertia, battery sag, noise)
│ ├── virtual_stand.py
│ └── test_client.py
│
├── docs/ # Architecture notes, legacy V2 audit, SAE 2027 rules
└── README.md