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