16. MIPI屏幕

16.1. 屏幕支持列表

LubanCat-RK3588系列板卡支持野火自家提供的MIPI屏幕

mipi屏幕

屏幕名称

屏幕类型

分辨率

色彩

接口

野火5.5寸mipi屏

LCD

1080x1920

RGB888

四通道mipi-dsi

野火7寸mipi屏

LCD

1024x600

RGB888

四通道mipi-dsi

野火10.1寸mipi屏

LCD

800x1280

RGB888

四通道mipi-dsi

  1. 购买链接： (野火)5.5寸电容屏1920*1080 MIPI接口5点触控 颜色深度24位 RGB888

  2. 购买链接： (野火)7寸电容屏1024*600 MIPI接口5点触控 颜色深度24位 RGB888

  3. 购买链接： (野火)10.1寸电容屏800*1280 MIPI接口5点触控 颜色深度24位 RGB888

注意

野火在售5.5寸和10.1寸mipi屏均为竖屏，7寸屏为横屏

5.5寸屏幕目前有新旧两款，在售5.5寸屏幕均为新款，可从屏幕背板编号区分新旧款

未找到该图片

10.1寸mipi屏幕已经升级换新，在售10.1寸mipi屏均为新款，可从屏幕外形区分新旧款

未找到图片

如果要自行适配其他屏幕（野火默认的vp分配下）

  • dsi0 接口 最大支持3840x2160@60hz

  • dsi1 接口 最大支持2048x1080@60Hz

16.2. 屏幕接口

16.2.1. LubanCat-4 mipi dsi接口

LubanCat-4板卡上带有两个mipi dsi接口，这两个接口可以与其他接口组成多屏异显.

接口类型详细信息

  • FPC连接器

  • 0.5间距

  • 30P

  • 往上翻盖下接

mipi dsi 0(在LubanCat-4板卡的背面)

../../_images/interface-mipi-dsi-0.png

mipi dsi 1(在LubanCat-4板卡的正面)

../../_images/interface-mipi-dsi-1.png

  • 当连接野火mipi屏时需要的fpc排线要求如下：

  • 30P

  • 间距0.5mm

  • 异面

16.2.2. LubanCat-4IO mipi dsi接口

LubanCat-4IO板卡上带有两个mipi dsi接口，这两个接口可以与其他接口组成多屏异显.

接口类型详细信息

  • FPC连接器

  • 0.5间距

  • 30P

  • 往上翻盖下接

mipi dsi 0(在LubanCat-4IO板卡的背面)

../../_images/interface-mipi-dsi-0_4IO.png

mipi dsi 1(在LubanCat-4IO板卡的正面)

../../_images/interface-mipi-dsi-1_4IO.png

  • 当连接野火mipi屏时需要的fpc排线要求如下：

  • 30P

  • 间距0.5mm

  • 异面

16.2.3. LubanCat-5 mipi dsi接口

LubanCat-5板卡上带有两个mipi dsi接口(均在正面)，这两个接口可以与其他接口组成多屏异显.

接口类型详细信息

  • FPC连接器

  • 0.5间距

  • 30P

  • 往上翻盖下接

接口如下图所示：

../../_images/interface-mipi-dsi1-1.png

  • 当连接野火mipi屏时需要的fpc排线要求如下：

  • 30P

  • 间距0.5mm

  • 异面

注意

mipi dsi接口不支持热插拔，请勿在上电的时候安装或者卸载屏幕, 上电时安装和卸载可能会导致板卡短路， 轻则板卡保护关机， 重则损坏芯片的接口或者烧坏芯片。

16.2.4. LubanCat-5IO mipi dsi接口

LubanCat-5板卡上带有两个mipi dsi接口，这两个接口可以与其他接口组成多屏异显。

接口类型详细信息

  • FPC连接器

  • 0.5间距

  • 30P

  • 往上翻盖下接

接口如下图所示：

