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

http://www.hkaco.com

// 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

http://www.hkaco.com

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) {

http://www.hkaco.com

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(); }

这里说明了发送数据的长度、缓冲、偏移、端点包大小以及当前的控制状态，并说明了如果发送的数据长度超出请求的数据长度，则将舍弃超出的部分。数据配置好后，调用SETUP0_TransData()进行数据发送。

在USB主机查询到USB设备准备就绪后，将读取出这些数据，完成后，USB设备将产生IN事件，此时将响应CTR_IN0()函数：

// ***************************************************************************** // Function Name : CTR_IN // Description : // Input : // Output : // Return :

// ***************************************************************************** void CTR_IN0(void) {

http://www.hkaco.com

switch(vsDeviceInfo.eControlState) {

case CS_GET_DESCRIPTOR:

if(SETUP0_TransData() == RESULT_SUCCESS) {

SetEPR_TXStatus(ENDP0, EP_TX_NAK); SetEPR_RXStatus(ENDP0, EP_RX_VALID); } break;

case CS_SET_ADDRESS:

SetEPR_TXStatus(ENDP0, EP_TX_NAK); SetEPR_RXStatus(ENDP0, EP_RX_VALID);

SetDADDR(0x0080 | vsDeviceInfo.bDeviceAddress); vsDeviceInfo.eDeviceState = DS_ADDRESSED; break;

case CS_SET_CONFIGURATION: