产品特性​

• 4 英寸 DSI 触控屏，电容式五点触摸控制
• IPS 显示面板，硬件分辨率为 480×800
• 采用全贴合工艺，画质更清晰
• 钢化玻璃触摸盖板，硬度可达 6H
• DSI 接口驱动 LCD，刷新率可达 60Hz
• 支持通过软件控制背光亮度
• 铝合金背壳设计，纯被动散热设计

电气规格​

• Note 1：输入电压超过最大值或操作不当可能会对设备造成永久性损坏。
• Note 2：输入电流需≥180mA，否则将导致启动失败或者显示异常，长时间处于异常状态可能会对设备造成永久性损坏。
• Note 3：请不要将显示屏长期置于高温高湿的存储环境，显示屏需在极限值范围内工作，否则将可能损坏显示屏。

接口介绍​

外观尺寸​

Pi5/CM5/CM4/CM3+/CM3 硬件连接​

1. 使用"FFC 线 22PIN 200mm （异向） "排线，将显示屏的 DSI 接口连接到树莓派主板的 22PIN DSI 接口。
2. 使用"GPIO 连接线"，将显示屏的电源接口连接到树莓派主板的 5V GND 排针。
   
   
3. 用 M2.5 螺丝将树莓派固定到显示屏上。 安装效果如下：
   
   

Pi4B/3B+/3B/3A+硬件连接​

1. 使用"DSI-Cable-12cm"排线，将显示屏的 DSI 接口连接到树莓派主板的 15PIN DSI 接口。
2. 使用"GPIO 连接线"，将显示屏的电源接口连接到树莓派主板的 5V GND 排针。
   
   
3. 用 M2.5 螺丝将树莓派固定到显示屏上。 安装效果如下：
   
   

软件设置​

烧录最新 Trixie/Bookworm 系统​

1. 将 TF 卡连接到 PC，下载并使用 Raspberry Pi Imager 进行烧录对应系统镜像。

   
   

2. 刷写完成后，将 TF 卡插入树莓派，启动树莓派，并登录树莓派的终端（可以将树莓派连接到 HDMI 显示器，或通过 SSH 远程登录）。

3. 在终端中运行以下命令以安装驱动程序：

   wget https://www.waveshare.net/w/upload/4/46/Panel-waveshare-dsi2-driver.zip
   unzip Panel-waveshare-dsi2-driver.zip
   cd Panel-waveshare-dsi2-driver/panel-waveshare-dsi2-driver
   make
   sudo rm /lib/modules/$(uname -r)/kernel/drivers/regulator/waveshare-panel-regulator.ko.xz
   sudo rm /lib/modules/$(uname -r)/kernel/drivers/gpu/drm/panel/panel-waveshare-dsi-v2.ko.xz
   sudo cp ./waveshare-panel-regulator.ko /lib/modules/$(uname -r)
   sudo cp ./panel-waveshare-dsi-v2.ko /lib/modules/$(uname -r)
   sudo depmod
   sudo modprobe waveshare-panel-regulator
   sudo modprobe panel-waveshare-dsi-v2
   sudo dtc -I dts -O dtb -o vc4-kms-dsi-waveshare-panel-v2.dtbo vc4-kms-dsi-waveshare-panel-v2-overlay.dts
   sudo cp vc4-kms-dsi-waveshare-panel-v2.dtbo /boot/overlays/
   

4. 配置 config.txt 文件

   sudo nano /boot/firmware/config.txt
   

   注意：由于 Pi5/CM5/CM4/CM3+/CM3 具有两个 mipi DSI 接口，请注意使用正确的 DSI 接口和指令，默认推荐使用 DSI1。

   dtoverlay=vc4-kms-v3d
   # DSI1 Use
   dtoverlay=vc4-kms-dsi-waveshare-panel-v2,4_0_inch_a
   # DSI0 Use
   #dtoverlay=vc4-kms-dsi-waveshare-panel-v2,4_0_inch_a,dsi0
   

5. 保存退出，重启系统后，屏幕可以正常显示触摸。

调节背光亮度​

图形界面调光​

以下步骤以 Trixie 系统为例：

1. 点击左上角菜单，依次进入 Preferences → Control Center，选择 Screens

   
   

2. 进入"Screen"->"DSI-2"->"Brightness" ，勾选并调整所需的背光亮度，最后点击 Apply 保存设置。

   
   
   信息

   在 Bookworm 系统中，该设置入口位于 Screen Configuration → Screen。

使用微雪背光调节应用程序​

您也可以使用微雪提供的图形化背光调节工具（该程序仅用于 Trixie，Bookworm 和 Bullseye 系统）：

