工控網(wǎng)首頁
>

應用設計

>

基于RK3568J平臺測試雙屏顯示

基于RK3568J平臺測試雙屏顯示

簡介

RK3568J 是瑞芯微(Rockchip)面向工業(yè)與醫(yī)療市場推出的高性能、低功耗應用處理器,采用四核 Arm Cortex-A55 架構(gòu),集成 Mali-G52 2EE GPU、512 MAC NPU、8M ISP 以及 4K 視頻編解碼單元。在顯示能力方面,RK3568J 支持多屏顯示(multi-display),可同時輸出 LVDS、MIPI-DSI、24bit RGB、eDP、HDMI 2.0 和 T-CON 等多種顯示接口,能夠滿足多屏異顯、多屏同顯等復雜顯示需求,具體規(guī)格可參考 Rockchip RK3568J 產(chǎn)品頁面。

憑借豐富的顯示接口與工業(yè)級可靠性,RK3568J 被廣泛應用于醫(yī)療設備(監(jiān)護儀、超聲/內(nèi)窺鏡顯示終端、手術(shù)臺操作面板)、工業(yè) HMI、自助服務終端、數(shù)字標牌、電力與軌道交通等場景。在這類設備中,主屏通常用于顯示核心業(yè)務界面,副屏用于操作面板、參數(shù)設置或輔助信息展示,雙屏顯示已成為典型的產(chǎn)品形態(tài)。

本文基于 Toradex Verdin RK3568J 嵌入式平臺,演示兩種雙屏顯示模式:默認的 Clone(鏡像)模式,以及兩個屏幕各自運行獨立 Qt5 應用的 獨立顯示模式,并給出完整的 BSP 編譯、鏡像燒寫與系統(tǒng)配置步驟。

硬件平臺介紹

Verdin RK3568J 是 Toradex 基于 Rockchip RK3568J 推出的 Verdin 系列核心板(Computer on Module),主要規(guī)格如下:

項目

規(guī)格

處理器

4× Arm Cortex-A55,normal 1.4 GHz / overdrive 1.8 GHz

協(xié)處理器

1× RISC-V MCU

GPU

Arm Mali-G52 2EE,支持 OpenGL ES 1.1/2.0/3.2、Vulkan 1.0/1.1、OpenCL 2.0

NPU

最高 1 TOPS

內(nèi)存

4 GB LPDDR4/4X(32 bit)

存儲

32 GB eMMC

顯示接口

HDMI 2.0、LVDS、MIPI-DSI(最高 4096×2304@60Hz),三路顯示控制器

視頻編解碼

解碼 4096×2304@60fps,編碼 1920×1080@60fps

網(wǎng)絡

2× Gigabit Ethernet(1× PHY with TSN + 1× RGMII,可復用 QSGMII)

高速接口

2× PCIe Gen3 x1、1× PCIe 2.0、2× USB 3.0、3× SATA 3.0

工業(yè)接口

2× CAN FD、5× I2C、2× SPI、8× UART、9× PWM、109× GPIO

工作溫度

-40 °C ~ +85 °C

尺寸

69.6 × 35.0 × 6.0 mm

核心板通過 Verdin 標準連接器與載板配合,本次測試使用 Dahlia 載板。

準備

硬件

?  Verdin RK3568J ARM 核心板,配合 Dahlia 載板使用

?  連接 Dahlia 載板的 X18 調(diào)試串口,用于查看系統(tǒng)啟動日志與執(zhí)行命令行操作

?  分別通過 X21 原生 HDMI 接口與 X17 DSI-to-HDMI Adapter 接口連接兩臺 HDMI 顯示器,用于后續(xù)雙屏測試

軟件

?  開發(fā)主機:Ubuntu 20.04 LTS(RK3568J 的 Yocto Kirkstone BSP 要求 Ubuntu 20.04 編譯環(huán)境)

?  本文使用 Docker 容器封裝編譯環(huán)境,避免污染開發(fā)主機,Dockerfile 參見文末倉庫鏈接

?  燒寫工具:Rockchip upgrade_tool(Linux 版本)

測試步驟

1. 編譯 Yocto BSP Image

1.1 準備編譯環(huán)境

首先初始化 repo 并同步 Toradex RK3568J 的 Yocto 源碼:

### create yocto build environment

$ cd/rockchip-yocto-release

