4inch HDMI LCD

来自丢石头百科
4inch HDMI LCD
4inch-HDMI-LCD
基本信息

分类: LCD 树莓派 IPS 电阻屏 显示屏

品牌: Waveshare

功能简介
特性
  • 4寸树莓派电阻屏 提供驱动
  • 分辨率:800×480
  • 适用范围:兼容任何版本的树莓派

接口

RPi接口 HDMI接口

相关产品

产品特点

  • 硬件分辨率为480×800
  • 电阻式触摸控制
  • 兼容并可直接插入任何版本树莓派(树莓派1代B型与树莓派Zero需另配HDMI连接线)
  • 提供驱动(支持Raspbian / Ubuntu / Kali和Retropie系统)
  • 可作为计算机显示器,无触摸功能(接入计算机须另配HDMI线)
  • 仅用于显示,不占用任何I/O资源(使用触摸功能,占用I/O)
  • 支持背光控制,更省电

快速入门

硬件连接

1. 连接GPIO接口

  • Raspberry Pi引出了40个GPIO管脚,而屏幕引出了26个管脚,连接时注意对应屏幕管脚和树莓派管脚。

树莓派 GPIO 连接

2. 连接HDMI接口。把HDMI连接器接入屏幕和主板的HDMI接口。

  • Raspberry Pi Model B与Raspberry Pi Zero需另配HDMI连接线进行连接。

3. 把LCD背后的Backlight拨到“ON”。

说明

  • 本屏幕必须连接树莓派的 GPIO,才能使用触摸功能。
  • 屏幕上面的 USB 口仅用于供电。
  • 如有风扇或者外壳,那么需要取下,才能把本产品插上树莓派,否则将无法使用触摸。

您可以通过两种方法启用触摸功能:方法一,给Raspbian/Ubuntu Mate/Kali和Retropie系统安装驱动。方法二,使用预装驱动的镜像。

方法一,安装驱动

请在树莓派官网下载最新版本的镜像(Raspbian/Ubuntu Mate/Kali或Retropie)。为了方便使用,这里提供Raspbian镜像

1) 将镜像文件下载到电脑上,并解压得到.img文件。

2) 将TF卡连接到电脑,打开Win32DiskImager.exe软件,选择第1步准备的.img文件,点击write烧写镜像。

3) 烧写完成后,用写字板打开TF卡根目录的config.txt文件,在config.txt最后加入以下代码,保存并安全弹出TF卡。

hdmi_group=2
hdmi_mode=87
hdmi_timings=480 0 40 10 80 800 0 13 3 32 0 0 0 60 0 32000000 3
dtoverlay=ads7846,cs=1,penirq=25,penirq_pull=2,speed=50000,keep_vref_on=0,swapxy=0,pmax=255,xohms=150,xmin=200,xmax=3900,ymin=200,ymax=3900
display_rotate=3

注:如果是Raspberry Pi 4,还需要把dtoverlay=vc4-fkms-V3D注释掉。

4) 将TF卡接入到树莓派上,并启动树莓派,登录树莓派的终端(可以将树莓派接到HDMI显示器或用ssh远程登录)。

5) 先通过网络下载相关驱动代码,在执行相应的安装命令,在整个过程中确保可以正常联网

git clone https://github.com/waveshare/LCD-show.git
cd LCD-show/
sudo ./LCD4-800x480-show

重启后触摸即可使用(为了方便使用,可以调整屏幕显示方向,参见#设置显示方向)。

方法二,使用预装驱动的镜像

这里提供预装驱动的镜像,解压并把镜像写入到TF卡中(打开Win32DiskImager.exe软件,选择.img文件,点击「write」烧写镜像)。然后把卡插入树莓派就可以使用了。

注:Raspberry Pi OS Bullseye分支需要更新软件版本,其他系统这一步骤可以省略。

sudo apt-get update
sudo apt-get full-upgrade

设置显示方向

安装完触摸驱动后,可以通过运行以下命令修改屏幕旋转方向。

cd LCD-show/
#X可选0、90、180和270。分别表示LCD旋转0度、90度、180度和270度。
sudo ./LCD4-800x480-show X

在Raspbian-lite下的旋转命令如下:

cd LCD-show/
#X可选0、90、180和270。分别表示LCD旋转0度、90度、180度和270度。
sudo ./LCD4-800x480-show lite X

触摸屏旋转(以90°为例)

显示旋转

sudo nano /boot/config.txt
在文件末尾加入
display_rotate=1 //旋转90°
/*
0表示旋转0°
1表示旋转90°
2表示旋转180°
3表示旋转270°
*/
ctrl + o 保存文档 重启即可

触摸旋转

  • 本LCD可以通过xinput-calibrator程序进行校准。
  • 运行以下命令,进行安装:
sudo apt-get install xinput-calibrator
  • 列出所有输入设备信息
xinput --list            //本机操作执行此条
DISPLAY=:0 xinput --list //远程操作执行此条
  • 列出目标设备属性
    • 通过上条指令,找到xxx Touchscreen对应的id号
    • 输入
//本机操作执行此条
xinput --list-props id
//远程操作执行此条
DISPLAY=:0 xinput --list-props id //id为对应的id号
  • 找到以下两条信息
Evdev Axis Inversion (246)0,0
Evdev Axes Swap (248): 0
其中
Evdev Axis Inversion (246):0,0项是每条轴的旋转设置项,后面第一个参数是x,第二个参数是y.
Evdev Axes Swap (248): 0项对应的是两条轴的交换。
0为不翻转,1为翻转 
  • 旋转触摸的坐标轴
    • 触摸旋转90度,从坐标轴理解:即目的x轴正向为初始y轴的反向。目的y轴的正方向为初始x轴的正向。
    • 先交换x、y轴
//本机操作执行此条
xinput --set-prop 'id' 'Evdev Axes Swap' 1     //id为对应的id号
//远程操作执行此条
DISPLAY=:0 xinput --set-prop 'id' 'Evdev Axes Swap' 1    //id为对应的id号
  • 然后反转y轴
//本机操作执行此条
xinput --set-prop 'id' 'Evdev Axis Inversion' 0 1    //id为对应的id号
//远程操作执行此条 
DISPLAY=:0 xinput --set-prop 'id' 'Evdev Axis Inversion' 0 1      //id为对应的id号
这样即可完成触摸旋转90度。若要旋转其他角度,推理一下即可。
  • 显示旋转修改之后需要重启。而触摸旋转不需要重启。

触摸屏校准(仅当触摸不准确时需校准)

  • 本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,即可

5inch HDMI LCD FAQ1.jpg

安装虚拟键盘

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
}

