使用ES8388和LCD的制作一个MP3播放器

该项目基于STM32F407ZGT6微控制器，设计并实现了在RT-Thread RT-Spark开发板上的裸机DIY MP3播放器。音乐音符通过软件合成，并借助I2S3外设以循环模式的DMA方式传输至板载ES8388音频编解码器。八首歌曲被编码为结构化音符数组，可通过三个GPIO中断驱动按钮进行导航。播放状态、曲目信息以及按钮使用说明显示在240x240分辨率的ST7789 LCD屏幕上，该屏幕通过8位并行模式的FSMC驱动。本项目未使用任何实时操作系统(RTOS)，而是由DMA传输回调处理实时音频缓冲区填充，EXTI回调处理按钮事件，主循环则通过一个可变标志位实现LCD画面的刷新。此方案旨在确保音频时序的确定性，并避免调度器带来的开销。

设计与测试

概念与系统概述

系统通过软件逐个生成方波，每秒44,100个样本。每首歌曲由一个连续的MusicalNote结构数组组成，每个结构包含频率(Hz)和持续时间(拍)。音频缓冲区存储512个16位样本(256对立体声)，并被分为两半。DMA控制器以循环模式将该缓冲区流式传输至I2S3，在第一半数据被消费时触发半完成回调，在第二半数据被消费时触发完全完成回调。当DMA传输一半数据时，CPU会重新填充另一半，从而确保音频输出持续不断，避免卡顿。

每个样本的相位增量由目标频率推导得出：

方波通过将当前相位与π进行比较来生成。低于π的采样输出+4096，高于π的采样输出-4096。在每个音符边界前插入一个1,323个采样点的静音间隔，该间隔在44.1 kHz下约为30毫秒，以防止相邻音符相互干扰。

样本中的持续时间是根据BPM计算得出的：

当样本计数器达到目标时，音符索引会向前移动。歌曲结束时，它会回到零。

硬件配置

微控制器

RT-Spark 板采用 LQFP144 封装的 STM32F407ZGT6 微控制器。本项目系统时钟由内部 HSI RC 振荡器提供，频率为 16 MHz，无需 PLL 增倍，因此 SYSCLK = 16 MHz，AHB = 16 MHz，APB1 = 4 MHz，APB2 = 8 MHz。专用的 PLLI2S(N=169，R=2)可产生 135.2 MHz 的 I2S 时钟，I2S3 由此获得精确的 44.1 kHz 音频采样率。

音频子系统

ES8388立体声编解码器(Everest Semiconductor)通过两条总线与STM32连接：

•I2C2(PB10 SCL，PB11 SDA，100 kHz)：寄存器配置

•I2S3(SPI3，飞利浦标准，16位数据，16位帧，44.1 kHz，主控发送)：音频采样串流

编解码器以从属模式运行，接收来自STM32的时钟和字选择信号。DAC输出通过LOUT1/ROUT1传输至主板的3.5毫米耳机插孔。音量通过向ES8388_DACCONTROL4和ES8388_DACCONTROL5写入衰减值来设置。驱动程序将0-100百分比映射到0-192寄存器范围，并进行反向处理，因为寄存器中的0表示最大输出。启动音量为100%。

编解码器初始化过程中最关键的步骤是在启用DAC电源之前，将0x18写入ES8388_DACCONTROL1寄存器。该寄存器明确设置了16位字长和飞利浦I2S对齐方式。如果设置错误，无论其他所有设置如何，都会导致无声或噪声。

LCD显示屏

板载的1.3英寸ST7789 LCD(240x240，RGB565)通过FSMC Bank 3以8位并行模式访问。数据/命令选择线连接至FSMC_A18，将命令寄存器设置在基地址0x68000000，数据寄存器设置在0x68000000 + 0x3FFFE。LCD驱动程序从RT-Thread BSP移植到裸机版本时，将所有RT-Thread操作系统类型(rt_uint16_t、rt_err_t、rt_thread_mdelay)替换为标准C类型和HAL延迟调用。

在初始化阶段，FSMC的时序设置较为保守(AddressSetupTime = 15，DataSetupTime = 255)，随后在LCD唤醒序列后通过直接写入FSMC_Bank1E->BWTR(ADDSET = 3，DATAST = 2)来收紧。在复位和初始化期间采用保守值是必要的;而在正常运行时，为了实现可接受的刷新速度，则需要更紧的设置。

背光在启动时通过PF9简单地将GPIO拉高。

按钮输入

