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