初涉USB，初学者USB入门总结USB上位机读写开发，请高手指点下！！！

Posted 2023-05-07

参考技术A 固件的程序和驱动编写好了后，把设备插入就可以正确识别到，接下来的工作就是如何用上位机读写设备了。其实读写操作跟读写串口一致的，就是用file进行操作。关键是打开设备，下面是我用到的程序，这里都贴出来吧，我都是用这个的，供大家参考，呵呵，如果刚开始弄的话，估计得弄上个一个星期才行，用这个程序修改一下，两分钟搞定。
其中GUID
ClassGuid
是你在驱动中生成的一个号，它必须跟你的驱动对应起来，这个号的位置在驱动程序的XXXDeviceInterface.h中的#define
XXXDevice_CLASS_GUID
\....（XXX表示你起的工程名字）。把这个号替换之后用FpOpenDevice打开设备，得到一个读句柄，一个写句柄，然后在自己的程序中用readfile和writefile读写设备就可以了，注意，不管是读还是写，都是主机发出的，设备不能主动发发数据。比如上位机中运行readfile，就会发送一个IN指令，设备接到IN指令后，会把缓冲区的内容发出。
这一方面，想简单可以简单，想复杂可以负责的，，
上位机包括驱动和应用两层。一般为了使自己的程序更通用并且适合做
再加工，，都是在驱动和界面程序中间加个dll什么的，，作为中间层。
简单说的话，你可以下载公版驱动，和针对于该驱动的dll，，
开发者直接调用dll
export出来的接口函数，完成开发，，跟一般的
软件开发差不多，，只有你会调用dll。。当然这里还有一个问题就是，
你还要和下位机软件开发的人一起制定一个协议什么的，，来具体完成
一些数据状态的交换。。。。
如果要写驱动，，相对教难些，，不过可以上网上下载些类似的源码，，
参考修改，，完成驱动。。。
推荐你去csdn，这个网站上有很多资源，注册都可以下载的 参考技术B 如果你是初学者，不建议你上来就USB协议呀，DDK呀，dll呀什么的，如果你很有时间，能全神贯注的扑在上面1年以上（每天8小时以上），那你可以去从头开始学。如果不是，只是想应用，那么建议你按照如下方法：
1、市面上有很多集成了USB模块的单片机，参照该单片机的器件手册，画出原理图、PCB并调试；
2、一般单片机厂家都会提供USB程序框架，你只需要在人家的框架上增加自己的内容就可以了；
3、关于上位机的驱动，你做的东西如果是海量存储设备或人机接口设备等，就不用自己写USB驱动，你只需要会用VC或JAVA等语言调用驱动中的接口函数就行了，如果是比较特殊的设备，那还要要写USB驱动，这会用到windows的DDK，这可就复杂了，没有成年的专研是不会掌握的。

STM32 USB使用记录：使用CDC类虚拟串口（VCP）进行通讯

文章目录

• 目的
• 基础说明
• 使用STM32CubeIDE配置生成代码
• 用户代码分析
• 回环测试
• 串口参数设置
• USB HS使用与演示
• 通讯速率测试
• • 测试代码
  • USB FS测试
  • USB HS测试
  • 影响速度的因素
• 总结

目的

以往来说单片机和电脑通讯通常使用串口，串口使用起来很方便，不管是单片机本身启用串口还是上位机些串口程序都很简单。但是串口速度并不快，如果想要更加高速的和上位机通讯可以使用USB接口。

使用USB中的CDC类来虚拟串口 Virtual COM Port （VCP）进行通讯是一种非常好用的方式，一方面对于上位机来说显示出来的就是个串口，所有操作都还是对串口的操作；另一方面实际数据传输是基于USB的，数据传输速度得到大大提升。本文将对STM32作为从设备使用USB的CDC类虚拟串口（VCP）进行通讯的相关内容做个说明。

基础说明

USB相对来说是一个比较复杂的东西，涉及的东西挺多，这里只对本文使用上需要了解的相关内容进行简单的说明。

从USB版本来说目前STM32系列MCU可以认为都是USB2.0的（现在还有了UCPD，对外接口外形可以是Type-C的，但是这个是只能用于PD3.0充电使用的，无法用于数据通讯）。

