xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/max77650.yaml (revision cab6a39d7b343596a5823e65c0f7b426551ec22d) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/mfd/max77650.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: MAX77650 ultra low-power PMIC from Maxim Integrated.
8
9maintainers:
10  - Bartosz Golaszewski <bgolaszewski@baylibre.com>
11
12description: |
13  MAX77650 is an ultra-low power PMIC providing battery charging and power
14  supply for low-power IoT and wearable applications.
15
16  The GPIO-controller module is represented as part of the top-level PMIC
17  node. The device exposes a single GPIO line.
18
19  For device-tree bindings of other sub-modules (regulator, power supply,
20  LEDs and onkey) refer to the binding documents under the respective
21  sub-system directories.
22
23properties:
24  compatible:
25    const: maxim,max77650
26
27  reg:
28    description:
29      I2C device address.
30    maxItems: 1
31
32  interrupts:
33    maxItems: 1
34
35  interrupt-controller: true
36
37  "#interrupt-cells":
38    const: 2
39    description:
40      The first cell is the IRQ number, the second cell is the trigger type.
41
42  gpio-controller: true
43
44  "#gpio-cells":
45    const: 2
46    description:
47      The first cell is the pin number and the second cell is used to specify
48      the gpio active state.
49
50  gpio-line-names:
51    maxItems: 1
52    description:
53      Single string containing the name of the GPIO line.
54
55  regulators:
56    $ref: ../regulator/max77650-regulator.yaml
57
58  charger:
59    $ref: ../power/supply/max77650-charger.yaml
60
61  leds:
62    $ref: ../leds/leds-max77650.yaml
63
64  onkey:
65    $ref: ../input/max77650-onkey.yaml
66
67required:
68  - compatible
69  - reg
70  - interrupts
71  - interrupt-controller
72  - "#interrupt-cells"
73  - gpio-controller
74  - "#gpio-cells"
75
76additionalProperties: false
77
78examples:
79  - |
80    #include <dt-bindings/interrupt-controller/irq.h>
81    #include <dt-bindings/input/linux-event-codes.h>
82    i2c {
83        #address-cells = <1>;
84        #size-cells = <0>;
85
86        pmic@48 {
87            compatible = "maxim,max77650";
88            reg = <0x48>;
89
90            interrupt-controller;
91            interrupt-parent = <&gpio2>;
92            #interrupt-cells = <2>;
93            interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
94
95            gpio-controller;
96            #gpio-cells = <2>;
97            gpio-line-names = "max77650-charger";
98
99            regulators {
100                compatible = "maxim,max77650-regulator";
101
102                max77650_ldo: regulator-ldo {
103                    regulator-compatible = "ldo";
104                    regulator-name = "max77650-ldo";
105                    regulator-min-microvolt = <1350000>;
106                    regulator-max-microvolt = <2937500>;
107                };
108
109                max77650_sbb0: regulator-sbb0 {
110                    regulator-compatible = "sbb0";
111                    regulator-name = "max77650-sbb0";
112                    regulator-min-microvolt = <800000>;
113                    regulator-max-microvolt = <1587500>;
114                };
115            };
116
117            charger {
118                compatible = "maxim,max77650-charger";
119                input-voltage-min-microvolt = <4200000>;
120                input-current-limit-microamp = <285000>;
121            };
122
123            leds {
124                compatible = "maxim,max77650-led";
125                #address-cells = <1>;
126                #size-cells = <0>;
127
128                led@0 {
129                    reg = <0>;
130                    label = "blue:usr0";
131                };
132
133                led@1 {
134                    reg = <1>;
135                    label = "red:usr1";
136                    linux,default-trigger = "heartbeat";
137                };
138
139                led@2 {
140                    reg = <2>;
141                    label = "green:usr2";
142                };
143            };
144
145            onkey {
146                compatible = "maxim,max77650-onkey";
147                linux,code = <KEY_END>;
148                maxim,onkey-slide;
149            };
150        };
151    };
152