各项参数

尺寸	7.3英寸
驱动板尺寸	65.0mm × 30.5mm
显示尺寸	160.0mm × 96.0mm
外形尺寸	170.20mm × 111.20mm × 0.91mm
工作电压	3.3V / 5V（IO电平电压要和供电电压一致）
通信接口	SPI
点距	0.2mm × 0.2mm
分辨率	800 × 480
显示颜色	黑、白、绿、蓝、红、黄
灰度等级	2
刷新时间	12s
刷新功耗	< 70 mW（typ.）
休眠电流	< 0.01uA（接近0）
工作温度	0 ~ 50 ℃
存储温度	-25 ~ 60 ℃

刷新时间：刷新时间为实验测试数据，实际刷新时间会有误差，以实际效果为准。全局刷新过程中会有闪烁效果，这个是正常现象。
刷新功耗：功耗数据为实验测试数据，实际功耗由于驱动板的存在和实际使用情况不同，会有一定误差，以实际效果为准。
在低温环境下进行刷新可能出现显示偏色，需要在25℃的环境中静止6小时后，在进行刷新。
给像素点写入 0x4 的数据时，也是可以显示橙色的，但是在目前的硬件环境下不建议使用。

通信方式

CSB（CS）：从机片选信号，低电平有效，为低电平的时候，芯片使能。
SCL（SCK/SCLK）：串行时钟信号。
D/C（DC）：数据/命令控制信号，低电平时写入命令（Command）；高电平时写入数据（Data/parameter）。
SDA（DIN）：串行数据信号。
时序：CPHL=0，CPOL=0，即 SPI 模式0。
【备注】具体关于SPI通信的相关信息，可以自行网上搜索资料了解。

工作原理

本产品使用的电子纸采用“微胶囊电泳显示”技术进行图像显示，其基本原理是悬浮在液体中的带电纳米粒子受到电场作用而产生迁移。电子纸显示屏是靠反射环境光来显示图案的，不需要背光，在环境光下，电子纸显示屏清晰可视，可视角度几乎达到了 180°。因此，电子纸显示屏非常适合阅读。

编程原理

对于计算机来说，图片是由像素点构成的，而每一个像素点所占的空间大小就决定了这个像素点可能的状态（颜色）多少，最简单的黑白图片每个像素点只占一位(1Bit)，不是0就是1非黑即白，随着颜色的增加，每一个像素点占用的空间越来越大，八位、十六位、二十四位……
本模块使用的是一种非标准二十四位图，如果需要自己制作图片可以参考"图片处理"章节。

对于黑白图片，我们可以规定，如果是黑色我们定义成0，如果是白色就定义成1，那么有了表示颜色的方式：
- 白色：□，对应1
- 黑色：■：对应0
一个点在图形上一般称之为像素点（pixel）,而颜色不是1就是0，也就是1个位就可以标识颜色：1Pixel = 1bit，那么一个字节里面就包含了8个像素点。
以16个像素点为例，我们假设前8个像素点为黑，后8个像素点为白色，那么可以这么认为，像素点1-16，对应这0位到15位，0表示黑色，1表示白色：

对于计算机而言，它的数据存储方式是高位在前，低位在后，且一个字节只有8个位，因此会有一点改变：

这样只需要2个字节即可表示16个像素点了。

现在假设我们有六种颜色，所以最少需要三位数据才能表示所有颜色，但为了方便运算我们在它前面加一个0，即用四位数据表示一个像素点的颜色，这样一个字节(1Byte)可以表示两个像素点。其实本模块的控制器使用的就是这种方式。

以四个像素点为例，我们假设这四个点的颜色依次为黄、蓝、红、绿，结合上表，那么人的逻辑是这样的，依次存储：

对于计算机而言，它的数据存储方式是高位在前，低位在后，且一个字节只有八位，因此存储在字节中是这样的：

注意事项

