1066 lines
38 KiB
C
1066 lines
38 KiB
C
/*
|
|
* Copyright (c) 2015 - 2016, Freescale Semiconductor, Inc.
|
|
* Copyright 2016 - 2019 NXP
|
|
* All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
|
*/
|
|
|
|
#include "usb_host_config.h"
|
|
#include "fsl_common.h"
|
|
#include "usb_host.h"
|
|
#include "usb_host_hci.h"
|
|
#include "usb_host_devices.h"
|
|
#include "fsl_device_registers.h"
|
|
#if ((defined USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE))
|
|
#include "fsl_cache.h"
|
|
#endif
|
|
|
|
/*******************************************************************************
|
|
* Definitions
|
|
******************************************************************************/
|
|
|
|
/* Component ID definition, used by tools. */
|
|
#ifndef FSL_COMPONENT_ID
|
|
#define FSL_COMPONENT_ID "middleware.usb.host_stack"
|
|
#endif
|
|
|
|
#if defined __CORTEX_M && (__CORTEX_M == 7U)
|
|
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE > 0U))
|
|
#warning USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE is not supported.
|
|
#endif
|
|
#endif
|
|
|
|
/*******************************************************************************
|
|
* Prototypes
|
|
******************************************************************************/
|
|
#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
|
|
|
|
#include "usb_host_hub.h"
|
|
#include "usb_host_hub_app.h"
|
|
#endif
|
|
|
|
/*!
|
|
* @brief get the idle host instance.
|
|
*
|
|
* @return host instance pointer.
|
|
*/
|
|
static usb_host_instance_t *USB_HostGetInstance(void);
|
|
|
|
/*!
|
|
* @brief release host instance.
|
|
*
|
|
* @param hostInstance host instance pointer.
|
|
*/
|
|
static void USB_HostReleaseInstance(usb_host_instance_t *hostInstance);
|
|
|
|
/*!
|
|
* @brief get the khci/ehci interface.
|
|
*
|
|
* @param controllerId controller id.
|
|
* @param controllerTable return controller interface structure.
|
|
*/
|
|
static void USB_HostGetControllerInterface(uint8_t controllerId,
|
|
const usb_host_controller_interface_t **controllerTable);
|
|
|
|
/*******************************************************************************
|
|
* Variables
|
|
******************************************************************************/
|
|
/*! @brief USB host instance resource */
|
|
usb_host_instance_t g_UsbHostInstance[USB_HOST_CONFIG_MAX_HOST];
|
|
|
|
#if ((defined USB_HOST_CONFIG_EHCI) && (USB_HOST_CONFIG_EHCI))
|
|
#include "usb_host_ehci.h"
|
|
static const usb_host_controller_interface_t s_EhciInterface = {
|
|
USB_HostEhciCreate, USB_HostEhciDestory, USB_HostEhciOpenPipe, USB_HostEhciClosePipe,
|
|
USB_HostEhciWritePipe, USB_HostEhciReadpipe, USB_HostEhciIoctl,
|
|
};
|
|
#endif /* USB_HOST_CONFIG_EHCI */
|
|
|
|
#if ((defined USB_HOST_CONFIG_KHCI) && (USB_HOST_CONFIG_KHCI))
|
|
#include "usb_host_khci.h"
|
|
static const usb_host_controller_interface_t s_KhciInterface = {
|
|
USB_HostKhciCreate, USB_HostKhciDestory, USB_HostKhciOpenPipe, USB_HostKhciClosePipe,
|
|
USB_HostKhciWritePipe, USB_HostKhciReadpipe, USB_HostKciIoctl,
|
|
};
|
|
#endif /* USB_HOST_CONFIG_KHCI */
|
|
|
|
#if ((defined USB_HOST_CONFIG_OHCI) && (USB_HOST_CONFIG_OHCI > 0U))
|
|
#include "usb_host_ohci.h"
|
|
static const usb_host_controller_interface_t s_OhciInterface = {
|
|
USB_HostOhciCreate, USB_HostOhciDestory, USB_HostOhciOpenPipe, USB_HostOhciClosePipe,
|
|
USB_HostOhciWritePipe, USB_HostOhciReadPipe, USB_HostOhciIoctl,
|
|
};
|
|
#endif /* USB_HOST_CONFIG_OHCI */
|
|
|
|
#if ((defined USB_HOST_CONFIG_IP3516HS) && (USB_HOST_CONFIG_IP3516HS > 0U))
|
|
#include "usb_host_ip3516hs.h"
|
|
static const usb_host_controller_interface_t s_Ip3516HsInterface = {
|
|
USB_HostIp3516HsCreate, USB_HostIp3516HsDestory, USB_HostIp3516HsOpenPipe, USB_HostIp3516HsClosePipe,
|
|
USB_HostIp3516HsWritePipe, USB_HostIp3516HsReadPipe, USB_HostIp3516HsIoctl,
|
|
};
|
|
#endif /* USB_HOST_CONFIG_IP3516HS */
|
|
|
|
USB_DMA_NONINIT_DATA_ALIGN(USB_DATA_ALIGN_SIZE)
|
|
static uint8_t s_Setupbuffer[USB_HOST_CONFIG_MAX_HOST][USB_HOST_CONFIG_MAX_TRANSFERS][USB_DATA_ALIGN_SIZE_MULTIPLE(8)];
|
|
/*******************************************************************************
|
|
* Code
|
|
******************************************************************************/
|
|
|
|
#if ((defined USB_HOST_CONFIG_COMPLIANCE_TEST) && (USB_HOST_CONFIG_COMPLIANCE_TEST))
|
|
/*FUNCTION*----------------------------------------------------------------
|
|
*
|
|
* Function Name : usb_test_mode_init
|
|
* Returned Value : None
|
|
* Comments :
|
|
* This function is called by common class to initialize the class driver. It
|
|
* is called in response to a select interface call by application
|
|
*
|
|
*END*--------------------------------------------------------------------*/
|
|
usb_status_t USB_HostTestModeInit(usb_device_handle deviceHandle)
|
|
{
|
|
#if (((defined USB_HOST_CONFIG_EHCI) && (USB_HOST_CONFIG_EHCI)) || \
|
|
((defined USB_HOST_CONFIG_IP3516HS) && (USB_HOST_CONFIG_IP3516HS)))
|
|
usb_host_device_instance_t *deviceInstance = (usb_host_device_instance_t *)deviceHandle;
|
|
usb_host_instance_t *hostInstance = (usb_host_instance_t *)deviceInstance->hostHandle;
|
|
#endif
|
|
uint32_t productId;
|
|
uint32_t vendorId;
|
|
|
|
(void)usb_echo("usb host test init\r\n");
|
|
(void)USB_HostHelperGetPeripheralInformation(deviceHandle, (uint32_t)kUSB_HostGetDevicePID, &productId);
|
|
(void)USB_HostHelperGetPeripheralInformation(deviceHandle, (uint32_t)kUSB_HostGetDeviceVID, &vendorId);
|
|
(void)usb_echo(" vendor id :0x%x product id:0x%x \r\n", vendorId, productId);
|
|
|
|
if ((productId != 0x0200U) && (productId != 0x0101U) && (productId != 0x0102U) && (productId != 0x0103U) &&
|
|
(productId != 0x0104U) && (productId != 0x0105U) && (productId != 0x0106U) && (productId != 0x0107U) &&
|
|
(productId != 0x0108U))
|
|
{
|
|
(void)usb_echo("Unsupported Device\r\n");
|
|
}
|
|
|
|
if (productId == 0x0200U)
|
|
{
|
|
(void)usb_echo("PET test device attached\r\n");
|
|
}
|
|
else
|
|
{
|
|
#if ((defined USB_HOST_CONFIG_EHCI) && (USB_HOST_CONFIG_EHCI))
|
|
if (hostInstance->controllerTable == &s_EhciInterface)
|
|
{
|
|
(void)hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostTestModeInit,
|
|
(void *)deviceHandle);
|
|
}
|
|
#elif ((defined USB_HOST_CONFIG_IP3516HS) && (USB_HOST_CONFIG_IP3516HS))
|
|
if (hostInstance->controllerTable == &s_Ip3516HsInterface)
|
|
{
|
|
(void)hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostTestModeInit,
|
|
(void *)deviceHandle);
|
|
}
|
|
#endif
|
|
}
|
|
|
|
return kStatus_USB_Success;
|
|
}
|
|
#endif
|
|
|
|
static usb_host_instance_t *USB_HostGetInstance(void)
|
|
{
|
|
uint8_t i = 0;
|
|
uint32_t index = 0;
|
|
void *temp;
|
|
OSA_SR_ALLOC();
|
|
OSA_ENTER_CRITICAL();
|
|
for (; i < USB_HOST_CONFIG_MAX_HOST; i++)
|
|
{
|
|
if (g_UsbHostInstance[i].occupied != 1U)
|
|
{
|
|
uint8_t *buffer = (uint8_t *)&g_UsbHostInstance[i];
|
|
for (uint32_t j = 0U; j < sizeof(usb_host_instance_t); j++)
|
|
{
|
|
buffer[j] = 0x00U;
|
|
}
|
|
g_UsbHostInstance[i].occupied = 1;
|
|
OSA_EXIT_CRITICAL();
|
|
for (index = 0; index < USB_HOST_CONFIG_MAX_TRANSFERS; ++index)
|
|
{
|
|
temp = (void *)&(s_Setupbuffer[i][index][0]);
|
|
g_UsbHostInstance[i].transferList[index].setupPacket = (usb_setup_struct_t *)temp;
|
|
}
|
|
return &g_UsbHostInstance[i];
|
|
}
|
|
}
|
|
OSA_EXIT_CRITICAL();
|
|
return NULL;
|
|
}
|
|
|
|
static void USB_HostReleaseInstance(usb_host_instance_t *hostInstance)
|
|
{
|
|
OSA_SR_ALLOC();
|
|
OSA_ENTER_CRITICAL();
|
|
hostInstance->occupied = 0;
|
|
OSA_EXIT_CRITICAL();
|
|
}
|
|
|
|
static void USB_HostGetControllerInterface(uint8_t controllerId,
|
|
const usb_host_controller_interface_t **controllerTable)
|
|
{
|
|
#if ((defined USB_HOST_CONFIG_KHCI) && (USB_HOST_CONFIG_KHCI))
|
|
if (controllerId == (uint8_t)kUSB_ControllerKhci0)
|
|
{
|
|
*controllerTable = &s_KhciInterface;
|
|
}
|
|
#endif /* USB_HOST_CONFIG_KHCI */
|
|
|
|
#if ((defined USB_HOST_CONFIG_EHCI) && (USB_HOST_CONFIG_EHCI))
|
|
if ((controllerId == (uint8_t)kUSB_ControllerEhci0) || (controllerId == (uint8_t)kUSB_ControllerEhci1))
|
|
{
|
|
*controllerTable = &s_EhciInterface;
|
|
}
|
|
#endif /* USB_HOST_CONFIG_EHCI */
|
|
|
|
#if ((defined USB_HOST_CONFIG_OHCI) && (USB_HOST_CONFIG_OHCI > 0U))
|
|
if (controllerId == (uint8_t)kUSB_ControllerOhci0)
|
|
{
|
|
*controllerTable = &s_OhciInterface;
|
|
}
|
|
#endif /* USB_HOST_CONFIG_OHCI */
|
|
|
|
#if ((defined USB_HOST_CONFIG_IP3516HS) && (USB_HOST_CONFIG_IP3516HS > 0U))
|
|
if (controllerId == (uint8_t)kUSB_ControllerIp3516Hs0)
|
|
{
|
|
*controllerTable = &s_Ip3516HsInterface;
|
|
}
|
|
#endif /* USB_HOST_CONFIG_IP3516HS */
|
|
}
|
|
|
|
usb_status_t USB_HostInit(uint8_t controllerId, usb_host_handle *hostHandle, host_callback_t callbackFn)
|
|
{
|
|
usb_status_t status = kStatus_USB_Success;
|
|
usb_host_instance_t *hostInstance = NULL;
|
|
usb_host_transfer_t *transferPrev = NULL;
|
|
uint8_t i = 0;
|
|
|
|
hostInstance = USB_HostGetInstance(); /* get one host instance */
|
|
if (hostInstance == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
|
|
/* get khci/ehci API table */
|
|
USB_HostGetControllerInterface(controllerId, &hostInstance->controllerTable);
|
|
if (hostInstance->controllerTable == NULL)
|
|
{
|
|
USB_HostReleaseInstance(hostInstance);
|
|
return kStatus_USB_ControllerNotFound;
|
|
}
|
|
|
|
/* judge the controller interface one time at here */
|
|
if ((hostInstance->controllerTable->controllerCreate == NULL) ||
|
|
(hostInstance->controllerTable->controllerDestory == NULL) ||
|
|
(hostInstance->controllerTable->controllerOpenPipe == NULL) ||
|
|
(hostInstance->controllerTable->controllerClosePipe == NULL) ||
|
|
(hostInstance->controllerTable->controllerWritePipe == NULL) ||
|
|
(hostInstance->controllerTable->controllerReadPipe == NULL) ||
|
|
(hostInstance->controllerTable->controllerIoctl == NULL))
|
|
{
|
|
return kStatus_USB_Error;
|
|
}
|
|
|
|
/* HOST instance init*/
|
|
hostInstance->controllerId = controllerId;
|
|
hostInstance->deviceCallback = callbackFn;
|
|
hostInstance->deviceList = NULL;
|
|
hostInstance->hostMutex = (osa_mutex_handle_t)(&hostInstance->mutexBuffer[0]);
|
|
if (KOSA_StatusSuccess != OSA_MutexCreate(hostInstance->hostMutex))
|
|
{
|
|
USB_HostReleaseInstance(hostInstance);
|
|
#ifdef HOST_ECHO
|
|
usb_echo("host init: create host mutex fail\r\n");
|
|
#endif
|
|
return kStatus_USB_Error;
|
|
}
|
|
|
|
/* initialize transfer list */
|
|
|
|
hostInstance->transferHead = &hostInstance->transferList[0];
|
|
transferPrev = hostInstance->transferHead;
|
|
for (i = 1; i < USB_HOST_CONFIG_MAX_TRANSFERS; ++i)
|
|
{
|
|
transferPrev->next = &hostInstance->transferList[i];
|
|
transferPrev = transferPrev->next;
|
|
}
|
|
|
|
/* controller create, the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status =
|
|
hostInstance->controllerTable->controllerCreate(controllerId, hostInstance, &(hostInstance->controllerHandle));
|
|
if ((status != kStatus_USB_Success) || (hostInstance->controllerHandle == NULL))
|
|
{
|
|
(void)OSA_MutexDestroy(hostInstance->hostMutex);
|
|
USB_HostReleaseInstance(hostInstance);
|
|
#ifdef HOST_ECHO
|
|
usb_echo("host init: controller init fail\r\n");
|
|
#endif
|
|
return kStatus_USB_Error;
|
|
}
|
|
|
|
*hostHandle = hostInstance;
|
|
return kStatus_USB_Success;
|
|
}
|
|
|
|
usb_status_t USB_HostDeinit(usb_host_handle hostHandle)
|
|
{
|
|
usb_status_t status = kStatus_USB_Success;
|
|
usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
|
|
usb_host_device_instance_t *deviceInstance = NULL;
|
|
|
|
if (hostHandle == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
|
|
/* device list detach */
|
|
deviceInstance = (usb_host_device_instance_t *)hostInstance->deviceList;
|
|
while (deviceInstance != NULL)
|
|
{
|
|
deviceInstance = (usb_host_device_instance_t *)hostInstance->deviceList;
|
|
(void)USB_HostDetachDeviceInternal(hostHandle, deviceInstance);
|
|
}
|
|
|
|
/* controller instance destroy, the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerDestory(hostInstance->controllerHandle);
|
|
hostInstance->controllerHandle = NULL;
|
|
if (status != kStatus_USB_Success)
|
|
{
|
|
#ifdef HOST_ECHO
|
|
usb_echo("host controller destroy fail\r\n");
|
|
#endif
|
|
}
|
|
|
|
/* resource release */
|
|
if (NULL != hostInstance->hostMutex)
|
|
{
|
|
(void)OSA_MutexDestroy(hostInstance->hostMutex);
|
|
hostInstance->hostMutex = NULL;
|
|
}
|
|
USB_HostReleaseInstance(hostInstance);
|
|
|
|
return status;
|
|
}
|
|
|
|
usb_status_t USB_HostOpenPipe(usb_host_handle hostHandle,
|
|
usb_host_pipe_handle *pipeHandle,
|
|
usb_host_pipe_init_t *pipeInit)
|
|
{
|
|
usb_status_t status = kStatus_USB_Success;
|
|
usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
if ((hostHandle == NULL) || (pipeInit == NULL))
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
|
|
/* call controller open pipe interface, the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerOpenPipe(hostInstance->controllerHandle, pipeHandle, pipeInit);
|
|
|
|
return status;
|
|
}
|
|
|
|
usb_status_t USB_HostClosePipe(usb_host_handle hostHandle, usb_host_pipe_handle pipeHandle)
|
|
{
|
|
usb_status_t status = kStatus_USB_Success;
|
|
usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
if ((hostHandle == NULL) || (pipeHandle == NULL))
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
|
|
/* call controller close pipe interface, the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerClosePipe(hostInstance->controllerHandle, pipeHandle);
|
|
|
|
return status;
|
|
}
|
|
|
|
usb_status_t USB_HostSend(usb_host_handle hostHandle, usb_host_pipe_handle pipeHandle, usb_host_transfer_t *transfer)
|
|
{
|
|
usb_status_t status = kStatus_USB_Success;
|
|
usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
if ((hostHandle == NULL) || (pipeHandle == NULL) || (transfer == NULL))
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
|
|
/* initialize transfer */
|
|
transfer->transferSofar = 0;
|
|
transfer->direction = USB_OUT;
|
|
|
|
(void)USB_HostLock(); /* This api can be called by host task and app task */
|
|
/* keep this code: in normal situation application will guarantee the device is attached when call send/receive function
|
|
*/
|
|
#if 0
|
|
if ((USB_HostValidateDevice(pipe_ptr->deviceHandle) != kStatus_USB_Success) || (!(USB_HostGetDeviceAttachState(pipe_ptr->deviceHandle))))
|
|
{
|
|
USB_HostUnlock();
|
|
return status;
|
|
}
|
|
#endif
|
|
/* call controller write pipe interface */
|
|
#if ((defined USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE))
|
|
if (transfer->transferLength > 0)
|
|
{
|
|
DCACHE_CleanByRange((uint32_t)transfer->transferBuffer, transfer->transferLength);
|
|
}
|
|
#endif
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerWritePipe(hostInstance->controllerHandle, pipeHandle, transfer);
|
|
|
|
(void)USB_HostUnlock();
|
|
return status;
|
|
}
|
|
|
|
usb_status_t USB_HostSendSetup(usb_host_handle hostHandle,
|
|
usb_host_pipe_handle pipeHandle,
|
|
usb_host_transfer_t *transfer)
|
|
{
|
|
usb_status_t status = kStatus_USB_Success;
|
|
usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
if ((hostHandle == NULL) || (pipeHandle == NULL) || (transfer == NULL))
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
|
|
/* initialize transfer */
|
|
transfer->transferSofar = 0;
|
|
transfer->next = NULL;
|
|
transfer->setupStatus = 0;
|
|
if ((transfer->setupPacket->bmRequestType & USB_REQUEST_TYPE_DIR_MASK) == USB_REQUEST_TYPE_DIR_IN)
|
|
{
|
|
transfer->direction = USB_IN;
|
|
}
|
|
else
|
|
{
|
|
transfer->direction = USB_OUT;
|
|
}
|
|
|
|
(void)USB_HostLock(); /* This API can be called by host task and application task */
|
|
/* keep this code: in normal situation application will guarantee the device is attached when call send/receive function
|
|
*/
|
|
#if 0
|
|
if ((USB_HostValidateDevice(pipe_ptr->deviceHandle) != kStatus_USB_Success) || (!(USB_HostGetDeviceAttachState(pipe_ptr->deviceHandle))))
|
|
{
|
|
USB_HostUnlock();
|
|
return status;
|
|
}
|
|
#endif
|
|
/* call controller write pipe interface */
|
|
#if ((defined USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE))
|
|
DCACHE_CleanByRange((uint32_t)&transfer->setupPacket->bmRequestType, sizeof(usb_setup_struct_t));
|
|
if (transfer->transferLength > 0)
|
|
{
|
|
DCACHE_CleanInvalidateByRange((uint32_t)transfer->transferBuffer, transfer->transferLength);
|
|
}
|
|
#endif
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerWritePipe(hostInstance->controllerHandle, pipeHandle, transfer);
|
|
|
|
(void)USB_HostUnlock();
|
|
return status;
|
|
}
|
|
|
|
usb_status_t USB_HostRecv(usb_host_handle hostHandle, usb_host_pipe_handle pipeHandle, usb_host_transfer_t *transfer)
|
|
{
|
|
usb_status_t status = kStatus_USB_Success;
|
|
usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
if ((hostHandle == NULL) || (pipeHandle == NULL) || (transfer == NULL))
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
|
|
/* initialize transfer */
|
|
transfer->transferSofar = 0;
|
|
transfer->direction = USB_IN;
|
|
|
|
(void)USB_HostLock(); /* This API can be called by host task and application task */
|
|
/* keep this code: in normal situation application will guarantee the device is attached when call send/receive function
|
|
*/
|
|
#if 0
|
|
if ((USB_HostValidateDevice(pipe_ptr->deviceHandle) != kStatus_USB_Success) || (!(USB_HostGetDeviceAttachState(pipe_ptr->deviceHandle))))
|
|
{
|
|
USB_HostUnlock();
|
|
return status;
|
|
}
|
|
#endif
|
|
|
|
#if ((defined USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE))
|
|
if (transfer->transferLength > 0)
|
|
{
|
|
DCACHE_CleanInvalidateByRange((uint32_t)transfer->transferBuffer, transfer->transferLength);
|
|
}
|
|
#endif
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerReadPipe(hostInstance->controllerHandle, pipeHandle, transfer);
|
|
|
|
(void)USB_HostUnlock();
|
|
return status;
|
|
}
|
|
|
|
usb_status_t USB_HostCancelTransfer(usb_host_handle hostHandle,
|
|
usb_host_pipe_handle pipeHandle,
|
|
usb_host_transfer_t *transfer)
|
|
{
|
|
usb_status_t status = kStatus_USB_Success;
|
|
usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
|
|
usb_host_cancel_param_t cancelParam;
|
|
|
|
if ((hostHandle == NULL) || (pipeHandle == NULL))
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
|
|
/* initialize cancel parameter */
|
|
cancelParam.pipeHandle = pipeHandle;
|
|
cancelParam.transfer = transfer;
|
|
|
|
/* USB_HostLock(); This api can be called by host task and app task */
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostCancelTransfer,
|
|
&cancelParam);
|
|
/* USB_HostUnlock(); */
|
|
|
|
return status;
|
|
}
|
|
|
|
usb_status_t USB_HostMallocTransfer(usb_host_handle hostHandle, usb_host_transfer_t **transfer)
|
|
{
|
|
usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
if ((hostHandle == NULL) || (transfer == NULL))
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
|
|
/* get one from the transfer_head */
|
|
(void)USB_HostLock();
|
|
if (hostInstance->transferHead != NULL)
|
|
{
|
|
*transfer = hostInstance->transferHead;
|
|
hostInstance->transferHead = hostInstance->transferHead->next;
|
|
(void)USB_HostUnlock();
|
|
return kStatus_USB_Success;
|
|
}
|
|
else
|
|
{
|
|
*transfer = NULL;
|
|
(void)USB_HostUnlock();
|
|
return kStatus_USB_Error;
|
|
}
|
|
}
|
|
|
|
usb_status_t USB_HostFreeTransfer(usb_host_handle hostHandle, usb_host_transfer_t *transfer)
|
|
{
|
|
usb_host_instance_t *hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
if (hostHandle == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
if (transfer == NULL)
|
|
{
|
|
return kStatus_USB_Success;
|
|
}
|
|
|
|
/* release one to the transfer_head */
|
|
(void)USB_HostLock();
|
|
transfer->next = hostInstance->transferHead;
|
|
hostInstance->transferHead = transfer;
|
|
(void)USB_HostUnlock();
|
|
return kStatus_USB_Success;
|
|
}
|
|
|
|
usb_status_t USB_HostHelperGetPeripheralInformation(usb_device_handle deviceHandle,
|
|
uint32_t infoCode,
|
|
uint32_t *infoValue)
|
|
{
|
|
usb_host_device_instance_t *deviceInstance = (usb_host_device_instance_t *)deviceHandle;
|
|
uint32_t *temp;
|
|
usb_host_dev_info_t devInfo;
|
|
if ((deviceHandle == NULL) || (infoValue == NULL))
|
|
{
|
|
return kStatus_USB_InvalidParameter;
|
|
}
|
|
devInfo = (usb_host_dev_info_t)infoCode;
|
|
switch (devInfo)
|
|
{
|
|
case kUSB_HostGetDeviceAddress: /* device address */
|
|
|
|
*infoValue = (uint32_t)deviceInstance->setAddress;
|
|
break;
|
|
|
|
case kUSB_HostGetDeviceControlPipe: /* device control pipe */
|
|
temp = (uint32_t *)deviceInstance->controlPipe;
|
|
*infoValue = (uint32_t)temp;
|
|
break;
|
|
|
|
case kUSB_HostGetHostHandle: /* device host handle */
|
|
temp = (uint32_t *)deviceInstance->hostHandle;
|
|
*infoValue = (uint32_t)temp;
|
|
break;
|
|
|
|
#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
|
|
case kUSB_HostGetDeviceHubNumber: /* device hub address */
|
|
*infoValue = (uint32_t)deviceInstance->hubNumber;
|
|
break;
|
|
|
|
case kUSB_HostGetDevicePortNumber: /* device port no */
|
|
*infoValue = (uint32_t)deviceInstance->portNumber;
|
|
break;
|
|
|
|
case kUSB_HostGetDeviceLevel: /* device level */
|
|
*infoValue = (uint32_t)deviceInstance->level;
|
|
break;
|
|
|
|
case kUSB_HostGetDeviceHSHubNumber: /* device high-speed hub address */
|
|
*infoValue = (uint32_t)deviceInstance->hsHubNumber;
|
|
break;
|
|
|
|
case kUSB_HostGetDeviceHSHubPort: /* device high-speed hub port no */
|
|
*infoValue = (uint32_t)deviceInstance->hsHubPort;
|
|
break;
|
|
|
|
case kUSB_HostGetHubThinkTime: /* device hub think time */
|
|
*infoValue = USB_HostHubGetTotalThinkTime(deviceInstance->hostHandle, deviceInstance->hubNumber);
|
|
break;
|
|
#else
|
|
case kUSB_HostGetDeviceHubNumber: /* device hub address */
|
|
case kUSB_HostGetDevicePortNumber: /* device port no */
|
|
case kUSB_HostGetDeviceHSHubNumber: /* device high-speed hub address */
|
|
case kUSB_HostGetDeviceHSHubPort: /* device high-speed hub port no */
|
|
case kUSB_HostGetHubThinkTime: /* device hub think time */
|
|
*infoValue = 0;
|
|
break;
|
|
case kUSB_HostGetDeviceLevel: /* device level */
|
|
*infoValue = 1;
|
|
break;
|
|
#endif /* USB_HOST_CONFIG_HUB */
|
|
|
|
case kUSB_HostGetDeviceSpeed: /* device speed */
|
|
*infoValue = (uint32_t)deviceInstance->speed;
|
|
break;
|
|
|
|
case kUSB_HostGetDevicePID: /* device pid */
|
|
*infoValue = (uint32_t)USB_SHORT_FROM_LITTLE_ENDIAN_ADDRESS(deviceInstance->deviceDescriptor->idProduct);
|
|
break;
|
|
|
|
case kUSB_HostGetDeviceVID: /* device vid */
|
|
*infoValue = (uint32_t)USB_SHORT_FROM_LITTLE_ENDIAN_ADDRESS(deviceInstance->deviceDescriptor->idVendor);
|
|
break;
|
|
|
|
case kUSB_HostGetDeviceConfigIndex: /* device config index */
|
|
*infoValue = (uint32_t)deviceInstance->configurationValue - 1U;
|
|
break;
|
|
|
|
case kUSB_HostGetConfigurationDes: /* configuration descriptor pointer */
|
|
*infoValue = (uint32_t)deviceInstance->configurationDesc;
|
|
break;
|
|
|
|
case kUSB_HostGetConfigurationLength: /* configuration descriptor length */
|
|
*infoValue = (uint32_t)deviceInstance->configurationLen;
|
|
break;
|
|
|
|
default:
|
|
/*no action*/
|
|
break;
|
|
}
|
|
|
|
return kStatus_USB_Success;
|
|
}
|
|
|
|
usb_status_t USB_HostHelperParseAlternateSetting(usb_host_interface_handle interfaceHandle,
|
|
uint8_t alternateSetting,
|
|
usb_host_interface_t *interface)
|
|
{
|
|
uint32_t endPosition;
|
|
usb_descriptor_union_t *unionDes;
|
|
usb_host_ep_t *epParse;
|
|
void *temp;
|
|
if (interfaceHandle == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
|
|
if (alternateSetting == 0U)
|
|
{
|
|
return kStatus_USB_InvalidParameter;
|
|
}
|
|
|
|
/* parse configuration descriptor */
|
|
temp = (void *)((usb_host_interface_t *)interfaceHandle)->interfaceDesc;
|
|
;
|
|
unionDes = (usb_descriptor_union_t *)temp; /* interface extend descriptor start */
|
|
endPosition =
|
|
(uint32_t)unionDes +
|
|
((usb_host_interface_t *)interfaceHandle)->interfaceExtensionLength; /* interface extend descriptor end */
|
|
unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
|
|
|
|
/* search for the alternate setting interface descriptor */
|
|
while ((uint32_t)unionDes < endPosition)
|
|
{
|
|
if (unionDes->interface.bDescriptorType == USB_DESCRIPTOR_TYPE_INTERFACE)
|
|
{
|
|
if (unionDes->interface.bAlternateSetting == alternateSetting)
|
|
{
|
|
break;
|
|
}
|
|
else
|
|
{
|
|
unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
|
|
}
|
|
}
|
|
else
|
|
{
|
|
unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
|
|
}
|
|
}
|
|
if ((uint32_t)unionDes >= endPosition)
|
|
{
|
|
return kStatus_USB_Error;
|
|
}
|
|
|
|
/* initialize interface handle structure instance */
|
|
interface->interfaceDesc = &unionDes->interface;
|
|
interface->alternateSettingNumber = 0U;
|
|
interface->epCount = 0U;
|
|
interface->interfaceExtension = NULL;
|
|
interface->interfaceExtensionLength = 0U;
|
|
interface->interfaceIndex = unionDes->interface.bInterfaceNumber;
|
|
|
|
/* search for endpoint descriptor start position */
|
|
unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
|
|
while ((uint32_t)unionDes < endPosition)
|
|
{
|
|
if ((unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_INTERFACE) &&
|
|
(unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_ENDPOINT))
|
|
{
|
|
if (interface->interfaceExtension == NULL)
|
|
{
|
|
interface->interfaceExtension = (uint8_t *)unionDes;
|
|
}
|
|
interface->interfaceExtensionLength += unionDes->common.bLength;
|
|
unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
|
|
}
|
|
else
|
|
{
|
|
break;
|
|
}
|
|
}
|
|
|
|
/* parse endpoint descriptor */
|
|
if (interface->interfaceDesc->bNumEndpoints != 0U)
|
|
{
|
|
if ((unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_ENDPOINT) ||
|
|
(interface->interfaceDesc->bNumEndpoints > USB_HOST_CONFIG_INTERFACE_MAX_EP))
|
|
{
|
|
#ifdef HOST_ECHO
|
|
usb_echo("interface descriptor error\n");
|
|
#endif
|
|
return kStatus_USB_Error;
|
|
}
|
|
for (; interface->epCount < interface->interfaceDesc->bNumEndpoints; (interface->epCount)++)
|
|
{
|
|
if (((uint32_t)unionDes >= endPosition) ||
|
|
(unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_ENDPOINT))
|
|
{
|
|
#ifdef HOST_ECHO
|
|
usb_echo("endpoint descriptor error\n");
|
|
#endif
|
|
return kStatus_USB_Error;
|
|
}
|
|
epParse = (usb_host_ep_t *)&interface->epList[interface->epCount];
|
|
temp = (void *)unionDes;
|
|
epParse->epDesc = (usb_descriptor_endpoint_t *)temp;
|
|
epParse->epExtensionLength = 0;
|
|
epParse->epExtension = NULL;
|
|
unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
|
|
while ((uint32_t)unionDes < endPosition)
|
|
{
|
|
if ((unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_ENDPOINT) &&
|
|
(unionDes->common.bDescriptorType != USB_DESCRIPTOR_TYPE_INTERFACE))
|
|
{
|
|
if (epParse->epExtension == NULL)
|
|
{
|
|
epParse->epExtension = (uint8_t *)unionDes;
|
|
}
|
|
epParse->epExtensionLength += unionDes->common.bLength;
|
|
unionDes = (usb_descriptor_union_t *)((uint32_t)unionDes + unionDes->common.bLength);
|
|
}
|
|
else
|
|
{
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
return kStatus_USB_Success;
|
|
}
|
|
|
|
void USB_HostGetVersion(uint32_t *version)
|
|
{
|
|
if (NULL != version)
|
|
{
|
|
*version =
|
|
(uint32_t)USB_MAKE_VERSION(USB_STACK_VERSION_MAJOR, USB_STACK_VERSION_MINOR, USB_STACK_VERSION_BUGFIX);
|
|
}
|
|
}
|
|
|
|
#if ((defined(USB_HOST_CONFIG_LOW_POWER_MODE)) && (USB_HOST_CONFIG_LOW_POWER_MODE > 0U))
|
|
/* Send BUS or specific device suspend request */
|
|
usb_status_t USB_HostSuspendDeviceResquest(usb_host_handle hostHandle, usb_device_handle deviceHandle)
|
|
{
|
|
usb_host_instance_t *hostInstance;
|
|
usb_host_device_instance_t *deviceInstance;
|
|
usb_status_t status = kStatus_USB_Error;
|
|
usb_host_bus_control_t type = kUSB_HostBusSuspend;
|
|
|
|
if (hostHandle == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
hostInstance->suspendedDevice = (void *)deviceHandle;
|
|
|
|
if (NULL == deviceHandle)
|
|
{
|
|
#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
|
|
status = USB_HostHubSuspendDevice(hostInstance);
|
|
#else
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status =
|
|
hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostBusControl, &type);
|
|
#endif
|
|
}
|
|
else
|
|
{
|
|
#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
|
|
deviceInstance = (usb_host_device_instance_t *)deviceHandle;
|
|
if (0U == deviceInstance->hubNumber)
|
|
{
|
|
#endif
|
|
if (hostInstance->deviceList == deviceHandle)
|
|
{
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle,
|
|
kUSB_HostBusControl, &type);
|
|
}
|
|
#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
|
|
}
|
|
else
|
|
{
|
|
if (kStatus_USB_Success == USB_HostValidateDevice(hostInstance, deviceHandle))
|
|
{
|
|
status = USB_HostHubSuspendDevice(hostInstance);
|
|
}
|
|
}
|
|
#endif
|
|
}
|
|
if (kStatus_USB_Error == status)
|
|
{
|
|
hostInstance->suspendedDevice = NULL;
|
|
}
|
|
return status;
|
|
}
|
|
|
|
/* Send BUS or specific device resume request */
|
|
usb_status_t USB_HostResumeDeviceResquest(usb_host_handle hostHandle, usb_device_handle deviceHandle)
|
|
{
|
|
usb_host_instance_t *hostInstance;
|
|
usb_host_device_instance_t *deviceInstance;
|
|
usb_status_t status = kStatus_USB_Error;
|
|
usb_host_bus_control_t type = kUSB_HostBusResume;
|
|
|
|
if (hostHandle == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
if (hostInstance->suspendedDevice != deviceHandle)
|
|
{
|
|
return kStatus_USB_InvalidParameter;
|
|
}
|
|
hostInstance->suspendedDevice = (void *)deviceHandle;
|
|
|
|
if (NULL == deviceHandle)
|
|
{
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status =
|
|
hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostBusControl, &type);
|
|
}
|
|
else
|
|
{
|
|
#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
|
|
deviceInstance = (usb_host_device_instance_t *)deviceHandle;
|
|
if (0U == deviceInstance->hubNumber)
|
|
{
|
|
#endif
|
|
if (hostInstance->deviceList == deviceHandle)
|
|
{
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle,
|
|
kUSB_HostBusControl, &type);
|
|
}
|
|
#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
|
|
}
|
|
else
|
|
{
|
|
if (kStatus_USB_Success == USB_HostValidateDevice(hostInstance, deviceHandle))
|
|
{
|
|
status = USB_HostHubResumeDevice(hostInstance);
|
|
}
|
|
}
|
|
#endif
|
|
}
|
|
|
|
return status;
|
|
}
|
|
#if ((defined(USB_HOST_CONFIG_LPM_L1)) && (USB_HOST_CONFIG_LPM_L1 > 0U))
|
|
/* Send BUS or specific device suspend request */
|
|
usb_status_t USB_HostL1SleepDeviceResquest(usb_host_handle hostHandle,
|
|
usb_device_handle deviceHandle,
|
|
uint8_t sleepType)
|
|
{
|
|
usb_host_instance_t *hostInstance;
|
|
usb_status_t status = kStatus_USB_Error;
|
|
usb_host_bus_control_t type = kUSB_HostBusL1Sleep;
|
|
|
|
if (hostHandle == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
hostInstance->suspendedDevice = (void *)deviceHandle;
|
|
|
|
if (1U == sleepType)
|
|
{
|
|
/*#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))*/
|
|
/*To do, incomplete hub L1 suspend device*/
|
|
/*#else*/
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status =
|
|
hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostBusControl, &type);
|
|
/*#endif*/
|
|
}
|
|
else
|
|
{
|
|
#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
|
|
/*To do, if device hub number is 0, need suspend the bus ,else suspend the corresponding device*/
|
|
#endif
|
|
if (hostInstance->deviceList == deviceHandle)
|
|
{
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostBusControl,
|
|
&type);
|
|
}
|
|
}
|
|
if (kStatus_USB_Error == status)
|
|
{
|
|
hostInstance->suspendedDevice = NULL;
|
|
}
|
|
return status;
|
|
}
|
|
/* Send BUS or specific device suspend request */
|
|
usb_status_t USB_HostL1SleepDeviceResquestConfig(usb_host_handle hostHandle, uint8_t *lpmParam)
|
|
{
|
|
usb_host_instance_t *hostInstance;
|
|
usb_status_t status = kStatus_USB_Error;
|
|
|
|
if (hostHandle == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
hostInstance = (usb_host_instance_t *)hostHandle;
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status =
|
|
hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostL1Config, lpmParam);
|
|
|
|
return status;
|
|
}
|
|
|
|
/* Send BUS or specific device resume request */
|
|
usb_status_t USB_HostL1ResumeDeviceResquest(usb_host_handle hostHandle,
|
|
usb_device_handle deviceHandle,
|
|
uint8_t sleepType)
|
|
{
|
|
usb_host_instance_t *hostInstance;
|
|
|
|
usb_status_t status = kStatus_USB_Error;
|
|
usb_host_bus_control_t type = kUSB_HostBusL1Resume;
|
|
|
|
if (hostHandle == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
if (1U == sleepType)
|
|
{
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status =
|
|
hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostBusControl, &type);
|
|
}
|
|
else
|
|
{
|
|
#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
|
|
/*To do, if device hub number is 0, need suspend the bus ,else suspend the corresponding device*/
|
|
|
|
#endif
|
|
if (hostInstance->deviceList == deviceHandle)
|
|
{
|
|
/* the callbackFn is initialized in USB_HostGetControllerInterface */
|
|
status = hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostBusControl,
|
|
&type);
|
|
}
|
|
}
|
|
|
|
return status;
|
|
}
|
|
#endif
|
|
/* Update HW tick(unit is ms) */
|
|
usb_status_t USB_HostUpdateHwTick(usb_host_handle hostHandle, uint64_t tick)
|
|
{
|
|
usb_host_instance_t *hostInstance;
|
|
usb_status_t status = kStatus_USB_Success;
|
|
|
|
if (hostHandle == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
hostInstance = (usb_host_instance_t *)hostHandle;
|
|
|
|
hostInstance->hwTick = tick;
|
|
|
|
return status;
|
|
}
|
|
#endif
|
|
|
|
#if ((defined(USB_HOST_CONFIG_BATTERY_CHARGER)) && (USB_HOST_CONFIG_BATTERY_CHARGER > 0U))
|
|
usb_status_t USB_HostSetChargerType(usb_host_handle hostHandle, uint8_t type)
|
|
{
|
|
usb_host_instance_t *hostInstance;
|
|
|
|
if (hostHandle == NULL)
|
|
{
|
|
return kStatus_USB_InvalidHandle;
|
|
}
|
|
hostInstance = (usb_host_instance_t *)hostHandle;
|
|
return hostInstance->controllerTable->controllerIoctl(hostInstance->controllerHandle, kUSB_HostSetChargerType,
|
|
&type);
|
|
}
|
|
#endif
|