Merge branch 'master' of ssh://git.code.sf.net/p/nuttx/git into usbhub
This commit is contained in:
Gregory Nutt
commit
a0713bfd1a
197
include/nuttx/usb/hub.h
Normal file
197
include/nuttx/usb/hub.h
Normal file
@ -0,0 +1,197 @@
|
||||
/************************************************************************************
|
||||
* include/nuttx/usb/hub.h
|
||||
*
|
||||
* Copyright (C) 2015 Gregory Nutt. All rights reserved.
|
||||
* Author: Kaushal Parikh <kaushal@dspworks.in>
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions
|
||||
* are met:
|
||||
*
|
||||
* 1. Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* 2. Redistributions in binary form must reproduce the above copyright
|
||||
* notice, this list of conditions and the following disclaimer in
|
||||
* the documentation and/or other materials provided with the
|
||||
* distribution.
|
||||
* 3. Neither the name NuttX nor the names of its contributors may be
|
||||
* used to endorse or promote products derived from this software
|
||||
* without specific prior written permission.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
||||
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||||
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
||||
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
||||
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
||||
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
||||
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
||||
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
||||
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
* POSSIBILITY OF SUCH DAMAGE.
|
||||
*
|
||||
************************************************************************************/
|
||||
|
||||
#ifndef __INCLUDE_NUTTX_USB_HUB_H
|
||||
#define __INCLUDE_NUTTX_USB_HUB_H
|
||||
|
||||
/************************************************************************************
|
||||
* Included Files
|
||||
************************************************************************************/
|
||||
|
||||
#include <nuttx/config.h>
|
||||
#include <stdint.h>
|
||||
|
||||
/************************************************************************************
|
||||
* Pre-processor Definitions
|
||||
************************************************************************************/
|
||||
|
||||
/* Hub request types */
|
||||
|
||||
#define USBHUB_REQ_TYPE_HUB (USB_REQ_TYPE_CLASS | USB_REQ_RECIPIENT_DEVICE)
|
||||
#define USBHUB_REQ_TYPE_PORT (USB_REQ_TYPE_CLASS | USB_REQ_RECIPIENT_OTHER)
|
||||
|
||||
/* Hub class requests */
|
||||
|
||||
#define USBHUB_REQ_CLEARTTBUFFER (0x8)
|
||||
#define USBHUB_REQ_RESETTT (0x9)
|
||||
#define USBHUB_REQ_GETTTSTATE (0xa)
|
||||
#define USBHUB_REQ_STOPTT (0xb)
|
||||
|
||||
/* Hub class features */
|
||||
|
||||
#define USBHUB_FEAT_CHUBLOCALPOWER (0x0)
|
||||
#define USBHUB_FEAT_CHUBOVERCURRENT (0x1)
|
||||
|
||||
/* Port features */
|
||||
|
||||
#define USBHUB_PORT_FEAT_CONNECTION (0x00)
|
||||
#define USBHUB_PORT_FEAT_ENABLE (0x01)
|
||||
#define USBHUB_PORT_FEAT_SUSPEND (0x02)
|
||||
#define USBHUB_PORT_FEAT_OVERCURRENT (0x03)
|
||||
#define USBHUB_PORT_FEAT_RESET (0x04)
|
||||
#define USBHUB_PORT_FEAT_L1 (0x05)
|
||||
#define USBHUB_PORT_FEAT_POWER (0x08)
|
||||
#define USBHUB_PORT_FEAT_LOWSPEED (0x09)
|
||||
#define USBHUB_PORT_FEAT_HIGHSPEED (0x0a)
|
||||
#define USBHUB_PORT_FEAT_CCONNECTION (0x10)
|
||||
#define USBHUB_PORT_FEAT_CENABLE (0x11)
|
||||
#define USBHUB_PORT_FEAT_CSUSPEND (0x12)
|
||||
#define USBHUB_PORT_FEAT_COVER_CURRENT (0x13)
|
||||
#define USBHUB_PORT_FEAT_CRESET (0x14)
|
||||
#define USBHUB_PORT_FEAT_TEST (0x15)
|
||||
#define USBHUB_PORT_FEAT_INDICATOR (0x16)
|
||||
#define USBHUB_PORT_FEAT_CPORTL1 (0x17)
|
||||
|
||||
/* Hub characteristics */
|
||||
|
||||
#define USBHUB_CHAR_LPSM_SHIFT (0)
|
||||
#define USBHUB_CHAR_LPSM_MASK (0x3 << USBHUB_CHAR_LPSM_SHIFT)
|
||||
|
||||
#define USBHUB_CHAR_COMPOUND (1 << 2)
|
||||
#define USBHUB_CHAR_OCPM_SHIFT (3)
|
||||
#define USBHUB_CHAR_OCPM_MASK (0x3 << USBHUB_CHAR_OCPM_SHIFT)
|
||||
|
||||
#define USBHUB_CHAR_TTTT_SHIFT (5)
|
||||
#define USBHUB_CHAR_TTTT_MASK (0x3 << USBHUB_CHAR_TTTT_SHIFT)
|
||||
# define USBHUB_CHAR_TTTT_8_BITS (0x0 << USBHUB_CHAR_TTTT_SHIFT)
|
||||
# define USBHUB_CHAR_TTTT_16_BITS (0x1 << USBHUB_CHAR_TTTT_SHIFT)
|
||||
# define USBHUB_CHAR_TTTT_24_BITS (0x2 << USBHUB_CHAR_TTTT_SHIFT)
|
||||
# define USBHUB_CHAR_TTTT_32_BITS (0x3 << USBHUB_CHAR_TTTT_SHIFT)
|
||||
|
||||
#define USBHUB_CHAR_PORTIND (1 << 7)
|
||||
|
||||
/* Hub status */
|
||||
|
||||
#define USBHUB_STAT_LOCALPOWER (1 << 0)
|
||||
#define USBHUB_STAT_OVERCURRENT (1 << 1)
|
||||
|
||||
/* Hub status change */
|
||||
|
||||
#define USBHUB_STAT_CLOCALPOWER (1 << 0)
|
||||
#define USBHUB_STAT_COVERCURRENT (1 << 1)
|
||||
|
||||
/* Hub port status */
|
||||
|
||||
#define USBHUB_PORT_STAT_CONNECTION (1 << 0)
|
||||
#define USBHUB_PORT_STAT_ENABLE (1 << 1)
|
||||
#define USBHUB_PORT_STAT_SUSPEND (1 << 2)
|
||||
#define USBHUB_PORT_STAT_OVERCURRENT (1 << 3)
|
||||
#define USBHUB_PORT_STAT_RESET (1 << 4)
|
||||
#define USBHUB_PORT_STAT_L1 (1 << 5)
|
||||
|
||||
#define USBHUB_PORT_STAT_POWER (1 << 8)
|
||||
#define USBHUB_PORT_STAT_LOW_SPEED (1 << 9)
|
||||
#define USBHUB_PORT_STAT_HIGH_SPEED (1 << 10)
|
||||
#define USBHUB_PORT_STAT_TEST (1 << 11)
|
||||
#define USBHUB_PORT_STAT_INDICATOR (1 << 12)
|
||||
|
||||
/* Hub port status change */
|
||||
|
||||
#define USBHUB_PORT_STAT_CCONNECTION (1 << 0)
|
||||
#define USBHUB_PORT_STAT_CENABLE (1 << 1)
|
||||
#define USBHUB_PORT_STAT_CSUSPEND (1 << 2)
|
||||
#define USBHUB_PORT_STAT_COVERCURRENT (1 << 3)
|
||||
#define USBHUB_PORT_STAT_CRESET (1 << 4)
|
||||
#define USBHUB_PORT_STAT_CL1 (1 << 5)
|
||||
|
||||
/* Hub descriptor type */
|
||||
|
||||
#define USB_DESC_TYPE_HUB (USB_REQ_TYPE_CLASS | USB_CLASS_HUB)
|
||||
|
||||
/* Hub max ports */
|
||||
|
||||
#define USBHUB_MAX_PORTS (7)
|
||||
|
||||
/************************************************************************************
|
||||
* Public Types
|
||||
************************************************************************************/
|
||||
|
||||
/* Hub descriptor */
|
||||
|
||||
struct usb_hubdesc_s
|
||||
{
|
||||
uint8_t len;
|
||||
uint8_t type;
|
||||
uint8_t nports;
|
||||
uint8_t characteristics[2];
|
||||
uint8_t pwrondelay;
|
||||
uint8_t ctrlcurrent;
|
||||
uint8_t devattached;
|
||||
uint8_t pwrctrlmask;
|
||||
};
|
||||
#define USB_SIZEOF_HUBDESC 9
|
||||
|
||||
/* Hub status */
|
||||
|
||||
struct usb_hubstatus_s
|
||||
{
|
||||
uint8_t status[2];
|
||||
uint8_t change[2];
|
||||
};
|
||||
#define USB_SIZEOF_HUBSTS 4
|
||||
|
||||
/* Hub port status */
|
||||
|
||||
struct usb_portstatus_s
|
||||
{
|
||||
uint8_t status[2];
|
||||
uint8_t change[2];
|
||||
};
|
||||
#define USB_SIZEOF_PORTSTS 4
|
||||
|
||||
/* Hub transaction translator */
|
||||
|
||||
struct usb_hubtt_s
|
||||
{
|
||||
/* Hub class that is the transaction translator for device */
|
||||
|
||||
FAR struct usbhost_class_s *class;
|
||||
|
||||
/* Transaction translator think time */
|
||||
|
||||
uint16_t thinktime;
|
||||
};
|
||||
|
||||
#endif /* __INCLUDE_NUTTX_USB_HUB_H */
|
||||
Loading…
Reference in New Issue
Block a user