Tom Rini | 53633a8 | 2024-02-29 12:33:36 -0500 | [diff] [blame] | 1 | TI LMU (Lighting Management Unit) device tree bindings |
| 2 | |
| 3 | TI LMU driver supports lighting devices below. |
| 4 | |
| 5 | Name Child nodes |
| 6 | ------ --------------------------------- |
| 7 | LM3631 Backlight and regulator |
| 8 | LM3632 Backlight and regulator |
| 9 | LM3633 Backlight, LED and fault monitor |
| 10 | LM3695 Backlight |
| 11 | LM36274 Backlight and regulator |
| 12 | |
| 13 | Required properties: |
| 14 | - compatible: Should be one of: |
| 15 | "ti,lm3631" |
| 16 | "ti,lm3632" |
| 17 | "ti,lm3633" |
| 18 | "ti,lm3695" |
| 19 | "ti,lm36274" |
| 20 | - reg: I2C slave address. |
| 21 | 0x11 for LM3632 |
| 22 | 0x29 for LM3631 |
| 23 | 0x36 for LM3633 |
| 24 | 0x63 for LM3695 |
| 25 | 0x11 for LM36274 |
| 26 | |
| 27 | Optional properties: |
| 28 | - enable-gpios: A GPIO specifier for hardware enable pin. |
| 29 | - ramp-up-us: Current ramping from one brightness level to |
| 30 | the a higher brightness level. |
| 31 | Range from 2048 us - 117.44 s |
| 32 | - ramp-down-us: Current ramping from one brightness level to |
| 33 | the a lower brightness level. |
| 34 | Range from 2048 us - 117.44 s |
| 35 | - ti,brightness-resolution - This determines whether to use 8 bit brightness |
| 36 | mode or 11 bit brightness mode. If this value is |
| 37 | not set the device is defaulted to the preferred |
| 38 | 8bit brightness mode per 7.3.4.1 of the data |
| 39 | sheet. This setting can either be in the parent |
| 40 | node or as part of the LED child nodes. This |
| 41 | is determined by the part itself if the strings |
| 42 | have a common brightness register or individual |
| 43 | brightness registers. |
| 44 | The values are 255 (8bit) or 2047 (11bit). |
| 45 | |
| 46 | Required node: |
| 47 | - backlight: All LMU devices have backlight child nodes. |
| 48 | For the properties, please refer to [1]. |
| 49 | |
| 50 | Optional nodes: |
| 51 | - fault-monitor: Hardware fault monitoring driver for LM3633 and LM3697. |
| 52 | Required properties: |
| 53 | - compatible: Should be one of: |
| 54 | "ti,lm3633-fault-monitor" |
| 55 | - leds: LED properties for LM3633. Please refer to [2]. |
| 56 | LED properties for LM36274. Please refer to [4]. |
| 57 | - regulators: Regulator properties for LM3631 and LM3632. |
| 58 | Please refer to [3]. |
| 59 | |
| 60 | [1] ../leds/backlight/ti-lmu-backlight.txt |
| 61 | [2] ../leds/leds-lm3633.txt |
| 62 | [3] ../regulator/lm363x-regulator.txt |
| 63 | [4] ../leds/leds-lm36274.txt |
| 64 | |
| 65 | lm3631@29 { |
| 66 | compatible = "ti,lm3631"; |
| 67 | reg = <0x29>; |
| 68 | |
| 69 | regulators { |
| 70 | compatible = "ti,lm363x-regulator"; |
| 71 | |
| 72 | vboost { |
| 73 | regulator-name = "lcd_boost"; |
| 74 | regulator-min-microvolt = <4500000>; |
| 75 | regulator-max-microvolt = <6350000>; |
| 76 | regulator-always-on; |
| 77 | }; |
| 78 | |
| 79 | vcont { |
| 80 | regulator-name = "lcd_vcont"; |
| 81 | regulator-min-microvolt = <1800000>; |
| 82 | regulator-max-microvolt = <3300000>; |
| 83 | }; |
| 84 | |
| 85 | voref { |
| 86 | regulator-name = "lcd_voref"; |
| 87 | regulator-min-microvolt = <4000000>; |
| 88 | regulator-max-microvolt = <6000000>; |
| 89 | }; |
| 90 | |
| 91 | vpos { |
| 92 | regulator-name = "lcd_vpos"; |
| 93 | regulator-min-microvolt = <4000000>; |
| 94 | regulator-max-microvolt = <6000000>; |
| 95 | regulator-boot-on; |
| 96 | }; |
| 97 | |
| 98 | vneg { |
| 99 | regulator-name = "lcd_vneg"; |
| 100 | regulator-min-microvolt = <4000000>; |
| 101 | regulator-max-microvolt = <6000000>; |
| 102 | regulator-boot-on; |
| 103 | }; |
| 104 | }; |
| 105 | |
| 106 | backlight { |
| 107 | compatible = "ti,lm3631-backlight"; |
| 108 | |
| 109 | lcd_bl { |
| 110 | led-sources = <0 1>; |
| 111 | ramp-up-us = <300000>; |
| 112 | }; |
| 113 | }; |
| 114 | }; |
| 115 | |
| 116 | lm3632@11 { |
| 117 | compatible = "ti,lm3632"; |
| 118 | reg = <0x11>; |
| 119 | |
| 120 | enable-gpios = <&pioC 2 GPIO_ACTIVE_HIGH>; /* PC2 */ |
| 121 | |
| 122 | regulators { |
| 123 | compatible = "ti,lm363x-regulator"; |
| 124 | |
| 125 | enable-gpios = <&pioC 0 GPIO_ACTIVE_HIGH>, |
| 126 | <&pioC 1 GPIO_ACTIVE_HIGH>; |
| 127 | |
| 128 | vboost { |
| 129 | regulator-name = "lcd_boost"; |
| 130 | regulator-min-microvolt = <4500000>; |
| 131 | regulator-max-microvolt = <6400000>; |
| 132 | regulator-always-on; |
| 133 | }; |
| 134 | |
| 135 | vpos { |
| 136 | regulator-name = "lcd_vpos"; |
| 137 | regulator-min-microvolt = <4000000>; |
| 138 | regulator-max-microvolt = <6000000>; |
| 139 | }; |
| 140 | |
| 141 | vneg { |
| 142 | regulator-name = "lcd_vneg"; |
| 143 | regulator-min-microvolt = <4000000>; |
| 144 | regulator-max-microvolt = <6000000>; |
| 145 | }; |
| 146 | }; |
| 147 | |
| 148 | backlight { |
| 149 | compatible = "ti,lm3632-backlight"; |
| 150 | |
| 151 | pwms = <&pwm0 0 10000 0>; /* pwm number, period, polarity */ |
| 152 | pwm-names = "lmu-backlight"; |
| 153 | |
| 154 | lcd { |
| 155 | led-sources = <0 1>; |
| 156 | pwm-period = <10000>; |
| 157 | }; |
| 158 | }; |
| 159 | }; |
| 160 | |
| 161 | lm3633@36 { |
| 162 | compatible = "ti,lm3633"; |
| 163 | reg = <0x36>; |
| 164 | |
| 165 | enable-gpios = <&pioC 2 GPIO_ACTIVE_HIGH>; |
| 166 | |
| 167 | backlight { |
| 168 | compatible = "ti,lm3633-backlight"; |
| 169 | |
| 170 | main { |
| 171 | label = "main_lcd"; |
| 172 | led-sources = <1 2>; |
| 173 | ramp-up-us = <500000>; |
| 174 | ramp-down-us = <500000>; |
| 175 | }; |
| 176 | |
| 177 | front { |
| 178 | label = "front_lcd"; |
| 179 | led-sources = <0>; |
| 180 | ramp-up-us = <1000000>; |
| 181 | ramp-down-us = <0>; |
| 182 | }; |
| 183 | }; |
| 184 | |
| 185 | leds { |
| 186 | compatible = "ti,lm3633-leds"; |
| 187 | |
| 188 | chan1 { |
| 189 | label = "status"; |
| 190 | led-sources = <1>; |
| 191 | led-max-microamp = <6000>; |
| 192 | }; |
| 193 | |
| 194 | chan345 { |
| 195 | label = "rgb"; |
| 196 | led-sources = <3 4 5>; |
| 197 | led-max-microamp = <10000>; |
| 198 | }; |
| 199 | }; |
| 200 | |
| 201 | fault-monitor { |
| 202 | compatible = "ti,lm3633-fault-monitor"; |
| 203 | }; |
| 204 | }; |
| 205 | |
| 206 | lm3695@63 { |
| 207 | compatible = "ti,lm3695"; |
| 208 | reg = <0x63>; |
| 209 | |
| 210 | enable-gpios = <&pioC 2 GPIO_ACTIVE_HIGH>; |
| 211 | |
| 212 | backlight { |
| 213 | compatible = "ti,lm3695-backlight"; |
| 214 | |
| 215 | lcd { |
| 216 | label = "bl"; |
| 217 | led-sources = <0 1>; |
| 218 | }; |
| 219 | }; |
| 220 | }; |
| 221 | |
| 222 | lm36274@11 { |
| 223 | compatible = "ti,lm36274"; |
| 224 | #address-cells = <1>; |
| 225 | #size-cells = <0>; |
| 226 | reg = <0x11>; |
| 227 | |
| 228 | enable-gpios = <&pioC 2 GPIO_ACTIVE_HIGH>; |
| 229 | regulators { |
| 230 | #address-cells = <1>; |
| 231 | #size-cells = <0>; |
| 232 | compatible = "ti,lm363x-regulator"; |
| 233 | |
| 234 | enable-gpios = <&pioC 0 GPIO_ACTIVE_HIGH>, |
| 235 | <&pioC 1 GPIO_ACTIVE_HIGH>; |
| 236 | |
| 237 | vboost { |
| 238 | regulator-name = "lcd_boost"; |
| 239 | regulator-min-microvolt = <4000000>; |
| 240 | regulator-max-microvolt = <7150000>; |
| 241 | regulator-always-on; |
| 242 | }; |
| 243 | |
| 244 | vpos { |
| 245 | regulator-name = "lcd_vpos"; |
| 246 | regulator-min-microvolt = <4000000>; |
| 247 | regulator-max-microvolt = <6500000>; |
| 248 | }; |
| 249 | |
| 250 | vneg { |
| 251 | regulator-name = "lcd_vneg"; |
| 252 | regulator-min-microvolt = <4000000>; |
| 253 | regulator-max-microvolt = <6500000>; |
| 254 | }; |
| 255 | }; |
| 256 | |
| 257 | backlight { |
| 258 | #address-cells = <1>; |
| 259 | #size-cells = <0>; |
| 260 | compatible = "ti,lm36274-backlight"; |
| 261 | |
| 262 | led@0 { |
| 263 | reg = <0>; |
| 264 | led-sources = <0 2>; |
| 265 | label = "white:backlight_cluster"; |
| 266 | linux,default-trigger = "backlight"; |
| 267 | }; |
| 268 | }; |
| 269 | }; |