从硬件接口功能上来说STM32系列MCU的USB分为 USB_FS 、 USB_OTG_FS 、 USB_OTG_HS 三种。其中的FS指的是全速（Full Speed），HS指的是高速（High Speed）。OTG指的是既可以作为Device（从设备）使用，也可以作为Host（主机）使用。

Full Speed 理论上速度为12Mbit/s，High Speed 理论上速度为480Mbit/s ，当然这都是理论速度，实际上通讯速度还依赖于所用通讯方式和设备性能。

对于STM32系列MCU而言，USB FS的使用只要使用 DM / D- 和 DP / D+ 这两个引脚就行了，最多也就加上ID、SOF、VBUS这三个引脚。而使用USB HS大多数还需要外接PHY芯片（比如USB3300），这样使用的引脚就多了，至少也要用到12个引脚。STM32系列MCU中目前只有STM32F723内置USB HS PHY功能，不需要外接PHY芯片。

STM32系列MCU在使用USB功能的时候建议使用外部时钟，外部无源晶体或有源晶振这些，因为USB对时钟精度要求比较高。

STM32 CDC VCP对于win10和较新版本的linux来说是免驱的，对于低版本的windows系统需要安装驱动，驱动下载地址如下：
STSW-STM32102 STM32 Virtual COM Port Driver
https://www.st.com/en/development-tools/stsw-stm32102.html

使用STM32CubeIDE配置生成代码

用STM32CubeIDE来实现VCP功能非常简单，只要在接口中启用USB，然后在中间件中使用USB库的CDC功能就行：

上面配置中主要涉及三个部分：

• 时钟配置
  使用USB推荐使用外部时钟，对于USB_FS而言其总线时钟一般为48MHz；
• 启用USB接口
  接口中启用USB，这里仅作为从设备使用（Device_Only）；
• 使用USB设备库
  中间件中启用USB_DEVICE库，使用CDC类（Communication Device Class Virtual Port Com）；
  参数设置主要与设备接口数量、电源、收发缓存等有关，一般默认即可；
  设备描述主要为VID和PID以及其文本描述；
  VID为厂商编码，可以在 https://www.usb.org/ 的 Developers 中找到，比如 1155 为 STMicroelectronics，如果你所在单位有自己的编码这里的VID和下面的厂商描述字符串就可以改成自己的；
  PID为产品编码，你可以自行更改这个编码和其下面的产品描述字符串；

按照上面的方式配置完成生成代码，直接编译下载到开发板中就可以进行测试了：

上图中可以看到在WIN10中显示出了该设备，设备被识别为串口设备，并且VID和PID和我们设置的相同。

上图是在树莓派中查看的，也可以被正确识别。

用户代码分析

上述配置生成的代码中，对于用户来说USB使用相关的代码都在 USB_DEVICE > App 中，这其中最重要的就是 usbd_cdc_if.c 文件，大多数时候我们只要改写这个文件就可以实现相关需求了，该文件主要结构与说明如下：

#include "usbd_cdc_if.h"

// 数据收发缓存，这部分也可以完全由用户自行定义
uint8_t UserRxBufferFS[APP_RX_DATA_SIZE]; // 接收缓存
uint8_t UserTxBufferFS[APP_TX_DATA_SIZE]; // 发送缓存

extern USBD_HandleTypeDef hUsbDeviceFS;

// 初始化USB_CDC
static int8_t CDC_Init_FS(void)
{
  USBD_CDC_SetTxBuffer(&hUsbDeviceFS, UserTxBufferFS, 0); // 设置发送缓存
  USBD_CDC_SetRxBuffer(&hUsbDeviceFS, UserRxBufferFS); // 设置接收缓存
}

// 反初始化USB_CDC
static int8_t CDC_DeInit_FS(void){}

// 来自主机的请求处理
// cmd: 命令代码
// pbuf & length: 请求数据指针与长度
static int8_t CDC_Control_FS(uint8_t cmd, uint8_t* pbuf, uint16_t length)
{
  switch(cmd)
  {
  /***********************************************************************************************/
  /* Line Coding Structure                                                                       */
  /*---------------------------------------------------------------------------------------------*/
  /* Offset | Field       | Size | Description                                                   */
  /* 0      | dwDTERate   |   4  | Data terminal rate, in bits per second                        */
  /* 4      | bCharFormat |   1  | Stop bits: 0 - 1 Stop bit; 1 - 1.5 Stop bits; 2 - 2 Stop bits */
  /* 5      | bParityType |   1  | Parity: 0 - None; 1 - Odd; 2 - Even; 3 - Mark; 4 - Space      */
  /* 6      | bDataBits   |   1  | Data bits (5, 6, 7, 8 or 16).                                 */
  /***********************************************************************************************/
    case CDC_SET_LINE_CODING: break; // 主机设置串口参数
  }
}

