xref: /linux/Documentation/devicetree/bindings/sound/spacemit,k1-i2s.yaml (revision 2aa680df68062e4e0c356ec2aa7100c13654907b) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/sound/spacemit,k1-i2s.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: K1 I2S controller
8
9description:
10  The I2S bus (Inter-IC sound bus) is a serial link for digital
11  audio data transfer between devices in the system.
12
13maintainers:
14  - Troy Mitchell <troy.mitchell@linux.spacemit.com>
15
16allOf:
17  - $ref: dai-common.yaml#
18
19properties:
20  compatible:
21    const: spacemit,k1-i2s
22
23  reg:
24    maxItems: 1
25
26  clocks:
27    items:
28      - description: clock for I2S sysclk
29      - description: clock for I2S bclk
30      - description: clock for I2S bus
31      - description: clock for I2S controller
32
33  clock-names:
34    items:
35      - const: sysclk
36      - const: bclk
37      - const: bus
38      - const: func
39
40  dmas:
41    minItems: 1
42    maxItems: 2
43
44  dma-names:
45    minItems: 1
46    items:
47      - const: tx
48      - const: rx
49
50  resets:
51    maxItems: 1
52
53  port:
54    $ref: audio-graph-port.yaml#
55    unevaluatedProperties: false
56
57  "#sound-dai-cells":
58    const: 0
59
60required:
61  - compatible
62  - reg
63  - clocks
64  - clock-names
65  - dmas
66  - dma-names
67  - resets
68  - "#sound-dai-cells"
69
70unevaluatedProperties: false
71
72examples:
73  - |
74    #include <dt-bindings/clock/spacemit,k1-syscon.h>
75    i2s@d4026000 {
76      compatible = "spacemit,k1-i2s";
77      reg = <0xd4026000 0x30>;
78      clocks = <&syscon_mpmu CLK_I2S_SYSCLK>,
79               <&syscon_mpmu CLK_I2S_BCLK>,
80               <&syscon_apbc CLK_SSPA0_BUS>,
81               <&syscon_apbc CLK_SSPA0>;
82      clock-names = "sysclk", "bclk", "bus", "func";
83      dmas = <&pdma0 21>, <&pdma0 22>;
84      dma-names = "tx", "rx";
85      resets = <&syscon_apbc RESET_SSPA0>;
86      #sound-dai-cells = <0>;
87    };
88