usb_host_devices.h

/*
 * Copyright (c) 2015, Freescale Semiconductor, Inc.
 * Copyright 2016 NXP
 * All rights reserved.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */
 
#ifndef _USB_HOST_DEV_MNG_H_
#define _USB_HOST_DEV_MNG_H_
 
#include <usb_host.h>
 
/*******************************************************************************
 * Definitions
 ******************************************************************************/
typedef enum _usb_host_device_enumeration_status
{
    kStatus_DEV_Notinit = 0, 
    kStatus_DEV_Initial,     
    kStatus_DEV_GetDes8,     
    kStatus_DEV_SetAddress,  
    kStatus_DEV_GetDes,      
    kStatus_DEV_GetCfg9,     
    kStatus_DEV_GetCfg,      
    kStatus_DEV_SetCfg,      
    kStatus_DEV_EnumDone,    
    kStatus_DEV_AppUsed,     
} usb_host_device_enumeration_status_t;
 
typedef enum _usb_host_interface_state
{
    kStatus_interface_Attached = 1, 
    kStatus_interface_Opened,       
    kStatus_interface_Detached,     
} usb_host_interface_state_t;
 
typedef enum _usb_host_device_state
{
    kStatus_device_Detached = 0, 
    kStatus_device_Attached,     
} usb_host_device_state_t;
 
typedef struct _usb_host_device_instance
{
    struct _usb_host_device_instance *next;    
    usb_host_handle hostHandle;                
    usb_host_configuration_t configuration;    
    usb_descriptor_device_t *deviceDescriptor; 
    usb_host_pipe_handle controlPipe;          
    uint8_t *configurationDesc;                
    uint8_t *enumBuffer;                       
    uint16_t configurationLen;                 
    uint8_t interfaceStatus[USB_HOST_CONFIG_CONFIGURATION_MAX_INTERFACE]; 
    uint8_t configurationValue;                                           
    uint8_t state;                                                        
    uint8_t enumRetries;       
    uint8_t stallRetries;      
    uint8_t speed;             
    uint8_t allocatedAddress;  
    uint8_t setAddress;        
    uint8_t deviceAttachState; 
#if ((defined USB_HOST_CONFIG_HUB) && (USB_HOST_CONFIG_HUB))
    /* hub related */
    uint8_t hubNumber;   
    uint8_t portNumber;  
    uint8_t hsHubNumber; 
    uint8_t hsHubPort;   
    uint8_t level;       
#endif
} usb_host_device_instance_t;
 
typedef struct _usb_host_enum_process_entry
{
    usb_host_device_enumeration_status_t successState; 
    usb_host_device_enumeration_status_t retryState;   
    usb_status_t (*process)(usb_host_device_instance_t *deviceInstance, uint32_t dataLength);
} usb_host_enum_process_entry_t;
 
/*******************************************************************************
 * API
 ******************************************************************************/
 
extern 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);
 
extern usb_status_t USB_HostDetachDevice(usb_host_handle hostHandle, uint8_t hubNumber, uint8_t portNumber);
 
extern usb_status_t USB_HostDetachDeviceInternal(usb_host_handle hostHandle, usb_device_handle deviceHandle);
 
extern uint8_t USB_HostGetDeviceAttachState(usb_device_handle deviceHandle);
 
extern usb_status_t USB_HostValidateDevice(usb_host_handle hostHandle, usb_device_handle deviceHandle);
 
#endif /* _USB_HOST_DEV_MNG_H_ */