企业官网建设流程全解析

简介：基于STM32的智能锁系统为一套嵌入式多功能门禁方案，面向物联网、智能家居及电子设计竞赛人群，围绕主控、AI视觉、指纹与键盘交互展开。系统以STM32F103C8T6为核心，配合K210处理器运行YOLO算法实现人脸检测，并集成ATK-AS608指纹模块与4×4薄膜矩阵键盘，形成“人脸+指纹+密码”多重验证机制。压缩包共19个文件，以C源码为主，包含11个c工程文件、2个hex固件、工程配置文件及文档，辅以2张图片说明，整体仅849KB，适合快速查看与移植。资料涵盖主程序、外设驱动、系统时钟、串口、蜂鸣器、看门狗等模块代码，并提供md与txt说明文档，便于梳理架构和二次开发。目前已有122人学习，适合需要完整参考实现或准备智能锁项目的开发者借鉴设计思路与代码组织方式。

1. 为什么智能锁要用 STM32F103C8T6 + K210 的双芯片组合

一个带有人脸识别的智能锁项目，硬件选型时最容易踩坑的地方，是把 YOLO 这种卷积网络硬塞给单片机。STM32F103C8T6 只有 72MHz 主频和 20KB SRAM，跑实时人脸检测基本不现实；K210 虽然带 KPU 硬件加速，但它的外设资源、生态和锁控经验远不如 STM32 丰富。这个标题给出的组合是我在实际项目中很认可的一种分工：STM32F103C8T6 负责指纹比对、矩阵键盘扫描、电磁锁驱动和整把锁的状态调度；K210 专门跑 YOLO 人脸检测，只通过串口把“谁来了、置信度多少”告诉主控。

这套架构里，ATK-AS608 指纹模块作为无网环境下的主要验证手段，4x4 薄膜矩阵键盘补充密码输入的门路，K210 则负责最有科技感的人脸开锁体验。三者互不抢占单片机的算力，由一颗 8 块钱级别的 STM32F103C8T6 统一调度，外设响应快、调试路径清晰，很适合作为毕业设计、产品原型和入门级视觉锁具的参考方案。

2. 硬件架构与接线：STM32F103C8T6 的外设分配和最小系统

2.1 为什么主控选 STM32F103C8T6：资源盘点与选型边界

先看这颗芯片的硬指标：ARM Cortex-M3 内核，72MHz 主频，64KB Flash，20KB SRAM，3 个 USART、2 个 SPI、2 个 I2C、4 个 16 位定时器。在智能锁的场景里，这些资源用起来非常紧凑，但不至于紧张。一个 USART 分给 K210，一个 USART 分给指纹模块，用掉两个；键盘扫描用一组 GPIO；继电器驱动一个 GPIO；蜂鸣器和指示灯各一个 GPIO。剩下多的引脚可以给外部 NOR Flash 或者调试口，整体的引脚占用大约六成。

为什么不用 ESP32？ESP32 的 WiFi/BT 是它的强项，但这个项目的目标是本地离线识别，不依赖云服务，而且 ESP32 跑 YOLO 也跑不动，最终还得挂一颗 K210。引入 WiFi 反而让智能锁面临联网攻击的风险面，也让功耗更难控制。为什么不直接上 STM32F407？F407 主频更高、RAM 更大，但对 YOLO 的推理帮助有限，因为瓶颈在 K210 端；F407 的价格和功耗换来的是用不到的 DPLL、FPU 等资源。在这个项目里，STM32F103C8T6 的定位是“决策和外设调度”，不是“计算”，所以它的性能边界刚刚好。20KB SRAM 如果在设计初期就把调试日志、显示缓冲都塞进去，后期肯定会爆，这也是我后面强调日志必须用 Flash 而不是 RAM 的原因。

2.2 外设接线分配表：K210、ATK-AS608、4x4 键盘和继电器的引脚规划

K210 开发板和 STM32F103C8T6 之间走 UART，STM32 用 USART1 还是 USART2，取决于你的开发板引脚是否引出。我一般建议 USART1 留给调试串口，USART2 给 K210，USART3 给 AS608，这样调试信息和业务数据不抢同一个波特率资源。下面是一份参考引脚表：

