2023年1月19日 (四) 11:39的版本

产品特点

5寸IPS显示屏，硬件分辨率为800×480
电容式5点触摸控制
钢化玻璃电容触摸面板，硬度达6H
支持Pi 4B/3B+/3A+/3B/2B/B+/A+，部分CM3/3+/4扩展板需另购转接线 DSI-Cable-15cm
直接通过Raspberry Pi的DSI接口驱动LCD，刷新率可达60Hz
配合Raspberry Pi使用时，支持Raspberry Pi OS / Ubuntu / Kali 和 Retropie，免驱
支持通过软件控制背光亮度

搭配树莓派使用

硬件连接

使用FFC线，将5inch DSI LCD连接到Raspberry Pi的DSI接口。
为了方便使用，可以把Raspberry Pi通过螺丝固定的5inch DSI LCD的背面，并组装上铜柱。

如下图所示：

软件设置

用于树莓派的Raspberry Pi OS / Ubuntu / Kali 和 Retropie系统。

1. 请在树莓派官网下载最新版本的镜像。将压缩文件下载到PC上，并解压得到.img文件。

2. TF卡连接到PC，使用SDFormatter软件格式化TF卡。

3. 打开Win32DiskImager软件，选择第1步准备的系统镜像，点击write烧写系统镜像。

4. 烧写完成后，打开TF卡根目录的config.txt文件，在config.txt最后加入以下代码，保存并安全弹出TF卡。

dtoverlay=vc4-kms-v3d
dtoverlay=vc4-kms-dsi-7inch

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

软件调光

