2020年09月17日 | STM32 usb_mem.c和usb_sil.c文件的分析

这两个c文件都还算是很简单的，先讲讲usb_mem.c这个文件。从文件名就能知道跟内存有关，这个文件主要定义了两个函数，一个读双缓冲区PMA的数据PMAToUserBufferCopy()，另一个是写数据到双缓冲区PMA,UserToPMABufferCopy。如果，当你的usb设备接收到了数据，当然数据存放在PMA中了，我们要读出数据就要用到PMAToUserBufferCopy()函数了，如果我们想要发送数据给usb主机，就要将你要发送的数据拷贝到PMA缓冲区中了，这样才能发送出去，原理跟串口类似。

/*******************************************************************************

* Function Name  : UserToPMABufferCopy

* Description    : 从用于内存区拷贝数据到PMA(数据包内存区)

* Input          : pbUsrBuf:指向用户的内存区

*                  wPMABufAddr:要拷贝到PMA的wPMABufAddr地址处

*                  wNBytes: 要拷贝的数据长度(单位：字)

* Output         : None.

* Return         : None .

*******************************************************************************/

void UserToPMABufferCopy(uint8_t *pbUsrBuf, uint16_t wPMABufAddr, uint16_t wNBytes)

{

  uint32_t n = (wNBytes + 1) >> 1;                //n = (wNBytes + 1) / 2，表示多少字

  uint32_t i, temp1, temp2;

  uint16_t *pdwVal;                                

  pdwVal = (uint16_t *)(wPMABufAddr * 2 + PMAAddr); //pdwVal存放要将数据存放的地址

  for (i = n; i != 0; i--)                          //开始考被数据

  {

    temp1 = (uint16_t) * pbUsrBuf;

    pbUsrBuf++;

    temp2 = temp1 | (uint16_t) * pbUsrBuf << 8;       //整合2个16bit数据

    *pdwVal++ = temp2;                              //把整合的数据拷贝PMA内

    pdwVal++;                                       //目的指针指向下一个地址

    pbUsrBuf++;                                     //源指针指向下一地址

  }

}

/*******************************************************************************

* Function Name  : PMAToUserBufferCopy

* Description    : Copy a buffer from user memory area to packet memory area (PMA)

* Input          : pbUsrBuf指向用户的内存区

*                  wPMABufAddr PAM的地址

*                  wNBytes要拷贝的字节数

* Output         : None.

* Return         : None.

*******************************************************************************/

void PMAToUserBufferCopy(uint8_t *pbUsrBuf, uint16_t wPMABufAddr, uint16_t wNBytes)

{

  uint32_t n = (wNBytes + 1) >> 1;            //n = (wNBytes + 1) / 2，表示多少字

  uint32_t i;

  uint32_t *pdwVal;

  pdwVal = (uint32_t *)(wPMABufAddr * 2 + PMAAddr); //从PAM区中去读1字数据

  for (i = n; i != 0; i--)

  {

    *(uint16_t*)pbUsrBuf++ = *pdwVal++;         //拷贝用户的内存区中

    pbUsrBuf++;

  }

}

接下去是usb_sil.c文件，这个文件主要是简单接口层的初始化，和端点的读写操作函数。总共有3个函数：USB_SIL_Init()；USB_SIL_Write()；USB_SIL_Read()。

USB_SIL_Init()函数初始化USB设备的IP和端点。该函数在usb_prop.c的CustomHID_init()中被调用，总之，就是初始化了

/*******************************************************************************

* Function Name  : USB_SIL_Init

* Description    : 初始化USB设备IP和端点

* Input          : None.

* Output         : None.

* Return         : Status.

*******************************************************************************/

uint32_t USB_SIL_Init(void)

{

#ifndef STM32F10X_CL

  /* USB interrupts initialization */

  /* clear pending interrupts */

  _SetISTR(0);                    //禁止所有的中断

  wInterrupt_Mask = IMR_MSK;     

  /* set interrupts mask */

  _SetCNTR(wInterrupt_Mask);      //使能一些中断

#else

  /* Perform OTG Device initialization procedure (including EP0 init) */

  OTG_DEV_Init();                 //执行初始化程序OTG设备(包括EP0初始化)

#endif /* STM32F10X_CL */

  return 0;

}

　　还有的就是两个端点读写数据函数了，端点写函数USB_SIL_Write()共有三个参数：uint8_t bEpAddr, uint8_t* pBufferPointer, uint32_t wBufferSize，所以写调用写函数时，要指明端点号、要写数据地址，和要写的数据长度。读函数USB_SIL_Read()只有两个参数：端点号、数要保存的据区地址。

/*******************************************************************************

* Function Name  : USB_SIL_Write

* Description    : 往选中的端点中写入数据

* Input          : bEpAddr:非控制端点的地址

*                  pBufferPointer:指向要写入端点的缓冲数据

*                  wBufferSize:要写入的数据长度(单位：字节)

* Output         : None.

* Return         : Status.

*******************************************************************************/

uint32_t USB_SIL_Write(uint8_t bEpAddr, uint8_t* pBufferPointer, uint32_t wBufferSize)

{

#ifndef STM32F10X_CL

  UserToPMABufferCopy(pBufferPointer, GetEPTxAddr(bEpAddr & 0x7F), wBufferSize);//把用户数据拷贝到PMA中

  SetEPTxCount((bEpAddr & 0x7F), wBufferSize);              //更新数据长度的控制寄存器

#else

   PCD_EP_Write (bEpAddr, pBufferPointer, wBufferSize);         //使用使用PCD接口层函数来写入选择的端点

#endif /* STM32F10X_CL */

  return 0;

}

/*******************************************************************************

* Function Name  : USB_SIL_Read

* Description    : 从选中的端点中读出数据

* Input          : bEpAddr:非控制端点的地址

*                  pBufferPointer:指向要保存的数据区地址

* Output         : None.

* Return         : 返回读出来的数据长度(单位：字节)

*******************************************************************************/

uint32_t USB_SIL_Read(uint8_t bEpAddr, uint8_t* pBufferPointer)

{

  uint32_t DataLength = 0;

#ifndef STM32F10X_CL

  DataLength = GetEPRxCount(bEpAddr & 0x7F);            //从选中的端点中获取接收的数据长度

  PMAToUserBufferCopy(pBufferPointer, GetEPRxAddr(bEpAddr & 0x7F), DataLength);//从PMA拷贝数据到用户区

#else

  USB_OTG_EP *ep;

  ep = PCD_GetOutEP(bEpAddr);                   //获取选中端点的结构体指针

  DataLength = ep->xfer_len;                 //获取接收到的数据长度

  PCD_EP_Read (bEpAddr, pBufferPointer, DataLength);        //使用PCD接口层函数读取选中的端口

#endif /* STM32F10X_CL */

  return DataLength;                        //返回接收到的数据长度

}