未找到图片
未找到图片

  • 当连接野火mipi屏时需要的fpc排线要求如下：

  • 30P

  • 间距0.5mm

  • 异面

注意

mipi dsi接口不支持热插拔，请勿在上电的时候安装或者卸载屏幕, 上电时安装和卸载可能会导致板卡短路， 轻则板卡保护关机， 重则损坏芯片的接口或者烧坏芯片。

16.3. MIPI屏幕的使用

16.3.1. 手动加载屏幕插件

16.3.1.1. LubanCat-4 mipi屏幕的使用

mipi屏幕的开关是通过配置文件来配置的。 点击跳转 配置文件&设备树&设备树插件

1
2
#查看配置文件
cat /boot/uEnv/uEnv.txt
../../_images/cat_uEnv.png

可以看到上图 # Display 下面会有两个区域 #dsi0 in vp2 和 #dsi1 in vp3

  • #dsi0 in vp2 下面的区域的屏幕设备树插件对应着现实的dsi0接口

  • #dsi1 in vp3 下面的区域的屏幕设备树插件对应着现实的dsi1接口

可根据使用的屏幕选择相应的设备树插件，各插件对应屏幕如下，有编号的可从屏幕背板丝印查看：

设备树插件

屏幕

800x1280-10.1inch-ebf410177

野火10.1寸-EBF410177(旧款停售)、野火10.1寸-EBF410177V1R0(旧款停售)

800x1280-10.1inch-s8001280b1060b

野火10.1寸-s8001280b1060b(新款在售)

1024x600-7inch-ebf410173

野火7寸-EBF410173(旧款停售)、野火7寸-EBF410173V1R0(新款在售)

1080x1920-5.5inch-ebf410125

野火5.5寸-EBF410125(旧款停售)

generic

野火5.5寸EBF410125V1R0(新款在售)、野火7寸-EBF410173V1R0(新款在售)、野火10.1寸-EBF410177V1R0(旧款停售)

注意

其中目前在售的5.5寸屏幕为野火5.5寸EBF410125V1R0，只能通过generic设备树插件打开。

16.3.1.1.1. 开启mipi屏

以开启mipi dsi0接口的野火5.5寸-EBF410125为例

1
2
#修改配置文件
sudo vi /boot/uEnv/uEnv.txt

1
2
3
4
5
6
7
#dsi0 in vp2
#dtoverlay=/dtb/overlay/rk3588s-lubancat-dp0-in-vp2-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-800x1280-10.1inch-ebf410177-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-800x1280-10.1inch-s8001280b1060b-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1024x600-7inch-ebf410173-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1080x1920-5.5inch-ebf410125-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-generic-overlay.dtbo

  • 删除 #dtoverlay=/dtb/overlay/dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1080x1920-5.5inch-ebf410125-overlay.dtbo 这行前面的 #

  • 本质上是把注释了的 #dtoverlay=/dtb/overlay/dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1080x1920-5.5inch-ebf410125-overlay.dtbo 取消注释

1
2
3
4
5
6
7
#dsi0 in vp2
#dtoverlay=/dtb/overlay/rk3588s-lubancat-dp0-in-vp2-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-800x1280-10.1inch-ebf410177-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-800x1280-10.1inch-s8001280b1060b-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1024x600-7inch-ebf410173-overlay.dtbo
dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1080x1920-5.5inch-ebf410125-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-generic-overlay.dtbo

修改完文件后就可以重启来生效该配置了

16.3.1.1.2. 关闭mipi屏

以关闭mipi dsi0接口的7寸屏为例

1
2
#修改配置文件
sudo vi /boot/uEnv/uEnv.txt

1
2
3
4
5
6
7
#dsi0 in vp2
#dtoverlay=/dtb/overlay/rk3588s-lubancat-dp0-in-vp2-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-800x1280-10.1inch-ebf410177-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-800x1280-10.1inch-s8001280b1060b-overlay.dtbo
dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1024x600-7inch-ebf410173-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1080x1920-5.5inch-ebf410125-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-generic-overlay.dtbo

  • 在 dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1024x600-7inch-ebf410173-overlay.dtbo 这行最前面添加 #

  • 本质上是把没有注释的 dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1024x600-7inch-ebf410173-overlay.dtbo 添加注释

