adamo

Rust SDK for the Adamo Network — low-latency robotics pub/sub and video streaming.

use adamo::{Protocol, Session};

let session = Session::open("ak_…", Protocol::Quic)?;
session.put("telemetry/heartbeat", b"hi", Default::default())?;

let sub = session.subscribe("commands/move")?;
let sample = sub.recv(Some(std::time::Duration::from_secs(5)))?;

Features

• Session — auth-aware Zenoh wrapper (open, put, publisher, subscribe).
• Robot (behind video feature) — declare hardware-accelerated video tracks against the local camera and stream them over Zenoh:

  use adamo::{Protocol, Robot};
  let mut robot = Robot::new("ak_…", Some("rover-01"), Protocol::Quic)?;
  robot.attach_v4l2("front", "/dev/video0", 1280, 720, 30, 4000)?;
  robot.run()?; // blocks; capture → encode → publish
  

• Adamo time — adamo::fabric_now_us() returns microseconds on a shared clock derived from the relays' zenoh-plugin-adamo-time. Stamp every cross-node timestamp with this so glass-to-glass latency measurements aren't poisoned by NTP drift between machines.

How the binary is shipped

The crate's adamo-sys dependency bundles a precompiled libadamo.so for the supported target (currently aarch64-unknown-linux-gnu — Jetson / Ubuntu 22.04 arm64) inside its crate tarball. No network access is required at build time.

For local development against a freshly-built libadamo, set ADAMO_LIB_DIR=/path/to/dir/with/libadamo.so to override the bundled binary.

License

Apache-2.0. The bundled libadamo binary is proprietary and covered by the Adamo SDK license.