12.3-DSI-TOUCH-A
产品简介
12.3-DSI-TOUCH-A 是一款纵向触摸屏 LCD 显示器,专为平板电脑、娱乐系统和信息仪表板等交互式项目而设计。
产品特性
- 12.3英寸DSI触控屏,电容式十点触摸控制
- IPS显示面板,硬件分辨率为720×1920
- 采用全贴合工艺,画质更清晰
- 钢化玻璃触摸盖板,硬度可达6H
- DSI接口驱动LCD,刷新率可达60Hz
- 支持通过软件控制背光亮度
- 全金属背板设计,纯被动散热设计
电气规格
| 参数 | 最小值 | 标准值 | 最大值 | 单位 | Note |
| 输入电压 | 4.75 | 5.00 | 5.25 | V | Note 1 |
| 输入电流 | - | 1 | TBD | A | Note 2 |
| 工作温度 | 0 | 25 | 60 | ℃ | Note 3 |
| 存储温度 | -10 | 25 | 70 | ℃ | Note 3 |
•Note 1:输入电压超过最大值或操作不当可能会对设备造成永久性损坏。
•Note 2:输入电流需≥1A,否则将导致启动失败或者显示异常,长时间处于异常状态可能会对设备造成永久性损坏。
•Note 3:请不要将显示屏长期置于高温高湿的存储环境,显示屏需在极限值范围内工作,否则将可能损坏显示屏。
接口简介
Raspberry Pi使用说明
Pi5/CM5 硬件连接
1.使用"FFC 线 22PIN 200mm (异向) "排线,将显示屏的DSI接口连接到树莓派主板的22PIN DSI接口。 2.使用"GPIO 连接线",将显示屏的电源接口连接到树莓派主板的5V GND排针。
3.用M2.5螺丝将树莓派固定到显示屏上。
注意:请确保 DSI 排线方向连接无误,并通过 GPIO 引脚提供 5V 电源。
软件设置
方法一:烧录最新Trixie和Bookworm系统(推荐)
1. 将TF卡连接到PC,下载并使用Raspberry Pi Imager进行烧录对应系统镜像。

