Connect to the Return to Dark Tower via Bluetooth LE

Disconnect from the Return to Dark Tower

Calibrate the tower drums. Must be connected first. The tower will rotate all drums to their home positions.

Get the current tower connection status, calibration state, and battery info

Get device information: manufacturer, model, firmware/hardware revision, serial number

Active connectivity check — verifies the tower is connected and responding

Clean up, reconnect, and recalibrate the tower in one step. Use this when tower_is_responsive returns false or the tower stops responding after going idle.

Enable or disable connection monitoring with optional frequency and timeout

Configure battery heartbeat monitoring

Play a sound from the tower audio library by index number (1-113). Volume is 0 (loudest) to 3 (soft).

Play a sound by name (e.g. 'Ashstrider', 'Battle Start'). Case-insensitive lookup.

List all available sounds from the tower audio library, optionally filtered by category

Control tower lights. Set doorway lights (north/south/east/west at top/middle/bottom), ledge lights (corner positions), and base lights. Effects: off, on, breathe, breatheFast, breathe50percent, flicker.

Set a single LED by layer and light index. Layers: 0=top ring, 1=middle ring, 2=bottom ring, 3=ledge, 4=base1, 5=base2. Light index 0-3.

Play a predefined light sequence by ID (1-19). Optionally play a sound simultaneously.

Play a predefined light sequence by name (e.g. 'victory', 'defeat', 'dungeonIdle', 'twinkle'). Case-insensitive.

Turn on all 24 tower LEDs with a single command. Optionally specify an effect (0=off, 1=on, 2=breathe, 3=breatheFast, 4=breathe50%, 5=flicker); defaults to on.

Turn off all 24 tower LEDs with a single command

Rotate all three drums to specified positions. Requires calibration. Optionally plays a sound.

Rotate a single drum to a specified position. Requires calibration.

Randomly rotate drum levels. level: 0=all, 1=top, 2=middle, 3=bottom, 4=top+middle, 5=top+bottom, 6=middle+bottom

Get the current position of all three drums

Break a seal at the specified side and level. Plays the seal-breaking animation and sound.

Check if a specific seal has been broken

Get a list of all broken seals

Reset all seals to unbroken state (in software tracking only)

Get a random unbroken seal location

Get the full current tower state including drums, lights, audio, and beam sensor data

Send a complete tower state to the tower. Advanced: directly sets all tower hardware state.

Get the current facing direction of all 5 glyphs (cleanse, quest, battle, banner, reinforce)

Get the current facing direction of a specific glyph

Get all glyphs currently facing a given direction

Get the cumulative number of skulls that have dropped into the tower

Reset the skull drop counter to zero