<aside> 💻

For OI engineers working on the codebase day-to-day. This page collects the most important references, repo links, and development resources in one place.

</aside>

Key Repositories

All repos live under the Overhead-Intelligence GitHub org.

Repo	Language	What It Does
`oi-raspi-toolkit`	Bash	Companion computer provisioning — CM4, CM5, Pi 5 setup scripts, mavp2p, MediaMTX, Tailscale, TAK Server systemd services
`oi-ros2-ws`	Python + C++ (rclpy/rclcpp)	ROS 2 Jazzy workspace — 5 packages (`oi_custom_msg_srv`, `oi_tak_interface`, `oi_sensor_interface`, `oi_trillium_bridge`, `oi_bladerf_driver` [on `libbladerf` branch]), Docker deployment
`BaseBoxMini_Archives`	Bash / OpenWrt	Ground station router setup scripts, firmware, and LuCI overlay configs for 8Devices Mango
`data-mag`	C	MagComputer RP2040 firmware — dual-core, 100Hz GPS-synced mag logging (CMake + Pico SDK, v1.6.1)
`mag-parser`	Python	Magnetometer data post-processing GUI (tkinter + ttkbootstrap)
`WIGGLE`	Python / C++ / JS	Photogrammetry workflow — GeoTagger, Google Drive uploader, S3 fetcher, H3 hex grid (v1.2.2)
`oi-sensor-studio`	Python (Flask)	Flask + Waitress web app (uv-managed Python 3.13+, Tailscale-fronted) for sensor dataset archival/analysis. Plugins: `mfam`, `rf`.

Development Environment

Companion Computer Development

Target platform: Raspberry Pi OS Lite (Debian Trixie, arm64) on CM4, CM5, or Pi 5.

Default user: droneman
Hostnames: named after the drone (e.g., tula, magpie2)
Password format: hostname_tailnumber (e.g., tula_01)
Serial: CM4/CM5 → /dev/ttyAMA2, Pi 5 → /dev/ttyACM0 or /dev/ttyAMA0
Baud rate: 115200 (flight controller default)
Scripts path: /home/droneman/oi-raspi-toolkit/

ROS 2 Development

Distro: Jazzy Jalisco on Ubuntu 24.04
Build: colcon build --symlink-install
Test: colcon test