# Enable full USB logs in UEFI

Enable full USB logs in UEFI by raising the error level mask and setting
the debug print error level for the required drivers.

Raise the error level mask, and then set the debug print error level for
each driver you want to log. Complete both steps before you rebuild
UEFI.

## Enable full USB logs

1. Update `ERROR_LEVEL_MASK` in `DebugLib.h` to enable the required
log levels.
2. Update `\boot_images\QcomPkg\SocPkg\SC8480XP\Common\Core.dsc.inc`
to set the `DebugPrintErrorLevel` for the required drivers.

#define ERROR_LEVEL_MASK 0xFFFFFFFF
        QcomPkg/Drivers/UsbfnDwc3Dxe/UsbfnDwc3Dxe.inf {
        <PcdsFixedAtBuild>
        gEfiMdePkgTokenSpaceGuid.PcdDebugPrintErrorLevel|0xFFFFFFFF
        <LibraryClasses>
        UsbfnDwc3Lib|QcomPkg/SDMPkg/1000/Library/UsbfnDwc3Lib/UsbfnDwc3Lib.inf
        }
        QcomPkg/Drivers/XhciPciEmulationDxe/XhciPciEmulationDxe.inf
        QcomPkg/Drivers/XhciDxe/XhciDxe.inf {
        <PcdsFixedAtBuild>
        gEfiMdePkgTokenSpaceGuid.PcdDebugPrintErrorLevel|0xFFFFFFFF
        }
        QcomPkg/Drivers/UsbBusDxe/UsbBusDxe.inf {
        <PcdsFixedAtBuild>
        gEfiMdePkgTokenSpaceGuid.PcdDebugPrintErrorLevel|0xFFFFFFFF
        }
        QcomPkg/Drivers/UsbKbDxe/UsbKbDxe.inf
        QcomPkg/Drivers/UsbMassStorageDxe/UsbMassStorageDxe.inf
        QcomPkg/Drivers/UsbMsdDxe/UsbMsdDxe.inf
        QcomPkg/Drivers/UsbDeviceDxe/UsbDeviceDxe.inf
        QcomPkg/Drivers/UsbConfigDxe/UsbConfigDxe.inf {
        <PcdsFixedAtBuild>
        gEfiMdePkgTokenSpaceGuid.PcdDebugPrintErrorLevel|0xFFFFFFFF
        <LibraryClasses>
        UsbConfigLib|QcomPkg/SDMPkg/1000/Library/UsbConfigLib/UsbConfigLib.inf
        }
        QcomPkg/Drivers/UsbInitDxe/UsbInitDxe.inf
        QcomPkg/Drivers/UsbfnChgDxe/UsbfnChgDxe.inf
        Copy to clipboard

## Related

- [Debug UEFI USB with serial logs and JTAG](https://docs.qualcomm.com/doc/80-A0399-8/topic/debug-uefi-usb-serial-jtag.html)
- [Troubleshoot the USB interface](https://docs.qualcomm.com/doc/80-A0399-8/topic/troubleshoot-usb.html)
- [Update the USB PHY tuning parameters for compliance](https://docs.qualcomm.com/doc/80-A0399-8/topic/update-usb-phy-tuning-parameters.html)

Last Published: Sep 17, 2026

[Previous Topic
Read the DWC3 debugfs entries](https://docs.qualcomm.com/bundle/publicresource/80-A0399-8/topics/read-dwc3-debugfs-entries.md) [Next Topic
Debug UEFI USB with serial logs and JTAG](https://docs.qualcomm.com/bundle/publicresource/80-A0399-8/topics/debug-uefi-usb-serial-jtag.md)