K210 的串口输出是 3.3V 逻辑电平，和 STM32F103 的 IO 电平一致，可以直接连。ATK-AS608 模块手册标注的是 TTL 电平，但部分批次模块的 RX 内部没有上拉，STM32 的 TX 空闲状态是拉高的，问题不大；如果用的是 5V 单片机或者带隔离的模块，必须加电平转换芯片，别图省事用电阻分压，指纹模块对电平很敏感。PB4-PB7 这组列引脚，在 STM32F103 上默认是 JTAG 复用线，使用前必须在代码里关闭 JTAG 功能，否则按键扫描会读到一堆乱值，这一点很容易翻车，具体做法是设置AFIO->MAPR的 SWJ_CFG 位，只保留 SWD。

2.3 供电与电磁锁驱动：12V/5V/3.3V 的电源树设计

智能锁不能只用 USB 供电，实际锁体里的电磁锁需要 12V。电源树从输入端开始分两条路：一路 12V 直接给电磁锁驱动电路，另一路经过 DC-DC 降压到 5V，再经 LDO 降到 3.3V 给 STM32、K210、指纹模块和键盘。AS608 的功耗峰值在采集指纹时大约 80mA，K210 整板功耗在 150mA 到 300mA 之间，如果直接用 AMS1117 从 12V 降到 3.3V，压差大、发热高，LDO 会烫手，所以中间必须加一级 DC-DC。常见做法是 MP1584 或 TPS5430 调到 5V，再给 AMS1117-3.3V。

电磁锁驱动是整个供电设计里最重要的环节。继电器线圈或者 MOS 管驱动电磁锁，电磁锁线圈是感性负载，断电瞬间会产生反向电动势，电压尖峰能到几十伏。如果不加续流二极管，这个尖峰直接通过地线把 STM32 复位，每次开锁都是重启。正确的接法是在电磁锁两端反向并联一个 1N4007 二极管，阴极接正极；继电器线圈同样并联一个二极管。补充一点，信号地和功率地要单点连接，尽量用一块完整的铜皮，不要让锁的大电流回流路径经过 STM32 的地引脚附近，这些细节决定了整机稳定性。

3. 在 K210 上跑 YOLO 人脸检测：训练、转换与 STM32 串口通信

3.1 YOLO 模型选型与训练：从 Darknet 到 K210 的 kmodel

K210 的 KPU 只能运行经过定点量化后的模型，所以标准 YOLOv5 的原始浮点模型是放不进去的。实际最常见的做法是在 Darknet 框架上训练 YOLOv2-tiny，或者用 YOLO 系列里更轻量的变体，输入分辨率取 224x224。如果你在 K210 模型训练平台里搜“人脸检测”，能找到一批已经标好的数据集和预训练权重，但我的建议是别直接用别人训练好的模型，因为不同摄像头模组的视场角、焦距和安装高度会影响检测框分布，最好采集你自己锁具安装位置的照片，用 LabelImg 标注 500 到 1000 张，重新微调一轮。

课程里常问的 coco80 怎么读在 YOLO 里，这个问题在转人脸检测时有实际意义：COCO 数据集的 80 类里包含 person，但没有人脸这个小类。训练时配置文件里的 classes 和 filters 要改动，YOLOv2-tiny 的最后一层卷积输出通道数由filters = (classes + 5) * 5决定，如果你把 classes 从 80 改成 1，filters 要改成 30，否则加载权重时会报维度不匹配。这意味着你不能简单地换一个数据集名，还要重建 cfg 文件，并把 anchors 按人脸框的统计重新聚类，通常人脸框的长宽比集中在 0.8 到 1.2 之间，比 COCO 的通用 anchor 更方正。

3.2 模型转换与量化：nncase 编译的关键参数

