STM32 适配 WinUSB

最新推荐文章于 2024-10-12 14:19:51 发布
最新推荐文章于 2024-10-12 14:19:51 发布
阅读量3.1k 收藏 44
点赞数 48
分类专栏： stm32 记录 文章标签： stm32 单片机 嵌入式硬件
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/gorgeousa/article/details/135370128
版权

基本上来说，STM32 在CubeMX生成的不同class的设备，都是支持windows免驱的，唯独在DFU模式的情况下，需要手动安装st的驱动才能实现功能，那么有什么办法能够在DFU模式下免驱呢，答案就是WinUSB。

废话不多说，我们用最简单明了的方式来实现此功能，上代码！

目前我们选用的都是Microsoft OS 2.0 描述符规范，因为1.0的描述符规范已经逐渐被微软抛弃了，在这里都没有什么存在的意义，1.0是通过请求0xEE的描述符来进行识别，到2.0是通过BOS的请求来获取完整的内容。

通过CubeMX生成基础程序

我这边选择的芯片是STM32F103，当然，其他有USB功能的STM芯片都是适用于这个功能的，我想既然打算开发WinUSB，这部分的内容读者都应该轻车熟路，所以我在这里省略，直接进入正题

修改代码

1.修改设备描述符

一般来说F4的设备需要使能USBD_LPM_ENABLED这个功能，最重要的一点，需要把bcdUSB的版本改为0x0210，这样windows才会试图请求BOS描述符，如下所示：

__ALIGN_BEGIN uint8_t USBD_FS_DeviceDesc[USB_LEN_DEV_DESC] __ALIGN_END =
{
  0x12,                       /*bLength */
  USB_DESC_TYPE_DEVICE,       /*bDescriptorType*/
  0x10,                       /*bcdUSB */ 修改此值
  0x02,
  0x00,                       /*bDeviceClass*/
  0x00,                       /*bDeviceSubClass*/
  0x00,                       /*bDeviceProtocol*/
  USB_MAX_EP0_SIZE,           /*bMaxPacketSize*/
  LOBYTE(USBD_VID),           /*idVendor*/
  HIBYTE(USBD_VID),           /*idVendor*/
  LOBYTE(USBD_PID_FS),        /*idProduct*/
  HIBYTE(USBD_PID_FS),        /*idProduct*/
  0x00,                       /*bcdDevice rel. 2.00*/
  0x02,
  USBD_IDX_MFC_STR,           /*Index of manufacturer  string*/
  USBD_IDX_PRODUCT_STR,       /*Index of product string*/
  USBD_IDX_SERIAL_STR,        /*Index of serial number string*/
  USBD_MAX_NUM_CONFIGURATION  /*bNumConfigurations*/
};

2.修改二进制描述符

将程序自动生成的二进制描述符改为如下所示，其中USB_REQ_GET_OS_FEATURE_DESCRIPTOR为请求的VendorCode，我们在下面会有提及

__ALIGN_BEGIN uint8_t USBD_FS_BOSDesc[33] __ALIGN_END =
{
  ///
  /// WCID20 BOS descriptor
  ///
  0x05,                                             /* bLength */
  USB_DESC_TYPE_BOS,                                /* bDescriptorType */
  0x21, 0x00,                                       /* wTotalLength */
  0x01,                                             /* bNumDeviceCaps */
  ///
  /// WCID20 device capability descriptor
  ///
  0x1c,                                             /* bLength */
  0x10,                                             /* bDescriptorType */
  0x05,                                             /* bDevCapabilityType */
  0x00,                                             /* bReserved */
  0xdf, 0x60, 0xdd, 0xd8, 0x89, 0x45, 0xc7, 0x4c,   /* bPlatformCapabilityUUID_16 */
  0x9c, 0xd2, 0x65, 0x9d, 0x9e, 0x64, 0x8a, 0x9f,   /* bPlatformCapabilityUUID_16 */
  0x00, 0x00, 0x03, 0x06,                           /* dwWindowsVersion */
  LOBYTE(WINUSB20_WCID_DESC_SET_SIZE), HIBYTE(WINUSB20_WCID_DESC_SET_SIZE),/* wDescriptorSetTotalLength */
  USB_REQ_GET_OS_FEATURE_DESCRIPTOR,                                 /* bVendorCode */
  0x00,    
};

