441 lines
12 KiB
YAML
441 lines
12 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/regulator/qcom,rpmh-regulator.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Qualcomm Technologies, Inc. RPMh Regulators
|
|
|
|
maintainers:
|
|
- Bjorn Andersson <bjorn.andersson@linaro.org>
|
|
- Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
|
|
|
|
description: |
|
|
rpmh-regulator devices support PMIC regulator management via the Voltage
|
|
Regulator Manager (VRM) and Oscillator Buffer (XOB) RPMh accelerators.
|
|
The APPS processor communicates with these hardware blocks via a
|
|
Resource State Coordinator (RSC) using command packets. The VRM allows
|
|
changing three parameters for a given regulator, enable state, output
|
|
voltage, and operating mode. The XOB allows changing only a single
|
|
parameter for a given regulator, its enable state. Despite its name,
|
|
the XOB is capable of controlling the enable state of any PMIC peripheral.
|
|
It is used for clock buffers, low-voltage switches, and LDO/SMPS regulators
|
|
which have a fixed voltage and mode.
|
|
|
|
=======================
|
|
Required Node Structure
|
|
=======================
|
|
|
|
RPMh regulators must be described in two levels of device nodes. The first
|
|
level describes the PMIC containing the regulators and must reside within an
|
|
RPMh device node. The second level describes each regulator within the PMIC
|
|
which is to be used on the board. Each of these regulators maps to a single
|
|
RPMh resource.
|
|
|
|
The names used for regulator nodes must match those supported by a given
|
|
PMIC. Supported regulator node names are
|
|
For PM6150, smps1 - smps5, ldo1 - ldo19
|
|
For PM6150L, smps1 - smps8, ldo1 - ldo11, bob
|
|
For PM6350, smps1 - smps5, ldo1 - ldo22
|
|
For PM660, smps1 - smps6, ldo1 - ldo3, ldo5 - ldo19
|
|
For PM660L, smps1 - smps3, smps5, ldo1 - ldo8, bob
|
|
For PM7325, smps1 - smps8, ldo1 - ldo19
|
|
For PM8005, smps1 - smps4
|
|
For PM8009, smps1 - smps2, ldo1 - ldo7
|
|
For PM8150, smps1 - smps10, ldo1 - ldo18
|
|
For PM8150L, smps1 - smps8, ldo1 - ldo11, bob, flash, rgb
|
|
For PM8350, smps1 - smps12, ldo1 - ldo10
|
|
For PM8350C, smps1 - smps10, ldo1 - ldo13, bob
|
|
For PM8450, smps1 - smps6, ldo1 - ldo4
|
|
For PM8998, smps1 - smps13, ldo1 - ldo28, lvs1 - lvs2
|
|
For PMI8998, bob
|
|
For PMR735A, smps1 - smps3, ldo1 - ldo7
|
|
For PMX55, smps1 - smps7, ldo1 - ldo16
|
|
For PMX65, smps1 - smps8, ldo1 - ldo21
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm6150-rpmh-regulators
|
|
- qcom,pm6150l-rpmh-regulators
|
|
- qcom,pm6350-rpmh-regulators
|
|
- qcom,pm660-rpmh-regulators
|
|
- qcom,pm660l-rpmh-regulators
|
|
- qcom,pm7325-rpmh-regulators
|
|
- qcom,pm8005-rpmh-regulators
|
|
- qcom,pm8009-rpmh-regulators
|
|
- qcom,pm8009-1-rpmh-regulators
|
|
- qcom,pm8150-rpmh-regulators
|
|
- qcom,pm8150l-rpmh-regulators
|
|
- qcom,pm8350-rpmh-regulators
|
|
- qcom,pm8350c-rpmh-regulators
|
|
- qcom,pm8450-rpmh-regulators
|
|
- qcom,pm8998-rpmh-regulators
|
|
- qcom,pmg1110-rpmh-regulators
|
|
- qcom,pmi8998-rpmh-regulators
|
|
- qcom,pmm8155au-rpmh-regulators
|
|
- qcom,pmr735a-rpmh-regulators
|
|
- qcom,pmx55-rpmh-regulators
|
|
- qcom,pmx65-rpmh-regulators
|
|
|
|
qcom,pmic-id:
|
|
description: |
|
|
RPMh resource name suffix used for the regulators found
|
|
on this PMIC.
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
enum: [a, b, c, d, e, f, h, k]
|
|
|
|
qcom,always-wait-for-ack:
|
|
description: |
|
|
Boolean flag which indicates that the application processor
|
|
must wait for an ACK or a NACK from RPMh for every request
|
|
sent for this regulator including those which are for a
|
|
strictly lower power state.
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
|
|
vdd-flash-supply:
|
|
description: Input supply phandle of flash.
|
|
|
|
vdd-rgb-supply:
|
|
description: Input supply phandle of rgb.
|
|
|
|
bob:
|
|
type: object
|
|
$ref: "regulator.yaml#"
|
|
description: BOB regulator node.
|
|
dependencies:
|
|
regulator-allow-set-load: ["regulator-allowed-modes"]
|
|
|
|
patternProperties:
|
|
"^(smps|ldo|lvs)[0-9]+$":
|
|
type: object
|
|
$ref: "regulator.yaml#"
|
|
description: smps/ldo regulator nodes(s).
|
|
dependencies:
|
|
regulator-allow-set-load: ["regulator-allowed-modes"]
|
|
|
|
required:
|
|
- compatible
|
|
- qcom,pmic-id
|
|
|
|
allOf:
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm6150-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-l2-l3-supply: true
|
|
vdd-l4-l7-l8-supply: true
|
|
vdd-l5-l16-l17-l18-l19-supply: true
|
|
vdd-l10-l14-l15-supply: true
|
|
vdd-l11-l12-l13-supply: true
|
|
patternProperties:
|
|
"^vdd-l[169]-supply$": true
|
|
"^vdd-s[1-5]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm6150l-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-bob-supply:
|
|
description: BOB regulator parent supply phandle.
|
|
vdd-l1-l8-supply: true
|
|
vdd-l2-l3-supply: true
|
|
vdd-l4-l5-l6-supply: true
|
|
vdd-l7-l11-supply: true
|
|
vdd-l9-l10-supply: true
|
|
patternProperties:
|
|
"^vdd-s[1-8]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm660-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-l1-l6-l7-supply: true
|
|
vdd-l2-l3-supply: true
|
|
vdd-l5-supply: true
|
|
vdd-l8-l9-l10-l11-l12-l13-l14-supply: true
|
|
vdd-l15-l16-l17-l18-l19-supply: true
|
|
patternProperties:
|
|
"^vdd-s[1-6]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm660l-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-bob-supply:
|
|
description: BOB regulator parent supply phandle.
|
|
vdd-l1-l9-l10-supply: true
|
|
vdd-l2-supply: true
|
|
vdd-l3-l5-l7-l8-supply: true
|
|
vdd-l4-l6-supply: true
|
|
vdd-s3-s4-supply: true
|
|
patternProperties:
|
|
"^vdd-s[125]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm7325-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-l1-l4-l12-l15-supply: true
|
|
vdd-l2-l7-supply: true
|
|
vdd-l6-l9-l10-supply: true
|
|
vdd-l11-l17-l18-l19-supply: true
|
|
vdd-l13-supply: true
|
|
vdd-l14-l16-supply: true
|
|
patternProperties:
|
|
"^vdd-l[358]-supply$": true
|
|
"^vdd-s[1-8]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm8005-rpmh-regulators
|
|
then:
|
|
patternProperties:
|
|
"^vdd-s[1-4]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm8009-rpmh-regulators
|
|
- qcom,pm8009-1-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-l5-l6-supply: true
|
|
patternProperties:
|
|
"^vdd-l[1-47]-supply$": true
|
|
"^vdd-s[1-2]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm8150-rpmh-regulators
|
|
- qcom,pmm8155au-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-l1-l8-l11-supply: true
|
|
vdd-l2-l10-supply: true
|
|
vdd-l3-l4-l5-l18-supply: true
|
|
vdd-l6-l9-supply: true
|
|
vdd-l7-l12-l14-l15-supply: true
|
|
vdd-l13-l16-l17-supply: true
|
|
patternProperties:
|
|
"^vdd-s([1-9]|10)-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm8150l-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-bob-supply:
|
|
description: BOB regulator parent supply phandle.
|
|
vdd-l1-l8-supply: true
|
|
vdd-l2-l3-supply: true
|
|
vdd-l4-l5-l6-supply: true
|
|
vdd-l7-l11-supply: true
|
|
vdd-l9-l10-supply: true
|
|
patternProperties:
|
|
"^vdd-s[1-8]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm8350-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-l1-l4-supply: true
|
|
vdd-l2-l7-supply: true
|
|
vdd-l3-l5-supply: true
|
|
vdd-l6-l9-l10-supply: true
|
|
vdd-l8-supply: true
|
|
patternProperties:
|
|
"^vdd-s([1-9]|1[0-2])-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm8350c-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-bob-supply:
|
|
description: BOB regulator parent supply phandle.
|
|
vdd-l1-l12-supply: true
|
|
vdd-l2-l8-supply: true
|
|
vdd-l3-l4-l5-l7-l13-supply: true
|
|
vdd-l6-l9-l11-supply: true
|
|
vdd-l10-supply: true
|
|
patternProperties:
|
|
"^vdd-s([1-9]|10)-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm8450-rpmh-regulators
|
|
then:
|
|
patternProperties:
|
|
"^vdd-l[1-4]-supply$": true
|
|
"^vdd-s[1-6]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm8998-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-l1-l27-supply: true
|
|
vdd-l2-l8-l17-supply: true
|
|
vdd-l3-l11-supply: true
|
|
vdd-l4-l5-supply: true
|
|
vdd-l6-supply: true
|
|
vdd-l7-l12-l14-l15-supply: true
|
|
vdd-l9-supply: true
|
|
vdd-l10-l23-l25-supply: true
|
|
vdd-l13-l19-l21-supply: true
|
|
vdd-l16-l28-supply: true
|
|
vdd-l18-l22-supply: true
|
|
vdd-l20-l24-supply: true
|
|
vdd-l26-supply: true
|
|
vin-lvs-1-2-supply: true
|
|
patternProperties:
|
|
"^vdd-s([1-9]|1[0-3])-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pmg1110-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-s1-supply: true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pmi8998-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-bob-supply:
|
|
description: BOB regulator parent supply phandle.
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pmr735a-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-l1-l2-supply: true
|
|
vdd-l3-supply: true
|
|
vdd-l4-supply: true
|
|
vdd-l5-l6-supply: true
|
|
vdd-l7-bob-supply: true
|
|
patternProperties:
|
|
"^vdd-s[1-3]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pmx55-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-l1-l2-supply: true
|
|
vdd-l3-l9-supply: true
|
|
vdd-l4-l12-supply: true
|
|
vdd-l5-l6-supply: true
|
|
vdd-l7-l8-supply: true
|
|
vdd-l10-l11-l13-supply: true
|
|
patternProperties:
|
|
"^vdd-l1[4-6]-supply$": true
|
|
"^vdd-s[1-7]-supply$": true
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pmx65-rpmh-regulators
|
|
then:
|
|
properties:
|
|
vdd-l2-l18-supply: true
|
|
vdd-l5-l6-l16-supply: true
|
|
vdd-l8-l9-supply: true
|
|
vdd-l11-l13-supply: true
|
|
patternProperties:
|
|
"^vdd-l[1347]-supply$": true
|
|
"^vdd-l1[0245789]-supply$": true
|
|
"^vdd-l2[01]-supply$": true
|
|
"^vdd-s[1-8]-supply$": true
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/regulator/qcom,rpmh-regulator.h>
|
|
|
|
pm8998-rpmh-regulators {
|
|
compatible = "qcom,pm8998-rpmh-regulators";
|
|
qcom,pmic-id = "a";
|
|
|
|
vdd-l7-l12-l14-l15-supply = <&pm8998_s5>;
|
|
|
|
smps2 {
|
|
regulator-min-microvolt = <1100000>;
|
|
regulator-max-microvolt = <1100000>;
|
|
};
|
|
|
|
ldo7 {
|
|
regulator-min-microvolt = <1800000>;
|
|
regulator-max-microvolt = <1800000>;
|
|
regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
|
|
regulator-allowed-modes =
|
|
<RPMH_REGULATOR_MODE_LPM
|
|
RPMH_REGULATOR_MODE_HPM>;
|
|
regulator-allow-set-load;
|
|
};
|
|
|
|
lvs1 {
|
|
regulator-min-microvolt = <1800000>;
|
|
regulator-max-microvolt = <1800000>;
|
|
};
|
|
};
|
|
|
|
pmi8998-rpmh-regulators {
|
|
compatible = "qcom,pmi8998-rpmh-regulators";
|
|
qcom,pmic-id = "b";
|
|
|
|
bob {
|
|
regulator-min-microvolt = <3312000>;
|
|
regulator-max-microvolt = <3600000>;
|
|
regulator-allowed-modes =
|
|
<RPMH_REGULATOR_MODE_AUTO
|
|
RPMH_REGULATOR_MODE_HPM>;
|
|
regulator-initial-mode = <RPMH_REGULATOR_MODE_AUTO>;
|
|
};
|
|
};
|
|
...
|