Documentation/devicetree/bindings/leds/leds-pwm.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-pwm.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: LEDs connected to PWM
   8
   9 maintainers:
  10   - Pavel Machek <pavel@ucw.cz>
  11
  12 description:
  13   Each LED is represented as a sub-node of the pwm-leds device.  Each
  14   node's name represents the name of the corresponding LED.
  15
  16 properties:
  17   compatible:
  18     const: pwm-leds
  19
  20 patternProperties:
  21   "^led(-[0-9a-f]+)?$":
  22     type: object
  23
  24     $ref: common.yaml#
  25
  26     properties:
  27       pwms:
  28         maxItems: 1
  29
  30       pwm-names: true
  31
  32       max-brightness:
  33         description:
  34           Maximum brightness possible for the LED
  35         $ref: /schemas/types.yaml#/definitions/uint32
  36
  37       active-low:
  38         description:
  39           For PWMs where the LED is wired to supply rather than ground.
  40         type: boolean
  41
  42     required:
  43       - pwms
  44       - max-brightness
  45
  46 additionalProperties: false
  47
  48 examples:
  49   - |
  50
  51     #include <dt-bindings/leds/common.h>
  52
  53     led-controller {
  54         compatible = "pwm-leds";
  55
  56         led-1 {
  57             label = "omap4::keypad";
  58             pwms = <&twl_pwm 0 7812500>;
  59             max-brightness = <127>;
  60         };
  61
  62         led-2 {
  63             color = <LED_COLOR_ID_GREEN>;
  64             function = LED_FUNCTION_CHARGING;
  65             pwms = <&twl_pwmled 0 7812500>;
  66             max-brightness = <255>;
  67         };
  68     };
  69
  70 ...