2.8inch HDMI LCD (H)
说明
| ||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||
产品概述
本产品是通用的2.8寸HDMI显示屏,480×640分辨率,带钢化玻璃电容触摸面板,全贴合工艺。
支持树莓派和Jetson Nano,也可作为计算机触控屏。
产品特点
- 2.8寸IPS屏,硬件分辨率为480×640
- 5点电容触控,钢化玻璃面板,硬度达6H
- 搭配Raspberry Pi使用时,支持Raspberry Pi OS / Ubuntu / Kali 和 Retropie
- 搭配Jetson Nano使用时,支持Ubuntu
- 作为计算机显示器使用时,支持Windows 11 / 10 / 8.1 / 8 / 7
- 板载双触摸电路,USB Type-C 或 I2C触摸可选,应用场景更丰富
- 支持背光控制,更省电
特色设计
搭配树莓派使用
用于树莓派的Raspberry Pi OS / Ubuntu / Kali 和 Retropie系统。
当LCD工作于树莓派这些系统时,必须手动设置分辨率,否则会导致显示异常。当LCD工作于PC版的Windows 系统时,无此问题。
- 1. 请在树莓派官网下载最新版本的镜像。将压缩文件下载到PC上,并解压得到.img文件。
- 2. TF卡连接到PC,使用SDFormatter软件格式化TF卡。
- 3. 打开Win32DiskImager软件,选择第1步准备的系统镜像,点击write烧写系统镜像。
- 4. 烧写完成后,打开TF卡根目录的config.txt文件,在config.txt最后加入以下代码。
hdmi_force_hotplug=1 hdmi_group=2 hdmi_mode=87 hdmi_timings=480 0 100 16 100 640 0 100 20 100 0 0 0 60 0 42000000 6 dtparam=i2c_arm=on dtoverlay=waveshare-28HDMI-3b dtoverlay=waveshare-28HDMI-4b dtoverlay=waveshare-28HDMI-5b start_x=1 gpu_mem=128
- 5. 下载2.8inch HDMI LCD-H DTBO文件,解压出3个dtbo文件。将3个文件复制到overlays目录(/boot/overlays/)
- 6. 保存,安全弹出TF卡,并将TF卡插入树莓派。
- 7. 将触摸接口选择开关切换到"I2C"。
- 8. 将屏幕通过背锁式安装,树莓派GPIO接口将通过顶针连接LCD的供电和触摸引脚。
- 9. 将LCD的Display接口连接到树莓派的HDMI接口,给树莓派上电,正常等待十几秒后可正常显示。
- 注意事项:本产品默认是竖屏显示,分辨率(H×V)是480×640。可以通过修改软件设置,进行横屏显示,详情参见#显示旋转。
显示旋转
更新软件版本
Raspberry Pi OS Bullseye分支需要更新软件版本,其他系统这一步骤可以省略。
sudo apt-get update sudo apt-get full-upgrade
Raspberry Pi OS和Kali显示旋转
先检查使用的系统是否有加载KMS或FKMS驱动。
查看方法:在/boot/config.txt中,看对应的主板是否有打开了dtoverlay=vc4-kms-v3d或dtoverlay=vc4-fkms-v3d。
有加载KMS或FKMS驱动
使用以下命令进行显示旋转:
sudo nano /etc/xdg/lxsession/LXDE-pi/autostart #在autostart文件末端输入对应显示旋转角度的指令,重启后生效 #0: 旋转0度; 1:旋转270度;2: 旋转180度; 3: 旋转90度 xrandr -o 1
没有加载KMS或FKMS驱动
使用以下命令进行显示旋转:
sudo nano /boot/config.txt #在config.txt文件末端输入对应显示旋转角度的指令,重启后生效 #0: 旋转0度; 1:旋转90度;2: 旋转180度; 3: 旋转270度 display_rotate=3
Ubuntu显示旋转
先检查使用的系统是否有加载KMS或FKMS驱动。
查看方法:在/boot/firmware/config.txt中,看对应的主板是否有打开了dtoverlay=vc4-kms-v3d或dtoverlay=vc4-fkms-v3d。
有加载KMS或FKMS驱动
使用以下方式进行显示旋转。
注:对于不同版本的Ubuntu系统,界面可能会有所区别,一般找到Displays应用进行旋转就可以。
执行命令,旋转Ubuntu登录界面,如果没有打开Ubuntu登录界面,这个步骤可以省略:
#对于32位系统,执行以下命令,your_user替代为当前登陆的用户名 sudo cp /home/<your_user>/.config/monitors.xml /var/lib/lightdm/.config #对于64位系统,执行以下命令,your_user替代为当前登陆的用户名 sudo cp /home/<your_user>/.config/monitors.xml /var/lib/gdm3/.config sudo chown gdm:gdm /var/lib/gdm3/.config/monitors.xml
执行以下命令旋转开机过程中的命令行显示:
sudo nano /boot/firmware/cmdline.txt #在尾部增加下面代码可以旋转命令行 #旋转0度 fbcon=rotate:0 video=HDMI-A-1:640x480M@60,rotate=0 #旋转90度 fbcon=rotate:3 video=HDMI-A-1:640x480M@60,rotate=90 #旋转180度 fbcon=rotate:2 video=HDMI-A-1:640x480M@60,rotate=0 #旋转270度 fbcon=rotate:1 video=HDMI-A-1:640x480M@60,rotate=270
没有加载KMS或FKMS驱动
旋转相对比较简单,使用以下命令进行显示旋转即可:
sudo nano /boot/firmware/config.txt #在config.txt文件末端输入对应显示旋转角度的指令,重启后生效 #0: 旋转0度; 1:旋转90度;2: 旋转180度; 3: 旋转270度 display_rotate=3
触摸旋转
在进行显示旋转后,由于触摸并没有随着显示角度做出更改,导致触摸位置不对。所以需要对触摸做出修改。
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的部分,在里面添加以下语句,然后保存即可
Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1"
sudo reboot
完成以上步骤即可进行90度旋转。
注:
90度旋转: Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1"
180度旋转: Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1"
270度旋转: Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1"
搭配PC机使用
该LCD可工作于PC版Windows 11 /10 / 8.1 / 8 / 7 系统。使用方法:
- 1) 将触摸接口选择开关切换到"USB"。
- 2) 将LCD的Power&Touch接口连接到PC机的USB接口。
- 3) 将LCD的Display接口连接到PC机的HDMI接口。
- 注意事项:本产品默认是竖屏显示,分辨率(H×V)是480×640。可以通过修改软件设置,进行横屏显示,详情参见#Windows旋转。
Windows旋转
1.右键桌面,进入 “显示设置”:
2.点击检测,选择对应显示屏,设置为扩展模式,然后选择对应的显示方向即可完成显示旋转。
搭配Jetson Nano使用
- 1) 将触摸接口选择开关切换到"USB"。
- 2) 将LCD的Power&Touch接口连接到PC机的USB接口。
- 3) 将LCD的Display接口连接到PC机的HDMI接口。
其它操作
背光控制
通过Power控制LCD的背关亮灭。
通过UP/DOWN,来控制背光亮度。
FAQ
disable_splash=1
将自定义图片替换此目录的图片即可 /usr/share/plymouth/themes/pix/splash.png
树莓派长按右键软件安装
测试环境: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 这两者参数大小,.
取决于系统,如果系统有休眠,那屏幕也会黑屏。如果是树莓派官方系统,默认十分钟左右无动作是有休眠的。