迅为RK3588开发板Android多屏显示之多屏同显和多屏异显

迅为RK3588开发板是一款低功耗、高性能的处理器，适用于基于arm的PC和Edge计算设备、个人移动互联网设备等数字多媒体应用，RK3588支持8K视频编解码，内置GPU可以完全兼容OpenGLES 1.1、2.0和3.2。RK3588引入了新一代完全基于硬件的最大4800万像素ISP，内置NPU，支持INT4/INT8/INT16/FP16混合运算能力，支持安卓12和、Debian11、Build root、Ubuntu20和22版本登系统。了解更多信息可点击迅为官网

【实验平台】：迅为RK3588开发板

【内容来源】《【北京迅为】itop-3588 开发板多屏显示手册 v1.0》

RK3588 最多可以支持 7 个屏幕显示，这主要取决于 RK3588 芯片内置了 VOP 控制器，

支持四路视频同显或异显，可有效提高行业定制的拓展性。本章节我们将介绍在 RK3588 的Android12 系统上实现多屏显示。

1.1 Android 多屏同显

iTOP-RK3588 开发板支持以下屏幕

迅为 MIPI 7 寸屏幕

标准 HDMI 屏幕（通过 HDMI 线连接）

迅为 LVDS 7 寸屏幕

迅为 LVDS 10.1 寸 1024*600 屏幕

迅为 LVDS 10.1 寸 1280*800 屏幕

迅为 LVDS 10.1 寸 1280*800 新屏幕

然后修改 Android12 源码 kernel-5.10/arch/arm64/boot/dts/rockchip/topeet_screen_lcds.dts 中

的设备树文件，如下图所示。 LVDS 屏幕是 MIPI 通过转接板连接显示的，RK3588 不支持LVDS 显示接口。

注：

其中#define LCD_TYPE_LVDS_10_1_1280X800_GT911 和#define

LCD_TYPE_LVDS_10_1_1280X800_GT9271 不同之处在于屏幕背板，可通过如下进行区分：

#define LCD_TYPE_LVDS_10_1_1280X800_GT911

#define LCD_TYPE_LVDS_10_1_1280X800_GT9271

我们可以根据自己的需求来修改 topeet_screen_choose.dtsi 文件。总之，修改

topeet_screen_choose.dtsi 的规律是：打开所连接的屏幕对应的宏定义，rk3588 有三个显示通道 vp0 vp1 vp2 vp3，所打开的宏定义对应的 vp 通道不能重复。默认打开对应的宏定义为多屏同显。

RK3588 VP 和各显示接口的连接关系如下图所示。

1.2 Android 多屏异显

如果要支持多屏异显，首先要调试好双屏或多屏都可以正常显示，并且分别挂载在不同的 vp 上，可以参考上一个小节根据自己的需求打开 topeet_screen_choose.dtsi 设备树中的宏定义。

默认开启后，多屏显示的是同一个画面(如果要支持双屏或者多屏异显，需要应用支持异显，才会显示不同的内容)。查看当前的屏幕显示状态输入以下命令

cat /sys/kernel/debug/dri/0/summary

如果双屏或者多屏的显示器分辨率比例不同，比如说主屏是 16:9，副屏是 4:3，那么副屏显示的画面会拉伸或者缩小，原因是副屏的画面是主屏映射过去的，所以副屏上显示的是主屏的分辨率。如果同样的屏幕情况下，应用支持异显，那么副屏会显示实际正常的分辨率。

所以如果要支持双屏或者多屏同显并要求显示正常，双屏或者多屏的屏幕的分辨率比要一致。

1.2.1 指定主副屏

多屏异显的实际应用中，需要指定哪个是主屏，哪个是副屏。修改 Android12 源码目录下 3588-android12/device/rockchip/rk3588/rk3588_s/rk3588_s.mk 文件，添加如下内容：

如果要指定 MIPI 屏幕为主屏，HDMI 屏幕为副屏，如下设置：

PRODUCT_PROPERTY_OVERRIDES += vendor.hwc.device.primary=DSI

PRODUCT_PROPERTY_OVERRIDES += vendor.hwc.device.extend=HDMI-A

如果要指定 MIPI 屏幕为主屏，EDP 屏幕为副屏，如下设置：

PRODUCT_PROPERTY_OVERRIDES += vendor.hwc.device.primary=DSI

PRODUCT_PROPERTY_OVERRIDES += vendor.hwc.device.extend=eDP

如果需要定义多个主副屏时，需要用逗号隔开，比如指定 MIPI eDP 为主屏，HDMI-A 为副屏，

设置如下：

PRODUCT_PROPERTY_OVERRIDES += vendor.hwc.device.primary=DSI,eDP

PRODUCT_PROPERTY_OVERRIDES += vendor.hwc.device.extend=HDMI-A

1.2.2 异显方案介绍

目前有两种异显方案分别是 Android Presentation 和 Andorid Activity 指定屏幕启动。

Android Presentation，需要 APP 应用开发中调用相应接口使指定的 view (Presentation view 是一个特殊的 dialog 类型 view)在副屏中显示。

