extreme3dpro_driver
Axis & Button Map
Physical layout and Linux evdev index mapping for the Logitech Extreme 3D Pro
Axis & Button Map
Hardware layout as reported by the Linux joystick kernel driver.
Axes
| Index | Name | Physical Control | Normalised Range |
|---|---|---|---|
0 | X | Stick left / right (roll) | −1.0 … +1.0 |
1 | Y | Stick forward / back (pitch) | −1.0 … +1.0 |
2 | Rz | Stick twist (yaw) | −1.0 … +1.0 |
3 | Throttle | Base slider | −1.0 … +1.0 |
4 | Hat X | Hat switch horizontal | −1, 0, +1 |
5 | Hat Y | Hat switch vertical | −1, 0, +1 |
Buttons
| Index | Label | Location |
|---|---|---|
0 | Trigger | Index finger — front of stick |
1 | Thumb | Top of stick |
2–5 | Buttons 3–6 | Top of stick |
6–11 | Buttons 7–12 | Base cluster |
Twist Mapping
When publish_twist: true and the deadman button is held, axes map to geometry_msgs/Twist:
Y and Yaw are inverted so that pushing forward → +x and twisting CCW → +z, matching ROS REP-103 conventions.
Debugging Raw Input
Inspect the raw device before running the driver:
# jstest (sudo apt install joystick)
jstest /dev/input/js0
# evtest (sudo apt install evtest)
sudo evtest /dev/input/event<N>