別門禁系統(tǒng)：從源碼與原理圖看懂感知-判斷-執(zhí)行閉環(huán))
很多初學(xué)者下載這一類的工程時(shí)會(huì)把注意力放在“口罩識(shí)別”四個(gè)字上甚至?xí)热パa(bǔ)神經(jīng)網(wǎng)絡(luò)結(jié)果折騰了一個(gè)多月門鎖還是不動(dòng)。其實(shí)對(duì)于一個(gè)標(biāo)注為“STM32 口罩識(shí)別門禁系統(tǒng)源碼原理圖”的開(kāi)源項(xiàng)目來(lái)說(shuō)你首先需要理解的是這是一個(gè)嵌入式控制系統(tǒng)不是一個(gè) AI 算法 Demo?！白R(shí)別口罩”只是信號(hào)來(lái)源真正決定系統(tǒng)可不可靠的是 STM32 怎么接收識(shí)別結(jié)果、怎么判斷當(dāng)前狀態(tài)、怎么控制鎖具以及在異常情況下能不能安全退出。源碼和原理圖放在一起價(jià)值不在于讓你照抄而在于提供一條完整的“硬件到軟件”的映射路徑。代碼里的每個(gè)外設(shè)初始化幾乎都能在原理圖上找到對(duì)應(yīng)引腳原理圖上的每個(gè)驅(qū)動(dòng)電路也應(yīng)該有對(duì)應(yīng)的控制邏輯。把這條鏈路吃透比單獨(dú)讀任何一段模型代碼都更有用。下面我會(huì)用一套通用拆解思路把這類項(xiàng)目最該看的幾個(gè)部分講清楚。1. 先糾正定位它是“感知-判斷-執(zhí)行”的閉環(huán)不是模型 Demo1.1 視覺(jué)模塊只負(fù)責(zé)產(chǎn)生事件STM32 才是門禁的大腦在一個(gè)典型的 STM32 口罩識(shí)別門禁系統(tǒng)里圖像采集和口罩識(shí)別不一定都發(fā)生在同一顆芯片上。很多開(kāi)源資料會(huì)采用視覺(jué)協(xié)處理器方案比如用 K210、OpenMV 這類視覺(jué)模塊采集圖像、跑輕量模型然后把“有人臉且佩戴口罩”“有人臉但未佩戴口罩”“未檢測(cè)到人臉”等結(jié)果通過(guò)串口發(fā)給 STM32。STM32 再根據(jù)這個(gè)結(jié)果去控制舵機(jī)、繼電器或電磁鎖同時(shí)驅(qū)動(dòng) OLED 屏幕、蜂鳴器和按鍵完成人機(jī)交互。也有另一種可能STM32 本身帶有攝像頭接口和一定算力可以在板卡上完成圖像采集和簡(jiǎn)單分類。無(wú)論哪種方案口罩識(shí)別模塊都只是門禁系統(tǒng)的“眼睛”它輸出的是事件和標(biāo)簽并不能直接驅(qū)動(dòng)一把鎖。真正決定什么時(shí)候開(kāi)鎖、開(kāi)鎖多長(zhǎng)時(shí)間、識(shí)別失敗時(shí)怎么處理、人員一直停留在門口時(shí)怎么防重入都是 STM32 主控的職責(zé)。如果你下載源碼后第一時(shí)間去找“模型是怎么訓(xùn)練的”“算法代碼在哪里看”方向就跑偏了。模型代碼不是這種開(kāi)源項(xiàng)目的主體或者可以說(shuō)它只是已經(jīng)封裝好的一小部分。更值得看的是 STM32 工程里的狀態(tài)機(jī)、串口協(xié)議解析和外設(shè)驅(qū)動(dòng)。1.2 一個(gè)合格門禁要處理“狀態(tài)”而不是每一幀結(jié)果門禁系統(tǒng)不是每識(shí)別一幀就執(zhí)行一次開(kāi)門。如果這樣設(shè)計(jì)人員只要在門禁前多站幾秒系統(tǒng)可能會(huì)觸發(fā)多次開(kāi)鎖動(dòng)作導(dǎo)致鎖具反復(fù)吸合、繼電器頻繁跳變甚至讓舵機(jī)來(lái)不及歸位。一個(gè)簡(jiǎn)單的狀態(tài)流通常如下待機(jī)狀態(tài)屏幕顯示待機(jī)界面等待人員靠近或按下觸發(fā)按鍵。識(shí)別狀態(tài)視覺(jué)模塊采集圖像并返回結(jié)果STM32 等待有效數(shù)據(jù)。判斷狀態(tài)根據(jù)識(shí)別結(jié)果執(zhí)行分支?？谡峙宕髡＿M(jìn)入開(kāi)鎖流程口罩未佩戴顯示提示并發(fā)出提示音。執(zhí)行狀態(tài)輸出開(kāi)鎖信號(hào)點(diǎn)亮綠色指示燈并開(kāi)始計(jì)時(shí)。超時(shí)或復(fù)位狀態(tài)開(kāi)鎖計(jì)時(shí)結(jié)束舵機(jī)或電磁鎖回到安全位置系統(tǒng)回到待機(jī)。這段流程不復(fù)雜但很多照抄代碼的初學(xué)者會(huì)把每個(gè)環(huán)節(jié)寫成阻塞式延時(shí)。比如識(shí)別到口罩后直接delay(3000)用延時(shí)時(shí)間代替開(kāi)鎖時(shí)間。這樣表面能跑但延時(shí)期間按鍵響應(yīng)、屏幕刷新、串口接收全部卡住。如果視覺(jué)模塊這時(shí)候發(fā)來(lái)新的結(jié)果主控也沒(méi)有及時(shí)處理協(xié)議緩沖可能被覆蓋。這就是我強(qiáng)調(diào)“狀態(tài)機(jī)”的原因。STM32 的主循環(huán)應(yīng)該不斷查詢當(dāng)前狀態(tài)根據(jù)事件跳轉(zhuǎn)而不是在某個(gè)邏輯里死等。1.3 源碼和原理圖配套出現(xiàn)才是最完整的參考設(shè)計(jì)單獨(dú)給一段源碼你很難在自己的板子上復(fù)現(xiàn)。硬件的引腳映射、供電方式、電平轉(zhuǎn)換、負(fù)載驅(qū)動(dòng)都可能是黑盒。單獨(dú)給一張?jiān)韴D你雖然能畫出板子卻不知道程序該怎么初始化外設(shè)、怎么按協(xié)議通信。所以“源碼 原理圖”才是這份開(kāi)源資料最有價(jià)值的地方。源碼告訴你“主控怎么想”原理圖告訴你“硬件怎么連”。你在閱讀任何一個(gè)功能點(diǎn)的時(shí)候都應(yīng)該同時(shí)翻開(kāi)這兩個(gè)文件。例如看到代碼里初始化了USART1就去原理圖找USART1_TX和USART1_RX接到了哪個(gè)器件看到代碼里把某個(gè) GPIO 拉高來(lái)控制繼電器就去原理圖看這個(gè) GPIO 經(jīng)過(guò)了什么驅(qū)動(dòng)電路。這樣對(duì)照著看才能避免“代碼能編譯板子不工作”的尷尬。2. 源碼和原理圖到手后別急著編譯先按四條線拆2.1 打開(kāi)工程先找輸入、處理、輸出三條線拿到源碼工程后我一般不會(huì)先點(diǎn)編譯按鈕而是先在工程目錄里找入口。KEIL 工程里通常是main.cSTM32CubeIDE 工程里通常是一個(gè)帶main函數(shù)的源文件。找到入口后不要試圖從頭到尾逐行讀而是先把代碼分成三條線輸入線處理按鍵、傳感器、視覺(jué)模塊返回的串口數(shù)據(jù)。處理線主循環(huán)里的狀態(tài)判斷、識(shí)別結(jié)果解析、執(zhí)行策略。輸出線控制 GPIO、PWM、屏幕顯示、蜂鳴器、繼電器和鎖具。打開(kāi)main函數(shù)后可以先看外設(shè)初始化。初始化代碼會(huì)告訴你作者用了哪幾個(gè)串口、哪幾個(gè)定時(shí)器、哪幾個(gè) GPIO 引腳。然后在主循環(huán)里找到狀態(tài)機(jī)變量看它有哪些狀態(tài)狀態(tài)之間通過(guò)什么條件跳轉(zhuǎn)。最后再去找串口接收函數(shù)確認(rèn)視覺(jué)模塊的數(shù)據(jù)從哪個(gè)入口進(jìn)來(lái)。如果資料里帶 README先讀 README確認(rèn)主控型號(hào)、視覺(jué)模塊型號(hào)、開(kāi)發(fā)環(huán)境版本和接線表。如果資料沒(méi)有 README也不要著急往往原理圖上的絲印和芯片型號(hào)已經(jīng)把關(guān)鍵信息寫清楚了。2.2 原理圖先看電源再看接口最后看最小系統(tǒng)很多人打開(kāi)原理圖后習(xí)慣先找 STM32 芯片然后盯著引腳看半天這是低效的。一張門禁系統(tǒng)原理圖最優(yōu)先讀的是電源網(wǎng)絡(luò)。我建議按這個(gè)順序讀看電源從哪里輸入是 USB 5V還是 DC 座 12V還是鋰電池接口。找穩(wěn)壓芯片。常見(jiàn)的線性穩(wěn)壓器件會(huì)把外部電壓降到 5V 或 3.3V給 STM32、攝像頭模塊、顯示屏供電?？吹鼐€是否分成模擬地、數(shù)字地、功率地。找主控最小系統(tǒng)晶振、復(fù)位電路、BOOT 引腳、SWD 下載接口。找對(duì)外接口視覺(jué)模塊接口、顯示屏接口、按鍵接口、舵機(jī)或電磁鎖接口。再對(duì)照檢查有沒(méi)有電平轉(zhuǎn)換電路或驅(qū)動(dòng)電路。很多入門者喜歡在面包板上照著原理圖連線但要注意原理圖里的電源網(wǎng)絡(luò)是完整的面包板上如果不同模塊共用一個(gè) 3.3V 穩(wěn)壓器可能會(huì)在鎖具或舵機(jī)動(dòng)作瞬間發(fā)生電壓跌落。2.3 程序結(jié)構(gòu)要和硬件引腳圖對(duì)照確認(rèn)不要想當(dāng)然源碼是作者在自己的板子上驗(yàn)證過(guò)的但如果你手里的板子和源工程不是完全一致就需要特別謹(jǐn)慎。舉一個(gè)常見(jiàn)例子原理圖上把舵機(jī) PWM 輸出放在PA8但源碼里初始化的卻是PB1。這時(shí)候你如果直接編譯燒寫舵機(jī)不會(huì)有反應(yīng)。如果不看原理圖你可能花很長(zhǎng)時(shí)間排查舵機(jī)本身甚至懷疑是 PWM 頻率不對(duì)。正確做法是先確認(rèn)當(dāng)前硬件實(shí)際連接再?zèng)Q定是改代碼還是改接線。同樣串口的 RX/TX 也容易錯(cuò)位。STM32 的PA9是USART1_TXPA10是USART1_RX但視覺(jué)模塊那一端的 TX 要接 STM32 的 RXRX 要接 STM32 的 TX。如果兩條線剛好對(duì)調(diào)STM32 收不到任何數(shù)據(jù)屏幕就會(huì)一直停留在“等待識(shí)別”。2.4 開(kāi)發(fā)環(huán)境和芯片型號(hào)要先對(duì)齊這種開(kāi)源工程的源碼不能保證在所有環(huán)境下都能直接編譯。打開(kāi)工程前要確認(rèn)工程使用的芯片型號(hào)。比如是STM32F103C8T6還是STM32F407ZGT6不同型號(hào)的外設(shè)資源和啟動(dòng)文件不同。如果使用 KEIL需要確認(rèn)是否已經(jīng)安裝了對(duì)應(yīng)的 Device Family Pack。如果缺少芯片包雙擊工程文件后會(huì)提示找不到 Device。下載對(duì)應(yīng)系列的 Pack 后重新打開(kāi)一般就能解決。如果使用 STM32CubeIDE則需要在工程屬性里確認(rèn)調(diào)試器型號(hào)和下載設(shè)置。時(shí)鐘配置也容易忽略。如果源碼是按外部 8MHz 晶振配置系統(tǒng)時(shí)鐘但你手里的板子用的是 12MHz 晶振系統(tǒng)可能無(wú)法啟動(dòng)或串口波特率會(huì)偏移。這時(shí)去原理圖確認(rèn)晶振頻率回到代碼里修改對(duì)應(yīng)的時(shí)鐘樹(shù)配置才能保證外設(shè)時(shí)序正常。3. 聯(lián)調(diào)時(shí)真正麻煩的是串口、驅(qū)動(dòng)和供電這三件事3.1 視覺(jué)模塊到 STM32先解決串口協(xié)議再談識(shí)別效果視覺(jué)模塊識(shí)別到結(jié)果后需要把結(jié)果發(fā)送給 STM32。最常見(jiàn)的通信接口是 UART 串口少數(shù)方案會(huì)用 SPI 或 I2C。如果主控和視覺(jué)模塊都是 3.3V 電平串口直連最方便如果視覺(jué)模塊是 5V 電平則要注意 STM32 引腳是否兼容必要時(shí)加電平轉(zhuǎn)換或分壓電阻。串口數(shù)據(jù)解析是第一個(gè)大坑。很多視覺(jué)模塊的識(shí)別結(jié)果并不是一行人類可讀的字符串而是一幀固定格式的二進(jìn)制數(shù)據(jù)可能包含幀頭、長(zhǎng)度、識(shí)別標(biāo)簽、置信度、邊界框坐標(biāo)和校驗(yàn)值。STM32 端需要按這個(gè)格式逐字節(jié)解析。最容易出問(wèn)題的不是幀頭判斷而是“半包”和“粘包”。串口每次實(shí)際收到的可能不是一個(gè)完整的數(shù)據(jù)幀而是半幀下一批字節(jié)到達(dá)時(shí)又可能把兩幀數(shù)據(jù)拼在一起。初學(xué)者如果只判斷if (buf[0] 0x55 buf[1] 0xAA)就開(kāi)始處理數(shù)據(jù)很容易在數(shù)據(jù)不完整時(shí)越界讀取或在粘包時(shí)錯(cuò)誤解析。我的建議是在串口接收中斷里只做“把字節(jié)保存到緩沖區(qū)”這件事不要做復(fù)雜的數(shù)據(jù)處理。在主循環(huán)中用一個(gè)狀態(tài)機(jī)逐字節(jié)查找?guī)^再按照長(zhǎng)度字段判斷完整幀是否到達(dá)最后做校驗(yàn)。下面是一個(gè)通用解析思路示例不代表該開(kāi)源工程源碼// 示意在主循環(huán)中逐字節(jié)解析 uint8_t frame[16]; uint8_t frame_len 0; uint8_t expect_len 0; void process_byte(uint8_t byte) { static uint8_t state 0; switch (state) { case 0: // 找?guī)^ if (byte 0x55) { frame[0] byte; state 1; } break; case 1: if (byte 0xAA) { frame[1] byte; state 2; } else { state 0; // 幀頭錯(cuò)誤重新來(lái) } break; case 2: frame_len byte; frame[2] byte; expect_len frame_len; state 3; break; default: // 按長(zhǎng)度收滿整幀后再校驗(yàn)和解析 break; } }這不是可以直接使用的代碼只是用來(lái)表達(dá)“接收緩沖區(qū) 幀解析狀態(tài)機(jī)”的思路。如果原工程已經(jīng)有了類似邏輯先確認(rèn)它是否正確處理了半包和粘包如果原工程沒(méi)有你可以自己補(bǔ)上。3.2 控制門鎖不能把鎖具直接接到 GPIO門鎖執(zhí)行部分是最需要安全意識(shí)的地方。電磁鎖、電插鎖、舵機(jī)都不是普通 LED不能直接掛在 STM32 的 GPIO 上。STM32 引腳能提供的電流非常有限電壓也只有 3.3V根本推不動(dòng)大電流器件。在原理圖里通常會(huì)看到 MOS 管、三極管、光耦或繼電器模塊。它們的作用是把 STM32 的低壓控制信號(hào)轉(zhuǎn)換成鎖具需要的開(kāi)關(guān)動(dòng)作。如果你拿到的是沒(méi)有驅(qū)動(dòng)電路的裸板一定不能拿杜邦線把鎖具接到單片機(jī)引腳上。幾個(gè)關(guān)鍵點(diǎn)確定控制信號(hào)是“高電平有效”還是“低電平有效”。有些繼電器模塊內(nèi)部使用了光耦反向輸入低電平時(shí)繼電器才會(huì)動(dòng)作。不要只看代碼里寫GPIO_SetBits就以為是開(kāi)鎖。驅(qū)動(dòng)繼電器線圈時(shí)要并聯(lián)續(xù)流二極管否則斷電瞬間會(huì)產(chǎn)生反向電動(dòng)勢(shì)可能損壞 MOS 管或干擾主控。如果驅(qū)動(dòng)舵機(jī)通常要使用定時(shí)器輸出 PWM。舵機(jī)信號(hào)周期一般是 20ms高電平脈寬 1ms 到 2ms 對(duì)應(yīng)不同角度。不要在主循環(huán)里用delay方式現(xiàn)場(chǎng)拉高拉低模擬 PWM那樣會(huì)讓系統(tǒng)卡死。鎖具動(dòng)作要設(shè)置時(shí)間上限。比如開(kāi)鎖指令觸發(fā)后持續(xù) 1 到 2 秒就自動(dòng)撤銷而不是一直輸出高電平。長(zhǎng)期通電會(huì)讓電磁鎖發(fā)熱也可能帶來(lái)安全隱患。建議先不接鎖具用一個(gè) LED 代替開(kāi)鎖輸出。確認(rèn)程序狀態(tài)機(jī)正確后再接入真實(shí)驅(qū)動(dòng)板和鎖具。這樣一旦出問(wèn)題不會(huì)燒壞昂貴外設(shè)也更容易定位。3.3 系統(tǒng)跑飛、復(fù)位、花屏優(yōu)先級(jí)最高的懷疑對(duì)象是供電在類似項(xiàng)目中我見(jiàn)過(guò)很多“代碼明明沒(méi)問(wèn)題但就是不能穩(wěn)定工作”的情況。最典型的場(chǎng)景是屏幕顯示識(shí)別到口罩舵機(jī)剛開(kāi)始轉(zhuǎn)動(dòng)STM32 就復(fù)位重啟了。原因往往不是哪一行代碼寫錯(cuò)而是供電撐不住。一個(gè)門禁系統(tǒng)里有多種電壓和電流需求STM32 需要 3.3V攝像頭模塊可能需要 3.3V 或 5V舵機(jī)可能需要 5V 或 6V電磁鎖可能需要 12V。如果全部從一個(gè) USB 口的 5V 取電當(dāng)鎖具啟動(dòng)或舵機(jī)堵轉(zhuǎn)時(shí)電流會(huì)瞬間增大電源電壓被拉低ST Link 或主控上的穩(wěn)壓器進(jìn)入欠壓狀態(tài)單片機(jī)自然復(fù)位。處理方法是分層供電主控和邏輯部分用獨(dú)立的 3.3V 穩(wěn)壓供電。視覺(jué)模塊單獨(dú)供電優(yōu)先使用模塊推薦的電壓范圍。舵機(jī)或鎖具使用更高電壓的獨(dú)立電源。所有模塊的地線要可靠共地否則串口信號(hào)沒(méi)有統(tǒng)一參考點(diǎn)通信會(huì)不穩(wěn)定。如果暫時(shí)沒(méi)有多路電源至少要在鎖具電源輸入端加大容量電容并且讓功率地線與信號(hào)地線盡量分開(kāi)走。不要用幾十厘米長(zhǎng)的細(xì)杜邦線同時(shí)給鎖具和主控供電。3.4 識(shí)別卡頓或者超時(shí)也要檢查觸發(fā)和復(fù)位策略口罩識(shí)別門禁不是一直不停地識(shí)別。如果視覺(jué)模塊以每秒幾幀的速度持續(xù)輸出結(jié)果主控在沒(méi)有人員觸發(fā)時(shí)也頻繁處理數(shù)據(jù)會(huì)造成不必要的功耗和屏幕閃爍。通常系統(tǒng)會(huì)有一個(gè)觸發(fā)方式人體感應(yīng)模塊、按鍵觸發(fā)或視覺(jué)模塊檢測(cè)到人臉后再開(kāi)始完整識(shí)別。如果項(xiàng)目里沒(méi)有觸發(fā)機(jī)制也可以靠狀態(tài)機(jī)在“待機(jī)態(tài)”丟棄無(wú)效識(shí)別結(jié)果只保留連續(xù)多次出現(xiàn)同一結(jié)果后再進(jìn)入動(dòng)作判斷。這樣可以避免單人路過(guò)時(shí)系統(tǒng)因?yàn)橐粌蓭`檢就開(kāi)門。另一個(gè)容易被忽略的問(wèn)題是超時(shí)復(fù)位。如果視覺(jué)模塊和主控之間的連線松動(dòng)主控會(huì)一直等待串口數(shù)據(jù)看起來(lái)像“死機(jī)”了。更好的做法是給識(shí)別等待過(guò)程加超時(shí)比如 3 秒內(nèi)沒(méi)有收到有效結(jié)果就自動(dòng)回到待機(jī)狀態(tài)并在屏幕上顯示“未檢測(cè)到模塊”。4. 從“能開(kāi)門”到“能長(zhǎng)期用”還差幾塊關(guān)鍵拼圖4.1 要分清實(shí)驗(yàn)演示和真實(shí)門禁的差別把一塊開(kāi)發(fā)板放在實(shí)驗(yàn)桌上接上舵機(jī)和紙板門識(shí)別到口罩就開(kāi)鎖這在課程設(shè)計(jì)里已經(jīng)很完整。但如果要把它放到實(shí)驗(yàn)室門口或者辦公室實(shí)際使用考慮的問(wèn)題會(huì)完全不同。實(shí)驗(yàn)演示只需要單次動(dòng)作能觸發(fā)真實(shí)門禁需要應(yīng)對(duì)連續(xù)多人進(jìn)出、環(huán)境光線變化、人員逆光、戴帽子、口罩遮擋程度不同等復(fù)雜情況。視覺(jué)模塊的識(shí)別閾值要重新校準(zhǔn)不能只看代碼里的默認(rèn)值。真實(shí)門禁還需要考慮斷電恢復(fù)。如果系統(tǒng)在開(kāi)門過(guò)程中斷電重新上電后應(yīng)該回到什么狀態(tài)如果是電磁鎖默認(rèn)應(yīng)該保持閉鎖還是釋放取決于具體門禁安全策略。這些不是能在代碼里憑空拍板的需要結(jié)合現(xiàn)場(chǎng)管理規(guī)則和門體類型。作為開(kāi)發(fā)者至少要做到上電初始化時(shí)不要把 GPIO 誤設(shè)為開(kāi)鎖狀態(tài)否則可能一上電就開(kāi)門。4.2 可靠性設(shè)計(jì)看門狗、狀態(tài)超時(shí)、防重入如果只是自己學(xué)習(xí)主循環(huán)跑死了大不了按復(fù)位鍵。但作為門禁系統(tǒng)長(zhǎng)時(shí)間無(wú)人值守必須考慮程序跑飛的情況。默認(rèn)應(yīng)該補(bǔ)三件事獨(dú)立看門狗。如果主循環(huán)卡死在某個(gè)阻塞等待里看門狗會(huì)產(chǎn)生復(fù)位讓系統(tǒng)重新初始化。要注意喂狗位置不能放在長(zhǎng)時(shí)間阻塞的流程里否則看門狗起不到作用。狀態(tài)超時(shí)。每個(gè)需要等待外部事件的環(huán)節(jié)都要有超時(shí)上限。比如等待視覺(jué)模塊數(shù)據(jù)如果 3 秒沒(méi)有收到完整幀就報(bào)錯(cuò)并回到待機(jī)而不是一直卡在接收狀態(tài)。防重入。開(kāi)鎖成功后要加冷卻時(shí)間比如 5 秒內(nèi)忽略新的開(kāi)鎖指令避免同一個(gè)人員站在門口反復(fù)觸發(fā)舵機(jī)動(dòng)作。在代碼層面盡量避免在狀態(tài)機(jī)里使用長(zhǎng)延時(shí)。如果功能需要時(shí)間控制可以結(jié)合定時(shí)器中斷做計(jì)時(shí)標(biāo)志或使用非阻塞的HAL_GetTick()查詢。比如if (HAL_GetTick() - open_tick OPEN_TIME_MS) { lock_off(); state IDLE; }這樣就不會(huì)阻塞按鍵掃描和屏幕刷新。4.3 數(shù)據(jù)與隱私邊界從課程設(shè)計(jì)就要注意口罩識(shí)別門禁涉及人臉圖像很多開(kāi)源源碼只在本地做推理這是比較穩(wěn)妥的做法。如果要把圖像上傳到云端除非有明確需求和安全鏈路否則我個(gè)人不建議在門禁場(chǎng)景里做。即使本地處理也可能在日志里保存圖片或裁剪出的人臉區(qū)域。對(duì)這些數(shù)據(jù)要有生命周期管理不能用完就堆在 SD 卡里。更合理的做法是只保存“時(shí)間、是否佩戴口罩、事件結(jié)果”這類文本日志不保存原始圖像。如果確實(shí)需要保存圖像用于事后追溯也要定期清理并限制訪問(wèn)權(quán)限。開(kāi)源項(xiàng)目用于學(xué)習(xí)沒(méi)有問(wèn)題但如果要部署在公共環(huán)境中需要先取得相應(yīng)授權(quán)并遵守學(xué)校或單位的隱私管理要求。把門禁系統(tǒng)當(dāng)成技術(shù)實(shí)驗(yàn)來(lái)寫安全邊界要清楚。4.4 增量改造從硬件到軟件的模塊化拆法很多人拿到別人的開(kāi)源項(xiàng)目后第一反應(yīng)是想換掉其中的某個(gè)模塊比如把視覺(jué)模塊換成更高分辨率的或者把舵機(jī)換成電磁鎖。這時(shí)候最容易出事。我建議的改造順序是保持原版硬件和軟件能完整運(yùn)行。把源碼里的協(xié)議解析做成一個(gè)獨(dú)立的模塊輸入是串口數(shù)據(jù)輸出是“口罩正常”或“口罩異?！钡某橄蠼Y(jié)果。把控制執(zhí)行做成另一個(gè)獨(dú)立模塊輸入是開(kāi)門指令輸出是繼電器或 PWM 動(dòng)作。更換視覺(jué)模塊時(shí)只改協(xié)議解析層不改狀態(tài)機(jī)和控制層。更換鎖具時(shí)只改執(zhí)行驅(qū)動(dòng)函數(shù)不改識(shí)別解析邏輯。這樣改造的好處是每次只改一個(gè)變量出問(wèn)題時(shí)可以快速定位。如果不分層所有邏輯都寫在main里換一個(gè)攝像頭模塊可能要把整個(gè)工程重寫一遍。5. 一張排查清單從現(xiàn)象到根因少走三小時(shí)彎路5.1 先別看模型按“從現(xiàn)象到模塊”的順序排查當(dāng)門禁系統(tǒng)出問(wèn)題時(shí)很多人的第一反應(yīng)是去調(diào)模型閾值或改識(shí)別算法。但問(wèn)題是如果主控根本沒(méi)收到視覺(jué)模塊的數(shù)據(jù)你再怎么調(diào)算法閾值也沒(méi)用。這里我可以給出一張通用排查清單現(xiàn)象優(yōu)先檢查位置常見(jiàn)原因上電后完全沒(méi)反應(yīng)電源輸入、穩(wěn)壓器、指示燈供電電壓不對(duì)、接線短路、板卡損壞程序下載失敗下載器、SWD 線、BOOT 引腳驅(qū)動(dòng)沒(méi)裝、目標(biāo)芯片選擇錯(cuò)誤、線序錯(cuò)誤OLED 不顯示屏幕供電、I2C/SPI 地址、GPIO 配置地址不一致、引腳被復(fù)用、初始化順序不對(duì)串口收不到識(shí)別結(jié)果RX/TX 接線是否交叉、共地、波特率視覺(jué)模塊沒(méi)有啟動(dòng)、供電不足、模塊故障能識(shí)別但不能開(kāi)鎖控制 GPIO、驅(qū)動(dòng)電路、鎖具電源有效電平判斷錯(cuò)誤、驅(qū)動(dòng)模塊損壞、鎖具電源缺失開(kāi)鎖瞬間復(fù)位電源、繼電器續(xù)流、鎖具驅(qū)動(dòng)電流沖擊導(dǎo)致電壓跌落、驅(qū)動(dòng)無(wú)保護(hù)電路門禁偶爾自己開(kāi)鎖狀態(tài)機(jī)、防重入、串口粘包數(shù)據(jù)幀解析錯(cuò)誤、沒(méi)有冷卻時(shí)間、誤檢觸發(fā)排查順序建議按這個(gè)鏈路來(lái)先看現(xiàn)象——是完全沒(méi)有輸出還是偶發(fā)錯(cuò)誤再看輸入——視覺(jué)模塊到底有沒(méi)有發(fā)數(shù)據(jù)、數(shù)據(jù)格式是否正確再看環(huán)境——供電電壓、地線、干擾最后再改代碼參數(shù)比如閾值、波特率、超時(shí)時(shí)間。如果一開(kāi)始就去改代碼可能改了半天才發(fā)現(xiàn)只是舵機(jī)電源線沒(méi)接好。5.2 做一個(gè)最小復(fù)現(xiàn)實(shí)驗(yàn)繞過(guò)視覺(jué)模塊直接給主控發(fā)已知數(shù)據(jù)這是我最推薦的一種排查方式。它能把“視覺(jué)模塊的問(wèn)題”和“主控的問(wèn)題”徹底分開(kāi)。具體做法是把 STM32 的串口 RX 線從視覺(jué)模塊上斷開(kāi)用 USB 轉(zhuǎn) TTL 模塊連接電腦通過(guò)串口助手按照源碼里的協(xié)議格式手動(dòng)發(fā)送一幀“口罩正?！钡臄?shù)據(jù)給 STM32。如果這時(shí)候門鎖正常動(dòng)作說(shuō)明主控端的串口解析、狀態(tài)機(jī)、控制驅(qū)動(dòng)是通的問(wèn)題大概率出在視覺(jué)模塊、模塊供電或視覺(jué)模塊和 STM32 之間的接線。如果發(fā)送已知數(shù)據(jù)后門鎖仍然不動(dòng)說(shuō)明主控端代碼有問(wèn)題可以再縮小范圍先把控制輸出的 GPIO 直接手動(dòng)拉高看鎖具有沒(méi)有反應(yīng)。如果 GPIO 拉高后鎖具動(dòng)了問(wèn)題在狀態(tài)機(jī)或串口解析如果 GPIO 拉高后鎖具還是不動(dòng)問(wèn)題在驅(qū)動(dòng)電路或鎖具電源。這種“逐級(jí)縮小”的方法比反復(fù)修改代碼要快得多。5.3 從開(kāi)源工程到自己的項(xiàng)目最穩(wěn)的方法是“先復(fù)現(xiàn)再改動(dòng)”最后給一個(gè)落地建議不要一上來(lái)就把工程大卸八塊改成自己的想法。先把原始工程完整地編譯、燒寫、跑通一次。即使你覺(jué)得某個(gè)模塊設(shè)計(jì)得不夠好也先尊重原作者的連線關(guān)系和工程結(jié)構(gòu)。跑通后在原始工程基礎(chǔ)上做一次小改動(dòng)比如把開(kāi)鎖指示燈換一個(gè) GPIO或者把串口波特率從 115200 改成 9600驗(yàn)證你理解的外設(shè)初始化是否和實(shí)際現(xiàn)象一致。小改動(dòng)驗(yàn)證成功以后再去做模塊替換和功能增強(qiáng)。這個(gè)流程聽(tīng)起來(lái)慢實(shí)際上最省時(shí)間。因?yàn)槊恳浑A段你都知道問(wèn)題出在哪里。相反如果第一天就把攝像頭模塊換掉第二天又改了主控芯片第三天把舵機(jī)換成了電磁鎖最后出問(wèn)題時(shí)你會(huì)發(fā)現(xiàn)電源、通信、控制、算法全部混在一起根本無(wú)從排查。對(duì)一份開(kāi)源資料最好的使用方式不是把它當(dāng)成最終成品而是把它當(dāng)成一個(gè)你已經(jīng)讀懂的參考基線。源代碼可以改原理圖可以改但你心里的架構(gòu)不能亂。把“感知—判斷—執(zhí)行”這條鏈路理清楚把串口、供電、驅(qū)動(dòng)和狀態(tài)機(jī)這幾件事調(diào)穩(wěn)口罩識(shí)別門禁系統(tǒng)的真正難點(diǎn)也就解決了大半。 STM32口罩識(shí)別門禁系統(tǒng)：從源碼與原理圖看懂感知-判斷-執(zhí)行閉環(huán)
很多初學(xué)者下載這一類的工程時(shí)會(huì)把注意力放在“口罩識(shí)別”四個(gè)字上甚至?xí)热パa(bǔ)神經(jīng)網(wǎng)絡(luò)結(jié)果折騰了一個(gè)多月門鎖還是不動(dòng)。其實(shí)對(duì)于一個(gè)標(biāo)注為“STM32 口罩識(shí)別門禁系統(tǒng)源碼原理圖”的開(kāi)源項(xiàng)目來(lái)說(shuō)你首先需要理解的是這是一個(gè)嵌入式控制系統(tǒng)不是一個(gè) AI 算法 Demo?！白R(shí)別口罩”只是信號(hào)來(lái)源真正決定系統(tǒng)可不可靠的是 STM32 怎么接收識(shí)別結(jié)果、怎么判斷當(dāng)前狀態(tài)、怎么控制鎖具以及在異常情況下能不能安全退出。源碼和原理圖放在一起價(jià)值不在于讓你照抄而在于提供一條完整的“硬件到軟件”的映射路徑。代碼里的每個(gè)外設(shè)初始化幾乎都能在原理圖上找到對(duì)應(yīng)引腳原理圖上的每個(gè)驅(qū)動(dòng)電路也應(yīng)該有對(duì)應(yīng)的控制邏輯。把這條鏈路吃透比單獨(dú)讀任何一段模型代碼都更有用。下面我會(huì)用一套通用拆解思路把這類項(xiàng)目最該看的幾個(gè)部分講清楚。1. 先糾正定位它是“感知-判斷-執(zhí)行”的閉環(huán)不是模型 Demo1.1 視覺(jué)模塊只負(fù)責(zé)產(chǎn)生事件STM32 才是門禁的大腦在一個(gè)典型的 STM32 口罩識(shí)別門禁系統(tǒng)里圖像采集和口罩識(shí)別不一定都發(fā)生在同一顆芯片上。很多開(kāi)源資料會(huì)采用視覺(jué)協(xié)處理器方案比如用 K210、OpenMV 這類視覺(jué)模塊采集圖像、跑輕量模型然后把“有人臉且佩戴口罩”“有人臉但未佩戴口罩”“未檢測(cè)到人臉”等結(jié)果通過(guò)串口發(fā)給 STM32。STM32 再根據(jù)這個(gè)結(jié)果去控制舵機(jī)、繼電器或電磁鎖同時(shí)驅(qū)動(dòng) OLED 屏幕、蜂鳴器和按鍵完成人機(jī)交互。也有另一種可能STM32 本身帶有攝像頭接口和一定算力可以在板卡上完成圖像采集和簡(jiǎn)單分類。無(wú)論哪種方案口罩識(shí)別模塊都只是門禁系統(tǒng)的“眼睛”它輸出的是事件和標(biāo)簽并不能直接驅(qū)動(dòng)一把鎖。真正決定什么時(shí)候開(kāi)鎖、開(kāi)鎖多長(zhǎng)時(shí)間、識(shí)別失敗時(shí)怎么處理、人員一直停留在門口時(shí)怎么防重入都是 STM32 主控的職責(zé)。如果你下載源碼后第一時(shí)間去找“模型是怎么訓(xùn)練的”“算法代碼在哪里看”方向就跑偏了。模型代碼不是這種開(kāi)源項(xiàng)目的主體或者可以說(shuō)它只是已經(jīng)封裝好的一小部分。更值得看的是 STM32 工程里的狀態(tài)機(jī)、串口協(xié)議解析和外設(shè)驅(qū)動(dòng)。1.2 一個(gè)合格門禁要處理“狀態(tài)”而不是每一幀結(jié)果門禁系統(tǒng)不是每識(shí)別一幀就執(zhí)行一次開(kāi)門。如果這樣設(shè)計(jì)人員只要在門禁前多站幾秒系統(tǒng)可能會(huì)觸發(fā)多次開(kāi)鎖動(dòng)作導(dǎo)致鎖具反復(fù)吸合、繼電器頻繁跳變甚至讓舵機(jī)來(lái)不及歸位。一個(gè)簡(jiǎn)單的狀態(tài)流通常如下待機(jī)狀態(tài)屏幕顯示待機(jī)界面等待人員靠近或按下觸發(fā)按鍵。識(shí)別狀態(tài)視覺(jué)模塊采集圖像并返回結(jié)果STM32 等待有效數(shù)據(jù)。判斷狀態(tài)根據(jù)識(shí)別結(jié)果執(zhí)行分支?？谡峙宕髡＿M(jìn)入開(kāi)鎖流程口罩未佩戴顯示提示并發(fā)出提示音。執(zhí)行狀態(tài)輸出開(kāi)鎖信號(hào)點(diǎn)亮綠色指示燈并開(kāi)始計(jì)時(shí)。超時(shí)或復(fù)位狀態(tài)開(kāi)鎖計(jì)時(shí)結(jié)束舵機(jī)或電磁鎖回到安全位置系統(tǒng)回到待機(jī)。這段流程不復(fù)雜但很多照抄代碼的初學(xué)者會(huì)把每個(gè)環(huán)節(jié)寫成阻塞式延時(shí)。比如識(shí)別到口罩后直接delay(3000)用延時(shí)時(shí)間代替開(kāi)鎖時(shí)間。這樣表面能跑但延時(shí)期間按鍵響應(yīng)、屏幕刷新、串口接收全部卡住。如果視覺(jué)模塊這時(shí)候發(fā)來(lái)新的結(jié)果主控也沒(méi)有及時(shí)處理協(xié)議緩沖可能被覆蓋。這就是我強(qiáng)調(diào)“狀態(tài)機(jī)”的原因。STM32 的主循環(huán)應(yīng)該不斷查詢當(dāng)前狀態(tài)根據(jù)事件跳轉(zhuǎn)而不是在某個(gè)邏輯里死等。1.3 源碼和原理圖配套出現(xiàn)才是最完整的參考設(shè)計(jì)單獨(dú)給一段源碼你很難在自己的板子上復(fù)現(xiàn)。硬件的引腳映射、供電方式、電平轉(zhuǎn)換、負(fù)載驅(qū)動(dòng)都可能是黑盒。單獨(dú)給一張?jiān)韴D你雖然能畫出板子卻不知道程序該怎么初始化外設(shè)、怎么按協(xié)議通信。所以“源碼 原理圖”才是這份開(kāi)源資料最有價(jià)值的地方。源碼告訴你“主控怎么想”原理圖告訴你“硬件怎么連”。你在閱讀任何一個(gè)功能點(diǎn)的時(shí)候都應(yīng)該同時(shí)翻開(kāi)這兩個(gè)文件。例如看到代碼里初始化了USART1就去原理圖找USART1_TX和USART1_RX接到了哪個(gè)器件看到代碼里把某個(gè) GPIO 拉高來(lái)控制繼電器就去原理圖看這個(gè) GPIO 經(jīng)過(guò)了什么驅(qū)動(dòng)電路。這樣對(duì)照著看才能避免“代碼能編譯板子不工作”的尷尬。2. 源碼和原理圖到手后別急著編譯先按四條線拆2.1 打開(kāi)工程先找輸入、處理、輸出三條線拿到源碼工程后我一般不會(huì)先點(diǎn)編譯按鈕而是先在工程目錄里找入口。KEIL 工程里通常是main.cSTM32CubeIDE 工程里通常是一個(gè)帶main函數(shù)的源文件。找到入口后不要試圖從頭到尾逐行讀而是先把代碼分成三條線輸入線處理按鍵、傳感器、視覺(jué)模塊返回的串口數(shù)據(jù)。處理線主循環(huán)里的狀態(tài)判斷、識(shí)別結(jié)果解析、執(zhí)行策略。輸出線控制 GPIO、PWM、屏幕顯示、蜂鳴器、繼電器和鎖具。打開(kāi)main函數(shù)后可以先看外設(shè)初始化。初始化代碼會(huì)告訴你作者用了哪幾個(gè)串口、哪幾個(gè)定時(shí)器、哪幾個(gè) GPIO 引腳。然后在主循環(huán)里找到狀態(tài)機(jī)變量看它有哪些狀態(tài)狀態(tài)之間通過(guò)什么條件跳轉(zhuǎn)。最后再去找串口接收函數(shù)確認(rèn)視覺(jué)模塊的數(shù)據(jù)從哪個(gè)入口進(jìn)來(lái)。如果資料里帶 README先讀 README確認(rèn)主控型號(hào)、視覺(jué)模塊型號(hào)、開(kāi)發(fā)環(huán)境版本和接線表。如果資料沒(méi)有 README也不要著急往往原理圖上的絲印和芯片型號(hào)已經(jīng)把關(guān)鍵信息寫清楚了。2.2 原理圖先看電源再看接口最后看最小系統(tǒng)很多人打開(kāi)原理圖后習(xí)慣先找 STM32 芯片然后盯著引腳看半天這是低效的。一張門禁系統(tǒng)原理圖最優(yōu)先讀的是電源網(wǎng)絡(luò)。我建議按這個(gè)順序讀看電源從哪里輸入是 USB 5V還是 DC 座 12V還是鋰電池接口。找穩(wěn)壓芯片。常見(jiàn)的線性穩(wěn)壓器件會(huì)把外部電壓降到 5V 或 3.3V給 STM32、攝像頭模塊、顯示屏供電?？吹鼐€是否分成模擬地、數(shù)字地、功率地。找主控最小系統(tǒng)晶振、復(fù)位電路、BOOT 引腳、SWD 下載接口。找對(duì)外接口視覺(jué)模塊接口、顯示屏接口、按鍵接口、舵機(jī)或電磁鎖接口。再對(duì)照檢查有沒(méi)有電平轉(zhuǎn)換電路或驅(qū)動(dòng)電路。很多入門者喜歡在面包板上照著原理圖連線但要注意原理圖里的電源網(wǎng)絡(luò)是完整的面包板上如果不同模塊共用一個(gè) 3.3V 穩(wěn)壓器可能會(huì)在鎖具或舵機(jī)動(dòng)作瞬間發(fā)生電壓跌落。2.3 程序結(jié)構(gòu)要和硬件引腳圖對(duì)照確認(rèn)不要想當(dāng)然源碼是作者在自己的板子上驗(yàn)證過(guò)的但如果你手里的板子和源工程不是完全一致就需要特別謹(jǐn)慎。舉一個(gè)常見(jiàn)例子原理圖上把舵機(jī) PWM 輸出放在PA8但源碼里初始化的卻是PB1。這時(shí)候你如果直接編譯燒寫舵機(jī)不會(huì)有反應(yīng)。如果不看原理圖你可能花很長(zhǎng)時(shí)間排查舵機(jī)本身甚至懷疑是 PWM 頻率不對(duì)。正確做法是先確認(rèn)當(dāng)前硬件實(shí)際連接再?zèng)Q定是改代碼還是改接線。同樣串口的 RX/TX 也容易錯(cuò)位。STM32 的PA9是USART1_TXPA10是USART1_RX但視覺(jué)模塊那一端的 TX 要接 STM32 的 RXRX 要接 STM32 的 TX。如果兩條線剛好對(duì)調(diào)STM32 收不到任何數(shù)據(jù)屏幕就會(huì)一直停留在“等待識(shí)別”。2.4 開(kāi)發(fā)環(huán)境和芯片型號(hào)要先對(duì)齊這種開(kāi)源工程的源碼不能保證在所有環(huán)境下都能直接編譯。打開(kāi)工程前要確認(rèn)工程使用的芯片型號(hào)。比如是STM32F103C8T6還是STM32F407ZGT6不同型號(hào)的外設(shè)資源和啟動(dòng)文件不同。如果使用 KEIL需要確認(rèn)是否已經(jīng)安裝了對(duì)應(yīng)的 Device Family Pack。如果缺少芯片包雙擊工程文件后會(huì)提示找不到 Device。下載對(duì)應(yīng)系列的 Pack 后重新打開(kāi)一般就能解決。如果使用 STM32CubeIDE則需要在工程屬性里確認(rèn)調(diào)試器型號(hào)和下載設(shè)置。時(shí)鐘配置也容易忽略。如果源碼是按外部 8MHz 晶振配置系統(tǒng)時(shí)鐘但你手里的板子用的是 12MHz 晶振系統(tǒng)可能無(wú)法啟動(dòng)或串口波特率會(huì)偏移。這時(shí)去原理圖確認(rèn)晶振頻率回到代碼里修改對(duì)應(yīng)的時(shí)鐘樹(shù)配置才能保證外設(shè)時(shí)序正常。3. 聯(lián)調(diào)時(shí)真正麻煩的是串口、驅(qū)動(dòng)和供電這三件事3.1 視覺(jué)模塊到 STM32先解決串口協(xié)議再談識(shí)別效果視覺(jué)模塊識(shí)別到結(jié)果后需要把結(jié)果發(fā)送給 STM32。最常見(jiàn)的通信接口是 UART 串口少數(shù)方案會(huì)用 SPI 或 I2C。如果主控和視覺(jué)模塊都是 3.3V 電平串口直連最方便如果視覺(jué)模塊是 5V 電平則要注意 STM32 引腳是否兼容必要時(shí)加電平轉(zhuǎn)換或分壓電阻。串口數(shù)據(jù)解析是第一個(gè)大坑。很多視覺(jué)模塊的識(shí)別結(jié)果并不是一行人類可讀的字符串而是一幀固定格式的二進(jìn)制數(shù)據(jù)可能包含幀頭、長(zhǎng)度、識(shí)別標(biāo)簽、置信度、邊界框坐標(biāo)和校驗(yàn)值。STM32 端需要按這個(gè)格式逐字節(jié)解析。最容易出問(wèn)題的不是幀頭判斷而是“半包”和“粘包”。串口每次實(shí)際收到的可能不是一個(gè)完整的數(shù)據(jù)幀而是半幀下一批字節(jié)到達(dá)時(shí)又可能把兩幀數(shù)據(jù)拼在一起。初學(xué)者如果只判斷if (buf[0] 0x55 buf[1] 0xAA)就開(kāi)始處理數(shù)據(jù)很容易在數(shù)據(jù)不完整時(shí)越界讀取或在粘包時(shí)錯(cuò)誤解析。我的建議是在串口接收中斷里只做“把字節(jié)保存到緩沖區(qū)”這件事不要做復(fù)雜的數(shù)據(jù)處理。在主循環(huán)中用一個(gè)狀態(tài)機(jī)逐字節(jié)查找?guī)^再按照長(zhǎng)度字段判斷完整幀是否到達(dá)最后做校驗(yàn)。下面是一個(gè)通用解析思路示例不代表該開(kāi)源工程源碼// 示意在主循環(huán)中逐字節(jié)解析 uint8_t frame[16]; uint8_t frame_len 0; uint8_t expect_len 0; void process_byte(uint8_t byte) { static uint8_t state 0; switch (state) { case 0: // 找?guī)^ if (byte 0x55) { frame[0] byte; state 1; } break; case 1: if (byte 0xAA) { frame[1] byte; state 2; } else { state 0; // 幀頭錯(cuò)誤重新來(lái) } break; case 2: frame_len byte; frame[2] byte; expect_len frame_len; state 3; break; default: // 按長(zhǎng)度收滿整幀后再校驗(yàn)和解析 break; } }這不是可以直接使用的代碼只是用來(lái)表達(dá)“接收緩沖區(qū) 幀解析狀態(tài)機(jī)”的思路。如果原工程已經(jīng)有了類似邏輯先確認(rèn)它是否正確處理了半包和粘包如果原工程沒(méi)有你可以自己補(bǔ)上。3.2 控制門鎖不能把鎖具直接接到 GPIO門鎖執(zhí)行部分是最需要安全意識(shí)的地方。電磁鎖、電插鎖、舵機(jī)都不是普通 LED不能直接掛在 STM32 的 GPIO 上。STM32 引腳能提供的電流非常有限電壓也只有 3.3V根本推不動(dòng)大電流器件。在原理圖里通常會(huì)看到 MOS 管、三極管、光耦或繼電器模塊。它們的作用是把 STM32 的低壓控制信號(hào)轉(zhuǎn)換成鎖具需要的開(kāi)關(guān)動(dòng)作。如果你拿到的是沒(méi)有驅(qū)動(dòng)電路的裸板一定不能拿杜邦線把鎖具接到單片機(jī)引腳上。幾個(gè)關(guān)鍵點(diǎn)確定控制信號(hào)是“高電平有效”還是“低電平有效”。有些繼電器模塊內(nèi)部使用了光耦反向輸入低電平時(shí)繼電器才會(huì)動(dòng)作。不要只看代碼里寫GPIO_SetBits就以為是開(kāi)鎖。驅(qū)動(dòng)繼電器線圈時(shí)要并聯(lián)續(xù)流二極管否則斷電瞬間會(huì)產(chǎn)生反向電動(dòng)勢(shì)可能損壞 MOS 管或干擾主控。如果驅(qū)動(dòng)舵機(jī)通常要使用定時(shí)器輸出 PWM。舵機(jī)信號(hào)周期一般是 20ms高電平脈寬 1ms 到 2ms 對(duì)應(yīng)不同角度。不要在主循環(huán)里用delay方式現(xiàn)場(chǎng)拉高拉低模擬 PWM那樣會(huì)讓系統(tǒng)卡死。鎖具動(dòng)作要設(shè)置時(shí)間上限。比如開(kāi)鎖指令觸發(fā)后持續(xù) 1 到 2 秒就自動(dòng)撤銷而不是一直輸出高電平。長(zhǎng)期通電會(huì)讓電磁鎖發(fā)熱也可能帶來(lái)安全隱患。建議先不接鎖具用一個(gè) LED 代替開(kāi)鎖輸出。確認(rèn)程序狀態(tài)機(jī)正確后再接入真實(shí)驅(qū)動(dòng)板和鎖具。這樣一旦出問(wèn)題不會(huì)燒壞昂貴外設(shè)也更容易定位。3.3 系統(tǒng)跑飛、復(fù)位、花屏優(yōu)先級(jí)最高的懷疑對(duì)象是供電在類似項(xiàng)目中我見(jiàn)過(guò)很多“代碼明明沒(méi)問(wèn)題但就是不能穩(wěn)定工作”的情況。最典型的場(chǎng)景是屏幕顯示識(shí)別到口罩舵機(jī)剛開(kāi)始轉(zhuǎn)動(dòng)STM32 就復(fù)位重啟了。原因往往不是哪一行代碼寫錯(cuò)而是供電撐不住。一個(gè)門禁系統(tǒng)里有多種電壓和電流需求STM32 需要 3.3V攝像頭模塊可能需要 3.3V 或 5V舵機(jī)可能需要 5V 或 6V電磁鎖可能需要 12V。如果全部從一個(gè) USB 口的 5V 取電當(dāng)鎖具啟動(dòng)或舵機(jī)堵轉(zhuǎn)時(shí)電流會(huì)瞬間增大電源電壓被拉低ST Link 或主控上的穩(wěn)壓器進(jìn)入欠壓狀態(tài)單片機(jī)自然復(fù)位。處理方法是分層供電主控和邏輯部分用獨(dú)立的 3.3V 穩(wěn)壓供電。視覺(jué)模塊單獨(dú)供電優(yōu)先使用模塊推薦的電壓范圍。舵機(jī)或鎖具使用更高電壓的獨(dú)立電源。所有模塊的地線要可靠共地否則串口信號(hào)沒(méi)有統(tǒng)一參考點(diǎn)通信會(huì)不穩(wěn)定。如果暫時(shí)沒(méi)有多路電源至少要在鎖具電源輸入端加大容量電容并且讓功率地線與信號(hào)地線盡量分開(kāi)走。不要用幾十厘米長(zhǎng)的細(xì)杜邦線同時(shí)給鎖具和主控供電。3.4 識(shí)別卡頓或者超時(shí)也要檢查觸發(fā)和復(fù)位策略口罩識(shí)別門禁不是一直不停地識(shí)別。如果視覺(jué)模塊以每秒幾幀的速度持續(xù)輸出結(jié)果主控在沒(méi)有人員觸發(fā)時(shí)也頻繁處理數(shù)據(jù)會(huì)造成不必要的功耗和屏幕閃爍。通常系統(tǒng)會(huì)有一個(gè)觸發(fā)方式人體感應(yīng)模塊、按鍵觸發(fā)或視覺(jué)模塊檢測(cè)到人臉后再開(kāi)始完整識(shí)別。如果項(xiàng)目里沒(méi)有觸發(fā)機(jī)制也可以靠狀態(tài)機(jī)在“待機(jī)態(tài)”丟棄無(wú)效識(shí)別結(jié)果只保留連續(xù)多次出現(xiàn)同一結(jié)果后再進(jìn)入動(dòng)作判斷。這樣可以避免單人路過(guò)時(shí)系統(tǒng)因?yàn)橐粌蓭`檢就開(kāi)門。另一個(gè)容易被忽略的問(wèn)題是超時(shí)復(fù)位。如果視覺(jué)模塊和主控之間的連線松動(dòng)主控會(huì)一直等待串口數(shù)據(jù)看起來(lái)像“死機(jī)”了。更好的做法是給識(shí)別等待過(guò)程加超時(shí)比如 3 秒內(nèi)沒(méi)有收到有效結(jié)果就自動(dòng)回到待機(jī)狀態(tài)并在屏幕上顯示“未檢測(cè)到模塊”。4. 從“能開(kāi)門”到“能長(zhǎng)期用”還差幾塊關(guān)鍵拼圖4.1 要分清實(shí)驗(yàn)演示和真實(shí)門禁的差別把一塊開(kāi)發(fā)板放在實(shí)驗(yàn)桌上接上舵機(jī)和紙板門識(shí)別到口罩就開(kāi)鎖這在課程設(shè)計(jì)里已經(jīng)很完整。但如果要把它放到實(shí)驗(yàn)室門口或者辦公室實(shí)際使用考慮的問(wèn)題會(huì)完全不同。實(shí)驗(yàn)演示只需要單次動(dòng)作能觸發(fā)真實(shí)門禁需要應(yīng)對(duì)連續(xù)多人進(jìn)出、環(huán)境光線變化、人員逆光、戴帽子、口罩遮擋程度不同等復(fù)雜情況。視覺(jué)模塊的識(shí)別閾值要重新校準(zhǔn)不能只看代碼里的默認(rèn)值。真實(shí)門禁還需要考慮斷電恢復(fù)。如果系統(tǒng)在開(kāi)門過(guò)程中斷電重新上電后應(yīng)該回到什么狀態(tài)如果是電磁鎖默認(rèn)應(yīng)該保持閉鎖還是釋放取決于具體門禁安全策略。這些不是能在代碼里憑空拍板的需要結(jié)合現(xiàn)場(chǎng)管理規(guī)則和門體類型。作為開(kāi)發(fā)者至少要做到上電初始化時(shí)不要把 GPIO 誤設(shè)為開(kāi)鎖狀態(tài)否則可能一上電就開(kāi)門。4.2 可靠性設(shè)計(jì)看門狗、狀態(tài)超時(shí)、防重入如果只是自己學(xué)習(xí)主循環(huán)跑死了大不了按復(fù)位鍵。但作為門禁系統(tǒng)長(zhǎng)時(shí)間無(wú)人值守必須考慮程序跑飛的情況。默認(rèn)應(yīng)該補(bǔ)三件事獨(dú)立看門狗。如果主循環(huán)卡死在某個(gè)阻塞等待里看門狗會(huì)產(chǎn)生復(fù)位讓系統(tǒng)重新初始化。要注意喂狗位置不能放在長(zhǎng)時(shí)間阻塞的流程里否則看門狗起不到作用。狀態(tài)超時(shí)。每個(gè)需要等待外部事件的環(huán)節(jié)都要有超時(shí)上限。比如等待視覺(jué)模塊數(shù)據(jù)如果 3 秒沒(méi)有收到完整幀就報(bào)錯(cuò)并回到待機(jī)而不是一直卡在接收狀態(tài)。防重入。開(kāi)鎖成功后要加冷卻時(shí)間比如 5 秒內(nèi)忽略新的開(kāi)鎖指令避免同一個(gè)人員站在門口反復(fù)觸發(fā)舵機(jī)動(dòng)作。在代碼層面盡量避免在狀態(tài)機(jī)里使用長(zhǎng)延時(shí)。如果功能需要時(shí)間控制可以結(jié)合定時(shí)器中斷做計(jì)時(shí)標(biāo)志或使用非阻塞的HAL_GetTick()查詢。比如if (HAL_GetTick() - open_tick OPEN_TIME_MS) { lock_off(); state IDLE; }這樣就不會(huì)阻塞按鍵掃描和屏幕刷新。4.3 數(shù)據(jù)與隱私邊界從課程設(shè)計(jì)就要注意口罩識(shí)別門禁涉及人臉圖像很多開(kāi)源源碼只在本地做推理這是比較穩(wěn)妥的做法。如果要把圖像上傳到云端除非有明確需求和安全鏈路否則我個(gè)人不建議在門禁場(chǎng)景里做。即使本地處理也可能在日志里保存圖片或裁剪出的人臉區(qū)域。對(duì)這些數(shù)據(jù)要有生命周期管理不能用完就堆在 SD 卡里。更合理的做法是只保存“時(shí)間、是否佩戴口罩、事件結(jié)果”這類文本日志不保存原始圖像。如果確實(shí)需要保存圖像用于事后追溯也要定期清理并限制訪問(wèn)權(quán)限。開(kāi)源項(xiàng)目用于學(xué)習(xí)沒(méi)有問(wèn)題但如果要部署在公共環(huán)境中需要先取得相應(yīng)授權(quán)并遵守學(xué)校或單位的隱私管理要求。把門禁系統(tǒng)當(dāng)成技術(shù)實(shí)驗(yàn)來(lái)寫安全邊界要清楚。4.4 增量改造從硬件到軟件的模塊化拆法很多人拿到別人的開(kāi)源項(xiàng)目后第一反應(yīng)是想換掉其中的某個(gè)模塊比如把視覺(jué)模塊換成更高分辨率的或者把舵機(jī)換成電磁鎖。這時(shí)候最容易出事。我建議的改造順序是保持原版硬件和軟件能完整運(yùn)行。把源碼里的協(xié)議解析做成一個(gè)獨(dú)立的模塊輸入是串口數(shù)據(jù)輸出是“口罩正常”或“口罩異?！钡某橄蠼Y(jié)果。把控制執(zhí)行做成另一個(gè)獨(dú)立模塊輸入是開(kāi)門指令輸出是繼電器或 PWM 動(dòng)作。更換視覺(jué)模塊時(shí)只改協(xié)議解析層不改狀態(tài)機(jī)和控制層。更換鎖具時(shí)只改執(zhí)行驅(qū)動(dòng)函數(shù)不改識(shí)別解析邏輯。這樣改造的好處是每次只改一個(gè)變量出問(wèn)題時(shí)可以快速定位。如果不分層所有邏輯都寫在main里換一個(gè)攝像頭模塊可能要把整個(gè)工程重寫一遍。5. 一張排查清單從現(xiàn)象到根因少走三小時(shí)彎路5.1 先別看模型按“從現(xiàn)象到模塊”的順序排查當(dāng)門禁系統(tǒng)出問(wèn)題時(shí)很多人的第一反應(yīng)是去調(diào)模型閾值或改識(shí)別算法。但問(wèn)題是如果主控根本沒(méi)收到視覺(jué)模塊的數(shù)據(jù)你再怎么調(diào)算法閾值也沒(méi)用。這里我可以給出一張通用排查清單現(xiàn)象優(yōu)先檢查位置常見(jiàn)原因上電后完全沒(méi)反應(yīng)電源輸入、穩(wěn)壓器、指示燈供電電壓不對(duì)、接線短路、板卡損壞程序下載失敗下載器、SWD 線、BOOT 引腳驅(qū)動(dòng)沒(méi)裝、目標(biāo)芯片選擇錯(cuò)誤、線序錯(cuò)誤OLED 不顯示屏幕供電、I2C/SPI 地址、GPIO 配置地址不一致、引腳被復(fù)用、初始化順序不對(duì)串口收不到識(shí)別結(jié)果RX/TX 接線是否交叉、共地、波特率視覺(jué)模塊沒(méi)有啟動(dòng)、供電不足、模塊故障能識(shí)別但不能開(kāi)鎖控制 GPIO、驅(qū)動(dòng)電路、鎖具電源有效電平判斷錯(cuò)誤、驅(qū)動(dòng)模塊損壞、鎖具電源缺失開(kāi)鎖瞬間復(fù)位電源、繼電器續(xù)流、鎖具驅(qū)動(dòng)電流沖擊導(dǎo)致電壓跌落、驅(qū)動(dòng)無(wú)保護(hù)電路門禁偶爾自己開(kāi)鎖狀態(tài)機(jī)、防重入、串口粘包數(shù)據(jù)幀解析錯(cuò)誤、沒(méi)有冷卻時(shí)間、誤檢觸發(fā)排查順序建議按這個(gè)鏈路來(lái)先看現(xiàn)象——是完全沒(méi)有輸出還是偶發(fā)錯(cuò)誤再看輸入——視覺(jué)模塊到底有沒(méi)有發(fā)數(shù)據(jù)、數(shù)據(jù)格式是否正確再看環(huán)境——供電電壓、地線、干擾最后再改代碼參數(shù)比如閾值、波特率、超時(shí)時(shí)間。如果一開(kāi)始就去改代碼可能改了半天才發(fā)現(xiàn)只是舵機(jī)電源線沒(méi)接好。5.2 做一個(gè)最小復(fù)現(xiàn)實(shí)驗(yàn)繞過(guò)視覺(jué)模塊直接給主控發(fā)已知數(shù)據(jù)這是我最推薦的一種排查方式。它能把“視覺(jué)模塊的問(wèn)題”和“主控的問(wèn)題”徹底分開(kāi)。具體做法是把 STM32 的串口 RX 線從視覺(jué)模塊上斷開(kāi)用 USB 轉(zhuǎn) TTL 模塊連接電腦通過(guò)串口助手按照源碼里的協(xié)議格式手動(dòng)發(fā)送一幀“口罩正?！钡臄?shù)據(jù)給 STM32。如果這時(shí)候門鎖正常動(dòng)作說(shuō)明主控端的串口解析、狀態(tài)機(jī)、控制驅(qū)動(dòng)是通的問(wèn)題大概率出在視覺(jué)模塊、模塊供電或視覺(jué)模塊和 STM32 之間的接線。如果發(fā)送已知數(shù)據(jù)后門鎖仍然不動(dòng)說(shuō)明主控端代碼有問(wèn)題可以再縮小范圍先把控制輸出的 GPIO 直接手動(dòng)拉高看鎖具有沒(méi)有反應(yīng)。如果 GPIO 拉高后鎖具動(dòng)了問(wèn)題在狀態(tài)機(jī)或串口解析如果 GPIO 拉高后鎖具還是不動(dòng)問(wèn)題在驅(qū)動(dòng)電路或鎖具電源。這種“逐級(jí)縮小”的方法比反復(fù)修改代碼要快得多。5.3 從開(kāi)源工程到自己的項(xiàng)目最穩(wěn)的方法是“先復(fù)現(xiàn)再改動(dòng)”最后給一個(gè)落地建議不要一上來(lái)就把工程大卸八塊改成自己的想法。先把原始工程完整地編譯、燒寫、跑通一次。即使你覺(jué)得某個(gè)模塊設(shè)計(jì)得不夠好也先尊重原作者的連線關(guān)系和工程結(jié)構(gòu)。跑通后在原始工程基礎(chǔ)上做一次小改動(dòng)比如把開(kāi)鎖指示燈換一個(gè) GPIO或者把串口波特率從 115200 改成 9600驗(yàn)證你理解的外設(shè)初始化是否和實(shí)際現(xiàn)象一致。小改動(dòng)驗(yàn)證成功以后再去做模塊替換和功能增強(qiáng)。這個(gè)流程聽(tīng)起來(lái)慢實(shí)際上最省時(shí)間。因?yàn)槊恳浑A段你都知道問(wèn)題出在哪里。相反如果第一天就把攝像頭模塊換掉第二天又改了主控芯片第三天把舵機(jī)換成了電磁鎖最后出問(wèn)題時(shí)你會(huì)發(fā)現(xiàn)電源、通信、控制、算法全部混在一起根本無(wú)從排查。對(duì)一份開(kāi)源資料最好的使用方式不是把它當(dāng)成最終成品而是把它當(dāng)成一個(gè)你已經(jīng)讀懂的參考基線。源代碼可以改原理圖可以改但你心里的架構(gòu)不能亂。把“感知—判斷—執(zhí)行”這條鏈路理清楚把串口、供電、驅(qū)動(dòng)和狀態(tài)機(jī)這幾件事調(diào)穩(wěn)口罩識(shí)別門禁系統(tǒng)的真正難點(diǎn)也就解決了大半。