Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: leds: Convert is31fl319x to dtschema
Convert leds-is31fl319x.txt to dtschema.
Set license to the one recommended by DT project
and set myself as maintainer.
Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Vincent Knecht <vincent.knecht@mailoo.org>
Signed-off-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20220712100841.1538395-2-vincent.knecht@mailoo.org
authored by
Vincent Knecht
and committed by
Rob Herring
dbc801b4
3ed4b599
+113
-61
+113
Documentation/devicetree/bindings/leds/issi,is31fl319x.yaml
+113
Documentation/devicetree/bindings/leds/issi,is31fl319x.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/leds/issi,is31fl319x.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: ISSI LED controllers bindings for IS31FL319{0,1,3,6,9}
8
+
9
+
maintainers:
10
+
- Vincent Knecht <vincent.knecht@mailoo.org>
11
+
12
+
description: |
13
+
The IS31FL319X are LED controllers with I2C interface.
14
+
Previously known as Si-En SN319{0,1,3,6,9}.
15
+
16
+
For more product information please see the links below:
17
+
https://lumissil.com/assets/pdf/core/IS31FL3190_DS.pdf
18
+
https://lumissil.com/assets/pdf/core/IS31FL3191_DS.pdf
19
+
https://lumissil.com/assets/pdf/core/IS31FL3193_DS.pdf
20
+
https://lumissil.com/assets/pdf/core/IS31FL3196_DS.pdf
21
+
https://lumissil.com/assets/pdf/core/IS31FL3199_DS.pdf
22
+
23
+
properties:
24
+
compatible:
25
+
enum:
26
+
- issi,is31fl3190
27
+
- issi,is31fl3191
28
+
- issi,is31fl3193
29
+
- issi,is31fl3196
30
+
- issi,is31fl3199
31
+
- si-en,sn3199
32
+
33
+
reg:
34
+
maxItems: 1
35
+
36
+
shutdown-gpios:
37
+
maxItems: 1
38
+
description: GPIO attached to the SDB pin.
39
+
40
+
audio-gain-db:
41
+
$ref: /schemas/types.yaml#/definitions/uint32
42
+
default: 0
43
+
description: Audio gain selection for external analog modulation input.
44
+
enum: [0, 3, 6, 9, 12, 15, 18, 21]
45
+
46
+
"#address-cells":
47
+
const: 1
48
+
49
+
"#size-cells":
50
+
const: 0
51
+
52
+
patternProperties:
53
+
"^led@[1-9]$":
54
+
type: object
55
+
$ref: common.yaml#
56
+
57
+
properties:
58
+
reg:
59
+
description: Index of the LED.
60
+
minimum: 1
61
+
maximum: 9
62
+
63
+
led-max-microamp:
64
+
default: 20000
65
+
enum: [5000, 10000, 15000, 20000, 25000, 30000, 35000, 40000]
66
+
description:
67
+
Note that a driver will take the lowest of all LED limits
68
+
since the chip has a single global setting. The lowest value
69
+
will be chosen due to the PWM specificity, where lower
70
+
brightness is achieved by reducing the duty-cycle of pulses
71
+
and not the current, which will always have its peak value
72
+
equal to led-max-microamp.
73
+
74
+
required:
75
+
- compatible
76
+
- reg
77
+
- "#address-cells"
78
+
- "#size-cells"
79
+
80
+
additionalProperties: false
81
+
82
+
examples:
83
+
- |
84
+
#include <dt-bindings/gpio/gpio.h>
85
+
#include <dt-bindings/leds/common.h>
86
+
87
+
i2c0 {
88
+
#address-cells = <1>;
89
+
#size-cells = <0>;
90
+
91
+
led-controller@65 {
92
+
compatible = "issi,is31fl3196";
93
+
reg = <0x65>;
94
+
#address-cells = <1>;
95
+
#size-cells = <0>;
96
+
97
+
shutdown-gpios = <&gpio0 11 GPIO_ACTIVE_HIGH>;
98
+
99
+
led@1 {
100
+
reg = <1>;
101
+
label = "red:aux";
102
+
led-max-microamp = <10000>;
103
+
};
104
+
105
+
led@5 {
106
+
reg = <5>;
107
+
label = "green:power";
108
+
linux,default-trigger = "default-on";
109
+
};
110
+
};
111
+
};
112
+
...
113
+
-61
Documentation/devicetree/bindings/leds/leds-is31fl319x.txt
-61
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
-
- shutdown-gpios : Specifier of the GPIO connected to SDB pin of the chip.
20
-
21
-
Each led is represented as a sub-node of the issi,is31fl319x device.
22
-
There can be less leds subnodes than the chip can support but not more.
23
-
24
-
Required led sub-node properties:
25
-
- reg : number of LED line
26
-
Valid values: 1 - number of leds supported by the chip variant.
27
-
28
-
Optional led sub-node properties:
29
-
- label : see Documentation/devicetree/bindings/leds/common.txt.
30
-
- linux,default-trigger :
31
-
see Documentation/devicetree/bindings/leds/common.txt.
32
-
- led-max-microamp : (optional)
33
-
Valid values: 5000 - 40000, step by 5000 (rounded down)
34
-
Default: 20000 (20 mA)
35
-
Note: a driver will take the lowest of all led limits since the
36
-
chip has a single global setting. The lowest value will be chosen
37
-
due to the PWM specificity, where lower brightness is achieved
38
-
by reducing the dury-cycle of pulses and not the current, which
39
-
will always have its peak value equal to led-max-microamp.
40
-
41
-
Examples:
42
-
43
-
fancy_leds: leds@65 {
44
-
compatible = "issi,is31fl3196";
45
-
#address-cells = <1>;
46
-
#size-cells = <0>;
47
-
reg = <0x65>;
48
-
shutdown-gpios = <&gpio0 11 GPIO_ACTIVE_HIGH>;
49
-
50
-
red_aux: led@1 {
51
-
label = "red:aux";
52
-
reg = <1>;
53
-
led-max-microamp = <10000>;
54
-
};
55
-
56
-
green_power: led@5 {
57
-
label = "green:power";
58
-
reg = <5>;
59
-
linux,default-trigger = "default-on";
60
-
};
61
-
};