STM32CubeMX | 基于STM32使用HAL庫實現(xiàn)USB組合設(shè)備之多路CDC

---

本博客完整代碼下載地址：https://download.csdn.net/download/qq153471503/18169362

或關(guān)注以下公眾號，回復(fù)關(guān)鍵字MultiCDC獲取下載鏈接！

---

目錄

• STM32CubeMX | 基于STM32使用HAL庫實現(xiàn)USB組合設(shè)備之多路CDC
• • • 第一步：基礎(chǔ)工程生成
    • 第二步：USB設(shè)備描述符的修改
    • 第三步：修改PMA端點分布
    • 第四步：修改配置描述符
    • 第五步：修改函數(shù)接口
    • 注意事項及問題
    • 補充：3路CDC實現(xiàn)

---

1、本篇文章已經(jīng)默認您已經(jīng)會使用STM32CUBEMX生成CDC工程并測試通過了，如果你還不會可參考我的另一篇博客：STM32快速實現(xiàn)USB虛擬串口+回環(huán)測試+USB轉(zhuǎn)TTL的功能

2、USB組合設(shè)備的編寫需要具備一定的USB相關(guān)知識，如果你不了解，那么請先看一下我的這篇博客：STM32 USB相關(guān)知識掃盲

---

工程環(huán)境：

• STM32F103RC
• STM32CubeIDE 1.5.1

---

第一步：基礎(chǔ)工程生成

~~~~~~~~????????首先先用STM32CUBEMX生成CDC工程，并測試通過沒有問題后，就可以著手開始下一步的修改，如果你還不了解CDC虛擬串口，那么可以參考文章開頭鏈接第一條說明里的博客內(nèi)容。

---

第二步：USB設(shè)備描述符的修改

~~~~~~~~????????這一步很簡單的，就是修改usbd_desc.c中的設(shè)備描述符數(shù)組USBD_FS_DeviceDesc，將設(shè)備類型改為組合設(shè)備類型：

---

第三步：修改PMA端點分布

然后進入usbd_conf.c文件中，找到USBD_LL_Init函數(shù)，修改PMA端點初始化：

說一下PMA為什么這么改，目前我們用到的端點有：

• 0X80、0X00為USB所必須的端點
• 0X81、0X01為CDC1的輸入輸出端點
• 0X82、0X02為CDC2的輸入輸出端點
• 0X83為CDC1的命令控制端點（0X03端點未使用，但是占用空間）
• 0X84為CDC2的命令控制端點（0X04端點未使用，但是占用空間）

所以一共10個端點，10x8=80字節(jié)，十六進制為0X50，所以端點的緩存地址就是從PMA偏移0X50地址處開始。

輸入輸出端點最大可配置為64字節(jié)的緩存，所以是自增0X40。

命令端點的緩存數(shù)據(jù)大小是8字節(jié)緩存，自增16字節(jié)是因為光用到了輸入端點，輸出端點沒用但是占用PMA空間，所以是自增0X10。

如下圖指示是8字節(jié)：

接下修改端點初始化，找到USBD_CDC_Init函數(shù)，添加CDC2的端點初始化操作：