3.增加WCID描述符

这是基础的单配置的最简单的WCID描述符，用于识别设备可用的window版本等信息

__ALIGN_BEGIN const uint8_t WINUSB20_WCIDDescriptorSet[WINUSB20_WCID_DESC_SET_SIZE] __ALIGN_END = {
  ///
  /// WCID20 descriptor set descriptor
  ///
  0x0a, 0x00,                                       /* wLength */
  0x00, 0x00,                                       /* wDescriptorType */
  0x00, 0x00, 0x03, 0x06,                           /* dwWindowsVersion */
  0xa2, 0x00,                                       /* wDescriptorSetTotalLength */ 
  ///
  /// WCID20 compatible ID descriptor
  ///
  0x14, 0x00,                                       /* wLength */
  0x03, 0x00,                                       /* wDescriptorType */
  /* WINUSB */
  'W', 'I', 'N', 'U', 'S', 'B', 0x00, 0x00,         /* cCID_8 */
  /*  */
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,   /* cSubCID_8 */
  ///
  /// WCID20 registry property descriptor
  ///
  0x84, 0x00,                                       /* wLength */
  0x04, 0x00,                                       /* wDescriptorType */
  0x07, 0x00,                                       /* wPropertyDataType */
  0x2a, 0x00,                                       /* wPropertyNameLength */
  /* DeviceInterfaceGUIDs */
  'D', 0x00, 'e', 0x00, 'v', 0x00, 'i', 0x00,       /* wcPropertyName_21 */
  'c', 0x00, 'e', 0x00, 'I', 0x00, 'n', 0x00,       /* wcPropertyName_21 */
  't', 0x00, 'e', 0x00, 'r', 0x00, 'f', 0x00,       /* wcPropertyName_21 */
  'a', 0x00, 'c', 0x00, 'e', 0x00, 'G', 0x00,       /* wcPropertyName_21 */
  'U', 0x00, 'I', 0x00, 'D', 0x00, 's', 0x00,       /* wcPropertyName_21 */
  0x00, 0x00,                                       /* wcPropertyName_21 */
  0x50, 0x00,                                       /* wPropertyDataLength */
  /* {36FC9E60-C465-11CF-8056-444553540000} */
  '{', 0x00, '3', 0x00, '6', 0x00, 'F', 0x00,       /* wcPropertyData_40 */
  'C', 0x00, '9', 0x00, 'E', 0x00, '6', 0x00,       /* wcPropertyData_40 */
  '0', 0x00, '-', 0x00, 'C', 0x00, '4', 0x00,       /* wcPropertyData_40 */
  '6', 0x00, '5', 0x00, '-', 0x00, '1', 0x00,       /* wcPropertyData_40 */
  '1', 0x00, 'C', 0x00, 'F', 0x00, '-', 0x00,       /* wcPropertyData_40 */
  '8', 0x00, '0', 0x00, '5', 0x00, '6', 0x00,       /* wcPropertyData_40 */
  '-', 0x00, '4', 0x00, '4', 0x00, '4', 0x00,       /* wcPropertyData_40 */
  '5', 0x00, '5', 0x00, '3', 0x00, '5', 0x00,       /* wcPropertyData_40 */
  '4', 0x00, '0', 0x00, '0', 0x00, '0', 0x00,       /* wcPropertyData_40 */
  '0', 0x00, '}', 0x00, 0x00, 0x00, 0x00, 0x00      /* wcPropertyData_40 */
};

以上都是在usbd_desc.h中添加的数据，下接下来还有2个文件需要修改

4.增加描述符的获取接口

打开usbd_def.h

先增加两个宏定义

