USB$SDA_HELP.HLB  —  SHOW
   Shows information about the BUS, Devices, Controllers, Endpoints,
   Interfaces, HID common layer, Requests, and BUS topology for the selected
   controller.

1  –  BUS

   Formats the USB BUS data structure.

   Format

      USB SHOW BUS

1.1  –  Example

   This example shows the USB BUS data structure for the EHAO High speed
   controller.

 OpenVMS system analyzer

 SDA> usb set con eha0
 Controller set to EHA0
 SDA> usb show bus
 Bus address is:                 89731750
 Structure type is               00000001
 Spinlock is                     0000003a
 Bus number is                   00000003
 Host controller UCB address is  89604380
 Flags 1 -> default addr in use  00000000
 Switch table address is         89722400
 Callback thread Queue Flink     89731768
 Callback thread Queue Blink     89731768
 Thread state is
 USBD_THREAD_IDLE
 Outstanding thread count        00000000
 KPB address                     89731980
 Skipping fork block
 Fork state 0 - idle 1 - bsy     00000000
 Root hub address                89749590
 Callback thread Queue Flink     897317b8
 Callback thread Queue Blink     897317b8
 Thread state is
 USBD_THREAD_IDLE
 Hub thread KPB                  89731840
 Wait Q flink                    897317c8
 Wait Q blink                    897317c8
 Array descriptor for the root hub
 Array size                      00002ed0
 Array location                  896ee0d0
 Available entries flink         89755290
 Available entries blink         89755290
 Used entries flink              89746690
 Used entries blink              89750e50
 Count of available entreis      00000001
 Count of used entries           00000004
 Number to add if expanding      00000001
 SDA>

2  –  DEVICE

   Formats the USB device data structure.

   Format

      USB SHO DEVICE [address]

2.1  –  TRACE

   Outputs tracing data for the specificed device.

   Format

      USB SHOW DEVICE TRACE [address]

2.2  –  Examples

2.2.1  –  Trace

 SDA> USB SHO DEV trace 89750e50
 Device  address is:             89750e50
 Device tracing messages:
                   0:  4-SEP-2008 17:50:10.38 - hub_device_sc
                   1:  4-SEP-2008 17:50:10.48 - hub_device_sc
                   2:  4-SEP-2008 17:50:10.48 - PORT_CONNECTION is set
                   3:  4-SEP-2008 17:50:10.48 - set device_state = USBD_DEVICE_POWERED
                   4:  4-SEP-2008 17:50:10.48 - open default address
                   5:  4-SEP-2008 17:50:10.48 - usbd_open_default_pipe
                   6:  4-SEP-2008 17:50:10.48 - set next_device_state = USBD_DEVICE_DEFAULT
                   7:  4-SEP-2008 17:50:10.48 - Ack the change
                   8:  4-SEP-2008 17:50:10.48 - change needed
                   9:  4-SEP-2008 17:50:10.48 - next_device_state == USBD_DEVICE_DEFAULT
                  10:  4-SEP-2008 17:50:10.48 - hub_device_sc
                  11:  4-SEP-2008 17:50:10.48 - No change needed
                  12:  4-SEP-2008 17:50:10.48 - next_device_state == USBD_DEVICE_DEFAULT
                  13:  4-SEP-2008 17:50:10.48 - No ack change
                  14:  4-SEP-2008 17:50:10.64 - hub_device_sc
                  15:  4-SEP-2008 17:50:10.64 - PORT_RESET is clear
                  16:  4-SEP-2008 17:50:10.64 - set device_state to USBD_DEVICE_DEFAULT
                  17:  4-SEP-2008 17:50:10.64 - set next_device_state to USBD_DEVICE_ADDRESSED
                  18:  4-SEP-2008 17:50:10.64 - Ack the change
                  19:  4-SEP-2008 17:50:10.64 - hub_device_sc
                  20:  4-SEP-2008 17:50:10.64 - No change needed
                  21:  4-SEP-2008 17:50:10.64 - next_device_state == USBD_DEVICE_ADDRESSED
                  22:  4-SEP-2008 17:50:10.64 - change needed
                  23:  4-SEP-2008 17:50:10.64 - next_device_state ==USBD_DEVICE_ADDRESSED
                  24:  4-SEP-2008 17:50:10.64 - No ack change
                  25:  4-SEP-2008 17:50:10.65 - hub_read_device_desc1
                  26:  4-SEP-2008 17:50:10.65 - usbd_setup_control_request
                  27:  4-SEP-2008 17:50:10.65 - hub_set_address
                  28:  4-SEP-2008 17:50:10.65 - usbd_setup_control_request
                  29:  4-SEP-2008 17:50:10.65 - usbd_close_default_pipe
                  30:  4-SEP-2008 17:50:10.65 - usbd_open_default_pipe
                  31:  4-SEP-2008 17:50:10.65 - hub_read_device_desc2
                  32:  4-SEP-2008 17:50:10.65 - usbd_setup_control_request
     Press RETURN for more.
 SDA>

2.2.2  –  Data Structure

 SDA> USB SHO DEV 89750e50
 Device  address is:             89750e50
 Descriptor header Flink         897317e0
 Descriptor header Blink         8974ded0
 Pointer to array descriptor     897317d0
 Index                           00000003
 Flags 0 -> avail 1 ->used       00000001
 Numbers of entries in this chunk00000001
 Descriptor type                 00000002
 Lock                            0000003a
 KPB pointer                     00000000
 Host controller UCB             00000000
 Device state                    00000010
    DEVICE CONFIGURED
 Device next state               00000000
    UNKNONW STATE
 Port number                     00000003
 Speed 0->full 1->low 2->High    00000001
 Tier level                      00000002
 USB bus address                 00000003
 Reference count                 00000000
 Flag(s) DEVICE_IS_CONNECTED
 Flag(s) DEVICE_CONFIG_INTERFACE
 Default pipe                    896f1ed0
 Bus device is attached to       89731750
 Upstream hub address            8974ded0
 Default pipe requests Flink     89750e98
 Default pipe requests Blink     89750e98
 Driver name
 Device descriptor length        00000012
 Descriptor type                 00000001
 Revision                        00000110
 Device class                    00000000
 Device sub class                00000000
 Device protocol                 00000000
 Max packet size                 00000008
 Vendor ID                       00000d3d
 Product  ID                     00000001
 Manufactures index              00000000
 Product index                   00000002
 Serial number index             00000000
 Number of configurations        00000001
 Pointer to configuration array  89755010
 Number of configuration desc    00000001
 Active configuration pointer    896f4690
 Pointer to interface desc array 89758ed0
 Default interface array ptr     89758e90
        Interface Address: 89758ED0 UCB: 8975A780 Driver Name: SYS$KBDDRIVER
        Interface Address: 89759010 UCB: 8975E800 Driver Name: SYS$MOUDRIVER
 Pointer to endpoint array       89759190
      Endpoint Address           89759190
         Device:    89750E50
         Interface: 89758ED0
         Desc:      896F46AB
         Number:    01
         Pipe:      8975ACD0

      Endpoint Address           897591a8
         Device:    89750E50
         Interface: 89759010
         Desc:      896F46C4
         Number:    02
         Pipe:      8975ED50

 Number of interface descriptors 00000002
 Number of endpoint descriptors  00000002
 Config_value                    00000001
 Failed configure attempts       00000000

3  –  EHCI

   Displays information about the selected EHCI host controller.

3.1  –  PORT

   Displays information about the specificed root hub port.
   Ports are numbered 1-n where n is typically no larger than 5.

   Format

      USB SHOW EHCI POTR [n]

