4. Display 使用

_images/usage_display_rk3588_vop.png

RK3588 拥有四路 Video 输出端口,每一个 Video 输出端口都绑定了固定的显示控制器,如 Port0 可以用于与 DP0、DP1、HDMI/eDP0 和 HDMI/eDP1 等显示控制器的连接,其他 Portx 以此类推。

每一个 Portx 都有各自所能输出的最大分辨率:

  • Port0 最大可以输出 7680x4320@60Hz

  • Port1 最大可以输出 4096x2304@60Hz

  • Port2 最大可以输出 4096x2304@60Hz

  • Port3 最大可以输出 1920x1080@60Hz

软件上如果把 HDMI0 显示控制器连接在 Port0 上,且硬件 phy 支持 HDMI2.1,则 HDMI0 支持 8K@60Hz 的输出。

如果给每一个 Portx 都单独分配一个显示控制器的话,便可支持同一时间的四屏同显(异显)。

但从软件的角度上,有以下的配置注意事项:

  1. RK3588 在做 8K 输出的时候,其实芯片内部是同时使用了 Port0 以及 Port1 的资源,只是借用 Port0 口做输出,所以当与 Port0 连接的显示控制器连接外部的 8K 显示器做输出的时候,与 Port1 连接的显示控制器工作会有异常。

    例如 HDMI0(接Port0) 接 8K 输出的时候,HDMI1(接Port1) 显示会有异常。只有当 Port0 输出小于等于4K@60Hz 的时候,Port1 才可以正常输出 4K@60Hz。

  2. 目前一个 Portx 在同一时间只能输出一种分辨率格式,所以如果软件配置有多个不同分辨率的显示接口都接在同一个 Portx 上面的话,同一时间只能使用其中一个。例如 VGA 与 DP,目前同时只能使用其中一个(后面随着 SDK 的更新便可支持同一路 Portx 下同时接多个显示外设。)。

4.1. ITX-3588J 显示接口的配置

ITX-3588J 有四种显示输出接口,分别是 HDMI、Display Port、VGA 以及 MIPI DSI,可以做到多屏同显/异显,接口图如下所示:

  • HDMI0/ HDMI1/ Display Port/ VGA_images/usage_display_interface.jpg

  • MIPI DSI0/ MIPI DSI1 _images/usage_display_dsi_interface.jpg

下面对各个显示输出接口的配置和使用作基本的介绍,详细内容可以参考文件:

  • kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dts

  • kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j-mipi101-M101014-BE45-A1.dts

4.1.1. HDMI

ITX-3588J 硬件上有两个 HDMI 显示输出接口:

  • HDMI0 支持 HDMI2.1 协议,分辨率最高可以支持 7680x4320@60Hz

  • HDMI1 支持 HDMI2.0 协议,分辨率最高可以支持 4096x2304@60Hz

4.1.1.1. 软件配置

由于 HDMI0 以及 HDMI1 在软件配置是类似的,所以下面以 HDMI0 的配置为例,HDMI0 软件上表示为 hdmi0,在设备树中添加:

//打开 hdmi0 功能
&hdmi0 {
        enable-gpios = <&gpio4 RK_PA0 GPIO_ACTIVE_HIGH>;
        status = "okay";
};

// hdmi0 的显示接口连接在 Port0
&hdmi0_in_vp0 {
        status = "okay";
};

//打开 hdmi0 音频输出
&hdmi0_sound {
        status = "okay";
};

//打开 hdmi0  硬件 phy
&hdptxphy_hdmi0 {
        status = "okay";
};

//打开 hdmi0  开机 logo
&route_hdmi0{
        status = "okay";
};

需要注意的是,由于这里默认会把 HDMI0 连接在 Port0 上,即为了支持 8K 输出。如果这个时候 HDMI1 连接在了 Port1 端口,如:

&hdmi1_in_vp1 {
        status = "okay";
};

则会出现前文说的 HDMI1 显示异常的情况,所以如果要支持 HDMI0(8K)+ HDMI1(4K)场景,需要把 HDMI1 连接在 Port2 上,如:

