从零构建Linux与STM32的USB-CDC数据通道

1. 为什么需要USB-CDC通信？

当你用STM32开发板和Linux电脑打交道时，最头疼的问题可能就是怎么让它们说上话。USB-CDC（Communication Device Class）就像给两个说不同语言的人配了个翻译——它把USB协议转换成串口通信，让嵌入式设备和电脑用最熟悉的方式交流。我做过十几个物联网项目，90%的硬件通信问题都卡在这个环节。

去年给智能农业系统调试时，就遇到过STM32发送的数据在Linux端乱码的情况。后来发现是波特率配置没对齐，折腾了整整两天。这种痛只有踩过坑的人才懂，所以今天我要把USB-CDC的完整搭建过程掰开揉碎讲清楚。

2. STM32端的CDC配置实战

2.1 CubeMX工程搭建

打开STM32CubeMX新建工程时，关键步骤是正确配置USB外设。以STM32F103C8T6为例：

1. 在"Connectivity"选项卡启用USB设备模式
2. 选择"Device (FS)"全速模式
3. 在"Middleware"中勾选USB_CDC类

这里有个容易翻车的点：时钟配置。USB模块要求精确的48MHz时钟，我建议直接使用外部晶振。曾经用内部RC振荡器导致通信不稳定，数据包时不时丢失，查了三天才发现是时钟漂移问题。

2.2 关键代码修改

自动生成的代码需要补充两个核心回调函数：

c复制// 数据接收回调
static int8_t CDC_Receive_FS(uint8_t* Buf, uint32_t *Len) {
  // 把接收到的数据转发到UART1
  HAL_UART_Transmit(&huart1, Buf, *Len, 1000); 
  // 回显到USB主机
  USBD_CDC_SetTxBuffer(&hUsbDeviceFS, Buf, *Len);
  return USBD_CDC_TransmitPacket(&hUsbDeviceFS);
}

// 发送完成回调
static int8_t CDC_TransmitCplt_FS(uint8_t *Buf, uint32_t *Len, uint8_t epnum) {
  return USBD_OK;
}

实测发现缓冲区大小直接影响传输效率，推荐设置为512字节以