#define  USB_REQ_GET_STATUS                             0x00U
#define  USB_REQ_CLEAR_FEATURE                          0x01U
#define  USB_REQ_SET_FEATURE                            0x03U
#define  USB_REQ_SET_ADDRESS                            0x05U
#define  USB_REQ_GET_DESCRIPTOR                         0x06U
#define  USB_REQ_SET_DESCRIPTOR                         0x07U
#define  USB_REQ_GET_CONFIGURATION                      0x08U
#define  USB_REQ_SET_CONFIGURATION                      0x09U
#define  USB_REQ_GET_INTERFACE                          0x0AU
#define  USB_REQ_SET_INTERFACE                          0x0BU
#define  USB_REQ_SYNCH_FRAME                            0x0CU
#define	 USB_REQ_GET_OS_FEATURE_DESCRIPTOR              0x20U //新增的
#define  MS_OS_20_DESCRIPTOR_INDEX                      0x07U //新增的

再增加两个接口的函数指针

typedef struct
{
  uint8_t  *(*GetDeviceDescriptor)(USBD_SpeedTypeDef speed, uint16_t *length);
  uint8_t  *(*GetLangIDStrDescriptor)(USBD_SpeedTypeDef speed, uint16_t *length);
  uint8_t  *(*GetManufacturerStrDescriptor)(USBD_SpeedTypeDef speed, uint16_t *length);
  uint8_t  *(*GetProductStrDescriptor)(USBD_SpeedTypeDef speed, uint16_t *length);
  uint8_t  *(*GetSerialStrDescriptor)(USBD_SpeedTypeDef speed, uint16_t *length);
  uint8_t  *(*GetConfigurationStrDescriptor)(USBD_SpeedTypeDef speed, uint16_t *length);
  uint8_t  *(*GetInterfaceStrDescriptor)(USBD_SpeedTypeDef speed, uint16_t *length);
#if (USBD_LPM_ENABLED == 1U)
  uint8_t  *(*GetBOSDescriptor)(USBD_SpeedTypeDef speed, uint16_t *length);
#if (USBD_WINUSB_ENABLED == 1U)
  uint8_t  *(*GetWCIDDescriptor)(USBD_SpeedTypeDef speed, uint16_t *length); //新增的
#endif
#endif
} USBD_DescriptorsTypeDef;

5.实现描述符的获取函数

首先在usbd_desc.c中声明函数

uint8_t * USBD_FS_DeviceDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_FS_LangIDStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_FS_ManufacturerStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_FS_ProductStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_FS_SerialStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_FS_ConfigStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_FS_InterfaceStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
#if (USBD_LPM_ENABLED == 1U)
uint8_t * USBD_FS_BOSDescriptor(USBD_SpeedTypeDef speed, uint16_t *length); //新增
#if (USBD_WINUSB_ENABLED == 1U)
uint8_t * USBD_FS_WCIDDescriptor(USBD_SpeedTypeDef speed, uint16_t *length); //新增
#endif
#endif

在结构体中增加函数调用

USBD_DescriptorsTypeDef FS_Desc =
{
  USBD_FS_DeviceDescriptor
, USBD_FS_LangIDStrDescriptor
, USBD_FS_ManufacturerStrDescriptor
, USBD_FS_ProductStrDescriptor
, USBD_FS_SerialStrDescriptor
, USBD_FS_ConfigStrDescriptor
, USBD_FS_InterfaceStrDescriptor
#if (USBD_LPM_ENABLED == 1U)
, USBD_FS_BOSDescriptor //新增
#if (USBD_WINUSB_ENABLED == 1U)
, USBD_FS_WCIDDescriptor //新增
#endif
#endif
};

最后，增加函数实现

