From nobody Thu Oct 02 17:25:39 2025 X-Original-To: dev-commits-src-main@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 4cczGN5ymLz69cNQ for ; Thu, 02 Oct 2025 17:25:48 +0000 (UTC) (envelope-from ziaee@runbox.com) Received: from mailtransmit04.runbox.com (mailtransmit04.runbox.com [IPv6:2a0c:5a00:149::25]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (prime256v1) server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4cczGN3gBSz3vy4; Thu, 02 Oct 2025 17:25:48 +0000 (UTC) (envelope-from ziaee@runbox.com) Authentication-Results: mx1.freebsd.org; none Received: from mailtransmit03.runbox ([10.9.9.163] helo=aibo.runbox.com) by mailtransmit04.runbox.com with esmtps (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.93) (envelope-from ) id 1v4N3k-00GDIV-6r; Thu, 02 Oct 2025 19:25:40 +0200 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=runbox.com; s=selector1; h=Message-Id:In-Reply-To:Date:Subject:To:From:MIME-Version: Content-Transfer-Encoding:Content-Type; bh=iEueauTkmCduOgadbd9lYl9I0/wz3DpkQKhvIW+QzfY=; b=0EXwYuSDwy606tq7NmymCEOeD8 EVgkYmsBo2XKVH88gNs7GELna+IwLCQitB6OW98Z4g8LcBpwFJ5I0ZaevgmwC7RPnJ2/U5lWj0cs4 euXPum6q3uybFdZrAahz5286/5HSF2+9hYg2iO2kRfI3WWuHedViy7vko/y9J53a5lopz0N6LxaDA 6SUTi2dwGXXzsAbuAJbPfFgrewPdKioIeIak7+sq1ZuDUTnVquyHR8e7dcssZvaBKHiAtpQ2otsq1 10Bv12g5wnI/oT9YD/HBpRAM9LRuU6ltuWqVmnAW8DHE/4j3Hp6M5Dneqoyx9+os2bW+xaB/GibtV IHVVvEbw==; Received: from [10.9.9.128] (helo=rmmprod06.runbox) by mailtransmit03.runbox with esmtp (Exim 4.86_2) (envelope-from ) id 1v4N3j-0007wm-E7; Thu, 02 Oct 2025 19:25:39 +0200 Received: from mail by rmmprod06.runbox with local (Exim 4.86_2) (envelope-from ) id 1v4N3j-0004oU-CX; Thu, 02 Oct 2025 19:25:39 +0200 Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: quoted-printable List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Received: from [Authenticated alias (1191889)] by runbox.com with http (RMM6); Thu, 02 Oct 2025 17:25:39 GMT From: "Alexander Ziaee" To: "Mark Millard" , "ziaee" , "dev-commits-src-main" , "obiwac" Subject: Re: git: 2f7a796b590e - main - thunderbolt.4: Initial manual for HW Relnotes Date: Thu, 02 Oct 2025 17:25:39 +0000 (UTC) X-RMM-Aliasid: 1191889 X-Mailer: RMM6 In-Reply-To: <1F1B3FF4-A31E-4E9C-8CFC-7BB7F1A38AFD@yahoo.com> Message-Id: X-Spamd-Bar: ---- X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[] X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-Rspamd-Queue-Id: 4cczGN3gBSz3vy4 On 2025-10-02 12:47 -04:00 EDT, "Mark Millard" wrote: > Alexander Ziaee wrote on > Date: Thu, 02 Oct 2025 15:14:07 UTC : >=20 >> The branch main has been updated by ziaee: >>=20 >> URL: https://cgit.FreeBSD.org/src/commit/?id=3D2f7a796b590e67c5d123f2b00= b3aaf7ba7a32a13 >>=20 >> commit 2f7a796b590e67c5d123f2b00b3aaf7ba7a32a13 >> Author: Alexander Ziaee >> AuthorDate: 2025-10-02 12:05:25 +0000 >> Commit: Alexander Ziaee >> CommitDate: 2025-10-02 15:12:48 +0000 >>=20 >> thunderbolt.4: Initial manual for HW Relnotes >>=20 >> This manual contains nothing and is only suitable for the HW Relnotes, >> but lets get it in so we have something and then can iterate on it. >>=20 >> MFC after: 3 minutes >> Fixes: 2ed9833791f2 (thunderbolt: Import USB4 code) >> Discussed with: obiwac >> Differential Revision: https://reviews.freebsd.org/D52847 >> --- >> share/man/man4/Makefile | 1 + >> share/man/man4/thunderbolt.4 | 22 ++++++++++++++++++++++ >> 2 files changed, 23 insertions(+) >>=20 >> diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile >> index f5d7a0e081fc..6e076722c786 100644 >> --- a/share/man/man4/Makefile >> +++ b/share/man/man4/Makefile >> @@ -589,6 +589,7 @@ MAN=3D aac.4 \ >> tdfx.4 \ >> termios.4 \ >> textdump.4 \ >> + thunderbolt.4 \ >> ti.4 \ >> timecounters.4 \ >> tmpfs.4 \ >> diff --git a/share/man/man4/thunderbolt.4 b/share/man/man4/thunderbolt.4 >> new file mode 100644 >> index 000000000000..3477c11fb60d >> --- /dev/null >> +++ b/share/man/man4/thunderbolt.4 >> @@ -0,0 +1,22 @@ >> +.\" >> +.\" Copyright (c) 2025 Alexander Ziaee >> +.\" >> +.\" SPDX-License-Identifier: BSD-2-Clause >> +.\" >> +.Dd October 2, 2025 >> +.Dt THUNDERBOLT 4 >> +.Os >> +.Sh NAME >> +.Nm thunderbolt >> +.Nd USB4 controller driver >> +.Sh SYNOPSIS >> +.Cd device thunderbolt >> +.Sh HARDWARE >> +The >> +.Nm >> +driver supports USB4 controllers. >=20 > As I understand things, being fairly explicit related the > following is likely required (not a proposed wording or > presentation): >=20 > Quoting USB4 V2: "A USB4 Host or USB4 Peripheral Device can > optionally support interoperability with Thunderbolt 3 > (TBT3) products." >=20 > Quoting USB4 V1: "A USB4 host or USB4 peripheral device can > optionally support interoperability with Thunderbolt 3 > (TBT3) products." >=20 > In both, this is tied to Chapter 13, "Interoperability with > Thunderbolt(tm) 3 systems". As I understand FreeBSD is not > trying to meet the criteria in that chapter, for example. >=20 > USB4 does not require a certification process, as I > remember. Thunderbolt 4 and 5 do, as I remember. >=20 > As I remember, a distinction between USB4 and Thunderbolt 4 > and 5 was that Thunderbolt 4 and 5 require (nearly?) all > optional items from the matching USB4 version to be > implemented (so: not optional if Thunderbolt 4 or 5 is > claimed/certified). Also, it seems unlikely that FreeBSD > would go through a Thunderbolt 4 or 5 certification process. >=20 > Overall this seems to mean not meeting the Thunderbolt 4 > and/or 5 criteria fully and not supporting Thunderbolt 3 > --but just meeting the criteria for one or both of: >=20 > ) USB4 V1 without "TBT3" support > ) USB4 V2 without "TBT3" support >=20 > That would be a subset of the Thunderbolt 4 or 5 criteria > in a way that excludes Thunderbolt 3. >=20 > Referencing Thunderbolt without someplace being fairly > explicit about those types of relationships could easily > leave a misimpression (even if I've gotten some of the > status wrong above). >=20 > My guess here is that enough is known about the intent > in this area to be able to have material about this type > of thing in place at any time. My impression is that actually nothing works yet, but we now have a driver = called thunderbolt which is made to support these controllers. The driver i= s in, allegedly, and so it's existence needs to be mentioned in the canonic= al places where we mention our drivers because people are looking for them = for assorted reasons. Patches to the doc are extremely welcome! Best, Alex >> +.Sh HISTORY >> +The >> +.Nm >> +driver appeared in >> +.Fx 15.0 . >>=20 >=20 > =3D=3D=3D > Mark Millard > marklmi at yahoo.com >=20 >=20=