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: <<
25 description: | <<
26 Optional mask of which TCSs (Triggered C <<
27 upon triggering. If not specified, then <<
28 completion. The mask bits are available <<
29 <<
30 The AMC TCS is triggered immediately whe <<
31 WAKE/SLEEP TCSs are triggered when the R <<
32 sleep modes. <<
33 <<
34 In most cases, it's necessary to wait in <<
35 ensure resources are available before us <<
36 cases can ensure sufficient delay by oth <<
37 overridden to reduce latencies. <<
38 <<
39 $ref: /schemas/types.yaml#/definitions/uin <<
40 <<
41 required: 24 required:
42 - compatible 25 - compatible
43 26
44 additionalProperties: false 27 additionalProperties: false
45 28
46 examples: 29 examples:
47 # Example 1: apps bcm_voter on SDM845 SoC sh 30 # Example 1: apps bcm_voter on SDM845 SoC should be defined inside &apps_rsc node
48 # as defined in Documentation/devicetree/bin !! 31 # as defined in Documentation/devicetree/bindings/soc/qcom/rpmh-rsc.txt
49 - | 32 - |
50 33
51 apps_bcm_voter: bcm-voter { !! 34 apps_bcm_voter: bcm_voter {
52 compatible = "qcom,bcm-voter"; 35 compatible = "qcom,bcm-voter";
53 }; 36 };
54 37
55 # Example 2: disp bcm_voter on SDM845 should 38 # Example 2: disp bcm_voter on SDM845 should be defined inside &disp_rsc node
56 # as defined in Documentation/devicetree/bin !! 39 # as defined in Documentation/devicetree/bindings/soc/qcom/rpmh-rsc.txt
57 - | 40 - |
58 41
59 #include <dt-bindings/interconnect/qcom,ic !! 42 disp_bcm_voter: bcm_voter {
60 <<
61 disp_bcm_voter: bcm-voter { <<
62 compatible = "qcom,bcm-voter"; 43 compatible = "qcom,bcm-voter";
63 qcom,tcs-wait = <QCOM_ICC_TAG_AMC>; <<
64 }; 44 };
65 ... 45 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.