| Message ID | 20230405-topic-master_stats-v3-1-2cb2ba4f2092@linaro.org |
|---|---|
| State | New |
| Headers | show |
| Series | [v3,1/2] dt-bindings: soc: qcom: Add RPM Master stats | expand |
On 14/04/2023 13:37, Konrad Dybcio wrote: > The RPM MSG RAM contains per-RPM-master (e.g. APPS, ADSP etc.) sleep > statistics. They let one assess which core is actively preventing the > system from entering a true low-power mode. > > Signed-off-by: Konrad Dybcio <konrad.dybcio@linaro.org> > --- > .../bindings/soc/qcom/qcom,rpm-master-stats.yaml | 53 ++++++++++++++++++++++ > 1 file changed, 53 insertions(+) > > diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,rpm-master-stats.yaml b/Documentation/devicetree/bindings/soc/qcom/qcom,rpm-master-stats.yaml > new file mode 100644 > index 000000000000..d7e58cbd3344 > --- /dev/null > +++ b/Documentation/devicetree/bindings/soc/qcom/qcom,rpm-master-stats.yaml > @@ -0,0 +1,53 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/soc/qcom/qcom,rpm-master-stats.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Qualcomm Technologies, Inc. (QTI) RPM Master Stats > + > +maintainers: > + - Konrad Dybcio <konrad.dybcio@linaro.org> > + > +description: > + Per-RPM-Master (e.g. APSS, ADSP, etc.) sleep statistics. Explain what is RPM-Master and what do you mean by "sleep". > + > +properties: > + compatible: > + const: qcom,rpm-master-stats > + > + qcom,rpm-msg-ram: > + $ref: /schemas/types.yaml#/definitions/phandle-array > + description: Phandle to an RPM MSG RAM slice containing the master stats > + minItems: 1 > + maxItems: 5 > + > + qcom,master-names: > + $ref: /schemas/types.yaml#/definitions/string-array > + description: RPM Master name There is a relation between this and qcom,rpm-msg-ram which you do not describe. It's not just RPM master name... Best regards, Krzysztof
diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,rpm-master-stats.yaml b/Documentation/devicetree/bindings/soc/qcom/qcom,rpm-master-stats.yaml new file mode 100644 index 000000000000..d7e58cbd3344 --- /dev/null +++ b/Documentation/devicetree/bindings/soc/qcom/qcom,rpm-master-stats.yaml @@ -0,0 +1,53 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/soc/qcom/qcom,rpm-master-stats.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Qualcomm Technologies, Inc. (QTI) RPM Master Stats + +maintainers: + - Konrad Dybcio <konrad.dybcio@linaro.org> + +description: + Per-RPM-Master (e.g. APSS, ADSP, etc.) sleep statistics. + +properties: + compatible: + const: qcom,rpm-master-stats + + qcom,rpm-msg-ram: + $ref: /schemas/types.yaml#/definitions/phandle-array + description: Phandle to an RPM MSG RAM slice containing the master stats + minItems: 1 + maxItems: 5 + + qcom,master-names: + $ref: /schemas/types.yaml#/definitions/string-array + description: RPM Master name + minItems: 1 + maxItems: 5 + +required: + - compatible + - qcom,rpm-msg-ram + - qcom,master-names + +additionalProperties: false + +examples: + - | + stats { + compatible = "qcom,rpm-master-stats"; + qcom,rpm-msg-ram = <&apss_master_stats>, + <&mpss_master_stats>, + <&adsp_master_stats>, + <&cdsp_master_stats>, + <&tz_master_stats>; + qcom,master-names = "APSS", + "MPSS", + "ADSP", + "CDSP", + "TZ"; + }; +...
The RPM MSG RAM contains per-RPM-master (e.g. APPS, ADSP etc.) sleep statistics. They let one assess which core is actively preventing the system from entering a true low-power mode. Signed-off-by: Konrad Dybcio <konrad.dybcio@linaro.org> --- .../bindings/soc/qcom/qcom,rpm-master-stats.yaml | 53 ++++++++++++++++++++++ 1 file changed, 53 insertions(+)