mirror of
https://github.com/torvalds/linux.git
synced 2026-04-19 23:34:00 -04:00
9a2c674ee7
On Qualcomm platforms, most subsystems (e.g. audio/modem DSP) are described as remote processors in the device tree, with a dedicated node where properties and services related to them can be described. The Resource Power Manager (RPM) is also such a subsystem, with a remote processor that is running a special firmware. Unfortunately, the RPM never got a dedicated node representing it properly in the device tree. Most of the RPM services are described below a top-level /smd or /rpm-glink node. However, SMD/GLINK is just one of the communication channels to the RPM firmware. For example, the MPM interrupt functionality provided by the RPM does not use SMD/GLINK but writes directly to a special memory region allocated by the RPM firmware in combination with a mailbox. Currently there is no good place in the device tree to describe this functionality. It doesn't belong below SMD/GLINK but it's not an independent top-level device either. Introduce a new "qcom,rpm-proc" compatible that allows describing the RPM as a remote processor/subsystem like all others. The SMD/GLINK node is moved to a "smd-edge"/"glink-edge" subnode consistent with other existing bindings. Additional subnodes (e.g. interrupt-controller for MPM, rpm-master-stats) can be also added there. Deprecate using the old top-level /smd node since all SMD edges are now specified as subnodes of the remote processor. Signed-off-by: Stephan Gerhold <stephan@gerhold.net> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Link: https://lore.kernel.org/r/20230531-rpm-rproc-v3-6-a07dcdefd918@gerhold.net Signed-off-by: Bjorn Andersson <andersson@kernel.org>
161 lines
4.4 KiB
YAML
161 lines
4.4 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/soc/qcom/qcom,smd-rpm.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Qualcomm Resource Power Manager (RPM) over SMD/GLINK
|
|
|
|
description: |
|
|
This driver is used to interface with the Resource Power Manager (RPM) found
|
|
in various Qualcomm platforms. The RPM allows each component in the system
|
|
to vote for state of the system resources, such as clocks, regulators and bus
|
|
frequencies.
|
|
|
|
The SMD or GLINK information for the RPM edge should be filled out. See
|
|
qcom,smd.yaml for the required edge properties. All SMD/GLINK related
|
|
properties will reside within the RPM node itself.
|
|
|
|
The RPM exposes resources to its subnodes. The rpm_requests node must be
|
|
present and this subnode may contain children that designate regulator
|
|
resources.
|
|
|
|
Refer to Documentation/devicetree/bindings/regulator/qcom,smd-rpm-regulator.yaml
|
|
for information on the regulator subnodes that can exist under the
|
|
rpm_requests.
|
|
|
|
maintainers:
|
|
- Andy Gross <agross@kernel.org>
|
|
- Bjorn Andersson <bjorn.andersson@linaro.org>
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,rpm-apq8084
|
|
- qcom,rpm-ipq6018
|
|
- qcom,rpm-ipq9574
|
|
- qcom,rpm-mdm9607
|
|
- qcom,rpm-msm8226
|
|
- qcom,rpm-msm8610
|
|
- qcom,rpm-msm8909
|
|
- qcom,rpm-msm8916
|
|
- qcom,rpm-msm8917
|
|
- qcom,rpm-msm8936
|
|
- qcom,rpm-msm8937
|
|
- qcom,rpm-msm8952
|
|
- qcom,rpm-msm8953
|
|
- qcom,rpm-msm8974
|
|
- qcom,rpm-msm8976
|
|
- qcom,rpm-msm8994
|
|
- qcom,rpm-msm8996
|
|
- qcom,rpm-msm8998
|
|
- qcom,rpm-qcm2290
|
|
- qcom,rpm-qcs404
|
|
- qcom,rpm-sdm660
|
|
- qcom,rpm-sm6115
|
|
- qcom,rpm-sm6125
|
|
- qcom,rpm-sm6375
|
|
|
|
clock-controller:
|
|
$ref: /schemas/clock/qcom,rpmcc.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
power-controller:
|
|
$ref: /schemas/power/qcom,rpmpd.yaml#
|
|
|
|
qcom,glink-channels:
|
|
$ref: /schemas/types.yaml#/definitions/string-array
|
|
description: Channel name used for the RPM communication
|
|
items:
|
|
- const: rpm_requests
|
|
|
|
qcom,smd-channels:
|
|
$ref: /schemas/types.yaml#/definitions/string-array
|
|
description: Channel name used for the RPM communication
|
|
items:
|
|
- const: rpm_requests
|
|
|
|
patternProperties:
|
|
"^regulators(-[01])?$":
|
|
$ref: /schemas/regulator/qcom,smd-rpm-regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- qcom,rpm-apq8084
|
|
- qcom,rpm-mdm9607
|
|
- qcom,rpm-msm8226
|
|
- qcom,rpm-msm8610
|
|
- qcom,rpm-msm8909
|
|
- qcom,rpm-msm8916
|
|
- qcom,rpm-msm8917
|
|
- qcom,rpm-msm8936
|
|
- qcom,rpm-msm8937
|
|
- qcom,rpm-msm8952
|
|
- qcom,rpm-msm8953
|
|
- qcom,rpm-msm8974
|
|
- qcom,rpm-msm8976
|
|
- qcom,rpm-msm8994
|
|
then:
|
|
properties:
|
|
qcom,glink-channels: false
|
|
required:
|
|
- qcom,smd-channels
|
|
else:
|
|
properties:
|
|
qcom,smd-channels: false
|
|
required:
|
|
- qcom,glink-channels
|
|
|
|
required:
|
|
- compatible
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
|
#include <dt-bindings/interrupt-controller/irq.h>
|
|
|
|
remoteproc {
|
|
compatible = "qcom,msm8916-rpm-proc", "qcom,rpm-proc";
|
|
|
|
smd-edge {
|
|
interrupts = <GIC_SPI 168 IRQ_TYPE_EDGE_RISING>;
|
|
qcom,ipc = <&apcs 8 0>;
|
|
qcom,smd-edge = <15>;
|
|
|
|
rpm-requests {
|
|
compatible = "qcom,rpm-msm8916";
|
|
qcom,smd-channels = "rpm_requests";
|
|
|
|
clock-controller {
|
|
compatible = "qcom,rpmcc-msm8916", "qcom,rpmcc";
|
|
#clock-cells = <1>;
|
|
clocks = <&xo_board>;
|
|
clock-names = "xo";
|
|
};
|
|
|
|
power-controller {
|
|
compatible = "qcom,msm8916-rpmpd";
|
|
#power-domain-cells = <1>;
|
|
operating-points-v2 = <&rpmpd_opp_table>;
|
|
|
|
rpmpd_opp_table: opp-table {
|
|
compatible = "operating-points-v2";
|
|
|
|
opp-1 {
|
|
opp-level = <1>;
|
|
};
|
|
opp-2 {
|
|
opp-level = <2>;
|
|
};
|
|
};
|
|
};
|
|
};
|
|
};
|
|
};
|