這次我們來看一個基于 STM32L432KC 微控制器的簡易超聲波測距裝置。這個項目的核心不是復(fù)雜的算法而是如何用一塊低成本、低功耗的 MCU 和常見的 HC-SR04 超聲波模塊快速搭建一個可用的測距系統(tǒng)。對于嵌入式初學(xué)者、電子愛好者或需要快速驗(yàn)證測距功能的開發(fā)者來說這是一個非常直接的實(shí)踐案例。本文將帶你從零開始理解超聲波測距原理完成 STM32L432KC 的硬件連接、軟件編程并最終實(shí)現(xiàn)一個能夠穩(wěn)定測量距離并在串口顯示結(jié)果的裝置。整個過程重點(diǎn)關(guān)注代碼的可讀性、測量的穩(wěn)定性以及如何在實(shí)際環(huán)境中進(jìn)行校準(zhǔn)和優(yōu)化。如果你手頭有 STM32 開發(fā)板和 HC-SR04 模塊跟著做一遍就能跑通。1. 核心能力速覽能力項說明核心控制器STM32L432KC (ARM Cortex-M4 低功耗)測距模塊HC-SR04 超聲波傳感器測距原理測量超聲波發(fā)射到接收回波的時間差根據(jù)聲速計算距離有效測距范圍通常為 2cm ~ 400cm (實(shí)際效果受環(huán)境、模塊精度影響)輸出方式通過 USART 串口輸出距離數(shù)據(jù)到 PC 端串口助手供電需求3.3V 或 5V (STM32開發(fā)板供電注意HC-SR04邏輯電平)開發(fā)環(huán)境STM32CubeIDE / Keil MDK關(guān)鍵外設(shè)GPIO (輸出觸發(fā)、輸入捕獲)、定時器 (高精度計時)、USART (通信)適合場景嵌入式學(xué)習(xí)、課程設(shè)計、避障小車原型、簡單物體檢測2. 適用場景與使用邊界這個簡易超聲波測距裝置最適合以下幾類人群和場景嵌入式初學(xué)者通過一個完整的“傳感器-控制器-輸出”項目學(xué)習(xí) STM32 的 GPIO、定時器、中斷和串口編程。快速原型驗(yàn)證在開發(fā)機(jī)器人、智能小車或安防設(shè)備初期需要快速驗(yàn)證測距功能是否可行。電子課程設(shè)計或畢業(yè)設(shè)計作為一個功能明確、硬件成本低、代碼量適中的選題。它的能力邊界也很清晰精度有限HC-SR04 模塊本身精度通常在毫米到厘米級且聲速受溫度、濕度影響。不適合需要亞毫米級高精度測量的場合。測量對象對平坦、堅硬的表面反射效果最好。對棉花、泡沫等吸音材料或角度過大的斜面可能無法測距或誤差極大。環(huán)境干擾多個超聲波模塊同時工作可能互相干擾。嘈雜的聲學(xué)環(huán)境也可能影響測量。非接觸式只能測量傳感器正前方障礙物的距離無法識別物體材質(zhì)、形狀。重要提醒本項目用于學(xué)習(xí)和功能驗(yàn)證。若用于實(shí)際產(chǎn)品需考慮更專業(yè)的傳感器、溫度補(bǔ)償算法以及嚴(yán)格的電磁兼容和安全設(shè)計。3. 環(huán)境準(zhǔn)備與前置條件在開始編程和接線之前請確保你已準(zhǔn)備好以下軟硬件環(huán)境。硬件清單STM32L432KC 開發(fā)板一塊如 NUCLEO-L432KC。HC-SR04 超聲波模塊一個。杜邦線若干母對母、公對母根據(jù)開發(fā)板接口而定。USB 數(shù)據(jù)線一根用于給開發(fā)板供電和程序下載/調(diào)試。PC 電腦一臺。(可選) 邏輯電平轉(zhuǎn)換模塊如果開發(fā)板只有3.3V電平而你的HC-SR04是5V邏輯版本則需要一個5V轉(zhuǎn)3.3V的電平轉(zhuǎn)換器用于Echo回波信號線。軟件清單集成開發(fā)環(huán)境 (IDE)STM32CubeIDE 或 Keil MDK (uVision)。本文以 STM32CubeIDE 為例因?yàn)樗闪薙TM32CubeMX圖形化配置工具對新手更友好。串口調(diào)試助手如 Putty、SecureCRT、或者 IDE 自帶的串口終端。用于查看測距結(jié)果。STM32CubeProgrammer用于程序燒錄STM32CubeIDE 已集成燒錄功能可備用。4. 硬件連接與電路原理HC-SR04 模塊通常有 4 個引腳VCC、Trig (觸發(fā))、Echo (回波)、GND。連接示意圖如下HC-SR04 STM32L432KC NUCLEO 板 VCC ----------- 5V 或 3.3V 引腳 (注意模塊電壓) Trig ----------- 任意 GPIO 輸出引腳 (如 PA5) Echo ----------- 任意 GPIO 輸入引腳 (如 PA6) GND ----------- GND關(guān)鍵連接說明VCC 與 GND為模塊供電。務(wù)必確認(rèn)你的 HC-SR04 模塊的工作電壓。老版本多為5V新版本有3.3V/5V兼容的。如果是5V模塊接到開發(fā)板的5V引腳如果是3.3V模塊接到3.3V引腳。NUCLEO-L432KC 板上有標(biāo)注的 5V (VIN) 和 3.3V (3V3) 輸出。Trig (觸發(fā))連接到一個配置為推挽輸出的 GPIO 引腳。STM32 通過向此引腳發(fā)送一個至少 10us 的高電平脈沖來觸發(fā)模塊發(fā)射超聲波。Echo (回波)連接到一個配置為浮空輸入或上拉輸入的 GPIO 引腳。該引腳在模塊接收到回波后會輸出一個高電平脈沖其寬度與距離成正比。這是最需要注意的地方如果 HC-SR04 是 5V 邏輯輸出而 STM32L432KC 的 GPIO 引腳只能容忍 3.3V則必須通過電平轉(zhuǎn)換電路如分壓電阻或電平轉(zhuǎn)換芯片將 5V 降至 3.3V 后再接入 PA6否則可能損壞 MCU如果是 3.3V 邏輯的模塊則可以直接連接。電平轉(zhuǎn)換簡易方案針對5V Echo信號使用兩個電阻組成分壓電路Echo 信號先串聯(lián)一個 1kΩ 電阻然后連接到 STM32 的 GPIO同時在 GPIO 引腳與 GND 之間并聯(lián)一個 2kΩ 電阻。這樣可以將 ~5V 電壓分壓到 ~3.3V。5. STM32CubeMX 工程配置我們使用 STM32CubeMX 進(jìn)行圖形化配置生成初始化代碼框架。創(chuàng)建新工程打開 STM32CubeIDE選擇 “Start new STM32 project”搜索并選擇 MCU 型號 “STM32L432KCUx”。配置系統(tǒng)時鐘 (SYS)在 “Pinout Configuration” 標(biāo)簽頁左側(cè)找到 “System Core” - “SYS”。將 “Debug” 設(shè)置為 “Serial Wire” (這是 ST-LINK 調(diào)試接口所需)。配置時鐘樹 (RCC)找到 “RCC”。將 “High Speed Clock (HSE)” 設(shè)置為 “Crystal/Ceramic Resonator”。如果板載外部高速晶振。進(jìn)入 “Clock Configuration” 標(biāo)簽頁。輸入 HSE 頻率如 8MHz然后通過 PLL 將系統(tǒng)時鐘 (SYSCLK) 配置到最高 80MHz。APB1 和 APB2 總線時鐘也會自動配置。配置 GPIO 引腳在芯片引腳圖上找到你計劃使用的引腳例如 PA5 和 PA6。單擊 PA5選擇 “GPIO_Output”。在左側(cè)的 GPIO 配置中可以設(shè)置用戶標(biāo)簽為 “TRIG”。單擊 PA6選擇 “GPIO_Input”。用戶標(biāo)簽設(shè)置為 “ECHO”。根據(jù)是否需要內(nèi)部上拉在 GPIO 設(shè)置中選擇 “Pull-up” 或 “No pull-up and no pull-down”。配置定時器 (TIM) 用于高精度計時超聲波測距需要微秒級的時間測量。我們將使用一個通用定時器如 TIM2的輸入捕獲功能或者更簡單的方式在代碼中利用定時器的計數(shù)器直接計算時間。這里我們采用定時器中斷計數(shù)器讀取的方式更直觀。找到 “TIM2”或其他空閑的通用定時器。在 “Parameter Settings” 中Prescaler (PSC) 設(shè)置為 80-1。如果系統(tǒng)時鐘是80MHz分頻后計數(shù)器時鐘為 1MHz (1us計數(shù)一次)。Counter Period (ARR) 設(shè)置為 65535-1 (16位定時器的最大值) 或更大值如果定時器是32位。Counter Mode Up。auto-reload preload Disable。在 “NVIC Settings” 中不要使能定時器中斷。我們只用它的計數(shù)器。配置串口 (USART) 用于輸出找到 “USART2”NUCLEO板通常通過 ST-LINK 的虛擬串口連接到 USART2。將 “Mode” 設(shè)置為 “Asynchronous”。在 “Parameter Settings” 中波特率設(shè)置為 115200 Bits/s其他默認(rèn)8位數(shù)據(jù)無校驗(yàn)1停止位。引腳 PA2 和 PA3 會自動配置為 USART_TX 和 USART_RX。生成工程代碼轉(zhuǎn)到 “Project Manager” 標(biāo)簽頁。設(shè)置 “Project Name” 和 “Project Location”?！癟oolchain / IDE” 選擇 “STM32CubeIDE”。點(diǎn)擊 “Generate Code”。6. 核心代碼編寫與解析工程生成后我們主要在main.c和stm32l4xx_it.c如果用到中斷中添加業(yè)務(wù)邏輯。6.1 宏定義與全局變量在main.c的/* USER CODE BEGIN PV */區(qū)域定義引腳和變量。/* USER CODE BEGIN PV */ // 超聲波模塊引腳定義 (根據(jù)你的實(shí)際連接修改) #define TRIG_PIN GPIO_PIN_5 #define TRIG_PORT GPIOA #define ECHO_PIN GPIO_PIN_6 #define ECHO_PORT GPIOA // 聲速定義 (單位厘米/微秒)在20°C干燥空氣中約為 0.0343 cm/us #define SOUND_SPEED_CM_US 0.0343 // 也可以定義為 34300 cm/s然后在計算時轉(zhuǎn)換時間單位 volatile uint32_t pulse_start 0; volatile uint32_t pulse_end 0; volatile uint8_t echo_received 0; float distance_cm 0; /* USER CODE END PV */6.2 超聲波觸發(fā)與回波捕獲函數(shù)在/* USER CODE BEGIN 0 */區(qū)域編寫驅(qū)動函數(shù)。/* USER CODE BEGIN 0 */ #include stdio.h // 用于 printf // 微秒級延時函數(shù)簡易實(shí)現(xiàn)精度受系統(tǒng)時鐘和優(yōu)化影響用于觸發(fā)脈沖 void Delay_us(uint16_t us) { uint32_t ticks us * (SystemCoreClock / 1000000) / 5; // 粗略計算循環(huán)次數(shù) while(ticks--) { __NOP(); } } // 發(fā)送觸發(fā)脈沖 void Ultrasonic_Trigger(void) { HAL_GPIO_WritePin(TRIG_PORT, TRIG_PIN, GPIO_PIN_SET); // 拉高 Trig Delay_us(12); // 保持高電平至少10us這里給12us HAL_GPIO_WritePin(TRIG_PORT, TRIG_PIN, GPIO_PIN_RESET); // 拉低 Trig } // 獲取高電平脈沖寬度單位微秒 // 方法輪詢等待 Echo 引腳上升沿和下降沿利用定時器計數(shù)器計算時間差。 uint32_t Get_Pulse_Width_us(void) { uint32_t start_time 0, end_time 0; uint32_t timeout 0; // 等待 Echo 變?yōu)楦唠娖?(上升沿) timeout 100000; // 超時計數(shù)防止死等 while (HAL_GPIO_ReadPin(ECHO_PORT, ECHO_PIN) GPIO_PIN_RESET) { if (timeout-- 0) return 0; // 超時返回0 } start_time __HAL_TIM_GET_COUNTER(htim2); // 記錄定時器當(dāng)前值 // 等待 Echo 變?yōu)榈碗娖?(下降沿) timeout 100000; while (HAL_GPIO_ReadPin(ECHO_PORT, ECHO_PIN) GPIO_PIN_SET) { if (timeout-- 0) return 0; // 超時返回0 } end_time __HAL_TIM_GET_COUNTER(htim2); // 計算時間差 (us)因?yàn)槎〞r器時鐘是1MHz // 注意處理定時器溢出的情況簡單項目可暫不考慮或確保測量距離內(nèi)不會溢出 if (end_time start_time) { return (end_time - start_time); } else { // 計數(shù)器溢出計算溢出后的值 return (0xFFFFFFFF - start_time end_time); // 假設(shè)是32位定時器 } } // 重定向 printf 到串口 (方便打印) int _write(int file, char *ptr, int len) { HAL_UART_Transmit(huart2, (uint8_t*)ptr, len, HAL_MAX_DELAY); return len; } /* USER CODE END 0 */6.3 主循環(huán)邏輯在main()函數(shù)的while (1)循環(huán)中添加測距和打印邏輯。/* USER CODE BEGIN WHILE */ HAL_TIM_Base_Start(htim2); // 啟動定時器2計數(shù)器 printf(Ultrasonic Ranging System Started.\r\n); while (1) { Ultrasonic_Trigger(); // 發(fā)送觸發(fā)脈沖 HAL_Delay(60); // 等待至少60ms防止發(fā)射信號對回波的干擾 uint32_t pulse_width Get_Pulse_Width_us(); // 獲取高電平時間微秒 if (pulse_width 0) { // 計算距離距離 (時間 * 聲速) / 2 // 時間單位是 us聲速是 cm/us除以2是因?yàn)槁曇糇吡藖砘貎杀堵烦?distance_cm (pulse_width * SOUND_SPEED_CM_US) / 2.0; printf(Pulse Width: %lu us, Distance: %.2f cm\r\n, pulse_width, distance_cm); } else { printf(Measurement timeout or error.\r\n); } HAL_Delay(200); // 主循環(huán)延時控制測量頻率 } /* USER CODE END WHILE */7. 功能測試與效果驗(yàn)證編譯與下載在 STM32CubeIDE 中點(diǎn)擊 “Build” 按鈕編譯工程。使用 USB 線連接開發(fā)板點(diǎn)擊 “Debug” 按鈕將程序下載到 MCU 并進(jìn)入調(diào)試模式或直接點(diǎn)擊 “Run” 運(yùn)行。串口監(jiān)視退出調(diào)試模式如果進(jìn)入了。在 IDE 的 “Window” - “Show View” - “Other…” 中搜索 “Serial Monitor” 并打開?；蛘咴陔娔X上打開獨(dú)立的串口調(diào)試助手如 Putty。選擇正確的串口號在設(shè)備管理器中查看 STM32 ST-LINK 虛擬串口的 COM 號。設(shè)置波特率為 115200數(shù)據(jù)位 8停止位 1無校驗(yàn)無流控。連接串口。觀察結(jié)果將超聲波傳感器模塊正面朝向空曠處或一個固定距離的物體如墻壁。觀察串口終端輸出的信息。你應(yīng)該能看到類似以下的輸出Ultrasonic Ranging System Started. Pulse Width: 588 us, Distance: 10.09 cm Pulse Width: 588 us, Distance: 10.09 cm ...改變傳感器與物體之間的距離輸出值應(yīng)相應(yīng)變化。校準(zhǔn)與優(yōu)化基準(zhǔn)測試用一個卷尺測量實(shí)際距離與串口輸出的距離對比。計算誤差。調(diào)整聲速SOUND_SPEED_CM_US常量是基于 20°C 空氣的。如果環(huán)境溫度差異大可以根據(jù)公式V 331.4 0.6 * T(m/s T為攝氏溫度) 重新計算并更新該常量。處理異常值在實(shí)際應(yīng)用中可以連續(xù)測量多次然后取中值或平均值以濾除偶然的干擾脈沖。檢查超時如果總是測量超時檢查 Echo 引腳連接、電平轉(zhuǎn)換是否正確以及Get_Pulse_Width_us函數(shù)中的超時值是否合理。8. 資源占用與性能觀察CPU 占用主循環(huán)中主要的耗時操作是HAL_Delay(200)即每 200ms 測量一次CPU 大部分時間處于空閑或低功耗狀態(tài)。Get_Pulse_Width_us函數(shù)中的輪詢等待會短暫占用 CPU。對于 STM32L432KC 來說負(fù)載極低。定時器資源我們占用了一個通用定時器 (TIM2) 作為高精度時鐘源。它被配置為自由運(yùn)行模式不產(chǎn)生中斷只提供計數(shù)器值。GPIO 資源占用兩個 GPIO 引腳。USART 資源占用一個 USART 用于調(diào)試輸出。內(nèi)存占用代碼量小全局變量少對 RAM 和 Flash 的占用可忽略不計。功耗STM32L432KC 本身是超低功耗 MCUHC-SR04 模塊在非觸發(fā)狀態(tài)下功耗也很低。整個系統(tǒng)非常適合電池供電的便攜設(shè)備。性能提升方向使用定時器的輸入捕獲中斷來測量 Echo 高電平寬度可以更精確且不阻塞 CPU。使用 DMA 傳輸串口數(shù)據(jù)進(jìn)一步降低 CPU 干預(yù)。實(shí)現(xiàn)溫度傳感器 (如 DS18B20) 實(shí)時補(bǔ)償聲速。9. 常見問題與排查方法問題現(xiàn)象可能原因排查方式解決方案串口無任何輸出1. 串口線未連接或端口錯誤。2. 波特率設(shè)置錯誤。3. 代碼未成功運(yùn)行。1. 檢查設(shè)備管理器中的串口號。2. 確認(rèn)串口助手波特率為115200。3. 檢查程序是否下載成功MCU是否復(fù)位。1. 選擇正確的COM口。2. 雙方波特率保持一致。3. 重新下載程序按復(fù)位鍵。串口一直輸出 “Measurement timeout or error.”1. Echo 引腳始終為低電平。2. 觸發(fā)信號未發(fā)出。3. 模塊供電不足或損壞。4. 物體超出測距范圍或表面不反射。1. 用邏輯分析儀或示波器檢查 Trig 和 Echo 信號。2. 用萬用表測量 VCC 和 GND 電壓。3. 將模塊對準(zhǔn)近距離的平整墻壁測試。1. 檢查 Trig/Echo 連線確認(rèn)電平轉(zhuǎn)換電路如果需要。2. 確保供電電壓符合模塊要求5V或3.3V。3. 更換模塊測試。測量距離固定不變或明顯錯誤1. 聲速常量設(shè)置錯誤。2. 定時器分頻系數(shù)計算錯誤導(dǎo)致時間單位不對。3. 測量對象是軟質(zhì)或斜面。1. 用尺子測量一個固定距離如20.0cm對比輸出反推實(shí)際聲速或時間系數(shù)。2. 檢查Get_Pulse_Width_us函數(shù)返回的時間值是否合理。1. 根據(jù)實(shí)測結(jié)果校準(zhǔn)SOUND_SPEED_CM_US或計算時的系數(shù)。2. 檢查定時器時鐘配置確認(rèn)計數(shù)器加1是否代表1us。3. 對硬質(zhì)平面進(jìn)行測量。測量值跳動大不穩(wěn)定1. 環(huán)境噪聲干擾。2. 電源紋波大。3. 軟件中沒有濾波算法。觀察多次測量的原始脈沖寬度值。1. 在軟件中實(shí)現(xiàn)多次測量取中值或平均值濾波。2. 為模塊電源增加濾波電容。3. 避免在嘈雜的聲學(xué)環(huán)境中使用。程序下載失敗1. 調(diào)試器連接問題。2. 芯片被寫保護(hù)。1. 檢查 USB 線、驅(qū)動。2. 查看 IDE 中的調(diào)試配置。1. 重新插拔 USB 線重啟 IDE。2. 使用 STM32CubeProgrammer 連接并解除保護(hù)。10. 最佳實(shí)踐與擴(kuò)展建議最佳實(shí)踐首次上電先不接 Echo 線用示波器或邏輯分析儀觀察 Trig 引腳是否有正確的 10us 以上脈沖。這是確認(rèn) MCU 控制邏輯正確的第一步。電平安全始終將“5V Echo 信號連接至 3.3V MCU”作為重點(diǎn)檢查項務(wù)必使用電平轉(zhuǎn)換或分壓電路。電源去耦在 HC-SR04 的 VCC 和 GND 引腳附近并聯(lián)一個 10uF 電解電容和一個 0.1uF 陶瓷電容以穩(wěn)定電源減少干擾。軟件濾波在產(chǎn)品代碼中務(wù)必實(shí)現(xiàn)軟件濾波。例如連續(xù)采樣 5 次去掉最大最小值后求平均能極大提升讀數(shù)穩(wěn)定性。錯誤處理增加對超長回波超出量程、超短回波低于最小測距的判斷和處理。擴(kuò)展建議增加顯示將距離值顯示在 LCD 屏如 OLED或數(shù)碼管上做成一個獨(dú)立的測距儀。報警功能設(shè)置一個距離閾值當(dāng)測量值低于該閾值時讓一個 LED 閃爍或蜂鳴器鳴叫實(shí)現(xiàn)簡易報警器。多傳感器使用多個超聲波模塊通過 GPIO 分時復(fù)用或不同的定時器通道實(shí)現(xiàn)多方向測距用于機(jī)器人環(huán)境感知。無線傳輸通過藍(lán)牙模塊 (如 HC-05) 或 WiFi 模塊 (如 ESP8266) 將距離數(shù)據(jù)發(fā)送到手機(jī)或云端。低功耗優(yōu)化利用 STM32L4 的低功耗模式讓 MCU 在兩次測量之間進(jìn)入 Sleep 或 Stop 模式HC-SR04 模塊也只在測量時上電大幅延長電池壽命。這個基于 STM32L432KC 的超聲波測距項目麻雀雖小五臟俱全。它串聯(lián)了 GPIO 控制、定時器計時、串口通信等嵌入式核心知識點(diǎn)。通過動手實(shí)現(xiàn)它你不僅能得到一個可工作的測距工具更能透徹理解傳感器與控制器的交互方式。建議在成功實(shí)現(xiàn)基礎(chǔ)功能后嘗試上述一兩個擴(kuò)展功能這對提升工程能力非常有幫助。