input: Documentation/input/xpad.txt: Update for new driver functionality
Subsystems (3)
PATCH 2/2 input: Documentation/input/xpad.txt: Update for new driver functionality
From: Mike Murphy <[email protected]>
Update to Documentation/input/xpad.txt to describe new driver functionality in this patchset.
[[email protected]: coding-style fixes]
Signed-off-by Mike Murphy <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Signed-off-by Andrew Morton <[email protected]>
---
Documentation/ABI/testing/game_device-sysfs-interface | 86 +++ Documentation/input/xpad.txt | 240 +++++++--- 2 files changed, 274 insertions(+), 52 deletions(-)
Documentation/ABI/testing/game_device-sysfs-interface new file +86 -0
@@ -0,0 +1,86 @@ +What: /sys/class/input/inputXX/game_device + (exact location depends on kernel and userspace rules) +Date: February 2009 +KernelVersion: 2.6.28 +Contact: Mike Murphy <[email protected]> +Description: The game_device subdirectory provides a mechanism for gaming + devices, such as joysticks and gamepads, to report information + and allow changes to calibration and behavior. The name of + this directory SHOULD be game_device for all drivers that + support it, and those drivers SHOULD have ABI documentation + in this file. However, the exact contents of the directory + MAY vary by device type, so that devices can expose whatever + properties and settings are appropriate for the hardware + and/or driver software. + + +What: game_device interface for the xpad driver + (drivers/input/joystick/xpad.c) +Date: February 2009 +KernelVersion: 2.6.28 +Contact: Mike Murphy <[email protected]> +Description: The game_device subdirectory for the Xbox/360 controller + driver provides the following files for retrieving information + and setting properties: + + left_dead_zone uint, read/write + right_dead_zone uint, read/write + + Set the size of the analog stick dead zones for the + left and right sticks, respectively. Minimum value + 0, default 8192, maximum 31743 (or 1024 less than + the stick_limit for the corresponding stick). + + left_stick_limit uint, read/write + right_stick_limit uint, read/write + + Set the square-axis limits of the analog left and + right sticks, respectively. Minimum value 1024, + default 32767, maximum 32767. The minimum is + constrained to be the size of the dead zone plus + 1024. See Documentation/input/xpad.txt for more + information. + + rumble_enable bool, read/write + + Enable or disable the controller's rumble effect. + Default 1 (enabled). + + left_trigger_full_axis bool, read/write + right_trigger_full_axis bool, read/write + + Enable or disable use of a full axis (-32767 to + +32767) for each of the left and right triggers, + respectively. Default 0 (disabled: use a half axis + from 0 to +32767). + + controller_number uint, read-only + + Controller slot number (1-4) for a wireless Xbox + 360 gaming receiver. This value will be zero for all + wired devices. + + controller_present bool, read-only + + Controller presence indicator for a wireless Xbox + 360 gaming receiver. Has the value 1 whenever the + controller is turned on and connected to the receiver + slot corresponding to the input device. This value + will always be 1 for all wired devices. + + controller_type uint, read-only + + Type of controller that is connected: + + 0 No controller connected + 1 Pad + 2 Guitar + 3 Dance pad + 255 Other/unknown type + + id string [17], read-only + + 16-character (plus NUL byte) presumably unique + identifier for each connected WIRELESS controller. + Presently, this value is an empty string for all + wired devices.
Documentation/input/xpad.txt renamed from Documentation/input/xpad.txt~input-documentation-input-xpadtxt-update-for-new-driver-functionality +188 -53
321 lines not on this page · raw message
_