/* * Copyright (c) 2023, Artinchip Technology Co., Ltd * * SPDX-License-Identifier: Apache-2.0 * * Wu Dehuang */ #ifndef _USB_HUB_H_ #define _USB_HUB_H_ #ifdef __cplusplus extern "C" { #endif #include /* HUB Class Descriptor Types */ #define HUB_DESCRIPTOR_TYPE_HUB 0x29 /* Hub class requests */ #define HUB_REQUEST_GET_STATUS USB_REQUEST_GET_STATUS #define HUB_REQUEST_CLEAR_FEATURE USB_REQUEST_CLEAR_FEATURE #define HUB_REQUEST_SET_FEATURE USB_REQUEST_SET_FEATURE #define HUB_REQUEST_GET_DESCRIPTOR USB_REQUEST_GET_DESCRIPTOR #define HUB_REQUEST_SET_DESCRIPTOR USB_REQUEST_SET_DESCRIPTOR #define HUB_REQUEST_CLEAR_TT_BUFFER (0x08) #define HUB_REQUEST_RESET_TT (0x09) #define HUB_REQUEST_GET_TT_STATE (0x0a) #define HUB_REQUEST_STOP_TT (0x0b) /* Hub class features */ #define HUB_FEATURE_HUB_C_LOCALPOWER (0x0) #define HUB_FEATURE_HUB_C_OVERCURRENT (0x1) /* Port features */ #define HUB_PORT_FEATURE_CONNECTION (0x00) #define HUB_PORT_FEATURE_ENABLE (0x01) #define HUB_PORT_FEATURE_SUSPEND (0x02) #define HUB_PORT_FEATURE_OVERCURRENT (0x03) #define HUB_PORT_FEATURE_RESET (0x04) #define HUB_PORT_FEATURE_L1 (0x05) #define HUB_PORT_FEATURE_POWER (0x08) #define HUB_PORT_FEATURE_LOWSPEED (0x09) #define HUB_PORT_FEATURE_HIGHSPEED (0x0a) #define HUB_PORT_FEATURE_C_CONNECTION (0x10) #define HUB_PORT_FEATURE_C_ENABLE (0x11) #define HUB_PORT_FEATURE_C_SUSPEND (0x12) #define HUB_PORT_FEATURE_C_OVER_CURREN (0x13) #define HUB_PORT_FEATURE_C_RESET (0x14) #define HUB_PORT_FEATURE_TEST (0x15) #define HUB_PORT_FEATURE_INDICATOR (0x16) #define HUB_PORT_FEATURE_C_PORTL1 (0x17) /* Hub status */ #define HUB_STATUS_LOCALPOWER (1 << 0) #ifndef HUB_STATUS_OVERCURRENT #define HUB_STATUS_OVERCURRENT (1 << 1) #endif /* Hub status change */ #define HUB_STATUS_C_LOCALPOWER (1 << 0) #define HUB_STATUS_C_OVERCURRENT (1 << 1) /* Hub port status */ #define HUB_PORT_STATUS_CONNECTION (1 << 0) #define HUB_PORT_STATUS_ENABLE (1 << 1) #define HUB_PORT_STATUS_SUSPEND (1 << 2) #define HUB_PORT_STATUS_OVERCURRENT (1 << 3) #define HUB_PORT_STATUS_RESET (1 << 4) #define HUB_PORT_STATUS_L1 (1 << 5) #define HUB_PORT_STATUS_POWER (1 << 8) #define HUB_PORT_STATUS_LOW_SPEED (1 << 9) #define HUB_PORT_STATUS_HIGH_SPEED (1 << 10) #define HUB_PORT_STATUS_TEST (1 << 11) #define HUB_PORT_STATUS_INDICATOR (1 << 12) /* Hub port status change */ #define HUB_PORT_STATUS_C_CONNECTION (1 << 0) #define HUB_PORT_STATUS_C_ENABLE (1 << 1) #define HUB_PORT_STATUS_C_SUSPEND (1 << 2) #define HUB_PORT_STATUS_C_OVERCURRENT (1 << 3) #define HUB_PORT_STATUS_C_RESET (1 << 4) #define HUB_PORT_STATUS_C_L1 (1 << 5) /* Hub characteristics */ #define HUB_CHAR_LPSM_SHIFT (0) /* Bits 0-1: Logical Power Switching Mode */ #define HUB_CHAR_LPSM_MASK (3 << HUB_CHAR_LPSM_SHIFT) #define HUB_CHAR_LPSM_GANGED (0 << HUB_CHAR_LPSM_SHIFT) #define HUB_CHAR_LPSM_INDIVIDUAL (1 << HUB_CHAR_LPSM_SHIFT) #ifndef HUB_CHAR_COMPOUND #define HUB_CHAR_COMPOUND (1 << 2) /* Bit 2: Compound device */ #endif #define HUB_CHAR_OCPM_SHIFT (3) /* Bits 3-4: Over-current Protection Mode */ #define HUB_CHAR_OCPM_MASK (3 << HUB_CHAR_OCPM_SHIFT) #define HUB_CHAR_OCPM_GLOBAL (0 << HUB_CHAR_OCPM_SHIFT) #define HUB_CHAR_OCPM_INDIVIDUAL (1 << HUB_CHAR_OCPM_SHIFT) #define HUB_CHAR_TTTT_SHIFT (5) /* Bits 5-6: TT Think Time */ #define HUB_CHAR_TTTT_MASK (3 << HUB_CHAR_TTTT_SHIFT) #define HUB_CHAR_TTTT_8_BITS (0 << HUB_CHAR_TTTT_SHIFT) #define HUB_CHAR_TTTT_16_BITS (1 << HUB_CHAR_TTTT_SHIFT) #define HUB_CHAR_TTTT_24_BITS (2 << HUB_CHAR_TTTT_SHIFT) #define HUB_CHAR_TTTT_32_BITS (3 << HUB_CHAR_TTTT_SHIFT) #define HUB_CHAR_PORTIND (1 << 7) /* Bit 7: Port Indicators Supported */ /* Hub descriptor */ struct usb_hub_descriptor { u8 bLength; u8 bDescriptorType; u8 bNbrPorts; u16 wHubCharacteristics; u8 bPwrOn2PwrGood; u8 bHubContrCurrent; u8 DeviceRemovable; u8 PortPwrCtrlMask; } __attribute__((packed)); #define USB_SIZEOF_HUB_DESC 9 /* Hub status */ struct hub_status { u16 wPortStatus; u16 wPortChange; }; /* Hub port status */ struct hub_port_status { u16 wPortStatus; u16 wPortChange; }; #ifdef __cplusplus } #endif #endif /* _USB_HUB_H_ */