16. MIPI屏幕

16.1. 屏幕支持列表

LubanCat-RK3576系列板卡支持野火自家提供的MIPI屏，其余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分配下）

  • Video Port0——HDMI接口 最大支持4K@120Hz

  • Video Port1——DP接口 最大支持2560x1600@60Hz

  • Video Port2——DSI接口 最大支持1920x1080@60Hz

以上Video Port可切换自由分配切换，例如DSI接口使用Video Port1就可以实现最大支持2560x1600@60Hz。

16.2. MIPI接口

危险

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

LubanCat-3系列板卡上带有一个MIPI DSI接口，可以与其他接口组成多屏异显。

接口类型详细信息

  • FPC连接器

  • 0.5间距

  • 30P

  • 异面

  • 往上翻盖下接

LubanCat-3板卡接MIPI屏幕如下：

../../_images/lubancat-3-mipi-dsi0.jpg

LubanCat-3金手指/BTB板卡接MIPI屏幕如下：

../../_images/lubancat-3io-mipi-dsi0.jpg

16.3. MIPI屏幕的使用

16.3.1. 手动加载屏幕插件

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

16.3.1.1. LubanCat-3板卡

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

可以看到上图 # Display 下面会有3个区域 vp0 、 vp1 和 vp2

其中vp2对应dsi接口，各插件对应屏幕如下，有编号的可从屏幕背板丝印查看：

设备树插件

屏幕

5-5inch-ebf410125

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

5-5inch-ebf410125-v1

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

7inch-ebf410173

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

10-1inch-ebf410177

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

10.1inch-s8001280b1060b

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

generic

通用屏幕设备树插件，当前版本不可用
16.3.1.1.1. 开启mipi屏

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

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

  • 删除 #dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1080x1920-5-5inch-ebf410125-overlay.dtbo 这行前面的 #

  • 本质上是把注释了的 #dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1080x1920-5-5inch-ebf410125-overlay.dtbo 取消注释

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

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

16.3.1.1.2. 关闭mipi屏

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

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

  • 在 #dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1080x1920-5-5inch-ebf410125-overlay.dtbo 这行最前面添加 #

  • 本质上是把没有注释的 #dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1080x1920-5-5inch-ebf410125-overlay.dtbo 添加注释

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

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

16.3.1.2. LubanCat-3IO板卡

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

可以看到上图 # Display 下面会有3个区域 vp0 、 vp1 和 vp2

其中vp2对应dsi接口，各插件对应屏幕如下，有编号的可从屏幕背板丝印查看：

设备树插件

屏幕

5-5inch-ebf410125

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

7inch-ebf410173

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

10-1inch-ebf410177

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

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

  • 删除 #dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1080x1920-5-5inch-ebf410125-overlay.dtbo 这行前面的 #

  • 本质上是把注释了的 #dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1080x1920-5-5inch-ebf410125-overlay.dtbo 取消注释

1
2
3
4
5
6
#vp2
dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1080x1920-5-5inch-ebf410125-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1024x600-7inch-ebf410173-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-800x1280-10-1inch-ebf410177-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-800x1280-10.1inch-s8001280b1060b-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-generic-overlay.dtbo

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

16.3.1.2.2. 关闭mipi屏

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

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

  • 在 #dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1080x1920-5-5inch-ebf410125-overlay.dtbo 这行最前面添加 #

  • 本质上是把没有注释的 #dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1080x1920-5-5inch-ebf410125-overlay.dtbo 添加注释

1
2
3
4
5
6
#vp2
#dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1080x1920-5-5inch-ebf410125-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-1024x600-7inch-ebf410173-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-800x1280-10-1inch-ebf410177-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-800x1280-10.1inch-s8001280b1060b-overlay.dtbo
#dtoverlay=/dtb/overlay/rk3576-lubancat-3-dsi-generic-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