用FPGA和4x4矩阵键盘DIY一个简易电子琴：从Verilog代码到蜂鸣器发声的完整流程

用FPGA和4x4矩阵键盘打造你的专属电子琴：从零开始实现音乐创作自由

想象一下，当你按下键盘上的按键，开发板上的蜂鸣器立刻发出清脆的音符——这不是普通的电子琴，而是你用FPGA亲手打造的DIY乐器。本文将带你从零开始，用Verilog语言编写核心逻辑，通过4x4矩阵键盘控制音符输出，最终在FPGA开发板上实现一个完整的电子琴系统。

1. 项目概览与核心设计思路

这个项目的魅力在于将数字逻辑设计与音乐创作相结合。我们不需要复杂的音频芯片，仅凭FPGA内部的数字电路和简单的蜂鸣器就能实现基础音阶的演奏。整个系统的工作流程可以分为三个关键部分：

1. 键盘扫描模块：实时检测4x4矩阵键盘的按键状态
2. 音符生成模块：根据按键值产生对应频率的方波信号
3. 顶层控制系统：协调各模块工作并将信号输出到蜂鸣器

提示：FPGA的并行处理特性使其特别适合这类需要实时响应的应用，每个按键都能得到即时反馈，不会有传统MCU可能遇到的扫描延迟问题。

2. 硬件准备与环境搭建

2.1 所需硬件组件

• FPGA开发板：推荐使用Altera Cyclone系列（如EP2C8Q240C8）
• 4x4矩阵键盘：常见薄膜键盘或机械按键均可
• 有源蜂鸣器：注意区分有源和无源类型
• 连接线材：杜邦线若干
• 下载器：USB-Blaster或其他兼容JTAG下载器

2.2 开发环境配置

# Quartus II安装建议版本： # - Quartus Prime Lite Edition 18.1 # - 确保安装时包含ModelSim仿真工具

安装完成后，我们需要配置以下基本设置：

1. 创建新工程时选择正确的FPGA器件型号
2. 设置默认的Verilog HDL为设计语言
3. 配置仿真工具路径（如ModelSim）

3. 矩阵键盘扫描模块设计

矩阵键盘的扫描是项目的第一个技术难点。与独立按键不同，4x4矩阵键盘通过行列扫描方式检测按键状态，可以大大节省IO资源。

3.1 扫描原理详解

典型的扫描过程分为四个阶段：

1. 列扫描：依次将每一列拉低，其他列保持高电平
2. 行检测：读取行线状态，判断是否有按键按下
3. 消抖处理：通过延时消除机械按键的抖动
4. 键值编码：将行列位置转换为唯一的键值编码

// 键盘扫描状态机定义 parameter IDLE = 3'b000; // 空闲状态 parameter COL1_SCAN = 3'b001; // 第一列扫描 parameter COL2_SCAN = 3'b010; // 第二列扫描 parameter COL3_SCAN = 3'b011; // 第三列扫描 parameter COL4_SCAN = 3'b100; // 第四列扫描 parameter DEBOUNCE = 3'b101; // 消抖状态

3.2 Verilog实现关键代码