$ repo init -u https://jihulab.com/toradex/rk3568j/toradex-cn-manifest.git -b kirkstone-6.x.y-rk -m tdxref/default.xml

$ repo sync

RK3568J 的 Yocto Kirkstone BSP 需要 Ubuntu 20.04 編譯環(huán)境,因此使用 Docker 構(gòu)建統(tǒng)一的編譯容器:

### RK3568 yocto kirkstone need Ubuntu 20.04 environment

### Dockerfile - https://gitee.com/simonqin09/verdin-rk3568-j-multi-screen-configuration/blob/master/Dockerfile

 

### build image

$ docker build -t verdin3568:1 .

 

### start yocto build docker environment

$ docker run --rm -it --user test:test -v/rockchip-yocto-release:/home/test/yocto \

  --workdir=/home/test/yocto verdin3568:1 bash

進入容器后,設置編譯環(huán)境并構(gòu)建鏡像:

### set up environment

$ MACHINE=verdin-rk3568j source verdin-setup-environment build

 

### build the image

$ bitbake verdin-image-common

1.2 添加 Qt5 與顯示配置 Layer

默認 BSP 鏡像不包含 Qt5 相關庫。為了驗證雙屏顯示效果,需要在源碼目錄中新增 meta-custom-demo layer,用于添加 Qt5 庫、兩個 Qt5 演示程序以及顯示相關配置:

### add customized layer meta-custom-demo

$ cd/rockchip-yocto-release/meta-custom-demo

$ tree -L 4

.

├── conf

│   └── layer.conf

├── recipes-core

│   └── images

│       ├── packagegroup-tdx-qt5.bb

│       └── verdin-image-common.bbappend

├── recipes-graphics

│   ├── wayland

│   │   ├── weston-init

│   │   │   └── weston.service

│   │   └── weston-init.bbappend

│   └── wayland-app-launch

│       ├── wayland-app-launch

│       │   └── wayland-app-launch.service.in

│       ├── wayland-app-launch.inc

│       └── wayland-qtdemo-launch-cinematicexperience_1.0.bb

└── recipes-qt

    └── examples

        ├── cinematicexperience

        │   └── fix-fullscreen-mode.patch

        ├── cinematicexperience_1.0.bbappend

        └── qtsmarthome_1.0.bbappend

各目錄的作用說明如下:

?  recipes-core/images:將 Qt5 庫和兩個 Qt5 demo 加入 verdin-image-common 鏡像

?  recipes-graphics/wayland/weston-init:修改 weston.service,默認將所有屏幕配置為 Clone 顯示

?  recipes-graphics/wayland-app-launch:配置 cinematicexperience demo 開機自啟動

?  recipes-qt/examples:配置安裝 cinematicexperience 和 qtsmarthome 兩個 Qt5 demo

具體文件內(nèi)容可參考倉庫:

https://gitee.com/simonqin09/verdin-rk3568-j-multi-screen-configuration/tree/master/meta-custom-demo

將 meta-custom-demo 加入 build/conf/bblayers.conf 后,重新執(zhí)行 bitbake verdin-image-common,即可生成包含 Qt5 與雙屏配置的鏡像。

2. 安裝編譯好的 BSP Image

1.  將 Dahlia 載板的調(diào)試 USB OTG 接口 X3 連接到開發(fā)主機

2.  先按住 SW5(Recovery) 按鍵,再按 SW3(On/Off) 按鍵開機,使 Verdin RK3568J 進入 Loader 模式

3.  在開發(fā)主機上使用 Rockchip upgrade_tool 將步驟 1 編譯出的 BSP 鏡像燒寫到模塊,本文以 Linux 環(huán)境為例

確認設備已進入 Loader 模式:

### check rk3568j device in loader mode

$ sudo ./upgrade_tool ld

Using/rkdeveloptool/tools-master/linux/Linux_Upgrade_Tool/Linux_Upgrade_Tool/config.ini

List of rockusb connected(1)

DevNo=1 Vid=0x2207,Pid=0x350a,LocationID=111143 Mode=Loader SerialNo=20971523

燒寫鏡像:

### upgrade bsp image

$ sudo ./upgrade_tool uf/verdin-image-common-verdin-rk3568j.update.img

Using/rkdeveloptool/tools-master/linux/Linux_Upgrade_Tool/Linux_Upgrade_Tool/config.ini

