2.13寸黑白电子墨水屏教程

版本说明

由于芯片升级，2.13inch e-Paper 将升级为2.13inch e-Paper v2版本。新老程序无法兼容。v2版本与老版本对比，除了芯片和驱动程序之外，其他外观和功能都兼容。如果您是老客户，需要再次采购新屏幕的话，注意更新程序。如果您是第一次采购，并且拿到的是新款屏幕，直接使用新版程序即可。新版屏幕的标签上带有v2的后缀。请注意区分

特点

尺寸： 2.13 inch
外形尺寸（裸屏）：59.2mm × 29.2mm × 1.05mm
外形尺寸（驱动板）：65mmx30.2mm
显示尺寸：48.55mm × 23.71mm
工作电压：3.3V/5V
通信接口：SPI
点距：0.194* 0.194
分辨率：250*122
显示颜色：黑、白
灰度等级：2
局部刷新：0.3s
全局刷新：2s
刷新功耗： 26.4mW(typ.)
待机功耗：<=0.017mW

【备注】：刷新时间：刷新时间为实验测试数据，实际刷新时间会有误差，以实际效果为准。全局刷新过程中会有闪烁效果，这个是正常现象
功耗：功耗数据为实验测试数据，实际功耗由于驱动板的存在和实际使用情况的不同，会有一定误差，以实际效果为准

SPI 通信时序

由于墨水屏只需要显示，这里将从机发，主机收的数据线（MISO）隐藏。
CS：从机片选，当CS为低电平的时候，芯片使能
DC：数据/命令控制引脚，当DC=0时写入命令；DC=1时写入数据
SCLK： SPI通信时钟
SDIN：SPI通信主机发送，从机接收
时序：CPHL=0， CPOL=0 （SPI0）
【备注】具体关于SPI通信的相关信息，可以自行网上搜索资料了解

墨水屏刷新原理

像素与字节的关系

对于黑白图片，我们可以规定，如果如果是黑色我们定义成0，如果是白色就定义成1，那么有了表示颜色的方式：
白色：□，对应1
黑色：■：对应0

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

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

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

教程

电子墨水屏树莓派使用教程
电子墨水屏Jetson nano使用教程
电子墨水屏STM32使用教程
电子墨水屏Arduino使用教程

文档

程序

旧版本

数据手册

2.13inch e-Paper Datasheet.pdf

V2版本

2.13inch e-Paper Specification

开发资料

相关资料

外壳图纸(PiSugar)

问题：怎么区分使用的程序版本？

答复:
目前2.13inch e-paper仅存在两种版本的程序，可以通过查看e-paper背面是否有V2标识 2.13inch e-paper HAT存在两种不同的底板，可以通过查看背面是否贴有V2：

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

答复:
【工作条件】温度范围：0~50°C ；湿度范围：35%~65%RH 【存储条件】：温度范围：30°C以下；湿度范围：55%RH以下；存储最长时间：6个月【运输条件】：温度范围：-25~70°C ；运输最长时间：10天【拆包后】：温度范围：20°C±5°C ；湿度范围：50±5%RH；存储最长时间：72小时内完成组装

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

答复:
刷新模式全刷：电子墨水屏在刷新过程中会闪烁多次（闪烁次数取决于刷新时长），闪烁是为了清除残影达到最佳的显示效果局刷：电子墨水屏在刷新过程中无闪烁效果。使用局刷功能的用户注意在刷新几次之后，要进行一次全刷操作清除残影，否则残影问题会越来越严重，甚至损坏屏幕（目前只有部分黑白电子墨水屏支持局刷，具体参考产品页面说明）刷新频率使用过程中，建议客户设置电子墨水屏的刷新间隔至少为180秒（支持局刷功能的产品除外）待机过程（即刷新操作后）建议客户将电子墨水屏设置为睡眠模式，或者断电操作（可以将墨水屏供电部分用模拟开关断开），降低功耗并且延长电子墨水屏寿命。（部分电子墨水屏如果长时间处于上电状态的话，会出现屏幕损坏无法修复的情况）三色电子墨水屏在使用的过程中，建议客户至少每24小时更新一次显示画面（如果屏幕长时间保持同一个画面，会出现烧屏情况难以修复）使用场所电子墨水屏建议是在室内使用。如果在户外使用，需要避免电子墨水屏受阳光直射，同时要做好紫外线防护措施。在设计电子墨水屏产品的时候，客户注意要确定好使用环境是否满足电子墨水屏的温湿度要求

问题：Arduino3.3V能不能驱动墨水屏？

答复:
可以，现在已经板载了电平转换芯片，支持3.3V驱动

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

