用 STM32 做一个简易 MP3 播放器（从0到1完整实现）

🎵 用 STM32 做一个简易 MP3 播放器（从0到1完整实现）

学会点灯、串口、OLED之后，很多同学都会问：

"STM32 能不能播放音乐？"

答案是：

当然可以！

而且这还是很多产品中的真实需求：

智能音箱

语音播报器

电梯语音系统

智能门锁

导航设备

家电语音提示

今天带大家实现一个：

🎵 STM32简易MP3播放器

实现从 SD 卡读取 MP3 文件并播放声音。

一、项目效果展示

最终实现：

text 复制代码

SD卡
 ↓
STM32
 ↓
MP3解码模块
 ↓
喇叭

支持：

✅ MP3文件播放

✅ 上一曲/下一曲

✅ 暂停/继续

✅ 音量调节

二、STM32能直接播放MP3吗？

很多新手会认为：

text 复制代码

STM32
 ↓
喇叭

就能播放 MP3。

实际上：

❌ 不行

因为 MP3 是压缩格式。

STM32看到的是：

text 复制代码

0xFF
0xFB
0x90
0x64
...

这些只是压缩数据。

三、MP3播放需要什么？

完整流程：

text 复制代码

MP3文件
 ↓
MP3解码
 ↓
PCM数据
 ↓
DAC输出
 ↓
功放
 ↓
喇叭

核心问题：

MP3必须先解码。

四、两种实现方案

方案一：STM32 + MP3解码芯片（推荐）

例如：

VS1003
VS1053

架构：

text 复制代码

STM32
 ↓ SPI
VS1053
 ↓
耳机/喇叭

优点：

简单
稳定
开发快

缺点：

多一个芯片

方案二：STM32软件解码MP3

架构：

text 复制代码

STM32
 ↓
MP3软件解码库
 ↓
DAC
 ↓
喇叭

优点：

成本低

缺点：

对MCU性能要求高

一般需要：

STM32F4
STM32F7
STM32H7

五、硬件选型

推荐配置：

MCU

text 复制代码

STM32F103C8T6

即可完成项目。

MP3解码模块

存储

text 复制代码

Micro SD卡

用于存放 MP3 文件。

功放

扬声器

text 复制代码

4Ω 3W

即可。

六、硬件连接

STM32 ↔ VS1053

采用 SPI 通信：

text 复制代码

STM32      VS1053

PA5  ----> SCK
PA7  ----> MOSI
PA6  <---- MISO

PB0  ----> XCS
PB1  ----> XDCS
PB10 <---- DREQ

SD卡连接

同样使用 SPI：

text 复制代码

STM32
 ↓
SD Card

很多开发板已经集成。

七、软件架构设计

项目目录建议：

text 复制代码

Project
│
├── BSP
│   ├── led
│   ├── key
│   ├── sdcard
│
├── Driver
│   ├── vs1053
│
├── FatFS
│
├── App
│   ├── player
│
└── main.c

八、文件系统移植

读取 MP3 文件需要：

text 复制代码

FatFS

STM32 官方支持。

配置完成后：

c 复制代码

f_mount();
f_open();
f_read();

即可读取文件。

九、读取 MP3 文件

打开歌曲：

c 复制代码

FIL file;

f_open(&file,
       "music.mp3",
       FA_READ);

读取数据：

c 复制代码

UINT br;

f_read(&file,
       buffer,
       512,
       &br);

十、VS1053驱动核心

发送音频数据：

c 复制代码

void VS1053_SendData(uint8_t *buf,
                     uint16_t len)
{
    while(len--)
    {
        SPI_WriteByte(*buf++);
    }
}

持续送数据：

c 复制代码

while(1)
{
    f_read(&file,
           buffer,
           512,
           &br);

    VS1053_SendData(buffer, br);

    if(br == 0)
        break;
}

十一、播放控制实现

播放

c 复制代码

Player_Play();

暂停

c 复制代码

Player_Pause();

继续

c 复制代码

Player_Resume();

停止

c 复制代码

Player_Stop();

十二、按键控制

定义三个按键：

按键	功能
KEY1	播放暂停
KEY2	下一曲
KEY3	音量+

示例：

c 复制代码

if(KEY1_Pressed())
{
    Player_Pause();
}

十三、OLED显示歌曲信息

显示：

text 复制代码

Now Playing

song1.mp3

Vol:20

实现：

c 复制代码

OLED_ShowString(0,0,
               file_name);

十四、项目运行流程

text 复制代码

上电
 ↓
初始化SPI
 ↓
初始化SD卡
 ↓
初始化VS1053
 ↓
扫描MP3文件
 ↓
播放第一首
 ↓
等待按键操作

十五、常见问题分析

问题1：没有声音

检查：

喇叭
功放
VS1053供电

问题2：声音断断续续

原因：

text 复制代码

SD读取速度不足

解决：

增加缓冲区。

问题3：歌曲打不开

检查：

text 复制代码

FatFS配置

以及：

text 复制代码

文件名格式

问题4：有杂音

检查：

电源纹波
地线布局
功放电路

十六、项目升级方向

升级1：歌词显示

支持：

text 复制代码

LRC文件

升级2：蓝牙播放

加入：

HC05
ESP32

实现无线音乐播放。

升级3：触摸屏界面

升级为：

text 复制代码

音乐播放器GUI

升级4：RTOS版本

任务划分：

text 复制代码

播放任务

按键任务

显示任务

文件管理任务

十七、项目知识点总结

通过这个项目你将掌握：

✅ SPI通信

✅ FatFS文件系统

✅ SD卡读写

✅ MP3解码原理

✅ 音频播放流程

✅ STM32工程架构设计

✅ 嵌入式多模块协同开发

总结

很多人觉得 MP3 播放器是一个复杂项目，其实拆开来看无非就是：

text 复制代码

SD卡读文件
        +
MP3解码
        +
音频输出

真正的价值不在于播放音乐，而在于你会接触到一个完整嵌入式产品的开发流程：

文件系统 + 通信接口 + 音频处理 + 人机交互