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