Loading firmware...

Support Type:3568 FW Ver:1.0.00 FW Time:2026-10-27 06:29:04

Loader ver:1.01 Loader Time:2026-10-23 12:46:25

Start to upgrade firmware...

Test Device Start

Test Device Success

Check Chip Start

Check Chip Success

Get FlashInfo Start

Get FlashInfo Success

Prepare IDB Start

Prepare IDB Success

Download IDB Start

Download IDB Success

Download Firmware Start

Download Image... (100%)

Download Firmware Success

Upgrade firmware ok.

3. 驗證 Clone 雙屏顯示

燒寫完成后設備會自動重啟。啟動完成后,同時連接的兩個 HDMI 屏幕呈現(xiàn) Clone(鏡像)顯示效果,即兩塊屏幕顯示完全相同的內(nèi)容,且均顯示 Qt5 cinematicexperience demo:

Clone_display.jpg 

Clone 模式下兩個 HDMI 屏幕顯示相同的 Qt5 CinematicExperience demo

Clone 模式由 weston.service 的默認配置實現(xiàn):Weston 作為 Wayland compositor 統(tǒng)一管理 DRM 輸出,將同一個 surface 復制到所有已連接的顯示接口,因此無需額外配置即可實現(xiàn)雙屏同顯,適合主副屏內(nèi)容一致的場景。

4. 配置獨立雙屏顯示

若希望兩塊 HDMI 屏幕不再 Clone,而是各自顯示獨立的應用,則需要讓每個 Qt5 應用分別直接接管一個顯示輸出。

4.1 關閉 Weston 與 wayland-app-launch

分屏顯示需要應用直接調(diào)用 eglfs_kms 后端訪問 DRM/KMS,而 Weston 運行時會占用 DRM master,兩者會產(chǎn)生沖突,因此先禁用 weston 與 wayland-app-launch:

root@verdin-rk3568j-20971523:~# systemctl disable wayland-app-launch

root@verdin-rk3568j-20971523:~# systemctl disable weston

4.2 配置 HDMI1 上的 cinematicexperience

重啟后,為第一個屏幕創(chuàng)建獨立的 systemd service,并通過單獨的 kms1.conf 指定顯示輸出設備與觸摸設備:

### qt-app-hdmi1.service

root@verdin-rk3568j-20971523:~# cat /lib/systemd/system/qt-app-hdmi1.service

[Unit]

Description=Qt App on HDMI-A-1

After=multi-user.target

 

[Service]

Type=simple

User=root

Group=root

Environment="QT_QPA_PLATFORM=eglfs"

Environment="QT_QPA_EGLFS_INTEGRATION=eglfs_kms"

Environment="QT_QPA_EGLFS_KMS_ATOMIC=1"

#Environment="QT_QPA_EGLFS_KMS_CONNECTOR_INDEX=1"

Environment="QT_QPA_EGLFS_HIDECURSOR=1"

Environment="QT_QPA_EGLFS_NO_LIBINPUT=1"

Environment="QT_QPA_EGLFS_KMS_CONFIG=/etc/kms1.conf"

Environment="XDG_RUNTIME_DIR=/run/user/0"

ExecStart=/usr/share/cinematicexperience-1.0/Qt5_CinematicExperience

Restart=on-failure

RestartSec=3

 

[Install]

WantedBy=multi-user.target

### kms1.conf

root@verdin-rk3568j-20971523:~# cat /etc/kms1.conf

{

    "device": "/dev/dri/card0",

    "outputs": [

        {

            "name": "HDMI1",

            "virtualIndex": 0,

            "touchDevice": "/dev/input/event4"

        }

    ]

}

4.3 配置 HDMI2 上的 qtsmarthome

同樣地,為第二個屏幕創(chuàng)建 service,并通過 kms2.conf 指定第二個輸出與對應的觸摸設備:

### qt-app-hdmi2.service

root@verdin-rk3568j-20971523:~# cat /lib/systemd/system/qt-app-hdmi2.service

[Unit]

Description=Qt App on HDMI-A-2

After=multi-user.target

 

[Service]

Type=simple

User=root

Group=root

WorkingDirectory=/usr/share/qtsmarthome-1.0

Environment="QT_QPA_PLATFORM=eglfs"

