1.1 项目名称

基于 EV78Y10A SAMG55 Curiosity Audio Board 嵌入式多媒体播放器开发项目

1.2 硬件平台

开发板：EV78Y10A SAMG55 Curiosity Audio Board（Microchip 官方音频评估板）主控：ATSAMG55J19B（ARM Cortex‑M4 @120MHz，内置 FPU）

1.3 项目目标

以音频处理为核心，搭建嵌入式多媒体软件平台：✅ 核心功能

1. USB Host 读取 U 盘媒体文件，FATFS 文件系统管理

2. I2S+DMA 硬件音频驱动，实现 MP3/AAC 音频软件解码播放

3. 播放器状态机：播放、暂停、停止、音量调节、循环播放

4. 串口指令交互，日志输出调试接口

   ✅ 扩展可选功能

5. 外接 SPI 显示屏，实现 QVGA 及以下分辨率轻量级 H.264 软解画面展示

6. 预留音频算法接口（均衡器、降噪、滤波算法接入）

1.4 范围边界（重要说明）

ATSAMG55 为通用 MCU，无内置 VPU 硬件视频解码器，无硬件多媒体加速单元

• 适合：音频开发、音频算法验证、低分辨率多媒体演示

• 不适合：高清视频、1080P 硬解码场景（与多媒体 SoC 方案做区分）

2. 硬件平台规格与资源

2.1 核心硬件清单

1. 主控：ATSAMG55J19B Cortex‑M4 @120MHz

2. 调试单元：板载 EDBG 调试器，单 USB 实现：固件下载、虚拟串口日志、供电

3. 时钟：12MHz 主振荡器、32.768K RTC 晶振

4. 音频外设：硬件 I2S 接口、PDC DMA 控制器（音频流式传输）

5. 接口资源

• Target USB / Device USB 双 USB 接口（支持 USB Host 读取 U 盘）

• mikroBUS 扩展插槽（可外接音频 Codec、SPI LCD、传感器）

• X32 标准扩展排针：GPIO、MCLK、音频专用时钟引脚

• 用户按键 ×3、LED 指示灯、板载电流采样测量电路

1. 供电：USB 5V 供电

2.2 外部推荐配套外设

• I2S 音频 Codec 模块 + 功放扬声器

• SPI LCD 显示屏（mikroBUS 接口）

• U 盘（存放 MP3/AAC/ 低分辨率测试码流）

3. 整体软件方案架构

3.1 分层架构文本框图

plaintext

┌─────────────────────────────────────────────────────┐
│ 应用层：播放器状态机 + 串口指令交互任务                │
│ 指令：播放/暂停/停止/音量调节/循环控制                 │
└───────────────────┬─────────────────────────────────┘
                    │
┌───────────────────▼─────────────────────────────────┐
│ 多媒体中间层                                         │
│ ├─ FATFS 文件系统｜读取U盘媒体文件                   │
│ ├─ 文件解析模块｜媒体文件读取、码流缓冲               │
│ ├─ 音频解码器｜MP3/AAC轻量级软解码，输出PCM           │
│ └─（可选）简易视频解析｜低分辨率H.264软解             │
└───────────────────┬─────────────────────────────────┘
                    │
┌───────────────────▼─────────────────────────────────┐
│ 驱动适配层（基于Microchip ASF4）                     │
│ I2S驱动 + PDC DMA、USB Host驱动、GPIO、SPI显示驱动    │
└───────────────────┬─────────────────────────────────┘
                    │
┌───────────────────▼─────────────────────────────────┐
│ 硬件外设层：USB存储、I2S音频Codec、SPI LCD、按键LED  │
└─────────────────────────────────────────────────────┘

3.2 Mermaid 流程图（可直接粘贴飞书文档渲染，导出效果图）

调度控制

U盘媒体文件

FATFS文件系统

媒体解析&缓冲模块

音频解码器
MP3/AAC软解

可选：轻量H.264视频软解

I2S + PDC DMA驱动

音频Codec & 扬声器

SPI LCD驱动

显示屏

串口指令/按键控制任务

调度控制

U盘媒体文件

FATFS文件系统

媒体解析&缓冲模块

音频解码器
MP3/AAC软解

可选：轻量H.264视频软解

I2S + PDC DMA驱动

音频Codec & 扬声器

SPI LCD驱动

显示屏

串口指令/按键控制任务

4. 分阶段实现方案与开发细节

开发准则：分层调试，由底层向上，先调驱动，再集成应用；隔离问题，逐个验证

阶段 1：基础系统与调试链路调试

1. 接线：USB 数据线连接 PC 与开发板 EDBG 接口（图中白色 USB 线缆）

2. 使用 Microchip Studio 下载 LED / 按键官方示例工程

3. 验证板载 EDBG 功能：程序下载、虚拟串口日志输出

   ✅ 验收标准：按键触发 LED 状态变化，串口正常打印日志

   【效果图占位：串口日志调试界面截图】

阶段 2：USB Host + FATFS 文件系统调试

1. ASF4 图形化配置开启 USB Host、FATFS 组件

2. 实现 U 盘热插拔检测、挂载、文件遍历接口

3. 开发测试指令：串口命令列出 U 盘内所有音频文件

   ✅ 验收标准：U 盘插入后正常挂载，能够读取文件名称

