模板: 4inch-HDMI-LCD-Manual

来自Waveshare Wiki
跳转至： 导航、 搜索

产品特点

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

演示视频

快速入门

硬件连接

  1. 连接GPIO接口
    • Raspberry Pi引出了40个GPIO管脚，而屏幕引出了26个管脚，连接时注意对应屏幕管脚和树莓派管脚。
  2. 连接HDMI接口。把HDMI连接器接入屏幕和主板的HDMI接口。
    • Raspberry Pi Model B与Raspberry Pi Zero需另配HDMI连接线进行连接。
  3. 把LCD背后的Backlight拨到“ON”。

您可以通过两种方法启用触摸功能：方法一，给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
hdmi_drive=1
hdmi_force_hotplug=1

注：如果是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」烧写镜像）。然后把卡插入树莓派就可以使用了。

设置显示方向

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

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

安装校准软件进行校准

  • 本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 触摸面板片选信号，低电平选择触摸面板
取自“https://www.waveshare.net/w/index.php?title=模板:4inch-HDMI-LCD-Manual&oldid=65100”