Environment="QT_QPA_EGLFS_INTEGRATION=eglfs_kms"

Environment="QT_QPA_EGLFS_KMS_ATOMIC=1"

#Environment="QT_QPA_EGLFS_KMS_CONNECTOR_INDEX=2"

Environment="QT_QPA_EGLFS_HIDECURSOR=1"

Environment="QT_QPA_EGLFS_NO_LIBINPUT=1"

Environment="QT_QPA_EGLFS_KMS_CONFIG=/etc/kms2.conf"

Environment="XDG_RUNTIME_DIR=/run/user/0"

ExecStart=/usr/share/qtsmarthome-1.0/smarthome

Restart=on-failure

RestartSec=3

 

[Install]

WantedBy=multi-user.target

### kms2.conf

root@verdin-rk3568j-20971523:~# cat /etc/kms2.conf

{

    "device": "/dev/dri/card0",

    "outputs": [

        {

            "name": "HDMI2",

            "virtualIndex": 1,

            "touchDevice": "/dev/input/event5"

        }

    ]

}

其中關鍵配置項說明:

?  QT_QPA_PLATFORM=eglfs:使用 EGL Full Screen 平臺插件,應用獨占整個顯示輸出

?  QT_QPA_EGLFS_INTEGRATION=eglfs_kms:通過 DRM/KMS 直接控制顯示,繞過 Weston

?  QT_QPA_EGLFS_KMS_ATOMIC=1:啟用 Atomic Mode Setting,保證多屏配置的原子性

?  QT_QPA_EGLFS_KMS_CONFIG:指定該應用使用的 KMS 配置文件

?  virtualIndex:指定該應用在 KMS 配置中的虛擬屏幕索引,兩個應用必須不同

?  touchDevice:綁定該屏幕對應的觸摸輸入設備,實現(xiàn)各屏幕獨立觸控

4.4 使能服務并重啟

使能兩個 systemd service 后重啟設備:

root@verdin-rk3568j-20971523:~# systemctl enable qt-app-hdmi1

root@verdin-rk3568j-20971523:~# systemctl enable qt-app-hdmi2

root@verdin-rk3568j-20971523:~# reboot

重啟完成后,兩塊 HDMI 屏幕分別顯示 cinematicexperience demo 與 qtsmarthome demo,實現(xiàn)真正的雙屏異顯:

Split_display.jpg 

獨立顯示模式下兩個 HDMI 屏幕分別運行不同的 Qt5 應用

總結(jié)

本文基于 Rockchip RK3568J 硬件平臺,完整演示了雙屏顯示的兩種實現(xiàn)方式:

1.  Clone(鏡像)模式:由 Weston 統(tǒng)一管理 DRM 輸出,所有屏幕顯示相同內(nèi)容,配置簡單,適合主副屏內(nèi)容一致的場景

2.  獨立顯示模式:禁用 Weston 后,各 Qt5 應用通過 eglfs_kms 后端直接接管一個 DRM connector,并配合獨立的 KMS 配置文件綁定顯示輸出與觸摸設備,實現(xiàn)一屏一應用

RK3568J 最多支持三路獨立顯示控制器,因此三屏甚至更多屏幕的組合也可以采用類似方式實現(xiàn):只需為每個應用準備獨立的 KMS 配置文件和 systemd service,并確保 virtualIndex 與 touchDevice 不沖突即可。該方案已在醫(yī)療設備、工業(yè) HMI 等多屏交互場景中得到驗證,具備良好的可移植性。

參考鏈接

?  Rockchip RK3568J 產(chǎn)品頁面

?  Toradex Verdin RK3568J 產(chǎn)品頁面

?  Toradex Dahlia 載板

?  本文示例代碼與 meta-custom-demo layer

?  Qt EGLFS KMS 配置說明

審核編輯(
王靜
)
投訴建議

提交

查看更多評論
其他資訊

查看更多

RS485 串行通信調(diào)試:工具鏈挑戰(zhàn)與 POSIX 兼容性問題

Toradex 在 elexcon 2026 深圳國際電子展暨嵌入式展等待您光臨

韜睿丨誠邀參與:Verdin RK3568J 核心板 Early Access計劃

Toradex Verdin iMX8M Plus 上使用 Bao Hypervisor

基于 NXP i.MX8M Plus 測試 Zephyr RTOS