支持局刷的屏幕，注意使用的时候不能一直用局刷对屏幕进行刷新，需要在做几次局刷之后，对屏幕进行一次全刷清屏。否则会造成屏幕显示效果异常。
三色或多色的墨水屏在批量的时候，会存在一定的色差，这个是正常现象，建议将屏幕刷白朝上存放，使用前，先上电做几次刷白操作。
注意屏幕不能长时间上电，在屏幕不刷新的时候，要将屏幕设置成睡眠模式，或者进行断电处理。否则屏幕长时间保持高电压状态，会损坏膜片，无法修复。
使用墨水屏的时候，建议刷新时间间隔至少是180s, 并且至少每24小时做一次刷新，如果长期不使用墨水屏的话，要将墨水屏刷白存放。（具体储存环境需求参考数据手册）
屏幕进入睡眠模式之后，会忽略发送的图片数据，只有重新初始化才能正常刷新。
控制 0x3C 或 0x50 （具体参照数据手册）寄存器可以调节边框颜色，在例程中可以调节 Border Waveform Control 寄存器或者 VCOM AND DATA INERTVAL SETTING 进行设置。
如果发现制作的图片数据在屏幕上显示错误，建议检查一下图片大小设置是否正确，调换一下宽度和高度设置再试一下。
墨水屏的工作电压要求是 3.3V，如果您购买的是裸屏的话，设计电路的时候如果需要配合 5V 工作环境的话，建议做一下电平转换处理。新版驱动板（Rev2.1及后续版本）加入了电平处理电路，可以同时支持 3.3V 和 5V 工作环境，老版本只能支持 3.3V 工作环境，使用的时候可以先确认一下版本号（版本号在板名下）。
屏幕的 FPC 排线比较脆弱，请注意：不要沿屏幕垂直方向弯曲排线，避免排线被撕裂；不要反复过度弯曲排线，避免排线断裂；不要往屏幕正面方向弯曲排线，避免排线与面板的连接断开。调试研发时建议固定排线后使用。
墨水屏屏幕较为脆弱，注意尽量避免跌落、碰撞、用力按压。
我们建议客户拿到屏幕之后，先用我们提供的示例程序，使用对应的开发板进行测试。

图片处理

多色墨水屏的图片制作与转换

图片制作

准备

所需软件：Adobe PhotoShop CC、画图

介绍

Floyd-Steinberg抖动算法非常适合在颜色数量很少的情况下，展示出丰富的层次感。使得获得更多的颜色组合，对原始图片进行更好的阴影渲染。特别适合电子墨水屏的各种使用场景。
以下将介绍如何将普通图片转为Floyd-Steinberg散点图。
如果你对实际的算法有兴趣，可以了解我们在ESP32和ESP8266的算法移植。在这里不在赘述。

操作步骤

准备工作：将颜色表下载到PC机，解压得到如下图文件，我们要用到的是 N-color.act 或者 4-color.act。

1. 新建Photoshop工程，按电子墨水屏的实际分辨率设置宽度和高度，颜色模式使用RGB颜色。如果使用的屏幕分辨率为800*480，将宽改为800像素，高改为480像素即可。

2. 准备好相应的素材，复制到工程中，调整好大小、对比度之类的参数（和一般Photoshop的处理图片的步骤类似）。

3. 选择文件-》存储为Web和设备所用格式。

4. 如下图选择载入颜色表。载入准备工作中所提供的颜色表。

5. 对于七色的图片，载入N-color.act，之后点击存储，保存为gif文件即可。然后转换成BMP格式即可在本模块上使用。
对于四色的图片，载入4-color.act，之后点击存储，保存为gif文件即可。然后转换成BMP格式即可在本模块上使用。

6.使用画图打开gif文件，将其另存为为24位的bmp图片。

7.至此，图片已经制作完成，可以把它放到树莓派或e-Paper Shield模块的SD卡中使用，或者参照下一节转换成数组供其他嵌入式设备使用。

图片数据转换

下载程序

四色应用程序：四色图片转换应用程序
七色应用程序：七色图片转换应用程序
源码：程序源码

注：该应用为方便您的使用友情提供且开源，我司不对其提供技术支持

BUG解决

如果你的电脑是 win10/win11 系统，并且没有安装 VS（Microsoft Visual Studio）或者其他微软的开发工具，在使用本程序时可能出现下面的错误提示

这个表示你电脑中缺少这两个组件，解决办法如下
1、安装 VS（Microsoft Visual Studio）或者其他微软的开发工具（Visual C++ Redistributable 等）
2、使用我们提供的两个组件文件

将这两个文件放到目录 C:\Windows\System32 下，然后重启电脑即可

转换步骤

将制作好的图片和对应的exe应用程序放在同一文件夹，可以同时放入多个图片。
将图片拖放到exe文件上，程序会把图片转换成固定名称的.c文件。
双击cmd文件，程序会把文件夹内的所有符合尺寸的图片转换生成相应名字的.c文件。

Raspberry Pi

硬件连接

连接树莓派的时候，可以直接将板子插到树莓派的 40PIN 排针上去，注意对好引脚。
如果是选择用 8PIN 排线连接的话，请参考下方的引脚对应表格：

