MP3 本地音乐播放器

源码路径:example/multimedia/audio/mp3_sd_player

支持的平台

  • sf32lb52-lchspi-ulp

概述

本例程将演示播放在 SD 卡上music目录下的的 MP3 或者 wav 音频文件,并提供了一个 shell 接口用于修改播放音量。

例程的使用

硬件需求

运行该例程前,需要准备:

警告

需要注意的是,在sf32lb52-lchspi-ulp平台上需要外接电池,否则长按按键会无法检测到。

编译和烧录

切换到例程 project 目录,运行 scons 命令执行编译:

scons --board=sf32lb52-lchspi-ulp -j32

切换到例程project/build_xx目录,运行uart_download.bat,按提示选择端口即可进行下载:

$ ./uart_download.bat

     Uart Download

please input the serial port num:5

关于编译、下载的详细步骤,请参考 快速上手 的相关介绍。

例程的预期结果

例程运行之后,会播放 SD 卡music目录下的 MP3 或者 wav 文件。上电之后默认处于停止播放状态。当列表中的音乐播放完毕后,会自动从第一首开始循环播放。

对于sf32lb52-lchspi-ulp平台,长按KEY1按键即可开始播放,播放中长按KEY1会停止播放,下次再次开始的时候会从第一首歌开始。短按KEY1按键可以暂停/继续播放,短按KEY2按键可以切换下一首音乐。

例程也提供了一个 shell 接口,可以通过volume命令获取或设置音量。输入volume命令可以查看当前音量,输入volume set <value>可以设置音量,<value>的范围是 0-15。

!shell

异常诊断

参考文档

更新记录

版本

日期

发布说明

0.0.1

6/2025

初始版本