Changes between Initial Version and Version 1 of linux/led

Timestamp:

10/22/2017 05:28:45 AM (7 years ago)

Author:

trac

Comment:

--

linux/led

@@ +1 @@
+{{{#!html
+          <div id="wikipage" class="trac-content"><p>
+</p><div class="wiki-toc">
+<ol>
+  <li>
+    <a href="#LinuxLEDclassforGPIOandPWMcontrolledLEDs">Linux LED class for GPIO (and PWM) controlled LEDs</a>
+    <ol>
+      <li>
+        <a href="#LEDTriggers">LED Triggers</a>
+      </li>
+    </ol>
+  </li>
+  <li>
+    <a href="#OtherReferences">Other References</a>
+  </li>
+</ol>
+</div><p>
+</p>
+<p>
+<span class="wikianchor" id="led_class"></span>
+</p>
+<h1 id="LinuxLEDclassforGPIOandPWMcontrolledLEDs">Linux LED class for GPIO (and PWM) controlled LEDs</h1>
+<p>
+GPIO's which are connected directly to LED's on are registered through the Linux LED class sysfs interface and you can control them via /sys/class/leds.
+</p>
+<p>
+Mapping GPIO's to LED's (as well as defining their logic level and default trigger) is done in the board support file or in the case of more modern kernels such as Ventana in the device-tree. See the led node in the <a class="ext-link" href="http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/arch/arm/boot/dts/imx6qdl-gw54xx.dtsi#n38"><span class="icon">​</span>gw54xx device-tree</a> for example.
+</p>
+<p>
+LED brightness is represented as an integer value and for LED's connected to PWM signals this truly controls the brightness. However for LED's connected to GPIO's a brightness of 0 is off and any other value is on.
+</p>
+<p>
+To list available LED's by name (see product hardware manual to match name to board LED):
+</p>
+<pre class="wiki">ls /sys/class/leds
+</pre><p>
+To enable/disable LEDs:
+</p>
+<pre class="wiki">echo 0 &gt; /sys/class/leds/user1/brightness ;# turn off user1 LED
+echo 255 &gt; /sys/class/leds/user1/brightness ;# turn on user1 LED
+</pre><p>
+Some boards (consult the board user manual) use a bi-color LED (typical green/red) where 2 GPIO's are used (connected to each side of the LED). In this scenario setting one LED on and the other Off would produce one color and flipping them would produce the other (while turning them both on or both off would result in no LED's lit):
+</p>
+<pre class="wiki"># turn bi-color LED Green 
+echo 0 &gt; /sys/class/leds/user1/brightness
+echo 255 &gt; /sys/class/leds/user2/brightness
+# turn bi-color LED Red 
+echo 255 &gt; /sys/class/leds/user1/brightness
+echo 0 &gt; /sys/class/leds/user2/brightness
+</pre><p>
+<span class="wikianchor" id="led-trigger"></span>
+</p>
+<h2 id="LEDTriggers">LED Triggers</h2>
+<p>
+Through the LED class LED's can be triggered by certain events / items depending on kernel configuration.
+</p>
+<p>
+To show what triggers are available in the current kernel:
+</p>
+<pre class="wiki"># cat /sys/class/leds/user1/trigger 
+[none] nand-disk mmc0 timer default-on netdev gpio heartbeat morse usbdev 
+</pre><ul><li>the one shown in brackets is the current trigger - to disable triggers set to none (as the example above shows)
+</li><li>the default trigger is specified in the board support file or device-tree
+</li></ul><p>
+To set a trigger:
+</p>
+<pre class="wiki">echo heartbeat &gt; /sys/class/leds/user1/trigger
+</pre><ul><li>the hearbeat trigger blinks the LED twice at the end of every second
+</li><li>depending on peripherals installed other triggers may be available such as network or disk activity
+</li></ul><h1 id="OtherReferences">Other References</h1>
+<p>
+Here are some other useful references from our wiki:
+</p>
+<ul><li><a class="wiki" href="/wiki/gpio">General Purpose I/O (GPIO)</a>
+</li><li><a class="wiki" href="/wiki/linux/pwm">Pulse-Width-Modulation (PWM)</a>
+</li><li><a class="wiki" href="/wiki/OpenWrt/gpio">GPIO in OpenWrt</a>
+</li><li><a class="wiki" href="/wiki/ventana/DigitalIO">Ventana product family Digital I/O</a>
+</li></ul
+}}}