From owner-svn-src-all@FreeBSD.ORG  Fri Jan 16 19:28:25 2009
Return-Path: <owner-svn-src-all@FreeBSD.ORG>
Delivered-To: svn-src-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id E90AB1065670;
	Fri, 16 Jan 2009 19:28:25 +0000 (UTC) (envelope-from mav@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
	by mx1.freebsd.org (Postfix) with ESMTP id BD4308FC19;
	Fri, 16 Jan 2009 19:28:25 +0000 (UTC) (envelope-from mav@FreeBSD.org)
Received: from svn.freebsd.org (localhost [127.0.0.1])
	by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id n0GJSPGK016435;
	Fri, 16 Jan 2009 19:28:25 GMT (envelope-from mav@svn.freebsd.org)
Received: (from mav@localhost)
	by svn.freebsd.org (8.14.3/8.14.3/Submit) id n0GJSP1F016434;
	Fri, 16 Jan 2009 19:28:25 GMT (envelope-from mav@svn.freebsd.org)
Message-Id: <200901161928.n0GJSP1F016434@svn.freebsd.org>
From: Alexander Motin <mav@FreeBSD.org>
Date: Fri, 16 Jan 2009 19:28:25 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-all@freebsd.org,
	svn-src-head@freebsd.org
X-SVN-Group: head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r187339 - head/share/man/man4
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
	user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 16 Jan 2009 19:28:26 -0000

Author: mav
Date: Fri Jan 16 19:28:25 2009
New Revision: 187339
URL: http://svn.freebsd.org/changeset/base/187339

Log:
  Add some information in SYNOPSIS, HARDWARE and BUGS sections.

Modified:
  head/share/man/man4/sdhci.4

Modified: head/share/man/man4/sdhci.4
==============================================================================
--- head/share/man/man4/sdhci.4	Fri Jan 16 19:02:08 2009	(r187338)
+++ head/share/man/man4/sdhci.4	Fri Jan 16 19:28:25 2009	(r187339)
@@ -24,16 +24,29 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 22, 2008
+.Dd January 14, 2009
 .Dt SDHCI 4
 .Os
 .Sh NAME
 .Nm sdhci
 .Nd PCI SD Host Controller bridge driver
 .Sh SYNOPSIS
-.Cd device mmc
-.Cd device mmcsd
-.Cd device sdhci
+To compile this driver into the kernel, place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device mmc"
+.Cd "device mmcsd"
+.Cd "device sdhci"
+.Ed
+.Pp
+Alternatively, to load the driver as a module at boot time, place the
+following lines in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+mmc_load="YES"
+mmcsd_load="YES"
+sdhci_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
@@ -42,6 +55,22 @@ SD Host Controller Specification.
 Driver supports up to six high speed 4bit MMC/SD slots per controller.
 Driver attaches mmc bus to the respective slot on card insertion and
 detaches it on card removing.
+.Sh HARDWARE
+The
+.Nm
+driver supports different specification compatible chips. The following
+chips have been verified to work:
+.Pp
+.Bl -bullet -compact
+.It
+ENE CB712
+.It
+ENE CB714
+.It
+RICOH R5C822
+.It
+TI PCIXX21/XX11
+.El
 .Sh SEE ALSO
 .Xr mmc 4 ,
 .Xr mmcsd 4
@@ -50,3 +79,8 @@ detaches it on card removing.
 .Re
 .Sh AUTHORS
 .An Alexander Motin Aq 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 don't see cards without some additional initialization.