linux-yocto/Documentation/ABI/testing/sysfs-driver-hid-wiimote
Mauro Carvalho Chehab 54a19b4d3f docs: ABI: cleanup several ABI documents
There are some ABI documents that, while they don't generate
any warnings, they have issues when parsed by get_abi.pl script
on its output result.

Address them, in order to provide a clean output.

Reviewed-by: Tom Rix <trix@redhat.com> # for fpga-manager
Reviewed-By: Kajol Jain<kjain@linux.ibm.com> # for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7
Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for IIO
Acked-by: Oded Gabbay <oded.gabbay@gmail.com> # for Habanalabs
Acked-by: Vaibhav Jain <vaibhav@linux.ibm.com> # for sysfs-bus-papr-pmem
Acked-by: Cezary Rojewski <cezary.rojewski@intel.com> # for catpt
Acked-by: Suzuki K Poulose <suzuki.poulose@arm.com>
Acked-by: Ilya Dryomov <idryomov@gmail.com> # for rbd
Acked-by: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/5bc78e5b68ed1e9e39135173857cb2e753be868f.1604042072.git.mchehab+huawei@kernel.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2020-10-30 13:14:29 +01:00

3.7 KiB

What: /sys/bus/hid/drivers/wiimote//led1 What: /sys/bus/hid/drivers/wiimote//led2 What: /sys/bus/hid/drivers/wiimote//led3 What: /sys/bus/hid/drivers/wiimote//led4 Date: July 2011 KernelVersion: 3.1 Contact: David Herrmann dh.herrmann@googlemail.com Description: Make it possible to set/get current led state. Reading from it returns 0 if led is off and 1 if it is on. Writing 0 to it disables the led, writing 1 enables it.

What: /sys/bus/hid/drivers/wiimote//extension Date: August 2011 KernelVersion: 3.2 Contact: David Herrmann dh.herrmann@gmail.com Description: This file contains the currently connected and initialized extensions. It can be one of: none, motionp, nunchuck, classic, motionp+nunchuck, motionp+classic motionp is the official Nintendo Motion+ extension, nunchuck is the official Nintendo Nunchuck extension and classic is the Nintendo Classic Controller extension. The motionp extension can be combined with the other two.

	Starting with kernel-version 3.11 Motion Plus hotplugging is
	supported and if detected, it's no longer reported as static
	extension. You will get uevent notifications for the motion-plus
	device then.

What: /sys/bus/hid/drivers/wiimote//devtype Date: May 2013 KernelVersion: 3.11 Contact: David Herrmann dh.herrmann@gmail.com Description: While a device is initialized by the wiimote driver, we perform a device detection and signal a "change" uevent after it is done. This file shows the detected device type. "pending" means that the detection is still ongoing, "unknown" means, that the device couldn't be detected or loaded. "generic" means, that the device couldn't be detected but supports basic Wii Remote features and can be used. Other strings for each device-type are available and may be added if new device-specific detections are added. Currently supported are:

		============= =======================================
		gen10:        First Wii Remote generation
		gen20:        Second Wii Remote Plus generation
			      (builtin MP)
		balanceboard: Wii Balance Board
		============= =======================================

What: /sys/bus/hid/drivers/wiimote//bboard_calib Date: May 2013 KernelVersion: 3.11 Contact: David Herrmann dh.herrmann@gmail.com Description: This attribute is only provided if the device was detected as a balance board. It provides a single line with 3 calibration values for all 4 sensors. The values are separated by colons and are each 2 bytes long (encoded as 4 digit hexadecimal value). First, 0kg values for all 4 sensors are written, followed by the 17kg values for all 4 sensors and last the 34kg values for all 4 sensors.

	Calibration data is already applied by the kernel to all input
	values but may be used by user-space to perform other
	transformations.

What: /sys/bus/hid/drivers/wiimote//pro_calib Date: October 2013 KernelVersion: 3.13 Contact: David Herrmann dh.herrmann@gmail.com Description: This attribute is only provided if the device was detected as a pro-controller. It provides a single line with 4 calibration values for all 4 analog sticks. Format is: "x1:y1 x2:y2". Data is prefixed with a +/-. Each value is a signed 16bit number. Data is encoded as decimal numbers and specifies the offsets of the analog sticks of the pro-controller.

	Calibration data is already applied by the kernel to all input
	values but may be used by user-space to perform other
	transformations.

	Calibration data is detected by the kernel during device setup.
	You can write "scan\n" into this file to re-trigger calibration.
	You can also write data directly in the form "x1:y1 x2:y2" to
	set the calibration values manually.