8inch DSI LCD (with cam)
产品特点
- 8寸电容触摸屏,硬件分辨率为800×480
- 电容式5点触摸控制
- 钢化玻璃电容触摸面板,硬度达6H
- OV5647摄像头,500W像素,对角视场角72.9°,分辨率为2592×1944
- 支持Pi5/4B/CM4/3B+/3A+/3B/CM3/CM3+/2B/B+/A+
- 直接通过Raspberry Pi的DSI接口驱动LCD,刷新率可达60Hz
- 直接通过Raspberry Pi的CSI接口驱动摄像头,视频帧率支持1920×1080p@30,1280×720p@60,640×480p@60,640×480p@90
- 配合Raspberry Pi使用时,支持Raspberry Pi OS / Ubuntu / Kali 和 Retropie,免驱
- 支持通过软件控制背光亮度
特色设计
1. LCD FFC 线抗干扰设计,工业使用更稳定。
2. VCOM电压调节电阻,可调节VCOM电压,以达到最佳的显示效果。
3. 可使用顶针进行供电,减少繁琐的接线。
4. 2 种形式的 5V 电源输出接口,方便用户接散热风扇或给其他小功率设备供电。
5. 带有OV5647摄像头,500W像素,对角视场角72.9°,分辨率为2592×1944
6. 大盖板设计,方便设计外壳,易于嵌入各种设备中。
7. 贴片螺母支撑与固定主板,结构更紧凑。
硬件连接
搭配Pi 4B/3B+/3A+/3B/2B/B+/A+使用
1. 使用15PIN的FPC排线,将显示屏接口连接到Raspberry Pi的DSI接口。
2. 使用15PIN的FFC排线,将摄像头接口连接到Raspberry Pi的CSI接口。
3. 为了方便使用,可以把Raspberry Pi通过螺丝固定到显示屏的背面。
安装效果如下图所示:(树莓派将通过顶针给LCD供电)
搭配Pi 5/CM4/CM3+/CM3使用使用
1. 使用DSI-Cable-12cm线材,将显示屏接口连接到Raspberry Pi主板的22PIN DSI1接口。
2. 使用Pi5-Camera-Cable线材,将摄像头接口连接到Raspberry Pi主板的22PIN CSI0接口。
3. 使用2PIN电源连接线将LCD的电源接口连接到树莓派的40PIN GPIO接口。
4. 为了方便使用,可以把Raspberry Pi 5通过螺丝固定的8inch DSI LCD的背面,并组装上铜柱。如下图所示:
软件设置
Raspberry Pi OS镜像烧录
用于树莓派的Raspberry Pi OS / Ubuntu / Kali 和 Retropie系统。
- 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 dtoverlay=ov5647 #DSI1 Use dtoverlay=vc4-kms-dsi-7inch #DSI0 Use #dtoverlay=vc4-kms-dsi-7inch,dsi0
- 3. 将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
Bookworm显示旋转
GUI 界面旋转
- 1.打开"Screen Configuration"应用程序;
- 2.进入"Screen"->"DSI-1"->"Touchscreen" ,勾选"6-0038 generic ft5x06(79)"
- 3.单击"Apply"并关闭当前窗口。根据弹出提示重新启动,然后触摸屏选择完成。
- 4.进入"Screen"->"DSI-1"->"Orientation" ,勾选您需要旋转的方向,最后点击“Apply”,即可完成显示屏和触摸的同步旋转。
-->
注意:仅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
显示旋转
Bookworm显示旋转
GUI 界面旋转
- 1.打开"Screen Configuration"应用程序;
- 2.进入"Screen"->"DSI-1"->"Touchscreen" ,勾选"6-0038 generic ft5x06(79)"
- 3.单击"Apply"并关闭当前窗口。根据弹出提示重新启动,然后触摸屏选择完成。
- 4.进入"Screen"->"DSI-1"->"Orientation" ,勾选您需要旋转的方向,最后点击“Apply”,即可完成显示屏和触摸的同步旋转。
-->
注意:仅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"应用程序;
- 2.进入"Screen"->"DSI-1"->"Orientation" ,勾选您需要旋转的方向,最后点击"Apply",即可完成显示旋转。
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-waveshare-touch.rules
sudo nano /etc/udev/rules.d/99-waveshare-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" 类似下图位置:
sudo reboot
完成以上步骤后触摸将会进行旋转。
屏幕休眠
在树莓派终端运行以下指令,屏幕即可进入休眠状态:
xset dpms force off
禁用触摸
在config.txt文件最后,加入以下对应禁用触摸的命令(config文件位于TF卡根目录,也可以通过命令访问:sudo nano /boot/config.txt):
disable_touchscreen=1
注:添加指令后需重启生效。
使用摄像头
如果你不清楚Raspberry Pi OS的两个分支的差别,可以查看以下介绍#Raspberry Pi OS分支介绍
Raspberry Pi OS Bookworm和Bullseye分支
在该分支中,默认使用libcamera相机子系统接口。并且摄像头接口默认是打开的。
可以使用以下命令控制摄像头:
#libcamera-hello是一个简单的"hello world" 程序,主要是启动摄像头预览功能,并显示到屏幕上。 libcamera-hello //大约显示5秒左右的预览窗口 libcamera-hello -t 0 //可以长时间显示预览窗口,使用ctrl+c结束 #libcamera-jpeg是一个简单的应用程序,运行预览窗口,然后获取高分辨率静止图像。 libcamera-jpeg -o test.jpg //大约显示5秒左右的预览窗口,然后将完整分辨率的JPEG图像保存到test.jpg #libcamera-still是一个更复杂的静态图像捕捉应用程序,主要为了模拟raspistill libcamera-still -o test.jpg //约显示5秒左右的预览窗口,然后图像保存到test.jpg #libcamera-vid是一个视频拍摄应用程序。默认使用Raspberry Pi的硬件H.264编码器。 libcamera-vid -t 10000 -o test.h264 //将10秒的视频保存到test.h264 vlc test.h264 //可以使用vlc播放生成的文件 #libcamera-raw直接从传感器捕获原始帧的基本应用程序,不显示预览窗口。 libcamera-raw -t 2000 -o test.raw //将2秒的视频保存到test.raw
更详细信息可查看: libcamera与libcamera-apps
注:在有些主板上,使用libcamera报错,可以尝试执行以下命令
sudo raspi-config -> Advanced Options -> Glamor -> Yes(Enabled) -> Ok -> Finish -> Yes (Reboot)
Raspberry Pi OS buster分支与Ubuntu
在这些系统中默认使用raspicam相机子系统接口。在Ubuntu中摄像头接口默认是打开的。在Raspberry Pi OS buster分支中,需要执行以下命令打开摄像头接口
sudo raspi-config -> Interface Options -> Camera -> Yes -> OK -> Finish -> Yes (Reboot)
可以使用以下命令控制摄像头:
#raspistill是一个运行预览窗口,然后获取高分辨率静止图像的应用程序。 raspistill -o cam.jpg //大约显示5秒左右的预览窗口,然后图像保存到cam.jpg raspistill -vf -hf -o cam2.jpg //垂直翻转和水平翻转 #raspivid是一个视频拍摄应用程序。 raspivid -o vid.h264 //将5秒的视频保存到test.h264 raspivid -o video.h264 -t 10000 //录制10秒视频 raspivid -vf -hf -o video.h264 -t 10000 //垂直翻转和水平翻转
更详细信息可查看: Raspicam命令
FAQ
300cd/m²
8.88mm