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