summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPatrick Georgi <pgeorgi@google.com>2015-01-26 20:17:49 +0100
committerPatrick Georgi <pgeorgi@google.com>2015-04-18 08:40:19 +0200
commit1bd3050c27508036576c1f34ca500a6b4bccbda0 (patch)
tree85966013d5bf40a82ba2b6aea8eb1d7c375b6f9d
parent2df124db36ab7a456fa301e7334cd4fe894cb86a (diff)
downloadcoreboot-1bd3050c27508036576c1f34ca500a6b4bccbda0.tar.xz
libpayload: Add USB device mode driver
Add a framework for USB device mode controllers and a driver for the ChipIdea controller which is part of the tegra platform. TODO: - fix USB detach/attach - implement zero length packet handling properly BUG=chrome-os-partner:35861 TEST=none BRANCH=none Change-Id: I8defeea78b5a3bdbf9c1b1222c2702eaf3256b81 Signed-off-by: Patrick Georgi <pgeorgi@chromium.org> Original-Commit-Id: 542332291880c4026a05a960ceb91d37891ee018 Original-Change-Id: Ib4068d201dd63ebeda80157bd3130f3059919cdd Original-Signed-off-by: Patrick Georgi <pgeorgi@chromium.org> Original-Reviewed-on: https://chromium-review.googlesource.com/243272 Original-Reviewed-by: Aaron Durbin <adurbin@chromium.org> Reviewed-on: http://review.coreboot.org/8756 Tested-by: build bot (Jenkins) Reviewed-by: Stefan Reinauer <stefan.reinauer@coreboot.org>
-rw-r--r--payloads/libpayload/Config.in15
-rw-r--r--payloads/libpayload/drivers/Makefile.inc4
-rw-r--r--payloads/libpayload/drivers/udc/chipidea.c472
-rw-r--r--payloads/libpayload/drivers/udc/chipidea_priv.h168
-rw-r--r--payloads/libpayload/drivers/udc/udc.c327
-rw-r--r--payloads/libpayload/include/udc/chipidea.h37
-rw-r--r--payloads/libpayload/include/udc/udc.h141
7 files changed, 1164 insertions, 0 deletions
diff --git a/payloads/libpayload/Config.in b/payloads/libpayload/Config.in
index 84f72e0089..ed6d91c1f9 100644
--- a/payloads/libpayload/Config.in
+++ b/payloads/libpayload/Config.in
@@ -531,6 +531,21 @@ config USB_PCI
default y if ARCH_X86
default n
+config UDC
+ bool "USB device mode support"
+ default n
+ help
+ Select this option to add support for running as
+ a USB device.
+
+config UDC_CI
+ bool "ChipIdea driver for USB device mode"
+ depends on UDC
+ default n
+ help
+ Select this option to add the driver for ChipIdea
+ USB device controller.
+
endmenu
menu "Debugging"
diff --git a/payloads/libpayload/drivers/Makefile.inc b/payloads/libpayload/drivers/Makefile.inc
index 007395788f..b5f6c16e22 100644
--- a/payloads/libpayload/drivers/Makefile.inc
+++ b/payloads/libpayload/drivers/Makefile.inc
@@ -105,5 +105,9 @@ libc-$(CONFIG_LP_USB_MSC) += usb/usbmsc.c
libc-$(CONFIG_LP_USB_DWC2) += usb/dwc2.c
libc-$(CONFIG_LP_USB_DWC2) += usb/dwc2_rh.c
+# USB device stack
+libc-$(CONFIG_LP_UDC) += udc/udc.c
+libc-$(CONFIG_LP_UDC_CI) += udc/chipidea.c
+
# used by both USB HID and keyboard
libc-y += hid.c
diff --git a/payloads/libpayload/drivers/udc/chipidea.c b/payloads/libpayload/drivers/udc/chipidea.c
new file mode 100644
index 0000000000..e06f0d2824
--- /dev/null
+++ b/payloads/libpayload/drivers/udc/chipidea.c
@@ -0,0 +1,472 @@
+/*
+ * This file is part of the libpayload project.
+ *
+ * Copyright (C) 2015 Google Inc.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * 3. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ */
+
+#include <libpayload.h>
+#include <arch/cache.h>
+#include <assert.h>
+#include <endian.h>
+#include <queue.h>
+#include <stdio.h>
+#include <stdint.h>
+#include <stdlib.h>
+#include <usb/usb.h>
+
+#include <udc/udc.h>
+#include <udc/chipidea.h>
+#include "chipidea_priv.h"
+
+#ifdef DEBUG
+#define debug(x...) printf(x)
+#else
+#define debug(x...) do {} while (0)
+#endif
+
+#define min(a, b) (((a) < (b)) ? (a) : (b))
+
+static struct qh *get_qh(struct chipidea_pdata *p, int endpoint, int in_dir)
+{
+ assert(in_dir <= 1);
+ return &p->qhlist[2 * endpoint + in_dir];
+}
+
+static unsigned int ep_to_bits(int ep, int in_dir)
+{
+ return ep + (in_dir ? 16 : 0);
+}
+
+static void clear_setup_ep(struct chipidea_pdata *p, int endpoint)
+{
+ writel(1 << endpoint, &p->opreg->epsetupstat);
+}
+
+static void clear_ep(struct chipidea_pdata *p, int endpoint, int in_dir)
+{
+ writel(1 << ep_to_bits(endpoint, in_dir), &p->opreg->epcomplete);
+}
+
+static int chipidea_hw_init(struct usbdev_ctrl *this, void *_opreg,
+ const device_descriptor_t *dd)
+{
+ struct chipidea_opreg *opreg = _opreg;
+ struct chipidea_pdata *p = CI_PDATA(this);
+
+ p->opreg = phys_to_virt(opreg);
+ p->qhlist = dma_memalign(4096, sizeof(struct qh) * CI_QHELEMENTS);
+ memcpy(&this->device_descriptor, dd, sizeof(*dd));
+
+ if (p->qhlist == NULL)
+ die("failed to allocate memory for usb device mode");
+
+ memset(p->qhlist, 0, sizeof(struct qh) * CI_QHELEMENTS);
+
+ SLIST_INIT(&this->configs);
+
+ int i;
+ for (i = 0; i < 16; i++) {
+ SIMPLEQ_INIT(&p->job_queue[i][0]);
+ SIMPLEQ_INIT(&p->job_queue[i][1]);
+ }
+
+ for (i = 0; i < CI_QHELEMENTS; i++) {
+ p->qhlist[i].config = QH_MPS(512) | QH_NO_AUTO_ZLT | QH_IOS;
+ p->qhlist[i].td.next = TD_TERMINATE;
+ }
+ /* EP0 in/out are hardwired for SETUP */
+ p->qhlist[0].config = QH_MPS(64) | QH_NO_AUTO_ZLT | QH_IOS;
+ p->qhlist[1].config = QH_MPS(64) | QH_NO_AUTO_ZLT | QH_IOS;
+
+ do {
+ debug("waiting for usb phy clk valid: %x\n",
+ readl(&p->opreg->susp_ctrl));
+ mdelay(1);
+ } while ((readl(&p->opreg->susp_ctrl) & (1 << 7)) == 0);
+
+ writel(USBCMD_8MICRO | USBCMD_RST, &p->opreg->usbcmd);
+ mdelay(1);
+
+ /* enable device mode */
+ writel(2, &p->opreg->usbmode);
+
+ dcache_clean_by_mva(p->qhlist, sizeof(struct qh) * CI_QHELEMENTS);
+
+ writel(virt_to_phys(p->qhlist), &p->opreg->epbase);
+ writel(0xffffffff, &p->opreg->epflush);
+
+ /* enable EP0 */
+ writel((1 << 23) | (1 << 22) | (1 << 7) | (1 << 6),
+ &p->opreg->epctrl[0]);
+
+ /* clear status register */
+ writel(readl(&p->opreg->usbsts), &p->opreg->usbsts);
+
+ debug("taking controller out of reset\n");
+ writel(USBCMD_8MICRO | USBCMD_RUN, &p->opreg->usbcmd);
+
+ return 1;
+}
+
+static void chipidea_halt_ep(struct usbdev_ctrl *this, int ep, int in_dir)
+{
+ struct chipidea_pdata *p = CI_PDATA(this);
+ writel(1 << ep_to_bits(ep, in_dir), &p->opreg->epflush);
+ while (readl(&p->opreg->epflush))
+ ;
+ clrbits_le32(&p->opreg->epctrl[ep], 1 << (7 + (in_dir ? 16 : 0)));
+}
+
+static void chipidea_start_ep(struct usbdev_ctrl *this,
+ int ep, int in_dir, int ep_type, int mps)
+{
+ struct chipidea_pdata *p = CI_PDATA(this);
+ struct qh *qh = get_qh(p, ep, in_dir);
+ qh->config = (mps << 16) | QH_NO_AUTO_ZLT | QH_IOS;
+ dcache_clean_by_mva(qh, sizeof(*qh));
+ in_dir = in_dir ? 1 : 0;
+ debug("enabling %d-%d (type %d)\n", ep, in_dir, ep_type);
+ /* enable endpoint, reset data toggle */
+ setbits_le32(&p->opreg->epctrl[ep],
+ ((1 << 7) | (1 << 6) | (ep_type << 2)) << (in_dir*16));
+ p->ep_busy[ep][in_dir] = 0;
+}
+
+static void advance_endpoint(struct chipidea_pdata *p, int endpoint, int in_dir)
+{
+ if (p->ep_busy[endpoint][in_dir])
+ return;
+ if (SIMPLEQ_EMPTY(&p->job_queue[endpoint][in_dir]))
+ return;
+
+ struct job *job = SIMPLEQ_FIRST(&p->job_queue[endpoint][in_dir]);
+ struct qh *qh = get_qh(p, endpoint, in_dir);
+
+ uint32_t start = (uint32_t)(uintptr_t)job->data;
+ uint32_t offset = (start & 0xfff);
+ /* unlike with typical EHCI controllers,
+ * a full TD transfers either 0x5000 bytes if
+ * page aligned or 0x4000 bytes if not.
+ */
+ int maxsize = 0x5000;
+ if (offset > 0)
+ maxsize = 0x4000;
+ uint32_t td_count = (job->length + maxsize - 1) / maxsize;
+
+ /* special case for zero length packets */
+ if (td_count == 0)
+ td_count = 1;
+
+ if (job->zlp)
+ td_count++;
+
+ struct td *tds = dma_memalign(32, sizeof(struct td) * td_count);
+ memset(tds, 0, sizeof(struct td) * td_count);
+
+ int i;
+ int remaining = job->length;
+ for (i = 0; i < td_count; i++) {
+ int datacount = min(maxsize, remaining);
+
+ debug("td %d, %d bytes\n", i, datacount);
+ tds[i].next = (uint32_t)virt_to_phys(&tds[i+1]);
+ tds[i].info = TD_INFO_LEN(datacount) | TD_INFO_ACTIVE;
+ tds[i].page0 = start;
+ tds[i].page1 = (start & 0xfffff000) + 0x1000;
+ tds[i].page2 = (start & 0xfffff000) + 0x2000;
+ tds[i].page3 = (start & 0xfffff000) + 0x3000;
+ tds[i].page4 = (start & 0xfffff000) + 0x4000;
+ remaining -= datacount;
+ start = start + datacount;
+ }
+ tds[td_count - 1].next = TD_TERMINATE;
+ tds[td_count - 1].info |= TD_INFO_IOC;
+
+ qh->td.next = (uint32_t)virt_to_phys(tds);
+ qh->td.info = 0;
+
+ job->tds = tds;
+ job->td_count = td_count;
+
+ dcache_clean_by_mva(tds, sizeof(struct td) * td_count);
+ dcache_clean_by_mva(job->data, job->length);
+ dcache_clean_by_mva(qh, sizeof(*qh));
+
+ debug("priming EP %d-%d with %zx bytes starting at %x (%p)\n", endpoint,
+ in_dir, job->length, tds[0].page0, job->data);
+ writel(1 << ep_to_bits(endpoint, in_dir), &p->opreg->epprime);
+ while (readl(&p->opreg->epprime))
+ ;
+ p->ep_busy[endpoint][in_dir] = 1;
+}
+
+static void handle_endpoint(struct usbdev_ctrl *this, int endpoint, int in_dir)
+{
+ struct chipidea_pdata *p = CI_PDATA(this);
+ struct job *job = SIMPLEQ_FIRST(&p->job_queue[endpoint][in_dir]);
+ SIMPLEQ_REMOVE_HEAD(&p->job_queue[endpoint][in_dir], queue);
+
+ if (in_dir)
+ dcache_invalidate_by_mva(job->data, job->length);
+
+ int length = job->length;
+
+ int i = 0;
+ do {
+ int active;
+ do {
+ dcache_invalidate_by_mva(&job->tds[i],
+ sizeof(struct td));
+ active = job->tds[i].info & TD_INFO_ACTIVE;
+ debug("%d-%d: info %08x, page0 %x, next %x\n",
+ endpoint, in_dir, job->tds[i].info,
+ job->tds[i].page0, job->tds[i].next);
+ } while (active);
+ /*
+ * The controller writes back the length field in info
+ * with the number of bytes it did _not_ process.
+ * Hence, take the originally scheduled length and
+ * subtract whatever lengths we still find - that gives
+ * us the data that the controller did transfer.
+ */
+ int remaining = job->tds[i].info >> 16;
+ length -= remaining;
+ } while (job->tds[i++].next != TD_TERMINATE);
+ debug("%d-%d: scheduled %zd, now %d bytes\n", endpoint, in_dir,
+ job->length, length);
+
+ if (this->current_config &&
+ this->current_config->interfaces[0].handle_packet)
+ this->current_config->interfaces[0].handle_packet(this,
+ endpoint, in_dir, job->data, length);
+
+ free(job->tds);
+ if (job->autofree)
+ free(job->data);
+ free(job);
+ p->ep_busy[endpoint][in_dir] = 0;
+
+ advance_endpoint(p, endpoint, in_dir);
+}
+
+static void start_setup(struct usbdev_ctrl *this, int ep)
+{
+ dev_req_t dr;
+ struct chipidea_pdata *p = CI_PDATA(this);
+ struct qh *qh = get_qh(p, ep, 0);
+
+ dcache_invalidate_by_mva(qh, sizeof(*qh));
+ memcpy(&dr, qh->setup_data, sizeof(qh->setup_data));
+ clear_setup_ep(p, ep);
+
+#ifdef DEBUG
+ hexdump((unsigned long)&dr, sizeof(dr));
+#endif
+
+ udc_handle_setup(this, ep, &dr);
+}
+
+
+static void chipidea_enqueue_packet(struct usbdev_ctrl *this, int endpoint,
+ int in_dir, void *data, int len, int zlp, int autofree)
+{
+ struct chipidea_pdata *p = CI_PDATA(this);
+ struct job *job = malloc(sizeof(*job));
+
+ job->data = data;
+ job->length = len;
+ job->zlp = zlp;
+ job->autofree = autofree;
+
+ debug("adding job of %d bytes to EP %d-%d\n", len, endpoint, in_dir);
+ SIMPLEQ_INSERT_TAIL(&p->job_queue[endpoint][in_dir], job, queue);
+
+ if ((endpoint == 0) || (this->initialized))
+ advance_endpoint(p, endpoint, in_dir);
+}
+
+static int chipidea_poll(struct usbdev_ctrl *this)
+{
+ struct chipidea_pdata *p = CI_PDATA(this);
+ uint32_t sts = readl(&p->opreg->usbsts);
+ writel(sts, &p->opreg->usbsts); /* clear */
+
+ /* new information if the bus is high speed or not */
+ if (sts & USBSTS_PCI) {
+ debug("USB speed negotiation: ");
+ if ((readl(&p->opreg->devlc) & DEVLC_HOSTSPEED_MASK)
+ == DEVLC_HOSTSPEED(2)) {
+ debug("high speed\n");
+ // TODO: implement
+ } else {
+ debug("full speed\n");
+ // TODO: implement
+ }
+ }
+
+ /* reset requested. stop all activities */
+ if (sts & USBSTS_URI) {
+ int i;
+ debug("USB reset requested\n");
+ if (this->initialized) {
+ writel(readl(&p->opreg->epstat), &p->opreg->epstat);
+ writel(readl(&p->opreg->epsetupstat),
+ &p->opreg->epsetupstat);
+ writel(0xffffffff, &p->opreg->epflush);
+ for (i = 1; i < 16; i++)
+ writel(0, &p->opreg->epctrl[i]);
+ this->initialized = 0;
+ }
+ writel((1 << 22) | (1 << 6), &p->opreg->epctrl[0]);
+ p->qhlist[0].config = QH_MPS(64) | QH_NO_AUTO_ZLT | QH_IOS;
+ p->qhlist[1].config = QH_MPS(64) | QH_NO_AUTO_ZLT | QH_IOS;
+ dcache_clean_by_mva(p->qhlist, 2 * sizeof(struct qh));
+ }
+
+ if (sts & (USBSTS_UEI | USBSTS_UI)) {
+ uint32_t bitmap = readl(&p->opreg->epsetupstat);
+ int ep = 0;
+ while (bitmap) {
+ if (bitmap & 1) {
+ debug("incoming packet on EP %d (setup)\n", ep);
+ start_setup(this, ep);
+ }
+ bitmap >>= 1;
+ ep++;
+ }
+ bitmap = readl(&p->opreg->epcomplete);
+ ep = 0;
+ int dir_in = 0;
+ while (bitmap) {
+ if (bitmap & 1) {
+ debug("incoming packet on EP %d (%s)\n",
+ ep, dir_in ? "intr/in" : "out");
+ handle_endpoint(this, ep & 0xf, dir_in);
+ clear_ep(p, ep & 0xf, dir_in);
+ }
+ bitmap >>= 1;
+ ep++;
+ if (ep == 16)
+ dir_in = 1;
+ }
+ }
+
+ return 1;
+}
+
+static void chipidea_shutdown(struct usbdev_ctrl *this)
+{
+ struct chipidea_pdata *p = CI_PDATA(this);
+ int i, j;
+ int is_empty = 0;
+ while (!is_empty) {
+ is_empty = 1;
+ this->poll(this);
+ for (i = 0; i < 16; i++)
+ for (j = 0; j < 2; j++)
+ if (!SIMPLEQ_EMPTY(&p->job_queue[i][j]))
+ is_empty = 0;
+ }
+ writel(0xffffffff, &p->opreg->epflush);
+ writel(USBCMD_8MICRO | USBCMD_RST, &p->opreg->usbcmd);
+ writel(0, &p->opreg->usbmode);
+ writel(USBCMD_8MICRO, &p->opreg->usbcmd);
+ free(p->qhlist);
+ free(p);
+ free(this);
+}
+
+static void chipidea_set_address(struct usbdev_ctrl *this, int address)
+{
+ struct chipidea_pdata *p = CI_PDATA(this);
+ writel((address << 25) | (1 << 24), &p->opreg->usbadr);
+}
+
+static void chipidea_stall(struct usbdev_ctrl *this,
+ uint8_t ep, int in_dir, int set)
+{
+ struct chipidea_pdata *p = CI_PDATA(this);
+ assert(ep < 16);
+ uint32_t *ctrl = &p->opreg->epctrl[ep];
+ in_dir = in_dir ? 1 : 0;
+ if (set) {
+ if (in_dir)
+ setbits_le32(ctrl, 1 << 16);
+ else
+ setbits_le32(ctrl, 1 << 0);
+ } else {
+ /* reset STALL bit, reset data toggle */
+ if (in_dir) {
+ setbits_le32(ctrl, 1 << 22);
+ clrbits_le32(ctrl, 1 << 16);
+ } else {
+ setbits_le32(ctrl, 1 << 6);
+ setbits_le32(ctrl, 1 << 0);
+ }
+ }
+ this->ep_halted[ep][in_dir] = set;
+}
+
+static void *chipidea_malloc(size_t size)
+{
+ return dma_malloc(size);
+}
+
+static void chipidea_free(void *ptr)
+{
+ free(ptr);
+}
+
+struct usbdev_ctrl *chipidea_init(device_descriptor_t *dd)
+{
+ struct usbdev_ctrl *ctrl = calloc(1, sizeof(*ctrl));
+ if (ctrl == NULL)
+ return NULL;
+ ctrl->pdata = calloc(1, sizeof(struct chipidea_pdata));
+ if (ctrl->pdata == NULL) {
+ free(ctrl);
+ return NULL;
+ }
+
+ ctrl->poll = chipidea_poll;
+ ctrl->add_gadget = udc_add_gadget;
+ ctrl->enqueue_packet = chipidea_enqueue_packet;
+ ctrl->shutdown = chipidea_shutdown;
+ ctrl->set_address = chipidea_set_address;
+ ctrl->stall = chipidea_stall;
+ ctrl->halt_ep = chipidea_halt_ep;
+ ctrl->start_ep = chipidea_start_ep;
+ ctrl->alloc_data = chipidea_malloc;
+ ctrl->free_data = chipidea_free;
+ ctrl->initialized = 0;
+
+ if (!chipidea_hw_init(ctrl, (void *)0x7d000000, dd)) {
+ free(ctrl->pdata);
+ free(ctrl);
+ return NULL;
+ }
+ return ctrl;
+}
diff --git a/payloads/libpayload/drivers/udc/chipidea_priv.h b/payloads/libpayload/drivers/udc/chipidea_priv.h
new file mode 100644
index 0000000000..ede97ab264
--- /dev/null
+++ b/payloads/libpayload/drivers/udc/chipidea_priv.h
@@ -0,0 +1,168 @@
+/*
+ * This file is part of the libpayload project.
+ *
+ * Copyright (C) 2015 Google Inc.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * 3. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ */
+
+#ifndef __CHIPIDEA_PRIV_H__
+#define __CHIPIDEA_PRIV_H__
+
+#include <queue.h>
+
+struct chipidea_opreg {
+ uint8_t pad0[0x130];
+ uint32_t usbcmd; // 0x130
+ uint32_t usbsts; // 0x134
+ uint32_t pad138[3];
+ uint32_t usbadr; // 0x144
+ /* 31:25: address
+ * 24: staging: 1 -> commit new address after
+ * next ctrl-in on ep0
+ */
+ uint32_t epbase; // 0x148
+ uint32_t pad14c[10];
+ uint32_t portsc; // 0x174
+ uint32_t pad178[15];
+ uint32_t devlc; // 0x1b4
+ /* 25:26: host-desired usb version
+ * 23: force full speed */
+ uint32_t pad1b8[16];
+ uint32_t usbmode; // 0x1f8
+ /* 0:1: 2 -> device mode */
+ uint32_t pad1fc[3];
+ uint32_t epsetupstat; // 0x208
+ /* 0:15: 1 -> epX received setup packet */
+ uint32_t epprime; // 0x20c
+ /* 0:15: 1 -> rx buffer for epX (OUT) is primed
+ * (ie. ready for controller-side processing)
+ * 16:31: 1 -> tx buffer for ep(X-16) (IN/INTR) is primed
+ * (ie. ready for controller-side processing)
+ *
+ * controller will read new td from qh and process it,
+ * then set the bit to 0
+ */
+ uint32_t epflush; // 0x210
+ /* 0:31: 1 -> flush buffer (as defined in epprime),
+ * so it's uninitialized again.
+ * controller resets to 0 when done
+ */
+ uint32_t epstat; // 0x214
+ /* 0:31: 1 -> command in epprime is done, EP is ready
+ * (which may be later than epprime reset)
+ */
+ uint32_t epcomplete; // 0x218
+ /* 0:15: 1 -> incoming out/setup packet for epX was handled.
+ * software should check QH state
+ * 16:31: 1 -> incoming intr/in packet for ep(X-16) was
+ * handled. software should check QH state
+ */
+ uint32_t epctrl[16]; // 0x21c
+ /* epctrl[0] is hardcoded as enabled control endpoint.
+ * TXS/RXS for stalling can be written.
+ *
+ * 23: TXE tx endpoint enable
+ * 22: TXR reset tx data toggle (for every configuration event)
+ * 18:19: 0=ctrl, 1=isoc, 2=bulk, 3=intr endpoint
+ * 16: TXS stall tx
+ *
+ * 7: RXE rx endpoint enable
+ * 6: RXR reset rx data toggle (for every configuration event)
+ * 2:3: endpoint type (like 18:19)
+ * 0: RXS stall rx
+ */
+ uint32_t pad25c[0x69]; // 0x25c
+ uint32_t susp_ctrl; // 0x400
+};
+
+#define CI_PDATA(ctrl) ((struct chipidea_pdata *)((ctrl)->pdata))
+#define CI_QHELEMENTS 32
+
+#define QH_NO_AUTO_ZLT (1 << 29) /* no automatic ZLT handling by chipset */
+#define QH_MPS(x) ((x) << 16)
+#define QH_IOS (1 << 15) /* IRQ on setup */
+
+#define TD_INFO_LEN(x) ((x) << 16)
+#define TD_INFO_IOC (1 << 15)
+#define TD_INFO_ACTIVE (1 << 7)
+#define TD_TERMINATE 1
+
+#define USBCMD_8MICRO (8 << 16)
+#define USBCMD_RST 2
+#define USBCMD_RUN 1
+
+#define USBSTS_SLI (1 << 8)
+#define USBSTS_URI (1 << 6)
+#define USBSTS_PCI (1 << 2)
+#define USBSTS_UEI (1 << 1)
+#define USBSTS_UI (1 << 0)
+
+#define DEVLC_HOSTSPEED(x) (x << 25)
+#define DEVLC_HOSTSPEED_MASK DEVLC_HOSTSPEED(3)
+
+struct td {
+ /* points to next td */
+ uint32_t next;
+ uint32_t info;
+ /* page0..4 are like EHCI pages: up to 4k each
+ * page0 from addr to page end, page4 to its length
+ */
+ uint32_t page0;
+ uint32_t page1;
+ uint32_t page2;
+ uint32_t page3;
+ uint32_t page4;
+ uint32_t res;
+};
+
+struct qh {
+ uint32_t config;
+ uint32_t current;
+ struct td td;
+ /* contains the data of a setup request */
+ uint8_t setup_data[8];
+ uint32_t res[4];
+};
+
+struct job {
+ SIMPLEQ_ENTRY(job) queue; // linkage
+ struct td *tds; // for later free()ing
+ int td_count;
+ void *data;
+ size_t length;
+ int zlp; // append zero length packet?
+ int autofree; // free after processing?
+};
+
+SIMPLEQ_HEAD(job_queue, job);
+
+struct chipidea_pdata {
+ struct chipidea_opreg *opreg;
+ struct qh *qhlist;
+ struct job_queue job_queue[16][2];
+ int ep_busy[16][2];
+};
+
+#endif
diff --git a/payloads/libpayload/drivers/udc/udc.c b/payloads/libpayload/drivers/udc/udc.c
new file mode 100644
index 0000000000..cdc2b29f95
--- /dev/null
+++ b/payloads/libpayload/drivers/udc/udc.c
@@ -0,0 +1,327 @@
+/*
+ * This file is part of the libpayload project.
+ *
+ * Copyright (C) 2015 Google Inc.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * 3. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ */
+
+#include <libpayload.h>
+#include <arch/cache.h>
+#include <assert.h>
+#include <endian.h>
+#include <queue.h>
+#include <stdio.h>
+#include <stdint.h>
+#include <stdlib.h>
+#include <usb/usb.h>
+
+#include <udc/udc.h>
+
+#ifdef DEBUG
+#define debug(x...) printf(x)
+#else
+#define debug(x...) do {} while (0)
+#endif
+
+#define min(a, b) (((a) < (b)) ? (a) : (b))
+
+// TODO: make this right
+#define ZLP(len, explen) 0
+
+static struct usbdev_configuration *fetch_config(struct usbdev_ctrl *this,
+ int id)
+{
+ struct usbdev_configuration *config;
+ SLIST_FOREACH(config, &this->configs, list) {
+ debug("checking descriptor %d\n",
+ config->descriptor.bConfigurationValue);
+ if (config->descriptor.bConfigurationValue == id)
+ return config;
+ }
+ return NULL;
+}
+
+static void enable_interface(struct usbdev_ctrl *this, int iface_num)
+{
+ struct usbdev_configuration *config = this->current_config;
+ struct usbdev_interface *iface = &config->interfaces[iface_num];
+
+ /* first: shut down all endpoints except EP0 */
+ int i;
+ for (i = 1; i < 16; i++) {
+ /* disable endpoints */
+ this->halt_ep(this, i, 0);
+ this->halt_ep(this, i, 1);
+ }
+
+ /* now enable all configured endpoints */
+ int epcount = iface->descriptor.bNumEndpoints;
+ for (i = 0; i < epcount; i++) {
+ int ep = iface->eps[i].bEndpointAddress;
+ int mps = iface->eps[i].wMaxPacketSize;
+ int in_dir = 0;
+ if (ep & 0x80) {
+ in_dir = 1;
+ ep &= 0x7f;
+ }
+ int ep_type = iface->eps[i].bmAttributes & 0x3;
+ this->start_ep(this, ep, in_dir, ep_type, mps);
+ }
+
+ // gadget specific configuration
+ if (iface->init)
+ iface->init(this);
+}
+
+/**
+ * handle default control transfers on EP 0
+ *
+ * returns 1 if transfer was handled
+ */
+static int setup_ep0(struct usbdev_ctrl *this, dev_req_t *dr)
+{
+ if ((dr->bmRequestType == 0x00) &&
+ (dr->bRequest == SET_ADDRESS)) {
+ this->set_address(this, dr->wValue & 0x7f);
+
+ /* status phase IN */
+ this->enqueue_packet(this, 0, 1, NULL, 0, 0, 0);
+ return 1;
+ } else
+ if ((dr->bmRequestType == 0x00) &&
+ (dr->bRequest == SET_CONFIGURATION)) {
+ struct usbdev_configuration *config =
+ fetch_config(this, dr->wValue);
+
+ this->current_config = config;
+ this->current_config_id = dr->wValue;
+
+ if (dr->wValue == 0)
+ // TODO: reset device
+ return 1;
+
+ if (config == NULL) {
+ this->stall(this, 0, 0, 1);
+ this->stall(this, 0, 1, 1);
+ return 1;
+ }
+
+ /* status phase IN */
+ this->enqueue_packet(this, 0, 1, NULL, 0, 0, 0);
+
+ /* automatically configure endpoints in interface 0 */
+ enable_interface(this, 0);
+ this->initialized = 1;
+ return 1;
+ } else
+ if ((dr->bmRequestType == 0x80) &&
+ (dr->bRequest == GET_CONFIGURATION)) {
+ unsigned char *res = dma_malloc(1);
+ res[0] = this->current_config_id;
+
+ /* data phase IN */
+ this->enqueue_packet(this, 0, 1, res, 1, 0, 1);
+
+ // status phase OUT
+ this->enqueue_packet(this, 0, 0, NULL, 0, 0, 0);
+ return 1;
+ } else
+ // ENDPOINT_HALT
+ if ((dr->bmRequestType == 0x02) && // endpoint
+ (dr->bRequest == CLEAR_FEATURE) &&
+ (dr->wValue == 0)) {
+ int ep = dr->wIndex;
+ /* clear STALL */
+ this->stall(this, ep & 0xf, ep & 0x80, 0);
+
+ /* status phase IN */
+ this->enqueue_packet(this, 0, 1, NULL, 0, 0, 0);
+ return 1;
+ } else
+ // ENDPOINT_HALT
+ if ((dr->bmRequestType == 0x02) && // endpoint
+ (dr->bRequest == SET_FEATURE) &&
+ (dr->wValue == 0)) {
+ int ep = dr->wIndex;
+ /* set STALL */
+ this->stall(this, ep & 0xf, ep & 0x80, 1);
+
+ /* status phase IN */
+ this->enqueue_packet(this, 0, 1, NULL, 0, 0, 0);
+ return 1;
+ } else
+ // DEVICE_REMOTE_WAKEUP
+ if ((dr->bmRequestType == 0x00) &&
+ (dr->bRequest == CLEAR_FEATURE) &&
+ (dr->wValue == 1)) {
+ this->remote_wakeup = 0;
+
+ /* status phase IN */
+ this->enqueue_packet(this, 0, 1, NULL, 0, 0, 0);
+ return 1;
+ } else
+ // DEVICE_REMOTE_WAKEUP
+ if ((dr->bmRequestType == 0x00) &&
+ (dr->bRequest == SET_FEATURE) &&
+ (dr->wValue == 1)) {
+ this->remote_wakeup = 1;
+
+ /* status phase IN */
+ this->enqueue_packet(this, 0, 1, NULL, 0, 0, 0);
+ return 1;
+ } else
+ if ((dr->bmRequestType == 0x82) && // endpoint
+ (dr->bRequest == GET_STATUS)) {
+ unsigned char *res = dma_malloc(2);
+ int ep = dr->wIndex;
+ /* is EP halted? */
+ res[0] = this->ep_halted[ep & 0xf][(ep & 0x80) ? 1 : 0];
+ res[1] = 0;
+
+ /* data phase IN */
+ this->enqueue_packet(this, 0, 1, res,
+ min(2, dr->wLength), 0, 1);
+
+ // status phase OUT
+ this->enqueue_packet(this, 0, 0, NULL, 0, 0, 0);
+ return 1;
+ } else
+ if ((dr->bmRequestType == 0x80) &&
+ (dr->bRequest == GET_STATUS)) {
+ unsigned char *res = dma_malloc(2);
+ res[0] = 1; // self powered
+ if (this->remote_wakeup)
+ res[0] |= 2;
+
+ res[1] = 0;
+
+ /* data phase IN */
+ this->enqueue_packet(this, 0, 1, res,
+ min(2, dr->wLength), 0, 1);
+
+ // status phase OUT
+ this->enqueue_packet(this, 0, 0, NULL, 0, 0, 0);
+ return 1;
+ } else
+ if ((dr->bmRequestType == 0x80) &&
+ (dr->bRequest == GET_DESCRIPTOR) &&
+ ((dr->wValue & 0xff00) == 0x0200)) {
+ int i, j;
+ /* config descriptor #id
+ * since config = 0 is undefined, but descriptors
+ * should start at 0, add 1 to have them match up.
+ */
+ int id = (dr->wValue & 0xff) + 1;
+ struct usbdev_configuration *config = fetch_config(this, id);
+ if (config == NULL) {
+ this->stall(this, 0, 0, 1);
+ this->stall(this, 0, 1, 1);
+ return 1;
+ }
+ debug("descriptor found, should be %d bytes\n",
+ config->descriptor.wTotalLength);
+
+ uint8_t *data = dma_malloc(config->descriptor.wTotalLength);
+ uint8_t *head = data;
+
+ memcpy(head, &config->descriptor,
+ sizeof(configuration_descriptor_t));
+ head += sizeof(configuration_descriptor_t);
+
+ for (i = 0; i < config->descriptor.bNumInterfaces; i++) {
+ memcpy(head, &config->interfaces[i].descriptor,
+ sizeof(interface_descriptor_t));
+ head += sizeof(interface_descriptor_t);
+ for (j = 0;
+ j < config->interfaces[i].descriptor.bNumEndpoints;
+ j++) {
+ memcpy(head, &config->interfaces[i].eps[j],
+ sizeof(endpoint_descriptor_t));
+ head += sizeof(endpoint_descriptor_t);
+ }
+ }
+ int size = config->descriptor.wTotalLength;
+ assert((head - data) == config->descriptor.wTotalLength);
+
+ /* data phase IN */
+ this->enqueue_packet(this, 0, 1, data,
+ min(size, dr->wLength),
+ ZLP(size, dr->wLength), 1);
+
+ /* status phase OUT */
+ this->enqueue_packet(this, 0, 0, NULL, 0, 0, 0);
+ return 1;
+ } else
+ if ((dr->bmRequestType == 0x80) &&
+ (dr->bRequest == GET_DESCRIPTOR) &&
+ ((dr->wValue & 0xff00) == 0x0100)) {
+ device_descriptor_t *dd = dma_malloc(sizeof(*dd));
+ memcpy(dd, &this->device_descriptor, sizeof(*dd));
+ dd->bNumConfigurations = this->config_count;
+
+ /* data phase IN */
+ this->enqueue_packet(this, 0, 1, (void *)dd,
+ min(sizeof(*dd), dr->wLength),
+ ZLP(sizeof(*dd), dr->wLength), 1);
+
+ /* status phase OUT */
+ this->enqueue_packet(this, 0, 0, NULL, 0, 0, 0);
+ return 1;
+ }
+ return 0;
+}
+
+void udc_add_gadget(struct usbdev_ctrl *this,
+ struct usbdev_configuration *config)
+{
+ int i, size;
+ SLIST_INSERT_HEAD(&this->configs, config, list);
+
+ size = sizeof(configuration_descriptor_t);
+
+ for (i = 0; i < config->descriptor.bNumInterfaces; i++) {
+ size += sizeof(config->interfaces[i].descriptor);
+ size += config->interfaces[i].descriptor.bNumEndpoints *
+ sizeof(endpoint_descriptor_t);
+ }
+ config->descriptor.wTotalLength = size;
+ config->descriptor.bConfigurationValue = ++this->config_count;
+}
+
+void udc_handle_setup(struct usbdev_ctrl *this, int ep, dev_req_t *dr)
+{
+ if ((ep == 0) && setup_ep0(this, dr))
+ return;
+
+ if (this->current_config &&
+ this->current_config->interfaces[0].handle_setup &&
+ this->current_config->interfaces[0].handle_setup(this, ep, dr))
+ return;
+
+ /* no successful SETUP transfer should end up here, report error */
+ this->halt_ep(this, ep, 0);
+ this->halt_ep(this, ep, 1);
+}
+
diff --git a/payloads/libpayload/include/udc/chipidea.h b/payloads/libpayload/include/udc/chipidea.h
new file mode 100644
index 0000000000..41b8385647
--- /dev/null
+++ b/payloads/libpayload/include/udc/chipidea.h
@@ -0,0 +1,37 @@
+/*
+ * This file is part of the libpayload project.
+ *
+ * Copyright (C) 2015 Google Inc.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * 3. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ */
+
+#ifndef __CHIPIDEA_H__
+#define __CHIPIDEA_H__
+
+#include "udc.h"
+
+struct usbdev_ctrl *chipidea_init(device_descriptor_t *dd);
+
+#endif
diff --git a/payloads/libpayload/include/udc/udc.h b/payloads/libpayload/include/udc/udc.h
new file mode 100644
index 0000000000..48e73f4c56
--- /dev/null
+++ b/payloads/libpayload/include/udc/udc.h
@@ -0,0 +1,141 @@
+/*
+ * This file is part of the libpayload project.
+ *
+ * Copyright (C) 2015 Google Inc.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * 3. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ */
+
+#ifndef __UDC_H__
+#define __UDC_H__
+
+#include <queue.h>
+#include <usb/usb.h>
+
+struct usbdev_ctrl;
+
+struct usbdev_interface {
+ interface_descriptor_t descriptor;
+ void (*init)(struct usbdev_ctrl *);
+
+ /**
+ * handle_packet: called by the controller driver for incoming packets
+ *
+ * @param ep endpoint the packet is for
+ *
+ * @param in_dir 1, if it's an IN or INTR transfer.
+ * 0 for OUT, SETUP is handled in handle_setup
+ *
+ * @param len Actual transfer length in bytes. Can differ from the
+ * scheduled length if the host requested a smaller
+ * transfer than we prepared for.
+ */
+ void (*handle_packet)(struct usbdev_ctrl *, int ep, int in_dir,
+ void *data, int len);
+
+ /**
+ * handle_setup: called by the controller driver for setup packets
+ *
+ * @param ep endpoint the SETUP request came up on
+ * @param dr SETUP request data
+ */
+ int (*handle_setup)(struct usbdev_ctrl *, int ep, dev_req_t *dr);
+ endpoint_descriptor_t *eps;
+};
+
+struct usbdev_configuration {
+ configuration_descriptor_t descriptor;
+ SLIST_ENTRY(usbdev_configuration) list;
+ struct usbdev_interface interfaces[];
+};
+
+SLIST_HEAD(configuration_list, usbdev_configuration);
+
+struct usbdev_ctrl {
+ /* private data */
+ void *pdata;
+
+ int initialized;
+ int remote_wakeup;
+
+ struct usbdev_configuration *current_config;
+ int current_config_id;
+
+ struct configuration_list configs;
+ int config_count;
+ device_descriptor_t device_descriptor;
+
+ int ep_halted[16][2];
+
+ /** returns 0 if an error occurred */
+ int (*poll)(struct usbdev_ctrl *);
+
+ /**
+ * Add a gadget driver that exposes properties described in config.
+ *
+ * Each gadget driver is registered and exposed as separate USB
+ * "configuration", so the host can choose between them.
+ */
+ void (*add_gadget)(struct usbdev_ctrl *,
+ struct usbdev_configuration *config);
+
+ /**
+ * Add packet to process by the controller.
+ * zlp: zero length packet, if such a termination is necessary
+ * autofree: free data after use
+ */
+ void (*enqueue_packet)(struct usbdev_ctrl *this, int endpoint,
+ int in_dir, void *data, int len, int zlp, int autofree);
+
+ /**
+ * Tell the hardware that it should listen to a new address
+ */
+ void (*set_address)(struct usbdev_ctrl *, int address);
+
+ void (*halt_ep)(struct usbdev_ctrl *this, int ep, int in_dir);
+ void (*start_ep)(struct usbdev_ctrl *this,
+ int ep, int in_dir, int ep_type, int mps);
+
+ /**
+ * Set or clear endpoint ep's STALL state
+ */
+ void (*stall)(struct usbdev_ctrl *, uint8_t ep, int in_dir, int set);
+
+ void (*shutdown)(struct usbdev_ctrl *this);
+
+ /**
+ * Allocate n bytes for use as data
+ */
+ void *(*alloc_data)(size_t n);
+ /**
+ * Free memory object allocated with alloc_data()
+ */
+ void (*free_data)(void *);
+};
+
+void udc_add_gadget(struct usbdev_ctrl *this,
+ struct usbdev_configuration *config);
+void udc_handle_setup(struct usbdev_ctrl *this, int ep, dev_req_t *dr);
+
+#endif