3.1.1  –  Example

 SDA> USB SHOW EHCI PORT 1

 Port 01 Status and Control Register         00001005
   Current connection status                1
   Current connection status change         0
   Port enable/disable                      1
   Port enable/disable change               0
   Over-current active                      0
   Over-current change                      0
   Force port resume                        0
   Port suspend                             0
   Port reset                               0
   Line Status 0 - SEO
               1 - K-State
               2 - J-State
               3 - undefined                0
   Port Power                               1
   Port owner                               0
   Port indicator                           0
   Port test 0 - test mode not enabled
             1 - Test J state
             2 - Test K State
             3 - Test SE0 state
             4 - Test packet
             5 - Test force enable          0
   Wake on connection enable                0
   Wake on disconnect enable                0
   Wake on over-current enable              0
 SDA>

3.2  –  REGISTERS

   Displays the various device registers.  The command
   is split into register sets to make it more readable.

3.2.1  –  CAPABILITIES

   Displays the capability registers.

   Format

      USB SHOW EHCI REGISTERS CAPABILITY

3.2.1.1  –  Example

 SDA> USB SHOW EHCI REGISTERS CAPABILITY

 Last EHCI controllers capability registers saved in EHCI UCB
 ----------------------------------        ------------------
 Capability length register                  00000020
 Interface version number                    00000095
 Structural parameters                       00002395
   Number of down stream ports              5
   Port Power Control                       1
   Port routing rules                       1
   Ports per companion controllers          3
   Number of companion controllers          2
   Port indicators                          0
   Bebug port number                        0
 Capability parameters                       00000002
   64-Bit Addressing Capability             0
   Programmable frame list flag             1
   Asynchronous frame list park             0
   Isochronous scheduling threshold         0
   EHCI extended capability pointer        00
 Port Route Description                                  1010
 SDA>

3.2.2  –  EECP

   Display Enhanced capability registers.

3.2.2.1  –  Example

 SDA> USB SHOW EHCI REGISTERS EECP
 NO EECP_REGISTERS present

3.2.3  –  OPERATING

   Displays the last saved contents of the devices operating
   registers if looking at a crash.  On a running system, displays
   the contents of the registers that were just read.

    Format

       USB SHOW EHCI REGISTERS OPERATING

3.2.3.1  –  Example

 SDA> USB SHOW EHCI REGISTERS OPERATING
 Current EHCI operating registers as read from the controller

 Extended Host Controller Operating Registers
 ----------------------------------        ----------
 USB Commad Register                         00080031
   Run/Stop                                 1
   Host Controler Reset                     0
   Frame List size 0-1024, 1-512, 2-256     0
   Periodic Schedule Enable                 1
   Asynchronous Schedule Enable             1
   Interrupt on Async Advance Doorbell      0
   Light Host Conrtoller Reset              0
   Asynchronous schedule park mode count    0
   Asynchronous Schedule park mode enable   0
   Interrupt Threshold Control             08
 USB Status Register                         0000c000
   USB Interrupt                            0
   USB Error Interrupt                      0
   Port Change Detect                       0
   Frame List Rollover                      0
   Host System Error                        0
   Interrupt on Asynch Advance              0
   HCHalted                                 0
   Reclamation                              0
   Periodic Schedule Status 1 - enabled     1
   Asynchronous Schedule Status 1 - enabled 1
 USB Interrupt Enable Register               0000003f
   USB Interrupt Enable                     1
   USB Error Interrupt Enable               1
   Port Change Interrupt Enable             1
   Frame List Rollover Enable               1
   Host System Error Enable                 1
   Interrupt On Async Advance Enable        1

 Frame Index Register                        00003324
 Control Data Structure Segment Register     00000000
 Periodic Frame List Base Address            454b0000
 Current Asynchronous List Address Base      45490040
 Configure Flag Register                     00000000

 Port 01 Status and Control Register         00001005
   Current connection status                1
   Current connection status change         0
   Port enable/disable                      1
   Port enable/disable change               0
   Over-current active                      0
   Over-current change                      0
   Force port resume                        0
   Port suspend                             0
   Port reset                               0
   Line Status 0 - SEO
               1 - K-State
               2 - J-State
               3 - undefined                0
   Port Power                               1
   Port owner                               0
   Port indicator                           0
   Port test 0 - test mode not enabled
             1 - Test J state
             2 - Test K State
             3 - Test SE0 state
             4 - Test packet
             5 - Test force enable          0
   Wake on connection enable                0
   Wake on disconnect enable                0
   Wake on over-current enable              0
 Port 02 Status and Control Register         00001000
   Current connection status                0
   Current connection status change         0
   Port enable/disable                      0
   Port enable/disable change               0
   Over-current active                      0
   Over-current change                      0
   Force port resume                        0
   Port suspend                             0
   Port reset                               0
   Line Status 0 - SEO
               1 - K-State
               2 - J-State
               3 - undefined                0
   Port Power                               1
   Port owner                               0
   Port indicator                           0
   Port test 0 - test mode not enabled
             1 - Test J state
             2 - Test K State
             3 - Test SE0 state
             4 - Test packet
             5 - Test force enable          0
   Wake on connection enable                0
   Wake on disconnect enable                0
   Wake on over-current enable              0
 Port 03 Status and Control Register         00001000
   Current connection status                0
   Current connection status change         0
   Port enable/disable                      0
   Port enable/disable change               0
   Over-current active                      0
   Over-current change                      0
   Force port resume                        0
   Port suspend                             0
   Port reset                               0
   Line Status 0 - SEO
               1 - K-State
               2 - J-State
               3 - undefined                0
   Port Power                               1
   Port owner                               0
   Port indicator                           0
   Port test 0 - test mode not enabled
             1 - Test J state
             2 - Test K State
             3 - Test SE0 state
             4 - Test packet
             5 - Test force enable          0
   Wake on connection enable                0
   Wake on disconnect enable                0
   Wake on over-current enable              0
 Port 04 Status and Control Register         00001000
   Current connection status                0
   Current connection status change         0
   Port enable/disable                      0
   Port enable/disable change               0
   Over-current active                      0
   Over-current change                      0
   Force port resume                        0
   Port suspend                             0
   Port reset                               0
   Line Status 0 - SEO
               1 - K-State
               2 - J-State
               3 - undefined                0
   Port Power                               1
   Port owner                               0
   Port indicator                           0
   Port test 0 - test mode not enabled
             1 - Test J state
             2 - Test K State
             3 - Test SE0 state
             4 - Test packet
             5 - Test force enable          0
   Wake on connection enable                0
   Wake on disconnect enable                0
   Wake on over-current enable              0
 Port 05 Status and Control Register         00001000
   Current connection status                0
   Current connection status change         0
   Port enable/disable                      0
   Port enable/disable change               0
   Over-current active                      0
   Over-current change                      0
   Force port resume                        0
   Port suspend                             0
   Port reset                               0
   Line Status 0 - SEO
               1 - K-State
               2 - J-State
               3 - undefined                0
   Port Power                               1
   Port owner                               0
   Port indicator                           0
   Port test 0 - test mode not enabled
             1 - Test J state
             2 - Test K State
             3 - Test SE0 state
             4 - Test packet
             5 - Test force enable          0
   Wake on connection enable                0
   Wake on disconnect enable                0
   Wake on over-current enable              0
 SDA>

3.2.4  –  PCI

   Displays the PCI device registers.

   Format

      USB SHOW EHCI REGISTERS PCI

3.2.4.1  –  Example

 SDA> USB SHOW EHCI REGISTERS PCI

 Last EHCI controllers PCI registers saved in EHCI UCB
 ----------------------------------        ----------
 Vendor Id                                       1033
 Device Id                                       00e0
 Command Register                                0146
 Status Register                                 0210
 Revision Id                                       02
 Programming if                                    20
 Sub Class                                         03
 Base Class                                        0c
 Cache line size                                   20
 Latency timer                                     80
 Header type                                       00
 BIST                                              00
 BAR                                         80000000
 BAR 1                                       00000000
 BAR 2                                       00000000
 BAR 3                                       00000000
 BAR 4                                       00000000
 BAR 5                                       00000000
 Cardbus CIS Pointer                         00000000
 Subsystem vendor Id                             1033
 Subsystem Id                                    00e0
 Expansion Rom base address                  00000000
 Serial Bus Release number                         20
 Frame Length adjustment register                  20
 Port Wake Capability register                     3f
 SDA>

