1. 矩阵键盘基础与硬件连接

大家好，今天我们来聊聊STM32F10x系列单片机驱动矩阵键盘的实战经验。我自己在做嵌入式开发时，经常遇到需要多个按键的场景，如果每个按键都单独占用一个IO口，实在太浪费资源了。矩阵键盘就是个很好的解决方案，用8个IO口就能实现16个按键的功能，特别适合STM32这种IO资源宝贵的MCU。

矩阵键盘的基本原理很简单，就是把按键排成矩阵形式，行为输出，列为输入。我常用的4x4矩阵键盘有4行4列，总共16个按键。行线接STM32的推挽输出引脚，列线接上拉输入引脚。当某个按键被按下时，对应的行和列就会连通。

硬件连接方面，我推荐这样安排：

• 行线（ROW1-ROW4）：接GPIO推挽输出模式
• 列线（COL1-COL4）：接GPIO上拉输入模式

推挽输出模式能够提供较强的驱动能力，输出高电平时电压接近VDD，低电平时接近GND。上拉输入模式则在没有按键按下时，保持高电平状态，有按键按下时会被拉低。

在实际接线时，要注意STM32F10x系列有些特殊引脚，比如PA13、PA14、PA15、PB3、PB4这些默认是JTAG/SWD调试接口。如果要用这些引脚做普通IO，需要先禁用JTAG功能。我就吃过这个亏，调试了半天才发现是引脚复用的问题。

2. GPIO模式深度解析

2.1 推挽输出模式详解

推挽输出是我最常用的输出模式，它的工作原理就像两个MOS管推挽工作。当输出高电平时，P-MOS导通，N-MOS截止，输出被拉到VDD；输出低电平时，N-MOS导通，P-MOS截止，输出被拉到GND。

这种模式的优点是驱动能力强，高低电平都很稳定。在矩阵键盘应用中，我们需要用推挽输出来驱动行线，确保能够可靠地将列线拉低。

配置推挽输出的代码是这样的：

GPIO_InitTypeDef GPIO_InitStructure;
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_2 | GPIO_Pin_3;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;  // 推挽输出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; // 输出速度50MHz
GPIO_Init(GPIOA, &GPIO_InitStructure);

输出速度的选择很重要，50MHz的速度足够应对键盘扫描的需求，同时也不会产生太大的电磁干扰。

2.2 上拉输入模式详解

上拉输入模式是矩阵键盘列线的理想选择。在这种模式下，IO口内部有一个上拉电阻连接到VDD，默认状态下引脚保持高电平。当外部电路将引脚拉低时，单片机能够检测到这个低电平。

在矩阵键盘中，当某行被拉低，且有按键按下时，对应的列线就会被拉低，这样我们就能检测到按键事件了。

上拉输入的配置代码如下：

GPIO_InitStructure.GPIO_Pin = GPIO_Pin_4 | GPIO_Pin_5 | GPIO_Pin_6 | GPIO_Pin_7;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU;     // 上拉输入
GPIO_Init(GPIOA, &GPIO_InitStructure);

需要注意的是，STM32的内部上拉电阻大约在30-50kΩ之间，这个阻值对于键盘扫描来说是合适的，既不会耗电太大，又能保证可靠的检测。

3. 键盘扫描算法实现

3.1 逐行扫描法

我最常用的扫描方法是逐行扫描法，思路很简单：依次将每一行拉低，然后检查各列的状态，如果某列为低电平，就说明对应位置的按键被按下了。

具体实现时，我会先让所有行都输出高电平，然后循环处理每一行：

1. 将当前行拉低，其他行保持高电平
2. 延时一小段时间（10-20us）让电平稳定
3. 读取所有列的状态
4. 如果某列为低电平，根据当前行号和列号计算键值
5. 将当前行恢复为高电平，处理下一行

这里有个重要的细节：每次只能拉低一行，如果同时拉低多行，当同时按下多个按键时就会出现误判。

3.2 键值计算与映射

键值计算很简单，用行号和列号就能唯一确定每个按键。我通常这样计算：键值 = 行号 * 列数 + 列号。对于4x4键盘，键值范围是0-15。

但实际应用中，我们可能需要将扫描得到的键值映射为具体的功能键值。比如键盘上印的是"1","2","3"等字符，但扫描得到的是0-15的数字。这时候就需要一个映射表：

const uint8_t KeyMap[16] = {
    '1', '2', '3', 'A',
    '4', '5', '6', 'B', 
    '7', '8', '9', 'C',
    '*', '0', '#', 'D'
};

这样当我们扫描到键值0时，实际返回的是字符'1'，更符合使用习惯。

3.3 消抖处理

机械按键都有抖动问题，按下和释放时会产生多个边沿。不处理抖动的话，一次按键可能会被误判为多次按键。

我常用的消抖方法很简单：第一次检测到按键后延时10-20ms再次检测，如果还是按下状态，就确认是有效按键。虽然这种方法会占用CPU时间，但对于STM32来说完全不是问题。

if (GPIO_ReadInputDataBit(GPIOA, pin) == 0) {
    Delay_ms(15);  // 延时消抖
    if (GPIO_ReadInputDataBit(GPIOA, pin) == 0) {
        // 确认按键按下
        while (GPIO_ReadInputDataBit(GPIOA, pin) == 0); // 等待释放
    }
}

如果需要更高效的消抖，可以用定时器中断来定期扫描键盘，这样就不会阻塞主循环了。

4. 特殊引脚处理技巧

4.1 JTAG复用引脚处理

STM32F10x的PA13、PA14、PA15、PB3、PB4默认用于JTAG调试，如果要用作普通IO，需要特殊处理。这是我踩过的一个大坑，当时调试了好久才发现问题。

禁用JTAG功能的代码是这样的：

