From nobody Fri Oct 3 17:52:33 2025 X-Original-To: dev-commits-src-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 4cdbpp4z5fz6BJMS; Fri, 03 Oct 2025 17:52:34 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cdbpp2b2qz3WJg; Fri, 03 Oct 2025 17:52:34 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1759513954; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=3OU+2ftdEt5pyjIKRwaCcO6oqcE/5R+YkOMHWfZav8Y=; b=VFlwADkz+XTtq9AbKBYnI+S+jnJ46nSrxH3krhyFuHyY7G/1hRc0LFM9rZMXFej1l+RStX SlAjKSFQPnvRuQwRN7j9zhncWdweOwiCzC2mQZ/T9SV3eKhm02z/D2qiTgWWREfmwFw5qP MG3VNiJijJgMLuAQIO9FFITZxy2ODbRDNA4UQmI6+PnpLcpiqMdbhcEjAW3IJ2lC601KHx DKgP4lNiZEYLx9uJB4iR02TgxqZKkalPIhalNnNkzv7RByyCsllyYCidLlXsbfh8G/pVKM 2T/i5SE8W3WoQ5FX9rAuTuLwC2pWUUJGKOwe5dI24miq04VF7dpinvzA1yyiWA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1759513954; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=3OU+2ftdEt5pyjIKRwaCcO6oqcE/5R+YkOMHWfZav8Y=; b=FZL4m21yxG+131kBcSwPg/qc8CFdTXUR8pr/ZD4FJ/RbqhPrv2QbsXdFdf7jNyiDR2tLMG 1tXzgfEd3wZTfAdm0FCRKoQN4GQYkr599RzoC+bMRVrFwSyOgiYCaaLt9Sgxej37Sq5/6l Is/87U09Ciwaw6+Shf28vdJ0mIBeKovV5tGjqHpPCvhWjnmS8qamRiReay7l/OA6UxVsdx 1l7Iucmud7rw8I2fQK7kqtDCj9r60tIXiHNxKTVdQ47tQLa7fq9fEH4jLWiZcONH8PE3nI H9SudAL3TDGT5faSsFuimJiGtXP4V0SNcHw/e1BKi2EPuw8n/oiVO2zItAE+/Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1759513954; a=rsa-sha256; cv=none; b=R5pWd5klDga6OJdAKdKXFUSwFuQN8YAkdzK7Dc8xibwvzbGMnejHEDQJG6lQCo8tuHvGqW 71hsQ2tSj90OZZ5UqHyLlDV53zIXXi8j3ImOYlFYepy/p6R2JeUB2z93Nvta4ADkhxFrmA 1rXVcyvFCkmdmiberkzsTVT55uF6NrMz5Dld8UVgzPzPxxnrATlxwgcsRLd/o/x+B4PjMk yPc8ugtKtW+YiqBHb3r2TC7vXKx32LK7gyHU32glAtMipszmKIL+YCEaxywiFkQ6fwJNCk yV/f2ckP70g9wcQ7EBuZE6aCIt212/v1ed3+yL8OwL2pGooFeIGe31+eQSiuwg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4cdbpn7501z14jt; Fri, 03 Oct 2025 17:52:33 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 593HqXY3077475; Fri, 3 Oct 2025 17:52:33 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 593HqXWM077472; Fri, 3 Oct 2025 17:52:33 GMT (envelope-from git) Date: Fri, 3 Oct 2025 17:52:33 GMT Message-Id: <202510031752.593HqXWM077472@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 3b7da838aa8f - stable/15 - sdhci.4: Improve HARDWARE for HW Relnotes + SPDX List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: 3b7da838aa8fbe8d27be3807dab1417bf0b3b3d2 Auto-Submitted: auto-generated The branch stable/15 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=3b7da838aa8fbe8d27be3807dab1417bf0b3b3d2 commit 3b7da838aa8fbe8d27be3807dab1417bf0b3b3d2 Author: Warner Losh AuthorDate: 2025-10-03 13:49:32 +0000 Commit: Alexander Ziaee CommitDate: 2025-10-03 17:48:20 +0000 sdhci.4: Improve HARDWARE for HW Relnotes + SPDX MFC after: 1 hr Discussed with: ivy, olce Co-authored-by: ziaee (typed up imps suggestion, tagged spdx) Differential Revision: https://reviews.freebsd.org/D52860 (cherry picked from commit bc433a0b7b046b0412777e0f3cc8f18a233af8ff) --- share/man/man4/sdhci.4 | 44 ++++++++++++++++++++++++-------------------- 1 file changed, 24 insertions(+), 20 deletions(-) diff --git a/share/man/man4/sdhci.4 b/share/man/man4/sdhci.4 index 4a4e02539acd..1608d9c2fe1a 100644 --- a/share/man/man4/sdhci.4 +++ b/share/man/man4/sdhci.4 @@ -1,4 +1,6 @@ .\" +.\" SPDX-License-Identifier: BSD-2-Clause +.\" .\" Copyright (c) 2008 Alexander Motin .\" All rights reserved. .\" @@ -22,7 +24,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd August 25, 2020 +.Dd October 3, 2025 .Dt SDHCI 4 .Os .Sh NAME @@ -56,21 +58,28 @@ detaches it on card removing. .Sh HARDWARE The .Nm -driver supports different specification compatible chips. -The following chips have been verified to work: +driver supports the SD Host Controller Specification. +When attaching via the PCI bus, +the controller is automatically configured. +Many SoC chips provide a SDHCI controller directly mapped to I/O memory. +For those, the controller may be configured using +.Xr fdt 4 +or +.Xr acpi 4 +methods, supplied by your board's vendor. .Pp -.Bl -bullet -compact -.It -ENE CB712 -.It -ENE CB714 -.It -RICOH R5C822 -.It -RICOH R5CE823 -.It -TI PCIXX21/XX11/XX12 -.El +Unlike most other drivers that support a generic standard, +.Nm +requires a large number of quirks to cope with hardware bugs, +proprietary registers and poorly specified power management. +While many chipsets from +Intel, Xilinx, Rockchip, Frescale, Ricoh, and TI have these entries, +suboptimal performance may result when using some controllers. +Quirks and custom configuration are most often required +when the device is configured via +.Xr fdt 4 +or +.Xr acpi 4 . .Sh SEE ALSO .Xr mmc 4 , .Xr mmcsd 4 @@ -79,8 +88,3 @@ TI PCIXX21/XX11/XX12 .Re .Sh AUTHORS .An Alexander Motin Aq Mt mav@FreeBSD.org -.Sh BUGS -Many of existing SD controller chips have some nonstandard requirements, -proprietary registers and hardware bugs, requiring additional handling. -ENE chips are handled to work fine, while some revisions of RICOH and TI -controllers still do not see cards without some additional initialization.