/* * ADM5120 HCD (Host Controller Driver) for USB * * Copyright (C) 2007-2008 Gabor Juhos * * This file was derived from: drivers/usb/host/ohci-dbg.c * (C) Copyright 1999 Roman Weissgaerber * (C) Copyright 2000-2002 David Brownell * * 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, ®s->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, ®s->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, ®s->int_status), next, size); admhc_dump_intr_mask(ahcd, "int_enable", admhc_readl(ahcd, ®s->int_enable), next, size); maybe_print_eds(ahcd, "hosthead", admhc_readl(ahcd, ®s->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, ®s->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, ®s->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, ®s->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 /*-------------------------------------------------------------------------*/