3.3  –  HCDQH

   Displays a Host Controller Drivers Queue Head data structure.

   Format

      USB SHOW EHCI HCDQH [address]

3.3.1  –  Example

 SDA> USB SHOW EHCI HCDQH 896C4300
 Flink                 00000000
 Blink                 00000000
 Next                  00000000
 Physical address      45490340
 HCDQTD flink          896C8D80
 HCDQTD blink          896C8D80
 Queue Header------------------
 Link pointer          00000001
 Characteristics       00081103
    Device Address           03
    Inactivate               00
    Endpoint Number          01
    Endpoint Speed           LOW
    Data Toggle              00
    Head of List             00
    Max Packet               08
    Control Endpoint         00
    NAK Reload Count         00
 Capability            41821C01
 Current QTD           454A0DC0
 Overlay QTD-------------------
 Next QTD              00000001
 Alt QTD               00000001
 QTD Token             80088D80
 BPP0                  455405D0
 BPP1                  00000004
 BPP2                  00000016
 BPP3                  00000000
 BPP4                  000005D0
 SDA>

3.4  –  HCDQTD

3.4.1  –  Example

 SDA> USB SHOW EHCI HCDQTD 896C9B60
 Flink                 896C9B00
 Blink                 896C9AA0
 Physical address      454A1BA0
 USB request           896F8820
 HCDQH                 896C4300
 Request flink         896C9B84
 Request blink         896F8818
 QTD---------------------------
 Next QTD              00000001
 Alt QTD               00000001
 QTD Token             00008D00
    In Token
    Error Count = 0
    Current Page = 0
    Interrupt On Complete
    Transfer Length = 0000
 BPP0                  455405D8
 BPP1                  00000000
 BPP2                  00000000
 BPP3                  00000000
 BPP4                  00000000
 SDA>

3.5  –  ASYNC

   Displays the Host Controller Drivers Queue Heads that are
   in the Asynchronous list.

3.5.1  –  Example

 SDA> USB SHOW EHCI ASYNCH
 EHCI Asynchronous list
 ----------------------
 HCDQH = 896C4100
 HCDQH = 896C4280
 SDA>

3.6  –  PERIODIC

   Displays the Host Controller Drivers Queue heads (HCDQH) that are
   in the periodic schedule.  Slots that do not have HCDQH's are not
   shown.

3.6.1  –  Example

 SDA> USB SHOW EHCI PERIODIC
 EHCI Periodic list
 ------------------
 [0006]
     HCDQH = 896C4380
         HCDQTD = 896C82A0, status = 80
 [0008]
     HCDQH = 896C4300
         HCDQTD = 896C9C20, status = 80
 [0016]
     HCDQH = 896C4380
         HCDQTD = 896C82A0, status = 80
 [0018]
     HCDQH = 896C4300
         HCDQTD = 896C9C20, status = 80

             .
             .
             .

 [1012]
     HCDQH = 896C4300
         HCDQTD = 896C9B60, status = 80
 [1020]
     HCDQH = 896C4380
         HCDQTD = 896C82A0, status = 80
 [1022]
     HCDQH = 896C4300
         HCDQTD = 896C9B60, status = 80
 SDA>

3.7  –  UCB

   Displays the EHCI drivers extensions to a standard UCB.

   Format

      USB SHOW EHCI UCB

3.7.1  –  Example

 SDA> USB SHOW EHCI UCB

 Extended Host Controller UCB extensions
 ----------------------------------  ----------------
 I/O handle                          ffffffff896bbe80
 Operating register offset                   00000020
 Number of root hub ports                    00000005
 Pointer to UCM's mailbox                    00000000
 Pointer to the bus structure                896cddd0
 Pointer to ehci routine table               896bbec0
 Root hub device address                     00000001
 Queue of status change requests
     Flink                                   896ce090
     Blink                                   896ce090
  8K Map register queue
     Flink                                   896f1690
     Blink                                   896f8750
 16K Map register queue
     Flink                                   895a11c8
     Blink                                   895a11c8
 32K Map register queue
     Flink                                   895a11d0
     Blink                                   895a11d0
 64K Map register queue
     Flink                                   895a11d8
     Blink                                   895a11d8
 List of free HCD queue heads
     Flink                                   896c4400
     Blink                                   896c4200
 list of used HCD queue heads
     Flink                                   895a11e8
     Blink                                   895a11e8
 list of used HCD QTD
     Flink                                   895a11f8
     Blink                                   895a11f8
 Devices that have HCD QH's
     All queue heads are empty
 Count of free HCD queue heads               00000056
 Count of used HCD queue heads               00000000
 Count of free HCD queue TD's                00000082
 Count of used HCD queue TD's                00000000
 Periodic list physical address      ffffffff454b0000
 Periodic list virtual address               896ca000
 Periodic shadow list virtual address        896cc000
 Current periodic frame                      00000031
 Count of tries to get control from BIOS     00000000
 Ports with pending C_PORT_RESET     0000000000000000
 Asynchronous hcdqh flink                    896c4000
 Asynchronous hcdqh blink                    896c4280
 Pending Remove HCDQH queue flink            895a1608
 Pending Remove HCDQH queue blink            895a1608
 Halted errors                               00000000
 Data buffer errors                          00000000
 Babble errors                               00000000
 Transaction errors                          00000000
 Missed micro frame errors                   00000000
 Err errors                                  00000000

 SDA>

4  –  ENDPOINT

   Displays information about a device's endpoint.  Devices can have
   multiple endpoints with each endpoint having a corresponding pipe.

   Format

      USB SHOW ENDPOINT [address]

4.1  –  Example

 SDA> USB SHO ENDPOINT 896eabd0
 Structure type is              ENDPOINT
 Interface pointer              896f1790
 Endpoint descriptor pointer    896f1722
     Descriptor Length     00000007
                Type       00000005
                Address    00000081
                  ED #     00000001
                  Direction: In
                Attributes 00000003
                  Type:      Interrupt
      Maxpacket low byte  00000001
      Maxpacket high byte 00000000
      Polling Interval    0000000c
 Endpoint number                00000001
 Pipe                           896cd890
 SDA>

5  –  HID

   Formats various Human Interface Devices "HID" data
   structures.

5.1  –  COLLECTION

   Formats the HID collection data structure.

   Format

      USB SHOW HID COLLECTION [address]

5.1.1  –  Example

 SDA> USB SHOW HID COLLECTIONS 8968b090
 Forward pointer to next collection: 00000000
 Forward pointer to next collection: 00000000
 This is a collection:               02
 Collection type:                    Application part
 Parent collection address:          00000000
 Main item Flink:                    896f9810
 Main item Blink:                    896fa390
 Number of main items:               00000005
 Number of sub items:                00000001
 Subcollection Flink:                896f9610
 Subcollection Blink:                896f95d0
 SDA>

5.2  –  CONTEXT

   Displays the HID context block.  Every HID device has one context
   block that it shares with the HID common driver.

   Format

      USB SHOW HID CONTEXT [address]

5.2.1  –  Example

 SDA> USB SHOW HID CONTEXT 896F7A50
 Flags                               : 00000000
 Interface handle                    : 896f5bd0
 Device handle                       : 896edb10
 Pointer to Configuration Descriptor : 896f1bd0
 Pointer to Interface Descriptor     : 896f1bf2
 Pointer to HID Descriptor           : 896f9550
 Report descriptor                   : 8968c390
 Report descriptor size in bytes     : 0000007c
 Pointer to Physical Descriptor      : 00000000
 Endpoint count                      : 00000001
 Control Pipe Handle                 : 896f4b50
 I/O's outstanding on control pipe   : 00000000
 Input Pipe Handle                   : 896fb8d0
 Output Pipe Handle                  : 00000000
 Pointer to collection array         : 8968b090
 Number of collection in array       : 00000004
 HID drivers UCB address             : 896f5ec0
 Functions UCB address               : 896fb380
 SDA>