阶段 3：I2S 音频驱动开发（核心模块）

1. 配置 I2S 主模式、采样率、位宽，配置 PDC DMA 环形缓冲区

2. 编写底层测试程序，输出正弦波 PCM 信号

3. 外接 Codec 功放，测试音频通路

   ✅ 验收标准：播放正弦波声音清晰，无杂音、爆音

   ⚠️ 重点风险：DMA 缓冲区大小、I2S 时钟分频配置直接影响音频流畅度

   【效果图占位：音频调试工位实拍】

阶段 4：多媒体解码集成开发

1. 移植开源轻量级音频解码器（minimp3/aacdec）

2. 解码器输出 PCM 数据流对接 I2S DMA 播放接口

3. 构建环形缓冲队列，解决文件读取与音频播放速率匹配问题

4. 实现播放器状态机（空闲→播放→暂停→停止异常恢复）

阶段 5：上层控制逻辑开发

1. 串口指令协议设计，外部可通过串口控制播放器

2. 按键事件绑定：快捷播放 / 暂停切换

3. 音量控制接口，调节 Codec PGA 增益

阶段 6：可选扩展功能：轻量级视频播放

1. SPI LCD 驱动调试，屏幕纯色测试、图片显示测试

2. 集成极简 H.264 软解码库，仅支持 QVGA 及以下分辨率

注意：受 Cortex-M4 性能限制，不支持高分辨率视频

阶段 7：稳定性优化与异常容错

1. U 盘热拔插异常捕获，防止程序死机

2. 非法音频文件过滤，解码器异常自动复位

3. 压力循环播放测试，检测内存泄漏、缓冲区溢出

5. Windows 开发环境完整搭建手册

5.1 开发环境说明

本平台不需要 WSL / 虚拟机，Microchip Studio 原生 Windows 环境编译下载。工具清单：

1. Microchip Studio（官方免费 IDE）

2. ASF4 软件驱动库

3. MobaXterm/TeraTerm（串口调试）

4. Windows FFmpeg（生成测试音频码流）

5.2 环境部署步骤

1. 安装 Microchip Studio，启动后进入【Tools → Packages】

2. 安装器件支持包：SAMG5 系列器件库；安装 ASF4 框架

3. EV78Y10A 开发板 USB 直连电脑，Windows 自动识别 EDBG 调试设备

4. 新建 ASF4 工程，目标芯片选择：ATSAMG55J19B

5. 使用图形化配置器（Harmony 配置工具）配置 I2S、USB、GPIO 外设，自动生成底层驱动代码

5.3 标准开发工作流

plaintext

Windows Microchip Studio源码编写
        ↓
一键编译生成HEX固件
        ↓
EDBG在线下载固件至SAMG55
        ↓
MobaXterm打开虚拟串口，实时监控运行日志
        ↓
U盘放入测试音频，上电进行播放功能验证

6. 标准化调试流程（故障分层定位方法）

出现异常，严格按照层级排查，快速缩小范围：

1. 完全无日志、程序无法下载

   → 检查 USB 线缆、EDBG 驱动、开发板供电

2. 系统正常运行，U 盘无法识别

   → USB Host 驱动、硬件接触、U 盘文件系统格式（推荐 FAT32）

3. 有日志，播放音频无声

   → I2S 时钟配置、Codec 硬件接线、DMA 缓冲区、Codec 使能引脚

4. 音频播放周期性卡顿、断音

   → 任务优先级不合理、DMA 缓冲区过小、后台任务占用 CPU

5. 声音杂音、变速失真

   → I2S 采样率与 PCM 采样率不匹配、位宽配置错误

6. 播放器遇到损坏文件卡死

   → 缺少码流异常检测、解码器没有安全复位逻辑

7. 关键模块设计说明

7.1 I2S 音频数据流设计

采用 PDC DMA 环形缓冲区，中断填充缓冲，减少 CPU 占用；音频任务设置为系统最高优先级，避免被其他任务抢占导致断音。

7.2 文件缓冲设计

设立两级缓冲：文件读取缓冲 + 音频解码输出缓冲；解决 U 盘读取速度波动，避免音频播放卡顿。

7.3 播放器状态机

状态定义：IDLE 空闲、PLAY 播放、PAUSE 暂停、ERROR 异常；任何状态切换做合法性校验，防止非法指令导致系统卡死。

8. 交付成果清单

1. Microchip Studio 完整工程源码（含 ASF4 驱动、播放器应用代码）

2. 可直接烧录的.hex固件文件

3. 本项目全套设计文档

4. 调试操作手册、串口指令协议文档

5. 测试用媒体文件（MP3/AAC 测试码流）

6. 实物照片、功能演示视频、测试记录

9. 素材采集规划（项目帖配套效果图点位）

1. 【主图】EV78Y10A SAMG55 Curiosity Audio Board 整机实拍（当前图片）

2. Microchip Studio 工程开发界面截图

3. MobaXterm 串口日志调试截图

4. I2S 音频通路调试工位实拍

5. U 盘音频播放功能演示视频

6. （选配）LCD 画面播放演示照片

素材统一命名规范图片：SAMG55_分类_日期_描述.jpg视频：SAMG55_DEMO_功能描述.mp4归档路径：项目共享盘→多媒体播放器→影像素材文件夹

10. 项目总结(未完待续)