Documentation/devicetree/bindings/mfd/netronix,ntxec.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/mfd/netronix,ntxec.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Netronix Embedded Controller
   8
   9 maintainers:
  10   - Jonathan Neuschäfer <j.neuschaefer@gmx.net>
  11
  12 description: |
  13   This EC is found in e-book readers of multiple brands (e.g. Kobo, Tolino), and
  14   is typically implemented as a TI MSP430 microcontroller.
  15
  16 properties:
  17   compatible:
  18     const: netronix,ntxec
  19
  20   reg:
  21     items:
  22       - description: The I2C address of the EC
  23
  24   system-power-controller:
  25     type: boolean
  26     description: See Documentation/devicetree/bindings/power/power-controller.txt
  27
  28   interrupts:
  29     minItems: 1
  30     description:
  31       The EC can signal interrupts via a GPIO line
  32
  33   "#pwm-cells":
  34     const: 2
  35     description: |
  36       Number of cells in a PWM specifier.
  37
  38       The following PWM channels are supported:
  39         - 0: The PWM channel controlled by registers 0xa1-0xa7
  40
  41 required:
  42   - compatible
  43   - reg
  44
  45 additionalProperties: false
  46
  47 examples:
  48   - |
  49     #include <dt-bindings/interrupt-controller/irq.h>
  50     i2c {
  51             #address-cells = <1>;
  52             #size-cells = <0>;
  53
  54             ec: embedded-controller@43 {
  55                     pinctrl-names = "default";
  56                     pinctrl-0 = <&pinctrl_ntxec>;
  57
  58                     compatible = "netronix,ntxec";
  59                     reg = <0x43>;
  60                     system-power-controller;
  61                     interrupt-parent = <&gpio4>;
  62                     interrupts = <11 IRQ_TYPE_EDGE_FALLING>;
  63                     #pwm-cells = <2>;
  64             };
  65     };
  66
  67     backlight {
  68             compatible = "pwm-backlight";
  69             pwms = <&ec 0 50000>;
  70             power-supply = <&backlight_regulator>;
  71     };
  72
  73     backlight_regulator: regulator-dummy {
  74             compatible = "regulator-fixed";
  75             regulator-name = "backlight";
  76     };