5.3  –  ITEM

   Displays data about a HID item.

   Format

      USB SHOW HID ITEM [address]

5.3.1  –  Example

 SDA> USB SHO HID ITEM 896f9850
 Items forward link pointer  : 896f9890
 Items backward link pointer : 896f9820
 Global item type
 Item tag is                 :     0000     usage page tag
 Item data is                : 00000009   Buttons

 SDA>

5.4  –  MAIN

   Displays data about a HID main item.

   Format

      USB SHOW HID MAIN [address]

5.4.1  –  Example

 SDA> USB SHOW HID MAIN 896f9810
 Main item Forward link                         : 896F99D0
 Main item Backward link                        : 8968b0a4
 This is a main item                            : 01
 Main item tag                                  : 00000008   Input Item tag
 Main item data                                 : 00000002
    Data, Variable, Absolute, Nowrap, Linear, Preferred state, No Null position
 Main item's item queue flink                   : 896f9850
 Main item's item queue blink                   : 896f96d0
 Pointer to collection this main item is part of: 8968b090
 SDA>

5.5  –  REPort

   Formats the HID report into an easaily read format

   Format

      USB SHO HID REPORT [address_of_context_block]

5.5.1  –  Example

 SDA> usb sho hid report 89716D90
 Item                                                                 Hex Value
 --------------------------------------------------------------------------------
  Generic Desktop                                                     05
 Usage (reserved)                                                     09
 Collection Application                                               a1
     Keyboard Keypad                                                  05
    Usage Minimum (e0)                                                19
    Usage Maximum (e7)                                                29
    Logical Minimum  (00)                                             15
    Logical Maximum  (01)                                             25
    Report Size (01)                                                  75
    Report Count (08)                                                 95
    Input (Data, Variable)                                            81
    Report Count (01)                                                 95
    Report Size (08)                                                  75
    Input (Constant)                                                  81
    Report Count (05)                                                 95
    Report Size (01)                                                  75
     LEDs                                                             05
    Usage Minimum (01)                                                19
    Usage Maximum (05)                                                29
    Output (Data, Variable)                                           91
    Report Count (01)                                                 95
    Report Size (03)                                                  75
    Output (Constant)                                                 91
    Report Count (06)                                                 95
    Report Size (08)                                                  75
    Logical Minimum  (00)                                             15
    Logical Maximum  (e700)                                           26
     Keyboard Keypad                                                  05
    Usage Minimum (00)                                                19
    Usage Maximum (e7)                                                29
    Input (Data, Array)                                               81
 End Collection                                                       c0
 SDA>

6  –  HUB

   Displays information about a USB hub.

   Format

      USB SHOW HUB [address]

6.1  –  Example

 SDA> usb show hub 8974ded0
 Hub address is:                 8974ded0
 Descriptor header Flink         89750e50
 Descriptor header Blink         89749590
 Pointer to array descriptor     897317d0
 Index                           00000002
 Flags 0 -> avail 1 ->used       00000001
 Numbers of entries in this chunk00000001
 Descriptor type                 00000002
 Lock                            0000003a
 KPB pointer                     00000000
 Host controller UCB             896f5400
 Device state                    00000010
    DEVICE CONFIGURED
 Device next state               00000000
    UNKNONW STATE
 Port number                     00000001
 Speed 0->full 1->low 2->High    00000002
 Tier level                      00000001
 USB bus address                 00000002
 Reference count                 00000001
 Flag(s) DEVICE_IS_CONNECTED
 Flag(s) DEVICE_CONFIG_DEVICE
 Default pipe                    89731f10
 Bus device is attached to       89731750
 Upstream hub address            89749590
 Default pipe requests Flink     8974df18
 Default pipe requests Blink     8974df18
 Driver name                     SYS$HUBDRIVER
 Device descriptor length        00000012
 Descriptor type                 00000001
 Revision                        00000200
 Device class                    00000009
 Device sub class                00000000
 Device protocol                 00000002
 Max packet size                 00000040
 Vendor ID                       0000050d
 Product  ID                     00000234
 Manufactures index              00000000
 Product index                   00000000
 Serial number index             00000000
 Number of configurations        00000001
 Pointer to configuration array  8974de50
 Number of configuration desc    00000001
 Active configuration pointer    89754c50
 Pointer to interface desc array 89754cd0
 Default interface array ptr     89754c10
 Pointer to endpoint array       8974de90
      Endpoint Address           8974de90
         Device:    8974DED0
         Interface: 89754CD0
         Desc:      89754C62
         Number:    01
         Pipe:      89750DD0

      Endpoint Address           8974dea8
         Device:    8974DED0
         Interface: 89754E10
         Desc:      89754C72
         Number:    01
         Pipe:      00000000

 Number of interface descriptors 00000002
 Number of endpoint descriptors  00000002
 Config_value                    00000001
 Failed configure attempts       00000000
 Structure type is               HUB
 -----Embeded hub descriptor-----
 Hub descriptor length           00000009
 Descriptor type                 00000029
 Number of ports                 00000004
 Characteristics low byte        00000000
 Characteristics high byte       00000000
 Power on to power good interval 00000032
 Hub control current             00000001
 Skipping port power control mask
 -----End of embeded hub descriptor-----
 Hub status change endpoint is   00000081
 Status change pipe handle       ffffffff89750dd0
 Status change requests Flink    896f0050
 Status change requests Blink    896f0050
 Number of ports                 00000004
 Port[1] status is               00000000
         next saved bits         00000000
 Port[2] status is               00000000
         next saved bits         00000000
 Port[3] status is               00000000
         next saved bits         00000005
         status bits
       4-SEP-2008 17:50:10.38 -> 00010301
       4-SEP-2008 17:50:10.48 -> 00010301
       4-SEP-2008 17:50:10.48 -> 00000301
       4-SEP-2008 17:50:10.64 -> 00100303
 IDX:  4-SEP-2008 17:50:10.64 -> 00000303
 Port[4] status is               00000000
         next saved bits         00000000
 Hub flags                       00000000
 Hub port power count            00000000
 Array of downstream device ptrs 89754fd0
      Port[1] device address     00000000
      Port[2] device address     00000000
      Port[3] device address     89750e50
      Port[4] device address     00000000
 Hub lock is                     0000003a
 SDA>

7  –  INTERFACE

   Displays information about the a device's interface.  Devices can
   have mulitple interfaces.

   Format

      USB SHOW INTERFACE [address]

7.1  –  Example

 SDA> USB SHO INTERFACE 896f1790
 Structure type is              INTERFACE
 Flags                          00000000
 State                          00008001
                                INTERFACE ACTIVE
                                INTERFACE CONFIG
 Device pointer                 896eac10
 UCB                            00000000
 Skipping config & deconfig routine addresses
 Driver name
 Default interface address      896f1790
 Interface array pointer        896f1790
 Interface count                00000002
 Active interface index         00000000
 Interface descriptor           896f1719
 Endpoint array pointer         896e9c50
        Endpoint address:       896eabd0
         Device:    896EAC10
         Interface: 896F1790
         Desc:      896F1722
         Number:    01
         Pipe:      896CD890

 Endpoint count                 00000001
 Private handle                 0000000000000000
 Interface spin lock            0000003a
 SDA>

8  –  OHCI

   Shows information about the selected Open Host Controller Interface
   controller.

8.1  –  BULK

   Shows head endpoint for the bulk list.

   Format

      USB SHOW OHCI BULK

8.1.1  –  Example

 SDA> USB SHOW OHCI BULK
 ED[64]
 ED Flink            89602ddc
 ED Blink            89602ddc
 ED headED           00000000
 ED physical address 00000028
 ED bandwidth        00000000
 ED next             000000ff
 ED flags            00000001
 SDA>

8.2  –  CONTROL

   Shows the head endpoint for the control list.

   Format

      USB SHOW OHCI CONTROL

