在STM32单片机中实现矩阵键盘的步骤如下，采用常见的扫描方式（行扫描、列检测）：

1. 硬件连接

• 4x4矩阵键盘：16个按键，4行 + 4列。
• 行线：连接到STM32的输出引脚（如PA0-PA3）。
• 列线：连接到STM32的输入引脚（如PA4-PA7），启用内部上拉电阻（默认高电平）。

2. 初始化GPIO

// 行引脚配置：推挽输出，初始高电平
GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();  // 使能GPIOA时钟

// 设置行（ROW0-ROW3: PA0-PA3）
GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;  // 推挽输出
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// 设置列（COL0-COL3: PA4-PA7），输入带上拉
GPIO_InitStruct.Pin = GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7;
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;      // 输入模式
GPIO_InitStruct.Pull = GPIO_PULLUP;          // 启用上拉电阻
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

3. 键盘扫描函数

#define ROWS 4
#define COLS 4

// 定义行对应的GPIO引脚
uint16_t rowPins[ROWS] = {GPIO_PIN_0, GPIO_PIN_1, GPIO_PIN_2, GPIO_PIN_3};
// 定义列对应的GPIO引脚
uint16_t colPins[COLS] = {GPIO_PIN_4, GPIO_PIN_5, GPIO_PIN_6, GPIO_PIN_7};

// 扫描函数，返回按键值（0-15表示按键，-1表示无按键）
int8_t MatrixKey_Scan() {
    for (uint8_t i = 0; i < ROWS; i++) {
        // 当前行置低电平，其他行置高
        for (uint8_t j = 0; j < ROWS; j++) {
            HAL_GPIO_WritePin(GPIOA, rowPins[j], (j == i) ? GPIO_PIN_RESET : GPIO_PIN_SET);
        }
        HAL_Delay(1);  // 稳定信号

        // 检查列状态
        for (uint8_t k = 0; k < COLS; k++) {
            if (HAL_GPIO_ReadPin(GPIOA, colPins[k]) == GPIO_PIN_RESET) {
                HAL_Delay(10);  // 消抖
                if (HAL_GPIO_ReadPin(GPIOA, colPins[k]) == GPIO_PIN_RESET) {
                    // 计算按键位置：行号 * 列数 + 列号
                    return (i * COLS + k);
                }
            }
        }
    }
    return -1;  // 无按键按下
}

4. 主循环调用

while (1) {
    int8_t key = MatrixKey_Scan();
    if (key != -1) {
        printf("Key Pressed: %d\n", key);  // 输出按键编号（0-15）
        while (MatrixKey_Scan() != -1);    // 等待释放
    }
    HAL_Delay(50);  // 降低扫描频率
}

5. 关键点说明

• 消抖处理：检测到按键后延时10ms再次确认，避免机械抖动。
• 内部上拉：列引脚启用内部上拉，按键未按下时保持高电平。
• 等待释放：检测到按键后循环等待松开，避免重复触发。
• 按键编码：返回的键值（0~15）对应键盘位置：

  0: (0,0)  1: (0,1)  2: (0,2)  3: (0,3)
  4: (1,0)  5: (1,1)  6: (1,2)  7: (1,3)
  8: (2,0)  9: (2,1)  10:(2,2) 11:(2,3)
  12:(3,0) 13:(3,1) 14:(3,2) 15:(3,3)

6. 优化建议

• 中断扫描：若需低功耗，可用外部中断检测列线变化，再启动扫描。
• 状态机消抖：用定时器实现非阻塞式消抖，提高系统效率。
• 多键支持：改进算法支持组合键（需避免“幽灵键”问题）。

通过以上步骤，即可在STM32上实现稳定的矩阵键盘扫描功能。实际应用中需根据硬件连接调整引脚定义。