微雪提供了对应的应用程序(该程序仅用于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

屏幕休眠

在树莓派终端运行以下指令，屏幕即可进入休眠状态：

xset dpms force off

禁用触摸

在config.txt文件最后，加入以下对应禁用触摸的命令（config文件位于TF卡根目录，也可以通过命令访问：sudo nano /boot/config.txt）：

disable_touchscreen=1

注：添加指令后需重启生效。

FAQ

问题：5inch DSI LCD功耗是多少？

使用5V供电，最大亮度工作电流约为250mA，最小亮度工作电流约150mA。

问题：5inch DSI LCD如何使用PWM控制背光？

默认状态是支持软件调节的，建议查看#背光控制，也可以按以下方法进行PWM控制背光：

如下图，先去掉原来焊接的电阻，在将该电阻的焊盘（左焊盘）连接到树莓派的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电阻：

售后

联系人：陈工
EMAIL：2355742828@qq.com
电话：0755-83043099
QQ：2355742828
微信：扫下方二维码添加

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

@@ 第1行： / 第1行： @@
-<div class="wiki-pages blue-color">
+<div class="wiki-pages pink-color">
-<!--<div class="tabberlive  newwsnav" id="wsnavbar">
+== 产品特点 ==
-<ul class="tabbernav">
+*5寸IPS显示屏，硬件分辨率为800×480
-<li class="nav-link">[[#myintro|说明]]</li>
+*电容式5点触摸控制
-<li class="nav-link">[[#myresources|资料]]</li>
+*钢化玻璃电容触摸面板，硬度达6H
-<li class="nav-link">[[#myfaq|FAQ]]</li>
+*支持Pi 4B/3B+/3A+/3B/2B/B+/A+，部分CM3/3+/4扩展板需另购转接线 [https://www.waveshare.net/shop/DSI-Cable-15cm.htm DSI-Cable-15cm]
-<li class="nav-link">[[#mysupport|售后]]</li>
+*直接通过Raspberry Pi的DSI接口驱动LCD，刷新率可达60Hz
-</ul>
+*配合Raspberry Pi使用时，支持Raspberry Pi OS / Ubuntu / Kali 和 Retropie，免驱
-</div>-->
+*支持通过软件控制背光亮度
-<div class="tabber">
-<div class="tabbertab" title="说明" id="myintro">
-=说明=
-{{外围模块|colorscheme=blue
-|name = 5inch DSI LCD
-|img=<div class="wiki-pages blue-color">
-<div class="tabbertab" title="标准版">[[File:5inch-DSI-LCD-1.jpg|360px |alt=5inch DSI LCD|link=https://{{SERVERNAME}}/shop/5inch-DSI-LCD.htm | 5inch DSI LCD]]</div></div>
-|category1=树莓派LCD
-|category2=电容屏
-|category3=DSI
-|category4=显示屏
-|brand=Waveshare
-|feature = 5寸树莓派电容屏
-|feature-name1= 分辨率
-|feature-value1= 800x480
-|feature-name2= 适用范围
-|feature-value2= 兼容任何版本的树莓派
-| interface1 = DSI
-| Product1 = {{DSI-LCD-Related}}
-}}
-{{5inch-DSI-LCD-Manual}}</div>
-<div class="tabbertab" title="资料" id="myresources">
-<h1>资料</h1>
+== 搭配树莓派使用 ==
+=== 硬件连接 ===
+# 使用FFC线，将5inch DSI LCD连接到Raspberry Pi的DSI接口。
+# 为了方便使用，可以把Raspberry Pi通过螺丝固定的5inch DSI LCD的背面，并组装上铜柱。
+如下图所示：
+: [[File:5inch DSI LCD-B.jpg|600px]]
-==相关资料==
+=== 软件设置 ===
-*[[:File:5inch DSI LCD (B).zip|5inch DSI LCD (B) 3D图纸]]
+用于树莓派的Raspberry Pi OS / Ubuntu / Kali 和 Retropie系统。
-==软件==
+:1. 请在[https://www.raspberrypi.com/software/operating-systems/ 树莓派官网]下载最新版本的镜像。将压缩文件下载到PC上，并解压得到.img文件。
-{{RPI-LCD Software}}
+:2. TF卡连接到PC，使用[https://{{SERVERNAME}}/w/upload/d/d7/Panasonic_SDFormatter.zip SDFormatter]软件格式化TF卡。
-</div>
+:3. 打开[https://{{SERVERNAME}}/w/upload/7/76/Win32DiskImager.zip Win32DiskImager]软件，选择第1步准备的系统镜像，点击write烧写系统镜像。
-<div class="tabbertab" title="FAQ" id="myfaq">
+:4. 烧写完成后，打开TF卡根目录的config.txt文件，在config.txt最后加入以下代码，保存并安全弹出TF卡。
+<syntaxhighlight lang="c">
+dtoverlay=vc4-kms-v3d
+dtoverlay=vc4-kms-dsi-7inch
+</syntaxhighlight>
+:5. 将TF卡插入树莓派，给树莓派上电，正常等待几秒后可以进入显示，系统启动后可以正常触摸。
-<h1>FAQ</h1>
+<!--
+注：在2021年12月2日，树莓派的Raspberry Pi OS分成了两个分支，分别是Buster分支和Bullseye分支。
+其中Buster分支是老系统的延续，更为稳定。Bullseye分支则添加了一些新的功能，使用了开源的库和新的接口。当前Bullseye分支刚发布不久，还不太稳定。
+如果你是工业用户，强烈建议使用Buster分支。
+如果你使用的Buster分支的系统，镜像无需任何改何修改即可正常使用。如果使用的是Bullseye分支的系统，还需要进行以下修改。
+在config.txt文件中注释以下语句（config文件位于TF卡根目录，即/boot中）：
+ #camera_auto_detect=1
+ #dtoverlay=vc4-kms-v3d
+在[all]下方添加以下语句：
+ dtoverlay=vc4-fkms-v3d
+ start_x=1
+保存后重启树莓派即可
+ sudo reboot
+如果你需要在Bullseye分支的系统下使用CSI摄像头。由于该分支默认使用libcamera摄像头库，该库不支持FKMS驱动。
+所以除了上面修改外，还需要安装Raspicam摄像头库。
+安装方法如下：
+在终端运行以下指令：
+ cd ~
+ sudo apt install cmake
+ git clone https://github.com/raspberrypi/userland
+ cd userland
+ ./buildme
+ sudo cp build/bin/* /bin/
+之后执行以下指令关机：
+ poweroff
+在将树莓派摄像头连接到树莓派的CSI接口上，重新给树莓派上电，系统启动后，执行以下命令即可：
+拍照
+ raspistill -o image.jpg
+摄像
+ raspivid -o video.h264 -t 10000
+-->
+{{800*480 DSI LCD软件调光}}
+=== 屏幕休眠 ===
+在树莓派终端运行以下指令，屏幕即可进入休眠状态：
+ xset dpms force off
+=== 禁用触摸 ===
+在config.txt文件最后，加入以下对应禁用触摸的命令（config文件位于TF卡根目录，也可以通过命令访问：sudo nano /boot/config.txt）：
+ disable_touchscreen=1
+注：添加指令后需重启生效。
+<!--
+=== 树莓派长按右键设置 ===
+{{电容屏右键触摸}}
+-->
+=FAQ=
+<!--
 {{FAQ|在2021-10-30-raspios-bullseye-armhf版本的系统配合摄像头使用时会报错？|
 执行以下命令：
 sudo raspi-config -> Advanced Options -> Glamor -> Yes(Enabled) -> Ok -> Finish -> Yes(Reboot)
 |||}}
+{{FAQ|4.3inch DSI LCD在睡眠时会不会自动关闭背光？|
-{{FAQ|5inch DSI LCD最大亮度和最小亮度的工作电流分别是多少？|
+不会
-*使用5V供电  单独树莓派4B  正常工作电流为450mA~500mA
+|||}}
-*使用5V供电  树莓派4B+5inch DSI LCD最大亮度   正常工作电流为700mA~750mA
+{{FAQ|如何控制4.3inch DSI LCD进入休眠模式？|
-*使用5V供电  树莓派4B+5inch DSI LCD最小亮度   正常工作电流为550mA~600mA
+使用'''xset dpms force off'''  和 '''xset dpms force on'''命令来控制屏幕休眠和唤醒
+|||}}
+-->
+{{FAQ|5inch DSI LCD功耗是多少？|
+使用5V供电，最大亮度工作电流约为250mA，最小亮度工作电流约150mA。
 |||}}
+{{FAQ|5inch DSI LCD如何使用PWM控制背光？|
-{{FAQ|5inch DSI LCD可以用外部PWM信号控制背光吗？|
+默认状态是支持软件调节的，建议查看[[#背光控制]]，也可以按以下方法进行PWM控制背光：
-默认状态是支持软件调节的，建议查看[[#背光控制]]，也可以按以下方法焊接PWM控制背光：
 如下图，先去掉原来焊接的电阻，在将该电阻的焊盘（左焊盘）连接到树莓派的P1脚，就可以用GPIO去控制背光。
@@ 第64行： / 第115行： @@
 *gpio -g pwm 18 X（X取值在0~1024之间，0最暗，1024最亮）
-PS:为了保证良好的客户体验，默认出厂最低亮度为可视状态，如需完全关闭背光实现黑屏效果，请将下图100K电阻手动改为68K电阻：
+PS:默认出厂最低亮度为可视状态，如需完全关闭背光实现黑屏效果，可以将下图100K电阻手动改为68K电阻：
 [[File:4.3DSI-brightness-2.png|600px]]
 |||}}

导航菜单

“5inch DSI LCD (B)”的版本间的差异