Android Activity 指定屏幕启动，APP 在启动 activity 时可以使用 display id 参数在对应的屏幕上直接显示。

两者主要区别在:

1 前者的 acitivity 需要独立开发,把需要显示的内容投到副屏，后者可以不需要源码,调用命令行或者系统接口把第三方 app 的 acitivity 投送到副屏;

2 .前者只有一个 activity 在顶层，通过特殊的 dialog 将指定内容显示在副屏，后者是两个 activity 分别显示在主副屏。

接下来我们详细讲述这俩种方法。

1.2.3 Android Presentation

本小节讲解 Android Presentation 异显方案，瑞芯微和迅为提供了使用 Android Presentation 编写好的 APP 例程，接下来进行测试。

1.2.3.1 ApiDemos APP

在 Android12 源码中瑞芯微已经提供了使用 Presentation 接口的测试 APP，在源码development/samples/ApiDemos 目录下，需要使用 mm 命令编译 APP。迅为提供了编译好的测试 APP 在网盘资料“iTOP-RK3588 开发板/02_【iTOP-RK3588 开发板】/12_多屏显示配套资料/Android/ApiDemosAPK”目录下。

此 APP 源码在 Android 源码 3588-android12/development/samples/ApiDemos 目录下，进入此目录，输入“mm”命令进行编译，如下图所示：

然后使用 adb 命令安装 APP，依次点击 App->Activity->Presentation 选项，即可进入Presentation 调用界面。如下图所示：

在该界面需点击如下副屏的 checkbox 选项,即可在副屏显示相应图片。副屏 HDMi 屏幕显示图片，

1.2.3.2 Presentation sampleAPP

此 APP 在网盘资料“iTOP-RK3588 开发板/02_【iTOP-RK3588 开发板】/12_多屏显示配套资料/Android/Presentation sample”目录下，下载此 APP 工程，然后用 Androidstudio 打开，并编译 apk。编译成功之后，安装 APP，APP 安装成功之后如下图所示：

打开 APP 如下图所示：

点击“显示副屏”按钮，会在副屏显示，如下图所示：

APP 重要知识点讲解：

随着用户的需求增多，特别是对于一些 Android 平板电脑以及其他的一些 Android 智能设备可能有多个屏幕，用户不仅想要在主屏幕上显示内容，同样在第二屏幕上也要显示想要的内容，这样可以达到更好的体验效果。Google 也是不负众望在 Android4.2 版本以后提供了 Presentation 类，可以轻松实现在两块屏幕上同时显示不同的内容。Presentation 是一个特殊的 dialog，它的目的是显示内容到第二屏幕。在 Presentation 创建的时候关联一个目标设备，确

定 Presentation 要显示在那个设备上，根据这个设备的信息来配置 Presentation 的 context 和 resources 信息。目前系统提供了两种方式来与目标显示屏进行绑定。

1 通过 MediaRouter 接口获取并绑定：

选择显示 presentation 的设备最简单的方法就是使用 Media Router，media router 服务持续追踪在系统中哪个音频、视频线路是可用的，当 routes 被选择或者不被选择，或者更好的显示 presentation display 的线路发生改变后 media router 就会发送消息。所以一些应用程序可以自动监视这些消息来在首选设备上显示或取消 presentation。

首选显示 presentation 的设备是 Media Router 进行推荐的，如果应用想要显示内容在第二屏幕上就该使用该设备。下面将给出如何使用 media router 在主屏的设备创建和显示

presentation。

MediaRouter mediaRouter =(MediaRouter)

context.getSystemService(Context.MEDIA_ROUTER_SERVICE); MediaRouter.RouteInfo route =

mediaRouter.getSelectedRoute();

if(route !=null){

Display presentationDisplay = route.getPresentationDisplay();

if(presentationDisplay !=null){

Presentation presentation =newMyPresentation(context, presentationDisplay);

presentation.show();

}

根据上面代码可以看出通过系统服务 Media Router 来选择一个合适的 route，从 route 中来获取首选的 display，如果 display 不为空就会创建该 presentation，创建完成后调用 presentation 的 show 方法将该 presentation 显示出来。

2 通过 DisplayManager 接口获取并绑定

另外一个获取首选 display 的方法是直接使用 display Manager 来获取。display manager 服务提供方法枚举和描述系统中所有的设备，包括可以显示 presentation 的设备。display manager持续追踪系统中所有的设备，然而，并不是所有的设备都适合显示 presentation，例如，如果一个 Activity 试图在主屏幕上显示一个 presentation，它可能会掩盖自己的内容，这就像在Activity 上打开一个 dialog 一样。

DisplayManager displayManager =(DisplayManager)

context.getSystemService(Context.DISPLAY_SERVICE); Display[] presentationDisplays

=displayManager.getDisplays(DisplayManager.DISPLAY_CATEGORY_PRESENTATION);

if(presentationDisplays.length >0){

// If there is more than one suitable presentation display, then we could consider

// giving the user a choice. For this example, we simply choose the first display

// which is the one the system recommends as the preferred presentation display.

Display display = presentationDisplays[1]; // displays[1]是副屏

Presentation presentation =new MyPresentation(context, presentationDisplay);

presentation.show();

}

根据上面代码可以看出通过系统服务 Display Manager 来获取所有适合显示 presentation 的 display 列表，如果获取到了多个适合 display 对象，我们选择副屏的 display。最后显示 presentation。

1.2.4 Android Activity 指定屏幕启动

本小节讲解 Android Activity 指定屏幕启动异显方案，瑞芯微提供了使用 Android Activity 指定屏幕启动编写好的 APP 例程，接下来进行测试。

1.2.4.1 dualscreendemo APP

RK DualScreen 主要区别与 android presentation，在于它实现了应用的派发，允许厂商快速根据现有的 app 功能，进行模块的集成，减少开发周期和研发成本。示例代码为DualScreenDemo.zip 工程，在网盘资料“iTOP-RK3588 开发板/02_【iTOP-RK3588 开发板】/12_ 多屏显示配套资料/Android/DualScreenDemo”目录下下载。

使用 Androidstudio 打开此工程代码，编译安装 APP，安装完成后如下所示：

打开此 APP，如下所示，有三个按钮。

第三个按钮使用了 Android Activity 指定屏幕启动，关键代码如下所示，第一个和第二个按钮使用了 Presentation。

private void showSecondByActivity(Context context){

ActivityOptions options = ActivityOptions.makeBasic();

MediaRouter mediaRouter = (MediaRouter)

context.getSystemService(Context.MEDIA_ROUTER_SERVICE);

MediaRouter.RouteInfo route =

mediaRouter.getSelectedRoute(MediaRouter.ROUTE_TYPE_LIVE_VIDEO);

if (route != null) {

Display presentationDisplay = route.getPresentationDisplay();

options.setLaunchDisplayId(presentationDisplay.getDisplayId());

Intent intent = new Intent("android.intent.action.MUSIC_PLAYER");

intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

startActivity(intent, options.toBundle());

}

在 startActivity 接口参数中设置指定屏幕的 display id，Activity 将在指定屏幕上直接启动显示。

Activity 的多显示器支持需要设备支持<feature name="android.software.activities_on_secondary_displays" />。

同时 application 或者 activity 需要支持分屏属性即<application>或者<activity>标签下设置新的属性 android:resizeableActivity="true"，这个属性在你 target 到 Android N 后 android:resizeableActivity 的默认值就是 true。

ActivityOptions 提供两个新函数以支持多个显示器，分别是 setLaunchDisplayId()和 getLaunchDisplayId()。

setLaunchDisplayId() 指定 Activity 在启动后应显示在哪个显示器上。

getLaunchDisplayId() 返回操作组件的当前启动显示器。

在上述代码中使用 MediaRouter 接口获取副屏的 display id,同理也可以使用

DisplayManager 接口获取响应的 display id。

1.2.5 支持输入法在副屏显示

修改 Android12 源码下的 device/rockchip/common/display_settings.xml 文件，如下所示：

将设置相应屏幕 shouldShowIme 为 true,如上配置支持输入法在 local:1 的副屏上显示。

1.2.6 副屏 DPI 设置

修改 Android12 源码下的 device/rockchip/common/display_settings.xml 文件，

修改 forcedDensity 的值可以修改副屏的屏幕密度。

1.2.7 主屏幕可以触摸，副屏不触摸

如果想要实现主屏可以触摸，副屏不用触摸的功能。有两种解决方式：第一种是在 App 应用代码中实现。第二种需要修改 framework 层的源码。

第一种方式：

getWindow().setFlags(WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL,

WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL);

第二种方式：

修改 Android12 源码 frameworks/native/services/inputflinger/reader/EventHub.cpp 文件，屏蔽掉 device->classes |= INPUT_DEVICE_CLASS_EXTERNAL;属性，

1.2.8 多屏异触

多屏异触需要指定主副屏。这里使用修改 Android 源码的方式实现绑定副屏触摸芯片。这样设置以后，系统开机会自动将 ft5x06 触摸绑定到副屏上面去。修改文件：

frameworks/native/services/inputflinger/reader/EventHub.cpp，添加如下加红的代码。通过修改EventHub.cpp 文件，在 isExternalDeviceLocked 函数中判断设备名称为指定的副屏设备（比如副屏的设备名称是 generic ft5x06 (79)），则返回 true。

bool EventHub::isExternalDeviceLocked(Device* device) {

const char *I2C_DEVICE_NAME = "generic ft5x06 (79)";

ALOGE("input deviceis '%s' ",device->identifier.name.c_str());

if (strcmp(device->identifier.name.c_str(), I2C_DEVICE_NAME) == 0) {

return true;

}

if (device->configuration) {

bool value;

if (device->configuration->tryGetProperty(String8("device.internal"), value)) {

return !value;

}

return device->identifier.bus == BUS_USB || device->identifier.bus ==