Tools

The aurora/tools directory collects standalone Python scripts used during development, testing and log analysis. They are not part of the firmware build and are invoked directly with python3.

All scripts share the same copyright header and SPDX identifier as the rest of the repository and target Python 3.10+.

Note

Pip requirements are installed via pip install -r tools/requirements.txt

• gen_flight_replay.py
• pad_link_central_example.py
• plot_flight_data.py
• rec_zephyr.py
• sim_fetch.py
• sim_flight_kalman.py
• sweep_apogee.py
• sync_defconfig.py

Overview

Script	Purpose
gen_flight_replay.py	Convert a recorded flights.csv into a generated C source file consumed by the fake_sensors replay backend.
pad_link_central_example.py	Reference BLE central for the pad-link library — scans, connects, and prints SM state and computed kinematics from a rocket.
plot_flight_data.py	Plot recorded or simulated flight data — standalone CLI for telemetry logs, importable plotting module for sim_flight_kalman.
rec_zephyr.py	MicroPython ground-station receiver for HC-12 telemetry — runs on a Raspberry Pi Pico and prints decoded state-machine frames to the REPL.
sim_fetch.py	Pull files out of a running native_sim Zephyr instance via the shell console.
sim_flight_kalman.py	Run a synthetic flight through a Python mirror of the AURORA Kalman filter and attitude tracker.
sweep_apogee.py	Grid-search Kalman filter tuning parameters against recorded flights.
sync_defconfig.py	Merge the generated Zephyr defconfig into a board-specific .conf.