当前位置：首页 > news >正文

立创墨水屏阅读器DIY全解析：基于STM32F103的硬件设计、GUI框架与踩坑实录

news 2026/3/26 17:09:18

立创墨水屏阅读器DIY全解析：基于STM32F103的硬件设计、GUI框架与踩坑实录

最近有不少朋友问我，想自己动手做一个墨水屏阅读器，既能护眼又能练手，但不知道从何下手。正好，我之前基于STM32F103VGT6主控，从零开始设计并制作了一个墨水屏阅读器。今天，我就把这个项目的完整过程，从硬件选型、电路设计，到软件架构和那些让我调试到半夜的“坑”，都给大家掰开揉碎了讲一讲。

这个项目麻雀虽小，五脏俱全，涵盖了主控、存储、传感器、电源管理、GUI界面设计等嵌入式开发的多个核心环节。无论你是想复刻一个，还是想学习其中的设计思路和解决问题的方法，相信这篇“踩坑实录”都能给你带来不少启发。

1. 项目概览与“劝退”声明

做这个阅读器的初衷很简单，就是想有个不伤眼的设备看电子书，顺便检验一下自己的软硬件综合能力。最终实现的功能包括时间/温湿度显示、TXT文本阅读、目录浏览、章节跳转，以及字体、字号调节等，界面相当简洁。

注意：在开始之前，我必须先泼一盆冷水。这个项目目前还存在不少缺陷，比如电量显示不准、翻页逻辑有小bug、功耗偏大、UI不够精美等。而且，复刻成本不低，大约需要250元以上，焊接难度也不小，需要处理Type-C、FPC连接器等密集器件。因此，我强烈不建议新手朋友直接复刻！本文更侧重于分享设计思路、技术细节和解决问题的过程，供大家学习和参考。

1.1 核心功能与技术参数

先来看看这个小家伙都能干什么，以及它的“硬实力”如何。

主要功能：

显示年、月、日、星期和时间。
实时显示环境温湿度。
阅读SD卡中的TXT文本（仅支持GB2312编码）。
显示文本目录，并支持快速跳转。
按“第XXX章”格式查找章节。
内置多款字体，可调节字体大小、字间距和行间距。
低电压、无操作定时自动关机。
开关机有提示音和灯光效果。

核心硬件参数：

部件	型号/规格	说明
主控MCU	STM32F103VGT6	ARM Cortex-M3内核，1MB Flash，资源足够驱动墨水屏和运行GUI
Flash存储	W25Q128JVSIQ	16MB SPI Flash，用于存储字库、阅读记录和系统设置
显示屏	大连佳显 GDEQ0426T82	4.26英寸黑白墨水屏，分辨率400x300
USB转串口	CH340X	用于程序ISP下载和调试打印
温湿度传感器	SHT30-DIS	IIC接口，精度不错的数字传感器
实时时钟RTC	RX8025T-UC	高精度时钟芯片，由电池供电，关机也能走时
电池	中顺芯 255464	3.7V，1000mAh锂电池
整机尺寸	114x72x7.4mm	比较小巧，便于手持

2. 硬件电路设计详解

硬件是项目的骨架。我的设计主要分为三大块：供电电路、下载电路以及主控和外设电路。

2.1 供能电路与一键开关机

供电是整个系统稳定的基础。我的设计思路是：外部5V电源通过Type-C口输入，经过充电管理芯片MCP73831T给电池充电，电池电压再通过一个LDO降压芯片SPX3819M5-L-3-3/TR稳定到3.3V，供给MCU和所有外设。

这里的亮点是一键开关机电路，它实现了按键的复用（短按开机/关机，长按用于下载模式），并且通过软硬件配合实现了“自锁”，确保开机后松开按键系统也不会断电。这个电路参考了FASTSHIFT大佬的开源项目，在此感谢！

电路原理（简述）：

