€•	‡      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ!/translations/zh_CN/input/gamepad”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/zh_TW/input/gamepad”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/it_IT/input/gamepad”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/ja_JP/input/gamepad”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/ko_KR/input/gamepad”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/sp_SP/input/gamepad”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒLinux Gamepad Specification”h]”hŒLinux Gamepad Specification”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒ;/var/lib/git/docbuild/linux/Documentation/input/gamepad.rst”h KubhŒ
field_list”“”)”}”(hhh]”hŒfield”“”)”}”(hhh]”(hŒ
field_name”“”)”}”(hŒAuthor”h]”hŒAuthor”…””}”(hhÃhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÁhh¾hŸh¶h K ubhŒ
field_body”“”)”}”(hŒ02013 by David Herrmann <dh.herrmann@gmail.com>

”h]”hŒ	paragraph”“”)”}”(hŒ.2013 by David Herrmann <dh.herrmann@gmail.com>”h]”(hŒ2013 by David Herrmann <”…””}”(hhÙhžhhŸNh NubhŒ	reference”“”)”}”(hŒdh.herrmann@gmail.com”h]”hŒdh.herrmann@gmail.com”…””}”(hhãhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:dh.herrmann@gmail.com”uh1háhhÙubhŒ>”…””}”(hhÙhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KhhÓubah}”(h]”h ]”h"]”h$]”h&]”uh1hÑhh¾ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h¼hŸh¶h Khh¹hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒIntroduction”h]”hŒIntroduction”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h K	ubhØ)”}”(hŒØLinux provides many different input drivers for gamepad hardware. To avoid
having user-space deal with different button-mappings for each gamepad, this
document defines how gamepads are supposed to report their data.”h]”hŒØLinux provides many different input drivers for gamepad hardware. To avoid
having user-space deal with different button-mappings for each gamepad, this
document defines how gamepads are supposed to report their data.”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K
hj  hžhubeh}”(h]”Œintroduction”ah ]”h"]”Œintroduction”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K	ubh¢)”}”(hhh]”(h§)”}”(hŒGeometry”h]”hŒGeometry”…””}”(hj9  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj6  hžhhŸh¶h KubhØ)”}”(hŒ=As "gamepad" we define devices which roughly look like this::”h]”hŒ@As â€œgamepadâ€ we define devices which roughly look like this:”…””}”(hjG  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Khj6  hžhubhŒliteral_block”“”)”}”(hX            ____________________________              __
         / [__ZL__]          [__ZR__] \               |
        / [__ TL __]        [__ TR __] \              | Front Triggers
     __/________________________________\__         __|
    /                                  _   \          |
   /      /\           __             (N)   \         |
  /       ||      __  |MO|  __     _       _ \        | Main Pad
 |    <===DP===> |SE|      |ST|   (W) -|- (E) |       |
  \       ||    ___          ___       _     /        |
  /\      \/   /   \        /   \     (S)   /\      __|
 /  \________ | LS  | ____ |  RS | ________/  \       |
|         /  \ \___/ /    \ \___/ /  \         |      | Control Sticks
|        /    \_____/      \_____/    \        |    __|
|       /                              \       |
 \_____/                                \_____/

     |________|______|    |______|___________|
       D-Pad    Left       Right   Action Pad
               Stick       Stick

                 |_____________|
                    Menu Pad”h]”hX            ____________________________              __
         / [__ZL__]          [__ZR__] \               |
        / [__ TL __]        [__ TR __] \              | Front Triggers
     __/________________________________\__         __|
    /                                  _   \          |
   /      /\           __             (N)   \         |
  /       ||      __  |MO|  __     _       _ \        | Main Pad
 |    <===DP===> |SE|      |ST|   (W) -|- (E) |       |
  \       ||    ___          ___       _     /        |
  /\      \/   /   \        /   \     (S)   /\      __|
 /  \________ | LS  | ____ |  RS | ________/  \       |