8.2.1  –  Example

 SDA> USB SHOW OHCI CONTROL
 ED[63]
 ED Flink            89720800
 ED Blink            89720800
 ED headED           00000000
 ED physical address 00000020
 ED bandwidth        00000000
 ED next             000000ff
 ED flags            00000001
 SDA>

8.3  –  EDLIST

   Shows the Endpoint list head at a specified address.

   Format

      USB SHOW OHCI EDLIST [address]

8.3.1  –  Example

 SDA> USB SHO OHCI EDLIST 896028DC
 ED Flink            896028dc
 ED Blink            896028dc
 ED headED           89720000
 ED physical address 8972003c
 ED bandwidth        00000000
 ED next             000000ff
 ED flags            00000000
 SDA>

8.4  –  ENDPOINT

   Displays Endpoint list head data.

8.4.1  –  Number

   Shows the specified Endpoint list head.

   Format

      USB SHOW OHCI ENDPOINT 1

8.4.2  –  A

   Shows all the Endpoint list heads.

   Format

      USB SHOW OHCI ENDPOINT ALL

8.4.3  –  BULK

   Shows the Bulk list head Endpoint

   Format

      USB SHOW OHCI ENDPOINT BULK

8.4.4  –  CONTROL

   Shows the Control list head Endpoint.

   Format

      USB SHOW OHCI ENDPOINT CONTROL

8.4.5  –  Interrupt

   Shows the Interrupt list head Endpoint.

   Format

      USB SHOW OHCI ENDPOINT INTERRUPT

8.4.5.1  –  Example

 SDA> USB SHOW OHCI ENDPOINT 1
 ED[01]
 ED Flink            896028f0
 ED Blink            896028f0
 ED headED           89720040
 ED physical address 8972007c
 ED bandwidth        00000000
 ED next             00000000
 ED flags            00000000

8.5  –  HCCA

   Shows the contents of the Host Communcations Area.

   Format

      USB SHOW OHCI HCCA

8.5.1  –  Example

 SDA> USB SHO OHCI HCCA
 OHCI controllers host communications area
 Physical pointer 454403f0 to interrupt endpoint 00
 Physical pointer 454405f0 to interrupt endpoint 01
 Physical pointer 454404f0 to interrupt endpoint 02
 Physical pointer 454406f0 to interrupt endpoint 03
 Physical pointer 45440470 to interrupt endpoint 04
 Physical pointer 45440670 to interrupt endpoint 05
 Physical pointer 45440570 to interrupt endpoint 06
 Physical pointer 45440770 to interrupt endpoint 07
 Physical pointer 45440430 to interrupt endpoint 08
 Physical pointer 45440630 to interrupt endpoint 09
 Physical pointer 45440530 to interrupt endpoint 10
 Physical pointer 45440730 to interrupt endpoint 11
 Physical pointer 454404b0 to interrupt endpoint 12
 Physical pointer 454406b0 to interrupt endpoint 13
 Physical pointer 454405b0 to interrupt endpoint 14
 Physical pointer 454407b0 to interrupt endpoint 15
 Physical pointer 454403f0 to interrupt endpoint 16
 Physical pointer 454405f0 to interrupt endpoint 17
 Physical pointer 454404f0 to interrupt endpoint 18
 Physical pointer 454406f0 to interrupt endpoint 19
 Physical pointer 45440470 to interrupt endpoint 20
 Physical pointer 45440670 to interrupt endpoint 21
 Physical pointer 45440570 to interrupt endpoint 22
 Physical pointer 45440770 to interrupt endpoint 23
 Physical pointer 45440430 to interrupt endpoint 24
 Physical pointer 45440630 to interrupt endpoint 25
 Physical pointer 45440530 to interrupt endpoint 26
 Physical pointer 45440730 to interrupt endpoint 27
 Physical pointer 454404b0 to interrupt endpoint 28
 Physical pointer 454406b0 to interrupt endpoint 29
 Physical pointer 454405b0 to interrupt endpoint 30
 Physical pointer 454407b0 to interrupt endpoint 31
 Hcca Frame Number                0000f57d
 Hcca Frame pad                   00000000
 Hcca Done Head                   00000000
 SDA>

8.6  –  HCDED

   Shows the Host Controller Drivers Endpoint data structure.

   Format

      USB SHOW OHCI HCDED [address]

8.6.1  –  Example

 SDA> USB SHOW OHCI HCDED 89720840
 flink             89602968
 blink             89602968
 type              3
 EDlist_index      7
 PausedFlag        0
 endpoint_state    1
                   Endpoint active
 PhysicalAddress   45440870
 pipe              8975ce10
 headTD            8971f5c0
 tailTD            8971f600
 ReclamationFrame  0
 request_count     1
 PausedLink flink  0
 PausedLink blink  0
 last_request      8975de20
 usb_address       00000002
 endpoint_number   00000001
 direction         00000002
                   Out
 speed             00000001
 skip              00000000
 Format            00000000
 MaximumPacketSize 00000008
 TailP             04543163
 Halted            00000000
 toggleCarry       00000001
 HeadP             0454315f
 NextED            454400f0
 SDA>

8.7  –  HCDTD

   Shows the Host Controller Drivers Transmit Descriptor data structure.

   Format

      USB SHOW OHCI HCDTD [address]

8.7.1  –  Example

 SDA> USB SHOW OHCI HCDTD 8971fd80
 TDStatus          3
                   Transmit notfilled
 CancelPending     0
 VirtualAddress    8971fd80
 PhysicalAddress   45431db0
 nextTD            00000000
 request           00000000
 ED                00000000
 TransferCount     0
 BufferRounding    00000001
 Direction_PID     00000002
                   in from endpoint
 DelayInterrupt    00000000
 DataToggle        00000003
 ErrorCount        00000000
 ConditionCode     00000000
 CBP               00000000
 NextTD            00000000
 BE                00000000
 SDA>

8.8  –  INTERRUPT

   Format

      USB SHOW OHCI INTERRUPT [interrupt-interval 1,2,4,8, 16, 32]

8.8.1  –  Example

 SDA> USB SHO OHCI INTERRUPT 1
 ******************************************
 Dumping 1Ms list heads and attached ED's
 ******************************************

 ED listhead[0]:
 ED Flink            896028dc
 ED Blink            896028dc
 ED headED           89720000
 ED physical address 8972003c
 ED bandwidth        00000000
 ED next             000000ff
 ED flags            00000000

 Head ED address 89720000
 flink             00000000
 blink             00000000
 type              0
 EDlist_index      0
 PausedFlag        0
 endpoint_state    0
                   Endpoint unknown state
 PhysicalAddress   45440030
 pipe              00000000
 headTD            8971e000
 tailTD            8971e000
 ReclamationFrame  0
 request_count     0
 PausedLink flink  0
 PausedLink blink  0
 last_request      00000000
 usb_address       00000000
 endpoint_number   00000000
 direction         00000000
                   Get direction from TD
 speed             00000000
 skip              00000001
 Format            00000000
 MaximumPacketSize 00000000
 TailP             04543003
 Halted            00000000
 toggleCarry       00000000
 HeadP             04543003
 NextED            00000000
 SDA>

8.9  –  REGISTERS

   Displays the last saved contents of the device's operating
   registers if looking at a crash.  On a running system, displays
   the contents of the registers that are just read.

   Format

      USB SHOW OHCI REGISTERS

