/****************************************************************************
 * include/nuttx/usb/usbdev_trace.h
 *
 *   Copyright (C) 2008, 2009-2010, 2012-2013, 2017 Gregory Nutt. All rights reserved.
 *   Author: Gregory Nutt <gnutt@nuttx.org>
 *
 * 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. Neither the name NuttX nor the names of its contributors may be
 *    used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS 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
 * COPYRIGHT OWNER 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 __INCLUDE_NUTTX_USB_USBDEV_TRACE_H
#define __INCLUDE_NUTTX_USB_USBDEV_TRACE_H

/****************************************************************************
 * Included Files
 ****************************************************************************/

#include <nuttx/config.h>

#include <stdint.h>

/****************************************************************************
 * Preprocessor definitions
 ****************************************************************************/

/* Event encoding/decoding macros *******************************************/

#define TRACE_EVENT(id,data)     ((uint16_t)(id) | (data))
#define TRACE_ID(event)          ((event) & 0xff00)
#define TRACE_DATA(event)        ((event) & 0x00ff)

/* Events ******************************************************************/

/* Event class IDs */

#define TRACE_INIT_ID            (0x0000) /* Initialization events */
#define TRACE_EP_ID              (0x0100) /* Endpoint API calls */
#define TRACE_DEV_ID             (0x0200) /* USB device API calls */
#define TRACE_CLASS_ID           (0x0300) /* USB class driver API calls */
#define TRACE_CLASSAPI_ID        (0x0400) /* Other class driver system API calls */
#define TRACE_CLASSSTATE_ID      (0x0500) /* Track class driver state changes */
#define TRACE_INTENTRY_ID        (0x0600) /* Interrupt handler entry */
#define TRACE_INTDECODE_ID       (0x0700) /* Decoded interrupt event */
#define TRACE_INTEXIT_ID         (0x0800) /* Interrupt handler exit */
#define TRACE_OUTREQQUEUED_ID    (0x0900) /* Request queued for OUT endpoint */
#define TRACE_INREQQUEUED_ID     (0x0a00) /* Request queued for IN endpoint */
#define TRACE_READ_ID            (0x0b00) /* Read (OUT) action */
#define TRACE_WRITE_ID           (0x0c00) /* Write (IN) action */
#define TRACE_COMPLETE_ID        (0x0d00) /* Request completed */
#define TRACE_DEVERROR_ID        (0x0e00) /* USB controller driver error event */
#define TRACE_CLSERROR_ID        (0x0f00) /* USB class driver error event */

#define TRACE_NIDS               16       /* Cannot exceed bits in usbtrace_idset_t */

/* Bit settings for usbtrace_enable */

#define TRACE_ID2BIT(id)         ((1) << ((id) >> 8))
#define TRACE_INIT_BIT           TRACE_ID2BIT(TRACE_INIT_ID)
#define TRACE_EP_BIT             TRACE_ID2BIT(TRACE_EP_ID)
#define TRACE_DEV_BIT            TRACE_ID2BIT(TRACE_DEV_ID)
#define TRACE_CLASS_BIT          TRACE_ID2BIT(TRACE_CLASS_ID)
#define TRACE_CLASSAPI_BIT       TRACE_ID2BIT(TRACE_CLASSAPI_ID)
#define TRACE_CLASSSTATE_BIT     TRACE_ID2BIT(TRACE_CLASSSTATE_ID)
#define TRACE_INTENTRY_BIT       TRACE_ID2BIT(TRACE_INTENTRY_ID)
#define TRACE_INTDECODE_BIT      TRACE_ID2BIT(TRACE_INTDECODE_ID)
#define TRACE_INTEXIT_BIT        TRACE_ID2BIT(TRACE_INTEXIT_ID)
#define TRACE_OUTREQQUEUED_BIT   TRACE_ID2BIT(TRACE_OUTREQQUEUED_ID)
#define TRACE_INREQQUEUED_BIT    TRACE_ID2BIT(TRACE_INREQQUEUED_ID)
#define TRACE_READ_BIT           TRACE_ID2BIT(TRACE_READ_ID)
#define TRACE_WRITE_BIT          TRACE_ID2BIT(TRACE_WRITE_ID)
#define TRACE_COMPLETE_BIT       TRACE_ID2BIT(TRACE_COMPLETE_ID)
#define TRACE_DEVERROR_BIT       TRACE_ID2BIT(TRACE_DEVERROR_ID)
#define TRACE_CLSERROR_BIT       TRACE_ID2BIT(TRACE_CLSERROR_ID)
#define TRACE_ALLBITS            ((usbtrace_idset_t)-1)

/* Initialization events */

#define TRACE_DEVINIT            TRACE_EVENT(TRACE_INIT_ID, 0x0001)
#define TRACE_DEVUNINIT          TRACE_EVENT(TRACE_INIT_ID, 0x0002)
#define TRACE_DEVREGISTER        TRACE_EVENT(TRACE_INIT_ID, 0x0003)
#define TRACE_DEVUNREGISTER      TRACE_EVENT(TRACE_INIT_ID, 0x0004)
#define TRACE_DEVINIT_USER       TRACE_EVENT(TRACE_INIT_ID, 0x0005) /* First user-defined */

/* API calls (see usbdev.h) */

#define TRACE_EPCONFIGURE        TRACE_EVENT(TRACE_EP_ID, 0x0001)
#define TRACE_EPDISABLE          TRACE_EVENT(TRACE_EP_ID, 0x0002)
#define TRACE_EPALLOCREQ         TRACE_EVENT(TRACE_EP_ID, 0x0003)
#define TRACE_EPFREEREQ          TRACE_EVENT(TRACE_EP_ID, 0x0004)
#define TRACE_EPALLOCBUFFER      TRACE_EVENT(TRACE_EP_ID, 0x0005)
#define TRACE_EPFREEBUFFER       TRACE_EVENT(TRACE_EP_ID, 0x0006)
#define TRACE_EPSUBMIT           TRACE_EVENT(TRACE_EP_ID, 0x0007)
#define TRACE_EPCANCEL           TRACE_EVENT(TRACE_EP_ID, 0x0008)
#define TRACE_EPSTALL            TRACE_EVENT(TRACE_EP_ID, 0x0009)
#define TRACE_EPRESUME           TRACE_EVENT(TRACE_EP_ID, 0x000a)
#define TRACE_EPAPI_USER         TRACE_EVENT(TRACE_EP_ID, 0x000b) /* First user-defined */

#define TRACE_DEVALLOCEP         TRACE_EVENT(TRACE_DEV_ID, 0x0001)
#define TRACE_DEVFREEEP          TRACE_EVENT(TRACE_DEV_ID, 0x0002)
#define TRACE_DEVGETFRAME        TRACE_EVENT(TRACE_DEV_ID, 0x0003)
#define TRACE_DEVWAKEUP          TRACE_EVENT(TRACE_DEV_ID, 0x0004)
#define TRACE_DEVSELFPOWERED     TRACE_EVENT(TRACE_DEV_ID, 0x0005)
#define TRACE_DEVPULLUP          TRACE_EVENT(TRACE_DEV_ID, 0x0006)
#define TRACE_DEVAPI_USER        TRACE_EVENT(TRACE_DEV_ID, 0x0007) /* First user-defined */

#define TRACE_CLASSBIND          TRACE_EVENT(TRACE_CLASS_ID, 0x0001)
#define TRACE_CLASSUNBIND        TRACE_EVENT(TRACE_CLASS_ID, 0x0002)
#define TRACE_CLASSDISCONNECT    TRACE_EVENT(TRACE_CLASS_ID, 0x0003)
#define TRACE_CLASSSETUP         TRACE_EVENT(TRACE_CLASS_ID, 0x0004)
#define TRACE_CLASSSUSPEND       TRACE_EVENT(TRACE_CLASS_ID, 0x0005)
#define TRACE_CLASSRESUME        TRACE_EVENT(TRACE_CLASS_ID, 0x0006)

#define TRACE_CLASSRDCOMPLETE    TRACE_EVENT(TRACE_CLASS_ID, 0x0007)
#define TRACE_CLASSWRCOMPLETE    TRACE_EVENT(TRACE_CLASS_ID, 0x0008)

#define TRACE_CLASSAPI_USER      TRACE_EVENT(TRACE_CLASS_ID, 0x0009) /* First user-defined */

#define TRACE_CLASSAPI(id)       TRACE_EVENT(TRACE_CLASSAPI_ID, id)

#define TRACE_CLASSSTATE(id)     TRACE_EVENT(TRACE_CLASSSTATE_ID, id)

/* USB device controller interrupt events.  The 'id' is specific to the driver.
 * Particular values for 'id' are unique for a given implementation of a
 * controller driver
 */

#define TRACE_INTENTRY(id)       TRACE_EVENT(TRACE_INTENTRY_ID, id)
#define TRACE_INTDECODE(id)      TRACE_EVENT(TRACE_INTDECODE_ID, id)
#define TRACE_INTEXIT(id)        TRACE_EVENT(TRACE_INTEXIT_ID, id)

/* Controller data transfer */

#define TRACE_OUTREQQUEUED(ep)   TRACE_EVENT(TRACE_OUTREQQUEUED_ID, ep)
#define TRACE_INREQQUEUED(ep)    TRACE_EVENT(TRACE_INREQQUEUED_ID, ep)
#define TRACE_READ(ep)           TRACE_EVENT(TRACE_READ_ID, ep)
#define TRACE_WRITE(ep)          TRACE_EVENT(TRACE_WRITE_ID, ep)
#define TRACE_COMPLETE(ep)       TRACE_EVENT(TRACE_COMPLETE_ID, ep)

/* USB device controller error events.  The 'id' is specific to the driver.
 * Particular values for 'id' are unique for a given implementation of a
 * controller driver
 */

#define TRACE_DEVERROR(id)       TRACE_EVENT(TRACE_DEVERROR_ID, id)

/* USB class driver error events.  The 'id' is specific to the class driver,
 * but common to all driver controller instances.
 */

#define TRACE_CLSERROR(id)       TRACE_EVENT(TRACE_CLSERROR_ID, id)

/* Event string descriptions ************************************************/
/* Macros for defining the string arrays for display of the traces. */

#ifdef CONFIG_USBDEV_TRACE_STRINGS
#  define TRACE_STR(id) {id, #id}
#  define TRACE_STR_END {0, NULL}
#endif

/* USB Serial driver class events *******************************************/
/* Used by both the CDC/ACM and the PL2303 serial class drivers */
/* UART interface API calls */

#define USBSER_TRACECLASSAPI_SETUP                   0x0001
#define USBSER_TRACECLASSAPI_SHUTDOWN                0x0002
#define USBSER_TRACECLASSAPI_ATTACH                  0x0003
#define USBSER_TRACECLASSAPI_DETACH                  0x0004
#define USBSER_TRACECLASSAPI_IOCTL                   0x0005
#define USBSER_TRACECLASSAPI_RECEIVE                 0x0006
#define USBSER_TRACECLASSAPI_RXINT                   0x0007
#define USBSER_TRACECLASSAPI_RXAVAILABLE             0x0008
#define USBSER_TRACECLASSAPI_SEND                    0x0009
#define USBSER_TRACECLASSAPI_TXINT                   0x000a
#define USBSER_TRACECLASSAPI_TXREADY                 0x000b
#define USBSER_TRACECLASSAPI_TXEMPTY                 0x000c
#define USBSER_TRACECLASSAPI_FLOWCONTROL             0x000d

/* Values of the class error ID used by the USB serial driver */

#define USBSER_TRACEERR_ALLOCCTRLREQ                 0x0001
#define USBSER_TRACEERR_ALLOCDEVSTRUCT               0x0002
#define USBSER_TRACEERR_ALREADYCLOSED                0x0003
#define USBSER_TRACEERR_ALREADYCONFIGURED            0x0004
#define USBSER_TRACEERR_CONFIGIDBAD                  0x0005
#define USBSER_TRACEERR_CONFIGNONE                   0x0006
#define USBSER_TRACEERR_CONSOLEREGISTER              0x0007
#define USBSER_TRACEERR_DEVREGISTER                  0x0008
#define USBSER_TRACEERR_EPRESPQ                      0x0009
#define USBSER_TRACEERR_GETUNKNOWNDESC               0x000a
#define USBSER_TRACEERR_INVALIDARG                   0x000b
#define USBSER_TRACEERR_EP0NOTBOUND                  0x000c
#define USBSER_TRACEERR_EPBULKINALLOCFAIL            0x000d
#define USBSER_TRACEERR_EPBULKINCONFIGFAIL           0x000e
#define USBSER_TRACEERR_EPBULKOUTALLOCFAIL           0x000f
#define USBSER_TRACEERR_EPINTINALLOCFAIL             0x0010
#define USBSER_TRACEERR_EPINTINCONFIGFAIL            0x0011
#define USBSER_TRACEERR_EPBULKOUTCONFIGFAIL          0x0012
#define USBSER_TRACEERR_RDALLOCREQ                   0x0013
#define USBSER_TRACEERR_RDSHUTDOWN                   0x0014
#define USBSER_TRACEERR_RDSUBMIT                     0x0015
#define USBSER_TRACEERR_RDUNEXPECTED                 0x0016
#define USBSER_TRACEERR_REQRESULT                    0x0017
#define USBSER_TRACEERR_RXOVERRUN                    0x0018
#define USBSER_TRACEERR_SETUPNOTCONNECTED            0x0019
#define USBSER_TRACEERR_SUBMITFAIL                   0x001a
#define USBSER_TRACEERR_UARTREGISTER                 0x001b
#define USBSER_TRACEERR_UARTUNREGISTER               0x001c
#define USBSER_TRACEERR_UNSUPPORTEDCTRLREQ           0x001d
#define USBSER_TRACEERR_UNSUPPORTEDCLASSREQ          0x001e
#define USBSER_TRACEERR_UNSUPPORTEDSTDREQ            0x001f
#define USBSER_TRACEERR_UNSUPPORTEDTYPE              0x0020
#define USBSER_TRACEERR_WRALLOCREQ                   0x0021
#define USBSER_TRACEERR_WRSHUTDOWN                   0x0022
#define USBSER_TRACEERR_WRUNEXPECTED                 0x0023

/* USB Storage driver class events ******************************************/

#define USBCOMPOSITE_TRACEERR_REQRESULT              0x0041
#define USBCOMPOSITE_TRACEERR_ALLOCCTRLREQ           0x0042
#define USBCOMPOSITE_TRACEERR_INVALIDARG             0x0043
#define USBCOMPOSITE_TRACEERR_EP0NOTBOUND            0x0044
#define USBCOMPOSITE_TRACEERR_SETUPINVALIDARGS       0x0045
#define USBCOMPOSITE_TRACEERR_EP0NOTBOUND2           0x0046
#define USBCOMPOSITE_TRACEERR_GETUNKNOWNDESC         0x0047
#define USBCOMPOSITE_TRACEERR_UNSUPPORTEDSTDREQ      0x0048
#define USBCOMPOSITE_TRACEERR_EPRESPQ                0x0049
#define USBCOMPOSITE_TRACEERR_ALLOCDEVSTRUCT         0x004a
#define USBCOMPOSITE_TRACEERR_CLASSOBJECT            0x004b
#define USBCOMPOSITE_TRACEERR_DEVREGISTER            0x004c

/* USB Storage driver class events ******************************************/

/* State transitions */

#define USBMSC_CLASSSTATE_IDLECMDPARSE               0x0081
#define USBMSC_CLASSSTATE_CMDPARSECMDFINISH          0x0082
#define USBMSC_CLASSSTATE_CMDPARSECMDREAD6           0x0083
#define USBMSC_CLASSSTATE_CMDPARSECMDREAD10          0x0084
#define USBMSC_CLASSSTATE_CMDPARSECMDREAD12          0x0085
#define USBMSC_CLASSSTATE_CMDPARSECMDWRITE6          0x0086
#define USBMSC_CLASSSTATE_CMDPARSECMDWRITE10         0x0087
#define USBMSC_CLASSSTATE_CMDPARSECMDWRITE12         0x0088
#define USBMSC_CLASSSTATE_CMDREAD                    0x0089
#define USBMSC_CLASSSTATE_CMDREADCMDFINISH           0x008a
#define USBMSC_CLASSSTATE_CMDWRITE                   0x008b
#define USBMSC_CLASSSTATE_CMDWRITECMDFINISH          0x008c
#define USBMSC_CLASSSTATE_CMDFINISHCMDSTATUS         0x008d
#define USBMSC_CLASSSTATE_CMDSTATUSIDLE              0x008e

/* Values of the class error ID used by the USB storage driver */

#define USBMSC_TRACEERR_ALLOCCTRLREQ                 0x0081
#define USBMSC_TRACEERR_ALLOCDEVSTRUCT               0x0082
#define USBMSC_TRACEERR_ALLOCIOBUFFER                0x0083
#define USBMSC_TRACEERR_ALREADYCONFIGURED            0x0084
#define USBMSC_TRACEERR_ALREADYUNINIT                0x0085
#define USBMSC_TRACEERR_BADREQUEST                   0x0086
#define USBMSC_TRACEERR_BINDLUNINVALIDARGS2          0x0087
#define USBMSC_TRACEERR_BINDLUNINVALIDARGS3          0x0088
#define USBMSC_TRACEERR_BINDLUNINVALIDARGS4          0x0089
#define USBMSC_TRACEERR_BINLUNINVALIDARGS1           0x008a
#define USBMSC_TRACEERR_BLKDRVEOPEN                  0x008b
#define USBMSC_TRACEERR_CMDBADLUN                    0x008c
#define USBMSC_TRACEERR_CMDFINISHRESIDUE             0x008d
#define USBMSC_TRACEERR_CMDFINISHRQEMPTY             0x008e
#define USBMSC_TRACEERR_CMDFINISHSHORTPKT            0x008f
#define USBMSC_TRACEERR_CMDFINISHSUBMIT              0x0090
#define USBMSC_TRACEERR_CMDFINSHDIR                  0x0091
#define USBMSC_TRACEERR_CMDFINSHSUBMIT               0x0092
#define USBMSC_TRACEERR_CMDPARSEWRREQLISTEMPTY       0x0093
#define USBMSC_TRACEERR_CMDREADREADFAIL              0x0094
#define USBMSC_TRACEERR_CMDREADSUBMIT                0x0095
#define USBMSC_TRACEERR_CMDREADWRRQEMPTY             0x0096
#define USBMSC_TRACEERR_CMDSTATUSWRREQLISTEMPTY      0x0097
#define USBMSC_TRACEERR_CMDUNEVIOLATION              0x0098
#define USBMSC_TRACEERR_CMDWRITERDSUBMIT             0x0099
#define USBMSC_TRACEERR_CMDWRITERDRQEMPTY            0x009a
#define USBMSC_TRACEERR_CMDWRITEWRITEFAIL            0x009b
#define USBMSC_TRACEERR_CONFIGIDBAD                  0x009c
#define USBMSC_TRACEERR_CONFIGNONE                   0x009d
#define USBMSC_TRACEERR_DEFERREDRESPINVALIDARGS      0x009e
#define USBMSC_TRACEERR_DEFERREDRESPSTALLED          0x009f
#define USBMSC_TRACEERR_DEFERREDRESPSUBMIT           0x00a0
#define USBMSC_TRACEERR_DEVREGISTER                  0x00a1
#define USBMSC_TRACEERR_DISCONNECTINVALIDARGS        0x00a2
#define USBMSC_TRACEERR_EP0NOTBOUND1                 0x00a3
#define USBMSC_TRACEERR_EP0NOTBOUND2                 0x00a4
#define USBMSC_TRACEERR_EP0NOTBOUND3                 0x00a5
#define USBMSC_TRACEERR_EPBULKINALLOCFAIL            0x00a6
#define USBMSC_TRACEERR_EPBULKINCONFIGFAIL           0x00a7
#define USBMSC_TRACEERR_EPBULKOUTALLOCFAIL           0x00a8
#define USBMSC_TRACEERR_EPBULKOUTCONFIGFAIL          0x00a9
#define USBMSC_TRACEERR_EPRESPQ                      0x00aa
#define USBMSC_TRACEERR_EXPORTLUNSINVALIDARGS        0x00ab
#define USBMSC_TRACEERR_GETMAXLUNNDX                 0x00ac
#define USBMSC_TRACEERR_GETUNKNOWNDESC               0x00ad
#define USBMSC_TRACEERR_IDLERDREQLISTEMPTY           0x00ae
#define USBMSC_TRACEERR_IDLERDSUBMIT                 0x00af
#define USBMSC_TRACEERR_INQUIRYFLAGS                 0x00b0
#define USBMSC_TRACEERR_INTERNALCONFUSION1           0x00b1
#define USBMSC_TRACEERR_INTERNALCONFUSION2           0x00b2
#define USBMSC_TRACEERR_INVALIDCBWCONTENT            0x00b3
#define USBMSC_TRACEERR_INVALIDCBWSIGNATURE          0x00b4
#define USBMSC_TRACEERR_INVALIDSTATE                 0x00b5
#define USBMSC_TRACEERR_LUNALREADYBOUND              0x00b6
#define USBMSC_TRACEERR_LUNNOTBOUND                  0x00b7
#define USBMSC_TRACEERR_MODEPAGEFLAGS                0x00b8
#define USBMSC_TRACEERR_MODESENSE10FLAGS             0x00b9
#define USBMSC_TRACEERR_MODESENSE6FLAGS              0x00ba
#define USBMSC_TRACEERR_MSRESETNDX                   0x00bb
#define USBMSC_TRACEERR_NOGEOMETRY                   0x00bc
#define USBMSC_TRACEERR_NOTCONFIGURED                0x00bd
#define USBMSC_TRACEERR_NOTREMOVABLE                 0x00be
#define USBMSC_TRACEERR_PCSAVED                      0x00bf
#define USBMSC_TRACEERR_PHASEERROR1                  0x00c0
#define USBMSC_TRACEERR_PHASEERROR2                  0x00c1
#define USBMSC_TRACEERR_PHASEERROR3                  0x00c2
#define USBMSC_TRACEERR_PREVENTMEDIUMREMOVALPREVENT  0x00c3
#define USBMSC_TRACEERR_RDALLOCREQ                   0x00c4
#define USBMSC_TRACEERR_RDCOMPLETEINVALIDARGS        0x00c5
#define USBMSC_TRACEERR_RDCOMPLETERDSUBMIT           0x00c6
#define USBMSC_TRACEERR_RDSHUTDOWN                   0x00c7
#define USBMSC_TRACEERR_RDSUBMIT                     0x00c8
#define USBMSC_TRACEERR_RDUNEXPECTED                 0x00c9
#define USBMSC_TRACEERR_READ10FLAGS                  0x00ca
#define USBMSC_TRACEERR_READ10LBARANGE               0x00cb
#define USBMSC_TRACEERR_READ10MEDIANOTPRESENT        0x00cc
#define USBMSC_TRACEERR_READ12FLAGS                  0x00cd
#define USBMSC_TRACEERR_READ12LBARANGE               0x00ce
#define USBMSC_TRACEERR_READ12MEDIANOTPRESENT        0x00cf
#define USBMSC_TRACEERR_READ6LBARANGE                0x00d0
#define USBMSC_TRACEERR_READ6MEDIANOTPRESENT         0x00d1
#define USBMSC_TRACEERR_READCAPACITYFLAGS            0x00d2
#define USBMSC_TRACEERR_REALLOCIOBUFFER              0x00d3
#define USBMSC_TRACEERR_REQRESULT                    0x00d4
#define USBMSC_TRACEERR_SCSICMDCONTROL               0x00d5
#define USBMSC_TRACEERR_SETCONFIGINVALIDARGS         0x00d6
#define USBMSC_TRACEERR_SETUPINVALIDARGS             0x00d7
#define USBMSC_TRACEERR_SNDCSWFAIL                   0x00d8
#define USBMSC_TRACEERR_SNDPHERROR                   0x00d9
#define USBMSC_TRACEERR_SNDSTATUSSUBMIT              0x00da
#define USBMSC_TRACEERR_SYNCCACHEMEDIANOTPRESENT     0x00db
#define USBMSC_TRACEERR_THREADCREATE                 0x00dc
#define USBMSC_TRACEERR_DETACH                       0x00dd
#define USBMSC_TRACEERR_TOOMANYLUNS                  0x00de
#define USBMSC_TRACEERR_UNBINDINVALIDARGS            0x00df
#define USBMSC_TRACEERR_UNBINDLUNINVALIDARGS1        0x00e0
#define USBMSC_TRACEERR_UNBINDLUNINVALIDARGS2        0x00e1
#define USBMSC_TRACEERR_UNINITIALIZEINVALIDARGS      0x00ee
#define USBMSC_TRACEERR_UNSUPPORTEDSTDREQ            0x00e3
#define USBMSC_TRACEERR_VERIFY10FLAGS                0x00e4
#define USBMSC_TRACEERR_VERIFY10LBARANGE             0x00e5
#define USBMSC_TRACEERR_VERIFY10MEDIANOTPRESENT      0x00e6
#define USBMSC_TRACEERR_VERIFY10NOBLOCKS             0x00e7
#define USBMSC_TRACEERR_VERIFY10READFAIL             0x00e8
#define USBMSC_TRACEERR_WRALLOCREQ                   0x00e9
#define USBMSC_TRACEERR_WRCOMPLETEINVALIDARGS        0x00ea
#define USBMSC_TRACEERR_WRITE10FLAGS                 0x00eb
#define USBMSC_TRACEERR_WRITE10LBARANGE              0x00ec
#define USBMSC_TRACEERR_WRITE10MEDIANOTPRESENT       0x00ed
#define USBMSC_TRACEERR_WRITE10READONLY              0x00ee
#define USBMSC_TRACEERR_WRITE12FLAGS                 0x00ef
#define USBMSC_TRACEERR_WRITE12LBARANGE              0x00f0
#define USBMSC_TRACEERR_WRITE12MEDIANOTPRESENT       0x00f1
#define USBMSC_TRACEERR_WRITE12READONLY              0x00f2
#define USBMSC_TRACEERR_WRITE6LBARANGE               0x00f3
#define USBMSC_TRACEERR_WRITE6MEDIANOTPRESENT        0x00f4
#define USBMSC_TRACEERR_WRITE6READONLY               0x00f5
#define USBMSC_TRACEERR_WRSHUTDOWN                   0x00f6
#define USBMSC_TRACEERR_WRUNEXPECTED                 0x00f7
#define USBMSC_TRACEERR_UNSUPPORTEDTYPE              0x00f8

