1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/leds/richte 4 $id: http://devicetree.org/schemas/leds/richtek,rt8515.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Richtek RT8515 1.5A dual channel LED dr 7 title: Richtek RT8515 1.5A dual channel LED driver
8 8
9 maintainers: 9 maintainers:
10 - Linus Walleij <linus.walleij@linaro.org> 10 - Linus Walleij <linus.walleij@linaro.org>
11 11
12 description: | 12 description: |
13 The Richtek RT8515 is a dual channel (two mo 13 The Richtek RT8515 is a dual channel (two mode) LED driver that
14 supports driving a white LED in flash or tor 14 supports driving a white LED in flash or torch mode. The maximum
15 current for each mode is defined in hardware 15 current for each mode is defined in hardware using two resistors
16 RFS and RTS. 16 RFS and RTS.
17 17
18 properties: 18 properties:
19 compatible: 19 compatible:
20 const: richtek,rt8515 20 const: richtek,rt8515
21 21
22 enf-gpios: 22 enf-gpios:
23 maxItems: 1 23 maxItems: 1
24 description: A connection to the 'ENF' (en 24 description: A connection to the 'ENF' (enable flash) pin.
25 25
26 ent-gpios: 26 ent-gpios:
27 maxItems: 1 27 maxItems: 1
28 description: A connection to the 'ENT' (en 28 description: A connection to the 'ENT' (enable torch) pin.
29 29
30 richtek,rfs-ohms: 30 richtek,rfs-ohms:
31 minimum: 7680 31 minimum: 7680
32 maximum: 367000 32 maximum: 367000
33 description: The resistance value of the R 33 description: The resistance value of the RFS resistor. This
34 resistors limits the maximum flash curre 34 resistors limits the maximum flash current. This must be set
35 for the property flash-max-microamp to w 35 for the property flash-max-microamp to work, the RFS resistor
36 defines the range of the dimmer setting 36 defines the range of the dimmer setting (brightness) of the
37 flash LED. 37 flash LED.
38 38
39 richtek,rts-ohms: 39 richtek,rts-ohms:
40 minimum: 7680 40 minimum: 7680
41 maximum: 367000 41 maximum: 367000
42 description: The resistance value of the R 42 description: The resistance value of the RTS resistor. This
43 resistors limits the maximum torch curre 43 resistors limits the maximum torch current. This must be set
44 for the property torch-max-microamp to w 44 for the property torch-max-microamp to work, the RTS resistor
45 defines the range of the dimmer setting 45 defines the range of the dimmer setting (brightness) of the
46 torch LED. 46 torch LED.
47 47
48 led: 48 led:
49 type: object 49 type: object
50 $ref: common.yaml# 50 $ref: common.yaml#
51 properties: 51 properties:
52 function: true 52 function: true
53 color: true 53 color: true
54 flash-max-timeout-us: true 54 flash-max-timeout-us: true
55 55
56 flash-max-microamp: 56 flash-max-microamp:
57 maximum: 700000 57 maximum: 700000
58 description: The maximum current for f 58 description: The maximum current for flash mode
59 is hardwired to the component using 59 is hardwired to the component using the RFS resistor to
60 ground. The maximum hardware current 60 ground. The maximum hardware current setting is calculated
61 according to the formula Imax = 5500 61 according to the formula Imax = 5500 / RFS. The lowest
62 allowed resistance value is 7.86 kOh 62 allowed resistance value is 7.86 kOhm giving an absolute
63 maximum current of 700mA. By setting 63 maximum current of 700mA. By setting this attribute in
64 the device tree, you can further res 64 the device tree, you can further restrict the maximum
65 current below the hardware limit. Th 65 current below the hardware limit. This requires the RFS
66 to be defined as it defines the maxi 66 to be defined as it defines the maximum range.
67 67
68 led-max-microamp: 68 led-max-microamp:
69 maximum: 700000 69 maximum: 700000
70 description: The maximum current for t 70 description: The maximum current for torch mode
71 is hardwired to the component using 71 is hardwired to the component using the RTS resistor to
72 ground. The maximum hardware current 72 ground. The maximum hardware current setting is calculated
73 according to the formula Imax = 5500 73 according to the formula Imax = 5500 / RTS. The lowest
74 allowed resistance value is 7.86 kOh 74 allowed resistance value is 7.86 kOhm giving an absolute
75 maximum current of 700mA. By setting 75 maximum current of 700mA. By setting this attribute in
76 the device tree, you can further res 76 the device tree, you can further restrict the maximum
77 current below the hardware limit. Th 77 current below the hardware limit. This requires the RTS
78 to be defined as it defines the maxi 78 to be defined as it defines the maximum range.
79 79
80 additionalProperties: false 80 additionalProperties: false
81 81
82 required: 82 required:
83 - compatible 83 - compatible
84 - ent-gpios 84 - ent-gpios
85 - enf-gpios 85 - enf-gpios
86 - led 86 - led
87 87
88 additionalProperties: false 88 additionalProperties: false
89 89
90 examples: 90 examples:
91 - | 91 - |
92 #include <dt-bindings/gpio/gpio.h> 92 #include <dt-bindings/gpio/gpio.h>
93 #include <dt-bindings/leds/common.h> 93 #include <dt-bindings/leds/common.h>
94 94
95 led-controller { 95 led-controller {
96 compatible = "richtek,rt8515"; 96 compatible = "richtek,rt8515";
97 enf-gpios = <&gpio4 12 GPIO_ACTIVE_HIG 97 enf-gpios = <&gpio4 12 GPIO_ACTIVE_HIGH>;
98 ent-gpios = <&gpio4 13 GPIO_ACTIVE_HIG 98 ent-gpios = <&gpio4 13 GPIO_ACTIVE_HIGH>;
99 richtek,rfs-ohms = <16000>; 99 richtek,rfs-ohms = <16000>;
100 richtek,rts-ohms = <100000>; 100 richtek,rts-ohms = <100000>;
101 101
102 led { 102 led {
103 function = LED_FUNCTION_FLASH; 103 function = LED_FUNCTION_FLASH;
104 color = <LED_COLOR_ID_WHITE>; 104 color = <LED_COLOR_ID_WHITE>;
105 flash-max-timeout-us = <250000>; 105 flash-max-timeout-us = <250000>;
106 flash-max-microamp = <150000>; 106 flash-max-microamp = <150000>;
107 led-max-microamp = <25000>; 107 led-max-microamp = <25000>;
108 }; 108 };
109 }; 109 };
110 110
111 ... 111 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.