查看“模板:4inch-RPi-LCD-C-Manual”的源代码

== '''产品特点''' ==
*硬件分辨率为480x320
*电阻式触摸控制
*兼容并可直接插入任何版本的树莓派
*支持125MHz高速SPI信号传输，显示清晰稳定
*提供驱动（支持Raspbian\Ubuntu\Kali和Retropie系统）
*支持FBCP软件驱动，可设置软件分辨率和双屏显示
*和你的树莓派一样大
*沉金工艺，精雕细琢

== '''快速入门''' ==
=== '''硬件连接''' ===
连接GPIO接口，Raspberry Pi引出了40个GPIO管脚，而屏幕引出了26个管脚，连接时注意对应屏幕管脚和树莓派管脚。

您可以通过两种方法使用该LCD：方法一，给Raspbian/Ubuntu Mate/Kali和Retropie系统安装驱动。方法二，使用预装驱动的镜像。

==='''方法一，安装驱动'''===

请在[https://www.raspberrypi.org/downloads/ 树莓派官网]下载最新版本的镜像（Raspbian/Ubuntu Mate/Kali或Retropie）。为了方便使用，这里提供Raspbian镜像{{RASPBERRY-OFFICIAL-IMAGE}}

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

2) 将TF卡连接到电脑，打开[https://{{SERVERNAME}}/w/upload/7/76/Win32DiskImager.zip Win32DiskImager.exe]软件，选择第1步准备的.img文件，点击write烧写镜像。烧写完成后，安全弹出TF卡。

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

4) 先通过网络下载相关驱动代码，在执行相应的安装命令，<font color="#FF0000">在整个过程中确保可以正常联网</font>。
<syntaxhighlight lang="c">
git clone https://github.com/waveshare/LCD-show.git
cd LCD-show/
sudo ./LCD4C-show
</syntaxhighlight>
重启后即可使用（为了方便使用，可以调整屏幕显示方向，参见[[#设置显示方向]]）。

''注意1：执行apt-get upgrade会导致LCD无法正常工作。此时需要编辑SD卡中的 config.txt 文件，并删除这一句：dtoverlay=ads7846。''

''注意2：在Raspbian-lite下，需要执行sudo ./LCD4C-show lite命令，以安装驱动。''

=== '''方法二，使用预装驱动的镜像''' ===
这里提供预装驱动的镜像，解压并把镜像写入到TF卡中（打开[https://{{SERVERNAME}}/w/upload/7/76/Win32DiskImager.zip Win32DiskImager.exe]软件，选择.img文件，点击「write」烧写镜像）。然后把卡插入树莓派就可以使用了。
{{4inch-RPI-LCD-C-IMAGE}}
<!--
== '''LCD和HDMI相互切换''' ==
使用上面两种方法在正常使用LCD的情况下，外接HDMI是没有显示的，如需启用HDMI输出，需执行以下命令，树莓派会自动重启。再等待约30秒，HDMI显示屏开始显示。

<syntaxhighlight lang="c">
cd LCD-show/
./LCD-hdmi
</syntaxhighlight>

如需切换回LCD显示方式，则需执行以下命令：
<syntaxhighlight lang="c">
cd LCD-show/
./LCD4C-show
</syntaxhighlight>
''注意：在Raspbian-lite下，需要执行./LCD4C-show lite命令，以安装驱动。''
-->

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

<syntaxhighlight lang="c">
cd LCD-show/
#X可选0、90、180和270。分别表示LCD旋转0度、90度、180度和270度。
sudo ./LCD4C-show X 
</syntaxhighlight>

在Raspbian-lite下的旋转命令如下：
<syntaxhighlight lang="c">
cd LCD-show/
#X可选0、90、180和270。分别表示LCD旋转0度、90度、180度和270度。
sudo ./LCD4C-show lite X 
</syntaxhighlight>
{{RPILCD-CALIBRATION}}

== '''使用GPIO控制背光亮度''' ==

使用0R电阻或焊锡连接该焊盘。

[[File:4inch-RPi-LCD-C-Manual-01.jpg|800px]]

在树莓派终端执行以下命令即可控制背光亮度：
<syntaxhighlight lang="c">
gpio -g pwm 18 1024
gpio -g mode 18 pwm （占用管脚为PWM管脚）
gpio pwmc 1000
gpio -g pwm 18 X （控制亮度，X取值在0~1024之间）
</syntaxhighlight>

{{RPILCD-INSTALL-KEYBOARD}}