1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-C 1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/interconnec 4 $id: http://devicetree.org/schemas/interconnect/qcom,bcm-voter.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Qualcomm BCM-Voter Interconnect 7 title: Qualcomm BCM-Voter Interconnect
8 8
9 maintainers: 9 maintainers:
10 - Georgi Djakov <georgi.djakov@linaro.org> 10 - Georgi Djakov <georgi.djakov@linaro.org>
11 11
12 description: | 12 description: |
13 The Bus Clock Manager (BCM) is a dedicated h 13 The Bus Clock Manager (BCM) is a dedicated hardware accelerator that manages
14 shared system resources by aggregating reque 14 shared system resources by aggregating requests from multiple Resource State
15 Coordinators (RSC). Interconnect providers a 15 Coordinators (RSC). Interconnect providers are able to vote for aggregated
16 thresholds values from consumers by communic 16 thresholds values from consumers by communicating through their respective
17 RSCs. 17 RSCs.
18 18
19 properties: 19 properties:
20 compatible: 20 compatible:
21 enum: 21 enum:
22 - qcom,bcm-voter 22 - qcom,bcm-voter
23 23
24 qcom,tcs-wait: 24 qcom,tcs-wait:
25 description: | 25 description: |
26 Optional mask of which TCSs (Triggered C 26 Optional mask of which TCSs (Triggered Command Sets) wait for completion
27 upon triggering. If not specified, then 27 upon triggering. If not specified, then the AMC and WAKE sets wait for
28 completion. The mask bits are available 28 completion. The mask bits are available in the QCOM_ICC_TAG_* defines.
29 29
30 The AMC TCS is triggered immediately whe 30 The AMC TCS is triggered immediately when icc_set_bw() is called. The
31 WAKE/SLEEP TCSs are triggered when the R 31 WAKE/SLEEP TCSs are triggered when the RSC transitions between active and
32 sleep modes. 32 sleep modes.
33 33
34 In most cases, it's necessary to wait in 34 In most cases, it's necessary to wait in both the AMC and WAKE sets to
35 ensure resources are available before us 35 ensure resources are available before use. If a specific RSC and its use
36 cases can ensure sufficient delay by oth 36 cases can ensure sufficient delay by other means, then this can be
37 overridden to reduce latencies. 37 overridden to reduce latencies.
38 38
39 $ref: /schemas/types.yaml#/definitions/uin 39 $ref: /schemas/types.yaml#/definitions/uint32
40 40
41 required: 41 required:
42 - compatible 42 - compatible
43 43
44 additionalProperties: false 44 additionalProperties: false
45 45
46 examples: 46 examples:
47 # Example 1: apps bcm_voter on SDM845 SoC sh 47 # Example 1: apps bcm_voter on SDM845 SoC should be defined inside &apps_rsc node
48 # as defined in Documentation/devicetree/bin 48 # as defined in Documentation/devicetree/bindings/soc/qcom/qcom,rpmh-rsc.yaml
49 - | 49 - |
50 50
51 apps_bcm_voter: bcm-voter { 51 apps_bcm_voter: bcm-voter {
52 compatible = "qcom,bcm-voter"; 52 compatible = "qcom,bcm-voter";
53 }; 53 };
54 54
55 # Example 2: disp bcm_voter on SDM845 should 55 # Example 2: disp bcm_voter on SDM845 should be defined inside &disp_rsc node
56 # as defined in Documentation/devicetree/bin 56 # as defined in Documentation/devicetree/bindings/soc/qcom/qcom,rpmh-rsc.yaml
57 - | 57 - |
58 58
59 #include <dt-bindings/interconnect/qcom,ic 59 #include <dt-bindings/interconnect/qcom,icc.h>
60 60
61 disp_bcm_voter: bcm-voter { 61 disp_bcm_voter: bcm-voter {
62 compatible = "qcom,bcm-voter"; 62 compatible = "qcom,bcm-voter";
63 qcom,tcs-wait = <QCOM_ICC_TAG_AMC>; 63 qcom,tcs-wait = <QCOM_ICC_TAG_AMC>;
64 }; 64 };
65 ... 65 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.