xref: /freebsd-src/sys/contrib/device-tree/Bindings/display/bridge/tda998x.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotDevice-Tree bindings for the NXP TDA998x HDMI transmitter
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotRequired properties;
4*c66ec88fSEmmanuel Vadot  - compatible: must be "nxp,tda998x"
5*c66ec88fSEmmanuel Vadot
6*c66ec88fSEmmanuel Vadot  - reg: I2C address
7*c66ec88fSEmmanuel Vadot
8*c66ec88fSEmmanuel VadotRequired node:
9*c66ec88fSEmmanuel Vadot  - port: Input port node with endpoint definition, as described
10*c66ec88fSEmmanuel Vadot        in Documentation/devicetree/bindings/graph.txt
11*c66ec88fSEmmanuel Vadot
12*c66ec88fSEmmanuel VadotOptional properties:
13*c66ec88fSEmmanuel Vadot  - interrupts: interrupt number and trigger type
14*c66ec88fSEmmanuel Vadot	default: polling
15*c66ec88fSEmmanuel Vadot
16*c66ec88fSEmmanuel Vadot  - pinctrl-0: pin control group to be used for
17*c66ec88fSEmmanuel Vadot	screen plug/unplug interrupt.
18*c66ec88fSEmmanuel Vadot
19*c66ec88fSEmmanuel Vadot  - pinctrl-names: must contain a "default" entry.
20*c66ec88fSEmmanuel Vadot
21*c66ec88fSEmmanuel Vadot  - video-ports: 24 bits value which defines how the video controller
22*c66ec88fSEmmanuel Vadot	output is wired to the TDA998x input - default: <0x230145>
23*c66ec88fSEmmanuel Vadot
24*c66ec88fSEmmanuel Vadot  - audio-ports: array of 8-bit values, 2 values per one DAI[1].
25*c66ec88fSEmmanuel Vadot	The first value defines the DAI type: TDA998x_SPDIF or TDA998x_I2S[2].
26*c66ec88fSEmmanuel Vadot	The second value defines the tda998x AP_ENA reg content when the DAI
27*c66ec88fSEmmanuel Vadot	in question is used. The implementation allows one or two DAIs. If two
28*c66ec88fSEmmanuel Vadot	DAIs are defined, they must be of different type.
29*c66ec88fSEmmanuel Vadot
30*c66ec88fSEmmanuel Vadot  - nxp,calib-gpios: calibration GPIO, which must correspond with the
31*c66ec88fSEmmanuel Vadot	gpio used for the TDA998x interrupt pin.
32*c66ec88fSEmmanuel Vadot
33*c66ec88fSEmmanuel Vadot[1] Documentation/sound/soc/dai.rst
34*c66ec88fSEmmanuel Vadot[2] include/dt-bindings/display/tda998x.h
35*c66ec88fSEmmanuel Vadot
36*c66ec88fSEmmanuel VadotExample:
37*c66ec88fSEmmanuel Vadot
38*c66ec88fSEmmanuel Vadot#include <dt-bindings/display/tda998x.h>
39*c66ec88fSEmmanuel Vadot
40*c66ec88fSEmmanuel Vadot	tda998x: hdmi-encoder {
41*c66ec88fSEmmanuel Vadot		compatible = "nxp,tda998x";
42*c66ec88fSEmmanuel Vadot		reg = <0x70>;
43*c66ec88fSEmmanuel Vadot		interrupt-parent = <&gpio0>;
44*c66ec88fSEmmanuel Vadot		interrupts = <27 2>;		/* falling edge */
45*c66ec88fSEmmanuel Vadot		pinctrl-0 = <&pmx_camera>;
46*c66ec88fSEmmanuel Vadot		pinctrl-names = "default";
47*c66ec88fSEmmanuel Vadot		video-ports = <0x230145>;
48*c66ec88fSEmmanuel Vadot
49*c66ec88fSEmmanuel Vadot		#sound-dai-cells = <2>;
50*c66ec88fSEmmanuel Vadot			     /*	DAI-format	AP_ENA reg value */
51*c66ec88fSEmmanuel Vadot		audio-ports = <	TDA998x_SPDIF	0x04
52*c66ec88fSEmmanuel Vadot				TDA998x_I2S	0x03>;
53*c66ec88fSEmmanuel Vadot
54*c66ec88fSEmmanuel Vadot	};
55