summaryrefslogtreecommitdiff
path: root/Documentation/devicetree/bindings/mfd/maxim,max8925.yaml
blob: 86dd810851ab549f93bd7936e64ca1aa54b90489 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/mfd/maxim,max8925.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: MAX8925 PMIC from Maxim Integrated.

maintainers:
  - Lee Jones <lee@kernel.org>

properties:
  compatible:
    const: maxim,max8925

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  interrupt-controller: true

  "#interrupt-cells":
    const: 1
    description:
      The cell is the IRQ number

  maxim,tsc-irq:
    description: second interrupt from max8925
    $ref: /schemas/types.yaml#/definitions/uint32

  regulators:
    type: object

    patternProperties:
      "^SDV[1-3]$|^LDO[1-9]$|^LDO1[0-9]$|^LDO20$":
        description: regulator configuration for SDV1-3 and LDO1-20
        $ref: /schemas/regulator/regulator.yaml
        unevaluatedProperties: false

    additionalProperties: false

  backlight:
    type: object
    properties:
      maxim,max8925-dual-string:
        description: set to 1 to support dual string
        $ref: /schemas/types.yaml#/definitions/uint32
        enum: [0, 1]
        default: 0

    additionalProperties: false

  charger:
    type: object
    properties:
      batt-detect:
        description: set to 1 if battery detection via ID pin is supported
        $ref: /schemas/types.yaml#/definitions/uint32
        enum: [0, 1]
        default: 0

      topoff-threshold:
        description: charging current in topoff mode, configures bits 5-6 in CHG_CNTL1
        $ref: /schemas/types.yaml#/definitions/uint32
        minimum: 0
        maximum: 3
        default: 0

      fast-charge:
        description: set charging current in fast mode, configures bits 0-3 in CHG_CNTL1
        $ref: /schemas/types.yaml#/definitions/uint32
        minimum: 0
        maximum: 7
        default: 0

      no-temp-support:
        description: set to 1 if temperature sensing is not supported
        $ref: /schemas/types.yaml#/definitions/uint32
        enum: [0, 1]
        default: 0

      no-insert-detect:
        description: set to 1 if AC detection is not supported
        $ref: /schemas/types.yaml#/definitions/uint32
        enum: [0, 1]
        default: 0

    additionalProperties: false

required:
  - compatible
  - reg
  - interrupts
  - interrupt-controller
  - "#interrupt-cells"
  - regulators

additionalProperties: false

examples:
  - |
    i2c {
        #address-cells = <1>;
        #size-cells = <0>;

        pmic@3c {
            compatible = "maxim,max8925";
            reg = <0x3c>;
            interrupts = <1>;
            interrupt-parent = <&intcmux4>;
            interrupt-controller;
            #interrupt-cells = <1>;
            maxim,tsc-irq = <0>;

            regulators {
                SDV1 {
                    regulator-min-microvolt = <637500>;
                    regulator-max-microvolt = <1425000>;
                    regulator-boot-on;
                    regulator-always-on;
                };

                LDO1 {
                    regulator-min-microvolt = <750000>;
                    regulator-max-microvolt = <3900000>;
                    regulator-boot-on;
                    regulator-always-on;
                };
            };

            backlight {
                maxim,max8925-dual-string = <0>;
            };

            charger {
                batt-detect = <0>;
                topoff-threshold = <1>;
                fast-charge = <7>;
                no-temp-support = <0>;
                no-insert-detect = <0>;
            };
        };
    };