diff --git a/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dtsi b/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dtsi
index afb176b9f8..099cccbf65 100644
--- a/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dtsi
+++ b/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dtsi
@@ -94,7 +94,7 @@ &hdmi1 {
 &hdmi1_sound {
        status = "okay";
 };
-&hdmi1_in_vp1 {
+&hdmi1_in_vp2 {
         status = "okay";
 };
 &hdptxphy_hdmi1 {

4.1.2. Display Port

ITX-3588J 有一个 Display Port 显示输出接口,支持 DP TX 1.4a 协议,分辨率最高可以支持 7680x4320@30Hz。

4.1.2.1. 软件配置

Display Port 软件上表示为 dp0,在设备树上添加:

// 打开 dp0 的音频输出功能
&spdif_tx2{
        status = "okay";
};

&dp0_sound{
        status = "okay";
};

//打开 dp0 功能
&dp0 {
        status = "okay";
};

//把 dp0 的显示接口连接在 port2
&dp0_in_vp2 {
        status = "okay";
};

//使能对应 Type-C 口的 PD 电源芯片
&usbc0{
        status = "okay";
        interrupt-parent = <&gpio0>;
        interrupts = <RK_PD3 IRQ_TYPE_LEVEL_LOW>;
};

&vbus5v0_typec_pwr_en{
        status = "okay";
        gpio = <&pca9555 PCA_IO1_4 GPIO_ACTIVE_HIGH>;  //PCA_IO 14
};

/* 注意:目前 dp0 暂不支持 开机 logo 的显示功能 */

这里要注意,SDK 默认的软件配置是把 dp0 连接在 vp2 上面,这样会导致 dp0 最高只能输出 4096x2304@60Hz,所以如果需要 7680x4320@30Hz 的功能,需要把 dp0 连接在 vp0上面,软件修改如下:

diff --git a/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dtsi b/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dtsi
index fc08eb7543..fee53ed2e9 100644
--- a/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dtsi
+++ b/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dtsi
@@ -301,7 +301,7 @@ &dp0 {
        status = "okay";
 };

-&dp0_in_vp2 {
+&dp0_in_vp0 {
        status = "okay";
 };

4.1.3. VGA

ITX-3588J 有一个 VGA 显示输出接口,是采用 DP 转 VGA 芯片实现的,受限于 VGA 协议,分辨率最高可以支持 1080p@60Hz。

4.1.3.1. 软件配置

由于是 DP 转 VGA,所以在软件配置上还是像 Display Port 那样配置,只是需要添加一个热插拔检测引脚,软件上表示为 dp1,在设备树上添加:

//把 dp1(VGA) 的显示接口连接在 port2
&dp1_in_vp2 {
        status = "okay";
};

// 打开 dp1(VGA) ,设置热插拔检测引脚
&dp1 {
        pinctrl-names = "default";
        pinctrl-0 = <&dp1_hpd>;
        hpd-gpios = <&gpio1 RK_PA4 GPIO_ACTIVE_HIGH>;
        status = "okay";
};

//打开 dp1(VGA)的 开机 logo
&route_dp1{
        status = "okay";
        connect = <&vp2_out_dp1>;
};

4.1.4. MIPI DSI

ITX-3588J 有两路 MIPI DSI 显示输出接口,均支持 DPHY2.0 和 4 Lane 的数据输出,最高可输出 4096x2304@60Hz(取决于连接的 Portx)。

4.1.4.1. 软件配置

由于 DSI0 和 DSI1 在软件配置上类似,这里以 DSI0 的配置为例,外接的屏幕是 Firefly V2 版本屏幕,DSI0 软件上表示为 dsi0

结合 ITX-3588J 的 DSI0 接口和屏幕时序

  • DSI0 接口 _images/usage_display_mipi_v2_interface.png

  • V2 屏幕显示时序 _images/usage_display_mipi_v2_timing.jpg

  • V2 屏幕上电时序 _images/usage_display_mipi_v2_power_on.png

  • V2 屏幕下电时序 _images/usage_display_mipi_v2_power_off.png

  • V2 屏幕上下电符号参考 _images/usage_display_mipi_v2_power_menu.png

在设备树上添加:

//设置屏幕的背光
backlight: backlight {
		...
        status = "okay";
        compatible = "pwm-backlight";
        enable-gpios = <&gpio2 RK_PC4 GPIO_ACTIVE_HIGH>;
        pwms = <&pwm12 0 50000 1>;

        ...
}
&pwm12 {
        pinctrl-0 = <&pwm12m1_pins>;
        status = "okay";
};

//设置 dsi0 的开机 logo
&route_dsi0 {
        status = "okay";
        connect = <&vp3_out_dsi0>;
};

//把 dsi0 连接在 Port3 上
&dsi0_in_vp3 {
        status = "okay";
};

//打开 DPHY
&mipi_dcphy0 {
        status = "okay";
};

//打开 dsi0(注意这一部分较重要,涉及到屏幕的上电时序)
&dsi0 {
	status = "okay";
	//rockchip,lane-rate = <1000>;
	dsi0_panel: panel@0 {
		status = "okay";
		compatible = "simple-panel-dsi";
		reg = <0>;

		//选择之前的配置的背光节点
		backlight = <&backlight>; 
		
		//设置 LCD 使能引脚
		enable-gpios = <&pca9555 PCA_IO0_2 GPIO_ACTIVE_HIGH>; 

		//设置 LCD 复位引脚
		reset-gpios = <&gpio2 RK_PB4 GPIO_ACTIVE_LOW>; 

		//设置 LCD 屏幕的上下电时序
		enable-delay-ms = <50>;
		prepare-delay-ms = <200>;
		reset-delay-ms = <50>;
		init-delay-ms = <55>;
		unprepare-delay-ms = <50>;
		disable-delay-ms = <20>;
		mipi-data-delay-ms = <200>;
		size,width = <120>;
		size,height = <170>;

		//设置 DSI(DPHY)的输出模式,一般默认为 Video 模式
		dsi,flags = <(MIPI_DSI_MODE_VIDEO | MIPI_DSI_MODE_VIDEO_BURST | MIPI_DSI_MODE_LPM | MIPI_DSI_MODE_EOT_PACKET)>;

		//设置 DSI 像素数据的输出格式,这部分的设置取决于接收端的屏幕是否支持该格式
		dsi,format = <MIPI_DSI_FMT_RGB888>;

		//设置使用的 lane 数量,默认为 4 lane
		dsi,lanes  = <4>;

		//设置 MIPI DSI 的上电指令
		panel-init-sequence = [
			//39 00 04 B9 83 10 2E
			// 15 00 02 CF FF
			05 78 01 11
			05 32 01 29
			//15 00 02 35 00
		];

		//设置 MIPI DSI 的下电指令 
		panel-exit-sequence = [
			05 00 01 28
			05 00 01 10
		];

		//设置 LCD 屏幕的显示时序(该部分内容一般都可以从对应屏幕的 datasheet 中获取,如上图所示)
		disp_timings0: display-timings {
			native-mode = <&dsi0_timing0>;
			dsi0_timing0: timing0 {

				/* 显示时序的换算公式一般为:
				(hactive + hsync-len + hback-porch + hfront-porch)   
							x
				( vactive + vsync-len + vback-porch + vfront-porch)x fps
				 = clock-frequency
				*/
				clock-frequency = <72600000>;//<80000000>;
				hactive = <800>;//<768>;
				vactive = <1280>;
				hsync-len = <14>;   //20, 50,10
				hback-porch = <26>; //50, 56,10
				hfront-porch = <32>;//50, 30,180
				vsync-len = <8>;//4
				vback-porch = <20>;//4
				vfront-porch = <80>;//8
				hsync-active = <0>;
				vsync-active = <0>;
				de-active = <0>;
				pixelclk-active = <0>;
			};
		};

		ports {
			#address-cells = <1>;
			#size-cells = <0>;

			port@0 {
				reg = <0>;
				panel_in_dsi: endpoint {
					remote-endpoint = <&dsi_out_panel>;
				};
			};
		};
	};

	ports {
		#address-cells = <1>;
		#size-cells = <0>;

		port@1 {
			reg = <1>;
			dsi_out_panel: endpoint {
			remote-endpoint = <&panel_in_dsi>;
			};
		};
	};
};

//使能屏幕的触摸功能
&i2c1{
	status = "okay";
	pinctrl-names = "default";
	pinctrl-0 = <&i2c1m2_xfer>;

	hxchipset@48{
		status = "okay";
		compatible = "himax,hxcommon";
		reg = <0x48>;
		//设置触摸功能的复位引脚
		himax,rst-gpio =  <&gpio3 RK_PC1 GPIO_ACTIVE_HIGH>;

		//设置触摸功能的中断引脚
		himax,irq-gpio = <&gpio3 RK_PC0 IRQ_TYPE_LEVEL_HIGH>;

		//himax,3v3-gpio = <&gpio0 RK_PB4 GPIO_ACTIVE_HIGH>;
		//himax,pon-gpio = <&gpio0 RK_PB4 GPIO_ACTIVE_HIGH>;
		pinctrl-names = "default";
        	pinctrl-0 = <&touch_int0>;
		//pinctrl-names = "default";
		//pinctrl-0 = <&lcd_tp_int>;

		himax,panel-coords = <0 800 0 1280>;      //触摸范围
		himax,display-coords = <0 800 0 1280>;    //分辨率
		report_type = <1>;
	};
};

在配置 MIPI DSI的时候,如果出现异常现象,如黑屏,画面拉伸,显示有噪点等,需要注意排查:

  1. 显示时序是否配置正确,尤其是 DCLK 的配置。

  2. 上下电时序是否正确,在文件 kernel-5.10/drivers/gpu/drm/panel/panel-simple.c中的 panel_simple_preparepanel_simple_unprepare 函数内,调用了设备树中所配置的上下电时序和 gpio 口。

    如果选择在 uboot 阶段开启开机 logo, 那么还需要排查 u-boot/drivers/video/drm/rockchip_panel.c 文件内的 panel_simple_preparepanel_simple_unprepare 函数。

  3. 搭示波器看一下上电时序是否正确,主要是确认 LCD 使能引脚、复位引脚和屏幕上电指令间的时序是否正确。

4.2. ITX-3588J 多屏场景的配置

下面列出一些常规的场景下,关于 Portx 以及 显示控制器之间的配置方法:

  • 四屏显示(接 DP 屏幕,HDMI0 + HDMI1 + Display Port + MIPI DSI0)

&hdmi0_in_vp0 {
        status = "okay";
};

&hdmi1_in_vp1 {
        status = "okay";
};

&dsi0_in_vp3 {
        status = "okay";
};

&dp0_in_vp2 {
        status = "okay";
};
  • 四屏显示(接 VGA 屏幕,HDMI0 + HDMI1 + VGA + MIPI DSI0)

&hdmi0_in_vp0 {
        status = "okay";
};

&hdmi1_in_vp1 {
        status = "okay";
};

&dsi0_in_vp3 {
        status = "okay";
};

&dp1_in_vp2 {
        status = "okay";
};

以上两种配置下,HDMI0 不能接入分辨率大于 4096x2304@60Hz 的屏幕。

  • 双 HDMI 支持 8K@60Hz + 4K@60Hz 输出

&hdmi0_in_vp0 {
        status = "okay";
};

&hdmi1_in_vp2 {
        status = "okay";
};

4.3. 调试手段

  • 在系统中设置分辨率

系统鼠标点击:‘设置->显示->HDMI->分辨率设置’

  • 获取 HDMI/Display Port 的 edid(以 HDMI 为例)

:/ # busybox hexdump /sys/class/drm/card0-HDMI-A-1/edid
0000000 ff00 ffff ffff 00ff 040d 0030 0001 0000
0000010 1e01 0301 8b80 784e 502a a31f 4959 2497
0000020 4fbb 2153 0008 8081 c081 0081 c0d1 7c61
0000030 fc81 0101 0101 7404 7c00 70f6 805a 58fc
0000040 008a 1072 0053 1e00 3a02 1880 3871 402d
0000050 2c58 0045 1072 0053 1e00 0000 fc00 4300
0000060 5348 5648 200a 2020 2020 2020 0000 fd00
0000070 1700 0f4c 1e50 0a00 2020 2020 2020 4a01
0000080 0302 f07c 015f 0302 0504 0706 1190 1312
0000090 1514 1f16 2220 5e5d 605f 6261 6564 c266
00000a0 c4c3 c7c6 0932 0717 0715 5750 0106 0467
00000b0 3d03 c007 7e5f e601 4611 00d0 8070 4783
00000c0 0000 036e 000c 0020 3cb8 0020 0180 0302
00000d0 6d04 5dd8 01c4 8078 2267 0000 67cf e51f
00000e0 000f 3000 e363 0506 e301 c305 e201 ff00
00000f0 01eb d046 4800 42af 38a2 d727 0000 a400
0000100
  • 获取 HDMI/Display Port 所支持的分辨率(以 HDMI 为例)

:/ # cat /sys/class/drm/card0-HDMI-A-1/modes
3840x2160
7680x4320
7680x4320
7680x4320
7680x4320
7680x4320
7680x4320
7680x4320
7680x4320
4096x2160
4096x2160
4096x2160
4096x2160
4096x2160
4096x2160
4096x2160
  • 获取 HDMI/Display Port 的连接状态(以 HDMI 为例)

:/ # cat /sys/class/drm/card0-HDMI-A-1/status
connected
  • 获取系统中正在使用的 Video Portx(与所连接的显示控制器) 信息

:/ # cat /d/dri/0/summary
Video Port0: ACTIVE
    Connector: HDMI-A-1
        bus_format[2026]: UYYVYY8_0_5X24
        overlay_mode[1] output_mode[e] color_space[3], eotf:0
    Display mode: 7680x4320p60
        clk[2376000] real_clk[2376000] type[40] flag[5]
        H: 7680 8232 8408 9000
        V: 4320 4336 4356 4400
    Cluster0-win0: ACTIVE
        win_id: 0
        format: AB24 little-endian (0x34324241)[AFBC] SDR[0] color_space[0] glb_alpha[0xff]
        rotate: xmirror: 0 ymirror: 0 rotate_90: 0 rotate_270: 0
        csc: y2r[0] r2y[1] csc mode[1]
        zpos: 0
        src: pos[0, 0] rect[3840 x 2160]
        dst: pos[0, 0] rect[7680 x 4320]
        buf[0]: addr: 0x0000000010971000 pitch: 15360 offset: 0
Video Port1: DISABLED
Video Port2: DISABLED
Video Port3: DISABLED

一般如果遇到 HDMI/Display Port 无法显示的问题,都需要先执行上面的命令去看一下连接状态、edid 和分辨率是否正确。