8.9.1  –  Example

 SDA> USB SHO OHCI REGISTERS
 Current OHCI registers as read from the controller
 HcRevision                                   00000010
 HcControl                                    000000B4
    Control to Bulk ratio 1 : 1
    Periodic List Enabled
    Isochronous Disabled
    Control List Enabled
    Bulk List Enabled
    USB Operational
    Interrupts routed to bus
    Remote Wake Up not connected
    Remote Wake Up Disabled
 HcCommandStatus                              00000000
    Scheduling Overrun Count 0
 HcInterruptStatus                            00000004
    Start of Frame Detected
 HcInterruptEnable                            C000007B
    Interrupt on Scheduling Overrun
    Interrupt on addition to done head
    Interrupt on Resume
    Interrupt on Frame number overflow
    Interrupt on Root Hub Status Change
    Interrupt on Ownership change
    Interrupt on Scheduling Overrun
    Master Interrupt Enabled
 HcInterruptDisable                           C000007B
 HcHCCA                                       45451D00
 HcPeriodCurrentED                            00000000
 HcControlHeadED                              45440830
 HcControlCurrentED                           00000000
 HcBulkHeadED                                 00000000
 HcBulkCurrentED                              00000000
 HcDoneHead                                   00000000
 HcFmInterval                                 A7782EDF
    Frame Interval                     02edf
    Largest full speed frame in bits   02778
    Frame Interval toggle set
 HcFmRemaining                                800004C2
    Frames remaining                   004c2
    Frames Remaining toggle is set
 HcFmNumber                                   0000F6DA
 HcPeriodicStart                              00002A27
 HcLSThreshold                                00000628
 HcRhDescriptorA                              FF000903
    Number of down stream ports          03
    Ports are power switched
    Ports powered individually
    Overcurrent reported on per port basis
    Power on to power good in Ms 510
 HcRhDescriptorB                              000E0000
    Device Removeable bit mask   0000000000000000
    Port Power control bit mask  0000000000001110
 HcRhStatus                                   00000000
 HcRhPortStatus[01]                           00000303
    Device connected
    Port Enabled
    Port power is on
    Low speed device attached
 HcRhPortStatus[02]                           00000100
    No Device connected
    Port Disabled
    Port power is on
 HcRhPortStatus[03]                           00000100
    No Device connected
    Port Disabled
    Port power is on
 SDA>

8.10  –  UCB

   Displays the OHCI drivers extensions to a standard UCB.

   Format

      USB SHOW OHCI UCB

8.10.1  –  Example

 SDA> USB SHO OHCI UCB
 Open Host Controller UCB extensions
 Direct DMA window base address      0000000000000000
 I/O handle                          ffffffff896f7a40
 Pointer to USB structure            89700d50
 Pointer to saved device registers   89718f00
 Pointer to HCCA                     8971dd00
 HCCA PCI buss address               45451d00
 Controler revision                  00000010
 Root hub address                    00000001
 Number of ports                     00000003
 Status change request queue
                            Flink    89723210
                            Blink    89723210
 Connected end points queue
                            Flink    89602898
                            Blink    89602898
 Free Endpoints queue
                            Flink    897208c0
                            Blink    897207c0
 Count of free ED                    0000005d
 Free transfer descriptor queue
                            Flink    8971fd80
                            Blink    8971fcc0
 Count of free TD                    0000005a
 Used transfer descriptor queue
                            Flink    8971e00c
                            Blink    8971fd4c
 Count of used TD                    00000025
 Stalled endpoint descriptor queue
                            Flink    896028c4
                            Blink    896028c4
 Running endpoint descriptor queue
                            Flink    896028cc
                            Blink    896028cc
 Paused endpoint descriptor queue
                            Flink    896028d4
                            Blink    896028d4
 ED lists will not be displayed
 Frame Hight part                    00070000
 Available Bandwidth                 00000064
 Used Bandwidth                      00000008
 SO count                            00000000
 SO stall Frame                      00000000
 SO Limit Frame                      00000000
 SO Limit Hit                        00000000
 SO Stall Hit                        00000000
 UCM message mailbox                 00000000
 Vendor ID                           00001033
 Device ID                           00000035
 SDA>

9  –  PIPE

   Displays the USB Pipe data structures.  A device can have multiple
   pipes.  Pipes are used to describe communication paths to devices.

   Format

      USB SHOW PIPE [address]

9.1  –  Example

 SDA> USB SHO INTERFACE 896f1790
 Structure type is              INTERFACE
 Flags                          00000000
 State                          00008001
                                INTERFACE ACTIVE
                                INTERFACE CONFIG
 Device pointer                 896eac10
 UCB                            00000000
 Skipping config & deconfig routine addresses
 Driver name
 Default interface address      896f1790
 Interface array pointer        896f1790
 Interface count                00000002
 Active interface index         00000000
 Interface descriptor           896f1719
 Endpoint array pointer         896e9c50
        Endpoint address:       896eabd0
         Device:    896EAC10
         Interface: 896F1790
         Desc:      896F1722
         Number:    01
         Pipe:      896CD890

 Endpoint count                 00000001
 Private handle                 0000000000000000
 Interface spin lock            0000003a
 SDA>

10  –  REQUEST

   Formats the USB request data structure.  You can display the
   data structure or event tracing information.  The amount of
   tracing data varies from controller to controller.

   Format

      USB SHO REQUEST [address]

10.1  –  TRACE

   Show tracing data for the request through the USB layers.  The
   level of detail varies greatly depending upon which host controller
   is being used.

   Format

      USB SHOW REQUEST TRACE [address]

10.2  –  Examples

10.2.1  –  Trace

   This examples show a request block that has been reused.  The next trace
   entry to be written is marked by "Index -->"

 SDA> USB SHOW REQUEST TRACE 896E9CE0
 Structure type                 00000005
                                REQUEST HANDLE
 Request tracing messages:
                   0:  8-SEP-2008 16:12:45.06 - usbd_alloc_request
                   1:  8-SEP-2008 16:12:45.06 - hub_alloc_request
                   2:  8-SEP-2008 16:12:45.06 - hub_port_status
                   3:  8-SEP-2008 16:12:45.06 - usbd_transfer
                   4:  8-SEP-2008 16:12:45.06 - ehci$queue_to_control_endpoint
                   5:  8-SEP-2008 16:12:45.06 - usbd_callback
                   6:  8-SEP-2008 16:12:45.06 - usbd_callback_thread
                   7:  8-SEP-2008 16:12:45.06 - hub_queue_entry_callback
                   8:  8-SEP-2008 16:12:45.06 - hub_port_change
                   9:  8-SEP-2008 16:12:45.06 - usbd_transfer
                  10:  8-SEP-2008 16:12:45.06 - ehci$queue_to_control_endpoint
                  11:  8-SEP-2008 16:12:45.06 - usbd_callback
                  12:  8-SEP-2008 16:12:45.06 - usbd_callback_thread
                  13:  8-SEP-2008 16:12:45.06 - hub_queue_entry_callback
                  14:  8-SEP-2008 16:12:45.06 - hub_port_change
                  15:  8-SEP-2008 16:12:45.06 - hub_request_status
                  16:  8-SEP-2008 16:12:45.06 - usbd_transfer
                  17:  8-SEP-2008 16:12:45.06 - ehci$queue_to_int_endpoint
  Index -->       18:  8-SEP-2008 16:12:44.81 - hub_free_request
                  19:  8-SEP-2008 16:12:44.81 - usbd_free_request
                  20:  8-SEP-2008 16:12:44.41 - ehci$queue_to_control_endpoint
                  21:  8-SEP-2008 16:12:44.41 - ehci$emulate_root_hub
                  22:  8-SEP-2008 16:12:44.41 - ehci$get_port_status
                  23:  8-SEP-2008 16:12:44.41 - usbd_callback
                  24:  8-SEP-2008 16:12:44.41 - usbd_callback_thread
                  25:  8-SEP-2008 16:12:44.41 - hub_queue_entry_callback
                  26:  8-SEP-2008 16:12:44.41 - hub_port_change
                  27:  8-SEP-2008 16:12:44.41 - hub_request_status
                  28:  8-SEP-2008 16:12:44.41 - usbd_transfer
                  29:  8-SEP-2008 16:12:44.41 - ehci$queue_to_int_endpoint
                  30:  8-SEP-2008 16:12:44.41 - ehci$q_to_root_hub_int_endpoint
                  31:  8-SEP-2008 16:12:44.41 - ehci$emulate_root_hub_interrupt
                  32:  8-SEP-2008 16:12:44.42 - ehci$emulate_root_hub_interrupt
                  33:  8-SEP-2008 16:12:44.42 - ehci$emulate_root_hub_interrupt
                  34:  8-SEP-2008 16:12:44.42 - usbd_callback
                  35:  8-SEP-2008 16:12:44.42 - usbd_callback_thread
                  36:  8-SEP-2008 16:12:44.42 - hub_queue_entry_callback
                  37:  8-SEP-2008 16:12:44.42 - hub_status_change
                  38:  8-SEP-2008 16:12:44.42 - hub_free_request
                  39:  8-SEP-2008 16:12:44.42 - usbd_free_request
 SDA>