1
2
3
4
5
6
7
#dsi0 in vp2
#dtoverlay=/dtb/overlay/rk3588s-lubancat-dp0-in-vp2-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-800x1280-10.1inch-ebf410177-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-800x1280-10.1inch-s8001280b1060b-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1024x600-7inch-ebf410173-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-1080x1920-5.5inch-ebf410125-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588s-lubancat-4-v1-dsi0-generic-overlay.dtbo

修改完文件后就可以重启来生效该配置了

16.3.1.2. LubanCat-5 mipi屏幕的使用

mipi屏幕的开关是通过配置文件来配置的。 点击跳转 配置文件&设备树&设备树插件

1
2
#查看配置文件
cat /boot/uEnv/uEnv.txt
../../_images/cat_uEnv0.png

可以看到下面会有两个区域 # vp2 和 # vp3

  • # vp2 下面的区域的屏幕设备树插件对应着现实的dsi0接口

  • # vp3 下面的区域的屏幕设备树插件对应着现实的dsi1接口

可根据使用的屏幕选择相应的设备树插件，各插件对应屏幕如下，有编号的可从屏幕背板丝印查看：

设备树插件

屏幕

1080p

野火5.5寸-EBF410125(旧款停售)

1024x600

野火7寸-EBF410173(旧款停售)、野火7寸-EBF410173V1R0(新款在售)

800x1280

野火10.1寸-EBF410177(旧款停售)、野火10.1寸-EBF410177V1R0(旧款停售)

800x1280-10.1inch-s8001280b1060b

野火10.1寸-s8001280b1060b(新款在售)

generic

野火5.5寸EBF410125V1R0(新款在售)、野火7寸-EBF410173V1R0(新款在售)、野火10.1寸-EBF410177V1R0(旧款停售)

注意

其中目前在售的5.5寸屏幕为野火5.5寸EBF410125V1R0，只能通过generic设备树插件打开。

16.3.1.2.1. 开启mipi屏

以开启mipi dsi0接口的野火5.5寸-EBF410125为例

1
2
#修改配置文件
sudo vi /boot/uEnv/uEnv.txt

1
2
3
4
5
6
7
8
# vp2 (插件只能同时开一个)
dtoverlay=/dtb/overlay/rk3588-lubancat-5-hdmi1-vp2-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1080p-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1024x600-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-800x1280-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-800x1280-10.1inch-s8001280b1060b-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-generic-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-edp-vp2-overlay.dtbo

  • 删除 #dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1080p-overlay.dtbo 这行前面的 #

  • 添加 dtoverlay=/dtb/overlay/rk3588-lubancat-5-hdmi1-vp2-overlay.dtbo 这行前面的 #

1
2
3
4
5
6
7
8
# vp2 (插件只能同时开一个)
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-hdmi1-vp2-overlay.dtbo
dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1080p-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1024x600-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-800x1280-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-800x1280-10.1inch-s8001280b1060b-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-generic-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-edp-vp2-overlay.dtbo

修改完文件后就可以重启来生效该配置了

16.3.1.2.2. 关闭mipi屏

以关闭mipi dsi0接口的7寸屏为例

1
2
#修改配置文件
sudo vi /boot/uEnv/uEnv.txt

1
2
3
4
5
6
7
8
# vp2 (插件只能同时开一个)
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-hdmi1-vp2-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1080p-overlay.dtbo
dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1024x600-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-800x1280-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-800x1280-10.1inch-s8001280b1060b-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-generic-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-edp-vp2-overlay.dtbo

  • 在 dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1024x600-overlay.dtbo 这行最前面添加 #

  • 本质上是把没有注释的 dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1024x600-overlay.dtbo 添加注释

