2.9inch E-paper Display
Ⅰ 产品概述
2.9英寸电子墨水屏，296*128像素，刷新快，功耗低，护眼，宽视角，高对比度，单色电子纸电子标签。
本产品是一款2.9英寸电子墨水显示扩展模块，适用于树莓派系列主板、Arduino、STM32等。我们为 Raspberry Pi 提供 C 和 Python 示例程序，以及 Arduino 和 STM32 示例程序。示例程序可以实现点、线、矩形和圆形的绘制，以及字母数字字符和图像的显示。
Ⅱ 产品特点
- 296*128像素
- SPI接口，占用引脚相对较少
- 板载电平转换芯片，兼容3.3V和5V单片机接口
- 可用于 Raspberry Pi、Arduino 和 STM32 开发板的开源示例程序
Ⅲ 产品参数
|
尺寸 |
82mm (长) * 38mm (宽) |
|
螺丝大小 |
M2.5 |
|
像素 |
296*128 |
|
显示颜色 |
单色 |
|
电平转换芯片 |
TXS0108EPWR |
|
信号接口 |
SPI |
|
供应电压 |
5V/3.3V |
|
显示区域 |
66.9mm (高) * 29mm (宽) |
|
灰度 |
4 |
|
全局刷新时间 |
3S |
|
快速刷新时间 |
1.5S |
|
局部刷新时间 |
0.3S |
|
功耗 |
9mW |
|
待机功耗 |
0.003mW |
Ⅳ 产品使用
电子墨水屏幕模块的引脚定义如下：
|
VCC |
3.3V&5V |
|
GND |
接地 |
|
RST |
外部复位引脚（低电平复位） |
|
BUSY |
忙碌状态输出（高级别指示忙碌） |
|
D/C |
数据／指令控制（数据为高级别，指令为低级别） |
|
MOSI |
SPI通信 MOSI 引脚 |
|
CS |
SPI芯片选择 (低电平活跃) |
|
CLK |
SPI 通信 SCK 引脚 |
表 4-1：模块引脚定义
资源介绍如下图所示：
图4-1 2.9寸电子纸显示资源介绍图
①2.9英寸电子墨水屏②电子墨水屏连接器③SPI控制接口连接器
④电平转换芯片TXS0108⑤SPI线号选择开关
4.1、树莓派示例程序用法
4.1.1、硬件接口配置说明
Raspberry Pi 主板的示例程序使用 wiringPi 编号引脚定义。与树莓派主板接线配对的接线Pi引脚定义如下表所示：
|
电子墨水屏幕界面 |
wiringPi 编码 |
BCM 编码 |
|
VCC |
|
|
|
GND |
|
|
|
RST |
P0 |
17 |
|
BUSY |
P5 |
24 |
|
D/C |
P6 |
25 |
|
MOSI |
MOSI/P12 |
10 |
|
CLK |
SCLK/P14 |
11 |
|
CS |
CE0/P10 |
8 |
表 4-2：将电子墨水屏幕连接到 Raspberry Pi 的引脚定义
4.1.2、程序使用示例
为本产品提供的所有示例程序均基于 4 线 SPI 模式。因此，电路板背面标记为 BS 的开关默认设置为“0”。
4.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升级，如果你的下载失败或者速度很慢，可以从以下链接下载，然后复制到树莓派主板上：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 |
注意：the--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”。如果您看到类似于以下内容的消息，则表示安装成功。
4.1.2.2、启用SPI 接口
|
sudo raspi-config |
启用SPI接口：
|
Interfacing Options -> SPI -> Yes |
查看已启用的 SPI 设备：
|
ls /dev/spi* # |
此时，它将打印出：“/dev/spidev0.0”和“/dev/spidev0.1”
4.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 |
4.1.2.4、C版示例程序
进入 C 示例程序项目文件目录。
|
sudo make clean sudo make sudo ./main |
输入上述命令后，您可以观察电子墨水屏幕上的显示情况。
4.1.2.5、Python 版本示例程序
进入 Python 示例程序项目文件 python 目录。
|
python3 gui_demo.py |
输入上述命令后，就可以观察电子墨水屏幕上的显示情况了。
4.2、Arduino MEGA示例程序的使用
4.2.1、硬件接口配置说明
|
电子墨水屏幕界面 |
Arduino接口 |
|
VCC |
5V |
|
GND |
GND |
|
RST |
D9 |
|
BUSY |
D10 |
|
D/C |
D8 |
|
MOSI |
D51 |
|
CLK |
D52 |
|
CS |
D53 |
4.2.2、程序使用示例
用Arduino IDE软件打开项目示例文件，点击验证，验证成功后上传到模块。观察电子墨水屏幕上的显示情况。
4.3、Arduino UNO示例程序的使用
4.3.1、硬件接口配置说明
|
电子墨水屏幕界面 |
Arduino 接口 |
|
VCC |
5V |
|
GND |
GND |
|
RST |
D9 |
|
BUSY |
D8 |
|
D/C |
D10 |
|
MOSI |
D13 |
|
CLK |
D12 |
|
CS |
D11 |
4.3.2、程序使用示例
使用 Arduino IDE 软件打开项目示例文件，单击验证。验证成功后，上传到模块，观察电子墨水屏幕上的显示情况。
4.4、STM32示例程序的使用
4.4.1、硬件接口配置说明
|
电子墨水屏幕界面 |
STM32 接口 |
|
VCC |
3.3V |
|
GND |
GND |
|
RST |
PA11 |
|
BUSY |
PA12 |
|
D/C |
PA8 |
|
MOSI |
PB15 |
|
CLK |
PB13 |
|
CS |
PB12 |
4.4.2、程序使用示例
使用 Keil uVision5 软件打开示例程序项目文件。编译无误后，下载到模块中，观察电子墨水屏幕上的显示情况。
4.5、ESP32示例程序的使用
4.5.1、硬件接口配置说明
|
电子墨水屏幕界面 |
ESP32 接口 |
|
VCC |
3.3V |
|
GND |
GND |
|
RST |
IO33 |
|
BUSY |
IO13 |
|
D/C |
IO14 |
|
MOSI |
IO23 |
|
CLK |
IO18 |
|
CS |
IO17 |
4.5.2、程序使用示例
使用 Arduino IDE 软件打开项目示例文件。单击验证。验证成功后，上传到模块，观察电子墨水屏幕上的显示情况。
4.6、图像创建和建模说明
4.6.1、图像创建
创建需要显示为分辨率为296*128（不支持灰度）的纯黑白图像的图像。将它们保存为 BMP 或 JPG 文件（建议使用 BMP 格式）。
4.6.2、建模
可以使用压缩包中提供的 image2lcd 软件进行建模。以图 4-2 所示的效果为例，建模参数设置界面如图 4-3 所示：
1、打开需要建模的图像。
2、 输出数据类型：选择 "C Language Array (*.c)".
3、 扫描方式：选择"Vertical scanning".
4、输出灰度：选择"Monochrome".
5、 最大宽度和高度：选择"296" "128". 选择后，单击旁边的箭头进行确认。
6、如下图所示的5项中的任何一项都不要勾选。
7、颜色反转：勾选显示原始图像;取消选中颜色反转。
8、点击“保存”，将转换后的数组保存到扩展名为“.c”的文件中。
9、最后，使用“.c”文件中的数组替换程序中对应的数组。
图4-2
图 4-3
Ⅴ 相关链接
Python 的图像库
如果用户需要实现额外的功能，他们可以访问官方网站进行学习： https://pillow.readthedocs.io/en/latest/handbook/index.html
产品注意事项
- 在通电状态下，不要插拔模块。
- 遵循产品上提供的所有警告和指南。
- 保持产品干燥。如不小心溅水或浸入液体，立即断开电源并彻底干燥产品。
- 确保操作环境有良好的通风和散热，以避免因高温导致组件损坏。
- 不要在多尘或肮脏的环境中使用或存放产品。u
- 避免在温度频繁变化的环境中使用产品，以防止组件发生冷凝损坏。
- 轻拿轻放产品，避免跌落、撞击或剧烈震动，以免损坏电路和组件。
- 不要使用有机溶剂或腐蚀性液体清洁产品。u
- 请勿自行尝试维修或拆解产品。如出现任何故障，请联系我们公司进行维修。未经授权的维修可能会损坏产品，造成的损坏将不在保修范围内。
技术支持
技术支持时间（工作日）：香港时间：上午9:30 - 上午11:30，
下午1:30 - 下午5:30电话：0773-7799838 传真：gxshengui@163.com
如果您有创意产品或想法，请随时给我们发送电子邮件，也许我们可以进一步合作。我们的电子邮件地址是：gxshengui@163.com
- 2025-12-02
- 2025-12-02
- 2025-12-02
- 2025-12-01