10.2.2  –  Data Structure

 SDA> USB SHOW REQUEST  896E9CE0
 Structure type                 00000005
                                REQUEST HANDLE
 Chained request pointer        00000000
 Pipe address                   896cd890
 Private handle                 ffffffff8968a4d0
 Retry count                    00000000
 Saved Buffer length            00000001
 Buffer address                 896cdfd0
 Buffer system physical address 45511fd0
 Buffer length                  00000000
 Maximum delay                  00000000
 ------ Set up device request -----
 Request type                   000000a3
                                Unknown value
 Request type                   00000000
                                Get status
 Value                          00000000
                                Endponit stall
 Index                          00000003
 Length                         00000004
 ------  End device request  -----
 Device request physical address 45501d0c
 Flags                          00000002
 Status                         07719923
 SDA>

11  –  ROOT

   Formats the root hubs data strucutre.  This is the same as show hub
   with the address of the root hub data structure supplied.  It saves
   having to find the root hub's address.

   Format

      USB SHOW ROOT

11.1  –  Example

 SDA> USB SHO ROOT
 Hub address is:                 89749590
 Descriptor header Flink         8974ded0
 Descriptor header Blink         89746690
 Pointer to array descriptor     897317d0
 Index                           00000001
 Flags 0 -> avail 1 ->used       00000001
 Numbers of entries in this chunk00000001
 Descriptor type                 00000002
 Lock                            0000003a
 KPB pointer                     00000000
 Host controller UCB             896f5400
 Device state                    00000010
    DEVICE CONFIGURED
 Device next state               00000000
    UNKNONW STATE
 Port number                     00000000
 Speed 0->full 1->low 2->High    00000000
 Tier level                      00000000
 USB bus address                 00000001
 Reference count                 00000001
 Flag(s) DEVICE_CONFIG_DEVICE
 Default pipe                    89731e90
 Bus device is attached to       89731750
 Upstream hub address            00000000
 Default pipe requests Flink     897495d8
 Default pipe requests Blink     897495d8
 Driver name                     SYS$HUBDRIVER
 Device descriptor length        00000012
 Descriptor type                 00000001
 Revision                        00000200
 Device class                    00000009
 Device sub class                00000000
 Device protocol                 00000000
 Max packet size                 00000000
 Vendor ID                       00001011
 Product  ID                     00000000
 Manufactures index              00000000
 Product index                   00000000
 Serial number index             00000000
 Number of configurations        00000001
 Pointer to configuration array  89723fd0
 Number of configuration desc    00000001
 Active configuration pointer    8974c550
 Pointer to interface desc array 8972f190
 Default interface array ptr     8974c650
 Pointer to endpoint array       8974c690
      Endpoint Address           8974c690
         Device:    89749590
         Interface: 8972F190
         Desc:      8974C562
         Number:    01
         Pipe:      8974DDD0

 Number of interface descriptors 00000001
 Number of endpoint descriptors  00000001
 Config_value                    00000001
 Failed configure attempts       00000000
 Structure type is               HUB
 -----Embeded hub descriptor-----
 Hub descriptor length           00000008
 Descriptor type                 00000029
 Number of ports                 00000005
 Characteristics low byte        00000009
 Characteristics high byte       00000000
 Power on to power good interval 000000ff
 Hub control current             00000000
 Skipping port power control mask
 -----End of embeded hub descriptor-----
 Hub status change endpoint is   00000081
 Status change pipe handle       ffffffff8974ddd0
 Status change requests Flink    89753e10
 Status change requests Blink    89753e10
 Number of ports                 00000005
 Port[1] status is               00000000
         next saved bits         00000005
         status bits
       4-SEP-2008 17:50:09.89 -> 00010001
       4-SEP-2008 17:50:09.99 -> 00010001
       4-SEP-2008 17:50:09.99 -> 00000001
       4-SEP-2008 17:50:10.00 -> 00100403
 IDX:  4-SEP-2008 17:50:10.00 -> 00000403
 Port[2] status is               00000000
         next saved bits         00000000
 Port[3] status is               00000000
         next saved bits         00000000
 Port[4] status is               00000000
         next saved bits         00000000
 Port[5] status is               00000000
         next saved bits         00000000
 Hub flags                       00000000
 Hub port power count            00000000
 Array of downstream device ptrs 8974c710
      Port[1] device address     8974ded0
      Port[2] device address     00000000
      Port[3] device address     00000000
      Port[4] device address     00000000
      Port[5] device address     00000000
 Hub lock is                     0000003a

12  –  TOPOLOGY

   Shows the topology of all devices connected to the selected controller.

   Format

      USB SHOW TOPOLOGY

12.1  –  Example

    This example shows that we have a high speed hub attached to the
    EHA0 high speed controller, and that the high speed hub has a low speed
    function with two interfaces.

 OpenVMS system analyzer

 SDA> usb set con eha0
 Controller set to EHA0
 SDA> usb sho top
 --------------- TIER[0] ---------------
 Root HUB            address is 89749590
 --------------- TIER[1] ---------------
 High Speed HUB      address is 8974ded0
 --------------- TIER[2] ---------------
 Low Speed Function  address is 89750e50
       Interface Address: 89758ED0 UCB: 8975A780 Driver Name: SYS$KBDDRIVER
       Interface Address: 89759010 UCB: 8975E800 Driver Name: SYS$MOUDRIVER
 SDA>

13  –  UHCI

   Displays information about the selected UHCI host controller.

13.1  –  HCDQH

   Shows a Host Controller Qhehe Head Descriptor.

   Format

      USB SHOW UHCI HCDQH [address]

13.1.1  –  Example

 SDA> USB SHO UHCI HCDQH 89fde000
 Host Controller Queue Head
 ----------------------------------  ----------------
 Forward Link pointer                        89fde050
 Backward link pointer                       896e8948
 Structure size                                   048
 Structure type                                    8b
 Structure sub type                                ff
 QH physical address                 00000000001c0040
 Device BUS address                               000
 Endpoint number                                  000
 USBD Endpoint state                         00000000
 Pipe Address                                00000000
 Outstanding Requests                            0000
 Pointer to next HCDTD                       00000000
 Previous Horizontal QH VA                   89fde5f0
 Next Horizontal QH VA                       89fde2d0
 Vertical QH/TD link VA                      00000000
 Flags 1 Permanent, 2 delete pending         00000001
 Last data toggle in a completed PHYTD             00
 Next data toggle to use                           00
 Physical part of Queue Head
 Horizontal Link Pointer                     001c0312
    Queue Head
    Phys Address                             001c0310
 vertical Link Pointer                       00000001
    Terminate set
    Transmit Descriptor
    Phys Address                             00000000
 SDA>

13.2  –  HCDTD

   Shows a Host controller Transmit Descriptor.

   Format

      USB SHOW UHCI HCDTD [address]

13.2.1  –  Example

 SDA> USB SHO UHCI HCDTD 89732100
 Host Controler Transfer Descriptor
 ----------------------------------  ----------------
 Forward Link pointer                        89758598
 Backward link pointer                       89758598
 Structure size                                   040
 Strucutre type                                    8b
 Structure sub type                                fe
 Used TD FLINK                               8973214c
 Used TD BLINK                               896e8928
 USDB Request associated to this TD          897585a0
 VA of HCDQH for this TD 0 for ISOCH         89fde4b0
 HCDTD flags
    HCDTD Active
 Next HCDTD if multiple queued requests      00000000
 Adderess Next byte in buffer if segments    00000000
 Number of bytes left to transfer                0000
 If segmented bytes transfered so far            0000
 Physical TD FLINK                           89fe02c0
             BLINK                           89fe02c0
 SDA>