static uint8_t USBD_CDC_Init(USBD_HandleTypeDef *pdev, uint8_t cfgidx) {uint8_t ret = 0U;USBD_CDC_HandleTypeDef *hcdc;if (pdev->dev_speed == USBD_SPEED_HIGH){/* Open EP IN */USBD_LL_OpenEP(pdev, CDC_IN_EP, USBD_EP_TYPE_BULK,CDC_DATA_HS_IN_PACKET_SIZE);pdev->ep_in[CDC_IN_EP & 0xFU].is_used = 1U;/* Open EP OUT */USBD_LL_OpenEP(pdev, CDC_OUT_EP, USBD_EP_TYPE_BULK,CDC_DATA_HS_OUT_PACKET_SIZE);pdev->ep_out[CDC_OUT_EP & 0xFU].is_used = 1U;}else{/* Open EP IN */USBD_LL_OpenEP(pdev, CDC_IN_EP, USBD_EP_TYPE_BULK,CDC_DATA_FS_IN_PACKET_SIZE);pdev->ep_in[CDC_IN_EP & 0xFU].is_used = 1U;/* Open EP OUT */USBD_LL_OpenEP(pdev, CDC_OUT_EP, USBD_EP_TYPE_BULK,CDC_DATA_FS_OUT_PACKET_SIZE);pdev->ep_out[CDC_OUT_EP & 0xFU].is_used = 1U;/ +++lakun /* Open EP IN */USBD_LL_OpenEP(pdev, CDC2_IN_EP, USBD_EP_TYPE_BULK,CDC_DATA_FS_IN_PACKET_SIZE);pdev->ep_in[CDC2_IN_EP & 0xFU].is_used = 1U;/* Open EP OUT */USBD_LL_OpenEP(pdev, CDC2_OUT_EP, USBD_EP_TYPE_BULK,CDC_DATA_FS_OUT_PACKET_SIZE);pdev->ep_out[CDC2_OUT_EP & 0xFU].is_used = 1U;}/* Open Command IN EP */USBD_LL_OpenEP(pdev, CDC_CMD_EP, USBD_EP_TYPE_INTR, CDC_CMD_PACKET_SIZE);pdev->ep_in[CDC_CMD_EP & 0xFU].is_used = 1U;/ +++lakun /* Open Command IN EP */USBD_LL_OpenEP(pdev, CDC2_CMD_EP, USBD_EP_TYPE_INTR, CDC_CMD_PACKET_SIZE);pdev->ep_in[CDC2_CMD_EP & 0xFU].is_used = 1U;pdev->pClassData = USBD_malloc(sizeof(USBD_CDC_HandleTypeDef));if (pdev->pClassData == NULL){ret = 1U;}else{hcdc = (USBD_CDC_HandleTypeDef *) pdev->pClassData;/* Init physical Interface components */((USBD_CDC_ItfTypeDef *)pdev->pUserData)->Init();/* Init Xfer states */hcdc->TxState = 0U;hcdc->RxState = 0U;if (pdev->dev_speed == USBD_SPEED_HIGH){/* Prepare Out endpoint to receive next packet */USBD_LL_PrepareReceive(pdev, CDC_OUT_EP, hcdc->RxBuffer,CDC_DATA_HS_OUT_PACKET_SIZE);}else{/* Prepare Out endpoint to receive next packet */USBD_LL_PrepareReceive(pdev, CDC_OUT_EP, hcdc->RxBuffer,CDC_DATA_FS_OUT_PACKET_SIZE);/ +++lakun /* Prepare Out endpoint to receive next packet */USBD_LL_PrepareReceive(pdev, CDC2_OUT_EP, hcdc->RxBuffer,CDC_DATA_FS_OUT_PACKET_SIZE);}}return ret; }

注：這一步驟的修改都非常掛關(guān)鍵，好多人組合設(shè)備修改出錯的原因就是在修改PMA這里出的問題！在本文章起始處的藍色鏈接《STM32 USB知識掃盲》文中有對PAM的詳細講解，一定要仔細看一下并理解！

---

第四步：修改配置描述符

貼一下我修改好的兩路CDC配置，修改過的地方都有+++lakun樣的標記：

