xref: /OK3568_Linux_fs/kernel/Documentation/ABI/testing/sysfs-driver-hid-wiimote (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunWhat:		/sys/bus/hid/drivers/wiimote/<dev>/led1
2*4882a593SmuzhiyunWhat:		/sys/bus/hid/drivers/wiimote/<dev>/led2
3*4882a593SmuzhiyunWhat:		/sys/bus/hid/drivers/wiimote/<dev>/led3
4*4882a593SmuzhiyunWhat:		/sys/bus/hid/drivers/wiimote/<dev>/led4
5*4882a593SmuzhiyunDate:		July 2011
6*4882a593SmuzhiyunKernelVersion:	3.1
7*4882a593SmuzhiyunContact:	David Herrmann <dh.herrmann@googlemail.com>
8*4882a593SmuzhiyunDescription:	Make it possible to set/get current led state. Reading from it
9*4882a593Smuzhiyun		returns 0 if led is off and 1 if it is on. Writing 0 to it
10*4882a593Smuzhiyun		disables the led, writing 1 enables it.
11*4882a593Smuzhiyun
12*4882a593SmuzhiyunWhat:		/sys/bus/hid/drivers/wiimote/<dev>/extension
13*4882a593SmuzhiyunDate:		August 2011
14*4882a593SmuzhiyunKernelVersion:	3.2
15*4882a593SmuzhiyunContact:	David Herrmann <dh.herrmann@gmail.com>
16*4882a593SmuzhiyunDescription:	This file contains the currently connected and initialized
17*4882a593Smuzhiyun		extensions. It can be one of: none, motionp, nunchuck, classic,
18*4882a593Smuzhiyun		motionp+nunchuck, motionp+classic
19*4882a593Smuzhiyun		motionp is the official Nintendo Motion+ extension, nunchuck is
20*4882a593Smuzhiyun		the official Nintendo Nunchuck extension and classic is the
21*4882a593Smuzhiyun		Nintendo Classic Controller extension. The motionp extension can
22*4882a593Smuzhiyun		be combined with the other two.
23*4882a593Smuzhiyun
24*4882a593Smuzhiyun		Starting with kernel-version 3.11 Motion Plus hotplugging is
25*4882a593Smuzhiyun		supported and if detected, it's no longer reported as static
26*4882a593Smuzhiyun		extension. You will get uevent notifications for the motion-plus
27*4882a593Smuzhiyun		device then.
28*4882a593Smuzhiyun
29*4882a593SmuzhiyunWhat:		/sys/bus/hid/drivers/wiimote/<dev>/devtype
30*4882a593SmuzhiyunDate:		May 2013
31*4882a593SmuzhiyunKernelVersion:	3.11
32*4882a593SmuzhiyunContact:	David Herrmann <dh.herrmann@gmail.com>
33*4882a593SmuzhiyunDescription:	While a device is initialized by the wiimote driver, we perform
34*4882a593Smuzhiyun		a device detection and signal a "change" uevent after it is
35*4882a593Smuzhiyun		done. This file shows the detected device type. "pending" means
36*4882a593Smuzhiyun		that the detection is still ongoing, "unknown" means, that the
37*4882a593Smuzhiyun		device couldn't be detected or loaded. "generic" means, that the
38*4882a593Smuzhiyun		device couldn't be detected but supports basic Wii Remote
39*4882a593Smuzhiyun		features and can be used.
40*4882a593Smuzhiyun		Other strings for each device-type are available and may be
41*4882a593Smuzhiyun		added if new device-specific detections are added.
42*4882a593Smuzhiyun		Currently supported are:
43*4882a593Smuzhiyun
44*4882a593Smuzhiyun			============= =======================================
45*4882a593Smuzhiyun			gen10:        First Wii Remote generation
46*4882a593Smuzhiyun			gen20:        Second Wii Remote Plus generation
47*4882a593Smuzhiyun				      (builtin MP)
48*4882a593Smuzhiyun			balanceboard: Wii Balance Board
49*4882a593Smuzhiyun			============= =======================================
50*4882a593Smuzhiyun
51*4882a593SmuzhiyunWhat:		/sys/bus/hid/drivers/wiimote/<dev>/bboard_calib
52*4882a593SmuzhiyunDate:		May 2013
53*4882a593SmuzhiyunKernelVersion:	3.11
54*4882a593SmuzhiyunContact:	David Herrmann <dh.herrmann@gmail.com>
55*4882a593SmuzhiyunDescription:	This attribute is only provided if the device was detected as a
56*4882a593Smuzhiyun		balance board. It provides a single line with 3 calibration
57*4882a593Smuzhiyun		values for all 4 sensors. The values are separated by colons and
58*4882a593Smuzhiyun		are each 2 bytes long (encoded as 4 digit hexadecimal value).
59*4882a593Smuzhiyun		First, 0kg values for all 4 sensors are written, followed by the
60*4882a593Smuzhiyun		17kg values for all 4 sensors and last the 34kg values for all 4
61*4882a593Smuzhiyun		sensors.
62*4882a593Smuzhiyun
63*4882a593Smuzhiyun		Calibration data is already applied by the kernel to all input
64*4882a593Smuzhiyun		values but may be used by user-space to perform other
65*4882a593Smuzhiyun		transformations.
66*4882a593Smuzhiyun
67*4882a593SmuzhiyunWhat:		/sys/bus/hid/drivers/wiimote/<dev>/pro_calib
68*4882a593SmuzhiyunDate:		October 2013
69*4882a593SmuzhiyunKernelVersion:	3.13
70*4882a593SmuzhiyunContact:	David Herrmann <dh.herrmann@gmail.com>
71*4882a593SmuzhiyunDescription:	This attribute is only provided if the device was detected as a
72*4882a593Smuzhiyun		pro-controller. It provides a single line with 4 calibration
73*4882a593Smuzhiyun		values for all 4 analog sticks. Format is: "x1:y1 x2:y2". Data
74*4882a593Smuzhiyun		is prefixed with a +/-. Each value is a signed 16bit number.
75*4882a593Smuzhiyun		Data is encoded as decimal numbers and specifies the offsets of
76*4882a593Smuzhiyun		the analog sticks of the pro-controller.
77*4882a593Smuzhiyun
78*4882a593Smuzhiyun		Calibration data is already applied by the kernel to all input
79*4882a593Smuzhiyun		values but may be used by user-space to perform other
80*4882a593Smuzhiyun		transformations.
81*4882a593Smuzhiyun
82*4882a593Smuzhiyun		Calibration data is detected by the kernel during device setup.
83*4882a593Smuzhiyun		You can write "scan\n" into this file to re-trigger calibration.
84*4882a593Smuzhiyun		You can also write data directly in the form "x1:y1 x2:y2" to
85*4882a593Smuzhiyun		set the calibration values manually.
86