13.3  –  PHYTD

   Shows a Physical Transmit Descriptor.  A transmission can consist
   of several Physical Transmit Descriptors.

   Format
      USB SHOW UHCI PHYTD [address]

13.3.1  –  Example

 SDA> USB SHO UHCI PHYTD 89fe02c0
 Physical Transfer Descriptor
 ----------------------------------  ----------------
 Forward link                                89732134
 Backward lnik                               89732134
 Size                                           0020
 Type                                             8b
 sub type                                         fd
 Physical address of this TD                 001c22d0
 Physical part of TD
 Link Pointer                                00000001
    Terminate set
    Transmit Descriptor
    Phys Address                             00000000
 Control and Status Field                    05000007
    Transfer length                          00000007
    Transfer status                          00000000
    Interrupt on complete 1 <on>                    1
    Isocronous TD if set                            0
    Low Speed device if set                         1
    Error count                                     0
    Short Packet Detect 1 allow short packet        0
 Token field                                 00e88269
    Packet ID                                      69
    Device_address                                 02
    Endpoint address                               01
    Data Toggle                                     1
    Max XFER Length                              0007
 Data Buffer Physical Address                09756410
 SDA>

13.4  –  PORT

   Show the specified ports status and displays the meaning of the bits.

   Format

      USB SHOW OHCI PORT x

13.4.1  –  HISTORY

   Shows a list of the last 25 port events.

   Format
      USB SHOW UHCI PORT x HISTORY

13.4.1.1  –  Examples

13.4.1.1.1  –  Data

 SDA> USB SHOW UHCI PORT 1
 Port 01 Status and Control Register             05a5
    Current connection Status                       1
    Connection changed State                        0
    Port Enable                                     1
    Port Enable Change                              0
    Line STS                                        2
    Resume Detected                                 0
    Low Speed Device                                1
    Port Reset                                      0
    Suspend                                         0
 SDA>

13.4.1.1.2  –  History

 SDA> USB SHOW UHCI PORT 1 HISTORY
 Port 1 state change history
                   0:  9-SEP-2008 17:55:35.31 - 05a3
                   1:  9-SEP-2008 17:55:35.67 - 05a5
  Index -->        2:  9-SEP-2008 18:03:05.42 - 05a5
 SDA>

13.5  –  REGISTERS

   Displays the last saved contents of the device's operating
   registers if looking at a crash.  On a running system, displays
   the contents of the registers are just read.

   Format

      USB SHO UHCI REGISTERS

13.5.1  –  Example

 SDA> USB SHOW UHCI REGISTERS
 Current UHCI operating registers as read from the controller

 Extended Host Controller Operating Registers
 ----------------------------------        ----------
 USB Commad Register                               01
    Run/Stop                                        1
    Host Controller Rest                            0
    Global Reset                                    0
    Enter Global Suspend                            0
    Forced Global resume                            0
    Software Debug                                  0
    Configure Flag                                  0
    Max Packet 1 -> 64 0 -> 32 bytes                0
 USB Status Register                               00
    TD completed                                    0
    Error Occured                                   0
    Device Resumed                                  0
    Host HW error                                   0
    Error processing TD                             0
    Controller Halted                               0
 USB Interrupt Enable Register                     0f
    Timeout                                         1
    Resume                                          1
    Interrupt on Completion                         1
    Short Transfer                                  1
 Frame Index Register                            06a6
 Frame List Base Address                     001be000
 Start or Frame Timing Modification                40
 Port 01 Status and Control Register             05a5
    Current connection Status                       1
    Connection changed State                        0
    Port Enable                                     1
    Port Enable Change                              0
    Line STS                                        2
    Undefined error
    Resume Detected                                 0
    Low Speed Device                                1
    Port Reset                                      0
    Suspend                                         0
 Port 02 Status and Control Register             0580
    Current connection Status                       0
    Connection changed State                        0
    Port Enable                                     0
    Port Enable Change                              0
    Line STS                                        0
    Port enabled
    Resume Detected                                 0
    Low Speed Device                                1
    Port Reset                                      0
    Suspend                                         0
 SDA>

13.6  –  TRACE

   Decodes the what driver tracing is enabled.  Just because it
   is enabled does not mean it is active.  SDA tracing must be
   loaded and active.

   Format

      USB SHOW UHCI TRACE

13.6.1  –  Example

 SDA> usb sho uhci trace

 The following trace points are active  00000000000000ff
 -------------------------------------------------------
    Control requests
    Interrupt requests
    Bulk requests
    Make TD's for request active on controller
    Report setting for TD's toggles
    Completions of TD's
    Log everytime Interrupt Service Routine is called
    Normal successful interrupts
 -------------------------------------------------------

13.7  –  UCB

   Displays the UHCI drivers extensions to a standard UCB.

   Format

      USB SHOW UHCI UCB

13.7.1  –  Example

 SDA> USB SHOW UHCI UCB

 Universal Host Controller UCB extensions
 ----------------------------------  ----------------
 I/O handle                          ffffffff8971fa00
 Direct DMA Base                     0000000000000000
 Frame List PA                       00000000001be000
 Frame List VA                               89fdc000
 Register Offset                             00000000
 Number of root hub ports                          02
 Logging mailbox ucb address                 00000000
 Pointer to USB BUS structure                8971ca10
 Pointer to routine driver table             89730000
 Root Hub address                            00000001
 Status change request queue
                       FLINK                 89750ad0
                       BLINK                 89750ad0
 Free HCDTD's
                       FLINK                 897332c0
                       BLINK                 89733200
 Used HCDTD's
                       FLINK                 8973324c
                       BLINK                 8973328c
 Count of free HCDTD's                           007d
 Count of used HCDTD's                           0002
 Free physical TD's
                       FLINK                 89fe1f60
                       BLINK                 89fe1f00
 Count of free PHYTD's                           00fd
 Count of used PHYTD's                           0002
 Free HCDQHD's
                       FLINK                 89fde550
                       BLINK                 89fde550
 Used HCDQHD's
                       FLINK                 89fde460
                       BLINK                 89fde460
 Count of free HCDQH's                           0056
 Count of used HCDQH's                           0004
 Permanent Queue Heads
 Interrupt period   1 Ms                     89fde000
 Interrupt period   2 Ms                     89fde050
 Interrupt period   4 Ms                     89fde0a0
 Interrupt period   8 Ms                     89fde0f0
 Interrupt period  16 Ms                     89fde140
 Interrupt period  32 Ms                     89fde190
 Interrupt period  64 Ms                     89fde1e0
 Interrupt period 128 Ms                     89fde230
 Unlink Queue Head                           89fde280
 Low Speed Control Queue Head                89fde2d0
 Full Speed Control Queue Head               89fde320
 Bulk Queue Head                             89fde370
 Terminate Queue Head                        89fde3c0
 Root hub poller 1 -> active                        1
 Bit mask of root hub ports finished reset   00000000
 Total interrupts                    0000000000000562
 TD complete interrupts              0000000000000562
 TD error interrupts                 0000000000000000
 Count of resume events              0000000000000000
 Number of times controller halted   0000000000000000
 TQE and PCI config space data omitted
 Error counters
  I/O's completed with error(s)              00000555
  Bit stuffing error(s)                      00000000
  CRC error                                  00000000
  NAK receied                                00000555
  Babble detected                            00000000
  Data Buffer error(s)                       00000000
  Stall event(s)                             00000000
  Timeout error(s)                           00000000
 Saved operating registers
 Command                                         0001
 Status                                          0000
 Interrupt Summary                               000f
 Frame Number                                    0000
 Frame list address                          001be000
 Start of Frame time modifier                      40
 Root Hub Port 1                                 05a5
          Port 2                                 0580
 Port History next slot                          0002
 Debug tracing bits                  00000000000000ff

 SDA>
Close Help