Outputs & API

Outputs

Protocol	Transport	Coordinate System	Consumers
PSN v2.03	UDP multicast 236.10.10.10:56565	Left-handed (X=right, Y=up,

Modes

python -m topos.main                          # Hardware mode (serial + WiFi UDP)
python -m topos.main --simulate circle        # Simulation (no hardware needed)
python -m topos.main --record                 # Record range data to JSONL
python -m topos.main --replay <file>          # Replay a recording
python -m topos.main --relay ws://ip:7070/ws/trackers  # Relay from remote Topos
python -m topos.main --clean                  # Ignore saved state, start fresh

REST & WebSocket API

Endpoint	Method	Description
/api/status	GET	Service status, uptime, active trackers
/api/trackers	GET	All trackers with positions
/api/trackers/{id}/name	PUT	Rename a performer
/api/trackers/{id}/ghost_timeout	PUT	Set ghost timeout per performer
/api/config	GET	Current configuration
/api/anchors/calibrate	PUT	Calibrate from terrain measurements
/api/anchors/positions	PUT	Set anchor positions directly
/api/anchors/measurements	GET	Saved terrain measurements
/api/outputs/{name}/enabled	PUT	Toggle output on/off
/api/presets	GET	List saved presets
/api/presets/save	POST	Save current state as preset
/api/presets/load	POST	Restore a preset
/api/fixtures	GET/POST	List or add fixtures
/api/fixtures/{id}	PUT/DELETE	Edit or remove a fixture
/api/fixtures/{id}/tracker	PUT	Assign tracker to fixture
/api/fixtures/{id}/calibration/stop	POST	Exit calibration mode (fixture resumes auto pan/tilt)
/api/fixtures/calibrate/start-batch	POST	Enter calibration mode for several fixtures at once
/api/fixtures/calibrate/record-batch	POST	Capture one tag position across selected fixtures (Art-Net snoop or manual override)
/api/fixtures/calibrate/solve-batch	POST	Solve and apply calibration for selected fixtures
/api/cues	GET	List tracking cues
/api/cues/save	POST	Save fixture→tracker assignments as cue
/api/cues/recall	POST	Recall a cue
/api/engine/trilateration	PUT	Switch 2D/3D mode
/api/devices/ports	GET	List serial ports
/api/devices/connect	POST	Connect to device for AT config
/api/devices/configure	POST	Configure tag/anchor via AT commands
/ws/trackers	WS	Real-time tracker positions (30 Hz)