树莓派连接引脚对应关系
e-Paper	Raspberry Pi
e-Paper	BCM2835编码	Board物理引脚序号
VCC	3.3V	3.3V
GND	GND	GND
DIN	MOSI	19
CLK	SCLK	23
CS	CE0	24
DC	25	22
RST	17	11
BUSY	24	18

开启SPI接口

打开树莓派终端，输入以下指令进入配置界面：

sudo raspi-config
选择Interfacing Options -> SPI -> Yes 开启SPI接口

重启树莓派：

sudo reboot

检查 /boot/config.txt，可以看到 'dtparam=spi=on' 已被写入

为了确保 SPI 没有被占用，建议其他的驱动覆盖暂时先关闭。可以使用 ls /dev/spi* 来检查 SPI 占用情况，终端输出 /dev/spidev0.0 和 /dev/spidev0.1 表示 SPI 情况正常

运行C语言例程

安装 lg 库

#打开树莓派终端，并运行以下指令：
wget https://github.com/joan2937/lg/archive/master.zip
unzip master.zip
cd lg-master
make
sudo make install
# 更多的可以参考源码：https://github.com/gpiozero/lg

安装 gpiod 库（可选）

#打开树莓派终端，并运行以下指令：
sudo apt-get update
sudo apt install gpiod libgpiod-dev

安装 BCM2835（可选）

#打开树莓派终端，并运行以下指令：
wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz
tar zxvf bcm2835-1.71.tar.gz 
cd bcm2835-1.71/
sudo ./configure && sudo make && sudo make check && sudo make install
# 更多的可以参考官网：http://www.airspayce.com/mikem/bcm2835/

安装 wiringPi（可选）

#打开树莓派终端，并运行以下指令：
sudo apt-get install wiringpi
#对于树莓派2019年5月之后的系统（早于之前的可不用执行），可能需要进行升级：
wget https://project-downloads.drogon.net/wiringpi-latest.deb
sudo dpkg -i wiringpi-latest.deb
gpio -v
# 运行 gpio -v 会出现 2.52 版本，如果没有出现，说明安装出错。

#Bullseye 分支系统使用如下命令：
git clone https://github.com/WiringPi/WiringPi
cd WiringPi
./build
gpio -v
# 运行 gpio -v 会出现 2.60 版本，如果没有出现，说明安装出错。

下载程序（已下载可跳过）

wget https://www.waveshare.net/w/upload/7/71/E-Paper_code.zip
unzip E-Paper_code.zip -d e-Paper
cd e-Paper/RaspberryPi_JetsonNano/

备用解压方式

sudo apt-get install p7zip-full
7z x E-Paper_code.zip -O./e-Paper
cd e-Paper/RaspberryPi_JetsonNano/

通过 GitHub 下载程序（备用方式，已下载可跳过）

目前访问 GitHub 并不是很流畅，建议使用上面的方法从我们官网下载。

git clone https://github.com/waveshare/e-Paper.git
cd e-Paper/RaspberryPi_JetsonNano/

编译程序（说明：-j4 为使用4线程编译，数字可自行修改；EPD=epd7in3e 是指定一个宏定义，epd7in3e 对应主函数中的测试程序）

# 此时在 e-Paper/RaspberryPi_JetsonNano 位置
cd c
sudo make clean
sudo make -j4 EPD=epd7in3e

运行程序

sudo ./epd

运行python例程

安装函数库

sudo apt-get update
sudo apt-get install python3-pip
sudo apt-get install python3-pil
sudo apt-get install python3-numpy
sudo pip3 install spidev

安装函数库（python2）

sudo apt-get update
sudo apt-get install python-pip
sudo apt-get install python-pil
sudo apt-get install python-numpy
sudo pip install spidev

安装gpiozero库（系统默认已安装，如果没有安装请按照以下命令进行安装）

sudo apt-get update
# python3
sudo apt install python3-gpiozero
# python2
sudo apt install python-gpiozero

下载程序（已下载可跳过）

wget https://www.waveshare.net/w/upload/7/71/E-Paper_code.zip
unzip E-Paper_code.zip -d e-Paper
cd e-Paper/RaspberryPi_JetsonNano/

备用解压方式

sudo apt-get install p7zip-full
7z x E-Paper_code.zip -O./e-Paper
cd e-Paper/RaspberryPi_JetsonNano/

通过 GitHub 下载程序（备用方式，已下载可跳过）

目前访问 GitHub 并不是很流畅，建议使用上面的方法从我们官网下载。

git clone https://github.com/waveshare/e-Paper.git
cd e-Paper/RaspberryPi_JetsonNano/

运行程序

