leds: add new LED_FUNCTION_PLAYER for player LEDs for game controllers.
authorRoderick Colenbrander <roderick@gaikai.com>
Wed, 8 Sep 2021 16:55:38 +0000 (09:55 -0700)
committerJiri Kosina <jkosina@suse.cz>
Wed, 27 Oct 2021 07:49:29 +0000 (09:49 +0200)
commit61177c088a57bed259122f3c7bc6d61984936a12
treec41c70138c7968119a288a678df9060cc3d72e25
parentfc97b4d6a1a6d418fd4053fd7716eca746fdd163
leds: add new LED_FUNCTION_PLAYER for player LEDs for game controllers.

Player LEDs are commonly found on game controllers from Nintendo and Sony
to indicate a player ID across a number of LEDs. For example, "Player 2"
might be indicated as "-x--" on a device with 4 LEDs where "x" means on.

This patch introduces LED_FUNCTION_PLAYER1-5 defines to properly indicate
player LEDs from the kernel. Until now there was no good standard, which
resulted in inconsistent behavior across xpad, hid-sony, hid-wiimote and
other drivers. Moving forward new drivers should use LED_FUNCTION_PLAYERx.

Note: management of Player IDs is left to user space, though a kernel
driver may pick a default value.

Signed-off-by: Roderick Colenbrander <roderick.colenbrander@sony.com>
Acked-by: Pavel Machek <pavel@ucw.cz>
Signed-off-by: Jiri Kosina <jkosina@suse.cz>
Documentation/leds/well-known-leds.txt
include/dt-bindings/leds/common.h