训练得到.weights之后，需要把它转成 K210 能加载的.kmodel文件。这一步在 K210 上跑 YOLO 的整个流程里是最容易被卡住的，因为中间隔着 ONNX 导出和量化校准两个环节。常见做法是先利用工具箱把 Darknet 模型导出 ONNX，然后用 nncase 进行编译。nncase 的命令行参数里，以下三个参数直接决定能不能跑通：

ncc yolo_tiny_custom.cfg -i yolo_tiny_custom.weights \ -o yolo_face.kmodel \ --dataset ./calib_images \ --inference-type uint8 \ --target k210

逻辑说明：-i指定原始权重，-o输出 kmodel，--dataset指向一组未标注的现场图像，这些图像会作为量化校准数据，让浮点模型在转定点时损失最小。--inference-type uint8表示把激活值量化到 8bit，这是 KPU 唯一支持的运算方式。--target k210指定芯片平台。这里有个很少人提的参数细节：校准图像选 50 到 100 张就够了，但画面内容必须覆盖不同亮度、不同人脸位置，如果你只放十几张纯正脸照，模型在真实旋转角度下会频繁漏检，这就是量化噪声导致的泛化下降。

转换完的 kmodel 文件通常几十 KB 到两三百 KB，在 K210 上加载时主要占用 KPU 寄存器内存和一部分 SRAM。加载失败时 K210 会返回一个错误码，常见的是 -2（模型尺寸超限）和 -5（数据格式不匹配）。前者的解决办法是减小输入分辨率或通道层数，后者的返工点几乎都在量化格式和平台目标设置上。

3.3 K210 与 STM32 的串口帧协议：定义格式和中断解析

我最后选择用 UART 作为两个芯片的通信通道，因为 K210 跑 YOLO 推理的同时还要处理摄像头数据，接 SPI 或 I2C 会增加主控的负担；只要把接收端放在 STM32 的中断里，数据量小、帧率不会阻塞主循环。推荐帧格式如下：

帧头(0xAA 0x55) + 命令码(1字节) + 数据长度(1字节) + 数据 + 累加和(1字节)

K210 端负责组帧发送，STM32 端在 USART 中断里逐字节接收。以下是 STM32 侧用 HAL 库写的中断接收示例：

// 串口中断接收 K210 上报的 YOLO 结果 // 帧格式: AA 55 CMD LEN DATA... SUM #define FRAME_MAX_LEN 32 volatile uint8_t rx_buf[FRAME_MAX_LEN]; volatile uint8_t rx_cnt = 0; volatile uint8_t frame_ok = 0; void USART2_IRQHandler(void) { uint8_t ch = USART2->DR; if (rx_cnt == 0 && ch != 0xAA) { return; } if (rx_cnt == 1 && ch != 0x55) { rx_cnt = 0; return; } rx_buf[rx_cnt++] = ch; // 帧头2字节 + CMD区1字节 + LEN区1字节，等到能读长度时做长度校验 if (rx_cnt == 4) { if (rx_buf[3] > (FRAME_MAX_LEN - 5)) { rx_cnt = 0; return; } } // 每收一帧，校验累加和 if (rx_cnt == (uint8_t)(rx_buf[3] + 5)) { frame_ok = 1; } }

代码里的frame_ok标志在主循环中被消费，消费完成后要清零。逻辑上必须处理两个边界：一是帧头丢失后要重新同步，即第一个字节不是 0xAA 直接丢弃；二是在收到的帧长度异常时立刻复位缓冲区，避免一个错误字节把后续所有数据带偏。累加和校验放在主循环里做，这样中断函数只负责搬运，不参与业务判断，逻辑更清晰。

4. STM32 开锁状态机实现：AS608 指纹、4x4 矩阵键盘与 K210 结果融合

4.1 主状态机的状态划分与开锁判定逻辑

三路输入到达主控的时间完全异步，键盘按键可能是在人脸识别过程中出现的，指纹采集也可能打断密码输入，所以软件架构上必须用一个状态机来串起这些事件。这个项目我建议直接做前后台轮询，不跑 RTOS，因为所有的外设事件都可以通过中断置标志，主循环一次性处理完所有待办即可。状态定义如下：

typedef enum { ST_IDLE, ST_KEY_INPUT, ST_FP_VERIFY, ST_FACE_VERIFY, ST_CHECK_PASS, ST_CHECK_FAIL, ST_UNLOCK, ST_UNLOCKED, ST_LOCKED } lock_state_t;

主循环里的状态转移逻辑是：空闲状态下检测到键盘按下，进入ST_KEY_INPUT累积密码；指纹触发时，在ST_FP_VERIFY发指令并等待 AS608 回包；K210 串口收到人脸结果，则进入ST_FACE_VERIFY比对置信度。三类验证互相独立，只要有一个通过，立即置ST_CHECK_PASS，驱动继电器开锁。开锁成功后延时 30ms 或者等锁体反馈到位信号，再跳回ST_LOCKED。

键盘密码和人脸/指纹开锁的区别在于，前者的密码存储与校验占用少量 Flash 和 RAM；后者则是由外设芯片自行维护特征库，STM32 只接收匹配结果。建议把密码用固定长度字符串，在前 4 个字节做简单的混淆存储，不要明文存在 Flash 的固定偏移地址，否则用 ST-Link 读出 bin 文件就能找到密码区。这里不做强加密设计，但至少不要直接把"123456"连续写在一个地址段里。

4.2 ATK-AS608 指纹模块的指令序列与特征库管理

AS608 是一个带 DSP 的指纹模块，完成从图像采集到特征匹配的全过程。STM32 只要按它的串口协议发指令包即可。指令格式是标准的 6 字节包头加指令码、长度、数据和校验和。以搜索指纹为例，时序上必须先发采集图像（命令码 0x01），等确认包，再发生成特征（命令码 0x02），再发搜索指纹（命令码 0x03）。三条指令之间必须等待模块的响应，不能连续发送。下面这一段对应的是发送“采集图像”的指令数组：

// AS608 常用基础指令: 采集指纹图像 // 格式: 包头 EF 01 FF FF FF FF + 包标识 01 + 包长度 00 03 + 指令 01 + 校验 uint8_t finger_capture[] = {0xEF, 0x01, 0xFF, 0xFF, 0xFF, 0xFF, 0x01, 0x00, 0x03, 0x01, 0x00, 0x05};

逻辑说明：前 6 个字节是固定包头，第 7 字节0x01表示命令包，第 8、9 字节是数据长度，第 10 字节是指令码0x01，最后是校验和。发送完这个数组后，至少等待 50ms，AS608 会回复一个确认包，确认包里会带有成功/失败状态码。如果此时用户手指没有按在采集窗上，返回的确认状态码就是 0x09。指纹录入的新手指必须先在模块里注册，调用写特征库指令（命令码 0x10），把当前缓冲区里的特征数据写入指定 ID。模块最多支持几十个指纹，本项目的典型配置是 10 个普通用户加 1 个管理员。管理员指纹的功能不是开锁，而是进入注册/删除模式，这样在设备上就可以增删指纹，不需要每次改动都重新烧录固件。

注意 AS608 的指令校验和是包内所有字节累加后再取反，不同固件版本对指令集的支持略有差异。厂家资料标注“兼容 AS608”的模块，实际校验算法可能不同。联调时第一步应当先用串口助手发一条读设备参数的命令，确认返回的设备号和校验方式，再继续后面的流程，否则你写的指令序列全是黑匣子，出问题也无从排起。

4.3 4x4 薄膜矩阵键盘的扫描算法与去抖

薄膜矩阵键盘的结构决定了逐行扫描是最稳的做法：把 4 个行引脚设为推挽输出，4 个列引脚设为上拉输入。扫描时每次只把一行拉低，然后读四列，有按键按下时，对应的列会被拉低到低电平。逐行扫完后就能获得一个 4x4 的键号。代码实现如下：

// 4x4 矩阵键盘扫描，返回 0 表示无按键 uint8_t matrix_key_scan(void) { uint8_t row, col; GPIO_TypeDef *row_port = GPIOB; uint8_t row_pins[4] = {GPIO_PIN_0, GPIO_PIN_1, GPIO_PIN_2, GPIO_PIN_3}; uint16_t col_pins[4] = {GPIO_PIN_4, GPIO_PIN_5, GPIO_PIN_6, GPIO_PIN_7}; for (row = 0; row < 4; row++) { // 拉低当前行 HAL_GPIO_WritePin(row_port, row_pins[row], GPIO_PIN_RESET); // 等行线和列线上的电容稳定 delay_us(30); for (col = 0; col < 4; col++) { if (HAL_GPIO_ReadPin(row_port, col_pins[col]) == GPIO_PIN_RESET) { // 扫到按键，恢复行电平后返回键值 HAL_GPIO_WritePin(row_port, row_pins[row], GPIO_PIN_SET); return row * 4 + col + 1; } } // 重点: 一行扫完必须拉高，否则会影响下一行 HAL_GPIO_WritePin(row_port, row_pins[row], GPIO_PIN_SET); } return 0; }

这段扫描函数里最容易漏掉的是最后一个HAL_GPIO_WritePin把行拉高。如果缺了这一句，当前行处于低电平，下一轮扫描时与该行交叉的按键会被误判为恒低，整个键盘就乱套了。delay_us(30)的作用是等待引脚状态稳定；薄膜键盘的线路有几十皮法的寄生电容，不延时就会扫到残留电平。在主循环里调用扫描函数时要加 10ms 的软件消抖，做法是连续两次扫描结果相同才认为是有效按键，否则不派发键值。按键释放检测也很关键，否则按下一次，重复触发好几次密码输入，输入框会出现乱码。

5. 联调避坑记录：AS608、暗光人脸、电磁锁干扰和串口丢帧

5.1 指纹识别率不稳定，干燥手指总是验证失败

现象：同一个手指，刚洗过手或者天气干燥时，验证失败率明显上升；手里有点汗反而很容易通过。

原因：AS608 是光学指纹模块，成像依赖指纹脊和谷的反光差。干燥手指的角质层反射弱，指纹图像的对比度低，DSP 提取的特征不够稳定，导致匹配失败。

解决：软件层面做两次重试，第一次失败后延时 300ms，再发送一次采集指令，让用户稍微抬起再按下，这样能消除一部分按压角度造成的成像差异。连续三次失败才返回最终失败。硬件层面，如果项目面向北方干燥地区，可以考虑换电容式指纹模块，或者在光学采集窗附近做一点微加热处理，让手指微微出汗，这种方式可能因方案而异。

5.2 K210 暗光环境下频繁漏检人脸

现象：白天室内人脸识别基本秒过，傍晚或者只有一盏床头灯的环境下，K210 上报人脸置信度大幅下降，经常没有任何输出，用户不得不掏出手机或输密码。

原因：K210 配套的摄像头感光能力有限，YOLO 输入分辨率又压到 224x224，暗光下边缘纹理信息弱，卷积特征响应整体降低，导致置信度低于你设定的阈值。

解决：先把置信度阈值从 0.6 降到 0.45，让人脸检测更容易通过。但降阈值会引入误检，所以要通过“检测结果 + 二次认证”来兜底：暗光下如果有人脸结果但置信度不足，可以判定为“疑似人脸”，再配合指纹或者密码才能开锁。硬件上最有效的办法是加红外补光灯，并让摄像头工作在自动增益模式。软件侧还可以做一帧亮度统计，连续几帧平均亮度低于设定值就主动开补光灯，这比常亮补光省电。

5.3 电磁锁动作瞬间 STM32 复位，每次开锁都重启

现象：按下开锁后继电器吸合，电磁锁弹开，接着系统灯全灭重启，锁又自动弹回去，用户看到的就是锁根本没开。

原因：电磁锁是感性负载，断开瞬间产生反向电动势，尖峰电压直接通过继电器触点或电源地窜回控制板。这是整个系统里最典型的硬件坑，必须从电路上解决，不能靠软件延时绕过去。

解决：在电磁锁线圈两端并联一个续流二极管（1N4007 或 SS34），阴极接电源正极，给反向电流一个释放回路。继电器线圈两端也同样并联二极管。如果尖峰已经进入 3.3V 系统，就在电源输入级加一个 TVS 管，并在 STM32 的 VDDA 引脚附近加 100nF 高频去耦电容。原型阶段一定要接真实锁具测试，不要用 LED 灯模拟负载，LED 没有感性储能，复现不了这种问题。

5.4 K210 串口帧持续丢数据，K210 明明输出了结果，STM32 端却收不到

现象：调试串口单独打印 K210 的数据是完整的，接上 STM32 后却时好时坏，K210 端用逻辑分析仪能看到连续帧，STM32 端频繁进不了帧头同步。

原因：很多 STM32 开发板的调试串口和 USART1 共用 PA9/PA10，调试器复位瞬间虚拟串口会占用或者拉低一段时间。如果 K210 正好接在 USART1 上，调试器一工作就会和业务数据抢线。另外，两个芯片串口共地没接好，也会出现间歇性丢字节。

解决：K210 的通信串口不要用 USART1，推荐映射到 USART3（PB10/PB11），把 USART1 留给调试日志。两块板子之间除了 TX/RX，必须连接 GND，而且要就近在 STM32 的 RX 引脚加一个 100nF 到地的滤波电容。如果丢帧依然存在，可以在 K210 端把帧发送间隔拉大到 20ms，因为人脸识别结果每秒上报 10 帧就够用了，没必要发满帧率，丢一帧也不需要补传。

6. 进阶：低功耗策略、日志回放和一个值得保留的开发习惯

6.1 待机低功耗：让 K210 和 AS608 一起睡

这个项目的功耗大头是 K210，运行状态下整板电流 150mA 以上，如果做电池供电，必须让系统进入低功耗待机。常见做法是 STM32F103C8T6 进入 STOP 模式，由 RTC 或者外部 GPIO 中断唤醒；进入 STOP 前，先给 K210 发送休眠命令，再把 AS608 的电源通过一个 P-MOS 切断，这样待机电流能降到一个比较低的数量级。唤醒时不能立即开锁，要等 K210 从休眠中恢复并加载模型，这个时间通常要几百毫秒，所以低功耗方案更适合配合人体传感器使用，检测有人接近再唤醒，而不是等人脸凑到跟前再去唤醒。

6.2 掉电日志：循环缓冲区与事件回放

智能锁到了用户现场，出问题时往往没有串口终端，所以我习惯在固件里加一个掉电日志功能。每次验证尝试都向 Flash 末尾写入一条 8 字节日志条目，内容包括时间戳、事件类型、结果、置信度和指纹 ID。下图是日志结构体的参考形态：

typedef struct { uint16_t magic; // 固定魔数，防错位读取 uint8_t event_id; // 1=指纹, 2=人脸, 3=键盘, 0xE=错误 uint8_t result; // 1=成功, 0=失败 uint8_t face_score; // 人脸置信度 0~100 uint8_t fp_id; // 指纹用户编号 uint16_t rtc_min; // 记录相对时间，单位分钟 } log_entry_t;

循环缓冲区原理：日志区划分成固定大小的 N 条记录，写满后从最旧的一条覆盖。读取时依据 magic 判断有效记录。现场出问题后，把 Flash 最后一个扇区读出来，解析时间戳和事件序列，就能看到类似“人脸成功、指纹模式又触发了开锁”这样的真实调用链，而不是靠用户口头描述。这个功能对调试的价值远大于一个漂亮的 UI。

最后说一个我做这类项目一直保留的习惯：所有硬件改动先在原理图上标注会签，再动烙铁。智能锁的故障往往不是单一原因，而是电源、地线、串口几条线互相干扰，改动一处要同步评估另外两端。比如给电磁锁加了续流二极管后，电源纹波可能会变好，但也可能让继电器断开变慢，导致锁体释放不到位，这一轮测试要重点观察。调试这类视觉+MCU 项目，稳一点比快一点更省时间，希望这个 STM32 与 K210 协作的设计思路能帮到你少走几段弯路。

本文还有配套的精品资源，点击获取