1 // USB functions and data.
5 #include "util.h" // struct mutex_s
17 // Common information for usb controllers.
19 struct usb_pipe *defaultpipe;
20 struct mutex_s resetlock;
26 #define USB_TYPE_UHCI 1
27 #define USB_TYPE_OHCI 2
29 #define USB_MAXADDR 127
32 /****************************************************************
33 * usb structs and flags
34 ****************************************************************/
36 // USB mandated timings (in ms)
37 #define USB_TIME_SIGATT 100
38 #define USB_TIME_ATTDB 100
39 #define USB_TIME_DRST 10
40 #define USB_TIME_DRSTR 50
41 #define USB_TIME_RSTRCY 10
43 #define USB_TIME_SETADDR_RECOVERY 2
45 #define USB_PID_OUT 0xe1
46 #define USB_PID_IN 0x69
47 #define USB_PID_SETUP 0x2d
49 #define USB_DIR_OUT 0 /* to device */
50 #define USB_DIR_IN 0x80 /* to host */
52 #define USB_TYPE_MASK (0x03 << 5)
53 #define USB_TYPE_STANDARD (0x00 << 5)
54 #define USB_TYPE_CLASS (0x01 << 5)
55 #define USB_TYPE_VENDOR (0x02 << 5)
56 #define USB_TYPE_RESERVED (0x03 << 5)
58 #define USB_RECIP_MASK 0x1f
59 #define USB_RECIP_DEVICE 0x00
60 #define USB_RECIP_INTERFACE 0x01
61 #define USB_RECIP_ENDPOINT 0x02
62 #define USB_RECIP_OTHER 0x03
64 #define USB_REQ_GET_STATUS 0x00
65 #define USB_REQ_CLEAR_FEATURE 0x01
66 #define USB_REQ_SET_FEATURE 0x03
67 #define USB_REQ_SET_ADDRESS 0x05
68 #define USB_REQ_GET_DESCRIPTOR 0x06
69 #define USB_REQ_SET_DESCRIPTOR 0x07
70 #define USB_REQ_GET_CONFIGURATION 0x08
71 #define USB_REQ_SET_CONFIGURATION 0x09
72 #define USB_REQ_GET_INTERFACE 0x0A
73 #define USB_REQ_SET_INTERFACE 0x0B
74 #define USB_REQ_SYNCH_FRAME 0x0C
76 struct usb_ctrlrequest {
84 #define USB_DT_DEVICE 0x01
85 #define USB_DT_CONFIG 0x02
86 #define USB_DT_STRING 0x03
87 #define USB_DT_INTERFACE 0x04
88 #define USB_DT_ENDPOINT 0x05
89 #define USB_DT_DEVICE_QUALIFIER 0x06
90 #define USB_DT_OTHER_SPEED_CONFIG 0x07
92 struct usb_device_descriptor {
107 u8 bNumConfigurations;
110 #define USB_CLASS_PER_INTERFACE 0 /* for DeviceClass */
111 #define USB_CLASS_AUDIO 1
112 #define USB_CLASS_COMM 2
113 #define USB_CLASS_HID 3
114 #define USB_CLASS_PHYSICAL 5
115 #define USB_CLASS_STILL_IMAGE 6
116 #define USB_CLASS_PRINTER 7
117 #define USB_CLASS_MASS_STORAGE 8
118 #define USB_CLASS_HUB 9
120 struct usb_config_descriptor {
126 u8 bConfigurationValue;
132 struct usb_interface_descriptor {
137 u8 bAlternateSetting;
140 u8 bInterfaceSubClass;
141 u8 bInterfaceProtocol;
145 struct usb_endpoint_descriptor {
155 #define USB_ENDPOINT_NUMBER_MASK 0x0f /* in bEndpointAddress */
156 #define USB_ENDPOINT_DIR_MASK 0x80
158 #define USB_ENDPOINT_XFERTYPE_MASK 0x03 /* in bmAttributes */
159 #define USB_ENDPOINT_XFER_CONTROL 0
160 #define USB_ENDPOINT_XFER_ISOC 1
161 #define USB_ENDPOINT_XFER_BULK 2
162 #define USB_ENDPOINT_XFER_INT 3
163 #define USB_ENDPOINT_MAX_ADJUSTABLE 0x80
166 /****************************************************************
168 ****************************************************************/
171 void usb_setup(void);
172 struct usb_pipe *usb_set_address(struct usb_s *cntl, int lowspeed);
173 int configure_usb_device(struct usb_pipe *pipe);
174 int send_default_control(struct usb_pipe *pipe, const struct usb_ctrlrequest *req
176 int usb_send_bulk(struct usb_pipe *pipe, int dir, void *data, int datasize);
177 void free_pipe(struct usb_pipe *pipe);
178 struct usb_pipe *alloc_bulk_pipe(struct usb_pipe *pipe
179 , struct usb_endpoint_descriptor *epdesc);
180 struct usb_pipe *alloc_intr_pipe(struct usb_pipe *pipe
181 , struct usb_endpoint_descriptor *epdesc);
182 int usb_poll_intr(struct usb_pipe *pipe, void *data);
183 struct usb_endpoint_descriptor *findEndPointDesc(
184 struct usb_interface_descriptor *iface, int imax, int type, int dir);
185 u32 mkendpFromDesc(struct usb_pipe *pipe
186 , struct usb_endpoint_descriptor *epdesc);