Manual & gamepad control
Use the on-screen pads or a connected controller in Autopilot mode.
Use manual controls
For WAM-V and BlueROV2, enable Joystick input in the ArduPilot panel. Use the two on-screen sticks with a mouse or touch.
Connect a gamepad
Use HTTPS or the installed app's local browser address. Focus the workspace window and press a controller button so the browser can detect it. A detected controller is selected automatically. The virtual sticks dim, with the device name and Key map buttons overlaid on them. Select the device name to choose a controller or change its mapping.
Browser standard uses the browser's standard mapping. Select POSIM USB · 0/1/2/5 for the matching generic USB layout from POSIM's joystick page. Other raw layouts require a matching mapping. The Key map popup shows the axes and buttons used by the selected vehicle and profile. Opening either popup pauses controller input. Center both sticks and release every button before resuming.
| Controller input | Action |
|---|---|
| Left stick up/down | Forward/reverse throttle |
| Left stick left/right | Underwater vehicle strafe |
| Right stick left/right | Steering/yaw |
| Right stick up/down | Underwater vehicle ascend/descend |
| Hold LB/L1 | Enable stick commands while held |
| B/Circle / X/Square | Increase / decrease output gain |
| Y/Triangle | Underwater vehicle depth hold (ALT_HOLD) |
| A/Cross | Underwater vehicle attitude stabilization (STABILIZE) |
| Hold Menu/Options for 1 second | Arm with centered sticks and LB/L1 released |
| View/Share | Stop input and disarm |
Button mapping and safe stopping
- The matching POSIM USB layout uses raw buttons 2 for LB, 0 for A, 1 for B, 3 for X, 4 for Y, 11 for Menu and 10 for View.
- Its stick axes are 0/1 and 2/5.
- The stick deadzone is 12%; the default gain is 25%, with 10% and 35% presets.
- Each B/X press moves one gain preset.
- Y/A switches the underwater flight controller's mode after releasing manual input; the reported mode appears in the panel.
- Depth hold maintains the flight controller's depth target when vertical input is neutral.
- Arming and mode changes retain the vehicle's normal readiness and mission checks.
- Release LB/L1 or select Stop input to send neutral input.
- Disconnect, focus loss or an interrupted polling loop also releases input; center the sticks and release the buttons before resuming.
- Inertia and waves can still move the robot.
-
A browser that lacks or blocks the Gamepad API displays an unavailable status.
-
Scene: terrain, water, axes and seabed lines
- Waves: applied to the physical wave solver
- Rate: requested and achieved values; live AIS hidden above 1×
- 3D day/night effects: browser lighting from location and UTC; off by default
Day/night effects apply to the browser scene. See Custom worlds for settings and Prepare your vehicle for model editing and Format SDF.