Date: Wed, 14 Jan 2026 13:59:37 +0000 From: Lorenzo Salvadore <salvadore@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Cc: Tom Jones <thj@FreeBSD.org> Subject: git: ab9f7e0239 - main - Status/2025Q4/usb-debugging.adoc: Add report Message-ID: <6967a149.46e1d.620fff93@gitrepo.freebsd.org>
index | next in thread | raw e-mail
The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=ab9f7e02392654be6a882ab2cad4a891cde5e5ed commit ab9f7e02392654be6a882ab2cad4a891cde5e5ed Author: Tom Jones <thj@FreeBSD.org> AuthorDate: 2026-01-10 12:41:24 +0000 Commit: Lorenzo Salvadore <salvadore@FreeBSD.org> CommitDate: 2026-01-14 13:59:17 +0000 Status/2025Q4/usb-debugging.adoc: Add report Differential Revision: https://reviews.freebsd.org/D54280 --- .../report-2025-10-2025-12/usb-debugging.adoc | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/website/content/en/status/report-2025-10-2025-12/usb-debugging.adoc b/website/content/en/status/report-2025-10-2025-12/usb-debugging.adoc new file mode 100644 index 0000000000..abb790aeda --- /dev/null +++ b/website/content/en/status/report-2025-10-2025-12/usb-debugging.adoc @@ -0,0 +1,21 @@ +=== USB Kernel Debugging Improvements + +Contact: Tom Jones <thj@FreeBSD.org> + +XHCI USB controllers offer a mode which allows them to be used as a system debugging interface. +XHCI debug uses a special USB 3 cable with VBUS, D+ and D- disconnected. +The feature can be used to live debug the FreeBSD kernel, enabling investigation of issues which cause the system video console to lock up and there is not an alternative such as a serial console. +This can happen when debugging issues with graphics drivers. + +mailto:hrs@FreeBSD.org[Hiroki Sato] developed support for the XHCI debug interface and made it available as some in progress git branches. +This implementation enables FreeBSD to operate as both a Debug Host and a Debug Target, with support for debugging from the loader through to the kernel. + +In this quarter there has been significant debugging of the debug interfaces associated with the host side of xhci debug. +A custom board was designed to support two debug modes with USB-C, xhci debug and the USB-C Debug Accessory Mode (DAM). +DAM enables an alt mode for USB-C connectors, on some devices such as 2025 Framework laptops and the desktop this mode enables access to a SOC UART for debugging. + +Further revisions of the hardware are needed to create a complete xhci USB-C adapter and a more fully featured DAM adapter. + +Reviews have been created for the loader portion of the implementation and several changes have been extracted out and landed in the tree. + +Sponsor: The FreeBSD Foundationhome | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6967a149.46e1d.620fff93>