用STM32F103C8T6和4x4矩阵按键做个密码锁，OLED显示状态（CubeMX配置+源码分享）

郭大秀·2026-04-17·阅读 49 GEO检测（免费）

STM32F103C8T6密码锁OLED显示CubeMX

|难度：普通|阅读约 16 分钟

STM32F103C8T6矩阵按键密码锁实战：从硬件连接到OLED状态显示

在嵌入式开发领域，将多个外设模块整合成一个完整系统是每个工程师的必经之路。今天我们要实现的这个密码锁项目，正是这样一个绝佳的学习案例——它融合了矩阵按键输入、OLED显示输出和STM32主控三大核心模块。不同于简单的代码堆砌，我们将从硬件连接原理出发，深入探讨每个模块的工作机制，最终打造一个可交互的实体项目。

1. 硬件选型与核心模块解析

1.1 STM32F103C8T6最小系统板

作为项目的核心大脑，STM32F103C8T6这款Cortex-M3内核的MCU以其出色的性价比成为众多嵌入式项目的首选。它的关键特性包括：

72MHz主频：足够处理按键扫描和显示刷新
64KB Flash：可容纳完整项目代码和字库
20KB RAM：满足运行时数据存储需求
丰富外设：包括我们需要的GPIO和I2C接口

实际项目中，建议选择带有USB转串口芯片的版本，方便调试和程序下载。核心板通常已经包含必要的电源电路和复位电路，我们只需要关注功能引脚的连接。

1.2 4×4矩阵按键模块

矩阵按键是密码锁的输入核心，其工作原理值得深入理解：

扫描方式	行线状态	列线检测	按键定位
逐行扫描	行1高电平	检测列1-4	确定行1的按键
	行2高电平	检测列1-4	确定行2的按键
	...	...	...

硬件连接时，行线和列线分别连接到STM32的GPIO。推荐使用上拉电阻（内部或外部）确保稳定的电平检测。

1.3 OLED显示模块

本项目选用的是0.96寸I2C接口的OLED屏幕，其优势在于：

128×64分辨率：足够显示密码输入状态和系统信息
自发光：无需背光，节省功耗
I2C接口：仅需2根信号线（SCL和SDA）

c复制// 典型的OLED初始化代码片段
void OLED_Init(void) {
    HAL_Delay(100);
    OLED_WriteCmd(0xAE); // 关闭显示
    OLED_WriteCmd(0xD5); // 设置显示时钟分频
    OLED_WriteCmd(0x80); // 建议值
    OLED_WriteCmd(0xA8); // 设置多路复用率
    OLED_WriteCmd(0x3F); // 1/64 duty
    // ...更多初始化命令
    OLED_WriteCmd(0xAF); // 开启显示
}

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. CubeMX工程配置详解

2.1 引脚分配策略

在CubeMX中配置引脚时，需要考虑以下原则：

避免功能冲突：检查数据手册，确保所选引脚没有复用限制
布线便利性：尽量将相关外设的引脚集中配置
电源考虑：高频率操作的引脚远离模拟电路

推荐配置方案：

外设	引脚分配	备注
矩阵按键行	PB8-PB11	输出模式
矩阵按键列	PB12-PB15	输入带上拉
OLED I2C	PB6(SCL), PB7(SDA)	标准I2C1引脚
状态LED	PC13	板载LED，用于指示状态

2.2 I2C外设配置

OLED显示依赖I2C通信，在CubeMX中需要特别注意：

选择正确的I2C接口（通常I2C1）
配置速度为标准模式（100kHz）或快速模式（400kHz）
启用I2C中断（可选，用于高级应用）

c复制// I2C初始化结构体示例
hi2c1.Instance = I2C1;
hi2c1.Init.ClockSpeed = 100000;
hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2;
hi2c1.Init.OwnAddress1 = 0;
hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE;
hi2c1.Init.OwnAddress2 = 0;
hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE;
hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE;

2.3 时钟树配置

合理的时钟配置是系统稳定运行的基础：

HSE：使用外部8MHz晶振作为时钟源
PLL：倍频至72MHz系统时钟
APB1：36MHz（定时器时钟为72MHz）
APB2：72MHz

提示：在CubeMX的Clock Configuration标签页中，确保所有时钟域显示为绿色，表示配置有效。

3. 矩阵按键扫描实现

3.1 扫描算法优化

高效的按键扫描需要考虑消抖和响应速度的平衡：

