0015-dt-bindings-backlight-add-ti-lmu-backlight-binding.patch (3631B)
1 From ce34e7400299f5130f4f78bf3e894905373bc3c3 Mon Sep 17 00:00:00 2001 2 From: Milo Kim <Milo.Kim@ti.com> 3 Date: Mon, 17 Jul 2017 15:39:55 +0200 4 Subject: [PATCH 15/17] dt-bindings: backlight: add ti-lmu-backlight binding 5 6 Add DT binding for ti-lmu devices. 7 8 Signed-off-by: Milo Kim <milo.kim@ti.com> 9 Signed-off-by: Sebastian Reichel <sebastian.reichel@collabora.co.uk> 10 --- 11 .../bindings/leds/backlight/ti-lmu-backlight.txt | 66 ++++++++++++++++++++++ 12 1 file changed, 66 insertions(+) 13 create mode 100644 Documentation/devicetree/bindings/leds/backlight/ti-lmu-backlight.txt 14 15 diff --git a/Documentation/devicetree/bindings/leds/backlight/ti-lmu-backlight.txt b/Documentation/devicetree/bindings/leds/backlight/ti-lmu-backlight.txt 16 new file mode 100644 17 index 0000000..5fb1458 18 --- /dev/null 19 +++ b/Documentation/devicetree/bindings/leds/backlight/ti-lmu-backlight.txt 20 @@ -0,0 +1,66 @@ 21 +TI LMU backlight device tree bindings 22 + 23 +Required property: 24 + - compatible: Should be one of: 25 + "ti,lm3532-backlight" 26 + "ti,lm3631-backlight" 27 + "ti,lm3632-backlight" 28 + "ti,lm3633-backlight" 29 + "ti,lm3695-backlight" 30 + "ti,lm3697-backlight" 31 + 32 +Optional properties: 33 + There are two backlight control mode. One is I2C, the other is PWM mode. 34 + Following properties are only specified in PWM mode. 35 + Please note that LMU backlight device can have only one PWM channel. 36 + 37 + - pwms: OF device-tree PWM specification. 38 + - pwm-names: a list of names for the PWM devices specified in the "pwms" 39 + property. 40 + 41 + For the PWM user nodes, please refer to [1]. 42 + 43 +Child nodes: 44 + LMU backlight is represented as sub-nodes of the TI LMU device [2]. 45 + So, LMU backlight should have more than one backlight child node. 46 + Each node exactly matches with backlight control bank configuration. 47 + Maximum numbers of child nodes depend on the device. 48 + 49 + 1 = LM3631, LM3632, LM3695 50 + 2 = LM3633, LM3697 51 + 3 = LM3532 52 + 53 + Required property of a child node: 54 + - led-sources: List of enabled channels from 0 to 2. 55 + Please refer to LED binding [3]. 56 + For output channels, please refer to the datasheets [4]. 57 + 58 + Optional properties of a child node: 59 + - label: Backlight channel identification. 60 + Please refer to LED binding [3]. 61 + - default-brightness-level: Backlight initial brightness value. 62 + Type is <u32>. It is set as soon as backlight 63 + device is created. 64 + 0 ~ 2047 = LM3631, LM3632, LM3633, LM3695 and 65 + LM3697 66 + 0 ~ 255 = LM3532 67 + - ramp-up-msec, ramp-down-msec: Light dimming effect properties. 68 + Type is <u32>. Unit is millisecond. 69 + 0 ~ 65 msec = LM3532 70 + 0 ~ 4000 msec = LM3631 71 + 0 ~ 16000 msec = LM3633 and LM3697 72 + - pwm-period: PWM period. Only valid in PWM brightness mode. 73 + Type is <u32>. If this property is missing, then control 74 + mode is set to I2C by default. 75 + 76 +Examples: Please refer to ti-lmu dt-bindings. [2]. 77 + 78 +[1] ../pwm/pwm.txt 79 +[2] ../mfd/ti-lmu.txt 80 +[3] ../leds/common.txt 81 +[4] LM3532: http://www.ti.com/product/LM3532/datasheet 82 + LM3631: http://www.ti.com/product/LM3631/datasheet 83 + LM3632: http://www.ti.com/product/LM3632A/datasheet 84 + LM3633: http://www.ti.com/product/LM3633/datasheet 85 + LM3695: Datasheet is not opened yet, but only two strings are used. 86 + LM3697: http://www.ti.com/product/LM3697/datasheet 87 -- 88 2.1.4 89