产品特性
- 10.1 英寸 DSI 触控屏，电容式十点触摸控制
- IPS 显示面板，硬件分辨率为 1280×800
- 采用全贴合工艺，画质更清晰
- 钢化玻璃触摸盖板，硬度可达 6H
- 支持 Pi5/4B/CM4/3B+/3A+/3B/CM3+/CM3
- 直接通过 Raspberry Pi 的 DSI 接口驱动 LCD，刷新率可达 60Hz
- 配合 Raspberry Pi 使用时，支持 Bookworm/Bullseye/Buster 使用
- 支持通过软件控制背光亮度
硬件连接
搭配 Pi4B/3B+/3B/3A+使用
1. 使用 15PIN 的 FPC 排线，将显示屏 DSI 接口连接到树莓派主板的 DSI 接口。 2. 树莓派背面朝下安装到显示屏底板上，并通过 4PIN 顶针连通 5V 供电和 I2C 通信。
- 安装效果如下：**
File:8inch-DSI-LCD-C-wiki-1.jpg
搭配 Pi5/CM4/CM3+/CM3 使用
1. 使用“DSI-Cable-12cm”排线，将显示屏 DSI 接口连接到树莓派主板的 22PIN DSI1 接口。 2. 树莓派背面朝下安装到显示屏底板上，并通过 4PIN 顶针连通 5V 供电和 I2C 通信。
- 安装效果如下：**
File:10.1inch DSI LCD (C)-Pi-5.jpg
-Pi-5.jpg){kind=link}
软件设置
用于 Bookworm 和 Bullseye 系统
- 1. 将 TF 卡连接到 PC，下载并使用Raspberry Pi Imager进行烧录对应系统镜像。
- 2. 镜像烧写完成后，打开 TF 卡根目录的 config.txt 文件，在 config.txt 最后加入以下代码，保存并安全弹出 TF 卡。
注意：由于 Pi5/CM4/CM3+/CM3 具有两个 mipi DSI 接口，请注意使用正确的 DSI 接口和指令，默认推荐使用 DSI1。dtoverlay=vc4-kms-v3d
#DSI1 Use
dtoverlay=vc4-kms-dsi-QDTFT-panel,10_1_inch
#DSI0 Use
#dtoverlay=vc4-kms-dsi-QDTFT-panel,10_1_inch,dsi0
- 3. 将 TF 卡插入树莓派，给树莓派上电，正常等待几秒后可以进入显示，系统启动后可以正常触摸。
用于 Buster 系统
方法一：手动安装驱动
1. 在树莓派官网下载最新版本的镜像，将压缩文件下载到 PC 上，并解压得到.img 文件。 2. TF 卡连接到 PC，使用SDFormatter软件格式化 TF 卡。 3. 打开Win32DiskImager软件，选择第 1 步准备的系统镜像，点击 write 烧写系统镜像。 4. 烧写完成后，将 TF 卡接入到树莓派上，并启动树莓派，登录树莓派的终端（可以将树莓派接到 HDMI 显示器或用 ssh 远程登录）。
#第一步：下载并进入 QDTFT-DSI-LCD 驱动文件夹
git clone https://github.com/QDTFT/QDTFT-DSI-LCD
cd QDTFT-DSI-LCD
#第二步：终端输入 uname -a 查看内核版本，并 cd 到对应文件目录
#6.1.21 则运行下面指令
cd 6.1.21
#第三步：请确定当前使用的系统是多少位的，32 位系统进入 32 目录，64 位系统进入 64 目录
cd 32
#cd 64
#第四步：输入您对应的型号指令进行安装驱动，注意 I2C 拨码开关的选择
#10.1inch DSI LCD (C) 1280×800 驱动：
sudo bash ./WS_xinchDSI_MAIN.sh 101C I2C0
#第五步：等待几秒，当驱动安装完成，没有提示任何报错时，进行重启加载 DSI 驱动即可正常使用
sudo reboot
#注意：以上步骤需要确保树莓派可以正常连接到互联网。5. 等待系统重启，将可以正常显示和触摸。
方法二：烧写预安装镜像
1. 选择您对应的树莓派版本镜像，下载并解压为.img 文件
- 树莓派 4B/CM4 版本下载：**QDTFT DSI LCD - Pi4 预安装镜像
- 树莓派 3B/3B+/CM3 版本下载：**QDTFT DSI LCD - Pi3 预安装镜像
2. TF 卡连接到 PC，使用SDFormatter软件格式化 TF 卡。 3. 打开Win32DiskImager软件，选择第 1 步准备的系统镜像，点击 write 烧写系统镜像。 4. 烧写完成后，打开 TF 卡根目录的 config.txt 文件，在[all]下方加入以下代码，保存并安全弹出 TF 卡。
dtoverlay=WS_xinchDSI_Screen,SCREEN_type=8,I2C_bus=10
dtoverlay=WS_xinchDSI_Touch,invertedx,swappedxy,I2C_bus=10
5. 将 TF 卡接入到树莓派上，并启动树莓派，等待 30 秒左右即可正常显示和触摸。
Buster 系统注意事项
1. 更新系统，如执行以下命令
sudo apt-get update
sudo apt-get full-upgrade注意：在更新完系统后，原本安装的驱动有些文件可能会被覆盖掉，需要重新安装驱动才可以正常显示。 2. 更换主板 如果原来在 Raspberry Pi 4 Model B 上安装的驱动，用户更换主板，如修改成 Raspberry Pi 3 Model B+，会导致显示屏无法正常显示。 因为 Pi4 和 Pi3 需要加载不同的驱动文件，需在新的主板上按照[#用于Buster系统]重新安装驱动才可以正常显示。
调节背光亮度
- 1. 打开"Screen Configuration"应用程序；
File:Pi5-mipiDSI-Brightness-0.png
- 2. 进入"Screen" -> "DSI-2" -> "Brightness" ，勾选您需要设置的背光亮度，最后点击"Apply"，即可完成背光设置。
File:Pi5-mipiDSI-Brightness.png
微雪也提供了对应的应用程序(该程序仅用于 Bookworm 和 Bullseye 系统)，用户可以通过以下方式下载安装使用：
wget https://www.QDTFT.net/w/upload/f/f4/Brightness.zip
unzip Brightness.zip
cd Brightness
sudo chmod +x install.sh
./install.sh安装完成后，可以在开始菜单 -》Accessories -》Brightness 打开该程序，如下图：
File: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/*/brightnessBookworm 触摸屏旋转
- 1. 打开"Screen Configuration"应用程序；
File:DSI-LCD-Bookworm-Rotate-01.png
- 2. 进入"Screen" -> "DSI-1" -> "Touchscreen"，勾选"10-0014 Goodix Capacitive TouchScreen"
- 3. 点击"Apply"，然后关闭当前窗口，根据弹窗提示进行 Reboot，即可完成指定触摸屏；
File:DSI-LCD-Bookworm-Rotate-03.png File:DSI-LCD-Bookworm-Rotate-05.png
- 4. 进入"Screen" -> "DSI-1" -> "Orientation" ，勾选您需要旋转的方向，最后点击"Apply"即可完成显示和触摸同步旋转。
File:DSI-LCD-Bookworm-Rotate-04.png
- 注意：仅 Bookworm 系统支持以上同步旋转方法。对于 Bullseye 和 Butser 系统，显示旋转后，需手动单独设置触摸旋转。**
Bullseye/Buster 显示旋转
- 1. 打开"Screen Configuration"应用程序；
File:DSI-LCD-Bullseye-Rotate-02.png
- 2. 进入"Screen" -> "DS-1" -> "Orientation" ，勾选您需要旋转的方向，最后点击"Apply"，即可完成显示旋转。
File:DSI-LCD-Bullseye-Rotate-03.png File:DSI-LCD-Bullseye-Rotate-04.png
Bullseye/Buster 触摸旋转
sudo nano /boot/config.txt
#在 config.txt 文件末端修改触摸旋转角度的指令，重启后生效（默认存在 0°触摸方向的指令）
#0°：
dtoverlay=WS_xinchDSI_Touch,invertedx,swappedxy
#90°：
dtoverlay=WS_xinchDSI_Touch,invertedx,invertedy
#180°：
dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy
#270°：
dtoverlay=WS_xinchDSI_Touch
lite 版本显示旋转
sudo nano /boot/cmdline.txt
#在 cmdline.txt 文件开头添加对应显示旋转角度的指令，保存重启后生效
#显示旋转 90 度
video=DSI-1:1280x800M@60,rotate=90
#显示旋转 180 度
video=DSI-1:1280x800M@60,rotate=180
#显示旋转 270 度
video=DSI-1:1280x800M@60,rotate=270屏幕休眠
在树莓派终端运行以下指令，屏幕即可进入休眠状态：
xset dpms force off禁用触摸
在 config.txt 文件最后，加入以下对应禁用触摸的命令（config 文件位于 TF 卡根目录，也可以通过命令访问：sudo nano /boot/config.txt）：
disable_touchscreen=1注：添加指令后需重启生效。
资料
FAQ
- 问题：10.1inch DSI LCD (C) 功耗是多少？
- 使用 5V 供电，开背光工作电流约为 520mA，关背光工作电流约 150mA。
- 问题：如何替换树莓派开机 logo 图片？
- 将自定义图片替换此目录的图片即可 /usr/share/plymouth/themes/pix/splash.png