7inch DSI LCD (H)

来自Waveshare Wiki
跳转至： 导航、 搜索

产品特性

  • 7英寸DSI触控屏，电容式十点触摸控制
  • IPS显示面板，硬件分辨率为1280×720
  • 钢化玻璃触摸盖板，硬度可达6H
  • 采用全贴合工艺，画质更清晰
  • 采用AF防指纹工艺，不易沾指纹，清洁方便
  • 支持Pi5/CM5/4B/CM4/3B+/3A+/3B/CM3+/CM3
  • 直接通过Raspberry Pi的DSI接口驱动LCD，刷新率可达60Hz
  • 配合Raspberry Pi使用时，兼容Bookworm系统
  • 支持通过软件控制背光亮度

视频教程

电气规格

参数 最小值 标准值 最大值 单位 Note
输入电压 4.75 5.00 5.30 V Note 1
输入电流 - 0.5 TBD A Note 2
工作温度 0 25 60 ℃ Note 3
存储温度 -10 25 70 ℃ Note 3

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

接口简介

7-DSI-TOUCH-A-details-11 (1).jpg

搭配Raspberry Pi 使用

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

1.使用"FFC 线 22PIN 200mm (异向) "排线，将显示屏的DSI接口连接到树莓派主板的22PIN DSI接口。
2.使用"GPIO 连接线"，将显示屏的电源接口连接到树莓派主板的5V GND排针。

Gpio-connection.png 

3.用M2.5螺丝将树莓派固定到显示屏上。

安装效果如下：
7-DSI-TOUCH-A-details-3.jpg

注意：请确保 DSI 排线方向连接无误，并通过 GPIO 引脚提供 5V 电源。

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

1.使用"DSI-Cable-12cm"排线，将显示屏的DSI接口连接到树莓派主板的15PIN DSI接口。
2.使用"GPIO 连接线"，将显示屏的电源接口连接到树莓派主板的5V GND排针。

Gpio-connection.png 

3.用M2.5螺丝将树莓派固定到显示屏上。

安装效果如下：
7-DSI-TOUCH-A-details-3-1.jpg

注意：请确保 DSI 排线方向连接无误，并通过 GPIO 引脚提供 5V 电源。

烧录最新Bookworm系统

1. 将TF卡连接到PC，下载并使用Raspberry Pi Imager进行烧录对应系统镜像。
800x480-DSI-LCD-0.png
2. 镜像烧写完成后，打开TF卡根目录的config.txt文件，在config.txt最后加入以下代码，保存并安全弹出TF卡。

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

dtoverlay=vc4-kms-v3d
# DSI1 Use
dtoverlay=vc4-kms-dsi-waveshare-panel,7_0_inchH
# DSI0 Use
# dtoverlay=vc4-kms-dsi-waveshare-panel,7_0_inchH,dsi0

3. 将TF卡插入树莓派，给树莓派上电，正常等待30秒左右可以进入显示，系统启动后可以正常触摸。

调节背光亮度

图形界面调光

以下步骤以Trixie系统为例:

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

8inch dsi lcd -1.png

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

8inch dsi lcd -2.png

在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 打开该程序，如下图： 43H-800480-IPS-CT-details-13.gif

使用终端调节背光亮度

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

8inch dsi lcd -5.png

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

8inch dsi lcd -6.png

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

8inch dsi lcd -7.png

  • 在Bookworm系统中，该设置入口位于 Screen Configuration → Screen。
注意：仅Trixie/Bookworm系统支持以上同步旋转方法。对于Bullseye/Butser系统，显示旋转后，需手动单独设置触摸旋转。

lite版本显示旋转

sudo nano /boot/firmware/cmdline.txt
#在cmdline.txt文件开头添加对应显示屏的分辨率和旋转角度指令，保存重启后生效
#例如DSI-1显示屏720x1280分辨率，显示旋转90度
video=DSI-1:720x1280e,rotate=90
#例如DSI-1显示屏720x1280分辨率，显示旋转180度
video=DSI-1:720x1280e,rotate=180
#例如DSI-1显示屏720x1280分辨率，显示旋转270度
video=DSI-1:720x1280e,rotate=270

注意：

  • 1.以实际的显示屏分辨率为准。
  • 2.如果是使用Pi5/CM5，以实际识别到的DSI显示器编号为准，例如"DSI-2"。
  • 3.无法使用 cmdline.txt 将 DSI 显示器与 HDMI 显示器分开旋转。当您同时使用 DSI 和 HDMI 时，它们共享相同的旋转值。

触摸旋转

如果使用图形界面进行旋转，可以在屏幕布局编辑器窗口中勾选“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"

#180°：
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"

#270°：
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"

3. 保存并重启 

sudo reboot

触摸模式选择

Trixie和Bookworm系统支持两种触控模式，可在 Screen Configuration > Touchscreen 菜单中切换：
DSI-Touch-Bookworm-Keyboard-04.png

  • 1.Mouse Emulation（默认）
单击 = 鼠标左键功能
长按 = 鼠标右键功能
支持双击
不支持滑动页面和多点触摸功能

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

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

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

使用触摸屏虚拟键盘

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

  • 系统会在可输入文字时自动弹出，在不可输入文字时自动隐藏。
  • 也可以通过任务栏右上角的键盘图标手动显示或隐藏

8inch dsi lcd -3.png
你也可以通过左上角菜单「Preferences」→「Control Centre」→「Display」来永久设置屏幕键盘的显示或隐藏。
8inch dsi lcd -4.png
在 Bookworm 系统 中，可通过 Raspberry Pi Configuration → Display 或 raspi-config → Display 设置键盘显示或隐藏。
DSI-Touch-Bookworm-Keyboard-02.png

  • 提示：

在 Raspberry Pi OS 的 Bookworm 之前的旧版本，请使用 matchbox-keyboard。如果你使用的是 wayfire 桌面合成器，请使用 wvkbd。

搭配ESP32-P4使用

屏幕驱动

101M 8001280 IPS CT K ESP32 P4.jpg

ESP32-P4-NANO通过MIPI 2-lane驱动该屏幕

ESP32-P4-Nano-ETH to WiFi 240925 02.png


  1. 此屏幕驱动已封装为组件，组件位置位于ESP Component Registry
    使用idf.py add-dependency "waveshare/esp_lcd_dsi"来向你的ESP-IDF工程中添加组件。
  2. 你也可以直接查看ESP32-P4-NANO驱动该屏幕的Wiki：ESP32-P4-NANO_MIPI-DSI

背光控制

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

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

bsp_display_brightness_init();   // 初始化背光

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

bsp_display_backlight_off();     // 关闭背光

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


ESP32-P4-Nano-I2C 240906 01.png

资料

3D图纸

2D图纸

FAQ

问题：如何替换树莓派开机logo图片？

将自定义图片替换此目录的图片即可 /usr/share/plymouth/themes/pix/splash.png


售后

联系人：梁工
电话：0755-83043099
微信：扫下方二维码添加
Ljh.png

说明：进行售后服务前，请准备好客户信息（定货单位、定货人等），以供验证

取自“https://www.waveshare.net/w/index.php?title=7inch_DSI_LCD_(H)&oldid=134048”