Error in widget StyledHeader-WS: Unable to load template 'wiki:StyledHeader-WS'

product presentation

product picture

Product Introduction

10.1-inch DSI touch screen with capacitive 5-point touch
IPS display panel, native hardware resolution of 800×1280
Full lamination process for sharper image quality
Tempered glass touch cover with hardness up to 6H
DSI interface for LCD driving, refresh rate up to 60Hz
Backlight brightness adjustable via software
Metal back cover, pure passive heat dissipation design

Product Specifications

Size: 10.1 inch
SKU: DSI1018
Resolution: 800×1280 dots
Backlight Brightness: 310 cd/m²
Touch: 5-point capacitive touch
Touch Screen Outline Dimension: 241.30 × 160.00 mm
Active Area (AA): 216.55 × 135.36 mm
Package Dimension:
Weight (with package):
Power Consumption:

Parameter	Min	Typ	Max	Unit	Note
Input Voltage	4.75	5.00	5.60	V	Note 1
Input Current	-	0.8	TBD	A	Note 2
Operating Temperature	0	25	60	℃	Note 3
Storage Temperature	-10	25	70	℃	Note 3

•Note 1：Exceeding the maximum input voltage or improper operation may cause permanent damage to the device.

•Note 2：The input current shall be ≥ 0.8 A. Insufficient current will lead to boot failure or display abnormality. Prolonged abnormal operation may result in permanent damage to the device.

•Note 3：Do not store the display screen in a high-temperature and high-humidity environment for a long time. The display must operate within the specified limit values; otherwise, the screen may be damaged.

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的背面，并组装上铜柱。如下图所示：

软件设置

方法一：使用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.点击左上角菜单，依次进入 Preferences → Control Center，选择 Screens

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

您也可以使用我们提供的图形化背光调节工具，(该程序仅用于Bookworm和Bullseye系统)，用户可以输入以下命令行的方式下载安装使用：

wget http://www.lcdwiki.com/res/software/lcd-dsi-brightness-go.zip
unzip lcd-dsi-brightness-go.zip
chmod -R 755 lcd-dsi-brightness-go
cd lcd-dsi-brightness-go
sudo ./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

显示旋转

Bookworm显示旋转

GUI 界面旋转

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

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

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

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

注意：仅Bookworm系统支持以上同步旋转方法。对于Bullseye和Butser系统，显示旋转后，需手动单独设置触摸旋转。

触摸模式选择

Trixie和Bookworm系统支持两种触控模式，可在 Screen Configuration > Touchscreen 菜单中切换：

1.Mouse Emulation（默认）

单击 = 鼠标左键功能
长按 = 鼠标右键功能
支持双击
不支持滑动页面和多点触摸功能

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

2.Multitouch

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

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

资料

10.1inch_IPS_Display_规格书

10.1inch_IPS_Display_产品手册

10.1inch_IPS_Display_尺寸图