//*****************************************************************************
//
// usbhhub.h - This hold the host driver for hid class.
//
// Copyright (c) 2011-2012 Texas Instruments Incorporated.  All rights reserved.
// Software License Agreement
// 
// Texas Instruments (TI) is supplying this software for use solely and
// exclusively on TI's microcontroller products. The software is owned by
// TI and/or its suppliers, and is protected under applicable copyright
// laws. You may not combine this software with "viral" open-source
// software in order to form a larger program.
// 
// THIS SOFTWARE IS PROVIDED "AS IS" AND WITH ALL FAULTS.
// NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT
// NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. TI SHALL NOT, UNDER ANY
// CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
// DAMAGES, FOR ANY REASON WHATSOEVER.
// 
// This is part of revision 9453 of the Stellaris USB Library.
//
//*****************************************************************************

#ifndef __USBHHUB_H__
#define __USBHHUB_H__

//*****************************************************************************
//
// If building with a C++ compiler, make all of the definitions in this header
// have a C binding.
//
//*****************************************************************************
#ifdef __cplusplus
extern "C"
{
#endif

extern const tUSBHostClassDriver g_USBHubClassDriver;

//*****************************************************************************
//
//! The USB standard hub descriptor structure.  Full documentation for the
//! contents of this structure can be found in chapter 11.23.2.1 of the USB
//! 2.0 specification.
//
//*****************************************************************************
#ifdef ewarm
#pragma pack(1)
#endif

//*****************************************************************************
//
// The USB standard allows for up to 127 downstream ports on a single hub.  This
// would require rather more memory than we would like to set aside so the
// default configuration of the hub driver supports hubs with up to 7
// downstream-facing ports.  In practice, this should be more than enough
// since this covers the vast majority of consumer hubs.  Note that, by default,
// we will only support 4 devices so you can't fully populate a 7 port hub and
// have everything work.
//
// Feel free to change this but bad things will happen if you increase it above
// 31 since we assume the reports will always fit inside a 4 byte buffer.
//
//*****************************************************************************
#define ROOT_HUB_MAX_PORTS 7

typedef struct
{
    //
    //! The total number of bytes in the descriptor (including this field).
    //
    unsigned char bLength;

    //
    //! The descriptor type. For a hub descriptor, this will be USB_DTYPE_HUB
    //! (0x29 or 41 decimal).
    //
    unsigned char bDescType;

    //
    //! The number of downstream-facing ports that the hub supports.
    //
    unsigned char bNbrPorts;

    //
    //! Characteristics of the hub device including its power switching
    //! capabilities and overcurrent protection mode.
    //
    unsigned short wHubCharacteristics;

    //
    //! The time between the start of the power-on sequence for a port and
    //! the power to the port becoming stable.  This is expressed in 2mS units.
    //
    unsigned char bPwrOn2PwrGood;

    //
    //! The maximum current requirement for the hub circuitry in mA.
    //
    unsigned char bHubContrCurrent;

    //
    //! The last two fields in the structure are bit masks indicating which
    //! downstream ports support removable devices and, following this, another
    //! obsolete field from USB1.0 related to port power control.  Each field
    //! is byte aligned and contains a bit for each hub port.  This structure
    //! definition is set up with enough storage to handle ROOT_HUB_MAX_PORTS
    //! ports but beware that the actual size of each field is dependent upon
    //! the bNbrPorts field above.
    //
    unsigned char PortInfo[((ROOT_HUB_MAX_PORTS + 7) / 8) * 2];
}
PACKED tUsbHubDescriptor;

#ifdef ewarm
#pragma pack()
#endif

//*****************************************************************************
//
// Values used as the usFeature parameter to USBHHubClearHubFeature.
//
//*****************************************************************************
#define HUB_FEATURE_C_HUB_LOCAL_POWER        0
#define HUB_FEATURE_C_HUB_OVER_CURRENT       1

//*****************************************************************************
//
// Values used as the usFeature parameter to USBHHubSetPortFeature and
// USBHHubClearPortFeature.
//
//*****************************************************************************
#define HUB_FEATURE_PORT_CONNECTION          0
#define HUB_FEATURE_PORT_ENABLE              1
#define HUB_FEATURE_PORT_SUSPEND             2
#define HUB_FEATURE_PORT_OVER_CURRENT        3
#define HUB_FEATURE_PORT_RESET               4
#define HUB_FEATURE_PORT_POWER               8
#define HUB_FEATURE_PORT_LOW_SPEED           9
#define HUB_FEATURE_C_PORT_CONNECTION        16
#define HUB_FEATURE_C_PORT_ENABLE            17
#define HUB_FEATURE_C_PORT_SUSPEND           18
#define HUB_FEATURE_C_PORT_OVER_CURRENT      19
#define HUB_FEATURE_C_PORT_RESET             20
#define HUB_FEATURE_PORT_TEST                21
#define HUB_FEATURE_PORT_INDICATOR           22

//*****************************************************************************
//
// Values returned via the *pusHubStatus and *pusHubChange parameters passed to
// USBHHubGetHubStatus.  These may be ORed together into the returned status
// value.
//
//*****************************************************************************
#define HUB_STATUS_PWR_LOST                   1
#define HUB_STATUS_OVER_CURRENT               2

//*****************************************************************************
//
// Values returned via the *pusPortStatus parameter passed to
// USBHHubGetPortStatus.  These may be ORed together into the returned status
// value.
//
//*****************************************************************************
#define HUB_PORT_STATUS_DEVICE_PRESENT          0x0001
#define HUB_PORT_STATUS_ENABLED                 0x0002
#define HUB_PORT_STATUS_SUSPENDED               0x0004
#define HUB_PORT_STATUS_OVER_CURRENT            0x0008
#define HUB_PORT_STATUS_RESET                   0x0010
#define HUB_PORT_STATUS_POWERED                 0x0100
#define HUB_PORT_STATUS_LOW_SPEED               0x0200
#define HUB_PORT_STATUS_HIGH_SPEED              0x0400
#define HUB_PORT_STATUS_TEST_MODE               0x0800
#define HUB_PORT_STATUS_INDICATOR_CONTROL       0x1000

//*****************************************************************************
//
// Values returned via the *pusPortChange parameter passed to
// USBHHubGetPortStatus.  These may be ORed together into the returned status
// value.
//
//*****************************************************************************
#define HUB_PORT_CHANGE_DEVICE_PRESENT          0x0001
#define HUB_PORT_CHANGE_ENABLED                 0x0002
#define HUB_PORT_CHANGE_SUSPENDED               0x0004
#define HUB_PORT_CHANGE_OVER_CURRENT            0x0008
#define HUB_PORT_CHANGE_RESET                   0x0010

//*****************************************************************************
//
// Public function prototypes for the HUB class driver.
//
//*****************************************************************************
extern unsigned long USBHHubOpen(tUSBCallback pfnCallback,
                                 unsigned char *pucHubPool,
                                 unsigned long ulPoolSize,
                                 tHubInstance *psHubInstance,
                                 unsigned long ulNumHubs);
extern void USBHHubClose(unsigned long ulInstance);

#ifdef __cplusplus
}
#endif

#endif // __USBHHUB_H__