使用STM32CubeMX把USB配置成虚拟串口（virtual com port）

最新推荐文章于 2025-10-09 16:13:06 发布

原创最新推荐文章于 2025-10-09 16:13:06 发布 · 7.5k 阅读

57 ·

CC 4.0 BY-SA版权

文章标签：

#stm32 #usb #串口通信 #keil mdk #gd32

STM32 CUBEMX 专栏收录该内容

2 篇文章

订阅专栏

本文介绍了如何使用STM32CubeMX将STM32的USB配置为虚拟串口，以实现与老旧上位机的串口通信。通过详细步骤展示了从新建工程、配置时钟、USB功能选择到生成代码的全过程，并在测试中成功实现了数据的双向传输。

应用场景：

本次在项目中，由于对方的上位机软件比较老旧。
该软件只能通过串口通讯。而我们的设备只引出了USB口。还好STM32 的USB类型可以设置成虚拟串口。所以可以通过把USB枚举成虚拟串口（virtual com port设备）来与该上位机软件通讯。
本来是想直接移植STM32 的USB_FS库。奈何移植失败。(给跪了orz orz orz…)
又想起CubeMX也可以配置的。就用CubeMX配置工程，效果出奇的好。PC能够正常的枚举和通讯。所以趁热和大家分享分享，自己也做个记录。
以下内容就是如何一步一步通过CubeMX，把STM32的USB配置成虚拟串口的过程。
文章最后放上了本次CubeMX的工程和对应的虚拟串口代码。

配置过程：

1、点开CubeMX，新建工程，选择MCU。我用的是STM32F103VCT6。你们根据自己实际的MCU选择对应的型号以及封装格式。
在这里插入图片描述

2、选择系统时钟源。这边必须要配置，没配置系统时钟，不能生成正确的代码。
这里我使用的是外部晶振。（根据实际配置）

3、配置USB的上拉PIN脚。我这边的上拉PIN是PA13（根据实际情况配置）。注意硬件上DP要接个1.5K的上拉。用以表示高速设备以及枚举控制。
在这里插入图片描述
4、选上USB FS功能

5、继续“去中间层”，设置USB的识别类型。我们是虚拟口，所以选VCP设备。

6、配置系统时钟树参数。我的外部晶振是12M，所以要得到72M时钟，要选择倍频系数为6倍频。（晶振是8M则选择9倍频）
注意USB时钟要为48M。所以选1.5分频。
在这里插入图片描述
7、配置结束，去设置工程保存的位置。注意工具和版本。

8、生成工程。

9、打开工程，已经直接生成好了USB虚拟串口的代码。并可以直接编译不报错。

int main(void)
{
  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_USB_DEVICE_Init();
  /* USER CODE BEGIN 2 */

  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}

10、这个时候载入生成的文件到MCU里，是不枚举的。因为自动生成的代码里，只完成初始化等一些基本功能。
在这里插入图片描述

PA13上拉以及收、发函数还需要我们自己完善才可以。

11、加入PA13上拉。编译载入，可以看到枚举出了com12虚拟口。

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_USB_DEVICE_Init();
  /* USER CODE BEGIN 2 */
  HAL_GPIO_WritePin(GPIOA, GPIO_PIN_13, GPIO_PIN_SET);

在这里插入图片描述
12、调用发送函数。发送使用的是CDC_Transmit_FS函数。
所以我们在系统运行时，直接扔出个信息查看。编译并运行。发现确实有扔出信息（USB SYSTEM ON）。

13、调用接收函数CDC_Receive_FS。在CDC_Receive_FS里，把收到的数据进行计数以及保存。

static int8_t CDC_Receive_FS(uint8_t* Buf, uint32_t *Len)
{
  /* USER CODE BEGIN 6 */
	if(*Len<0x100)
	{
		uint16_t i;
		receive_len = *Len;
		for(i=0;i<*Len;i++)
			receivebuf[i] = Buf[i];
	}
	
  USBD_CDC_SetRxBuffer(&hUsbDeviceFS, &Buf[0]);
  USBD_CDC_ReceivePacket(&hUsbDeviceFS);
  return (USBD_OK);
  /* USER CODE END 6 */
}

14、做好了接收，我们在main里判断，接收的数据非空，则直接输出收到的数据。到此工程结束。

int main(void)
{
  /* USER CODE BEGIN 1 */
	uint32_t i;
	
  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_USB_DEVICE_Init();
  /* USER CODE BEGIN 2 */
	HAL_GPIO_WritePin(GPIOA, GPIO_PIN_13, GPIO_PIN_SET);
  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
	for(i = 0;i < 5;i++)
	{
		HAL_GPIO_WritePin(GPIOD, GPIO_PIN_2, GPIO_PIN_RESET);
		delay_1000ms();
		HAL_GPIO_WritePin(GPIOD, GPIO_PIN_2, GPIO_PIN_SET);
		delay_1000ms();
	}

	CDC_Transmit_FS("USB SYSTEM ON\r\n",15);
	
  while (1)
  {
		if(receive_len!=0)
		{
			CDC_Transmit_FS(receivebuf,receive_len);
			receive_len = 0;
			memset(receivebuf,0,sizeof(receivebuf));
		}

		
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}