c复制#define ROWS 4
#define COLS 4

const uint16_t rowPins[ROWS] = {GPIO_PIN_8, GPIO_PIN_9, GPIO_PIN_10, GPIO_PIN_11};
const uint16_t colPins[COLS] = {GPIO_PIN_12, GPIO_PIN_13, GPIO_PIN_14, GPIO_PIN_15};

uint8_t KeyScan(void) {
    static uint8_t lastKey = 0xFF;
    uint8_t currentKey = 0xFF;
    
    for(uint8_t i = 0; i < ROWS; i++) {
        // 设置当前行为高，其他行为低
        HAL_GPIO_WritePin(GPIOB, rowPins[i], GPIO_PIN_SET);
        for(uint8_t j = 0; j < ROWS; j++) {
            if(j != i) HAL_GPIO_WritePin(GPIOB, rowPins[j], GPIO_PIN_RESET);
        }
        
        // 检测列线
        for(uint8_t j = 0; j < COLS; j++) {
            if(HAL_GPIO_ReadPin(GPIOB, colPins[j]) == GPIO_PIN_SET) {
                currentKey = i * COLS + j;
                HAL_Delay(20); // 简单消抖
                if(HAL_GPIO_ReadPin(GPIOB, colPins[j]) == GPIO_PIN_SET) {
                    while(HAL_GPIO_ReadPin(GPIOB, colPins[j]) == GPIO_PIN_SET); // 等待释放
                    return currentKey;
                }
            }
        }
    }
    return 0xFF; // 无按键按下
}

3.2 按键映射与密码处理

将扫描得到的键值映射到实际功能：

c复制const char keyMap[ROWS][COLS] = {
    {'1','2','3','A'},
    {'4','5','6','B'},
    {'7','8','9','C'},
    {'*','0','#','D'}
};

void ProcessKey(uint8_t key) {
    if(key == 0xFF) return;
    
    char inputChar = keyMap[key/4][key%4];
    static char password[6] = {0};
    static uint8_t pos = 0;
    
    if(inputChar >= '0' && inputChar <= '9') {
        if(pos < 6) {
            password[pos++] = inputChar;
            OLED_ShowString(10, 2, "*", 16); // 显示输入掩码
        }
    }
    else if(inputChar == '#') {
        if(CheckPassword(password)) {
            OLED_ShowString(10, 4, "Correct!", 16);
            HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET); // 开锁
        } else {
            OLED_ShowString(10, 4, "Wrong!", 16);
        }
        pos = 0;
        memset(password, 0, 6);
    }
    else if(inputChar == '*') {
        pos = 0;
        memset(password, 0, 6);
        OLED_Clear();
    }
}

4. OLED状态显示与系统集成

4.1 显示界面设计

良好的用户界面应该包含以下信息：

系统标题：固定显示在首行
输入提示：引导用户操作
密码掩码：用*号显示输入进度
系统状态：显示验证结果或错误信息

c复制void UpdateDisplay(void) {
    OLED_Clear();
    OLED_ShowString(0, 0, "STM32 Password Lock", 16);
    OLED_ShowString(0, 2, "Input:", 16);
    // 密码掩码和状态信息由按键处理函数更新
}

4.2 系统状态机实现

使用状态机管理密码锁的不同工作模式：

c复制typedef enum {
    MODE_IDLE,
    MODE_INPUT,
    MODE_CHECK,
    MODE_CORRECT,
    MODE_WRONG,
    MODE_SETTING
} SystemMode;

SystemMode currentMode = MODE_IDLE;

void SystemTask(void) {
    static uint32_t lastTick = 0;
    uint8_t key = KeyScan();
    
    switch(currentMode) {
        case MODE_IDLE:
            if(key != 0xFF) {
                currentMode = MODE_INPUT;
                OLED_Clear();
            }
            break;
            
        case MODE_INPUT:
            ProcessKey(key);
            if(key == '#') {
                currentMode = MODE_CHECK;
                lastTick = HAL_GetTick();
            }
            break;
            
        case MODE_CORRECT:
            if(HAL_GetTick() - lastTick > 3000) {
                currentMode = MODE_IDLE;
                HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET); // 重新锁定
                UpdateDisplay();
            }
            break;
            
        // 其他状态处理...
    }
}

4.3 低功耗优化技巧

对于电池供电的应用，可以考虑以下优化：