// 接收回调函数
// Buf & Len: 当前收到这一包数据指针与长度
static int8_t CDC_Receive_FS(uint8_t* Buf, uint32_t *Len)
{
  USBD_CDC_SetRxBuffer(&hUsbDeviceFS, &Buf[0]); // 重新设置接收缓存
  // 注意默认情况下上面一行代码相当于 USBD_CDC_SetRxBuffer(&hUsbDeviceFS, UserRxBufferFS);
  USBD_CDC_ReceivePacket(&hUsbDeviceFS); // 重新启动数据接收
}

// 数据发送函数
// Buf & Len: 要发送的数据指针与长度
uint8_t CDC_Transmit_FS(uint8_t* Buf, uint16_t Len)
{
  USBD_CDC_HandleTypeDef *hcdc = (USBD_CDC_HandleTypeDef*)hUsbDeviceFS.pClassData;
  if (hcdc->TxState != 0){
    return USBD_BUSY; // 如果当前USB繁忙则返回USBD_BUSY
  }
  USBD_CDC_SetTxBuffer(&hUsbDeviceFS, Buf, Len); // 设置要发送的数据
  result = USBD_CDC_TransmitPacket(&hUsbDeviceFS); // 发送数据
}

// 发送完成回调函数
// Buf & Len: 所送的数据指针与长度
static int8_t CDC_TransmitCplt_FS(uint8_t *Buf, uint32_t *Len, uint8_t epnum){}

上面代码中最常处理的只有下面四个函数：
CDC_Control_FS() 来自主机请求的回调函数
CDC_Receive_FS() 接收数据回调函数；
CDC_Transmit_FS() 用来发送数据；
CDC_TransmitCplt_FS() 发送完成回调函数；

回环测试

在官方生成的代码中只要添加一行代码就可以进行通讯回环测试了：

上面中在 CDC_Receive_FS 中添加了一行 CDC_Transmit_FS(Buf, *Len); 代码，可以看到演示中实现了回环效果，上位机不管发送什么数据下位机都会原样返回。并且可以发现不管上位机软件中波特率设置为多少都可以正常通讯，因为使用USB虚拟串口的时候真正数据传输用的是USB，串口本身参数这些已经无所谓了。

上面方式演示中其实存在一个问题，演示中并未体现出来，如果你尝试在上位机一次向下发送超过64个字节数据，那么你收到的返回数据可能就只有64个字节。USB数据的收发都是以一个一个包的形式进行的，包的大小一方面和USB协议有关，另一方面和程序有关。在上面工程的 usbd_cdc.h 文件中可以找到相关定义：

/* CDC Endpoints parameters:                                                         */
/* you can fine tune these values depending on the needed baudrates and performance. */
#define CDC_DATA_HS_MAX_PACKET_SIZE    512U  /* Endpoint IN & OUT Packet size */
#define CDC_DATA_FS_MAX_PACKET_SIZE    64U   /* Endpoint IN & OUT Packet size */
#define CDC_CMD_PACKET_SIZE            8U    /* Control Endpoint Packet size */

#define CDC_DATA_HS_IN_PACKET_SIZE     CDC_DATA_HS_MAX_PACKET_SIZE
#define CDC_DATA_HS_OUT_PACKET_SIZE    CDC_DATA_HS_MAX_PACKET_SIZE

#define CDC_DATA_FS_IN_PACKET_SIZE     CDC_DATA_FS_MAX_PACKET_SIZE
#define CDC_DATA_FS_OUT_PACKET_SIZE    CDC_DATA_FS_MAX_PACKET_SIZE

USB的 IN / OUT 都是从HOST而言说的，对于Device而言IN指的是发送，OUT指的是接收。 默认定义下USB_FS收发每一个包的大小均为64字节。 前的提的大于64的字节出现的问题中，第一次进入 CDC_Receive_FS 将接收到64个字节数据，这时候调用了 CDC_Transmit_FS 回发数据；接着重启接收将立马接到第二个包数据，然后第二次调用 CDC_Transmit_FS ，这个时候前一次的发送还未处理完成，此次调用将失败。

