xref: /openbmc/linux/Documentation/devicetree/bindings/sound/allwinner,sun4i-a10-spdif.yaml (revision ed32f8d42cee118b075e4372a55c7739a11094b2) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/sound/allwinner,sun4i-a10-spdif.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Allwinner A10 S/PDIF Controller Device Tree Bindings
8
9maintainers:
10  - Chen-Yu Tsai <wens@csie.org>
11  - Liam Girdwood <lgirdwood@gmail.com>
12  - Mark Brown <broonie@kernel.org>
13  - Maxime Ripard <maxime.ripard@bootlin.com>
14
15properties:
16  "#sound-dai-cells":
17    const: 0
18
19  compatible:
20    oneOf:
21      - const: allwinner,sun4i-a10-spdif
22      - const: allwinner,sun6i-a31-spdif
23      - const: allwinner,sun8i-h3-spdif
24      - const: allwinner,sun50i-h6-spdif
25      - items:
26          - const: allwinner,sun8i-a83t-spdif
27          - const: allwinner,sun8i-h3-spdif
28      - items:
29          - const: allwinner,sun50i-a64-spdif
30          - const: allwinner,sun8i-h3-spdif
31
32  reg:
33    maxItems: 1
34
35  interrupts:
36    maxItems: 1
37
38  clocks:
39    items:
40      - description: Bus Clock
41      - description: Module Clock
42
43  clock-names:
44    items:
45      - const: apb
46      - const: spdif
47
48  # Even though it only applies to subschemas under the conditionals,
49  # not listing them here will trigger a warning because of the
50  # additionalsProperties set to false.
51  dmas: true
52  dma-names: true
53  resets:
54    maxItems: 1
55
56allOf:
57  - if:
58      properties:
59        compatible:
60          contains:
61            enum:
62              - allwinner,sun6i-a31-spdif
63              - allwinner,sun8i-h3-spdif
64
65    then:
66      required:
67        - resets
68
69  - if:
70      properties:
71        compatible:
72          contains:
73            const: allwinner,sun8i-h3-spdif
74
75    then:
76      properties:
77        dmas:
78          description: TX DMA Channel
79
80        dma-names:
81          const: tx
82
83    else:
84      properties:
85        dmas:
86          items:
87            - description: RX DMA Channel
88            - description: TX DMA Channel
89
90        dma-names:
91          items:
92            - const: rx
93            - const: tx
94
95required:
96  - "#sound-dai-cells"
97  - compatible
98  - reg
99  - interrupts
100  - clocks
101  - clock-names
102  - dmas
103  - dma-names
104
105additionalProperties: false
106
107examples:
108  - |
109    spdif: spdif@1c21000 {
110        #sound-dai-cells = <0>;
111        compatible = "allwinner,sun4i-a10-spdif";
112        reg = <0x01c21000 0x40>;
113        interrupts = <13>;
114        clocks = <&apb0_gates 1>, <&spdif_clk>;
115        clock-names = "apb", "spdif";
116        dmas = <&dma 0 2>, <&dma 0 2>;
117        dma-names = "rx", "tx";
118    };
119
120...
121