#if (USBD_LPM_ENABLED == 1U)
uint8_t * USBD_FS_BOSDescriptor(USBD_SpeedTypeDef speed, uint16_t *length) 
{
  UNUSED(speed);
  *length = sizeof(USBD_FS_BOSDesc);
  return (uint8_t*)USBD_FS_BOSDesc;
}
#if (USBD_WINUSB_ENABLED == 1U)
uint8_t * USBD_FS_WCIDDescriptor(USBD_SpeedTypeDef speed, uint16_t *length)
{
  UNUSED(speed);
  *length = sizeof(WINUSB20_WCIDDescriptorSet);
  return (uint8_t*)WINUSB20_WCIDDescriptorSet;
}
#endif
#endif

6.增加Vendor接口的实现

打开usbd_ctlreq.c文件，在文件中新增函数声明

static void USBD_GetDescriptor(USBD_HandleTypeDef *pdev,
                               USBD_SetupReqTypedef *req);

static void USBD_SetAddress(USBD_HandleTypeDef *pdev,
                            USBD_SetupReqTypedef *req);

static void USBD_SetConfig(USBD_HandleTypeDef *pdev,
                           USBD_SetupReqTypedef *req);

static void USBD_GetConfig(USBD_HandleTypeDef *pdev,
                           USBD_SetupReqTypedef *req);

static void USBD_GetStatus(USBD_HandleTypeDef *pdev,
                           USBD_SetupReqTypedef *req);

static void USBD_SetFeature(USBD_HandleTypeDef *pdev,
                            USBD_SetupReqTypedef *req);

static void USBD_ClrFeature(USBD_HandleTypeDef *pdev,
                            USBD_SetupReqTypedef *req);
#if (USBD_LPM_ENABLED == 1)
static void USBD_GetVendor(USBD_HandleTypeDef *pdev,
                            USBD_SetupReqTypedef *req); //新增的
#endif
static uint8_t USBD_GetLen(uint8_t *buf);

在文件中新增函数实现

#if (USBD_LPM_ENABLED == 1)
static void USBD_GetVendor(USBD_HandleTypeDef *pdev,
                            USBD_SetupReqTypedef *req)
{
  uint16_t len = 0U;
  uint8_t *pbuf = NULL;

  switch (req->wIndex) 
  {
	  case MS_OS_20_DESCRIPTOR_INDEX: //MS OS 2.0 的7号请求
      if (pdev->pDesc->GetWCIDDescriptor != NULL)
      {
        pbuf = pdev->pDesc->GetWCIDDescriptor(pdev->dev_speed, &len);
      }
      else
      {
        USBD_CtlError(pdev, req);
      }
    break;
  }

  if((len != 0)&& (req->wLength != 0))
  {
    len = MIN(len , req->wLength);
    
    USBD_CtlSendData (pdev, 
                      pbuf,
                      len);
  }  
}
#endif

最后，修改USBD_StdDevReq函数的前部分为

