USB設備可以定義一個復合設備,復合設備分兩種,一種是一個設備多個配置,還有一種是一個配置多個接口,在本例中采用一個配置多個接口的方式
首先修改設備描述符,標准設備描述符和報告描述符都不需要修改,只需要修改配置描述符即可
//usb配置描述符 const u8 DinkUsbConfigDescriptor[DINK_USB_SIZ_CONFIG_DESC] = { /***************配置描述符***********************/ USB_CONFIGUARTION_DESC_SIZE, //bLength字段。配置描述符的長度為9字節。 USB_CONFIGURATION_DESCRIPTOR_TYPE, //bDescriptorType字段。配置描述符編號為0x02。 //wTotalLength字段。配置描述符集合的總長度， //包括配置描述符本身、接口描述符、類描述符、端點描述符等。 WBVAL( USB_CONFIGUARTION_DESC_SIZE + //配置描述符 USB_INTERFACE_DESC_SIZE + //接口1描述符 9 + //hid描述符 USB_ENDPOINT_DESC_SIZE + //端點描述符 USB_ENDPOINT_DESC_SIZE + //端點描述符 USB_INTERFACE_DESC_SIZE + //接口描述符2 USB_ENDPOINT_DESC_SIZE + //端點描述符1 USB_ENDPOINT_DESC_SIZE //端點描述符2 ), 0x02, //bNumInterfaces字段。該配置包含的接口數，復合設備,兩個接口。 0x01, //bConfiguration字段。該配置的值為1。 0x00, //iConfigurationz字段，該配置的字符串索引。這里沒有，為0。 USB_CONFIG_BUS_POWERED , //bmAttributes字段，該設備的屬性 USB_CONFIG_POWER_MA(500), //bMaxPower字段，該設備需要的最大電流量 /*********************第一個接口描述符,hid設備**********************/ USB_INTERFACE_DESC_SIZE, //bLength字段。接口描述符的長度為9字節。 USB_INTERFACE_DESCRIPTOR_TYPE, //bDescriptorType字段。接口描述符的編號為0x04。 0x00, //bInterfaceNumber字段。該接口的編號，第一個接口，編號為0。 0x00, //bAlternateSetting字段。該接口的備用編號，為0。 0x02, //bNumEndpoints字段。非0端點的數目。該接口有2個批量端點 USB_DEVICE_CLASS_HUMAN_INTERFACE, //bInterfaceClass字段。該接口所使用的類。大容量存儲設備接口類的代碼為0x08。， 0x00, //bInterfaceSubClass字段。該接口所使用的子類。在HID1.1協議中， //只規定了一種子類：支持BIOS引導啟動的子類。 //USB鍵盤、鼠標屬於該子類，子類代碼為0x01。 //但這里我們是自定義的HID設備，所以不使用子類。 0x00, //bInterfaceProtocol字段。如果子類為支持引導啟動的子類， //則協議可選擇鼠標和鍵盤。鍵盤代碼為0x01，鼠標代碼為0x02。 //自定義的HID設備，也不使用協議。 0x00, //iConfiguration字段。該接口的字符串索引值。這里沒有，為0。 /*********************HID報告描述符*************************/ //bLength字段。本HID描述符下只有一個下級描述符。所以長度為9字節。 0x09, //bDescriptorType字段。HID描述符的編號為0x21。 0x21, //bcdHID字段。本協議使用的HID1.1協議。注意低字節在先。 0x10, 0x01, //bCountyCode字段。設備適用的國家代碼，這里選擇為美國，代碼0x21。 0x21, //bNumDescriptors字段。下級描述符的數目。我們只有一個報告描述符。 0x01, //bDescriptorType字段。下級描述符的類型，為報告描述符，編號為0x22。 0x22, //bDescriptorLength字段。下級描述符的長度。下級描述符為報告描述符。 sizeof(HID_ReportDescriptor)&0xFF, (sizeof(HID_ReportDescriptor)>>8)&0xFF, /*********************端點描述符**********************************/ /* 端點描述符 */ USB_ENDPOINT_DESC_SIZE, //bLength字段。端點描述符長度為7字節。 USB_ENDPOINT_DESCRIPTOR_TYPE, //bDescriptorType字段。端點描述符編號為0x05。 USB_ENDPOINT_IN(1), //bEndpointAddress字段。端點的地址。我們使用D12的輸入端點1。 USB_ENDPOINT_TYPE_INTERRUPT, //bmAttributes字段。D1~D0為端點傳輸類型選擇。 WBVAL(0x0040), //wMaxPacketSize字段。該端點的最大包長。最大包長為64字節。 0x01, //bInterval字段。端點查詢的時間，端點查詢的時間，此處無意義。 /***********************端點描述符*******************************************/ USB_ENDPOINT_DESC_SIZE, //bLength字段。端點描述符長度為7字節。 USB_ENDPOINT_DESCRIPTOR_TYPE, //bDescriptorType字段。端點描述符編號為0x05。 USB_ENDPOINT_OUT(1), //bEndpointAddress字段。端點的地址。我們使用D12的輸入端點1。 USB_ENDPOINT_TYPE_INTERRUPT, //bmAttributes字段。D1~D0為端點傳輸類型選擇。 WBVAL(0x0040), //wMaxPacketSize字段。該端點的最大包長。最大包長為64字節。 0x01, //bInterval字段。端點查詢的時間，端點查詢的時間，此處無意義。 /*******************第二個接口描述符 存儲設備*********************/ USB_INTERFACE_DESC_SIZE, //bLength字段。接口描述符的長度為9字節。 USB_INTERFACE_DESCRIPTOR_TYPE, //bDescriptorType字段。接口描述符的編號為0x04。 0x01, //bInterfaceNumber字段。該接口的編號，第二個接口，編號為1。 0x00, //bAlternateSetting字段。該接口的備用編號，為0。 0x02, //bNumEndpoints字段。非0端點的數目。該接口有2個批量端點 USB_DEVICE_CLASS_STORAGE, //bInterfaceClass字段。該接口所使用的類。大容量存儲設備接口類的代碼為0x08。， MSC_SUBCLASS_SCSI, //bInterfaceSubClass字段。SCSI透明命令集的子類代碼為0x06。 MSC_PROTOCOL_BULK_ONLY, //bInterfaceProtocol字段。協議為僅批量傳輸，代碼為0x50。 0x04, //iConfiguration字段。該接口的字符串索引值 /************************************* 端點描述符 *********************************************/ USB_ENDPOINT_DESC_SIZE, //bLength字段。端點描述符長度為7字節。 USB_ENDPOINT_DESCRIPTOR_TYPE, //bDescriptorType字段。端點描述符編號為0x05。 USB_ENDPOINT_IN(2), //bEndpointAddress字段。端點的地址。我們使用D12的輸入端點1。 USB_ENDPOINT_TYPE_BULK, //bmAttributes字段。D1~D0為端點傳輸類型選擇。 WBVAL(0x0040), //wMaxPacketSize字段。該端點的最大包長。最大包長為64字節。 0x00, //bInterval字段。端點查詢的時間，端點查詢的時間，此處無意義。 /************************************端點描述符********************************************************/ USB_ENDPOINT_DESC_SIZE, //bLength字段。端點描述符長度為7字節。 USB_ENDPOINT_DESCRIPTOR_TYPE, //bDescriptorType字段。端點描述符編號為0x05。 USB_ENDPOINT_OUT(2), //bEndpointAddress字段。端點的地址。我們使用D12的輸入端點1。 USB_ENDPOINT_TYPE_BULK, //bmAttributes字段。D1~D0為端點傳輸類型選擇。 WBVAL(0x0040), //wMaxPacketSize字段。該端點的最大包長。最大包長為64字節。 0x00, //bInterval字段。端點查詢的時間，端點查詢的時間，此處無意義。 };
修改描述符之后要同時記得修改描述符的長度,然后修改usb_prop文件,主要是兩個多出來的命令GET_MAX_LEN用來獲取當前存儲設備的個數,還有一個用來復位當前存儲設備,如下
RESULT DinkUsbData_Setup(u8 RequestNo) { u8 *(*CopyRoutine)(u16); CopyRoutine = NULL; if ((RequestNo == GET_DESCRIPTOR) && (Type_Recipient == (STANDARD_REQUEST | INTERFACE_RECIPIENT)) && (pInformation->USBwIndex0 == 0)) { //獲取報告描述符 if (pInformation->USBwValue1 == REPORT_DESCRIPTOR) { CopyRoutine = DinkUsbGetReportDescriptor; } //獲取HID描述符 else if (pInformation->USBwValue1 == HID_DESCRIPTOR_TYPE) { CopyRoutine = DinkUsbGetHIDDescriptor; } } /*** GET_PROTOCOL ***/ else if ((Type_Recipient == (CLASS_REQUEST | INTERFACE_RECIPIENT)) && RequestNo == GET_PROTOCOL) { CopyRoutine = DinkUsbGetProtocolValue;//獲取協議值 } else if ((Type_Recipient == (CLASS_REQUEST | INTERFACE_RECIPIENT)) && (RequestNo == GET_MAX_LUN) && (pInformation->USBwValue == 0) && (pInformation->USBwIndex == 0) && (pInformation->USBwLength == 0x01)) { CopyRoutine = Get_Max_Lun; } if (CopyRoutine == NULL) { return USB_UNSUPPORT; } pInformation->Ctrl_Info.CopyData = CopyRoutine; pInformation->Ctrl_Info.Usb_wOffset = 0; (*CopyRoutine)(0); return USB_SUCCESS; }
GET_MAX_LEN的函數體為
u8 *Get_Max_Lun(u16 Length) { if (Length == 0) { pInformation->Ctrl_Info.Usb_wLength = LUN_DATA_LENGTH; return 0; } else { return((u8*)(&Max_Lun)); } }
對了,因為這一次使用了端點2作為存儲設備使用的端點,所以要在初始化的時候順便也多初始化兩個端點
//設備復位 void DinkUsbReset(void) { Device_Info.Current_Configuration = 0; //選擇當前配置為0 pInformation->Current_Feature = DinkUsbConfigDescriptor[7]; //獲取配置描述符中當前設備屬性 pInformation->Current_Interface = 0;//設置當前設備接口 SetBTABLE(BTABLE_ADDRESS);//設置緩沖區地址 SetEPType(ENDP0, EP_CONTROL);//控制端點 SetEPTxStatus(ENDP0, EP_TX_STALL); SetEPRxAddr(ENDP0, ENDP0_RXADDR);//設置端點緩沖區地址 SetEPTxAddr(ENDP0, ENDP0_TXADDR); Clear_Status_Out(ENDP0); SetEPRxCount(ENDP0, Device_Property.MaxPacketSize);//設置接收最大長度 SetEPRxValid(ENDP0); SetEPType(ENDP1, EP_INTERRUPT);//初始化端點1為中斷傳輸模式,用來報告一些狀態 SetEPTxAddr(ENDP1, ENDP1_TXADDR);//設置端點地址 SetEPRxAddr(ENDP1, ENDP1_RXADDR);//設置端點地址 SetEPRxStatus(ENDP1, EP_RX_VALID);//使能接收 SetEPTxStatus(ENDP1, EP_TX_NAK); //不使能發送 SetEPRxCount(ENDP1, 64);//設置接收最大長度 Clear_Status_Out(ENDP1); SetEPType(ENDP2, EP_BULK);//初始化端點1為中斷傳輸模式,用來報告一些狀態 SetEPTxAddr(ENDP2, ENDP2_TXADDR);//設置端點地址 SetEPRxAddr(ENDP2, ENDP2_RXADDR);//設置端點地址 SetEPRxStatus(ENDP2, EP_RX_VALID);//使能接收 SetEPTxStatus(ENDP2, EP_TX_NAK); //不使能發送 SetEPRxCount(ENDP2, 64);//設置接收最大長度 Clear_Status_Out(ENDP2); bDeviceState = ATTACHED;//設備插入 SetDeviceAddress(0);//設置當前地址為0 usb_debug_printf("USB Reset\r\n"); }
然后就是端點響應了,端點2的響應文件如下
void EP2_IN_Callback(void) { Mass_Storage_In(); } //USB總線發送過來數據 void EP2_OUT_Callback(void) { Mass_Storage_Out(); }
對應具體的代碼就是這樣
/******************************************************************************* * Function Name : Mass_Storage_In * Description : Mass Storage IN transfer. * Input : None. * Output : None. * Return : None. //設備->USB *******************************************************************************/ void Mass_Storage_In (void) { USB_STATUS_REG|=0X10;//標記輪詢 switch (Bot_State) { case BOT_CSW_Send: case BOT_ERROR: Bot_State = BOT_IDLE; SetEPRxStatus(ENDP2, EP_RX_VALID);/* enable the Endpoint to recive the next cmd*/ break; case BOT_DATA_IN: //USB從設備讀數據 switch (CBW.CB[0]) { case SCSI_READ10: USB_STATUS_REG|=0X02;//標記正在讀數據 SCSI_Read10_Cmd(CBW.bLUN , SCSI_LBA , SCSI_BlkLen); break; } break; case BOT_DATA_IN_LAST: Set_CSW (CSW_CMD_PASSED, SEND_CSW_ENABLE); SetEPRxStatus(ENDP2, EP_RX_VALID); break; default: break; } } /******************************************************************************* * Function Name : Mass_Storage_Out * Description : Mass Storage OUT transfer. * Input : None. * Output : None. * Return : None. //USB->設備 *******************************************************************************/ void Mass_Storage_Out (void) { u8 CMD; USB_STATUS_REG|=0X10;//標記輪詢 CMD = CBW.CB[0]; Data_Len = GetEPRxCount(ENDP2); PMAToUserBufferCopy(Bulk_Data_Buff, ENDP2_RXADDR, Data_Len);//讀取端點緩存 switch (Bot_State)//根據狀態進行處理 { case BOT_IDLE://最開始的命令階段 CBW_Decode(); break; case BOT_DATA_OUT://USB發送數據到設備 if (CMD == SCSI_WRITE10) { USB_STATUS_REG|=0X01;//標記正在寫數據 SCSI_Write10_Cmd(CBW.bLUN , SCSI_LBA , SCSI_BlkLen); break; } Bot_Abort(DIR_OUT); Set_Scsi_Sense_Data(CBW.bLUN, ILLEGAL_REQUEST, INVALID_FIELED_IN_COMMAND); Set_CSW (CSW_PHASE_ERROR, SEND_CSW_DISABLE); break; default: Bot_Abort(BOTH_DIR); Set_Scsi_Sense_Data(CBW.bLUN, ILLEGAL_REQUEST, INVALID_FIELED_IN_COMMAND); Set_CSW (CSW_PHASE_ERROR, SEND_CSW_DISABLE); break; } } /******************************************************************************* * Function Name : CBW_Decode * Description : Decode the received CBW and call the related SCSI command * routine. * Input : None. * Output : None. * Return : None. *******************************************************************************/ void CBW_Decode(void) { u32 Counter; for (Counter = 0; Counter < Data_Len; Counter++) { *((u8 *)&CBW + Counter) = Bulk_Data_Buff[Counter]; }//將buf數據拷貝入cbw結構體,便於下一次處理 CSW.dTag = CBW.dTag; CSW.dDataResidue = CBW.dDataLength; if (Data_Len != BOT_CBW_PACKET_LENGTH) { Bot_Abort(BOTH_DIR); /* reset the CBW.dSignature to desible the clear feature until receiving a Mass storage reset*/ CBW.dSignature = 0; Set_Scsi_Sense_Data(CBW.bLUN, ILLEGAL_REQUEST, PARAMETER_LIST_LENGTH_ERROR); Set_CSW (CSW_CMD_FAILED, SEND_CSW_DISABLE); return; } if ((CBW.CB[0] == SCSI_READ10 ) || (CBW.CB[0] == SCSI_WRITE10 )) { /* Calculate Logical Block Address */ SCSI_LBA = (CBW.CB[2] << 24) | (CBW.CB[3] << 16) | (CBW.CB[4] << 8) | CBW.CB[5]; /* Calculate the Number of Blocks to transfer */ SCSI_BlkLen = (CBW.CB[7] << 8) | CBW.CB[8]; } if (CBW.dSignature == BOT_CBW_SIGNATURE) { /* Valid CBW */ if ((CBW.bLUN > Max_Lun) || (CBW.bCBLength < 1) || (CBW.bCBLength > 16)) { Bot_Abort(BOTH_DIR); Set_Scsi_Sense_Data(CBW.bLUN, ILLEGAL_REQUEST, INVALID_FIELED_IN_COMMAND); Set_CSW (CSW_CMD_FAILED, SEND_CSW_DISABLE); } else { switch (CBW.CB[0]) { case SCSI_REQUEST_SENSE: SCSI_RequestSense_Cmd (CBW.bLUN); msc_debug_printf("SCSI_REQUEST_SENSE\r\n"); break; case SCSI_INQUIRY: SCSI_Inquiry_Cmd(CBW.bLUN); msc_debug_printf("SCSI_INQUIRY\r\n"); break; case SCSI_START_STOP_UNIT: SCSI_Start_Stop_Unit_Cmd(CBW.bLUN); msc_debug_printf("SCSI_START_STOP_UNIT\r\n"); break; case SCSI_ALLOW_MEDIUM_REMOVAL: SCSI_Start_Stop_Unit_Cmd(CBW.bLUN); msc_debug_printf("SCSI_MEDIA_REMOVAL\r\n"); break; case SCSI_MODE_SENSE6: SCSI_ModeSense6_Cmd (CBW.bLUN); msc_debug_printf("SCSI_MODE_SENSE6\r\n"); break; case SCSI_MODE_SENSE10: SCSI_ModeSense10_Cmd (CBW.bLUN); msc_debug_printf("SCSI_MODE_SENSE10\r\n"); break; case SCSI_READ_FORMAT_CAPACITIES: SCSI_ReadFormatCapacity_Cmd(CBW.bLUN); msc_debug_printf("SCSI_READ_FORMAT_CAPACITIES\r\n"); break; case SCSI_READ_CAPACITY10: SCSI_ReadCapacity10_Cmd(CBW.bLUN); msc_debug_printf("SCSI_READ_CAPACITY10\r\n"); break; case SCSI_TEST_UNIT_READY: SCSI_TestUnitReady_Cmd(CBW.bLUN); msc_debug_printf("SCSI_TEST_UNIT_READY\r\n"); break; case SCSI_READ10: SCSI_Read10_Cmd(CBW.bLUN, SCSI_LBA , SCSI_BlkLen); msc_debug_printf("SCSI_READ10\r\n"); break; case SCSI_WRITE10: SCSI_Write10_Cmd(CBW.bLUN, SCSI_LBA , SCSI_BlkLen); msc_debug_printf("SCSI_WRITE10\r\n"); break; case SCSI_VERIFY10: SCSI_Verify10_Cmd(CBW.bLUN); msc_debug_printf("SCSI_VERIFY10\r\n"); break; case SCSI_FORMAT_UNIT: SCSI_Format_Cmd(CBW.bLUN); msc_debug_printf("SCSI_FORMAT_UNIT\r\n"); break; /*Unsupported command*/ case SCSI_MODE_SELECT10: SCSI_Mode_Select10_Cmd(CBW.bLUN); msc_debug_printf("SCSI_MODE_SELECT10\r\n"); break; case SCSI_MODE_SELECT6: SCSI_Mode_Select6_Cmd(CBW.bLUN); msc_debug_printf("SCSI_MODE_SELECT6\r\n"); break; case SCSI_SEND_DIAGNOSTIC: SCSI_Send_Diagnostic_Cmd(CBW.bLUN); msc_debug_printf("SCSI_SEND_DIAGNOSTIC\r\n"); break; case SCSI_READ6: SCSI_Read6_Cmd(CBW.bLUN); msc_debug_printf("SCSI_READ6\r\n"); break; case SCSI_READ12: SCSI_Read12_Cmd(CBW.bLUN); msc_debug_printf("SCSI_READ12\r\n"); break; case SCSI_READ16: SCSI_Read16_Cmd(CBW.bLUN); msc_debug_printf("SCSI_READ16\r\n"); break; case SCSI_READ_CAPACITY16: SCSI_READ_CAPACITY16_Cmd(CBW.bLUN); msc_debug_printf("SCSI_READ_CAPACITY16\r\n"); break; case SCSI_WRITE6: SCSI_Write6_Cmd(CBW.bLUN); msc_debug_printf("SCSI_WRITE6\r\n"); break; case SCSI_WRITE12: SCSI_Write12_Cmd(CBW.bLUN); msc_debug_printf("SCSI_WRITE12\r\n"); break; case SCSI_WRITE16: SCSI_Write16_Cmd(CBW.bLUN); msc_debug_printf("SCSI_WRITE16\r\n"); break; case SCSI_VERIFY12: SCSI_Verify12_Cmd(CBW.bLUN); msc_debug_printf("SCSI_VERIFY12\r\n"); break; case SCSI_VERIFY16: SCSI_Verify16_Cmd(CBW.bLUN); msc_debug_printf("SCSI_VERIFY16\r\n"); break; default: { Bot_Abort(BOTH_DIR); Set_Scsi_Sense_Data(CBW.bLUN, ILLEGAL_REQUEST, INVALID_COMMAND); Set_CSW (CSW_CMD_FAILED, SEND_CSW_DISABLE); } } } } else { /* Invalid CBW */ Bot_Abort(BOTH_DIR); Set_Scsi_Sense_Data(CBW.bLUN, ILLEGAL_REQUEST, INVALID_COMMAND); Set_CSW (CSW_CMD_FAILED, SEND_CSW_DISABLE); } } /******************************************************************************* * Function Name : Transfer_Data_Request * Description : Send the request response to the PC HOST. * Input : u8* Data_Address : point to the data to transfer. * u16 Data_Length : the nember of Bytes to transfer. * Output : None. * Return : None. *******************************************************************************/ void Transfer_Data_Request(u8* Data_Pointer, u16 Data_Len) { UserToPMABufferCopy(Data_Pointer, ENDP2_TXADDR, Data_Len); SetEPTxCount(ENDP2, Data_Len); SetEPTxStatus(ENDP2, EP_TX_VALID); Bot_State = BOT_DATA_IN_LAST; CSW.dDataResidue -= Data_Len; CSW.bStatus = CSW_CMD_PASSED; } /******************************************************************************* * Function Name : Set_CSW * Description : Set the SCW with the needed fields. * Input : u8 CSW_Status this filed can be CSW_CMD_PASSED,CSW_CMD_FAILED, * or CSW_PHASE_ERROR. * Output : None. * Return : None. *******************************************************************************/ void Set_CSW (u8 CSW_Status, u8 Send_Permission) { CSW.dSignature = BOT_CSW_SIGNATURE; CSW.bStatus = CSW_Status; UserToPMABufferCopy(((u8 *)& CSW), ENDP2_TXADDR, CSW_DATA_LENGTH); SetEPTxCount(ENDP2, CSW_DATA_LENGTH); Bot_State = BOT_ERROR; if (Send_Permission) { Bot_State = BOT_CSW_Send; SetEPTxStatus(ENDP2, EP_TX_VALID); } } /******************************************************************************* * Function Name : Bot_Abort * Description : Stall the needed Endpoint according to the selected direction. * Input : Endpoint direction IN, OUT or both directions * Output : None. * Return : None. *******************************************************************************/ void Bot_Abort(u8 Direction) { switch (Direction) { case DIR_IN : SetEPTxStatus(ENDP2, EP_TX_STALL); break; case DIR_OUT : SetEPRxStatus(ENDP2, EP_RX_STALL); break; case BOTH_DIR : SetEPTxStatus(ENDP2, EP_TX_STALL); SetEPRxStatus(ENDP2, EP_RX_STALL); break; default: break; } }
實質上就是實現usb的scsi存儲接口,具體請看工程代碼,另外需要注意,因為USB讀取SD卡是在中斷中,所以我們實際上操作物理介質的時候需要將讀寫函數做成可重入的,否則會為存儲設備帶來災難的,也就是每次讀取之前加一個標志位,不讓其他資源來讀寫,類似於互斥信號量吧
工程代碼地址
http://download.csdn.net/detail/dengrengong/8542847