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。
!
异常诊断
参考文档
更新记录
版本 |
日期 |
发布说明 |
---|---|---|
0.0.1 |
6/2025 |
初始版本 |