MAVKit

Async MAVLink SDK for vehicle control, telemetry, missions, and parameters. Available as a Rust crate and a Python package with full async support.

Install

Python

pip install mavkit

Rust

[dependencies]
mavkit = "0.3"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Quick Start

Python

import asyncio
import mavkit

async def main():
    vehicle = await mavkit.Vehicle.connect_udp("0.0.0.0:14550")

    state = await vehicle.wait_state()
    print(f"mode={state.mode_name} armed={state.armed}")

    telem = await vehicle.wait_telemetry()
    print(f"alt={telem.altitude_m} bat={telem.battery_pct}")

    await vehicle.disconnect()

asyncio.run(main())

Rust

use mavkit::Vehicle;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let vehicle = Vehicle::connect_udp("0.0.0.0:14550").await?;

    let mut state_rx = vehicle.state();
    state_rx.changed().await?;
    let state = state_rx.borrow().clone();
    println!("mode={} armed={}", state.mode_name, state.armed);

    vehicle.disconnect().await?;
    Ok(())
}

Features

• Connections -- UDP, TCP, serial, BLE/SPP via byte-stream adapters
• Telemetry -- reactive watch channels (Rust) / sync properties + async waiters (Python)
• Commands -- arm, disarm, set mode, takeoff, guided goto, arbitrary COMMAND_LONG
• Missions -- upload, download, clear, set current, verify roundtrip
• Parameters -- download all, write single, batch write, .param file I/O
• Validation -- plan validation, normalization, tolerance-based comparison

Feature Flags (Rust)

Mission Wire Semantics

For MissionType::Mission, MAVLink wire transfer is normalized:

• Upload: a home item is prepended at seq=0 (or a zero placeholder if missing)
• Download: wire seq=0 is extracted as home; remaining items are resequenced from 0

For Fence and Rally types, items pass through unchanged.

Examples

Rust -- see examples/:

cargo run --example connect_udp

Python -- see mavkit-python/examples/:

cd mavkit-python && uv run python examples/connect_udp.py

Development

Rust

cargo check
cargo clippy --all-targets --all-features -- -D warnings
cargo test
cargo fmt --all -- --check

Python

cd mavkit-python
uv sync
uv run maturin develop
uv run ruff format --check .
uv run ruff check .

SITL Integration Tests

Requires Docker + ArduPilot SITL:

make bridge-up        # start SITL + MAVProxy bridge
make test-sitl        # run integration tests
make bridge-down      # cleanup

Environment: MAVKIT_SITL_UDP_BIND (default 0.0.0.0:14550), MAVKIT_SITL_STRICT (set 1 for strict mode).

License

MIT