基于STM32的USB程序开发笔记(四)
基于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;
}
}
下篇将介绍上述的各个请求函数如何响应主机。