四个导航按钮均通过STM32CubeMX配置的内部上拉电阻进行GPIO轮询，PC0引脚用于LEFT，PC1用于DOWN，PC4用于RIGHT，PC5用于UP。现在每个引脚都被配置为浮空输入模式，并启用GPIO_PULLUP功能，即未按下时读取逻辑高电平，按下时读取逻辑低电平。固件中使用表达式!HAL_GPIO_ReadPin(GPIOx, GPIO_Pin_n)对低电平激活的读数进行反转，使得值为1表示按键被按下。

在按钮状态检测中，主循环每次迭代结束时通过 HAL_Delay(50) 每 50 毫秒采样一次，因此通过将当前引脚状态与每个按钮静态变量中存储的上一状态进行比较来实现边缘检测。按键按下事件仅在从 0 到 1 的状态转换时触发，因此按住按钮不会导致重复触发。此外，无需单独设置去抖定时器或中断，因为 50 毫秒的轮询间隔能够自然抑制接触反弹，而接触反弹通常会在 5 至 20 毫秒内稳定下来。

DOWN按钮的PC1键为修饰键：当按住DOWN键并同时按下RIGHT键时，主音量增加10%;当按住DOWN键并按下LEFT键时，音量减少10%;当不再按住DOWN键时，LEFT和RIGHT键用于轨道导航：LEFT键跳转至上一曲目，RIGHT键跳转至下一曲目。无论DOWN键是否处于修饰状态，UP键每次按下都会在播放(PLAYING)和暂停(PAUSED)之间切换。

状态指示灯

外周总结

软件架构

歌曲数据结构

每首歌曲都通过两个自定义结构体来定义：

八首歌曲以常量数组的形式存储在程序闪存中，并通过 playlist[] 指针数组进行引用。当前播放的歌曲由一个易变指针 current_song 和索引 current_song_idx 来跟踪。切换歌曲时，会调用 Switch_song() 函数，该函数会短暂禁用中断，以原子方式更新指针、音符索引和采样计数器，然后重新启用中断。

音频缓冲区填充

Fill_Audio_Buffer(offset, length) 由 DMA 回调函数和写入方波样本的代码共同调用，用于将方波样本写入 debug_audio_buffer[512] 的正确半部分。它会按以下五种方式执行操作：

•检查是否暂停，如果是则写入零

•增加样本计数器，并将其与当前音符的目标持续时间进行比较

•在音符边界前插入一个30毫秒的静音间隙

•推进音符索引，并在歌曲结束时进行循环。

•计算当前相位累加器产生的方波输出

显示更新

Update_LCD_Display() 会使用 lcd_fill(0, 0, 240, 240, Black) 作为第一个操作，重新绘制整个 240x240 屏幕，以确保无论之前的 LCD 状态如何，都能获得一个干净的黑色画布。这种方法跳过了 lcd_clear()，后者依赖于上一次设置的前景/背景颜色寄存器，当在启动画面之后调用时会产生颜色溢出的视觉瑕疵。完整的填充操作直接将黑色像素数据写入 FSMC 窗口中的每个地址，不受颜色寄存器状态的影响。

屏幕分为四个区域：顶部显示播放器标题，状态栏以绿色显示“正在播放”或红色显示“暂停”，内容区域显示曲目编号和歌曲名称，底部则显示按钮控件和当前音量。超过13个字符的歌曲名称会在第13个字符前的最后一个空格处分段，并以24像素字体居中显示在两行上;底部控件和音量显示使用16像素字体，以节省垂直空间。

当检测到轨道变化或播放/暂停切换的按钮边缘时，主循环内部会设置 iupdateLCD 变量的可变标志。主循环在每个 50 毫秒周期结束时轮询该标志，若被设置则调用 Update_LCD_Display()，然后清除该标志。音量变化不会设置 updateLCD，而是直接调用 Update_Volume_Only()，后者使用 lcd_fill() 只清除底部一行，并重新绘制音量字符串。这样，在调整音量期间，屏幕其余部分不会被破坏或损坏。

并发模型

工作分布在四个执行上下文中：

音频通过 DMA 回调函数 HAL_12S_TxHalfCpltCallback 和 Hal_12S_TxCpltCallback 在中断上下文中完全运行，主循环仅操作 LCD 和按钮状态，这两者均无实时截止时间。由于不同上下文之间共享全局状态(如 current_song、is_paused、updateLCD、volume_level)，这些变量被声明为 volatile，以防止编译器优化缓存过时的值。Switch_song() 中多个变量的更新被包裹在 __disable_irq() 和 __enable_irq() 之中，以确保良好的访问性能。

文档

源文件中遍布内联注释。Fill_Audio_Buffer() 函数在每个决策点都有注释：暂停检查、相位递增公式、间隙逻辑以及音符推进。es8388_init() 驱动的注释解释了为何将 0x18 写入 DACCONTROL1(格式锁定)，以及为何在寄存器序列开始前必须设置静音位(扬声器保护)。LCD 驱动的注释指明了哪些 RT-Thread 调用被替换及其原因，包括双相 FSMC 时序策略。

