做这个项目算是缘分。我原本在做一个用STM32控制小玩意的练手项目，结果在查资料时看到一堆"51单片机简易电子琴 矩阵键盘8音符 按键长按发声"的提问，突然意识到很多刚入门的朋友都在卡在同一个点上：怎么把按键、声音、定时器这些零散的东西拼成一个能跑起来、能演奏的完整系统。刚好我手头有一块STM32F103C8T6最小系统板，干脆就把它做成一个"基于STM32的电子琴音乐播放器"——既能当电子琴弹，又能自动播放预置音乐，顺便把矩阵键盘扫描、PWM发声、定时器中断、状态机这些嵌入式基本功全部串起来。这个项目非常适合正在学STM32的人，尤其是做完流水灯和呼吸灯之后不知道下一步该做什么的朋友。今天我就把这套东西从头到尾拆开，把硬件连接、软件逻辑、踩过的坑一次讲清楚。
1. 整体方案设计与模块拆解
1.1 需求拆解：电子琴与音乐播放器结合的本质
先说清楚这个项目到底在做一件什么事。要做一个"电子琴音乐播放器"，本质上就是要实现两个功能模式：一个是演奏模式，用户按下键盘上的按键，系统立刻发出对应音高的声音，松开按键就停止；另一个是播放模式，系统按照预置曲谱自动发声，不需要人为干预。
这两个模式看起来差别很大，但站在硬件角度它们的底层需求是一致的：都需要在某个时间点产生某个频率的声音，并持续一段可控的时间。演奏模式里，时间长短由用户按键的时长决定；播放模式里，时间长短由曲谱中音符的时值决定。所以整个项目的核心就收敛成了一个点：如何用STM32稳定地产生指定频率、指定时长的方波信号。
把这个核心想明白之后，整个系统就分成了几大块。键盘输入负责捕捉用户意图，频率生成负责把音高翻译成电信号，时序控制负责管理每个音的持续时间，再加上一套曲谱数据结构和模式切换逻辑，就可以把两个功能统一在同一套框架里。我在设计时没有把电子琴和播放器当作两个割裂的功能去写两套代码，而是复用了同一个发声引擎，只是把"谁来决定按下和松开"这件事做了抽象——演奏模式由用户按键驱动，播放模式由软件定时器驱动。这样代码量大幅减少，结构也干净很多。
1.2 核心硬件选型与理由
主控芯片我选了STM32F103C8T6。选它不是因为参数有多强，而是因为它有72MHz主频、多个定时器、丰富的中断资源，这些能力对于产生音频信号来说绰绰有余。更重要的是它的资料在国内社区非常丰富，几乎所有问题都能搜到现成解决办法，对新手极其友好。
发声器件上用无源蜂鸣器，有源蜂鸣器买回来就能响，但它内部自带振荡电路，频率固定，想要控制出不同的音高根本不可能。无源蜂鸣器需要外部给它一定频率的方波才会发声，正好我们能通过STM32定时器输出任意频率的方波，两者配合完美。至于很多人纠结的用DAC加功放和喇叭的方案，虽然音质好很多，但对新手来说引入了运放调音、功放选型、滤波电路设计等一系列新问题，我建议先把方波方案跑通，后面有兴趣再升级。
按键部分用4x4矩阵键盘。为什么不用8个独立按键？16个独立按键会占掉16个GPIO，而STM32F103C8T6虽然I/O不少，但我们要留出足够引脚给调试和后续扩展。矩阵键盘用8个引脚（4行4列）就能管理16个按键，资源利用效率高得明显。而且这个项目需要的功能不止8个音符，还需要播放、暂停、切歌、模式切换这些控制功能，16键刚好能把音阶键和功能键分开，互不干扰。
| 器件 | 型号/规格 | 作用 | 选择理由 |
|---|---|---|---|
| 主控 | STM32F103C8T6 | 逻辑控制、频率生成 | 资源充足、资料丰富、性价比高 |
| 发热源 | 无源蜂鸣器（5V） | 发声 | 可通过方波频率精确控制音高 |
| 键盘 | 4x4薄膜矩阵键盘 | 输入音符与控制命令 | 8个GPIO管理16个按键，节省引脚 |
| 显示 | OLED SSD1306（可选） | 显示当前模式、音符 | 提升交互体验，非必需 |
| 电源 | USB 5V转3.3V模块 | 供电 | 开发板自带稳压，简单可靠 |
硬件清单确认之后，我建议你在动手前先画一画引脚分配表，别等焊好了才发现引脚被占用。我的分配思路是：PB0-PB3做矩阵键盘行线，PB4-PB7做列线，PA0输出PWM到蜂鸣器，PA1接按键LED指示灯，剩余引脚留作SWD调试或OLED扩展。这个分配的讲究在于把定时器通道、复用功能优先级都考虑进去，避免后续调试时被引脚冲突卡住。
2. 硬件电路设计要点
2.1 矩阵键盘的电路原理与连接
矩阵键盘电路这块，很多新手第一次接触时会觉得神秘，其实拆开了看就是一组行线与列线的交叉网络。4x4矩阵意味着有4根行线和4根列线，每个按键连接某一行和某一列。扫描的核心思路是：逐行置高电平，读取列线的电平状态，二者相交的位置就是被按下的按键。
具体到硬件连接，我在STM32最小系统板上的接法是行线接PB0-PB3并配置为推挽输出，列线接PB4-PB7并配置为输入下拉模式。扫描时，先把PB0输出高电平、PB1-PB3输出低电平，再读取PB4-PB7的电平状态，如果某一列为高，就说明第一行对应的键被按下；然后切换到PB1输出高电平，再读一次列状态，以此类推。整个过程循环很快，人感觉不到延迟。
有个细节必须注意：列线一定要加上下拉电阻。有些开发板内部没有上下拉或者默认状态不确定，会造成读到的电平随机跳变，导致按键判定错乱。STM32的GPIO内部有可配置的上拉/下拉电阻，我会在代码里把它们打开，但为了稳定起见，我在硬件上也给四根列线各接了一个10K下拉电阻。这个习惯是我从工业控制板的设计上学来的——能用硬件兜底的，就不要完全依赖软件配置。
2.2 发声方案对比：无源蜂鸣器与DAC功放
在发声方案上，很多人一上来就纠结"声音好不好听"。我的建议是别在第一步追求音质，先用最简单的方案把功能跑通。无源蜂鸣器加定时器PWM的方案，听起来确实比较"电子味"，像早期游戏机的声音，但它有一个不可替代的优点：原理简单、调试容易、硬件成本极低。你只需要一根I/O通过三极管驱动蜂鸣器，不需要额外的音频放大器、不需要滤波器、不需要考虑阻抗匹配。
如果后续想提升音质，可以考虑用STM32的DAC输出正弦波，再经过功放芯片驱动小喇叭。这个方案的音色接近真实乐器，但你需要处理波形的查表生成、DMA传输、低通滤波、功放芯片的选型和布线等问题。我自己在升级版里用的是MCP4725这种I2C接口的DAC模块加PAM8403功放模块，解决了STM32F103C8T6只有一路DAC不够用的问题，效果确实提升了一个档次。但初版调试时，我仍然建议先用蜂鸣器把时序逻辑调通，因为系统核心难点根本不在发声器件的档次，而在于音符时序的控制。
2.3 电源与噪声处理经验
电源这个事，我吃过一次亏。最初我把蜂鸣器直接接到STM32的GPIO上，一响起来屏幕就闪，有时候还会莫名其妙复位。后来用示波器一看，蜂鸣器启动瞬间的电流尖峰直接把3.3V电压拉到了2.8V，导致主控供电不足。解决方案有两个：一是蜂鸣器使用独立的5V供电，通过三极管或MOS管来开关；二是在蜂鸣器两端并联一个100uF电解电容和一个小容量的104陶瓷电容，吸收瞬间冲击。
三极管驱动电路也很简单，我用的是S8050 NPN三极管，基极串一个1K电阻接到STM32的PA0引脚，发射极接地，集电极接蜂鸣器的负极，蜂鸣器正极接5V电源。这样STM32 GPIO只需要提供几个毫安的基极电流，蜂鸣器的几十毫安电流直接从5V电源走，主控的3.3V完全不受影响。如果手头有MOS管，比如AO3400，效果会更好，导通压降更小，声音更响亮。
3. 核心软件架构与音符频率设计
3.1 音符频率表的计算与映射
电子琴的本质，是把每个音名映射到一个确定的频率。国际标准音A4的频率是440Hz，每升高一个半音（比如从C到升C），频率乘以2的1/12次方，即约1.059463。而每升高一个八度，频率翻倍。通过这个规律，可以计算出从C4到B5一共16个音符的频率值，正好对应4x4键盘的前两行。
我用C语言定义了一个音符频率查找表，用数组下标来索引音名。比如数组的第一个元素对应C4（261.63Hz），第二个对应C#4（277.18Hz），以此类推。这样我只需要定义一个索引宏，比如#define NOTE_C4 0、#define NOTE_CS4 1，代码可读性就很高。查找表比实时计算速度更快，而且避免浮点运算——对没有浮点单元的STM32F103来说，整型查找表是非常划算的做法。
频率有了之后，下一步就要把它转换为定时器的参数。我用的是TIM2的PWM输出模式，TIM2挂载在APB1总线上，时钟频率是72MHz。要让定时器输出指定频率freq的方波，需要设置预分频器PSC和自动重装载值ARR。计算公式是freq = 72MHz / ((PSC+1) * (ARR+1))。我固定PSC为71，这样定时器计数频率就是1MHz，即每微秒计数一次，然后ARR就等于1000000/freq-1。这样ARR是一个整数，而且运算简单，误差通常在0.1%以内，人耳完全分辨不出来。
| 音符 | 频率(Hz) | 定时器ARR(预分频71) |
|---|---|---|
| C4 | 261.63 | 3822 |
| D4 | 293.66 | 3405 |
| E4 | 329.63 | 3033 |
| F4 | 349.23 | 2863 |
| G4 | 392.00 | 2551 |
| A4 | 440.00 | 2272 |
| B4 | 493.88 | 2024 |
| C5 | 523.25 | 1911 |
3.2 软件整体架构：前后台与中断分层
这个项目的软件架构我采用了典型的前后台结构：一个主循环负责键盘扫描和模式调度，若干个定时器中断负责精确的发声控制。这个架构虽然朴素，但对于教学和演示来说是最容易理解和最稳定的。不要把复杂的时间片轮询或RTOS引入这个项目，除非你想增加不必要的调试难度。
主循环里做的事情是扫描矩阵键盘、处理按键事件、更新OLED显示。定时器中断里，TIM2负责产生音符频率的PWM信号，这是发声的核心；TIM3作为节拍计时器，在播放模式下每10毫秒产生一次中断，用来计时当前音符已经播放了多久、什么时候需要播放下一个音符。
这里有个很重要的设计思路：发声和按键扫描是解耦的。演奏模式下，按键按下时只做一件事——告诉TIM2"现在你要输出某个频率的PWM"；按键松开时告诉TIM2"停止输出"。至于这个键按了多久、扫描期间抖动了一下，这些都是键盘扫描层应该处理的，不能让它们干扰到发声层。如果按键状态判断与PWM输出耦合得太紧，很容易出现按一个键时声音卡顿或者破音。
3.3 曲谱数据结构设计：用数组描述音乐
播放模式的关键在于定义一种容易编写和解析的音乐数据格式。我采用的是"音符-音长"二元组数组。每个音符用一个结构体表示，包含音高索引和时值计数。这个设计借鉴了MIDI文件的思路，但去掉了文件解析的复杂度，直接用C语言数组固化在Flash里。
typedef struct { uint8_t pitch; // 音高索引，0表示休止符 uint16_t duration; // 节拍数，单位：1/4拍 } Note_t;然后定义节拍速度，比如设定一分钟120拍，那么一拍就是500毫秒。我让TIM3的时基为10毫秒中断一次，那么一个四分音符（1拍）就对应50个中断计数。这个计数关系在代码里用一个宏定义#define BEAT_QUARTER 50来表示，清晰明了。
曲谱的编排就非常直观了。以《小星星》为例，它的第一句是"C C G G A A G"，对应的音符时长是两个半拍、两个半拍、两个半拍、一个整拍，所以在数组里写出来就是：
const Note_t melody_star[] = { {NOTE_C4, HALF}, {NOTE_C4, HALF}, {NOTE_G4, HALF}, {NOTE_G4, HALF}, {NOTE_A4, HALF}, {NOTE_A4, HALF}, {NOTE_G4, FULL}, };为了让播放器可连续播放多首曲子，我定义了一个曲目列表，把所有预置歌曲的数组地址和长度登记在册。播放器通过一个索引变量来指向当前播放的曲目，支持"上一曲""下一曲"切换。这个设计扩展起来很方便，以后加新曲目只需要新增一个数组，然后在列表里登记一行，播放引擎完全不用改。
4. 关键代码实现与调试过程
4.1 TIM2 PWM发声模块的初始化与实现
TIM2的PWM输出是这个项目的声音之源。我先把它的完整配置贴出来，然后逐行解释为什么这样设。
void TIM2_PWM_Init(void) { GPIO_InitTypeDef gpio_init; TIM_TimeBaseInitTypeDef tim_base; TIM_OCInitTypeDef tim_oc; // 1. 使能时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); // 2. 配置PA0为复用推挽输出 gpio_init.GPIO_Pin = GPIO_Pin_0; gpio_init.GPIO_Mode = GPIO_Mode_AF_PP; gpio_init.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &gpio_init); // 3. 定时器时基：预分频71，计数频率为1MHz tim_base.TIM_Prescaler = 71; tim_base.TIM_CounterMode = TIM_CounterMode_Up; tim_base.TIM_Period = 3822; // 默认输出C4，261.63Hz tim_base.TIM_ClockDivision = TIM_CKD_DIV1; TIM_TimeBaseInit(TIM2, &tim_base); // 4. PWM模式1，占空比50% tim_oc.TIM_OCMode = TIM_OCMode_PWM1; tim_oc.TIM_OutputState = TIM_OutputState_Enable; tim_oc.TIM_Pulse = 1911; // 占空比50% tim_oc.TIM_OCPolarity = TIM_OCPolarity_High; TIM_OC1Init(TIM2, &tim_oc); TIM_OC1PreloadConfig(TIM2, TIM_OCPreload_Enable); // 5. 使能ARR预装载 TIM_ARRPreloadConfig(TIM2, ENABLE); }PA0复用为定时器2的通道1，这是数据手册里确定的映射关系，不能用错引脚。预分频器设为71，是因为系统主频72MHz除以72得到1MHz，也就是计数频率1微秒一次，这样ARR的值直接就是周期的微秒数，换算直观。占空比设为50%，意味着高低电平各占一半，方波信号正好对称，驱动蜂鸣器的效率最高，声音最响亮。
播放某个音符时，只需要修改ARR并保持Pulse为ARR的一半：
void Tone_Play(uint16_t freq) { if (freq == 0) { TIM_Cmd(TIM2, DISABLE); GPIO_ResetBits(GPIOA, GPIO_Pin_0); return; } uint16_t arr = 1000000 / freq - 1; TIM_SetAutoreload(TIM2, arr); TIM_SetCompare1(TIM2, arr / 2); TIM_Cmd(TIM2, ENABLE); }这里要注意一个坑：不能在TIM_SetAutoreload之前让定时器处于停止状态，否则改ARR不生效。我最初写代码时就因为顺序错了，导致频率怎么改都没有变化，花了大半天排查。先设ARR、再设CCR、最后使能定时器，这个顺序是经过验证的。
4.2 矩阵键盘扫描与长按识别
键盘扫描的代码有很多种写法，我采用的是"逐行拉高、按列读入"的经典方法，同时加入了状态机和消抖逻辑。独立按键的消抖大家都懂，延时10到20毫秒再确认；但矩阵键盘的消抖如果简单地对每一个按键延时，会严重拖慢整体扫描速度，导致其他按键响应迟钝。
我使用的改进方案是"边沿检测+延迟确认"的两步法。第一步先快速扫描得到当前行和列的编号，如果与上次状态不同，启动一个20毫秒的软件定时器；第二步在定时器到期后再次读取同一位置的按键状态，如果依然按下，才认定这是一个有效的按键事件。用语言描述可能有点绕，看代码会更直观。
#define KEY_ROWS 4 #define KEY_COLS 4 uint8_t key_scan(void) { uint8_t row, col; for (row = 0; row < KEY_ROWS; row++) { // 当前行输出高，其余行输出低 GPIO_Write(GPIOB, (uint16_t)(0x01 << row)); delay_us(10); // 读取列状态 uint8_t col_data = GPIO_ReadInputData(GPIOB) >> 4; if (col_data != 0x0F) { for (col = 0; col < KEY_COLS; col++) { if ((col_data & (0x01 << col)) != 0) { return row * KEY_COLS + col; } } } } return 0xFF; // 无按键 }这个扫描函数返回0-15的按键编号，0xFF表示无按键。调用者需要自己做消抖和状态处理。长按识别的思路是：在检测到按键按下之后，记录按下的时间戳；如果该按键持续按下超过500毫秒，判定为长按，触发长按对应的动作；如果不到500毫秒就松开了，则判定为短按，触发短按对应的动作。这个时间戳不需要用RTC，直接用主循环的循环计数或HAL_GetTick()（标准库用SysTick）来记录即可。
4.3 播放状态机：从演奏模式到音乐模式
模式切换用状态机来实现，是这个项目中最优雅的一部分。我把系统分为三个状态：MODE_IDLE（待机）、MODE_PLAY（演奏）、MODE_MUSIC（自动播放）。初始状态是MODE_IDLE，此时按任何音符键会直接进入演奏模式并响音；按"播放"功能键会进入音乐模式开始放歌。
状态机的核心代码用switch-case实现：
void mode_update(KeyEvent_t *evt) { switch (current_mode) { case MODE_IDLE: if (evt->type == KEY_SHORT_PRESS) { if (evt->key < 8) { current_mode = MODE_PLAY; Tone_Play(note_freq[evt->key]); } else if (evt->key == KEY_PLAY) { current_mode = MODE_MUSIC; music_start(0); } } break; case MODE_PLAY: if (evt->type == KEY_SHORT_PRESS) { if (evt->key < 8) { Tone_Play(note_freq[evt->key]); } } else if (evt->type == KEY_LONG_PRESS || evt->type == KEY_RELEASE) { current_mode = MODE_IDLE; Tone_Stop(); } break; case MODE_MUSIC: if (evt->type == KEY_SHORT_PRESS) { if (evt->key == KEY_STOP) { music_stop(); current_mode = MODE_IDLE; } else if (evt->key == KEY_NEXT) { music_next(); } } break; } }这里有一个细节值得说明：在演奏模式下，短按任意音符键就是切换音符，这要求键盘扫描能够区分"新的按键事件"和"按住同一个按键不松"。按键事件结构体里包含了按键编号和事件类型，事件类型可以是按下、松开、长按、短按。每次扫描周期，状态机只处理事件，不关心底层GPIO的状态，这大大降低了耦合度。
4.4 播放引擎：节拍计时与音符切换
音乐模式的核心是播放引擎，它由一个TIM3中断定时驱动。TIM3配置为10毫秒产生一次中断，中断服务函数里做以下三件事：累加节拍计数、检查当前音符是否播完、播完则加载下一个音符。
volatile uint16_t tick_count = 0; volatile uint8_t music_flag = 0; volatile uint16_t note_index = 0; void TIM3_IRQHandler(void) { if (TIM_GetITStatus(TIM3, TIM_IT_Update)) { TIM_ClearITPendingBit(TIM3, TIM_IT_Update); if (music_flag) { tick_count++; if (tick_count >= current_note_duration) { tick_count = 0; note_index++; if (note_index >= current_song_len) { music_flag = 0; // 播放结束 Tone_Stop(); } else { tone_set_from_note(¤t_song[note_index]); } } } } }current_song指针指向当前播放的曲谱数组，current_note_duration表示当前音符持续的节拍计数值。每次进入中断先检查计数器有没有到达当前音符的时值，到了就切换到下一个音符。这种用粗粒度时基（10毫秒）驱动音乐进度、用高频PWM产生音调的方式，避免了在音频回路里做耗时运算，稳定性非常高。
播放过程中如果用户按键停止，只需要把music_flag清零，并调用Tone_Stop()停掉PWM输出，系统立刻回到待机状态，不需要额外做复杂的清理工作。这也是状态机设计的好处：状态切换只发生在明确的事件点，没有异步的竞态问题。
5. 实测过程中踩过的坑与排查技巧
5.1 按键抖动导致音符乱跳
第一个遇到的典型问题就是按键抖动。最开始我的扫描函数没有消抖，按下一次键经常被识别成两三次，声音卡顿得像老式电话拨号。排查方法是用串口把每次识别到的按键编号打印出来，发现按下一次，串口输出了两到三个不同编号——这就是抖动导致的。
解决方式是两层组合。第一层是硬件上在列线对地接10K下拉电阻，把不确定的电平稳定下来；第二层是软件上采用我之前说的"边沿检测+延迟确认"流程。总结一下核心经验：矩阵键盘的消抖必须在按键编号确认之前完成，不能在确认之后再补救。如果先判定出一个按键编号，再去做延时消抖，那么消抖期间这个编号可能已经因为抖动变成了另一个值，等于白做了。
5.2 蜂鸣器音量小或无声
蜂鸣器无声或音量极小，这个问题常见的诱因有三个。第一个是GPIO驱动能力不足，直接接蜂鸣器的话，GPIO最大只能提供20mA左右电流，很多无源蜂鸣器工作电流远超这个值，电压被拉低，声音自然小；解决方法是加三极管或MOS管驱动。第二个是频率参数配置错误，有些朋友把ARR的值直接当作频率去设置，导致实际输出频率差了数千倍，听起来像"滋滋"的电流声而不是乐音；这时应该用示波器或者耳朵对比一根琴弦的频率，确认输出频率接近目标。第三个是极性接反，无源蜂鸣器有正负极之分，接反了不会发声。用万用表二极管挡可以测出蜂鸣器的极性，正向导通时会有轻微的蜂鸣声。
5.3 长按与短按识别冲突
长按和短按同时存在时，最容易出现的问题就是：用户明明想长按切换曲目，结果系统先触发了短按动作；或者明明想短按弹一个音，系统却因为按键停留时间稍长就判定成长按，导致音突然断了。
我的解决思路是：短按动作在按键松开时触发，长按动作在持续按住达到阈值时触发。这样安排的好处是，当系统检测到长按条件满足并执行了长按动作后，即使后续用户松开按键，也不会再触发短按，因为短按的触发条件要求按键在此之前出现过完整的按下-松开过程。这条逻辑看起来简单，但很多人一开始都写成"按下时立即触发短按，超过阈值再触发长按"，结果必然是短按和长按同时触发，逻辑冲突。我做了一个按下、释放、时长三分法的表格，方便理解：
| 按键过程 | 事件类型 | 触发时机 |
|---|---|---|
| 按下-松开（<500ms） | 短按 | 松开瞬间 |
| 按下-持续（>=500ms） | 长按 | 达到阈值瞬间 |
| 长按后的释放 | 无 | 不触发任何事件 |
5.4 播放模式下按键响应卡顿
播放模式下按停止键，有时要等半秒才响应。这个问题出在TIM3中断函数的执行时间上。早期版本里，我在中断服务函数中直接调用了Tone_Play()，而这个函数内部有时会调用GPIO操作和定时器寄存器修改，需要十几个微秒。虽然看起来不多，但TIM3的中断频率是100Hz，如果主循环里刚好在扫描键盘的延时阶段，按键响应就会被中断反复打断，导致延迟不均匀。
优化方案是在中断服务函数中只做标志位的置位和索引变化，把真正的频率切换操作放到主循环中完成。中断里只负责计数，主循环检测到note_index发生了变化，然后调用Tone_Play()更新频率。这样中断服务函数的执行时间从十几微秒降到了不到一微秒，系统响应变得非常平稳。这也是嵌入式开发中一个重要的经验法则：中断服务函数越短越好，凡是能在主循环中处理的事情，尽量不要压在中断里做。
5.5 常见问题速查表
| 现象 | 可能原因 | 排查方向 |
|---|---|---|
| 按下按键无反应 | 接线错误、GPIO模式配置错误 | 用万用表测行线电平均值 |
| 串口输出按键编号跳动 | 抖动未滤除 | 检查下拉电阻、延时是否够长 |
| 蜂鸣器有"嘶嘶"声 | PWM频率与目标不符 | 检查PSC和ARR计算 |
| 音准偏低或偏高 | 晶振频率偏差导致定时器不准 | 检查时钟配置、改用HSI或校准HSE |
| 播放到一半卡住 | 曲谱长度或索引越界 | 打印note_index检查边界 |
| 长按误触发生 | 长按阈值设置过短 | 增大阈值或改为松开确认 |
6. 从项目到催生更多想法的扩展方向
这个项目做完之后，整个系统的框架非常清晰，它的扩展空间大得超乎想象。我建议你沿着几个方向继续深挖，每一个方向都能独立做成一个不错的作品。
第一个方向是音质升级。把无源蜂鸣器换成DAC加喇叭，利用STM32F103的DAC输出平滑的正弦波，可以让声音从单调的方波变成接近真实乐器的音色。更进一步，可以采集不同乐器的采样波形存入Flash，播放音符时直接调用对应的采样，这就变成了一个简易的波表合成器。
第二个方向是增加OLED显示界面。用I2C接口的0.96寸OLED，实时显示当前状态是演奏模式还是播放模式、显示当前音符的简谱或英语名称、显示的播放进度。这会让作品瞬间有了"产品感"，也适合拿去做课程设计或毕业设计展示。
第三个方向是加入音色控制。比如加上一个旋钮调节音量和速度，或者加上一个按键切换不同的音阶调式（C大调、G大调等）。这些功能本质上都是在已有的状态机架构上增加状态和参数，不需要改动底层发声引擎，恰好验证了你对软件分层设计的理解有没有到位。
我个人建议你优先尝试音质升级这条路，因为它在硬件上增加的东西不多（一个DAC模块、一个功放模块、一个小喇叭），但收获的成就感会大得多。听着自己焊的板子演奏出接近八音盒"音色的旋律，那种满足感是光看仿真跑通完全比不上的。做完这个项目你也会发现，STM32嵌入式开发并没有多神秘，无非是理解清楚"什么功能对应什么外设、什么中断、什么数据格式"，然后把他们组装起来。每一次烧录调试、每一次用示波器抓到正确的波形，都是在帮助你建立对这一行的真实手感。希望这篇分享能帮你少走一些弯路，也期待看到你的版本有什么不一样的想法。
