The gamepad connects directly to Duck. Complete calibration and a standing/walking check first. Open Settings → Gamepad in the cockpit (on phones, View → Show all), or http://<board-ip>:9527/gamepad.html. The embedded panel follows the cockpit language; the standalone page follows the browser language and has a language switch.

Pair and enable

  1. Put a Bluetooth-capable Xbox or Switch Pro controller into pairing mode. Switch Pro requires a driver matching the board kernel.
  2. Select Scan for controllers, then Pair & connect beside the intended device. Scanning ends after 30 seconds; existing pairings offer Connect.
  3. Wait for Input ready, center both sticks and release every button.
  4. Select Enable gamepad control. Pairing and enabling input do not engage torque.
Default input Action
Menu / Start Walk / get up; also stands up from sitting
Bottom face button (Xbox A) Default pose
Right face button (Xbox B) Torque off; support Duck first
Left stick Forward/back and strafe
Right stick horizontal Turn

No LB modifier is needed. Centering the sticks clears movement. Roller mode has no strafe. Nintendo mappings follow physical button positions, not the printed A/B letters.

Bind actions and Duck calls

Disable gamepad control, choose Bind beside an action, release held buttons, then press one button within 15 seconds. Learning does not perform actions. Duplicate assignments, multiple presses, timeout or disconnect leave the mapping unchanged. Use Clear, Cancel binding or Restore defaults as needed, and keep a Torque off button assigned.

Sit, Roller mode, Left kick, Right kick and all seven Duck calls are initially unassigned. Existing custom mappings are retained. Press a bound call once to play it on Duck's speaker. After switching Roller mode, center the sticks before moving. Settings persist in data/gamepad-bindings.json across restarts.

Ownership and connection loss

While enabled, the gamepad owns continuous motion input; browser movement messages are ignored. Explicit browser mode controls and Torque off remain available. Disable gamepad control before returning to screen joysticks. Disconnect, stale input or worker failure disarms and releases the source; reconnection requires explicit enabling again. Calibration and Servo setup also release gamepad ownership.

Compatibility

Xbox models must support Bluetooth; proprietary wireless models need an appropriate receiver and driver. Switch Pro requires hid-nintendo compiled for the actual kernel; never force-load a mismatched module. Separate Joy-Cons are not combined into a two-stick controller. For a supported Unitree-* remote, use Connect BLE, then enable control explicitly; compatibility with other firmware needs verification. Reconnecting never silently arms motors.

0.3.6 English gamepad controls · offline UI
0.3.6 English gamepad controls · offline UI