OpenWrt – Rev 1

Subversion Repositories:
Rev:
/*
 * ADM5120 HCD (Host Controller Driver) for USB
 *
 * Copyright (C) 2007-2008 Gabor Juhos <juhosg@openwrt.org>
 *
 * This file was derived from: drivers/usb/host/ohci-dbg.c
 *   (C) Copyright 1999 Roman Weissgaerber <weissg@vienna.at>
 *   (C) Copyright 2000-2002 David Brownell <dbrownell@users.sourceforge.net>
 *
 *  This program is free software; you can redistribute it and/or modify it
 *  under the terms of the GNU General Public License version 2 as published
 *  by the Free Software Foundation.
 *
 */

/*-------------------------------------------------------------------------*/

static inline char *ed_typestring(int ed_type)
{
        switch (ed_type) {
        case PIPE_CONTROL:
                return "ctrl";
        case PIPE_BULK:
                return "bulk";
        case PIPE_INTERRUPT:
                return "intr";
        case PIPE_ISOCHRONOUS:
                return "isoc";
        }
        return "(bad ed_type)";
}

static inline char *ed_statestring(int state)
{
        switch (state) {
        case ED_IDLE:
                return "IDLE";
        case ED_UNLINK:
                return "UNLINK";
        case ED_OPER:
                return "OPER";
        }
        return "?STATE";
}

static inline char *pipestring(int pipe)
{
        return ed_typestring(usb_pipetype(pipe));
}

static inline char *td_pidstring(u32 info)
{
        switch (info & TD_DP) {
        case TD_DP_SETUP:
                return "SETUP";
        case TD_DP_IN:
                return "IN";
        case TD_DP_OUT:
                return "OUT";
        }
        return "?PID";
}

static inline char *td_togglestring(u32 info)
{
        switch (info & TD_T) {
        case TD_T_DATA0:
                return "DATA0";
        case TD_T_DATA1:
                return "DATA1";
        case TD_T_CARRY:
                return "CARRY";
        }
        return "?TOGGLE";
}

/*-------------------------------------------------------------------------*/

#ifdef DEBUG

/* debug| print the main components of an URB
 * small: 0) header + data packets 1) just header
 */
static void __attribute__((unused))
urb_print(struct admhcd *ahcd, struct urb *urb, char *str, int small, int status)
{
        unsigned int pipe = urb->pipe;

        if (!urb->dev || !urb->dev->bus) {
                admhc_dbg(ahcd, "%s URB: no dev", str);
                return;
        }

#ifndef ADMHC_VERBOSE_DEBUG
        if (status != 0)
#endif
        admhc_dbg(ahcd, "URB-%s %p dev=%d ep=%d%s-%s flags=%x len=%d/%d "
                        "stat=%d\n",
                        str,
                        urb,
                        usb_pipedevice(pipe),
                        usb_pipeendpoint(pipe),
                        usb_pipeout(pipe) ? "out" : "in",
                        pipestring(pipe),
                        urb->transfer_flags,
                        urb->actual_length,
                        urb->transfer_buffer_length,
                        status);

#ifdef  ADMHC_VERBOSE_DEBUG
        if (!small) {
                int i, len;

                if (usb_pipecontrol(pipe)) {
                        admhc_dbg(ahcd, "setup(8):");
                        for (i = 0; i < 8 ; i++)
                                printk(KERN_INFO" %02x", ((__u8 *)urb->setup_packet)[i]);
                        printk(KERN_INFO "\n");
                }
                if (urb->transfer_buffer_length > 0 && urb->transfer_buffer) {
                        admhc_dbg(ahcd, "data(%d/%d):",
                                urb->actual_length,
                                urb->transfer_buffer_length);
                        len = usb_pipeout(pipe) ?
                                                urb->transfer_buffer_length : urb->actual_length;
                        for (i = 0; i < 16 && i < len; i++)
                                printk(KERN_INFO " %02x", ((__u8 *)urb->transfer_buffer)[i]);
                        printk(KERN_INFO "%s stat:%d\n", i < len ? "..." : "", status);
                }
        }
#endif /* ADMHC_VERBOSE_DEBUG */
}

#define admhc_dbg_sw(ahcd, next, size, format, arg...) \
        do { \
                if (next) { \
                        unsigned s_len; \
                        s_len = scnprintf(*next, *size, format, ## arg); \
                        *size -= s_len; *next += s_len; \
                } else \
                        admhc_dbg(ahcd, format, ## arg); \
        } while (0);


static void admhc_dump_intr_mask(struct admhcd *ahcd, char *label, u32 mask,
                char **next, unsigned *size)
{
        admhc_dbg_sw(ahcd, next, size, "%s 0x%08x%s%s%s%s%s%s%s%s%s%s%s%s\n",
                label,
                mask,
                (mask & ADMHC_INTR_INTA) ? " INTA" : "",
                (mask & ADMHC_INTR_FATI) ? " FATI" : "",
                (mask & ADMHC_INTR_SWI) ? " SWI" : "",
                (mask & ADMHC_INTR_TDC) ? " TDC" : "",
                (mask & ADMHC_INTR_FNO) ? " FNO" : "",
                (mask & ADMHC_INTR_SO) ? " SO" : "",
                (mask & ADMHC_INTR_INSM) ? " INSM" : "",
                (mask & ADMHC_INTR_BABI) ? " BABI" : "",
                (mask & ADMHC_INTR_7) ? " !7!" : "",
                (mask & ADMHC_INTR_6) ? " !6!" : "",
                (mask & ADMHC_INTR_RESI) ? " RESI" : "",
                (mask & ADMHC_INTR_SOFI) ? " SOFI" : ""
                );
}

static void maybe_print_eds(struct admhcd *ahcd, char *label, u32 value,
                char **next, unsigned *size)
{
        if (value)
                admhc_dbg_sw(ahcd, next, size, "%s %08x\n", label, value);
}

static char *buss2string(int state)
{
        switch (state) {
        case ADMHC_BUSS_RESET:
                return "reset";
        case ADMHC_BUSS_RESUME:
                return "resume";
        case ADMHC_BUSS_OPER:
                return "operational";
        case ADMHC_BUSS_SUSPEND:
                return "suspend";
        }
        return "?state";
}

static void
admhc_dump_status(struct admhcd *ahcd, char **next, unsigned *size)
{
        struct admhcd_regs __iomem *regs = ahcd->regs;
        u32                     temp;

        temp = admhc_readl(ahcd, &regs->gencontrol);
        admhc_dbg_sw(ahcd, next, size,
                "gencontrol 0x%08x%s%s%s%s\n",
                temp,
                (temp & ADMHC_CTRL_UHFE) ? " UHFE" : "",
                (temp & ADMHC_CTRL_SIR) ? " SIR" : "",
                (temp & ADMHC_CTRL_DMAA) ? " DMAA" : "",
                (temp & ADMHC_CTRL_SR) ? " SR" : ""
                );

        temp = admhc_readl(ahcd, &regs->host_control);
        admhc_dbg_sw(ahcd, next, size,
                "host_control 0x%08x BUSS=%s%s\n",
                temp,
                buss2string(temp & ADMHC_HC_BUSS),
                (temp & ADMHC_HC_DMAE) ? " DMAE" : ""
                );

        admhc_dump_intr_mask(ahcd, "int_status",
                        admhc_readl(ahcd, &regs->int_status),
                        next, size);
        admhc_dump_intr_mask(ahcd, "int_enable",
                        admhc_readl(ahcd, &regs->int_enable),
                        next, size);

        maybe_print_eds(ahcd, "hosthead",
                        admhc_readl(ahcd, &regs->hosthead), next, size);
}

#define dbg_port_sw(hc, num, value, next, size) \
        admhc_dbg_sw(hc, next, size, \
                "portstatus [%d] " \
                "0x%08x%s%s%s%s%s%s%s%s%s%s%s%s\n", \
                num, temp, \
                (temp & ADMHC_PS_PRSC) ? " PRSC" : "", \
                (temp & ADMHC_PS_OCIC) ? " OCIC" : "", \
                (temp & ADMHC_PS_PSSC) ? " PSSC" : "", \
                (temp & ADMHC_PS_PESC) ? " PESC" : "", \
                (temp & ADMHC_PS_CSC) ? " CSC" : "", \
                \
                (temp & ADMHC_PS_LSDA) ? " LSDA" : "", \
                (temp & ADMHC_PS_PPS) ? " PPS" : "", \
                (temp & ADMHC_PS_PRS) ? " PRS" : "", \
                (temp & ADMHC_PS_POCI) ? " POCI" : "", \
                (temp & ADMHC_PS_PSS) ? " PSS" : "", \
                \
                (temp & ADMHC_PS_PES) ? " PES" : "", \
                (temp & ADMHC_PS_CCS) ? " CCS" : "" \
                );


static void
admhc_dump_roothub(
        struct admhcd *ahcd,
        int verbose,
        char **next,
        unsigned *size)
{
        u32                     temp, i;

        temp = admhc_read_rhdesc(ahcd);
        if (temp == ~(u32)0)
                return;

        if (verbose) {
                admhc_dbg_sw(ahcd, next, size,
                        "rhdesc %08x%s%s%s%s%s%s PPCM=%02x%s%s%s%s NUMP=%d(%d)\n",
                        temp,
                        (temp & ADMHC_RH_CRWE) ? " CRWE" : "",
                        (temp & ADMHC_RH_OCIC) ? " OCIC" : "",
                        (temp & ADMHC_RH_LPSC) ? " LPSC" : "",
                        (temp & ADMHC_RH_LPSC) ? " DRWE" : "",
                        (temp & ADMHC_RH_LPSC) ? " OCI" : "",
                        (temp & ADMHC_RH_LPSC) ? " LPS" : "",
                        ((temp & ADMHC_RH_PPCM) >> 16),
                        (temp & ADMHC_RH_NOCP) ? " NOCP" : "",
                        (temp & ADMHC_RH_OCPM) ? " OCPM" : "",
                        (temp & ADMHC_RH_NPS) ? " NPS" : "",
                        (temp & ADMHC_RH_PSM) ? " PSM" : "",
                        (temp & ADMHC_RH_NUMP), ahcd->num_ports
                        );
        }

        for (i = 0; i < ahcd->num_ports; i++) {
                temp = admhc_read_portstatus(ahcd, i);
                dbg_port_sw(ahcd, i, temp, next, size);
        }
}

static void admhc_dump(struct admhcd *ahcd, int verbose)
{
        admhc_dbg(ahcd, "ADMHC ahcd state\n");

        /* dumps some of the state we know about */
        admhc_dump_status(ahcd, NULL, NULL);
        admhc_dbg(ahcd, "current frame #%04x\n",
                admhc_frame_no(ahcd));

        admhc_dump_roothub(ahcd, verbose, NULL, NULL);
}

static const char data0[] = "DATA0";
static const char data1[] = "DATA1";

static void admhc_dump_td(const struct admhcd *ahcd, const char *label,
                const struct td *td)
{
        u32     tmp;

        admhc_dbg(ahcd, "%s td %p; urb %p index %d; hwNextTD %08x\n",
                label, td,
                td->urb, td->index,
                hc32_to_cpup(ahcd, &td->hwNextTD));

        tmp = hc32_to_cpup(ahcd, &td->hwINFO);
        admhc_dbg(ahcd, "     status %08x%s CC=%x EC=%d %s %s ISI=%x FN=%x\n",
                tmp,
                (tmp & TD_OWN) ? " OWN" : "",
                TD_CC_GET(tmp),
                TD_EC_GET(tmp),
                td_togglestring(tmp),
                td_pidstring(tmp),
                TD_ISI_GET(tmp),
                TD_FN_GET(tmp));

        tmp = hc32_to_cpup(ahcd, &td->hwCBL);
        admhc_dbg(ahcd, "     dbp %08x; cbl %08x; LEN=%d%s\n",
                hc32_to_cpup(ahcd, &td->hwDBP),
                tmp,
                TD_BL_GET(tmp),
                (tmp & TD_IE) ? " IE" : "");
}

/* caller MUST own hcd spinlock if verbose is set! */
static void __attribute__((unused))
admhc_dump_ed(const struct admhcd *ahcd, const char *label,
                const struct ed *ed, int verbose)
{
        u32 tmp = hc32_to_cpu(ahcd, ed->hwINFO);

        admhc_dbg(ahcd, "%s ed %p %s type %s; next ed %08x\n",
                label,
                ed, ed_statestring(ed->state), ed_typestring(ed->type),
                hc32_to_cpup(ahcd, &ed->hwNextED));

        admhc_dbg(ahcd, "  info %08x MAX=%d%s%s%s%s EP=%d DEV=%d\n", tmp,
                ED_MPS_GET(tmp),
                (tmp & ED_ISO) ? " ISO" : "",
                (tmp & ED_SKIP) ? " SKIP" : "",
                (tmp & ED_SPEED_FULL) ? " FULL" : " LOW",
                (tmp & ED_INT) ? " INT" : "",
                ED_EN_GET(tmp),
                ED_FA_GET(tmp));

        tmp = hc32_to_cpup(ahcd, &ed->hwHeadP);
        admhc_dbg(ahcd, "  tds: head %08x tail %08x %s%s%s\n",
                tmp & TD_MASK,
                hc32_to_cpup(ahcd, &ed->hwTailP),
                (tmp & ED_C) ? data1 : data0,
                (tmp & ED_H) ? " HALT" : "",
                verbose ? " td list follows" : " (not listing)");

        if (verbose) {
                struct list_head        *tmp;

                /* use ed->td_list because HC concurrently modifies
                 * hwNextTD as it accumulates ed_donelist.
                 */
                list_for_each(tmp, &ed->td_list) {
                        struct td               *td;
                        td = list_entry(tmp, struct td, td_list);
                        admhc_dump_td(ahcd, "  ->", td);
                }
        }
}

#else /* ifdef DEBUG */

static inline void urb_print(struct admhcd *ahcd, struct urb * urb, char * str,
        int small, int status) {}
static inline void admhc_dump_ed(const struct admhcd *ahcd, const char *label,
        const struct ed *ed, int verbose) {}
static inline void admhc_dump_td(const struct admhcd *ahcd, const char *label,
        const struct td *td) {}
static inline void admhc_dump(struct admhcd *ahcd, int verbose) {}

#undef ADMHC_VERBOSE_DEBUG

#endif /* DEBUG */

/*-------------------------------------------------------------------------*/

#ifdef STUB_DEBUG_FILES

static inline void create_debug_files(struct admhcd *bus) { }
static inline void remove_debug_files(struct admhcd *bus) { }

#else

static int debug_async_open(struct inode *, struct file *);
static int debug_periodic_open(struct inode *, struct file *);
static int debug_registers_open(struct inode *, struct file *);
static ssize_t debug_output(struct file*, char __user*, size_t, loff_t*);
static int debug_close(struct inode *, struct file *);

static const struct file_operations debug_async_fops = {
        .owner          = THIS_MODULE,
        .open           = debug_async_open,
        .read           = debug_output,
        .release        = debug_close,
        .llseek         = default_llseek,
};
static const struct file_operations debug_periodic_fops = {
        .owner          = THIS_MODULE,
        .open           = debug_periodic_open,
        .read           = debug_output,
        .release        = debug_close,
        .llseek         = default_llseek,
};
static const struct file_operations debug_registers_fops = {
        .owner          = THIS_MODULE,
        .open           = debug_registers_open,
        .read           = debug_output,
        .release        = debug_close,
        .llseek         = default_llseek,
};

static struct dentry *admhc_debug_root;

struct debug_buffer {
        ssize_t (*fill_func)(struct debug_buffer *);    /* fill method */
        struct admhcd *ahcd;
        struct mutex mutex;     /* protect filling of buffer */
        size_t count;           /* number of characters filled into buffer */
        char *page;
};

static ssize_t
show_list(struct admhcd *ahcd, char *buf, size_t count, struct ed *ed)
{
        unsigned temp;
        unsigned size = count;

        if (!ed)
                return 0;

        /* dump a snapshot of the bulk or control schedule */
        while (ed) {
                u32 info = hc32_to_cpu(ahcd, ed->hwINFO);
                u32 headp = hc32_to_cpu(ahcd, ed->hwHeadP);
                u32 tailp = hc32_to_cpu(ahcd, ed->hwTailP);
                struct list_head *entry;
                struct td       *td;

                temp = scnprintf(buf, size,
                        "ed/%p %s %s %cs dev%d ep%d %s%smax %d %08x%s%s %s"
                        " h:%08x t:%08x",
                        ed,
                        ed_statestring(ed->state),
                        ed_typestring(ed->type),
                        (info & ED_SPEED_FULL) ? 'f' : 'l',
                        info & ED_FA_MASK,
                        (info >> ED_EN_SHIFT) & ED_EN_MASK,
                        (info & ED_INT) ? "INT " : "",
                        (info & ED_ISO) ? "ISO " : "",
                        (info >> ED_MPS_SHIFT) & ED_MPS_MASK ,
                        info,
                        (info & ED_SKIP) ? " S" : "",
                        (headp & ED_H) ? " H" : "",
                        (headp & ED_C) ? data1 : data0,
                        headp & ED_MASK, tailp);
                size -= temp;
                buf += temp;

                list_for_each(entry, &ed->td_list) {
                        u32             dbp, cbl;

                        td = list_entry(entry, struct td, td_list);
                        info = hc32_to_cpup(ahcd, &td->hwINFO);
                        dbp = hc32_to_cpup(ahcd, &td->hwDBP);
                        cbl = hc32_to_cpup(ahcd, &td->hwCBL);

                        temp = scnprintf(buf, size,
                                "\n\ttd/%p %s %d %s%scc=%x urb %p (%08x,%08x)",
                                td,
                                td_pidstring(info),
                                TD_BL_GET(cbl),
                                (info & TD_OWN) ? "" : "DONE ",
                                (cbl & TD_IE) ? "IE " : "",
                                TD_CC_GET(info), td->urb, info, cbl);
                        size -= temp;
                        buf += temp;
                }

                temp = scnprintf(buf, size, "\n");
                size -= temp;
                buf += temp;

                ed = ed->ed_next;
        }

        return count - size;
}

static ssize_t fill_async_buffer(struct debug_buffer *buf)
{
        struct admhcd           *ahcd;
        size_t                  temp;
        unsigned long           flags;

        ahcd = buf->ahcd;

        spin_lock_irqsave(&ahcd->lock, flags);
        temp = show_list(ahcd, buf->page, PAGE_SIZE, ahcd->ed_head);
        spin_unlock_irqrestore(&ahcd->lock, flags);

        return temp;
}


#define DBG_SCHED_LIMIT 64

static ssize_t fill_periodic_buffer(struct debug_buffer *buf)
{
        struct admhcd           *ahcd;
        struct ed               **seen, *ed;
        unsigned long           flags;
        unsigned                temp, size, seen_count;
        char                    *next;
        unsigned                i;

        seen = kmalloc(DBG_SCHED_LIMIT * sizeof(*seen), GFP_ATOMIC);
        if (!seen)
                return 0;
        seen_count = 0;

        ahcd = buf->ahcd;
        next = buf->page;
        size = PAGE_SIZE;

        temp = scnprintf(next, size, "size = %d\n", NUM_INTS);
        size -= temp;
        next += temp;

        /* dump a snapshot of the periodic schedule (and load) */
        spin_lock_irqsave(&ahcd->lock, flags);
        for (i = 0; i < NUM_INTS; i++) {
                ed = ahcd->periodic[i];
                if (!ed)
                        continue;

                temp = scnprintf(next, size, "%2d [%3d]:", i, ahcd->load[i]);
                size -= temp;
                next += temp;

                do {
                        temp = scnprintf(next, size, " ed%d/%p",
                                ed->interval, ed);
                        size -= temp;
                        next += temp;
                        for (temp = 0; temp < seen_count; temp++) {
                                if (seen[temp] == ed)
                                        break;
                        }

                        /* show more info the first time around */
                        if (temp == seen_count) {
                                u32     info = hc32_to_cpu(ahcd, ed->hwINFO);
                                struct list_head        *entry;
                                unsigned                qlen = 0;

                                /* qlen measured here in TDs, not urbs */
                                list_for_each(entry, &ed->td_list)
                                        qlen++;
                                temp = scnprintf(next, size,
                                        " (%cs dev%d ep%d%s qlen %u"
                                        " max %d %08x%s%s)",
                                        (info & ED_SPEED_FULL) ? 'f' : 'l',
                                        ED_FA_GET(info),
                                        ED_EN_GET(info),
                                        (info & ED_ISO) ? "iso" : "int",
                                        qlen,
                                        ED_MPS_GET(info),
                                        info,
                                        (info & ED_SKIP) ? " K" : "",
                                        (ed->hwHeadP &
                                                cpu_to_hc32(ahcd, ED_H)) ?
                                                        " H" : "");
                                size -= temp;
                                next += temp;

                                if (seen_count < DBG_SCHED_LIMIT)
                                        seen[seen_count++] = ed;

                                ed = ed->ed_next;

                        } else {
                                /* we've seen it and what's after */
                                temp = 0;
                                ed = NULL;
                        }

                } while (ed);

                temp = scnprintf(next, size, "\n");
                size -= temp;
                next += temp;
        }
        spin_unlock_irqrestore(&ahcd->lock, flags);
        kfree(seen);

        return PAGE_SIZE - size;
}


#undef DBG_SCHED_LIMIT

static ssize_t fill_registers_buffer(struct debug_buffer *buf)
{
        struct usb_hcd          *hcd;
        struct admhcd           *ahcd;
        struct admhcd_regs __iomem *regs;
        unsigned long           flags;
        unsigned                temp, size;
        char                    *next;
        u32                     rdata;

        ahcd = buf->ahcd;
        hcd = admhc_to_hcd(ahcd);
        regs = ahcd->regs;
        next = buf->page;
        size = PAGE_SIZE;

        spin_lock_irqsave(&ahcd->lock, flags);

        /* dump driver info, then registers in spec order */

        admhc_dbg_sw(ahcd, &next, &size,
                "bus %s, device %s\n"
                "%s\n"
                "%s\n",
                hcd->self.controller->bus->name,
                dev_name(hcd->self.controller),
                hcd->product_desc,
                hcd_name);

        if (!HCD_HW_ACCESSIBLE(hcd)) {
                size -= scnprintf(next, size,
                        "SUSPENDED (no register access)\n");
                goto done;
        }

        admhc_dump_status(ahcd, &next, &size);

        /* other registers mostly affect frame timings */
        rdata = admhc_readl(ahcd, &regs->fminterval);
        temp = scnprintf(next, size,
                        "fmintvl 0x%08x %sFSLDP=0x%04x FI=0x%04x\n",
                        rdata, (rdata & ADMHC_SFI_FIT) ? "FIT " : "",
                        (rdata >> ADMHC_SFI_FSLDP_SHIFT) & ADMHC_SFI_FSLDP_MASK,
                        rdata  & ADMHC_SFI_FI_MASK);
        size -= temp;
        next += temp;

        rdata = admhc_readl(ahcd, &regs->fmnumber);
        temp = scnprintf(next, size, "fmnumber 0x%08x %sFR=0x%04x FN=%04x\n",
                        rdata, (rdata & ADMHC_SFN_FRT) ? "FRT " : "",
                        (rdata >> ADMHC_SFN_FR_SHIFT) & ADMHC_SFN_FR_MASK,
                        rdata  & ADMHC_SFN_FN_MASK);
        size -= temp;
        next += temp;

        /* TODO: use predefined bitmask */
        rdata = admhc_readl(ahcd, &regs->lsthresh);
        temp = scnprintf(next, size, "lsthresh 0x%04x\n",
                        rdata & 0x3fff);
        size -= temp;
        next += temp;

        temp = scnprintf(next, size, "hub poll timer: %s\n",
                        admhcd_to_hcd(ahcd)->poll_rh ? "ON" : "OFF");
        size -= temp;
        next += temp;

        /* roothub */
        admhc_dump_roothub(ahcd, 1, &next, &size);

done:
        spin_unlock_irqrestore(&ahcd->lock, flags);
        return PAGE_SIZE - size;
}


static struct debug_buffer *alloc_buffer(struct admhcd *ahcd,
                                ssize_t (*fill_func)(struct debug_buffer *))
{
        struct debug_buffer *buf;

        buf = kzalloc(sizeof(struct debug_buffer), GFP_KERNEL);

        if (buf) {
                buf->ahcd = ahcd;
                buf->fill_func = fill_func;
                mutex_init(&buf->mutex);
        }

        return buf;
}

static int fill_buffer(struct debug_buffer *buf)
{
        int ret = 0;

        if (!buf->page)
                buf->page = (char *)get_zeroed_page(GFP_KERNEL);

        if (!buf->page) {
                ret = -ENOMEM;
                goto out;
        }

        ret = buf->fill_func(buf);

        if (ret >= 0) {
                buf->count = ret;
                ret = 0;
        }

out:
        return ret;
}

static ssize_t debug_output(struct file *file, char __user *user_buf,
                        size_t len, loff_t *offset)
{
        struct debug_buffer *buf = file->private_data;
        int ret = 0;

        mutex_lock(&buf->mutex);
        if (buf->count == 0) {
                ret = fill_buffer(buf);
                if (ret != 0) {
                        mutex_unlock(&buf->mutex);
                        goto out;
                }
        }
        mutex_unlock(&buf->mutex);

        ret = simple_read_from_buffer(user_buf, len, offset,
                                        buf->page, buf->count);

out:
        return ret;
}

static int debug_close(struct inode *inode, struct file *file)
{
        struct debug_buffer *buf = file->private_data;

        if (buf) {
                if (buf->page)
                        free_page((unsigned long)buf->page);
                kfree(buf);
        }

        return 0;
}

static int debug_async_open(struct inode *inode, struct file *file)
{
        file->private_data = alloc_buffer(inode->i_private, fill_async_buffer);

        return file->private_data ? 0 : -ENOMEM;
}

static int debug_periodic_open(struct inode *inode, struct file *file)
{
        file->private_data = alloc_buffer(inode->i_private,
                                                fill_periodic_buffer);

        return file->private_data ? 0 : -ENOMEM;
}

static int debug_registers_open(struct inode *inode, struct file *file)
{
        file->private_data = alloc_buffer(inode->i_private,
                                                fill_registers_buffer);

        return file->private_data ? 0 : -ENOMEM;
}

static inline void create_debug_files(struct admhcd *ahcd)
{
        struct usb_bus *bus = &admhcd_to_hcd(ahcd)->self;

        ahcd->debug_dir = debugfs_create_dir(bus->bus_name, admhc_debug_root);
        if (!ahcd->debug_dir)
                goto dir_error;

        ahcd->debug_async = debugfs_create_file("async", S_IRUGO,
                                                ahcd->debug_dir, ahcd,
                                                &debug_async_fops);
        if (!ahcd->debug_async)
                goto async_error;

        ahcd->debug_periodic = debugfs_create_file("periodic", S_IRUGO,
                                                ahcd->debug_dir, ahcd,
                                                &debug_periodic_fops);
        if (!ahcd->debug_periodic)
                goto periodic_error;

        ahcd->debug_registers = debugfs_create_file("registers", S_IRUGO,
                                                ahcd->debug_dir, ahcd,
                                                &debug_registers_fops);
        if (!ahcd->debug_registers)
                goto registers_error;

        admhc_dbg(ahcd, "created debug files\n");
        return;

registers_error:
        debugfs_remove(ahcd->debug_periodic);
periodic_error:
        debugfs_remove(ahcd->debug_async);
async_error:
        debugfs_remove(ahcd->debug_dir);
dir_error:
        ahcd->debug_periodic = NULL;
        ahcd->debug_async = NULL;
        ahcd->debug_dir = NULL;
}

static inline void remove_debug_files(struct admhcd *ahcd)
{
        debugfs_remove(ahcd->debug_registers);
        debugfs_remove(ahcd->debug_periodic);
        debugfs_remove(ahcd->debug_async);
        debugfs_remove(ahcd->debug_dir);
}

#endif

/*-------------------------------------------------------------------------*/