1. STM32 USB虚拟串口方案概述
在嵌入式开发中，串口通信是最基础也最常用的调试和通信手段。传统方案通常采用CH340或CP2102这类专用USB转串口芯片，但这会带来三个明显问题：增加BOM成本、占用PCB空间、需要额外设计电路。而STM32系列单片机内置USB外设，通过虚拟串口(CDC类)功能，可以直接实现USB转串口的功能，省去外部芯片。
我最近在一个紧凑型设备开发中就遇到了PCB空间紧张的问题，手头也没有现成的串口芯片。经过实测验证，STM32的USB虚拟串口方案完全能够满足常规调试需求，最高速度可达12Mbps（全速USB），远高于普通串口芯片的115200bps。下面将详细介绍实现方法和优化技巧。
2. 开发环境搭建与基础配置
2.1 硬件平台选型要点
推荐使用STM32F103ZET6作为开发平台，原因有三：
- 该型号具有完整的USB FS(全速)外设
- 内置512KB Flash和64KB RAM，资源充足
- 价格适中且供货稳定
实际项目中，根据需求也可选择其他带USB外设的STM32型号，如F0/F1/F3系列。需注意不同系列的USB IP核可能存在差异，本文以F1系列为例。
2.2 软件工具链配置
开发环境采用：
- STM32CubeMX v6.9.1：用于外设初始化和代码生成
- CLion 2023.3：作为主要IDE，配合OpenOCD调试
- ST-Link V2：烧录调试工具
关键提示：使用CLion开发STM32需要安装arm-none-eabi-gcc工具链和Cmake，具体配置方法可参考JetBrains官方文档。相比Keil/IAR，CLion提供更现代化的开发体验。
3. USB虚拟串口工程创建与配置
3.1 CubeMX工程初始化
- 在CubeMX中选择对应型号（STM32F103ZE）
- 配置时钟树：
- HSE选择外部8MHz晶振
- PLL倍频至72MHz系统时钟
- USB时钟必须为48MHz（由PLL分频得到）
- 调试接口选择SWD模式（与ST-Link兼容）
3.2 USB外设关键配置
在Connectivity选项卡中：
- 启用USB(FS)设备模式
- 在Middleware中启用USB_DEVICE
- Class选择Communication Device Class (CDC)
特别注意以下参数：
- Device FS参数保持默认
- CDC接口配置：
- 通信接口：仅启用ACM（Abstract Control Model）
- 数据接口：最大包尺寸设为64字节
- 字符串描述符自定义为"STM32 Virtual COM"
3.3 生成代码注意事项
代码生成时建议：
- 勾选"为每个外设生成单独的.c/.h文件"
- 工具链选择SW4STM32（与CLion兼容）
- 启用所有外设的中断
生成后工程结构应包含：
code复制├── Core
├── Drivers
├── USB_DEVICE
│ ├── App
│ └── Target
└── Middlewares/ST/STM32_USB_Device_Library
4. 虚拟串口功能实现与优化
4.1 基础数据发送实现
USB虚拟串口的发送函数原型为：
c复制uint8_t CDC_Transmit_FS(uint8_t* Buf, uint16_t Len);
典型发送示例：
c复制// 发送字符串
CDC_Transmit_FS((uint8_t*)"Hello STM32\r\n", 13);
// 发送变量数据
uint8_t data[32];
sprintf((char*)data, "ADC Value: %d\r\n", adc_value);
CDC_Transmit_FS(data, strlen((char*)data));
4.2 发送功能常见问题与优化
原始实现存在两个典型问题：
-
连续发送丢失数据：
原因在于CDC_Transmit_FS内部状态机未就绪时直接返回。优化方案：c复制// 在usbd_cdc_if.c中修改CDC_Transmit_FS函数 uint32_t timeout = HAL_GetTick(); while (hcdc->TxState != 0) { if ((HAL_GetTick() - timeout) > 10) { return USBD_BUSY; } } -
每次烧录需重新插拔USB：
解决方法是在初始化时模拟USB断开：c复制// 在MX_USB_DEVICE_Init()函数开始处添加 GPIO_InitTypeDef GPIO_InitStruct = {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitStruct.Pin = GPIO_PIN_12; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_PULLDOWN; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); HAL_Delay(100); HAL_GPIO_DeInit(GPIOA, GPIO_PIN_12);
4.3 数据接收实现方案
接收数据通过回调函数处理：
c复制static int8_t CDC_Receive_FS(uint8_t* Buf, uint32_t *Len)
{
// 将数据复制到应用缓冲区
memcpy(rx_buffer, Buf, *Len);
rx_length = *Len;
// 通知主循环处理
data_received = 1;
// 必须返回USBD_OK
return USBD_OK;
}
主循环处理示例：
c复制while(1) {
if (data_received) {
// 处理接收数据
process_rx_data(rx_buffer, rx_length);
// 清空标志
data_received = 0;
}
}
5. 高级应用与性能优化
5.1 大容量数据传输方案
标准CDC类每次最多传输64字节，如需更大数据量，可采用以下方案：
-
分包发送机制：
c复制void send_large_data(uint8_t* data, uint32_t length) { uint32_t sent = 0; while (sent < length) { uint16_t chunk = MIN(64, length - sent); while (CDC_Transmit_FS(&data[sent], chunk) != USBD_OK) { HAL_Delay(1); } sent += chunk; } } -
双缓冲接收技术：
在接收回调中快速切换缓冲区，避免数据丢失：c复制#define BUF_SIZE 256 uint8_t rx_buf[2][BUF_SIZE]; volatile uint8_t active_buf = 0; static int8_t CDC_Receive_FS(uint8_t* Buf, uint32_t *Len) { memcpy(rx_buf[active_buf], Buf, *Len); active_buf ^= 1; // 切换缓冲区 return USBD_OK; }
5.2 波特率自适应技巧
虽然虚拟串口不依赖实际波特率，但为兼容传统应用，可模拟波特率设置：
-
在USB描述符中声明支持的波特率：
c复制__ALIGN_BEGIN static uint8_t CDC_IF_StringDescriptor[] __ALIGN_END = { // ...其他描述符 0x00, 0x00, // 1200 baud 0x80, 0x25, // 9600 baud 0x00, 0x4B, // 115200 baud }; -
通过控制请求处理波特率变更：
c复制static int8_t CDC_Control_FS(uint8_t cmd, uint8_t* pbuf, uint16_t length) { switch (cmd) { case CDC_SET_LINE_CODING: memcpy(&line_coding, pbuf, sizeof(line_coding)); break; // 其他命令处理 } }
6. 实战经验与问题排查
6.1 常见问题速查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 电脑无法识别设备 | 1. USB DP未接上拉电阻 2. 描述符配置错误 |
1. 检查硬件连接 2. 使用USB分析仪抓包 |
| 数据发送不完整 | 1. 未处理TxState状态 2. 缓冲区太小 |
1. 添加状态检查 2. 增大发送缓冲区 |
| 接收数据丢失 | 1. 处理速度过慢 2. 未及时返回USBD_OK |
1. 使用双缓冲 2. 简化回调函数 |
6.2 性能优化建议
-
提升吞吐量：
- 启用USB DMA传输
- 使用环形缓冲区管理数据
- 适当增大USB堆栈（修改USB_DEVICE_STACK_SIZE）
-
降低延迟：
- 提高USB中断优先级
c复制HAL_NVIC_SetPriority(USB_LP_CAN1_RX0_IRQn, 0, 0);- 减少回调函数处理时间
-
电源管理：
- 正确实现USB挂起/恢复回调
- 低功耗设计时注意保持USB时钟
7. 项目应用实例
7.1 固件升级方案
结合USB虚拟串口实现DFU功能：
- 在CubeMX中启用USB DFU模式
- 划分Flash为两个区域：Bootloader + Application
- 通过虚拟串口发送升级指令和固件数据
关键代码片段：
c复制void jump_to_bootloader(void) {
void (*bootloader)(void) = (void (*)(void))(*((uint32_t*)0x1FFFF000));
HAL_RCC_DeInit();
HAL_DeInit();
__set_MSP(*(uint32_t*)0x1FFFF000);
bootloader();
}
7.2 多接口复合设备
实现同时支持虚拟串口和HID设备：
- 在CubeMX中添加HID类
- 修改USB描述符配置复合设备
- 为每个接口分配独立端点
配置要点：
- 每个接口需要独立的报告描述符
- 端点地址不能冲突
- 接口交替设置需正确实现
经过实际项目验证，STM32 USB虚拟串口方案在稳定性、成本和空间占用方面都具有明显优势。特别是在紧凑型设备和量产产品中，能有效简化设计并降低成本。对于需要更高性能的场景，可考虑使用STM32的HS USB外设（需外接PHY芯片），将速度提升至480Mbps。