8dab91970a
Rename the leds documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> Acked-by: Pavel Machek <pavel@ucw.cz> Signed-off-by: Jacek Anaszewski <jacek.anaszewski@gmail.com>
47 lines
1.4 KiB
ReStructuredText
47 lines
1.4 KiB
ReStructuredText
====================
|
|
USB port LED trigger
|
|
====================
|
|
|
|
This LED trigger can be used for signalling to the user a presence of USB device
|
|
in a given port. It simply turns on LED when device appears and turns it off
|
|
when it disappears.
|
|
|
|
It requires selecting USB ports that should be observed. All available ones are
|
|
listed as separated entries in a "ports" subdirectory. Selecting is handled by
|
|
echoing "1" to a chosen port.
|
|
|
|
Please note that this trigger allows selecting multiple USB ports for a single
|
|
LED.
|
|
|
|
This can be useful in two cases:
|
|
|
|
1) Device with single USB LED and few physical ports
|
|
====================================================
|
|
|
|
In such a case LED will be turned on as long as there is at least one connected
|
|
USB device.
|
|
|
|
2) Device with a physical port handled by few controllers
|
|
=========================================================
|
|
|
|
Some devices may have one controller per PHY standard. E.g. USB 3.0 physical
|
|
port may be handled by ohci-platform, ehci-platform and xhci-hcd. If there is
|
|
only one LED user will most likely want to assign ports from all 3 hubs.
|
|
|
|
|
|
This trigger can be activated from user space on led class devices as shown
|
|
below::
|
|
|
|
echo usbport > trigger
|
|
|
|
This adds sysfs attributes to the LED that are documented in:
|
|
Documentation/ABI/testing/sysfs-class-led-trigger-usbport
|
|
|
|
Example use-case::
|
|
|
|
echo usbport > trigger
|
|
echo 1 > ports/usb1-port1
|
|
echo 1 > ports/usb2-port1
|
|
cat ports/usb1-port1
|
|
echo 0 > ports/usb1-port1
|