xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/mediatek,mt6316d-regulator.yaml (revision 96fb1ebd28756790597f73ad25306f58f558be97)
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/regulator/mediatek,mt6316d-regulator.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: MediaTek MT6316 DP/TP SPMI PMIC Regulators
8
9maintainers:
10  - AngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com>
11
12description:
13  The MediaTek MT6316DP/TP PMICs are fully controlled by SPMI interface, both
14  feature four step-down DC/DC (buck) converters, and provides a single Phase,
15  joining Buck 1+2+3+4.
16
17properties:
18  compatible:
19    const: mediatek,mt6316d-regulator
20
21  reg:
22    maxItems: 1
23
24  vbuck1234:
25    type: object
26    $ref: regulator.yaml#
27    unevaluatedProperties: false
28    properties:
29      regulator-allowed-modes:
30        description: |
31          Allowed Buck regulator operating modes allowed. Valid values below.
32            0 - Normal mode with automatic power saving, reducing the switching
33                frequency when light load conditions are detected
34            1 - Forced Continuous Conduction mode (FCCM) for improved voltage
35                regulation accuracy with constant switching frequency but lower
36                regulator efficiency
37            2 - Forced Low Power mode for improved regulator efficiency, used
38                when no heavy load is expected, will shut down unnecessary IP
39                blocks and secondary phases to reduce quiescent current.
40                This mode does not limit the maximum output current but unless
41                only a light load is applied, there will be regulation accuracy
42                and efficiency losses.
43        minItems: 1
44        maxItems: 3
45        items:
46          enum: [ 0, 1, 2 ]
47
48required:
49  - compatible
50  - reg
51
52additionalProperties: false
53
54examples:
55  - |
56    #include <dt-bindings/spmi/spmi.h>
57
58    spmi {
59      #address-cells = <2>;
60      #size-cells = <0>;
61
62      pmic@7 {
63        compatible = "mediatek,mt6316d-regulator";
64        reg = <0x7 SPMI_USID>;
65
66        vbuck1234 {
67          regulator-name = "dvdd_gpustack";
68          regulator-min-microvolt = <400000>;
69          regulator-max-microvolt = <1277500>;
70          regulator-allowed-modes = <0 1 2>;
71          regulator-enable-ramp-delay = <256>;
72        };
73      };
74    };
75...
76