树莓派2.9寸柔性电子墨水屏使用教程

特点

尺寸： 2.9inch
外形尺寸（裸屏）：79.0mm × 36.7mm × 0.34mm
外形尺寸（驱动板）：89.5mm × 38mm
显示尺寸：66.9mm x 29.06mm
工作电压：3.3V/5V
通信接口：SPI
点距：0.138 x 0.138
分辨率：296 x 128
显示颜色：黑、白
灰度等级：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个像素点了。

文档

程序

旧版本示例程序

旧版本示例程序

数据手册

2.9inch e-Paper (D) Datasheet

开发资料

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

答复:
刷新模式全刷：电子墨水屏在刷新过程中会闪烁多次（闪烁次数取决于刷新时长），闪烁是为了清除残影达到最佳的显示效果局刷：电子墨水屏在刷新过程中无闪烁效果。使用局刷功能的用户注意在刷新几次之后，要进行一次全刷操作清除残影，否则残影问题会越来越严重，甚至损坏屏幕（目前只有部分黑白电子墨水屏支持局刷，具体参考产品页面说明）刷新频率使用过程中，建议客户设置电子墨水屏的刷新间隔至少为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小摆件LVGL太空人时钟手表1.69寸圆LCD显示触摸屏ST7789 240x280 树莓派mSATA扩展板树莓派5 USB音频声卡Raspberry Pi 5耳机口扬声器喇叭树莓派4B ESP32-S3 X1202 树莓派5 UPS电源管理扩展板18650不间断供电模块树莓派Pico 2 RP2350-One 迷你开发板Type-A RP2350A 1.54英寸无源NFC电子墨水屏黑白红3色无须电池无线供电&刷图 Milk-V Duo camera 树莓派5外壳 MPS2280 POE树莓派5 PCIE M.2 NVME SSD固态硬盘 Pi5 2280/2242/2230 UNO R4 WiFi 14寸双显示屏笔记本电脑扩展屏 LCD 1080P 内置重力感应喇叭树莓派5外壳 MiniPCIe接口CAN卡双通道 USB转Can带电气隔离和多重保护电路Linux/Windows AI机器视觉套件OAK-D-POE 1200万像素4TOPS OpenCV摄像头 Arduino SH1107 DeepSeek ESP32人工智能语音聊天机器人树莓派UGV Beast ROS2 越野履带开源AI云台机器人小车OpenCV X1201 树莓派5 UPS电源管理扩展板18650不间断供电模块 nRF528xx电子墨水屏驱动板

价格：

¥123

型号：

2.9inch-e-Paper-HAT-(D)

树莓派2.9寸柔性墨水屏 296×128分辨率黑白

TAG： RV1103摄像头 Milk-V Duo 256MB TTL转CAN MINI 双向透明传输串口服务器 ESP32 S3开发板3.5寸虾哥小智AIDeepSeek人工智能语音聊天机器人盒子 QSPI高刷 N16R8 QMI8658 6轴/触摸/摄像头树莓派三连屏 ESP32-S3 LCD Intel 1112代 Raspberry Pi 5 Official Original AI Kit Hailo8l 13Tops 26Tops PCIe M.2 HAT Pi5 USB转CAN FD数据逻辑分析仪 ESP32-S3 QMI8658A WIFI蓝牙树莓派5散热片 ESP32 1.5寸LCD 树莓派4代B ESP32-S3 LVGL 树莓派不间断供电电源 ESP32 S3 MINI开发板 2.66寸四色红黄黑白墨水屏模块e-Paper 360×184适用于Arduino树莓派STM32 Jetson斑梨 4寸电容触摸480x480显示屏LCD幸狐Luckfox Pico Ultra