xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/leds/leds-is31fl319x.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunLEDs connected to is31fl319x LED controller chip
2*4882a593Smuzhiyun
3*4882a593SmuzhiyunRequired properties:
4*4882a593Smuzhiyun- compatible : Should be any of
5*4882a593Smuzhiyun	"issi,is31fl3190"
6*4882a593Smuzhiyun	"issi,is31fl3191"
7*4882a593Smuzhiyun	"issi,is31fl3193"
8*4882a593Smuzhiyun	"issi,is31fl3196"
9*4882a593Smuzhiyun	"issi,is31fl3199"
10*4882a593Smuzhiyun	"si-en,sn3199".
11*4882a593Smuzhiyun- #address-cells: Must be 1.
12*4882a593Smuzhiyun- #size-cells: Must be 0.
13*4882a593Smuzhiyun- reg: 0x64, 0x65, 0x66, or 0x67.
14*4882a593Smuzhiyun
15*4882a593SmuzhiyunOptional properties:
16*4882a593Smuzhiyun- audio-gain-db : audio gain selection for external analog modulation input.
17*4882a593Smuzhiyun	Valid values: 0 - 21, step by 3 (rounded down)
18*4882a593Smuzhiyun	Default: 0
19*4882a593Smuzhiyun- shutdown-gpios : Specifier of the GPIO connected to SDB pin of the chip.
20*4882a593Smuzhiyun
21*4882a593SmuzhiyunEach led is represented as a sub-node of the issi,is31fl319x device.
22*4882a593SmuzhiyunThere can be less leds subnodes than the chip can support but not more.
23*4882a593Smuzhiyun
24*4882a593SmuzhiyunRequired led sub-node properties:
25*4882a593Smuzhiyun- reg : number of LED line
26*4882a593Smuzhiyun	Valid values: 1 - number of leds supported by the chip variant.
27*4882a593Smuzhiyun
28*4882a593SmuzhiyunOptional led sub-node properties:
29*4882a593Smuzhiyun- label : see Documentation/devicetree/bindings/leds/common.txt.
30*4882a593Smuzhiyun- linux,default-trigger :
31*4882a593Smuzhiyun	see Documentation/devicetree/bindings/leds/common.txt.
32*4882a593Smuzhiyun- led-max-microamp : (optional)
33*4882a593Smuzhiyun	Valid values: 5000 - 40000, step by 5000 (rounded down)
34*4882a593Smuzhiyun	Default: 20000 (20 mA)
35*4882a593Smuzhiyun	Note: a driver will take the lowest of all led limits since the
36*4882a593Smuzhiyun	chip has a single global setting. The lowest value will be chosen
37*4882a593Smuzhiyun	due to the PWM specificity, where lower brightness is achieved
38*4882a593Smuzhiyun	by reducing the dury-cycle of pulses and not the current, which
39*4882a593Smuzhiyun	will always have its peak value equal to led-max-microamp.
40*4882a593Smuzhiyun
41*4882a593SmuzhiyunExamples:
42*4882a593Smuzhiyun
43*4882a593Smuzhiyunfancy_leds: leds@65 {
44*4882a593Smuzhiyun	compatible = "issi,is31fl3196";
45*4882a593Smuzhiyun	#address-cells = <1>;
46*4882a593Smuzhiyun	#size-cells = <0>;
47*4882a593Smuzhiyun	reg = <0x65>;
48*4882a593Smuzhiyun	shutdown-gpios = <&gpio0 11 GPIO_ACTIVE_HIGH>;
49*4882a593Smuzhiyun
50*4882a593Smuzhiyun	red_aux: led@1 {
51*4882a593Smuzhiyun		label = "red:aux";
52*4882a593Smuzhiyun		reg = <1>;
53*4882a593Smuzhiyun		led-max-microamp = <10000>;
54*4882a593Smuzhiyun	};
55*4882a593Smuzhiyun
56*4882a593Smuzhiyun	green_power: led@5 {
57*4882a593Smuzhiyun		label = "green:power";
58*4882a593Smuzhiyun		reg = <5>;
59*4882a593Smuzhiyun		linux,default-trigger = "default-on";
60*4882a593Smuzhiyun	};
61*4882a593Smuzhiyun};
62