简介一套面向STM32初学者与嵌入式开发者的完整学习资料围绕STM32F103ZET6开发板提供PDF原理图以及数码相框-BMP图片显示实验的函数库版工程源码。原理图清晰展示了电源、时钟、GPIO、LCD接口等硬件连接关系源码则覆盖BMP文件读取、图像解码、LCD驱动和系统时钟初始化等关键环节适合零基础到进阶逐步对照实践。压缩包共281个文件整体大小8.38MB以C语言源文件、头文件、PDF文档为主同时包含Keil工程文件uvprojx/uvoptx、编译生成的hex/axf以及map/lst等调试辅助文件便于直接打开工程验证效果并跟踪构建细节。目前已有149人学习下载。通过研读这套资料可以快速掌握STM32标准外设库的基本用法理解BMP图片从存储介质到屏幕显示的完整数据链路同时结合原理图排查硬件连接问题为后续LCD类项目打下扎实基础。1. 为什么拿 F103ZET6 做数码相框把 STM32F103ZET6 接上一块 SD 卡、一块 TFT LCD不做任何上位机参与让它自己把 BMP 图片读完再显示出来——这个实验看着简单实际把文件系统、LCD 控制器时序、单片机端到端的存储带宽全串起来了。网上能下载到的这个「PDF原理图BMP图片显示实验源码函数库版」压缩包拿到手不是让你点亮屏幕就完事而是让你把 F103 的外设真正跑起来TFTLCD 驱动挂在 FSMC 上SD 卡走 SPI 或 SDIO图片数据通过 FatFs 一层层读进内存再刷进显存。适合谁呢对 F103 外设有一定印象但没独立做过存储类应用的人以及想搞懂「BMP 为什么看着简单显示起来一堆坑」的人。这个工程值得花一个下午顺一遍因为它在文件系统和显示驱动之间给出了一条完整的调用链改任何一环都能立刻看到效果。下面从格式和原理讲起再落到这份源码里的实际代码路径。2. BMP 文件格式与 FatFs 文件系统接入2.1 BMP 文件结构从文件头到像素矩阵BMPBitmap属于最原始的位图格式它把像素数据几乎不压缩地按行存放所以读文件的关键不是解码算法而是准确跳过各种头结构定位到像素数组的起始位置。标准 BMP 文件由四部分组成位图文件头BITMAPFILEHEADER、位图信息头BITMAPINFOHEADER、调色板可选、像素数据。文件头固定 14 字节其中偏移 10 处的 4 字节bfOffBits表示从文件开头到像素数据的偏移量这个字段最关键因为不同 BMP 的信息头长度可能在 40 到 124 字节之间变化直接读这个偏移量跳转最稳妥。信息头里值得关注的还有偏移 18 处的宽度4 字节有符号整数和偏移 22 处的高度4 字节有符号整数。高度为正表示图像自底向上存储为负表示自顶向下这个符号会直接影响读取像素时的行序处理。像素数据部分需要注意对齐规则每一行的字节数必须是 4 的倍数否则要在行尾补零。比如一张 24 位色深、宽度为 53 像素的图每行原始数据是 53×3 159 字节实际存储时补齐为 160 字节。这个「行补齐」是新手最容易忽略的直接用width × height × 3去读文件读到后半部分画面就会斜切。| 文件头 14B | 信息头 40B/108B/124B | 调色板索引色才有 | 像素数据行对齐到4B |这份源码用的是 16 位色深 BMP即 RGB565 格式一个像素占 2 字节每行width×2字节对齐计算时按(width×2 3) ~3处理。选择 16 位图的原因很直接LCD 控制器本身就是 RGB565 接口读出来的像素字节可以直接拼接成 16 位颜色值写入显存不需要做色彩空间转换省掉了中间一个「调色板映射」的步骤。2.2 FatFs 的移植路径与磁盘挂载流程源码里出现ff.c和cc936.c前者是 FatFs 文件系统层的核心实现后者是简体中文 GBK 编码与 Unicode 之间的转换表。FatFs 是一个面向嵌入式场景的 FAT 文件系统组件它不负责底层存储介质的读写而是通过一组底层接口函数把「读扇区」「写扇区」「获取当前时间」等操作委托给用户实现这套接口定义在diskio.c里。在 F103ZET6 上挂载 SD 卡标准做法是把 SD 卡的 SPI 模式驱动实现为disk_read和disk_write然后调用f_mount注册一个 FAT 卷标。整个流程大致是初始化 SPI 外设以配置 SCK 频率和极性SD 卡发送 CMD0 进入 SPI 模式CMD1 或 ACMD41 完成初始化随后f_mount在 FatFs 内部读取引导扇区和 FAT 表。中间涉及到的底层函数在这份源码的sdio_sdcard.c或spi_sdcard.c中实现取决于板子用哪种方式接 SD 卡。以下是一份典型的 FatFs 挂载和打开文件代码结构上模仿了这份源码在 main 函数里的调用顺序FATFS fs; // FatFs 文件系统对象 FIL file; // 文件对象 FRESULT res; // 1. 挂载 SD 卡为 0 号卷第二个参数 1 表示立即挂载 res f_mount(fs, 0:, 1); if (res ! FR_OK) { // 常见错误FR_NOT_READY 表示 SD 卡初始化失败 // 检查 SPI 时钟极性、分频系数、SD 卡供电电压 printf(Mount failed: %d\n, res); } // 2. 打开根目录下的 test.bmp res f_open(file, 0:/test.bmp, FA_READ); if (res ! FR_OK) { // FR_NO_FILE 表示文件名或路径错误注意 FatFs 使用 / 分隔 } // 3. 读取 14 字节文件头验证是否是 BMP 文件 uint8_t header[14]; UINT br; res f_read(file, header, 14, br); if (header[0] B header[1] M) { // 确实是 BMP 文件继续读取信息头 } // 4. 使用完毕后关闭文件释放文件对象 f_close(file);这段代码里的f_mount第一个参数传fs是 FatFs 的工作区对象里面保存了 FAT 表缓存的中间状态。如果系统里只有一个卷可以在初始化时只调用一次后续f_open时不需要重复挂载。f_read的第四个参数br返回实际读取到的字节数在文件末尾或 SD 卡出错时这个值会小于请求值判断文件是否完整要靠它。2.3 为什么直接读扇区不是好方案有人会问既然 BMP 是连续存储的直接通过 SPI 读 SD 卡的原始扇区跳过 FatFs 不是更快吗这个想法在纯顺序读的场景下确实能省掉 FAT 表查询的开销但代价是代码量和健壮性的双重损失。直接读扇区意味着你必须在单片机里实现 FAT16/FAT32 的目录项解析包括长文件名匹配、簇链跟踪、跨簇读写时的边界计算。且 FAT 文件系统的文件在磁盘上不保证连续SD 卡经过多次删除、写入后碎片化严重文件可能分布在不同簇中直接按扇区地址读只能读到第一个簇的内容。FatFs 把这部分逻辑封装在ff.c里调用方只需要提供起始簇号和文件内偏移内部自动完成簇链跳转这就是数码相框选择 FatFs 的根本理由。3. 原理图分析FSMC 驱动 LCD 与 SD 卡通路3.1 核心接线方案:FSMC 并行总线与 SPI 通道拿到压缩包里的 PDF 原理图先别急着看芯片引脚按功能模块划分会清晰很多。开发板上有三个与数码相框直接相关的模块TFTLCD 液晶屏接口、SD 卡座、以及与 PC 通信用的串口。LCD 接口通常以 2×17 或 2×20 排针引出数据线为 16 位并行控制线包含 RS寄存器选择、WR写使能、RD读使能、CS片选和 RST。这些信号在 STM32F103ZET6 上直接复用 FSMC 外设的 NE1、NWR、NOE、A6 等引脚核心映射关系如下表。FSMC 信号STM32 引脚功能说明NE1PD7片选信号选中外部存储区 1A6PF0地址线用于区分命令/数据阶段NWRPD5写使能低电平有效NOEPD4读使能低电平有效D0-D15PD14-PD15, PE0-PE1516 位双向数据总线通过 FSMC 的地址对齐特性开发者把 A6 接到 LCD 的 RS 引脚利用「访问不同地址段自动切换命令/数据」的特性省掉一根独立的 GPIO 控制线。访问地址0x60000000时 A6 为 0LCD 进入命令模式访问0x60000040时 A6 为 1进入数据模式。这种方式让 LCD 读写看起来像内存访问配合 FSMC 的片选时序CPU 不需要等待 GPIO 翻转延时。SD 卡在原理图上通常有两种接法SPI 模式或 SDIO 模式。这份实验源码默认走 SPI1 接口引脚为 SCKPA5、MISOPA6、MOSIPA7、CSPA4。SPI 模式的优势是引脚占用少、代码简单但传输速率偏低实测 SPI 时钟跑到 18MHz 时读 SD 卡大约能到 1.5MB/s而 SDIO 四线模式可以做到 10MB/s 以上。对于显示一幅 320×240 的 16 位 BMP 图约 150KBSPI 模式的读取时间在 100ms 量级肉眼能感知到刷新延迟这也是很多数码相框会升级到 SDIO 的原因。3.2 LCD 初始化中的 FSMC 时序配置LCD 初始化代码分布在tftlcd.c中核心步骤是结构体确认 FSMC 时序参数是否与液晶面板匹配。TFTLCD 的数据手册会给出最小建立时间和最小保持时间这些值需要换算成 STM32 的 FSMC 时钟周期数。以下代码展示了典型的 FSMC NOR/SRAM 时序配置FSMC_NORSRAMInitTypeDef fsmc_init; FSMC_NORSRAMTimingInitTypeDef timing; // 读时序参数设置 timing.FSMC_AddressSetupTime 1; // 地址建立时间 1 个 HCLK timing.FSMC_AddressHoldTime 1; // 地址保持时间 timing.FSMC_DataSetupTime 4; // 数据建立时间 4 个 HCLK timing.FSMC_BusTurnAroundDuration 0; timing.FSMC_CLKDivision 0; timing.FSMC_DataLatency 0; timing.FSMC_AccessMode FSMC_AccessMode_A; // 模式 A 适配 LCD 读写 fsmc_init.FSMC_Bank FSMC_Bank1_NORSRAM1; fsmc_init.FSMC_DataAddressMux FSMC_DataAddressMux_Disable; fsmc_init.FSMC_MemoryType FSMC_MemoryType_SRAM; fsmc_init.FSMC_MemoryDataWidth FSMC_MemoryDataWidth_16b; fsmc_init.FSMC_BurstAccessMode FSMC_BurstAccessMode_Disable; fsmc_init.FSMC_WriteOperation FSMC_WriteOperation_Enable; fsmc_init.FSMC_ExtendedMode FSMC_ExtendedMode_Disable; fsmc_init.FSMC_WriteTimingStruct timing; fsmc_init.FSMC_ReadWriteTimingStruct timing; FSMC_NORSRAMInit(fsmc_init); FSMC_NORSRAMCmd(FSMC_Bank1_NORSRAM1, ENABLE);这段配置里最影响显示稳定性的是FSMC_DataSetupTime。取值太小数据总线还没稳定就被 LCD 采样画面会出现随机噪点或颜色错位取值太大写入速度下降刷屏变慢。如果屏幕出现「雪花点」但不完全花屏优先把这个参数加 1 到 2。FSMC_AccessMode_A是 LCD 最常用的模式读写共用同一份时序参数适合 ILI9320、ILI9341 这类标准的 8080 接口控制器。3.3 代码中 LCD 驱动与 FSMC 地址映射的配合在驱动代码里访问 LCD 被抽象成两个宏。根据 FSMC Bank1 的基地址命令寄存器和数据寄存器的地址相差 0x40对应的 C 语言宏定义如下#define LCD_BASE ((uint32_t)(0x60000000 | 0x00000000)) #define LCD_CMD (*(volatile uint16_t *)LCD_BASE) #define LCD_DATA (*(volatile uint16_t *)(LCD_BASE 0x40))这里0x60000000是 FSMC Bank1 的起始地址0x40意味着访问地址的第 6 位为 1对应 A6 引脚输出高电平LCD 的 RS 引脚被拉高进入数据模式。以 ILI9341 为例写寄存器命令时先向LCD_CMD写入寄存器地址再向LCD_DATA写入寄存器值。整个写入过程由 FSMC 硬件自动产生时序CPU 只负责赋值相比 GPIO 逐位翻转效率高一个数量级。4. 数码相框源码走读从按键检测到 BMP 显示4.1 main 函数初始化与文件系统就绪源码的main.c初始化顺序对理解整个系统帮助很大。第一步是时钟配置SystemInit()将系统时钟锁定到 72MHz再通过RCC_APB2PeriphClockCmd开启 GPIOA、GPIOB、GPIOC、GPIOD、GPIOE、AFIO 的时钟以及 FSMC、SPI1、USART1 的外设时钟。顺序上先开 GPIO 时钟再配置引脚复用功能是标准套路颠倒会导致外部设备在上电瞬间处于未定义状态。接着是 LCD 和 SD 卡的初始化这两个模块的先后顺序在功能上解耦但经验上建议先初始化 SD 卡后初始化 LCD因为 FatFs 挂载失败时可以在 LCD 上显示错误码方便调试。随后进入文件系统挂载环节这里有一个工程上常见的选择挂载失败时是否重试。// 初始化 SD 卡并挂载文件系统最多重试 3 次 uint8_t mount_count 0; while (f_mount(fs, 0:, 1) ! FR_OK) { mount_count; if (mount_count 3) { printf(SD card mount error\n); return; } delay_ms(200); // 等待 SD 卡稳定避免上电瞬间电压不稳导致失败 }SD 卡初次上电时可能因电压波动导致初始化失败加短暂延时重试非常必要。delay_ms(200)给了 SD 卡内部电压调节器足够的稳定时间这个细节在换用不同品牌 SD 卡时表现尤其明显某些卡对时序更敏感不加延时复位流程反复失败。完成挂载后接下来是 BMP 图片文件的遍历逻辑。数码相框需要支持多张图片切换常规做法是在根目录下预先存放1.bmp、2.bmp、3.bmp等文件代码通过一个变量记录当前图片序号按键触发时把序号加一后重新拼路径。源码中这块逻辑通常通过sprintf实现char path[16]; uint8_t img_index 1; sprintf(path, 0:/%d.bmp, img_index); res f_open(file, path, FA_READ);这里有几个容易犯的错sprintf配合%d时如果图片序号超过 9 会自动多占一个字符务必确认path数组长度够用另外空文件或 SD 卡里没有对应文件时f_open返回FR_NO_FILE代码需要做保护常见的处理方式是直接跳过读取等待下一次按键。4.2 BMP 解码函数的数据流路径工程核心的图片读取函数调用路径通常为main调用show_bmp函数该函数内部完成打开文件、读取文件头、解析 BMP 头信息、读取像素数据、写入 LCD 显存的完整流程。函数代码的关键部分如下void show_bmp(FIL *file, uint16_t x, uint16_t y) { BITMAPFILEHEADER file_header; BITMAPINFOHEADER info_header; UINT br; // 读取文件头校验 BMP 标识 f_read(file, file_header, sizeof(file_header), br); if (file_header.bfType ! 0x4D42) { // 小端序下 BM 是 0x4D42 printf(Not a BMP file\n); return; } // 读取信息头获取宽高和色深 f_read(file, info_header, sizeof(info_header), br); uint16_t width info_header.biWidth; uint16_t height info_header.biHeight; uint16_t depth info_header.biBitCount; // 跳过像素数据偏移之前的剩余内容主要是调色板 f_lseek(file, file_header.bfOffBits); // 读取像素数据并逐行写入 LCD uint16_t color_buf[240]; // 行缓冲宽度 240 时足够 uint16_t row_size width * 2; // 16 位色深 for (uint16_t i 0; i height; i) { f_read(file, color_buf, row_size, br); // BMP 行序是自底向上显示时需要翻转 LCD_Show_RGB565(x, y height - 1 - i, color_buf, width); } f_close(file); }这里最关键的细节是行序翻转。BMP 格式默认从最后一行开始存储像素即图像文件中的第一行数据对应图片视觉上的最底行。如果直接把读出来的第一行刷到 LCD 顶部图片会上下颠倒。源码中采用y height - 1 - i的方式逐行反转这是数码相框正确显示 BMP 的必备逻辑。f_lseek(file, file_header.bfOffBits)的作用是把文件指针跳转到像素数据真正开始的位置。对于 24 位或 8 位 BMP如果信息头后有调色板直接顺序读取会误把调色板当像素数据整幅图的颜色完全错乱。这个偏移跳转是区分 BMP 显示代码「能用」与「标准」的分水岭。4.3 按键事件与图片序号切换按键检测可以放在主循环中以轮询方式执行也可以使用外部中断。考虑到按键存在机械抖动直接读引脚电平容易误触发源码中的实现一般是「检测按下 延时消抖 再次确认」三步如下所示uint8_t key_scan(void) { if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) RESET) { delay_ms(20); // 消抖延时 if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) RESET) { while (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) RESET); return 1; // 确认按下并已释放 } } return 0; }消抖延时的 20ms 是机械按键的典型抖动窗口太短无法滤除抖动太长会明显降低按键灵敏度。检测到按键后img_index加一如果图片总数小于当前序号则回到 1。为了兼容相框应用的多图循环体验有些版本还会在切换时先清屏再显示新图避免新旧图片内容叠加。5. 显示提速、内存策略与常见故障排查5.1 逐行缓冲与全图缓冲的内存取舍F103ZET6 拥有 64KB SRAM而一幅 240×320 的 RGB565 图片裸数据为 150KB远超 SRAM 容量因此全图缓冲方案根本不可行。源码采用的行缓冲方式每次最多占用 240×2480 字节加上 FatFs 内部缓冲区整体开销在 1KB 级别非常宽裕。这个设计也决定了显示速度的瓶颈不完全是 LCD 写入而是 SD 卡读取与 LCD 写入之间的串行等待。如果要提速有两条路一是开启 FSMC 的 DMA 传输让内存到 FSMC 地址的数据搬移不经过 CPU二是利用 SPI 的双缓冲在读取下一行数据的同时把当前行的数据刷入显存。原版源码通常没有做这两层优化这是拆分代码后最容易收效的改动点进阶玩家可以从这里入手。5.2 显示花屏与颜色错乱的背后原因花屏的本质是 LCD 显存中写入的数据与当前的 GRAM 窗口不匹配或者 FSMC 时序参数不正确。结合数码相框的具体场景优先级最高的是行列扫描方向问题。部分 LCD 模块的 GRAM 方向与设置不一致显示 BMP 时会呈现「镜像」或「旋转 90 度」的异常。解决方式是调整 LCD 控制器的入口模式寄存器如 ILI9341 的 MADCTL 寄存器而不是修改 BMP 数据的行列顺序修改像素数据的方法会显著拖慢速度。另一类常见问题是颜色通道顺序。RGB565 在内存中有两种字节序浅红高字节在前RGB还是浅蓝高字节在前BGR。大多数 LCD 控制器通过0x3A寄存器设置像素格式如果 BMP 数据是 RGB 序而 LCD 设置为 BGR 序图像会出现红蓝互换人的肤色会显得发青发紫。排除方法很简单先在 LCD 上画一个纯色测试块确认颜色输出正确后再去查 BMP 数据的解析逻辑。5.3 用 FAT 格式化工具验证 SD 卡兼容性数码相框在调试阶段最常见的问题是 SD 卡不识别但这个「不识别」有 90% 是 FAT 格式化问题而不是 SPI 时序问题。FatFs 支持的 FAT12、FAT16、FAT32 在 Windows 下默认格式化工具可能因容量产生差异建议先用专门的格式化工具如 SD Card Formatter将卡格式化为 FAT32分配单元大小选默认值。格式化厂商的 LBA 对齐方式、隐藏扇区数等参数如果不符合 FAT 规范f_mount会返回FR_NO_FILESYSTEM。如果格式化后仍然报错再用示波器或逻辑分析仪检查 SPI 引脚上的波形确认 MISO 上有 MBR 扇区的响应数据。另外SD 卡 SPI 模式的初始化频率必须是低速400kHz 以下初始化完成后才能切换到高速模式这是 SD 卡物理规范要求代码中如果省略了频率切换部分卡会直接无响应。5.4 图片解码失败时的回退策略呈现在产品化相框中一张损坏的图片不应该让整个系统死机。代码中show_bmp函数在文件头校验失败、文件为空、文件读取中断时需要有一个统一的错误处理出口。这里给出一种实用的回退策略uint8_t show_bmp_safe(const char *path) { FIL file; FRESULT res f_open(file, path, FA_READ); if (res ! FR_OK) return 0; uint16_t *buf (uint16_t *)malloc(480); if (buf NULL) { f_close(file); return 0; } // 读取文件头并校验…… // 显示过程中如果 f_read 失败直接跳转到错误标签 free(buf); f_close(file); return 1; }错误标签统一执行清理操作释放缓冲、关闭文件、在 LCD 上显示「FILE ERROR」。这种集中式清理模式比在每个分支重复写释放代码可靠得多尤其涉及雪崩式错误传播时漏掉一次f_close会导致文件句柄泄漏重复切换图片后达到 FatFs 的最大打开文件数限制系统表现为「用着用着突然打不开任何文件了」。文件句柄泄漏的排查方式是用f_open的返回码加打印如果连续几十次操作后第一次打开失败且FR_TOO_MANY_OPEN_FILES基本可以锁定泄漏点。数码相框这个实验项目真正训练的能力是把芯片手册中的 FSMC 时序、文件系统的扇区管理、图像格式的字节布局三者揉进一份工程代码中的系统思维这份源码的价值也正处于此处。本文还有配套的精品资源点击获取