Eve library

Uzume Protocol Engines (Rust Workspace)

Other

Revision 1

On this page

This workspace initializes Uzume's protocol-engine foundation for low-latency show control and browser-hosted control surfaces.

Crates#

  • uzume-protocol-types
    • Shared protocol domain models: DMXUniverse, MIDIMessage, OSCMessage, TimecodeFrame.
  • uzume-timing-core
    • High-precision clock (Instant anchored), timer wheel scheduler, and SMPTE frame counter with system/external sync modes (LTC/MTC).
  • uzume-network-io
    • Tokio-based UDP/TCP network layer for Art-Net/sACN/OSC/device-control, multicast join/leave helpers, configurable buffers, and zero-copy parsers.
  • uzume-node-bridge
    • napi-rs native bridge exposing typed Node.js bindings for DMX universe output, device discovery, timecode sync, OSC messaging, and MIDI I/O.
  • uzume-control-surface-wasm
    • wasm-bindgen bridge crate for web control surfaces.
    • Built using wasm-pack with --target web.
  • uzume-integration-tests
    • Comprehensive integration suite covering Art-Net/sACN/OSC loopback flows, mock MIDI and Node bridge integration, and timecode latency/jitter reports.

Commands#

bash
# Workspace checks
cargo check --workspace
cargo test --workspace

# Focused integration suite
cargo test -p uzume-integration-tests -- --nocapture

# Build web-targeted WASM package
wasm-pack build crates/uzume-control-surface-wasm --target web

Toolchain#

rust-toolchain.toml pins stable Rust and includes:

  • rustfmt
  • clippy
  • wasm32-unknown-unknown target