# 确保在 e-Paper/RaspberryPi_JetsonNano/ 位置
cd python/examples/
python3 epd_7in3e_test.py

Arduino

硬件连接

使用 8PIN 排线连接，请参考下方的引脚对应表格：

Arduino连接引脚对应关系
e-Paper	Arduino UNO	Mega2560
VCC	5V	5V
GND	GND	GND
DIN	D11	D51
CLK	D13	D52
CS	D10	D10
DC	D9	D9
RST	D8	D8
BUSY	D7	D7

安装IDE

Arduino IDE Windows 安装教程

运行程序

在资料界面下载程序，然后解压进入 E-Paper_code 目录可以看到下面的内容

打开测试程序：E-Paper_code\Arduino-R4\Arduino_R4.ino，然后取消对应注释
在 Arduino IDE 中的工具栏（Tools）选择对应的开发板（Board）和端口（Port）

最后点击上传即可。（Arduino 1.8.13）

Jetson Nano

硬件连接

Jetson Nano 的 40PIN 引脚是兼容树莓派的 40PIN 引脚的，并且提供了一个 Jetson.GPIO 库跟树莓派的 RPI.GPIO 库的 API 是一致的，所以这里连接的序号跟树莓派的是一样的，使用 40PIN 接口时，可以直接将模块插入 Jetson Nano 的 40Pin 排座。
如果是选择用 8PIN 排线连接的话，请参考下方的引脚对应表格：

