2.8inch RPi LCD (A)
说明
| ||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||
视频
产品特点
- 硬件分辨率为320×240
- 电阻式触摸控制
- 兼容并可直接插入任何版本的树莓派
- 提供驱动(支持Raspbian\Ubuntu\Kali和Retropie系统)
- 支持FBCP软件驱动,可设置软件分辨率和双屏显示
- 和你的树莓派一样大
- 沉金工艺,精雕细琢
版本说明
- 由于原来2.8inch RPi LCD (A)使用的IC已缺货,我们更换了一款显示效果可替代的驱动方案。
- 外观设计上,LCD尺寸无差别,但软件需要更新,Rev2.1版本增加背光PWM控制功能。(需要使用最新版本的驱动)
- 用户可以通过模块背面的丝印判断新老版本。如果背面丝印带有Rev2.1的,则为新版本。
快速入门
硬件连接
连接GPIO接口,Raspberry Pi引出了40个GPIO管脚,而屏幕引出了26个管脚,连接时注意对应屏幕管脚和树莓派管脚。
您可以通过两种方法使用该LCD:方法一,给Raspbian/Ubuntu Mate/Kali和Retropie系统安装驱动。方法二,使用预装驱动的镜像。
方法一,安装驱动
请在树莓派官网下载最新版本的镜像(Raspbian/Ubuntu Mate/Kali或Retropie)。为了方便使用,这里提供Raspbian镜像
- 2019-07-10-raspbian-buster-full-------------提取码:s5x9
1) 将镜像文件下载到电脑上,并解压得到.img文件。
2) 将TF卡连接到电脑,打开Win32DiskImager.exe软件,选择第1步准备的.img文件,点击write烧写镜像。烧写完成后,安全弹出TF卡。
3) 将TF卡接入到树莓派上,启动树莓派,登录树莓派的终端(可以将树莓派接到HDMI显示器或用ssh远程登录)。
4) 先通过网络下载相关驱动代码,在执行相应的安装命令,在整个过程中确保可以正常联网。
git clone https://github.com/waveshare/LCD-show.git cd LCD-show/ 如果为老版本,则执行以下代码: sudo ./LCD28-show 如果为新版本,则执行以下代码: sudo ./LCD28-show-V2
重启后即可使用(为了方便使用,可以调整屏幕显示方向,参见#设置显示方向)。
注意1:执行apt-get upgrade会导致LCD无法正常工作。此时需要编辑SD卡中的 config.txt 文件,并删除这一句:dtoverlay=ads7846。
注意2:在Raspbian-lite下,需要执行sudo ./LCD28-show lite或sudo ./LCD28-show-V2 lite命令,以安装驱动。
对于Bullseye 64bit 和 Bookworm系统,需要手动配置,方法如下:2.8inch RPi LCD (A) 手动配置
方法二,使用预装驱动的镜像
这里提供预装驱动的镜像,解压并把镜像写入到TF卡中(打开Win32DiskImager.exe软件,选择.img文件,点击「write」烧写镜像)。然后把卡插入树莓派就可以使用了。 如果为老版本,则烧写以下镜像:
- 2.8inch RPi LCD (A)启动镜像-基于2020-08-20-raspios-buster-armhf-full-------------提取码:wxdz
如果为新版本,则烧写以下镜像:
- 2.8inch RPi LCD (A)-V2启动镜像-基于2021-05-07-raspios-buster-armhf-full-------------提取码:wxdz
设置显示方向
安装完触摸驱动后,可以通过运行以下命令修改屏幕旋转方向。
cd LCD-show/ #X可选0、90、180和270。分别表示LCD旋转0度、90度、180度和270度。 #如果为老版本,则执行以下代码: sudo ./LCD28-show X #如果为新版本,则执行以下代码: sudo ./LCD28-show-V2 X
在Raspbian-lite下的旋转命令如下:
cd LCD-show/ #X可选0、90、180和270。分别表示LCD旋转0度、90度、180度和270度。 #如果为老版本,则执行以下代码: sudo ./LCD28-show lite X #如果为新版本,则执行以下代码: sudo ./LCD28-show-V2 lite X
安装校准软件进行校准
- 本LCD可以通过xinput-calibrator程序进行校准。
- 运行以下命令,进行安装:
sudo apt-get install xinput-calibrator
- 点击任务栏的Menu键,选择Preferences -> Calibrate Touchscreen。
- 按显示提示进行触摸校准。
- 如果要保存这些触摸值,需要在以下路径新建一个99-calibration.conf文件(如果已存在则不需要新建)
/etc/X11/xorg.conf.d/99-calibration.conf
- 将触摸参数(不同LCD,下图数据可能不同)保存至99-calibration.conf,即可
2.8inch RPi LCD (A) - Rev2.1版本PWM背光调节功能
对于Pi4,需要先更新wiringPi版本,操作方法如下(对于3B+及更早的版本,则无需更新):
wget https://project-downloads.drogon.net/wiringpi-latest.deb sudo dpkg -i wiringpi-latest.deb gpio -v # 运行gpio -v会出现2.52版本,如果没有出现说明安装出错
更新wiringPi成功后,可通过以下命令控制背光亮度。
gpio -g mode 18 pwm #占用管脚为PWM管脚 gpio pwmc 100 gpio -g pwm 18 0 #最暗 gpio -g pwm 18 1023 #最亮 gpio -g mode 18 out #释放为输出
安装虚拟键盘
1. 执行以下命令安装相应软件
sudo apt-get update sudo apt-get install matchbox-keyboard sudo nano /usr/bin/toggle-matchbox-keyboard.sh
2. 复制以下内容到toggle-matchbox-keyboard.sh,保存退出
#!/bin/bash #This script toggle the virtual keyboard PID=`pidof matchbox-keyboard` if [ ! -e $PID ]; then killall matchbox-keyboard else matchbox-keyboard & fi
3. 执行以下命令
sudo chmod +x /usr/bin/toggle-matchbox-keyboard.sh sudo mkdir /usr/local/share/applications sudo nano /usr/local/share/applications/toggle-matchbox-keyboard.desktop
4. 复制以下内容到toggle-matchbox-keyboard.desktop,保存退出
[Desktop Entry] Name=Toggle Matchbox Keyboard Comment=Toggle Matchbox Keyboard` Exec=toggle-matchbox-keyboard.sh Type=Application Icon=matchbox-keyboard.png Categories=Panel;Utility;MB X-MB-INPUT-MECHANSIM=True
5. 执行以下命令,注意该步骤必须使用"pi"用户权限,如果使用管理员权限,将找不到该文件
sudo nano /etc/xdg/lxpanel/LXDE-pi/panels/panel
6. 找到类似以下命令(不同版本的图标可能有一定差异)
Plugin { type = launchbar Config { Button { id=lxde-screenlock.desktop } Button { id=lxde-logout.desktop } }
7. 加入以下代码以新增一个Button项,如下图
Button { id=/usr/local/share/applications/toggle-matchbox-keyboard.desktop }
8. 执行以下命令重启系统,正常可以看到左上角多了一个虚拟键盘的图标
sudo reboot
接口定义
以下标识为“NC”的引脚表示LCD没有占用该引脚,用户可用于其它应用。
引脚号 | 标识 | 描述 |
---|---|---|
1 | 3.3V | 电源正(3.3V电源输入) |
2 | 5V | 电源正(5V电源输入) |
3 | NC | NC |
4 | 5V | 电源正(5V电源输入) |
5 | NC | NC |
6 | GND | 电源地 |
7 | KEY1 | 按键1 |
8 | NC | NC |
9 | GND | 电源地 |
10 | NC | NC |
11 | TP_IRQ | 触摸面板中断,检测到触摸面板有按下则为低电平 |
12 | PWM | 背光控制 |
13 | RST | 复位 |
14 | GND | 电源地 |
15 | LCD_RS | LCD指令控制,指令/数据寄存器选择 |
16 | KEY2 | 按键2 |
17 | 3.3V | 电源正(3.3V电源输入) |
18 | KEY3 | 按键3 |
19 | LCD_SI / TP_SI | LCD显示 / 触摸面板的SPI数据输入 |
20 | GND | 电源地 |
21 | TP_SO | 触摸面板的SPI数据输出 |
22 | KEY4 | 按键4 |
23 | LCD_SCK / TP_SCK | LCD显示 / 触摸面板的SPI时钟信号 |
24 | LCD_CS | LCD片选信号,低电平选择LCD |
25 | GND | 电源地 |
26 | TP_CS | 触摸面板片选信号,低电平选择触摸面板 |
资料
开发资料
树莓派驱动
通过Github获取驱动程序:
git clone https://github.com/waveshare/LCD-show.git
树莓派镜像
如果为老版本,则烧写以下镜像:
- 2.8inch RPi LCD (A)启动镜像-基于2020-08-20-raspios-buster-armhf-full-------------提取码:wxdz
如果为新版本,则烧写以下镜像:
- 2.8inch RPi LCD (A)-V2启动镜像-基于2021-05-07-raspios-buster-armhf-full-------------提取码:wxdz
- 2.8inch RPi LCD (A)启动镜像桌面版本64位适用于所有版本树莓派-基于2024-07-04-raspios-bookworm-arm64-lite.img-------------提取码:wxdz
软件
树莓派相关教程
LCD显示区域
FAQ
- 该LCD必须安装驱动才能正常使用。具体请查看用户手册相关介绍。
- 由于树莓派镜像和版本经常更新,如遇到无法正常使用LCD的情况,请下载我们提供的最新版本镜像或到树莓派官网下载最新的镜像并安装我们提供的最新驱动进行使用。
- 确定硬件连接无误且接触良好。
- 确定TF卡烧写正常。
树莓派正常启动时PWR灯常亮,ACT灯闪烁。如果发现两灯都常亮则可能是TF卡烧写镜像不成功或TF卡与树莓派接触不良。
推荐使用5V 2.5A电源适配器对树莓派进行供电。 如使用PC机的USB接口对树莓派供电,可能由于供电不足导致树莓派无法正常启动。
商业级(0~70摄氏度)。