针对这个问题在使用的时候要合理设计数据收发逻辑。对于接收而言可以设计特殊字符用于标示一帧数据结束，或是设计超时时间来判断一帧数据结束。对于发送而言通常不会有太大问题，一次性发送大量数据也行，在全部发送完成后会触发发送完成回调函数CDC_TransmitCplt_FS；

串口参数设置

上一节中有说使用USB虚拟串口的时候真正数据传输用的是USB，串口本身参数这些已经无所谓了。不过有一种情况会需要这些串口参数，比如单片机一方面与上位机通过USB虚拟串口方式进行通讯，另一方面通过物理串口和其它模块进行通讯，单片机只做数据转发工作。这个时候单片机物理串口的参数就必须要能与其它模块匹配，这个参数如果要通过上位机来设置的话就需要对 CDC_Control_FS() 中的 CDC_SET_LINE_CODING 节点进行处理了：

要注意的是上位机每次设置串口参数可能会进入 CDC_SET_LINE_CODING 好几次。

USB HS使用与演示

目前来说除了STM32F723，其它支持USB HS的STM32系列MCU都需要外界的USB HS PHY芯片才能真正支持USB HS，最常见的比如USB3300，可以在某宝上买到相关的模块用来测试：

这个模块主要都是微雪电子或是防为微雪电子的，资料可以在这里找到 https://www.waveshare.net/wiki/USB3300_USB_HS_Board 。

这个模块支持做主从机和OTG切换实验用的，这里我们只用来测试当从机使用。作为从机使用时接线方式如下：

MCU端 USB HS模块 ULPI接口	USB3300模块端 ULPI接口	MCU端 USB HS模块 ULPI接口	USB3300模块端 ULPI接口
3.3V	3.3V	GND	GND
USB_HS_ULPI_STP	STP	USB_HS_ULPI_NXT	NXT
USB_HS_ULPI_DIR	DIR	USB_HS_ULPI_CK	CLK
USB_HS_ULPI_D0	DATA0	USB_HS_ULPI_D1	DATA1
USB_HS_ULPI_D2	DATA2	USB_HS_ULPI_D3	DATA3
USB_HS_ULPI_D4	DATA4	USB_HS_ULPI_D5	DATA5
USB_HS_ULPI_D6	DATA6	USB_HS_ULPI_D7	DATA7

接线上特别需要注意的一点是USB3300模块上的5V针脚并不能向外供电，而是使用OTG功能的时候需要从单片机向这里供电。另外在作为从机使用的时候USB线是插在这个模块的OTG接口上的。

下面是USB HS的配置与回环测试：

上面演示中使用了USB_OTG_HS，使能外部PHY为Devic only，要注意的是使用外部PHY时要保证AHB时钟频率不小于30MHz。（USB_OTG_HS也可以使能内部FS PHY，这样就可以作为另一个USB FS使用了。）

USB HS的代码和USB FS差不多，主要是各个函数与变量中的的FS字符变成了HS而已。上面演示中在 CDC_Receive_HS 中添加了一行 CDC_Transmit_HS(Buf, *Len); 代码进行回环测试。 默认定义下USB_HS收发每一个包的大小均为512字节。

通讯速率测试

测试代码

相比硬件串口而言，USB虚拟的串口速度可以变得非常快，图形化的串口工具已经无法用来测速了，这里用python写了个脚本进行测试，测试脚本如下：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

from typing import Counter
import serial
import serial.tools.list_ports
import time
import datetime

print('正在搜索串口……')
port_list = list(serial.tools.list_ports.comports())
print('发现串口：')
for i in range(0, len(port_list)):
    print(port_list[i])
print('')

port = input('请输入串口号，并按回车确认: ')
print('')

ser = serial.Serial(port, 22333, timeout=5)

run = True
count = 0
starttime = int(round(time.time() * 1000))

print(datetime.datetime.now().strftime('%H:%M:%S.%f') + '：开始测试单片机向上位机发送数据……')
ser.write('S'.encode('utf-8'))
while (run):
    ser.read(2048) # 接收来自单片机的数据
    count += 1
    currenttime = int(round(time.time() * 1000))
    run = False if (currenttime - starttime) >= 1000 else True

