1. 项目缘起从物理串口到虚拟串口的必然跨越最近在做一个基于STM32F103的小型数据采集设备需要将传感器数据实时上传到上位机。最开始我理所当然地选择了最传统的USART配合一个CH340G的USB转串口模块。项目初期一切顺利但到了后期问题开始浮现多出来的那个USB转串口模块不仅增加了BOM成本和PCB面积更麻烦的是在频繁插拔调试或者设备交付给用户后那个小小的CH340模块成了故障高发点——要么是接触不良要么是驱动兼容性问题尤其是在一些老旧的Windows 7系统上驱动安装能折腾半天。这让我开始思考既然我的主控STM32F103本身自带USB 2.0全速设备接口为什么还要外挂一个“翻译官”呢能不能让STM32自己“变成”一个串口直接通过USB线连接到电脑让电脑识别为一个标准的COM口这就是USB虚拟串口USB CDC-ACM类设备技术的用武之地。它省去了物理的UART转USB芯片让通信链路更简洁、更可靠成本也更低。于是我决定用STM32CubeMX这个神器重新梳理一遍从零开始实现USB虚拟串口的完整流程把过程中的关键配置、底层原理和那些容易踩的坑都记录下来。2. CubeMX工程创建与基础外设配置工欲善其事必先利其器。我们首先需要一个正确的工程骨架。这里我使用的是STM32F103C8T6这款经典的“蓝莓”芯片但流程对于F103系列其他型号基本通用。2.1 芯片选型与时钟树配置打开STM32CubeMX新建工程选择你的具体芯片型号。对于USB功能时钟配置是第一个关键点。USB模块需要精确的48MHz时钟。对于STM32F103通常的路径是利用内部或外部晶振通过PLL倍频得到72MHz的系统时钟SYSCLK然后由USB预分频器产生48MHz的USB时钟USBCLK。HSE外部高速时钟如果你板子上有8MHz晶振很常见在RCC配置中将High Speed Clock (HSE)设置为Crystal/Ceramic Resonator。时钟树配置在Clock Configuration标签页将PLL Source Mux选择为HSE。将PLLMUL设置为x9倍频。因为HSE是8MHz8 * 9 72MHz得到PLLCLK。将SYSCLK的来源选择为PLLCLK这样系统主频就是72MHz。最关键的一步找到USB Clock的配置。它由PLLCLK72MHz经过一个分频器得到。你需要将USB Prescaler设置为/1.5。是的是1.5分频72 / 1.5 48MHz。这是硬件规定的必须为USB提供精确的48MHz时钟。如果这里配置错误USB根本无法正常工作电脑会提示“无法识别的USB设备”。注意如果你使用内部RC振荡器HSI作为时钟源由于其精度较低通常±1%虽然可能能让USB枚举成功但在进行高速、稳定的数据通信时可能会遇到数据错误或连接间歇性断开的问题。对于产品级应用强烈建议使用外部晶振。2.2 调试接口与基本引脚配置在开始配置USB之前先做好两件基础事情调试接口在System Core-SYS里将Debug设置为Serial Wire。这能保证SWD下载和调试功能正常避免芯片被锁死。USB引脚STM32F103的USB是固定在PA11DM和PA12DP这两个引脚上的。CubeMX通常在你使能USB后会自动配置这两个引脚。你可以在Pinout Configuration视图的芯片图上确认一下PA11和PA12是否已经被标记为USB_DM和USB_DP。3. USB中间件Middleware的深度配置这是整个项目的核心部分。在左侧分类中找到Middleware展开并激活USB_DEVICE。3.1 设备类型选择与类配置在USB_DEVICE的配置界面中Class For FS IP选择Communication Device Class (Virtual Port Com)。这个“FS IP”指的是全速Full SpeedUSB设备接口。选择后下方会自动出现CDC的配置子菜单。进入CDC配置页面这里有几个关键参数USB CDC FIFO Size这是USB端点缓冲区的大小。虚拟串口数据通过批量传输Bulk Transfer端点进行默认的256字节对于大多数串口通信场景是足够的。如果你需要传输非常大的数据块例如文件可以适当调大但会占用更多的RAM。CDC Receive Buffer Size这是CDC类驱动内部用于接收数据的缓冲区大小。当上位机发送数据到虚拟串口时数据会先存在这里然后你的应用程序通过CDC_Receive_FS()函数来读取。这个大小需要根据你一次期望接收的最大数据包长度来设置通常设为512或1024字节是安全的。3.2 端点与描述符解析点击USB_DEVICE下的Device Descriptor可以查看和修改USB设备描述符。对于虚拟串口大部分参数CubeMX已经填好但有两个信息你最好根据实际情况修改Vendor ID (VID)和Product ID (PID)这是USB设备的“身份证”。默认是ST的VID和某个示例PID。如果你做产品需要向USB-IF申请自己的VID或购买一个PID则可以自定义。对于学习和调试使用默认值或随意修改一个注意不要和已知设备冲突都可以。Product String设备名称连接电脑后会在设备管理器中显示的名字比如可以改成“MySTM32 Virtual COM Port”。更底层的是端点配置。USB通信基于“端点”Endpoint你可以理解为数据进出的管道。对于CDC类至少需要三个端点控制端点0 (EP0)所有USB设备都必须有用于枚举、配置和控制命令传输。CubeMX自动管理。中断输入端点 (EP1_IN)用于传输串口线路状态如DTR、RTS和通知。这是可选的但标准CDC驱动会使用它。批量输出端点 (EP2_OUT)用于接收从上位机电脑发往设备的数据即PC发送STM32接收。批量输入端点 (EP2_IN)用于发送从设备发往上位机的数据即STM32发送PC接收。在Configuration下的CDC配置中你可以看到这些端点的分配。通常Bulk Out EP和Bulk In EP会共用同一个端点号如0x02但方向不同。这些配置CubeMX已经为我们优化好了除非有特殊需求否则不建议改动。4. 生成代码与工程结构剖析完成所有图形化配置后点击Project Manager标签页设置好工程名称、存储路径、IDE我常用Keil MDK-ARM V5。关键点在于Toolchain / IDE的选择要正确。在Code Generator部分我习惯做如下设置选中Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral这样每个外设的代码会单独成对文件结构更清晰。选中Set all free pins as analog (to optimize power consumption)这能降低未使用引脚的功耗。最后点击GENERATE CODE。第一次生成会询问是否安装缺失的软件包确认即可。代码生成后用你的IDE如Keil打开工程。生成的代码结构非常清晰Core/Inc和Core/Src存放主函数、main.c、stm32f1xx_it.c中断服务函数以及你自己添加的应用代码。Drivers/STM32 HAL库和CMSIS文件。Middlewares/ST/STM32_USB_Device_Library/ST官方提供的USB设备库CDC类的实现就在这里的Class/CDC目录下。我们一般不需要直接修改这里的文件。USB_DEVICE/这是与我们工程最相关的目录。里面包含App/usb_device.c负责USB设备初始化和启动。usbd_cdc_if.c是关键文件它实现了CDC类应用层的接口函数我们需要重点修改和填充的就是这个文件里的回调函数。Target/包含USB描述符等配置信息。5. 应用层代码实现填充CDC接口回调函数打开USB_DEVICE/App/usbd_cdc_if.c我们的主要工作就在这里。这个文件定义了一系列以CDC_开头的弱函数我们需要根据应用逻辑来实现它们。5.1 数据接收CDC_Receive_FS这是最重要的回调函数之一。当电脑通过虚拟串口发送数据到STM32时USB底层驱动在接收完一包数据后会自动调用这个函数。static int8_t CDC_Receive_FS(uint8_t* Buf, uint32_t *Len) { /* USER CODE BEGIN 6 */ // 1. 将接收到的数据拷贝到你的应用缓冲区进行处理 // 例如memcpy(my_rx_buffer, Buf, *Len); // process_uart_data(my_rx_buffer, *Len); // 2. 重新启动接收准备接收下一包数据 USBD_CDC_SetRxBuffer(hUsbDeviceFS, Buf[0]); USBD_CDC_ReceivePacket(hUsbDeviceFS); return (USBD_OK); /* USER CODE END 6 */ }关键点Buf和Len指向接收到的数据缓冲区及其长度。注意这个缓冲区是USB驱动内部管理的你不能长时间持有它的指针。通常的做法是立即将数据复制到你自己定义的全局缓冲区环形缓冲区是更优选择中进行处理。必须重新启动接收在函数末尾调用USBD_CDC_ReceivePacket是必须的这告诉USB驱动“我已经处理完这包数据了缓冲区可以用于接收下一包了”。如果忘记调用USB将无法再接收后续数据。处理要快这个函数是在中断上下文中被调用的虽然CDC接收通常使用批量传输其完成也是在中断中处理所以里面的代码应该尽量简短、高效避免复杂的运算或阻塞操作。快速拷贝数据并设置标志位在主循环中处理是更好的实践。5.2 数据发送CDC_Transmit_FS当你的应用程序需要发送数据到电脑时就调用这个函数。它并不是一个回调函数而是一个供你主动调用的API。uint8_t CDC_Transmit_FS(uint8_t* Buf, uint16_t Len) { uint8_t result USBD_OK; /* USER CODE BEGIN 7 */ // 检查USB连接状态和前一次传输是否完成 if (hUsbDeviceFS.dev_state ! USBD_STATE_CONFIGURED) { return USBD_FAIL; } if (TxState ! 0) { return USBD_BUSY; // 上一次传输还未完成 } // 调用底层接口启动传输 result USBD_CDC_TransmitPacket(hUsbDeviceFS, Buf, Len); /* USER CODE END 7 */ return result; }关键点状态检查在发送前务必检查hUsbDeviceFS.dev_state是否为USBD_STATE_CONFIGURED。只有在这个状态下USB设备才被主机正确配置可以通信。同时检查TxState一个全局变量由CDC驱动维护是否为0确保上一次传输已经完成避免数据覆盖。非阻塞与阻塞处理CDC_Transmit_FS函数启动传输后立即返回。传输本身是异步的由USB硬件和中断在后台完成。如果你需要实现一个阻塞式的“发送完成”等待可以轮询TxState变量直到其变为0。但更优雅的方式是基于事件驱动在发送完成回调函数中设置标志。5.3 发送完成回调CDC_TransmitCplt_FS当一包数据成功发送完毕后USB底层会调用这个函数。这是实现流控或连续发送的关键。static int8_t CDC_TransmitCplt_FS(uint8_t *Buf, uint32_t *Len, uint8_t epnum) { /* USER CODE BEGIN 8 */ // 发送完成可以在这里设置标志通知主程序可以发送下一包数据了 // 例如tx_complete_flag 1; // 或者如果使用环形缓冲区可以在这里触发下一次发送 // send_next_chunk_from_buffer(); // 特别注意这个Buf和Len参数通常为NULL不要依赖它们 UNUSED(Buf); UNUSED(Len); UNUSED(epnum); // 驱动内部会将TxState清零 return (USBD_OK); /* USER CODE END 8 */ }这个函数通常用于解除你在应用程序中设置的“发送忙”标志或者触发环形缓冲区中下一段数据的发送从而实现连续、不间断的数据流传输。5.4 线路控制回调CDC_Control_FS这个函数处理来自上位机的控制信号比如设置波特率虽然虚拟串口实际不走硬件波特率但PC端软件会发、数据位、停止位以及最重要的流控制信号DTR、RTS。static int8_t CDC_Control_FS(uint8_t cmd, uint8_t* pbuf, uint16_t length) { /* USER CODE BEGIN 5 */ switch (cmd) { case CDC_SEND_ENCAPSULATED_COMMAND: // 通常不需要处理 break; case CDC_GET_ENCAPSULATED_RESPONSE: // 通常不需要处理 break; case CDC_SET_COMM_FEATURE: // 通常不需要处理 break; case CDC_GET_COMM_FEATURE: // 通常不需要处理 break; case CDC_CLEAR_COMM_FEATURE: // 通常不需要处理 break; case CDC_SET_LINE_CODING: // 设置串口参数 // pbuf指向一个LineCoding结构体包含波特率、数据位等 // 虚拟串口我们可以忽略或记录这些参数用于兼容性 // line_coding.bitrate *(uint32_t*)pbuf; // line_coding.format pbuf[4]; // ... break; case CDC_GET_LINE_CODING: // 获取当前串口参数 // 需要填充pbuf指向的缓冲区为当前的LineCoding // *(uint32_t*)pbuf line_coding.bitrate; // 例如 115200 // pbuf[4] line_coding.format; // 例如 8位数据1停止位无校验 break; case CDC_SET_CONTROL_LINE_STATE: // 设置控制线状态DTR, RTS // pbuf[0]的第0位是DTR状态第1位是RTS状态 // 这是流控制的关键 // uint8_t dtr_rts_state pbuf[0]; // if (dtr_rts_state 0x01) { /* DTR置位PC端串口工具已打开 */ } // if (dtr_rts_state 0x02) { /* RTS置位 */ } break; case CDC_SEND_BREAK: // 发送Break信号一般不用处理 break; default: break; } return (USBD_OK); /* USER CODE END 5 */ }实操心得CDC_SET_CONTROL_LINE_STATE命令至关重要。很多人在第一次使用虚拟串口时会发现打开PC串口助手后STM32这边并没有立即进入接收回调。这是因为很多串口助手如SecureCRT、Putty在打开串口时会先拉高DTR信号。你可以在这个命令的处理中检测到DTR置位然后将其作为一个“串口已连接”的标志从而开始你的数据发送流程。同样当DTR清零时意味着串口被关闭你可以停止发送以节省资源。6. 主程序逻辑与数据流设计有了底层的CDC接口函数我们需要在主程序main.c中构建应用逻辑。一个典型的虚拟串口数据回环Echo示例流程如下初始化在main()函数中CubeMX生成的MX_USB_DEVICE_Init()会初始化USB并启动设备。之后USB库会在后台自动处理枚举过程。等待枚举完成你可以在主循环中检查hUsbDeviceFS.dev_state是否变为USBD_STATE_CONFIGURED或者等待CDC_SET_CONTROL_LINE_STATE中DTR信号有效。数据接收与处理在CDC_Receive_FS回调中不要进行复杂处理。最佳实践是使用一个环形缓冲区Ring Buffer。当数据到来时快速将Buf中的数据写入环形缓冲区的尾部。主循环处理在主循环中不断检查环形缓冲区的读指针和写指针。如果有数据就读取出来进行处理比如你的业务逻辑然后通过CDC_Transmit_FS函数发送回去回环测试或发送其他数据。流控制实现为了实现可靠的连续发送比如高速上传传感器数据你需要结合CDC_TransmitCplt_FS回调。设计一个状态机当有数据要发送时调用CDC_Transmit_FS发送第一包并将状态设为“发送中”。在CDC_TransmitCplt_FS回调中将状态设为“空闲”并检查是否还有后续数据要发送如果有则立即启动下一次发送。这样可以确保发送队列不会堵塞充分利用USB带宽。// 主循环片段示例 while (1) { // 1. 处理接收到的数据从环形缓冲区读取 if(ring_buffer_data_available(rx_buf)) { uint16_t len ring_buffer_read(rx_buf, process_buffer, sizeof(process_buffer)); // ... 你的应用处理逻辑 ... // 例如回环发送 CDC_Transmit_FS(process_buffer, len); } // 2. 处理定时发送任务例如每秒发送一次传感器数据 if(HAL_GetTick() - last_send_tick 1000) { last_send_tick HAL_GetTick(); if(usb_connected) { // usb_connected 在 CDC_SET_CONTROL_LINE_STATE 中设置 sensor_data read_sensor(); CDC_Transmit_FS((uint8_t*)sensor_data, sizeof(sensor_data)); } } HAL_Delay(1); // 短暂延时避免CPU空转 }7. 电脑端驱动安装与常见问题排查代码编译下载到STM32后用USB线连接电脑和板子的USB口注意STM32F103的USB是设备模式需要连接到电脑的USB主机口。7.1 驱动自动安装Windows 10/11对于符合CDC标准的设备Windows 10和11通常内置了usbser.sys驱动可以自动识别并安装。连接设备后你可以在“设备管理器”中看到“端口 (COM 和 LPT)”下出现一个新的设备例如“USB串行设备 (COM3)”。这里的COM号是系统自动分配的。7.2 手动安装驱动Windows 7或识别失败如果系统没有自动安装或者显示为“未知设备”你需要手动指定驱动。在设备管理器中右键点击未知设备 - “更新驱动程序软件”。选择“浏览我的计算机以查找驱动程序软件”。选择“从计算机的设备驱动程序列表中选取”。在“显示所有设备”列表中选择“端口 (COM 和 LPT)”。在厂商列表选择“Microsoft”在右侧型号列表选择“USB串行设备”或“标准串行 over USB”然后下一步完成安装。注意ST官方也提供了一个STM32 Virtual COM Port Driver但这个驱动主要是为早期或特定型号的评估板提供的。对于使用标准CDC类的自定义设备Windows自带的usbser.sys是首选且最通用的。7.3 常见故障排查表现象可能原因排查步骤电脑提示“无法识别的USB设备”1. USB硬件连接问题DP/DM接反、没接上拉电阻2. USB时钟配置错误不是精确48MHz3. 芯片没有正确进入设备模式VBUS检测4. 描述符错误VID/PID冲突或格式错误1. 检查硬件STM32F103的USB需要外接一个1.5kΩ的上拉电阻在DPPA12线上到3.3V。很多最小系统板已经集成。2. 用示波器或逻辑分析仪检查PA11/PA12是否有数据活动。检查CubeMX中USB时钟是否为48MHz。3. 确保USB_DP引脚PA12通过一个1.5kΩ电阻上拉到3.3V。4. 使用USB协议分析仪如USBlyzer付费或Wireshark配合USBPcap抓取USB枚举过程查看描述符。设备管理器显示黄色感叹号驱动安装失败或不匹配1. 尝试手动指定安装usbser.sys驱动。2. 尝试卸载设备拔插USB让系统重新识别。3. 检查设备VID/PID是否与系统已有驱动冲突。识别为COM口但无法收发数据1. 应用程序未正确打开串口或参数错误2. STM32端未正确处理CDC_Receive_FS或CDC_Transmit_FS3. 流控制问题DTR/RTS1. 确认PC端串口助手选择了正确的COM号波特率等参数任意设置如115200即可实际速率由USB总线决定。2.最关键在STM32代码中必须在CDC_Receive_FS函数末尾调用USBD_CDC_ReceivePacket重新启动接收。3. 在PC端串口助手中尝试勾选“DTR”或“RTS”选项。在STM32代码的CDC_Control_FS函数中打印或处理CDC_SET_CONTROL_LINE_STATE命令确认信号到来。发送数据丢失或卡顿1. 发送缓冲区溢出2. 未处理CDC_TransmitCplt_FS连续调用CDC_Transmit_FS导致阻塞3. PC端接收软件处理慢1. 检查CDC_Transmit_FS的返回值如果是USBD_BUSY说明上一次发送未完成。2. 实现基于CDC_TransmitCplt_FS回调的发送状态机确保前一包发送完成后再发下一包。3. 在PC端尝试使用更高效的串口助手或检查是否有其他程序占用了COM口。设备频繁断开重连1. USB供电不足2. 软件中错误地反复初始化/去初始化USB3. 硬件接触不良1. 确保板子供电充足USB线质量良好。尝试给板子单独供电。2. 检查代码确保MX_USB_DEVICE_Init()只在上电后调用一次不要在循环中反复调用。3. 检查USB插座和线缆的焊接与连接。8. 进阶话题性能优化与稳定性提升当基本功能跑通后为了应对更严苛的应用场景可以考虑以下优化1. 使用DMA进行数据搬运对于高速、大数据量的虚拟串口传输频繁的CPU参与内存拷贝会成为瓶颈。可以为USB端点配置DMA。在CubeMX中配置USB的批量传输端点使用DMA通道。然后在usbd_cdc_if.c中数据接收和发送将通过DMA自动进行大大减轻CPU负担并允许在传输过程中CPU处理其他任务。不过CDC类驱动对DMA的支持需要更细致的配置和处理DMA传输完成中断。2. 实现真正的硬件流控RTS/CTS虽然虚拟串口的RTS/CTS是软件模拟的但你可以在CDC_Control_FS中解析RTS信号并将其映射到一个GPIO输出去控制外部真正的UART硬件的流控。反过来也可以读取一个GPIO的CTS状态通过CDC_GetLineCoding或其他自定义方式反馈给PC端这需要扩展CDC协议较为复杂。3. 多接口复合设备你的STM32不仅可以模拟一个串口还可以同时模拟其他USB设备比如一个HID键盘或一个存储设备MSC。这在CubeMX中可以通过在USB_DEVICE配置里添加多个“Class”来实现。你需要精心设计复合设备的描述符并处理好不同接口对应的回调函数。4. 功耗管理对于电池供电设备当USB未连接时可以关闭USB时钟和外设以省电。当VBUSPA9如果有检测电路信号到来时产生中断再初始化USB设备。这需要在硬件上连接USB的VBUS到STM32的一个具有中断功能的引脚如PA9并配置相应的中断服务例程。折腾完这一整套我的那个数据采集设备终于甩掉了外挂的USB转串口芯片电路板看起来清爽多了成本也降了几块钱。最关键的是稳定性得到了质的提升再也没有因为驱动问题被客户投诉过。虚拟串口技术就像给STM32打开了一扇直接通往PC的高速大门省去了中间商赚差价。整个过程最深的体会就是时钟配置和那个USBD_CDC_ReceivePacket的调用是两大命门一个不对整个通信链路就瘫了。另外善用CDC_SET_CONTROL_LINE_STATE来感知串口工具的开关状态能让你的设备行为更加智能和稳健。下次如果再需要更高速率或者更复杂的USB功能比如直接传输文件我会考虑尝试USB大容量存储设备MSC类那又是另一个有趣的故事了。