Single Camera Kiosk: Xbox / USB joystick setup

Xbox / USB joystick setup

Open NDI camera joystick, choose an NDI PTZ camera and Connect controls. Press a controller button if necessary for browser detection. A browser-reported standard gamepad automatically receives the Xbox / standard preset: left stick pan/tilt, right stick up/down zoom, and hold RB (right shoulder) for movement. Enable USB movement with the sticks centered and RB released, then hold RB while moving. Releasing RB stops movement. The separate USB status shows camera connection, focus, neutral arming, hold-button detection and command dispatch; camera status reports actual control errors. Sending commands does not prove the camera moved.

Live axes and pressed button indices identify custom mappings. A controller without the standard mapping is left in custom mode (zoom disabled initially); configure the shown indices and invert directions as needed. Axis −1 disables an axis. A non-centering throttle used as zoom prevents arming: disable that axis or select a centered stick. Missing/invalid mapped axes or hold buttons produce an explanation. Changes to mapping, selected controller, focus, camera or STOP disable USB movement and require enabling again. Connecting an unrelated controller leaves the selected controller alone. Presets never automatically enable movement.

The existing release used hold button 0 (A on standard Xbox controllers); checking Enable USB movement alone did not authorize movement. Standard layout reference: https://w3c.github.io/gamepad/#remapping . Verify low-speed directions on the actual camera before live use. Physical controller/native Mac/NDI hardware require target-system testing.