3 * Copyright (c) 2007 Luigi Rizzo - Universita` di Pisa. All rights reserved.
4 * Copyright (c) 2007 Hans Petter Selasky. All rights reserved.
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 #ifndef _USB_COMPAT_LINUX_H
29 #define _USB_COMPAT_LINUX_H
36 typedef void *pm_message_t;
37 typedef void (usb_complete_t)(struct urb *);
39 #define USB_MAX_FULL_SPEED_ISOC_FRAMES (60 * 1)
40 #define USB_MAX_HIGH_SPEED_ISOC_FRAMES (60 * 8)
42 #define USB_DEVICE_ID_MATCH_DEVICE \
43 (USB_DEVICE_ID_MATCH_VENDOR | USB_DEVICE_ID_MATCH_PRODUCT)
45 #define USB_DEVICE(vend,prod) \
46 .match_flags = USB_DEVICE_ID_MATCH_DEVICE, .idVendor = (vend), \
49 /* The "usb_driver" structure holds the Linux USB device driver
50 * callbacks, and a pointer to device ID's which this entry should
51 * match against. Usually this entry is exposed to the USB emulation
52 * layer using the "USB_DRIVER_EXPORT()" macro, which is defined
58 int (*probe) (struct usb_interface *intf,
59 const struct usb_device_id *id);
61 void (*disconnect) (struct usb_interface *intf);
63 int (*ioctl) (struct usb_interface *intf, unsigned int code,
66 int (*suspend) (struct usb_interface *intf, pm_message_t message);
67 int (*resume) (struct usb_interface *intf);
69 const struct usb_device_id *id_table;
71 void (*shutdown) (struct usb_interface *intf);
73 LIST_ENTRY(usb_driver) linux_driver_list;
76 #define USB_DRIVER_EXPORT(id,p_usb_drv) \
77 SYSINIT(id,SI_SUB_KLD,SI_ORDER_FIRST,usb_linux_register,p_usb_drv); \
78 SYSUNINIT(id,SI_SUB_KLD,SI_ORDER_ANY,usb_linux_deregister,p_usb_drv)
80 #define USB_DT_ENDPOINT_SIZE 7
81 #define USB_DT_ENDPOINT_AUDIO_SIZE 9
86 #define USB_ENDPOINT_NUMBER_MASK 0x0f /* in bEndpointAddress */
87 #define USB_ENDPOINT_DIR_MASK 0x80
89 #define USB_ENDPOINT_XFERTYPE_MASK 0x03 /* in bmAttributes */
90 #define USB_ENDPOINT_XFER_CONTROL 0
91 #define USB_ENDPOINT_XFER_ISOC 1
92 #define USB_ENDPOINT_XFER_BULK 2
93 #define USB_ENDPOINT_XFER_INT 3
94 #define USB_ENDPOINT_MAX_ADJUSTABLE 0x80
96 /* CONTROL REQUEST SUPPORT */
99 * Definition of direction mask for
100 * "bEndpointAddress" and "bmRequestType":
102 #define USB_DIR_MASK 0x80
103 #define USB_DIR_OUT 0x00 /* write to USB device */
104 #define USB_DIR_IN 0x80 /* read from USB device */
107 * Definition of type mask for
110 #define USB_TYPE_MASK (0x03 << 5)
111 #define USB_TYPE_STANDARD (0x00 << 5)
112 #define USB_TYPE_CLASS (0x01 << 5)
113 #define USB_TYPE_VENDOR (0x02 << 5)
114 #define USB_TYPE_RESERVED (0x03 << 5)
117 * Definition of receiver mask for
120 #define USB_RECIP_MASK 0x1f
121 #define USB_RECIP_DEVICE 0x00
122 #define USB_RECIP_INTERFACE 0x01
123 #define USB_RECIP_ENDPOINT 0x02
124 #define USB_RECIP_OTHER 0x03
127 * Definition of standard request values for
130 #define USB_REQ_GET_STATUS 0x00
131 #define USB_REQ_CLEAR_FEATURE 0x01
132 #define USB_REQ_SET_FEATURE 0x03
133 #define USB_REQ_SET_ADDRESS 0x05
134 #define USB_REQ_GET_DESCRIPTOR 0x06
135 #define USB_REQ_SET_DESCRIPTOR 0x07
136 #define USB_REQ_GET_CONFIGURATION 0x08
137 #define USB_REQ_SET_CONFIGURATION 0x09
138 #define USB_REQ_GET_INTERFACE 0x0A
139 #define USB_REQ_SET_INTERFACE 0x0B
140 #define USB_REQ_SYNCH_FRAME 0x0C
142 #define USB_REQ_SET_ENCRYPTION 0x0D /* Wireless USB */
143 #define USB_REQ_GET_ENCRYPTION 0x0E
144 #define USB_REQ_SET_HANDSHAKE 0x0F
145 #define USB_REQ_GET_HANDSHAKE 0x10
146 #define USB_REQ_SET_CONNECTION 0x11
147 #define USB_REQ_SET_SECURITY_DATA 0x12
148 #define USB_REQ_GET_SECURITY_DATA 0x13
149 #define USB_REQ_SET_WUSB_DATA 0x14
150 #define USB_REQ_LOOPBACK_DATA_WRITE 0x15
151 #define USB_REQ_LOOPBACK_DATA_READ 0x16
152 #define USB_REQ_SET_INTERFACE_DS 0x17
155 * USB feature flags are written using USB_REQ_{CLEAR,SET}_FEATURE, and
156 * are read as a bit array returned by USB_REQ_GET_STATUS. (So there
157 * are at most sixteen features of each type.)
159 #define USB_DEVICE_SELF_POWERED 0 /* (read only) */
160 #define USB_DEVICE_REMOTE_WAKEUP 1 /* dev may initiate wakeup */
161 #define USB_DEVICE_TEST_MODE 2 /* (wired high speed only) */
162 #define USB_DEVICE_BATTERY 2 /* (wireless) */
163 #define USB_DEVICE_B_HNP_ENABLE 3 /* (otg) dev may initiate HNP */
164 #define USB_DEVICE_WUSB_DEVICE 3 /* (wireless) */
165 #define USB_DEVICE_A_HNP_SUPPORT 4 /* (otg) RH port supports HNP */
166 #define USB_DEVICE_A_ALT_HNP_SUPPORT 5 /* (otg) other RH port does */
167 #define USB_DEVICE_DEBUG_MODE 6 /* (special devices only) */
169 #define USB_ENDPOINT_HALT 0 /* IN/OUT will STALL */
171 #define PIPE_ISOCHRONOUS 0x01 /* UE_ISOCHRONOUS */
172 #define PIPE_INTERRUPT 0x03 /* UE_INTERRUPT */
173 #define PIPE_CONTROL 0x00 /* UE_CONTROL */
174 #define PIPE_BULK 0x02 /* UE_BULK */
176 /* Whenever Linux references an USB endpoint:
177 * a) to initialize "urb->endpoint"
178 * b) second argument passed to "usb_control_msg()"
180 * Then it uses one of the following macros. The "endpoint" argument
181 * is the physical endpoint value masked by 0xF. The "dev" argument
182 * is a pointer to "struct usb_device".
184 #define usb_sndctrlpipe(dev,endpoint) \
185 usb_find_host_endpoint(dev, PIPE_CONTROL, (endpoint) | USB_DIR_OUT)
187 #define usb_rcvctrlpipe(dev,endpoint) \
188 usb_find_host_endpoint(dev, PIPE_CONTROL, (endpoint) | USB_DIR_IN)
190 #define usb_sndisocpipe(dev,endpoint) \
191 usb_find_host_endpoint(dev, PIPE_ISOCHRONOUS, (endpoint) | USB_DIR_OUT)
193 #define usb_rcvisocpipe(dev,endpoint) \
194 usb_find_host_endpoint(dev, PIPE_ISOCHRONOUS, (endpoint) | USB_DIR_IN)
196 #define usb_sndbulkpipe(dev,endpoint) \
197 usb_find_host_endpoint(dev, PIPE_BULK, (endpoint) | USB_DIR_OUT)
199 #define usb_rcvbulkpipe(dev,endpoint) \
200 usb_find_host_endpoint(dev, PIPE_BULK, (endpoint) | USB_DIR_IN)
202 #define usb_sndintpipe(dev,endpoint) \
203 usb_find_host_endpoint(dev, PIPE_INTERRUPT, (endpoint) | USB_DIR_OUT)
205 #define usb_rcvintpipe(dev,endpoint) \
206 usb_find_host_endpoint(dev, PIPE_INTERRUPT, (endpoint) | USB_DIR_IN)
209 * The following structure is used to extend "struct urb" when we are
210 * dealing with an isochronous endpoint. It contains information about
211 * the data offset and data length of an isochronous packet.
212 * The "actual_length" field is updated before the "complete"
213 * callback in the "urb" structure is called.
215 struct usb_iso_packet_descriptor {
216 uint32_t offset; /* depreciated buffer offset (the
217 * packets are usually back to back) */
218 uint16_t length; /* expected length */
219 uint16_t actual_length;
220 int16_t status; /* transfer status */
224 * The following structure holds various information about an USB
225 * transfer. This structure is used for all kinds of USB transfers.
227 * URB is short for USB Request Block.
230 TAILQ_ENTRY(urb) bsd_urb_list;
233 struct usb_device *dev; /* (in) pointer to associated device */
234 struct usb_host_endpoint *endpoint; /* (in) pipe pointer */
235 uint8_t *setup_packet; /* (in) setup packet (control only) */
236 uint8_t *bsd_data_ptr;
237 void *transfer_buffer; /* (in) associated data buffer */
238 void *context; /* (in) context for completion */
239 usb_complete_t *complete; /* (in) completion routine */
241 usb_size_t transfer_buffer_length;/* (in) data buffer length */
242 usb_size_t bsd_length_rem;
243 usb_size_t actual_length; /* (return) actual transfer length */
244 usb_timeout_t timeout; /* FreeBSD specific */
246 uint16_t transfer_flags; /* (in) */
247 #define URB_SHORT_NOT_OK 0x0001 /* report short transfers like errors */
248 #define URB_ISO_ASAP 0x0002 /* ignore "start_frame" field */
249 #define URB_ZERO_PACKET 0x0004 /* the USB transfer ends with a short
251 #define URB_NO_TRANSFER_DMA_MAP 0x0008 /* "transfer_dma" is valid on submit */
252 #define URB_WAIT_WAKEUP 0x0010 /* custom flags */
253 #define URB_IS_SLEEPING 0x0020 /* custom flags */
255 usb_frcount_t start_frame; /* (modify) start frame (ISO) */
256 usb_frcount_t number_of_packets; /* (in) number of ISO packets */
257 uint16_t interval; /* (modify) transfer interval
259 uint16_t error_count; /* (return) number of ISO errors */
260 int16_t status; /* (return) status */
262 uint8_t setup_dma; /* (in) not used on FreeBSD */
263 uint8_t transfer_dma; /* (in) not used on FreeBSD */
265 uint8_t kill_count; /* FreeBSD specific */
267 struct usb_iso_packet_descriptor iso_frame_desc[]; /* (in) ISO ONLY */
270 /* various prototypes */
272 int usb_submit_urb(struct urb *urb, uint16_t mem_flags);
273 int usb_unlink_urb(struct urb *urb);
274 int usb_clear_halt(struct usb_device *dev, struct usb_host_endpoint *uhe);
275 int usb_control_msg(struct usb_device *dev, struct usb_host_endpoint *ep,
276 uint8_t request, uint8_t requesttype, uint16_t value,
277 uint16_t index, void *data, uint16_t size, usb_timeout_t timeout);
278 int usb_set_interface(struct usb_device *dev, uint8_t ifnum,
280 int usb_setup_endpoint(struct usb_device *dev,
281 struct usb_host_endpoint *uhe, usb_frlength_t bufsize);
283 struct usb_host_endpoint *usb_find_host_endpoint(struct usb_device *dev,
284 uint8_t type, uint8_t ep);
285 struct urb *usb_alloc_urb(uint16_t iso_packets, uint16_t mem_flags);
286 struct usb_host_interface *usb_altnum_to_altsetting(
287 const struct usb_interface *intf, uint8_t alt_index);
288 struct usb_interface *usb_ifnum_to_if(struct usb_device *dev, uint8_t iface_no);
290 void *usb_buffer_alloc(struct usb_device *dev, usb_size_t size,
291 uint16_t mem_flags, uint8_t *dma_addr);
292 void *usbd_get_intfdata(struct usb_interface *intf);
294 void usb_buffer_free(struct usb_device *dev, usb_size_t size, void *addr, uint8_t dma_addr);
295 void usb_free_urb(struct urb *urb);
296 void usb_init_urb(struct urb *urb);
297 void usb_kill_urb(struct urb *urb);
298 void usb_set_intfdata(struct usb_interface *intf, void *data);
299 void usb_linux_register(void *arg);
300 void usb_linux_deregister(void *arg);
302 void usb_fill_bulk_urb(struct urb *, struct usb_device *,
303 struct usb_host_endpoint *, void *, int, usb_complete_t, void *);
304 int usb_bulk_msg(struct usb_device *, struct usb_host_endpoint *,
305 void *, int, uint16_t *, usb_timeout_t);
307 #define interface_to_usbdev(intf) (intf)->linux_udev
308 #define interface_to_bsddev(intf) (intf)->linux_udev
310 #endif /* _USB_COMPAT_LINUX_H */