From nobody Thu Oct 02 19:22:45 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 4cd1sc32RRz69rh9 for ; Thu, 02 Oct 2025 19:23:00 +0000 (UTC) (envelope-from marklmi@yahoo.com) Received: from sonic316-54.consmr.mail.gq1.yahoo.com (sonic316-54.consmr.mail.gq1.yahoo.com [98.137.69.30]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4cd1sb5y2Lz3HB8 for ; Thu, 02 Oct 2025 19:22:59 +0000 (UTC) (envelope-from marklmi@yahoo.com) Authentication-Results: mx1.freebsd.org; none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1759432977; bh=B+TinOrQMFwTeXJsIC/zslOBdwNSrFlfdFOvHVl+oeI=; h=Subject:From:In-Reply-To:Date:Cc:References:To:From:Subject:Reply-To; b=kazyhLxIdtS/YXnDi3j7pd03kaoFpmw0GRHj023KDoKu082uzSmPbNr61NR4qr9YmHEpB4shqMbKksfHuxd0PPSiVm5NyKnzMg+l721T/Uo5XZiRPPOhGaH2rXJOUYKRdf4yAzetVyWMXJMybdSLycwiQxmx527oIq9TY9ovZ1yB4pKYerAmAFh12xIp21BlwmEO0X9CIWd9n5pDIFOGM4tr8/9bRbwqZQzygDTMeNNFEvaAS7jPvJ6MPyciISJiu4egFcsUuXvAMPAGETaZ722kJs2p7iAErUTajwS8QlSlilJoP3j0+xfgos5hM2nOTTKBhHkkx3p1j4Ti4yIvUQ== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1759432977; bh=8FqFnonQDsch5terGGF9Imb5hRLJ+lR9KNU+8odH1Lh=; h=X-Sonic-MF:Subject:From:Date:To:From:Subject; b=WImcYXM8ye/lWF9y3J+TkLguTqPLWY3qs2lel1fD3Capj/q3m7EBrflvzzWi4V45Ptwuy0Az6U9PbOBAfhPhWIUBNvXMOKg4oPKmTqFwMvBWoFoHNEWo4w3PgFan4ExVAYEhdKw0o1TSLGKU/8ZKTqJClEEu21Uy74ESJd1c85CaSh7bYKaeBCq/Agau2UqoZlR/w8iaucowmIoLeZwYgTi9E2T/AgHcgJmNjS8E4HduJIBj+lCgdsDwv1jQq5GJ/OUs82nH+gS7FMwpHKmxj+MSRqR2NwJXNFWOXtL72PzpkMDo3ZYXrVe/M6BfcHjAK6wnXeBN00CJE7EG3rfmQA== X-YMail-OSG: UMWNInwVM1mWBoI1pvZwciepbvK0wR2VWR2J0C75_eYxtU9hcRRRKNYBBavWvec 85CSkTTS9e6Q4U5UKeCLSuFXJ_44nKUR3nU6CRNf2B2T3GZaGPrZNJdiHowu0jmbSly6qENZ2qEm o_Y6thYe4bRARtr3CB2Wvxl9BoQ6UHY2YoaUkh_MPm17KH7xvmF_bj3WAlikG0LBU8RyccpXqHWa nH5EmBQ6m81p71CARIFNt8S0367fYZgBerPkshNofCFmwJTeDc6fp3KS_7Jujg_JBlPu1Z9I3J9U gwdFIlyHvfnK_._QAxOnVCBCW9fuFiucG9D.porHUCovHzXJO39qnGjsVhF09K9Ws3QfReRWo.dk BRLp0_d2HvaBZdHCBZw1wQfUHg4E5rYt7.CpaZCRRycHdUEeIklG95IC6SWyxci7F3OiiymperHZ DYhMyuHs2oQdZ.QdU1XEkvnMDgqZjThzQbcewj1P6oxpf7ytBC6y08yMDYSJYbXFjLQ2nkIPN36u spZ0BDK4lOOqnans2OvRs4AD.zyfuT8bgVNp6qnuzWNHQcGO4E5xjBM6lvgC.nZUQtACVngL.tWV kXWf69fCgdTvZ6Ch3PbkEiE7MQiYiwN1SrzlSRJ.b7YAKDGUa8kfaUttHw_t5PfqP5bUrSqQjKdX 4zMBEMA7RGnQqMEFS14pBm3NG1EyAOBSjvCR325TPpX28fDMon2foH.PDcS3dvJ6cOZbtffq_NSo JdmxFEYSoTEBPZijA9RmNLlAuUFtV1ewleuCzHx5iZSZiD5c6QRa_8Z9KnDqCaWJpB8TSg.KE9vH lc6aic7DAU79VwzJd3DBMoBAHSqJymiCLT8YAKf1D9V1.Q6rzOpUyvpOvo6K4ZTGYsiqYoXRjzS6 325Z4VqPczxC_m4tOsm6sHwWPzR4s9tbPslae94eKjZiQ1PfjfaAW5UKSZCnfhY4EM0fq2Gk2sIv j.of5mnCE648hUOXTR6zm0IAk8APLjDXgXclo9poLqGpqNe6XV.B3ZWZr9HVQEyqq7tDV4f_igzv 8LMT4t8ma7U7u4_PuTrGkJysn2sM372_o949iS4fpr1IGDHEcatCrFKBZhR.7eqd1p85MJwQlksj QeFIqJGe66wsTdAPuYT5ggc7o5IFezPqt9lFuAmxZ_FqHgnIcsndGa1wG1z3qgb286RMT9z.dH6J X5VXM0WVtrGx_I93wGmMxjUoBJ4RbFPDgvPT_lav.H18i6WLxVr3pU8FvQOfovzqd_lxFZ5LJziX 8X0xIvBZtrzkw0jIcAY97XpG0sMfZOvs7GisaI1E1CgFnLG6GXxNyhPKdAznEtAJHgT8_tHrhXFk yxX8NvdPajno5K__sXj8O_MKabnI9c74crQXQhnxMp3Qvuy94qYoW5kJ_8EIi78Gqr.Q4KXi7HLQ 5xFsOaTkMn4KTTa6a8NOM2.WyzqFOnAHESQl86Du75_LBLhxlshvPEStO6OJocertEYq6uLK6xd8 Q7AI3TAL0TuE5dLMeK1clwFnwbz3waOofUlulhi8YNnnHvqBbMl6A8Rb4e4Q_HOjSeLu4IOolJJL UDys.s0v7KpBXjGtwhqI7KF6Pu5cKK62tPjgyxdKL02AhrAY.1lepc7ENmSAXl885qbpycl9QKzf RXSStgqbetTiu2lrmRGu08EpDQEDh4.t4hFv4PCG3Rtz_P1hu8AkBuBLLbx562TVJbEL0yFrT0es M21fZTgQ5crIOxu7DoX1BRG1D8FvB2qbbdQ0QBgq8u.ZUUo8dmN2teLGCCsYuoErZok7x4EPdb_x f2MXLZ0v0R4c11JJw0KhjQqjIxYAmU9hNx5NGAGY3qxcbJHK4psBtzzRz6UH4Qt7Qho05Jy8iKmI s2k53tMEu4Kl3JPZe7InVj.OcvmhnK7neL1oz1bLyFgqjoRNaqw1Q1ZNZ7DJ_ZJpf8WedDfRIaXQ QZ5W30hjDvNrfQmgQe8wOh2QgWSKMkehnx.cUtpUcnqTK2eKg3KI2V__0KaJHZJTIwiuW74AcXZi fuQSO0qx9ivCkefaO9KmC3c_kBk4ned2ipiWQdqX_.K0WsYeA4BQNawjfJ9w8MOLytFx4CqNG3Ir JNtPJw9ZMRdD2lcJB6wyp0lMC26wdJ7gytLTR0UxarEd2gAMUTMOs2X9r5zOiFG0Wggq2rmTVF2s Cs4ibZwuUzkKE4a1obyFOol9qIzSBC1t5PzQXq.2Jv07IL7Q6u6vxWavX0.Ij4swtbXEHl3pVPsq VrIPKi_kDd_iYqFTjUZvw8YPU5HM- X-Sonic-MF: X-Sonic-ID: 08078370-9a0f-4f7c-b613-cd7b9266a81a Received: from sonic.gate.mail.ne1.yahoo.com by sonic316.consmr.mail.gq1.yahoo.com with HTTP; Thu, 2 Oct 2025 19:22:57 +0000 Received: by hermes--production-gq1-66b66ffd5-ls9xm (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID 5bd33aa0565942b6ec12bd50e35fdd58; Thu, 02 Oct 2025 19:22:56 +0000 (UTC) Content-Type: text/plain; charset=us-ascii 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 (Mac OS X Mail 16.0 \(3826.700.81\)) Subject: Re: git: 2f7a796b590e - main - thunderbolt.4: Initial manual for HW Relnotes From: Mark Millard In-Reply-To: Date: Thu, 2 Oct 2025 12:22:45 -0700 Cc: ziaee , dev-commits-src-main , obiwac Content-Transfer-Encoding: quoted-printable Message-Id: <8C91D367-E9E5-4750-AA81-8C673000778E@yahoo.com> References: To: Alexander Ziaee X-Mailer: Apple Mail (2.3826.700.81) X-Spamd-Bar: ---- X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:36647, ipnet:98.137.64.0/20, country:US] X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-Rspamd-Queue-Id: 4cd1sb5y2Lz3HB8 On Oct 2, 2025, at 10:25, Alexander Ziaee wrote: > 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=3D2f7a796b590e67c5d123f2b00b3aaf7b= a7a32a13 >>>=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. >=20 > 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 is in, allegedly, and so it's existence needs to be mentioned = in the canonical places where we mention our drivers because people are = looking for them for assorted reasons. I've actually booted a Dell Precision 5490 via external USB4 media, but only when it was downstream of a Thunderbolt 3 hub. All 4 USB ports are USB4 on this 5490. And that was some time ago: early 2025-Feb with 1500031 of main 15. It saw the USB4 media as nda0 at nvme0 . This only works as much as it does because the UEFI/ACPI involved supports enough to make some things possible such that FreeBSD does not need to be as involved. As I remember, I set up and did some live-plugging/unlugging experiments any they lead to panics. The configuration had to be as it was at boot time. If I remember right this looked like Thunderbolt 3 mishandling (no surprise). Directly connected, the transition from the kernel to the world/root mount for the USB4 media fails instead. I've not yet tried updating the USB4 media with a more recent FreeBSD main 16 to see what happens now. > Patches to the doc are extremely welcome! I'd need a lot more certainty about interpreting the more informal references that are around vs. the terminology in the USB4 specifications (or other such). I've been more trying to point out subject areas than knowing for sure the details that I used for illustration. > Best, > Alex >=20 >>> +.Sh HISTORY >>> +The >>> +.Nm >>> +driver appeared in >>> +.Fx 15.0 . >>>=20 >>=20 >> =3D=3D=3D >> Mark Millard >> marklmi at yahoo.com >=20 >=20 =3D=3D=3D Mark Millard marklmi at yahoo.com