1
2
3
4
5
6
7
8
# vp2 (插件只能同时开一个)
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-hdmi1-vp2-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1080p-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-1024x600-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-800x1280-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-800x1280-10.1inch-s8001280b1060b-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-dsi0-vp2-generic-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3588-lubancat-5-v2-edp-vp2-overlay.dtbo

修改完文件后就可以重启来生效该配置了

16.3.1.3. LubanCat-5IO mipi屏幕的使用

mipi屏幕的开关是通过配置文件来配置的。 点击跳转 配置文件&设备树&设备树插件

1
2
#查看配置文件
cat /boot/uEnv/uEnv.txt
../../_images/screen_2.jpg

出厂镜像默认使用四屏异显配置，默认开启hdmi0、hdmi1以及dp0。

可根据使用的屏幕选择相应的设备树插件，各插件对应屏幕如下，有编号的可从屏幕背板丝印查看：

设备树插件

屏幕

1080p

野火5.5寸-EBF410125(旧款停售)

800x1280

野火10.1寸-EBF410177(旧款停售)、野火10.1寸-EBF410177V1R0(旧款停售)

800x1280-10.1inch-s8001280b1060b

野火10.1寸-s8001280b1060b(新款在售)

1024x600

野火7寸-EBF410173(旧款停售)、野火7寸-EBF410173V1R0(新款在售)

generic

野火5.5寸EBF410125V1R0(新款在售)、野火7寸-EBF410173V1R0(新款在售)、野火10.1寸-EBF410177V1R0(旧款停售)

注意

其中目前在售的5.5寸屏幕为野火5.5寸EBF410125V1R0，只能通过generic设备树插件打开

16.3.1.3.1. 开启mipi屏

以开启mipi dsi0接口的野火5.5寸-EBF410125为例，因为dp0和dsi0共用一个vp接口，同时只能开启其中一个，所以需要注释dp0-vp2，取消注释dsi0-vp2。

1
2
#修改配置文件
sudo vi /boot/uEnv/uEnv.txt

1
2
3
#注释dp0-vp2，取消注释dsi0-vp2
#dtoverlay=/dtb/overlay/rk3588-lubancat-5io-dp0-vp2-overlay.dtbo
dtoverlay=/dtb/overlay/rk3588-lubancat-5io-dsi0-vp2-1080p-overlay.dtbo

修改完文件后就可以重启来生效该配置了

16.3.1.3.2. 关闭mipi屏

以关闭mipi dsi0接口的5.5寸屏为例

1
2
#修改配置文件
sudo vi /boot/uEnv/uEnv.txt

1
2
#注释对应的dsi0
#dtoverlay=/dtb/overlay/rk3588-lubancat-5io-dsi0-vp2-1080p-overlay.dtbo

修改完文件后就可以重启来生效该配置了。

16.3.2. 自动加载屏幕插件

野火2026年1月份发布的镜像搭配带有eeprom的屏幕，可实现在uboot阶段识别并自动加载通用屏幕插件，系统启动过程中会读取屏幕上eeprom的数据， 根据eeprom存储的屏幕时序信息从而驱动屏幕显示。

支持的屏幕如下，可根据屏幕背面的丝印确认屏幕版本：

  • 野火5.5寸EBF410125V1R0(新款在售)

  • 野火7寸-EBF410173V1R0(新款在售)

  • 野火10.1寸-EBF410177V1R0(旧款停售)

确认镜像日期在2026年1月份及之后，屏幕连接板卡任意一个MIPI DSI接口然后上电即可点亮屏幕，无需修改任何配置。

如果需要关闭该功能可修改/boot/uEnv/uEnv.txt文件，将enable_gsdt_auto_load变量值修改为0。

16.3.2.1. 重新烧录屏幕固件

野火在出厂的时候为带有eeprom的屏幕都烧录了对应的固件，如果在使用的过程中损坏了里面的数据，可根据以下链接中的方法重新烧录固件。

参考链接：https://github.com/LubanCat/lcd_firmware