wget https://www.waveshare.net/w/upload/f/f4/Brightness.zip
unzip Brightness.zip
cd Brightness
sudo chmod +x install.sh
./install.sh

安装完成后，可以在开始菜单-> Accessories -> Brightness 打开该程序，如下图：

使用终端调节背光亮度​

echo X | sudo tee /sys/class/backlight/*/brightness

其中 X 表示 0~255 中的任意数字。0 表示背光最暗，255 表示背光最亮。例如：

echo 100 | sudo tee /sys/class/backlight/*/brightness
echo 0 | sudo tee /sys/class/backlight/*/brightness
echo 255 | sudo tee /sys/class/backlight/*/brightness

Trixie/Bookworm 显示旋转​

GUI 界面旋转​

以下步骤以 Trixie 系统为例：

1. 点击左上角菜单，依次进入 Preferences → Control Center，选择 Screens

   
   

2. 进入"Screen"->"DSI-1"->"Touchscreen"，勾选"10-0014 Goodix Capacitive TouchScreen"

   
   

3. 进入"Screen"->"DSI-2"->"Orientation" ，勾选您需要旋转的方向，最后点击"Apply"即可完成显示和触摸同步旋转。

   
   

lite 版本显示旋转​

sudo nano /boot/firmware/cmdline.txt

在 cmdline.txt 文件开头添加对应显示旋转角度的指令，保存重启后生效。

• 旋转指令

# 显示旋转 90 度
video=DSI-1:480x800M@60,rotate=90

# 显示旋转 270 度
video=DSI-1:480x800M@60,rotate=270

# 显示旋转 180 度
video=DSI-1:480x800M@60,rotate=180

触摸旋转​

如果使用图形界面进行旋转，可以在屏幕布局编辑器窗口中勾选“Touchscreen”来同步触摸旋转。屏幕旋转方法请参考前面的介绍。命令行旋转方法请参考以下文字：

1. 创建一个名为的新文件 99-waveshare-touch.rules

   sudo nano /etc/udev/rules.d/99-waveshare-touch.rules
   

2. 根据需要添加以下行，设定触摸旋转角度的指令，重启后生效。

   # 触摸旋转 90 度
   ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"
   
   # 触摸旋转 270 度
   ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"
   
   # 触摸旋转 180 度
   ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"
   
   # 保存退出并重启：
   sudo reboot
   

触摸模式选择​

Trixie 和 Bookworm 系统支持两种触控模式，可在 Screen Configuration > Touchscreen 菜单中切换：

1. Mouse Emulation（默认）

   • 单击 = 鼠标左键功能
   • 长按 = 鼠标右键功能
   • 支持双击
   • 不支持滑动页面和多点触摸功能

   注：此模式适合需要鼠标操作的场景，如双击打开文件管理器，长按实现右键功能。

2. Multitouch

   • 支持多点触摸功能
   • 支持滑动页面
   • 不支持双击和长按右键功能

   注：此模式适合触控优化场景，如网页浏览、滚动列表。

使用触摸屏虚拟键盘​

从 Raspberry Pi OS Bookworm 版本开始，系统默认集成了 Squeekboard 屏幕键盘。

• 系统会在可输入文字时自动弹出，在不可输入文字时自动隐藏。

• 也可以通过任务栏右上角的键盘图标手动显示或隐藏

  
  

  你也可以通过左上角菜单「Preferences」→「Control Centre」→「Display」来永久设置屏幕键盘的显示或隐藏。

  
  

  在 Bookworm 系统 中，可通过 Raspberry Pi Configuration → Display 或 raspi-config → Display 设置键盘显示或隐藏。

  
  

硬件连接​

屏幕驱动​

ESP32-P4-Module-DEV-KIT 通过** MIPI 2-lane **驱动该屏幕

此屏幕驱动已封装为组件，通过 BSP 进行驱动，组件位置位于 ESP Component Registry

使用 idf.py add-dependency "waveshare/esp32_p4_platform" 来向你的 ESP-IDF 工程中添加组件。

背光控制​

使用配套 FPC 排线、供电线连接 ESP32-P4-Module-DEV-KIT 后，通过 ESP32-P4-Module-DEV-KIT I2C 向屏幕 0x45 设备 0x96 寄存器写入 0x00~0xFF（满亮度）即可控制背光

如果使用 ESP32-P4-Module-DEV-KIT BSP 组件，则可以通过下述函数直接控制

bsp_display_brightness_init();   // 初始化背光

bsp_display_backlight_on();      // 开启背光，默认全亮

bsp_display_backlight_off();     // 关闭背光

bsp_display_brightness_set(95); // 设置具体背光亮度，0~100

技术支持

周一-周五（9:30-6:30）周六（9:30-5:30）

手机：13434470212

邮箱：services04@spotpear.cn

QQ：202004841