2inch LCD Display

Ⅰ产品介绍

2英寸液晶显示屏，分辨率为240×320 ST7789V

这款液晶显示器是一块2英寸TFT显示屏，分辨率为320×240。它带有一个内部ST7789V控制器，并利用SPI控制接口。它为 Raspberry Pi 提供 C 和 Python 示例程序，以及 Arduino 示例程序。这些示例程序可以绘制点、线、矩形和圆形，还支持显示中英文字符和图像。

配件清单：

①2inch LCD Display Module x1

②配件包

Ⅱ 产品规格

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

Ⅲ 产品用途

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

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

表 4-1：模块引脚定义

3.1 树莓派示例程序用法
3.1.1、硬件接口配置说明
在 Raspberry Pi 示例程序中，引脚是使用 wiringPi 编号定义的。以下是用于将 LCD 接口连接到 Raspberry Pi 板的引脚配置表：

LCD 接口	BCM number	wiringPi number	BOARD number
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	1

表 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 系统（对于早期系统不需要），可能需要升级：

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

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

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

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

sudo dpkg -I wiringpi-latest.deb

gpio -v #

# 如果出现 2.52 版本，则安装成功

# 对于 Bullseye 分支系统，请使用以下命令：

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" and "/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.21、硬件接口配置说明.

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 函数都可以由该库直接提供，大大减少了示例程序中的代码量。

Ⅳ 相关链接

4.1、Python 图像库

如果用户需要实现更多功能，可以在官方上了解更多

website at https://pillow.readthedocs.io/en/latest/handbook/index.html

Ⅴ 附录

5.1产品的注意事项

注意事项

在通电状态下，不要插拔模块。
遵循产品上提供的所有警告和指南。
保持产品干燥。如不小心溅水或浸入液体，立即断开电源并彻底干燥产品。
确保操作环境有良好的通风和散热，以避免因高温导致组件损坏。
不要在多尘或肮脏的环境中使用或存放产品。
避免在温度频繁变化的环境中使用产品，以防止组件发生冷凝损坏。
轻拿轻放产品，避免跌落、撞击或剧烈震动，以免损坏电路和组件。
不要使用有机溶剂或腐蚀性液体清洁产品。
请勿自行尝试维修或拆解产品。如出现任何故障，请联系我们公司进行维修。未经授权的维修可能会损坏产品，造成的损坏将不在保修范围内。

5.2技术支持

技术支持时间（工作日）：香港时间：上午9:30 - 上午11:30，

下午1:30 - 下午5:30电话：0773-7799838 传真：gxshengui@163.com

如果您有创意产品或想法，请随时给我们发送电子邮件，也许我们可以进一步合作。我们的电子邮件地址是：gxshengui@163.com

ꄴ前一个：无

ꄲ后一个：无

2inch LCD Display

Ⅰ产品介绍

Ⅱ 产品规格

Ⅲ 产品用途

3.1.2、程序用法示例

3.1.2.2、启用 SPI 接口

Consumer hotline

Service hours

QR code