renesas,rpc-if.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/memory-controllers/renesas,rpc-if.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Renesas Reduced Pin Count Interface (RPC-IF)
  8
  9maintainers:
 10  - Sergei Shtylyov <sergei.shtylyov@gmail.com>
 11
 12description: |
 13  Renesas RPC-IF allows a SPI flash or HyperFlash connected to the SoC to
 14  be accessed via the external address space read mode or the manual mode.
 15
 16  The flash chip itself should be represented by a subnode of the RPC-IF node.
 17  The flash interface is selected based on the "compatible" property of this
 18  subnode:
 19  - if it contains "jedec,spi-nor", then SPI is used;
 20  - if it contains "cfi-flash", then HyperFlash is used.
 21
 22allOf:
 23  - $ref: /schemas/spi/spi-controller.yaml#
 24
 25properties:
 26  compatible:
 27    oneOf:
 28      - items:
 29          - enum:
 30              - renesas,r8a774a1-rpc-if       # RZ/G2M
 31              - renesas,r8a774b1-rpc-if       # RZ/G2N
 32              - renesas,r8a774c0-rpc-if       # RZ/G2E
 33              - renesas,r8a774e1-rpc-if       # RZ/G2H
 34              - renesas,r8a7795-rpc-if        # R-Car H3
 35              - renesas,r8a7796-rpc-if        # R-Car M3-W
 36              - renesas,r8a77961-rpc-if       # R-Car M3-W+
 37              - renesas,r8a77965-rpc-if       # R-Car M3-N
 38              - renesas,r8a77970-rpc-if       # R-Car V3M
 39              - renesas,r8a77980-rpc-if       # R-Car V3H
 40              - renesas,r8a77990-rpc-if       # R-Car E3
 41              - renesas,r8a77995-rpc-if       # R-Car D3
 42              - renesas,r8a779a0-rpc-if       # R-Car V3U
 43          - const: renesas,rcar-gen3-rpc-if   # a generic R-Car gen3 or RZ/G2{E,H,M,N} device
 44
 45      - items:
 46          - enum:
 47              - renesas,r8a779g0-rpc-if       # R-Car V4H
 48              - renesas,r8a779h0-rpc-if       # R-Car V4M
 49          - const: renesas,rcar-gen4-rpc-if   # a generic R-Car gen4 device
 50
 51      - items:
 52          - enum:
 53              - renesas,r9a07g043-rpc-if      # RZ/G2UL
 54              - renesas,r9a07g044-rpc-if      # RZ/G2{L,LC}
 55              - renesas,r9a07g054-rpc-if      # RZ/V2L
 56          - const: renesas,rzg2l-rpc-if
 57
 58  reg:
 59    items:
 60      - description: RPC-IF registers
 61      - description: direct mapping read mode area
 62      - description: write buffer area
 63
 64  reg-names:
 65    items:
 66      - const: regs
 67      - const: dirmap
 68      - const: wbuf
 69
 70  clocks:
 71    minItems: 1
 72    maxItems: 2
 73
 74  interrupts:
 75    maxItems: 1
 76
 77  power-domains:
 78    maxItems: 1
 79
 80  resets:
 81    maxItems: 1
 82
 83patternProperties:
 84  "flash@[0-9a-f]+$":
 85    type: object
 86    additionalProperties: true
 87
 88    properties:
 89      compatible:
 90        contains:
 91          enum:
 92            - cfi-flash
 93            - jedec,spi-nor
 94
 95required:
 96  - compatible
 97  - reg
 98  - reg-names
 99  - clocks
100  - power-domains
101  - resets
102  - '#address-cells'
103  - '#size-cells'
104
105if:
106  properties:
107    compatible:
108      contains:
109        enum:
110          - renesas,rzg2l-rpc-if
111then:
112  properties:
113    clocks:
114      items:
115        - description: SPI Multi IO Register access clock (SPI_CLK2)
116        - description: SPI Multi IO Main clock (SPI_CLK).
117
118else:
119  properties:
120    clocks:
121      maxItems: 1
122
123unevaluatedProperties: false
124
125examples:
126  - |
127    #include <dt-bindings/clock/renesas-cpg-mssr.h>
128    #include <dt-bindings/power/r8a77995-sysc.h>
129
130    spi@ee200000 {
131      compatible = "renesas,r8a77995-rpc-if", "renesas,rcar-gen3-rpc-if";
132      reg = <0xee200000 0x200>,
133            <0x08000000 0x4000000>,
134            <0xee208000 0x100>;
135      reg-names = "regs", "dirmap", "wbuf";
136      clocks = <&cpg CPG_MOD 917>;
137      power-domains = <&sysc R8A77995_PD_ALWAYS_ON>;
138      resets = <&cpg 917>;
139      #address-cells = <1>;
140      #size-cells = <0>;
141
142      flash@0 {
143        compatible = "jedec,spi-nor";
144        reg = <0>;
145        spi-max-frequency = <40000000>;
146        spi-tx-bus-width = <1>;
147        spi-rx-bus-width = <1>;
148      };
149    };