产品 FAQ

示例说明

本页保留参考型号的通用排查方法和配图。涉及工程文件的操作需以 7.5inch_e-Paper_E 对应程序为准。

软件问题

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

• 输入命令： ls /dev/spi*

• 出现结果可能如图

  

• 这是因为在 /boot/config.txt 文件中对 SPI 接口进行了占用

  

• 解决方法如下：

  • 删除 /boot/config.txt 文件中对 spi0-0 的占用

  • 修改 7.5inch_e-Paper_E/example/RaspberryPi_JetsonNano/python/lib/waveshare_epd/epdconfig.py 文件中图片所示位置，将其改为 0,1

    

问：怎么使用其他自定义字体？

• 参考示例未提供其他字体文件，可使用社区分享的自定义字体编译器生成字体文件测试。注意：该工具非官方维护，仅供学习使用
  • https://github.com/ayoy/fontedit

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

• 参考例程使用 STM32F103ZET6。如果在 MDK 中改为其他型号，例如 STM32F103RBT6，RAM 空间变小了，需要在原基础上修改启动文件中的 stack size 和 heap size。

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

• 如果程序使用参考例程中的 GB2312 编码字库，将对应的 xxx_test.c 文件保存为 GB2312 编码后重新编译、下载。

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

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

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

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

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

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

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

• 参考例程使用 Python 2 时，可运行 sudo apt-get install python-imaging 安装 imaging 函数库。

硬件问题

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

• 模块版板载电平转换芯片，可接入 5 V 电平接口；裸屏工作电压为 3.3 V。

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

• 本型号裸屏工作电压为 3.3 V，接入 5 V 系统时需进行电平转换。
• 器件选型可以使用我们提供的原理图中的型号或者根据数据手册选择都是可以的。

问：可以使用模拟 SPI 吗？

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

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

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

屏幕问题

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

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

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

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

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

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

问：为什么显示图像偏移

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

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

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

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

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