10.1inch-DSI-TOUCH-A：修订间差异

←上一编辑下一编辑→

可视化wikitext

2026年9月22日 (二) 10:24的版本

[编辑]

产品介绍

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

产品参数

尺寸: 10.1(inch)
SKU: MPI101A
分辨率: 800×1280(dots)
背光亮度：310cd/m2
触摸: 5点电容触摸
触摸屏外形尺寸: 121.11*95.24(mm)
有效显示区域AA区: 108.00*64.80(mm)
包装尺寸: 153*135*51 (mm)
重量(含包装): 259(g)
功耗: 0.30A*5V

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

•Note 1：输入电压超过最大值或操作不当可能会对设备造成永久性损坏。

•Note 2：输入电流需≥0.8A，否则将导致启动失败或者显示异常，长时间处于异常状态可能会对设备造成永久性损坏。

•Note 3：请不要将显示屏长期置于高温高湿的存储环境，显示屏需在极限值范围内工作，否则将可能损坏显示屏。

DSI-22PIN 接口定义

跳转硬件连接页面→

[编辑]

搭配Pi 4B/3B+/3A+/3B/2B/B+/A+使用

1. 使用DSI-Cable-12cm线材，将10.1inch DSI LCD连接到Raspberry Pi主板的22PIN DSI1接口。
2. 使用2PIN电源连接线将LCD的电源接口连接到树莓派主板的5V GND排针。
3. 为了方便使用，可以把Raspberry Pi4通过螺丝固定的10.1inch DSI LCD的背面，并组装上铜柱。如下图所示：

搭配Pi 5/CM4/CM3+/CM3使用

1. 使用DSI-Cable-12cm线材，将7inch DSI LCD连接到Raspberry Pi主板的22PIN DSI1接口。
2. 使用2PIN电源连接线将LCD的电源接口连接到树莓派的40PIN GPIO接口。
3. 为了方便使用，可以把Raspberry Pi 5通过螺丝固定的7inch DSI LCD的背面，并组装上铜柱。如下图所示：

← 返回产品介绍页面

→跳转软件设置页面

[编辑]

用于Bookworm和Bullseye系统

方法一：使用Raspberry Pi Imager烧写最新官方镜像

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

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

2. 镜像烧写完成后，登陆树莓派系统到用户命令行(初始用户名:pi 密码:raspberry)
从GitHub 获取最新驱动(树莓派需连接互联网)
输入以下命令行安装驱动

sudo rm -rf DSI-800x1280
git clone https://github.com/goodtft/DSI-800x1280.git
chmod -R 755 DSI-800x1280
cd DSI-800x1280/
sudo ./DSI-800x1280-show

默认驱动使用I2C0
如果需要DSI0+i2c1，可以使用以下命令行

sudo ./DSI-800x1280-show i2c1 dsi0

方法二：使用预安装镜像

1.选择对应的树莓派版本镜像，下载并解压为.img文件。
树莓派3/4B/CM4/5版本下载：

QD-DSI-7A LCD Bookworm- Pi3/4B/CM4/5预安装镜像

【插入百度盘链接镜像地址】

2.将TF卡连接到PC，使用SDFormatter格式化TF卡。
3.打开Win32DiskImager，选择准备好的系统镜像，点击“Write”开始烧录。
4.烧录完成后，打开TF卡根目录的config.txt文件，找到"[all]"这一行，根据自己的屏幕型号，取消注释相关行，以使能DSI屏，然后保存并安全弹出TF卡。

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

下面以800*480的DSI LCD屏为例：
使用DSI1接口：

#800*480 resolution DSI LCD display
dtoverlay=vc4-kms-dsi-7inch

使用的DSI0接口：

#800*480 resolution DSI LCD display
dtoverlay=vc4-kms-dsi-7inch,dsi0

5.将TF卡插入树莓派，通电启动，等待几秒即可进入系统显示，触控功能也可正常工作。

调节背光亮度

1.打开"Screen Configuration"应用程序；

File:Pi5-mipiDSI-Brightness-0.png

2.进入"Screen"->"DSI-2"->"Brightness" ，勾选您需要设置的背光亮度，最后点击"Apply"，即可完成背光设置。

[[wiki/文件:Pi5-mipiDSI-Brightness.png|Pi5-mipiDSI-Brightness.png]]

