USB$SDA_HELP.HLB  —  SHOW
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