4.3inch DSI LCD
产品特点
- 4.3寸IPS显示屏,硬件分辨率为800×480
- 电容式5点触摸控制
- 钢化玻璃电容触摸面板,硬度达6H
- 支持Pi5/CM5/4B/CM4/3B+/3A+/3B/CM3/CM3+/2B/B+/A+
- 直接通过Raspberry Pi的DSI接口驱动LCD,刷新率可达60Hz
- 配合Raspberry Pi使用时,支持Raspberry Pi OS / Ubuntu / Kali / Volumio 和 Retropie,免驱
- 配合VisionFive2使用时,支持Debian,单点触控,免驱
- 配合Tinker Board 2使用时,支持Linux/Android,五点触控,免驱
- 配合Core3566使用时,支持Debian/Ubuntu,五点触控,免驱
- 支持通过软件控制背光亮度
视频教程
接口定义
| PIN | 标志 |
|---|---|
| 1 | GND |
| 2 | DSI1_DN1 |
| 3 | DSI1_DP1 |
| 4 | GND |
| 5 | DSI1_CN |
| 6 | DSI1_CP |
| 7 | GND |
| 8 | DSI1_DN0 |
| 9 | DSI1_DP0 |
| 10 | GND |
| 11 | SCL0 |
| 12 | SDA0 |
| 13 | GND |
| 14 | 3V3 |
| 15 | 3V3 |
硬件连接
搭配Pi 5/CM5/CM4/CM3+/CM3使用使用
- 使用DSI-Cable-12cm线材,将4.3inch DSI LCD连接到Raspberry Pi主板的22PIN DSI1接口。
- 为了方便安装,可将 Raspberry Pi 5 固定在 4.3inch DSI LCD 背面。
在组装时,请在屏幕与主板之间垫上配件包内的短铜柱,再用螺丝固定,如下图所示:
搭配Pi 4B/3B+/3A+/3B/2B/B+/A+使用
- 使用FFC线,将4.3inch DSI LCD连接到Raspberry Pi主板的15PIN DSI接口。
- 为了方便使用,可以把Raspberry Pi主板通过螺丝固定的4.3inch DSI LCD的背面,并组装上铜柱。
在组装时,请在屏幕与主板之间垫上配件包内的短铜柱,再用螺丝固定,如下图所示:
软件设置
用于Trixie和Bookworm系统
用于树莓派的Raspberry Pi OS / Ubuntu / Kali / Volumio 和 Retropie系统。
- 1. 将TF卡连接到PC,下载并使用Raspberry Pi Imager进行烧录对应系统镜像。
- 2. 镜像烧写完成后,打开TF卡根目录的config.txt文件,在config.txt最后加入以下代码,保存并安全弹出TF卡。
dtoverlay=vc4-kms-v3d #DSI1 Use dtoverlay=vc4-kms-dsi-7inch #DSI0 Use #dtoverlay=vc4-kms-dsi-7inch,dsi0
- 3. 将TF卡插入树莓派,给树莓派上电,正常等待几秒后可以进入显示,系统启动后可以正常触摸。
#更新系统 sudo apt-get update sudo apt-get full-upgrade -y #重启系统 sudo reboot
调节背光亮度
图形界面调光
以下步骤以Trixie系统为例:
- 1.点击左上角菜单,依次进入 Preferences → Control Center,选择 Screens;
- 2.进入"Screen"->"DSI-2"->"Brightness" ,勾选并调整所需的背光亮度,最后点击 Apply 保存设置。。
使用微雪背光调节应用程序
您也可以使用微雪提供的图形化背光调节工具(该程序仅用于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"即可完成显示和触摸同步旋转。
- 在Bookworm系统中,该设置入口位于 Screen Configuration → Screen。
lite版本显示旋转
- 1.需要修改/boot/cmdline.txt文件:
sudo nano /boot/cmdline.txt
- 2.在cmdline.txt文件开头,添加对应显示旋转角度的指令:(请注意,该命令需要放在同一行上,每个命令用空格分隔。)
video=DSI-1:800x480M@60,rotate=90
通过将rotate值更改为 90、180 或 270 来更改显示旋转的角度。
- 3.保存并重新启动
sudo reboot
Bullseye/Buster显示旋转
GUI 界面旋转
- 1.打开"Screen Configuration"应用程序;
- 2.进入"Screen"->"DSI-1"->"Orientation" ,勾选您需要旋转的方向,最后点击"Apply",即可完成显示旋转。
lite版本显示旋转
- 1.需要修改/boot/cmdline.txt文件:
sudo nano /boot/cmdline.txt
- 2.在cmdline.txt文件开头,添加对应显示旋转角度的指令:(请注意,该命令需要放在同一行上,每个命令用空格分隔。)
video=DSI-1:800x480M@60,rotate=90
通过将rotate值更改为 90、180 或 270 来更改显示旋转的角度。
- 3.保存并重新启动
sudo reboot
Stretch/Jessie显示旋转
对于一些比较古老的系统,它们不使用vc4-kms-v3d 或 vc4-fkms-v3d 驱动模式,显示旋转方法如下
- 1. 在config.txt文件中加入语句(config文件位于TF卡根目录,即/boot中):
display_rotate=1 #1:90;2: 180; 3: 270
- 2. 保存后重启树莓派即可
sudo reboot
触摸旋转
Bookworm 触摸
如果使用图形界面进行旋转,可以在屏幕布局编辑器窗口中勾选“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
Bullseye/Buster 触摸
部分系统显示旋转后,触摸方向不一致,需要按下文操作进行触摸旋转:
1. 安装libinput
sudo apt-get install xserver-xorg-input-libinput
- 如果你安装的是Ubuntu系统,或者是Jetson Nano。安装指令为
sudo apt install xserver-xorg-input-synaptics
2. 在/etc/X11/下创建xorg.conf.d目录 (如果该目录已存在,这直接进行第3步)
sudo mkdir /etc/X11/xorg.conf.d
3. 复制40-libinput-conf 文件到刚刚创建的目录下
sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/
4. 编辑该文件
sudo nano /etc/X11/xorg.conf.d/40-libinput.conf
#找到 touchscreen的部分,在里面添加对应的旋转角度指令,然后保存即可 #90°Right触摸旋转: Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1" #180° Inverted触摸旋转: #Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1" #270° Left旋转: #Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1" 类似下图位置:
sudo reboot
完成以上步骤后触摸将会进行旋转。
资料
相关资料
软件
FAQ
使用树莓派DSI接口供电,功耗约1.2W左右。
370cd/m²
14.05mm
默认状态是支持软件调节的,建议查看#调节背光亮度,也可以按以下方法进行PWM控制背光:
Rev2.1版本:
如下图,先去掉原来焊接的电阻,在将该电阻的焊盘(左焊盘)连接到树莓派的P1脚,就可以用GPIO去控制背光。
- gpio -g pwm 18 0
- gpio -g mode 18 pwm (占用管脚为PWM管脚)
- gpio pwmc 1000
- 控制亮度:
- gpio -g pwm 18 X(X取值在0~1024之间,0最暗,1024最亮)
PS:默认出厂最低亮度为可视状态,如需完全关闭背光实现黑屏效果,可以将下图100K电阻手动改为68K电阻:
![]()
Rev2.2版本:
如下图,先去掉原来焊接的电阻,在将该电阻的焊盘(左焊盘)连接到树莓派的P1脚,就可以用GPIO去控制背光。
![]()
PS:默认出厂最低亮度为可视状态,如需完全关闭背光实现黑屏效果,可以将下图100K电阻手动改为68K电阻:
![]()
取决于系统,如果系统有休眠,那屏幕也会黑屏。
在使用 Wayland 环境(如 Raspberry Pi OS Trixie 或 Bookworm)时,可通过 wlr-randr 命令来控制屏幕显示状态。
#关闭屏幕 wlr-randr --output DSI-2 --off #打开屏幕 wlr-randr --output DSI-2 --on




