基于STM32的USB程序开发笔记(五)

基于STM32的USB程序开发笔记(五) ——USB设备的枚举（下）

SETUP事件正确接收后，根据该事件提供的请求类型进行对主机的响应。SETUP数据结构的wLength字段说明的是请求返回或者提供的数据长度。
如果判断出的请求信息错误或者说不被支持，STM32 USB设备需要中断此次请求：
    SetEPR_RXStatus(ENDP0, EP_RX_VALID);
    SetEPR_TXStatus(ENDP0, EP_TX_STALL);

正确获取到请求信息后，如果wLength为0，设备需要发送一个0长度数据包以响应主机：
// *****************************************************************************
// Function Name  : SETUP0_Trans0Data
// Description    :
// Input          :
// Output         :
// Return         :
// *****************************************************************************
RESULT SETUP0_Trans0Data(void)
{
  // Send 0-length data frame as ACK to host
  SetBuffDescTable_TXCount(ENDP0, 0);
  SetEPR_RXStatus(ENDP0, EP_RX_NAK);
  SetEPR_TXStatus(ENDP0, EP_TX_VALID);

  return RESULT_SUCCESS;
}
如果wLength不为0，设备则需要根据请求的数据长度发送数据包以响应主机：
// *****************************************************************************
// Function Name  : SETUP0_TransData
// Description    :
// Input          :
// Output         :
// Return         :
// *****************************************************************************
RESULT SETUP0_TransData(void)
{
  unsigned short wLength = vsDeviceInfo.TransInfo.wLength;
  unsigned short wOffset = vsDeviceInfo.TransInfo.wOffset;
  unsigned short wMaxSize = vsDeviceInfo.TransInfo.wPacketSize;

  if(wLength)
  {
    if(wLength > wMaxSize)
    {
      wLength = wMaxSize;      
}

    // Copy the transfer buffer to the endpoint0's buffer
    BufferCopy_UserToPMA( vsDeviceInfo.TransInfo.pBuffer+wOffset,   // transfer buffer
                          GetBuffDescTable_TXAddr(ENDP0),           // endpoint 0 TX address
                          wLength);

    SetBuffDescTable_TXCount(ENDP0, wLength);
    SetEPR_RXStatus(ENDP0, EP_RX_NAK);
    SetEPR_TXStatus(ENDP0, EP_TX_VALID);

    // Update the data lengths
    vsDeviceInfo.TransInfo.wLength -= wLength;
    vsDeviceInfo.TransInfo.wOffset += wLength;
   
    return RESULT_LASTDATA;         
  }

  return RESULT_SUCCESS;
}
如果发送的数据长度大于端点设置的最大数据包长度，数据将分割为若干次发送，记录发送数据的状态包含在结构体TRANSFER_INFO中：
// *****************************************************************************
// TRANSFER_INFO
// *****************************************************************************
typedef struct _TRANSFER_INFO
{
  unsigned short wLength;                 // total lengths data will be transmit
  unsigned short wOffset;                 // number of data be transmited
  unsigned short wPacketSize;             // endpoints packet max size
  unsigned char* pBuffer;                 // address of data buffer
}
TRANSFER_INFO,
*PTRANSFER_INFO;
TRANSFER_INFO.wLength记录发送的数据长度，如果非0，表示有数据需要被发送。
TRANSFER_INFO.wOffset记录已发送的数据长度，用以确定数据缓冲TRANSFER_INFO.pBuffer的偏移量。

需要了解的一点：USB主机向USB设备正确发送一请求后（这部分的处理由硬件完成），USB主机将间隔若干次的向USB设备索取响应数据，STM32 USB TX状态为NAK说明不响应USB主机，USB主机在超时后退出此次请求；TX状态为STLL说明中断此次请求，USB主机将无条件退出请求；TX状态为 VALID说明设备已准备好数据发送，USB主机将从USB设备读取数据。
以非0长度数据请求的GET_DESCRIPTOR请求为例的响应过程：
CTR_SETUP0()->SETUP0_Data()->SR_GetDescriptor()->SETUP0_TransData()
RESULT SR_GetDescriptor(void)
{
  // RequestType: device->host, standard request and device recipient
  if(vsDeviceInfo.SetupData.bmRequestType == RT_D2H_STANDARD_DEVICE)
  {
    // SetupData.wValue.b.MSB: descriptor type
    // SetupData.wValue.b.LSB: descriptor index
    switch(vsDeviceInfo.SetupData.wValue.b.MSB)
    {
    case DESCRIPTOR_DEVICE:               return SR_GetDescriptor_Device();
    case DESCRIPTOR_CONFIG:               return SR_GetDescriptor_Config();
    case DESCRIPTOR_STRING:               return SR_GetDescriptor_String();

    default:  return RESULT_UNSUPPORT;
    }
  }

  return RESULT_UNSUPPORT;
}
GET_DESCRIPTOR请求属于USB协议中的标准请求（standard request）并且数据方向为设备至主机（device->host），分设备描述符、配置描述符、字符串描述符三种。已设备描述符为例：
RESULT SR_GetDescriptor_Device(void)
{
  // Assigned the device descriptor to the transfer
  vsDeviceInfo.TransInfo.wOffset = 0;
  vsDeviceInfo.TransInfo.wPacketSize = ENDP0_PACKETSIZE;
  vsDeviceInfo.TransInfo.pBuffer = DescBuffer_Device.pBuff;
  vsDeviceInfo.TransInfo.wLength = DescBuffer_Device.wLen;
  vsDeviceInfo.eControlState = CS_GET_DESCRIPTOR;

  if(vsDeviceInfo.TransInfo.wLength > vsDeviceInfo.SetupData.wLength.w)
  {
    vsDeviceInfo.TransInfo.wLength = vsDeviceInfo.SetupData.wLength.w;
  }

  return SETUP0_TransData();
}