5.79寸电子墨水屏使用教程

文档

程序

开发资料

软件问题

问题：树莓派运行python程序出现以下情况

输入命令： ls /dev/spi*
这是因为在 /boot/config.txt 文件中对SPI接口进行了占用
解决方法如下：
- 删除 /boot/config.txt 文件中对 spi0-0 的占用
- 修改 /e-Paper/RaspberryPi_JetsonNano/lib/waveshare_epd/epdconfig.py 文件中图片所示位置，将其改为0,1

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

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

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

在 Data Start Transmission 1 时，发送上一次的数据，即所谓的“OLD”数据，一般在程序中就直接发送 0x00；在 Data Start Transmission 2 时，就发送需要刷新的数据，即所谓的“NEW”数据。

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

我们的例程的中文字库是使用 GB2312 的编码方式，请将您的 xxx_test.c 文件改成 GB2312 编码格式编译下载后即可正常显示。

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

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

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

这种情况需要客户减少局刷位置并且在局刷5次后进行一次清屏。

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

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

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

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

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

墨水屏从局刷切换为全刷时需要加入全刷初始化函数。

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

可能是之前运行过C语言的基于 BCM2835 库的例程，此时需要重启树莓派再运行 python 例程。

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

使用指令 "sudo apt-get install python-imaging" 安装一下 imaging 函数库。

硬件问题

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

可以，现在已经板载了电平转换芯片，支持 5V 驱动。

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

墨水屏额定输入电压是 2.3~3.6V，如果是 5V 系统需要做电平转换，另外电压最好不要低于 2.5V，以免影响墨水屏显示效果。
器件选型可以使用我们提供的原理图中的型号或者根据数据手册选择都是可以的。

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

可以，注意需要时序正确。

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

确认 SPI 通信是否正常。
确认 BUSY 引脚是否正常初始化为输入模式。
可能是没有正常复位，尝试缩短复位时低电平的持续时间。（因为驱动电路加入了断电开关，复位低电平过长会导致驱动板断电导致复位失败）
如果判忙函数有发送 0x71 命令，可以尝试注释掉。

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

1.64inch、2.36inch、3inch，为0.5mm 间距，26Pin
1.02inch，为0.5mm 间距，30Pin
4.37inch、7.3inch，为0.5mm 间距，50Pin
其余（非并口），为0.5mm 间距，24Pin。

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

排线插座 0.5-XXpin 后翻盖式 2.0H（FPC连接器）。

屏幕问题

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

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

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

刷新模式：
- 全刷：电子墨水屏在刷新过程中会闪烁多次（闪烁次数取决于刷新时长），闪烁是为了清除残影达到最佳的显示效果。
- 局刷：电子墨水屏在刷新过程中无闪烁效果。使用局刷功能的用户注意在刷新几次之后，要进行一次全刷操作清除残影，否则残影问题会越来越严重，甚至损坏屏幕。（目前只有部分黑白电子墨水屏支持局刷，具体参考产品页面说明）
刷新频率：
- 使用过程中，建议客户设置电子墨水屏的刷新间隔至少为180秒。（支持局刷功能的产品除外）
- 待机过程（即刷新操作后）建议客户将电子墨水屏设置为睡眠模式，或者断电操作（可以将墨水屏供电部分用模拟开关断开），降低功耗并且延长电子墨水屏寿命。（部分电子墨水屏如果长时间处于上电状态的话，会出现屏幕损坏无法修复的情况）
使用场所：
- 电子墨水屏建议是在室内使用，不建议在户外使用。
- 如果使用场景是在户外，我们不保证其显示效果，如果因为是在户外使用导致出现的墨水屏损坏，我们不提供保修服务
- 以下是一些户外使用的防护，我们不保证做好这些防护后墨水屏可以正常使用
  - 避免电子墨水屏受阳光直射，同时要做好紫外线防护措施，因为带电粒子长时间在强光的照射下会发干，导致失去活性无法刷新，这种情况是不可逆的。
  - 在墨水屏连接排线上面白胶部分，使用3M胶将其完全覆盖，完全覆盖与不加，在紫外线下是有不同反应的。
  - 将墨水屏放在相对阴凉的区域，如树荫底下、屋檐阴影下面
- 在设计电子墨水屏产品的时候，客户注意要确定好使用环境是否满足电子墨水屏的要求。

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

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

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

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

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

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

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

可能 SPI 速率过高，导致数据丢失，尝试降低 SPI 速率。
供电不足或者电源不稳定导致数据丢失。
数据线过长导致数据丢失，延长线最好不要超过20cm。

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

电泳电子纸的显示灰阶由粒子在微胶囊或者微杯的空间位置所决定，黑色粒子与白色粒子在电压的作用下发生电泳现象，这种促使粒子发生电泳运动的电压时序就是电子纸的驱动波形。驱动波形为电子纸显示器的核心部分，对驱动波形的优化将直接影响显示器的显示效果。而驱动波形文件是用来说明促使粒子发生电泳运动的电压时序而形成的参数,在电子纸刷新时需要定期被调用。
不同批次的电子纸膜片，电泳矩阵因为材料、制作工艺等原因，在驱动显示时所需电压值会有所差异，反映在灰度与电压、温度关系的就是电子墨水屏的波形。一般来说，每一批次的电泳矩阵生成后，会有相应的波形文件，以 .wbf 文件形式存在，由膜片生产商将波形文件和电泳矩阵提供给生产电子纸屏的厂家，再由生产电子纸屏厂家集成保护板、基板和驱动器以后提供给客户；如果波形文件和屏幕不对应，很可能造成无法显示或者显示效果不理想。一般出厂时波形文件已经 OTP 内置于墨水屏的驱动 IC 内，并且我们提供的部分程序也有调用外部的波形文件来驱动电子墨水屏。

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

LUT 是 LOOK UP TABLE 的缩写，OTP 是 ONE TIME PROGRAM 的缩写，LUT 本意就是加载波形文件，而波形文件分 OTP 和 REGISTER 两种，其中 OTP 为内置波形存储方式，REGISTER 为外置波形存储方式。

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

主要有两种类型的墨水屏：
- 一种是先刷背景图。
- 另外一种是交替刷新旧数据和新数据。

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

在不同位置同时局刷需要在程序设计进行操作，即先把不同位置的数据刷到电子纸 IC 内，最后统一做好 Updata/TurnOnDisplay。

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

有覆膜。

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

目前所有屏幕都有内置温度传感器，也可以使用 IIC 管脚外置 LM75 温度传感器。

TAG： 360°电机 UART转WiFi 兼容T-Embed-CC1101 ESP32-S3 1.9寸LCD PN532开发板兼容LILYGO Jetson Orin 不间断电源 UPS模块支持同时充电和放电 DeepSeek ESP32 C6开发板小智AI 1.69寸LCD显示屏语音聊天可编程手表 240x280触摸 nRF528xx MX25R6435 树莓派PICO LoRa LF 8.8寸USB电脑机箱副屏RGB/桌搭氛围屏LCD1920x480带拾音功能 ESP32-C3FN4 CAN逻辑分析仪懒人键盘 ESP32-S3 1.28寸 ESP32-S3 1.14寸LCD TTGO Meshtastic T-Beam V1.2 ESP32 LoRa GPS开发板0.96 inch OLED SX1278/SX1276 433/868/915/923MHz兼容LILYGO 双电子眼睛0.71寸圆形LCD显示屏适用于Arduino/树莓派/PICO/STM32 树莓派5 RTC电池盒 1.91寸AMOLED ESP32-P4 PICO开发板C6 WiFi6 MIPI DSI 10.1寸显示屏/CSI摄像头/音频喇叭小智 AI Deepseek Jetson Orin 4G 3G 2G 扩展板GNSS GPS SIM7600G-H-M.2 树莓派摄像头1200万IMX708索尼传感器自动对焦摄像头 Module 3 Sensor Assembly