123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464 |
- /*
- * Copyright (c) 2015 - 2016, Freescale Semiconductor, Inc.
- * Copyright 2016,2019 NXP
- *
- * SPDX-License-Identifier: BSD-3-Clause
- */
- #include <usb/include/usb_host_config.h>
- #include "usb_host.h"
- #include "usb_host_hci.h"
- #include "usb_host_devices.h"
- #include "usb_host_framework.h"
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- #include "usb_host_hub.h"
- #include "usb_host_hub_app.h"
- #endif /* USB_HOST_CONFIG_HUB */
- /*******************************************************************************
- * Definitions
- ******************************************************************************/
- #ifndef USB_HOST_CONFIG_MAX_CONFIGURATION_DESCRIPTOR_LENGTH
- #define USB_HOST_CONFIG_MAX_CONFIGURATION_DESCRIPTOR_LENGTH (5000U)
- #endif
- /*******************************************************************************
- * Prototypes
- ******************************************************************************/
- /*!
- * @brief enumeration transfer callback function.
- *
- * @param param callback parameter.
- * @param transfer the transfer.
- * @param status transfer result status.
- */
- static void USB_HostEnumerationTransferCallback(void *param, usb_host_transfer_t *transfer, usb_status_t status);
- /*!
- * @brief process the new step state.
- *
- * @param deviceInstance device instance pointer.
- *
- * @return kStatus_USB_Success or error codes
- */
- static usb_status_t USB_HostProcessState(usb_host_device_instance_t *deviceInstance);
- /*!
- * @brief process the previous step transfer result.
- *
- * @param deviceInstance device instance pointer.
- *
- * @return kStatus_USB_Success or error codes
- */
- static usb_status_t USB_HostProcessCallback(usb_host_device_instance_t *deviceInstance, uint32_t dataLength);
- /*!
- * @brief notify the application event, the callback is registered when initializing host.
- *
- * @param deviceInstance device instance pointer.
- * @param eventCode event code.
- *
- * @return kStatus_USB_Success or error codes
- */
- static usb_status_t USB_HostNotifyDevice(usb_host_handle hostHandle,
- usb_host_device_instance_t *deviceInstance,
- uint32_t eventCode,
- uint32_t eventParameter);
- /*!
- * @brief allocate one address.
- *
- * @param hostInstance host instance pointer.
- *
- * @return address, 0 is invalid.
- */
- static uint8_t USB_HostAllocateDeviceAddress(usb_host_instance_t *hostInstance);
- /*!
- * @brief release one address.
- *
- * @param hostInstance host instance pointer.
- * @param address releasing address.
- */
- static void USB_HostReleaseDeviceAddress(usb_host_instance_t *hostInstance, uint8_t address);
- /*!
- * @brief release device resource.
- *
- * @param hostInstance host instance pointer.
- * @param deviceInstance device instance pointer.
- */
- static void USB_HostReleaseDeviceResource(usb_host_instance_t *hostInstance,
- usb_host_device_instance_t *deviceInstance);
- /*!
- * @brief parse device configuration descriptor.
- *
- * @param deviceHandle device handle.
- *
- * @return kStatus_USB_Success or error codes.
- */
- static usb_status_t USB_HostParseDeviceConfigurationDescriptor(usb_device_handle deviceHandle);
- /*!
- * @brief remove device instance from host device list.
- *
- * @param hostHandle host instance handle.
- * @param deviceHandle device handle.
- *
- * @return kStatus_USB_Success or error codes.
- */
- static usb_status_t USB_HostRemoveDeviceInstance(usb_host_handle hostHandle, usb_device_handle deviceHandle);
- /*!
- * @brief control the bus.
- *
- * This function control the host bus.
- *
- * @param[in] hostHandle the host handle.
- * @param[in] controlType the control code, please reference to bus_event_t.
- *
- * @retval kStatus_USB_Success control successfully.
- * @retval kStatus_USB_InvalidHandle The hostHandle is a NULL pointer.
- */
- static usb_status_t USB_HostControlBus(usb_host_handle hostHandle, uint8_t controlType);
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- #endif
- /*******************************************************************************
- * Variables
- ******************************************************************************/
- /*! @brief enumeration step process array */
- static const usb_host_enum_process_entry_t s_EnumEntries[] = {
- /* kStatus_dev_initial */
- {
- kStatus_DEV_Notinit,
- kStatus_DEV_Notinit,
- NULL,
- },
- /* kStatus_DEV_GetDes8 */
- {
- kStatus_DEV_SetAddress,
- kStatus_DEV_GetDes8,
- USB_HostProcessCallback,
- },
- /* kStatus_DEV_SetAddress */
- {
- kStatus_DEV_GetDes,
- kStatus_DEV_SetAddress,
- USB_HostProcessCallback,
- },
- /* kStatus_DEV_GetDes */
- {
- kStatus_DEV_GetCfg9,
- kStatus_DEV_GetDes,
- NULL,
- },
- /* kStatus_DEV_GetCfg9 */
- {
- kStatus_DEV_GetCfg,
- kStatus_DEV_GetCfg9,
- USB_HostProcessCallback,
- },
- /* kStatus_DEV_GetCfg */
- {
- kStatus_DEV_SetCfg,
- kStatus_DEV_GetCfg9,
- USB_HostProcessCallback,
- },
- /* kStatus_DEV_SetCfg */
- {
- kStatus_DEV_EnumDone,
- kStatus_DEV_SetCfg,
- NULL,
- },
- };
- /*******************************************************************************
- * Code
- ******************************************************************************/
- static void USB_HostEnumerationTransferCallback(void *param, usb_host_transfer_t *transfer, usb_status_t status)
- {
- /* 0 - retry current transfer, 1 - transfer success process,
- * 2 - retry whole process, 3 - fail process
- */
- uint8_t nextStep = 0U;
- usb_host_device_instance_t *deviceInstance = (usb_host_device_instance_t *)param;
- usb_status_t failReason = kStatus_USB_Success;
- uint32_t dataLength;
- dataLength = transfer->transferSofar;
- (void)USB_HostFreeTransfer(deviceInstance->hostHandle, transfer); /* free transfer */
- if (status == kStatus_USB_Success)
- {
- nextStep = 1U;
- }
- else if (status == kStatus_USB_TransferStall)
- {
- #if ((defined USB_HOST_CONFIG_COMPLIANCE_TEST) && (USB_HOST_CONFIG_COMPLIANCE_TEST))
- (void)usb_echo("no response from device\r\n");
- #endif /* USB_HOST_CONFIG_COMPLIANCE_TEST */
- if (deviceInstance->stallRetries > 0U) /* retry same transfer when stall */
- {
- nextStep = 0U;
- deviceInstance->stallRetries--;
- }
- else
- {
- failReason = kStatus_USB_TransferFailed;
- nextStep = 2U;
- }
- }
- else if (status == kStatus_USB_TransferCancel)
- {
- failReason = kStatus_USB_TransferCancel;
- nextStep = 3U;
- }
- else
- {
- failReason = kStatus_USB_TransferFailed;
- nextStep = 2U;
- }
- if (nextStep == 1U)
- {
- deviceInstance->stallRetries = USB_HOST_CONFIG_ENUMERATION_MAX_STALL_RETRIES;
- if (s_EnumEntries[deviceInstance->state - 1U].process == NULL)
- {
- deviceInstance->state = (uint8_t)s_EnumEntries[deviceInstance->state - 1U].successState; /* next state */
- }
- else
- {
- status = s_EnumEntries[deviceInstance->state - 1U].process(
- deviceInstance, dataLength); /* process the previous state result */
- if (status == kStatus_USB_Success) /* process success */
- {
- deviceInstance->state = (uint8_t)s_EnumEntries[deviceInstance->state - 1U].successState;
- }
- else if (status == kStatus_USB_Retry) /* need retry */
- {
- deviceInstance->state = (uint8_t)s_EnumEntries[deviceInstance->state - 1U].retryState;
- }
- else if (status == kStatus_USB_NotSupported) /* device don't suport by the application */
- {
- return; /* unrecoverable fail */
- }
- else /* process error, next retry */
- {
- /* kStatus_USB_Error or kStatus_USB_AllocFail */
- failReason = status;
- nextStep = 2U;
- }
- }
- }
- if (nextStep == 2U)
- {
- if (deviceInstance->enumRetries > 0U) /* next whole retry */
- {
- deviceInstance->enumRetries--;
- deviceInstance->stallRetries = USB_HOST_CONFIG_ENUMERATION_MAX_STALL_RETRIES;
- deviceInstance->configurationValue = 0U;
- deviceInstance->state = (uint8_t)kStatus_DEV_GetDes8;
- }
- else
- {
- #if ((defined USB_HOST_CONFIG_COMPLIANCE_TEST) && (USB_HOST_CONFIG_COMPLIANCE_TEST))
- usb_echo("Device No Response\r\n");
- #endif
- nextStep = 3U;
- }
- }
- /* process the state */
- if (nextStep != 3U)
- {
- if (USB_HostProcessState(deviceInstance) != kStatus_USB_Success)
- {
- #ifdef HOST_ECHO
- usb_echo("enumation setup error\r\n");
- #endif
- failReason = kStatus_USB_Error;
- nextStep = 3U;
- }
- }
- if (nextStep == 3U)
- {
- (void)USB_HostNotifyDevice(deviceInstance->hostHandle, deviceInstance, (uint32_t)kUSB_HostEventEnumerationFail,
- (uint32_t)failReason);
- }
- }
- static usb_status_t USB_HostProcessState(usb_host_device_instance_t *deviceInstance)
- {
- usb_status_t status = kStatus_USB_Success;
- usb_host_process_descriptor_param_t getDescriptorParam;
- usb_host_transfer_t *transfer;
- usb_host_device_enumeration_status_t state;
- /* malloc transfer */
- state = (usb_host_device_enumeration_status_t)deviceInstance->state;
- if (state != kStatus_DEV_EnumDone)
- {
- if (USB_HostMallocTransfer(deviceInstance->hostHandle, &transfer) != kStatus_USB_Success)
- {
- #ifdef HOST_ECHO
- usb_echo("error to get transfer\r\n");
- #endif
- return kStatus_USB_Error;
- }
- transfer->callbackFn = USB_HostEnumerationTransferCallback;
- transfer->callbackParam = deviceInstance;
- /* reset transfer fields */
- transfer->setupPacket->bmRequestType = 0x00U;
- transfer->setupPacket->wIndex = 0U;
- transfer->setupPacket->wLength = 0U;
- transfer->setupPacket->wValue = 0U;
- }
- switch (state)
- {
- case kStatus_DEV_GetDes8:
- case kStatus_DEV_GetDes: /* get descriptor state */
- getDescriptorParam.descriptorLength = sizeof(usb_descriptor_device_t);
- if (deviceInstance->state == (uint8_t)kStatus_DEV_GetDes8)
- {
- getDescriptorParam.descriptorLength = 8U;
- }
- getDescriptorParam.descriptorBuffer = (uint8_t *)deviceInstance->deviceDescriptor;
- getDescriptorParam.descriptorType = USB_DESCRIPTOR_TYPE_DEVICE;
- getDescriptorParam.descriptorIndex = 0U;
- getDescriptorParam.languageId = 0U;
- transfer->setupPacket->bmRequestType |= USB_REQUEST_TYPE_DIR_IN;
- transfer->setupPacket->bRequest = USB_REQUEST_STANDARD_GET_DESCRIPTOR;
- status = USB_HostStandardSetGetDescriptor(deviceInstance, transfer, &getDescriptorParam);
- break;
- case kStatus_DEV_SetAddress: /* set address state */
- transfer->setupPacket->bRequest = USB_REQUEST_STANDARD_SET_ADDRESS;
- status = USB_HostStandardSetAddress(deviceInstance, transfer, &deviceInstance->allocatedAddress);
- break;
- case kStatus_DEV_GetCfg9: /* get 9 bytes configuration state */
- getDescriptorParam.descriptorBuffer = deviceInstance->enumBuffer;
- getDescriptorParam.descriptorType = USB_DESCRIPTOR_TYPE_CONFIGURE;
- getDescriptorParam.descriptorIndex = deviceInstance->configurationValue;
- getDescriptorParam.descriptorLength = 9;
- getDescriptorParam.languageId = 0;
- transfer->setupPacket->bmRequestType |= USB_REQUEST_TYPE_DIR_IN;
- transfer->setupPacket->bRequest = USB_REQUEST_STANDARD_GET_DESCRIPTOR;
- status = USB_HostStandardSetGetDescriptor(deviceInstance, transfer, &getDescriptorParam);
- break;
- case kStatus_DEV_GetCfg: /* get configuration state */
- getDescriptorParam.descriptorBuffer = deviceInstance->configurationDesc;
- getDescriptorParam.descriptorType = USB_DESCRIPTOR_TYPE_CONFIGURE;
- getDescriptorParam.descriptorIndex = deviceInstance->configurationValue;
- getDescriptorParam.descriptorLength = deviceInstance->configurationLen;
- getDescriptorParam.languageId = 0;
- transfer->setupPacket->bmRequestType |= USB_REQUEST_TYPE_DIR_IN;
- transfer->setupPacket->bRequest = USB_REQUEST_STANDARD_GET_DESCRIPTOR;
- status = USB_HostStandardSetGetDescriptor(deviceInstance, transfer, &getDescriptorParam);
- break;
- case kStatus_DEV_SetCfg: /* set configuration state */
- transfer->setupPacket->wValue =
- USB_SHORT_TO_LITTLE_ENDIAN(deviceInstance->configuration.configurationDesc->bConfigurationValue);
- transfer->setupPacket->bRequest = USB_REQUEST_STANDARD_SET_CONFIGURATION;
- status = USB_HostCh9RequestCommon(deviceInstance, transfer, NULL, 0);
- break;
- case kStatus_DEV_EnumDone: /* enumeration done state */
- /* notify device enumeration done */
- status = USB_HostNotifyDevice(deviceInstance->hostHandle, deviceInstance,
- (uint32_t)kUSB_HostEventEnumerationDone, (uint32_t)kStatus_USB_Success);
- if (status == kStatus_USB_Success)
- {
- deviceInstance->state = (uint8_t)kStatus_DEV_AppUsed;
- }
- break;
- default:
- /*no action*/
- break;
- }
- return status;
- }
- static usb_status_t USB_HostProcessCallback(usb_host_device_instance_t *deviceInstance, uint32_t dataLength)
- {
- usb_host_pipe_t *pipe = (usb_host_pipe_t *)deviceInstance->controlPipe;
- usb_status_t status = kStatus_USB_Success;
- usb_descriptor_configuration_t *configureDesc;
- usb_host_instance_t *hostInstance = (usb_host_instance_t *)deviceInstance->hostHandle;
- void *temp;
- usb_host_device_enumeration_status_t state;
- state = (usb_host_device_enumeration_status_t)deviceInstance->state;
- switch (state)
- {
- case kStatus_DEV_GetDes8: /* process get 8 bytes descriptor result */
- if (dataLength != 8u)
- {
- return kStatus_USB_Error;
- }
- pipe->maxPacketSize = deviceInstance->deviceDescriptor->bMaxPacketSize0;
- /* the callbackFn is initialized in USB_HostGetControllerInterface */
- (void)hostInstance->controllerTable->controllerIoctl(
- hostInstance->controllerHandle, kUSB_HostUpdateControlPacketSize, deviceInstance->controlPipe);
- break;
- case kStatus_DEV_SetAddress: /* process set address result */
- deviceInstance->setAddress = deviceInstance->allocatedAddress;
- /* the callbackFn is initialized in USB_HostGetControllerInterface */
- (void)hostInstance->controllerTable->controllerIoctl(
- hostInstance->controllerHandle, kUSB_HostUpdateControlEndpointAddress, deviceInstance->controlPipe);
- break;
- case kStatus_DEV_GetDes: /* process get full device descriptor result */
- if (dataLength != sizeof(usb_descriptor_device_t))
- {
- return kStatus_USB_Error;
- }
- break;
- case kStatus_DEV_GetCfg9: /* process get 9 bytes configuration result */
- if (dataLength != 9u)
- {
- return kStatus_USB_Error;
- }
- temp = (void *)&deviceInstance->enumBuffer[0];
- configureDesc = (usb_descriptor_configuration_t *)temp;
- deviceInstance->configurationLen = USB_SHORT_FROM_LITTLE_ENDIAN_ADDRESS(configureDesc->wTotalLength);
- if (deviceInstance->configurationDesc != NULL)
- {
- #if ((defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE > 0U))
- SDK_Free(deviceInstance->configurationDesc);
- #else
- OSA_MemoryFree(deviceInstance->configurationDesc);
- #endif
- deviceInstance->configurationDesc = NULL;
- }
- /* fix misra 4.14 */
- if (deviceInstance->configurationLen > USB_HOST_CONFIG_MAX_CONFIGURATION_DESCRIPTOR_LENGTH)
- {
- return kStatus_USB_Error;
- }
- /* for KHCI, the start address and the length should be 4 byte align */
- if ((deviceInstance->configurationLen & 0x03U) != 0U)
- {
- #if ((defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE > 0U))
- deviceInstance->configurationDesc =
- (uint8_t *)SDK_Malloc((deviceInstance->configurationLen & 0xFFFCu) + 4, USB_CACHE_LINESIZE);
- #else
- deviceInstance->configurationDesc =
- (uint8_t *)OSA_MemoryAllocate((((uint32_t)deviceInstance->configurationLen) & 0xFFFCU) + 4UL);
- #endif
- }
- else
- {
- #if ((defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE > 0U))
- deviceInstance->configurationDesc =
- (uint8_t *)SDK_Malloc(deviceInstance->configurationLen, USB_CACHE_LINESIZE);
- #else
- deviceInstance->configurationDesc = (uint8_t *)OSA_MemoryAllocate(deviceInstance->configurationLen);
- #endif
- }
- if (deviceInstance->configurationDesc == NULL)
- {
- return kStatus_USB_AllocFail;
- }
- break;
- case kStatus_DEV_GetCfg: /* process get configuration result */
- if (dataLength != deviceInstance->configurationLen)
- {
- return kStatus_USB_Error;
- }
- temp = (void *)deviceInstance->configurationDesc;
- if (((usb_descriptor_configuration_t *)temp)->bMaxPower > USB_HOST_CONFIG_MAX_POWER)
- {
- return kStatus_USB_Error;
- }
- deviceInstance->configurationValue++;
- if (USB_HostParseDeviceConfigurationDescriptor(deviceInstance) !=
- kStatus_USB_Success) /* parse configuration descriptor */
- {
- return kStatus_USB_Error;
- }
- status = USB_HostNotifyDevice(deviceInstance->hostHandle, deviceInstance, (uint32_t)kUSB_HostEventAttach,
- (uint32_t)kStatus_USB_Success);
- if (status != kStatus_USB_Success)
- {
- /* next configuration */
- if (deviceInstance->configurationValue < deviceInstance->deviceDescriptor->bNumConfigurations)
- {
- return kStatus_USB_Retry;
- }
- else
- {
- /* notify application device is not supported */
- (void)USB_HostNotifyDevice(deviceInstance->hostHandle, deviceInstance,
- (uint32_t)kUSB_HostEventNotSupported, (uint32_t)kStatus_USB_Success);
- return kStatus_USB_NotSupported;
- }
- }
- break;
- case kStatus_DEV_SetCfg:
- /* NULL */
- break;
- default:
- /*no action*/
- break;
- }
- return status;
- }
- static usb_status_t USB_HostNotifyDevice(usb_host_handle hostHandle,
- usb_host_device_instance_t *deviceInstance,
- uint32_t eventCode,
- uint32_t eventParameter)
- {
- usb_host_instance_t *hostInstance;
- usb_status_t status1 = kStatus_USB_Error;
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- usb_status_t status2 = kStatus_USB_Error;
- uint8_t haveHub;
- uint8_t haveNoHub;
- uint8_t interfaceIndex;
- #endif /* USB_HOST_CONFIG_HUB */
- eventCode = (((uint32_t)eventParameter << 16U) | (uint32_t)eventCode);
- hostInstance = (usb_host_instance_t *)hostHandle;
- if (deviceInstance == NULL)
- {
- (void)hostInstance->deviceCallback(NULL, NULL, eventCode);
- return kStatus_USB_InvalidHandle;
- }
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- haveHub = 0U;
- haveNoHub = 0U;
- for (interfaceIndex = 0U; interfaceIndex < deviceInstance->configuration.interfaceCount; ++interfaceIndex)
- {
- if (((usb_descriptor_interface_t *)deviceInstance->configuration.interfaceList[interfaceIndex].interfaceDesc)
- ->bInterfaceClass == USB_HOST_HUB_CLASS_CODE)
- {
- haveHub = 1U;
- }
- else
- {
- haveNoHub = 1U;
- }
- }
- if ((hostInstance->deviceCallback != NULL) &&
- ((haveNoHub == 1U) || (deviceInstance->configuration.interfaceCount == 0U)))
- {
- /* call host callback function, function is initialized in USB_HostInit */
- status1 = hostInstance->deviceCallback(deviceInstance, &deviceInstance->configuration, eventCode);
- }
- if (0U != haveHub)
- {
- status2 = USB_HostHubDeviceEvent(hostInstance, deviceInstance, &deviceInstance->configuration,
- eventCode); /* notify hub event */
- }
- if ((status1 == kStatus_USB_Success) || (status2 == kStatus_USB_Success)) /* the device is supported */
- {
- return kStatus_USB_Success;
- }
- else if (eventCode == (uint32_t)kUSB_HostEventAttach) /* attach event */
- {
- status1 = kStatus_USB_NotSupported;
- }
- else
- {
- status1 = kStatus_USB_Error;
- }
- #else
- if (hostInstance->deviceCallback != NULL)
- {
- /* call host callback function, function is initialized in USB_HostInit */
- status1 = hostInstance->deviceCallback(deviceInstance, &deviceInstance->configuration, eventCode);
- }
- #endif
- return status1;
- }
- static uint8_t USB_HostAllocateDeviceAddress(usb_host_instance_t *hostInstance)
- {
- uint8_t address = 0U;
- uint8_t addressIndex;
- uint8_t addressBitIndex;
- for (addressIndex = 0U; addressIndex < 8U; ++addressIndex) /* find the idle address position byte */
- {
- if (hostInstance->addressBitMap[addressIndex] != 0xFFU)
- {
- break;
- }
- }
- if (addressIndex < 8U)
- {
- for (addressBitIndex = 0U; addressBitIndex < 8U; ++addressBitIndex) /* find the idle address position bit */
- {
- if (0U == (hostInstance->addressBitMap[addressIndex] & (0x01U << addressBitIndex)))
- {
- hostInstance->addressBitMap[addressIndex] |= (0x01U << addressBitIndex); /* set the allocated bit */
- address = addressIndex * 8U + addressBitIndex + 1U; /* the address minimum is 1 */
- break;
- }
- }
- }
- return address;
- }
- static void USB_HostReleaseDeviceAddress(usb_host_instance_t *hostInstance, uint8_t address)
- {
- (void)USB_HostLock();
- hostInstance->addressBitMap[((uint32_t)address - 1U) >> 3U] &=
- (~(0x01U << (((uint32_t)address - 1U) & 0x07U))); /* reset the allocated bit */
- (void)USB_HostUnlock();
- }
- static usb_status_t USB_HostRemoveDeviceInstance(usb_host_handle hostHandle, usb_device_handle deviceHandle)
- {
- usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
- usb_host_device_instance_t *currentInstance;
- usb_host_device_instance_t *prevInstance;
- if ((hostHandle == NULL) || (deviceHandle == NULL))
- {
- return kStatus_USB_InvalidHandle;
- }
- /* search and remove device instance */
- prevInstance = (usb_host_device_instance_t *)hostInstance->deviceList;
- if (prevInstance == deviceHandle)
- {
- hostInstance->deviceList = prevInstance->next;
- return kStatus_USB_Success;
- }
- else
- {
- currentInstance = prevInstance->next;
- }
- while (currentInstance != NULL)
- {
- if (currentInstance == deviceHandle)
- {
- prevInstance->next = currentInstance->next;
- return kStatus_USB_Success;
- }
- prevInstance = currentInstance;
- currentInstance = currentInstance->next;
- }
- return kStatus_USB_Success;
- }
- static void USB_HostReleaseDeviceResource(usb_host_instance_t *hostInstance, usb_host_device_instance_t *deviceInstance)
- {
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- uint8_t level = 0;
- #endif
- #if ((defined(USB_HOST_CONFIG_LOW_POWER_MODE)) && (USB_HOST_CONFIG_LOW_POWER_MODE > 0U))
- if (deviceInstance == hostInstance->suspendedDevice)
- {
- hostInstance->suspendedDevice = NULL;
- }
- #endif
- /* release device's address */
- if (deviceInstance->setAddress != 0U)
- {
- USB_HostReleaseDeviceAddress(hostInstance, deviceInstance->setAddress);
- }
- else
- {
- if (deviceInstance->allocatedAddress != 0U)
- {
- USB_HostReleaseDeviceAddress(hostInstance, deviceInstance->allocatedAddress);
- }
- }
- /* close control pipe */
- if (deviceInstance->controlPipe != NULL)
- {
- (void)USB_HostCancelTransfer(hostInstance, deviceInstance->controlPipe, NULL);
- if (USB_HostClosePipe(hostInstance, deviceInstance->controlPipe) != kStatus_USB_Success)
- {
- #ifdef HOST_ECHO
- usb_echo("error when close pipe\r\n");
- #endif
- }
- deviceInstance->controlPipe = NULL;
- }
- /* free configuration buffer */
- if (deviceInstance->configurationDesc != NULL)
- {
- #if ((defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE > 0U))
- SDK_Free(deviceInstance->configurationDesc);
- #else
- OSA_MemoryFree(deviceInstance->configurationDesc);
- #endif
- }
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- level = deviceInstance->level;
- #endif
- #if ((defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE > 0U))
- SDK_Free(deviceInstance->deviceDescriptor);
- #else
- OSA_MemoryFree(deviceInstance->deviceDescriptor);
- #endif
- /* free device instance buffer */
- OSA_MemoryFree(deviceInstance);
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- /* enable controller attach if root hub */
- if (level == 1U)
- {
- (void)USB_HostControlBus(hostInstance, (uint8_t)kUSB_HostBusEnableAttach);
- }
- #else
- /* enable controller attach */
- USB_HostControlBus(hostInstance, (uint8_t)kUSB_HostBusEnableAttach);
- #endif
- }
- static usb_status_t USB_HostParseDeviceConfigurationDescriptor(usb_device_handle deviceHandle)
- {
- usb_host_device_instance_t *deviceInstance = (usb_host_device_instance_t *)deviceHandle;
- uint32_t endPos;
- usb_descriptor_union_t *unionDes;
- usb_host_interface_t *interfaceParse = NULL;
- usb_host_ep_t *epParse;
- uint8_t *buffer;
- void *temp;
- if (deviceHandle == NULL)
- {
- return kStatus_USB_InvalidParameter;
- }
- temp = (void *)&deviceInstance->configuration;
- buffer = (uint8_t *)temp;
- /* clear the previous parse result, note: end_pos means buffer index here*/
- for (endPos = 0U; endPos < sizeof(usb_host_configuration_t); endPos++)
- {
- buffer[endPos] = 0U;
- }
- for (endPos = 0U; endPos < USB_HOST_CONFIG_CONFIGURATION_MAX_INTERFACE; ++endPos)
- {
- deviceInstance->interfaceStatus[endPos] = 0U;
- }
- /* parse configuration descriptor */
- temp = (void *)deviceInstance->configurationDesc;
- unionDes = (usb_descriptor_union_t *)temp;
- endPos = (uint32_t)(deviceInstance->configurationDesc + deviceInstance->configurationLen);
- if ((unionDes->common.bLength == USB_DESCRIPTOR_LENGTH_CONFIGURE) &&
- (unionDes->common.bDescriptorType == USB_DESCRIPTOR_TYPE_CONFIGURE))
- {
- /* configuration descriptor */
- temp = (void *)unionDes;
- deviceInstance->configuration.configurationDesc = (usb_descriptor_configuration_t *)temp;
- deviceInstance->configuration.configurationExtensionLength = 0;
- deviceInstance->configuration.configurationExtension = NULL;
- deviceInstance->configuration.interfaceCount = 0;
- unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
- while ((uint32_t)unionDes < endPos)
- {
- if (unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_INTERFACE)
- {
- if (deviceInstance->configuration.configurationExtension == NULL)
- {
- deviceInstance->configuration.configurationExtension = (uint8_t *)unionDes;
- }
- if ((unionDes->common.bDescriptorType == 0x00U) ||
- (unionDes->common.bLength == 0x00U)) /* the descriptor data is wrong */
- {
- return kStatus_USB_Error;
- }
- deviceInstance->configuration.configurationExtensionLength += unionDes->common.bLength;
- unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
- }
- else
- {
- break;
- }
- }
- /* interface descriptor */
- deviceInstance->configuration.interfaceCount = 0U;
- while ((uint32_t)unionDes < endPos)
- {
- if (unionDes->common.bDescriptorType == USB_DESCRIPTOR_TYPE_INTERFACE)
- {
- if (unionDes->interface.bAlternateSetting == 0x00U)
- {
- if (deviceInstance->configuration.interfaceCount >= USB_HOST_CONFIG_CONFIGURATION_MAX_INTERFACE)
- {
- #if (((defined USB_HOST_CONFIG_COMPLIANCE_TEST) && (USB_HOST_CONFIG_COMPLIANCE_TEST)) || defined(HOST_ECHO))
- (void)usb_echo(
- "Unsupported Device attached\r\n too many interfaces in one configuration, please increase "
- "the USB_HOST_CONFIG_CONFIGURATION_MAX_INTERFACE value\n");
- #endif
- return kStatus_USB_Error;
- }
- interfaceParse =
- &deviceInstance->configuration.interfaceList[deviceInstance->configuration.interfaceCount];
- deviceInstance->configuration.interfaceCount++;
- interfaceParse->alternateSettingNumber = 0;
- interfaceParse->epCount = 0;
- interfaceParse->interfaceDesc = &unionDes->interface;
- interfaceParse->interfaceExtensionLength = 0;
- interfaceParse->interfaceExtension = NULL;
- interfaceParse->interfaceIndex = unionDes->interface.bInterfaceNumber;
- if (unionDes->common.bLength == 0x00U) /* the descriptor data is wrong */
- {
- return kStatus_USB_Error;
- }
- unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
- while ((uint32_t)unionDes < endPos)
- {
- if ((unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_INTERFACE) &&
- (unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_ENDPOINT))
- {
- if (interfaceParse->interfaceExtension == NULL)
- {
- interfaceParse->interfaceExtension = (uint8_t *)unionDes;
- }
- if ((unionDes->common.bDescriptorType == 0x00U) ||
- (unionDes->common.bLength == 0x00U)) /* the descriptor data is wrong */
- {
- return kStatus_USB_Error;
- }
- interfaceParse->interfaceExtensionLength += unionDes->common.bLength;
- unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
- }
- else
- {
- break;
- }
- }
- /* endpoint descriptor */
- if (interfaceParse->interfaceDesc->bNumEndpoints != 0U)
- {
- if ((unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_ENDPOINT) ||
- (interfaceParse->interfaceDesc->bNumEndpoints > USB_HOST_CONFIG_INTERFACE_MAX_EP))
- {
- #ifdef HOST_ECHO
- usb_echo("interface descriptor error\n");
- #endif
- return kStatus_USB_Error;
- }
- for (; interfaceParse->epCount < interfaceParse->interfaceDesc->bNumEndpoints;
- (interfaceParse->epCount)++)
- {
- if (((uint32_t)unionDes >= endPos) ||
- (unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_ENDPOINT))
- {
- #ifdef HOST_ECHO
- usb_echo("endpoint descriptor error\n");
- #endif
- return kStatus_USB_Error;
- }
- temp = (void *)&interfaceParse->epList[interfaceParse->epCount];
- epParse = (usb_host_ep_t *)temp;
- temp = (void *)unionDes;
- epParse->epDesc = (usb_descriptor_endpoint_t *)temp;
- epParse->epExtensionLength = 0U;
- epParse->epExtension = NULL;
- if (unionDes->common.bLength == 0x00U) /* the descriptor data is wrong */
- {
- return kStatus_USB_Error;
- }
- unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
- while ((uint32_t)unionDes < endPos)
- {
- if ((unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_ENDPOINT) &&
- (unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_INTERFACE))
- {
- if (epParse->epExtension == NULL)
- {
- epParse->epExtension = (uint8_t *)unionDes;
- }
- if ((unionDes->common.bDescriptorType == 0x00U) ||
- (unionDes->common.bLength == 0x00U)) /* the descriptor data is wrong */
- {
- return kStatus_USB_Error;
- }
- epParse->epExtensionLength += unionDes->common.bLength;
- unionDes =
- (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
- }
- else
- {
- break;
- }
- }
- }
- }
- }
- else
- {
- if (interfaceParse == NULL)
- {
- return kStatus_USB_Error; /* in normal situation this cannot reach */
- }
- interfaceParse->alternateSettingNumber++;
- if (interfaceParse->interfaceExtension == NULL)
- {
- interfaceParse->interfaceExtension = (uint8_t *)unionDes;
- }
- if (unionDes->common.bLength == 0x00U) /* the descriptor data is wrong */
- {
- return kStatus_USB_Error;
- }
- interfaceParse->interfaceExtensionLength += unionDes->common.bLength;
- unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
- while ((uint32_t)unionDes < endPos)
- {
- if (unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_INTERFACE)
- {
- if ((unionDes->common.bDescriptorType == 0x00U) ||
- (unionDes->common.bLength == 0x00U)) /* the descriptor data is wrong */
- {
- return kStatus_USB_Error;
- }
- interfaceParse->interfaceExtensionLength += unionDes->common.bLength;
- unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
- }
- else
- {
- break;
- }
- }
- }
- }
- else
- {
- return kStatus_USB_Error;
- }
- }
- }
- for (endPos = 0U; endPos < deviceInstance->configuration.interfaceCount; ++endPos)
- {
- deviceInstance->interfaceStatus[endPos] = (uint8_t)kStatus_interface_Attached;
- }
- return kStatus_USB_Success;
- }
- usb_status_t USB_HostAttachDevice(usb_host_handle hostHandle,
- uint8_t speed,
- uint8_t hubNumber,
- uint8_t portNumber,
- uint8_t level,
- usb_device_handle *deviceHandle)
- {
- usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
- usb_host_device_instance_t *newInstance;
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- usb_host_device_instance_t *currentInstance;
- #endif
- uint8_t address;
- usb_host_pipe_init_t pipeInit;
- if (hostHandle == NULL)
- {
- return kStatus_USB_InvalidHandle;
- }
- /* check whether is the device attached? */
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- currentInstance = (usb_host_device_instance_t *)hostInstance->deviceList;
- while (currentInstance != NULL)
- {
- if ((currentInstance->hubNumber == hubNumber) && (currentInstance->portNumber == portNumber))
- {
- *deviceHandle = NULL;
- #ifdef HOST_ECHO
- usb_echo("device has attached\r\n");
- #endif
- return kStatus_USB_Busy;
- }
- else
- {
- currentInstance = currentInstance->next;
- }
- }
- #else
- if (hostInstance->deviceList != NULL)
- {
- *deviceHandle = NULL;
- usb_echo("device has attached\r\n");
- return kStatus_USB_Busy;
- }
- #endif
- /* Allocate new device instance */
- newInstance = (usb_host_device_instance_t *)OSA_MemoryAllocate(sizeof(usb_host_device_instance_t));
- if (newInstance == NULL)
- {
- #ifdef HOST_ECHO
- usb_echo("allocate dev instance fail\r\n");
- #endif
- (void)USB_HostNotifyDevice(hostInstance, NULL, (uint32_t)kUSB_HostEventEnumerationFail,
- (uint32_t)kStatus_USB_AllocFail);
- return kStatus_USB_AllocFail;
- }
- /* new instance fields init */
- newInstance->hostHandle = hostHandle;
- newInstance->speed = speed;
- newInstance->stallRetries = USB_HOST_CONFIG_ENUMERATION_MAX_STALL_RETRIES;
- newInstance->enumRetries = USB_HOST_CONFIG_ENUMERATION_MAX_RETRIES;
- newInstance->setAddress = 0;
- newInstance->deviceAttachState = (uint8_t)kStatus_device_Attached;
- #if ((defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE > 0U))
- newInstance->deviceDescriptor =
- (usb_descriptor_device_t *)SDK_Malloc(sizeof(usb_descriptor_device_t) + 9, USB_CACHE_LINESIZE);
- #else
- newInstance->deviceDescriptor = (usb_descriptor_device_t *)OSA_MemoryAllocate(sizeof(usb_descriptor_device_t) + 9U);
- #endif
- if (newInstance->deviceDescriptor == NULL)
- {
- #ifdef HOST_ECHO
- usb_echo("allocate newInstance->deviceDescriptor fail\r\n");
- #endif
- #if ((defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE > 0U))
- SDK_Free(newInstance->deviceDescriptor);
- #else
- OSA_MemoryFree(newInstance->deviceDescriptor);
- #endif
- OSA_MemoryFree(newInstance);
- (void)USB_HostNotifyDevice(hostInstance, NULL, (uint32_t)kUSB_HostEventEnumerationFail,
- (uint32_t)kStatus_USB_AllocFail);
- return kStatus_USB_AllocFail;
- }
- newInstance->enumBuffer = (uint8_t *)((uint8_t *)newInstance->deviceDescriptor + sizeof(usb_descriptor_device_t));
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- newInstance->hubNumber = hubNumber;
- newInstance->portNumber = portNumber;
- newInstance->level = level;
- if ((speed != USB_SPEED_HIGH) && (level > 1U))
- {
- newInstance->hsHubNumber = (uint8_t)USB_HostHubGetHsHubNumber(hostHandle, hubNumber);
- newInstance->hsHubPort = (uint8_t)USB_HostHubGetHsHubPort(hostHandle, hubNumber, portNumber);
- }
- else
- {
- newInstance->hsHubNumber = hubNumber;
- newInstance->hsHubPort = portNumber;
- }
- #endif /* USB_HOST_CONFIG_HUB */
- (void)USB_HostLock();
- /* allocate address && insert to the dev list */
- address = USB_HostAllocateDeviceAddress(hostInstance);
- if (address == 0U)
- {
- #ifdef HOST_ECHO
- usb_echo("allocate address fail\r\n");
- #endif
- (void)USB_HostUnlock();
- #if ((defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE > 0U))
- SDK_Free(newInstance->deviceDescriptor);
- #else
- OSA_MemoryFree(newInstance->deviceDescriptor);
- #endif
- OSA_MemoryFree(newInstance);
- (void)USB_HostNotifyDevice(hostInstance, NULL, (uint32_t)kUSB_HostEventEnumerationFail,
- (uint32_t)kStatus_USB_Error);
- return kStatus_USB_Error;
- }
- newInstance->allocatedAddress = address;
- newInstance->next = (usb_host_device_instance_t *)hostInstance->deviceList;
- hostInstance->deviceList = newInstance;
- newInstance->state = (uint8_t)kStatus_DEV_Initial;
- (void)USB_HostUnlock();
- /* open control pipe */
- pipeInit.devInstance = newInstance;
- pipeInit.pipeType = USB_ENDPOINT_CONTROL;
- pipeInit.direction = 0;
- pipeInit.endpointAddress = 0;
- pipeInit.interval = 0;
- pipeInit.maxPacketSize = 8;
- pipeInit.numberPerUframe = 0;
- pipeInit.nakCount = USB_HOST_CONFIG_MAX_NAK;
- if (USB_HostOpenPipe(hostHandle, &newInstance->controlPipe, &pipeInit) != kStatus_USB_Success)
- {
- /* don't need release resource, resource is released when detach */
- *deviceHandle = newInstance;
- #if ((defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE > 0U))
- SDK_Free(newInstance->deviceDescriptor);
- #else
- OSA_MemoryFree(newInstance->deviceDescriptor);
- #endif
- OSA_MemoryFree(newInstance);
- (void)USB_HostNotifyDevice(hostInstance, NULL, (uint32_t)kUSB_HostEventEnumerationFail,
- (uint32_t)kStatus_USB_Error);
- return kStatus_USB_Error;
- }
- /* start enumeration */
- newInstance->state = (uint8_t)kStatus_DEV_GetDes8;
- /* process enumeration state machine */
- if (USB_HostProcessState(newInstance) != kStatus_USB_Success)
- {
- (void)USB_HostNotifyDevice(hostInstance, newInstance, (uint32_t)kUSB_HostEventEnumerationFail,
- (uint32_t)kStatus_USB_Error);
- }
- *deviceHandle = newInstance;
- return kStatus_USB_Success;
- }
- usb_status_t USB_HostDetachDevice(usb_host_handle hostHandle, uint8_t hubNumber, uint8_t portNumber)
- {
- usb_host_device_instance_t *deviceInstance;
- usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
- if (hostHandle == NULL)
- {
- return kStatus_USB_InvalidHandle;
- }
- (void)USB_HostLock();
- /* search for device instance handle */
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- deviceInstance = (usb_host_device_instance_t *)hostInstance->deviceList;
- while (deviceInstance != NULL)
- {
- if ((deviceInstance->hubNumber == hubNumber) && (deviceInstance->portNumber == portNumber))
- {
- break;
- }
- deviceInstance = deviceInstance->next;
- }
- #else
- deviceInstance = (usb_host_device_instance_t *)hostInstance->deviceList;
- #endif
- (void)USB_HostUnlock();
- if (deviceInstance != NULL)
- {
- return USB_HostDetachDeviceInternal(hostHandle, deviceInstance); /* device instance detach */
- }
- return kStatus_USB_Success;
- }
- usb_status_t USB_HostDetachDeviceInternal(usb_host_handle hostHandle, usb_device_handle deviceHandle)
- {
- usb_host_device_instance_t *deviceInstance = (usb_host_device_instance_t *)deviceHandle;
- usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
- if ((hostHandle == NULL) || (deviceHandle == NULL))
- {
- return kStatus_USB_InvalidHandle;
- }
- deviceInstance->deviceAttachState = (uint8_t)kStatus_device_Detached; /* mark the device is detached from host */
- if (deviceInstance->state >= (uint8_t)kStatus_DEV_Initial) /* device instance is valid */
- {
- /* detach internally */
- if (deviceInstance->state < (uint8_t)kStatus_DEV_AppUsed) /* enumeration is not done */
- {
- if (deviceInstance->controlPipe != NULL)
- {
- (void)USB_HostCancelTransfer(hostInstance, deviceInstance->controlPipe, NULL);
- }
- /* remove device instance from host */
- (void)USB_HostRemoveDeviceInstance(hostInstance, deviceInstance);
- USB_HostReleaseDeviceResource(hostInstance, deviceInstance);
- }
- else /* enumeration has be done and notified application */
- {
- /* notify application device detach */
- (void)USB_HostNotifyDevice(hostInstance, deviceInstance, (uint32_t)kUSB_HostEventDetach,
- (uint32_t)kStatus_USB_Success);
- }
- }
- return kStatus_USB_Success;
- }
- uint8_t USB_HostGetDeviceAttachState(usb_device_handle deviceHandle)
- {
- return (NULL != deviceHandle) ? ((usb_host_device_instance_t *)deviceHandle)->deviceAttachState : 0x0U;
- }
- usb_status_t USB_HostValidateDevice(usb_host_handle hostHandle, usb_device_handle deviceHandle)
- {
- usb_host_device_instance_t *searchDev;
- if (deviceHandle == NULL)
- {
- return kStatus_USB_InvalidParameter;
- }
- /* search for the device */
- searchDev = (usb_host_device_instance_t *)((usb_host_instance_t *)hostHandle)->deviceList;
- while ((searchDev != NULL) && ((usb_device_handle)searchDev != deviceHandle))
- {
- searchDev = searchDev->next;
- }
- if (NULL != searchDev)
- {
- return kStatus_USB_Success;
- }
- return kStatus_USB_Error;
- }
- static usb_status_t USB_HostControlBus(usb_host_handle hostHandle, uint8_t controlType)
- {
- usb_status_t status = kStatus_USB_Success;
- usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
- if (hostHandle == NULL)
- {
- return kStatus_USB_InvalidHandle;
- }
- /* the callbackFn is initialized in USB_HostGetControllerInterface */
- status = hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostBusControl,
- &controlType);
- return status;
- }
- usb_status_t USB_HostOpenDeviceInterface(usb_device_handle deviceHandle, usb_host_interface_handle interfaceHandle)
- {
- usb_host_device_instance_t *deviceInstance = (usb_host_device_instance_t *)deviceHandle;
- usb_host_instance_t *hostInstance = NULL;
- uint8_t interfaceIndex;
- uint8_t index = 0;
- if ((deviceHandle == NULL) || (interfaceHandle == NULL))
- {
- return kStatus_USB_InvalidHandle;
- }
- hostInstance = (usb_host_instance_t *)deviceInstance->hostHandle;
- (void)USB_HostLock();
- /* check host_instance valid? */
- for (; index < USB_HOST_CONFIG_MAX_HOST; ++index)
- {
- if ((g_UsbHostInstance[index].occupied == 1U) &&
- ((usb_host_instance_t *)(&g_UsbHostInstance[index]) == (hostInstance)))
- {
- break;
- }
- }
- if (index >= USB_HOST_CONFIG_MAX_HOST)
- {
- (void)USB_HostUnlock();
- return kStatus_USB_Error;
- }
- /* check deviceHandle valid? */
- if (USB_HostValidateDevice(hostInstance, deviceHandle) != kStatus_USB_Success)
- {
- (void)USB_HostUnlock();
- return kStatus_USB_Error;
- }
- /* search interface and set the interface as opened */
- for (interfaceIndex = 0; interfaceIndex < deviceInstance->configuration.interfaceCount; ++interfaceIndex)
- {
- if (&deviceInstance->configuration.interfaceList[interfaceIndex] == interfaceHandle)
- {
- deviceInstance->interfaceStatus[interfaceIndex] = (uint8_t)kStatus_interface_Opened;
- break;
- }
- }
- (void)USB_HostUnlock();
- return kStatus_USB_Success;
- }
- usb_status_t USB_HostCloseDeviceInterface(usb_device_handle deviceHandle, usb_host_interface_handle interfaceHandle)
- {
- usb_host_device_instance_t *deviceInstance = (usb_host_device_instance_t *)deviceHandle;
- usb_host_instance_t *hostInstance = NULL;
- uint8_t interfaceIndex;
- uint8_t removeLabel = 1;
- uint8_t index = 0;
- if (deviceHandle == NULL)
- {
- return kStatus_USB_InvalidHandle;
- }
- hostInstance = (usb_host_instance_t *)deviceInstance->hostHandle;
- (void)USB_HostLock();
- /* check host_instance valid? */
- for (; index < USB_HOST_CONFIG_MAX_HOST; ++index)
- {
- if ((g_UsbHostInstance[index].occupied == 1U) &&
- ((usb_host_instance_t *)(&g_UsbHostInstance[index]) == (hostInstance)))
- {
- break;
- }
- }
- if (index >= USB_HOST_CONFIG_MAX_HOST)
- {
- (void)USB_HostUnlock();
- return kStatus_USB_Error;
- }
- /* check deviceHandle valid? */
- if (USB_HostValidateDevice(hostInstance, deviceHandle) != kStatus_USB_Success)
- {
- (void)USB_HostUnlock();
- return kStatus_USB_Error;
- }
- if (interfaceHandle != NULL)
- {
- /* search interface and set the interface as detached */
- for (interfaceIndex = 0; interfaceIndex < deviceInstance->configuration.interfaceCount; ++interfaceIndex)
- {
- if (&deviceInstance->configuration.interfaceList[interfaceIndex] == interfaceHandle)
- {
- deviceInstance->interfaceStatus[interfaceIndex] = (uint8_t)kStatus_interface_Detached;
- break;
- }
- }
- }
- if (deviceInstance->deviceAttachState == (uint8_t)kStatus_device_Detached) /* device is removed from host */
- {
- removeLabel = 1;
- /* check all the interfaces of the device are not opened */
- for (interfaceIndex = 0; interfaceIndex < deviceInstance->configuration.interfaceCount; ++interfaceIndex)
- {
- if (deviceInstance->interfaceStatus[interfaceIndex] == (uint8_t)kStatus_interface_Opened)
- {
- removeLabel = 0U;
- break;
- }
- }
- if (removeLabel == 1U)
- {
- /* remove device instance from host */
- (void)USB_HostRemoveDeviceInstance(hostInstance, deviceInstance);
- }
- (void)USB_HostUnlock();
- if (removeLabel == 1U)
- {
- USB_HostReleaseDeviceResource((usb_host_instance_t *)deviceInstance->hostHandle,
- deviceInstance); /* release device resource */
- }
- }
- else
- {
- (void)USB_HostUnlock();
- }
- return kStatus_USB_Success;
- }
- usb_status_t USB_HostRemoveDevice(usb_host_handle hostHandle, usb_device_handle deviceHandle)
- {
- usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
- usb_host_device_instance_t *deviceInstance = (usb_host_device_instance_t *)deviceHandle;
- uint8_t interfaceIndex = 0;
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- uint8_t level = 0;
- uint8_t devHubNo;
- uint8_t devPortNo;
- #endif
- if ((hostHandle == NULL) || (deviceHandle == NULL))
- {
- return kStatus_USB_InvalidHandle;
- }
- if (deviceInstance->hostHandle != hostHandle)
- {
- return kStatus_USB_InvalidParameter;
- }
- if (USB_HostValidateDevice(hostInstance, deviceInstance) == kStatus_USB_Success) /* device is valid */
- {
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- devHubNo = deviceInstance->hubNumber;
- devPortNo = deviceInstance->portNumber;
- level = deviceInstance->level;
- #endif
- deviceInstance->deviceAttachState = (uint8_t)kStatus_device_Detached;
- if (deviceInstance->state >= (uint8_t)kStatus_DEV_Initial) /* device is valid */
- {
- if (deviceInstance->state <
- (uint8_t)kStatus_DEV_AppUsed) /* enumeration is not done or application don't use */
- {
- /* detach internally */
- (void)USB_HostDetachDeviceInternal(hostHandle, deviceHandle);
- }
- else /* application use the device */
- {
- for (interfaceIndex = 0U; interfaceIndex < deviceInstance->configuration.interfaceCount;
- ++interfaceIndex)
- {
- if (deviceInstance->interfaceStatus[interfaceIndex] == (uint8_t)kStatus_interface_Opened)
- {
- #ifdef HOST_ECHO
- usb_echo("error: there is class instance that is not deinited\r\n");
- #endif
- break;
- }
- }
- /* remove device instance from host */
- (void)USB_HostRemoveDeviceInstance(hostInstance, deviceInstance);
- USB_HostReleaseDeviceResource(hostInstance, deviceInstance); /* release resource */
- }
- }
- #if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
- if (level == 1U)
- {
- (void)USB_HostControlBus(hostHandle, (uint8_t)kUSB_HostBusReset); /* reset controller port */
- (void)USB_HostControlBus(hostHandle, (uint8_t)kUSB_HostBusRestart); /* restart controller port */
- }
- else
- {
- (void)USB_HostHubRemovePort(hostHandle, devHubNo, devPortNo); /* reset hub port */
- }
- #else
- USB_HostControlBus(hostHandle, kUSB_HostBusReset); /* reset controller port */
- USB_HostControlBus(hostHandle, kUSB_HostBusRestart); /* restart controller port */
- #endif /* USB_HOST_CONFIG_HUB */
- }
- return kStatus_USB_Success;
- }
|