开机：按下按键SW12，三极管Q3（AO3401）的栅极被拉低，Q3导通，3.3V LDO输出供电。MCU上电后，立即将一个GPIO（PWR_EN）置为高电平，使另一个三极管Q2（AO3400）导通，将Q3栅极持续拉低，实现自锁。此时松开按键，系统依然有电。
关机：再次按下SW12，MCU检测到另一个GPIO（KEY_DET）变为低电平（按键按下），然后在程序中判断为关机意图，将PWR_EN引脚拉低。Q2关闭，当松开SW12后，Q3栅极恢复高电平，Q3关闭，整个系统断电。

这个设计非常巧妙，用一个按键就解决了开关机和进入下载模式（长按）的需求，而且硬件成本很低。

2.2 下载电路：SWD与ISP自动下载

为了方便调试和烧录，我设计了两种下载方式：

SWD接口：这是最常用的调试接口，连接SWD下载器（如ST-Link）即可进行下载和在线调试。
ISP自动下载电路：这是为了方便没有调试器的朋友。我参考了野火开发板的方案，使用CH340X芯片。这里我踩过一个坑：一定要在CH340X相关控制三极管的基极加上拉电阻。最初我没加，导致MCU上电后状态不稳定，时而能启动时而自动关机，排查了很久才发现是这里的问题。加上拉电阻后，就能确保MCU上电初始状态确定，避免异常。

2.3 MCU及外设电路

主控STM32F103VGT6负责调度一切。围绕它的外设包括：

SD卡槽：用于读取存放TXT文件的SD卡。
SPI Flash (W25Q128)：存储庞大的中文字库，以及用户的阅读进度、系统设置等数据。
RTC时钟 (RX8025T)：为了保证时间精度，选用了一颗独立的时钟芯片，并由电池直接供电，即使主系统关机，它也能继续走时。
温湿度传感器 (SHT30)：IIC接口，获取环境数据。
电池电量检测 (CW2015)：用于估算电池剩余电量，实现低电关机提醒。
按键、LED、蜂鸣器：实现人机交互。

这些电路的连接都比较常规，遵循数据手册的推荐设计即可。关键在于PCB布局时，要注意模拟部分（如电池检测）和数字部分的隔离，以及电源路径的走线宽度。

3. 软件架构与程序框架

硬件搭好了，软件就是灵魂。这个阅读器的软件核心思想是：以GUI界面为导向的事件驱动模型。

3.1 核心工作流程

整个系统的运作可以概括为：通过FatFs文件系统读取SD卡内容，调用外设获取时间、温湿度等信息，处理数据，最终显示在墨水屏上。

程序上电后的流程如下：

初始化：初始化所有硬件外设（GPIO、SPI、IIC、FatFs等）。
加载历史数据：从SPI Flash中读取上次保存的阅读进度、系统设置等信息。
进入主循环：系统开始永不停止地循环执行以下任务：
- 时间/温湿度刷新：定时从RTC和SHT30读取数据并更新显示。
- 电量检测：实时监测电池电压。
- 界面管理与刷新：这是核心，根据当前界面状态，决定显示什么内容。
- 按键扫描：检测用户输入，并转化为对应界面下的功能指令。
- 关机判断：检查是否满足低电量或超时无操作关机条件。

3.2 GUI界面切换逻辑

整个系统有5个主要界面：时钟主页、系统设置、文件目录、阅读界面、章节导航。它们之间的切换逻辑如下图所示（概念上）：

[时钟主页] <---> [系统设置] | | v v [文件目录] ---> [阅读界面] <---> [章节导航]

在代码中，我通过一个全局变量（如current_gui）来标记当前处于哪个界面。在主循环的“界面选择及刷新”函数里，会根据这个变量执行对应的界面绘制函数和按键处理函数。

例如，在阅读界面下，上下按键被映射为翻页功能；而在目录界面下，同样的上下按键则被映射为选择文件的功能。这种设计使得程序结构清晰，易于维护和扩展。

4. 开发中的“踩坑”与解决方案

这部分是精华，也是每个开发者成长最快的地方。我挑几个印象深刻的坑和大家分享。

4.1 IIC通信的“10微秒”延时

