尧图网页设计 
简介这是一份基于STM32的智能门禁系统硬件端程序面向嵌入式、物联网方向的毕设学生与开发者。系统以STM32为主控通过Wi-Fi与MQTT接入阿里云平台与安卓App联动实现密码与指纹解锁及修改、虚位密码、超时自动锁屏、门锁状态与修改钥匙通知等功能密码和指纹特征加密存放在外部Flash交互界面会提示按键与错误信息整体基于HAL库开发代码结构清晰。压缩包共135个文件包括75个h头文件、46个c源文件以及json配置、txt说明、效果图片等辅助内容大小仅4.49MB便于下载研读。已有325人学习下载。借助完整源码可快速理解外设驱动、FatFS文件系统、MQTT云平台对接等关键模块还能参考其界面交互设计和异常提示逻辑作为毕设基础直接改造与功能扩展。1. 从一块开发板到一套可交付的门禁系统STM32 到底在管什么很多刚接触嵌入式的人会把智能门禁理解为给门锁加个屏幕但真正做过项目你会发现门禁的本质是一个多输入、多输出、带状态记忆的实时控制系统。指纹模块、密码键盘、IC 卡读卡器、红外人体感应、舵机或电插锁、OLED 显示屏、蜂鸣器、Wi-Fi 或蓝牙模块这些设备全部挂在 STM32 的总线上由它统一调度。所谓程序其实是在解决三个问题怎么可靠地采集身份信息、怎么安全地判断放行、怎么在异常情况下不丢状态。本文围绕基于 STM32 的智能门禁系统程序这一项目从硬件选型、程序框架、外设驱动到掉电保护给你一套能直接落地的实现路径。我会以 STM32F103C8T6 为例所有代码基于 HAL 库编写思路同样适用于 F401、F407 等更高性能的型号。如果你正在做毕业设计或产品原型这套方案的完整度足够你少走三个月弯路。2. 硬件选型和程序框架先想清楚门禁和智能分别要什么2.1 主控选型为什么是 STM32F103C8T6智能门禁对主控的要求并不苛刻但它对外设接口数量和低功耗能力有明确要求。指纹模块走串口读卡器走 SPI显示屏走 I2C继电器或舵机走 PWM再加上几个 GPIO 检测门磁和人体红外——这已经吃掉了至少 2 个 UART、1 个 SPI、1 个 I2C、1 个定时器。STM32F103C8T6 拥有 3 个 USART、2 个 SPI、2 个 I2C、4 个 16 位定时器刚好在这个容量区间内做到不用省着用。另一个关键因素是生态成熟度。无论是标准外设库、HAL 库还是 LL 库网上能检索到的 STM32 门禁项目示例非常多。这意味着你在调试指纹模块通讯或 OLED 刷新异常时几乎每一个报错都能在社区里找到对应讨论。对于项目周期紧张的场景这比追求一颗更冷门的主控要务实得多。2.2 外设分工谁做主、谁做从、谁做冗余我一般会把门禁系统的外设分成三个层级。第一层是身份输入设备矩阵键盘接 GPIO 扫描RC522 读卡器接 SPI指纹模块接 USART1。这三者互不占用对方的总线资源可以并行工作不存在读卡时不能按密码的尴尬。第二层是执行与反馈设备舵机或电插锁接定时器 PWM 输出OLED 显示屏接 I2C蜂鸣器和 LED 指示灯接普通 GPIO。执行层的统一特点是状态可查询——你随时能通过 GPIO 电平判断门锁当前是开还是关。第三层是状态感知设备门磁开关接一个外部中断引脚人体红外模块HC-SR501接另一个 GPIO。这一层决定了系统的智能程度有人靠近时才唤醒屏幕、夜晚自动切换布防模式、门被异常撬开时立刻报警。项目落地的常见误区是把所有外设都堆在主控的 5V 电源上忽略 STM32 的 GPIO 容忍电压和模块电平匹配。RC522 的引脚是 3.3V 逻辑但部分指纹模块如 AS608输出的是 5V TTL 电平这时 USART 的 RX 引脚需要加电阻分压或使用电平转换芯片否则长期使用容易损坏 PA10。2.3 程序整体架构状态机是门禁程序的骨架如果你把门禁程序写成顺序执行读卡→判断→开门→关门那系统一旦在开门过程中遇到指纹模块无响应整个逻辑就会卡死。正确的做法是用有限状态机管理系统的所有行为。typedef enum { STATE_LOCKED 0, // 待机锁定 STATE_AUTHENTICATING, // 正在验证身份 STATE_UNLOCKED, // 已放行 STATE_ALARM, // 报警 STATE_CONFIG // 配置模式 } SystemState;系统主循环只做两件事检测外设事件、根据当前状态迁移到下一个状态。比如在上锁状态下检测到指纹模块上报匹配成功系统进入 STATE_AUTHENTICATING此时点亮屏幕等待二次确认如再按一次确认键防止误触放行。确认后切入 STATE_UNLOCKED启动一个 5 秒的开门计时器超时后自动回到 STATE_LOCKED。HAL 库的HAL_GPIO_EXTI_Callback、HAL_UART_RxCpltCallback这类中断回调函数里只做置位标志位的操作真正的业务逻辑全部放在主循环的switch语句中执行。这个架构的好处是每个状态的行为是独立的新增一个管理员指纹注册模式不会影响已有的验证流程。3. 核心功能实现指纹识别、读卡与密码验证的完整流程3.1 基于 AS608 指纹模块的 USART 通讯AS608 是市场上最常见的电容式指纹模块通过串口与 STM32 通信默认波特率 57600。它的指令格式遵循包头 地址 包标识 长度 指令 参数 校验和的结构。这里涉及一个关键点AS608 的数据包是分段传输的一个完整的 192 字节图像上传请求会被拆成多个包。所以你的接收缓冲区必须足够大建议 256 字节并且要能处理粘包——即上一次的残余数据和本次的包头粘连在一起。我建议用下面的方式初始化串口接收uint8_t fingerprint_rx_buf[256]; volatile uint16_t fingerprint_rx_len 0; volatile uint8_t fingerprint_rx_complete 0; // 开启串口空闲中断配合 DMA 接收不定长数据 HAL_UARTEx_ReceiveToIdle_DMA(huart1, fingerprint_rx_buf, sizeof(fingerprint_rx_buf)); // 在回调中判断帧是否完整 void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size) { if (huart-Instance USART1) { fingerprint_rx_len Size; // 检查帧头: 0xEF 0x01 0xFF 0xFF 0xFF 0xFF if (fingerprint_rx_buf[0] 0xEF fingerprint_rx_buf[1] 0x01) { fingerprint_rx_complete 1; } // 重新开启下一次接收 HAL_UARTEx_ReceiveToIdle_DMA(huart1, fingerprint_rx_buf, sizeof(fingerprint_rx_buf)); } }这段代码的核心是利用串口空闲中断来判断一帧数据是否接收完毕。AS608 的所有应答帧都以0xEF01开头因此收到0xEF01即可确认帧同步而不必依赖固定的字节计数。注意设备地址0xFFFFFFFF是广播地址如果你在总线上挂了多个 AS608必须给每个模块设置不同的地址。3.2 RC522 读卡器的 SPI 时序与防冲突机制RC522 通过 SPI 接口与 STM32 通信。它的寄存器寻址机制比较特殊最高位决定读还是写1 为读0 为写低 6 位是寄存器地址。如果直接调用 HAL 的HAL_SPI_TransmitReceive很容易因为地址拼接错误导致读出的数据全是 0xFF。uint8_t RC522_ReadReg(uint8_t reg) { uint8_t tx_data ((reg 1) 0x7E) | 0x80; // 读命令 uint8_t rx_data 0; uint8_t dummy 0; HAL_GPIO_WritePin(RC522_CS_GPIO_Port, RC522_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, tx_data, 1, 10); HAL_SPI_Receive(hspi1, rx_data, 1, 10); // 读取数据 HAL_GPIO_WritePin(RC522_CS_GPIO_Port, RC522_CS_Pin, GPIO_PIN_SET); return rx_data; }寄存器地址与 SPI 数据位之间隔了一个移位这是个典型的 RC522 驱动坑。很多移植失败的项目都卡在这一行reg 1。另外在读取卡号时需要执行寻卡、防冲突、选卡三个步骤对应的命令分别是PCD_ANTICOLL0x93、PCD_TRANSCEIVE0x0C。如果遇到读卡不稳定优先检查 SPI 时钟极性CPOL0, CPHA0和 RC522 的 IRQ 引脚是否接到了 STM32 的外部中断输入。3.3 密码验证的最小实现与防暴力破解密码验证逻辑本身不复杂但门禁场景对它有额外的安全约束连续输错超过 5 次应锁定 1 分钟否则任何人都可以在键盘前穷举。我用一个二维数组保存三个用户的密码以及各自剩余的尝试次数。typedef struct { uint8_t password[6]; // 6 位数字密码ASCII 存储 uint16_t unlock_time; // 最近解锁时间戳 uint8_t retry_count; // 连续错误次数 uint8_t locked_until; // 锁定截止时间相对分钟 } UserEntry; UserEntry users[3] { {{1,2,3,4,5,6}, 0, 0, 0}, {{2,3,4,5,6,7}, 0, 0, 0}, {{3,4,5,6,7,8}, 0, 0, 0} };在验证函数里我需要判断locked_until是否大于当前时间。如果是直接返回 已锁定 状态不参与字符串比较。这样避免了一个细节问题strcmp在密码位数不足时会越界读取内存。所有密码固定 6 位比较用memcmp替代strcmp并且先比对长度再从末尾向前比对能略微增加时序攻击的难度——虽然对门禁这种低价值目标意义有限但代码习惯是好的。3.4 OLED 显示驱动的缓冲区策略0.96 寸 OLED 采用 SSD1306 控制器I2C 接口。它的显存是 1KB128x64 像素每像素 1 bit。在 HAL 库环境下I2C 通信本身是阻塞式的一帧全屏刷新大约要传 1024 字节数据按 400kHz 的 I2C 速率算需要约 20ms。如果你在开门动画里频繁全屏刷新会明显拖慢主循环。我一般用双缓冲 局部刷新策略系统维护一个 1KB 的显存数组所有绘制操作都写在这个数组上只有调用OLED_Display()时才把整个数组推送到屏幕。而像验证成功这种需要动画效果的状态我只刷新屏幕中间 1/4 区域而不是全屏。void OLED_ShowUnlockStatus(void) { // 只清空 y 轴 24~40 的区域 for (uint8_t i 0; i 16; i) { // 第 i 行 对应的显存 y 坐标为 24 i // 需要清除 128 像素宽的整行 memset(display_buffer[(24 i) * 16], 0, 16); } OLED_ShowString(20, 24, UNLOCKED); // 只刷新 y 24~40 区域 OLED_DisplayPart(24, 16); }3.5 舵机开锁与红外感应的联动逻辑门锁执行器用的是 SG90 舵机通过定时器 PWM 控制——20ms 周期0.5ms 高电平对应 0 度2.5ms 对应 180 度。在 HAL 库中用 TIM2 的通道 1 输出 PWM预分频器设置为 72-1这样 72MHz 的主频被分到 1MHz计数周期为 20000 个脉冲对应 20ms。// 打开90度 void DoorLock_Open(void) { __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, 1500); // 1.5ms 高电平 - 90度 } // 回到0度 void DoorLock_Close(void) { __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, 500); // 0.5ms 高电平 - 0度 }红外人体感应HC-SR501在检测到有人时输出 3.3V 高电平。这个信号不需要实时轮询开启上升沿外部中断即可。中断回调里只设置一个标志位主循环发现有人的标志后唤醒屏幕、开启键盘背光。感应器的封锁时间和延时两个电位器需要调节延时调最短约 0.5 秒避免检测到人后长时间不释放灵敏度和距离调到合适档位防止误触发。4. 程序加入掉电保护与日志循环电一断不会前功尽弃4.1 MCU 内部 Flash 的磨损平衡写法门禁系统会记录开锁历史、用户 ID、时间戳还需要保存管理员指纹已注册这类关键配置。如果这些数据只存在 RAM 里一断电就全丢。一个常见的做法是定期把数据写入 STM32 内部的 Flash。但内部 Flash 的擦写寿命大约是 10,000 次门禁频繁开锁时意味着每天可能写数十次几个月就会把同一片 Flash 区域写到报废。解决思路是磨损均衡不固定写同一个扇区而是轮流使用多个扇区。每个扇区开头写一个序列号最新序列号所在扇区就是当前有效数据。由于 STM32F103 的 Flash 扇区大小是 1KB小容量或 2KB中容量我建议用 4 个扇区做循环。#define FLASH_LOG_BASE_ADDR 0x0800C000 // 视具体 Flash 大小调整 #define FLASH_LOG_SECTOR_NUM 4 #define FLASH_LOG_SECTOR_SIZE 2048 typedef struct { uint32_t magic; // 0xA5A5A5A5 表示有效 uint32_t seq; // 序列号 uint8_t user_id; uint8_t unlock_method; // 1指纹 2密码 3IC卡 uint32_t timestamp; } AccessLogEntry;每次写入新日志时先把无效扇区擦掉再把新日志写到下一个有效扇区的尾部。读取时扫描所有扇区找出magic 0xA5A5A5A5且seq最大的记录作为最新状态。4 个扇区交错使用相当于把寿命延长了 4 倍。如果你的项目对日志持久性要求更高可以外挂一个 SPI NOR Flash如 W25Q32它的擦写寿命是 100,000 次量级完全不同。4.2 独立看门狗与待机唤醒的组合策略门禁系统常年在没人操作时处于低功耗状态但也可能在深夜被异常撬门事件唤醒。此时如果主程序因为 I2C 总线挂死而无法正常喂狗独立看门狗IWDG就会产生复位。复位后系统不能直接重新进入待机而要先读取状态标志判断复位原因是看门狗复位还是上电复位。// 在main最前面检查复位原因 if (__HAL_RCC_GET_FLAG(RCC_FLAG_IWDGRST) ! RESET) { // 看门狗复位记录错误日志 Log_Write(LOG_LEVEL_ERROR, System reset by IWDG); __HAL_RCC_CLEAR_RESET_FLAGS(); }独立看门狗的喂狗周期设置需要谨慎它依赖 LSI 低速内部时钟约 40kHz预分频器设为 64重装载值设为 625相当于约 1 秒的超时窗口。在 HAL 库中初始化 IWDG 后必须保证主循环走一圈不超过 1 秒否则看门狗在系统活着但繁忙时也会误复位。建议把喂狗放在主循环最后排除中断引起的时序波动干扰。4.3 不依赖 Flash 的 RTC 时间戳方案很多门禁日志需要记录几点几分开锁这样的时间戳。如果外接 DS1302 或 PCF8563 RTC 芯片会增加硬件成本。STM32F103 内置的 RTC 模块只需要一个 32.768kHz 的外部晶振和两个负载电容典型值 6~12.5pF具体看晶振规格书就能在备用电池供电下持续走时。它的寄存器是备份域的一部分复位后需要先解锁 PWR 和备份域时钟才能访问。注意STM32 的 RTC 一旦设置后不能直接写入新的时间要先进入配置模式。HAL 库中对应的写法是RTC_TimeTypeDef sTime {0}; sTime.Hours 0x12; sTime.Minutes 0x30; sTime.Seconds 0x00; // 进入配置模式 HAL_RTC_SetTime(hrtc, sTime, RTC_FORMAT_BCD);所有时间数据用 BCD 码存储读取时如果用RTC_FORMAT_BIN参数会得到二进制值。这极易造成 12:30 被显示成 0x12:0x30 的混乱。统一格式化并在结构体字段的定义处注释清楚能大幅减少后续调试的返工。5. 联网升级与远程管理从能开门到可运营5.1 ESP8266 的 AT 指令接入与 MQTT 数据上行本地门禁做好之后下一步自然是远程管理。最常见也最便宜的做法是加一个 ESP8266 模块通过 USART2 以 AT 指令方式连接 Wi-Fi再通过 MQTT 协议与云端或局域网服务器通信。ESP8266 的 AT 固件默认波特率 115200与 AS608 的 57600 不同这一点要在代码中区分开。// 连接Wi-Fi uint8_t at_wifi[] ATCWJAP\ssid\,\password\\r\n; // 连接MQTT服务器 uint8_t at_mqtt[] ATMQTTCONN0,\tcp://192.168.1.100:1883\,0,1,\doorlock001\\r\n; // 发布开门记录 uint8_t at_pub[] ATMQTTPUB0,\door/record\,\{\\\uid\\\:1,\\\method\\\:\\\fingerprint\\\,\\\time\\\:\\\2024-05-20 12:30\\\}\,0,0\r\n;注意两个细节AT 指令的每条命令必须以\r\n结束AT 指令的返回结果OK、ERROR、MQTTPUB: 0等是异步到达的需要实现一个行缓冲解析器而不能简单地按固定长度读取。5.2 离线优先网络断了门禁照常工作引入联网后最忌讳的是把正常开锁流程依赖网络。我见过一个失败案例程序在每次指纹验证前先尝试连接服务器一旦 Wi-Fi 断开就拒绝开门。正确的逻辑是本地验证优先网络只是旁路——用户在本机验证通过后立即开门同时把开门记录放入一个 FIFO 队列。ESP8266 在线时把队列中的数据逐条推送掉线时继续累积最多存 100 条超出后覆盖最老的记录。队列在内存中即可但如果担心断电丢失队列数据可以定期把队列头部偏移量写入 Flash。这个方案的优点是系统的关键路径——指纹比对、密码验证——完全不依赖外部网络状态网络只是异步上报的工具。5.3 基于 AT 指令的 OTA 固件升级风险控制对已部署的门禁做固件升级是一件需要谨慎处理的事。STM32 的 Bootloader 跳转机制是在 IAP 模式下从 Ymodem 或 Xmodem 协议接收新固件写入 App 区域写完校验 CRC然后软复位跳转到新固件。对于 ESP8266可以使用它的ATCIUPDATE指令升级 ESP8266 自身的固件但STM32 侧的固件升级更常见的是把新固件分割成小块通过 MQTT 下发。升级过程中断的风险很高如果在写入 Flash 时断电STM32 App 区就损坏了。所以 IAP 程序必须放在独立的 Bootloader 区且 App 区写入前先擦除、写完一页立刻读回验证。任何一页校验失败就中止升级并保留旧固件入口。我一般要求 Bootloader 不超过 8KB否则留给 App 的 Flash 空间会被挤压。6. 门禁程序的安全加固防止调试接口被利用与数据被窃听6.1 读保护与调试接口禁用STM32 的 Flash 读保护分为 Level 0无保护、Level 1禁止外部调试器读取 Flash、Level 2永久锁定不可回退。门禁固件里存有管理密码和指纹模板至少开启 Level 1。在代码中设置选项字节Option Bytes的方式在 STM32CubeProgrammer 里勾选即可也可以通过FLASH_OB_Unlock、FLASH_OB_RDPConfig在代码中设置但要注意设置后程序立即生效且回退需要全片擦除。另外PA13/PA14/PA15 和 PB3/PB4 这五个引脚在默认状态下是 SWD/JTAG 调试功能如果你的门禁产品不需要现场调试建议在初始化时把这几个引脚完全禁用并复用为 GPIO。__HAL_AFIO_REMAP_SWJ_NOJTAG(); // 禁用JTAG保留SWD GPIO_InitTypeDef GPIO_InitStruct {0}; GPIO_InitStruct.Pin GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15; GPIO_InitStruct.Mode GPIO_MODE_INPUT; GPIO_InitStruct.Pull GPIO_PULLDOWN; HAL_GPIO_Init(GPIOA, GPIO_InitStruct);6.2 指纹模板与密码存储的加密策略AS608 指纹模块本身支持将模板存储在模块内部的 Flash 中但模块的调试串口若被物理接触外部设备同样能向模块发送指令读取模板。因此需要在 STM32 侧做一层简单的混淆所有通过 UART 发送给 AS608 的指令帧中的参数段做一次 XOR 运算密钥存储在 STM32 的 Flash 中。这只是提高攻击门槛距离真正的安全还有距离但门禁场景里大多数威胁来自随手捡到设备后插上串口工具的好奇者而非专业破解者。密码存储则明确不使用明文。STM32 没有硬件 AES 加速但软实现 AES-128 或更轻量的 XXTEA 是可行的。YYTEA 的优点是代码量极短几十行对单片机的 RAM 占用可以忽略。// XXTEA 加密示例只展示调用方式完整实现可参考公开实现 uint32_t v[4] {0x12345678, 0x90ABCDEF, 0x11112222, 0x33334444}; uint32_t k[4] {0x1122, 0x3344, 0x5566, 0x7788}; xxtea_encrypt(v, 4, k); // 将加密后的数据写入Flash或外挂EEPROM6.3 异常访问日志的关键字与审计技巧日志的意义在于事后追踪。当系统被撬或有人尝试输入错误密码时日志必须记录以下信息用户 ID、认证方式、验证结果、时间戳、重试次数。在Log_Write函数里用一个循环缓冲区每次写入前先检查当前时间是否与上一条相差不到 3 秒如果是则合并为一条连续失败记录避免深夜暴力尝试把日志刷爆——日志区通常只有 8KB足够存几十条带时间戳的记录但如果每 2 秒写一条几分钟就满了。我一般会在日志区预留最后 1KB 存关键事件管理员操作、看门狗复位、篡改检测触发。这类事件不允许被循环覆盖一旦写入永久保留。配合前面讲的磨损均衡 Flash 写入策略整个门禁的状态审计能力就能达到打开串口看日志前因后果清清楚楚的程度。本文还有配套的精品资源点击获取 STM32智能门禁系统程序开发指南：从硬件选型到掉电保护
简介这是一份基于STM32的智能门禁系统硬件端程序面向嵌入式、物联网方向的毕设学生与开发者。系统以STM32为主控通过Wi-Fi与MQTT接入阿里云平台与安卓App联动实现密码与指纹解锁及修改、虚位密码、超时自动锁屏、门锁状态与修改钥匙通知等功能密码和指纹特征加密存放在外部Flash交互界面会提示按键与错误信息整体基于HAL库开发代码结构清晰。压缩包共135个文件包括75个h头文件、46个c源文件以及json配置、txt说明、效果图片等辅助内容大小仅4.49MB便于下载研读。已有325人学习下载。借助完整源码可快速理解外设驱动、FatFS文件系统、MQTT云平台对接等关键模块还能参考其界面交互设计和异常提示逻辑作为毕设基础直接改造与功能扩展。1. 从一块开发板到一套可交付的门禁系统STM32 到底在管什么很多刚接触嵌入式的人会把智能门禁理解为给门锁加个屏幕但真正做过项目你会发现门禁的本质是一个多输入、多输出、带状态记忆的实时控制系统。指纹模块、密码键盘、IC 卡读卡器、红外人体感应、舵机或电插锁、OLED 显示屏、蜂鸣器、Wi-Fi 或蓝牙模块这些设备全部挂在 STM32 的总线上由它统一调度。所谓程序其实是在解决三个问题怎么可靠地采集身份信息、怎么安全地判断放行、怎么在异常情况下不丢状态。本文围绕基于 STM32 的智能门禁系统程序这一项目从硬件选型、程序框架、外设驱动到掉电保护给你一套能直接落地的实现路径。我会以 STM32F103C8T6 为例所有代码基于 HAL 库编写思路同样适用于 F401、F407 等更高性能的型号。如果你正在做毕业设计或产品原型这套方案的完整度足够你少走三个月弯路。2. 硬件选型和程序框架先想清楚门禁和智能分别要什么2.1 主控选型为什么是 STM32F103C8T6智能门禁对主控的要求并不苛刻但它对外设接口数量和低功耗能力有明确要求。指纹模块走串口读卡器走 SPI显示屏走 I2C继电器或舵机走 PWM再加上几个 GPIO 检测门磁和人体红外——这已经吃掉了至少 2 个 UART、1 个 SPI、1 个 I2C、1 个定时器。STM32F103C8T6 拥有 3 个 USART、2 个 SPI、2 个 I2C、4 个 16 位定时器刚好在这个容量区间内做到不用省着用。另一个关键因素是生态成熟度。无论是标准外设库、HAL 库还是 LL 库网上能检索到的 STM32 门禁项目示例非常多。这意味着你在调试指纹模块通讯或 OLED 刷新异常时几乎每一个报错都能在社区里找到对应讨论。对于项目周期紧张的场景这比追求一颗更冷门的主控要务实得多。2.2 外设分工谁做主、谁做从、谁做冗余我一般会把门禁系统的外设分成三个层级。第一层是身份输入设备矩阵键盘接 GPIO 扫描RC522 读卡器接 SPI指纹模块接 USART1。这三者互不占用对方的总线资源可以并行工作不存在读卡时不能按密码的尴尬。第二层是执行与反馈设备舵机或电插锁接定时器 PWM 输出OLED 显示屏接 I2C蜂鸣器和 LED 指示灯接普通 GPIO。执行层的统一特点是状态可查询——你随时能通过 GPIO 电平判断门锁当前是开还是关。第三层是状态感知设备门磁开关接一个外部中断引脚人体红外模块HC-SR501接另一个 GPIO。这一层决定了系统的智能程度有人靠近时才唤醒屏幕、夜晚自动切换布防模式、门被异常撬开时立刻报警。项目落地的常见误区是把所有外设都堆在主控的 5V 电源上忽略 STM32 的 GPIO 容忍电压和模块电平匹配。RC522 的引脚是 3.3V 逻辑但部分指纹模块如 AS608输出的是 5V TTL 电平这时 USART 的 RX 引脚需要加电阻分压或使用电平转换芯片否则长期使用容易损坏 PA10。2.3 程序整体架构状态机是门禁程序的骨架如果你把门禁程序写成顺序执行读卡→判断→开门→关门那系统一旦在开门过程中遇到指纹模块无响应整个逻辑就会卡死。正确的做法是用有限状态机管理系统的所有行为。typedef enum { STATE_LOCKED 0, // 待机锁定 STATE_AUTHENTICATING, // 正在验证身份 STATE_UNLOCKED, // 已放行 STATE_ALARM, // 报警 STATE_CONFIG // 配置模式 } SystemState;系统主循环只做两件事检测外设事件、根据当前状态迁移到下一个状态。比如在上锁状态下检测到指纹模块上报匹配成功系统进入 STATE_AUTHENTICATING此时点亮屏幕等待二次确认如再按一次确认键防止误触放行。确认后切入 STATE_UNLOCKED启动一个 5 秒的开门计时器超时后自动回到 STATE_LOCKED。HAL 库的HAL_GPIO_EXTI_Callback、HAL_UART_RxCpltCallback这类中断回调函数里只做置位标志位的操作真正的业务逻辑全部放在主循环的switch语句中执行。这个架构的好处是每个状态的行为是独立的新增一个管理员指纹注册模式不会影响已有的验证流程。3. 核心功能实现指纹识别、读卡与密码验证的完整流程3.1 基于 AS608 指纹模块的 USART 通讯AS608 是市场上最常见的电容式指纹模块通过串口与 STM32 通信默认波特率 57600。它的指令格式遵循包头 地址 包标识 长度 指令 参数 校验和的结构。这里涉及一个关键点AS608 的数据包是分段传输的一个完整的 192 字节图像上传请求会被拆成多个包。所以你的接收缓冲区必须足够大建议 256 字节并且要能处理粘包——即上一次的残余数据和本次的包头粘连在一起。我建议用下面的方式初始化串口接收uint8_t fingerprint_rx_buf[256]; volatile uint16_t fingerprint_rx_len 0; volatile uint8_t fingerprint_rx_complete 0; // 开启串口空闲中断配合 DMA 接收不定长数据 HAL_UARTEx_ReceiveToIdle_DMA(huart1, fingerprint_rx_buf, sizeof(fingerprint_rx_buf)); // 在回调中判断帧是否完整 void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size) { if (huart-Instance USART1) { fingerprint_rx_len Size; // 检查帧头: 0xEF 0x01 0xFF 0xFF 0xFF 0xFF if (fingerprint_rx_buf[0] 0xEF fingerprint_rx_buf[1] 0x01) { fingerprint_rx_complete 1; } // 重新开启下一次接收 HAL_UARTEx_ReceiveToIdle_DMA(huart1, fingerprint_rx_buf, sizeof(fingerprint_rx_buf)); } }这段代码的核心是利用串口空闲中断来判断一帧数据是否接收完毕。AS608 的所有应答帧都以0xEF01开头因此收到0xEF01即可确认帧同步而不必依赖固定的字节计数。注意设备地址0xFFFFFFFF是广播地址如果你在总线上挂了多个 AS608必须给每个模块设置不同的地址。3.2 RC522 读卡器的 SPI 时序与防冲突机制RC522 通过 SPI 接口与 STM32 通信。它的寄存器寻址机制比较特殊最高位决定读还是写1 为读0 为写低 6 位是寄存器地址。如果直接调用 HAL 的HAL_SPI_TransmitReceive很容易因为地址拼接错误导致读出的数据全是 0xFF。uint8_t RC522_ReadReg(uint8_t reg) { uint8_t tx_data ((reg 1) 0x7E) | 0x80; // 读命令 uint8_t rx_data 0; uint8_t dummy 0; HAL_GPIO_WritePin(RC522_CS_GPIO_Port, RC522_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, tx_data, 1, 10); HAL_SPI_Receive(hspi1, rx_data, 1, 10); // 读取数据 HAL_GPIO_WritePin(RC522_CS_GPIO_Port, RC522_CS_Pin, GPIO_PIN_SET); return rx_data; }寄存器地址与 SPI 数据位之间隔了一个移位这是个典型的 RC522 驱动坑。很多移植失败的项目都卡在这一行reg 1。另外在读取卡号时需要执行寻卡、防冲突、选卡三个步骤对应的命令分别是PCD_ANTICOLL0x93、PCD_TRANSCEIVE0x0C。如果遇到读卡不稳定优先检查 SPI 时钟极性CPOL0, CPHA0和 RC522 的 IRQ 引脚是否接到了 STM32 的外部中断输入。3.3 密码验证的最小实现与防暴力破解密码验证逻辑本身不复杂但门禁场景对它有额外的安全约束连续输错超过 5 次应锁定 1 分钟否则任何人都可以在键盘前穷举。我用一个二维数组保存三个用户的密码以及各自剩余的尝试次数。typedef struct { uint8_t password[6]; // 6 位数字密码ASCII 存储 uint16_t unlock_time; // 最近解锁时间戳 uint8_t retry_count; // 连续错误次数 uint8_t locked_until; // 锁定截止时间相对分钟 } UserEntry; UserEntry users[3] { {{1,2,3,4,5,6}, 0, 0, 0}, {{2,3,4,5,6,7}, 0, 0, 0}, {{3,4,5,6,7,8}, 0, 0, 0} };在验证函数里我需要判断locked_until是否大于当前时间。如果是直接返回 已锁定 状态不参与字符串比较。这样避免了一个细节问题strcmp在密码位数不足时会越界读取内存。所有密码固定 6 位比较用memcmp替代strcmp并且先比对长度再从末尾向前比对能略微增加时序攻击的难度——虽然对门禁这种低价值目标意义有限但代码习惯是好的。3.4 OLED 显示驱动的缓冲区策略0.96 寸 OLED 采用 SSD1306 控制器I2C 接口。它的显存是 1KB128x64 像素每像素 1 bit。在 HAL 库环境下I2C 通信本身是阻塞式的一帧全屏刷新大约要传 1024 字节数据按 400kHz 的 I2C 速率算需要约 20ms。如果你在开门动画里频繁全屏刷新会明显拖慢主循环。我一般用双缓冲 局部刷新策略系统维护一个 1KB 的显存数组所有绘制操作都写在这个数组上只有调用OLED_Display()时才把整个数组推送到屏幕。而像验证成功这种需要动画效果的状态我只刷新屏幕中间 1/4 区域而不是全屏。void OLED_ShowUnlockStatus(void) { // 只清空 y 轴 24~40 的区域 for (uint8_t i 0; i 16; i) { // 第 i 行 对应的显存 y 坐标为 24 i // 需要清除 128 像素宽的整行 memset(display_buffer[(24 i) * 16], 0, 16); } OLED_ShowString(20, 24, UNLOCKED); // 只刷新 y 24~40 区域 OLED_DisplayPart(24, 16); }3.5 舵机开锁与红外感应的联动逻辑门锁执行器用的是 SG90 舵机通过定时器 PWM 控制——20ms 周期0.5ms 高电平对应 0 度2.5ms 对应 180 度。在 HAL 库中用 TIM2 的通道 1 输出 PWM预分频器设置为 72-1这样 72MHz 的主频被分到 1MHz计数周期为 20000 个脉冲对应 20ms。// 打开90度 void DoorLock_Open(void) { __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, 1500); // 1.5ms 高电平 - 90度 } // 回到0度 void DoorLock_Close(void) { __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, 500); // 0.5ms 高电平 - 0度 }红外人体感应HC-SR501在检测到有人时输出 3.3V 高电平。这个信号不需要实时轮询开启上升沿外部中断即可。中断回调里只设置一个标志位主循环发现有人的标志后唤醒屏幕、开启键盘背光。感应器的封锁时间和延时两个电位器需要调节延时调最短约 0.5 秒避免检测到人后长时间不释放灵敏度和距离调到合适档位防止误触发。4. 程序加入掉电保护与日志循环电一断不会前功尽弃4.1 MCU 内部 Flash 的磨损平衡写法门禁系统会记录开锁历史、用户 ID、时间戳还需要保存管理员指纹已注册这类关键配置。如果这些数据只存在 RAM 里一断电就全丢。一个常见的做法是定期把数据写入 STM32 内部的 Flash。但内部 Flash 的擦写寿命大约是 10,000 次门禁频繁开锁时意味着每天可能写数十次几个月就会把同一片 Flash 区域写到报废。解决思路是磨损均衡不固定写同一个扇区而是轮流使用多个扇区。每个扇区开头写一个序列号最新序列号所在扇区就是当前有效数据。由于 STM32F103 的 Flash 扇区大小是 1KB小容量或 2KB中容量我建议用 4 个扇区做循环。#define FLASH_LOG_BASE_ADDR 0x0800C000 // 视具体 Flash 大小调整 #define FLASH_LOG_SECTOR_NUM 4 #define FLASH_LOG_SECTOR_SIZE 2048 typedef struct { uint32_t magic; // 0xA5A5A5A5 表示有效 uint32_t seq; // 序列号 uint8_t user_id; uint8_t unlock_method; // 1指纹 2密码 3IC卡 uint32_t timestamp; } AccessLogEntry;每次写入新日志时先把无效扇区擦掉再把新日志写到下一个有效扇区的尾部。读取时扫描所有扇区找出magic 0xA5A5A5A5且seq最大的记录作为最新状态。4 个扇区交错使用相当于把寿命延长了 4 倍。如果你的项目对日志持久性要求更高可以外挂一个 SPI NOR Flash如 W25Q32它的擦写寿命是 100,000 次量级完全不同。4.2 独立看门狗与待机唤醒的组合策略门禁系统常年在没人操作时处于低功耗状态但也可能在深夜被异常撬门事件唤醒。此时如果主程序因为 I2C 总线挂死而无法正常喂狗独立看门狗IWDG就会产生复位。复位后系统不能直接重新进入待机而要先读取状态标志判断复位原因是看门狗复位还是上电复位。// 在main最前面检查复位原因 if (__HAL_RCC_GET_FLAG(RCC_FLAG_IWDGRST) ! RESET) { // 看门狗复位记录错误日志 Log_Write(LOG_LEVEL_ERROR, System reset by IWDG); __HAL_RCC_CLEAR_RESET_FLAGS(); }独立看门狗的喂狗周期设置需要谨慎它依赖 LSI 低速内部时钟约 40kHz预分频器设为 64重装载值设为 625相当于约 1 秒的超时窗口。在 HAL 库中初始化 IWDG 后必须保证主循环走一圈不超过 1 秒否则看门狗在系统活着但繁忙时也会误复位。建议把喂狗放在主循环最后排除中断引起的时序波动干扰。4.3 不依赖 Flash 的 RTC 时间戳方案很多门禁日志需要记录几点几分开锁这样的时间戳。如果外接 DS1302 或 PCF8563 RTC 芯片会增加硬件成本。STM32F103 内置的 RTC 模块只需要一个 32.768kHz 的外部晶振和两个负载电容典型值 6~12.5pF具体看晶振规格书就能在备用电池供电下持续走时。它的寄存器是备份域的一部分复位后需要先解锁 PWR 和备份域时钟才能访问。注意STM32 的 RTC 一旦设置后不能直接写入新的时间要先进入配置模式。HAL 库中对应的写法是RTC_TimeTypeDef sTime {0}; sTime.Hours 0x12; sTime.Minutes 0x30; sTime.Seconds 0x00; // 进入配置模式 HAL_RTC_SetTime(hrtc, sTime, RTC_FORMAT_BCD);所有时间数据用 BCD 码存储读取时如果用RTC_FORMAT_BIN参数会得到二进制值。这极易造成 12:30 被显示成 0x12:0x30 的混乱。统一格式化并在结构体字段的定义处注释清楚能大幅减少后续调试的返工。5. 联网升级与远程管理从能开门到可运营5.1 ESP8266 的 AT 指令接入与 MQTT 数据上行本地门禁做好之后下一步自然是远程管理。最常见也最便宜的做法是加一个 ESP8266 模块通过 USART2 以 AT 指令方式连接 Wi-Fi再通过 MQTT 协议与云端或局域网服务器通信。ESP8266 的 AT 固件默认波特率 115200与 AS608 的 57600 不同这一点要在代码中区分开。// 连接Wi-Fi uint8_t at_wifi[] ATCWJAP\ssid\,\password\\r\n; // 连接MQTT服务器 uint8_t at_mqtt[] ATMQTTCONN0,\tcp://192.168.1.100:1883\,0,1,\doorlock001\\r\n; // 发布开门记录 uint8_t at_pub[] ATMQTTPUB0,\door/record\,\{\\\uid\\\:1,\\\method\\\:\\\fingerprint\\\,\\\time\\\:\\\2024-05-20 12:30\\\}\,0,0\r\n;注意两个细节AT 指令的每条命令必须以\r\n结束AT 指令的返回结果OK、ERROR、MQTTPUB: 0等是异步到达的需要实现一个行缓冲解析器而不能简单地按固定长度读取。5.2 离线优先网络断了门禁照常工作引入联网后最忌讳的是把正常开锁流程依赖网络。我见过一个失败案例程序在每次指纹验证前先尝试连接服务器一旦 Wi-Fi 断开就拒绝开门。正确的逻辑是本地验证优先网络只是旁路——用户在本机验证通过后立即开门同时把开门记录放入一个 FIFO 队列。ESP8266 在线时把队列中的数据逐条推送掉线时继续累积最多存 100 条超出后覆盖最老的记录。队列在内存中即可但如果担心断电丢失队列数据可以定期把队列头部偏移量写入 Flash。这个方案的优点是系统的关键路径——指纹比对、密码验证——完全不依赖外部网络状态网络只是异步上报的工具。5.3 基于 AT 指令的 OTA 固件升级风险控制对已部署的门禁做固件升级是一件需要谨慎处理的事。STM32 的 Bootloader 跳转机制是在 IAP 模式下从 Ymodem 或 Xmodem 协议接收新固件写入 App 区域写完校验 CRC然后软复位跳转到新固件。对于 ESP8266可以使用它的ATCIUPDATE指令升级 ESP8266 自身的固件但STM32 侧的固件升级更常见的是把新固件分割成小块通过 MQTT 下发。升级过程中断的风险很高如果在写入 Flash 时断电STM32 App 区就损坏了。所以 IAP 程序必须放在独立的 Bootloader 区且 App 区写入前先擦除、写完一页立刻读回验证。任何一页校验失败就中止升级并保留旧固件入口。我一般要求 Bootloader 不超过 8KB否则留给 App 的 Flash 空间会被挤压。6. 门禁程序的安全加固防止调试接口被利用与数据被窃听6.1 读保护与调试接口禁用STM32 的 Flash 读保护分为 Level 0无保护、Level 1禁止外部调试器读取 Flash、Level 2永久锁定不可回退。门禁固件里存有管理密码和指纹模板至少开启 Level 1。在代码中设置选项字节Option Bytes的方式在 STM32CubeProgrammer 里勾选即可也可以通过FLASH_OB_Unlock、FLASH_OB_RDPConfig在代码中设置但要注意设置后程序立即生效且回退需要全片擦除。另外PA13/PA14/PA15 和 PB3/PB4 这五个引脚在默认状态下是 SWD/JTAG 调试功能如果你的门禁产品不需要现场调试建议在初始化时把这几个引脚完全禁用并复用为 GPIO。__HAL_AFIO_REMAP_SWJ_NOJTAG(); // 禁用JTAG保留SWD GPIO_InitTypeDef GPIO_InitStruct {0}; GPIO_InitStruct.Pin GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15; GPIO_InitStruct.Mode GPIO_MODE_INPUT; GPIO_InitStruct.Pull GPIO_PULLDOWN; HAL_GPIO_Init(GPIOA, GPIO_InitStruct);6.2 指纹模板与密码存储的加密策略AS608 指纹模块本身支持将模板存储在模块内部的 Flash 中但模块的调试串口若被物理接触外部设备同样能向模块发送指令读取模板。因此需要在 STM32 侧做一层简单的混淆所有通过 UART 发送给 AS608 的指令帧中的参数段做一次 XOR 运算密钥存储在 STM32 的 Flash 中。这只是提高攻击门槛距离真正的安全还有距离但门禁场景里大多数威胁来自随手捡到设备后插上串口工具的好奇者而非专业破解者。密码存储则明确不使用明文。STM32 没有硬件 AES 加速但软实现 AES-128 或更轻量的 XXTEA 是可行的。YYTEA 的优点是代码量极短几十行对单片机的 RAM 占用可以忽略。// XXTEA 加密示例只展示调用方式完整实现可参考公开实现 uint32_t v[4] {0x12345678, 0x90ABCDEF, 0x11112222, 0x33334444}; uint32_t k[4] {0x1122, 0x3344, 0x5566, 0x7788}; xxtea_encrypt(v, 4, k); // 将加密后的数据写入Flash或外挂EEPROM6.3 异常访问日志的关键字与审计技巧日志的意义在于事后追踪。当系统被撬或有人尝试输入错误密码时日志必须记录以下信息用户 ID、认证方式、验证结果、时间戳、重试次数。在Log_Write函数里用一个循环缓冲区每次写入前先检查当前时间是否与上一条相差不到 3 秒如果是则合并为一条连续失败记录避免深夜暴力尝试把日志刷爆——日志区通常只有 8KB足够存几十条带时间戳的记录但如果每 2 秒写一条几分钟就满了。我一般会在日志区预留最后 1KB 存关键事件管理员操作、看门狗复位、篡改检测触发。这类事件不允许被循环覆盖一旦写入永久保留。配合前面讲的磨损均衡 Flash 写入策略整个门禁的状态审计能力就能达到打开串口看日志前因后果清清楚楚的程度。本文还有配套的精品资源点击获取