xref: /linux/Documentation/devicetree/bindings/sound/renesas,fsi.yaml (revision 4b3c1f1b15f576445c221cbc77a88540433a2ba7) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/sound/renesas,fsi.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Renesas FIFO-buffered Serial Interface (FSI)
8
9maintainers:
10  - Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
11
12properties:
13  $nodename:
14    pattern: "^sound@.*"
15
16  compatible:
17    oneOf:
18      # for FSI2 SoC
19      - items:
20          - enum:
21              - renesas,fsi2-sh73a0  # SH-Mobile AG5
22              - renesas,fsi2-r8a7740 # R-Mobile A1
23          - enum:
24              - renesas,sh_fsi2
25      # for Generic
26      - items:
27          - enum:
28              - renesas,sh_fsi
29              - renesas,sh_fsi2
30
31  reg:
32    maxItems: 1
33
34  interrupts:
35    maxItems: 1
36
37  clocks:
38    maxItems: 1
39
40  power-domains:
41    maxItems: 1
42
43  '#sound-dai-cells':
44    const: 1
45
46  fsia,spdif-connection:
47    $ref: /schemas/types.yaml#/definitions/flag
48    description: FSI is connected by S/PDIF
49
50  fsia,stream-mode-support:
51    $ref: /schemas/types.yaml#/definitions/flag
52    description: FSI supports 16bit stream mode
53
54  fsia,use-internal-clock:
55    $ref: /schemas/types.yaml#/definitions/flag
56    description: FSI uses internal clock when master mode
57
58  fsib,spdif-connection:
59    $ref: /schemas/types.yaml#/definitions/flag
60    description: same as fsia
61
62  fsib,stream-mode-support:
63    $ref: /schemas/types.yaml#/definitions/flag
64    description: same as fsia
65
66  fsib,use-internal-clock:
67    $ref: /schemas/types.yaml#/definitions/flag
68    description: same as fsia
69
70required:
71  - compatible
72  - reg
73  - interrupts
74  - clocks
75  - power-domains
76  - '#sound-dai-cells'
77
78additionalProperties: false
79
80examples:
81  - |
82    #include <dt-bindings/clock/r8a7740-clock.h>
83    #include <dt-bindings/interrupt-controller/arm-gic.h>
84    sh_fsi2: sound@fe1f0000 {
85            compatible = "renesas,fsi2-r8a7740", "renesas,sh_fsi2";
86            reg = <0xfe1f0000 0x400>;
87            interrupts = <GIC_SPI 9 0x4>;
88            clocks = <&mstp3_clks R8A7740_CLK_FSI>;
89            power-domains = <&pd_a4mp>;
90
91            #sound-dai-cells = <1>;
92            fsia,spdif-connection;
93            fsia,stream-mode-support;
94            fsia,use-internal-clock;
95    };
96