xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/netronix,ntxec.yaml (revision f7c32ed617858bcd22f8d1b03199099d50125721)
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
7title: Netronix Embedded Controller
8
9maintainers:
10  - Jonathan Neuschäfer <j.neuschaefer@gmx.net>
11
12description: |
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
16properties:
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
41required:
42  - compatible
43  - reg
44
45additionalProperties: false
46
47examples:
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    };
77