QD也提供了对应的应用程序(该程序仅用于Bookworm和Bullseye系统)，用户可以通过以下方式下载安装使用：

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

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

[[wiki/文件:43H-800480-IPS-CT-details-13.gif|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

显示旋转

Bookworm显示旋转

GUI 界面旋转

1.打开"Screen Configuration"应用程序；

[[wiki/文件:DSI-LCD-Bookworm-Rotate-01.png|DSI-LCD-Bookworm-Rotate-01.png]]

2.进入"Screen"->"DSI-1"->"Touchscreen" ，勾选"6-0038 generic ft5x06(79)"

[[wiki/文件:DSI-LCD-Bookworm-Rotate-02.png|DSI-LCD-Bookworm-Rotate-02.png]]

3.单击"Apply"并关闭当前窗口。根据弹出提示重新启动，然后触摸屏选择完成。

[[wiki/文件:DSI-LCD-Bookworm-Rotate-03.png|DSI-LCD-Bookworm-Rotate-03.png]]
[[wiki/文件:DSI-LCD-Bookworm-Rotate-05.png|DSI-LCD-Bookworm-Rotate-05.png]]

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

[[wiki/文件:DSI-LCD-Bookworm-Rotate-04.png|DSI-LCD-Bookworm-Rotate-04.png]] -->
注意：仅Bookworm系统支持以上同步旋转方法。对于Bullseye和Butser系统，显示旋转后，需手动单独设置触摸旋转。

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"应用程序；

[[wiki/文件:DSI-LCD-Bullseye-Rotate-02.png|DSI-LCD-Bullseye-Rotate-02.png]]

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

[[wiki/文件:DSI-LCD-Bullseye-Rotate-03.png|DSI-LCD-Bullseye-Rotate-03.png]][[wiki/文件:DSI-LCD-Bullseye-Rotate-04.png|DSI-LCD-Bullseye-Rotate-04.png]]

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-QD-touch.rules

sudo nano /etc/udev/rules.d/99-QD-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"
类似下图位置：

[[wiki/文件:Touch_roate.jpg|Touch roate.jpg]]
5. 重启树莓派

sudo reboot

完成以上步骤后触摸将会进行旋转。

屏幕休眠

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

xset dpms force off

注：该指令仅适用于Bullseye和Buster系统。

禁用触摸

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

disable_touchscreen=1

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

←返回硬件连接绍页面

→跳转资料页面

[编辑]

问题7inch-dsi-lcd功耗是多少?

5V 500mA

@@ 第113行： / 第113行： @@
 [[File:Raspberry-Pi-Imager-to.gif|680x480px]]
-* 2. 镜像烧写完成后，打开TF卡根目录的config.txt文件，在config.txt最后加入以下代码，保存并安全弹出TF卡。
+* 2. 镜像烧写完成后，登陆树莓派系统到用户命令行(初始用户名:pi 密码:raspberry)
+* 从GitHub 获取最新驱动(树莓派需连接互联网)
+* 输入以下命令行安装驱动
-<pre class="code2highlight lang-c">dtoverlay=vc4-kms-v3d
+<pre class="code2highlight lang-c">sudo rm -rf DSI-800x1280
-#DSI1 Use
+git clone https://github.com/goodtft/DSI-800x1280.git
-dtoverlay=vc4-kms-dsi-7inch
+chmod -R 755 DSI-800x1280
-#DSI0 Use（Only Pi5/CM4）
+cd DSI-800x1280/
-#dtoverlay=vc4-kms-dsi-7inch,dsi0</pre>
+sudo ./DSI-800x1280-show</pre>
-* 3. 将TF卡插入树莓派，给树莓派上电，正常等待几秒后可以进入显示，系统启动后可以正常触摸。
+* 默认驱动使用I2C0
-* <span style="color:#FF0000;">注意：对于树莓派5的Bookworm系统，建议手动更新到最新的系统版本并重启（需在联网状态进行）</span>
+* 如果需要DSI0+i2c1，可以使用以下命令行
-<pre class="code2highlight lang-c">#更新系统
+<pre class="code2highlight lang-c">sudo ./DSI-800x1280-show i2c1 dsi0</pre>
-sudo apt-get update
-sudo apt-get full-upgrade -y
-#重启系统
-sudo reboot</pre>
 === 方法二：使用预安装镜像 ===