app_player 本地文件播放示例

功能说明

演示如何使用 app_player 模块从本地文件系统（FAT32 SD 卡）播放音频文件，包括文件系统挂载、播放控制和事件回调处理。

硬件连接

PA27: PA（功放）控制引脚，用于控制音频功放的开关
SDMMC0 接口: 连接 SD 卡/eMMC，用于存储音频文件

使用 tools/fatfs_package 工具将音频文件打包为 FAT32 镜像：

# 进入工具目录
cd tools/fatfs_package

# 生成镜像文件（示例：32MB 大小）
./tools/fatfs_package/mkfatfs.py -o fatfs.img -s 32M -d samples/media/app_player/local_fs/res/audio_file -l SD

示例步骤

初始化 SD 卡并挂载 FAT32 文件系统到 /SD: 挂载点
初始化 app_player 模块并配置 PA 控制回调
创建播放器实例并注册事件回调
播放本地 MP3 音频文件 /SD:/001_network_suc.mp3
演示播放控制：播放、暂停、恢复、停止
销毁播放器实例

编译

重要提示：在编译前，请先确认您使用的开发板型号。SDK 目前支持以下开发板：

arcs_evb - ARCS EVB 评估板
arcs_mini - ARCS Mini 开发板

根据您的开发板型号，选择对应的编译命令：

在示例目录下执行编译:

# 使用 arcs_evb 开发板
./build.sh -C -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -DBOARD=arcs_mini

Note

如果在 SDK 根目录执行，需要指定示例路径:

# 使用 arcs_evb 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_mini

Note

确保已安装对应的工具链。

烧录

编译完成后，使用 SDK tools 目录下的 cskburn 工具烧录固件:

./tools/burn/cskburn -s /dev/ttyUSB0 -b 3000000 0x0 build/arcs.bin -C arcs

Note

烧录参数说明：

-s /dev/ttyUSB0：串口设备路径，需要根据实际情况修改 - Linux 系统：通常是 /dev/ttyUSB0 或 /dev/ttyACM0 - 可通过 ls /dev/tty* 命令查看可用串口设备 - 不同开发板或 USB 转串口芯片可能使用不同的设备名
-b 3000000：烧录波特率（3Mbps）
0x0：烧录起始地址
build/arcs.bin：编译生成的固件路径
-C arcs：芯片类型

注意事项：

确保开发板已正确连接到电脑
如果无法识别串口设备，请检查 USB 连接线是否正常，或尝试其他 USB 端口

预期输出

[app_player_sample] App Player Local Filesystem Sample
[app_player_sample] Starting playback demo...
[app_player_sample] Player prepared
[app_player_sample] Player playing
[app_player_sample] PA ON
[app_player_sample] Player stopped
[app_player_sample] PA OFF
[app_player_sample] Playback demo completed

核心 API

API	说明
`app_player_init()`	初始化 app_player 模块
`app_player_create()`	创建播放器实例
`app_player_register_callback()`	注册播放事件回调函数
`app_player_play()`	播放指定路径的音频文件
`app_player_pause()`	暂停播放
`app_player_resume()`	恢复播放
`app_player_stop()`	停止播放（同步接口）
`app_player_destroy()`	销毁播放器实例

关键代码

/* 初始化播放器 */
app_player_config_t config = {
    .pa_ctrl_callback = pa_control_callback
};
app_player_init(&config);

/* 创建播放器实例 */
app_player_t *player = app_player_create("tone");
app_player_register_callback(player, player_event_callback, NULL);

/* 播放本地文件 */
app_player_play(player, "/SD:/001_network_suc.mp3");

/* 播放控制 */
app_player_pause(player);
app_player_resume(player);
app_player_stop(player);

注意事项

文件系统镜像: 运行前需使用 mkfatfs.py 工具将音频文件打包为 FAT32 镜像并烧录到 eMMC
烧录顺序: 先烧录文件系统镜像到 eMMC（使用 --emmc 参数），再烧录应用固件到 Flash
文件路径格式: 播放路径必须包含挂载点前缀，如 /SD:/filename.mp3
PA 回调必填: app_player_init() 时必须提供 pa_ctrl_callback，用于控制功放开关
音频格式: 支持 MP3、WAV 等格式，推荐 16kHz、16bit 的音频文件