Documentation/devicetree/bindings/leds/leds-lp55xx.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/leds/leds-lp55xx.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: TI/National Semiconductor LP55xx and LP8501 LED Drivers
   8
   9 maintainers:
  10   - Jacek Anaszewski <jacek.anaszewski@gmail.com>
  11   - Pavel Machek <pavel@ucw.cz>
  12
  13 description: |
  14   Bindings for the TI/National Semiconductor LP55xx and LP8501 multi channel
  15   LED Drivers.
  16
  17   For more product information please see the link below:
  18     https://www.ti.com/lit/gpn/lp5521
  19     https://www.ti.com/lit/gpn/lp5523
  20     https://www.ti.com/lit/gpn/lp55231
  21     https://www.ti.com/lit/gpn/lp5562
  22     https://www.ti.com/lit/gpn/lp8501
  23
  24 properties:
  25   compatible:
  26     enum:
  27       - national,lp5521
  28       - national,lp5523
  29       - ti,lp55231
  30       - ti,lp5562
  31       - ti,lp8501
  32
  33   reg:
  34     maxItems: 1
  35     description: I2C slave address
  36
  37   clock-mode:
  38     $ref: /schemas/types.yaml#/definitions/uint8
  39     description: |
  40       Input clock mode
  41     enum:
  42       - 0 # automode
  43       - 1 # internal
  44       - 2 # external
  45
  46   enable-gpio:
  47     maxItems: 1
  48     description: |
  49       GPIO attached to the chip's enable pin
  50
  51   pwr-sel:
  52     $ref: /schemas/types.yaml#/definitions/uint8
  53     description: |
  54       LP8501 specific property. Power selection for output channels.
  55     enum:
  56       - 0 # D1~9 are connected to VDD
  57       - 1 # D1~6 with VDD, D7~9 with VOUT
  58       - 2 # D1~6 with VOUT, D7~9 with VDD
  59       - 3 # D1~9 are connected to VOUT
  60
  61   '#address-cells':
  62     const: 1
  63
  64   '#size-cells':
  65     const: 0
  66
  67 patternProperties:
  68   "(^led@[0-9a-f]$|led)":
  69     type: object
  70     $ref: common.yaml#
  71     properties:
  72       led-cur:
  73         $ref: /schemas/types.yaml#/definitions/uint8
  74         description: |
  75           Current setting at each LED channel (mA x10, 0 if LED is not connected)
  76         minimum: 0
  77         maximum: 255
  78
  79       max-cur:
  80         $ref: /schemas/types.yaml#/definitions/uint8
  81         description: Maximun current at each LED channel.
  82
  83       reg:
  84         description: |
  85           Output channel for the LED.  This is zero based channel identifier and
  86           the data sheet is a one based channel identifier.
  87           reg value to output to LED output number
  88         enum:
  89           - 0 # LED output D1
  90           - 1 # LED output D2
  91           - 2 # LED output D3
  92           - 3 # LED output D4
  93           - 4 # LED output D5
  94           - 5 # LED output D6
  95           - 6 # LED output D7
  96           - 7 # LED output D8
  97           - 8 # LED output D9
  98
  99       chan-name:
 100         $ref: /schemas/types.yaml#/definitions/string
 101         description: name of channel
 102
 103 required:
 104   - compatible
 105   - reg
 106
 107 additionalProperties: false
 108
 109 examples:
 110   - |
 111     #include <dt-bindings/leds/common.h>
 112
 113     i2c {
 114         #address-cells = <1>;
 115         #size-cells = <0>;
 116
 117         led-controller@32 {
 118             #address-cells = <1>;
 119             #size-cells = <0>;
 120             compatible = "ti,lp8501";
 121             reg = <0x32>;
 122             clock-mode = /bits/ 8 <2>;
 123             pwr-sel = /bits/ 8 <3>;     /* D1~9 connected to VOUT */
 124
 125             led@0 {
 126                 reg = <0>;
 127                 chan-name = "d1";
 128                 led-cur = /bits/ 8 <0x14>;
 129                 max-cur = /bits/ 8 <0x20>;
 130             };
 131
 132             led@1 {
 133                 reg = <1>;
 134                 chan-name = "d2";
 135                 led-cur = /bits/ 8 <0x14>;
 136                 max-cur = /bits/ 8 <0x20>;
 137             };
 138
 139             led@2 {
 140                 reg = <2>;
 141                 chan-name = "d3";
 142                 led-cur = /bits/ 8 <0x14>;
 143                 max-cur = /bits/ 8 <0x20>;
 144             };
 145
 146             led@3 {
 147                 reg = <3>;
 148                 chan-name = "d4";
 149                 led-cur = /bits/ 8 <0x14>;
 150                 max-cur = /bits/ 8 <0x20>;
 151             };
 152
 153             led@4 {
 154                 reg = <4>;
 155                 chan-name = "d5";
 156                 led-cur = /bits/ 8 <0x14>;
 157                 max-cur = /bits/ 8 <0x20>;
 158             };
 159
 160             led@5 {
 161                 reg = <5>;
 162                 chan-name = "d6";
 163                 led-cur = /bits/ 8 <0x14>;
 164                 max-cur = /bits/ 8 <0x20>;
 165             };
 166
 167             led@6 {
 168                 reg = <6>;
 169                 chan-name = "d7";
 170                 led-cur = /bits/ 8 <0x14>;
 171                 max-cur = /bits/ 8 <0x20>;
 172             };
 173
 174             led@7 {
 175                 reg = <7>;
 176                 chan-name = "d8";
 177                 led-cur = /bits/ 8 <0x14>;
 178                 max-cur = /bits/ 8 <0x20>;
 179             };
 180
 181             led@8 {
 182                 reg = <8>;
 183                 chan-name = "d9";
 184                 led-cur = /bits/ 8 <0x14>;
 185                 max-cur = /bits/ 8 <0x20>;
 186             };
 187         };
 188
 189         led-controller@33 {
 190             #address-cells = <1>;
 191             #size-cells = <0>;
 192             compatible = "national,lp5523";
 193             reg = <0x33>;
 194             clock-mode = /bits/ 8 <0>;
 195
 196             multi-led@2 {
 197                 #address-cells = <1>;
 198                 #size-cells = <0>;
 199                 reg = <0x2>;
 200                 color = <LED_COLOR_ID_RGB>;
 201                 function = LED_FUNCTION_STANDBY;
 202                 linux,default-trigger = "heartbeat";
 203
 204                 led@0 {
 205                     led-cur = /bits/ 8 <50>;
 206                     max-cur = /bits/ 8 <100>;
 207                     reg = <0x0>;
 208                     color = <LED_COLOR_ID_GREEN>;
 209                 };
 210
 211                 led@1 {
 212                     led-cur = /bits/ 8 <50>;
 213                     max-cur = /bits/ 8 <100>;
 214                     reg = <0x1>;
 215                     color = <LED_COLOR_ID_BLUE>;
 216                 };
 217
 218                 led@6 {
 219                     led-cur = /bits/ 8 <50>;
 220                     max-cur = /bits/ 8 <100>;
 221                     reg = <0x6>;
 222                     color = <LED_COLOR_ID_RED>;
 223                 };
 224             };
 225         };
 226     };
 227
 228 ...