5inch DSI LCD (B)
说明
| ||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||
产品特点
- 5寸电容触摸屏,硬件分辨率为800×480
- 电容式5点触摸控制
- 钢化玻璃电容触摸面板,硬度达6H
- 支持Pi 4B/3B+/3A+/3B/2B/B+/A+,CM3/3+/4须另购转接板 CM-DSI-ADAPTER
- 直接通过Raspberry Pi的DSI接口驱动LCD,刷新率可达60Hz
- 配合Raspberry Pi使用时,支持Raspberry Pi OS / Ubuntu / Kali 和 Retropie,免驱
- 支持通过软件控制背光亮度
搭配树莓派使用
硬件连接
- 使用FFC线,将5inch DSI LCD连接到Raspberry Pi的DSI接口。
- 为了方便使用,可以把Raspberry Pi通过螺丝固定的5inch DSI LCD的背面,并组装上铜柱。
如下图所示:
软件设置
用于树莓派的Raspberry Pi OS / Ubuntu / Kali 和 Retropie系统。
- 1. 请在树莓派官网下载最新版本的镜像。将压缩文件下载到PC上,并解压得到.img文件。
- 2. TF卡连接到PC,使用SDFormatter软件格式化TF卡。
- 3. 打开Win32DiskImager软件,选择第1步准备的系统镜像,点击write烧写系统镜像。
- 4. 烧写完成后,保存并安全弹出TF卡。并将TF卡插入树莓派。
- 5. 给树莓派上电,正常等待几秒后可正常显示。系统启动后可以正常触摸。
注:在2021年12月2日,树莓派的Raspberry Pi OS分成了两个分支,分别是Buster分支和Bullseye分支。
其中Buster分支是老系统的延续,更为稳定。Bullseye分支则添加了一些新的功能,使用了开源的库和新的接口。当前Bullseye分支刚发布不久,还不太稳定。
如果你是工业用户,强烈建议使用Buster分支。
如果你使用的Buster分支的系统,镜像无需任何改何修改即可正常使用。如果使用的是Bullseye分支的系统,还需要进行以下修改。
在config.txt文件中注释以下语句(config文件位于TF卡根目录,即/boot中):
#camera_auto_detect=1 #dtoverlay=vc4-kms-v3d
在[all]下方添加以下语句:
dtoverlay=vc4-fkms-v3d start_x=1
保存后重启树莓派即可
sudo reboot
如果你需要在Bullseye分支的系统下使用CSI摄像头。由于该分支默认使用libcamera摄像头库,该库不支持FKMS驱动。
所以除了上面修改外,还需要安装Raspicam摄像头库。
安装方法如下:
在终端运行以下指令:
cd ~ sudo apt install cmake git clone https://github.com/raspberrypi/userland cd userland ./buildme sudo cp build/bin/* /bin/
之后执行以下指令关机:
poweroff
在将树莓派摄像头连接到树莓派的CSI接口上,重新给树莓派上电,系统启动后,执行以下命令即可:
拍照
raspistill -o image.jpg
摄像
raspivid -o video.h264 -t 10000
软件调光
微雪提供了对应的应用程序(该程序仅用于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
禁用触摸
在config.txt文件最后,加入以下对应禁用触摸的命令(config文件位于TF卡根目录,也可以通过命令访问:sudo nano /boot/config.txt):
disable_touchscreen=1
注:添加指令后需重启生效。
树莓派长按右键设置
树莓派长按右键软件安装
测试环境:2022-04-04-raspios-bullseye-armhf 32位系统
支持型号:支持微雪电子DSI LCD、DPI LCD和HDMI LCD电容触摸屏系列的32位系统,64位系统默认不支持
wget https://www.waveshare.net/w/upload/1/18/Evdev-right-click-emulation.zip unzip Evdev-right-click-emulation.zip cd evdev-right-click-emulation sudo apt install build-essential libevdev2 libevdev-dev -y sudo cp 'out/evdev-rce' '/usr/local/bin/' sudo chmod +x '/usr/local/bin/evdev-rce'
输入命令
sudo evdev-rce
运行之后即可触摸长按实现右键功能
设置 pi用户可以执行
sudo usermod -G 'input' -a pi echo 'uinput' | sudo tee -a /etc/modules sudo nano /etc/udev/rules.d/99-uinput.rules
在99-uinput.rules文件中添加
KERNEL=="uinput", MODE="0660", GROUP="input"
保存,再在终端运行
sudo udevadm control --reload-rules sudo udevadm trigger
然后重启
sudo reboot
重启后运行(此时不需要sudo)
evdev-rce
运行之后即可触摸长按实现右键功能
设置开机启动
在终端输入
sudo mkdir ~/.config/autostart sudo nano ~/.config/autostart/right_click.desktop
在right_click.desktop增加如下
[Desktop Entry] Version=1.0 Type=Application Name=evdev-rce GenericName=Enable long-press-to-right-click gesture Exec=env LONG_CLICK_INTERVAL=1000 LONG_CLICK_FUZZ=200 /usr/local/bin/evdev-rce Terminal=true StartupNotify=false
如果要修改灵敏度则可以修改 LONG_CLICK_INTERVAL=1000 LONG_CLICK_FUZZ=200 这两者参数大小,.
FAQ
执行以下命令: sudo raspi-config -> Advanced Options -> Glamor -> Yes(Enabled) -> Ok -> Finish -> Yes(Reboot)
- 使用5V供电 单独树莓派4B 正常工作电流为450mA~500mA
- 使用5V供电 树莓派4B+5inch DSI LCD最大亮度 正常工作电流为700mA~750mA
- 使用5V供电 树莓派4B+5inch DSI LCD最小亮度 正常工作电流为550mA~600mA
默认状态是支持软件调节的,建议查看#背光控制,也可以按以下方法焊接PWM控制背光:
如下图,先去掉原来焊接的电阻,在将该电阻的焊盘(左焊盘)连接到树莓派的P1脚,就可以用GPIO去控制背光。
- gpio -g pwm 18 0
- gpio -g mode 18 pwm (占用管脚为PWM管脚)
- gpio pwmc 1000
- 控制亮度:
- gpio -g pwm 18 X(X取值在0~1024之间,0最暗,1024最亮)
PS:为了保证良好的客户体验,默认出厂最低亮度为可视状态,如需完全关闭背光实现黑屏效果,请将下图100K电阻手动改为68K电阻: