1 /* $FreeBSD: releng/12.2/sys/dev/usb/usb_debug.h 326255 2017-11-27 14:52:40Z pfg $ */ 2 /*- 3 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD 4 * 5 * Copyright (c) 2008 Hans Petter Selasky. All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 */ 28 29 /* This file contains various factored out debug macros. */ 30 31 #ifndef _USB_DEBUG_H_ 32 #define _USB_DEBUG_H_ 33 34 /* Declare global USB debug variable. */ 35 extern int usb_debug; 36 37 /* Check if USB debugging is enabled. */ 38 #ifdef USB_DEBUG_VAR 39 #ifdef LOSCFG_USB_DEBUG 40 #define DPRINTFN(n,fmt,...) do { \ 41 if ((USB_DEBUG_VAR) >= (n)) { \ 42 PRINTK("%s: " fmt, \ 43 __FUNCTION__ ,##__VA_ARGS__); \ 44 } \ 45 } while (0) 46 #define DPRINTF(...) DPRINTFN(1, __VA_ARGS__) 47 #else 48 #define DPRINTF(...) do { } while (0) 49 #define DPRINTFN(...) do { } while (0) 50 #endif 51 /* usb_debug shell command supports the following modules print level control */ 52 /* 53 * composite, about composite.c 54 * dwc_pcd, about dwc_otg_pcd.c 55 * dwc_intr, about dwc_ptg_pcd_intr.c 56 * ehci, about ehci.c 57 * fmass, about f_mass_storage.c 58 * axe, about if_axe.c 59 * cdce, about if_cdce.c 60 * urndis, about if_urndis.c 61 * u3g, about u3g.c 62 * umass, about umass.c 63 * controller, about usb_controller.c 64 * uhub, about usb_hub.c 65 * process, about usb_process.c 66 * serial, about usb_serial.c 67 * other, about bsd_kernel.c/linux_usb.c/usb_device.c/usb_request.c/usb_transfer.c 68 */ 69 70 /* For example: usb_debug modules level */ 71 #endif 72 73 struct usb_interface; 74 struct usb_device; 75 struct usb_endpoint; 76 struct usb_xfer; 77 78 void usb_dump_iface(struct usb_interface *iface); 79 void usb_dump_device(struct usb_device *udev); 80 void usb_dump_queue(struct usb_endpoint *ep); 81 void usb_dump_endpoint(struct usb_endpoint *ep); 82 void usb_dump_xfer(struct usb_xfer *xfer); 83 84 #ifdef LOSCFG_USB_DEBUG 85 extern unsigned int usb_port_reset_delay; 86 extern unsigned int usb_port_root_reset_delay; 87 extern unsigned int usb_port_reset_recovery; 88 extern unsigned int usb_port_powerup_delay; 89 extern unsigned int usb_port_resume_delay; 90 extern unsigned int usb_set_address_settle; 91 extern unsigned int usb_resume_delay; 92 extern unsigned int usb_resume_wait; 93 extern unsigned int usb_resume_recovery; 94 extern unsigned int usb_extra_power_up_time; 95 #else 96 #define usb_port_reset_delay USB_PORT_RESET_DELAY 97 #define usb_port_root_reset_delay USB_PORT_ROOT_RESET_DELAY 98 #define usb_port_reset_recovery USB_PORT_RESET_RECOVERY 99 #define usb_port_powerup_delay USB_PORT_POWERUP_DELAY 100 #define usb_port_resume_delay USB_PORT_RESUME_DELAY 101 #define usb_set_address_settle USB_SET_ADDRESS_SETTLE 102 #define usb_resume_delay USB_RESUME_DELAY 103 #define usb_resume_wait USB_RESUME_WAIT 104 #define usb_resume_recovery USB_RESUME_RECOVERY 105 #define usb_extra_power_up_time USB_EXTRA_POWER_UP_TIME 106 #endif 107 108 #endif /* _USB_DEBUG_H_ */ 109