ser.write('E'.encode('utf-8'))
print(datetime.datetime.now().strftime('%H:%M:%S.%f') + '：结束测试，速度约为 ' + str(count * 2048 / 1000) + 'K Byte/s\\n')

sendbuf = bytes(2048)
run = True
count = 0
starttime = int(round(time.time() * 1000))

print(datetime.datetime.now().strftime('%H:%M:%S.%f') + '：开始测试单片机接收上位机的数据……')
while (run):
    count += ser.write(sendbuf) # 向单片机发送数据
    currenttime = int(round(time.time() * 1000))
    run = False if (currenttime - starttime) >= 1000 else True

print(datetime.datetime.now().strftime('%H:%M:%S.%f') + '：结束测试，速度约为 ' + str(count / 1000) + 'K Byte/s\\n')

ser.close()
exit()

该脚本需要配合单片机程序使用，STM32CubeIDE中使用前面演示的默认配置生成代码后对 usbd_cdc_if.c 文件部分内容进行修改：

/****************************** 第一处修改点 ******************************/
int flag = 0;

static int8_t CDC_Receive_FS(uint8_t* Buf, uint32_t *Len)
{
	if(Buf[0]=='S')
	{
		flag = 1;
		CDC_Transmit_FS(UserTxBufferFS, APP_TX_DATA_SIZE);
	}
	if(Buf[0]=='E')
	{
		flag = 0;
	}

  /* USER CODE BEGIN 6 */
  USBD_CDC_SetRxBuffer(&hUsbDeviceFS, &Buf[0]);
  USBD_CDC_ReceivePacket(&hUsbDeviceFS);
  return (USBD_OK);
  /* USER CODE END 6 */
}

/****************************** 第二处修改点 ******************************/
static int8_t CDC_TransmitCplt_FS(uint8_t *Buf, uint32_t *Len, uint8_t epnum)
{
  uint8_t result = USBD_OK;
  /* USER CODE BEGIN 13 */
  if(flag)
  {
	  CDC_Transmit_FS(UserTxBufferFS, APP_TX_DATA_SIZE);
  }

  UNUSED(Buf);
  UNUSED(Len);
  UNUSED(epnum);
  /* USER CODE END 13 */
  return result;
}

USB FS测试

准备好上面的内容就可以进行测速了（注意编译固件时使用Release版本）：


上面两幅图分别为使用USB FS在win10和树莓派中的测试过程，可以看到使用USB FS虚拟串口向上位机发送数据的速度约为 1000KByte/s ，接收来自上位机数据的速度约为 900KByte/s。这个数据如果换算成串口波特率的话分别约为 10000000 和 9000000 ，可以看到这个速度非常不错了。

USB HS测试

接下来看看USB HS的速度表现（注意编译固件时使用Release版本）：


上面测试中可以看到使用USB HS虚拟串口向上位机发送数据在win10和树莓派中速度分别约为 27000KByte/s 和 16000KByte/s ，接收来自上位机数据的速度约为 11000KByte/s。换算成串口波特率的话最大都已经达到 270000000 了，比常见的9600波特率快了27000倍不止。

影响速度的因素

上面几个测试中可以看到速度还是有差异的，特别是USB HS中上位机接收来自单片机的测速中win10和树莓派中速度出现了较大差异，这里列一下影响速度的一些因素:

• USB是主从协议，速度差异首先来自主机端
  • 主机硬件与系统性能； （USB HS中win10和树莓派速度差异来自于此）
  • 主机上对虚拟串口读写程序的性能； （上面的测试代码如果优化的好win10和树莓派中也可以测出相同的结果，我甚至于测出过30MByte/s的速度，不过那个代码不易于阅读）
• 排除了主机端的因素后就是单片机自身了
• 单片机性能；
• 固件编译参数； （试试用Debug版本编译，USB HS的速度会差非常多）
• 库程序性能； （比如调整前面提到的包大小这些就会影响速度）
• 用户程序性能； （实际使用中这个才是最影响性能的）

总结

STM32 USB使用CDC类虚拟串口（VCP）进行通讯主要就是上面这些内容了，更多内容可以在 https://www.stmcu.com.cn/ 搜索 《USB CDC类入门培训》 ，这个文档讲的还算简单明了：