RPILCD-INSTALL-KEYBOARD01.png

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 NC NC
8 NC NC
9 GND 电源地
10 NC NC
11 NC NC
12 NC NC
13 NC NC
14 GND 电源地
15 NC NC
16 NC NC
17 3.3V 电源正(3.3V电源输入)
18 NC NC
19 TP_SI LCD显示 / 触摸面板的SPI数据输入
20 GND 电源地
21 TP_SO 触摸面板的SPI数据输出
22 TP_IRQ 触摸面板中断,检测到触摸面板有按下则为低电平
23 TP_SCK 触摸面板的SPI时钟信号
24 NC NC
25 GND 电源地
26 TP_CS 触摸面板片选信号,低电平选择触摸面板

视频

开发资料

树莓派驱动

通过Github获取驱动程序:

git clone https://github.com/waveshare/LCD-show.git

树莓派镜像

软件

树莓派相关教程

树莓派系列教程

LCD显示区域

4inch HDMI LCD显示区域

认证资料


转到:#软件#程序#文档

选型列表

型号 分辨率 显示接口 面板材质 触摸类型 触摸接口 扬声器 音频输出
0.96inch LCD Module 80x160 SPI TFT - - - -
1.3inch LCD HAT 240x240 SPI IPS - - - -
1.3inch LCD Module 240x240 SPI TFT - - - -
1.3inch OLED (B) 128x64 I2C/SPI OLED(蓝色) - - - -
1.44inch LCD HAT 128x128 SPI TFT - - - -
1.5inch RGB OLED Module 128x128 SPI OLED(65K彩色) - - - -
1.8inch LCD Module 160x128 SPI TFT - - - -
2.23inch OLED HAT 128x32 I2C/SPI OLED(白色) - - - -
2inch LCD Module 320x240 SPI TFT - - - -
3.5HD480320SR TFT LCD 480x320 HDMI TFT 电阻式 SPI -
3.5HS480320SR TFT LCD 480x320 SPI (高速) TFT 电阻式 SPI - -
3.5inch HDMI LCD 480x320 HDMI IPS 电阻式 SPI -
3.5inch RPi LCD (A) 480x320 SPI TFT 电阻式 SPI - -
4.3inch DSI LCD 800x480 DSI IPS 电容式 I2C - -
4HD480800SR IPS LCD 800x480 HDMI IPS 电阻式 SPI -
4inch HDMI LCD 800x480 HDMI IPS 电阻式 SPI - -
4inch Resistive Touch LCD 800x480 8080 IPS 电阻式 SPI - -
5HD800480SR TFT LCD 800x480 HDMI TFT 电阻式 SPI - -
5HD800480UC TFT LCD 800x480 HDMI TFT 电阻式 USB -
5inch HDMI LCD 800x480 HDMI TFT 电阻式 SPI - -
7HD1024600UC IPS LCD 1024x600 HDMI IPS 电容式 USB - -
7HD1024600UCC IPS LCD 1024x600 HDMI IPS 电容式 USB
7HD800480UC TFT LCD 800x480 HDMI TFT 电容式 USB - -
7inch HDMI LCD (H) 1024x600 HDMI IPS 电容式 USB -
Display (1024×600, 7inch, IPS, HD, C) 1024x600 HDMI IPS 电容式 USB - -

FAQ


问题:
使用树莓派官方提供的镜像,无法正常使用LCD,是什么原因?
答复:
  • 该LCD必须安装驱动才能正常使用。具体请查看用户手册相关介绍。



问题:
使用waveshare提供的树莓派镜像,无法正常使用LCD,怎么处理?
答复:
  • 由于树莓派镜像和版本经常更新,如遇到无法正常使用LCD的情况,请下载我们提供的最新版本镜像或到树莓派官网下载最新的镜像并安装我们提供的最新驱动进行使用。
  • 确定硬件连接无误且接触良好。
  • 确定TF卡烧写正常。
    树莓派正常启动时PWR灯常亮,ACT灯闪烁。如果发现两灯都常亮则可能是TF卡烧写镜像不成功或TF卡与树莓派接触不良。



问题:
4inch HDMI LCD 的工作温度是?
答复:

商业级(0~70摄氏度)。




Icon-mail.png 联系 丢石头

我们的工作时间是: 09:00-18:00 (UTC+8 周一到周六)