qcom,msm8998-bwmon.yaml

  1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/interconnect/qcom,msm8998-bwmon.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Qualcomm Interconnect Bandwidth Monitor
  8
  9maintainers:
 10  - Krzysztof Kozlowski <krzk@kernel.org>
 11
 12description: |
 13  Bandwidth Monitor measures current throughput on buses between various NoC
 14  fabrics and provides information when it crosses configured thresholds.
 15
 16  Certain SoCs might have more than one Bandwidth Monitors, for example on SDM845::
 17   - Measuring the bandwidth between CPUs and Last Level Cache Controller -
 18     called just BWMON,
 19   - Measuring the bandwidth between Last Level Cache Controller and memory
 20     (DDR) - called LLCC BWMON.
 21
 22properties:
 23  compatible:
 24    oneOf:
 25      - const: qcom,msm8998-bwmon       # BWMON v4
 26      - items:
 27          - enum:
 28              - qcom,kaanapali-cpu-bwmon
 29              - qcom,qcm2290-cpu-bwmon
 30              - qcom,qcs615-cpu-bwmon
 31              - qcom,qcs8300-cpu-bwmon
 32              - qcom,sa8775p-cpu-bwmon
 33              - qcom,sc7180-cpu-bwmon
 34              - qcom,sc7280-cpu-bwmon
 35              - qcom,sc8280xp-cpu-bwmon
 36              - qcom,sdm845-cpu-bwmon
 37              - qcom,sm6115-cpu-bwmon
 38              - qcom,sm6350-llcc-bwmon
 39              - qcom,sm8250-cpu-bwmon
 40              - qcom,sm8550-cpu-bwmon
 41              - qcom,sm8650-cpu-bwmon
 42              - qcom,sm8750-cpu-bwmon
 43              - qcom,x1e80100-cpu-bwmon
 44          - const: qcom,sdm845-bwmon    # BWMON v4, unified register space
 45      - items:
 46          - enum:
 47              - qcom,qcs615-llcc-bwmon
 48              - qcom,qcs8300-llcc-bwmon
 49              - qcom,sa8775p-llcc-bwmon
 50              - qcom,sc7180-llcc-bwmon
 51              - qcom,sc8280xp-llcc-bwmon
 52              - qcom,sm6350-cpu-bwmon
 53              - qcom,sm8250-llcc-bwmon
 54              - qcom,sm8550-llcc-bwmon
 55              - qcom,sm8650-llcc-bwmon
 56              - qcom,x1e80100-llcc-bwmon
 57          - const: qcom,sc7280-llcc-bwmon
 58      - const: qcom,sc7280-llcc-bwmon   # BWMON v5
 59      - const: qcom,sdm845-llcc-bwmon   # BWMON v5
 60
 61  interconnects:
 62    maxItems: 1
 63
 64  interrupts:
 65    maxItems: 1
 66
 67  operating-points-v2: true
 68  opp-table:
 69    type: object
 70
 71  reg:
 72    # BWMON v5 uses one register address space, v1-v4 use one or two.
 73    minItems: 1
 74    maxItems: 2
 75
 76  reg-names:
 77    minItems: 1
 78    maxItems: 2
 79
 80  nonposted-mmio: true
 81
 82required:
 83  - compatible
 84  - interconnects
 85  - interrupts
 86  - operating-points-v2
 87  - reg
 88
 89additionalProperties: false
 90
 91allOf:
 92  - if:
 93      properties:
 94        compatible:
 95          const: qcom,msm8998-bwmon
 96    then:
 97      properties:
 98        reg:
 99          minItems: 2
100
101        reg-names:
102          items:
103            - const: monitor
104            - const: global
105
106    else:
107      properties:
108        reg:
109          maxItems: 1
110
111        reg-names:
112          maxItems: 1
113
114examples:
115  - |
116    #include <dt-bindings/interconnect/qcom,sdm845.h>
117    #include <dt-bindings/interrupt-controller/arm-gic.h>
118
119    pmu@1436400 {
120        compatible = "qcom,sdm845-cpu-bwmon", "qcom,sdm845-bwmon";
121        reg = <0x01436400 0x600>;
122        interrupts = <GIC_SPI 581 IRQ_TYPE_LEVEL_HIGH>;
123        interconnects = <&gladiator_noc MASTER_APPSS_PROC 3 &mem_noc SLAVE_LLCC 3>;
124
125        operating-points-v2 = <&cpu_bwmon_opp_table>;
126
127        cpu_bwmon_opp_table: opp-table {
128            compatible = "operating-points-v2";
129            opp-0 {
130                opp-peak-kBps = <4800000>;
131            };
132            opp-1 {
133                opp-peak-kBps = <9216000>;
134            };
135            opp-2 {
136                opp-peak-kBps = <15052800>;
137            };
138            opp-3 {
139                opp-peak-kBps = <20889600>;
140            };
141            opp-4 {
142                opp-peak-kBps = <25497600>;
143            };
144        };
145    };