270 lines · yaml
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause2%YAML 1.23---4$id: http://devicetree.org/schemas/media/renesas,drif.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: Renesas R-Car Gen3 Digital Radio Interface Controller (DRIF)8 9maintainers:10 - Ramesh Shanmugasundaram <rashanmu@gmail.com>11 - Fabrizio Castro <fabrizio.castro.jz@renesas.com>12 13description: |14 R-Car Gen3 DRIF is a SPI like receive only slave device. A general15 representation of DRIF interfacing with a master device is shown below.16 17 +---------------------+ +---------------------+18 | |-----SCK------->|CLK |19 | Master |-----SS-------->|SYNC DRIFn (slave) |20 | |-----SD0------->|D0 |21 | |-----SD1------->|D1 |22 +---------------------+ +---------------------+23 24 As per datasheet, each DRIF channel (drifn) is made up of two internal25 channels (drifn0 & drifn1). These two internal channels share the common26 CLK & SYNC. Each internal channel has its own dedicated resources like27 irq, dma channels, address space & clock. This internal split is not28 visible to the external master device.29 30 The device tree model represents each internal channel as a separate node.31 The internal channels sharing the CLK & SYNC are tied together by their32 phandles using a property called "renesas,bonding". For the rest of33 the documentation, unless explicitly stated, the word channel implies an34 internal channel.35 36 When both internal channels are enabled they need to be managed together37 as one (i.e.) they cannot operate alone as independent devices. Out of the38 two, one of them needs to act as a primary device that accepts common39 properties of both the internal channels. This channel is identified by a40 property called "renesas,primary-bond".41 42 To summarize,43 * When both the internal channels that are bonded together are enabled,44 the zeroth channel is selected as primary-bond. This channels accepts45 properties common to all the members of the bond.46 * When only one of the bonded channels need to be enabled, the property47 "renesas,bonding" or "renesas,primary-bond" will have no effect. That48 enabled channel can act alone as any other independent device.49 50properties:51 compatible:52 items:53 - enum:54 - renesas,r8a7795-drif # R-Car H355 - renesas,r8a7796-drif # R-Car M3-W56 - renesas,r8a77965-drif # R-Car M3-N57 - renesas,r8a77990-drif # R-Car E358 - const: renesas,rcar-gen3-drif # Generic R-Car Gen3 compatible device59 60 reg:61 maxItems: 162 63 interrupts:64 maxItems: 165 66 clocks:67 maxItems: 168 69 clock-names:70 const: fck71 72 resets:73 maxItems: 174 75 dmas:76 minItems: 177 maxItems: 278 79 dma-names:80 minItems: 181 items:82 - const: rx83 - const: rx84 85 renesas,bonding:86 $ref: /schemas/types.yaml#/definitions/phandle87 description:88 The phandle to the other internal channel of DRIF89 90 power-domains:91 maxItems: 192 93 renesas,primary-bond:94 type: boolean95 description:96 Indicates that the channel acts as primary among the bonded channels.97 98 port:99 $ref: /schemas/graph.yaml#/$defs/port-base100 unevaluatedProperties: false101 description:102 Child port node corresponding to the data input. The port node must103 contain at least one endpoint.104 105 properties:106 endpoint:107 $ref: /schemas/graph.yaml#/$defs/endpoint-base108 unevaluatedProperties: false109 110 properties:111 sync-active:112 $ref: /schemas/types.yaml#/definitions/uint32113 enum: [0, 1]114 description:115 Indicates sync signal polarity, 0/1 for low/high respectively.116 This property maps to SYNCAC bit in the hardware manual. The117 default is 1 (active high).118 119required:120 - compatible121 - reg122 - interrupts123 - clocks124 - clock-names125 - resets126 - dmas127 - dma-names128 - renesas,bonding129 - power-domains130 131allOf:132 - if:133 required:134 - renesas,primary-bond135 then:136 required:137 - pinctrl-0138 - pinctrl-names139 - port140 141 - if:142 required:143 - port144 then:145 required:146 - pinctrl-0147 - pinctrl-names148 else:149 properties:150 pinctrl-0: false151 pinctrl-names: false152 153additionalProperties: false154 155examples:156 # Example with both internal channels enabled.157 #158 # When interfacing with a third party tuner device with two data pins as shown159 # below.160 #161 # +---------------------+ +---------------------+162 # | |-----SCK------->|CLK |163 # | Master |-----SS-------->|SYNC DRIFn (slave) |164 # | |-----SD0------->|D0 |165 # | |-----SD1------->|D1 |166 # +---------------------+ +---------------------+167 - |168 #include <dt-bindings/clock/r8a7795-cpg-mssr.h>169 #include <dt-bindings/interrupt-controller/arm-gic.h>170 #include <dt-bindings/power/r8a7795-sysc.h>171 172 soc {173 #address-cells = <2>;174 #size-cells = <2>;175 176 drif00: rif@e6f40000 {177 compatible = "renesas,r8a7795-drif",178 "renesas,rcar-gen3-drif";179 reg = <0 0xe6f40000 0 0x64>;180 interrupts = <GIC_SPI 12 IRQ_TYPE_LEVEL_HIGH>;181 clocks = <&cpg CPG_MOD 515>;182 clock-names = "fck";183 dmas = <&dmac1 0x20>, <&dmac2 0x20>;184 dma-names = "rx", "rx";185 power-domains = <&sysc R8A7795_PD_ALWAYS_ON>;186 renesas,bonding = <&drif01>;187 resets = <&cpg 515>;188 renesas,primary-bond;189 pinctrl-0 = <&drif0_pins>;190 pinctrl-names = "default";191 port {192 drif0_ep: endpoint {193 remote-endpoint = <&tuner_ep>;194 };195 };196 };197 198 drif01: rif@e6f50000 {199 compatible = "renesas,r8a7795-drif",200 "renesas,rcar-gen3-drif";201 reg = <0 0xe6f50000 0 0x64>;202 interrupts = <GIC_SPI 13 IRQ_TYPE_LEVEL_HIGH>;203 clocks = <&cpg CPG_MOD 514>;204 clock-names = "fck";205 dmas = <&dmac1 0x22>, <&dmac2 0x22>;206 dma-names = "rx", "rx";207 power-domains = <&sysc R8A7795_PD_ALWAYS_ON>;208 renesas,bonding = <&drif00>;209 resets = <&cpg 514>;210 };211 };212 213 # Example with internal channel 1 alone enabled.214 #215 # When interfacing with a third party tuner device with one data pin as shown216 # below.217 #218 # +---------------------+ +---------------------+219 # | |-----SCK------->|CLK |220 # | Master |-----SS-------->|SYNC DRIFn (slave) |221 # | | |D0 (unused) |222 # | |-----SD-------->|D1 |223 # +---------------------+ +---------------------+224 - |225 #include <dt-bindings/clock/r8a7795-cpg-mssr.h>226 #include <dt-bindings/interrupt-controller/arm-gic.h>227 #include <dt-bindings/power/r8a7795-sysc.h>228 229 soc {230 #address-cells = <2>;231 #size-cells = <2>;232 233 drif10: rif@e6f60000 {234 compatible = "renesas,r8a7795-drif",235 "renesas,rcar-gen3-drif";236 reg = <0 0xe6f60000 0 0x64>;237 interrupts = <GIC_SPI 14 IRQ_TYPE_LEVEL_HIGH>;238 clocks = <&cpg CPG_MOD 513>;239 clock-names = "fck";240 dmas = <&dmac1 0x24>, <&dmac2 0x24>;241 dma-names = "rx", "rx";242 power-domains = <&sysc R8A7795_PD_ALWAYS_ON>;243 resets = <&cpg 513>;244 renesas,bonding = <&drif11>;245 };246 247 drif11: rif@e6f70000 {248 compatible = "renesas,r8a7795-drif",249 "renesas,rcar-gen3-drif";250 reg = <0 0xe6f70000 0 0x64>;251 interrupts = <GIC_SPI 15 IRQ_TYPE_LEVEL_HIGH>;252 clocks = <&cpg CPG_MOD 512>;253 clock-names = "fck";254 dmas = <&dmac1 0x26>, <&dmac2 0x26>;255 dma-names = "rx", "rx";256 power-domains = <&sysc R8A7795_PD_ALWAYS_ON>;257 resets = <&cpg 512>;258 renesas,bonding = <&drif10>;259 pinctrl-0 = <&drif1_pins>;260 pinctrl-names = "default";261 port {262 drif1_ep: endpoint {263 remote-endpoint = <&tuner_ep1>;264 sync-active = <0>;265 };266 };267 };268 };269...270