2. 镜像烧写完成后,打开TF卡根目录的config.txt文件,在config.txt最后加入以下代码,保存并安全弹出TF卡。
注意:由于Pi5/CM5/CM4/CM3+/CM3具有两个mipi DSI接口,请注意使用正确的DSI接口和指令,默认推荐使用DSI1。
dtoverlay=vc4-kms-v3d #DSI1 Use dtoverlay=vc4-kms-dsi-waveshare-panel-v2,12_3_inch_a_4lane #DSI0 Use # dtoverlay=vc4-kms-dsi-waveshare-panel-v2,12_3_inch_a_4lane,dsi0
3. 将TF卡插入树莓派,给树莓派上电,正常等待30秒左右可以进入显示,系统启动后可以正常触摸。
方法二:烧写预安装镜像
1. 选择预安装镜像,下载并解压为.img文件
2. 烧写完成后,将TF卡接入到树莓派上,并启动树莓派,等待30秒左右即可正常显示和触摸。
Luckfox-Omni3576 使用说明
硬件连接
1. 使用22PIN的FPC排线,将显示屏DSI接口连接到Omni3576主板的DSI接口。
2. 使用2PIN电源连接线,将显示屏的电源接口连接到Omni3576主板的40PIN GPIO接口。如下图所示:
软件设置
屏幕的设备树文件位于 SDK 目录下:
sysdrv/source/kernel/arch/arm64/boot/dts/rockchip/rv1126b-luckfox-aura-dsi.dtsi
查看屏幕信息
当前系统中可用的屏幕 ID 可通过以下命令查看:
cat /sys/kernel/debug/dri/0/summary
输出示例:
VOP [ff600000.vop]: ACTIVE
Connector: DSI-1
bus_format[100a]: RGB888_1X24
overlay_mode[0] output_mode[0]color-encoding[1] color-range[1]
Display mode: 800x1280p60
dclk[70000 kHz] real_dclk[69475 kHz] aclk[294912 kHz] type[48] flag[a]
H: 800 840 860 880
V: 1280 1310 1314 1324
win1-0: ACTIVE
format: XR24 little-endian (0x34325258) SDR[0] color-encoding[0] color-range[0]
csc: y2r[0] r2r[0] r2y[0] csc mode[0]
zpos: 0
src: pos[0x0] rect[800x1280]
dst: pos[0x0] rect[800x1280]
buf[0]: addr: 0x06100000 pitch: 3200 offset: 0
post: sdr2hdr[0] hdr2sdr[0]
pre : sdr2hdr[0]
post CSC: r2y[0] y2r[0] CSC mode[2]
显示测试
使用 modetest 进行彩条测试,以验证显示输出。
查看 Connector ID
执行以下命令:
modetest -M rockchip | grep -A10 "Connectors:"
输出示例:
Connectors:
id encoder status name size (mm) modes encoders
96 95 connected DSI-1 216x135 1 95
modes:
index name refresh (Hz) hdisp hss hse htot vdisp vss vse vtot
#0 800x1280 60.08 800 840 860 880 1280 1300 1304 1324 70000 flags: nhsync, nvsync; type: preferred, driver
props:
1 EDID:
flags: immutable blob
blobs:
- Connector ID = 96
- Encoder ID = 95
查看 CRTC ID
执行以下命令:
modetest -M rockchip | grep -A10 "CRTCs:"
输出示例:
CRTCs:
id fb pos size
73 99 (0,0) (800x1280)
#0 800x1280 60.08 800 840 860 880 1280 1300 1304 1324 70000 flags: nhsync, nvsync; type: preferred, driver
props:
24 VRR_ENABLED:
flags: range
values: 0 1
value: 0
39 ACLK:
flags: range
- CRTC ID = 73
竖条测试
使用标准模式进行竖条测试:
modetest -M rockchip -s [Connector ID]@[CRTC ID]:[分辨率]
例如,800×1280 分辨率:
modetest -M rockchip -s 96@73:800x1280
斜条测试
启用 tile 格式进行斜条测试:
modetest -M rockchip -s [Connector ID]@[CRTC ID]:[分辨率] -Ftiles
例如,800×1280 分辨率:
modetest -M rockchip -s 96@73:800x1280 -Ftiles
注意:上述 Connector ID、CRTC ID 和分辨率仅为示例,实际测试时请根据设备查询结果进行调整。
触摸测试
使用 evtest 命令进行触摸屏测试,检查触摸输入设备的响应。
执行以下命令:
evtest
正常情况下会显示类似以下的输出:
No device specified, trying to scan all of /dev/input/event* Available devices: /dev/input/event0: 2-005d Goodix Capacitive TouchScreen Select the device event number [0-0]:
输入 0 并按回车键,随后触摸屏幕,终端会打印触摸操作触发的事件数值。
背光控制
其他适配屏幕共用同一个驱动,支持 0~255 级背光亮度调节。
背光控制命令:
# brightness level: 0 ~ 255 echo <brightness level> > /sys/class/backlight/waveshare_bl/brightness
例如,将背光亮度设置为 128:
echo 128 > /sys/class/backlight/waveshare_bl/brightness
将背光亮度设置为最大值:
echo 255 > /sys/class/backlight/waveshare_bl/brightness
关闭背光:
echo 0 > /sys/class/backlight/waveshare_bl/brightness
显示旋转
- 旋转指令
#旋转90度 xrandr -o left #旋转270度 xrandr -o right #旋转180度 xrandr -o inverted #旋转0度 xrandr -o normal
- 使用 xrandr 旋转的效果是一次性的,系统重启后屏幕显示方向会还原。 如果要开机自动旋转,则需要修改配置文件:
sudo vim /etc/X11/xorg.conf.d/10-monitor.conf
添加以下语句:
### Valid values for rotation are "normal", "left", "right"
Section "Monitor"
# Identifier "Default Monitor"
Identifier "DSI-1"
Option "Rotate" "left"
EndSection
触摸旋转
- 系统显示旋转后,触摸方向不一致,需要按下文操作进行触摸旋转:
sudo vim /etc/udev/rules.d/99-luckfox-touch.rules
- 根据自己的旋转方向,加入对应的配置,保存后重启开发板。
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"
安全说明
为避免本产品发生故障或损坏,请遵守以下事项:
- 连接设备前,请关闭您的 Raspberry Pi 计算机并断开外部电源。
- 如果线缆脱落,请将连接器上的锁定装置向前拉,将带状线缆插入,金属触点朝向您,然后将锁定装置推回原位。
- 本设备应在 0–60°C 的干燥环境中操作。
- 操作时,请勿将设备暴露在水中或潮湿环境中,也不要将其放置在导电表面上。
- 请勿将其暴露在任何过热源的环境中。
- 应注意不要折叠或拉紧带状线缆。
- 拧入零件时应小心。螺纹错位可能会造成无法修复的损坏,并使保修失效。
- 搬运时请小心,避免对印刷电路板和连接器造成机械或电气损坏。
- 存放在阴凉干燥处。
- 避免温度急剧变化,否则会导致设备内积聚湿气。
- 显示屏表面易碎,有可能破碎。
图纸
FAQ
售后
联系人:梁工
电话:0755-83043099
微信:扫下方二维码添加
![]()
