Initial USB device controller (UDC) and USB CDC Ethernet function support

for PXA27x/Zaurus, not enabled yet; for dlg and dale :)

1 files changed, 175 insertions, 0 deletions

diff --git a/sys/dev/usb/usbfvar.h b/sys/dev/usb/usbfvar.h
new file mode 100644
index 00000000000..d36836b12c0
--- /dev/null
+++ b/sys/dev/usb/usbfvar.h
@@ -0,0 +1,175 @@
+/*	$OpenBSD: usbfvar.h,v 1.1 2006/11/25 18:10:29 uwe Exp $	*/
+
+/*
+ * Copyright (c) 2006 Uwe Stuehler <uwe@openbsd.org>
+ *
+ * Permission to use, copy, modify, and distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ */
+
+/*
+ * USB function driver interface
+ *
+ * This file is to be included only by the logical device driver and the
+ * USB device controller (DC) driver.
+ */
+
+/*** structures corresponding to USB protocol components ***/
+
+struct usbf_endpoint {
+	struct usbf_interface	    *iface;
+	usb_endpoint_descriptor_t   *edesc;
+	int			     halted;	/* UF_ENDPOINT_HALT set */
+	int			     refcnt;
+	SIMPLEQ_ENTRY(usbf_endpoint) next;
+};
+
+struct usbf_interface {
+	struct usbf_config	     *config;
+	usb_interface_descriptor_t   *idesc;
+	LIST_HEAD(, usbf_pipe)        pipes;
+	SIMPLEQ_HEAD(, usbf_endpoint) endpoint_head;
+	SIMPLEQ_ENTRY(usbf_interface) next;
+};
+
+struct usbf_config {
+	struct usbf_device *uc_device;
+	usb_config_descriptor_t *uc_cdesc;
+	size_t uc_cdesc_size;
+	int uc_closed;
+	SIMPLEQ_HEAD(, usbf_interface) iface_head;
+	SIMPLEQ_ENTRY(usbf_config) next;
+};
+
+struct usbf_device {
+	USBBASEDEVICE		 bdev;		/* base device */
+	struct usbf_bus		*bus;		/* device controller */
+	struct usbf_function	*function;	/* function driver */
+	struct usbf_pipe	*default_pipe;	/* pipe 0 (device control) */
+	struct usbf_xfer	*default_xfer;	/* device request xfer */
+	struct usbf_xfer	*data_xfer;	/* request response xfer */
+	int			 address;	/* assigned by host (or 0) */
+	usbf_config_handle	 config;	/* set by host (or NULL) */
+	usb_status_t		 status;	/* device status */
+	usb_device_request_t	 def_req;	/* device request buffer */
+	struct usbf_endpoint	 def_ep;	/* for pipe 0 */
+	usb_endpoint_descriptor_t def_ep_desc;	/* for pipe 0 */
+	usb_device_descriptor_t  ddesc;		/* device descriptor */
+	usb_string_descriptor_t *sdesc;		/* string descriptors */
+	size_t			 sdesc_size;	/* size of ud_sdesc */
+	uByte			 string_id;	/* next string id */
+	SIMPLEQ_HEAD(, usbf_config) configs;
+};
+
+/*** software control structures ***/
+
+struct usbf_pipe_methods {
+	usbf_status	(*transfer)(usbf_xfer_handle);
+	usbf_status	(*start)(usbf_xfer_handle);
+	void		(*abort)(usbf_xfer_handle);
+	void		(*done)(usbf_xfer_handle);
+	void		(*close)(usbf_pipe_handle);
+};
+
+struct usbf_bus_methods {
+	usbf_status	  (*open_pipe)(struct usbf_pipe *);
+	void		  (*soft_intr)(void *);
+	usbf_status	  (*allocm)(struct usbf_bus *, usb_dma_t *, u_int32_t);
+	void		  (*freem)(struct usbf_bus *, usb_dma_t *);
+	struct usbf_xfer *(*allocx)(struct usbf_bus *);
+	void		  (*freex)(struct usbf_bus *, struct usbf_xfer *);
+};
+
+struct usbf_softc;
+
+struct usbf_bus {
+	/* Filled by DC driver */
+	USBBASEDEVICE		 bdev;		/* base device */
+	struct usbf_bus_methods	*methods;
+	size_t			 pipe_size;	/* size of pipe struct */
+	u_int8_t		 ep0_maxp;	/* packet size for EP0 */
+	int			 usbrev;	/* as in struct usbd_bus */
+	/* Filled by usbf driver */
+	struct usbf_softc	*usbfctl;
+	int			 intr_context;
+#ifdef USB_USE_SOFTINTR
+#ifdef __HAVE_GENERIC_SOFT_INTERRUPTS
+	void			*soft;		/* soft interrupt cookie */
+#else
+	usb_callout_t		 softi;		/* timeout handle */
+#endif
+#endif
+	bus_dma_tag_t		 dmatag;	/* DMA tag */
+};
+
+struct usbf_port {
+	usb_port_status_t	 status;
+	u_int8_t		 portno;
+	struct usbf_device	*device;	/* connected function */
+};
+
+struct usbf_pipe {
+	struct usbf_device	 *device;
+	struct usbf_interface	 *iface;	/* unless default pipe */
+	struct usbf_endpoint	 *endpoint;
+	int			  refcnt;
+	int			  running;
+	int			  aborting;
+	SIMPLEQ_HEAD(, usbf_xfer) queue;
+	LIST_ENTRY(usbf_pipe)	  next;
+
+	char			  repeat;
+	int			  interval;
+
+	/* Filled by DC driver. */
+	struct usbf_pipe_methods *methods;
+};
+
+struct usbf_xfer {
+	struct usbf_pipe	*pipe;
+	usbf_private_handle	 priv;
+	void			*buffer;
+	u_int32_t		 length;
+	u_int32_t		 actlen;
+	u_int16_t		 flags;
+	u_int32_t		 timeout;
+	usbf_status		 status;
+	usbf_callback		 callback;
+	SIMPLEQ_ENTRY(usbf_xfer) next;
+
+	/* for memory management */
+	struct usbf_device	*device;
+	int			 rqflags;
+	usb_dma_t		 dmabuf;
+
+	usb_callout_t		 timeout_handle;
+};
+
+
+/* usbf.c */
+void	    usbf_host_reset(usbf_bus_handle);
+void	    usbf_do_request(usbf_xfer_handle, usbf_private_handle,
+			    usbf_status);
+
+/* usbf_subr.c */
+usbf_status usbf_new_device(device_ptr_t, usbf_bus_handle, int,
+			    int, int, struct usbf_port *);
+usbf_status usbf_set_endpoint_feature(usbf_config_handle, u_int8_t,
+				      u_int16_t);
+usbf_status usbf_clear_endpoint_feature(usbf_config_handle, u_int8_t,
+					u_int16_t);
+usbf_status usbf_insert_transfer(usbf_xfer_handle xfer);
+void	    usbf_transfer_complete(usbf_xfer_handle xfer);
+usbf_status usbf_allocmem(usbf_bus_handle, size_t, size_t, usb_dma_t *);
+void	    usbf_freemem(usbf_bus_handle, usb_dma_t *);
+usbf_status usbf_softintr_establish(struct usbf_bus *);
+void	    usbf_schedsoftintr(struct usbf_bus *);