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

USB设备能否工作，枚举步骤，用“乡村爱情”里的话说，“必须的！”，网上也有很多资料，圈圈就提供了一份详细的枚举过程，但对STM32是怎么响应的没有说明，一会详细道来，先上圈圈的提供的那个枚举图示，希望圈圈支持，如果不妥，请与我联系，谢谢。 
我将此转换成了PDF文件，方便查看。
首先说明一个变量，定义在usb_core.c中： 
volatile DEVICE_INFO vsDeviceInfo; 
看意思就知道他的作用了，DEVICE_INFO是个结构，定义在usb_type.h中： 
// ***************************************************************************** 
// DEVICE_INFO 
// ***************************************************************************** 
typedef struct _DEVICE_INFO 
{ 
  unsigned char bDeviceAddress; 

  unsigned char bCurrentFeature; 
  unsigned char bCurrentConfiguration; 
  unsigned char bCurrentInterface; 
  unsigned char bCurrentAlternateSetting; 

  WORD_2BYTE    uStatusInfo; 

  DEVICE_STATE  eDeviceState; 
  RESUME_STATE  eResumeState; 
  CONTROL_STATE eControlState; 

  SETUP_DATA    SetupData; 

  TRANSFER_INFO TransInfo; 
} 
DEVICE_INFO, 
*PDEVICE_INFO; 

在枚举过程中，就是如何处理好SETUP事件，如果STM32 USB接收到正确的SETUP事件，将响应函数CTR_SETUP0()，SETUP事件是特殊的OUT事件，数据方向 Host->Device，SETUP事件数据长度固定为8，数据定义在DEVICE_INFO.SetupData，其数据结构是(定义在 usb_type.h中)： 
typedef struct _SETUP_DATA 
{ 
  unsigned char bmRequestType;            // request type 
  unsigned char bRequest;                 // request code 

  WORD_2BYTE wValue; 
  WORD_2BYTE wIndex; 
  WORD_2BYTE wLength; 
} 
SETUP_DATA, 
*PSETUP_DATA; 

WORD_2BYTE是定义的一个共用体： 
typedef union _WORD_2BYTE 
{ 
  unsigned short w; 
  struct 
  { 
    unsigned char LSB; 
    unsigned char MSB; 
  }b; 
} 
WORD_2BYTE; 

为什么将SETUP数据结构中的wValue,wIndex,wLength如此定义？ 
1：USB协议中所有数据传输都是依照低位在先的原则 
2：高地位字节可能功能复用 
这样在后续的程序编写中就变得十分方便，ST提供的USB固件方法同样如此，但这方面的处理让人有些摸不着头脑，详情可参阅。至于具体的SETUP数据结构含义如何，还是要具备基本知识：了解USB协议 

CTR_SETUP0() 函数将SETUP数据提取出来，SETUP数据结构有0长度和非0长度的数据结构，详细参阅USB2.0官方协议第9章。在这将两种区别开来分别执行 SETUP0_NoData()和SETUP0_Data()函数，并返回结果，根据返回结果再响应USB主机 
// ***************************************************************************** 
// Function Name  : CTR_SETUP0 
// Description    : 
// Input          : 
// Output         : 
// Return         : 
// ***************************************************************************** 
void CTR_SETUP0(void) 
{ 
  RESULT eResult; 

  BufferCopy_PMAToUser( (unsigned char *)&vsDeviceInfo.SetupData, 
                        GetBuffDescTable_RXAddr(ENDP0), 
                        GetBuffDescTable_RXCount(ENDP0)); 

  if(vsDeviceInfo.SetupData.wLength.w == 0) 
  { 
    eResult = SETUP0_NoData(); 
  } 
  else 
  { 
    eResult = SETUP0_Data(); 
  } 

  switch(eResult) 
  { 
  case RESULT_SUCCESS: 

    break; 

  case RESULT_LASTDATA: 

    break; 

  case RESULT_ERROR: 
  case RESULT_UNSUPPORT: 
    SetEPR_RXStatus(ENDP0, EP_RX_VALID); 
    SetEPR_TXStatus(ENDP0, EP_TX_STALL); 
    break; 
  } 
} 

SETUP0_Data() 和SETUP0_NoData()函数支持的所有USB请求类型只有罗列的这些，有多少种组合都定义在USB协议中，程序根据请求代码，再去执行对应函数，这样做的目的就是让程序结构明了。其中注释为"// done"的部分表明此部分功能已完成。对于未完成部分，希望大家在交流中完善。 

// ***************************************************************************** 
// Routine Groups: SETUP_Data 
// ***************************************************************************** 
RESULT SETUP0_Data(void) 
{ 
  // SetupData.bRequest: request code 
  switch(vsDeviceInfo.SetupData.bRequest) 
  { 
  case SR_GET_STATUS:         return SR_GetStatus();                  // done 
  case SR_GET_DESCRIPTOR:     return SR_GetDescriptor();              // done 
  case SR_SET_DESCRIPTOR:     return SR_SetDescriptor();              // unsupport 
  case SR_GET_CONFIGURATION:  return SR_GetConfiguration();           // done 
  case SR_GET_INTERFACE:      return SR_GetInterface();               // unsupport 
  case SR_SYNCH_FRAME:        return SR_SynchFrame();                 // unsupport 

  default: return RESULT_UNSUPPORT; 
  } 
} 

// ***************************************************************************** 
// Routine Groups: SETUP_NoData 
// ***************************************************************************** 
RESULT SETUP0_NoData(void) 
{ 
  // SetupData.bRequest: request code 
  switch(vsDeviceInfo.SetupData.bRequest) 
  { 
  case SR_CLEAR_FEATURE:      return SR_ClearFeature();        // unsupport 
  case SR_SET_FEATURE:        return SR_SetFeature();          // unsupport 
  case SR_SET_ADDRESS:        return SR_SetAddress();          // done 
  case SR_SET_CONFIGURATION:  return SR_SetConfiguration();    // done 
  case SR_SET_INTERFACE:      return SR_SetInterface();        // unsupport 

  default: return RESULT_UNSUPPORT; 
  } 
}