OmniTiles Python SDK

The OmniTiles SDK gives you a Python API for every interaction the debug GUI supports: send motion commands to one or many tiles, subscribe to sensor telemetry, and script higher-level behaviors on top. The Viser debug GUI uses this SDK as its transport and protocol layer.

Contents

• Quickstart
  • Install
  • Connect to one tile (blocking)
  • Connect to one tile (async)
  • Subscribe to telemetry
• Working with multiple tiles
  • Discover and connect
  • Broadcast an action in parallel
  • Scripting a layout switch
  • Sync fleet
• Binary protocol reference
  • Packet format
  • Command IDs
  • Telemetry variants
  • Extending the protocol
• API reference
  • Tile
  • Fleet
  • Sync wrappers
  • Telemetry
  • Protocol
  • UWB
  • Hardware constants

Highlights

• Async-first API with a blocking sync wrapper for scripts and UI frameworks.

• Multi-tile fleets — discover every OmniTile_* advertiser and control them in parallel.

• Typed telemetry exposed both as a latest-snapshot property and as a callback subscription.

• Protocol parity with the Rust firmware; the binary protocol module mirrors omnitiles/src/protocol/messages.rs.

Quick peek

from omnitiles import SyncTile

tile = SyncTile.discover_one()
tile.m1_extend(speed=200)
print(tile.telemetry)
tile.disconnect()