Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: ti-lmu: Modify dt bindings for the LM3697

The LM3697 is a single function LED driver. The single function LED
driver needs to reside in the LED directory as a dedicated LED driver
and not as a MFD device. The device does have common brightness and ramp
features and those can be accomodated by a TI LMU framework.

The LM3697 dt binding needs to be moved from the ti-lmu.txt and a dedicated
LED dt binding needs to be added. The new LM3697 LED dt binding will then
reside in the Documentation/devicetree/bindings/leds directory and follow the
current LED and general bindings guidelines.

Signed-off-by: Dan Murphy <dmurphy@ti.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Acked-by: Lee Jones <lee.jones@linaro.org>
Signed-off-by: Jacek Anaszewski <jacek.anaszewski@gmail.com>

authored by

Dan Murphy and committed by
Jacek Anaszewski
1372bbe6 3fce8e1e

+74 -26
+73
Documentation/devicetree/bindings/leds/leds-lm3697.txt
··· 1 + * Texas Instruments - LM3697 Highly Efficient White LED Driver 2 + 3 + The LM3697 11-bit LED driver provides high- 4 + performance backlight dimming for 1, 2, or 3 series 5 + LED strings while delivering up to 90% efficiency. 6 + 7 + This device is suitable for display and keypad lighting 8 + 9 + Required properties: 10 + - compatible: 11 + "ti,lm3697" 12 + - reg : I2C slave address 13 + - #address-cells : 1 14 + - #size-cells : 0 15 + 16 + Optional properties: 17 + - enable-gpios : GPIO pin to enable/disable the device 18 + - vled-supply : LED supply 19 + 20 + Required child properties: 21 + - reg : 0 - LED is Controlled by bank A 22 + 1 - LED is Controlled by bank B 23 + - led-sources : Indicates which HVLED string is associated to which 24 + control bank. This is a zero based property so 25 + HVLED1 = 0, HVLED2 = 1, HVLED3 = 2. 26 + Additional information is contained 27 + in Documentation/devicetree/bindings/leds/common.txt 28 + 29 + Optional child properties: 30 + - ti,brightness-resolution - see Documentation/devicetree/bindings/mfd/ti-lmu.txt 31 + - ramp-up-us: see Documentation/devicetree/bindings/mfd/ti-lmu.txt 32 + - ramp-down-us: see Documentation/devicetree/bindings/mfd/ti-lmu.txt 33 + - label : see Documentation/devicetree/bindings/leds/common.txt 34 + - linux,default-trigger : 35 + see Documentation/devicetree/bindings/leds/common.txt 36 + 37 + Example: 38 + 39 + HVLED string 1 and 3 are controlled by control bank A and HVLED 2 string is 40 + controlled by control bank B. 41 + 42 + led-controller@36 { 43 + compatible = "ti,lm3697"; 44 + #address-cells = <1>; 45 + #size-cells = <0>; 46 + reg = <0x36>; 47 + 48 + enable-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH>; 49 + vled-supply = <&vbatt>; 50 + 51 + led@0 { 52 + reg = <0>; 53 + led-sources = <0 2>; 54 + ti,brightness-resolution = <2047>; 55 + ramp-up-us = <5000>; 56 + ramp-down-us = <1000>; 57 + label = "white:first_backlight_cluster"; 58 + linux,default-trigger = "backlight"; 59 + }; 60 + 61 + led@1 { 62 + reg = <1>; 63 + led-sources = <1>; 64 + ti,brightness-resolution = <255>; 65 + ramp-up-us = <500>; 66 + ramp-down-us = <1000>; 67 + label = "white:second_backlight_cluster"; 68 + linux,default-trigger = "backlight"; 69 + }; 70 + } 71 + 72 + For more product information please see the link below: 73 + http://www.ti.com/lit/ds/symlink/lm3697.pdf
+1 -26
Documentation/devicetree/bindings/mfd/ti-lmu.txt
··· 8 8 LM3632 Backlight and regulator 9 9 LM3633 Backlight, LED and fault monitor 10 10 LM3695 Backlight 11 - LM3697 Backlight and fault monitor 12 11 13 12 Required properties: 14 13 - compatible: Should be one of: ··· 15 16 "ti,lm3632" 16 17 "ti,lm3633" 17 18 "ti,lm3695" 18 - "ti,lm3697" 19 19 - reg: I2C slave address. 20 20 0x11 for LM3632 21 21 0x29 for LM3631 22 - 0x36 for LM3633, LM3697 22 + 0x36 for LM3633 23 23 0x63 for LM3695 24 24 25 25 Optional properties: ··· 49 51 Required properties: 50 52 - compatible: Should be one of: 51 53 "ti,lm3633-fault-monitor" 52 - "ti,lm3697-fault-monitor" 53 54 - leds: LED properties for LM3633. Please refer to [2]. 54 55 - regulators: Regulator properties for LM3631 and LM3632. 55 56 Please refer to [3]. ··· 211 214 label = "bl"; 212 215 led-sources = <0 1>; 213 216 }; 214 - }; 215 - }; 216 - 217 - lm3697@36 { 218 - compatible = "ti,lm3697"; 219 - reg = <0x36>; 220 - 221 - enable-gpios = <&pioC 2 GPIO_ACTIVE_HIGH>; 222 - 223 - backlight { 224 - compatible = "ti,lm3697-backlight"; 225 - 226 - lcd { 227 - ti,brightness-resolution = <255>; 228 - led-sources = <0 1 2>; 229 - ramp-up-us = <200000>; 230 - ramp-down-us = <200000>; 231 - }; 232 - }; 233 - 234 - fault-monitor { 235 - compatible = "ti,lm3697-fault-monitor"; 236 217 }; 237 218 };