Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
ASoC: dt-bindings: xlnx,i2s: Convert to json-schema
Convert the Xilinx I2S device tree binding documentation to json-schema.
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Signed-off-by: Vincenzo Frascino <vincenzo.frascino@arm.com>
Link: https://patch.msgid.link/20250226122325.2014547-2-vincenzo.frascino@arm.com
Signed-off-by: Mark Brown <broonie@kernel.org>
authored by
Vincenzo Frascino
and committed by
Mark Brown
a206376b
dc64e1b9
+65
-28
-28
Documentation/devicetree/bindings/sound/xlnx,i2s.txt
-28
Documentation/devicetree/bindings/sound/xlnx,i2s.txt
···
1
-
Device-Tree bindings for Xilinx I2S PL block
2
-
3
-
The IP supports I2S based playback/capture audio
4
-
5
-
Required property:
6
-
- compatible: "xlnx,i2s-transmitter-1.0" for playback and
7
-
"xlnx,i2s-receiver-1.0" for capture
8
-
9
-
Required property common to both I2S playback and capture:
10
-
- reg: Base address and size of the IP core instance.
11
-
- xlnx,dwidth: sample data width. Can be any of 16, 24.
12
-
- xlnx,num-channels: Number of I2S streams. Can be any of 1, 2, 3, 4.
13
-
supported channels = 2 * xlnx,num-channels
14
-
15
-
Example:
16
-
17
-
i2s_receiver@a0080000 {
18
-
compatible = "xlnx,i2s-receiver-1.0";
19
-
reg = <0x0 0xa0080000 0x0 0x10000>;
20
-
xlnx,dwidth = <0x18>;
21
-
xlnx,num-channels = <1>;
22
-
};
23
-
i2s_transmitter@a0090000 {
24
-
compatible = "xlnx,i2s-transmitter-1.0";
25
-
reg = <0x0 0xa0090000 0x0 0x10000>;
26
-
xlnx,dwidth = <0x18>;
27
-
xlnx,num-channels = <1>;
28
-
};
+65
Documentation/devicetree/bindings/sound/xlnx,i2s.yaml
+65
Documentation/devicetree/bindings/sound/xlnx,i2s.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/xlnx,i2s.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Xilinx I2S PL block
8
+
9
+
description:
10
+
The IP supports I2S based playback/capture audio.
11
+
12
+
maintainers:
13
+
- Vincenzo Frascino <vincenzo.frascino@arm.com>
14
+
15
+
allOf:
16
+
- $ref: dai-common.yaml#
17
+
18
+
properties:
19
+
compatible:
20
+
enum:
21
+
- xlnx,i2s-receiver-1.0
22
+
- xlnx,i2s-transmitter-1.0
23
+
24
+
reg:
25
+
maxItems: 1
26
+
27
+
xlnx,dwidth:
28
+
$ref: /schemas/types.yaml#/definitions/uint32
29
+
enum:
30
+
- 16
31
+
- 24
32
+
description: |
33
+
Sample data width.
34
+
35
+
xlnx,num-channels:
36
+
$ref: /schemas/types.yaml#/definitions/uint32
37
+
minimum: 1
38
+
maximum: 4
39
+
description: |
40
+
Number of I2S streams.
41
+
42
+
required:
43
+
- compatible
44
+
- reg
45
+
- xlnx,dwidth
46
+
- xlnx,num-channels
47
+
48
+
additionalProperties: false
49
+
50
+
examples:
51
+
- |
52
+
i2s@a0080000 {
53
+
compatible = "xlnx,i2s-receiver-1.0";
54
+
reg = <0xa0080000 0x10000>;
55
+
xlnx,dwidth = <0x18>;
56
+
xlnx,num-channels = <1>;
57
+
};
58
+
i2s@a0090000 {
59
+
compatible = "xlnx,i2s-transmitter-1.0";
60
+
reg = <0xa0090000 0x10000>;
61
+
xlnx,dwidth = <0x18>;
62
+
xlnx,num-channels = <1>;
63
+
};
64
+
65
+
...