2.9寸黄黑白电子墨水屏使用教程

特点

尺寸： 2.9inch
外形尺寸（裸屏）：79.0mm × 36.7mm × 1.05mm
外形尺寸（驱动板）：89.5mm × 38mm
显示尺寸：66.89nn x 29.05mm
工作电压：3.3V/5V
通信接口：SPI
点距：0.138 x 0.138
分辨率：296 x 128
显示颜色：黄、白、红
灰度等级：2
全局刷新：15s
刷新功耗： 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个像素点了。

对于2.9inch e-paper C而言，是黑白黄三色

我们需要把图片拆成2张图片，一张黑白图片，一张黄白图片，在传输的时候因为一个寄存器是控制黑白显示的，一个寄存器是控制黄白显示。黑白部分1个字节控制8个像素点，黄白部分1个字节可以控制8个像素点
举个栗子，假设有8个像素点，前面4个是黄色色，后面4个黑色：需要把他们拆成一个黑白图片，一个红白图片，这两个图片都是8个像素点，只不过黑白图片前四个像素为白色，后4个像素点为黑色，而黄白图片前4个像素点为黄色，后四个像素点为白色；

如果我们规定，白色存储为1，红色或者黑色存储为0，那么就有了如下的表示：上面说了黑白

部分表示8个像素点需要1个字节，控制黄白1个字节控制8个像素点；

教程

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

文档

程序

旧版本示例程序

旧版本示例程序

数据手册

2.9inch e-Paper (B) Datasheet(使用的芯片一样，只是的颜色不一样)

开发资料

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

答复:
【工作条件】温度范围：0~40°C ；湿度范围：35%~65%RH 【存储条件】：温度范围：30°C以下；湿度范围：55%RH以下；存储最长时间：3个月【运输条件】：温度范围：-25~60°C ；运输最长时间：10天【拆包后】：温度范围：20°C±5°C ；湿度范围：50±5%RH；存储最长时间：72小时内完成组装三色电子墨水屏在存储的时候，显示画面需要保持白屏状态，显示面朝上放置，并且至少三个月内做一次刷新操作

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

答复:
是的，e-Paper在批量时，会有一些色差，这属于正常现象。把e-paper正面朝上存放，可在一定程度上减小偏红/黄的现象。

问题：三色如何作为单色使用？

答复:
三色e-Paper作为单色屏使用，需要加载外部波形的方式实现。

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

答复:
刷新模式全刷：电子墨水屏在刷新过程中会闪烁多次（闪烁次数取决于刷新时长），闪烁是为了清除残影达到最佳的显示效果局刷：电子墨水屏在刷新过程中无闪烁效果。使用局刷功能的用户注意在刷新几次之后，要进行一次全刷操作清除残影，否则残影问题会越来越严重，甚至损坏屏幕（目前只有部分黑白电子墨水屏支持局刷，具体参考产品页面说明）刷新频率使用过程中，建议客户设置电子墨水屏的刷新间隔至少为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：树莓派Pico ESP32-S3开发板 2.8寸圆形LCD显示屏480x480 触摸屏板载加速度与陀螺仪QMI8658传感器/SD卡槽/电池接口/麦克风/RTC/MP3喇叭音频适用于Arduino ESP32-S3开发板1.47寸LCD显示屏1.47B SD卡槽172×320 RGB LED 莓派5 MIPI摄像头 ESP32小车 ESP32显示屏双电子眼睛0.71寸圆形LCD显示屏适用于Arduino/树莓派/PICO/STM32 USB转I2C Luckfox Pico ESP32-P4-ETH以太网POE开发板RJ45 DSI显示屏/CSI摄像头/音频喇叭小智 AI Deepseek Modbus TCP RoArm-M2-S 步骤录制和重现 Arducam AF Camera 斑梨 0.96寸1.3寸1.44寸1.8寸LCD显示屏TFT圆形SPI液晶屏ST7735 ESP32-S3小智AI双目电子眼睛开发板触摸圆形1.28寸LCD显示屏玩具公仔手办机器人N16R8豆包Deepseek 幸狐Luckfox Pico摄像头 MIS5001 500万广角仅支持RV1106系列智能串口显示屏 Arduino SSD1357 斑梨

2.9寸电子墨水屏裸屏 296x128分辨率黄黑白

TAG：树莓派5 英伟达NVIDIA Jetson Orin Nano 8GB 40Tops AI人工智能开发板套件 4.26寸电子墨水屏树莓派5官方散热器树莓派5 PCIE M.2 NVME SSD固态硬盘Pi5 2242-2230 X1003迷你树莓派SSD扩展板高精度360°磁编码器UART串行总线舵机ST3025 TTL 40KG.CM高精度大扭矩树莓派原装高质量HQ摄像头模块1230 C CS型镜头IMX477 UART-WIFI232-B2 树莓派5 27W 树莓派Pico 2 RP2350B 2.1寸LCD圆形触摸显示屏 480x480 HMI LVGL QMI8658 6轴 65K彩色 ESP32 ESP32-S3 树莓派Pico 2 RP2350 1.47寸LCD显示屏开发板172x320带RGB灯SD槽 4.26寸电子墨水屏模块树莓派CAN总线双通道隔离型扩展板 USB TO RS485 树莓派5 MIPI转接线树莓派5 7.5英寸无源NFC电子墨水屏无须电池无线供电