Changes in uspace/lib/usb/include/usb/classes/hub.h [4b4c797:da55d5b] in mainline
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
uspace/lib/usb/include/usb/classes/hub.h
r4b4c797 rda55d5b 36 36 #define LIBUSB_HUB_H_ 37 37 38 /** Hub class request. */ 39 typedef enum { 40 USB_HUB_REQUEST_GET_STATUS = 0, 41 USB_HUB_REQUEST_CLEAR_FEATURE = 1, 42 USB_HUB_REQUEST_GET_STATE = 2, 43 USB_HUB_REQUEST_SET_FEATURE = 3, 44 USB_HUB_REQUEST_GET_DESCRIPTOR = 6, 45 USB_HUB_REQUEST_SET_DESCRIPTOR = 7, 46 /* USB_HUB_REQUEST_ = , */ 47 } usb_hub_class_request_t; 38 #include <sys/types.h> 39 #include <usb/hcdhubd.h> 40 48 41 49 42 /** Hub class feature selector. … … 69 62 } usb_hub_class_feature_t; 70 63 64 65 /** 66 * @brief usb hub descriptor 67 * 68 * For more information see Universal Serial Bus Specification Revision 1.1 chapter 11.16.2 69 */ 70 typedef struct hub_descriptor_type{ 71 /** Number of bytes in this descriptor, including this byte */ 72 //uint8_t bDescLength; 73 74 /** Descriptor Type, value: 29H for hub descriptor */ 75 //uint8_t bDescriptorType; 76 77 /** Number of downstream ports that this hub supports */ 78 uint8_t ports_count; 79 80 /** 81 D1...D0: Logical Power Switching Mode 82 00: Ganged power switching (all ports’ power at 83 once) 84 01: Individual port power switching 85 1X: Reserved. Used only on 1.0 compliant hubs 86 that implement no power switching. 87 D2: Identifies a Compound Device 88 0: Hub is not part of a compound device 89 1: Hub is part of a compound device 90 D4...D3: Over-current Protection Mode 91 00: Global Over-current Protection. The hub 92 reports over-current as a summation of all 93 ports’ current draw, without a breakdown of 94 individual port over-current status. 95 01: Individual Port Over-current Protection. The 96 hub reports over-current on a per-port basis. 97 Each port has an over-current indicator. 98 1X: No Over-current Protection. This option is 99 allowed only for bus-powered hubs that do not 100 implement over-current protection. 101 D15...D5: 102 Reserved 103 */ 104 uint16_t hub_characteristics; 105 106 /** 107 Time (in 2ms intervals) from the time the power-on 108 sequence begins on a port until power is good on that 109 port. The USB System Software uses this value to 110 determine how long to wait before accessing a 111 powered-on port. 112 */ 113 uint8_t pwr_on_2_good_time; 114 115 /** 116 Maximum current requirements of the Hub Controller 117 electronics in mA. 118 */ 119 uint8_t current_requirement; 120 121 /** 122 Indicates if a port has a removable device attached. 123 This field is reported on byte-granularity. Within a 124 byte, if no port exists for a given location, the field 125 representing the port characteristics returns 0. 126 Bit value definition: 127 0B - Device is removable 128 1B - Device is non-removable 129 This is a bitmap corresponding to the individual ports 130 on the hub: 131 Bit 0: Reserved for future use 132 Bit 1: Port 1 133 Bit 2: Port 2 134 .... 135 Bit n: Port n (implementation-dependent, up to a 136 maximum of 255 ports). 137 */ 138 uint8_t * devices_removable; 139 140 /** 141 This field exists for reasons of compatibility with 142 software written for 1.0 compliant devices. All bits in 143 this field should be set to 1B. This field has one bit for 144 each port on the hub with additional pad bits, if 145 necessary, to make the number of bits in the field an 146 integer multiple of 8. 147 */ 148 //uint8_t * port_pwr_ctrl_mask; 149 } usb_hub_descriptor_t; 150 151 152 153 /** @brief usb hub specific request types. 154 * 155 * For more information see Universal Serial Bus Specification Revision 1.1 chapter 11.16.2 156 */ 157 typedef enum { 158 /** This request resets a value reported in the hub status. */ 159 USB_HUB_REQ_TYPE_CLEAR_HUB_FEATURE = 0x20, 160 /** This request resets a value reported in the port status. */ 161 USB_HUB_REQ_TYPE_CLEAR_PORT_FEATURE = 0x23, 162 /** This is an optional per-port diagnostic request that returns the bus state value, as sampled at the last EOF2 point. */ 163 USB_HUB_REQ_TYPE_GET_STATE = 0xA3, 164 /** This request returns the hub descriptor. */ 165 USB_HUB_REQ_TYPE_GET_DESCRIPTOR = 0xA0, 166 /** This request returns the current hub status and the states that have changed since the previous acknowledgment. */ 167 USB_HUB_REQ_TYPE_GET_HUB_STATUS = 0xA0, 168 /** This request returns the current port status and the current value of the port status change bits. */ 169 USB_HUB_REQ_TYPE_GET_PORT_STATUS = 0xA3, 170 /** This request overwrites the hub descriptor. */ 171 USB_HUB_REQ_TYPE_SET_DESCRIPTOR = 0x20, 172 /** This request sets a value reported in the hub status. */ 173 USB_HUB_REQ_TYPE_SET_HUB_FEATURE = 0x20, 174 /** This request sets a value reported in the port status. */ 175 USB_HUB_REQ_TYPE_SET_PORT_FEATURE = 0x23 176 } usb_hub_bm_request_type_t; 177 178 /** @brief hub class request codes*/ 179 typedef enum { 180 /** */ 181 USB_HUB_REQUEST_GET_STATUS = 0, 182 /** */ 183 USB_HUB_REQUEST_CLEAR_FEATURE = 1, 184 /** */ 185 USB_HUB_REQUEST_GET_STATE = 2, 186 /** */ 187 USB_HUB_REQUEST_SET_FEATURE = 3, 188 /** */ 189 USB_HUB_REQUEST_GET_DESCRIPTOR = 6, 190 /** */ 191 USB_HUB_REQUEST_SET_DESCRIPTOR = 7 192 } usb_hub_request_t; 193 194 /** 195 * Maximum size of usb hub descriptor in bytes 196 */ 197 extern size_t USB_HUB_MAX_DESCRIPTOR_SIZE; 198 199 /** 200 * @brief create uint8_t array with serialized descriptor 201 * 202 * @param descriptor 203 */ 204 void * usb_serialize_hub_descriptor(usb_hub_descriptor_t * descriptor); 205 206 /** 207 * @brief create deserialized desriptor structure out of serialized descriptor 208 * 209 * The serialized descriptor must be proper usb hub descriptor, otherwise an eerror might occur. 210 * 211 * @param sdescriptor serialized descriptor 212 */ 213 usb_hub_descriptor_t * usb_deserialize_hub_desriptor(void * sdescriptor); 214 215 /** 216 * @brief create hub structure instance 217 * 218 * @param device 219 * @return 220 */ 221 usb_hcd_hub_info_t * usb_create_hub_info(device_t * device); 222 223 224 225 226 71 227 #endif 72 228 /**
Note:
See TracChangeset
for help on using the changeset viewer.