Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: display: bridge: nxp,tda998x: Convert to json-schema
Convert the NXP TDA998x HDMI transmitter Device Tree binding
documentation to json-schema.
Add missing "#sound-dai-cells" property.
Add ports hierarchy, as an alternative to port.
Drop pinctrl properties, as they do not belong here.
Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
Link: https://lore.kernel.org/r/1224e757ec958f8b29ec66e783a7ee805c339d84.1663165552.git.geert+renesas@glider.be
Signed-off-by: Rob Herring <robh@kernel.org>
authored by
Geert Uytterhoeven
and committed by
Rob Herring
260a4ca8
a607a850
+109
-54
+109
Documentation/devicetree/bindings/display/bridge/nxp,tda998x.yaml
+109
Documentation/devicetree/bindings/display/bridge/nxp,tda998x.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/display/bridge/nxp,tda998x.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: NXP TDA998x HDMI transmitter
8
+
9
+
maintainers:
10
+
- Russell King <linux@armlinux.org.uk>
11
+
12
+
properties:
13
+
compatible:
14
+
const: nxp,tda998x
15
+
16
+
reg:
17
+
maxItems: 1
18
+
19
+
interrupts:
20
+
maxItems: 1
21
+
22
+
video-ports:
23
+
default: 0x230145
24
+
maximum: 0xffffff
25
+
description:
26
+
24 bits value which defines how the video controller output is wired to
27
+
the TDA998x input.
28
+
29
+
audio-ports:
30
+
description:
31
+
Array of 8-bit values, 2 values per DAI (Documentation/sound/soc/dai.rst).
32
+
The implementation allows one or two DAIs.
33
+
If two DAIs are defined, they must be of different type.
34
+
$ref: /schemas/types.yaml#/definitions/uint32-matrix
35
+
items:
36
+
minItems: 1
37
+
items:
38
+
- description: |
39
+
The first value defines the DAI type: TDA998x_SPDIF or TDA998x_I2S
40
+
(see include/dt-bindings/display/tda998x.h).
41
+
- description:
42
+
The second value defines the tda998x AP_ENA reg content when the
43
+
DAI in question is used.
44
+
45
+
'#sound-dai-cells':
46
+
enum: [ 0, 1 ]
47
+
48
+
nxp,calib-gpios:
49
+
maxItems: 1
50
+
description:
51
+
Calibration GPIO, which must correspond with the gpio used for the
52
+
TDA998x interrupt pin.
53
+
54
+
port:
55
+
$ref: /schemas/graph.yaml#/properties/port
56
+
description: Parallel input port
57
+
58
+
ports:
59
+
$ref: /schemas/graph.yaml#/properties/ports
60
+
61
+
properties:
62
+
port@0:
63
+
type: object
64
+
description: Parallel input port
65
+
66
+
port@1:
67
+
type: object
68
+
description: HDMI output port
69
+
70
+
required:
71
+
- compatible
72
+
- reg
73
+
74
+
oneOf:
75
+
- required:
76
+
- port
77
+
- required:
78
+
- ports
79
+
80
+
additionalProperties: false
81
+
82
+
examples:
83
+
- |
84
+
#include <dt-bindings/display/tda998x.h>
85
+
#include <dt-bindings/interrupt-controller/irq.h>
86
+
87
+
i2c {
88
+
#address-cells = <1>;
89
+
#size-cells = <0>;
90
+
91
+
tda998x: hdmi-encoder@70 {
92
+
compatible = "nxp,tda998x";
93
+
reg = <0x70>;
94
+
interrupt-parent = <&gpio0>;
95
+
interrupts = <27 IRQ_TYPE_EDGE_FALLING>;
96
+
video-ports = <0x230145>;
97
+
98
+
#sound-dai-cells = <1>;
99
+
/* DAI-format / AP_ENA reg value */
100
+
audio-ports = <TDA998x_SPDIF 0x04>,
101
+
<TDA998x_I2S 0x03>;
102
+
103
+
port {
104
+
tda998x_in: endpoint {
105
+
remote-endpoint = <&lcdc_0>;
106
+
};
107
+
};
108
+
};
109
+
};
-54
Documentation/devicetree/bindings/display/bridge/tda998x.txt
-54
Documentation/devicetree/bindings/display/bridge/tda998x.txt
···
1
-
Device-Tree bindings for the NXP TDA998x HDMI transmitter
2
-
3
-
Required properties;
4
-
- compatible: must be "nxp,tda998x"
5
-
6
-
- reg: I2C address
7
-
8
-
Required node:
9
-
- port: Input port node with endpoint definition, as described
10
-
in Documentation/devicetree/bindings/graph.txt
11
-
12
-
Optional properties:
13
-
- interrupts: interrupt number and trigger type
14
-
default: polling
15
-
16
-
- pinctrl-0: pin control group to be used for
17
-
screen plug/unplug interrupt.
18
-
19
-
- pinctrl-names: must contain a "default" entry.
20
-
21
-
- video-ports: 24 bits value which defines how the video controller
22
-
output is wired to the TDA998x input - default: <0x230145>
23
-
24
-
- audio-ports: array of 8-bit values, 2 values per one DAI[1].
25
-
The first value defines the DAI type: TDA998x_SPDIF or TDA998x_I2S[2].
26
-
The second value defines the tda998x AP_ENA reg content when the DAI
27
-
in question is used. The implementation allows one or two DAIs. If two
28
-
DAIs are defined, they must be of different type.
29
-
30
-
- nxp,calib-gpios: calibration GPIO, which must correspond with the
31
-
gpio used for the TDA998x interrupt pin.
32
-
33
-
[1] Documentation/sound/soc/dai.rst
34
-
[2] include/dt-bindings/display/tda998x.h
35
-
36
-
Example:
37
-
38
-
#include <dt-bindings/display/tda998x.h>
39
-
40
-
tda998x: hdmi-encoder {
41
-
compatible = "nxp,tda998x";
42
-
reg = <0x70>;
43
-
interrupt-parent = <&gpio0>;
44
-
interrupts = <27 2>; /* falling edge */
45
-
pinctrl-0 = <&pmx_camera>;
46
-
pinctrl-names = "default";
47
-
video-ports = <0x230145>;
48
-
49
-
#sound-dai-cells = <2>;
50
-
/* DAI-format AP_ENA reg value */
51
-
audio-ports = < TDA998x_SPDIF 0x04
52
-
TDA998x_I2S 0x03>;
53
-
54
-
};