Crate toio

toio driver in Rust.

Supports all the messages defined in the technical specification. Provides async/await API. Provides the similar API as JavaScript version. Also provides the low-level API, which allows fine-grained control and configuration.

Plans to be cross-platform. The targets are:

• macOS
• Windows 10 (TODO)
• Linux (TODO)

use std::time::Duration;
use toio::Cube;
use tokio::time::delay_for;

#[tokio::main]
async fn main() {
    // Search for the nearest cube.
    let mut cube = Cube::search().nearest().await.unwrap();

    // Connect.
    cube.connect().await.unwrap();

    // Print status.
    println!("version   : {}", cube.version().await.unwrap());
    println!("battery   : {}%", cube.battery().await.unwrap());
    println!("button    : {}", cube.button().await.unwrap());

    // Move forward.
    cube.go(10, 10, None).await.unwrap();

    delay_for(Duration::from_secs(3)).await;

    // Spin for 2 seconds.
    cube.go(100, 5, Some(Duration::from_secs(2))).await.unwrap();

    delay_for(Duration::from_secs(3)).await;
}

Re-exports

• pub use proto::IdPos;
• pub use proto::IdStd;
• pub use proto::Note;
• pub use proto::Posture;
• pub use proto::SoundPresetId;

Modules

• ble
  Abstracts BLE.
• proto
  Protocol data structures.

Macros

• uuid
  Helper to construct [ble::Uuid][] from a string at compile time.

Structs

• Cube
  The cube.
• LightOp
  A light operation.
• Position
  The cube position information.
• Searcher
  Searcher to search cubes.
• SoundOp
  A sound operation.
• StdId
  The standard id information.

Enums

• Event
  The event sent when the status is updated.

Type Aliases

• EventStream
  The stream of events.