/* USB CDC device Configuration Descriptor */ __ALIGN_BEGIN uint8_t USBD_CDC_CfgFSDesc[USB_CDC_CONFIG_DESC_SIZ] __ALIGN_END = {/*Configuration Descriptor*/0x09, /* bLength: Configuration Descriptor size */USB_DESC_TYPE_CONFIGURATION, /* bDescriptorType: Configuration */USB_CDC_CONFIG_DESC_SIZ, /* wTotalLength:no of returned bytes */0x00,0x04, /* bNumInterfaces: 4 interface */ /* +++lakun：一個CDC用到了連個接口，兩個CDC就是4個接口 */0x01, /* bConfigurationValue: Configuration value */0x00, /* iConfiguration: Index of string descriptor describing the configuration */0xC0, /* bmAttributes: self powered */0x32, /* MaxPower 0 mA *//*---------------------------------------------------------------------------*///// +++lakun: IAD(Interface Association Descriptor)//0X08, // bLength: Interface Descriptor size，固定值0X0B, // bDescriptorType: IAD，固定值0X00, // bFirstInterface，第一個接口的起始序號0X02, // bInterfaceCount，本IAD下的接口數(shù)量0X02, // bFunctionClass: CDC，表明該IAD是一個CDC類型的設(shè)備0X02, // bFunctionSubClass：子類型，默認即可0X01, // bFunctionProtocol：控制協(xié)議，默認即可0X02, // iFunction/*Interface Descriptor */0x09, /* bLength: Interface Descriptor size */USB_DESC_TYPE_INTERFACE, /* bDescriptorType: Interface *//* Interface descriptor type */0x00, /* bInterfaceNumber: Number of Interface */ /* +++lakun:接口編號，從0開始 */0x00, /* bAlternateSetting: Alternate setting */0x01, /* bNumEndpoints: One endpoints used */0x02, /* bInterfaceClass: Communication Interface Class */0x02, /* bInterfaceSubClass: Abstract Control Model */0x01, /* bInterfaceProtocol: Common AT commands */0x00, /* iInterface: *//*Header Functional Descriptor*/0x05, /* bLength: Endpoint Descriptor size */0x24, /* bDescriptorType: CS_INTERFACE */0x00, /* bDescriptorSubtype: Header Func Desc */0x10, /* bcdCDC: spec release number */0x01,/*Call Management Functional Descriptor*/0x05, /* bFunctionLength */0x24, /* bDescriptorType: CS_INTERFACE */0x01, /* bDescriptorSubtype: Call Management Func Desc */0x00, /* bmCapabilities: D0+D1 */0x01, /* bDataInterface: 1 *//*ACM Functional Descriptor*/0x04, /* bFunctionLength */0x24, /* bDescriptorType: CS_INTERFACE */0x02, /* bDescriptorSubtype: Abstract Control Management desc */0x02, /* bmCapabilities *//*Union Functional Descriptor*/0x05, /* bFunctionLength */0x24, /* bDescriptorType: CS_INTERFACE */0x06, /* bDescriptorSubtype: Union func desc */0x00, /* bMasterInterface: Communication class interface */ /* +++lakun:這里指示的是本CDC的通信接口編號 */0x01, /* bSlaveInterface0: Data Class Interface */ /* +++lakun:這里指示的是本CDC的數(shù)據(jù)接口編號 *//*Endpoint 2 Descriptor*/0x07, /* bLength: Endpoint Descriptor size */USB_DESC_TYPE_ENDPOINT, /* bDescriptorType: Endpoint */CDC_CMD_EP, /* bEndpointAddress */0x03, /* bmAttributes: Interrupt */LOBYTE(CDC_CMD_PACKET_SIZE), /* wMaxPacketSize: */HIBYTE(CDC_CMD_PACKET_SIZE),CDC_FS_BINTERVAL, /* bInterval: *//*---------------------------------------------------------------------------*//*Data class interface descriptor*/0x09, /* bLength: Endpoint Descriptor size */USB_DESC_TYPE_INTERFACE, /* bDescriptorType: */0x01, /* bInterfaceNumber: Number of Interface */ /* +++lakun:CDC1的數(shù)據(jù)接口編號 */0x00, /* bAlternateSetting: Alternate setting */0x02, /* bNumEndpoints: Two endpoints used */0x0A, /* bInterfaceClass: CDC */0x00, /* bInterfaceSubClass: */0x00, /* bInterfaceProtocol: */0x00, /* iInterface: *//*Endpoint OUT Descriptor*/0x07, /* bLength: Endpoint Descriptor size */USB_DESC_TYPE_ENDPOINT, /* bDescriptorType: Endpoint */CDC_OUT_EP, /* bEndpointAddress */0x02, /* bmAttributes: Bulk */LOBYTE(CDC_DATA_FS_MAX_PACKET_SIZE), /* wMaxPacketSize: */HIBYTE(CDC_DATA_FS_MAX_PACKET_SIZE),0x00, /* bInterval: ignore for Bulk transfer *//*Endpoint IN Descriptor*/0x07, /* bLength: Endpoint Descriptor size */USB_DESC_TYPE_ENDPOINT, /* bDescriptorType: Endpoint */CDC_IN_EP, /* bEndpointAddress */0x02, /* bmAttributes: Bulk */LOBYTE(CDC_DATA_FS_MAX_PACKET_SIZE), /* wMaxPacketSize: */HIBYTE(CDC_DATA_FS_MAX_PACKET_SIZE),0x00, /* bInterval: ignore for Bulk transfer *///// +++lakun: IAD(Interface Association Descriptor)//0X08, // bLength: Interface Descriptor size，固定值0X0B, // bDescriptorType: IAD，固定值0X02, // bFirstInterface，第一個接口的起始序號（第0、1編號的接口用于CDC1，現(xiàn)在是第二個CDC了，所以從2開始）0X02, // bInterfaceCount，本IAD下的接口數(shù)量0X02, // bFunctionClass: CDC，表明該IAD是一個CDC類型的設(shè)備0X02, // bFunctionSubClass：子類型，默認即可0X01, // bFunctionProtocol：控制協(xié)議，默認即可0X02, // iFunction/*Interface Descriptor */0x09, /* bLength: Interface Descriptor size */USB_DESC_TYPE_INTERFACE, /* bDescriptorType: Interface *//* Interface descriptor type */0x02, /* bInterfaceNumber: Number of Interface */ /* +++lakun：這里就是第二個CDC了，第0、1編號的接口給CDC1使用了，所以是2開始的 */0x00, /* bAlternateSetting: Alternate setting */0x01, /* bNumEndpoints: One endpoints used */0x02, /* bInterfaceClass: Communication Interface Class */0x02, /* bInterfaceSubClass: Abstract Control Model */0x01, /* bInterfaceProtocol: Common AT commands */0x00, /* iInterface: *//*Header Functional Descriptor*/0x05, /* bLength: Endpoint Descriptor size */0x24, /* bDescriptorType: CS_INTERFACE */0x00, /* bDescriptorSubtype: Header Func Desc */0x10, /* bcdCDC: spec release number */0x01,/*Call Management Functional Descriptor*/0x05, /* bFunctionLength */0x24, /* bDescriptorType: CS_INTERFACE */0x01, /* bDescriptorSubtype: Call Management Func Desc */0x00, /* bmCapabilities: D0+D1 */0x01, /* bDataInterface: 1 *//*ACM Functional Descriptor*/0x04, /* bFunctionLength */0x24, /* bDescriptorType: CS_INTERFACE */0x02, /* bDescriptorSubtype: Abstract Control Management desc */0x02, /* bmCapabilities *//*Union Functional Descriptor*/0x05, /* bFunctionLength */0x24, /* bDescriptorType: CS_INTERFACE */0x06, /* bDescriptorSubtype: Union func desc */0x02, /* bMasterInterface: Communication class interface */ /* +++lakun：這里指示的是本CDC的通信接口編號 */0x03, /* bSlaveInterface0: Data Class Interface */ /* +++lakun：這里指示的是本CDC的數(shù)據(jù)接口編號 *//*Endpoint 2 Descriptor*/0x07, /* bLength: Endpoint Descriptor size */USB_DESC_TYPE_ENDPOINT, /* bDescriptorType: Endpoint */CDC2_CMD_EP, /* bEndpointAddress */0x03, /* bmAttributes: Interrupt */LOBYTE(CDC_CMD_PACKET_SIZE), /* wMaxPacketSize: */HIBYTE(CDC_CMD_PACKET_SIZE),CDC_FS_BINTERVAL, /* bInterval: *//*---------------------------------------------------------------------------*//*Data class interface descriptor*/0x09, /* bLength: Endpoint Descriptor size */USB_DESC_TYPE_INTERFACE, /* bDescriptorType: */0x03, /* bInterfaceNumber: Number of Interface */ /* +++lakun：CDC2的數(shù)據(jù)接口編號 */0x00, /* bAlternateSetting: Alternate setting */0x02, /* bNumEndpoints: Two endpoints used */0x0A, /* bInterfaceClass: CDC */0x00, /* bInterfaceSubClass: */0x00, /* bInterfaceProtocol: */0x00, /* iInterface: *//*Endpoint OUT Descriptor*/0x07, /* bLength: Endpoint Descriptor size */USB_DESC_TYPE_ENDPOINT, /* bDescriptorType: Endpoint */CDC2_OUT_EP, /* bEndpointAddress */0x02, /* bmAttributes: Bulk */LOBYTE(CDC_DATA_FS_MAX_PACKET_SIZE), /* wMaxPacketSize: */HIBYTE(CDC_DATA_FS_MAX_PACKET_SIZE),0x00, /* bInterval: ignore for Bulk transfer *//*Endpoint IN Descriptor*/0x07, /* bLength: Endpoint Descriptor size */USB_DESC_TYPE_ENDPOINT, /* bDescriptorType: Endpoint */CDC2_IN_EP, /* bEndpointAddress */0x02, /* bmAttributes: Bulk */LOBYTE(CDC_DATA_FS_MAX_PACKET_SIZE), /* wMaxPacketSize: */HIBYTE(CDC_DATA_FS_MAX_PACKET_SIZE),0x00, /* bInterval: ignore for Bulk transfer */} ;

第五步：修改函數(shù)接口

默認的HAL庫函數(shù)是只針對一路CDC的情況，所以我們需要修改成多路CDC操作函數(shù)，將端口參數(shù)傳遞出來，一共有下面幾個函數(shù)：

• USBD_CDC_DataOut:USB接收函數(shù)回調(diào)，修改提供端口參數(shù)
• CDC_Receive_FS(uint8_t *Buf, uint32_t *Len):USB CDC接收函數(shù)
• CDC_Transmit_FS(uint8_t* Buf, uint16_t Len):USB CDC發(fā)送函數(shù)
• USBD_CDC_TransmitPacket(USBD_HandleTypeDef *pdev)
• USBD_CDC_ReceivePacket(USBD_HandleTypeDef *pdev)

這幾個函數(shù)的調(diào)用關(guān)系為：

CDC_Transmit_FS->
~~~~????USBD_CDC_TransmitPacket->
~~~~~~~~????????USBD_CDC_DataOut->
~~~~~~~~~~~~????????????CDC_Receive_FS

USBD_CDC_DataOut函數(shù)有一個參數(shù)是epnum，這個是端點號，我們就可以使用該參數(shù)來區(qū)分是哪一路CDC！

所以USBD_CDC_DataOut函數(shù)添加上epnum參數(shù)，改為：

USBD_CDC_TransmitPacket函數(shù)改為：

USBD_CDC_ReceivePacket函數(shù)改為：

CDC_Transmit_FS函數(shù)改為：

CDC_Receive_FS函數(shù)改為：

到此就已經(jīng)修改完畢了，將USB接入電腦后，設(shè)備管理區(qū)會多出現(xiàn)一個USB復(fù)合設(shè)備和兩個端口，這樣就是成功了：

下面進行測試，使用串口助手同時對兩路CDC進行收發(fā)測試效果如下：

互不影響，USB兩路CDC成功！

---

注意事項及問題

如果你移植的時候?qū)SB接入電腦后，設(shè)備管理器里面只會出現(xiàn)1路串口，那么可能是因為你先用的CDC單獨的工程測試的，電腦已經(jīng)默認枚舉為了VCP，那么此時有兩種辦法解決：

