Linux 6.7-rc7
[linux-modified.git] / Documentation / devicetree / bindings / sound / ingenic,aic.yaml
1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/sound/ingenic,aic.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Ingenic SoCs AC97 / I2S Controller (AIC)
8
9 maintainers:
10   - Paul Cercueil <paul@crapouillou.net>
11
12 allOf:
13   - $ref: dai-common.yaml#
14
15 properties:
16   $nodename:
17     pattern: '^audio-controller@'
18
19   compatible:
20     oneOf:
21       - enum:
22           - ingenic,jz4740-i2s
23           - ingenic,jz4760-i2s
24           - ingenic,jz4770-i2s
25           - ingenic,jz4780-i2s
26           - ingenic,x1000-i2s
27       - items:
28           - const: ingenic,jz4725b-i2s
29           - const: ingenic,jz4740-i2s
30
31   '#sound-dai-cells':
32     const: 0
33
34   reg:
35     maxItems: 1
36
37   interrupts:
38     maxItems: 1
39
40   clocks:
41     items:
42       - description: AIC clock
43       - description: I2S clock
44
45   clock-names:
46     items:
47       - const: aic
48       - const: i2s
49
50   dmas:
51     items:
52       - description: DMA controller phandle and request line for I2S RX
53       - description: DMA controller phandle and request line for I2S TX
54
55   dma-names:
56     items:
57       - const: rx
58       - const: tx
59
60 unevaluatedProperties: false
61
62 required:
63   - compatible
64   - reg
65   - interrupts
66   - clocks
67   - clock-names
68   - dmas
69   - dma-names
70   - '#sound-dai-cells'
71
72 examples:
73   - |
74     #include <dt-bindings/clock/ingenic,jz4740-cgu.h>
75     aic: audio-controller@10020000 {
76       compatible = "ingenic,jz4740-i2s";
77       reg = <0x10020000 0x38>;
78
79       #sound-dai-cells = <0>;
80
81       interrupt-parent = <&intc>;
82       interrupts = <18>;
83
84       clocks = <&cgu JZ4740_CLK_AIC>,
85                <&cgu JZ4740_CLK_I2S>;
86       clock-names = "aic", "i2s";
87
88       dmas = <&dmac 25 0xffffffff>, <&dmac 24 0xffffffff>;
89       dma-names = "rx", "tx";
90     };