2019年03月11日 | STM32 USB学习笔记7

主机环境：Windows 7 SP1

开发环境：MDK5.14

目标板：STM32F103C8T6

开发库：STM32F1Cube库和STM32_USB_Device_Library

现在来分析一下USB器件库中核心文件usbd_ioreq，相对于usbd_ctlreq来说usbd_ioreq文件的代码量要小一些。该文件的主要作用是为控制端点提供IO请求API，更准确来说是为默认的控制端点0提供的API，该文件只有7个函数体，首先看第一个函数发送数据函数

/**

* @brief  USBD_CtlSendData

*         send data on the ctl pipe

* @param  pdev: device instance

* @param  buff: pointer to data buffer

* @param  len: length of data to be sent

* @retval status

*/

USBD_StatusTypeDef  USBD_CtlSendData (USBD_HandleTypeDef  *pdev, 

                               uint8_t *pbuf,

                               uint16_t len)

{

  /* Set EP0 State */

  pdev->ep0_state          = USBD_EP0_DATA_IN;                                      

  pdev->ep_in[0].total_length = len;

  pdev->ep_in[0].rem_length   = len;

 /* Start the transfer */

  USBD_LL_Transmit (pdev, 0x00, pbuf, len);  

  return USBD_OK;

}

第一句设置端点0状态为DATA_IN，记录本次发送数据的数据长度，可以看出total_length是和rem_length在初次发送数据时是相等的，在DataInStage的回调函数中更新rem_length数值，而total_length数值是没有变的，最后通过USBD_LL_Transmit()函数发出数据，这个需要注意STM32F103C8T6提供了8个双向端点，之前也提到过使用端点地址的最高位来标记其是IN端点还是OUT端点，在Cube库中已经区分了IN端点和OUT端点，只在打开端点时才使用端点最高位，而在传输过程中是不再需要的，所以这里传递的端点地址是0x00而不是0x80，毕竟只有IN端点才能发送数据到USB主机。第二个函数是继续发送数据，该函数比较简单，如下：

/**

* @brief  USBD_CtlContinueSendData

*         continue sending data on the ctl pipe

* @param  pdev: device instance

* @param  buff: pointer to data buffer

* @param  len: length of data to be sent

* @retval status

*/

USBD_StatusTypeDef  USBD_CtlContinueSendData (USBD_HandleTypeDef  *pdev, 

                                       uint8_t *pbuf,

                                       uint16_t len)

{

 /* Start the next transfer */

  USBD_LL_Transmit (pdev, 0x00, pbuf, len);   

  return USBD_OK;

}

直接调用USBD_LL_Transmit()函数即可，无需设置total_length和rem_length。接着查看接收数据函数，如下：

/**

* @brief  USBD_CtlPrepareRx

*         receive data on the ctl pipe

* @param  pdev: device instance

* @param  buff: pointer to data buffer

* @param  len: length of data to be received

* @retval status

*/

USBD_StatusTypeDef  USBD_CtlPrepareRx (USBD_HandleTypeDef  *pdev,

                                  uint8_t *pbuf,                                  

                                  uint16_t len)

{

  /* Set EP0 State */

  pdev->ep0_state = USBD_EP0_DATA_OUT; 

  pdev->ep_out[0].total_length = len;

  pdev->ep_out[0].rem_length   = len;

  /* Start the transfer */

  USBD_LL_PrepareReceive (pdev,

                          0,

                          pbuf,

                         len);

  return USBD_OK;

}

/**

* @brief  USBD_CtlContinueRx

*         continue receive data on the ctl pipe

* @param  pdev: device instance

* @param  buff: pointer to data buffer

* @param  len: length of data to be received

* @retval status

*/

USBD_StatusTypeDef  USBD_CtlContinueRx (USBD_HandleTypeDef  *pdev, 

                                          uint8_t *pbuf,                                          

                                          uint16_t len)

{

  USBD_LL_PrepareReceive (pdev,

                          0,                     

                          pbuf,                         

                          len);

  return USBD_OK;

}

其实也只需要分析USBD_CtlPrepareRx()函数即可，该函数对比发送数据函数很容易弄懂，设置端点状态，设置本次接收数据的长度。剩下两个跟状态相关的函数，和一个获取已接收数据大小的函数，如下：

/**

* @brief  USBD_CtlSendStatus

*         send zero lzngth packet on the ctl pipe

* @param  pdev: device instance

* @retval status

*/

USBD_StatusTypeDef  USBD_CtlSendStatus (USBD_HandleTypeDef  *pdev)

{

  /* Set EP0 State */

  pdev->ep0_state = USBD_EP0_STATUS_IN;

 /* Start the transfer */

  USBD_LL_Transmit (pdev, 0x00, NULL, 0);   

  return USBD_OK;

}

/**

* @brief  USBD_CtlReceiveStatus

*         receive zero lzngth packet on the ctl pipe

* @param  pdev: device instance

* @retval status

*/

USBD_StatusTypeDef  USBD_CtlReceiveStatus (USBD_HandleTypeDef  *pdev)

{

  /* Set EP0 State */

  pdev->ep0_state = USBD_EP0_STATUS_OUT; 

 /* Start the transfer */  

  USBD_LL_PrepareReceive ( pdev,

                    0,

                    NULL,

                    0);  

  return USBD_OK;

}

/**

* @brief  USBD_GetRxCount

*         returns the received data length

* @param  pdev: device instance

* @param  ep_addr: endpoint address

* @retval Rx Data blength

*/

uint16_t  USBD_GetRxCount (USBD_HandleTypeDef  *pdev , uint8_t ep_addr)

{

  return USBD_LL_GetRxDataSize(pdev, ep_addr);

}

此时端点0的状态不再是DATA_IN/DATA_OUT而是STATUS_IN/STATUS_OUT，但调用的底层函数是跟发送/接收数据是一样的，只是数据量为0，且无需传递有效缓存区参数。最后一个获取已接收数据大小的函数就不再赘述了，usbd_ioreq文件中的函数多次在usbd_core文件中调用。可以看到这两个文件跟端点0息息相关。至此，usbd_ioreq文件分析完毕。