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.