aboutsummaryrefslogtreecommitdiffstats
path: root/drivers/staging/hikey9xx/hisilicon,hi6421-spmi-pmic.yaml
blob: 80e74c261e0536ec12628395dabed51d833d08d3 (plain) (blame)
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
146
147
148
149
150
151
152
153
154
155
156
157
158
159
# SPDX-License-Identifier: GPL-2.0
%YAML 1.2
---
$id: http://devicetree.org/schemas/mfd/hisilicon,hi6421-spmi-pmic.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: HiSilicon 6421v600 SPMI PMIC

maintainers:
  - Mauro Carvalho Chehab <mchehab+huawei@kernel.org>

description: |
  HiSilicon 6421v600 should be connected inside a MIPI System Power Management
  (SPMI) bus. It provides interrupts and power supply.

  The GPIO and interrupt settings are represented as part of the top-level PMIC
  node.

  The SPMI controller part is provided by
  drivers/staging/hikey9xx/hisilicon,hisi-spmi-controller.yaml.

properties:
  $nodename:
    pattern: "pmic@[0-9a-f]"

  compatible:
    const: hisilicon,hi6421v600-spmi

  reg:
    maxItems: 1

  '#interrupt-cells':
    const: 2

  interrupt-controller:
    description:
      Identify that the PMIC is capable of behaving as an interrupt controller.

  gpios:
    maxItems: 1

  regulators:
    type: object

    properties:
      '#address-cells':
        const: 1

      '#size-cells':
        const: 0

    patternProperties:
      '^ldo[0-9]+@[0-9a-f]$':
        type: object

        $ref: "/schemas/regulator/regulator.yaml#"

        properties:
          reg:
            description: Enable register.

          '#address-cells':
            const: 1

          '#size-cells':
            const: 0

          vsel-reg:
            description: Voltage selector register.

          enable-mask:
            description: Bitmask used to enable the regulator.

          voltage-table:
            description: Table with the selector items for the voltage regulator.
            minItems: 2
            maxItems: 16

          off-on-delay-us:
            description: Time required for changing state to enabled in microseconds.

          startup-delay-us:
            description: Startup time in microseconds.

          idle-mode-mask:
            description: Bitmask used to put the regulator on idle mode.

          eco-microamp:
            description: Maximum current while on idle mode.

        required:
          - reg
          - vsel-reg
          - enable-mask
          - voltage-table
          - off-on-delay-us
          - startup-delay-us

required:
  - compatible
  - reg
  - regulators

examples:
  - |
    /* pmic properties */

    pmic: pmic@0 {
      compatible = "hisilicon,hi6421-spmi";
      reg = <0 0>;

      #interrupt-cells = <2>;
      interrupt-controller;
      gpios = <&gpio28 0 0>;

      regulators {
        #address-cells = <1>;
        #size-cells = <0>;

        ldo3: ldo3@16 {
          reg = <0x16>;
          vsel-reg = <0x51>;

          regulator-name = "ldo3";
          regulator-min-microvolt = <1500000>;
          regulator-max-microvolt = <2000000>;
          regulator-boot-on;

          enable-mask = <0x01>;

          voltage-table = <1500000>, <1550000>, <1600000>, <1650000>,
                          <1700000>, <1725000>, <1750000>, <1775000>,
                          <1800000>, <1825000>, <1850000>, <1875000>,
                          <1900000>, <1925000>, <1950000>, <2000000>;
          off-on-delay-us = <20000>;
          startup-delay-us = <120>;
        };

        ldo4: ldo4@17 { /* 40 PIN */
          reg = <0x17>;
          vsel-reg = <0x52>;

          regulator-name = "ldo4";
          regulator-min-microvolt = <1725000>;
          regulator-max-microvolt = <1900000>;
          regulator-boot-on;

          enable-mask = <0x01>;
          idle-mode-mask = <0x10>;
          eco-microamp = <10000>;

          hi6421-vsel = <0x52 0x07>;
          voltage-table = <1725000>, <1750000>, <1775000>, <1800000>,
                          <1825000>, <1850000>, <1875000>, <1900000>;
          off-on-delay-us = <20000>;
          startup-delay-us = <120>;
        };
      };
    };