答复:
长时间上电开发板，在每次刷新操作之后，建议将屏幕设置为睡眠模式或者直接断电处理，否则屏幕长时间处于高电压状态下可能烧坏屏幕

问题：e-Paper显示偏黑或者颜色偏浅？

答复:
可以调节程序中Vcom的值改变显示对比度，带局刷的屏幕改善效果特别明显。

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

答复:
可以通过Border Waveform Control寄存器或者VCOM AND DATA INTERVAL SETTING寄存器设置边框显示颜色。

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

答复:
0.5mm间距，24Pin。

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

答复:
使用指令sudo apt-get install python-imaging 安装一下imaging函数库

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

答复:
这种情况需要客户减少局刷位置并且在局刷5次后进行一次清屏（提高VCOM的电压可以改善颜色，但是带来是残影加重）。

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

答复:
可以，但是需要用软件重新做电子纸初始化操作。

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

答复:
电子墨水屏重新唤醒的过程，实际是重新上电的过程，所以EPD在wake up时，要先进行清屏的动作，这样才能最大程度地避免残影现象。

问题：关于datasheet的问题。客户问字库什么时候传输Data Start Transmission 1，什么时候用 Data Start Transmission 2.在KW mode 下，什么是“OLD”数据，什么是"NEW"数据。

答复:
如果是三色屏，在需要传输B/W数据时，使Data Start Transmission 1，在传输RED数据时，使用Data Start Transmission 2，因为2.13inch e-Paper HAT (D)只能显示黑白两色，所以工作在KW模式Data Start Transmission 1时，发送上一次的数据，即所谓的old，在程序中就直接发送0x00，在Data Start Transmission 2时，就发送需要刷新的数据，即所谓的“NEW”数据。

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

答复:
排线插座 0.5-24pin 后翻盖式 2.0H（FPC连接器）

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

答复:
有覆膜

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

答复:
是的，也可以使用IIC管脚外置LM75温度传感器

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

答复:
可能是spi驱动不成功导致的1.先检查接线是否正确2.在检查spi是否开启，参数是否配置正确（spi的波特率，spi模式等参数)

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

答复:
理想情况下，正常使用，可以刷新1000000次(100万次)

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

答复:
我们例程使用的是stm32f103zet6，如果客户在MDK中修改其他的型号，例如stm32f103rbt6，ram空间变小了，需要在原基础上修改启动文件中的stack size和heap size

TAG： ESP32 C6开发板1.47寸LCD显示屏172x320带RGB灯SD槽兼容Arduino 树莓派PICO USB调试 ESP32-S3开发板 1.46寸圆形LCD显示屏412x412 触摸屏板载加速度与陀螺仪QMI8658传感器/SD卡槽/电池接口/麦克风/RTC/MP3喇叭音频适用于Arduino Raspberry Pi 5 双向透明传输串口服务器刷机线电脑副屏 RP2040-PiZero 树莓派5 PD诱导 Type-C 电子眼睛0.71寸圆形LCD显示屏液晶屏适用于Arduino/树莓派/PICO/STM32 4寸圆形LCD电容触摸HDMI显示屏适用于mini PC树莓派Jetson 树莓派13.3寸LCD DSI显示屏MIPI触摸屏1920x1080 树莓派5 DSI显示屏 1.5寸OLED ABS 树莓派5散热片 T Watch S3 ESP32 S3 PMU 1.54寸可触摸显示屏编程手表 SX1262 433/868/915MHz兼容LILYGO 1.83寸LCD触摸显示屏240&amp;amp;amp;amp;times;280 NV3030B Arduino 树莓派 ESP32 Pico STM32 Modbus

树莓派2.13寸墨水屏模块 250×122分辨率黑白 e-paper

TAG： ESP32小电视TV太空人LVGL时钟手表1.69寸LCD显示触摸屏 240x280 Arduino UNO R4 Minima e-Paper 2.4Ghz板砖天线SeeedStudio-XIAO C3 S3 Arduino 0.85寸LCD 树莓派IR-CUT星光摄像头(A) IMX462 90度 ESP32 S3 TFT 树莓派USB M.2 4G 5G LTE GSM GPRS EDGE RM500 SIM8200 GM800 Samsung ARTIK Rock64 Asus Tinker Latte Panda 802.11模组 ESP32 S3 1.43寸AMOLED显示屏触摸6轴传感器Arduino ESP32 USB Dongle 树莓派摄像头树莓派5 FAN Seeed Studio XIAO ESP32C3 WIFI蓝牙Arduino RP2040 LoRa HF DeepSeek ESP32人工智能语音聊天机器人0.85寸屏LCD MINI小智虾哥原装Arduino MEGA2560 R3 工业级树莓派5官方散热器