动态扫描频率：无操作时降低按键扫描频率
OLED局部刷新：只更新变化的部分区域
睡眠模式：长时间无操作进入低功耗模式

c复制void EnterLowPowerMode(void) {
    OLED_WriteCmd(0xAE); // 关闭OLED显示
    HAL_GPIO_WritePin(GPIOB, GPIO_PIN_8|GPIO_PIN_9|GPIO_PIN_10|GPIO_PIN_11, GPIO_PIN_RESET); // 关闭按键行驱动
    // 配置MCU进入睡眠模式
    HAL_PWR_EnterSLEEPMode(PWR_MAINREGULATOR_ON, PWR_SLEEPENTRY_WFI);
}

5. 常见问题与调试技巧

5.1 硬件连接问题排查

当系统不能正常工作时，建议按照以下顺序排查：

电源检查：
- 测量各模块供电电压
- 检查接地是否良好
信号线检查：
- 确认I2C线路上拉电阻（通常4.7kΩ）
- 检查矩阵按键行列线是否正确连接
软件调试：
- 使用逻辑分析仪抓取I2C波形
- 通过串口打印调试信息

5.2 典型错误代码分析

以下是开发者常遇到的几个问题及解决方案：

现象	可能原因	解决方案
OLED无显示	I2C地址错误	尝试0x78或0x7A地址
按键响应不稳定	消抖时间不足	增加消抖延时或使用定时器扫描
系统偶尔死机	堆栈溢出	增加堆栈大小
显示内容错乱	显存未及时更新	检查OLED刷新函数调用时机

5.3 性能优化建议

对于需要更高响应速度的应用：

使用中断方式检测按键：将列线配置为外部中断
DMA加速数据传输：使用DMA传输OLED显示数据
硬件I2C加速：确保I2C时钟配置正确

c复制// 使用DMA传输OLED数据的示例
HAL_I2C_Mem_Write_DMA(&hi2c1, OLED_ADDRESS, 0x40, I2C_MEMADD_SIZE_8BIT, buffer, sizeof(buffer));

6. 项目扩展与进阶方向

6.1 EEPROM密码存储

实现掉电不丢失的密码存储：

c复制#include "stm32f1xx_hal_flash.h"

#define PASSWORD_ADDR 0x0800FC00 // Flash最后一页

void SavePassword(const char* pwd) {
    HAL_FLASH_Unlock();
    FLASH_EraseInitTypeDef erase;
    erase.TypeErase = FLASH_TYPEERASE_PAGES;
    erase.PageAddress = PASSWORD_ADDR;
    erase.NbPages = 1;
    uint32_t error;
    HAL_FLASHEx_Erase(&erase, &error);
    
    for(int i=0; i<6; i++) {
        HAL_FLASH_Program(FLASH_TYPEPROGRAM_HALFWORD, PASSWORD_ADDR+i*2, pwd[i]);
    }
    HAL_FLASH_Lock();
}

void ReadPassword(char* pwd) {
    for(int i=0; i<6; i++) {
        pwd[i] = *(uint16_t*)(PASSWORD_ADDR+i*2);
    }
}

6.2 无线控制扩展

添加蓝牙或Wi-Fi模块实现远程控制：

HC-05蓝牙模块：通过串口与STM32通信
ESP8266 WiFi模块：实现网络接入
RFID/NFC模块：增加刷卡开锁功能

6.3 安全增强措施

提升系统安全性的几种方法：

输入超时：30秒无操作清除输入
错误锁定：连续3次错误后锁定系统
密码加密：存储加密后的密码而非明文

c复制// 简单的密码加密示例
void EncryptPassword(char* pwd) {
    for(int i=0; i<6; i++) {
        pwd[i] = (pwd[i] + 0x55) ^ 0xAA;
    }
}

int CheckPassword(const char* input) {
    char stored[6];
    ReadPassword(stored);
    char encrypted[6];
    memcpy(encrypted, input, 6);
    EncryptPassword(encrypted);
    return memcmp(encrypted, stored, 6) == 0;
}

在完成基础功能后，尝试将这些模块装入一个合适的 enclosure，使用3D打印或现成的盒子都可以。实际部署时，注意将按键和OLED面板合理布局，确保良好的用户体验。我在一个商业项目中采用了类似的方案，最终产品已经稳定运行两年多，期间只遇到过几次因静电导致的复位，通过增加适当的保护电路就解决了。