From mboxrd@z Thu Jan 1 00:00:00 1970 From: Kumar Gala Subject: Re: [RFC 3/7] mfd: devicetree: bindings: Add Qualcomm SMD based RPM DT binding Date: Tue, 30 Sep 2014 08:46:29 -0500 Message-ID: <85C5C172-D309-41B4-B511-7820BAFDA017@codeaurora.org> References: <1412037291-16880-1-git-send-email-bjorn.andersson@sonymobile.com> <1412037291-16880-4-git-send-email-bjorn.andersson@sonymobile.com> Mime-Version: 1.0 (Mac OS X Mail 7.3 \(1878.6\)) Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: QUOTED-PRINTABLE Return-path: In-Reply-To: <1412037291-16880-4-git-send-email-bjorn.andersson@sonymobile.com> Sender: linux-arm-msm-owner@vger.kernel.org To: Bjorn Andersson Cc: Andy Gross , Arnd Bergmann , Grant Likely , Ian Campbell , Lee Jones , Liam Girdwood , Mark Brown , Mark Rutland , Pawel Moll , Rob Herring , Samuel Ortiz , "open list:OPEN FIRMWARE AND..." , linux-arm-kernel@lists.infradead.org, linux-arm-msm , linux-kernel@vger.kernel.org, Jeffrey Hugo List-Id: devicetree@vger.kernel.org On Sep 29, 2014, at 7:34 PM, Bjorn Andersson wrote: > Add binding documentation for the Qualcomm Resource Power Manager (RP= M) > using shared memory (Qualcomm SMD) as transport mechanism. This is fo= und > in 8974 and newer based devices. >=20 > The binding currently describes the rpm itself and the regulator > subnodes. >=20 > Signed-off-by: Bjorn Andersson > --- >=20 > Note that this patch extends the rpm dt-bindings header from [1]. >=20 > [1] https://lkml.org/lkml/2014/9/22/733 >=20 > .../devicetree/bindings/mfd/qcom-rpm-smd.txt | 122 +++++++++++= +++++++++ > include/dt-bindings/mfd/qcom-rpm.h | 36 ++++++ > 2 files changed, 158 insertions(+) > create mode 100644 Documentation/devicetree/bindings/mfd/qcom-rpm-smd= =2Etxt >=20 > diff --git a/Documentation/devicetree/bindings/mfd/qcom-rpm-smd.txt b= /Documentation/devicetree/bindings/mfd/qcom-rpm-smd.txt > new file mode 100644 > index 0000000..a846101 > --- /dev/null > +++ b/Documentation/devicetree/bindings/mfd/qcom-rpm-smd.txt > @@ -0,0 +1,122 @@ > +Qualcomm Resource Power Manager (RPM) over SMD > + > +This driver is used to interface with the Resource Power Manager (RP= M) found in > +various Qualcomm platforms. The RPM allows each component in the sys= tem to vote > +for state of the system resources, such as clocks, regulators and bu= s > +frequencies. > + > +- compatible: > + Usage: required > + Value type: > + Definition: must be one of: > + "qcom,rpm-msm8974=94 Why not =93qcom,rpm-smd=94. I=92d like to get Jeff H=92s input on how = what we do here for compat and distinguish the A-family RPM support vs = B-family/RPM-SMD support. > + > +- qcom,smd-channels: > + Usage: required > + Value type: > + Definition: Shared Memory Channel used for communication with the R= PM > + This needs more details. > +- #address-cells: > + Usage: required > + Value type: > + Definition: must be 1 > + > +- #size-cells: > + Usage: required > + Value type: > + Definition: must be 0 > + > +=3D SUBDEVICES As I mentioned for the the RPM binding on a-family, we should split out= the devices into their own binding specs. > + > +The RPM exposes resources to its subnodes. The below bindings specif= y the set > +of valid subnodes that can operate on these resources. > + > +=3D=3D Switch-mode Power Supply regulator > + > +- compatible: > + Usage: required > + Value type: > + Definition: must be one of: > + "qcom,rpm-pm8841-smps" > + "qcom,rpm-pm8941-smps" > + > + > +- reg: > + Usage: required > + Value type: > + Definition: resource as defined in > + must be one of: > + QCOM_RPM_PM8841_SMPS1 - QCOM_RPM_PM8841_SMPS4, > + QCOM_RPM_PM8941_SMPS1 - QCOM_RPM_PM8941_SMPS3 > + > +Standard regulator bindings are used inside switch mode power supply= subnodes. > +Check Documentation/devicetree/bindings/regulator/regulator.txt for = more > +details. > + > +=3D=3D Low-dropout regulator > + > +- compatible: > + Usage: required > + Value type: > + Definition: must be one of: > + "qcom,rpm-pm8941-ldo" > + > +- reg: > + Usage: required > + Value type: > + Definition: resource as defined in > + must be one of: > + QCOM_RPM_PM8941_LDO1 - QCOM_RPM_PM8941_LDO24 > + > +Standard regulator bindings are used inside switch low-dropout regul= ator > +subnodes. Check Documentation/devicetree/bindings/regulator/regulat= or.txt for > +more details. > + > +=3D=3D Switch > + > +- compatible: > + Usage: required > + Value type: > + Definition: must be one of: > + "qcom,rpm-pm8941-switch" > + > +- reg: > + Usage: required > + Value type: > + Definition: resource as defined in > + must be one of: > + QCOM_RPM_PM8941_LVS1 - QCOM_RPM_PM8941_LVS3, > + QCOM_RPM_PM8941_MVS1 - QCOM_RPM_PM8941_MVS2 > + > +Standard regulator bindings are used inside switch regulator subnode= s. Check > +Documentation/devicetree/bindings/regulator/regulator.txt for more d= etails. > + > +=3D EXAMPLE > + > + #include > + > + rpm@108000 { > + compatible =3D "qcom,rpm-msm8960"; > + qcom,smd-channels =3D "rpm_requests"; > + > + #address-cells =3D <1>; > + #size-cells =3D <0>; > + > + pm8941_s1: regulator-s1 { > + compatible =3D "qcom,rpm-pm8941-smps"; > + reg =3D ; > + > + regulator-min-microvolt =3D <1300000>; > + regulator-max-microvolt =3D <1300000>; > + }; > + > + pm8941_l3: pm8941-l3 { > + compatible =3D "qcom,rpm-pm8941-ldo"; > + reg =3D ; > + > + regulator-min-microvolt =3D <1200000>; > + regulator-max-microvolt =3D <1200000>; > + }; > + > + }; > + - k --=20 Employee of Qualcomm Innovation Center, Inc. Qualcomm Innovation Center, Inc. is a member of Code Aurora Forum, host= ed by The Linux Foundation