在调试SHT30温湿度传感器时，读取的数据一直是某个固定的异常值。排查硬件连接、地址、时序都没问题。最后死磕数据手册，发现发送读取命令后，传感器需要一点时间准备数据。手册里可能没明确写，但实际测试中，在发送读命令后，增加一个约10微秒的延时，再启动读取，数据就正常了。

// 示例代码片段 SHT30_Send_Cmd(READ_MEASUREMENT_CMD); // 发送读取测量值命令 Delay_us(10); // 关键！等待传感器准备数据 IIC_Read_Multi_Byte(SHT30_ADDR, read_buffer, 6); // 读取6个字节数据

提示：很多IIC设备对时序有微妙的要求，当通信不正常时，除了检查基本配置，不妨在关键位置尝试增加微小延时。

4.2 Keil编译优化等级引发的“玄学”bug

为了减小程序体积，我把Keil的编译优化等级从默认的-O0（不优化）调到了最高的-O3。结果出现了一个诡异的bug：当文本的章节数超过900章时，进行章节查找功能，系统必定死机。

调试过程非常痛苦，因为优化后的代码和实际运行的指令很难直观对应。最后将优化等级调回-O0，问题消失。初步判断是某些用于章节计数的变量或指针，在高级别优化下被编译器“优化”掉了，或者产生了非预期的内存访问。教训就是：不要轻易使用最高级别的优化，尤其是在代码逻辑复杂、指针操作多的情况下。可以逐步提高优化等级，并充分测试。

4.3 硬件设计疏漏导致MCU异常

在设计ISP自动下载电路时，我使用了一个三极管来控制MCU的BOOT0引脚。最初的设计漏加了一个上拉电阻。导致的结果是，系统上电瞬间，BOOT0引脚处于浮空状态，电平不确定，可能导致MCU意外进入系统存储器启动模式（ISP模式），而不是从用户Flash启动，从而表现为上电后程序不运行或立即异常复位。

// 硬件上的教训：为关键控制信号（如复位、BOOT0）提供明确的上拉或下拉， // 确保其在MCU上电复位期间的初始状态是确定的。

解决方法就是在三极管的基极到电源之间加一个10k的上拉电阻，确保MCU上电时BOOT0引脚被稳定地拉低，从而正常从用户Flash启动。

4.4 SPI Flash数据不完整导致的HardFault

在向W25Q128 Flash烧录初始字库数据后，系统一运行就进入HardFault_Handler硬件错误中断。通过调试器回溯调用栈，发现是在访问某个字体数据时发生的。

问题根源是：烧录到Flash的初始数据不完整。可能是在烧录过程中被打断，或者烧录程序本身有bug，导致部分数据丢失。当GUI尝试读取这些丢失的数据时，访问了非法的内存地址，直接触发硬件错误。

解决方法是重新检查并确保烧录过程的完整性，在代码中增加对Flash数据有效性的校验（比如计算校验和），如果校验失败则使用默认字体或提示错误。

5. 字体自定义与使用指南

如果你对这个项目感兴趣，想替换自己喜欢的字体，可以按照以下步骤操作：

准备字体文件：从网上下载.ttf格式的字体文件并安装到电脑上。
生成字模：使用“GTFontLab”等字模生成软件。
- 选择你安装的字体。
- 编码格式选择GB2312_80（这是本项目支持的编码）。
- 排置方式：字节横置；字节方式：高位在前。
- 勾选生成bin文件，使用水平/垂直偏移微调使字模居中。
- 分别生成16x16, 24x24, 32x32三种点阵大小的字库文件。
文件命名与替换：
- 将生成的三个文件（如font16.bin,font24.bin,font32.bin）放入SD卡的srcdata文件夹。
- 关键一步：用这套新字库的文件，重命名替换掉原有字库的文件（即使用旧字库的文件名）。因为代码里固定读取的是那几个文件名。
烧录字库：
- 将SD卡插入阅读器。
- 编译并下载专门的“刷外部FLASH字库”工程到阅读器。
- 复位设备，通过串口工具按提示操作，将SD卡中的新字库写入SPI Flash。
重新烧录主程序：字库写入完成后，再重新烧录阅读器的主程序即可生效。