module key_scan( input clk, // 系统时钟(50MHz) input reset, // 异步复位 input [3:0] row, // 键盘行输入 output reg [3:0] col, // 键盘列输出 output reg [3:0] key_code, // 键值输出 output reg key_valid // 键值有效信号 ); reg [19:0] debounce_cnt; // 消抖计数器(约21ms) reg [2:0] state; // 状态机当前状态 reg [3:0] next_col; // 下一扫描列 reg [3:0] saved_row; // 保存的行值 always @(posedge clk or posedge reset) begin if(reset) begin state <= IDLE; col <= 4'b1111; key_valid <= 0; end else begin case(state) IDLE: begin col <= 4'b1110; // 开始扫描第一列 state <= COL1_SCAN; end COL1_SCAN, COL2_SCAN, COL3_SCAN, COL4_SCAN: begin if(row != 4'b1111) begin // 检测到按键按下 saved_row <= row; next_col <= col; state <= DEBOUNCE; debounce_cnt <= 0; end else begin // 切换到下一列扫描 col <= {col[2:0], 1'b1}; state <= state + 1; if(state == COL4_SCAN) state <= IDLE; end end DEBOUNCE: begin if(debounce_cnt == 20'hFFFFF) begin if(row == saved_row) begin // 确认按键仍然按下 key_code <= encode_key(next_col, saved_row); key_valid <= 1; end state <= IDLE; end else begin debounce_cnt <= debounce_cnt + 1; end end endcase end end function [3:0] encode_key(input [3:0] col, row); // 编码逻辑实现... endfunction endmodule

4. 音符生成与分频技术

4.1 音阶频率原理

音乐中的每个音符对应特定的频率。以A4(La)为例，标准频率为440Hz。我们的目标是通过FPGA的时钟分频产生这些特定频率的方波。

4.2 可配置分频器实现

module tone_generator( input clk, input [3:0] note_sel, // 音符选择 output reg pwm_out // 输出到蜂鸣器 ); reg [15:0] counter; reg [15:0] threshold; always @(posedge clk) begin case(note_sel) 4'h0: threshold <= 16'd95420; // Do 4'h1: threshold <= 16'd85034; // Re 4'h2: threshold <= 16'd75758; // Mi 4'h3: threshold <= 16'd71633; // Fa 4'h4: threshold <= 16'd63776; // Sol 4'h5: threshold <= 16'd56818; // La 4'h6: threshold <= 16'd50607; // Si default: threshold <= 0; // 无声 endcase if(counter >= threshold) begin counter <= 0; pwm_out <= ~pwm_out; end else begin counter <= counter + 1; end end endmodule

5. 系统集成与调试技巧

5.1 顶层模块设计

顶层模块需要实例化键盘扫描和音调生成模块，并处理它们之间的信号连接：

module electronic_organ( input clk_50m, input reset_n, input [3:0] key_row, output [3:0] key_col, output buzzer ); wire [3:0] key_code; wire key_valid; key_scan u_key_scan( .clk(clk_50m), .reset(~reset_n), .row(key_row), .col(key_col), .key_code(key_code), .key_valid(key_valid) ); tone_generator u_tone_gen( .clk(clk_50m), .note_sel(key_valid ? key_code[2:0] : 4'hF), // 无按键按下时静音 .pwm_out(buzzer) ); endmodule

5.2 常见问题排查

1. 按键无响应：

   • 检查行列接线是否正确
   • 确认键盘扫描时钟频率合适(约10-20ms扫描周期)
   • 使用SignalTap观察行列信号

2. 音调不准：

   • 重新计算分频系数
   • 检查系统时钟是否准确
   • 尝试调整蜂鸣器驱动电路

3. 多个按键同时按下：

   • 在键盘扫描模块中添加防冲突逻辑
   • 实现按键优先级处理

6. 功能扩展与创意玩法

基础功能实现后，你可以尝试以下扩展：

• 增加音色选择：通过PWM占空比调节音色
• 实现和弦功能：同时发出多个音符
• 添加节奏器：内置节拍器功能
• 录音与回放：记录并重放演奏片段
• OLED显示：添加小屏幕显示当前音符

// 简单的和弦实现示例 module chord_generator( input clk, input [2:0] chord_type, output reg [2:0] note_enable // 控制三个音调发生器 ); always @(posedge clk) begin case(chord_type) 3'b000: note_enable <= 3'b000; // 无和弦 3'b001: note_enable <= 3'b001; // 单音 3'b010: note_enable <= 3'b011; // 大三和弦 3'b011: note_enable <= 3'b010; // 小三和弦 // 更多和弦类型... endcase end endmodule

在实际项目中，我发现最实用的改进是增加一个简单的"音色库"，通过改变波形生成方式（如从方波改为三角波）可以显著改善音质。另一个有趣的尝试是用滑动开关控制音高微调，实现类似吉他推弦的效果。