/****************************************************************************
 * Public Types
 ****************************************************************************/

/* The reported trace information */

struct usbtrace_s
{
  uint16_t event;
  uint16_t value;
};

/* Describes on element of a string string for decoding of device-specific
 * trace events.
 */

#ifdef CONFIG_USBDEV_TRACE_STRINGS
struct trace_msg_t
{
  uint16_t        id;   /* 8-bit ID value */
  FAR const char *str;  /* String assoiciated with the ID */
};
#endif

/* Enumeration callback function signature */

typedef CODE int (*trace_callback_t)(struct usbtrace_s *trace, void *arg);

/* Bit mask input type for usbtrace_enable().  If  TRACE_NIDS grows beyond
 * 16, then this will have to be changed to uint32_t
 */

typedef uint16_t usbtrace_idset_t;

/* Print routine to use for usbdev_trprint() output */

typedef CODE int (*trprintf_t)(const char *fmt, ...);

/****************************************************************************
 * Public Data
 ****************************************************************************/

#undef EXTERN
#if defined(__cplusplus)
# define EXTERN extern "C"
extern "C"
{
#else
# define EXTERN extern
#endif

/* If CONFIG_USBDEV_TRACE_STRINGS is defined, then the USB class driver and
 * the USB device controller driver must provide these strings to support
 * decoding of class- and device-specific trace events.
 */

#ifdef CONFIG_USBDEV_TRACE_STRINGS
EXTERN const struct trace_msg_t g_usb_trace_strings_clsapi[];
EXTERN const struct trace_msg_t g_usb_trace_strings_clsstate[];
EXTERN const struct trace_msg_t g_usb_trace_strings_clserror[];
EXTERN const struct trace_msg_t g_usb_trace_strings_deverror[];
EXTERN const struct trace_msg_t g_usb_trace_strings_intdecode[];
#endif

/****************************************************************************
 * Public Function Prototypes
 ****************************************************************************/

/****************************************************************************
 * Name: usbtrace_enable
 *
 * Description:
 *  Enable/disable tracing per trace ID.  The initial state is all IDs enabled.
 *
 * Input Parameters:
 *  idset - The bitset of IDs to be masked.  TRACE_ALLIDS enables all IDS; zero
 *  masks all IDs.
 *
 * Returned Value:
 *  The previous idset value.
 *
 * Assumptions:
 * - May be called from an interrupt handler
 *
 ****************************************************************************/

#if defined(CONFIG_USBDEV_TRACE) || (defined(CONFIG_DEBUG_FEATURES) && defined(CONFIG_DEBUG_USB))
usbtrace_idset_t usbtrace_enable(usbtrace_idset_t idset);
#else
#  define usbtrace_enable(idset)
#endif

/****************************************************************************
 * Name: usbtrace
 *
 * Description:
 *  Record a USB event (tracing must be enabled)
 *
 * Assumptions:
 *   May be called from an interrupt handler
 *
 ****************************************************************************/

#if defined(CONFIG_USBDEV_TRACE) || (defined(CONFIG_DEBUG_FEATURES) && defined(CONFIG_DEBUG_USB))
void usbtrace(uint16_t event, uint16_t value);
#else
#  define usbtrace(event, value)
#endif

/****************************************************************************
 * Name: usbtrace_enumerate
 *
 * Description:
 *   Enumerate all buffer trace data (will temporarily disable tracing)
 *
 * Assumptions:
 *   NEVER called from an interrupt handler
 *
 ****************************************************************************/

#ifdef CONFIG_USBDEV_TRACE
int usbtrace_enumerate(trace_callback_t callback, void *arg);
#else
#  define usbtrace_enumerate(event)
#endif

/****************************************************************************
 * Name: usbtrace_trprint
 *
 * Description:
 *   Print the trace record using the supplied printing function
 *
 ****************************************************************************/

void usbtrace_trprintf(trprintf_t trprintf, uint16_t event, uint16_t value);

#undef EXTERN
#if defined(__cplusplus)
}
#endif

#endif /* __INCLUDE_NUTTX_USB_USBDEV_TRACE_H */