// 禁用JTAG，启用SWD（这样PA15、PB3、PB4就可以作为普通IO使用）
GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);

需要注意的是，虽然禁用了JTAG，但SWD调试功能还是可用的，这样我们既能使用这些引脚，又不影响调试。

4.2 复用功能配置

有些特殊引脚需要配置为复用功能才能作为普通IO使用，但要注意的是，推挽输出模式直接配置为GPIO_Mode_Out_PP即可，不需要配置为复用推挽输出。这是我经过多次试验得出的经验。

// 正确配置 - 直接推挽输出
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;

// 错误配置 - 不需要复用功能
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;

如果错误地配置为复用模式，反而可能导致引脚无法正常工作。

5. 完整代码实现

5.1 初始化函数

首先来看初始化函数，这里要完成GPIO时钟使能、引脚模式配置等基础工作：

void MatrixKey_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStructure;
    
    // 使能GPIO时钟
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB, ENABLE);
    
    // 配置行引脚为推挽输出（PA15、PB3、PB4、PB5）
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_15;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOA, &GPIO_InitStructure);
    
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3 | GPIO_Pin_4 | GPIO_Pin_5;
    GPIO_Init(GPIOB, &GPIO_InitStructure);
    
    // 配置列引脚为上拉输入（PB6、PB7、PB8、PB9）
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7 | GPIO_Pin_8 | GPIO_Pin_9;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU;
    GPIO_Init(GPIOB, &GPIO_InitStructure);
    
    // 禁用JTAG，释放PA15、PB3、PB4
    GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);
    
    // 所有行初始化为高电平
    GPIO_SetBits(GPIOA, GPIO_Pin_15);
    GPIO_SetBits(GPIOB, GPIO_Pin_3 | GPIO_Pin_4 | GPIO_Pin_5);
}

初始化时要注意所有行线都要设置为高电平，否则可能影响后续的扫描逻辑。

5.2 扫描函数实现

扫描函数是核心部分，负责检测按键并返回键值：

uint8_t MatrixKey_Scan(void)
{
    uint8_t row, col;
    uint16_t rowPins[4] = {GPIO_Pin_15, GPIO_Pin_3, GPIO_Pin_4, GPIO_Pin_5};
    GPIO_TypeDef* rowPorts[4] = {GPIOA, GPIOB, GPIOB, GPIOB};
    
    // 遍历每一行
    for (row = 0; row < 4; row++) {
        // 拉低当前行
        GPIO_ResetBits(rowPorts[row], rowPins[row]);
        
        // 短暂延时稳定电平
        Delay_us(10);
        
        // 检查各列状态
        if (GPIO_ReadInputDataBit(GPIOB, GPIO_Pin_6) == 0) {
            Delay_ms(10);  // 消抖
            if (GPIO_ReadInputDataBit(GPIOB, GPIO_Pin_6) == 0) {
                GPIO_SetBits(rowPorts[row], rowPins[row]);  // 恢复行电平
                return row * 4 + 0;  // 返回键值
            }
        }
        // 同样方式检查其他列...
        
        // 恢复当前行为高电平
        GPIO_SetBits(rowPorts[row], rowPins[row]);
    }
    
    return 0xFF;  // 没有按键按下
}

在实际项目中，我会把消抖和键值处理做得更完善，比如支持长按、连按等高级功能。

6. 常见问题与调试技巧

6.1 按键响应不稳定

按键响应不稳定是最常见的问题，通常有几个原因：

1. 消抖时间不合适：太长会影响响应速度，太短则无法有效消除抖动。我一般用10-20ms的消抖时间。
2. 扫描频率不当：扫描太快会占用太多CPU资源，太慢则影响响应速度。通常10-100ms的扫描间隔比较合适。
3. 硬件连接问题：接触不良、线太长等都可能导致信号不稳定。

6.2 多个按键同时按下

矩阵键盘处理多键同时按下比较复杂，常见的解决方案有：

1. 屏蔽多键：只处理第一个按下的键，忽略其他键
2. 轮询检测：快速扫描所有按键状态，记录每个按键的状态
3. 使用更复杂的扫描算法，如反向扫描法等

对于大多数应用，屏蔽多键就足够了，除非确实需要支持组合键功能。

6.3 功耗优化

如果项目对功耗要求较高，可以优化扫描策略：

1. 降低扫描频率：在没有按键时降低扫描频率，有按键时提高扫描频率
2. 使用中断唤醒：用外部中断检测按键，平时MCU处于低功耗模式
3. 动态配置IO模式：扫描时配置为输出模式，其他时间配置为输入模式减少功耗

7. 实际项目中的应用

在我最近的一个项目中，需要用矩阵键盘输入数字和功能键。除了基本的扫描功能外，我还实现了以下高级功能：

长按支持：检测按键长时间按下，用于实现快速增加/减少数值的功能。实现方法是在检测到按键按下后，开始计时，如果超过一定时间（如1秒）仍然按下，就触发长按事件。

按键音反馈：通过蜂鸣器提供按键音反馈，增强用户体验。每次检测到有效按键时，就让蜂鸣器短响一声。

双层功能：通过功能键切换，实现按键的双重功能。比如正常模式下输入数字，按住Shift键时执行特殊功能。

这些功能的加入大大提升了产品的用户体验，虽然增加了代码复杂度，但还是很值得的。

在实际开发中，我还发现一个有用的技巧：在键盘扫描函数中加入超时机制，防止因为某个按键一直按下而阻塞其他操作。比如设置最大扫描时间为50ms，超过这个时间就退出扫描，下次再继续。

矩阵键盘虽然看似简单，但要想做得稳定可靠，还是需要不少技巧和经验的。希望我的这些实战经验对大家有所帮助，少走一些弯路。