本报告中标注的所有图形均需插入指定位置。原理图应使用 draw.io 或同等工具绘制，并在提交前作为图形插入。

播放列表

所有歌曲从最后一个音符完成时开始循环播放。无需用户操作即可重新开始播放曲目。

音频输出

音频信号为16位方波，每秒生成44,100个采样点，并通过DMA传输至I2S3。音符频率范围从C3(130.81 Hz)到B5(987.77 Hz)，覆盖三个全八度。相位累加器将目标周期精确匹配至一个采样周期以内，约为22微秒。

30毫秒的音符间间隔(1,323个采样点)在音符之间清晰可闻，能有效防止相邻音调相互模糊。如果没有这个间隔，相同频率的快速音符序列听起来会像一个连续的长音，而非独立的事件。

ES8388 DAC输出直接连接至3.5毫米耳机插孔。启动时，编解码器音量设置为100%，对应DACCONTROL4和DACCONTROL5寄存器的衰减值均为0。

按钮响应

主循环中，按钮状态每50毫秒采样一次。静态变量up_prev、left_prev、right_prev和down_prev分别存储每个按钮的上一次引脚读数。只有当当前读数与按压方向上的上一次读数不同时，才会记录按钮按下事件，因此无论按键被按住多长时间，每次实际按下都会生成一个事件。

当音轨发生变化时，会立即对按下边缘产生影响。随后，Switch_Song() 在临界区下重置音符索引和采样计数器，新的歌曲将在下一个DMA回调周期内开始播放。该周期在44、100 Hz频率下，使用256个采样大小的半缓冲区时，可在5.8毫秒内完成。因此，音轨切换不会产生可听的杂音，因为采样计数器能够干净地重置为零。

由于音量可通过按住“向下”按钮并按下“向右”或“向左”来以10%为步长从10%调整至100%，因此每次按键事件都会通过es8388_volume_set()立即更新ES8388的音量寄存器。音量水平会持续显示在LCD底部，并由Update_Volume_Only()刷新，该函数仅重绘底部一行，使用lcd_fill()清除旧值后再写入新值，从而避免每次音量变化时都需要重新绘制整个屏幕。这种部分重绘方式有效防止了调整过程中出现可见的闪烁现象。

LCD显示屏

所有显示状态均正确呈现。多词歌曲名称(例如“Bohemian Rhapsody”占用18个字符，“Eye of the Tiger”占用16个字符)在空格处清晰分段，并在两行中居中显示。每次按下向上按钮，状态文本会从绿色的“正在播放”变为红色的“暂停”。采用标志位刷新策略，仅在状态实际发生变化时才重新绘制屏幕，从而在连续播放期间保持LCD处于空闲状态。

波形参数

结果

结论

在STM32F407ZGT6上构建了一个无实时操作系统的裸机MP3播放器。音频合成、编解码器控制、按钮处理和LCD输出通过DMA循环缓冲、EXTI中断回调以及标志位轮询的主循环同时运行。

项目中最困难的部分并非音频合成，一旦DMA回调函数运行起来，这部分就变得简单明了。更棘手的问题在于ES8388的初始化序列和LCD驱动端口。编解码器需要按照特定的寄存器写入顺序操作，且在启用DAC功放前，必须先设置格式寄存器(0x18 in DACCONTROL1)。若设置错误，将耗费大量调试时间。而LCD端口则需要经过一系列RT-Thread API的替代方案，最终通过经验确定采用双相FSMC时序方法(初始化阶段较为保守，唤醒后更为精确)，而非直接参考数据手册。

选择裸机方式而非FreeRTOS是有具体原因的，因为音频缓冲区必须每5.8毫秒重新填充一次。抢占式调度器会引入抖动，而任务在错误时机切换会导致输出出现可听的异常。直接在DMA中断服务例程(ISR)中执行音频填充操作，可以完全消除这一风险。但这样带来的代价是主循环和中断上下文共享全局状态(如当前歌曲、是否暂停、更新后的LCD)，因此在多变量更新时需要谨慎使用volatile关键字，并设置短暂的临界段。

两个扩展功能可以改进这一设计。第一个是通过PA5上的内置电位器实现基于ADC的音量控制，这样无需按钮操作即可实现实时衰减调节。第二个是直接从NOR闪存或SD卡流式传输实际PCM音频，而不是在软件中生成方波，从而获得真正的音频保真度，而不会像当前方案那样产生类似蜂鸣的音调。

本文编译自hackster.io