拆个超市电子价签，用STM32F103驱动GDEW029T5D墨水屏（附完整代码）

从废弃电子价签到创意显示设备STM32驱动GDEW029T5D墨水屏实战超市货架上的电子价签总给人一种神秘感——这些低功耗的小设备是如何实现长时间稳定显示的最近我偶然获得了几块废弃的电子价签拆解后发现它们使用的是GDEW029T5D型号的2.9英寸墨水屏。这种屏幕不仅功耗极低而且断电后仍能保持显示内容非常适合DIY各种创意项目。本文将详细介绍如何通过STM32F103单片机成功驱动这块捡来的墨水屏并分享一些实际应用中的技巧和注意事项。1. 拆解与硬件识别拿到电子价签的第一步自然是拆解。大多数超市使用的电子价签都采用卡扣式设计用塑料撬棒沿着边缘轻轻撬开就能看到内部结构。拆开后我的目光立刻被那块2.9英寸的墨水屏吸引——它通过一条柔性排线与主板连接。仔细观察排线发现上面印有WFT0290CZ10的字样经过搜索确认这对应的是GDEW029T5D型号的墨水屏。这种屏幕具有以下特点分辨率296×128像素显示颜色黑白两色通信接口支持3线/4线SPI刷新时间局部刷新约300ms全刷约2s工作电压3.3V屏幕的引脚定义如下表所示引脚名称功能描述VCC3.3V电源GND地线DINSPI数据输入CLKSPI时钟CS片选信号DC数据/命令选择RST复位信号BUSY忙状态指示BS1接口模式选择提示不同批次的屏幕排线颜色可能不同建议用万用表测量确认各引脚功能。2. 硬件连接与SPI配置确定了屏幕的引脚定义后接下来需要将其与STM32F103CBT6开发板连接。我选择使用4线SPI模式因为这种方式比3线SPI更直观易用。具体连接方式如下VCC → 3.3VGND → GNDDIN → PA7 (SPI1_MOSI)CLK → PA5 (SPI1_SCK)CS → PA4 (自定义GPIO)DC → PA3 (自定义GPIO)RST → PA2 (自定义GPIO)BUSY → PA1 (自定义GPIO)BS1 → GND (选择4线SPI模式)在CubeMX中的配置步骤如下启用SPI1接口模式选择Full-Duplex Master设置Prescaler为2得到18MHz时钟屏幕最大支持20MHz配置CPOLLowCPHA1Edge将PA4、PA3、PA2、PA1设置为GPIO_Output将PA0设置为GPIO_Input用于检测BUSY状态生成代码后需要编写基本的屏幕驱动函数。首先是写命令和写数据的函数void EPD_WriteCmd(uint8_t cmd) { HAL_GPIO_WritePin(EPD_DC_GPIO_Port, EPD_DC_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(EPD_CS_GPIO_Port, EPD_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, cmd, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(EPD_CS_GPIO_Port, EPD_CS_Pin, GPIO_PIN_SET); } void EPD_WriteData(uint8_t data) { HAL_GPIO_WritePin(EPD_DC_GPIO_Port, EPD_DC_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(EPD_CS_GPIO_Port, EPD_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, data, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(EPD_CS_GPIO_Port, EPD_CS_Pin, GPIO_PIN_SET); }3. 屏幕初始化与基本操作墨水屏的初始化过程比普通LCD屏要复杂一些需要按照严格的时序发送一系列命令。以下是初始化函数的关键步骤void EPD_Init(void) { // 硬件复位 HAL_GPIO_WritePin(EPD_RST_GPIO_Port, EPD_RST_Pin, GPIO_PIN_SET); HAL_Delay(10); HAL_GPIO_WritePin(EPD_RST_GPIO_Port, EPD_RST_Pin, GPIO_PIN_RESET); HAL_Delay(10); HAL_GPIO_WritePin(EPD_RST_GPIO_Port, EPD_RST_Pin, GPIO_PIN_SET); HAL_Delay(10); // 发送初始化命令序列 EPD_WriteCmd(0x01); // POWER SETTING EPD_WriteData(0x03); // VDS_EN, VDG_EN EPD_WriteData(0x00); // VCOM_HV, VGHL_LV EPD_WriteData(0x2B); // VDH EPD_WriteData(0x2B); // VDL EPD_WriteCmd(0x06); // BOOSTER SOFT START EPD_WriteData(0x07); EPD_WriteData(0x07); EPD_WriteData(0x17); // ... 更多初始化命令 EPD_WriteCmd(0x04); // POWER ON EPD_WaitBusy(); EPD_WriteCmd(0x00); // PANEL SETTING EPD_WriteData(0xBF); // KW-3f, KWR-2F, BWROTP 0f, BWOTP 1f EPD_WriteCmd(0x30); // PLL CONTROL EPD_WriteData(0x3A); // 3A 100HZ EPD_WriteCmd(0x61); // RESOLUTION SETTING EPD_WriteData(0x80); // source 128 EPD_WriteData(0x01); // gate 296 EPD_WriteData(0x28); EPD_WriteCmd(0x82); // VCOM DC SETTING EPD_WriteData(0x12); }屏幕初始化完成后就可以开始绘制内容了。墨水屏的一个特点是它使用帧缓冲区来存储显示数据我们需要先填充缓冲区然后一次性刷新显示。定义缓冲区uint8_t EPD_Buffer[EPD_WIDTH * EPD_HEIGHT / 8];基本的像素操作函数void EPD_DrawPixel(uint16_t x, uint16_t y, uint8_t color) { if(x EPD_WIDTH || y EPD_HEIGHT) return; if(color) { EPD_Buffer[(x y * EPD_WIDTH) / 8] | 0x80 (x % 8); } else { EPD_Buffer[(x y * EPD_WIDTH) / 8] ~(0x80 (x % 8)); } }4. 高级功能实现与优化有了基本的像素操作函数后我们可以实现更高级的绘图功能。首先是文字显示这需要先准备好字模数据。我使用PCtoLCD2002软件生成了ASCII和中文点阵字库。typedef struct { uint8_t width; uint8_t height; const uint8_t *data; } FontDef; extern FontDef Font_8x16; extern FontDef Font_16x24; void EPD_DrawChar(uint16_t x, uint16_t y, char ch, FontDef font) { uint8_t i, j; for(i 0; i font.height; i) { uint8_t line font.data[(ch - 32) * font.height i]; for(j 0; j font.width; j) { if(line (0x80 j)) { EPD_DrawPixel(x j, y i, 1); } } } } void EPD_DrawString(uint16_t x, uint16_t y, const char *str, FontDef font) { while(*str) { EPD_DrawChar(x, y, *str, font); x font.width; str; } }图片显示也是类似原理需要先将图片转换为位图数据。我使用Img2Lcd工具将图片转换为C数组void EPD_DrawImage(uint16_t x, uint16_t y, uint16_t w, uint16_t h, const uint8_t *img) { uint16_t i, j; for(i 0; i h; i) { for(j 0; j w; j) { if(img[(i * w j) / 8] (0x80 (j % 8))) { EPD_DrawPixel(x j, y i, 1); } } } }在实际使用中我发现墨水屏有几个需要注意的地方刷新策略频繁局部刷新会导致残影建议每5-10次局部刷新后做一次全刷电源管理显示完成后应立即进入睡眠模式以节省功耗温度影响低温环境下刷新时间会明显延长使用寿命建议每3个月做一次全刷以保持屏幕性能以下是一个完整的显示流程示例void EPD_ShowDemo(void) { // 清屏 EPD_Clear(); // 显示文字 EPD_DrawString(10, 10, Hello World!, Font_16x24); EPD_DrawString(10, 40, 墨水屏测试, Font_16x24); // 显示图形 EPD_DrawRect(10, 100, 50, 80); EPD_DrawCircle(150, 65, 30); // 刷新显示 EPD_Refresh(); // 进入睡眠 EPD_Sleep(); }通过这个项目我不仅成功复活了废弃的电子价签屏幕还深入理解了墨水屏的工作原理。这种屏幕虽然刷新率低但在低功耗、长时间显示的场景下有着不可替代的优势。现在这块屏幕已经被我用作桌面天气显示器每天只需刷新几次一节电池可以使用数月之久。