PosiStageNet (PSN)

PosiStageNet is an open protocol for real-time tracking data, commonly used with motion tracking systems. WATCHOUT 7 can receive PSN data and use it to control variables.

Enabling PSN

PSN input must be enabled per node. In the Nodes panel, select a node and enable PSN in its properties. When enabled, the node will listen for PSN data on the standard multicast group (236.10.10.10) and port (56565).

Variable Keys

PSN tracking data is automatically mapped to variable keys based on tracker ID and data type. Create variables with matching keys to receive tracking data:

Position

  • psn.{tracker_id}.pos.x - X position
  • psn.{tracker_id}.pos.y - Y position
  • psn.{tracker_id}.pos.z - Z position

Orientation

  • psn.{tracker_id}.ori.x - X orientation (rotation)
  • psn.{tracker_id}.ori.y - Y orientation (rotation)
  • psn.{tracker_id}.ori.z - Z orientation (rotation)

Speed

  • psn.{tracker_id}.speed.x - X velocity
  • psn.{tracker_id}.speed.y - Y velocity
  • psn.{tracker_id}.speed.z - Z velocity

Acceleration

  • psn.{tracker_id}.accel.x - X acceleration
  • psn.{tracker_id}.accel.y - Y acceleration
  • psn.{tracker_id}.accel.z - Z acceleration

Example

To use position data from tracker 1:

  1. Enable PSN on the node receiving tracking data
  2. Create a variable with key psn.1.pos.x
  3. Set appropriate min/max values for your tracking coordinate system
  4. Use the variable in expressions or bind it to cue properties

TIP: For orientation data (rotation angles), use Circular interpolation to handle wrap-around at boundaries. See Variables for interpolation settings.

Tips

  • PSN coordinates are typically in meters or millimeters depending on your tracking system configuration
  • Set variable min/max values to match your tracking system's coordinate range
  • Use expressions to scale or offset PSN values to match your stage coordinates
  • PSN data updates at high frequency; interpolation can help smooth the motion

Note: WATCHOUT receives PSN data via UDP multicast. Ensure your network infrastructure supports multicast routing if the tracking system and WATCHOUT nodes are on different network segments.