STM32 C++实战：超声波测距+LCD+USB虚拟串口系统整合-北京尧图网络

哟哟哟咱们还差活滴——看到这个标题别笑这是我写完上一期之后最真实的内心活动。前面几期我们拿着 STM32 和 C 把点灯、按键扫描、串口回显这些基础模块都过了一遍但心里一直不踏实独立 demo 能跑不等于能把它们捏成一个完整的小系统。C 的封装、回调、状态机这些好东西还停留在“教程代码”阶段没有真正在外设之间形成数据流。更别说调试过程中那些耗掉半宿的奇葩问题不写下来过几天连自己都忘。所以这一期不干别的就是把欠下的“活儿”补上。我会拿一个超声波测距 ILI9341 液晶显示 USB 虚拟串口上报的小项目把散件拼成系统顺带把定时器输入捕获、USB 设备枚举、读屏 ID 这类实战硬坑逐个拆开讲。适合已经玩过 STM32 基础外设、懂一点 C、想从“点灯侠”往工程化固件方向走一步的人。1. 还差活差的是把模块捏成系统的活儿1.1 为什么独立 Demo 不能叫项目很多刚入门的同学都会经历这个阶段点灯 demo 跑通了按键中断也能进串口能打印 “Hello”就觉得嵌入式差不多了。但一旦你尝试把三个模块放在同一个工程里问题马上冒出来——全局变量满天飞中断回调里到处改标志位轮询逻辑和中断处理互相抢资源改一个模块还要担心把另一个模块的初始化顺序搞坏。这不是代码写错了而是缺少“系统边界”。真正的嵌入式项目第一步不是写功能而是先划分谁产生数据、谁消费数据、谁负责传输。比如我们这次要做的小系统数据流是单向的超声波传感器测出距离LCD 负责显示USB 虚拟串口把数据发到 PC。三个模块之间不允许互相调用内部变量更不能 A 模块直接去操作 B 模块的引脚。这样设计的好处是任何一个模块出问题可以单独替换成假数据来测试不用动其他代码。这种解耦思维才是“项目”和“demo”之间的分水岭。1.2 C 在单片机上到底该“用到什么程度”一说嵌入式用 C很多人第一反应是虚函数STL异常模板那不是分分钟把 Flash 撑爆我的态度比较务实在 MCU 上用 C重点不是用多高深的语法而是用对几个能直接提升代码质量的小工具——类封装、命名空间、constexpr。类封装解决的是“句柄散落”的问题。裸机 C 语言里你要操作一个定时器得把 TIM_HandleTypeDef、GPIO_TypeDef、捕获标志位分别传来传去用类把这些句柄和变量绑在一起对外只暴露 Trigger()、GetDistanceCm() 这种接口调用方根本不用关心内部怎么实现。命名空间防止不同驱动库的符号冲突。constexpr 则在编译期把延时系数、距离换算因子算好运行时不占 CPU。至于异常、RTTI、重载算子这些我在 Cortex-M 上基本不用——不是不会用而是没必要异常在资源紧张的 MCU 上会引入大量额外代码RTTI 也会让 Flash 体积变大。打个比方C 在单片机上是螺丝刀不是多功能瑞士军刀。你只拿最顺手的几件工具就够了把整把军刀塞进口袋只会增加负担。1.3 模块划分与通信边界这次小项目的模块划分特别简单我先把表拉出来后面所有代码都围绕这张表来写。模块数据方向核心资源关键接口CDistanceSensor产生距离数据TIM 输入捕获 HC-SR04Trigger(), GetDistanceCm()CTftDisplay消费距离数据SPI ILI9341ShowDistance(float cm)CCdcUsb消费并上传数据USB FS CDC 类SendDistance(float cm)模块之间只通过返回值传递数据不共享全局缓冲区。测距模块只管把距离算出来至于这个距离是显示在屏幕上还是发给上位机它一概不知。显示模块和 USB 模块也都只负责自己那一摊事。后面凡是遇到数据不对的问题我只需要检查数据在哪一个边界上“变脏”了不用把整个工程翻一遍。2. 核心模块拆解测距、显示、USB 上报各自怎么设计2.1 超声波测距定时器输入捕获的使用才算真正入门先聊 HC-SR04。这个传感器大家应该不陌生给 Trig 脚一个至少 10us 的高电平模块内部会发出 8 个 40kHz 的超声波脉冲然后把 Echo 脚拉高高电平持续时间就是超声波从发出到碰到障碍物再返回的时间。距离换算公式很简单离cm 时间us÷ 58这个数字怎么来的声速在空气中大约 340m/s也就是 0.0343cm/us。Echo 高电平时间对应的是往返两倍距离所以距离时间 × 0.0343 ÷ 2。把 0.0343 ÷ 2 换成分数大约就是 1/58.3。比如 Echo 高电平持续 1000us距离就是 1000 ÷ 58.3 ≈ 17.2cm。关键是怎么准确测这个高电平时间。很多人用 GPIO 轮询等 Echo 脚拉高再拉低循环读引脚电平——不是不行但在高负载系统里误差很大CPU 也被占死了。正确做法是用定时器输入捕获配置一个通道让它既能捕获上升沿又能捕获下降沿。第一次捕获上升沿记下计数器值然后通过代码把捕获极性切换成下降沿第二次捕获下降沿再记一个计数器值两者之差除以定时器时钟频率就是脉宽。我习惯把定时器时钟配成 1MHz这样计数器每个 tick 正好是 1us连换算都省了。下面是使用 HAL 库时输入捕获中断回调的封装骨架// 输入捕获中断回调放在 extern C 的回调函数里 void ECHO_CaptureCallback(TIM_HandleTypeDef* htim) { if (htim-Instance TIM2) { uint32_t cnt __HAL_TIM_GET_COUNTER(htim); if (capture_edge_ RISING) { start_us_ cnt; __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); capture_edge_ FALLING; } else { duration_us_ (cnt - start_us_) 0xFFFF; // 注意处理16位计数器溢出 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); capture_edge_ RISING; echo_done_ true; } } }这里有两个特别容易踩的坑。第一16位计数器在 1MHz 计数频率下最多数到 65.535msHC-SR04 最长 Echo 脉宽大约 38ms看着够用但如果你系统里还有其他中断频繁抢优先级计数器可能在你还没来得及读的时候就溢出了所以实际项目里要加上溢出中断做扩展计数。第二Trig 脉冲和 Echo 信号之间有时间差发完 Trig 后要等一小会儿再打开捕获否则可能把 Trig 本身的毛刺当成了 Echo。2.2 定时器捕获测频率的技巧输入捕获不仅能测脉宽还能测频率而且原理完全一样。测频率只需要在同一个通道上连续捕获两次上升沿两次计数器值之差就是信号的一个周期频率定时器时钟 ÷ 两次计数差。比如定时器时钟 1MHz两次上升沿计数差是 1000那信号频率就是 1000Hz。这里有个容易被忽视的问题如果信号频率很低两次上升沿间隔超过 65535 个计数16位计数器会溢出你算出来的频率会大得离谱。解决办法有两种一是把定时器分频调大牺牲测量精度来换取量程二是开溢出中断把溢出次数也记进去做 32 位扩展计数。我实战中更喜欢前者因为对大多数低速信号来说测量精度到 1us 已经够用了没必要追求极端。测低速信号还想保持精度那就直接换 32 位定时器比如 STM32F4 的 TIM2 和 TIM5能数到 4.29e9彻底告别溢出焦虑。2.3 ILI9341 的 ID 为什么读出 0xA1A1这个坑我在调试液晶屏时卡了整整一个晚上。现象很典型用 SPI 去读 ILI9341 的芯片 ID返回结果不是 0x9341而是 0xA1A1 这种看起来毫无意义的数字。屏幕能正常显示但读 ID 就是不对。先说结论0xA1A1 绝大多数情况下是“假数据”而不是真正的芯片 ID。造成假数据的原因按概率从高到低排模块的 SDO/MISO 引脚没有接。很多 4 线 SPI 屏幕模块出场时把 MISO 脚省掉了只留了 SCL、MOSI、CS、DC、RST。没有数据回传通道读出来的自然是总线悬空电平往往就是 0xFF 的某个变体0xA1A1 这种看起来有规律的假数据多半就是位线上电平不受控的产物。读时序里没有给足 Dummy 字节。SPI 是全双工协议主机发时钟的同时从机在 MOSI 上采样指令、在 MISO 上输出数据。如果你读命令之后没有继续发时钟MISO 上根本不会有完整的返回数据后面读到的字节就是乱的。模块实际不是 ILI9341。市面上很多屏幕标称 ILI9341实际用的是 ST7789、ILI9488 之类的兼容驱动它们读 ID 的命令和返回值完全不同。这时候你读不到 0x9341 是正常的按实际型号配驱动就行。排查方法也很简单先万用表量一下模块 SDO 引脚有没有焊盘、有没有连到主控。再写一段回环测试让 MCU 在 SPI 上发一个 0x55同时看 MISO 能不能读回 0x55。回环都不通就别纠结读 ID 了说明你的屏幕根本就是“只写屏”直接按 ILI9341 的驱动初始化不要死磕读寄存器。如果回环通了但读 ID 还是怪才需要去查时序和 Dummy 字节的问题。2.4 USB 虚拟串口从“能点灯”到“能被 PC 识别”串口调试用了这么久为什么还要做 USB 虚拟串口原因很现实不是每块开发板都板载 USB 转串口芯片而且 USB CDC 的传输速度、稳定性都比普通 UART 强不少。用 CubeMX 勾选 USB_DEVICE 的 Communication Device Class生成的就是一个虚拟串口PC 上装好驱动后能直接识别成 COM 口。USB 这部分最坑的是枚举。STM32 的 USB FS 外设对时钟要求非常高必须是精确的 48MHz。如果你用的是内部 HSIPLL 配置不对USB 挂上 PC 后大概率就是“无法识别的 USB 设备”。所以第一步永远是检查时钟树确保 PLL 输出 48MHz 给 USB 外设。其次是 DP 上拉电阻问题大部分核心板上 STM32 的 PA12 已经集成了 1.5k 上拉但如果你是自己画的板子漏了这颗电阻USB 设备永远不能被识别。代码层面要注意的是CubeMX 生成的 CDC_Transmit_FS 是 C 函数你在 C 文件里调用之前要包一层 extern “C”否则链接报找不到符号extern C { #include usbd_cdc_if.h } void SendFloatViaUsb(float value) { char buf[32]; int n snprintf(buf, sizeof(buf), %d.%02d\r\n, (int)value, (int)((value - (int)value) * 100)); CDC_Transmit_FS((uint8_t*)buf, n); }顺便提醒一句嵌入式 MCU 上能不用 snprintf 就不要用它会把几 KB 的格式化代码拖进 Flash。真要发 float我还见过有人直接用 union 把 float 拆成 4 字节发或者干脆发整数和小数两个字段让上位机自己拼。务实点省下来的 Flash 干啥不好。3. 实操过程把 C 类拼成一个能跑的小系统3.1 工程搭建与代码结构我先交代环境我用的是 STM32CubeIDECubeMX 生成外设初始化代码业务代码用手写的 C 类。你也可以用 VS Code CMake arm-none-eabi-gcc核心逻辑不变只是编译配置不同。CubeMX 里要配置的东西有TIM2 输入捕获用来测 Echo 脉宽、SPI1接 ILI9341、USB_DEVICECDC、PA 引脚接 Trig。生成代码之后把生成的 main.c 改名为 main.cpp或者在工程里新建一个 app.cpp把业务逻辑全部放进去初始化代码保留在 main.c 里。这样 CubeMX 下次重新生成代码时不会把你写的业务代码覆盖掉。我习惯把驱动类放在 drivers 目录下目录结构大致是这样core/ inc/main.h src/main.cpp drivers/ distance_sensor/ inc/distance_sensor.h src/distance_sensor.cpp tft_display/ inc/tft_display.h src/tft_display.cpp cdc_log/ inc/cdc_log.h src/cdc_log.cpp每个类都遵守一个约定构造函数只保存句柄不做复杂初始化复杂初始化放到 init() 方法里返回值是错误码。这么做有个好处全局对象被构造时不会因为外设时序没准备好而出问题init() 的调用顺序完全由你控制。3.2 主循环与状态机主循环我不用裸的 while HAL_Delay 顺序执行而是搞一个非常轻量的状态机。状态机的好处是在等待 Echo 返回的这段时间里CPU 不会被阻塞其他模块照常可以工作。状态流转很简单IDLE 空闲 → 触发测距 → 等待 Echo → 计算距离 → 刷新 LCD → USB 上报 → 回到 IDLE。我用一个枚举变量记录当前状态主循环里只有一个 switchwhile (1) { switch (app_state_) { case ST_IDLE: distance_sensor_.Trigger(); state_tick_ HAL_GetTick(); app_state_ ST_WAIT_ECHO; break; case ST_WAIT_ECHO: if (distance_sensor_.IsEchoDone()) { app_state_ ST_COMPUTE; } else if (HAL_GetTick() - state_tick_ 100) { app_state_ ST_TIMEOUT; // 超时保护防止卡死 } break; case ST_COMPUTE: last_distance_cm_ distance_sensor_.GetDistanceCm(); app_state_ ST_DISPLAY_UPDATE; break; case ST_DISPLAY_UPDATE: tft_display_.ShowDistance(last_distance_cm_); app_state_ ST_USB_SEND; break; case ST_USB_SEND: cdc_log_.SendDistance(last_distance_cm_); HAL_Delay(60); // 两次测量间隔至少60ms避免余波干扰 app_state_ ST_IDLE; break; default: app_state_ ST_IDLE; break; } }状态机看着比顺序执行啰嗦但维护性好了不止一个量级。以后想加一个“按键切换显示单位”的功能只需要在 IDLE 和 TRIGGER 之间插一个状态不用动其他代码。这就是状态机在嵌入式系统里最朴素的价值。3.3 数据帧设计USB 上报数据不能直接发“17.20cm”这种字符串了事。PC 端要稳定解析就得有帧协议。我用的帧格式很简单字段字节数说明帧头20xAA 0x55用来同步长度1有效载荷长度不含帧头和长度本身类型10x01 表示距离数据距离整数2比如 17.20cm整数部分是 17距离小数2百分位部分这里是 20校验和1从长度到小数全部字节累加取低 8 位加上帧头和校验和一帧是 9 个字节。校验和特别重要USB CDC 虽然是可靠的但你的上位机可能带蓝牙转发、可能走网关中间任何一环都可能丢字节。有了校验和上位机丢帧、粘帧都能发现不至于把错误数据显示出来。实测中我用一个简单的累加和就够用了没必要上 CRC32那只会浪费 MCU 的算力和代码量。PC 端解析也很无脑收字节 → 查 0xAA 0x55 → 读长度 → 收完一帧 → 校验 → 解析。只要协议定了上位机用 Python、C#、LabVIEW 都能轻松处理。3.4 编译选项与链接器的坑C 工程在 MCU 上编译最烦的是 Flash 体积爆炸。我总结下来有三类问题必须处理。第一启动文件里有没有调用__libc_init_array。有些老版本的启动文件只调了 SystemInit 就跳 mainC 全局对象的构造函数根本不会执行结果就是所有全局对象的数据都是初始值之前的样子。怎么确认在构造函数里加一行 volatile 变量赋值单步调试看有没有走进来。没进来就在 main 开头手动调用或者升级启动文件。第二C 特性开关。如果你的工程不需要异常和 RTTI编译选项里加上-fno-exceptions -fno-rtti能省下不少代码。如果用了纯虚函数链接时会报__cxa_pure_virtual未定义需要自己补一个空实现或者干脆别用纯虚类。第三裁剪未使用段。GCC 加上-ffunction-sections -fdata-sections链接时配合-Wl,--gc-sections可以把没用到的函数和数据全部丢掉。实测这一组参数在 STM32F103C8 这种 64KB Flash 的单片机上特别有用能省出好几 KB 空间。那些一上来就说 C 不适合单片机的人很多是因为没开这组参数。4. 常见问题与排查技巧实录4.1 关键参数速查表把这次调试涉及到的关键参数统一列出来方便你以后直接查表不用再翻数据手册。项目推荐参数原理/说明典型坑HC-SR04 Trig 脉冲≥10us低于 10us 模块不触发测距用 HAL_Delay(1) 误差大改用定时器微秒延时HC-SR04 Echo 最大脉宽约 38ms对应 6.5m超出后模块不会再拉低电平主循环必须加超时保护定时器计数频率1MHz每个 tick 正好 1us省换算16 位计数器可能溢出需加溢出中断ILI9341 SPI 时钟2~20MHz过高会读回乱码读 ID 时可以用低速时钟先稳定USB CDC 单次传输≤64 字节FS 端点最大包长是 64 字节发长数据要 Split否则 CDC_Transmit_FS 返回忙这里面最容易被忽视的是 USB CDC 的 64 字节限制。CDC_Transmit_FS 一次最多发 64 字节你发 100 字节函数可能返回 USBD_BUSY数据就丢了。我自己的经验是自定义一个小缓冲区把要发的内容拼好超过 60 字节就分批发送避免一次性长数据把端点堵死。4.2 CAN 通信突然连不上一次典型的嵌入式排查虽然这次小系统里没有 CAN但这个问题是嵌入式社区问得最多的热词之一我之前实际排查过值得单独写一段。现象很简单昨天还通信正常的两个 STM32 节点今天上电后 CAN 总线突然连不上发送函数一直报错。我当时的排查步骤按优先级排序第一步查硬件终端电阻。CAN 总线两端各需要一只 120Ω 终端电阻。如果总线上一端没焊电阻或者电阻虚焊信号反射会让收发器误码率飙升。用万用表量总线上两个节点之间的电阻正常应该在 60Ω 左右两端 120Ω 并联如果量出来是 120Ω说明有一端断开。第二步确认波特率。如果某个节点的系统时钟因为改了外部晶振或者 PLL 配置而变了CAN 外设的波特率也会跟着变两边不一致就直接表现为发不出去。用示波器看 CAN_H 和 CAN_L 的位时间量一下每位宽度反推波特率对比是不是 500kbps。第三步看错误状态寄存器。HAL 库里可以读 CAN 的错误状态如果节点进入了 Bus-Off 状态必须先恢复否则发多少都是白费。恢复方法不是简单地把外设重新初始化而是要清错误计数器、重新进入正常模式。我当时写了一个简单的恢复逻辑// 粗糙但有效的 CAN 总线恢复示例 if (HAL_CAN_GetState(hcan) HAL_CAN_STATE_ERROR) { __HAL_CAN_CLEAR_RESET_ERRORDETAILS(hcan); HAL_CAN_Start(hcan); } if (HAL_CAN_IsBitErrorPassive(hcan)) { HAL_CAN_Stop(hcan); HAL_CAN_Start(hcan); }但这里要提醒一句如果总线上只有你一个节点在发没有其他节点应答CAN 协议里 ACK 字段永远收不到隐性位发送节点会一直重试直到 Bus-Off。所以 CAN 调试第一句话永远是确认总线上至少有两个节点波特率一致。总线空着就想测试发送那是和自己过不去。4.3 打印、断言、被动调试三板斧嵌入式调试最忌讳的就是“到处加打印然后肉眼瞪串口”。我个人的三板斧是打印、断言、被动调试。打印要带时间戳。每次输出前加一个HAL_GetTick()这样一旦发现系统卡住你能立刻知道卡在哪个时间点再跟代码逻辑一对照问题范围瞬间缩小一半。断言则是在关键路径上做检查。C 片子上没有 PC 端那种异常机制你只需要一个非常朴素的断言宏#define ASSERT(cond) do { \ if (!(cond)) { \ Error_Handler(); \ } \ } while (0)在传感器数据解析、缓冲区写指针移动这些地方加上断言比打印一百行日志都有效。被动调试更高级一点指的是不打断程序运行直接通过外设的状态寄存器、逻辑分析仪的波形来判断问题。比如 SPI 读 ID 读到 0xA1A1这时候你加一百个打印也不如用逻辑分析仪抓一次 MISO 波形来得直接。波形上有没有数据回传一眼就看清楚了。5. 一些我个人的体会玩 MCU 上 C 这几年我最大的体会就两个字克制。别把 PC 端那套大规模面向对象设计搬过来一个项目恨不得抽出十几个虚基类最后 Flash 爆了、调试晕了还反过来怪 C 不好用。在单片机上做嵌入式 C核心是把每个外设做成小而独立的类用清晰的返回值替代层层嵌套的标志位用简单的状态机替代混乱的延时和等待这已经能解决大部分工程可维护性的问题了。最后再分享一个小技巧每个类的构造函数都写成“空操作”不申请内存、不碰外设、不抛异常把真正的初始化放到 init() 方法里并且让 init() 返回错误码。这样既避免了全局对象构造顺序问题又能在初始化失败时明确知道是哪一步出了问题。嵌入式开发的活儿永远干不完今天把这块补上明天还会有新的需求冒出来但没关系重要的是每一步都踩得实。这期的“活”补到这里下一期咱们接着造。

STM32 C++实战：超声波测距+LCD+USB虚拟串口系统整合

相关推荐

手把手教你用TaoToken统一API通道快速集成酷我音乐服务

PyCharm应用开发实战：从项目配置到调试测试的完整指南

ponytail插件与skill全解析：轻量可插拔工具的使用指南

更多资讯

让Agent接管GitHub Issue到PR全链路：工程实践与避坑指南

远程启动管理器1.3：机房批量部署PXE网络引导实战指南

手搓生产级AI Agent：LLM工程化与RAG混合索引实战

基于YOLOv8的居民楼外立面瓷砖脱落检测：从数据集标注到界面部署全流程

基于Gabor滤波+PCA+LDA+SVM的人脸表情识别完整方案

wifit3 WiFi 审计工具 WPA PSK 派生实现完整走读：从 PSK 字符串到 M2 的 MIC

今日更新

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？