Skip to content

Gamepad Teleop: Easy Mode Mapping #21

Open
hello-robot-shehab wants to merge 12 commits into
mainfrom
feature/gamepad_mapping_easy_mode
Open

Gamepad Teleop: Easy Mode Mapping #21
hello-robot-shehab wants to merge 12 commits into
mainfrom
feature/gamepad_mapping_easy_mode

Conversation

@hello-robot-shehab

@hello-robot-shehab hello-robot-shehab commented May 22, 2026

Copy link
Copy Markdown
Contributor

Easy Mode Controller Mapping

A gamepad teleop mapping that fits all the controls except wrist roll on the main controller, without the Right Trigger.
image
image
image

  • Flying Gripper mapping by default.
  • Tap Y to switch between Flying Gripper mapping and Direct Control mapping
  • When you launch stretch_gamepad_teleop default settings:
    • Medium Speed
    • Medium Strength
    • Flying Gripper Mapping (Control Mode 1)
  • New Direct Control Mode Mapping:
    • Left Trigger for precision mode (Analog - the more you press, the slower it moves)
    • D-pad up/down for lift
    • D-pad left/right for arm
    • Left Stick for Omnibase translation
      • Right Trigger + Left Stick Makes the robot move in a straight line (Makes the analog stick 1/0 in either direction), useful for docking and moving in tight spaces.
    • Right Stick for Pitch and Yaw
    • Shoulder buttons for Omnibase rotate
    • Right Trigger + Shoulder buttons for Roll
    • A and B buttons for open close gripper (unchanged)
    • Changing Settings:
      • Y or Right Trigger + Y Change between Flying Gripper and Direct Control mappings (vibrates with a different sequence for each mode)
      • Right Trigger + A Cycle Speed (vibrates longer for more speed)
      • Right Trigger + B Cycle Strength (vibrates longer for more strength)
      • Right Trigger + Select Read out the current settings
      • When not homed: tap Start to home
      • Hold Right Trigger + Hold Select to stow
      • Hold Start or Right Trigger + Start for Left/Right Handed Mode

To Test

  • Install flying gripper
cd ~repos
git clone https://github.com/hello-robot/stretch4_flying_gripper.git
pip install -e stretch4_flying_gripper
  • Run stretch_gamepad_teleop

Please also try the Improved Manipulation mapping: #22

@hello-robot-shehab hello-robot-shehab changed the base branch from main to feature/flying-gripper-control-mode May 22, 2026 23:53
@hello-robot-shehab hello-robot-shehab force-pushed the feature/flying-gripper-control-mode branch from 1f1fca3 to c6e8725 Compare June 8, 2026 22:09
Base automatically changed from feature/flying-gripper-control-mode to main June 9, 2026 20:02
Flying Gripper mapping by default.
Tap Y to switch between Flying Gripper mapping and Direct Control mapping
When you launch stretch_gamepad_teleop default settings:
Medium Speed
Medium Strength
Flying Gripper Mapping (Control Mode 1)

Based on the feedback I got and my recent experience at UNH, I propose Direct Control Mapping to be the following, which fits everything on the controller except wrist roll (which would need the right trigger):
Left Trigger for precision mode (Analog - the more you press, the slower it moves)
D-pad up/down for lift
D-pad left/right for arm
Left Stick for Omnibase translation
Right Trigger + Left Stick Makes the robot move in a straight line (Makes the analog stick 1/0 in either direction), useful for docking and moving in tight spaces.

Right Stick for Pitch and Yaw
Right Trigger + D-pad for Pitch and Yaw for folks that like to use the d-pad for pitch/yaw (?)

Shoulder buttons for Omnibase rotate
Right Trigger + Shoulder buttons for Roll

A and B buttons for open close gripper (unchanged)
Changing Settings:
Y or Right Trigger + Y Change between Flying Gripper and Direct Control mappings (vibrates with a different sequence for each mode)
Right Trigger + A Cycle Speed (vibrates longer for more speed)
Right Trigger + B Cycle Strength (vibrates longer for more strength)
Right Trigger + Select Read out the current settings
When not homed: tap Start to home
Hold Right Trigger + Hold Select to stow
Hold Start or Right Trigger + Start for Left/Right Handed Mode
@hello-robot-shehab hello-robot-shehab force-pushed the feature/gamepad_mapping_easy_mode branch from 6acedca to cda911f Compare June 12, 2026 14:11
@hello-robot-shehab hello-robot-shehab marked this pull request as ready for review June 12, 2026 14:11
@hello-robot-shehab hello-robot-shehab force-pushed the feature/gamepad_mapping_easy_mode branch from c91c8e8 to ce7109a Compare June 17, 2026 20:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants