口罩識(shí)別門禁系統(tǒng)是嵌入式項(xiàng)目里比較完整的一種綜合訓(xùn)練攝像頭每隔幾百毫秒抓取畫面視覺模塊判斷進(jìn)出的這個(gè)人是否佩戴口罩再把結(jié)果交給 STM32STM32 需要同時(shí)處理按鍵、OLED、蜂鳴器、舵機(jī)或電磁鎖等外設(shè)。很多學(xué)習(xí)者在網(wǎng)上找到類似“STM32 口罩識(shí)別門禁系統(tǒng)源碼原理圖0465A”的免費(fèi)開源資料后第一個(gè)動(dòng)作往往是打開 Keil 直接編譯。結(jié)果不是編譯報(bào)錯(cuò)就是下載后沒有任何現(xiàn)象。這一類資料和普通串口點(diǎn)燈 Demo 不同。它里面包含原理圖、PCB、多份源碼文件、文檔和可能的模型文件。只有在真正搞清楚“哪一顆芯片負(fù)責(zé)識(shí)別、哪一顆芯片負(fù)責(zé)門鎖控制”的前提下代碼才能和電路對(duì)應(yīng)起來。這篇文章以這類 STM32 口罩識(shí)別門禁系統(tǒng)為對(duì)象整理從資料初檢、原理圖閱讀、環(huán)境安裝、模塊聯(lián)調(diào)、故障排查到生產(chǎn)化改造的完整路徑。文中給出的代碼、表格和排查步驟都可以直接移植到自己的工程里而不只是把開源包再解壓一遍。1. 拿到資料先拆系統(tǒng)口罩識(shí)別和門禁控制可能分別在不同芯片1.1 先理解“識(shí)別計(jì)算量”和“控制可靠性”是兩回事口罩識(shí)別門禁系統(tǒng)本質(zhì)上由三個(gè)能力組成圖像采集與識(shí)別、業(yè)務(wù)決策、門鎖執(zhí)行。很多人誤以為所有功能都應(yīng)該由同一顆 STM32 完成這是第一個(gè)認(rèn)知誤區(qū)。STM32F103C8T6 只有 64KB Flash、20KB RAM主頻 72MHz。如果還要讓它同時(shí)處理攝像頭原始圖像和神經(jīng)網(wǎng)絡(luò)推理內(nèi)存和算力都不現(xiàn)實(shí)。而 STM32H743 這類高性能 MCU 在算力和內(nèi)存上明顯更強(qiáng)可以把視覺識(shí)別和門控邏輯放在同一顆芯片上。因此拿到資料的第一步不是找main.c而是先打開原理圖找到圖上到底有幾顆處理器。這里的核心問題是口罩識(shí)別發(fā)生在哪里門禁控制邏輯又發(fā)生在哪里。這決定了你后續(xù)要編譯幾個(gè)工程、需要燒錄幾顆芯片也決定了排錯(cuò)時(shí)先看哪一側(cè)的日志。1.2 三種常見系統(tǒng)架構(gòu)與選型對(duì)照在常見的“STM32 口罩識(shí)別門禁”開源資料中主要有三種架構(gòu)可以用一張表快速判斷。架構(gòu)類型典型芯片組合口罩識(shí)別在哪里完成主控芯片的任務(wù)優(yōu)點(diǎn)難點(diǎn)適用場(chǎng)景STM32 主控 獨(dú)立視覺模塊STM32F103 OpenMV / K210 / ESP32-CAM第二顆視覺芯片或模組接收識(shí)別結(jié)果控制門鎖、顯示、按鍵軟件分層清晰視覺算法不占主控資源雙端通信協(xié)議、另配一路電源多數(shù)低成本門禁 Demo也是 0465A 這類資料最常見的設(shè)計(jì)高性能 MCU 本地 AISTM32H743 / STM32H747 攝像頭主控內(nèi)部通過 Cube.AI 或 TensorFlow Lite Micro 運(yùn)行模型視覺推理與門控邏輯單板少一顆處理器BOM 更緊湊模型量化、內(nèi)存分配、IDE 配置復(fù)雜偏 AI 一體板需要研究模型部署STM32 WiFi / 網(wǎng)絡(luò)后端STM32 ESP8266 / 4G 模組服務(wù)器或云端網(wǎng)絡(luò)通信、門鎖控制后臺(tái)可以在線管理、記錄通行數(shù)據(jù)必須依賴網(wǎng)絡(luò)存在隱私合規(guī)問題需要遠(yuǎn)程后臺(tái)和通行記錄的項(xiàng)目區(qū)分方法很簡(jiǎn)單看原理圖中除了 STM32 之外是否還有 OpenMV、K210、攝像頭模組、ESP32-CAM 等第二處理器。如果有那 STM32 主要負(fù)責(zé)門禁業(yè)務(wù)邏輯如果沒有那視覺識(shí)別大概率在同一顆芯片內(nèi)完成。拿到 0465A 這類資料時(shí)先不要管壓縮包內(nèi)的項(xiàng)目名先把原理圖縮放到全局理解芯片位置和芯片型號(hào)然后再進(jìn)入源碼閱讀。1.3 讀源碼前先整理一張“功能到引腳”映射表嵌入式開發(fā)最常見的問題不是代碼不會(huì)寫而是代碼和原理圖對(duì)不上。比如原理圖中某個(gè)網(wǎng)絡(luò)標(biāo)號(hào)叫DOOR_LOCK但在代碼里可能叫LOCK_Pin。如果不做一次人工翻譯后面排查時(shí)會(huì)浪費(fèi)大量時(shí)間。建議打開原理圖后對(duì)每個(gè)外設(shè)整理一張映射表格式如下。功能原理圖網(wǎng)絡(luò)標(biāo)號(hào)STM32 引腳代碼宏定義GPIO 模式初始電平所在驅(qū)動(dòng)文件蜂鳴器BUZZERPB5BUZZER_Pin/GPIO_PIN_5推挽輸出低電平bsp_buzzer.c舵機(jī)信號(hào)PWM_SERVOPA0TIM2_CH1復(fù)用推挽低電平bsp_servo.cOLED SCLOLED_SCLPB6I2C1_SCL開漏或復(fù)用高電平bsp_oled.c電磁鎖繼電器DRLOCKPB1LOCK_Pin推挽輸出低電平釋放bsp_lock.c視覺模塊 RXUART1_TXPA9USART1_TX復(fù)用推挽-bsp_uart.c這張表不需要一開始填滿但遇到每一個(gè)外設(shè)都要補(bǔ)。填寫完成后把它作為 README 放回源碼目錄比任何現(xiàn)成說明都可靠。代碼中的引腳配置、GPIO 模式、復(fù)用功能都會(huì)在這張表里暴露矛盾。2. 環(huán)境準(zhǔn)備Keil、芯片 Pack、串口驅(qū)動(dòng)都要和源碼對(duì)齊2.1 判斷源碼用的是標(biāo)準(zhǔn)外設(shè)庫還是 HAL 庫很多資料在網(wǎng)盤或壓縮包內(nèi)會(huì)出現(xiàn)兩種風(fēng)格完全不同的代碼一種是標(biāo)準(zhǔn)外設(shè)庫文件里常見GPIO_InitTypeDef、GPIO_ResetBits、GPIO_SetBits另一種是 HAL 庫文件里常見HAL_GPIO_WritePin、HAL_UART_Transmit、__HAL_TIM_SET_COMPARE。快速判斷方法在源碼目錄中搜索是否包含stm32f1xx_hal.h如果存在說明是 HAL 庫工程如果看不到*_hal_*文件而是大量stm32f10x_gpio.c、stm32f10x_tim.c說明是標(biāo)準(zhǔn)外設(shè)庫。這兩種風(fēng)格對(duì)應(yīng)不同的編譯環(huán)境和底層初始化思路。HAL 工程大多可以直接用 CubeMX 重新生成標(biāo)準(zhǔn)外設(shè)庫工程則依賴原作者的模板。使用 0465A 這類開源資料時(shí)最忌諱在拿到資料后立刻用 CubeMX 重新生成自己的工程再?gòu)?qiáng)行把源碼里的main.c替換進(jìn)去。因?yàn)椴煌瑤斓臅r(shí)鐘初始化、GPIO 初始化函數(shù)名稱完全不一樣混在一起會(huì)出現(xiàn)幾十個(gè)編譯錯(cuò)誤。2.2 Keil MDK 的芯片包與 Arm 編譯器版本要匹配即使源碼版本正確編譯時(shí)仍可能遇到啟動(dòng)文件報(bào)錯(cuò)、找不到芯片、語法不兼容等問題。建議在打開工程前做一個(gè)環(huán)境檢查。檢查項(xiàng)推薦做法檢查點(diǎn)芯片型號(hào)在 Keil 的 Options for Target → Device 中選擇原理圖對(duì)應(yīng)的型號(hào)常見的是 STM32F103C8 / STM32F103RCT6 / STM32F407ZGT6芯片 Pack使用 Pack Installer 安裝對(duì)應(yīng)廠商的 DFP 包能識(shí)別芯片型號(hào)編譯時(shí)不報(bào) algorithm 錯(cuò)誤Arm 編譯器版本舊工程默認(rèn) AC5新 Keil 默認(rèn) AC6編譯出現(xiàn)大量 GNU 語法告警時(shí)先切回 AC5 測(cè)試C99 標(biāo)準(zhǔn)在 C/C 選項(xiàng)卡中勾選 C99代碼中出現(xiàn)for(int i0;...)時(shí)沒有 C99 會(huì)報(bào)錯(cuò)MicroLib在 Target 選項(xiàng)卡勾選 Use MicroLib源碼中重定向了printf到串口時(shí)不勾選可能導(dǎo)致串口無輸出另外很多資料里的工程文件路徑是Keil\Project.uvprojx。打開前可以先看目錄中是否包含.uvprojx或.uvproj舊版本工具是.uvproj。如果資料里只有.uvproj就用舊版 Keil MDK 打開并升級(jí)或者手動(dòng)創(chuàng)建新