Documentation/devicetree/bindings/media/i2c/tda1997x.txt - linux-mtk - Git at Google

 Device-Tree bindings for the NXP TDA1997x HDMI receiver

 The TDA19971/73 are HDMI video receivers.

 The TDA19971 Video port output pins can be used as follows:
  - RGB 8bit per color (24 bits total): R[11:4] B[11:4] G[11:4]
  - YUV444 8bit per color (24 bits total): Y[11:4] Cr[11:4] Cb[11:4]
  - YUV422 semi-planar 8bit per component (16 bits total): Y[11:4] CbCr[11:4]
  - YUV422 semi-planar 10bit per component (20 bits total): Y[11:2] CbCr[11:2]
  - YUV422 semi-planar 12bit per component (24 bits total): - Y[11:0] CbCr[11:0]
  - YUV422 BT656 8bit per component (8 bits total): YCbCr[11:4] (2-cycles)
  - YUV422 BT656 10bit per component (10 bits total): YCbCr[11:2] (2-cycles)
  - YUV422 BT656 12bit per component (12 bits total): YCbCr[11:0] (2-cycles)

 The TDA19973 Video port output pins can be used as follows:
  - RGB 12bit per color (36 bits total): R[11:0] B[11:0] G[11:0]
  - YUV444 12bit per color (36 bits total): Y[11:0] Cb[11:0] Cr[11:0]
  - YUV422 semi-planar 12bit per component (24 bits total): Y[11:0] CbCr[11:0]
  - YUV422 BT656 12bit per component (12 bits total): YCbCr[11:0] (2-cycles)

 The Video port output pins are mapped via 4-bit 'pin groups' allowing
 for a variety of connection possibilities including swapping pin order within
 pin groups. The video_portcfg device-tree property consists of register mapping
 pairs which map a chip-specific VP output register to a 4-bit pin group. If
 the pin group needs to be bit-swapped you can use the *_S pin-group defines.

 Required Properties:
  - compatible          :
   - "nxp,tda19971" for the TDA19971
   - "nxp,tda19973" for the TDA19973
  - reg                 : I2C slave address
  - interrupts          : The interrupt number
  - DOVDD-supply        : Digital I/O supply
  - DVDD-supply         : Digital Core supply
  - AVDD-supply         : Analog supply
  - nxp,vidout-portcfg  : array of pairs mapping VP output pins to pin groups.

 Optional Properties:
  - nxp,audout-format   : DAI bus format: "i2s" or "spdif".
  - nxp,audout-width    : width of audio output data bus (1-4).
  - nxp,audout-layout   : data layout (0=AP0 used, 1=AP0/AP1/AP2/AP3 used).
  - nxp,audout-mclk-fs  : Multiplication factor between stream rate and codec
                          mclk.

 The port node shall contain one endpoint child node for its digital
 output video port, in accordance with the video interface bindings defined in
 Documentation/devicetree/bindings/media/video-interfaces.txt.

 Optional Endpoint Properties:
   The following three properties are defined in video-interfaces.txt and
   are valid for the output parallel bus endpoint:
   - hsync-active: Horizontal synchronization polarity. Defaults to active high.
   - vsync-active: Vertical synchronization polarity. Defaults to active high.
   - data-active: Data polarity. Defaults to active high.

 Examples:
  - VP[15:0] connected to IMX6 CSI_DATA[19:4] for 16bit YUV422
    16bit I2S layout0 with a 128*fs clock (A_WS, AP0, A_CLK pins)
 	hdmi-receiver@48 {
 		compatible = "nxp,tda19971";
 		pinctrl-names = "default";
 		pinctrl-0 = <&pinctrl_tda1997x>;
 		reg = <0x48>;
 		interrupt-parent = <&gpio1>;
 		interrupts = <7 IRQ_TYPE_LEVEL_LOW>;
 		DOVDD-supply = <&reg_3p3v>;
 		AVDD-supply = <&reg_1p8v>;
 		DVDD-supply = <&reg_1p8v>;
 		/* audio */
 		#sound-dai-cells = <0>;
 		nxp,audout-format = "i2s";
 		nxp,audout-layout = <0>;
 		nxp,audout-width = <16>;
 		nxp,audout-mclk-fs = <128>;
 		/*
 		 * The 8bpp YUV422 semi-planar mode outputs CbCr[11:4]
 		 * and Y[11:4] across 16bits in the same pixclk cycle.
 		 */
 		nxp,vidout-portcfg =
 			/* Y[11:8]<->VP[15:12]<->CSI_DATA[19:16] */
 			< TDA1997X_VP24_V15_12 TDA1997X_G_Y_11_8 >,
 			/* Y[7:4]<->VP[11:08]<->CSI_DATA[15:12] */
 			< TDA1997X_VP24_V11_08 TDA1997X_G_Y_7_4 >,
 			/* CbCc[11:8]<->VP[07:04]<->CSI_DATA[11:8] */
 			< TDA1997X_VP24_V07_04 TDA1997X_R_CR_CBCR_11_8 >,
 			/* CbCr[7:4]<->VP[03:00]<->CSI_DATA[7:4] */
 			< TDA1997X_VP24_V03_00 TDA1997X_R_CR_CBCR_7_4 >;

 		port {
 			tda1997x_to_ipu1_csi0_mux: endpoint {
 				remote-endpoint = <&ipu1_csi0_mux_from_parallel_sensor>;
 				bus-width = <16>;
 				hsync-active = <1>;
 				vsync-active = <1>;
 				data-active = <1>;
 			};
 		};
 	};
  - VP[15:8] connected to IMX6 CSI_DATA[19:12] for 8bit BT656
    16bit I2S layout0 with a 128*fs clock (A_WS, AP0, A_CLK pins)
 	hdmi-receiver@48 {
 		compatible = "nxp,tda19971";
 		pinctrl-names = "default";
 		pinctrl-0 = <&pinctrl_tda1997x>;
 		reg = <0x48>;
 		interrupt-parent = <&gpio1>;
 		interrupts = <7 IRQ_TYPE_LEVEL_LOW>;
 		DOVDD-supply = <&reg_3p3v>;
 		AVDD-supply = <&reg_1p8v>;
 		DVDD-supply = <&reg_1p8v>;
 		/* audio */
 		#sound-dai-cells = <0>;
 		nxp,audout-format = "i2s";
 		nxp,audout-layout = <0>;
 		nxp,audout-width = <16>;
 		nxp,audout-mclk-fs = <128>;
 		/*
 		 * The 8bpp YUV422 semi-planar mode outputs CbCr[11:4]
 		 * and Y[11:4] across 16bits in the same pixclk cycle.
 		 */
 		nxp,vidout-portcfg =
 			/* Y[11:8]<->VP[15:12]<->CSI_DATA[19:16] */
 			< TDA1997X_VP24_V15_12 TDA1997X_G_Y_11_8 >,
 			/* Y[7:4]<->VP[11:08]<->CSI_DATA[15:12] */
 			< TDA1997X_VP24_V11_08 TDA1997X_G_Y_7_4 >,
 			/* CbCc[11:8]<->VP[07:04]<->CSI_DATA[11:8] */
 			< TDA1997X_VP24_V07_04 TDA1997X_R_CR_CBCR_11_8 >,
 			/* CbCr[7:4]<->VP[03:00]<->CSI_DATA[7:4] */
 			< TDA1997X_VP24_V03_00 TDA1997X_R_CR_CBCR_7_4 >;

 		port {
 			tda1997x_to_ipu1_csi0_mux: endpoint {
 				remote-endpoint = <&ipu1_csi0_mux_from_parallel_sensor>;
 				bus-width = <16>;
 				hsync-active = <1>;
 				vsync-active = <1>;
 				data-active = <1>;
 			};
 		};
 	};
  - VP[15:8] connected to IMX6 CSI_DATA[19:12] for 8bit BT656
    16bit I2S layout0 with a 128*fs clock (A_WS, AP0, A_CLK pins)
 	hdmi-receiver@48 {
 		compatible = "nxp,tda19971";
 		pinctrl-names = "default";
 		pinctrl-0 = <&pinctrl_tda1997x>;
 		reg = <0x48>;
 		interrupt-parent = <&gpio1>;
 		interrupts = <7 IRQ_TYPE_LEVEL_LOW>;
 		DOVDD-supply = <&reg_3p3v>;
 		AVDD-supply = <&reg_1p8v>;
 		DVDD-supply = <&reg_1p8v>;
 		/* audio */
 		#sound-dai-cells = <0>;
 		nxp,audout-format = "i2s";
 		nxp,audout-layout = <0>;
 		nxp,audout-width = <16>;
 		nxp,audout-mclk-fs = <128>;
 		/*
 		 * The 8bpp BT656 mode outputs YCbCr[11:4] across 8bits over
 		 * 2 pixclk cycles.
 		 */
 		nxp,vidout-portcfg =
 			/* YCbCr[11:8]<->VP[15:12]<->CSI_DATA[19:16] */
 			< TDA1997X_VP24_V15_12 TDA1997X_R_CR_CBCR_11_8 >,
 			/* YCbCr[7:4]<->VP[11:08]<->CSI_DATA[15:12] */
 			< TDA1997X_VP24_V11_08 TDA1997X_R_CR_CBCR_7_4 >,

 		port {
 			tda1997x_to_ipu1_csi0_mux: endpoint {
 				remote-endpoint = <&ipu1_csi0_mux_from_parallel_sensor>;
 				bus-width = <16>;
 				hsync-active = <1>;
 				vsync-active = <1>;
 				data-active = <1>;
 			};
 		};
 	};
	Device-Tree bindings for the NXP TDA1997x HDMI receiver

	The TDA19971/73 are HDMI video receivers.

	The TDA19971 Video port output pins can be used as follows:
	- RGB 8bit per color (24 bits total): R[11:4] B[11:4] G[11:4]
	- YUV444 8bit per color (24 bits total): Y[11:4] Cr[11:4] Cb[11:4]
	- YUV422 semi-planar 8bit per component (16 bits total): Y[11:4] CbCr[11:4]
	- YUV422 semi-planar 10bit per component (20 bits total): Y[11:2] CbCr[11:2]
	- YUV422 semi-planar 12bit per component (24 bits total): - Y[11:0] CbCr[11:0]
	- YUV422 BT656 8bit per component (8 bits total): YCbCr[11:4] (2-cycles)
	- YUV422 BT656 10bit per component (10 bits total): YCbCr[11:2] (2-cycles)
	- YUV422 BT656 12bit per component (12 bits total): YCbCr[11:0] (2-cycles)

	The TDA19973 Video port output pins can be used as follows:
	- RGB 12bit per color (36 bits total): R[11:0] B[11:0] G[11:0]
	- YUV444 12bit per color (36 bits total): Y[11:0] Cb[11:0] Cr[11:0]
	- YUV422 semi-planar 12bit per component (24 bits total): Y[11:0] CbCr[11:0]
	- YUV422 BT656 12bit per component (12 bits total): YCbCr[11:0] (2-cycles)

	The Video port output pins are mapped via 4-bit 'pin groups' allowing
	for a variety of connection possibilities including swapping pin order within
	pin groups. The video_portcfg device-tree property consists of register mapping
	pairs which map a chip-specific VP output register to a 4-bit pin group. If
	the pin group needs to be bit-swapped you can use the *_S pin-group defines.

	Required Properties:
	- compatible :
	- "nxp,tda19971" for the TDA19971
	- "nxp,tda19973" for the TDA19973
	- reg : I2C slave address
	- interrupts : The interrupt number
	- DOVDD-supply : Digital I/O supply
	- DVDD-supply : Digital Core supply
	- AVDD-supply : Analog supply
	- nxp,vidout-portcfg : array of pairs mapping VP output pins to pin groups.

	Optional Properties:
	- nxp,audout-format : DAI bus format: "i2s" or "spdif".
	- nxp,audout-width : width of audio output data bus (1-4).
	- nxp,audout-layout : data layout (0=AP0 used, 1=AP0/AP1/AP2/AP3 used).
	- nxp,audout-mclk-fs : Multiplication factor between stream rate and codec
	mclk.

	The port node shall contain one endpoint child node for its digital
	output video port, in accordance with the video interface bindings defined in
	Documentation/devicetree/bindings/media/video-interfaces.txt.

	Optional Endpoint Properties:
	The following three properties are defined in video-interfaces.txt and
	are valid for the output parallel bus endpoint:
	- hsync-active: Horizontal synchronization polarity. Defaults to active high.
	- vsync-active: Vertical synchronization polarity. Defaults to active high.
	- data-active: Data polarity. Defaults to active high.

	Examples:
	- VP[15:0] connected to IMX6 CSI_DATA[19:4] for 16bit YUV422
	16bit I2S layout0 with a 128*fs clock (A_WS, AP0, A_CLK pins)
	hdmi-receiver@48 {
	compatible = "nxp,tda19971";
	pinctrl-names = "default";
	pinctrl-0 = <&pinctrl_tda1997x>;
	reg = <0x48>;
	interrupt-parent = <&gpio1>;
	interrupts = <7 IRQ_TYPE_LEVEL_LOW>;
	DOVDD-supply = <&reg_3p3v>;
	AVDD-supply = <&reg_1p8v>;
	DVDD-supply = <&reg_1p8v>;
	/* audio */
	#sound-dai-cells = <0>;
	nxp,audout-format = "i2s";
	nxp,audout-layout = <0>;
	nxp,audout-width = <16>;
	nxp,audout-mclk-fs = <128>;
	/*
	* The 8bpp YUV422 semi-planar mode outputs CbCr[11:4]
	* and Y[11:4] across 16bits in the same pixclk cycle.
	*/
	nxp,vidout-portcfg =
	/* Y[11:8]<->VP[15:12]<->CSI_DATA[19:16] */
	< TDA1997X_VP24_V15_12 TDA1997X_G_Y_11_8 >,
	/* Y[7:4]<->VP[11:08]<->CSI_DATA[15:12] */
	< TDA1997X_VP24_V11_08 TDA1997X_G_Y_7_4 >,
	/* CbCc[11:8]<->VP[07:04]<->CSI_DATA[11:8] */
	< TDA1997X_VP24_V07_04 TDA1997X_R_CR_CBCR_11_8 >,
	/* CbCr[7:4]<->VP[03:00]<->CSI_DATA[7:4] */
	< TDA1997X_VP24_V03_00 TDA1997X_R_CR_CBCR_7_4 >;

	port {
	tda1997x_to_ipu1_csi0_mux: endpoint {
	remote-endpoint = <&ipu1_csi0_mux_from_parallel_sensor>;
	bus-width = <16>;
	hsync-active = <1>;
	vsync-active = <1>;
	data-active = <1>;
	};
	};
	};
	- VP[15:8] connected to IMX6 CSI_DATA[19:12] for 8bit BT656
	16bit I2S layout0 with a 128*fs clock (A_WS, AP0, A_CLK pins)
	hdmi-receiver@48 {
	compatible = "nxp,tda19971";
	pinctrl-names = "default";
	pinctrl-0 = <&pinctrl_tda1997x>;
	reg = <0x48>;
	interrupt-parent = <&gpio1>;
	interrupts = <7 IRQ_TYPE_LEVEL_LOW>;
	DOVDD-supply = <&reg_3p3v>;
	AVDD-supply = <&reg_1p8v>;
	DVDD-supply = <&reg_1p8v>;
	/* audio */
	#sound-dai-cells = <0>;
	nxp,audout-format = "i2s";
	nxp,audout-layout = <0>;
	nxp,audout-width = <16>;
	nxp,audout-mclk-fs = <128>;
	/*
	* The 8bpp YUV422 semi-planar mode outputs CbCr[11:4]
	* and Y[11:4] across 16bits in the same pixclk cycle.
	*/
	nxp,vidout-portcfg =
	/* Y[11:8]<->VP[15:12]<->CSI_DATA[19:16] */
	< TDA1997X_VP24_V15_12 TDA1997X_G_Y_11_8 >,
	/* Y[7:4]<->VP[11:08]<->CSI_DATA[15:12] */
	< TDA1997X_VP24_V11_08 TDA1997X_G_Y_7_4 >,
	/* CbCc[11:8]<->VP[07:04]<->CSI_DATA[11:8] */
	< TDA1997X_VP24_V07_04 TDA1997X_R_CR_CBCR_11_8 >,
	/* CbCr[7:4]<->VP[03:00]<->CSI_DATA[7:4] */
	< TDA1997X_VP24_V03_00 TDA1997X_R_CR_CBCR_7_4 >;

	port {
	tda1997x_to_ipu1_csi0_mux: endpoint {
	remote-endpoint = <&ipu1_csi0_mux_from_parallel_sensor>;
	bus-width = <16>;
	hsync-active = <1>;
	vsync-active = <1>;
	data-active = <1>;
	};
	};
	};
	- VP[15:8] connected to IMX6 CSI_DATA[19:12] for 8bit BT656
	16bit I2S layout0 with a 128*fs clock (A_WS, AP0, A_CLK pins)
	hdmi-receiver@48 {
	compatible = "nxp,tda19971";
	pinctrl-names = "default";
	pinctrl-0 = <&pinctrl_tda1997x>;
	reg = <0x48>;
	interrupt-parent = <&gpio1>;
	interrupts = <7 IRQ_TYPE_LEVEL_LOW>;
	DOVDD-supply = <&reg_3p3v>;
	AVDD-supply = <&reg_1p8v>;
	DVDD-supply = <&reg_1p8v>;
	/* audio */
	#sound-dai-cells = <0>;
	nxp,audout-format = "i2s";
	nxp,audout-layout = <0>;
	nxp,audout-width = <16>;
	nxp,audout-mclk-fs = <128>;
	/*
	* The 8bpp BT656 mode outputs YCbCr[11:4] across 8bits over
	* 2 pixclk cycles.
	*/
	nxp,vidout-portcfg =
	/* YCbCr[11:8]<->VP[15:12]<->CSI_DATA[19:16] */
	< TDA1997X_VP24_V15_12 TDA1997X_R_CR_CBCR_11_8 >,
	/* YCbCr[7:4]<->VP[11:08]<->CSI_DATA[15:12] */
	< TDA1997X_VP24_V11_08 TDA1997X_R_CR_CBCR_7_4 >,

	port {
	tda1997x_to_ipu1_csi0_mux: endpoint {
	remote-endpoint = <&ipu1_csi0_mux_from_parallel_sensor>;
	bus-width = <16>;
	hsync-active = <1>;
	vsync-active = <1>;
	data-active = <1>;
	};
	};
	};