Documentation/devicetree/bindings/arm/l2c2x0.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/arm/l2c2x0.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: ARM L2 Cache Controller
   8
   9 maintainers:
  10   - Rob Herring <robh@kernel.org>
  11
  12 description: |+
  13   ARM cores often have a separate L2C210/L2C220/L2C310 (also known as PL210/
  14   PL220/PL310 and variants) based level 2 cache controller. All these various
  15   implementations of the L2 cache controller have compatible programming
  16   models (Note 1). Some of the properties that are just prefixed "cache-*" are
  17   taken from section 3.7.3 of the Devicetree Specification which can be found
  18   at:
  19   https://www.devicetree.org/specifications/
  20
  21   Note 1: The description in this document doesn't apply to integrated L2
  22     cache controllers as found in e.g. Cortex-A15/A7/A57/A53. These
  23     integrated L2 controllers are assumed to be all preconfigured by
  24     early secure boot code. Thus no need to deal with their configuration
  25     in the kernel at all.
  26
  27 allOf:
  28   - $ref: /schemas/cache-controller.yaml#
  29
  30 properties:
  31   compatible:
  32     enum:
  33       - arm,pl310-cache
  34       - arm,l220-cache
  35       - arm,l210-cache
  36         # DEPRECATED by "brcm,bcm11351-a2-pl310-cache"
  37       - bcm,bcm11351-a2-pl310-cache
  38         # For Broadcom bcm11351 chipset where an
  39         # offset needs to be added to the address before passing down to the L2
  40         # cache controller
  41       - brcm,bcm11351-a2-pl310-cache
  42         # Marvell Controller designed to be
  43         # compatible with the ARM one, with system cache mode (meaning
  44         # maintenance operations on L1 are broadcasted to the L2 and L2
  45         # performs the same operation).
  46       - marvell,aurora-system-cache
  47         # Marvell Controller designed to be
  48         # compatible with the ARM one with outer cache mode.
  49       - marvell,aurora-outer-cache
  50         # Marvell Tauros3 cache controller, compatible
  51         # with arm,pl310-cache controller.
  52       - marvell,tauros3-cache
  53
  54   cache-level:
  55     const: 2
  56
  57   cache-unified: true
  58   cache-size: true
  59   cache-sets: true
  60   cache-block-size: true
  61   cache-line-size: true
  62
  63   reg:
  64     maxItems: 1
  65
  66   arm,data-latency:
  67     description: Cycles of latency for Data RAM accesses. Specifies 3 cells of
  68       read, write and setup latencies. Minimum valid values are 1. Controllers
  69       without setup latency control should use a value of 0.
  70     allOf:
  71       - $ref: /schemas/types.yaml#/definitions/uint32-array
  72       - minItems: 2
  73         maxItems: 3
  74         items:
  75           minimum: 0
  76           maximum: 8
  77
  78   arm,tag-latency:
  79     description: Cycles of latency for Tag RAM accesses. Specifies 3 cells of
  80       read, write and setup latencies. Controllers without setup latency control
  81       should use 0. Controllers without separate read and write Tag RAM latency
  82       values should only use the first cell.
  83     allOf:
  84       - $ref: /schemas/types.yaml#/definitions/uint32-array
  85       - minItems: 1
  86         maxItems: 3
  87         items:
  88           minimum: 0
  89           maximum: 8
  90
  91   arm,dirty-latency:
  92     description: Cycles of latency for Dirty RAMs. This is a single cell.
  93     allOf:
  94       - $ref: /schemas/types.yaml#/definitions/uint32
  95       - minimum: 1
  96         maximum: 8
  97
  98   arm,filter-ranges:
  99     description: <start length> Starting address and length of window to
 100       filter. Addresses in the filter window are directed to the M1 port. Other
 101       addresses will go to the M0 port.
 102     allOf:
 103       - $ref: /schemas/types.yaml#/definitions/uint32-array
 104       - items:
 105           minItems: 2
 106           maxItems: 2
 107
 108   arm,io-coherent:
 109     description: indicates that the system is operating in an hardware
 110       I/O coherent mode. Valid only when the arm,pl310-cache compatible
 111       string is used.
 112     type: boolean
 113
 114   interrupts:
 115     # Either a single combined interrupt or up to 9 individual interrupts
 116     minItems: 1
 117     maxItems: 9
 118
 119   cache-id-part:
 120     description: cache id part number to be used if it is not present
 121       on hardware
 122     $ref: /schemas/types.yaml#/definitions/uint32
 123
 124   wt-override:
 125     description: If present then L2 is forced to Write through mode
 126     type: boolean
 127
 128   arm,double-linefill:
 129     description: Override double linefill enable setting. Enable if
 130       non-zero, disable if zero.
 131     allOf:
 132       - $ref: /schemas/types.yaml#/definitions/uint32
 133       - enum: [ 0, 1 ]
 134
 135   arm,double-linefill-incr:
 136     description: Override double linefill on INCR read. Enable
 137       if non-zero, disable if zero.
 138     allOf:
 139       - $ref: /schemas/types.yaml#/definitions/uint32
 140       - enum: [ 0, 1 ]
 141
 142   arm,double-linefill-wrap:
 143     description: Override double linefill on WRAP read. Enable
 144       if non-zero, disable if zero.
 145     allOf:
 146       - $ref: /schemas/types.yaml#/definitions/uint32
 147       - enum: [ 0, 1 ]
 148
 149   arm,prefetch-drop:
 150     description: Override prefetch drop enable setting. Enable if non-zero,
 151       disable if zero.
 152     allOf:
 153       - $ref: /schemas/types.yaml#/definitions/uint32
 154       - enum: [ 0, 1 ]
 155
 156   arm,prefetch-offset:
 157     description: Override prefetch offset value.
 158     allOf:
 159       - $ref: /schemas/types.yaml#/definitions/uint32
 160       - enum: [ 0, 1, 2, 3, 4, 5, 6, 7, 15, 23, 31 ]
 161
 162   arm,shared-override:
 163     description: The default behavior of the L220 or PL310 cache
 164       controllers with respect to the shareable attribute is to transform "normal
 165       memory non-cacheable transactions" into "cacheable no allocate" (for reads)
 166       or "write through no write allocate" (for writes).
 167       On systems where this may cause DMA buffer corruption, this property must
 168       be specified to indicate that such transforms are precluded.
 169     type: boolean
 170
 171   arm,parity-enable:
 172     description: enable parity checking on the L2 cache (L220 or PL310).
 173     type: boolean
 174
 175   arm,parity-disable:
 176     description: disable parity checking on the L2 cache (L220 or PL310).
 177     type: boolean
 178
 179   arm,outer-sync-disable:
 180     description: disable the outer sync operation on the L2 cache.
 181       Some core tiles, especially ARM PB11MPCore have a faulty L220 cache that
 182       will randomly hang unless outer sync operations are disabled.
 183     type: boolean
 184
 185   prefetch-data:
 186     description: |
 187       Data prefetch. Value: <0> (forcibly disable), <1>
 188       (forcibly enable), property absent (retain settings set by firmware)
 189     allOf:
 190       - $ref: /schemas/types.yaml#/definitions/uint32
 191       - enum: [ 0, 1 ]
 192
 193   prefetch-instr:
 194     description: |
 195       Instruction prefetch. Value: <0> (forcibly disable),
 196       <1> (forcibly enable), property absent (retain settings set by
 197       firmware)
 198     allOf:
 199       - $ref: /schemas/types.yaml#/definitions/uint32
 200       - enum: [ 0, 1 ]
 201
 202   arm,dynamic-clock-gating:
 203     description: |
 204       L2 dynamic clock gating. Value: <0> (forcibly
 205       disable), <1> (forcibly enable), property absent (OS specific behavior,
 206       preferably retain firmware settings)
 207     allOf:
 208       - $ref: /schemas/types.yaml#/definitions/uint32
 209       - enum: [ 0, 1 ]
 210
 211   arm,standby-mode:
 212     description: L2 standby mode enable. Value <0> (forcibly disable),
 213       <1> (forcibly enable), property absent (OS specific behavior,
 214       preferably retain firmware settings)
 215     allOf:
 216       - $ref: /schemas/types.yaml#/definitions/uint32
 217       - enum: [ 0, 1 ]
 218
 219   arm,early-bresp-disable:
 220     description: Disable the CA9 optimization Early BRESP (PL310)
 221     type: boolean
 222
 223   arm,full-line-zero-disable:
 224     description: Disable the CA9 optimization Full line of zero
 225       write (PL310)
 226     type: boolean
 227
 228 required:
 229   - compatible
 230   - cache-unified
 231   - reg
 232
 233 additionalProperties: false
 234
 235 examples:
 236   - |
 237     cache-controller@fff12000 {
 238         compatible = "arm,pl310-cache";
 239         reg = <0xfff12000 0x1000>;
 240         arm,data-latency = <1 1 1>;
 241         arm,tag-latency = <2 2 2>;
 242         arm,filter-ranges = <0x80000000 0x8000000>;
 243         cache-unified;
 244         cache-level = <2>;
 245         interrupts = <45>;
 246     };
 247
 248 ...