設(shè)備管理器卸載掉出現(xiàn)的虛擬串口，重新拔插USB

修改程序里的USBD_VID，換個其他編號

我是用第二個辦法解決的！

---

補充：3路CDC實現(xiàn)

實現(xiàn)3路CDC修改步驟跟實現(xiàn)2路一樣，首先是PMA端點的配置：

為什么要把CDC_DATA_FS_MAX_PACKET_SIZE改成32呢？

現(xiàn)在我們算一下使用到的端點：

• 0X80、0X00用于USB必須的
• 0X81、0X01用于CDC1輸入輸出端點
• 0X82、0X02用于CDC2輸入輸出端點
• 0X83、0X03用于CDC3輸入輸出端點
• 0X84用于CDC1命令控制端點、0X04未用但占用空間
• 0X85用于CDC2命令控制端點、0X05未用但占用空間
• 0X86用于CDC3命令控制端點、0X06未用但占用空間

可以看到我們用到的端點很多，光算輸入輸出端點一共8個，每個端點最大占用64，那么就是512字節(jié)，而PMA一共才512字節(jié)，所以如果將端點緩沖設(shè)置為最大64字節(jié)的話，3路CDC串口緩存空間不夠用！不改成32的話你會發(fā)現(xiàn)第1和2路串口收發(fā)沒問題，而第三路串口返回的都是0！

如下圖：

改成32后，效果如下：

三路虛擬串口收發(fā)數(shù)據(jù)互不影響，到這里就成功了！

---

ends…

總結(jié)

以上是生活随笔為你收集整理的STM32CubeMX | 基于STM32使用HAL库实现USB组合设备之多路CDC的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。