×
单片机 > 单片机程序设计 > 详情

STM32 USB学习笔记7

发布时间:2020-06-18 发布时间:
|

主机环境: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文件分析完毕。


关键字:STM32  USB  学习笔记

『本文转载自网络,版权归原作者所有,如有侵权请联系删除』

热门文章 更多
8051单片机的函数发生器的设计