1. 项目概述为什么选择1.64英寸电子纸模块如果你正在寻找一种低功耗、高对比度、并且能在断电后保持显示内容的屏幕方案那么电子纸e-Paper模块绝对值得你深入研究。这次我们要聊的是一款尺寸为1.64英寸、分辨率为296x152的黑白红三色电子纸模块。它不像传统的LCD或OLED屏幕那样需要持续供电来维持画面一旦刷新完成即使拔掉电源图像依然清晰可见这种特性让它非常适合用在需要长时间显示固定信息、且对功耗极其敏感的场景里。我最初接触这个模块是想做一个放在门口的智能天气和日历显示牌。它需要一周甚至更久才充一次电并且大部分时间都处于休眠状态。市面上常见的OLED虽然省电但长时间显示静态内容有烧屏风险而电子纸的零功耗保持特性完美契合了这个需求。这款1.64英寸的模块尺寸小巧分辨率足够显示几行文字和简单的图标加上红、黑、白三色能让关键信息比如预警、高亮事项更醒目可玩性很高。从网络上的热度来看围绕它的开发主要集中在几个主流平台上Raspberry Pi、Arduino、Jetson Nano和STM32。这几乎覆盖了从单板计算机到微控制器的全谱系开发者。无论你是想用树莓派做个桌面小挂件用Arduino集成到智能小车或物联网设备里还是在STM32上做低功耗嵌入式产品这个模块都能找到用武之地。接下来的内容我会以一个嵌入式开发者的视角带你从硬件拆解到软件驱动手把手把这个模块用起来并分享我在不同平台调试时踩过的坑和积累的经验。2. 模块硬件深度解析与接口定义拿到模块的第一件事不是急着上电写代码而是先把它翻来覆去看明白。这块1.64英寸的电子纸模块核心是一块由广州微雪电子Waveshare或其他类似厂商生产的屏幕通常以排针或FPC软排线的形式引出引脚。2.1 核心引脚功能与电气特性模块的引脚定义是驱动它的基石。虽然不同厂商的引脚顺序可能略有差异但核心信号线是通用的。一个典型的1.64英寸三色电子纸模块如Waveshare 1.64inch e-Paper Module (G)通常会提供以下关键引脚电源相关VCC 正极电源输入。这里有个大坑电子纸的驱动电压和逻辑电压可能不同。很多模块内部集成了电源管理芯片VCC输入范围可能是3.3V但驱动屏幕的电压可能高达十几伏。所以务必查阅你的模块具体手册确认VCC是接3.3V还是5V。接错了轻则不工作重则烧毁。GND 电源地。通信接口这类小尺寸模块为了节省引脚最常用的是4线SPI接口。DIN (MOSI) SPI主设备输出从设备输入用于发送图像数据或命令。CLK (SCK) SPI时钟线。CS (片选) 低电平有效选中当前模块。当总线上有多个SPI设备时靠它来区分。DC (数据/命令选择) 这是一个非常关键的引脚。它告诉屏幕控制器当前通过SPI发送的是“命令”还是“数据”。例如设置刷新模式、写入内存地址是命令写入具体的像素数据是数据。通常高电平为数据低电平为命令。BUSY 输出引脚用于指示屏幕内部状态。当屏幕正在执行刷新、清屏等耗时操作时此引脚会拉高或拉低具体看模块定义告诉主控“我正在忙别打扰我”。驱动程序中必须查询或等待此引脚状态否则连续发送指令会导致通信混乱。复位与控制RST 复位引脚低电平有效。用于在初始化或异常时对屏幕控制器进行硬件复位。一个完整的初始化流程通常以拉低RST开始。其他 有些模块可能还有BS边框控制等引脚用于控制屏幕刷新时的边框波形以改善视觉效果。注意在连接前最稳妥的方法是找到对应型号的规格书Datasheet或用户手册核对引脚定义。盲目接线是硬件调试的第一大忌。2.2 屏幕驱动原理与三色实现为什么电子纸可以断电保持它的核心是“电泳”技术。屏幕内部有数百万个微胶囊每个胶囊里充满了带负电的黑色粒子和带正电的白色或红色粒子悬浮在透明液体中。当在胶囊两侧施加电场时带电粒子会向相反的电极移动。通过控制不同位置电极的电压极性就能让黑色或白色粒子浮到表面从而形成图像。对于这款三色黑、白、红屏幕其内部结构更复杂一些。通常有两种实现方式一种是双层结构上层是黑/白粒子下层是红/白粒子另一种是单层但含有三种粒子。驱动时需要发送两帧数据第一帧决定黑色像素的分布第二帧决定红色像素的分布。白色则是默认背景色通过“不驱动”该区域来实现。因此在编程时你需要准备一个全黑的图像缓冲区和一个全红的图像缓冲区或者一个包含两种颜色信息的复合缓冲区然后分两次发送给屏幕控制器。屏幕的刷新过程比较慢全刷可能需要2-3秒并且有明显的“闪屏”现象全屏先变黑再变白最后显示图像这是电泳技术的物理特性决定的属于正常现象。频繁全刷会加速屏幕老化所以驱动策略上要尽量避免不必要的全局刷新。3. 主流开发平台驱动实战了解了硬件我们就可以着手写软件了。下面我将分别针对Arduino (AVR/ESP32)、Raspberry Pi (Linux)和STM32 (HAL库)这三个最热门的平台讲解驱动移植和核心代码逻辑。3.1 Arduino平台从快速验收到深度定制Arduino生态完善有大量现成库是快速上手验证模块功能的最佳选择。3.1.1 环境准备与库安装首先在Arduino IDE中通常可以通过“库管理器”搜索“e-Paper”或“GxEPD”来安装相关库。例如GxEPD2库对微雪的屏幕支持很好。安装后在示例程序中找到对应尺寸和型号的例程例如GxEPD2_Example。接线示意图以Arduino Uno为例电子纸模块引脚Arduino Uno 引脚功能VCC3.3V务必确认电压GNDGND共地DIN11 (MOSI)SPI数据CLK13 (SCK)SPI时钟CS10片选可自定义DC9数据/命令可自定义RST8复位可自定义BUSY7忙状态可自定义3.1.2 核心代码拆解与避坑库函数封装得很好但理解其底层操作有助于排查问题。一个典型的显示流程如下#include GxEPD2_BW.h // 如果是三色可能是 GxEPD2_3C #include U8g2_for_Adafruit_GFX.h // 用于字体和图形 // 根据你的屏幕型号定义驱动对象 GxEPD2_BWGxEPD2_164, GxEPD2_164::HEIGHT display(GxEPD2_164(/*CS*/10, /*DC*/9, /*RST*/8, /*BUSY*/7)); void setup() { Serial.begin(115200); display.init(); // 初始化内部会执行复位、握手、读取ID等操作 // display.init(115200); // 有些库支持指定调试波特率 } void loop() { display.setRotation(1); // 设置显示方向 display.setFullWindow(); // 设置全窗口刷新模式 display.firstPage(); // 开始页面刷新循环 do { display.fillScreen(GxEPD_WHITE); // 填充白色背景 display.setTextColor(GxEPD_BLACK); display.setCursor(10, 30); display.print(Hello, e-Paper!); // 绘制红色矩形如果是三色屏 // display.fillRect(50, 50, 60, 30, GxEPD_RED); } while (display.nextPage()); // 这个循环会处理分页发送数据和触发刷新 display.hibernate(); // **关键一步进入深度睡眠**。如果不调用功耗会很高。 delay(5000); // 休眠5秒 }实操心得与避坑指南hibernate()必须调用这是很多新手忽略的一点。刷新完成后屏幕控制器芯片本身还在耗电。调用hibernate()或sleep()函数会发送命令让控制器进入最低功耗模式此时电流可以从mA级降至uA级。BUSY引脚的处理好的库会在nextPage()和hibernate()等函数内部自动查询BUSY引脚并等待。但如果你自己写底层驱动或者库工作不正常一定要在发送任何命令后检查BUSY引脚确保上一个操作完成。局部刷新如果只更新部分内容如数字时钟的秒位尽量使用局部刷新display.setPartialWindow()。全屏刷新display.setFullWindow()慢且伤屏。但注意局部刷新多次后可能产生残影需要定期进行一次全刷来清除。供电一定要足在刷新瞬间屏幕需要较大的驱动电流。如果使用USB供电或电池确保电源能提供足够的峰值电流否则会导致刷新不全、花屏或复位。3.2 Raspberry Pi平台Python与C语言双视角在树莓派上你可以用Python快速原型开发也可以用C语言追求更高性能。3.2.1 Python驱动 (使用waveshare_epd库)微雪官方通常提供Python库。通过pip安装或直接下载库文件。sudo apt-get update sudo apt-get install python3-pip python3-pil python3-numpy sudo pip3 install spidev RPi.GPIO # 然后下载并安装waveshare的e-Paper库Python代码结构清晰易于理解import epd1in64g # 导入对应尺寸的库 from PIL import Image, ImageDraw, ImageFont import time epd epd1in64g.EPD() # 初始化对象 epd.init() # 硬件初始化 epd.Clear() # 清屏 # 创建画布 image Image.new(1, (epd.width, epd.height), 255) # 255为白色 draw ImageDraw.Draw(image) # 加载字体 font ImageFont.truetype(/usr/share/fonts/truetype/freefont/FreeMono.ttf, 18) # 画文字 draw.text((10, 30), Raspberry Pi, fontfont, fill0) # 0为黑色 # 画红色图形需要处理双缓冲区 # 对于三色屏通常需要创建两个图像一个黑一个红 image_black Image.new(1, (epd.width, epd.height), 255) image_red Image.new(1, (epd.width, epd.height), 255) draw_black ImageDraw.Draw(image_black) draw_red ImageDraw.Draw(image_red) draw_black.text((10, 30), Black Text, fontfont, fill0) draw_red.rectangle((50, 50, 110, 80), fill0) # 在红色层画一个矩形 # 显示 epd.display(epd.getbuffer(image_black), epd.getbuffer(image_red)) time.sleep(2) epd.sleep() # 让屏幕进入睡眠Python环境常见问题SPI权限问题运行脚本报错找不到SPI设备。需要将用户加入spi组并确保/dev/spidev0.0和/dev/spidev0.1存在。sudo usermod -a -G spi,gpio pi sudo rebootPIL安装问题确保安装的是Pillow它是PIL的友好分支。sudo pip3 install Pillow。3.2.2 C语言驱动与直接寄存器操作对于需要高刷新率或与C/C项目集成的场景可以直接操作树莓派的GPIO和SPI外设。可以使用wiringPi或bcm2835库。核心步骤初始化SPI设置SPI模式通常为Mode 0、时钟频率建议从1MHz开始试、位顺序MSB first。初始化GPIO将RST、DC、CS、BUSY引脚设置为输出或输入方向。实现底层发送函数void EPD_SendCommand(unsigned char command) { DigitalWrite(DC_PIN, LOW); // DC置低表示发送命令 DigitalWrite(CS_PIN, LOW); SPI_Transfer(command); DigitalWrite(CS_PIN, HIGH); } void EPD_SendData(unsigned char data) { DigitalWrite(DC_PIN, HIGH); // DC置高表示发送数据 DigitalWrite(CS_PIN, LOW); SPI_Transfer(data); DigitalWrite(CS_PIN, HIGH); }等待BUSYvoid EPD_WaitUntilIdle(void) { while(DigitalRead(BUSY_PIN) 1) { // 假设BUSY高电平为忙 DelayMs(10); } }严格按照时序初始化参照数据手册的初始化序列Init Code依次发送命令和参数一个都不能错。这是驱动成功的核心。3.3 STM32平台HAL库与低功耗设计考量在STM32上驱动更能体现嵌入式开发的精髓。我们以STM32F103蓝桥杯常用和HAL库为例。3.3.1 硬件连接与CubeMX配置连接将模块的SPI引脚连接到STM32的任意一个SPI外设如SPI1GPIO引脚连接到普通IO口。CubeMX配置启用一个SPI模式为“Full-Duplex Master”硬件NSS选择“Disable”我们用软件控制CS。参数设置数据大小8位MSB FirstCPOLLowCPHA1Edge即SPI Mode 0预分频器确保波特率在几MHz以内初始调试建议用1MHz。将RST、DC、CS引脚配置为GPIO_OutputBUSY配置为GPIO_Input。生成代码。3.3.2 驱动层代码实现在生成的工程中创建epd.c和epd.h文件。epd.h中定义引脚和函数原型// 引脚定义根据实际接线修改 #define EPD_RST_PIN GPIO_PIN_0 #define EPD_RST_PORT GPIOA #define EPD_DC_PIN GPIO_PIN_1 #define EPD_DC_PORT GPIOA #define EPD_CS_PIN GPIO_PIN_2 #define EPD_CS_PORT GPIOA #define EPD_BUSY_PIN GPIO_PIN_3 #define EPD_BUSY_PORT GPIOA // SPI句柄在main.c中extern声明 extern SPI_HandleTypeDef hspi1; void EPD_Reset(void); void EPD_SendCommand(uint8_t cmd); void EPD_SendData(uint8_t data); void EPD_WaitUntilIdle(void); void EPD_Init(void); void EPD_Clear(void); void EPD_DisplayFrame(const uint8_t *black_image, const uint8_t *red_image); void EPD_Sleep(void);epd.c中实现关键函数// 发送命令 void EPD_SendCommand(uint8_t cmd) { HAL_GPIO_WritePin(EPD_DC_PORT, EPD_DC_PIN, GPIO_PIN_RESET); // DC 0 HAL_GPIO_WritePin(EPD_CS_PORT, EPD_CS_PIN, GPIO_PIN_RESET); // CS 0 HAL_SPI_Transmit(hspi1, cmd, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(EPD_CS_PORT, EPD_CS_PIN, GPIO_PIN_SET); // CS 1 } // 发送数据 void EPD_SendData(uint8_t data) { HAL_GPIO_WritePin(EPD_DC_PORT, EPD_DC_PIN, GPIO_PIN_SET); // DC 1 HAL_GPIO_WritePin(EPD_CS_PORT, EPD_CS_PIN, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, data, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(EPD_CS_PORT, EPD_CS_PIN, GPIO_PIN_SET); } // 等待屏幕空闲 void EPD_WaitUntilIdle(void) { while(HAL_GPIO_ReadPin(EPD_BUSY_PORT, EPD_BUSY_PIN) GPIO_PIN_SET) { HAL_Delay(1); // 使用HAL_Delay或更精确的延时 } } // 初始化序列 - **这是最需要根据具体屏幕型号修改的地方** void EPD_Init(void) { EPD_Reset(); // 硬件复位 EPD_WaitUntilIdle(); EPD_SendCommand(0x12); // 软件复位 EPD_WaitUntilIdle(); // 接下来是一长串设置命令和参数必须从官方示例代码或数据手册中拷贝 // 例如设置分辨率、驱动波形、电源配置等 // EPD_SendCommand(0x01); EPD_SendData(0x03); ... // 这部分代码非常固定但一个字节都不能错。 }3.3.3 图像数据处理与内存优化STM32资源有限需要高效处理图像数据。屏幕分辨率296x152单色一位1bit表示一个像素那么一帧黑色图像需要(296 * 152) / 8 5624字节。三色屏需要两帧就是11KB以上。这对于RAM不大的MCU是个挑战。优化策略使用常量数组存储静态界面如果界面固定可以直接将转换好的位图数组存放在Flashconst中显示时直接发送节省RAM。动态生成内容对于变化的文字或数字可以只准备一个小的字符点阵库在RAM中组合生成需要显示的一行或一小块区域的图像数据然后使用局部刷新功能发送避免操作整个帧缓冲区。使用外部存储器如果界面复杂且多变可以考虑使用SPI Flash或SD卡存储多张图片需要时读取部分数据到RAM并发送。低功耗设计在EPD_Sleep()函数中发送睡眠命令后可以将连接屏幕的MCU GPIO口设置为高阻态输入模式防止漏电。在屏幕休眠期间STM32自身也可以进入Stop或Sleep模式进一步降低系统功耗。唤醒后需要重新初始化屏幕通常需要先唤醒再发送初始化序列。4. 高级应用与性能调优当基础显示功能实现后我们可以追求更流畅的体验和更复杂的应用。4.1 局部刷新与动画效果全局刷新慢且闪屏局部刷新是提升体验的关键。大多数屏幕控制器支持指定一个矩形区域进行刷新。实现步骤发送命令设置局部刷新模式。发送命令设置刷新区域的左上角和右下角坐标。只发送该区域对应的图像数据。发送刷新触发命令。注意事项残影累积局部刷新利用的是屏幕的“记忆效应”多次局部刷新后新旧电荷分布可能叠加导致残影Ghosting。通常手册会规定在N次局部刷新后必须进行一次全局刷新来清空残影。刷新速度局部刷新速度比全局刷新快但依然有几百毫秒的延迟实现“动画”效果如进度条是可行的但帧率很低可能只有1-2 fps。4.2 字体与图形库集成直接操作像素点太原始需要集成图形库。嵌入式平台STM32/Arduino可以使用u8g2、LVGL等库。u8g2轻量支持多种字体和绘图原语能自动处理在单色缓冲区上的绘制。你需要为其实现一个“回调函数”将库的绘制指令转化为对你帧缓冲区的操作。Linux平台Raspberry Pi使用PIL (Python)或Cairo (C)等库功能强大可以轻松处理抗锯齿、复杂图形和字体渲染。4.3 项目实战打造一个低功耗信息显示屏结合上述所有知识我们可以构建一个完整的项目一个由STM32和1.64英寸电子纸构成的室内温湿度计兼日历。系统架构主控STM32F103C8T6蓝色药丸板运行FreeRTOS。传感器DHT11温湿度通过单总线连接。计时DS1302 RTC模块提供精确时间。显示1.64英寸三色电子纸。电源18650锂电池配合TP4056充电模块和AMS1117-3.3稳压。软件设计任务1传感器读取每60秒读取一次温湿度数据。任务2时间更新每1秒从RTC读取时间。任务3显示刷新当数据或时间发生变化时例如分钟数变化、温度变化超过0.5度触发显示更新。更新策略分钟数字变化只局部刷新时间区域小时变化或温度变化局部刷新对应区域每天凌晨进行一次全局刷新以清除残影。任务4电源管理在无刷新操作的空闲期让STM32进入Stop模式通过RTC的Alarm或外部中断如按键唤醒。避坑总结多任务访问共享资源帧缓冲区是共享资源在FreeRTOS中必须用互斥锁Mutex保护防止显示任务正在发送数据时绘制任务修改了缓冲区。SPI总线冲突如果系统中还有别的SPI设备如Flash要管理好片选CS信号确保同一时刻只有一个设备被选中。刷新过程中的功耗峰值屏幕刷新时电流可达几十mA可能导致电池供电的系统电压瞬间跌落引起MCU复位。在电源路径上加一个大电容如100uF可以缓解这个问题。驱动一块小小的电子纸屏幕从硬件连接到软件协议从基础显示到低功耗优化涉及了嵌入式开发的多个核心环节。它不像点亮一个LED那么简单但也没有复杂到令人望而却步。最关键的是耐心尤其是严格按照数据手册的时序和初始化代码来操作。当你第一次看到清晰的文字和图形在断电后依然停留在屏幕上时那种成就感会告诉你这一切的折腾都是值得的。希望这篇长文能帮你绕过我踩过的那些坑顺利地把这个有趣的显示方案用在你自己的创意项目里。