Rust crates - ADOS Documentation

The ADOS Drone Agent publishes its reusable Rust code as separate crates on crates.io. All of them live in the crates/ workspace of the agent repository. The platform crates speak the agent’s wire or read its board profiles; the standalone crates have no ADOS dependency and work in any project. Platform (versioned with the ADOS Drone Agent)

Crate	What it does	Add it	Docs
`ados-protocol`	Wire contracts of the ADOS Drone Agent: IPC framing, plugin RPC envelope, capability tokens and the vision frame bus.	`cargo add ados-protocol`	docs.rs
`ados-sdk`	Write Rust plugins for the ADOS Drone Agent: IPC client, plugin context, driver traits and lifecycle runner.	`cargo add ados-sdk`	docs.rs
`ados-vision`	Single-object visual tracker: Kalman motion model, appearance re-identification and YOLOv8 head decoding.	`cargo add ados-vision`	docs.rs
`ados-gpio`	Drive status buzzers and LEDs on Linux GPIO lines, with bounded software-PWM beep patterns.	`cargo add ados-gpio`	docs.rs
`ados-hal-probe`	Find out what a board’s hardware can really do by probing it, plus bundled board profiles.	`cargo add ados-hal-probe`	docs.rs

Standalone

Crate	What it does	Add it	Docs
`ados-sensorhub`	Sensor hub wire protocol: COBS framing, CRC-16 and fixed-layout IMU, baro, mag and GNSS packets. no_std.	`cargo add ados-sensorhub`	docs.rs
`ados-offload`	Choose where perception runs (onboard, offloaded or hybrid) and hold the vehicle when results go stale.	`cargo add ados-offload`	docs.rs
`ados-macpin`	Stable MAC addresses for Linux network adapters that randomize theirs every boot.	`cargo add ados-macpin`	docs.rs
`ados-lora`	LoRa transmit governor with cited regional band plans, duty cycle, dwell time and airtime accounting.	`cargo add ados-lora`	docs.rs
`ados-crsf-codec`	no_std CRSF / ExpressLRS codec for RC channels, telemetry and parameter frames.	`cargo add ados-crsf-codec`	docs.rs
`ados-positioning`	Split mixed UBX, NMEA and RTCM3 GNSS streams, configure u-blox receivers and run an RTK base survey-in.	`cargo add ados-positioning`	docs.rs
`ados-rtcm`	RTCM3 framing, CRC-24Q and MAVLink GPS_RTCM_DATA fragmentation for RTK corrections.	`cargo add ados-rtcm`	docs.rs
`ados-clock`	Map remote clocks onto the host clock: least-squares and envelope fits, TIMESYNC and a chrony sink.	`cargo add ados-clock`	docs.rs
`ados-swarm`	Swarm control laws: separation, flocking, formations, CBBA task allocation and a point-mass simulator.	`cargo add ados-swarm`	docs.rs
`ados-mavlink-tunnel`	Send large messages over MAVLink TUNNEL frames with chunking and bounded reassembly.	`cargo add ados-mavlink-tunnel`	docs.rs
`ados-display-driver`	Small-display output on Linux: SSD1306/SH1106 OLED over I2C, pixel packers and a framebuffer writer.	`cargo add ados-display-driver`	docs.rs
`ados-hmi`	Front-panel input: touchscreen calibration and gestures, button presses and rotary encoders.	`cargo add ados-hmi`	docs.rs

Versioning

Platform crates move in lockstep with the agent. ados-protocol, ados-sdk, ados-vision, ados-gpio and ados-hal-probe carry the agent version, so ados-sdk X.Y.Z speaks the wire of agent X.Y.Z. Pin the major.minor of the agent you target.
Standalone crates follow their own semver. They started at 0.1.0 and bump only when they change.

Any change to a published crate’s packaged files ships with a version bump. To build an agent plugin, start with the Rust SDK guide.

License

Every crate is licensed under either of Apache License 2.0 or MIT at your option, except ados-sensorhub, which is MIT. The agent services themselves stay GPL-3.0-or-later. See Legal and licensing.

Last modified on October 22, 2026