xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/leds/leds-el15203000.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunCrane Merchandising System - EL15203000 LED driver
2*4882a593Smuzhiyun--------------------------------------------------
3*4882a593Smuzhiyun
4*4882a593SmuzhiyunThis LED Board (aka RED LEDs board) is widely used in
5*4882a593Smuzhiyuncoffee vending machines produced by Crane Merchandising Systems.
6*4882a593SmuzhiyunThe board manages 3 LEDs and supports predefined blinking patterns
7*4882a593Smuzhiyunfor specific leds.
8*4882a593Smuzhiyun
9*4882a593SmuzhiyunVending area LED encoded with symbol 'V' (hex code 0x56).
10*4882a593SmuzhiyunDoesn't have any hardware blinking pattern.
11*4882a593Smuzhiyun
12*4882a593SmuzhiyunScreen light tube LED which surrounds vending machine screen and
13*4882a593Smuzhiyunencoded with symbol 'S' (hex code 0x53). Supports blinking breathing pattern.
14*4882a593Smuzhiyun
15*4882a593SmuzhiyunWater Pipe LED encoded with symbol 'P' (hex code 0x50) and
16*4882a593Smuzhiyunactually consists of 5 LEDs that exposed by protocol like one LED.
17*4882a593SmuzhiyunSupports next patterns:
18*4882a593Smuzhiyun- cascade pattern
19*4882a593Smuzhiyun- inversed cascade pattern
20*4882a593Smuzhiyun- bounce pattern
21*4882a593Smuzhiyun- inversed bounce pattern
22*4882a593Smuzhiyun
23*4882a593SmuzhiyunRequired properties:
24*4882a593Smuzhiyun- compatible : "crane,el15203000"
25*4882a593Smuzhiyun- #address-cells : must be 1
26*4882a593Smuzhiyun- #size-cells : must be 0
27*4882a593Smuzhiyun
28*4882a593SmuzhiyunProperty rules described in Documentation/devicetree/bindings/spi/spi-bus.txt
29*4882a593Smuzhiyunapply. In particular, "reg" and "spi-max-frequency" properties must be given.
30*4882a593Smuzhiyun
31*4882a593SmuzhiyunOptional LED sub-node properties:
32*4882a593Smuzhiyun- function:
33*4882a593Smuzhiyun	see Documentation/devicetree/bindings/leds/common.txt
34*4882a593Smuzhiyun- color:
35*4882a593Smuzhiyun	see Documentation/devicetree/bindings/leds/common.txt
36*4882a593Smuzhiyun
37*4882a593SmuzhiyunExample
38*4882a593Smuzhiyun-------
39*4882a593Smuzhiyun
40*4882a593Smuzhiyun#include <dt-bindings/leds/common.h>
41*4882a593Smuzhiyun
42*4882a593Smuzhiyunled-controller@0 {
43*4882a593Smuzhiyun	compatible = "crane,el15203000";
44*4882a593Smuzhiyun	reg = <0>;
45*4882a593Smuzhiyun	spi-max-frequency = <50000>;
46*4882a593Smuzhiyun	#address-cells = <1>;
47*4882a593Smuzhiyun	#size-cells = <0>;
48*4882a593Smuzhiyun
49*4882a593Smuzhiyun	/* water pipe */
50*4882a593Smuzhiyun	led@50 {
51*4882a593Smuzhiyun		reg = <0x50>;
52*4882a593Smuzhiyun		function = "pipe";
53*4882a593Smuzhiyun		color = <LED_COLOR_ID_RED>;
54*4882a593Smuzhiyun	};
55*4882a593Smuzhiyun
56*4882a593Smuzhiyun	/* screen frame */
57*4882a593Smuzhiyun	led@53 {
58*4882a593Smuzhiyun		reg = <0x53>;
59*4882a593Smuzhiyun		function = "screen";
60*4882a593Smuzhiyun		color = <LED_COLOR_ID_RED>;
61*4882a593Smuzhiyun	};
62*4882a593Smuzhiyun
63*4882a593Smuzhiyun	/* vending area */
64*4882a593Smuzhiyun	led@56 {
65*4882a593Smuzhiyun		reg = <0x56>;
66*4882a593Smuzhiyun		function = "vend";
67*4882a593Smuzhiyun		color = <LED_COLOR_ID_RED>;
68*4882a593Smuzhiyun	};
69*4882a593Smuzhiyun};
70