|         /  \ \___/ /    \ \___/ /  \         |      | Control Sticks
|        /    \_____/      \_____/    \        |    __|
|       /                              \       |
 \_____/                                \_____/

     |________|______|    |______|___________|
       D-Pad    Left       Right   Action Pad
               Stick       Stick

                 |_____________|
                    Menu Pad”…””}”hjW  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1jU  hŸh¶h Khj6  hžhubhØ)”}”(hŒ*Most gamepads have the following features:”h]”hŒ*Most gamepads have the following features:”…””}”(hjg  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K)hj6  hžhubhŒblock_quote”“”)”}”(hXH  - Action-Pad
  4 buttons in diamonds-shape (on the right side). The buttons are
  differently labeled on most devices so we define them as NORTH,
  SOUTH, WEST and EAST.
- D-Pad (Direction-pad)
  4 buttons (on the left side) that point up, down, left and right.
- Menu-Pad
  Different constellations, but most-times 2 buttons: SELECT - START
  Furthermore, many gamepads have a fancy branded button that is used as
  special system-button. It often looks different to the other buttons and
  is used to pop up system-menus or system-settings.
- Analog-Sticks
  Analog-sticks provide freely moveable sticks to control directions. Not
  all devices have both or any, but they are present at most times.
  Analog-sticks may also provide a digital button if you press them.
- Triggers
  Triggers are located on the upper-side of the pad in vertical direction.
  Not all devices provide them, but the upper buttons are normally named
  Left- and Right-Triggers, the lower buttons Z-Left and Z-Right.
- Rumble
  Many devices provide force-feedback features. But are mostly just
  simple rumble motors.
”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ¡Action-Pad
4 buttons in diamonds-shape (on the right side). The buttons are
differently labeled on most devices so we define them as NORTH,
SOUTH, WEST and EAST.”h]”hØ)”}”(hŒ¡Action-Pad
4 buttons in diamonds-shape (on the right side). The buttons are
differently labeled on most devices so we define them as NORTH,
SOUTH, WEST and EAST.”h]”hŒ¡Action-Pad
4 buttons in diamonds-shape (on the right side). The buttons are
differently labeled on most devices so we define them as NORTH,
SOUTH, WEST and EAST.”…””}”(hj†  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K+hj‚  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj}  ubj  )”}”(hŒWD-Pad (Direction-pad)
4 buttons (on the left side) that point up, down, left and right.”h]”hØ)”}”(hŒWD-Pad (Direction-pad)
4 buttons (on the left side) that point up, down, left and right.”h]”hŒWD-Pad (Direction-pad)
4 buttons (on the left side) that point up, down, left and right.”…””}”(hjž  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K/hjš  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj}  ubj  )”}”(hX  Menu-Pad
Different constellations, but most-times 2 buttons: SELECT - START
Furthermore, many gamepads have a fancy branded button that is used as
special system-button. It often looks different to the other buttons and
is used to pop up system-menus or system-settings.”h]”hØ)”}”(hX  Menu-Pad
Different constellations, but most-times 2 buttons: SELECT - START
Furthermore, many gamepads have a fancy branded button that is used as
special system-button. It often looks different to the other buttons and
is used to pop up system-menus or system-settings.”h]”hX  Menu-Pad
Different constellations, but most-times 2 buttons: SELECT - START
Furthermore, many gamepads have a fancy branded button that is used as
special system-button. It often looks different to the other buttons and
is used to pop up system-menus or system-settings.”…””}”(hj¶  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K1hj²  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj}  ubj  )”}”(hŒÚAnalog-Sticks
Analog-sticks provide freely moveable sticks to control directions. Not
all devices have both or any, but they are present at most times.
Analog-sticks may also provide a digital button if you press them.”h]”hØ)”}”(hŒÚAnalog-Sticks
Analog-sticks provide freely moveable sticks to control directions. Not
all devices have both or any, but they are present at most times.
Analog-sticks may also provide a digital button if you press them.”h]”hŒÚAnalog-Sticks
Analog-sticks provide freely moveable sticks to control directions. Not
all devices have both or any, but they are present at most times.
Analog-sticks may also provide a digital button if you press them.”…””}”(hjÎ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K6hjÊ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj}  ubj  )”}”(hŒØTriggers
Triggers are located on the upper-side of the pad in vertical direction.
Not all devices provide them, but the upper buttons are normally named
Left- and Right-Triggers, the lower buttons Z-Left and Z-Right.”h]”hØ)”}”(hŒØTriggers
Triggers are located on the upper-side of the pad in vertical direction.
Not all devices provide them, but the upper buttons are normally named
Left- and Right-Triggers, the lower buttons Z-Left and Z-Right.”h]”hŒØTriggers
Triggers are located on the upper-side of the pad in vertical direction.
Not all devices provide them, but the upper buttons are normally named
Left- and Right-Triggers, the lower buttons Z-Left and Z-Right.”…””}”(hjæ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K:hjâ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj}  ubj  )”}”(hŒ_Rumble
Many devices provide force-feedback features. But are mostly just
simple rumble motors.
”h]”hØ)”}”(hŒ^Rumble
Many devices provide force-feedback features. But are mostly just
simple rumble motors.”h]”hŒ^Rumble
Many devices provide force-feedback features. But are mostly just
simple rumble motors.”…””}”(hjþ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K>hjú  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj}  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j{  hŸh¶h K+hjw  ubah}”(h]”h ]”h"]”h$]”h&]”uh1ju  hŸh¶h K+hj6  hžhubeh}”(h]”Œgeometry”ah ]”h"]”Œgeometry”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ	Detection”h]”hŒ	Detection”…””}”(hj+  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj(  hžhhŸh¶h KCubhØ)”}”(hX3  All gamepads that follow the protocol described here map BTN_GAMEPAD. This is
an alias for BTN_SOUTH/BTN_A. It can be used to identify a gamepad as such.
However, not all gamepads provide all features, so you need to test for all
features that you need, first. How each feature is mapped is described below.”h]”hX3  All gamepads that follow the protocol described here map BTN_GAMEPAD. This is
an alias for BTN_SOUTH/BTN_A. It can be used to identify a gamepad as such.
However, not all gamepads provide all features, so you need to test for all
features that you need, first. How each feature is mapped is described below.”…””}”(hj9  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KEhj(  hžhubhØ)”}”(hX  Legacy drivers often don't comply to these rules. As we cannot change them
for backwards-compatibility reasons, you need to provide fixup mappings in
user-space yourself. Some of them might also provide module-options that
change the mappings so you can advise users to set these.”h]”hX  Legacy drivers often donâ€™t comply to these rules. As we cannot change them
for backwards-compatibility reasons, you need to provide fixup mappings in
user-space yourself. Some of them might also provide module-options that
change the mappings so you can advise users to set these.”…””}”(hjG  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KJhj(  hžhubhØ)”}”(hŒaAll new gamepads are supposed to comply with this mapping. Please report any
bugs, if they don't.”h]”hŒcAll new gamepads are supposed to comply with this mapping. Please report any
bugs, if they donâ€™t.”…””}”(hjU  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KOhj(  hžhubhØ)”}”(hX5  There are a lot of less-featured/less-powerful devices out there, which re-use
the buttons from this protocol. However, they try to do this in a compatible
fashion. For example, the "Nintendo Wii Nunchuk" provides two trigger buttons
and one analog stick. It reports them as if it were a gamepad with only one
analog stick and two trigger buttons on the right side.
But that means, that if you only support "real" gamepads, you must test
devices for _all_ reported events that you need. Otherwise, you will also get
devices that report a small subset of the events.”h]”hX=  There are a lot of less-featured/less-powerful devices out there, which re-use
the buttons from this protocol. However, they try to do this in a compatible
fashion. For example, the â€œNintendo Wii Nunchukâ€ provides two trigger buttons
and one analog stick. It reports them as if it were a gamepad with only one
analog stick and two trigger buttons on the right side.
But that means, that if you only support â€œrealâ€ gamepads, you must test
devices for _all_ reported events that you need. Otherwise, you will also get
devices that report a small subset of the events.”…””}”(hjc  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KRhj(  hžhubhØ)”}”(hŒRNo other devices, that do not look/feel like a gamepad, shall report these
events.”h]”hŒRNo other devices, that do not look/feel like a gamepad, shall report these
events.”…””}”(hjq  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K[hj(  hžhubeh}”(h]”Œ	detection”ah ]”h"]”Œ	detection”ah$]”h&]”uh1h¡hh£hžhhŸh¶h KCubh¢)”}”(hhh]”(h§)”}”(hŒEvents”h]”hŒEvents”…””}”(hjŠ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj‡  hžhhŸh¶h K_ubhØ)”}”(hŒ%Gamepads report the following events:”h]”hŒ%Gamepads report the following events:”…””}”(hj˜  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kahj‡  hžhubj|  )”}”(hhh]”(j  )”}”(hXó  Action-Pad:

Every gamepad device has at least 2 action buttons. This means, that every
device reports BTN_SOUTH (which BTN_GAMEPAD is an alias for). Regardless
of the labels on the buttons, the codes are sent according to the
physical position of the buttons.

Please note that 2- and 3-button pads are fairly rare and old. You might
want to filter gamepads that do not report all four.

  - 2-Button Pad:

    If only 2 action-buttons are present, they are reported as BTN_SOUTH and
    BTN_EAST. For vertical layouts, the upper button is BTN_EAST. For
    horizontal layouts, the button more on the right is BTN_EAST.

  - 3-Button Pad:

    If only 3 action-buttons are present, they are reported as (from left
    to right): BTN_WEST, BTN_SOUTH, BTN_EAST
    If the buttons are aligned perfectly vertically, they are reported as
    (from top down): BTN_WEST, BTN_SOUTH, BTN_EAST

  - 4-Button Pad:

    If all 4 action-buttons are present, they can be aligned in two
    different formations. If diamond-shaped, they are reported as BTN_NORTH,
    BTN_WEST, BTN_SOUTH, BTN_EAST according to their physical location.
    If rectangular-shaped, the upper-left button is BTN_NORTH, lower-left
    is BTN_WEST, lower-right is BTN_SOUTH and upper-right is BTN_EAST.
”h]”(hØ)”}”(hŒAction-Pad:”h]”hŒAction-Pad:”…””}”(hj­  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kchj©  ubhØ)”}”(hŒ÷Every gamepad device has at least 2 action buttons. This means, that every
device reports BTN_SOUTH (which BTN_GAMEPAD is an alias for). Regardless
of the labels on the buttons, the codes are sent according to the
physical position of the buttons.”h]”hŒ÷Every gamepad device has at least 2 action buttons. This means, that every
device reports BTN_SOUTH (which BTN_GAMEPAD is an alias for). Regardless
of the labels on the buttons, the codes are sent according to the
physical position of the buttons.”…””}”(hj»  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kehj©  ubhØ)”}”(hŒ}Please note that 2- and 3-button pads are fairly rare and old. You might
want to filter gamepads that do not report all four.”h]”hŒ}Please note that 2- and 3-button pads are fairly rare and old. You might
want to filter gamepads that do not report all four.”…””}”(hjÉ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kjhj©  ubjv  )”}”(hXP  - 2-Button Pad:

  If only 2 action-buttons are present, they are reported as BTN_SOUTH and
  BTN_EAST. For vertical layouts, the upper button is BTN_EAST. For
  horizontal layouts, the button more on the right is BTN_EAST.

- 3-Button Pad:

  If only 3 action-buttons are present, they are reported as (from left
  to right): BTN_WEST, BTN_SOUTH, BTN_EAST
  If the buttons are aligned perfectly vertically, they are reported as
  (from top down): BTN_WEST, BTN_SOUTH, BTN_EAST

- 4-Button Pad:

  If all 4 action-buttons are present, they can be aligned in two
  different formations. If diamond-shaped, they are reported as BTN_NORTH,
  BTN_WEST, BTN_SOUTH, BTN_EAST according to their physical location.
  If rectangular-shaped, the upper-left button is BTN_NORTH, lower-left
  is BTN_WEST, lower-right is BTN_SOUTH and upper-right is BTN_EAST.
”h]”j|  )”}”(hhh]”(j  )”}”(hŒØ2-Button Pad:

If only 2 action-buttons are present, they are reported as BTN_SOUTH and
BTN_EAST. For vertical layouts, the upper button is BTN_EAST. For
horizontal layouts, the button more on the right is BTN_EAST.
”h]”(hØ)”}”(hŒ2-Button Pad:”h]”hŒ2-Button Pad:”…””}”(hjâ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KmhjÞ  ubhØ)”}”(hŒÈIf only 2 action-buttons are present, they are reported as BTN_SOUTH and
BTN_EAST. For vertical layouts, the upper button is BTN_EAST. For
horizontal layouts, the button more on the right is BTN_EAST.”h]”hŒÈIf only 2 action-buttons are present, they are reported as BTN_SOUTH and
BTN_EAST. For vertical layouts, the upper button is BTN_EAST. For
horizontal layouts, the button more on the right is BTN_EAST.”…””}”(hjð  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KohjÞ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hjÛ  ubj  )”}”(hŒó3-Button Pad:

If only 3 action-buttons are present, they are reported as (from left
to right): BTN_WEST, BTN_SOUTH, BTN_EAST
If the buttons are aligned perfectly vertically, they are reported as
(from top down): BTN_WEST, BTN_SOUTH, BTN_EAST
”h]”(hØ)”}”(hŒ3-Button Pad:”h]”hŒ3-Button Pad:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kshj  ubhØ)”}”(hŒãIf only 3 action-buttons are present, they are reported as (from left
to right): BTN_WEST, BTN_SOUTH, BTN_EAST
If the buttons are aligned perfectly vertically, they are reported as
(from top down): BTN_WEST, BTN_SOUTH, BTN_EAST”h]”hŒãIf only 3 action-buttons are present, they are reported as (from left
to right): BTN_WEST, BTN_SOUTH, BTN_EAST
If the buttons are aligned perfectly vertically, they are reported as
(from top down): BTN_WEST, BTN_SOUTH, BTN_EAST”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kuhj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hjÛ  ubj  )”}”(hXe  4-Button Pad:

If all 4 action-buttons are present, they can be aligned in two
different formations. If diamond-shaped, they are reported as BTN_NORTH,
BTN_WEST, BTN_SOUTH, BTN_EAST according to their physical location.
If rectangular-shaped, the upper-left button is BTN_NORTH, lower-left
is BTN_WEST, lower-right is BTN_SOUTH and upper-right is BTN_EAST.
”h]”(hØ)”}”(hŒ4-Button Pad:”h]”hŒ4-Button Pad:”…””}”(hj.  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kzhj*  ubhØ)”}”(hXU  If all 4 action-buttons are present, they can be aligned in two
different formations. If diamond-shaped, they are reported as BTN_NORTH,
BTN_WEST, BTN_SOUTH, BTN_EAST according to their physical location.
If rectangular-shaped, the upper-left button is BTN_NORTH, lower-left
is BTN_WEST, lower-right is BTN_SOUTH and upper-right is BTN_EAST.”h]”hXU  If all 4 action-buttons are present, they can be aligned in two
different formations. If diamond-shaped, they are reported as BTN_NORTH,
BTN_WEST, BTN_SOUTH, BTN_EAST according to their physical location.
If rectangular-shaped, the upper-left button is BTN_NORTH, lower-left
is BTN_WEST, lower-right is BTN_SOUTH and upper-right is BTN_EAST.”…””}”(hj<  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K|hj*  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hjÛ  ubeh}”(h]”h ]”h"]”h$]”h&]”j  j  uh1j{  hŸh¶h Kmhj×  ubah}”(h]”h ]”h"]”h$]”h&]”uh1ju  hŸh¶h Kmhj©  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj¦  hžhhŸh¶h Nubj  )”}”(hXô  D-Pad:

Every gamepad provides a D-Pad with four directions: Up, Down, Left, Right
Some of these are available as digital buttons, some as analog buttons. Some
may even report both. The kernel does not convert between these so
applications should support both and choose what is more appropriate if
both are reported.

  - Digital buttons are reported as:

    BTN_DPAD_*

  - Analog buttons are reported as:

    ABS_HAT0X and ABS_HAT0Y

(for ABS values negative is left/up, positive is right/down)
”h]”(hØ)”}”(hŒD-Pad:”h]”hŒD-Pad:”…””}”(hjf  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K‚hjb  ubhØ)”}”(hX5  Every gamepad provides a D-Pad with four directions: Up, Down, Left, Right
Some of these are available as digital buttons, some as analog buttons. Some
may even report both. The kernel does not convert between these so
applications should support both and choose what is more appropriate if
both are reported.”h]”hX5  Every gamepad provides a D-Pad with four directions: Up, Down, Left, Right
Some of these are available as digital buttons, some as analog buttons. Some
may even report both. The kernel does not convert between these so
applications should support both and choose what is more appropriate if
both are reported.”…””}”(hjt  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K„hjb  ubjv  )”}”(hŒo- Digital buttons are reported as:

  BTN_DPAD_*

- Analog buttons are reported as:

  ABS_HAT0X and ABS_HAT0Y
”h]”j|  )”}”(hhh]”(j  )”}”(hŒ-Digital buttons are reported as:

BTN_DPAD_*
”h]”(hØ)”}”(hŒ Digital buttons are reported as:”h]”hŒ Digital buttons are reported as:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KŠhj‰  ubhØ)”}”(hŒ
BTN_DPAD_*”h]”hŒ
BTN_DPAD_*”…””}”(hj›  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KŒhj‰  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj†  ubj  )”}”(hŒ9Analog buttons are reported as:

ABS_HAT0X and ABS_HAT0Y
”h]”(hØ)”}”(hŒAnalog buttons are reported as:”h]”hŒAnalog buttons are reported as:”…””}”(hj³  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KŽhj¯  ubhØ)”}”(hŒABS_HAT0X and ABS_HAT0Y”h]”hŒABS_HAT0X and ABS_HAT0Y”…””}”(hjÁ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Khj¯  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj†  ubeh}”(h]”h ]”h"]”h$]”h&]”j  j  uh1j{  hŸh¶h KŠhj‚  ubah}”(h]”h ]”h"]”h$]”h&]”uh1ju  hŸh¶h KŠhjb  ubhØ)”}”(hŒ<(for ABS values negative is left/up, positive is right/down)”h]”hŒ<(for ABS values negative is left/up, positive is right/down)”…””}”(hjá  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K’hjb  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj¦  hžhhŸh¶h Nubj  )”}”(hX_  Analog-Sticks:

The left analog-stick is reported as ABS_X, ABS_Y. The right analog stick is
reported as ABS_RX, ABS_RY. Zero, one or two sticks may be present.
If analog-sticks provide digital buttons, they are mapped accordingly as
BTN_THUMBL (first/left) and BTN_THUMBR (second/right).

(for ABS values negative is left/up, positive is right/down)
”h]”(hØ)”}”(hŒAnalog-Sticks:”h]”hŒAnalog-Sticks:”…””}”(hjù  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K”hjõ  ubhØ)”}”(hX  The left analog-stick is reported as ABS_X, ABS_Y. The right analog stick is
reported as ABS_RX, ABS_RY. Zero, one or two sticks may be present.
If analog-sticks provide digital buttons, they are mapped accordingly as
BTN_THUMBL (first/left) and BTN_THUMBR (second/right).”h]”hX  The left analog-stick is reported as ABS_X, ABS_Y. The right analog stick is
reported as ABS_RX, ABS_RY. Zero, one or two sticks may be present.
If analog-sticks provide digital buttons, they are mapped accordingly as
BTN_THUMBL (first/left) and BTN_THUMBR (second/right).”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K–hjõ  ubhØ)”}”(hŒ<(for ABS values negative is left/up, positive is right/down)”h]”hŒ<(for ABS values negative is left/up, positive is right/down)”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K›hjõ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj¦  hžhhŸh¶h Nubj  )”}”(hX>  Triggers:

Trigger buttons can be available as digital or analog buttons or both. User-
space must correctly deal with any situation and choose the most appropriate
mode.

Upper trigger buttons are reported as BTN_TR or ABS_HAT1X (right) and BTN_TL
or ABS_HAT1Y (left). Lower trigger buttons are reported as BTN_TR2 or
ABS_HAT2X (right/ZR) and BTN_TL2 or ABS_HAT2Y (left/ZL).

If only one trigger-button combination is present (upper+lower), they are
reported as "right" triggers (BTN_TR/ABS_HAT1X).

(ABS trigger values start at 0, pressure is reported as positive values)
”h]”(hØ)”}”(hŒ	Triggers:”h]”hŒ	Triggers:”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Khj)  ubhØ)”}”(hŒŸTrigger buttons can be available as digital or analog buttons or both. User-
space must correctly deal with any situation and choose the most appropriate
mode.”h]”hŒŸTrigger buttons can be available as digital or analog buttons or both. User-
space must correctly deal with any situation and choose the most appropriate
mode.”…””}”(hj;  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KŸhj)  ubhØ)”}”(hŒËUpper trigger buttons are reported as BTN_TR or ABS_HAT1X (right) and BTN_TL
or ABS_HAT1Y (left). Lower trigger buttons are reported as BTN_TR2 or
ABS_HAT2X (right/ZR) and BTN_TL2 or ABS_HAT2Y (left/ZL).”h]”hŒËUpper trigger buttons are reported as BTN_TR or ABS_HAT1X (right) and BTN_TL
or ABS_HAT1Y (left). Lower trigger buttons are reported as BTN_TR2 or
ABS_HAT2X (right/ZR) and BTN_TL2 or ABS_HAT2Y (left/ZL).”…””}”(hjI  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K£hj)  ubhØ)”}”(hŒzIf only one trigger-button combination is present (upper+lower), they are
reported as "right" triggers (BTN_TR/ABS_HAT1X).”h]”hŒ~If only one trigger-button combination is present (upper+lower), they are
reported as â€œrightâ€ triggers (BTN_TR/ABS_HAT1X).”…””}”(hjW  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K§hj)  ubhØ)”}”(hŒH(ABS trigger values start at 0, pressure is reported as positive values)”h]”hŒH(ABS trigger values start at 0, pressure is reported as positive values)”…””}”(hje  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kªhj)  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj¦  hžhhŸh¶h Nubj  )”}”(hXà  Menu-Pad:

Menu buttons are always digital and are mapped according to their location
instead of their labels. That is:

  - 1-button Pad:

    Mapped as BTN_START

  - 2-button Pad:

    Left button mapped as BTN_SELECT, right button mapped as BTN_START

Many pads also have a third button which is branded or has a special symbol
and meaning. Such buttons are mapped as BTN_MODE. Examples are the Nintendo
"HOME" button, the Xbox "X" button or the Sony PlayStation "PS" button.
”h]”(hØ)”}”(hŒ	Menu-Pad:”h]”hŒ	Menu-Pad:”…””}”(hj}  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K¬hjy  ubhØ)”}”(hŒlMenu buttons are always digital and are mapped according to their location
instead of their labels. That is:”h]”hŒlMenu buttons are always digital and are mapped according to their location
instead of their labels. That is:”…””}”(hj‹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K®hjy  ubjv  )”}”(hŒ~- 1-button Pad:

  Mapped as BTN_START

- 2-button Pad:

  Left button mapped as BTN_SELECT, right button mapped as BTN_START
”h]”j|  )”}”(hhh]”(j  )”}”(hŒ#1-button Pad:

Mapped as BTN_START
”h]”(hØ)”}”(hŒ1-button Pad:”h]”hŒ1-button Pad:”…””}”(hj¤  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K±hj   ubhØ)”}”(hŒMapped as BTN_START”h]”hŒMapped as BTN_START”…””}”(hj²  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K³hj   ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj  ubj  )”}”(hŒR2-button Pad:

Left button mapped as BTN_SELECT, right button mapped as BTN_START
”h]”(hØ)”}”(hŒ2-button Pad:”h]”hŒ2-button Pad:”…””}”(hjÊ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KµhjÆ  ubhØ)”}”(hŒBLeft button mapped as BTN_SELECT, right button mapped as BTN_START”h]”hŒBLeft button mapped as BTN_SELECT, right button mapped as BTN_START”…””}”(hjØ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K·hjÆ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”j  j  uh1j{  hŸh¶h K±hj™  ubah}”(h]”h ]”h"]”h$]”h&]”uh1ju  hŸh¶h K±hjy  ubhØ)”}”(hŒßMany pads also have a third button which is branded or has a special symbol
and meaning. Such buttons are mapped as BTN_MODE. Examples are the Nintendo
"HOME" button, the Xbox "X" button or the Sony PlayStation "PS" button.”h]”hŒëMany pads also have a third button which is branded or has a special symbol
and meaning. Such buttons are mapped as BTN_MODE. Examples are the Nintendo
â€œHOMEâ€ button, the Xbox â€œXâ€ button or the Sony PlayStation â€œPSâ€ button.”…””}”(hjø  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K¹hjy  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj¦  hžhhŸh¶h Nubj  )”}”(hŒ,Rumble:

Rumble is advertised as FF_RUMBLE.
”h]”(hØ)”}”(hŒRumble:”h]”hŒRumble:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K½hj  ubhØ)”}”(hŒ"Rumble is advertised as FF_RUMBLE.”h]”hŒ"Rumble is advertised as FF_RUMBLE.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K¿hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj¦  hžhhŸh¶h Nubj  )”}”(hŒéProfile:

Some pads provide a multi-value profile selection switch.  An example is the
XBox Adaptive and the XBox Elite 2 controllers.  When the active profile is
switched, its newly selected value is emitted as an ABS_PROFILE event.”h]”(hØ)”}”(hŒProfile:”h]”hŒProfile:”…””}”(hj6  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÁhj2  ubhØ)”}”(hŒßSome pads provide a multi-value profile selection switch.  An example is the
XBox Adaptive and the XBox Elite 2 controllers.  When the active profile is
switched, its newly selected value is emitted as an ABS_PROFILE event.”h]”hŒßSome pads provide a multi-value profile selection switch.  An example is the
XBox Adaptive and the XBox Elite 2 controllers.  When the active profile is
switched, its newly selected value is emitted as an ABS_PROFILE event.”…””}”(hjD  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÃhj2  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j€  hj¦  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”j  j  uh1j{  hŸh¶h Kchj‡  hžhubeh}”(h]”Œevents”ah ]”h"]”Œevents”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K_ubeh}”(h]”Œlinux-gamepad-specification”ah ]”h"]”Œlinux gamepad specification”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h¶uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¦NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j‘  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h¶Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jk  jh  j3  j0  j%  j"  j„  j  jc  j`  uŒ	nametypes”}”(jk  ‰j3  ‰j%  ‰j„  ‰jc  ‰uh}”(jh  h£j0  j  j"  j6  j  j(  j`  j‡  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.