USBD_StatusTypeDef  USBD_StdDevReq(USBD_HandleTypeDef *pdev,
                                   USBD_SetupReqTypedef *req)
{
  USBD_StatusTypeDef ret = USBD_OK;

  switch (req->bmRequest & USB_REQ_TYPE_MASK)
  {
    case USB_REQ_TYPE_VENDOR:
#if (USBD_LPM_ENABLED == 1)    
      USBD_GetVendor(pdev, req);
      break;    
#endif      
    case USB_REQ_TYPE_CLASS:
      pdev->pClass->Setup(pdev, req);
      break;

修改USBD_StdItfReq函数的前部分为

USBD_StatusTypeDef  USBD_StdItfReq(USBD_HandleTypeDef *pdev,
                                   USBD_SetupReqTypedef  *req)
{
  USBD_StatusTypeDef ret = USBD_OK;

  switch (req->bmRequest & USB_REQ_TYPE_MASK)
  {
    case USB_REQ_TYPE_VENDOR:
#if (USBD_LPM_ENABLED == 1)   
      USBD_GetVendor(pdev, req);  
      break;
#endif      
    case USB_REQ_TYPE_CLASS:
    case USB_REQ_TYPE_STANDARD:

修改USBD_StdEPReq的前部分为

USBD_StatusTypeDef  USBD_StdEPReq(USBD_HandleTypeDef *pdev,
                                  USBD_SetupReqTypedef  *req)
{
  USBD_EndpointTypeDef *pep;
  uint8_t   ep_addr;
  USBD_StatusTypeDef ret = USBD_OK;
  ep_addr  = LOBYTE(req->wIndex);

  switch (req->bmRequest & USB_REQ_TYPE_MASK)
  {
    case USB_REQ_TYPE_VENDOR:
#if (USBD_LPM_ENABLED == 1) 
      USBD_GetVendor(pdev, req);
      break;
#endif      
    case USB_REQ_TYPE_CLASS:
      pdev->pClass->Setup(pdev, req);
      break;

这个目的是获取vendor的支持

最后

到此，程序应该可以被识别成winUSB设备了，如图所示

网上有很多教程混淆了1.0和2.0的概念，导致大家可能遇到0xEE请求无法收到的情况，这主要是目前使用的2.0已经废除了这个读取的步骤，在此我作为记录，以后再有需求就不会忘记

参考链接

STM32F407实现USB BULK传输+WINUSB免驱

Microsoft OS 2.0 描述符规范

合理说明
关注
专栏目录
WinUSB STM32 含多种驱动及工具
10-08
基于ST 3.5库函数的STM32F1XX系列SOC；非官方开发板的可以直接替换STM32F1XX V3.3.0 (WinUSB)中usb_desc.c及.h,usb_prop.c及.h；只有CUSTOM_HID实现了winusb；win7以上无需驱动即可识别，也可通过zadig查看及安装其他驱动（如libusbk，libusb）；device-monitoring-studio工具为usb数据监测工具；libusb中examples工具xusb可读取usb信息，具体用法可以-h；包含的工具若有疑问请百度；已验证
STM32F103ZET6_USB_自定义BULK
11-19
实现USB的块传输，可通过libusb做上位机实现通讯。速度测试可以达到900K左右。
STM32F4的USB接口学习笔记-虚拟键盘
最新发布
Sean的博客
10-12 983
用STM32单片机模拟一个USB键盘
STM32 WinUSB
11-02
stm32无需安装vcp驱动程序了 1 修改stm32 cdc，将stm cdc变为winusb类型设备 2 制作一个inf,插入usb时可作为驱动的选择 3 winusb .net中间件来作为上位机与stm32的usb通讯模块
STM32 USB高速USB端口加持4G联网
fhqlongteng的博客
07-07 1630
关于STM32F4USB驱动程序（FULL SPEED）目前是可以用，但是有很多问题，比如NAK的问题，导致U盘读写出错。USB底层驱动程序中进行OUT传输时必须增加一个1ms延时的问题。等等储多问题。本文高速USB的驱动程序参考了网友@sakumisu的文章：[基于 CherryUSB 调试 dwc2 usb host 笔记](https://club.rt-thread.org/ask/article/9c31ce71ead26c2b.html "基于 CherryUSB 调试 dwc2 usb hos
STM32F1XX使用WinUSB
06-10
搞这个STM32的USB很久了，最近知道WinUSB这个好东西，可惜国内的资料太少了，出去，终于找到好东西了，不敢藏私，献给各位程序猿同类们，顺便赚点积分^_^
WINUSB STM32移植参考
假不假，生来只为写代码
10-12 5114
1为什么用WINUSB？ 据说WINUSB是免驱的，那HID也是免驱的，用HID不是一样吗？ 不一样！ HID采用中断传输，传输速度上不去，如果是使用的是USB2.0 FULL speed，那速度更低，可能很多场合都满足不了了。但是WINUSB就不一样了，winusb可以采用批量传输，数据吞吐量大大提高。 2 WINUSB对下位机的要求 我参考了2个例子，一个老外的一个国内的。都 是在stm32上实现WINUSB功能，我大概看了下程序，并认真分析了，这2个例子都是从STM32 CDC例子修改来的，.
STM32 WinUSB(WCID)免驱高速通信 20M/s（附详细测试）
热门推荐
bingwueyi的博客
11-29 1万+
WinUSB 免驱高速通信，STM32工程详细配置及修改，C#上位机Windows全平台测试
STM32+WinUSB（部分文件）
04-18
在公司做嵌入式的实习，让我讲一个U盘识别成WinUSB设备，实现无驱动。在网上找了很多资料，也下过一些，但是我还是懵里懵懂。借到公司的USB分析仪，抓取了枚举过程中的命令，再结合相关知识，在对应的位置修改就可以啦。 由于是公司的项目，只能上传一些文件。
STM32F407实现USB BULK传输+WINUSB免驱
dbxzjq的专栏
08-24 5672
记录一下使用stm32_f105-07_f2_f4_usb-host-device_lib固件库用STM32F407实现USB BULK传输+WINUSB免驱的过程，作为以后忘记后的一个参考记忆
STM32USB虚拟串口驱动 支持win10
10-04
总的来说，STM32USB虚拟串口驱动是STM32开发中不可或缺的一部分，它使得STM32与PC间的通信变得更加便捷。无论是固件升级、数据传输还是调试，这个驱动都扮演着至关重要的角色。对于Windows 10用户来说，确保驱动版本...
STM32F1XX V3.3.0 (WinUSB).rar
06-11
STM32F1XX V3.3.0 (WinUSB)，这个例子是stm32和winusb的通讯实例，供大家参考
STM32 Winusb转串口与并口
03-05
WinUSB设备windos可以免驱使用，STM32系列的芯片自带了USB2.0的接口和全速PHY，支持12MBps的全速USB模式。 STM32F103C8T6最小系统板 - USART1:串口输入与输出 ​ 串口以";"为结束符； ​ STM32串口发送“1234;”====>>USB收到“1234” - PA0-PA8:并口输出 - PC13:电平翻转引脚
STM32_USB-Host-Device_Lib_V2.1.0 (WINUSB HID)
09-14
STM32_USB-Host-Device_Lib_V2.1.0 (WINUSB HID)
PC端连接USB设备通信案例（STM32实现USB设备）
06-25
实现PC端与USB设备之间的简单通信，可以帮助理解USB通信，PC端程序主要是驱动编写，USB设备通过STM32f103ZET6实现。
stm32 USB虚拟串口驱动 全系列 全兼容（无V10）
07-12
stm32 USB虚拟串口驱动 全系列兼容。支持win7，win8 ，win10. 我是win10的系统，之前网上找的驱动都安装不上。也有说win10自带驱动，但我识别出来是打叹号的不能用。后来找到这个，按装完后，能正常使用了。分享给大家
STM32 RTT学习笔记（二）外设驱动添加(uart)
12-02
STM32 RTT学习笔记（二）主要涉及在RT-Thread实时操作系统上为STM32F407VET6芯片添加UART（通用异步收发传输器）外设驱动的过程。RT-Thread是一个轻量级、高效率的嵌入式实时操作系统，广泛应用于物联网和嵌入式系统...
开源STM32F4xx自定义USB数据传输，支持Windows,Linux,Android,速度高达1MBytes
07-24
在Windows上，libusb通过libusb-win32驱动实现USB通信。Linux系统则通常内建了libusb支持，而在Android平台上，我们需要利用libusb的NDK接口，并可能需要对设备进行额外的权限设置。 总结来说，实现开源STM32F4xx...
stm32cubemx
11-09
STM32CubMX的最新版本为“win-v6-9-2”，适配于Windows操作系统，这表明它是一款面向Windows用户的软件。 该软件的核心功能包括以下几点： 1. **MCU配置**：STM32CubMX允许用户根据项目需求选择合适的STM32系列微...
stm32 winusb
09-22
stm32 winusb是一种通用串行总线(USB)设备，其固件定义了某些Microsoft操作系统(OS)特征描述符，将兼容ID报告为"WINUSB"。WinUSB设备的作用是让Windows将Winusb.sys作为设备的功能驱动程序载入，而无需自定义INF文件。对于WinUSB设备，无需为设备分发INF文件，这大大简化了驱动程序安装过程。
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值