2inch LCD Display B

1 产品介绍

2英寸ST7789V液晶显示屏（240×320分辨率 SPI TFT屏幕）

内置ST7789V控制器，提供适用于Raspberry Pi、C语言和Arduino的演示代码

这款液晶显示屏采用2英寸TFT面板，分辨率达320×240像素。内置ST7789V控制器并配备SPI控制接口，同时提供适用于树莓派的C语言和Python示例程序，以及Arduino开发板的配套代码。这些示例程序不仅能实现点、线、矩形和圆形的绘制功能，还支持中英文字符显示及图像呈现。

1.1 产品特点

240×320 分辨率；
SPI接口及较少的引脚占用；
屏幕内置了一个 ST7789V控制器；
提供适用于 Raspberry Pi和 Arduino 开发板的开源演示代码用于使用。

2 产品规格

规格	50mm (长) * 37mm (宽)
分辨率	240*320
显示颜色	RGB，65K Colors
控制芯片	ST7789V
背光控制	LED
信号接口	SPI
供电电源	5V/3.3V

3 产品用途

模块接口定义如表所示 4-1:

VCC	3.3V&5V
GND	地线/接地
DIN	SPI数据输入
SCK	SPI时钟输入
CS	SPI片选（低电平有效）
RST	显示屏复位（低电平复位）
DC	数据/命令控制引脚（高电平为数据，低电平为命令）
BL	背光控制

表 4-1：模块引脚定义

3.1 树莓派示例程序用法

3.1.1、硬件接口配置说明

在树莓派示例程序中，引脚是通过wiringPi编号定义的。以下是将LCD接口连接到树莓派板的引脚配置表：

LCD接口	BCM编号	wiringPi编号	BOARD 编号
VCC	3.3V	3.3V	3.3V
GND	GND	GND	GND
DIN	MOSI	12	19
CLK	SCLK	14	23
CS	CE0	10	24
RST	22	3	15
DC	25	6	22
BL	24	5	18

表 4-2：LCD 连接到 Raspberry Pi 的引脚定义

3.1.2、程序用法示例

3.1.2.1、WiringPi 库安装

首先，在终端中，使用“gpio -v”命令检查是否安装了WiringPi库。如果出现 2.52 版本信息，则表示安装成功。您可以跳过这部分。否则，您需要按如下方式安装它：

sudo apt_get install wiringpi

#对于 2019 年 5 月之后的 Raspberry Pi 系统（对于早期系统不需要），可能需要升级：

https://project-downloads.drogon.net/wiringpi-latest.deb

#对于 Raspberry Pi 4B 升级，如果您的下载失败或速度非常慢，您可以从以下链接下载它，然后将其复制到您的 Raspberry Pi 板上：

https://github.com/seengreat/wiringpi-library

下载后，使用以下命令安装它：

git clone https://github.com/WiringPi/WiringPi

cd WiringPi

./build

gpio -v

运行“gpio -v”将生成 2.70 版本。如果未显示任何内容，则表示安装错误。

如果您在运行示例程序的 Python 版本时遇到错误信息“ImportError： No module named 'wiringpi'”，请执行以下命令：
对于 Python 2.x 版本：

pip install wiringpi

对于 Python 3.x 版本：

pip3 install wiringpi

注意：如果安装失败，可以尝试以下编译安装：

git clone --recursive https://github.com/WiringPi/WiringPi-Python.git

注意：--recursive 选项可以自动拉取子模块;否则，需要手动下载。
导航到下载的 WiringPi Python 文件夹，然后输入以下命令进行编译和安装：
对于 Python 2.x 版本：

sudo python setup.py install

对于 Python 3.x 版本：

sudo python3 setup.py install

如果遇到以下错误：

此时，输入命令“sudo apt-install-swig”来安装 SWIG。然后，编译并安装“sudo python3 setup.py install”。如果您看到类似于以下内容的消息，则表示安装成功。

3.1.2.2、启用 SPI 接口

sudo raspi-config

启用 SPI 接口：

Interfacing Options -> SPI -> Yes

要查看已启用的 SPI 设备，请运行：

ls /dev/spi* #

这将打印出：“/dev/spidev0.0”和“/dev/spidev0.1”

3.1.2.3、安装 Python 库

示例程序使用 Python 3 环境。要运行 Python 示例程序，您需要安装 PIL、NumPy 和 spidev 库。按顺序执行以下命令以安装它们：

sudo apt-get install python3-pi1

sudo apt-get install python3-numpy

sudo apt-get install python3-pip

sudo pip3 install spidev

3.1.2.4、C 语言版本示例程序

导航到示例程序项目文件的 C 目录。

sudo make clean

sudo make

sudo ./main

输入以上命令后，即可观察屏幕显示。

3.1.2.5、Python 版本示例程序

导航到示例程序项目文件的 Python 目录。

python3 2inch_lcd.py

输入以上命令后，即可观察屏幕显示。

3.2、Arduino UNO 示例程序用法

3.2.1、硬件接口配置说明

LCD 接口	Arduino接口
VCC	5V
GND	GND
DIN	D11
SCK	D13
CS	D10
RST	D9
DC	D8
BL	D7

图4-4：Arduino与显示屏接线图

3.2.2、程序用法示例

使用 Arduino IDE 软件打开项目示例文件，单击验证。验证成功后，上传到模块，观察显示情况。

3.3、示例说明

3.3.1、C 语言版本示例程序

示例代码分为较低级别和上级别。较低级别的文件是 lcd_2inch.c 和 lcd_2inch.h，它们实现了 Raspberry Pi 控制引脚和 LCD 屏幕的初始化。上层文件为lcd_gui.c和lcd_gui.h，主要实现绘制点、线、矩形、圆形的功能，以及显示中英文字符和图像。

以“font”开头的文件与字体库相关。“.c”后缀对应于字体库的数据源文件。多个字体库数据源文件的数据结构在“fonts.h”文件中定义。在 Raspberry Pi 示例程序中，带有“.bmp”后缀的文件用于显示图像源。文件名中的数字表示彩色像素深度（bpp，每像素位数），例如，fruits24.bmp表示 24bpp 的真彩色格式图像文件。Arduino UNO 示例程序不包含这些“.bmp”文件，因为 Arduino UNO 板上的可用内存有限。相反，图像源数据以数组形式存储在image.cpp文件中。

3.3.2、Python 程序

示例程序的 Python 语言版本仅适用于 Raspberry Pi 平台。此外，由于 Python 平台可以利用 PIL（Python Imaging Library）进行图像处理，因此许多上层 API 函数都可以由该库直接提供，大大减少了示例程序中的代码量。

5 附录

5.1 产品注意事项和维护

5.1.1 产品须知

·请勿在模块通电时插拔模块。
·请遵循产品上提供的所有警告和指南。
·保持产品干燥。如果意外溅出或浸入任何液体中，请立即断开电源并彻底擦干产品。
·确保作环境中适当的通风和散热，避免因高温而损坏部件。
·请勿在多尘或肮脏的环境中使用或存放产品。
·避免在温度变化频繁的环境中使用本产品，以防止冷凝损坏组件。
·轻轻处理产品，因为跌落、撞击或剧烈摇晃可能会损坏电路和组件。
·请勿使用有机溶剂或腐蚀性液体清洁产品。
·请勿尝试自行修理或拆卸产品。如有任何故障，请联系我公司进行维修。未经授权的维修可能会损坏产品，由此造成的任何损坏将不在保修范围内

ꄴ前一个：无

ꄲ后一个：无