Jetson nano连接引脚对应关系
e-Paper	Jetson Nano Developer Kit
e-Paper	BCM2835编码	Board物理引脚序号
VCC	3.3V	3.3V
GND	GND	GND
DIN	10(SPI0_MOSI)	19
CLK	11(SPI0_SCK	23
CS	8(SPI0_CS0)	24
DC	25	22
RST	17	11
BUSY	24	18

运行C语言例程

下载程序（已下载可跳过）

wget https://www.waveshare.net/w/upload/7/71/E-Paper_code.zip
unzip E-Paper_code.zip -d e-Paper
cd e-Paper/RaspberryPi_JetsonNano/

备用解压方式

sudo apt-get install p7zip-full
7z x E-Paper_code.zip -O./e-Paper
cd e-Paper/RaspberryPi_JetsonNano/

通过 GitHub 下载程序（备用方式，已下载可跳过）

目前访问 GitHub 并不是很流畅，建议使用另一种方法从我们官网下载。

git clone https://github.com/waveshare/e-Paper.git
cd e-Paper/RaspberryPi_JetsonNano/

编译程序（说明：JETSON 是指定设备为 jetson nano，不指定默认为树莓派；-j4 为使用4线程编译，数字可自行修改；EPD=epd7in3e 为指定一个宏定义，epd7in3e 对应主函数中的测试程序）

# 此时在 e-Paper/RaspberryPi_JetsonNano 位置
cd c
sudo make clean
sudo make JETSON -j4 EPD=epd7in3e

运行程序

sudo ./epd

运行python例程

安装函数库

sudo apt-get update
sudo apt-get install python3-numpy
sudo apt-get install python3-pip
sudo pip3 install Jetson.GPIO

下载程序（已下载可跳过）

wget https://www.waveshare.net/w/upload/7/71/E-Paper_code.zip
unzip E-Paper_code.zip -d e-Paper
cd e-Paper/RaspberryPi_JetsonNano/

备用解压方式

sudo apt-get install p7zip-full
7z x E-Paper_code.zip -O./e-Paper
cd e-Paper/RaspberryPi_JetsonNano/

通过 GitHub 下载程序（备用方式，已下载可跳过）

目前访问 GitHub 并不是很流畅，建议使用上面的方法从我们官网下载。

git clone https://github.com/waveshare/e-Paper.git
cd e-Paper/RaspberryPi_JetsonNano/

运行程序

# 确保在 e-Paper/RaspberryPi_JetsonNano/ 位置
cd python/examples/
python3 epd_7in3e_test.py

Sunrise X3 Pi

硬件连接

连接旭日派的时候，可以直接将板子插到旭日派的 40PIN 排针上去，注意对好引脚。
如果是选择用 8PIN 排线连接的话，请参考下方的引脚对应表格：

Sunrise X3 Pi连接引脚对应关系
e-Paper	Sunrise X3 Pi
e-Paper	BCM编码	Board物理引脚序号
VCC	3.3V	3.3V
GND	GND	GND
DIN	MOSI	19
CLK	SCLK	23
CS	CE0	24
DC	25	22
RST	17	11
BUSY	24	18

开启SPI

SPI 是默认开启的，如果不小心关闭请按照以下方法进行开启

输入命令： sudo srpi-config

运行python程序

对应的库在函数中已安装完成，如果不小心卸载，请使用下面的命令进行安装

sudo apt-get update
sudo apt-get install python-pip
sudo apt-get install python-pil
sudo apt-get install python-numpy
sudo pip install Hobot.GPIO
sudo pip install spidev

下载程序（已下载可跳过）

wget https://www.waveshare.net/w/upload/7/71/E-Paper_code.zip
unzip E-Paper_code.zip -d e-Paper
cd e-Paper/RaspberryPi_JetsonNano/

备用解压方式

sudo apt-get install p7zip-full
7z x E-Paper_code.zip -O./e-Paper
cd e-Paper/RaspberryPi_JetsonNano/

通过 GitHub 下载程序（备用方式，已下载可跳过）

目前访问 GitHub 并不是很流畅，建议使用上面的方法从我们官网下载。

git clone https://github.com/waveshare/e-Paper.git
cd e-Paper/RaspberryPi_JetsonNano/

运行程序

# 确保在 e-Paper/RaspberryPi_JetsonNano/ 位置
cd python/examples/
python3 epd_7in3e_test.py

STM32

硬件连接

使用 8PIN 排线连接，请参考下方的引脚对应表格：

STM32连接引脚对应关系
e-Paper	STM32
VCC	3.3V
GND	GND
DIN	PA7
CLK	PA5
CS	PA4
DC	PA2
RST	PA1
BUSY	PA3

运行程序

点击下载程序，然后解压进入 E-Paper_code 目录可以看到下面的内容

使用 Keil 打开 E-Paper_code\STM32\STM32-F103ZET6\MDK-ARM 目录下的 epd-demo.uvprojx
打开 Keil 的编译工具栏（一般情况已经打开了）

在图片所示位置选择 EPD_7in3e_test 目标

点击编译。

确保已连接合适的烧录器，然后点击下载（LOAD）将程序下载到单片机中

斑梨电子

7.3寸电子墨水屏 E使用教程

说明

各项参数

通信方式

工作原理

编程原理

注意事项

图片处理

图片制作

准备

介绍

操作步骤

图片数据转换

下载程序

BUG解决

转换步骤

Raspberry Pi

硬件连接

开启SPI接口

运行C语言例程

运行python例程

Arduino

硬件连接

安装IDE

运行程序

Jetson Nano

硬件连接

运行C语言例程

运行python例程

Sunrise X3 Pi

硬件连接

开启SPI

运行python程序

STM32

硬件连接

运行程序

资料

文档

程序

开发资料

相关链接

FAQ

软件问题

问题：STM32 驱动墨水屏，MDK 编译显示空间不够？

问题：关于 datasheet 的问题。字库什么时候传输 Data Start Transmission 1，什么时候用 Data Start Transmission 2？

问题：电子墨水屏上无法显示中文？

问题：e-Paper 显示黑边框？

问题：多个位置局刷，局刷几次后字体偏浅？

问题：墨水屏在 deep sleep mode 时，第一次唤醒画面刷新会有不干净的问题，请问如何解决？

问题：测试程序时，程序一直卡在 e-Paper busy？

问题：为什么局刷后再全刷无法显示图像？

问题：为什么运行 python 程序时打印信息正常但墨水屏没有反应？

问题：运行 python 程序的时候报错 ImportError: No module named Image?

硬件问题

问题：Arduino 5V 能不能驱动墨水屏？

问题：设计驱动板要注意什么？

问题：可以使用模拟 SPI 吗？

问题：为什么 BUSY 引脚一直处于忙状态？

问题：屏幕排线接口是什么规格？

问题：墨水屏使用的是什么型号的连接器？

屏幕问题

问题：电子墨水屏的使用环境？

问题：电子墨水屏刷新注意事项

问题：电子墨水屏的刷新次数是多少/使用寿命是多少？

问题：使用一段时间之后屏幕刷新（全刷）出现严重残影问题无法修复？

问题：墨水屏进入深入睡眠模式后，是否可以再次刷新？

问题：为什么显示图像偏移

问题：什么是电子墨水屏的波形文件，有什么作用？

问题：LUT和OTP代表什么意思？

问题：电子纸的局刷过程？

问题：如何在不同位置同时局刷？

问题：三色e-Paper有色差偏红/黄的情况？

问题：裸屏产品出货时是否有表面覆膜？

问题：请问e-Paper内置温度传感器吗？

7.3寸电子墨水屏模块E6彩色6色ePaper适用于Arduino树莓派STM32/Jetson

[教程导航]