From nobody Wed Jan 14 13:59:37 2026 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4drnmV08MQz6NS41 for ; Wed, 14 Jan 2026 13:59:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R13" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4drnmT4VHhz49Q0 for ; Wed, 14 Jan 2026 13:59:37 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1768399177; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=5yMYuXTh4FalsChPAu4E3xnnAg4R+QaZPvoOvaBCLqo=; b=I58YBLv8eWPlby7BV3ux1bqi/WfuE/wFLy0YoEmJT2dxpoFyapIgtnn2H11dvPSycRBB/s chTlsyDKJT5Cah/IKDd0+TEVjlry8lKzcLYOw5x8YqUO/iIovEKoPqNfLig/tqVqOLEHVT WbYbppmiHpAQb2cqdxyqti+uxGjYjboguUj5nc3B9ViwNUow2zkGcQZ7eQs4rH7XltaUuz OZWFGWLESm8sjqSo20iuGmUB1FMSRRDGsTdTh2T4RwjSXwa8T1ErGmbinqJgvA2jJuPNHj Xo13HZNqm060BlPIgJKQ0Ld+ywf9l0jpWXCA/+bCv7MZbuNiCvUafpfooxSbTg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1768399177; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=5yMYuXTh4FalsChPAu4E3xnnAg4R+QaZPvoOvaBCLqo=; b=jLQzSUpNmjqYuiRh/AYE8kRFWKOS51z7aEM4VjuZH218rd99mRa1qVtgkdOYNHswosWpAd NcXZmecZIwFiIV2pFYJiyxImyeCOmFC/+9yP4meSP1j8V1ryLC5/DLUEJ9VyHcJT5eJYBL uu0VrabjTjkhMErWEVwP19RD7kbdfFJpbIjdFXIgSBOs/3N7HTSnRLfdRrcHq7LlNo3GYn hBv/mkwVe0F9H4DKvkrE0AjdqbKk0OZiGxKRFyot2IxdWJx0aBaddzVaHGJIHrV3y2sG5t 77t2tzyYtNeqc9tTw4cKUWttwJTgAFqwL80qYFWoaUmuiL8W69yEY6I6qQpN0Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1768399177; a=rsa-sha256; cv=none; b=txgPzkrFuxb4fqVQm7vtVSHsuyqAyCacVsU/sWjzZ4QA65ZoUJURotLaSSdApNUJEP5tFC LCecEtTRYmzDkTS3DU6MTd84YLjUPbzFBsBwSF5/m8uMvKV8KVKrimtawoIoTxopZLOpBt 0a21nZQkuMrExwKDV7pox6AVNhEBKZq7VnNoYhiBTAYeJRDOJcz0VdcYDUaYXHb6JoFZVr dqKpP/iUf6adTRK65CZeGD9pfR1NPTewBupwW6IdaIEnhXVRL7h4BG8li291uCg+luisKW rx4XgDvbgtJjeHisN0vlhz0c2tOucWpwVHL4Hq5t3+3XrHE/vzN80mqK7p8Ykg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4drnmT3Hq6z11cQ for ; Wed, 14 Jan 2026 13:59:37 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 46e1d by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 14 Jan 2026 13:59:37 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Cc: Tom Jones From: Lorenzo Salvadore Subject: git: ab9f7e0239 - main - Status/2025Q4/usb-debugging.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: ab9f7e02392654be6a882ab2cad4a891cde5e5ed Auto-Submitted: auto-generated Date: Wed, 14 Jan 2026 13:59:37 +0000 Message-Id: <6967a149.46e1d.620fff93@gitrepo.freebsd.org> The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=ab9f7e02392654be6a882ab2cad4a891cde5e5ed commit ab9f7e02392654be6a882ab2cad4a891cde5e5ed Author: Tom Jones AuthorDate: 2026-01-10 12:41:24 +0000 Commit: Lorenzo Salvadore 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 + +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 Foundation