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文件分析完毕。