# map3

**Repository Path**: winshengly/map3

## Basic Information

- **Project Name**: map3
- **Description**: 这是一个基于stm32的项目。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# STM32F103 MP3播放器 (基于VS1053)

一个功能完整的嵌入式MP3播放器项目，运行在STM32F103微控制器上。

## 项目简介

本项目是一个基于STM32F103RCT6芯片的MP3播放器，支持SD卡存储、触摸屏控制、歌词显示等功能。

## 硬件配置

- **主控芯片**: STM32F103RCT6 (ARM Cortex-M3)
- **MP3解码器**: VS1053
- **显示屏**: ILI9341 2.8寸TFT LCD (320x240)
- **触摸屏控制器**: XPT2046
- **存储**: SD卡 (SPI接口) + SPI Flash
- **文件系统**: FATFS

## 功能特性

- 🎵 MP3文件播放 (支持VBR/CBR)
- 📺 中文歌曲名显示
- 📝 LRC歌词同步显示
- 👆 触摸屏控制 (播放/暂停、上一曲、下一曲)
- 🔀 支持SD卡热插拔
- 💾 自动记忆播放位置

## 项目结构

```
├── Libraries/           # STM32标准库
│   ├── CMSIS/          # ARM Cortex-M3内核文件
│   └── FWlib/         # STM32外设驱动库
├── User/               # 用户应用程序
│   ├── main.c         # 主程序入口
│   ├── vs1053/        # VS1053驱动
│   ├── lcd/           # 显示屏驱动
│   ├── key/           # 按键驱动
│   ├── led/           # LED驱动
│   ├── sdcard/        # SD卡驱动
│   ├── flash/         # SPI Flash驱动
│   ├── FATFS/         # 文件系统
│   ├── cvs/           # LRC歌词解析
│   ├── usart/         # 串口通信
│   └── SysTick/       # 系统定时器
└── Output/             # 编译输出目录
```

## 编译说明

1. 使用Keil MDK打开项目文件 `Project.uvproj`
2. 选择目标芯片 `STM32F103RC`
3. 编译项目: Build (F7)
4. 下载到开发板

## 使用方法

1. 将MP3文件放入SD卡根目录
2. 如有LRC歌词，文件名需与MP3文件相同(扩展名为.lrc)
3. 上电后自动扫描SD卡中的音乐文件
4. 触摸屏操作:
   - 中间区域: 播放/暂停
   - 左侧: 上一曲
   - 右侧: 下一曲

## 依赖库

- STM32F10x标准外设库
- FATFS文件系统 (版本 R0.11)
- ILI9341 LCD驱动
- XPT2046触摸屏驱动
- VS1053 MP3解码器驱动

## 注意事项

- SD卡需格式化为FAT32文件系统
- 建议使用英文文件名以获得最佳兼容性
- LRC歌词需符合标准格式: `[mm:ss.xx]歌词内容`

## 许可证

本项目仅供学习交流使用。