456 lines
12 KiB
YAML
456 lines
12 KiB
YAML
|
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
||
|
%YAML 1.2
|
||
|
---
|
||
|
$id: http://devicetree.org/schemas/sound/renesas,rsnd.yaml#
|
||
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||
|
|
||
|
title: Renesas R-Car Sound Driver Device Tree Bindings
|
||
|
|
||
|
maintainers:
|
||
|
- Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
|
||
|
|
||
|
properties:
|
||
|
|
||
|
compatible:
|
||
|
oneOf:
|
||
|
# for Gen1 SoC
|
||
|
- items:
|
||
|
- enum:
|
||
|
- renesas,rcar_sound-r8a7778 # R-Car M1A
|
||
|
- renesas,rcar_sound-r8a7779 # R-Car H1
|
||
|
- enum:
|
||
|
- renesas,rcar_sound-gen1
|
||
|
# for Gen2 SoC
|
||
|
- items:
|
||
|
- enum:
|
||
|
- renesas,rcar_sound-r8a7742 # RZ/G1H
|
||
|
- renesas,rcar_sound-r8a7743 # RZ/G1M
|
||
|
- renesas,rcar_sound-r8a7744 # RZ/G1N
|
||
|
- renesas,rcar_sound-r8a7745 # RZ/G1E
|
||
|
- renesas,rcar_sound-r8a77470 # RZ/G1C
|
||
|
- renesas,rcar_sound-r8a7790 # R-Car H2
|
||
|
- renesas,rcar_sound-r8a7791 # R-Car M2-W
|
||
|
- renesas,rcar_sound-r8a7793 # R-Car M2-N
|
||
|
- renesas,rcar_sound-r8a7794 # R-Car E2
|
||
|
- enum:
|
||
|
- renesas,rcar_sound-gen2
|
||
|
# for Gen3 SoC
|
||
|
- items:
|
||
|
- enum:
|
||
|
- renesas,rcar_sound-r8a774a1 # RZ/G2M
|
||
|
- renesas,rcar_sound-r8a774b1 # RZ/G2N
|
||
|
- renesas,rcar_sound-r8a774c0 # RZ/G2E
|
||
|
- renesas,rcar_sound-r8a774e1 # RZ/G2H
|
||
|
- renesas,rcar_sound-r8a7795 # R-Car H3
|
||
|
- renesas,rcar_sound-r8a7796 # R-Car M3-W
|
||
|
- renesas,rcar_sound-r8a77961 # R-Car M3-W+
|
||
|
- renesas,rcar_sound-r8a77965 # R-Car M3-N
|
||
|
- renesas,rcar_sound-r8a77990 # R-Car E3
|
||
|
- renesas,rcar_sound-r8a77995 # R-Car D3
|
||
|
- enum:
|
||
|
- renesas,rcar_sound-gen3
|
||
|
# for Generic
|
||
|
- items:
|
||
|
- enum:
|
||
|
- renesas,rcar_sound-gen1
|
||
|
- renesas,rcar_sound-gen2
|
||
|
- renesas,rcar_sound-gen3
|
||
|
|
||
|
reg:
|
||
|
minItems: 1
|
||
|
maxItems: 5
|
||
|
|
||
|
reg-names:
|
||
|
minItems: 1
|
||
|
maxItems: 5
|
||
|
|
||
|
"#sound-dai-cells":
|
||
|
description: |
|
||
|
it must be 0 if your system is using single DAI
|
||
|
it must be 1 if your system is using multi DAIs
|
||
|
enum: [0, 1]
|
||
|
|
||
|
"#clock-cells":
|
||
|
description: |
|
||
|
it must be 0 if your system has audio_clkout
|
||
|
it must be 1 if your system has audio_clkout0/1/2/3
|
||
|
enum: [0, 1]
|
||
|
|
||
|
clock-frequency:
|
||
|
description: for audio_clkout0/1/2/3
|
||
|
|
||
|
clkout-lr-asynchronous:
|
||
|
description: audio_clkoutn is asynchronizes with lr-clock.
|
||
|
$ref: /schemas/types.yaml#/definitions/flag
|
||
|
|
||
|
power-domains: true
|
||
|
|
||
|
resets:
|
||
|
minItems: 1
|
||
|
maxItems: 11
|
||
|
|
||
|
reset-names:
|
||
|
minItems: 1
|
||
|
maxItems: 11
|
||
|
|
||
|
clocks:
|
||
|
description: References to SSI/SRC/MIX/CTU/DVC/AUDIO_CLK clocks.
|
||
|
minItems: 1
|
||
|
maxItems: 31
|
||
|
|
||
|
clock-names:
|
||
|
description: List of necessary clock names.
|
||
|
minItems: 1
|
||
|
maxItems: 31
|
||
|
items:
|
||
|
oneOf:
|
||
|
- const: ssi-all
|
||
|
- pattern: '^ssi\.[0-9]$'
|
||
|
- pattern: '^src\.[0-9]$'
|
||
|
- pattern: '^mix\.[0-1]$'
|
||
|
- pattern: '^ctu\.[0-1]$'
|
||
|
- pattern: '^dvc\.[0-1]$'
|
||
|
- pattern: '^clk_(a|b|c|i)$'
|
||
|
|
||
|
ports:
|
||
|
$ref: /schemas/graph.yaml#/properties/ports
|
||
|
patternProperties:
|
||
|
port(@[0-9a-f]+)?:
|
||
|
$ref: audio-graph-port.yaml#
|
||
|
unevaluatedProperties: false
|
||
|
|
||
|
port:
|
||
|
$ref: audio-graph-port.yaml#
|
||
|
unevaluatedProperties: false
|
||
|
|
||
|
# use patternProperties to avoid naming "xxx,yyy" issue
|
||
|
patternProperties:
|
||
|
"^rcar_sound,dvc$":
|
||
|
description: DVC subnode.
|
||
|
type: object
|
||
|
patternProperties:
|
||
|
"^dvc-[0-1]$":
|
||
|
type: object
|
||
|
properties:
|
||
|
dmas:
|
||
|
maxItems: 1
|
||
|
dma-names:
|
||
|
const: "tx"
|
||
|
required:
|
||
|
- dmas
|
||
|
- dma-names
|
||
|
additionalProperties: false
|
||
|
|
||
|
"^rcar_sound,mix$":
|
||
|
description: MIX subnode.
|
||
|
type: object
|
||
|
patternProperties:
|
||
|
"^mix-[0-1]$":
|
||
|
type: object
|
||
|
# no properties
|
||
|
additionalProperties: false
|
||
|
|
||
|
"^rcar_sound,ctu$":
|
||
|
description: CTU subnode.
|
||
|
type: object
|
||
|
patternProperties:
|
||
|
"^ctu-[0-7]$":
|
||
|
type: object
|
||
|
# no properties
|
||
|
additionalProperties: false
|
||
|
|
||
|
"^rcar_sound,src$":
|
||
|
description: SRC subnode.
|
||
|
type: object
|
||
|
patternProperties:
|
||
|
"^src-[0-9]$":
|
||
|
type: object
|
||
|
properties:
|
||
|
interrupts:
|
||
|
maxItems: 1
|
||
|
dmas:
|
||
|
maxItems: 2
|
||
|
dma-names:
|
||
|
allOf:
|
||
|
- items:
|
||
|
enum:
|
||
|
- tx
|
||
|
- rx
|
||
|
required:
|
||
|
- interrupts
|
||
|
- dmas
|
||
|
- dma-names
|
||
|
additionalProperties: false
|
||
|
|
||
|
"^rcar_sound,ssiu$":
|
||
|
description: SSIU subnode.
|
||
|
type: object
|
||
|
patternProperties:
|
||
|
"^ssiu-[0-9]+$":
|
||
|
type: object
|
||
|
properties:
|
||
|
dmas:
|
||
|
maxItems: 2
|
||
|
dma-names:
|
||
|
allOf:
|
||
|
- items:
|
||
|
enum:
|
||
|
- tx
|
||
|
- rx
|
||
|
required:
|
||
|
- dmas
|
||
|
- dma-names
|
||
|
additionalProperties: false
|
||
|
|
||
|
"^rcar_sound,ssi$":
|
||
|
description: SSI subnode.
|
||
|
type: object
|
||
|
patternProperties:
|
||
|
"^ssi-[0-9]$":
|
||
|
type: object
|
||
|
properties:
|
||
|
interrupts:
|
||
|
maxItems: 1
|
||
|
dmas:
|
||
|
minItems: 2
|
||
|
maxItems: 4
|
||
|
dma-names:
|
||
|
allOf:
|
||
|
- items:
|
||
|
enum:
|
||
|
- tx
|
||
|
- rx
|
||
|
- txu # if no ssiu node
|
||
|
- rxu # if no ssiu node
|
||
|
|
||
|
shared-pin:
|
||
|
description: shared clock pin
|
||
|
$ref: /schemas/types.yaml#/definitions/flag
|
||
|
pio-transfer:
|
||
|
description: PIO transfer mode
|
||
|
$ref: /schemas/types.yaml#/definitions/flag
|
||
|
no-busif:
|
||
|
description: BUSIF is not used when [mem -> SSI] via DMA case
|
||
|
$ref: /schemas/types.yaml#/definitions/flag
|
||
|
required:
|
||
|
- interrupts
|
||
|
- dmas
|
||
|
- dma-names
|
||
|
additionalProperties: false
|
||
|
|
||
|
# For DAI base
|
||
|
"^rcar_sound,dai$":
|
||
|
description: DAI subnode.
|
||
|
type: object
|
||
|
patternProperties:
|
||
|
"^dai([0-9]+)?$":
|
||
|
type: object
|
||
|
properties:
|
||
|
playback:
|
||
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
||
|
capture:
|
||
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
||
|
anyOf:
|
||
|
- required:
|
||
|
- playback
|
||
|
- required:
|
||
|
- capture
|
||
|
additionalProperties: false
|
||
|
|
||
|
required:
|
||
|
- compatible
|
||
|
- reg
|
||
|
- reg-names
|
||
|
- clocks
|
||
|
- clock-names
|
||
|
- "#sound-dai-cells"
|
||
|
|
||
|
allOf:
|
||
|
- if:
|
||
|
properties:
|
||
|
compatible:
|
||
|
contains:
|
||
|
const: renesas,rcar_sound-gen1
|
||
|
then:
|
||
|
properties:
|
||
|
reg:
|
||
|
maxItems: 3
|
||
|
reg-names:
|
||
|
maxItems: 3
|
||
|
items:
|
||
|
enum:
|
||
|
- scu
|
||
|
- ssi
|
||
|
- adg
|
||
|
else:
|
||
|
properties:
|
||
|
reg:
|
||
|
maxItems: 5
|
||
|
reg-names:
|
||
|
maxItems: 5
|
||
|
items:
|
||
|
enum:
|
||
|
- scu
|
||
|
- adg
|
||
|
- ssiu
|
||
|
- ssi
|
||
|
- audmapp
|
||
|
|
||
|
additionalProperties: false
|
||
|
|
||
|
examples:
|
||
|
- |
|
||
|
rcar_sound: sound@ec500000 {
|
||
|
#sound-dai-cells = <1>;
|
||
|
compatible = "renesas,rcar_sound-r8a7790", "renesas,rcar_sound-gen2";
|
||
|
reg = <0xec500000 0x1000>, /* SCU */
|
||
|
<0xec5a0000 0x100>, /* ADG */
|
||
|
<0xec540000 0x1000>, /* SSIU */
|
||
|
<0xec541000 0x1280>, /* SSI */
|
||
|
<0xec740000 0x200>; /* Audio DMAC peri peri*/
|
||
|
reg-names = "scu", "adg", "ssiu", "ssi", "audmapp";
|
||
|
|
||
|
clocks = <&mstp10_clks 1005>, /* SSI-ALL */
|
||
|
<&mstp10_clks 1006>, <&mstp10_clks 1007>, /* SSI9, SSI8 */
|
||
|
<&mstp10_clks 1008>, <&mstp10_clks 1009>, /* SSI7, SSI6 */
|
||
|
<&mstp10_clks 1010>, <&mstp10_clks 1011>, /* SSI5, SSI4 */
|
||
|
<&mstp10_clks 1012>, <&mstp10_clks 1013>, /* SSI3, SSI2 */
|
||
|
<&mstp10_clks 1014>, <&mstp10_clks 1015>, /* SSI1, SSI0 */
|
||
|
<&mstp10_clks 1022>, <&mstp10_clks 1023>, /* SRC9, SRC8 */
|
||
|
<&mstp10_clks 1024>, <&mstp10_clks 1025>, /* SRC7, SRC6 */
|
||
|
<&mstp10_clks 1026>, <&mstp10_clks 1027>, /* SRC5, SRC4 */
|
||
|
<&mstp10_clks 1028>, <&mstp10_clks 1029>, /* SRC3, SRC2 */
|
||
|
<&mstp10_clks 1030>, <&mstp10_clks 1031>, /* SRC1, SRC0 */
|
||
|
<&mstp10_clks 1020>, <&mstp10_clks 1021>, /* MIX1, MIX0 */
|
||
|
<&mstp10_clks 1020>, <&mstp10_clks 1021>, /* CTU1, CTU0 */
|
||
|
<&mstp10_clks 1019>, <&mstp10_clks 1018>, /* DVC0, DVC1 */
|
||
|
<&audio_clk_a>, <&audio_clk_b>, /* CLKA, CLKB */
|
||
|
<&audio_clk_c>, <&audio_clk_i>; /* CLKC, CLKI */
|
||
|
|
||
|
clock-names = "ssi-all",
|
||
|
"ssi.9", "ssi.8",
|
||
|
"ssi.7", "ssi.6",
|
||
|
"ssi.5", "ssi.4",
|
||
|
"ssi.3", "ssi.2",
|
||
|
"ssi.1", "ssi.0",
|
||
|
"src.9", "src.8",
|
||
|
"src.7", "src.6",
|
||
|
"src.5", "src.4",
|
||
|
"src.3", "src.2",
|
||
|
"src.1", "src.0",
|
||
|
"mix.1", "mix.0",
|
||
|
"ctu.1", "ctu.0",
|
||
|
"dvc.0", "dvc.1",
|
||
|
"clk_a", "clk_b",
|
||
|
"clk_c", "clk_i";
|
||
|
|
||
|
rcar_sound,dvc {
|
||
|
dvc0: dvc-0 {
|
||
|
dmas = <&audma0 0xbc>;
|
||
|
dma-names = "tx";
|
||
|
};
|
||
|
dvc1: dvc-1 {
|
||
|
dmas = <&audma0 0xbe>;
|
||
|
dma-names = "tx";
|
||
|
};
|
||
|
};
|
||
|
|
||
|
rcar_sound,mix {
|
||
|
mix0: mix-0 { };
|
||
|
mix1: mix-1 { };
|
||
|
};
|
||
|
|
||
|
rcar_sound,ctu {
|
||
|
ctu00: ctu-0 { };
|
||
|
ctu01: ctu-1 { };
|
||
|
ctu02: ctu-2 { };
|
||
|
ctu03: ctu-3 { };
|
||
|
ctu10: ctu-4 { };
|
||
|
ctu11: ctu-5 { };
|
||
|
ctu12: ctu-6 { };
|
||
|
ctu13: ctu-7 { };
|
||
|
};
|
||
|
|
||
|
rcar_sound,src {
|
||
|
src0: src-0 {
|
||
|
status = "disabled";
|
||
|
};
|
||
|
src1: src-1 {
|
||
|
interrupts = <0 353 0>;
|
||
|
dmas = <&audma0 0x87>, <&audma1 0x9c>;
|
||
|
dma-names = "rx", "tx";
|
||
|
};
|
||
|
/* skip after src-2 */
|
||
|
};
|
||
|
|
||
|
rcar_sound,ssiu {
|
||
|
ssiu00: ssiu-0 {
|
||
|
dmas = <&audma0 0x15>, <&audma1 0x16>;
|
||
|
dma-names = "rx", "tx";
|
||
|
};
|
||
|
ssiu01: ssiu-1 {
|
||
|
dmas = <&audma0 0x35>, <&audma1 0x36>;
|
||
|
dma-names = "rx", "tx";
|
||
|
};
|
||
|
/* skip after ssiu-2 */
|
||
|
};
|
||
|
|
||
|
rcar_sound,ssi {
|
||
|
ssi0: ssi-0 {
|
||
|
interrupts = <0 370 1>;
|
||
|
dmas = <&audma0 0x01>, <&audma1 0x02>;
|
||
|
dma-names = "rx", "tx";
|
||
|
};
|
||
|
ssi1: ssi-1 {
|
||
|
interrupts = <0 371 1>;
|
||
|
dmas = <&audma0 0x03>, <&audma1 0x04>;
|
||
|
dma-names = "rx", "tx";
|
||
|
};
|
||
|
/* skip other ssi-2 */
|
||
|
};
|
||
|
|
||
|
/* DAI base */
|
||
|
rcar_sound,dai {
|
||
|
dai0 {
|
||
|
playback = <&ssi5>, <&src5>;
|
||
|
capture = <&ssi6>;
|
||
|
};
|
||
|
dai1 {
|
||
|
playback = <&ssi3>;
|
||
|
};
|
||
|
dai2 {
|
||
|
capture = <&ssi4>;
|
||
|
};
|
||
|
dai3 {
|
||
|
playback = <&ssi7>;
|
||
|
};
|
||
|
dai4 {
|
||
|
capture = <&ssi8>;
|
||
|
};
|
||
|
};
|
||
|
|
||
|
/* assume audio-graph */
|
||
|
port {
|
||
|
rsnd_endpoint: endpoint {
|
||
|
remote-endpoint = <&codec_endpoint>;
|
||
|
|
||
|
dai-format = "left_j";
|
||
|
bitclock-master = <&rsnd_endpoint0>;
|
||
|
frame-master = <&rsnd_endpoint0>;
|
||
|
|
||
|
playback = <&ssi0>, <&src0>, <&dvc0>;
|
||
|
capture = <&ssi1>, <&src1>, <&dvc1>;
|
||
|
};
|
||
|
};
|
||
|
};
|
||
|
|
||
|
|
||
|
/* assume audio-graph */
|
||
|
codec {
|
||
|
port {
|
||
|
codec_endpoint: endpoint {
|
||
|
remote-endpoint = <&rsnd_endpoint>;
|
||
|
};
|
||
|
};
|
||
|
};
|