UEFI Tool for HS USB Host Mode Electrical Testing

Change History

• [02/2018] v2.1 Port changes from boot.xf.2.0 and boot.xf.2.2.
• [09/2017] v2.1 Added support to enable SS TX compliance testing, updated command line interface.
• [06/2013] v2.0 Added support for Xhci host controller, updated command line interface.
• [07/2012] v1.5 Add support of multiple USB host controllers and testing of downstream hub ports. Please reset the hub/device after each test.
• [01/2012] v1.0 Initial release

Introduction

USB electrical testing typically involves a software HSETT developed by Intel. Most of the test equipment vendors like Agilent/Tektronics base their USB electrical testing procedures on HSETT. The problem with HSETT is that it does not run natively in DUT, thus not possible to use for Host mode electrical testing.

This page introduces a UEFI command line tool/application "UsbHostPortTestApp.efi" that can be used as HSETT for high-speed host mode electrical testing. The tool was developed during the process of testing 8960/8064/8974 EA high-speed USB in host mode, and the scope is Agilent Infinnium. The following test cases are supported for the testing of roothub ports:

• Host Hi-Speed Signal Quality
• Host Controller Packet Parameters
• Host CHIRP Timing
• Host Suspend/Resume Timing
• Host Test J/K, SE0_NAK
• Host Disconnect Detect
• Host SS compliance tests

And the following test cases are supported for non-root hub downstream ports (i.e. hub ports):

• Hub Hi-Speed Signal Quality Test - Downstream Facing Ports
• Hub Jitter Test - Downstream Facing Ports
• Hub Test J/K, SE0_NAK - Downstream Facing Ports

Following sections explains the tool's CLI interface and the procedures to conduct each tests list above.

Command Line Interface of UsbHostPortTestApp

After booting into UEFI shell, type "exit" to quit into SBL shell. Then type "cd fv1:" to enter the firmware volume where the command line application resides. Run the command with no options to display the list of available options.

    Qcom fv1:\> start UsbHostPortTestApp
    ERROR: at least 2 arguments required (0 supplied)
    High-speed USB Host Mode Electrical Test Tool version 2.0
    Usage: UsbHostPortTestApp "CONTROLLER_ID TEST_MODE_ID [HUB_PORT_ID]"
      Controllers:
        ID  Description
         0  Ehci PortTest protocol on core 0
              Has 3 port hub (1 based index)
         1  Xhci PortTest protocol on core 128
      Test Modes:
        ID  Description
         0  TEST_DISABLE
         1  TEST_J_STATE
         2  TEST_K_STATE
         3  TEST_SE0/NAK
         4  TEST_PACKET
         5  TEST_FORCE_ENABLE
         6  SS compliance enable
        10  Suspend
        11  Resume
        12  Single step get device descriptor (HC packet parameters)
        13  Suspend+reset (Chirp timing)
       101  TEST_J_STATE (Hub)
       102  TEST_K_STATE (Hub)
       103  TEST_SE0/NAK (Hub)
       104  TEST_PACKET (Hub)
       105  TEST_FORCE_ENABLE (Hub)

• All arguments must be placed in a single set of quotes (see Usage line of help).
• The controllers listed and any hubs on their root ports are dynamically populated at runtime, however, the controller ID values will be consistent across multiple runs.
• Options 1-5 are open-ended in that once the DUT is put into certain test mode it will stay in that mode till option 0 (TEST_DISABLE) is issued. An exception is that options 1-3 can be issued in tandem for "Host Test J/K, SE0_NAK".
• The HUB_PORT_ID argument is only required for the hub test modes (101-105) and will be ignored if supplied with other test modes.

High-speed USB Host Mode Electrical Testing

USB test instructions often refer to the screenshots of HSETT. To make it easier to correlate HSETT instructions with UsbHostPortTestApp command line options, users are recommended to read Agilent USB Electrical testing notes: http://www.usb.org/developers/docs/USB_Electrical_Testing_Notes.pdf. Following sections will list Agilent instructions along side the instructions for UsbHostPortTestApp.efi. Don't worry if you don't have Agilent scope in your lab because all vendors refer to the same HSETT in their documents.

• The following examples use the Xhci controller's root port for testing, so the CONTROLLER_ID used is 1.
• For each test, if previous tests involve any of the UsbHostPortTestApp options 1-5, use option 0 to reset first.

Host Hi-Speed Signal Quality

Host Controller Packet Parameters

Host CHIRP Timing

Host Suspend/Resume Timing

Host Test J/K, SE0_NAK

Host Disconnect Detect

• Note: Disconnect detect is no longer required for USB electrical compliance, according to this compliance update.
  

Hub Port Test Modes

• The following examples use the Ehci controller's hub port 1 for testing, so the CONTROLLER_ID used is 0 and the HUB_PORT_ID is 1.
• The hub will need to be reset between each test run.

Hub Hi-Speed Signal Quality - Downstream Facing Ports

Hub Jitter Test - Downstream Facing Ports

Hub Test J/K, SE0_NAK - Downstream Facing Ports

Super-speed USB Host Mode Electrical Testing

Notes:

• For each test, if previous tests involve any of the UsbHostPortTestApp options 1-5, use option 0 to reset first.
• Procedure to enable SS compliance:
  • 1. Controller needs to be running/active (RS bit set)
  • 2. Detach downstream test dongle.
  • 3. Run UsbHostPortTestApp "0 6" to enable SS compliance mode.
  • 4. Attach downstream dongle.
  • 5. Run tests